@urateam/core 0.1.50 → 0.1.52

package/dist/__tests__/session-lazy-creation.test.js

@@ -0,0 +1,146 @@
+/**
+ * BEC-231 — Lazy / retry SDK session creation.
+ *
+ * Reproduces the production bug surfaced during the BEC-227 Phase 2 dogfood
+ * soak: when the first resumable stage's SDK call fails before any JSONL
+ * message is written (auth 401, pre-stream stall, etc.), subsequent stages
+ * MUST retry the create path (`sessionId:`) rather than blindly using
+ * `resume:` against a transcript that never materialized.
+ *
+ * The pre-BEC-231 implementation used an in-memory `hasInitiatedSession` flag
+ * (flipped after the first resumable stage's CALL, not after the SDK actually
+ * wrote a message). The new implementation derives the shape from
+ * `transcriptExists()` on every stage entry, so a stage 2 invocation against
+ * a non-existent JSONL re-attempts creation.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// ── Module mocks (declared before imports) ────────────────────────────────────
+vi.mock("@anthropic-ai/claude-agent-sdk", () => ({
+    query: vi.fn(),
+}));
+vi.mock("../executor/auth-check.js", () => ({
+    isClaudeAuthValid: vi.fn().mockResolvedValue(true),
+    resolveClaudeAuth: vi.fn().mockReturnValue({ method: "session" }),
+}));
+vi.mock("../executor/extract-handoff.js", () => ({
+    extractHandoff: vi.fn().mockResolvedValue({
+        artifact: {
+            runId: "run-bec231",
+            issueId: "BEC-231",
+            stage: "implement",
+            timestamp: new Date().toISOString(),
+            summary: "Stub handoff",
+            filesChanged: [],
+            approach: "Stub",
+            context: { issueIntent: "x", constraints: [], assumptions: [] },
+            tokenBudget: { contextTokensUsed: 0, recommendedMaxTurns: 1 },
+        },
+        structured: true,
+    }),
+}));
+const { transcriptExistsMock } = vi.hoisted(() => ({
+    transcriptExistsMock: vi.fn(),
+}));
+vi.mock("../executor/session-store.js", async () => {
+    const real = await vi.importActual("../executor/session-store.js");
+    return {
+        ...real,
+        transcriptExists: transcriptExistsMock,
+    };
+});
+// ── Imports ───────────────────────────────────────────────────────────────────
+import { executeStage } from "../executor/executor.js";
+import { createDb } from "../db/client.js";
+import { pipelineRuns } from "../db/schema.js";
+// ── Fixtures ──────────────────────────────────────────────────────────────────
+const testIssue = {
+    id: "BEC-231",
+    slug: "lazy-session-creation",
+    title: "BEC-231 lazy session creation",
+    description: "Verify session shape is derived from on-disk state",
+    acceptanceCriteria: ["transcriptExists drives sessionId vs resume choice"],
+    labels: ["bug"],
+    priority: 2,
+};
+const testRepoConfig = {
+    url: "https://github.com/test-org/test-repo",
+    defaultBranch: "main",
+    testCommand: "echo ok",
+    buildCommand: "echo ok",
+};
+async function seedPipelineRun(db, runId) {
+    await db.insert(pipelineRuns).values({
+        id: runId,
+        issueId: testIssue.id,
+        issueTitle: testIssue.title,
+        pipelineKey: "auto-implement",
+        repoUrl: testRepoConfig.url,
+        branch: `agent/${runId}`,
+        status: "running",
+    });
+}
+function makeMinimalStream() {
+    return (async function* () {
+        yield { type: "assistant", content: [{ type: "text", text: "done" }] };
+    })();
+}
+// ── Tests ─────────────────────────────────────────────────────────────────────
+describe("BEC-231 — lazy session creation derives shape from transcriptExists()", () => {
+    let db;
+    beforeEach(async () => {
+        db = await createDb({ connectionString: ":memory:" });
+        vi.clearAllMocks();
+    });
+    it("isFirstResumableStage=false BUT transcript absent → retries create (sessionId:), not resume:", async () => {
+        // This is the exact bug pattern: a "second" stage gets called with
+        // isFirstResumableStage=false (because the runner's in-memory flag
+        // believed the first stage initiated the session) but the JSONL was
+        // never written (first stage failed at auth before any SDK message).
+        // Pre-BEC-231: routed to resume:, found JSONL missing, dropped to
+        // legacy fresh-session-no-opts, lost the session permanently.
+        // Post-BEC-231: routes to sessionId: → SDK creates the session now.
+        const { query } = await import("@anthropic-ai/claude-agent-sdk");
+        query.mockReturnValue(makeMinimalStream());
+        transcriptExistsMock.mockReturnValue(false);
+        await seedPipelineRun(db, "run-bec231-stage2-recreate");
+        await executeStage({
+            runId: "run-bec231-stage2-recreate",
+            issueId: testIssue.id,
+            stage: "implement",
+            sanitizedIssue: testIssue,
+            repoConfig: testRepoConfig,
+            workdir: "/tmp/bec231-workdir",
+            db,
+            agentSessionId: "uuid-bec231",
+            isFirstResumableStage: false,
+        });
+        const opts = query.mock.calls[0][0].options;
+        expect(opts.sessionId).toBe("uuid-bec231");
+        expect(opts.resume).toBeUndefined();
+    });
+    it("isFirstResumableStage=true AND transcript present → resumes (transcriptExists wins over the flag)", async () => {
+        // Symmetric case: the runner says "this is the first resumable stage"
+        // but the JSONL actually already exists (e.g. retriable resume after a
+        // restart that lost the in-memory flag). BEC-231 still routes to
+        // resume: because the transcript is on disk.
+        const { query } = await import("@anthropic-ai/claude-agent-sdk");
+        query.mockReturnValue(makeMinimalStream());
+        transcriptExistsMock.mockReturnValue(true);
+        await seedPipelineRun(db, "run-bec231-restarted");
+        await executeStage({
+            runId: "run-bec231-restarted",
+            issueId: testIssue.id,
+            stage: "implement",
+            sanitizedIssue: testIssue,
+            repoConfig: testRepoConfig,
+            workdir: "/tmp/bec231-workdir",
+            db,
+            agentSessionId: "uuid-bec231-existing",
+            isFirstResumableStage: true,
+        });
+        const opts = query.mock.calls[0][0].options;
+        expect(opts.resume).toBe("uuid-bec231-existing");
+        expect(opts.sessionId).toBeUndefined();
+    });
+});
+//# sourceMappingURL=session-lazy-creation.test.js.map

package/dist/__tests__/session-lazy-creation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lazy-creation.test.js","sourceRoot":"","sources":["../../src/__tests__/session-lazy-creation.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/session-policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-policy.test.d.ts.map

package/dist/__tests__/session-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-policy.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-policy.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-policy.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from "vitest";
+import { isResumable, isAlwaysFreshStage, ALWAYS_FRESH_STAGES } from "../executor/session-policy.js";
+describe("session-policy (BEC-227)", () => {
+    describe("isAlwaysFreshStage", () => {
+        it("validate stage is always fresh", () => {
+            expect(isAlwaysFreshStage("validate")).toBe(true);
+        });
+        it("ralph-check stage is always fresh", () => {
+            expect(isAlwaysFreshStage("ralph-check")).toBe(true);
+        });
+        it("implement stage is NOT always fresh", () => {
+            expect(isAlwaysFreshStage("implement")).toBe(false);
+        });
+        it("ALWAYS_FRESH_STAGES set is exposed and immutable from caller's perspective", () => {
+            expect(ALWAYS_FRESH_STAGES.has("validate")).toBe(true);
+            expect(ALWAYS_FRESH_STAGES.has("implement")).toBe(false);
+        });
+    });
+    describe("isResumable", () => {
+        it("Sonnet on implement → resumable", () => {
+            expect(isResumable("implement", "claude-sonnet-4-6")).toBe(true);
+        });
+        it("Opus on implement → resumable (same family)", () => {
+            expect(isResumable("implement", "claude-opus-4-7")).toBe(true);
+        });
+        it("Haiku on implement → not resumable (different family)", () => {
+            expect(isResumable("implement", "claude-haiku-4-5")).toBe(false);
+        });
+        it("any model on validate → not resumable", () => {
+            expect(isResumable("validate", "claude-sonnet-4-6")).toBe(false);
+        });
+        it("Sonnet on review → resumable", () => {
+            expect(isResumable("review", "claude-sonnet-4-6")).toBe(true);
+        });
+        it("Sonnet on deep-review → resumable", () => {
+            expect(isResumable("deep-review", "claude-sonnet-4-6")).toBe(true);
+        });
+        it("non-Claude model → not resumable", () => {
+            expect(isResumable("review", "qwen/qwen-3-plus")).toBe(false);
+            expect(isResumable("review", "openai/gpt-oss-120b")).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=session-policy.test.js.map

package/dist/__tests__/session-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-policy.test.js","sourceRoot":"","sources":["../../src/__tests__/session-policy.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAErG,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;YACpF,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvD,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9D,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/session-resume-fallback.test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tests for BEC-227 Task 7, AS UPDATED BY BEC-231 (lazy session creation).
+ *
+ * Original BEC-227 design (T7): when `isFirstResumableStage=false` AND the
+ * JSONL is missing, drop to fresh-session shape (no opts) + emit
+ * `missing_fallback` audit event. The bug: the in-memory `hasInitiatedSession`
+ * flag flipped after the first stage's CALL, not after the SDK actually wrote
+ * the JSONL. If the first stage failed (auth 401, etc.) before writing, every
+ * later stage thought "session initiated; use resume:" but the JSONL didn't
+ * exist, so they all dropped to fresh-session-with-no-opts — losing the
+ * session permanently for the run's lifetime.
+ *
+ * BEC-231 fix: derive the shape from on-disk state, not from the in-memory
+ * flag. JSONL present → `resume:`. JSONL absent → `sessionId:` (retries
+ * creation). The `missing_fallback` audit event is no longer emitted from
+ * the executor — the new logic always picks the right shape.
+ *
+ * This test now verifies the new behavior: missing JSONL → SDK call shape
+ * is `{ sessionId: <uuid> }` (the create/retry path), NOT empty opts.
+ */
+export {};
+//# sourceMappingURL=session-resume-fallback.test.d.ts.map

package/dist/__tests__/session-resume-fallback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume-fallback.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-resume-fallback.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/__tests__/session-resume-fallback.test.js

@@ -0,0 +1,145 @@
+/**
+ * Tests for BEC-227 Task 7, AS UPDATED BY BEC-231 (lazy session creation).
+ *
+ * Original BEC-227 design (T7): when `isFirstResumableStage=false` AND the
+ * JSONL is missing, drop to fresh-session shape (no opts) + emit
+ * `missing_fallback` audit event. The bug: the in-memory `hasInitiatedSession`
+ * flag flipped after the first stage's CALL, not after the SDK actually wrote
+ * the JSONL. If the first stage failed (auth 401, etc.) before writing, every
+ * later stage thought "session initiated; use resume:" but the JSONL didn't
+ * exist, so they all dropped to fresh-session-with-no-opts — losing the
+ * session permanently for the run's lifetime.
+ *
+ * BEC-231 fix: derive the shape from on-disk state, not from the in-memory
+ * flag. JSONL present → `resume:`. JSONL absent → `sessionId:` (retries
+ * creation). The `missing_fallback` audit event is no longer emitted from
+ * the executor — the new logic always picks the right shape.
+ *
+ * This test now verifies the new behavior: missing JSONL → SDK call shape
+ * is `{ sessionId: <uuid> }` (the create/retry path), NOT empty opts.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// ── Module mocks (declared before imports) ────────────────────────────────────
+vi.mock("@anthropic-ai/claude-agent-sdk", () => ({
+    query: vi.fn(),
+}));
+vi.mock("../executor/auth-check.js", () => ({
+    isClaudeAuthValid: vi.fn().mockResolvedValue(true),
+    resolveClaudeAuth: vi.fn().mockReturnValue({ method: "session" }),
+}));
+vi.mock("../executor/extract-handoff.js", () => ({
+    extractHandoff: vi.fn().mockResolvedValue({
+        artifact: {
+            runId: "run-bec227-t7",
+            issueId: "BEC-227",
+            stage: "implement",
+            timestamp: new Date().toISOString(),
+            summary: "Stub handoff",
+            filesChanged: [],
+            approach: "Stub",
+            context: { issueIntent: "x", constraints: [], assumptions: [] },
+            tokenBudget: { contextTokensUsed: 0, recommendedMaxTurns: 1 },
+        },
+        structured: true,
+    }),
+}));
+vi.mock("../executor/session-store.js", async () => {
+    const real = await vi.importActual("../executor/session-store.js");
+    return {
+        ...real,
+        // Force the transcript-not-found path so the fallback branch fires.
+        transcriptExists: vi.fn().mockReturnValue(false),
+    };
+});
+const { logAuditEventMock } = vi.hoisted(() => ({
+    logAuditEventMock: vi.fn().mockResolvedValue(undefined),
+}));
+vi.mock("../audit/writer.js", async () => {
+    const real = await vi.importActual("../audit/writer.js");
+    return {
+        ...real,
+        logAuditEvent: logAuditEventMock,
+    };
+});
+// ── Imports ───────────────────────────────────────────────────────────────────
+import { executeStage } from "../executor/executor.js";
+import { createDb } from "../db/client.js";
+import { pipelineRuns } from "../db/schema.js";
+// ── Fixtures ──────────────────────────────────────────────────────────────────
+const testIssue = {
+    id: "BEC-227",
+    slug: "agent-session-continuity",
+    title: "Agent session continuity Phase 1",
+    description: "Resume fallback when JSONL is missing",
+    acceptanceCriteria: ["fallback to fresh session on missing JSONL"],
+    labels: ["auto-implement"],
+    priority: 4,
+};
+const testRepoConfig = {
+    url: "https://github.com/test-org/test-repo",
+    defaultBranch: "main",
+    testCommand: "echo ok",
+    buildCommand: "echo ok",
+};
+async function seedPipelineRun(db, runId) {
+    await db.insert(pipelineRuns).values({
+        id: runId,
+        issueId: testIssue.id,
+        issueTitle: testIssue.title,
+        pipelineKey: "auto-implement",
+        repoUrl: testRepoConfig.url,
+        branch: `agent/${runId}`,
+        status: "running",
+    });
+}
+function makeMinimalStream() {
+    return (async function* () {
+        yield {
+            type: "assistant",
+            content: [{ type: "text", text: "done" }],
+        };
+    })();
+}
+// ── Tests ─────────────────────────────────────────────────────────────────────
+describe("executeStage — lazy session creation when JSONL absent (BEC-231 update of BEC-227 T7)", () => {
+    let db;
+    beforeEach(async () => {
+        db = await createDb({ connectionString: ":memory:" });
+        vi.clearAllMocks();
+        logAuditEventMock.mockClear();
+        logAuditEventMock.mockResolvedValue(undefined);
+    });
+    it("transcript missing → retries session creation (sessionId set), does NOT emit missing_fallback (BEC-231)", async () => {
+        const { query } = await import("@anthropic-ai/claude-agent-sdk");
+        query.mockReturnValue(makeMinimalStream());
+        await seedPipelineRun(db, "run-bec231-retry-create");
+        // Even though the caller passes isFirstResumableStage=false (the old
+        // pre-BEC-231 callers do this for non-first stages), the new logic checks
+        // transcriptExists() and routes to sessionId: when it returns false.
+        await executeStage({
+            runId: "run-bec231-retry-create",
+            issueId: testIssue.id,
+            stage: "implement",
+            sanitizedIssue: testIssue,
+            repoConfig: testRepoConfig,
+            workdir: "/nonexistent/path/bec231",
+            db,
+            agentSessionId: "uuid-bec231-recreate",
+            isFirstResumableStage: false, // ← ignored under BEC-231
+        });
+        expect(query).toHaveBeenCalledOnce();
+        const opts = query.mock.calls[0][0].options;
+        // BEC-231: when JSONL is absent, we (re-)create with sessionId: rather
+        // than dropping to legacy fresh-session shape.
+        expect(opts.sessionId).toBe("uuid-bec231-recreate");
+        expect(opts.resume).toBeUndefined();
+        // BEC-231: missing_fallback audit event is no longer emitted from the
+        // executor — the new logic always picks the right shape.
+        const fallbackCall = logAuditEventMock.mock.calls.find((call) => call[1]?.eventType === "pipeline.agent_session_missing_fallback");
+        expect(fallbackCall).toBeUndefined();
+        // resumed event is also not emitted (we're creating, not resuming).
+        const resumedCall = logAuditEventMock.mock.calls.find((call) => call[1]?.eventType === "pipeline.agent_session_resumed");
+        expect(resumedCall).toBeUndefined();
+    });
+});
+//# sourceMappingURL=session-resume-fallback.test.js.map

package/dist/__tests__/session-resume-fallback.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume-fallback.test.js","sourceRoot":"","sources":["../../src/__tests__/session-resume-fallback.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/session-resume-flag.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-resume-flag.test.d.ts.map

package/dist/__tests__/session-resume-flag.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume-flag.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-resume-flag.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-resume-flag.test.js

@@ -0,0 +1,87 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { eq } from "drizzle-orm";
+import { createDb } from "../db/client.js";
+import { pipelineRuns } from "../db/schema.js";
+/**
+ * BEC-227 — Task 5 verification.
+ *
+ * `runner.start()` mints an `agent_session_id` UUID and persists it on the
+ * `pipeline_runs` row when `URATEAM_ENABLE_AGENT_SESSION_RESUME=true`. This
+ * test simulates the row state directly (rather than invoking `start()`
+ * which requires reconstructing 6 positional params + a queue + executor)
+ * and asserts the column behaviour — the runner-level integration is
+ * verified by typecheck + existing pipeline tests.
+ */
+describe("agent_session_id minting (BEC-227)", () => {
+    let originalEnv;
+    beforeEach(() => {
+        originalEnv = process.env.URATEAM_ENABLE_AGENT_SESSION_RESUME;
+    });
+    afterEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.URATEAM_ENABLE_AGENT_SESSION_RESUME;
+        }
+        else {
+            process.env.URATEAM_ENABLE_AGENT_SESSION_RESUME = originalEnv;
+        }
+    });
+    it("flag on → mints UUID and persists on pipeline_runs row", async () => {
+        process.env.URATEAM_ENABLE_AGENT_SESSION_RESUME = "true";
+        const db = await createDb({ driver: "sqlite", connectionString: ":memory:" });
+        const runId = "test-run-with-session";
+        await db.insert(pipelineRuns).values({
+            id: runId,
+            issueId: "BEC-227",
+            issueTitle: "test",
+            repoUrl: "https://example.com/repo",
+            pipelineKey: "auto-implement",
+            status: "queued",
+            startedAt: new Date(),
+            agentSessionId: "expected-uuid", // simulate what start() writes
+        });
+        const [row] = await db
+            .select()
+            .from(pipelineRuns)
+            .where(eq(pipelineRuns.id, runId));
+        expect(row.agentSessionId).toBe("expected-uuid");
+    });
+    it("flag off → agentSessionId stays null", async () => {
+        delete process.env.URATEAM_ENABLE_AGENT_SESSION_RESUME;
+        const db = await createDb({ driver: "sqlite", connectionString: ":memory:" });
+        const runId = "test-run-legacy";
+        await db.insert(pipelineRuns).values({
+            id: runId,
+            issueId: "BEC-227",
+            issueTitle: "test",
+            repoUrl: "https://example.com/repo",
+            pipelineKey: "auto-implement",
+            status: "queued",
+            startedAt: new Date(),
+        });
+        const [row] = await db
+            .select()
+            .from(pipelineRuns)
+            .where(eq(pipelineRuns.id, runId));
+        expect(row.agentSessionId).toBeNull();
+    });
+    it("isAgentSessionResumeEnabled reads env at call time (strict equality 'true')", async () => {
+        const { isAgentSessionResumeEnabled } = await import("../executor/session-policy.js");
+        expect(isAgentSessionResumeEnabled({
+            URATEAM_ENABLE_AGENT_SESSION_RESUME: "true",
+        })).toBe(true);
+        expect(isAgentSessionResumeEnabled({
+            URATEAM_ENABLE_AGENT_SESSION_RESUME: "1",
+        })).toBe(false);
+        expect(isAgentSessionResumeEnabled({
+            URATEAM_ENABLE_AGENT_SESSION_RESUME: "yes",
+        })).toBe(false);
+        expect(isAgentSessionResumeEnabled({
+            URATEAM_ENABLE_AGENT_SESSION_RESUME: "TRUE",
+        })).toBe(false);
+        expect(isAgentSessionResumeEnabled({
+            URATEAM_ENABLE_AGENT_SESSION_RESUME: "",
+        })).toBe(false);
+        expect(isAgentSessionResumeEnabled({})).toBe(false);
+    });
+});
+//# sourceMappingURL=session-resume-flag.test.js.map

package/dist/__tests__/session-resume-flag.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume-flag.test.js","sourceRoot":"","sources":["../../src/__tests__/session-resume-flag.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/session-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-store.test.d.ts.map

package/dist/__tests__/session-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-store.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-store.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { transcriptPath, transcriptExists } from "../executor/session-store.js";
+let tmpRoot;
+beforeEach(() => {
+    tmpRoot = mkdtempSync(join(tmpdir(), "urateam-session-store-test-"));
+});
+afterEach(() => {
+    rmSync(tmpRoot, { recursive: true, force: true });
+});
+describe("session-store (BEC-227)", () => {
+    it("transcriptPath builds the expected per-cwd / per-session path", () => {
+        const p = transcriptPath({
+            projectsRoot: tmpRoot,
+            cwd: "/home/ura/data/runs/abc/worktree",
+            sessionId: "uuid-1",
+        });
+        // Per SDK convention: projectsRoot / <encoded-cwd> / <sessionId>.jsonl
+        expect(p).toMatch(/uuid-1\.jsonl$/);
+        expect(p).toContain(tmpRoot);
+    });
+    it("transcriptExists returns true when the JSONL file is present", () => {
+        const dir = join(tmpRoot, "encoded-cwd");
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, "uuid-1.jsonl"), '{"message":"hi"}\n');
+        const exists = transcriptExists({
+            projectsRoot: tmpRoot,
+            cwd: "/encoded-cwd",
+            sessionId: "uuid-1",
+        });
+        expect(exists).toBe(true);
+    });
+    it("transcriptExists returns false when missing", () => {
+        const exists = transcriptExists({
+            projectsRoot: tmpRoot,
+            cwd: "/nonexistent",
+            sessionId: "uuid-missing",
+        });
+        expect(exists).toBe(false);
+    });
+});
+//# sourceMappingURL=session-store.test.js.map

package/dist/__tests__/session-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.test.js","sourceRoot":"","sources":["../../src/__tests__/session-store.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAM,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAc,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhF,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,6BAA6B,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AACH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,GAAG,cAAc,CAAC;YACvB,YAAY,EAAE,OAAO;YACrB,GAAG,EAAE,kCAAkC;YACvC,SAAS,EAAE,QAAQ;SACpB,CAAC,CAAC;QACH,uEAAuE;QACvE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACzC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC9B,YAAY,EAAE,OAAO;YACrB,GAAG,EAAE,cAAc;YACnB,SAAS,EAAE,QAAQ;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC9B,YAAY,EAAE,OAAO;YACrB,GAAG,EAAE,cAAc;YACnB,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/session-volume-check.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-volume-check.test.d.ts.map

package/dist/__tests__/session-volume-check.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-volume-check.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-volume-check.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-volume-check.test.js

@@ -0,0 +1,28 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { checkSessionVolume } from "../pipeline/session-volume-check.js";
+let dir;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), "vol-check-"));
+});
+afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+});
+describe("checkSessionVolume (BEC-227)", () => {
+    it("writeable persistent dir → returns ok", () => {
+        const result = checkSessionVolume({ projectsDir: dir });
+        expect(result.ok).toBe(true);
+    });
+    it("nonexistent dir → returns not-found", () => {
+        const result = checkSessionVolume({
+            projectsDir: "/totally/not/a/real/path/asdf",
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.reason).toBe("not-found");
+        }
+    });
+});
+//# sourceMappingURL=session-volume-check.test.js.map

package/dist/__tests__/session-volume-check.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-volume-check.test.js","sourceRoot":"","sources":["../../src/__tests__/session-volume-check.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,IAAI,GAAW,CAAC;AAChB,UAAU,CAAC,GAAG,EAAE;IACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AACH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,kBAAkB,CAAC;YAChC,WAAW,EAAE,+BAA+B;SAC7C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/validate-run-mode.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-run-mode.test.d.ts.map

package/dist/__tests__/validate-run-mode.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-run-mode.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/validate-run-mode.test.ts"],"names":[],"mappings":""}