antcolony

3.1 KB

1. // registry.hl — project metadata, one JSON file per project (`<name>.json`), the model being the
2. // antcolony repo's `projects/` folder on Byrodin (decided 2026-09-24, docs/scheduler-agent.md).
3. // COLONY_PROJECTS_DIR points at the folder; default `projects/` beside scheduler.hl (a copy —
4. // refresh it from Byrodin, README "Config").
5. //
6. // A project file: { name, dev: { host, folder }, concept, dependsOn: [..], code?, live?, deploy?, note?,
7. // workers?, ui?, needs? }. Only what the rules need is checked: `name` = file name, `concept` a string (may be
8. // empty = no concept yet), `dependsOn` a list of strings, `workers` a boolean when present
9. // (`false` = the scheduler never starts a worker there, e.g. hybriel: AntColony only files issues).
10. import { listDir } from 'hl:fs'
11. import { env } from 'hl:proc'
12. import { readJson, fromCwd, isList, isObject, isString, sortStrings } from './util.hl'
14. static projectsDir = () => {
15. let d = env('COLONY_PROJECTS_DIR')
16. if (d == null || d == '') { return './projects' }
17. return fromCwd(d)
18. }
20. // → { dir, projects: { name → meta }, names: [sorted], errors: [text] }
21. static loadRegistry = () => {
22. let dir = projectsDir()
23. let out = { dir = dir projects = {} names = [] errors = [] }
24. for (n of listDir(dir)) {
25. let file = hlTypeName(n) == 'String' ? n : n.name
26. if (file.endsWith('.json')) {
27. let r = readJson(dir + '/' + file)
28. let name = file.slice(0, file.length - 5)
29. if (r.error != null) {
30. out.errors.push(r.error)
31. } else if (!isObject(r.value)) {
32. out.errors.push(file + ': not a JSON object')
33. } else if (r.value.name != name) {
34. out.errors.push(file + ": 'name' must be '" + name + "' (the file name)")
35. } else {
36. let m = r.value
37. let deps = []
38. if (m.dependsOn != null) {
39. if (!isList(m.dependsOn)) { out.errors.push(file + ": 'dependsOn' must be a list") } else {
40. for (d of m.dependsOn) { if (isString(d)) { deps.push(d) } else { out.errors.push(file + ": 'dependsOn' entries must be strings") } }
41. }
42. }
43. m.deps = deps
44. m.takesWorkers = true
45. if (m.workers != null) {
46. if (hlTypeName(m.workers) != 'Boolean') { out.errors.push(file + ": 'workers' must be true or false") }
47. else if (m.workers == false) { m.takesWorkers = false }
48. }
49. // antcolony#15: `"needs": ["chrome", "gpu"]` = capabilities the host's agent must announce before work starts here
50. let needs = []
51. if (m.needs != null) {
52. if (!isList(m.needs)) { out.errors.push(file + ": 'needs' must be a list") } else {
53. for (x of m.needs) { if (isString(x) && x.trim() != '') { needs.push(x.trim().toLowerCase()) } else { out.errors.push(file + ": 'needs' entries must be non-empty strings") } }
54. }
55. }
56. m.needList = needs
57. m.hasConcept = isString(m.concept) && m.concept.trim() != ''
58. // mission 029: `"ui": true` = an app with pages/styles → its briefs name the creator's layout conventions
59. m.hasUi = false
60. if (m.ui != null) {
61. if (hlTypeName(m.ui) != 'Boolean') { out.errors.push(file + ": 'ui' must be true or false") }
62. else if (m.ui == true) { m.hasUi = true }
63. }
64. out.projects[name] = m
65. out.names.push(name)
66. }
67. }
68. }
69. sortStrings(out.names)
70. return out
71. }