nexarch 0.11.3 → 0.11.4

package/dist/commands/check-in.js

@@ -128,6 +128,8 @@ export async function checkIn(args) {
                 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}"`);
         }

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

@@ -189,8 +189,9 @@ Usage:
                                --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.3",
+  "version": "0.11.4",
   "description": "Your architecture workspace for AI delivery.",
   "keywords": [
     "nexarch",