agentera 0.0.0 → 3.0.0-dev.1

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