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,197 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { isFile, pathExists } from "../core/paths.js";
4
+ import { NPX_BUNDLE_SENTINEL, isNpxBundleRoot } from "../core/sourceRoot.js";
5
+ import { BUNDLE_MARKER } from "../state/installRoot.js";
6
+ import { doctorRoots, loadSuiteVersion } from "./appModel.js";
7
+ import { resolveUpdateChannel } from "./channels.js";
8
+ /**
9
+ * v2/v3 install layout detection and cross-major upgrade guard rails.
10
+ * Authority: references/cli/app-lifecycle-vocabulary.yaml (major_boundary_crossing)
11
+ */
12
+ export const MAJOR_BOUNDARY_ITEM_TAG = "requires_explicit_major_opt_in";
13
+ export const STATUS_MANUAL_REVIEW_NEEDED = "manual_review_needed";
14
+ export const STATUS_NO_CHANGES_NEEDED = "no_changes_needed";
15
+ export const STATUS_READY_TO_APPLY = "ready_to_apply";
16
+ export const STATUS_APPLIED = "applied";
17
+ export const UPGRADE_PREVIEW_SCHEMA = "agentera.upgrade.v2";
18
+ export const STATUS_CONCEPT_MAJOR_BOUNDARY = "major_boundary_crossing";
19
+ const CROSS_MAJOR_ITEMS = [
20
+ { phase: "artifacts", verb: "migrate", name: "v2_to_v3_artifacts" },
21
+ { phase: "runtime", verb: "migrate", name: "v2_to_v3_runtime_rewire" },
22
+ { phase: "cleanup", verb: "migrate", name: "v2_to_v3_app_home_cleanup" },
23
+ ];
24
+ function hasBundleRootEvidence(root) {
25
+ return (isFile(path.join(root, "scripts", "agentera")) &&
26
+ isFile(path.join(root, "skills", "agentera", "SKILL.md")));
27
+ }
28
+ function isSourceCheckoutRoot(sourceRoot) {
29
+ return (pathExists(path.join(sourceRoot, ".git")) &&
30
+ isFile(path.join(sourceRoot, "skills", "agentera", "SKILL.md")) &&
31
+ isFile(path.join(sourceRoot, "registry.json")) &&
32
+ !isNpxBundleRoot(sourceRoot));
33
+ }
34
+ function readSignals(appHome, sourceRoot, activeBundleRoot) {
35
+ return {
36
+ bundleMarkerAtActiveRoot: isFile(path.join(activeBundleRoot, BUNDLE_MARKER)),
37
+ agenteraScriptAtActiveRoot: isFile(path.join(activeBundleRoot, "scripts", "agentera")),
38
+ skillAtActiveRoot: isFile(path.join(activeBundleRoot, "skills", "agentera", "SKILL.md")),
39
+ npxBundleSentinelAtSourceRoot: isFile(path.join(sourceRoot, NPX_BUNDLE_SENTINEL)),
40
+ npxBundleSentinelAtActiveRoot: isFile(path.join(activeBundleRoot, NPX_BUNDLE_SENTINEL)),
41
+ gitAtSourceRoot: pathExists(path.join(sourceRoot, ".git")),
42
+ skillAtSourceRoot: isFile(path.join(sourceRoot, "skills", "agentera", "SKILL.md")),
43
+ registryAtSourceRoot: isFile(path.join(sourceRoot, "registry.json")),
44
+ };
45
+ }
46
+ function hasV2ManagedEvidence(signals, activeBundleRoot) {
47
+ return ((signals.bundleMarkerAtActiveRoot || signals.agenteraScriptAtActiveRoot) &&
48
+ hasBundleRootEvidence(activeBundleRoot) &&
49
+ !signals.npxBundleSentinelAtActiveRoot);
50
+ }
51
+ export function cliDistributionMajor(sourceRoot) {
52
+ if (isSourceCheckoutRoot(sourceRoot)) {
53
+ return 3;
54
+ }
55
+ if (isNpxBundleRoot(sourceRoot)) {
56
+ return 3;
57
+ }
58
+ const version = loadSuiteVersion(sourceRoot);
59
+ if (version) {
60
+ const major = Number.parseInt(version.split(".")[0] ?? "", 10);
61
+ if (Number.isFinite(major) && major > 0) {
62
+ return major;
63
+ }
64
+ }
65
+ return 2;
66
+ }
67
+ export function classifyInstall(args) {
68
+ const appHome = args.appHome;
69
+ const sourceRoot = args.sourceRoot;
70
+ const roots = doctorRoots(appHome);
71
+ const activeBundleRoot = roots.activeBundleRoot;
72
+ const signals = readSignals(appHome, sourceRoot, activeBundleRoot);
73
+ if (isNpxBundleRoot(sourceRoot) || isNpxBundleRoot(activeBundleRoot) || isNpxBundleRoot(appHome)) {
74
+ return {
75
+ kind: "v3_self_contained_npm",
76
+ appHome,
77
+ activeBundleRoot,
78
+ managedAppRoot: roots.managedAppRoot,
79
+ sourceRoot,
80
+ signals,
81
+ };
82
+ }
83
+ if (hasV2ManagedEvidence(signals, activeBundleRoot)) {
84
+ return {
85
+ kind: "v2_managed_app_home",
86
+ appHome,
87
+ activeBundleRoot,
88
+ managedAppRoot: roots.managedAppRoot,
89
+ sourceRoot,
90
+ signals,
91
+ };
92
+ }
93
+ if (isSourceCheckoutRoot(sourceRoot)) {
94
+ return {
95
+ kind: "source_checkout",
96
+ appHome,
97
+ activeBundleRoot,
98
+ managedAppRoot: roots.managedAppRoot,
99
+ sourceRoot,
100
+ signals,
101
+ };
102
+ }
103
+ return {
104
+ kind: "unknown_foreign",
105
+ appHome,
106
+ activeBundleRoot,
107
+ managedAppRoot: roots.managedAppRoot,
108
+ sourceRoot,
109
+ signals,
110
+ };
111
+ }
112
+ export function crossMajorBoundaryApplies(install, sourceRoot) {
113
+ return install.kind === "v2_managed_app_home" && cliDistributionMajor(sourceRoot) >= 3;
114
+ }
115
+ function taggedCrossMajorItems() {
116
+ return CROSS_MAJOR_ITEMS.map((item) => ({
117
+ ...item,
118
+ statusConcept: STATUS_CONCEPT_MAJOR_BOUNDARY,
119
+ tag: MAJOR_BOUNDARY_ITEM_TAG,
120
+ lifecycleStatus: STATUS_MANUAL_REVIEW_NEEDED,
121
+ }));
122
+ }
123
+ function groupItemsByPhase(items) {
124
+ const order = ["detect", "artifacts", "runtime", "cleanup"];
125
+ const byPhase = new Map();
126
+ for (const item of items) {
127
+ const list = byPhase.get(item.phase) ?? [];
128
+ list.push(item);
129
+ byPhase.set(item.phase, list);
130
+ }
131
+ const phases = [{ name: "detect", items: [] }];
132
+ for (const name of order) {
133
+ if (name === "detect") {
134
+ continue;
135
+ }
136
+ const phaseItems = byPhase.get(name) ?? [];
137
+ if (phaseItems.length > 0) {
138
+ phases.push({ name, items: phaseItems });
139
+ }
140
+ }
141
+ return phases;
142
+ }
143
+ export function shouldIncludeCrossMajorPlanItems(channel, explicitMajorOptIn) {
144
+ return channel.distributionMajor >= 3 && explicitMajorOptIn;
145
+ }
146
+ export function collectV3MigrationOperations(preview) {
147
+ const out = [];
148
+ for (const phase of preview.phases) {
149
+ for (const item of phase.items) {
150
+ if (item.verb === "migrate" && item.tag === MAJOR_BOUNDARY_ITEM_TAG) {
151
+ out.push(item);
152
+ }
153
+ }
154
+ }
155
+ return out;
156
+ }
157
+ export function previewCrossMajorGuard(args) {
158
+ const channel = resolveUpdateChannel(args);
159
+ const install = classifyInstall({ appHome: args.appHome, sourceRoot: args.sourceRoot });
160
+ const targetMajor = args.targetMajor ?? null;
161
+ const explicitMajorOptIn = targetMajor === 3;
162
+ const crossMajorBoundary = crossMajorBoundaryApplies(install, args.sourceRoot);
163
+ const items = shouldIncludeCrossMajorPlanItems(channel, explicitMajorOptIn)
164
+ ? taggedCrossMajorItems()
165
+ : [];
166
+ let lifecycleStatus;
167
+ if (!crossMajorBoundary) {
168
+ lifecycleStatus = STATUS_NO_CHANGES_NEEDED;
169
+ }
170
+ else if (!explicitMajorOptIn || channel.distributionMajor < 3) {
171
+ lifecycleStatus = STATUS_MANUAL_REVIEW_NEEDED;
172
+ }
173
+ else {
174
+ lifecycleStatus = STATUS_MANUAL_REVIEW_NEEDED;
175
+ }
176
+ return {
177
+ schemaVersion: UPGRADE_PREVIEW_SCHEMA,
178
+ lifecycleStatus,
179
+ channel,
180
+ install,
181
+ targetMajor,
182
+ crossMajorBoundary,
183
+ phases: groupItemsByPhase(items),
184
+ };
185
+ }
186
+ export function foreignLayoutHasUnexpectedEntries(root) {
187
+ if (!pathExists(root)) {
188
+ return false;
189
+ }
190
+ try {
191
+ return fs.readdirSync(root).some((entry) => entry !== ".gitkeep");
192
+ }
193
+ catch {
194
+ return false;
195
+ }
196
+ }
197
+ //# sourceMappingURL=compatibility.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/upgrade/compatibility.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,368 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { expanduser, isFile, pathExists, resolvePath } from "../core/paths.js";
4
+ import { SOURCE_LABELS, classifyResolvedRoot } from "../state/installRoot.js";
5
+ import { doctorRoots, loadSuiteVersion } from "./appModel.js";
6
+ import { isNpxBundleRoot } from "../core/sourceRoot.js";
7
+ import { resolveUpdateChannel } from "./channels.js";
8
+ import { classifyInstall, crossMajorBoundaryApplies } from "./compatibility.js";
9
+ import { buildUpgradeCommands, commandText } from "./upgradeCommands.js";
10
+ export const APP_UP_TO_DATE = "up_to_date";
11
+ export const APP_OUTDATED = "outdated";
12
+ export const APP_REPAIR_NEEDED = "repair_needed";
13
+ export const APP_MIGRATION_NEEDED = "migration_needed";
14
+ export const APP_MANUAL_REVIEW_NEEDED = "manual_review_needed";
15
+ export const EXPECTED_STATE_COMMANDS = ["prime"];
16
+ export const BUNDLE_MARKER = ".agentera-bundle.json";
17
+ /** Agentera user state preserved during v2→v3 managed app-home cleanup. */
18
+ export const AGENTERA_USER_STATE_NAMES = new Set([
19
+ "progress.yaml",
20
+ "decisions.yaml",
21
+ "health.yaml",
22
+ "plan.yaml",
23
+ "docs.yaml",
24
+ ]);
25
+ export const ROOT_USER_STATE_FILE_NAMES = new Set([
26
+ "PROFILE.md",
27
+ "USAGE.md",
28
+ "corpus.json",
29
+ "TODO.md",
30
+ "CHANGELOG.md",
31
+ "DESIGN.md",
32
+ ]);
33
+ export const ROOT_USER_STATE_DIR_NAMES = new Set(["history", "corpus"]);
34
+ function hasBundleRootEvidence(root) {
35
+ return (isFile(path.join(root, "scripts", "agentera")) &&
36
+ isFile(path.join(root, "skills", "agentera", "SKILL.md")));
37
+ }
38
+ function legacyDefaultAppHome(home) {
39
+ return resolvePath(path.join(expanduser(home), ".agents", "agentera"));
40
+ }
41
+ function isRecoverableStaleDefaultAppHome(appHome, rootSource, home) {
42
+ return rootSource === "AGENTERA_HOME" && appHome === legacyDefaultAppHome(home);
43
+ }
44
+ function legacyAppHomeHasBundle(appHome) {
45
+ return hasBundleRootEvidence(appHome) && !pathExists(path.join(appHome, ".git"));
46
+ }
47
+ function agenteraUserStateDirIsRecognized(p) {
48
+ if (!pathExists(p) || !fs.statSync(p).isDirectory()) {
49
+ return false;
50
+ }
51
+ for (const entry of fs.readdirSync(p)) {
52
+ const full = path.join(p, entry);
53
+ const st = fs.statSync(full);
54
+ if (AGENTERA_USER_STATE_NAMES.has(entry) && st.isFile()) {
55
+ continue;
56
+ }
57
+ if (entry === "optimera" && st.isDirectory()) {
58
+ continue;
59
+ }
60
+ return false;
61
+ }
62
+ return true;
63
+ }
64
+ function appHomeIsUserDataOnly(appHome) {
65
+ if (!pathExists(appHome)) {
66
+ return true;
67
+ }
68
+ if (!fs.statSync(appHome).isDirectory()) {
69
+ return false;
70
+ }
71
+ let hasUserState = false;
72
+ for (const entry of fs.readdirSync(appHome)) {
73
+ const full = path.join(appHome, entry);
74
+ const st = fs.statSync(full);
75
+ if (ROOT_USER_STATE_FILE_NAMES.has(entry) && st.isFile()) {
76
+ hasUserState = true;
77
+ continue;
78
+ }
79
+ if (ROOT_USER_STATE_DIR_NAMES.has(entry) && st.isDirectory()) {
80
+ hasUserState = true;
81
+ continue;
82
+ }
83
+ if (entry === ".agentera" && agenteraUserStateDirIsRecognized(full)) {
84
+ hasUserState = true;
85
+ continue;
86
+ }
87
+ return false;
88
+ }
89
+ return hasUserState;
90
+ }
91
+ function sourceKey(rootSource) {
92
+ for (const [key, label] of Object.entries(SOURCE_LABELS)) {
93
+ if (rootSource === label) {
94
+ return key;
95
+ }
96
+ }
97
+ if (rootSource === "AGENTERA_HOME") {
98
+ return "environment";
99
+ }
100
+ return "explicit";
101
+ }
102
+ function recoverableStaleDefaultSignal(appHome, roots) {
103
+ return {
104
+ status: APP_REPAIR_NEEDED,
105
+ kind: "recoverable_stale_default",
106
+ message: "Agentera found an old app directory and can repair it without asking you to edit shell settings",
107
+ deprecatedDefaultAppHome: appHome,
108
+ managedAppRoot: roots.managedAppRoot,
109
+ };
110
+ }
111
+ function userDataOnlySignal(appHome, roots) {
112
+ return {
113
+ status: APP_REPAIR_NEEDED,
114
+ kind: "user_data_only_app_home",
115
+ message: "This Agentera directory only has your Agentera data, so Agentera can safely add fresh app files under app/",
116
+ appHome,
117
+ managedAppRoot: roots.managedAppRoot,
118
+ };
119
+ }
120
+ function blockedRootRecoveryMessage(_rootSource) {
121
+ return "choose a different Agentera directory, or use --force only if you checked this directory and want Agentera to replace files there";
122
+ }
123
+ export function buildDoctorStatus(installRoot, opts) {
124
+ const rootSource = opts.rootSource;
125
+ const sourceRoot = opts.sourceRoot;
126
+ const home = opts.home;
127
+ const project = opts.project;
128
+ const expectedCommands = opts.expectedCommands ?? EXPECTED_STATE_COMMANDS;
129
+ const probeCli = opts.probeCli ?? true;
130
+ // Fully self-contained npx bundle: the bundle IS the app and is always current
131
+ // (its version is the package version), so there is no install/upgrade step.
132
+ // Report it as the authoritative, up-to-date app home. (Sentinel-gated; never
133
+ // triggers for a repo checkout or an installed managed app.)
134
+ if (isNpxBundleRoot(sourceRoot)) {
135
+ const bundleExpected = opts.expectedVersion || loadSuiteVersion(sourceRoot) || "unknown";
136
+ return {
137
+ schemaVersion: "agentera.bundleStatus.v1",
138
+ status: APP_UP_TO_DATE,
139
+ expectedVersion: bundleExpected,
140
+ appHome: sourceRoot,
141
+ appHomeSource: "bundled app",
142
+ managedAppRoot: sourceRoot,
143
+ userDataRoot: sourceRoot,
144
+ activeBundleRoot: sourceRoot,
145
+ authoritativeRoot: sourceRoot,
146
+ skillRoot: path.join(sourceRoot, "skills", "agentera"),
147
+ runtimeRoot: sourceRoot,
148
+ sourceRoot,
149
+ installRoot: sourceRoot,
150
+ installRootSource: "bundled app",
151
+ home,
152
+ project,
153
+ rootStatus: "bundled",
154
+ markerVersion: bundleExpected,
155
+ signals: [],
156
+ dryRunCommand: null,
157
+ applyCommand: null,
158
+ retryCommand: commandText(["npx", "-y", "agentera", expectedCommands[0] ?? "prime"]),
159
+ approval: "no action needed: self-contained app bundle is current",
160
+ };
161
+ }
162
+ const expected = opts.expectedVersion || loadSuiteVersion(sourceRoot) || "unknown";
163
+ const roots = doctorRoots(installRoot);
164
+ const activeBundleRoot = roots.activeBundleRoot;
165
+ const classification = classifyResolvedRoot(activeBundleRoot, {
166
+ source: sourceKey(rootSource),
167
+ expectedVersion: expected,
168
+ });
169
+ const markerVersion = classification.current_version;
170
+ const signals = [];
171
+ let blocked = false;
172
+ const recoverableStaleDefault = isRecoverableStaleDefaultAppHome(installRoot, rootSource, home);
173
+ const legacyBundleRoot = activeBundleRoot === installRoot &&
174
+ hasBundleRootEvidence(installRoot) &&
175
+ !pathExists(path.join(installRoot, ".git"));
176
+ let rootStatus;
177
+ if (classification.kind === "missing_default") {
178
+ rootStatus = "missing";
179
+ signals.push({
180
+ status: APP_REPAIR_NEEDED,
181
+ kind: "missing_bundle",
182
+ message: "Agentera is not installed in the normal directory yet",
183
+ });
184
+ }
185
+ else if (classification.kind === "missing_explicit_or_environment" && recoverableStaleDefault) {
186
+ rootStatus = "missing";
187
+ signals.push(recoverableStaleDefaultSignal(installRoot, roots));
188
+ }
189
+ else if (classification.kind === "missing_explicit_or_environment") {
190
+ rootStatus = "missing";
191
+ blocked = true;
192
+ signals.push({
193
+ status: APP_MANUAL_REVIEW_NEEDED,
194
+ kind: "invalid_install_root",
195
+ message: "Agentera was told to use a directory that does not exist. " +
196
+ "Choose an existing Agentera directory, or install into the normal Agentera directory.",
197
+ });
198
+ }
199
+ else if (classification.kind === "file_valued_root") {
200
+ rootStatus = "invalid";
201
+ blocked = true;
202
+ signals.push({
203
+ status: APP_MANUAL_REVIEW_NEEDED,
204
+ kind: "invalid_install_root",
205
+ message: `Agentera was told to use a file instead of a directory; ${blockedRootRecoveryMessage(rootSource)}`,
206
+ });
207
+ }
208
+ else if ((classification.kind === "invalid_bundle" || classification.kind === "unmanaged_directory") &&
209
+ recoverableStaleDefault) {
210
+ rootStatus = "stale_default";
211
+ signals.push(recoverableStaleDefaultSignal(installRoot, roots));
212
+ }
213
+ else if (classification.kind === "unmanaged_directory" && appHomeIsUserDataOnly(installRoot)) {
214
+ rootStatus = "user_data_only";
215
+ signals.push(userDataOnlySignal(installRoot, roots));
216
+ }
217
+ else if (classification.kind === "unmanaged_directory") {
218
+ rootStatus = "unmanaged";
219
+ blocked = true;
220
+ signals.push({
221
+ status: APP_MANUAL_REVIEW_NEEDED,
222
+ kind: "unmanaged_install_root",
223
+ message: `This directory already has files Agentera does not recognize, so Agentera will not change it automatically; ${blockedRootRecoveryMessage(rootSource)}`,
224
+ });
225
+ }
226
+ else if (classification.kind === "invalid_bundle") {
227
+ rootStatus = "invalid";
228
+ blocked = true;
229
+ signals.push({
230
+ status: APP_MANUAL_REVIEW_NEEDED,
231
+ kind: "invalid_bundle",
232
+ message: `This directory looks like a broken Agentera install; ${blockedRootRecoveryMessage(rootSource)}`,
233
+ });
234
+ }
235
+ else {
236
+ rootStatus = "managed";
237
+ if (legacyBundleRoot) {
238
+ signals.push({
239
+ status: APP_MIGRATION_NEEDED,
240
+ kind: APP_MIGRATION_NEEDED,
241
+ message: "Agentera app files are in the old place and can be moved into app/",
242
+ legacyBundleRoot: installRoot,
243
+ managedAppRoot: roots.managedAppRoot,
244
+ });
245
+ }
246
+ const reason = classification.diagnostic.evidence.reason;
247
+ if (classification.kind === "managed_stale" && reason === "missing_marker") {
248
+ if (recoverableStaleDefault) {
249
+ signals.push(recoverableStaleDefaultSignal(installRoot, roots));
250
+ }
251
+ signals.push({
252
+ status: APP_REPAIR_NEEDED,
253
+ kind: "missing_marker",
254
+ message: "Agentera cannot prove these app files are current, so it should repair them",
255
+ });
256
+ }
257
+ else if (classification.kind === "managed_stale" && reason === "version_mismatch") {
258
+ if (recoverableStaleDefault) {
259
+ signals.push(recoverableStaleDefaultSignal(installRoot, roots));
260
+ }
261
+ signals.push({
262
+ status: APP_OUTDATED,
263
+ kind: "version_mismatch",
264
+ expected,
265
+ actual: markerVersion,
266
+ message: "Agentera app files are valid but need an update to the expected version",
267
+ });
268
+ }
269
+ const probe = probeCli
270
+ ? (opts.probeRunner ?? defaultProbe)({
271
+ bundleRoot: activeBundleRoot,
272
+ appHome: installRoot,
273
+ project,
274
+ expectedCommands,
275
+ })
276
+ : { ok: true };
277
+ if (!probe.ok) {
278
+ let kind = "cli_probe_unavailable";
279
+ if (probe.returnCode !== null && probe.returnCode !== undefined && probe.returnCode !== 0) {
280
+ kind = "cli_probe_failed";
281
+ }
282
+ else if (probe.missingCommands && probe.missingCommands.length > 0) {
283
+ kind = "missing_command";
284
+ }
285
+ signals.push({
286
+ status: APP_REPAIR_NEEDED,
287
+ kind,
288
+ message: probe.message,
289
+ returnCode: probe.returnCode ?? null,
290
+ missingCommands: probe.missingCommands ?? [],
291
+ stdoutTail: probe.stdoutTail ?? [],
292
+ stderrTail: probe.stderrTail ?? [],
293
+ });
294
+ }
295
+ }
296
+ const env = { ...(opts.env ?? process.env), HOME: home };
297
+ const channel = resolveUpdateChannel({
298
+ channel: opts.channel ?? null,
299
+ env,
300
+ home,
301
+ sourceRoot,
302
+ });
303
+ const install = classifyInstall({ appHome: installRoot, sourceRoot });
304
+ const crossMajorBoundary = crossMajorBoundaryApplies(install, sourceRoot);
305
+ const upgradeCommands = buildUpgradeCommands({
306
+ project,
307
+ installRoot,
308
+ channel,
309
+ targetMajor: null,
310
+ });
311
+ const status = blocked
312
+ ? APP_MANUAL_REVIEW_NEEDED
313
+ : signals.some((s) => s.kind === APP_MIGRATION_NEEDED)
314
+ ? APP_MIGRATION_NEEDED
315
+ : signals.some((s) => s.status === APP_REPAIR_NEEDED)
316
+ ? APP_REPAIR_NEEDED
317
+ : signals.some((s) => s.status === APP_OUTDATED)
318
+ ? APP_OUTDATED
319
+ : APP_UP_TO_DATE;
320
+ return {
321
+ schemaVersion: "agentera.bundleStatus.v1",
322
+ status,
323
+ expectedVersion: expected,
324
+ appHome: installRoot,
325
+ appHomeSource: rootSource,
326
+ managedAppRoot: roots.managedAppRoot,
327
+ userDataRoot: installRoot,
328
+ activeBundleRoot,
329
+ authoritativeRoot: roots.managedAppRoot,
330
+ skillRoot: roots.skillRoot,
331
+ runtimeRoot: roots.runtimeRoot,
332
+ sourceRoot,
333
+ installRoot,
334
+ installRootSource: rootSource,
335
+ home,
336
+ project,
337
+ rootStatus,
338
+ markerVersion,
339
+ signals,
340
+ dryRunCommand: blocked || status === APP_UP_TO_DATE ? null : upgradeCommands.dryRunCommand,
341
+ applyCommand: blocked || status === APP_UP_TO_DATE ? null : upgradeCommands.applyCommand,
342
+ updateChannel: channel.channel,
343
+ crossMajorBoundary,
344
+ retryCommand: commandText([
345
+ "node",
346
+ path.join(activeBundleRoot, "scripts", "agentera"),
347
+ expectedCommands[0] ?? "prime",
348
+ ]),
349
+ approval: `approve app files repair for ${installRoot}`,
350
+ };
351
+ }
352
+ /** Default CLI probe placeholder (wired to the bundled TS CLI in Phase 8). */
353
+ const defaultProbe = ({ expectedCommands }) => ({
354
+ ok: false,
355
+ command: null,
356
+ returnCode: null,
357
+ stdoutTail: [],
358
+ stderrTail: [],
359
+ missingCommands: [...expectedCommands],
360
+ message: "CLI probe not yet wired to the bundled TS CLI",
361
+ });
362
+ export function publicDoctorStatus(status) {
363
+ const pub = JSON.parse(JSON.stringify(status));
364
+ delete pub.installRoot;
365
+ delete pub.installRootSource;
366
+ return pub;
367
+ }
368
+ //# sourceMappingURL=doctor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/upgrade/doctor.ts"],"names":[],"mappings":"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"}