@mindexed/cfact 1.1.1 → 1.1.3

package/README.md

@@ -55,7 +55,8 @@ This repo **is** the framework — the pieces a consuming project resolves throu
 ├── .mcp.json                  # Model Context Protocol (MCP) server definitions
 ├── .claude/
 │   ├── CLAUDE.md              # Router containing Global Hard Rules & path-scoped rule routes
-│   ├── settings.json          # Automated hooks (PreToolUse/PostSave) and verification scripts
+│   ├── settings.json          # Minimal (enabledMcpjsonServers). No hooks: this repo has no app code
+│   │                             for the write-time gates to act on — see ADR-0226
 │   ├── state/                 # Symlink -> ../cfact-docs (compat path every
 │   │                             # command/hook still reads/writes)
 │   ├── rules/, agents/, commands/  # Symlinks back to the root folders above, so Claude Code's

package/bin/{claude-factory.js → cfact.js}

@@ -246,14 +246,15 @@ function parseArgs(argv) {
   return opts;
 }
 
-const HELP = `claude-factory — install/update a pinned, vendored Claude Factory engine
+const HELP = `cfact — install/update a pinned, vendored CFacT engine
 
 Usage:
   npx @mindexed/cfact init   [consumer-path] --version <v> [options]
   npx @mindexed/cfact update [consumer-path] [--version <v>] [options]
 
-Also published as @mindexed/claude-factory (the kept-alive legacy name); both
-serve the identical tree at the identical version.
+Also resolvable as @mindexed/claude-factory (the deprecated legacy name) --
+frozen at its last published version as of ADR-0287 and never updated again;
+install @mindexed/cfact for anything published from here on.
 
 Materialises .claude/engine as REAL FILES at a pinned version (never a clone or
 symlink of the private repo), then wires the consumer (pointer-symlinks, the
@@ -607,6 +608,45 @@ function channelBase(opts, pin) {
   return DEFAULT_CHANNEL_URL;
 }
 
+// CHG-91 (FF-305) / ADR-0128: a plain `update` (no --version) re-requests the
+// already-pinned version — there is deliberately no `latest` lookup, so the
+// maintainer-controlled pin is what moves a consumer forward, never a bare
+// `update`. That is correct and, read at the terminal, indistinguishable from
+// a real update: checksum verified, engine materialised, "Done" — every line
+// individually true while nothing moved. This decides which of the two a run
+// actually was and phrases the one line every run ends on accordingly, so the
+// two stop reading the same.
+//
+// Pure: takes exactly what the caller already resolved (the requested version,
+// the version the PIN had before this run touched it, and the version that got
+// installed) and returns strings — no I/O, so it is unit-testable without a
+// network fetch, the same reason resolveSource()/channelBase() are pure.
+//
+// `requestedVersion` falsy is the whole trigger: when it holds, `targetVersion`
+// upstream resolves to `opts.version || pin.version` picking `pin.version`, so
+// `installedVersion` equals `priorVersion` by construction — this function does
+// not re-derive that equality, it names the case that produces it. A bare
+// `update` with no requested version AND no prior pin dies earlier (in
+// resolveSource, "no engine version to install"), so that combination never
+// reaches here.
+function describeUpdateOutcome(command, requestedVersion, priorVersion, installedVersion) {
+  if (command === 'update' && !requestedVersion) {
+    return {
+      isNoOp: true,
+      note:
+        `ℹ️  re-materialised the PINNED version ${installedVersion} — update never moves ` +
+        `the pin by design (ADR-0128). To adopt a different release: --version <v>.`,
+      done: `Done (${command}) — pin unchanged at ${installedVersion}.`,
+    };
+  }
+  const moved = command === 'update' && priorVersion && priorVersion !== installedVersion;
+  return {
+    isNoOp: false,
+    note: null,
+    done: moved ? `Done (${command}) — ${priorVersion} → ${installedVersion}.` : `Done (${command}).`,
+  };
+}
+
 function resolveSource(opts, pin) {
   if (opts.from) return { kind: 'file', via: 'local-file', ref: path.resolve(opts.from) };
 
@@ -1414,6 +1454,11 @@ async function materialise(opts) {
       (matrixVersionOfEngine && matrixVersionOfEngine !== installedVersion ? `, matrix ${matrixVersionOfEngine}` : '') +
       ')'
   );
+  // CHG-91 / ADR-0128: `describeUpdateOutcome` decides whether THIS run moved
+  // the pin — pure, so the no-op/real-update split is unit-testable without a
+  // network fetch (the same reason resolveSource()/channelBase() are pure).
+  const outcome = describeUpdateOutcome(opts.command, opts.version, pin.version, installedVersion);
+  if (outcome.note) info(outcome.note);
   if (!targetVersion && matrixVersionOfEngine) {
     // Reached only by `--from <tarball>` with no --version and no pin: there is
     // no release id to record, so the pin gets the engine's matrix version as a
@@ -1556,7 +1601,7 @@ async function materialise(opts) {
   }
 
   info('');
-  info(`Done (${opts.command}).`);
+  info(outcome.done);
   for (const line of requiredNextSteps({ consumerRoot, wiring })) info(line);
 }
 
@@ -1655,5 +1700,6 @@ module.exports = {
   envNamespaceObserved,
   resetEnvNamespaceObservation,
   engineMatrixVersion,
+  describeUpdateOutcome,
   requiredNextSteps,
 };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@mindexed/cfact",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Clean Orthogonal Architecture Software Factory Framework",
   "bin": {
-    "claude-factory": "bin/claude-factory.js",
-    "cfact": "bin/claude-factory.js"
+    "claude-factory": "bin/cfact.js",
+    "cfact": "bin/cfact.js"
   },
   "files": [
     "bin/"
@@ -24,12 +24,15 @@
     "gate:compliance": "node scripts/audit-framework-compliance.js",
     "gate:doc-links": "node scripts/check-doc-links.js",
     "gate:command-metadata": "node scripts/check-command-metadata.js",
+    "gate:agent-context-inputs": "node scripts/check-agent-context-inputs.js",
     "gate:tracked-symlinks": "node scripts/check-tracked-symlinks.js",
     "gate:agents-md-sync": "node scripts/check-agents-md-sync.js",
     "gate:ripple-coverage": "node scripts/check-ripple-coverage.js",
     "gate:profile-docs": "node scripts/check-profile-docs.js",
     "gate:profile-coverage": "node scripts/check-profile-coverage.js",
+    "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",
     "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",
@@ -38,18 +41,25 @@
     "test:json-flush": "node scripts/test-json-flush.js",
     "test:installer-exit": "node scripts/test-installer-exit.js",
     "test:installer-channel": "node scripts/test-installer-channel.js",
+    "test:installer-update-messaging": "node scripts/test-installer-update-messaging.js",
     "test:installer-wiring": "node scripts/test-installer-wiring.js",
     "test:tar-invocation": "node scripts/test-tar-invocation.js",
     "test:framework-agents-mcp": "node scripts/test-framework-agents-mcp.js",
     "test:controller-gates": "node scripts/test-controller-gates.js",
+    "test:controller-single-file-attribution": "node scripts/test-controller-single-file-attribution.js",
+    "test:parse-ast": "node skills/ast-parser/scripts/test-parse-ast.js",
     "test:git-tree-sweep": "node scripts/test-git-tree-sweep.js",
     "test:secrets-two-stage": "node scripts/test-secrets-two-stage.js",
     "test:profile-paths": "node scripts/verify-profiles.js",
     "test:registry-gate": "node scripts/test-registry-gate.js",
+    "test:rule-resolver": "node scripts/test-rule-resolver.js",
     "test:adr-template-edges": "node scripts/test-adr-template-edges.js",
     "test:adr-path-constants": "node scripts/test-adr-path-constants.js",
+    "test:resolver-topology": "node scripts/test-resolver-topology.js",
     "test:graph-strip": "node scripts/test-graph-frontmatter-strip.js",
     "test:graph-registry": "node scripts/test-graph-registry.js",
+    "test:graph-memory-substrate": "node scripts/test-graph-memory-substrate.js",
+    "test:document-freshness": "node scripts/test-document-freshness.js",
     "test:frontmatter-readers": "node scripts/test-frontmatter-readers.js",
     "test:tarball-reproducible": "node scripts/test-tarball-reproducible.js",
     "test:release-version": "node scripts/test-release-version-lib.js",
@@ -57,22 +67,44 @@
     "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",
+    "test:artifact-timestamps": "node scripts/test-artifact-timestamps.js",
+    "test:engine-write-lock": "node scripts/test-engine-write-lock.js",
     "test:installer-publish-drift": "node scripts/test-installer-publish-drift.js",
     "test:grants-authored": "node scripts/test-grants-authored.js",
     "test:test-capability": "node scripts/test-test-capability.js",
     "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-write-guard": "node scripts/test-feature-write-guard.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: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:changelog && 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-wiring && npm run test:tar-invocation && npm run test:framework-agents-mcp && npm run test:controller-gates && 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:adr-template-edges && npm run test:adr-path-constants && npm run test:graph-strip && npm run test:graph-registry && 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: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:installer-shadowing && npm run test:feature-record && npm run test:consumer-docs-migration && npm run test:npm-deprecation",
+    "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",
     "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",
+    "test:policy-lib": "node scripts/test-policy-lib.js",
+    "test:validate-zone-denylist-bypass": "node scripts/test-validate-zone-denylist-bypass.js",
+    "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: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"
+    "test:npm-deprecation": "node scripts/test-npm-deprecation.js",
+    "test:generate-erd": "node scripts/test-generate-erd.js",
+    "test:surfaces-layerpaths": "node scripts/test-surfaces-layerpaths.js",
+    "test:list-feature-files": "node scripts/test-list-feature-files.js",
+    "test:generate-project-analysis": "node scripts/test-generate-project-analysis.js",
+    "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: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"
   },
   "keywords": [],
   "author": "",