agentic-workflow-manager 6.5.2 → 8.1.0

package/dist/tests/structural/r3-cli-major-version.test.js

@@ -0,0 +1,37 @@
+"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 child_process_1 = require("child_process");
+const CLI_ROOT = path_1.default.resolve(__dirname, '../..');
+const DIST_ENTRYPOINT = path_1.default.join(CLI_ROOT, 'dist', 'src', 'index.js');
+const TARGET_VERSION = '8.0.0';
+function readJson(file) {
+    return JSON.parse(fs_1.default.readFileSync(path_1.default.join(CLI_ROOT, file), 'utf8'));
+}
+function runCompiledCli(...args) {
+    const result = (0, child_process_1.spawnSync)(process.execPath, [DIST_ENTRYPOINT, ...args], {
+        cwd: CLI_ROOT,
+        encoding: 'utf8',
+    });
+    expect(result.error).toBeUndefined();
+    expect(result.status).toBe(0);
+    return `${result.stdout}${result.stderr}`;
+}
+describe('R3 public major CLI release contract', () => {
+    it('declares 8.0.0 consistently in package metadata and the lockfile root', () => {
+        const pkg = readJson('package.json');
+        const lock = readJson('package-lock.json');
+        const root = lock.packages[''];
+        expect(pkg.version).toBe(TARGET_VERSION);
+        expect(lock.version).toBe(TARGET_VERSION);
+        expect(root.version).toBe(TARGET_VERSION);
+    });
+    it('exposes 8.0.0 from the compiled CLI while retaining its help banner', () => {
+        expect(runCompiledCli('--version').trim()).toBe(TARGET_VERSION);
+        expect(runCompiledCli('--help')).toContain('Usage: awm');
+    });
+});

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

@@ -0,0 +1,77 @@
+"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 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) {
+    return files.flatMap((file) => Array.from(read(file).matchAll(/```json\s*\n([\s\S]*?)```/g), (match) => JSON.parse(match[1])));
+}
+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 = documentedJson(['docs/configuration.md', 'docs/cli-reference.md'])
+            .filter((value) => typeof value === 'object' && value !== null && value.schemaVersion === 2);
+        expect(examples.length).toBeGreaterThan(0);
+        examples.forEach((example) => expect(() => (0, manifest_1.parseSensorManifest)(example, 'documented example')).not.toThrow());
+    });
+    test('keeps documented v2 sensor manifests portable across native platforms', () => {
+        const examples = documentedJson(['docs/configuration.md', 'docs/cli-reference.md'])
+            .filter((value) => typeof value === 'object' && value !== null && value.schemaVersion === 2);
+        expect(examples.length).toBeGreaterThan(0);
+        examples.forEach((example) => expect(example).not.toHaveProperty('registryRoot'));
+    });
+    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/support-matrix-is-current.test.js

@@ -16,7 +16,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Este test hace que ese desvio sea imposible de mergear. No verifica que la tabla sea
 // "linda": verifica que sea LA MISMA que produce el codigo hoy.
 const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const support_matrix_1 = require("../../scripts/support-matrix");
+const sensor_support_matrix_1 = require("../../scripts/sensor-support-matrix");
+const SENSOR_FIXTURE_REGISTRY = path_1.default.join(__dirname, '..', 'fixtures', 'sensor-support-matrix', 'registry');
 describe('docs/support-matrix.md refleja el codigo', () => {
     it('el bloque generado esta al dia', () => {
         const doc = fs_1.default.readFileSync(support_matrix_1.DOC_PATH, 'utf-8');
@@ -30,6 +33,18 @@ describe('docs/support-matrix.md refleja el codigo', () => {
         expect(doc).toContain(support_matrix_1.BEGIN_MARKER);
         expect(doc).toContain(support_matrix_1.END_MARKER);
     });
+    it('the generated pre-publication v2 sensor-pack contract fixture is current', () => {
+        const doc = fs_1.default.readFileSync(support_matrix_1.DOC_PATH, 'utf-8');
+        expect(doc).toContain(sensor_support_matrix_1.SENSOR_BEGIN_MARKER);
+        expect(doc).toContain(sensor_support_matrix_1.SENSOR_END_MARKER);
+        expect(doc).toContain(sensor_support_matrix_1.R3_PREPUBLICATION_FIXTURE_PURPOSE);
+        expect(doc).toContain('not the published `awm-baseline-registry` manifests');
+        expect(doc).toBe((0, sensor_support_matrix_1.spliceSensorSupportMatrix)(doc, (0, sensor_support_matrix_1.renderSensorSupportMatrix)(SENSOR_FIXTURE_REGISTRY)));
+    });
+    it('pins the documentation generator to the declared R3 pre-publication fixture', () => {
+        const packageJson = JSON.parse(fs_1.default.readFileSync(path_1.default.join(__dirname, '..', '..', 'package.json'), 'utf8'));
+        expect(packageJson.scripts?.['docs:matrix']).toContain(`--registry-root ${sensor_support_matrix_1.R3_PREPUBLICATION_FIXTURE_RELATIVE_PATH}`);
+    });
     it('la tabla nombra a los seis providers declarados', () => {
         // Que el bloque este "al dia" no sirve si el generador se olvidara de un provider:
         // doc y generador coincidirian, los dos incompletos.
@@ -61,6 +76,58 @@ describe('docs/support-matrix.md refleja el codigo', () => {
             jest.resetModules();
         }
     });
+    it('documents default provider paths even when this machine overrides CODEX_HOME', () => {
+        const saved = process.env.CODEX_HOME;
+        process.env.CODEX_HOME = '/private/codex-home';
+        try {
+            jest.resetModules();
+            const { renderProviderTables: fresh } = require('../../scripts/support-matrix');
+            expect(fresh()).toContain('`~/.codex/agents`');
+            expect(fresh()).not.toContain('/private/codex-home');
+        }
+        finally {
+            if (saved === undefined)
+                delete process.env.CODEX_HOME;
+            else
+                process.env.CODEX_HOME = saved;
+            jest.resetModules();
+        }
+    });
+    it('does not leak a normalized CODEX_HOME override into generated documentation', () => {
+        const saved = process.env.CODEX_HOME;
+        process.env.CODEX_HOME = '/private/codex/../secret-codex/';
+        try {
+            jest.resetModules();
+            const { renderProviderTables: fresh } = require('../../scripts/support-matrix');
+            const generated = fresh();
+            expect(generated).toContain('`~/.codex/agents`');
+            expect(generated).not.toContain('/private/');
+            expect(generated).not.toContain('secret-codex');
+        }
+        finally {
+            if (saved === undefined)
+                delete process.env.CODEX_HOME;
+            else
+                process.env.CODEX_HOME = saved;
+            jest.resetModules();
+        }
+    });
+    it('keeps a separator when CODEX_HOME has a trailing slash', () => {
+        const saved = process.env.CODEX_HOME;
+        process.env.CODEX_HOME = '/private/codex-home/';
+        try {
+            jest.resetModules();
+            const { renderProviderTables: fresh } = require('../../scripts/support-matrix');
+            expect(fresh()).toContain('`~/.codex/agents`');
+        }
+        finally {
+            if (saved === undefined)
+                delete process.env.CODEX_HOME;
+            else
+                process.env.CODEX_HOME = saved;
+            jest.resetModules();
+        }
+    });
     // La abreviacion a `~` se probaba solo end-to-end, y en Linux eso no distingue entre
     // "normaliza bien" y "los separadores ya coincidian". La CI de Windows encontro que no
     // normalizaba: comparaba el prefijo ANTES de convertir separadores, asi que alla no
@@ -89,12 +156,12 @@ describe('docs/support-matrix.md refleja el codigo', () => {
         expect(out).toContain('linea uno\r\nlinea dos');
         expect(out.split('\r\n').length - 1).toBe(out.split('\n').length - 1); // ni un LF suelto
     });
-    it('marca como no soportado, no como ausente, el scope que un provider no tiene', () => {
+    it('marks an unsupported scope rather than leaving it absent', () => {
         // La diferencia entre "no soportado" y una celda vacia es exactamente lo que el
         // documento existe para no dejar ambiguo: Copilot no tiene scope global por
         // decision del producto que integramos, no porque falte implementarlo.
         const generated = (0, support_matrix_1.renderProviderTables)();
         const copilotRow = generated.split('\n').find((l) => l.startsWith('| `copilot` |'));
-        expect(copilotRow).toContain('**no soportado**');
+        expect(copilotRow).toContain('**unsupported**');
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-workflow-manager",
-  "version": "6.5.2",
+  "version": "8.1.0",
   "main": "dist/src/index.js",
   "bin": {
     "awm": "./dist/src/index.js"
@@ -18,13 +18,16 @@
   },
   "scripts": {
     "build": "tsc && chmod +x dist/src/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --config eslint.config.awm.mjs --cache --format json",
+    "depcheck": "depcruise --config .dep-cruiser.awm.js src",
     "test": "jest --runInBand",
     "start": "ts-node src/index.ts",
     "prerelease": "npm run build",
     "release": "node dist/src/release/index.js",
     "prepack": "npm run build",
     "prepublishOnly": "npm run build",
-    "docs:matrix": "ts-node scripts/support-matrix.ts"
+    "docs:matrix": "ts-node scripts/support-matrix.ts && ts-node scripts/sensor-support-matrix.ts --registry-root tests/fixtures/sensor-support-matrix/registry"
   },
   "keywords": [
     "agentic",
@@ -43,17 +46,20 @@
     "@clack/prompts": "^1.0.1",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
+    "semver": "^7.7.4",
     "simple-git": "^3.32.2"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "4.0.9",
     "@types/node": "^25.3.0",
+    "@types/semver": "^7.7.1",
     "dependency-cruiser": "^17.4.3",
     "eslint": "^10.4.1",
     "jest": "^30.2.0",
     "js-yaml": "4.1.0",
     "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   }
 }