nexarch 0.9.6 → 0.9.8

package/dist/commands/init-agent.js

@@ -444,6 +444,32 @@ function injectTrustAttestationUnavailableBlock(path, reason) {
     }
     writeFileSync(path, replaced !== existing ? replaced : `${existing}${existing.endsWith("\n") ? "" : "\n"}${managed}\n`, "utf8");
 }
+function injectInitProjectReportingContract(path) {
+    const section = [
+        "## Nexarch Init-Project Reporting 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.",
+        "",
+        "Required final status fields in your reply after init-project:",
+        '- `registration_status`: `"skeleton_only"` or `"enriched"`',
+        '- `enrichment_completed`: `true` or `false`',
+        "",
+        "Hard rule:",
+        '- If `enrichment_completed=false`, you MUST include: `Enrichment pending: run update-entity/enrichment steps.`',
+        '- If `enrichment_completed=false`, NEVER say: "fully registered", "fully done", or equivalent.',
+        "",
+        "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).",
+        "",
+    ].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);
+    }
+    writeFileSync(path, replaced !== existing ? replaced : `${existing}${existing.endsWith("\n") ? "" : "\n"}${managed}\n`, "utf8");
+}
 function injectGenericAgentConfig(registry) {
     const templateByCode = new Map(registry.instructionTemplates.map((t) => [t.code, t]));
     const genericTargets = [...registry.instructionTargets]
@@ -1114,6 +1140,7 @@ export async function initAgent(args) {
                         else {
                             injectTrustAttestationUnavailableBlock(r.path, trustAttestation.reason ?? "unknown");
                         }
+                        injectInitProjectReportingContract(r.path);
                     }
                     catch {
                         // non-fatal
@@ -1222,6 +1249,12 @@ export async function initAgent(args) {
                         consentPrompt: "I detected a likely project in this directory. Do you want me to run init-project now?",
                         actionIfApproved: "run_init_project",
                         command: "npx nexarch@latest init-project --dir . --json",
+                        reportingContract: {
+                            requiredFields: ["registration_status", "enrichment_completed"],
+                            allowedRegistrationStatus: ["skeleton_only", "enriched"],
+                            forbiddenWhenEnrichmentPending: ["fully registered", "fully done"],
+                            mandatoryLineWhenEnrichmentPending: "Enrichment pending: run update-entity/enrichment steps.",
+                        },
                     }
                     : {
                         detected: false,

package/dist/commands/init-project.js

@@ -1646,8 +1646,8 @@ ${finalStep} — Identify architecturally significant components not auto-detect
 ║  ENRICHMENT TASK — action required                               ║
 ╚══════════════════════════════════════════════════════════════════╝
 
-The mechanical scan has written a skeleton graph entry for this project.
-You now need to enrich it with meaningful content.
+The mechanical scan has written a skeleton graph entry for this project (NOT fully enriched).
+You now need to enrich it with meaningful content before considering registration complete.
 
 PROJECT ENTITY  : ${projectExternalKey}
 PROJECT DIR     : ${dir}
@@ -1655,6 +1655,10 @@ ECOSYSTEM(S)    : ${ecosystemLabel}
 MANIFEST        : ${manifestHint}
 ${readmeHints.length > 0 ? `README FILES    : ${readmeHints.join(", ")}` : "README FILES    : (none found — check docs/)"}
 
+IMPORTANT REPORTING RULE:
+  Do NOT report "fully registered" or "fully done" after init-project alone.
+  Correct status after init-project is: "skeleton created; enrichment pending" until Steps 1+ are completed.
+
 STEP 1 — Read the project README / docs and build your understanding of:
   • What does this project do? (business purpose, key features)
   • Who are the users?
@@ -1750,6 +1754,7 @@ ${subPkgSection}${adrSection}${gapCheckSection}`;
     console.log(`\nDone.`);
     console.log(`  Entities     : ${output.entities.succeeded ?? 0} written, ${output.entities.failed ?? 0} failed`);
     console.log(`  Relationships: ${output.relationships.succeeded ?? 0} written`);
+    console.log("  Status       : skeleton created; enrichment pending");
     if (output.metrics.relationshipsSkippedAsDuplicate > 0) {
         console.log(`  Deduped rels : ${output.metrics.relationshipsSkippedAsDuplicate} skipped as duplicates before upsert`);
     }

package/package.json

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