nexarch 0.12.10 → 0.12.11

package/dist/commands/init-agent.js

@@ -477,27 +477,46 @@ function injectTrustAttestationUnavailableBlock(path, reason) {
 }
 function injectInitProjectReportingContract(path) {
     const section = [
-        "## Nexarch Init-Project Reporting Contract",
+        "## Nexarch Init-Project Completion Contract",
         "",
-        "When you run `npx nexarch@latest init-project`, treat it as skeleton registration only.",
-        "Do not claim full completion until enrichment commands are actually executed.",
+        "`init-project` is the first step of registration, not the whole task. It returns",
+        "`registrationStatus`, `enrichmentCompleted` and a `nextSteps` array. While",
+        "`enrichmentCompleted` is `false`, the work is unfinished.",
         "",
-        "Useful status fields to report after init-project:",
-        '- `registration_status`: `"skeleton_only"` or `"enriched"`',
-        '- `enrichment_completed`: `true` or `false`',
+        "**Run the commands in `nextSteps` before you report back.** They are the step that",
+        "puts real content in the graph. Reporting `skeleton_only` and stopping is not a",
+        "completed task — it is a description of a task you have not finished.",
+        "",
+        "For an infrastructure repository, `nextSteps` holds one `ingest-infra` command per",
+        "Terraform root module. Until they run, the graph knows the repository exists but",
+        "nothing it provisions.",
         "",
-        "Notes:",
-        '- While `enrichment_completed=false`, the project is a skeleton; describing it as fully registered would overstate what is in the graph.',
-        '- Enrichment uses explicit per-entity `update-entity` runs rather than a bulk shortcut, so each entity gets evidence-based content.',
+        "Stop early only when a step genuinely cannot run — missing cloud credentials, a root",
+        "module that needs `terraform init`, or an environment you should not touch without",
+        "asking. When that happens, say which step stopped you and why, then ask. Do not",
+        "silently return a skeleton.",
         "",
-        "You may set `registration_status=\"enriched\"` only after executing enrichment actions (e.g. update-entity for project/sub-packages, aliases, and any chosen gap wiring), with evidence-based per-entity descriptions/subtypes.",
+        "When reporting:",
+        '- `registration_status`: `"skeleton_only"` or `"enriched"` — take it from the command output, do not infer it',
+        '- `enrichment_completed`: `true` or `false`',
+        '- Describing a skeleton as fully registered overstates what is in the graph; so does reporting success without saying what remains.',
+        "",
+        "Enrichment uses explicit per-entity `update-entity` runs rather than a bulk shortcut,",
+        "so each entity gets evidence-based content.",
         "",
     ].join("\n");
     const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
     const managed = wrapManagedSection("init-project-reporting-contract", section.trim());
     let replaced = replaceManagedSection(existing, "init-project-reporting-contract", section.trim());
     if (replaced === existing) {
-        replaced = replaceInjectedSection(existing, "## Nexarch Init-Project Reporting Contract", managed);
+        // The section was renamed from "Reporting Contract" to "Completion Contract".
+        // Files written before managed markers existed carry the old heading, so both
+        // are matched — otherwise the rename would leave the superseded contract in
+        // place alongside the new one, and the old one tells the agent to stop.
+        replaced = replaceInjectedSection(existing, "## Nexarch Init-Project Completion Contract", managed);
+        if (replaced === existing) {
+            replaced = replaceInjectedSection(existing, "## Nexarch Init-Project Reporting Contract", managed);
+        }
     }
     writeFileSync(path, replaced !== existing ? replaced : `${existing}${existing.endsWith("\n") ? "" : "\n"}${managed}\n`, "utf8");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexarch",
-  "version": "0.12.10",
+  "version": "0.12.11",
   "description": "Your architecture workspace for AI delivery.",
   "keywords": [
     "nexarch",