@hmharness/agent 0.11.0 → 0.12.0

package/dist/pipeline.d.ts

@@ -21,6 +21,12 @@ export interface PipelineReport {
     finalVerdict: 'PASS' | 'FAIL' | 'none';
     stages: StageRecord[];
     repairsUsed: number;
+    /** set when opts.release ran on a PASS verdict (ADR-0008) */
+    release?: {
+        projectId: string;
+        version: string;
+        checkpointId: string;
+    };
 }
 export interface PipelineOptions {
     task: string;
@@ -53,6 +59,14 @@ export interface PipelineOptions {
         /** injectable runner (tests); default = domain-harmony runDeviceTest */
         runDeviceTestImpl?: (o: DeviceTestOptions) => Promise<DeviceTestStep[]>;
     };
+    /** V3 release slice (ADR-0008): when the final verdict is PASS, bind the
+     *  work to the workspace's Project Runtime (M8): attach the run, checkpoint
+     *  the tree, and record a release pinned to that checkpoint. FAIL/budget
+     *  never release - no verdict, no version. */
+    release?: {
+        version: string;
+        notes?: string;
+    };
 }
 /** Pull the judge's verdict line out of the final text; absence = FAIL
  *  (an judge that did not follow the contract did not render a verdict). */

package/dist/pipeline.js

@@ -73,6 +73,7 @@ export async function runPipeline(opts) {
     let repairs = 0;
     let spent = 0;
     let status = 'completed';
+    let releaseTick;
     const startedAt = new Date().toISOString();
     const runStage = async (stage, attempt, directive) => {
         // maxTurns is only a soft checkpoint in the kernel loop - the HARD caps
@@ -183,7 +184,23 @@ export async function runPipeline(opts) {
             }
             judge = await runStage('judge', repairs + 1, DIRECTIVES.judge(opts.task, evidenceSummary(stages)));
         }
-        return await finish(judge && judge.verdict !== 'n/a' ? judge.verdict : 'FAIL');
+        const verdict = judge && judge.verdict !== 'n/a' ? judge.verdict : 'FAIL';
+        // V3 release slice: only a PASS verdict earns a version (ADR-0008)
+        if (verdict === 'PASS' && opts.release) {
+            try {
+                const P = await import("./project.js");
+                const proj = await P.projectFor(opts.home, opts.ctx.cwd);
+                await P.attachRun(opts.home, proj, pipelineId);
+                const cp = await P.checkpointProject(opts.home, proj, `pipeline ${pipelineId}`);
+                await P.releaseProject(opts.home, proj, opts.release.version, opts.release.notes ?? `pipeline ${pipelineId} VERDICT: PASS (${stages.length} stages, ${repairs} repairs)`);
+                releaseTick = { projectId: proj.projectId, version: opts.release.version, checkpointId: cp.id };
+            }
+            catch (err) {
+                // release is bookkeeping - record the failure, never fail the pipeline
+                stages.push({ stage: 'judge', attempt: 0, verdict: 'n/a', text: `release binding failed: ${String(err).slice(0, 200)}`, turns: 0, toolUses: 0, reason: 'final' });
+            }
+        }
+        return await finish(verdict);
     }
     catch (err) {
         status = 'error';
@@ -200,6 +217,7 @@ export async function runPipeline(opts) {
             finalVerdict: verdict,
             stages,
             repairsUsed: repairs,
+            ...(releaseTick ? { release: releaseTick } : {}),
         };
         try {
             await writeFile(join(dir, 'pipeline.report.json'), JSON.stringify(report, null, 2) + '\n', 'utf8');

package/dist/project.js

@@ -192,6 +192,13 @@ export async function checkpointProject(home, rec, label) {
     else {
         const rel = `artifacts/cp-${Date.now().toString(36)}`;
         const dest = join(projDir(home, rec.projectId), rel);
+        // the copy fallback cannot handle the workspace containing the destination
+        // (workspace == home in degenerate setups) - say so plainly instead of
+        // letting cp throw EINVAL halfway through
+        const norm = (p) => resolve(p).replace(/[\\/]+$/, '').toLowerCase();
+        if (norm(dest).startsWith(norm(rec.workspace) + '\\') || norm(dest).startsWith(norm(rec.workspace) + '/')) {
+            throw new Error(`checkpoint copy fallback requires the project workspace (${rec.workspace}) to be outside HMH_HOME (${home})`);
+        }
         await mkdir(dest, { recursive: true });
         await cp(rec.workspace, dest, { recursive: true, filter: (src) => !COPY_SKIP.has(src.split(/[\\/]/).pop() ?? '') });
         let files = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
   "type": "module",
   "main": "dist/index.js",