@rasensio/aidlc 1.82.0 → 1.83.0

package/dist/verify/run.js

@@ -0,0 +1,59 @@
+/**
+ * Run `verify.command` and write the receipt.
+ *
+ * The command runs through the platform shell because it is a string a person wrote
+ * for one (`pnpm test && pnpm lint` must work). Output is shown live and hashed as it
+ * arrives; it is never stored (AC-7). The receipt is written whether the command
+ * passed or failed, so a failing run replaces an older passing one (AC-10).
+ *
+ * Requirements: tool-written-test-receipts/AC-4, AC-5, AC-6, AC-10
+ */
+import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { constants } from 'node:os';
+import { VERSION } from '../core/version.js';
+import { changedOutside } from './git.js';
+import { hashCommand, writeReceipt } from './receipt.js';
+/** Exit code for a run killed by a signal: the shell convention, 128 + its number. */
+function signalExitCode(signal) {
+    const n = signal ? constants.signals[signal] : undefined;
+    return n === undefined ? 1 : 128 + n;
+}
+/**
+ * @param commit HEAD, already resolved by the caller (which refuses when there is none).
+ */
+export async function runVerify(projectRoot, instance, command, commit, out = { stdout: process.stdout, stderr: process.stderr }) {
+    // Measured before the run, so what the run itself writes cannot make it dirty. An
+    // unanswerable status counts as dirty: unknown is not clean (AC-6).
+    const changed = changedOutside(projectRoot, instance, null);
+    const dirty = !changed.ok || changed.paths.length > 0;
+    const hash = createHash('sha256');
+    const started = Date.now();
+    const exitCode = await new Promise((resolve) => {
+        const child = spawn(command, { shell: true, cwd: projectRoot, stdio: ['inherit', 'pipe', 'pipe'] });
+        child.stdout.on('data', (chunk) => {
+            hash.update(chunk);
+            out.stdout.write(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            hash.update(chunk);
+            out.stderr.write(chunk);
+        });
+        // A shell that cannot start is the shell's "command not found".
+        child.on('error', () => resolve(127));
+        child.on('close', (code, signal) => resolve(code ?? signalExitCode(signal)));
+    });
+    const receipt = {
+        version: 1,
+        commit,
+        dirty,
+        command_sha256: hashCommand(command),
+        exit_code: exitCode,
+        output_sha256: hash.digest('hex'),
+        duration_ms: Date.now() - started,
+        cli_version: VERSION,
+        finished_at: new Date().toISOString(),
+    };
+    return { receipt, path: writeReceipt(projectRoot, instance, receipt) };
+}
+//# sourceMappingURL=run.js.map

package/dist/verify/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/verify/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQzD,sFAAsF;AACtF,SAAS,cAAc,CAAC,MAA6B;IACnD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,SAAS,CAAC,OAAkC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,QAAgB,EAChB,OAAe,EACf,MAAc,EACd,MAAoB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;IAEtE,kFAAkF;IAClF,oEAAoE;IACpE,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAEtD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACpG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,gEAAgE;QAChE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAY;QACvB,OAAO,EAAE,CAAC;QACV,MAAM;QACN,KAAK;QACL,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC;QACpC,SAAS,EAAE,QAAQ;QACnB,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QACjC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;QACjC,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;AACzE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc",
-  "version": "1.82.0",
+  "version": "1.83.0",
   "description": "AI Development Lifecycle Framework — structured lifecycle guidance for AI coding agents across platforms",
   "homepage": "https://aidlc.rodrigoasensio.com",
   "repository": {
@@ -31,7 +31,7 @@
     "commander": "15.0.0",
     "picomatch": "4.0.5",
     "yaml": "2.9.0",
-    "@rasensio/aidlc-content": "1.82.0"
+    "@rasensio/aidlc-content": "1.83.0"
   },
   "devDependencies": {
     "@types/node": "22.15.32",