nexarch 0.11.2 → 0.11.4

package/dist/commands/check-in.js

@@ -40,36 +40,29 @@ export async function checkIn(args) {
     const agentKey = agentKeyArg ?? identity.agentKey;
     if (!agentKey) {
         if (asJson) {
-            process.stdout.write(JSON.stringify({ commands: [], draftApplications: [], reason: "no-agent-key" }) + "\n");
+            process.stdout.write(JSON.stringify({ commands: [], draftApplications: [], proposedApplications: [], reason: "no-agent-key" }) + "\n");
         }
         else {
             console.log("No agent key found. Pass --agent-key or run nexarch init-agent first.");
         }
         return;
     }
-    const [raw, draftRaw] = await Promise.all([
-        callMcpTool("nexarch_check_in", {
-            agentRef: agentKey,
-            agentKey,
-            companyId: creds.companyId,
-        }, { companyId: creds.companyId }),
-        callMcpTool("nexarch_list_entities", {
-            companyId: creds.companyId,
-            entityTypeCode: "application",
-            status: "draft",
-        }, { companyId: creds.companyId }),
-    ]);
+    const raw = await callMcpTool("nexarch_check_in", {
+        agentRef: agentKey,
+        agentKey,
+        companyId: creds.companyId,
+    }, { companyId: creds.companyId });
     const result = parseToolText(raw);
-    const draftResult = parseToolText(draftRaw);
-    const draftApplications = draftResult.entities ?? [];
+    const draftApplications = result.draftApplications ?? [];
+    const proposedApplications = result.proposedApplications ?? [];
     if (asJson) {
-        process.stdout.write(JSON.stringify({ ...result, draftApplications }) + "\n");
+        process.stdout.write(JSON.stringify(result) + "\n");
         return;
     }
     const commands = result.commands ?? [];
-    if (commands.length === 0 && draftApplications.length === 0) {
+    if (commands.length === 0 && draftApplications.length === 0 && proposedApplications.length === 0) {
         console.log("No pending application-target commands found.");
-        console.log("No applications in draft state.");
+        console.log("No draft or proposed applications need attention.");
         return;
     }
     if (commands.length > 0) {
@@ -107,7 +100,7 @@ export async function checkIn(args) {
             " Ask the user if they would like to review and instantiate any of them.");
         for (const app of draftApplications) {
             const subtype = app.entitySubtypeCode ? ` [${app.entitySubtypeCode}]` : "";
-            const key = app.externalKey ? ` (${app.externalKey})` : "";
+            const key = app.entityRef ? ` (${app.entityRef})` : "";
             console.log(`\n  Name    : ${app.name}${subtype}${key}`);
             if (app.description)
                 console.log(`  Desc    : ${app.description}`);
@@ -118,4 +111,30 @@ export async function checkIn(args) {
         console.log("  npx nexarch proposals start --id <applicationId>");
         console.log("  npx nexarch proposals start --id <applicationId> --dir <path> --non-interactive");
     }
+    if (proposedApplications.length > 0) {
+        const count = proposedApplications.length;
+        console.log(`\n--- Proposed applications (${count}) ---`);
+        console.log(`${count === 1 ? "There is 1 application" : `There are ${count} applications`} in proposed state.` +
+            " Ask the user if they would like to review and realise any of them.");
+        for (const app of proposedApplications) {
+            const subtype = app.entitySubtypeCode ? ` [${app.entitySubtypeCode}]` : "";
+            const key = app.entityRef ? ` (${app.entityRef})` : "";
+            console.log(`\n  Name    : ${app.name}${subtype}${key}`);
+            if (app.description)
+                console.log(`  Desc    : ${app.description}`);
+            if (app.recommendationBasis)
+                console.log(`  Basis   : ${app.recommendationBasis}`);
+            if (typeof app.recommendedTechnologyCount === "number")
+                console.log(`  Tech    : ${app.recommendedTechnologyCount} recommended`);
+            if (typeof app.confirmedPolicyCount === "number")
+                console.log(`  Policy  : ${app.confirmedPolicyCount} confirmed`);
+            if (app.requiresPolicyReview)
+                console.log(`  Gate    : policy review required`);
+            console.log(`  ID      : ${app.id}`);
+            console.log(`  Realise : npx nexarch proposals start --id "${app.id}"`);
+        }
+        console.log("\nTo scaffold a proposed application into a local project:");
+        console.log("  npx nexarch proposals start --id <applicationId>");
+        console.log("  npx nexarch proposals start --id <applicationId> --dir <path> --non-interactive");
+    }
 }

package/dist/commands/proposals-start.js

@@ -203,7 +203,7 @@ function buildReadme(proposal, template) {
 
 ${proposal.application.description ?? "Application scaffold generated from a NexArch proposal."}
 
-## Starter template
+${proposal.proposal.requiresPolicyReview ? `> Policy review is required before activation. Review docs/architecture/policy-controls.md and satisfy each required control before marking this application active.\n\n` : ""}## Starter template
 
 - Template: ${template.label}
 - Runtime: ${template.runtime}
@@ -226,7 +226,7 @@ ${formatBulletList(technologies)}
 
 ${formatBulletList(policies)}
 
-## Getting started
+${proposal.proposal.preScaffoldInstructions ? `## Pre-scaffold instruction\n\n${proposal.proposal.preScaffoldInstructions}\n\n` : ""}## Getting started
 
 ${template.nextSteps.map((step, index) => `${index + 1}. ${step}`).join("\n")}
 `;
@@ -234,7 +234,10 @@ ${template.nextSteps.map((step, index) => `${index + 1}. ${step}`).join("\n")}
 function buildProposalMarkdown(proposal) {
     const techLines = proposal.technologyChoices.map((tech) => `${tech.name}${tech.entitySubtypeCode ? ` (${tech.entitySubtypeCode})` : ""}${tech.description ? ` — ${tech.description}` : ""}`);
     const policyLines = proposal.policyControls.map((control) => `${control.name}${control.description ? ` — ${control.description}` : ""}`);
-    return `# NexArch proposal context\n\n## Application\n\n- Name: ${proposal.application.name}\n- ID: ${proposal.application.id}\n- Reference: ${proposal.application.entityRef ?? "n/a"}\n- Subtype: ${proposal.application.entitySubtypeCode ?? "n/a"}\n- Description: ${proposal.application.description ?? "n/a"}\n- Recommendation basis: ${proposal.application.recommendationBasis ?? "n/a"}\n- Proposal source: ${proposal.proposal.proposalSource ?? "n/a"}\n\n${proposal.application.recommendationSummary ? `## Recommendation summary\n\n${proposal.application.recommendationSummary}\n\n` : ""}## Technology choices\n\n${formatBulletList(techLines)}\n\n## Policy controls\n\n${formatBulletList(policyLines)}\n`;
+    const gateLines = proposal.proposal.requiresPolicyReview
+        ? `- Activation gate: policy review required\n- Required policy controls: ${proposal.proposal.requiredPolicyControlIds?.length ?? 0}\n`
+        : "";
+    return `# NexArch proposal context\n\n## Application\n\n- Name: ${proposal.application.name}\n- ID: ${proposal.application.id}\n- Reference: ${proposal.application.entityRef ?? "n/a"}\n- Subtype: ${proposal.application.entitySubtypeCode ?? "n/a"}\n- Description: ${proposal.application.description ?? "n/a"}\n- Recommendation basis: ${proposal.application.recommendationBasis ?? "n/a"}\n- Proposal source: ${proposal.proposal.proposalSource ?? "n/a"}\n${gateLines}\n${proposal.application.recommendationSummary ? `## Recommendation summary\n\n${proposal.application.recommendationSummary}\n\n` : ""}${proposal.proposal.preScaffoldInstructions ? `## Pre-scaffold instruction\n\n${proposal.proposal.preScaffoldInstructions}\n\n` : ""}## Technology choices\n\n${formatBulletList(techLines)}\n\n## Policy controls\n\n${formatBulletList(policyLines)}\n`;
 }
 function buildPolicyMarkdown(proposal) {
     if (proposal.policyControls.length === 0) {
@@ -242,12 +245,17 @@ function buildPolicyMarkdown(proposal) {
     }
     return `# Policy controls\n\n${proposal.policyControls.map((control) => {
         const guidance = trimText(typeof control.controlAttributes.summary === "string" ? control.controlAttributes.summary : null);
-        const rules = Array.isArray(control.controlAttributes.rules)
-            ? control.controlAttributes.rules
-                .map((rule) => trimText(typeof rule.title === "string" ? rule.title : typeof rule.code === "string" ? rule.code : null))
-                .filter((value) => Boolean(value))
-            : [];
-        return `## ${control.name}\n\n${control.description ?? "No description provided."}\n\n${guidance ? `Guidance: ${guidance}\n\n` : ""}${rules.length > 0 ? `Rules\n\n${formatBulletList(rules)}\n` : ""}`;
+        const rules = (control.rules ?? [])
+            .map((rule) => {
+            const title = trimText(rule.title) ?? trimText(rule.ruleId) ?? trimText(rule.name) ?? "Unnamed rule";
+            const level = trimText(rule.requirementLevel);
+            const mode = trimText(rule.ruleMode);
+            const text = trimText(rule.ruleText);
+            return `${title}${level ? ` [${level}]` : ""}${mode ? ` (${mode})` : ""}${text ? ` — ${text}` : ""}`;
+        })
+            .filter((value) => Boolean(value));
+        const auditRules = Array.isArray(control.auditRules) ? control.auditRules.length : 0;
+        return `## ${control.name}\n\n${control.description ?? "No description provided."}\n\n${guidance ? `Guidance: ${guidance}\n\n` : ""}${control.policyMarkdown ? `Policy markdown\n\n${control.policyMarkdown}\n\n` : ""}${rules.length > 0 ? `Rules\n\n${formatBulletList(rules)}\n\n` : ""}${auditRules > 0 ? `Audit rules: ${auditRules}\n` : ""}`;
     }).join("\n")}`;
 }
 function buildTsConfig() {
@@ -560,6 +568,7 @@ export async function proposalsStart(args) {
                 command: "proposals start",
                 operatorEmail: creds.email,
             },
+            reviewedPolicyControlIds: proposal.proposal.requiredPolicyControlIds ?? proposal.proposal.confirmedPolicyControlIds,
         }, { companyId: creds.companyId });
         activated = parseToolText(activateRaw);
     }

package/dist/index.js

@@ -181,16 +181,17 @@ Usage:
                                --limit <1-500>
                                --json
   nexarch check-in    Preview pending application-target commands (no auto-claim)
-                      and report any applications currently in draft state so the
+                      and report draft/proposed applications needing review so the
                       agent can prompt the user to explore and instantiate them.
                       Use command-claim to explicitly claim a specific command.
                       Scope is resolved server-side from active company context.
                       Options: --agent-key <key>   override stored agent key
-                               --json              JSON output includes draftApplications[]
+                               --json              JSON output includes draftApplications[] and proposedApplications[]
   nexarch proposals start
                       Start a new application workspace from a proposed NexArch app.
-                      Lists proposed apps, lets you choose one, writes a starter
-                      project scaffold, and activates the proposal to active.
+                      Lists proposed apps, shows policy review gates, writes a starter
+                      project scaffold, and activates the proposal to active once
+                      required policy controls are acknowledged.
                       Options: --id <applicationId>
                                --dir <path>
                                --reason <text>

package/package.json

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