agentera 0.0.0 → 3.0.0-dev.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (252) hide show
  1. package/README.md +6 -45
  2. package/bundle/.agentera-npx-bundle.json +4 -0
  3. package/bundle/references/adapters/cursor.md +213 -0
  4. package/bundle/references/adapters/opencode.md +530 -0
  5. package/bundle/references/adapters/package-manifest-interface-model.yaml +337 -0
  6. package/bundle/references/adapters/package-registry.yaml +247 -0
  7. package/bundle/references/adapters/package-surface-characterization.md +48 -0
  8. package/bundle/references/adapters/runtime-adapter-characterization.md +79 -0
  9. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +200 -0
  10. package/bundle/references/adapters/runtime-adapter-registry.yaml +548 -0
  11. package/bundle/references/adapters/runtime-feature-parity.md +189 -0
  12. package/bundle/references/analysis/benchmark.md +267 -0
  13. package/bundle/references/analysis/startup-measurement-contract.yaml +424 -0
  14. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +288 -0
  15. package/bundle/references/cli/agent-ready-state-contract.yaml +950 -0
  16. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +233 -0
  17. package/bundle/references/cli/audience-namespace-cli-migration.yaml +355 -0
  18. package/bundle/references/cli/bundle-skill-vocabulary.yaml +278 -0
  19. package/bundle/references/cli/capability-instruction-contract.yaml +123 -0
  20. package/bundle/references/cli/capability-tool-classification.yaml +53 -0
  21. package/bundle/references/cli/routing-execution-vocabulary.yaml +281 -0
  22. package/bundle/references/cli/update-channels.yaml +120 -0
  23. package/bundle/references/cli/vocabulary-index.yaml +160 -0
  24. package/bundle/references/cli/vocabulary.md +562 -0
  25. package/bundle/references/meta/documentation-inventory.md +43 -0
  26. package/bundle/references/v1-section-mapping.md +47 -0
  27. package/bundle/registry.json +39 -0
  28. package/bundle/skills/agentera/.claude-plugin/plugin.json +27 -0
  29. package/bundle/skills/agentera/SKILL.md +470 -0
  30. package/bundle/skills/agentera/agents/dokumentera.toml +6 -0
  31. package/bundle/skills/agentera/agents/hej.toml +6 -0
  32. package/bundle/skills/agentera/agents/inspektera.toml +6 -0
  33. package/bundle/skills/agentera/agents/inspirera.toml +6 -0
  34. package/bundle/skills/agentera/agents/optimera.toml +6 -0
  35. package/bundle/skills/agentera/agents/orkestrera.toml +6 -0
  36. package/bundle/skills/agentera/agents/planera.toml +6 -0
  37. package/bundle/skills/agentera/agents/profilera.toml +6 -0
  38. package/bundle/skills/agentera/agents/realisera.toml +6 -0
  39. package/bundle/skills/agentera/agents/resonera.toml +6 -0
  40. package/bundle/skills/agentera/agents/visionera.toml +6 -0
  41. package/bundle/skills/agentera/agents/visualisera.toml +6 -0
  42. package/bundle/skills/agentera/capabilities/dokumentera/instructions.md +428 -0
  43. package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +73 -0
  44. package/bundle/skills/agentera/capabilities/dokumentera/schemas/exit.yaml +35 -0
  45. package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +35 -0
  46. package/bundle/skills/agentera/capabilities/dokumentera/schemas/validation.yaml +139 -0
  47. package/bundle/skills/agentera/capabilities/hej/instructions.md +331 -0
  48. package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +69 -0
  49. package/bundle/skills/agentera/capabilities/hej/schemas/exit.yaml +32 -0
  50. package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +58 -0
  51. package/bundle/skills/agentera/capabilities/hej/schemas/validation.yaml +55 -0
  52. package/bundle/skills/agentera/capabilities/inspektera/instructions.md +514 -0
  53. package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +76 -0
  54. package/bundle/skills/agentera/capabilities/inspektera/schemas/exit.yaml +36 -0
  55. package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +38 -0
  56. package/bundle/skills/agentera/capabilities/inspektera/schemas/validation.yaml +113 -0
  57. package/bundle/skills/agentera/capabilities/inspirera/instructions.md +280 -0
  58. package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +24 -0
  59. package/bundle/skills/agentera/capabilities/inspirera/schemas/exit.yaml +33 -0
  60. package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +34 -0
  61. package/bundle/skills/agentera/capabilities/inspirera/schemas/validation.yaml +58 -0
  62. package/bundle/skills/agentera/capabilities/optimera/instructions.md +437 -0
  63. package/bundle/skills/agentera/capabilities/optimera/schemas/artifacts.yaml +69 -0
  64. package/bundle/skills/agentera/capabilities/optimera/schemas/exit.yaml +35 -0
  65. package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +39 -0
  66. package/bundle/skills/agentera/capabilities/optimera/schemas/validation.yaml +91 -0
  67. package/bundle/skills/agentera/capabilities/orkestrera/instructions.md +433 -0
  68. package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +64 -0
  69. package/bundle/skills/agentera/capabilities/orkestrera/schemas/exit.yaml +34 -0
  70. package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +42 -0
  71. package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +107 -0
  72. package/bundle/skills/agentera/capabilities/planera/instructions.md +368 -0
  73. package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +62 -0
  74. package/bundle/skills/agentera/capabilities/planera/schemas/exit.yaml +33 -0
  75. package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +34 -0
  76. package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +61 -0
  77. package/bundle/skills/agentera/capabilities/profilera/instructions.md +419 -0
  78. package/bundle/skills/agentera/capabilities/profilera/schemas/artifacts.yaml +18 -0
  79. package/bundle/skills/agentera/capabilities/profilera/schemas/exit.yaml +34 -0
  80. package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +45 -0
  81. package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +57 -0
  82. package/bundle/skills/agentera/capabilities/realisera/instructions.md +403 -0
  83. package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +80 -0
  84. package/bundle/skills/agentera/capabilities/realisera/schemas/exit.yaml +35 -0
  85. package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +39 -0
  86. package/bundle/skills/agentera/capabilities/realisera/schemas/validation.yaml +110 -0
  87. package/bundle/skills/agentera/capabilities/resonera/instructions.md +329 -0
  88. package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +47 -0
  89. package/bundle/skills/agentera/capabilities/resonera/schemas/exit.yaml +35 -0
  90. package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +46 -0
  91. package/bundle/skills/agentera/capabilities/resonera/schemas/validation.yaml +77 -0
  92. package/bundle/skills/agentera/capabilities/visionera/instructions.md +309 -0
  93. package/bundle/skills/agentera/capabilities/visionera/schemas/artifacts.yaml +57 -0
  94. package/bundle/skills/agentera/capabilities/visionera/schemas/exit.yaml +35 -0
  95. package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +41 -0
  96. package/bundle/skills/agentera/capabilities/visionera/schemas/validation.yaml +74 -0
  97. package/bundle/skills/agentera/capabilities/visualisera/instructions.md +400 -0
  98. package/bundle/skills/agentera/capabilities/visualisera/schemas/artifacts.yaml +44 -0
  99. package/bundle/skills/agentera/capabilities/visualisera/schemas/exit.yaml +34 -0
  100. package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +33 -0
  101. package/bundle/skills/agentera/capabilities/visualisera/schemas/validation.yaml +80 -0
  102. package/bundle/skills/agentera/capability_schema_contract.yaml +385 -0
  103. package/bundle/skills/agentera/protocol.yaml +463 -0
  104. package/bundle/skills/agentera/references/contract.md +1039 -0
  105. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +60 -0
  106. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +461 -0
  107. package/bundle/skills/agentera/schemas/artifacts/design.yaml +55 -0
  108. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +402 -0
  109. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +373 -0
  110. package/bundle/skills/agentera/schemas/artifacts/health.yaml +484 -0
  111. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +399 -0
  112. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +342 -0
  113. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +325 -0
  114. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +110 -0
  115. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +262 -0
  116. package/bundle/skills/hej/.claude-plugin/plugin.json +6 -0
  117. package/bundle/skills/hej/SKILL.md +69 -0
  118. package/bundle/skills/hej/agents/hej.toml +11 -0
  119. package/bundle/skills/hej/agents/openai.yaml +8 -0
  120. package/dist/analytics/extractCorpus.js +1791 -0
  121. package/dist/analytics/extractCorpus.js.map +1 -0
  122. package/dist/analytics/usageStats.js +487 -0
  123. package/dist/analytics/usageStats.js.map +1 -0
  124. package/dist/bin/agentera.js +4 -0
  125. package/dist/bin/agentera.js.map +1 -0
  126. package/dist/cli/appContext.js +226 -0
  127. package/dist/cli/appContext.js.map +1 -0
  128. package/dist/cli/argvalidate.js +41 -0
  129. package/dist/cli/argvalidate.js.map +1 -0
  130. package/dist/cli/capabilityContext.js +2421 -0
  131. package/dist/cli/capabilityContext.js.map +1 -0
  132. package/dist/cli/commands/backfill.js +84 -0
  133. package/dist/cli/commands/backfill.js.map +1 -0
  134. package/dist/cli/commands/capability.js +44 -0
  135. package/dist/cli/commands/capability.js.map +1 -0
  136. package/dist/cli/commands/compact.js +148 -0
  137. package/dist/cli/commands/compact.js.map +1 -0
  138. package/dist/cli/commands/doctor.js +180 -0
  139. package/dist/cli/commands/doctor.js.map +1 -0
  140. package/dist/cli/commands/lint.js +179 -0
  141. package/dist/cli/commands/lint.js.map +1 -0
  142. package/dist/cli/commands/prime.js +545 -0
  143. package/dist/cli/commands/prime.js.map +1 -0
  144. package/dist/cli/commands/query.js +346 -0
  145. package/dist/cli/commands/query.js.map +1 -0
  146. package/dist/cli/commands/report.js +210 -0
  147. package/dist/cli/commands/report.js.map +1 -0
  148. package/dist/cli/commands/schema.js +306 -0
  149. package/dist/cli/commands/schema.js.map +1 -0
  150. package/dist/cli/commands/state.js +1012 -0
  151. package/dist/cli/commands/state.js.map +1 -0
  152. package/dist/cli/commands/upgrade.js +49 -0
  153. package/dist/cli/commands/upgrade.js.map +1 -0
  154. package/dist/cli/commands/validate.js +519 -0
  155. package/dist/cli/commands/validate.js.map +1 -0
  156. package/dist/cli/commands/verify.js +204 -0
  157. package/dist/cli/commands/verify.js.map +1 -0
  158. package/dist/cli/dispatch.js +962 -0
  159. package/dist/cli/dispatch.js.map +1 -0
  160. package/dist/cli/orientation.js +595 -0
  161. package/dist/cli/orientation.js.map +1 -0
  162. package/dist/cli/prime-blob.js +3 -0
  163. package/dist/cli/prime-blob.js.map +1 -0
  164. package/dist/cli/stateQuery.js +292 -0
  165. package/dist/cli/stateQuery.js.map +1 -0
  166. package/dist/cli/structured.js +18 -0
  167. package/dist/cli/structured.js.map +1 -0
  168. package/dist/core/difflib.js +274 -0
  169. package/dist/core/difflib.js.map +1 -0
  170. package/dist/core/git.js +43 -0
  171. package/dist/core/git.js.map +1 -0
  172. package/dist/core/paths.js +50 -0
  173. package/dist/core/paths.js.map +1 -0
  174. package/dist/core/pyjson.js +101 -0
  175. package/dist/core/pyjson.js.map +1 -0
  176. package/dist/core/sourceRoot.js +72 -0
  177. package/dist/core/sourceRoot.js.map +1 -0
  178. package/dist/core/toml.js +11 -0
  179. package/dist/core/toml.js.map +1 -0
  180. package/dist/core/yaml.js +25 -0
  181. package/dist/core/yaml.js.map +1 -0
  182. package/dist/eval/evalSkills.js +258 -0
  183. package/dist/eval/evalSkills.js.map +1 -0
  184. package/dist/eval/semanticEval.js +148 -0
  185. package/dist/eval/semanticEval.js.map +1 -0
  186. package/dist/eval/semanticFixtures.js +227 -0
  187. package/dist/eval/semanticFixtures.js.map +1 -0
  188. package/dist/hooks/common.js +160 -0
  189. package/dist/hooks/common.js.map +1 -0
  190. package/dist/hooks/compaction.js +935 -0
  191. package/dist/hooks/compaction.js.map +1 -0
  192. package/dist/hooks/cursorPreToolUse.js +19 -0
  193. package/dist/hooks/cursorPreToolUse.js.map +1 -0
  194. package/dist/hooks/cursorSessionStart.js +71 -0
  195. package/dist/hooks/cursorSessionStart.js.map +1 -0
  196. package/dist/hooks/sessionStart.js +209 -0
  197. package/dist/hooks/sessionStart.js.map +1 -0
  198. package/dist/hooks/sessionStop.js +212 -0
  199. package/dist/hooks/sessionStop.js.map +1 -0
  200. package/dist/hooks/validateArtifact.js +933 -0
  201. package/dist/hooks/validateArtifact.js.map +1 -0
  202. package/dist/registries/artifactRegistry.js +206 -0
  203. package/dist/registries/artifactRegistry.js.map +1 -0
  204. package/dist/registries/capabilityContract.js +310 -0
  205. package/dist/registries/capabilityContract.js.map +1 -0
  206. package/dist/registries/packageRegistry.js +641 -0
  207. package/dist/registries/packageRegistry.js.map +1 -0
  208. package/dist/registries/runtimeAdapterRegistry.js +315 -0
  209. package/dist/registries/runtimeAdapterRegistry.js.map +1 -0
  210. package/dist/setup/codex.js +1052 -0
  211. package/dist/setup/codex.js.map +1 -0
  212. package/dist/setup/copilot.js +227 -0
  213. package/dist/setup/copilot.js.map +1 -0
  214. package/dist/setup/cursor.js +127 -0
  215. package/dist/setup/cursor.js.map +1 -0
  216. package/dist/setup/doctor.js +1269 -0
  217. package/dist/setup/doctor.js.map +1 -0
  218. package/dist/state/installRoot.js +279 -0
  219. package/dist/state/installRoot.js.map +1 -0
  220. package/dist/state/progressCommit.js +289 -0
  221. package/dist/state/progressCommit.js.map +1 -0
  222. package/dist/state/startupAnalysis.js +1953 -0
  223. package/dist/state/startupAnalysis.js.map +1 -0
  224. package/dist/upgrade/appModel.js +189 -0
  225. package/dist/upgrade/appModel.js.map +1 -0
  226. package/dist/upgrade/channels.js +197 -0
  227. package/dist/upgrade/channels.js.map +1 -0
  228. package/dist/upgrade/compatibility.js +197 -0
  229. package/dist/upgrade/compatibility.js.map +1 -0
  230. package/dist/upgrade/doctor.js +368 -0
  231. package/dist/upgrade/doctor.js.map +1 -0
  232. package/dist/upgrade/migrateArtifactsV2ToV3.js +412 -0
  233. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -0
  234. package/dist/upgrade/upgradeCommands.js +40 -0
  235. package/dist/upgrade/upgradeCommands.js.map +1 -0
  236. package/dist/upgrade/upgradeOrchestrator.js +280 -0
  237. package/dist/upgrade/upgradeOrchestrator.js.map +1 -0
  238. package/dist/validate/appHomeContract.js +150 -0
  239. package/dist/validate/appHomeContract.js.map +1 -0
  240. package/dist/validate/capability.js +412 -0
  241. package/dist/validate/capability.js.map +1 -0
  242. package/dist/validate/crossCapability.js +145 -0
  243. package/dist/validate/crossCapability.js.map +1 -0
  244. package/dist/validate/lifecycleAdapters.js +772 -0
  245. package/dist/validate/lifecycleAdapters.js.map +1 -0
  246. package/dist/validate/selfAudit.js +107 -0
  247. package/dist/validate/selfAudit.js.map +1 -0
  248. package/package.json +28 -8
  249. package/LICENSE +0 -201
  250. package/bin/agentera.mjs +0 -50
  251. package/lib/exec.mjs +0 -116
  252. package/lib/resolve.mjs +0 -129
@@ -0,0 +1,412 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { loadYamlMapping } from "../core/yaml.js";
4
+ import { loadCapabilitySchemaContract, } from "../registries/capabilityContract.js";
5
+ export const PROTOCOL_GROUPS = [
6
+ "CONFIDENCE_SCALE",
7
+ "SEVERITY_FINDING",
8
+ "SEVERITY_ISSUE",
9
+ "SEVERITY_MAPPING",
10
+ "DECISION_LABELS",
11
+ "EXIT_SIGNALS",
12
+ "VISUAL_TOKENS",
13
+ "SKILL_GLYPHS",
14
+ "PHASES",
15
+ ];
16
+ export { loadCapabilitySchemaContract };
17
+ function isMapping(value) {
18
+ return value !== null && typeof value === "object" && !Array.isArray(value);
19
+ }
20
+ /** True when a YAML key string represents a positive integer (`>= 1`). */
21
+ function isNumericKey(key) {
22
+ return /^\d+$/.test(key) && Number(key) >= 1;
23
+ }
24
+ /** Render a key for diagnostics roughly like Python repr: bare for ints, quoted otherwise. */
25
+ function keyRepr(key) {
26
+ return /^-?\d+(?:\.\d+)?$/.test(key) ? key : `'${key}'`;
27
+ }
28
+ function valueRepr(value) {
29
+ if (value === null || value === undefined) {
30
+ return "None";
31
+ }
32
+ if (typeof value === "string") {
33
+ return `'${value}'`;
34
+ }
35
+ if (typeof value === "boolean") {
36
+ return value ? "True" : "False";
37
+ }
38
+ return String(value);
39
+ }
40
+ function pyListRepr(values) {
41
+ return "[" + values.map((v) => `'${v}'`).join(", ") + "]";
42
+ }
43
+ export function loadContract(contractPath) {
44
+ return loadYamlMapping(fs.readFileSync(contractPath, "utf8"));
45
+ }
46
+ export function loadSchemaFile(p) {
47
+ return loadYamlMapping(fs.readFileSync(p, "utf8"));
48
+ }
49
+ export function loadProtocol(protocolPath) {
50
+ return loadYamlMapping(fs.readFileSync(protocolPath, "utf8"));
51
+ }
52
+ function listSchemaFiles(schemasDir, glob) {
53
+ // Agentera schema globs are always "*.yaml"; match on suffix.
54
+ const suffix = glob.replace(/^\*/, "");
55
+ if (!fs.existsSync(schemasDir) || !fs.statSync(schemasDir).isDirectory()) {
56
+ return [];
57
+ }
58
+ return fs
59
+ .readdirSync(schemasDir)
60
+ .filter((name) => name.endsWith(suffix))
61
+ .sort()
62
+ .map((name) => path.join(schemasDir, name));
63
+ }
64
+ export function collectSchemaGroups(schemasDir, requiredGroups, schemaGlob = "*.yaml") {
65
+ const combined = {};
66
+ for (const yamlFile of listSchemaFiles(schemasDir, schemaGlob)) {
67
+ const data = loadSchemaFile(yamlFile);
68
+ for (const [groupName, groupData] of Object.entries(data)) {
69
+ if (requiredGroups.includes(groupName)) {
70
+ if (!(groupName in combined)) {
71
+ combined[groupName] = {};
72
+ }
73
+ if (isMapping(groupData)) {
74
+ Object.assign(combined[groupName], groupData);
75
+ }
76
+ }
77
+ }
78
+ }
79
+ return combined;
80
+ }
81
+ export function checkDirectoryStructure(capDir, contract) {
82
+ const errors = [];
83
+ const directoryRules = contract.directoryRules;
84
+ const prose = path.join(capDir, directoryRules.instructionPath);
85
+ const schemas = path.join(capDir, directoryRules.schemasPath);
86
+ const isFile = fs.existsSync(prose) && fs.statSync(prose).isFile();
87
+ if (!isFile) {
88
+ errors.push(`V1 [error]: ${directoryRules.instructionPath} not found in ${capDir}`);
89
+ }
90
+ const isDir = fs.existsSync(schemas) && fs.statSync(schemas).isDirectory();
91
+ if (!isDir) {
92
+ errors.push(`V1 [error]: ${directoryRules.schemasPath}/ directory not found in ${capDir}`);
93
+ }
94
+ else if (listSchemaFiles(schemas, directoryRules.schemaGlob).length < directoryRules.minimumSchemaFiles) {
95
+ errors.push(`V1 [error]: ${directoryRules.schemasPath}/ contains no .yaml files in ${capDir}`);
96
+ }
97
+ return errors;
98
+ }
99
+ export function checkRequiredGroups(groups, sourceLabel, contract) {
100
+ const errors = [];
101
+ for (const rg of contract.requiredGroups) {
102
+ if (!(rg in groups)) {
103
+ errors.push(`V2 [error]: required group ${rg} missing in ${sourceLabel}`);
104
+ }
105
+ }
106
+ return errors;
107
+ }
108
+ export function checkNumberedEntries(groups, sourceLabel, contract) {
109
+ const errors = [];
110
+ for (const [groupName, entries] of Object.entries(groups)) {
111
+ if (!contract.requiredGroups.includes(groupName)) {
112
+ continue;
113
+ }
114
+ if (!isMapping(entries)) {
115
+ errors.push(`V3 [error]: ${groupName} in ${sourceLabel} is not a mapping`);
116
+ continue;
117
+ }
118
+ for (const key of Object.keys(entries)) {
119
+ if (!isNumericKey(key)) {
120
+ errors.push(`V3 [error]: non-numeric key ${keyRepr(key)} in ${groupName} in ${sourceLabel}`);
121
+ }
122
+ }
123
+ }
124
+ return errors;
125
+ }
126
+ export function checkStableIds(groups, sourceLabel, contract) {
127
+ const errors = [];
128
+ for (const [groupName, entries] of Object.entries(groups)) {
129
+ if (!contract.requiredGroups.includes(groupName)) {
130
+ continue;
131
+ }
132
+ if (!isMapping(entries)) {
133
+ continue;
134
+ }
135
+ const requiredFields = contract.entryRules.requiredFieldsByGroup[groupName] ?? contract.entryRules.defaultRequiredFields;
136
+ for (const [key, entry] of Object.entries(entries)) {
137
+ if (!isMapping(entry)) {
138
+ errors.push(`V4 [error]: entry ${key} in ${groupName} in ${sourceLabel} is not a mapping`);
139
+ continue;
140
+ }
141
+ for (const fieldName of requiredFields) {
142
+ if (groupName === "TRIGGERS" && fieldName === "priority") {
143
+ continue;
144
+ }
145
+ if (!(fieldName in entry)) {
146
+ errors.push(`V4 [error]: entry ${key} in ${groupName} in ${sourceLabel} missing '${fieldName}'`);
147
+ }
148
+ }
149
+ }
150
+ }
151
+ return errors;
152
+ }
153
+ export function checkTriggerPriorities(groups, sourceLabel, contract) {
154
+ const errors = [];
155
+ const triggers = groups.TRIGGERS ?? {};
156
+ if (!isMapping(triggers)) {
157
+ return errors;
158
+ }
159
+ const priorityRules = contract.triggerPriorityRules;
160
+ for (const [key, entry] of Object.entries(triggers)) {
161
+ if (!isMapping(entry)) {
162
+ continue;
163
+ }
164
+ const priority = entry.priority ?? null;
165
+ if (priority === null && priorityRules.required) {
166
+ errors.push(`V5b [error]: TRIGGERS entry ${key} in ${sourceLabel} missing 'priority'`);
167
+ }
168
+ else if (priority !== null && !priorityRules.allowedValues.includes(priority)) {
169
+ errors.push(`V5b [error]: TRIGGERS entry ${key} in ${sourceLabel} has invalid priority=${valueRepr(priority)} ` +
170
+ `(must be one of: ${priorityRules.allowedValues.join(", ")})`);
171
+ }
172
+ }
173
+ return errors;
174
+ }
175
+ export function checkDeprecation(groups, sourceLabel, contract) {
176
+ const warnings = [];
177
+ const markerField = contract.deprecationRules.marker_field;
178
+ const markerValue = contract.deprecationRules.marker_value;
179
+ const replacementField = contract.deprecationRules.replacement_field;
180
+ const replacementTarget = contract.deprecationRules.replacement_target_field;
181
+ for (const [groupName, entries] of Object.entries(groups)) {
182
+ if (!contract.requiredGroups.includes(groupName)) {
183
+ continue;
184
+ }
185
+ if (!isMapping(entries)) {
186
+ continue;
187
+ }
188
+ const validIds = new Set();
189
+ for (const entry of Object.values(entries)) {
190
+ if (isMapping(entry) && replacementTarget in entry) {
191
+ validIds.add(entry[replacementTarget]);
192
+ }
193
+ }
194
+ for (const [key, entry] of Object.entries(entries)) {
195
+ if (!isMapping(entry)) {
196
+ continue;
197
+ }
198
+ if (entry[markerField] === markerValue) {
199
+ const replaced = entry[replacementField];
200
+ if (!replaced) {
201
+ warnings.push(`V5 [warning]: entry ${key} (${entry.id ?? "?"}) ` +
202
+ `in ${groupName} in ${sourceLabel} is deprecated but has no ${replacementField}`);
203
+ }
204
+ else if (!validIds.has(replaced)) {
205
+ warnings.push(`V5 [warning]: entry ${key} (${entry.id ?? "?"}) ` +
206
+ `in ${groupName} in ${sourceLabel} has ${replacementField}=${valueRepr(replaced)} ` +
207
+ `which does not match any entry ID`);
208
+ }
209
+ }
210
+ }
211
+ }
212
+ return warnings;
213
+ }
214
+ export function validateContractSelf(contractPath) {
215
+ const contract = loadCapabilitySchemaContract(contractPath);
216
+ const data = loadContract(contractPath);
217
+ const errors = [];
218
+ const groups = {};
219
+ for (const groupName of contract.requiredGroups) {
220
+ if (groupName in data && isMapping(data[groupName])) {
221
+ groups[groupName] = data[groupName];
222
+ }
223
+ }
224
+ errors.push(...checkRequiredGroups(groups, contractPath, contract));
225
+ errors.push(...checkNumberedEntries(groups, contractPath, contract));
226
+ errors.push(...checkStableIds(groups, contractPath, contract));
227
+ errors.push(...checkTriggerPriorities(groups, contractPath, contract));
228
+ for (const w of checkDeprecation(groups, contractPath, contract)) {
229
+ process.stderr.write(w + "\n");
230
+ }
231
+ return errors;
232
+ }
233
+ export function validateCapability(capDir, contractPath) {
234
+ const contract = loadCapabilitySchemaContract(contractPath);
235
+ const allErrors = [];
236
+ allErrors.push(...checkDirectoryStructure(capDir, contract));
237
+ const schemasDir = path.join(capDir, contract.directoryRules.schemasPath);
238
+ if (fs.existsSync(schemasDir) && fs.statSync(schemasDir).isDirectory()) {
239
+ const groups = collectSchemaGroups(schemasDir, contract.requiredGroups, contract.directoryRules.schemaGlob);
240
+ allErrors.push(...checkRequiredGroups(groups, capDir, contract));
241
+ allErrors.push(...checkNumberedEntries(groups, capDir, contract));
242
+ allErrors.push(...checkStableIds(groups, capDir, contract));
243
+ allErrors.push(...checkTriggerPriorities(groups, capDir, contract));
244
+ for (const w of checkDeprecation(groups, capDir, contract)) {
245
+ process.stderr.write(w + "\n");
246
+ }
247
+ }
248
+ return allErrors;
249
+ }
250
+ export function buildProtocolValueLookup(protocolData) {
251
+ const lookup = {};
252
+ for (const groupName of PROTOCOL_GROUPS) {
253
+ const group = protocolData[groupName];
254
+ if (!isMapping(group)) {
255
+ continue;
256
+ }
257
+ const values = new Set();
258
+ for (const [key, entry] of Object.entries(group)) {
259
+ if (!isNumericKey(key) || !isMapping(entry)) {
260
+ continue;
261
+ }
262
+ if ("value" in entry) {
263
+ values.add(entry.value);
264
+ }
265
+ }
266
+ if (values.size > 0) {
267
+ lookup[groupName] = values;
268
+ }
269
+ }
270
+ return lookup;
271
+ }
272
+ export function checkProtocolStructure(protocolData, sourceLabel) {
273
+ const errors = [];
274
+ const prefixes = protocolData.GROUP_PREFIXES ?? {};
275
+ if (!isMapping(prefixes)) {
276
+ errors.push(`[error]: GROUP_PREFIXES missing or not a mapping in ${sourceLabel}`);
277
+ return errors;
278
+ }
279
+ for (const groupName of PROTOCOL_GROUPS) {
280
+ const group = protocolData[groupName];
281
+ if (!isMapping(group)) {
282
+ errors.push(`[error]: group ${groupName} missing in ${sourceLabel}`);
283
+ continue;
284
+ }
285
+ const expectedPrefix = prefixes[groupName] ?? "";
286
+ const validIds = new Set();
287
+ for (const [key, entry] of Object.entries(group)) {
288
+ if (!isNumericKey(key)) {
289
+ continue;
290
+ }
291
+ if (!isMapping(entry)) {
292
+ errors.push(`[error]: entry ${key} in ${groupName} is not a mapping`);
293
+ continue;
294
+ }
295
+ if (!("id" in entry)) {
296
+ errors.push(`[error]: entry ${key} in ${groupName} missing 'id'`);
297
+ }
298
+ else {
299
+ const eid = entry.id;
300
+ if (expectedPrefix && !eid.startsWith(expectedPrefix)) {
301
+ errors.push(`[error]: entry ${key} id=${valueRepr(eid)} in ${groupName} ` +
302
+ `does not match prefix ${valueRepr(expectedPrefix)}`);
303
+ }
304
+ validIds.add(eid);
305
+ }
306
+ }
307
+ for (const [key, entry] of Object.entries(group)) {
308
+ if (!isNumericKey(key) || !isMapping(entry)) {
309
+ continue;
310
+ }
311
+ if (entry.deprecated) {
312
+ const replaced = entry.replaced_by;
313
+ if (!replaced) {
314
+ errors.push(`[warning]: entry ${key} (${entry.id ?? "?"}) ` +
315
+ `in ${groupName} is deprecated but has no replaced_by`);
316
+ }
317
+ else if (!validIds.has(replaced)) {
318
+ errors.push(`[warning]: entry ${key} (${entry.id ?? "?"}) ` +
319
+ `in ${groupName} has replaced_by=${valueRepr(replaced)} ` +
320
+ `which does not match any entry ID`);
321
+ }
322
+ }
323
+ }
324
+ }
325
+ return errors;
326
+ }
327
+ export function checkPhaseTransitions(protocolData, sourceLabel) {
328
+ const errors = [];
329
+ void sourceLabel;
330
+ const phasesGroup = protocolData.PHASES;
331
+ if (!isMapping(phasesGroup)) {
332
+ return errors;
333
+ }
334
+ const phaseValues = new Set();
335
+ for (const [key, entry] of Object.entries(phasesGroup)) {
336
+ if (isNumericKey(key) && isMapping(entry) && "value" in entry) {
337
+ phaseValues.add(entry.value);
338
+ }
339
+ }
340
+ for (const [key, entry] of Object.entries(phasesGroup)) {
341
+ if (!isNumericKey(key) || !isMapping(entry)) {
342
+ continue;
343
+ }
344
+ const successors = entry.valid_successors ?? [];
345
+ const entryId = entry.id ?? `entry ${key}`;
346
+ for (const s of successors) {
347
+ if (!phaseValues.has(s)) {
348
+ errors.push(`[error]: ${entryId} in PHASES has valid_successors entry ` +
349
+ `${valueRepr(s)} which is not a defined phase value`);
350
+ }
351
+ }
352
+ if (entry.self_transition && !successors.includes(entry.value)) {
353
+ errors.push(`[error]: ${entryId} in PHASES has self_transition=true ` +
354
+ `but ${valueRepr(entry.value)} not in valid_successors`);
355
+ }
356
+ }
357
+ return errors;
358
+ }
359
+ export function validateProtocolSelf(protocolPath) {
360
+ const data = loadProtocol(protocolPath);
361
+ const errors = [];
362
+ errors.push(...checkProtocolStructure(data, protocolPath));
363
+ errors.push(...checkPhaseTransitions(data, protocolPath));
364
+ return errors;
365
+ }
366
+ export function checkPrimitiveReferences(capDir, protocolPath, contractPath = "skills/agentera/capability_schema_contract.yaml") {
367
+ const contract = loadCapabilitySchemaContract(contractPath);
368
+ const protocolData = loadProtocol(protocolPath);
369
+ const lookup = buildProtocolValueLookup(protocolData);
370
+ const errors = [];
371
+ const schemasDir = path.join(capDir, "schemas");
372
+ if (!fs.existsSync(schemasDir) || !fs.statSync(schemasDir).isDirectory()) {
373
+ return errors;
374
+ }
375
+ for (const yamlFile of listSchemaFiles(schemasDir, "*.yaml")) {
376
+ const data = loadSchemaFile(yamlFile);
377
+ for (const [groupName, groupData] of Object.entries(data)) {
378
+ if (!isMapping(groupData)) {
379
+ continue;
380
+ }
381
+ for (const [key, entry] of Object.entries(groupData)) {
382
+ if (!isNumericKey(key) || !isMapping(entry)) {
383
+ continue;
384
+ }
385
+ const entryId = entry.id ?? `${groupName}.${key}`;
386
+ for (const [fieldName, protocolGroups] of Object.entries(contract.primitiveReferences.fields)) {
387
+ if (!(fieldName in entry)) {
388
+ continue;
389
+ }
390
+ const value = entry[fieldName];
391
+ const valuesToCheck = Array.isArray(value) ? value : [value];
392
+ for (const v of valuesToCheck) {
393
+ let resolved = false;
394
+ for (const pg of protocolGroups) {
395
+ if (pg in lookup && lookup[pg].has(v)) {
396
+ resolved = true;
397
+ break;
398
+ }
399
+ }
400
+ if (!resolved) {
401
+ errors.push(`[error]: ${entryId} field ${fieldName}=${valueRepr(v)} ` +
402
+ `does not resolve to any protocol primitive ` +
403
+ `in groups ${pyListRepr(protocolGroups)}`);
404
+ }
405
+ }
406
+ }
407
+ }
408
+ }
409
+ }
410
+ return errors;
411
+ }
412
+ //# sourceMappingURL=capability.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability.js","sourceRoot":"","sources":["../../src/validate/capability.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,145 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { loadYamlMapping } from "../core/yaml.js";
4
+ import { resolveSourceRoot } from "../core/sourceRoot.js";
5
+ import { artifactSchemasDir as defaultArtifactSchemasDir, loadArtifactRegistry, } from "../registries/artifactRegistry.js";
6
+ function capabilitiesDirDefault() {
7
+ return path.join(resolveSourceRoot(), "skills", "agentera", "capabilities");
8
+ }
9
+ function loadYaml(p) {
10
+ return loadYamlMapping(fs.readFileSync(p, "utf8"));
11
+ }
12
+ export function loadCanonicalArtifacts(artifactSchemasDir = defaultArtifactSchemasDir()) {
13
+ const out = new Map();
14
+ for (const [artifactId, record] of loadArtifactRegistry(artifactSchemasDir)) {
15
+ out.set(artifactId, {
16
+ artifactId: record.artifactId,
17
+ displayName: record.displayName,
18
+ producers: record.producers,
19
+ consumers: record.consumers,
20
+ });
21
+ }
22
+ return out;
23
+ }
24
+ function listCapabilityDirs(capabilitiesDir) {
25
+ if (!fs.existsSync(capabilitiesDir) || !fs.statSync(capabilitiesDir).isDirectory()) {
26
+ return [];
27
+ }
28
+ return fs
29
+ .readdirSync(capabilitiesDir)
30
+ .filter((name) => fs.statSync(path.join(capabilitiesDir, name)).isDirectory())
31
+ .sort();
32
+ }
33
+ export function loadCapabilityArtifacts(capabilitiesDir = capabilitiesDirDefault()) {
34
+ const records = [];
35
+ for (const capName of listCapabilityDirs(capabilitiesDir)) {
36
+ const artifactPath = path.join(capabilitiesDir, capName, "schemas", "artifacts.yaml");
37
+ if (!fs.existsSync(artifactPath) || !fs.statSync(artifactPath).isFile()) {
38
+ continue;
39
+ }
40
+ const data = loadYaml(artifactPath);
41
+ const entries = data.ARTIFACTS ?? {};
42
+ if (entries === null || typeof entries !== "object" || Array.isArray(entries)) {
43
+ continue;
44
+ }
45
+ for (const entry of Object.values(entries)) {
46
+ if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
47
+ continue;
48
+ }
49
+ const e = entry;
50
+ const artifactId = String(e.artifact_id ?? "").trim();
51
+ const localRole = String(e.local_role ?? "").trim();
52
+ if (!artifactId) {
53
+ continue;
54
+ }
55
+ const produces = localRole === "produces" || localRole === "produces_and_consumes";
56
+ const consumes = localRole === "consumes" || localRole === "produces_and_consumes";
57
+ records.push({
58
+ capability: capName,
59
+ artifactId,
60
+ displayName: artifactId,
61
+ producers: produces ? new Set([capName]) : new Set(),
62
+ consumers: consumes ? new Set([capName]) : new Set(),
63
+ });
64
+ }
65
+ }
66
+ return records;
67
+ }
68
+ function displayName(record, registry) {
69
+ const artifact = registry.get(record.artifactId);
70
+ return artifact ? artifact.displayName : record.artifactId;
71
+ }
72
+ function unionSets(sets) {
73
+ const out = new Set();
74
+ for (const s of sets) {
75
+ for (const v of s) {
76
+ out.add(v);
77
+ }
78
+ }
79
+ return out;
80
+ }
81
+ function intersect(a, b) {
82
+ const out = new Set();
83
+ for (const v of a) {
84
+ if (b.has(v)) {
85
+ out.add(v);
86
+ }
87
+ }
88
+ return out;
89
+ }
90
+ function setsEqual(a, b) {
91
+ if (a.size !== b.size) {
92
+ return false;
93
+ }
94
+ for (const v of a) {
95
+ if (!b.has(v)) {
96
+ return false;
97
+ }
98
+ }
99
+ return true;
100
+ }
101
+ function sortedListRepr(s) {
102
+ const arr = [...s].sort();
103
+ return "[" + arr.map((v) => `'${v}'`).join(", ") + "]";
104
+ }
105
+ export function validateGraph(artifactSchemasDir = defaultArtifactSchemasDir(), capabilitiesDir = capabilitiesDirDefault()) {
106
+ const registry = loadArtifactRegistry(artifactSchemasDir);
107
+ const canonical = loadCanonicalArtifacts(artifactSchemasDir);
108
+ const capabilityArtifacts = loadCapabilityArtifacts(capabilitiesDir);
109
+ const capabilityNames = new Set(listCapabilityDirs(capabilitiesDir));
110
+ const errors = [];
111
+ const byArtifactId = new Map();
112
+ for (const record of capabilityArtifacts) {
113
+ if (!byArtifactId.has(record.artifactId)) {
114
+ byArtifactId.set(record.artifactId, []);
115
+ }
116
+ byArtifactId.get(record.artifactId).push(record);
117
+ const name = displayName(record, registry);
118
+ if (!canonical.has(record.artifactId)) {
119
+ errors.push(`${record.capability}: unknown artifact_id '${record.artifactId}'`);
120
+ continue;
121
+ }
122
+ if (record.producers.size === 0 && record.consumers.size === 0) {
123
+ errors.push(`${record.capability}: ${name} neither produces nor consumes`);
124
+ }
125
+ }
126
+ for (const [artifactId, artifact] of canonical) {
127
+ const records = byArtifactId.get(artifactId) ?? [];
128
+ const producedBy = records.length ? unionSets(records.map((r) => r.producers)) : new Set();
129
+ const consumedBy = records.length ? unionSets(records.map((r) => r.consumers)) : new Set();
130
+ const schemaProducers = intersect(artifact.producers, capabilityNames);
131
+ const schemaConsumers = intersect(artifact.consumers, capabilityNames);
132
+ if (schemaProducers.size > 0 && !setsEqual(schemaProducers, producedBy)) {
133
+ errors.push(`${artifact.displayName}: registry producers ${sortedListRepr(schemaProducers)} ` +
134
+ `do not match capability producers ${sortedListRepr(producedBy)}`);
135
+ }
136
+ if (artifact.consumers.size > 0 &&
137
+ !artifact.consumers.has("all_skills") &&
138
+ !setsEqual(schemaConsumers, consumedBy)) {
139
+ errors.push(`${artifact.displayName}: registry consumers ${sortedListRepr(schemaConsumers)} ` +
140
+ `do not match capability consumers ${sortedListRepr(consumedBy)}`);
141
+ }
142
+ }
143
+ return errors;
144
+ }
145
+ //# sourceMappingURL=crossCapability.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"crossCapability.js","sourceRoot":"","sources":["../../src/validate/crossCapability.ts"],"names":[],"mappings":"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"}