agentic-workflow-manager 9.22.0 → 9.22.1

package/dist/tests/structural/sensor-documentation-contract.test.js

@@ -5,13 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const commander_1 = require("commander");
 jest.mock('@clack/prompts', () => ({
     log: { error: jest.fn(), success: jest.fn(), warn: jest.fn(), info: jest.fn() },
 }));
 const manifest_1 = require("../../src/commands/sensors/compatibility/manifest");
-const ledger_1 = require("../../src/commands/ledger");
-const sensors_1 = require("../../src/commands/sensors");
 const ROOT = path_1.default.resolve(__dirname, '../../..');
 const read = (file) => fs_1.default.readFileSync(path_1.default.join(ROOT, file), 'utf8');
 function documentedJson(files) {
@@ -35,26 +32,7 @@ function documentedV2Manifests(files) {
         && example.value.schemaVersion === 2)
         .map(example => example.value);
 }
-function helpFor(command) {
-    const program = new commander_1.Command().name('awm');
-    (0, sensors_1.registerSensorsCommand)(program);
-    (0, ledger_1.registerLedgerCommand)(program);
-    const [parent, child] = command.split(' ');
-    return program.commands.find((entry) => entry.name() === parent)
-        .commands.find((entry) => entry.name() === child).helpInformation();
-}
 describe('R3 canonical sensor documentation', () => {
-    test.each([
-        ['docs/framework.md', ['Static coverage', 'Empirical coverage', 'retrospective feedback loop']],
-        ['docs/configuration.md', ['pack schema v2', 'legacy pack', 'compatible-unverified']],
-        ['docs/project-setup.md', ['version-aware', 'hardening opt-in']],
-        ['docs/runbook.md', ['awm sensors coverage --min', 'compatibility drift', 'orphaned asset']],
-        ['docs/cli-reference.md', ['schemaVersion: 2', '--defect-class', '--min']],
-        ['docs/architecture.md', ['compatibility resolver', 'bounded probe']],
-    ])('%s owns its R3 subject', (file, phrases) => {
-        const text = read(file);
-        phrases.forEach((phrase) => expect(text).toContain(phrase));
-    });
     test('parses every documented v2 sensor manifest example with the production parser', () => {
         const examples = documentedV2Manifests(['docs/configuration.md', 'docs/cli-reference.md']);
         expect(examples.length).toBeGreaterThan(0);
@@ -77,29 +55,4 @@ describe('R3 canonical sensor documentation', () => {
             schemaVersion: 2, pack: 'js-ts', sensors: { test: { enabled: true, variantId: 'npm-script' } },
         }, 'invalid full manifest')).toThrow();
     });
-    test('documents exact Commander flags', () => {
-        expect(helpFor('sensors coverage')).toContain('--min <count>');
-        expect(helpFor('ledger add')).toContain('--defect-class <id>');
-        const reference = read('docs/cli-reference.md');
-        expect(reference).toContain('awm sensors coverage [--json] [--min <count>]');
-        expect(reference).toContain('--defect-class <id>');
-    });
-    test('does not overstate the human coverage renderer or retrospective archive wiring', () => {
-        const reference = read('docs/cli-reference.md');
-        const runbook = read('docs/runbook.md');
-        expect(reference).toMatch(/safe,\s+sanitized evidence references and safe cluster signatures/);
-        expect(reference).toMatch(/never ledger\s+descriptions, raw ledger lines, or unsafe values/);
-        expect(runbook).toContain('Run `awm sensors coverage --min 2` manually before archive');
-        expect(runbook).toMatch(/Automatic\s+coverage-before-archive enforcement is delivered by the registry in T12/);
-        expect(runbook).not.toContain('it automatically evaluates\ncoverage feedback');
-    });
-    test('keeps archival coverage manual until registry enforcement and scopes v2 binary resolution', () => {
-        const framework = read('docs/framework.md');
-        const osMatrix = read('docs/testing/os-matrix.md');
-        expect(framework).toMatch(/manual operator step[\s\S]*until the registry delivers automatic enforcement in T12/i);
-        expect(osMatrix).toMatch(/v2 local resolution modes use project-local `node_modules` or `.venv`\/`venv`\s+environments/i);
-        expect(osMatrix).toMatch(/Windows `.cmd`\/`.bat` wrappers are rejected for structured v2\s+commands/i);
-        expect(osMatrix).toMatch(/Legacy string\s+commands remain separate and retain their documented shell\/PATH semantics/i);
-        expect(osMatrix).not.toContain('Sensors resolve their binaries on PATH');
-    });
 });

package/dist/tests/structural/sensor-portability-contract.test.js

@@ -24,13 +24,6 @@ describe('Publication B portable bootstrap contract', () => {
         expect(help).toContain('--reason <text>');
         expect(help).toContain('--dry-run');
     });
-    it('documents schema v3, explicit migration, dry-run, and environment separation', () => {
-        const reference = fs_1.default.readFileSync(path_1.default.join(root, 'docs/cli-reference.md'), 'utf8');
-        expect(reference).toContain('awm sensors bootstrap [--mode project-sensors|native-gate|opt-out] [--reason <text>] [--dry-run]');
-        expect(reference).toContain('schemaVersion: 3');
-        expect(reference).toContain('never writes');
-        expect(reference).toContain('each environment updates its own AWM installation separately');
-    });
     it('keeps all documented v3 declarations free of machine registry paths', () => {
         const reference = fs_1.default.readFileSync(path_1.default.join(root, 'docs/cli-reference.md'), 'utf8');
         const examples = Array.from(reference.matchAll(/```json\s*\n([\s\S]*?)```/g), match => JSON.parse(match[1]));

package/dist/tests/structural/simple-git-v4-pin.test.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const CLI_ROOT = path_1.default.resolve(__dirname, '..', '..');
+const FACTORY = 'src/core/registry-git.ts';
+describe('simple-git v4 pin (#238)', () => {
+    it('pins simple-git exactly to 4.0.2', () => {
+        const pkg = JSON.parse(fs_1.default.readFileSync(path_1.default.join(CLI_ROOT, 'package.json'), 'utf8'));
+        expect(pkg.dependencies['simple-git']).toBe('4.0.2');
+    });
+    it('imports simple-git only from registry-git.ts via named simpleGit', () => {
+        const factory = fs_1.default.readFileSync(path_1.default.join(CLI_ROOT, FACTORY), 'utf8');
+        expect(factory).toMatch(/import\s*\{[^}]*\bsimpleGit\b[^}]*\}\s*from\s*['"]simple-git['"]/);
+        expect(factory).not.toMatch(/import\s+simpleGit\s+from\s*['"]simple-git['"]/);
+        const walk = (dir) => {
+            const out = [];
+            for (const ent of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+                const p = path_1.default.join(dir, ent.name);
+                if (ent.isDirectory())
+                    out.push(...walk(p));
+                else if (ent.name.endsWith('.ts'))
+                    out.push(p);
+            }
+            return out;
+        };
+        for (const file of walk(path_1.default.join(CLI_ROOT, 'src'))) {
+            const rel = path_1.default.relative(CLI_ROOT, file).replace(/\\/g, '/');
+            if (rel === FACTORY)
+                continue;
+            const text = fs_1.default.readFileSync(file, 'utf8');
+            expect(text).not.toMatch(/from\s*['"]simple-git['"]/);
+            expect(text).not.toMatch(/\bsimpleGit\s*\(/);
+        }
+    });
+    it('factory allowEnvironment is only GIT_TERMINAL_PROMPT and enables no allowUnsafe*', () => {
+        const factory = fs_1.default.readFileSync(path_1.default.join(CLI_ROOT, FACTORY), 'utf8');
+        expect(factory).toMatch(/allowEnvironment:\s*\[\s*['"]GIT_TERMINAL_PROMPT['"]\s*\]/);
+        expect(factory).not.toMatch(/allowUnsafe/);
+        // B1 / V1: factory must use the shared constant (not a duplicated literal).
+        expect(factory).toMatch(/timeout:\s*\{\s*block:\s*REGISTRY_GIT_TIMEOUT_MS\s*\}/);
+        expect(factory).toMatch(/export\s+const\s+REGISTRY_GIT_TIMEOUT_MS\s*=\s*60_?000\s*;/);
+        // SG-3: guarded env must be applied — deleting `.env(buildRegistryGitEnv())` must fail this pin.
+        expect(factory).toMatch(/\.env\(\s*buildRegistryGitEnv\(\)/);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-workflow-manager",
-  "version": "9.22.0",
+  "version": "9.22.1",
   "main": "dist/src/index.js",
   "bin": {
     "awm": "./dist/src/index.js"
@@ -55,7 +55,7 @@
     "picocolors": "^1.1.1",
     "picomatch": "4.0.7",
     "semver": "^7.7.4",
-    "simple-git": "3.36.0"
+    "simple-git": "4.0.2"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",

package/dist/tests/structural/cloud-admission-docs-contract.test.js

@@ -1,54 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/** CMD-DOCS — V-R4 (issue #215 documentation). */
-const repoRoot = path_1.default.resolve(__dirname, '../../..');
-/** Whitespace-normalized so re-wrapping the prose never breaks a pinned phrase. */
-const read = (relative) => fs_1.default.readFileSync(path_1.default.join(repoRoot, ...relative.split('/')), 'utf8').replace(/\s+/g, ' ');
-describe('issue #215 documentation contract (V-R4)', () => {
-    const configuration = read('docs/configuration.md');
-    it('documents .awm/admission.json with defaults, the git rule and the accepted risk', () => {
-        expect(configuration).toContain('## Read-only admission observation (`.awm/admission.json`)');
-        for (const name of ['node_modules', '.next', '.turbo', 'dist', 'build', 'coverage', '.venv', 'target'])
-            expect(configuration).toContain(`\`${name}\``);
-        expect(configuration).toContain('git-ignored and contains no tracked file');
-        expect(configuration).toContain('**Accepted risk:**');
-        expect(configuration).toContain('`admission-config-invalid`');
-        expect(configuration).toContain('`readOnlyObservation`');
-        expect(configuration).toContain('`awm plan admit` does not print it');
-    });
-    it.each([
-        '250000',
-        '1 GiB',
-        '`read-only-mutation-detected`',
-        '`read-only-observation-unavailable`',
-        '`not-ignored`',
-        '`contains-tracked`',
-        '`git-unavailable`',
-        '`.git` or `.awm`',
-        'never skipped',
-        'including any `.awm` or `.git` nested',
-        'regular file',
-        '65536 bytes',
-    ])('documents the observation limit, reason code or reserved-name rule %s', literal => {
-        expect(configuration).toContain(literal);
-    });
-    it('points --verify-sensors in the CLI reference at the observation rules', () => {
-        const doc = read('docs/cli-reference.md');
-        expect(doc).toContain('configuration.md#read-only-admission-observation-awmadmissionjson');
-        expect(doc).toContain('`ADMISSION_SENSORS_BLOCKED`');
-    });
-    it('states that the D-7 insteadOf recipe passes strict currentness', () => {
-        const doc = read('docs/operations/cloud-and-platforms.md');
-        expect(doc).toContain('`awm preflight --require-current`');
-        expect(doc).toContain('`remote.origin.url`');
-        expect(doc).toContain('--local');
-    });
-    it('describes the snapshot exclusions in the plan admit help', () => {
-        expect(read('cli/src/commands/plan/index.ts')).toContain("'require an empirical sensor pass; read-only observation skips git-ignored build output (see .awm/admission.json)'");
-    });
-});

package/dist/tests/structural/documentation-phase-is-mechanized.test.js

@@ -1,29 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const ROOT = path_1.default.resolve(__dirname, '../../..');
-const read = (file) => fs_1.default.readFileSync(path_1.default.join(ROOT, file), 'utf8');
-describe('la fase de documentacion esta mecanizada, no solo enunciada', () => {
-    it('CONSTITUTION.md enuncia la regla y nombra el marker', () => {
-        const text = read('CONSTITUTION.md');
-        expect(text).toMatch(/awm-docs-complete/);
-        expect(text).toMatch(/post-implementation-docs/);
-    });
-    it('CONSTITUTION.md apunta al mecanismo, no lo reemplaza', () => {
-        const text = read('CONSTITUTION.md');
-        // debe citar el archivo que efectivamente hace cumplir la regla
-        expect(text).toMatch(/plan-state\.ts/);
-        expect(text).toMatch(/development-process/);
-    });
-    it('el enunciado NO es el unico lugar donde la fase existe', () => {
-        // Si esto pasa solo por CONSTITUTION.md, la regla es decorativa.
-        expect(read('cli/src/core/dashboard/plan-state.ts')).toMatch(/docsComplete/);
-        expect(read('cli/src/core/dashboard/plan-state.ts')).toMatch(/docs_pending/);
-        expect(read('cli/src/core/dashboard/sanitize.ts')).toMatch(/docsComplete/);
-        expect(read('cli/src/commands/evidence/index.ts')).toMatch(/awm-docs-complete/);
-    });
-});

package/dist/tests/structural/operator-environments-docs-contract.test.js

@@ -1,70 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * CMD-SCAFFOLD-DOCS — RF-5.2 operator-environments documentation contract.
- * Asserts runbook + cli-reference document scaffold/doctor/env and state that
- * awm-cenco-infra-registry migration is out of scope (RF-5.2).
- */
-const repoRoot = path_1.default.resolve(__dirname, '../../..');
-const runbookPath = path_1.default.join(repoRoot, 'docs', 'runbook.md');
-const cliReferencePath = path_1.default.join(repoRoot, 'docs', 'cli-reference.md');
-const designPath = 'docs/plans/2026-10-12-operator-environments-design.md';
-function teamRegistriesSection(runbook) {
-    const start = runbook.indexOf('## Team registries');
-    expect(start).toBeGreaterThanOrEqual(0);
-    const rest = runbook.slice(start);
-    const nextH2 = rest.search(/\n## (?!Team)/);
-    return nextH2 === -1 ? rest : rest.slice(0, nextH2);
-}
-function registriesSection(cliRef) {
-    const start = cliRef.indexOf('## Registries & pinning');
-    expect(start).toBeGreaterThanOrEqual(0);
-    const rest = cliRef.slice(start);
-    const nextH2 = rest.search(/\n## (?!Registries)/);
-    return nextH2 === -1 ? rest : rest.slice(0, nextH2);
-}
-describe('operator-environments docs contract (RF-5.2)', () => {
-    it('runbook team-registries leads with scaffold and mentions doctor + design RF-5.2 out-of-scope', () => {
-        const runbook = fs_1.default.readFileSync(runbookPath, 'utf-8');
-        const section = teamRegistriesSection(runbook);
-        const scaffoldIdx = section.indexOf('awm registry scaffold');
-        const addIdx = section.indexOf('awm registry add');
-        expect(scaffoldIdx).toBeGreaterThanOrEqual(0);
-        expect(addIdx).toBeGreaterThan(scaffoldIdx);
-        expect(section).toContain('awm registry doctor');
-        // RF-5.2: Cenco infra registry is out of scope — require the out-of-scope
-        // phrase near the cenco mention (same paragraph/window), not a loose
-        // match elsewhere in the section.
-        expect(section).toMatch(/RF-5\.2/);
-        expect(section).toContain(designPath);
-        const cencoIdx = section.search(/awm-cenco-infra-registry/);
-        expect(cencoIdx).toBeGreaterThanOrEqual(0);
-        const windowStart = Math.max(0, cencoIdx - 120);
-        const windowEnd = Math.min(section.length, cencoIdx + 160);
-        const nearCenco = section.slice(windowStart, windowEnd);
-        expect(nearCenco).toMatch(/out of scope|out-of-scope|does not modify|SHALL NOT modify/i);
-    });
-    it('cli-reference documents registry scaffold, registry doctor, and awm env', () => {
-        const cliRef = fs_1.default.readFileSync(cliReferencePath, 'utf-8');
-        const registries = registriesSection(cliRef);
-        expect(registries).toMatch(/###\s+`awm registry scaffold/);
-        expect(registries).toMatch(/###\s+`awm registry doctor/);
-        // env lives as its own H2; require the three command strings in the file
-        // with scoped checks so headings cannot be satisfied by a stray mention.
-        expect(cliRef).toContain('awm registry scaffold');
-        expect(cliRef).toContain('awm registry doctor');
-        const envStart = cliRef.search(/^##\s+.*\benv\b/im);
-        expect(envStart).toBeGreaterThanOrEqual(0);
-        const envRest = cliRef.slice(envStart);
-        const envNext = envRest.search(/\n## /);
-        const envSection = envNext === -1 ? envRest : envRest.slice(0, envNext);
-        expect(envSection).toMatch(/awm env/);
-        expect(envSection).toMatch(/env set|`awm env set`/i);
-        expect(envSection).toMatch(/env status|`awm env status`/i);
-    });
-});

package/dist/tests/structural/process-model-description-contract.test.js

@@ -1,34 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const DESIGN = path_1.default.resolve(__dirname, '../../../docs/plans/2026-08-23-process-lifecycle-design.md');
-function artifactSection() {
-    const text = fs_1.default.readFileSync(DESIGN, 'utf8');
-    const start = text.indexOf('### El artefacto');
-    expect(start).toBeGreaterThan(-1);
-    const end = text.indexOf('\n### ', start + 1);
-    return text.slice(start, end === -1 ? undefined : end);
-}
-describe('process-model contract documents the optional description (PD-4)', () => {
-    it('lists description in the frontmatter block as optional', () => {
-        const section = artifactSection();
-        expect(section).toMatch(/^description: <texto de una línea> {2}# opcional$/m);
-    });
-    it('states the rules the parser enforces and why the field exists', () => {
-        /** Whitespace-normalized so re-wrapping the prose never breaks a pinned phrase. */
-        const section = artifactSection().replace(/\s+/g, ' ');
-        expect(section).toContain('#### Enmienda 2026-10-18 — `description` opcional');
-        expect(section).toContain('una sola línea');
-        expect(section).toContain('1024 caracteres');
-        expect(section).toContain('Codex');
-        expect(section).toContain('único campo opcional');
-        expect(section).toContain('parser YAML');
-        expect(section).not.toContain('no reemplaza a un parser YAML');
-        expect(section).toContain('code points');
-        expect(section).toContain('caracteres de control');
-    });
-});

package/dist/tests/structural/project-declared-sensors-docs-contract.test.js

@@ -1,104 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * CMD-DOCS — RF-5.1 / RF-5.2 (project-declared sensors documentation).
- *
- * Resolves awm-baseline-registry from (in order):
- * 1. `AWM_BASELINE_REGISTRY_ROOT` (CI docs checkout)
- * 2. nested `repoRoot/awm-baseline-registry` (CI support-matrix layout)
- * 3. sibling `repoRoot/../awm-baseline-registry` (maintainer workspace)
- *
- * Prefer a checkout that already contains RF-5.1 (`## Project sensors vs packs`).
- * Missing / too-old checkouts fail loudly (no silent skip).
- */
-const repoRoot = path_1.default.resolve(__dirname, '../../..');
-const cliReferencePath = path_1.default.join(repoRoot, 'docs', 'cli-reference.md');
-const RF51_HEADING = '## Project sensors vs packs';
-function setupSensorsSkillPath(registryRoot) {
-    return path_1.default.join(registryRoot, 'skills', 'setup-sensors', 'SKILL.md');
-}
-function resolveSetupSensorsPath() {
-    const envRoot = process.env.AWM_BASELINE_REGISTRY_ROOT?.trim();
-    // When CI/maintainer sets the override, that root is authoritative (no silent
-    // fallback to a nested immutable pin that lacks RF-5.1 prose).
-    const candidates = envRoot
-        ? [path_1.default.resolve(envRoot)]
-        : [
-            path_1.default.join(repoRoot, 'awm-baseline-registry'),
-            path_1.default.join(repoRoot, '..', 'awm-baseline-registry'),
-        ];
-    const existing = candidates
-        .map(root => ({ root, skill: setupSensorsSkillPath(root) }))
-        .filter(entry => fs_1.default.existsSync(entry.skill));
-    if (existing.length === 0) {
-        throw new Error('Baseline registry checkout missing for RF-5.1 docs contract. Tried:\n'
-            + candidates.map(root => `  - ${setupSensorsSkillPath(root)}`).join('\n')
-            + '\nClone awm-baseline-registry as a sibling, nest it under the CLI repo, '
-            + 'or set AWM_BASELINE_REGISTRY_ROOT to a checkout that includes setup-sensors RF-5.1.');
-    }
-    const withRf51 = existing.find(entry => fs_1.default.readFileSync(entry.skill, 'utf8').includes(RF51_HEADING));
-    if (!withRf51) {
-        throw new Error('Baseline registry checkout is present but too old for RF-5.1 '
-            + `(missing ${RF51_HEADING}). Checked:\n`
-            + existing.map(entry => `  - ${entry.skill}`).join('\n')
-            + '\nPoint AWM_BASELINE_REGISTRY_ROOT at a registry tip that documents project-declared sensors '
-            + '(coordinated awm-baseline-registry PR), without replacing the immutable v2.0.1 support-matrix pin.');
-    }
-    return withRf51.skill;
-}
-function sensorsSection(text) {
-    const start = text.indexOf('## Sensors (per-project computational checks)');
-    expect(start).toBeGreaterThanOrEqual(0);
-    const rest = text.slice(start);
-    const nextH2 = rest.search(/\n## (?!Sensors)/);
-    return nextH2 === -1 ? rest : rest.slice(0, nextH2);
-}
-/** Skill body after YAML frontmatter (content after the closing `---`). */
-function skillBody(skill) {
-    const match = skill.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n([\s\S]*)$/);
-    if (!match) {
-        throw new Error('setup-sensors SKILL.md missing YAML frontmatter delimiters');
-    }
-    return match[1];
-}
-/** Named H2 section inside the skill body; fails if the heading is absent. */
-function skillSection(body, heading) {
-    const start = body.indexOf(heading);
-    expect(start).toBeGreaterThanOrEqual(0);
-    const rest = body.slice(start);
-    const nextH2 = rest.search(/\n## /);
-    return nextH2 === -1 ? rest : rest.slice(0, nextH2);
-}
-describe('project-declared sensors docs contract (CMD-DOCS)', () => {
-    it('cli-reference sensors section documents project markers, provenance, exit-code, and non-gating (RF-5.2)', () => {
-        const text = fs_1.default.readFileSync(cliReferencePath, 'utf8');
-        const section = sensorsSection(text);
-        expect(section).toMatch(/source:\s*"project"|source"\s*:\s*"project"/);
-        expect(section).toContain('project-declared');
-        expect(section).toContain('exit-code');
-        expect(section).toMatch(/provenance[\s\S]{0,220}(?:does not|never)\s+(?:block|blocks)[\s\S]{0,100}(?:unattended|gates)/i);
-        // Optional pack (omit or null) — RF-5.2 clause already in cli-reference prose.
-        expect(section).toMatch(/[Pp]ack may be omitted or set\s+to\s+`?null`?[\s\S]{0,120}project-declared/i);
-        // JSON-vs-schema diagnostics distinction — RF-5.2.
-        expect(section).toMatch(/not valid JSON[\s\S]{0,220}schema-invalid/i);
-    });
-    it('setup-sensors skill documents project vs pack, JSON example, and non-gating provenance (RF-5.1)', () => {
-        const setupSensorsPath = resolveSetupSensorsPath();
-        const skill = fs_1.default.readFileSync(setupSensorsPath, 'utf8');
-        const body = skillBody(skill);
-        // Scope when-to-use / project-vs-packs (and related RF-5.1 prose) to the
-        // dedicated body section — frontmatter description must not satisfy these.
-        const projectVsPacks = skillSection(body, RF51_HEADING);
-        // Both guidance clauses are required — Prefer|Declare OR let either alone satisfy.
-        expect(projectVsPacks).toMatch(/Prefer a \*\*pack\*\*/);
-        expect(projectVsPacks).toMatch(/Declare a \*\*project sensor\*\*\s+when\s+the check is project-owned/i);
-        expect(projectVsPacks).toMatch(/"source"\s*:\s*"project"/);
-        expect(projectVsPacks).toMatch(/```json[\s\S]*?"source"\s*:\s*"project"[\s\S]*?```/);
-        expect(projectVsPacks).toMatch(/project-declared[\s\S]{0,220}(?:does not|never)\s+(?:block|blocks)[\s\S]{0,100}unattended/i);
-    });
-});

package/dist/tests/structural/r4-plan-currentness-docs.test.js

@@ -1,37 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const cliReference = fs_1.default.readFileSync(path_1.default.resolve(__dirname, '../../../docs/cli-reference.md'), 'utf8');
-const readme = fs_1.default.readFileSync(path_1.default.resolve(__dirname, '../../../README.md'), 'utf8');
-const installation = fs_1.default.readFileSync(path_1.default.resolve(__dirname, '../../../docs/installation.md'), 'utf8');
-const developmentProcess = fs_1.default.readFileSync(path_1.default.resolve(__dirname, '../../../docs/guides/development-process.md'), 'utf8');
-describe('R4 plan/currentness documentation contract', () => {
-    it('documents plan validation and the unchanged legacy path', () => {
-        expect(cliReference).toContain('awm plan validate PLAN_PATH');
-        expect(cliReference).toMatch(/legacy/i);
-    });
-    it('documents strict currentness separately from minCliVersion compatibility', () => {
-        expect(cliReference).toContain('--require-current');
-        expect(cliReference).toContain('minCliVersion');
-        expect(cliReference).toMatch(/currentness[\s\S]{0,700}compatib|compatib[\s\S]{0,700}currentness/i);
-    });
-    it('documents the exact cache-resistant bootstrap and its enforceable boundary', () => {
-        expect(cliReference).toContain('npm exec --yes --package=agentic-workflow-manager@latest -- awm preflight --require-current');
-        expect(cliReference).toMatch(/fresh CLI\/bootstrap/i);
-        expect(cliReference).toMatch(/cannot update a host or cached container that\s+never runs new code/i);
-    });
-    it('keeps supported commands, remedies, bootstrap, and the enforceable boundary discoverable across user docs', () => {
-        expect(readme).toContain('awm plan validate PLAN_PATH');
-        expect(readme).toContain('awm preflight --require-current');
-        expect(installation).toContain('npm exec --yes --package=agentic-workflow-manager@latest -- awm preflight --require-current');
-        expect(installation).toMatch(/cannot update a host or cached container that\s+never runs new code/i);
-        expect(developmentProcess).toContain('awm preflight --require-current');
-        expect(developmentProcess).toContain('awm plan validate PLAN_PATH');
-        expect(developmentProcess).toMatch(/awm update --yes/);
-        expect(cliReference).toMatch(/awm unpin REGISTRY_NAME.*awm update --yes/s);
-    });
-});

package/dist/tests/structural/sensor-execution-optimization-docs-contract.test.js

@@ -1,102 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * CMD-CLI-DOCS — RF-3.3 sensor execution optimization CLI reference.
- *
- * Section-scoped asserts only: a whole-file keyword must not satisfy these.
- * No registry file reads (CLI plan S5).
- */
-const repoRoot = path_1.default.resolve(__dirname, '../../..');
-const cliReferencePath = path_1.default.join(repoRoot, 'docs', 'cli-reference.md');
-function readCliReference() {
-    return fs_1.default.readFileSync(cliReferencePath, 'utf8');
-}
-/** H2 Sensors block through the next H2. */
-function sensorsSection(text) {
-    const start = text.indexOf('## Sensors (per-project computational checks)');
-    expect(start).toBeGreaterThanOrEqual(0);
-    const rest = text.slice(start);
-    const nextH2 = rest.search(/\n## (?!Sensors)/);
-    return nextH2 === -1 ? rest : rest.slice(0, nextH2);
-}
-/** Named H3 inside a parent section; fails if the heading is absent. */
-function h3Section(parent, heading) {
-    const start = parent.indexOf(heading);
-    expect(start).toBeGreaterThanOrEqual(0);
-    const rest = parent.slice(start);
-    const next = rest.search(/\n### /);
-    return next === -1 ? rest : rest.slice(0, next);
-}
-/** Named H4 inside a parent section; fails if the heading is absent. */
-function h4Section(parent, heading) {
-    const start = parent.indexOf(heading);
-    expect(start).toBeGreaterThanOrEqual(0);
-    const rest = parent.slice(start);
-    const next = rest.search(/\n#### /);
-    return next === -1 ? rest : rest.slice(0, next);
-}
-describe('sensor execution optimization docs contract (CMD-CLI-DOCS / RF-3.3)', () => {
-    it('documents authored inputs and sensor-level closureOnly under Sensors', () => {
-        const sensors = sensorsSection(readCliReference());
-        const section = h3Section(sensors, '### Inputs and closureOnly');
-        expect(section).toMatch(/`inputs`/);
-        expect(section).toMatch(/variant|project override|pack/i);
-        expect(section).toMatch(/no effective `inputs`[\s\S]{0,160}always execute|always execute[\s\S]{0,160}no effective `inputs`/i);
-        expect(section).toMatch(/`closureOnly`/);
-        expect(section).toMatch(/sensor-level|sensor object/i);
-        expect(section).toMatch(/mutation[\s\S]{0,120}closureOnly|closureOnly[\s\S]{0,120}mutation/i);
-    });
-    it('documents --slice and --no-cache on awm sensors run', () => {
-        const sensors = sensorsSection(readCliReference());
-        const run = h3Section(sensors, '### `awm sensors run`');
-        expect(run).toMatch(/--slice/);
-        expect(run).toMatch(/closureOnly/);
-        expect(run).toMatch(/--slice[\s\S]{0,200}(?:reject|refuse|not combine|cannot(?:\s+be)?\s+combin)[\s\S]{0,80}--(?:all|slow)|(?:--all|--slow)[\s\S]{0,120}(?:reject|refuse|not combine|cannot(?:\s+be)?\s+combin)[\s\S]{0,80}--slice/i);
-        expect(run).toMatch(/--no-cache/);
-        expect(run).toMatch(/isFullSelection|full[- ]gate|Change Record receipt/i);
-        expect(run).toMatch(/--slice[\s\S]{0,200}(?:not|never|no)[\s\S]{0,80}receipt|receipt[\s\S]{0,120}--slice/i);
-    });
-    it('documents cache hit semantics, provenance, fingerprint, and failureKind', () => {
-        const sensors = sensorsSection(readCliReference());
-        const cache = h4Section(h3Section(sensors, '### `awm sensors run`'), '#### Result cache');
-        expect(cache).toMatch(/cache hit|cached:\s*`?true`?/i);
-        expect(cache).toMatch(/originDirty/);
-        expect(cache).toMatch(/fingerprint|sensorFingerprint/i);
-        expect(cache).toMatch(/always-measured|alwaysMeasured/i);
-        expect(cache).toMatch(/live[\s\S]{0,80}version|liveState/i);
-        expect(cache).toMatch(/failureKind/);
-        expect(cache).toMatch(/findings/);
-        expect(cache).toMatch(/missing-binary|exit-code/);
-        expect(cache).toMatch(/\.awm\/sensors\/runs\//);
-        expect(cache).toMatch(/pre-baseline|before baseline|raw[\s\S]{0,40}baseline/i);
-        expect(cache).toMatch(/--changed[\s\S]{0,160}(?:not|never|must not)[\s\S]{0,80}(?:write|cache)|(?:write|cache)[\s\S]{0,120}(?:not|never)[\s\S]{0,80}--changed/i);
-    });
-    it('documents receipt schema 2 and RF-4.6 Change Record honesty', () => {
-        const sensors = sensorsSection(readCliReference());
-        const receipt = h4Section(h3Section(sensors, '### `awm sensors run`'), '#### Sensor receipt');
-        expect(receipt).toMatch(/"schema"\s*:\s*2|schema\s*`?2`?/);
-        expect(receipt).toMatch(/measurements/);
-        expect(receipt).toMatch(/alwaysMeasuredPaths|always-measured/i);
-        // RF-4.6 honesty only — "legacy late-path rules" elsewhere must not satisfy this.
-        expect(receipt).toMatch(/RF-4\.6[\s\S]{0,80}honesty[\s\S]{0,400}schema-1 late-path|schema-1 late-path[\s\S]{0,400}RF-4\.6[\s\S]{0,80}honesty/i);
-        expect(receipt).toMatch(/(?:any|every)[\s\S]{0,80}(?:without|no|lacks)[\s\S]{0,60}inputs[\s\S]{0,160}schema[\s\S]{0,40}1|schema[\s\S]{0,40}1[\s\S]{0,160}(?:without|no|lacks)[\s\S]{0,60}inputs/i);
-        expect(receipt).toMatch(/docs-only|documentation-only|docs only/i);
-        expect(receipt).toMatch(/project override/i);
-    });
-    it('documents RF-4.7 change new remedy honesty (full-gate + cache reuse)', () => {
-        const text = readCliReference();
-        const start = text.indexOf('### `awm change new <slug>`');
-        expect(start).toBeGreaterThanOrEqual(0);
-        const rest = text.slice(start);
-        const nextH3 = rest.search(/\n### /);
-        const section = nextH3 === -1 ? rest : rest.slice(0, nextH3);
-        // Must match REMEDY_RECEIPT honesty — not a bare `awm sensors run` that implies every binary re-execs.
-        expect(section).toMatch(/receipt-missing[\s\S]{0,200}full-gate[\s\S]{0,80}awm sensors run[\s\S]{0,120}cache may reuse/i);
-        expect(section.toLowerCase()).not.toMatch(/every tool|must re-exec|reexecute every/);
-    });
-});