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,346 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { resolveArtifactPath } from "../../registries/artifactRegistry.js";
4
+ import { activeObjectiveName, artifactPath, discoverSchemasDir, loadSchemas, resolveArtifactPathLocal, } from "../appContext.js";
5
+ import { validateAgentString } from "../argvalidate.js";
6
+ import { loadDocsPathOverrides } from "../../registries/artifactRegistry.js";
7
+ import { emitStructured } from "../structured.js";
8
+ import { COMMAND_FILTERS, emitStateStructured, extractEntries, filterByFieldValue, filterByTopic, formatEntry, loadArtifact, missingSchemaError, recentCycles, sourceMetadata, structuredState, validateFilterValues, } from "../stateQuery.js";
9
+ import { displayFields, queryTodo } from "./state.js";
10
+ const ENCODED_TRAVERSAL_RE = /%(?:2e|2f|5c)/i;
11
+ const ALLOWED_RAW_ARTIFACT_USES = [
12
+ "artifact writes",
13
+ "artifact archival",
14
+ "artifact validation",
15
+ "corruption diagnostics",
16
+ "CLI defects",
17
+ "unavailable or incomplete CLI state after CLI fallbacks",
18
+ "benchmark analysis",
19
+ ];
20
+ const BENCHMARK_CONTEXT_COMMAND = "agentera prime --context optimera --format json";
21
+ const STATE_COMMAND_NAMES = new Set([
22
+ "decisions",
23
+ "docs",
24
+ "experiments",
25
+ "health",
26
+ "objective",
27
+ "plan",
28
+ "progress",
29
+ "todo",
30
+ ]);
31
+ function out(io) {
32
+ return io.out ?? ((t) => process.stdout.write(t));
33
+ }
34
+ function err(io) {
35
+ return io.err ?? ((t) => process.stderr.write(t));
36
+ }
37
+ function projectRelativeOrAbsolute(p) {
38
+ const cwd = path.resolve(process.cwd());
39
+ const rel = path.relative(cwd, p);
40
+ if (rel.startsWith("..") || path.isAbsolute(rel))
41
+ return p;
42
+ return rel;
43
+ }
44
+ function artifactReadInterfaces(name, record) {
45
+ const artifactId = record !== null ? record.artifactId : name;
46
+ const routineCommand = STATE_COMMAND_NAMES.has(artifactId) ? `agentera ${artifactId} --format json` : null;
47
+ let advancedCommand;
48
+ if (artifactId === "benchmark_context")
49
+ advancedCommand = BENCHMARK_CONTEXT_COMMAND;
50
+ else if (STATE_COMMAND_NAMES.has(artifactId))
51
+ advancedCommand = null;
52
+ else
53
+ advancedCommand = `agentera query ${artifactId} --format json`;
54
+ let policy;
55
+ if (routineCommand)
56
+ policy = "Use the routine state command for normal content reads before any raw artifact access.";
57
+ else if (advancedCommand)
58
+ policy = "Use the listed CLI discovery/query surface before any last-resort raw artifact access.";
59
+ else
60
+ policy = "No normal content-read command is registered; raw access is limited to allowed boundary cases.";
61
+ return {
62
+ normal_read_command: routineCommand,
63
+ advanced_query_command: advancedCommand,
64
+ raw_access_boundary: {
65
+ normal_policy: policy,
66
+ allowed_raw_artifact_uses: ALLOWED_RAW_ARTIFACT_USES,
67
+ },
68
+ };
69
+ }
70
+ function artifactLocationRecord(name, info, schemasDir, docsOverrides) {
71
+ const record = info.record ?? null;
72
+ const schema = info.schema && typeof info.schema === "object" ? info.schema : {};
73
+ const meta = (schema.meta ?? {});
74
+ const schemaFile = path.join(schemasDir, `${name}.yaml`);
75
+ const artifactId = record !== null ? record.artifactId : name;
76
+ const displayName = record !== null ? record.displayName : String(meta.name ?? name);
77
+ const defaultPath = record !== null ? record.defaultPath : String(info.path ?? "");
78
+ let mappedPath = defaultPath;
79
+ let resolutionSource = record !== null ? "registry default" : "schema metadata";
80
+ const caveats = [];
81
+ if (record !== null && record.docsYamlCanOverridePath && record.displayName in docsOverrides) {
82
+ mappedPath = docsOverrides[record.displayName];
83
+ resolutionSource = ".agentera/docs.yaml mapping";
84
+ }
85
+ const objectiveName = activeObjectiveName();
86
+ let resolvedPath = null;
87
+ if (record !== null && record.pathTemplate && mappedPath.includes("<name>") && !objectiveName) {
88
+ caveats.push("Path template contains <name>; no active objective name was available for resolution.");
89
+ }
90
+ else {
91
+ try {
92
+ resolvedPath =
93
+ record !== null ? resolveArtifactPath(record, process.cwd(), objectiveName) : resolveArtifactPathLocal(mappedPath);
94
+ }
95
+ catch (exc) {
96
+ caveats.push(exc.message);
97
+ }
98
+ }
99
+ const pathPayload = {
100
+ default_path: defaultPath,
101
+ mapped_path: mappedPath,
102
+ resolved_path: resolvedPath !== null ? resolvedPath : null,
103
+ display_path: resolvedPath !== null ? projectRelativeOrAbsolute(resolvedPath) : mappedPath,
104
+ resolution_source: resolutionSource,
105
+ exists: resolvedPath !== null ? fs.existsSync(resolvedPath) : false,
106
+ docs_yaml_can_override_path: record !== null ? record.docsYamlCanOverridePath : false,
107
+ project_boundary_check: resolvedPath !== null ? "enforced" : "not_resolved",
108
+ };
109
+ return {
110
+ artifact_id: artifactId,
111
+ name: artifactId,
112
+ display_name: displayName,
113
+ artifact_type: record !== null ? record.artifactType : meta.artifact_type ?? "unknown",
114
+ format: typeof meta === "object" ? meta.format ?? "unknown" : "unknown",
115
+ producer: record !== null ? [...record.producers].sort() : meta.producer ?? "unknown",
116
+ consumers: record !== null ? [...record.consumers].sort() : meta.consumers ?? "unknown",
117
+ schema_file: fileExists(schemaFile) ? schemaFile : null,
118
+ path: pathPayload,
119
+ ...artifactReadInterfaces(name, record),
120
+ caveats,
121
+ };
122
+ }
123
+ function fileExists(p) {
124
+ try {
125
+ return fs.statSync(p).isFile();
126
+ }
127
+ catch {
128
+ return false;
129
+ }
130
+ }
131
+ export function artifactLocationContract(schemasDir, schemas) {
132
+ const docsOverrides = loadDocsPathOverrides(process.cwd());
133
+ const names = Object.keys(schemas).sort();
134
+ const records = names.map((name) => artifactLocationRecord(name, schemas[name], schemasDir, docsOverrides));
135
+ const caveats = records.flatMap((record) => record.caveats);
136
+ return {
137
+ schemaVersion: "agentera.artifact_locations.v1",
138
+ status: dirExists(schemasDir) ? "complete" : "missing_schemas",
139
+ source: {
140
+ schemas_dir: schemasDir,
141
+ docs_yaml_path: path.join(process.cwd(), ".agentera", "docs.yaml"),
142
+ docs_yaml_overrides_loaded: Object.keys(docsOverrides).length > 0,
143
+ },
144
+ source_contract: {
145
+ raw_artifact_reads_required_for_discovery: false,
146
+ normal_content_policy: "Use routine state commands when normal_read_command is present; use query only for advanced/custom artifact inspection.",
147
+ raw_artifact_read_policy: "Raw artifact reads remain valid only for explicit writes, archival, validation, corruption diagnostics, CLI defects, unavailable/incomplete CLI state after fallbacks, and benchmark analysis.",
148
+ allowed_raw_artifact_uses: ALLOWED_RAW_ARTIFACT_USES,
149
+ },
150
+ artifacts: records,
151
+ caveats,
152
+ };
153
+ }
154
+ function dirExists(p) {
155
+ try {
156
+ return fs.statSync(p).isDirectory();
157
+ }
158
+ catch {
159
+ return false;
160
+ }
161
+ }
162
+ function queryGenericEntries(args, schemas, name) {
163
+ const info = schemas[name];
164
+ const data = loadArtifact(artifactPath(info, name));
165
+ let entries = extractEntries(data);
166
+ if (entries.length === 0)
167
+ return [];
168
+ const topic = args.topic ?? null;
169
+ const sev = args.severity ?? null;
170
+ const dim = args.dimension ?? null;
171
+ const status = args.status ?? null;
172
+ if (topic)
173
+ entries = filterByTopic(entries, topic, info.fields);
174
+ if (sev)
175
+ entries = filterByFieldValue(entries, "severity", sev);
176
+ if (status)
177
+ entries = filterByFieldValue(entries, "status", status);
178
+ if (dim) {
179
+ entries = filterByFieldValue(entries, "dimension", dim, true);
180
+ if (entries.length === 0) {
181
+ entries = filterByFieldValue(extractEntries(data), "dimensions", dim, true);
182
+ }
183
+ }
184
+ return entries;
185
+ }
186
+ function queryGeneric(args, schemas, name, io) {
187
+ const o = out(io);
188
+ const e = err(io);
189
+ const format = args.format ?? "text";
190
+ const entries = queryGenericEntries(args, schemas, name);
191
+ if (format !== "text") {
192
+ const info = schemas[name];
193
+ const p = artifactPath(info, name);
194
+ const source = sourceMetadata(name, p);
195
+ const filters = {
196
+ topic: args.topic ?? null,
197
+ severity: args.severity ?? null,
198
+ status: args.status ?? null,
199
+ dimension: args.dimension ?? null,
200
+ };
201
+ return emitStateStructured(name, structuredState(name, entries, source, { filters }), format, args.fields, o, e);
202
+ }
203
+ if (entries.length === 0)
204
+ return 1;
205
+ const info = schemas[name];
206
+ const disp = displayFields(info.fields);
207
+ for (const entry of entries) {
208
+ const line = formatEntry(entry, disp);
209
+ if (line)
210
+ o(line + "\n");
211
+ }
212
+ return 0;
213
+ }
214
+ function queryLastPhase(args, schemas, io) {
215
+ const o = out(io);
216
+ const e = err(io);
217
+ const format = args.format ?? "text";
218
+ const info = schemas.progress;
219
+ if (!info) {
220
+ e(missingSchemaError("progress") + "\n");
221
+ return 1;
222
+ }
223
+ const data = loadArtifact(artifactPath(info, "progress"));
224
+ const entries = extractEntries(data);
225
+ if (entries.length === 0) {
226
+ if (format !== "text")
227
+ emitStructured(null, format, o);
228
+ return 0;
229
+ }
230
+ const last = recentCycles(entries, 1)[0];
231
+ const phase = last.phase ?? "";
232
+ if (format !== "text") {
233
+ emitStructured({ phase }, format, o);
234
+ return 0;
235
+ }
236
+ if (phase)
237
+ o(phase + "\n");
238
+ return 0;
239
+ }
240
+ function queryDesign(args, schemas, io) {
241
+ const o = out(io);
242
+ const e = err(io);
243
+ const info = schemas.design;
244
+ if (!info) {
245
+ e(missingSchemaError("design") + "\n");
246
+ return 1;
247
+ }
248
+ const p = artifactPath(info, "design");
249
+ const data = loadArtifact(p);
250
+ const entries = extractEntries(data);
251
+ if (entries.length > 0) {
252
+ let filtered = entries;
253
+ const topic = args.topic ?? null;
254
+ if (topic)
255
+ filtered = filterByTopic(filtered, topic, info.fields);
256
+ for (const entry of filtered) {
257
+ const line = formatEntry(entry, ["category", "name", "value"]);
258
+ if (line)
259
+ o(line + "\n");
260
+ }
261
+ return 0;
262
+ }
263
+ if (!fs.existsSync(p))
264
+ return 0;
265
+ const text = fs.readFileSync(p, "utf8");
266
+ const markers = [];
267
+ for (const line of text.split(/\r\n|\r|\n/)) {
268
+ const stripped = line.trim();
269
+ if (stripped.startsWith("<!-- design:") && stripped.endsWith("-->")) {
270
+ markers.push(stripped.slice("<!-- design:".length, stripped.length - "-->".length).trim());
271
+ }
272
+ }
273
+ o(`Design: sections=${markers.length}\n`);
274
+ for (const marker of markers.slice(0, 20))
275
+ o(`category=${marker}\n`);
276
+ return 0;
277
+ }
278
+ export function cmdQuery(args, io) {
279
+ const o = out(io);
280
+ const e = err(io);
281
+ const format = args.format ?? "text";
282
+ validateFilterValues(args, COMMAND_FILTERS.query);
283
+ if (args.limit !== null && args.limit !== undefined && args.limit < 0) {
284
+ throw new Error("limit must be zero or greater");
285
+ }
286
+ if (args.list_artifacts) {
287
+ const schemasDir = discoverSchemasDir();
288
+ const schemas = loadSchemas(schemasDir);
289
+ const names = Object.keys(schemas).sort();
290
+ if (format !== "text") {
291
+ const locations = artifactLocationContract(schemasDir, schemas);
292
+ emitStructured({
293
+ schemaVersion: "agentera.query.list_artifacts.v2",
294
+ command: "query",
295
+ status: locations.status,
296
+ names,
297
+ artifacts: locations.artifacts,
298
+ source: locations.source,
299
+ source_contract: locations.source_contract,
300
+ caveats: locations.caveats,
301
+ }, format, o);
302
+ return 0;
303
+ }
304
+ for (const name of names)
305
+ o(name + "\n");
306
+ return 0;
307
+ }
308
+ const query = args.query ?? "";
309
+ if (!query) {
310
+ e("Error: query pattern required (or use --list-artifacts)\n");
311
+ return 1;
312
+ }
313
+ validateAgentString(query, "query");
314
+ if (query.includes("/") || query.includes("\\") || query === "." || query === ".." || ENCODED_TRAVERSAL_RE.test(query)) {
315
+ throw new Error(`unsupported artifact/query name ${pyRepr(query)}; path-like values are not artifact names`);
316
+ }
317
+ if (STATE_COMMAND_NAMES.has(query)) {
318
+ e(`Unsupported routine query: ${query}. Use \`agentera ${query}\` instead.\n`);
319
+ return 1;
320
+ }
321
+ const schemas = loadSchemas(discoverSchemasDir());
322
+ const stateArgs = args;
323
+ const handlers = {
324
+ "last-phase": queryLastPhase,
325
+ design: queryDesign,
326
+ "open-todos": (a, s, ioo) => queryTodo({ ...a, command: "todo" }, s, ioo, true),
327
+ };
328
+ if (query in handlers) {
329
+ if (format !== "text" && query in schemas)
330
+ return queryGeneric(args, schemas, query, io);
331
+ return handlers[query](args, schemas, io);
332
+ }
333
+ if (query in schemas)
334
+ return queryGeneric(args, schemas, query, io);
335
+ for (const name of Object.keys(schemas)) {
336
+ if (query === name || query === name.replace(/s$/, "") || query === name + "s") {
337
+ return queryGeneric(args, schemas, name, io);
338
+ }
339
+ }
340
+ e(`Unknown query: ${query}\n`);
341
+ return 1;
342
+ }
343
+ function pyRepr(value) {
344
+ return value.includes("'") && !value.includes('"') ? `"${value}"` : `'${value}'`;
345
+ }
346
+ //# sourceMappingURL=query.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,210 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { usageMain } from "../../analytics/usageStats.js";
5
+ import { extractCorpusMain } from "../../analytics/extractCorpus.js";
6
+ function buildExtractArgv(args, corpusPath) {
7
+ const argv = ["--output", corpusPath];
8
+ for (const root of args.projectRoot ?? [])
9
+ argv.push("--project-root", root);
10
+ if (args.codexSessionsDir)
11
+ argv.push("--codex-sessions-dir", args.codexSessionsDir);
12
+ if (args.claudeProjectsDir)
13
+ argv.push("--claude-projects-dir", args.claudeProjectsDir);
14
+ if (args.opencodeConversationsDir)
15
+ argv.push("--opencode-conversations-dir", args.opencodeConversationsDir);
16
+ if (args.copilotConversationsDir)
17
+ argv.push("--copilot-conversations-dir", args.copilotConversationsDir);
18
+ if (args.cursorProjectsDir)
19
+ argv.push("--cursor-projects-dir", args.cursorProjectsDir);
20
+ if (args.cursorChatsDir)
21
+ argv.push("--cursor-chats-dir", args.cursorChatsDir);
22
+ if (args.noCodex)
23
+ argv.push("--no-codex");
24
+ if (args.noClaude)
25
+ argv.push("--no-claude");
26
+ if (args.noOpencode)
27
+ argv.push("--no-opencode");
28
+ if (args.noCopilot)
29
+ argv.push("--no-copilot");
30
+ if (args.noCursor)
31
+ argv.push("--no-cursor");
32
+ return argv;
33
+ }
34
+ function usageSyntax() {
35
+ return "agentera usage [--format text|json] [--corpus PATH] [--project VALUE]";
36
+ }
37
+ function usageExample() {
38
+ return "agentera usage --format json --project agentera";
39
+ }
40
+ /** Faithful port of scripts/agentera `_validate_usage_request` (shared by usage/stats/report). */
41
+ function validateUsageRequest(format) {
42
+ if (format !== "text" && format !== "json") {
43
+ throw new Error(`unsupported usage format '${format}'; valid formats: text, json. ` +
44
+ `Syntax: ${usageSyntax()}. Example: ${usageExample()}`);
45
+ }
46
+ return format;
47
+ }
48
+ /** Faithful port of `_stats_corpus_path`. */
49
+ export function statsCorpusPath(env = process.env, platform = process.platform) {
50
+ const override = env.PROFILERA_PROFILE_DIR;
51
+ if (override)
52
+ return path.join(override, "intermediate", "corpus.json");
53
+ const appHome = env.AGENTERA_HOME;
54
+ if (appHome)
55
+ return path.join(appHome, "intermediate", "corpus.json");
56
+ let base;
57
+ if (platform === "darwin") {
58
+ base = path.join(os.homedir(), "Library", "Application Support", "agentera");
59
+ }
60
+ else if (platform === "win32") {
61
+ base = path.join(env.APPDATA || path.join(os.homedir(), "AppData", "Roaming"), "agentera");
62
+ }
63
+ else {
64
+ base = path.join(env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share"), "agentera");
65
+ }
66
+ return path.join(base, "intermediate", "corpus.json");
67
+ }
68
+ /** Faithful port of `_stats_existing_corpus_status`. */
69
+ export function statsExistingCorpusStatus(corpusPath) {
70
+ if (!fs.existsSync(corpusPath)) {
71
+ return { status: "missing", path: corpusPath, reason: "corpus file does not exist" };
72
+ }
73
+ let data;
74
+ try {
75
+ data = JSON.parse(fs.readFileSync(corpusPath, "utf8"));
76
+ }
77
+ catch (exc) {
78
+ return { status: "stale", path: corpusPath, reason: `corpus is not readable JSON: ${exc.message}` };
79
+ }
80
+ const records = data && typeof data === "object" && !Array.isArray(data) ? data.records ?? [] : [];
81
+ const hasTurn = Array.isArray(records) &&
82
+ records.some((r) => r && typeof r === "object" && r.source_kind === "conversation_turn");
83
+ if (!hasTurn) {
84
+ return { status: "stale", path: corpusPath, reason: "corpus has no conversation_turn records" };
85
+ }
86
+ const metadata = data.metadata && typeof data.metadata === "object" ? data.metadata : {};
87
+ return {
88
+ status: "ready",
89
+ path: corpusPath,
90
+ reason: "existing corpus has conversation_turn records",
91
+ extracted_at: metadata.extracted_at ?? null,
92
+ total_records: records.length,
93
+ };
94
+ }
95
+ /**
96
+ * Faithful port of scripts/agentera `cmd_stats` (canonical command is `report`;
97
+ * `stats` is the deprecated alias and shares this logic). The plain read path
98
+ * reuses the ported usage engine; corpus refresh (which would run the maintainer
99
+ * extractor over local runtime history) is reported as unavailable in the
100
+ * self-contained package.
101
+ */
102
+ export function cmdReport(args, io = {}) {
103
+ const out = io.out ?? ((t) => process.stdout.write(t));
104
+ const err = io.err ?? ((t) => process.stderr.write(t));
105
+ let outputFormat;
106
+ try {
107
+ outputFormat = validateUsageRequest(String(args.format ?? "text"));
108
+ }
109
+ catch (exc) {
110
+ err(`Error: ${exc.message}\n`);
111
+ return 2;
112
+ }
113
+ const action = args.action ?? null;
114
+ if (action === "refresh") {
115
+ const dryRun = Boolean(args.dryRun);
116
+ const consent = args.consent ?? null;
117
+ if (dryRun && consent) {
118
+ err("Error: agentera stats refresh accepts either --dry-run or --consent local-history, not both\n");
119
+ return 2;
120
+ }
121
+ if (!dryRun && consent !== "local-history") {
122
+ err("Error: agentera stats refresh requires explicit --consent local-history to read local runtime history. " +
123
+ "Preview first with agentera stats refresh --dry-run\n");
124
+ return 2;
125
+ }
126
+ const corpusPath = args.output || statsCorpusPath();
127
+ const engineArgv = buildExtractArgv(args, corpusPath);
128
+ const engineCommand = ["npx", "-y", "agentera", "report", "refresh", "--consent", "local-history", ...engineArgv];
129
+ if (dryRun) {
130
+ const payload = {
131
+ command: "stats refresh",
132
+ status: "dry_run",
133
+ privacy: { local_history_read: false, local_history_write: false, corpus_write: false, required_consent: "local-history" },
134
+ corpus_path: corpusPath,
135
+ engine: { command: engineCommand },
136
+ diagnostics: ["dry-run does not read runtime history or write corpus files"],
137
+ };
138
+ if (outputFormat === "json") {
139
+ out(JSON.stringify(payload, null, 2) + "\n");
140
+ }
141
+ else {
142
+ out(`agentera stats refresh: dry_run\ncorpus=${corpusPath}\nengine=${engineCommand.join(" ")}\n`);
143
+ out("privacy=local_history_read=false, corpus_write=false, required_consent=local-history\n");
144
+ }
145
+ return 0;
146
+ }
147
+ // consent === "local-history": run the corpus extractor over local history.
148
+ let engineOut = "";
149
+ let engineErr = "";
150
+ const rc = extractCorpusMain(engineArgv, {
151
+ out: (t) => (engineOut += t + "\n"),
152
+ err: (t) => (engineErr += t + "\n"),
153
+ });
154
+ const payload = {
155
+ command: "stats refresh",
156
+ status: rc === 0 ? "pass" : "fail",
157
+ privacy: { local_history_read: true, local_history_write: false, corpus_write: true, required_consent: "local-history", provided_consent: "local-history" },
158
+ corpus_path: corpusPath,
159
+ engine: { command: engineCommand, exit_code: rc, stdout: engineOut.split("\n").filter((l) => l), stderr: engineErr.split("\n").filter((l) => l) },
160
+ };
161
+ if (outputFormat === "json") {
162
+ out(JSON.stringify(payload, null, 2) + "\n");
163
+ }
164
+ else {
165
+ out(`agentera stats refresh: ${payload.status}\ncorpus=${corpusPath}\n`);
166
+ if (engineOut)
167
+ out(engineOut);
168
+ if (engineErr)
169
+ err(engineErr);
170
+ }
171
+ return rc;
172
+ }
173
+ if (action !== null) {
174
+ err(`Error: unsupported stats action '${action}'. ` +
175
+ "Syntax: agentera stats [--format text|json] [--project VALUE] | agentera stats refresh --dry-run|--consent local-history\n");
176
+ return 2;
177
+ }
178
+ const corpusPath = statsCorpusPath();
179
+ const status = statsExistingCorpusStatus(corpusPath);
180
+ if (status.status !== "ready") {
181
+ if (outputFormat === "json") {
182
+ out(JSON.stringify({
183
+ command: "stats",
184
+ status: status.status,
185
+ corpus_path: corpusPath,
186
+ reason: status.reason,
187
+ next: "agentera stats refresh --dry-run",
188
+ privacy: { local_history_read: false, local_history_write: false },
189
+ }, null, 2) + "\n");
190
+ }
191
+ else {
192
+ err(`stats data ${status.status}: ${status.reason}\n`);
193
+ err(`corpus=${corpusPath}\n`);
194
+ err("Next: agentera stats refresh --dry-run\n");
195
+ err("Plain stats does not read local runtime history.\n");
196
+ }
197
+ return 2;
198
+ }
199
+ // Ready: run the usage engine over the existing corpus (passthrough).
200
+ const engineArgs = ["--corpus", corpusPath];
201
+ if (args.project)
202
+ engineArgs.push("--project", args.project);
203
+ if (outputFormat === "json")
204
+ engineArgs.push("--json");
205
+ return usageMain(engineArgs, {
206
+ out: (t) => out(t + "\n"),
207
+ err: (t) => err(t + "\n"),
208
+ });
209
+ }
210
+ //# sourceMappingURL=report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"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"}