@mindexed/cfact 1.1.3 → 1.1.4

package/bin/cfact.js

@@ -1602,7 +1602,7 @@ async function materialise(opts) {
 
   info('');
   info(outcome.done);
-  for (const line of requiredNextSteps({ consumerRoot, wiring })) info(line);
+  for (const line of requiredNextSteps({ consumerRoot, wiring, command: opts.command })) info(line);
 }
 
 // --- required next steps (ADR-0178) ------------------------------------------
@@ -1624,7 +1624,7 @@ async function materialise(opts) {
 // was applied. A second check here would be a second authority over one fact,
 // and the obvious cheap form of it (does the file exist?) is true of every wired
 // consumer, which makes the advice permanent noise.
-function requiredNextSteps({ consumerRoot, wiring }) {
+function requiredNextSteps({ consumerRoot, wiring, command }) {
   const steps = [
     `restart the Claude Code session in '${consumerRoot}' — this is what loads the new engine`,
   ];
@@ -1634,6 +1634,18 @@ function requiredNextSteps({ consumerRoot, wiring }) {
         "session's `NO MCP` is indistinguishable from a broken config (ADR-0066)"
     );
   }
+  // CHG-236 (Jose, 2026-09-23): "a guided walkthrough on npx update, not a
+  // text report" — this CLI has no LLM to walk anyone through anything, so
+  // the walkthrough itself is `/guide-sync`, run inside the restarted
+  // session above. This is the one line pointing there; `update` only, since
+  // a fresh `init` has no prior state to have drifted from.
+  if (command === 'update') {
+    steps.push(
+      "run `/guide-sync` in that session — it walks every stale/cannot-evaluate " +
+        'alignment signal interactively, one at a time, rather than leaving you to ' +
+        'read `/generate-alignment-map`\'s report and resolve it by hand'
+    );
+  }
   return ['', 'Required next steps:', ...steps.map((s, i) => `  ${i + 1}. ${s}`)];
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexed/cfact",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Clean Orthogonal Architecture Software Factory Framework",
   "bin": {
     "claude-factory": "bin/cfact.js",
@@ -33,6 +33,8 @@
     "gate:document-freshness": "node scripts/check-document-freshness.js",
     "gate:registry": "node scripts/check-registry.js",
     "gate:rule-records": "node scripts/check-rule-records.js",
+    "audit:record-text": "node scripts/check-record-text.js",
+    "gate:graph-coverage": "node scripts/check-graph-coverage.js",
     "gate:adr-template-edges": "node scripts/check-adr-template-edges.js",
     "gate:installer-publish-drift": "node scripts/check-installer-publish-drift.js",
     "gate:changelog": "node scripts/generate-changelog.js --check",
@@ -64,6 +66,8 @@
     "test:tarball-reproducible": "node scripts/test-tarball-reproducible.js",
     "test:release-version": "node scripts/test-release-version-lib.js",
     "test:consumer-checklist": "node scripts/test-consumer-checklist.js",
+    "test:engine-host": "node scripts/test-engine-host.js",
+    "test:zone-coverage": "node scripts/test-zone-coverage.js",
     "test:workflow-spine": "node scripts/test-workflow-spine.js",
     "test:command-shape": "node scripts/test-command-shape.js",
     "test:change-record": "node scripts/test-change-record.js",
@@ -75,12 +79,21 @@
     "test:installer-lifecycle": "node scripts/test-installer-lifecycle.js",
     "test:installer-shadowing": "node scripts/test-installer-shadowing.js",
     "test:feature-record": "node scripts/test-feature-record.js",
+    "test:feature-store": "node scripts/test-feature-store.js",
+    "test:feature-record-v2": "node scripts/test-feature-record-v2.js",
+    "test:feature-v2-switch": "node scripts/test-feature-v2-switch.js",
+    "test:feature-completeness": "node scripts/test-feature-completeness.js",
+    "test:feature-history": "node scripts/test-feature-history.js",
+    "test:agent-note-dispatch": "node scripts/test-agent-note-dispatch.js",
+    "test:check-record-text": "node scripts/test-check-record-text.js",
     "test:feature-write-guard": "node scripts/test-feature-write-guard.js",
+    "test:trailer-lib": "node scripts/test-trailer-lib.js",
+    "test:feature-write-lock": "node scripts/test-feature-write-lock.js",
     "test:generate-ci": "node scripts/test-generate-ci.js",
     "publish:release": "node maintainer-hooks/publish-release.js",
-    "gate:consistency": "npm run gate:matrix-sync && npm run gate:compliance && npm run gate:doc-links && npm run gate:command-metadata && npm run gate:tracked-symlinks && npm run gate:agents-md-sync && npm run gate:ripple-coverage && npm run gate:profile-docs && npm run gate:registry && npm run gate:adr-template-edges && npm run gate:installer-publish-drift",
+    "gate:consistency": "npm run gate:matrix-sync && npm run gate:compliance && npm run gate:doc-links && npm run gate:command-metadata && npm run gate:tracked-symlinks && npm run gate:agents-md-sync && npm run gate:ripple-coverage && npm run gate:profile-docs && npm run gate:registry && npm run gate:rule-records && npm run gate:graph-coverage && npm run gate:adr-template-edges && npm run gate:installer-publish-drift",
     "gate:boundaries": "bash hooks/check-matrix.sh domain && bash hooks/check-matrix.sh components && bash hooks/check-matrix.sh controllers && bash hooks/check-matrix.sh secrets",
-    "ci": "npm run gate:consistency && npm run gate:boundaries && npm run gate:profile-coverage && npm run gate:document-freshness && npm run gate:changelog && npm test",
+    "ci": "npm run gate:consistency && npm run gate:boundaries && npm run gate:profile-coverage && npm run gate:document-freshness && npm test",
     "test:gate-three-state": "node scripts/test-gate-three-state.js",
     "test:refresh-compliance": "node scripts/test-refresh-compliance.js",
     "test:gate-coverage": "node scripts/test-gate-coverage.js",
@@ -89,6 +102,9 @@
     "test:validate-zone-ledger-score": "node scripts/test-validate-zone-ledger-score.js",
     "test:rules-carrier-schema": "node scripts/test-rules-carrier-schema.js",
     "test:rule-record-schema": "node scripts/test-rule-record-schema.js",
+    "test:rule-record-concerns-check": "node scripts/test-rule-record-concerns-check.js",
+    "test:external-standard-drift": "node scripts/test-external-standard-drift.js",
+    "test:session-branch": "node scripts/test-session-branch.js",
     "test:consumer-docs-migration": "node scripts/test-consumer-docs-migration.js",
     "test:sot-templates-pointer": "node scripts/test-sot-templates-pointer.js",
     "test:npm-deprecation": "node scripts/test-npm-deprecation.js",
@@ -99,12 +115,21 @@
     "test:generate-feature-card": "node scripts/test-generate-feature-card.js",
     "test:generate-codex-agents": "node scripts/test-generate-codex-agents.js",
     "test:context-subject": "node scripts/test-context-subject.js",
-    "test": "npm run test:dc-generator && npm run test:substance-generator && npm run test:json-flush && npm run test:installer-exit && npm run test:installer-channel && npm run test:installer-update-messaging && npm run test:installer-wiring && npm run test:tar-invocation && npm run test:framework-agents-mcp && npm run test:controller-gates && npm run test:controller-single-file-attribution && npm run test:parse-ast && npm run test:git-tree-sweep && npm run test:secrets-two-stage && npm run test:profile-paths && npm run test:registry-gate && npm run test:rule-resolver && npm run test:adr-template-edges && npm run test:adr-path-constants && npm run test:resolver-topology && npm run test:graph-strip && npm run test:graph-registry && npm run test:graph-memory-substrate && npm run test:document-freshness && npm run test:frontmatter-readers && npm run test:tarball-reproducible && npm run test:release-version && npm run test:consumer-checklist && npm run test:workflow-spine && npm run test:command-shape && npm run test:change-record && npm run test:engine-write-lock && npm run test:installer-publish-drift && npm run test:grants-authored && npm run test:test-capability && npm run test:installer-lifecycle && npm run test:gate-three-state && npm run test:refresh-compliance && npm run test:gate-coverage && npm run test:policy-lib && npm run test:validate-zone-denylist-bypass && npm run test:validate-zone-ledger-score && npm run test:rules-carrier-schema && npm run test:rule-record-schema && npm run test:installer-shadowing && npm run test:feature-record && npm run test:consumer-docs-migration && npm run test:npm-deprecation && npm run test:sot-templates-pointer && npm run test:test-command-gate && npm run test:changelog-adr-refs && npm run test:generate-ci && npm run test:known-frictions-staleness && npm run test:artifact-timestamps && npm run test:generate-flow-map && npm run test:generate-zone-map && npm run test:generate-erd && npm run test:surfaces-layerpaths && npm run test:list-feature-files && npm run test:feature-write-guard && npm run test:context-subject && npm run test:generate-project-analysis && npm run test:generate-feature-card && npm run test:generate-codex-agents",
+    "test": "npm run test:dc-generator && npm run test:substance-generator && npm run test:json-flush && npm run test:installer-exit && npm run test:installer-channel && npm run test:installer-update-messaging && npm run test:installer-wiring && npm run test:tar-invocation && npm run test:framework-agents-mcp && npm run test:controller-gates && npm run test:controller-single-file-attribution && npm run test:parse-ast && npm run test:git-tree-sweep && npm run test:secrets-two-stage && npm run test:profile-paths && npm run test:registry-gate && npm run test:rule-resolver && npm run test:adr-template-edges && npm run test:adr-path-constants && npm run test:resolver-topology && npm run test:graph-strip && npm run test:graph-registry && npm run test:graph-memory-substrate && npm run test:document-freshness && npm run test:frontmatter-readers && npm run test:tarball-reproducible && npm run test:release-version && npm run test:consumer-checklist && npm run test:engine-host && npm run test:zone-coverage && npm run test:workflow-spine && npm run test:command-shape && npm run test:change-record && npm run test:engine-write-lock && npm run test:installer-publish-drift && npm run test:grants-authored && npm run test:test-capability && npm run test:installer-lifecycle && npm run test:gate-three-state && npm run test:refresh-compliance && npm run test:gate-coverage && npm run test:policy-lib && npm run test:validate-zone-denylist-bypass && npm run test:validate-zone-ledger-score && npm run test:rules-carrier-schema && npm run test:rule-record-schema && npm run test:rule-record-concerns-check && npm run test:external-standard-drift && npm run test:session-branch && npm run test:installer-shadowing && npm run test:feature-record && npm run test:feature-store && npm run test:feature-record-v2 && npm run test:feature-v2-switch && npm run test:feature-completeness && npm run test:feature-history && npm run test:agent-note-dispatch && npm run test:check-record-text && npm run test:consumer-docs-migration && npm run test:npm-deprecation && npm run test:sot-templates-pointer && npm run test:test-command-gate && npm run test:changelog-adr-refs && npm run test:generate-ci && npm run test:known-frictions-staleness && npm run test:artifact-timestamps && npm run test:generate-flow-map && npm run test:generate-zone-map && npm run test:generate-infra-map && npm run test:generate-erd && npm run test:surfaces-layerpaths && npm run test:list-feature-files && npm run test:feature-write-guard && npm run test:context-subject && npm run test:generate-project-analysis && npm run test:generate-feature-card && npm run test:generate-codex-agents && npm run test:generate-agent-cards && npm run test:generate-framework-graph && npm run test:unrecorded-scope && npm run test:profile-reinstated-zones && npm run test:contract-claims && npm run test:plan-crosscheck && npm run test:consumer-alignment && npm run test:check-consumer-alignment",
     "test:test-command-gate": "node scripts/test-test-command-gate.js",
     "test:changelog-adr-refs": "node scripts/test-changelog-adr-refs.js",
     "test:known-frictions-staleness": "node scripts/test-known-frictions-staleness.js",
     "test:generate-flow-map": "node scripts/test-generate-flow-map.js",
-    "test:generate-zone-map": "node scripts/test-generate-zone-map.js"
+    "test:generate-zone-map": "node scripts/test-generate-zone-map.js",
+    "test:generate-infra-map": "node scripts/test-generate-infra-map.js",
+    "test:generate-agent-cards": "node scripts/test-generate-agent-cards.js",
+    "test:generate-framework-graph": "node scripts/test-generate-framework-graph.js",
+    "test:unrecorded-scope": "node scripts/test-unrecorded-scope.js",
+    "test:profile-reinstated-zones": "node scripts/test-profile-reinstated-zones.js",
+    "test:contract-claims": "node scripts/test-contract-claims.js",
+    "test:plan-crosscheck": "node scripts/test-plan-crosscheck.js",
+    "test:consumer-alignment": "node scripts/test-consumer-alignment.js",
+    "test:check-consumer-alignment": "node scripts/test-check-consumer-alignment.js"
   },
   "keywords": [],
   "author": "",