gcf-aif-ext 0.7.4 → 0.7.5

package/README.md

@@ -52,7 +52,7 @@ On Windows, run `extension add` and `extension update` from PowerShell or cmd, n
 
 ### 0.7.1
 
-- `gcf board --json`: a ready item's worktree with no run lock and no session mark is a run that stopped (a timeout, a stop, a crash), not a run: the item reads `running: false`, `resumable: true`, and keeps its moves; its next run resumes the worktree.
+- `gcf board --json`: a ready item's worktree with no run lock and no session mark is a run that stopped (a timeout, a stop, a crash), not a run: the item reads `running: false`, `resumable: true`, and keeps its moves; its next run resumes the worktree. An agent session the harness kept (`.gcf-session/runs/<id>.agent.json`) makes a ready item `resumable` too, in either run mode, and shows as `resume: {ended, resets?}` (null without one).
 
 ### 0.7.0
 

package/extension.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/lee-to/ai-factory/2.x/schemas/extension.schema.json",
   "name": "gcf-aif-ext",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "Game Context Framework for AI Factory",
   "skills": [
     "skills/gcf-init",

package/lib/board.js

@@ -120,6 +120,25 @@ function logOf(projectDir, id) {
   return existsSync(path.join(projectDir, log)) ? log : null;
 }
 
+/**
+ * How the agent session of the item's last run ended, when the harness kept it for a rerun to
+ * resume (`<id>.agent.json`): `{ended, resets?}`, or null. A file that is not a record is none.
+ */
+async function resumeOf(projectDir, id) {
+  try {
+    const file = path.join(projectDir, '.gcf-session', 'runs', `${id}.agent.json`);
+    const rec = JSON.parse(await readFile(file, 'utf8'));
+    if (typeof rec?.session_id !== 'string') return null;
+
+    return {
+      ended: String(rec.ended ?? ''),
+      ...(rec.resets ? { resets: String(rec.resets) } : {}),
+    };
+  } catch {
+    return null;
+  }
+}
+
 // Fields of the item file a board shows as they are: null or [] when the file has none.
 const SCALARS = [
   'title',
@@ -163,10 +182,15 @@ async function itemOf(projectDir, c, verified) {
   const ready = c.data.status === 'ready' && verified.has(id);
   // `running` and `verify` are not stored (§4): a live harness run lock or a fresh session mark
   // is a run; a trailer is a passed DoD. A worktree with neither is a run that stopped (a
-  // timeout, a stop, a crash): the item is ready, and its next run resumes that worktree.
+  // timeout, a stop, a crash): the item is ready, and its next run resumes that worktree. A
+  // session the harness kept (`resume`) is resumed by the next run in either mode.
   const running = runHolder(projectDir, id) !== null || sessionActive(projectDir, id);
+  const resume = c.data.status === 'ready' ? await resumeOf(projectDir, id) : null;
   const resumable =
-    !running && c.data.status === 'ready' && !ready && existsSync(worktreeOf(projectDir, id));
+    !running &&
+    c.data.status === 'ready' &&
+    !ready &&
+    (resume !== null || existsSync(worktreeOf(projectDir, id)));
 
   return {
     id,
@@ -179,6 +203,7 @@ async function itemOf(projectDir, c, verified) {
     ...(c.data.blocked ? { blocked: c.data.blocked } : {}),
     running,
     resumable,
+    resume,
     verified: ready,
     // What a board may offer (§4.1): nothing while a run drives the item.
     moves: running ? [] : movesOf(c.data),

package/lib/session-mark.js

@@ -40,6 +40,14 @@ export function releaseSession(projectDir, id) {
   rmSync(markOf(projectDir, id), { force: true });
 }
 
+/**
+ * Forget the agent session the harness kept for a rerun of `id` (`<id>.agent.json`): a move,
+ * by hand or by an agent, ends the work it would resume.
+ */
+export function dropAgentSession(projectDir, id) {
+  rmSync(path.join(path.dirname(markOf(projectDir, id)), `${id}.agent.json`), { force: true });
+}
+
 /** Whether a session works the item now: a mark refreshed within SESSION_TTL_MS. */
 export function sessionActive(projectDir, id) {
   const file = markOf(projectDir, id);

package/lib/work-ops.js

@@ -38,7 +38,7 @@ import {
 import { dropInbox } from './inbox.js';
 import { refuseByPhase } from './phase.js';
 import { runHolder, withMainLock } from './main-lock.js';
-import { releaseSession, sessionActive } from './session-mark.js';
+import { dropAgentSession, releaseSession, sessionActive } from './session-mark.js';
 
 /**
  * Options of a committed move; each move reads the ones it needs.
@@ -228,8 +228,10 @@ async function finish(m, move, tail, commit) {
     commit,
     inputs: [m.item.file],
   });
-  // A move on the item ends the session that worked it: the board stops showing it running.
+  // A move on the item ends the session that worked it: the board stops showing it running,
+  // and no rerun resumes it.
   releaseSession(m.projectDir, String(m.item.data.id));
+  dropAgentSession(m.projectDir, String(m.item.data.id));
 
   return hash;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gcf-aif-ext",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "Game Context Framework for AI Factory",
   "type": "module",
   "license": "MIT",