@united-workforce/cli 0.2.1-rc.9 → 0.4.0

package/dist/__tests__/solve-issue-tea-worktree.test.js

@@ -12,28 +12,26 @@ import { parse } from "yaml";
  */
 describe("solve-issue workflow: Gitea API PR creation", () => {
     // Navigate up from packages/cli/src/__tests__ to repo root
-    const workflowPath = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "..", ".workflows", "solve-issue.yaml");
-    test("committer procedure should use curl API instead of tea pr create", async () => {
+    const workflowPath = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "..", "examples", "solve-issue.yaml");
+    test("committer procedure should create PR via tea pr create", async () => {
         const yamlContent = await readFile(workflowPath, "utf-8");
         const workflow = parse(yamlContent);
         expect(workflow.roles.committer).toBeDefined();
         const committerProcedure = workflow.roles.committer?.procedure;
         expect(committerProcedure).toBeDefined();
-        // Verify the procedure uses curl API, not tea pr create
-        expect(committerProcedure).toContain("curl");
-        expect(committerProcedure).toContain("api/v1/repos");
-        expect(committerProcedure).toContain("/pulls");
-        // Verify it explicitly warns against tea pr create
-        expect(committerProcedure).toMatch(/do NOT use.*tea pr create/i);
+        // Verify the procedure uses tea pr create for PR creation
+        expect(committerProcedure).toContain("tea pr create");
+        expect(committerProcedure).toContain("git push");
+        expect(committerProcedure).toContain("Fixes #N");
     });
-    test("committer procedure should reference repoRemote from task prompt", async () => {
+    test("committer procedure should extract owner/repo from git remote", async () => {
         const yamlContent = await readFile(workflowPath, "utf-8");
         const workflow = parse(yamlContent);
         const committerProcedure = workflow.roles.committer?.procedure;
         expect(committerProcedure).toBeDefined();
-        // Verify the procedure mentions repoRemote is provided in task prompt
-        expect(committerProcedure).toMatch(/repo remote.*provided.*task prompt/i);
-        expect(committerProcedure).toMatch(/owner\/repo/i);
+        // Verify the procedure extracts owner/repo from remote
+        expect(committerProcedure).toContain("git remote get-url origin");
+        expect(committerProcedure).toContain("hook_failed");
     });
     test("committer procedure should include error handling for curl failures", async () => {
         const yamlContent = await readFile(workflowPath, "utf-8");
@@ -72,36 +70,35 @@ describe("solve-issue workflow: Gitea API PR creation", () => {
         expect(committedVariant).toBeDefined();
         expect(committedVariant.required).toContain("$status");
     });
-    test("developer procedure should include mandatory verification step", async () => {
+    test("developer procedure should include worktree setup", async () => {
         const yamlContent = await readFile(workflowPath, "utf-8");
         const workflow = parse(yamlContent);
         const developerProcedure = workflow.roles.developer?.procedure;
         expect(developerProcedure).toBeDefined();
-        // Verify the procedure includes mandatory verification step
-        expect(developerProcedure).toContain("MANDATORY VERIFICATION");
-        expect(developerProcedure).toContain("git branch --show-current");
-        expect(developerProcedure).toContain("git status");
-        expect(developerProcedure).toMatch(/ls -la|verify.*exist/i);
+        // Verify the procedure includes worktree setup
+        expect(developerProcedure).toContain("IMPORTANT");
+        expect(developerProcedure).toContain("git worktree add");
+        expect(developerProcedure).toContain("pnpm install");
     });
-    test("reviewer procedure should enforce worktree path verification", async () => {
+    test("reviewer procedure should verify branch and run checks", async () => {
         const yamlContent = await readFile(workflowPath, "utf-8");
         const workflow = parse(yamlContent);
         const reviewerProcedure = workflow.roles.reviewer?.procedure;
         expect(reviewerProcedure).toBeDefined();
-        // Verify the procedure includes critical enforcement
-        expect(reviewerProcedure).toContain("CRITICAL");
-        expect(reviewerProcedure).toMatch(/cd.*pwd/);
-        expect(reviewerProcedure).toContain("Do NOT report results without running the actual commands");
+        // Verify the procedure includes branch verification and build checks
+        expect(reviewerProcedure).toContain("git branch --show-current");
+        expect(reviewerProcedure).toContain("pnpm run build");
+        expect(reviewerProcedure).toContain("pnpm run check");
     });
-    test("developer procedure should include test debugging escalation", async () => {
+    test("developer procedure should include changeset and failure handling", async () => {
         const yamlContent = await readFile(workflowPath, "utf-8");
         const workflow = parse(yamlContent);
         const developerProcedure = workflow.roles.developer?.procedure;
         expect(developerProcedure).toBeDefined();
-        // Verify the procedure includes test failure guidance
-        expect(developerProcedure).toMatch(/tests fail.*first run/i);
-        expect(developerProcedure).toMatch(/3 test cycles|after 3 attempts/i);
+        // Verify the procedure includes changeset requirement and failure path
+        expect(developerProcedure).toContain(".changeset/");
         expect(developerProcedure).toContain("$status=failed");
+        expect(developerProcedure).toContain("pnpm test");
     });
 });
 //# sourceMappingURL=solve-issue-tea-worktree.test.js.map

package/dist/__tests__/solve-issue-tea-worktree.test.js.map

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

package/dist/__tests__/step-ask.test.d.ts

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

package/dist/__tests__/step-ask.test.d.ts.map

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

package/dist/__tests__/step-ask.test.js

@@ -0,0 +1,499 @@
+import { execFileSync } from "node:child_process";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { bootstrap, putSchema } from "@ocas/core";
+import { openStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+import { registerUwfSchemas } from "../schemas.js";
+import { seedThreads } from "./thread-test-helpers.js";
+const OUTPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        $status: { type: "string" },
+        note: { type: "string" },
+    },
+    required: ["$status"],
+    additionalProperties: false,
+};
+const DETAIL_SCHEMA = {
+    title: "ask-detail",
+    type: "object",
+    required: ["sessionId", "model", "duration", "turnCount", "turns"],
+    properties: {
+        sessionId: { type: "string" },
+        model: { type: "string" },
+        duration: { type: "integer" },
+        turnCount: { type: "integer" },
+        turns: {
+            type: "array",
+            items: { type: "string", format: "ocas_ref" },
+        },
+    },
+    additionalProperties: false,
+};
+const THREAD_ID = "01ASKSTEPTEST000000000";
+const STEP_SESSION_ID = "ses-original-step-001";
+let tmpDir;
+beforeEach(async () => {
+    tmpDir = await mkdtemp(join(tmpdir(), "cli-uwf-step-ask-test-"));
+});
+afterEach(async () => {
+    await rm(tmpDir, { recursive: true, force: true });
+});
+async function setupAskFixture(opts = {}) {
+    const cfg = {
+        threadStatus: opts.threadStatus ?? "idle",
+        withDetail: opts.withDetail ?? true,
+        stepAgentNameOverride: opts.stepAgentNameOverride ?? null,
+        preCachedForkSessionId: opts.preCachedForkSessionId ?? null,
+    };
+    const casDir = join(tmpDir, "cas");
+    await mkdir(casDir, { recursive: true });
+    const store = await openStore(casDir);
+    await bootstrap(store);
+    const schemas = await registerUwfSchemas(store);
+    const outputSchemaHash = await putSchema(store, OUTPUT_SCHEMA);
+    const detailSchemaHash = await putSchema(store, DETAIL_SCHEMA);
+    const workflowHash = await store.cas.put(schemas.workflow, {
+        name: "test-ask",
+        description: "ask command integration test",
+        roles: {
+            worker: {
+                description: "Worker",
+                goal: "Work",
+                capabilities: [],
+                procedure: "work",
+                output: "result",
+                frontmatter: outputSchemaHash,
+            },
+        },
+        graph: {
+            $START: {
+                new: { role: "worker", prompt: "Start work", location: null },
+            },
+            worker: { ok: { role: "$END", prompt: "done", location: null } },
+        },
+    });
+    const startHash = await store.cas.put(schemas.startNode, {
+        workflow: workflowHash,
+        prompt: "Test ask task",
+        cwd: tmpDir,
+    });
+    // Set OCAS_HOME so seedThreads + in-test createUwfStore calls resolve to this CAS dir.
+    process.env.OCAS_HOME = casDir;
+    // Capture file paths
+    const promptCapturePath = join(tmpDir, "captured-prompt.txt");
+    const modeCapturePath = join(tmpDir, "captured-mode.txt");
+    const forkSessionCapturePath = join(tmpDir, "captured-fork-session.txt");
+    const askSessionCapturePath = join(tmpDir, "captured-ask-session.txt");
+    const envCapturePath = join(tmpDir, "captured-env.txt");
+    const mockAgentPath = join(tmpDir, "mock-agent.sh");
+    const failingAgentPath = join(tmpDir, "failing-agent.sh");
+    // Build a detail node with sessionId so step ask can extract it
+    let detailHash = null;
+    if (cfg.withDetail) {
+        const turnHash = await store.cas.put(detailSchemaHash, {
+            sessionId: STEP_SESSION_ID,
+            model: "test-model",
+            duration: 1000,
+            turnCount: 0,
+            turns: [],
+        });
+        detailHash = turnHash;
+    }
+    // Build the StepNode at thread head
+    const outputHash = await store.cas.put(outputSchemaHash, { $status: "ok" });
+    const stepHash = await store.cas.put(schemas.stepNode, {
+        start: startHash,
+        prev: null,
+        role: "worker",
+        output: outputHash,
+        detail: detailHash,
+        agent: cfg.stepAgentNameOverride ?? mockAgentPath,
+        edgePrompt: "Start work",
+        startedAtMs: 1716600000000,
+        completedAtMs: 1716600001000,
+        cwd: tmpDir,
+        assembledPrompt: null,
+        usage: null,
+    });
+    // Seed thread index entry
+    await seedThreads(tmpDir, {
+        [THREAD_ID]: {
+            head: stepHash,
+            status: cfg.threadStatus,
+            suspendedRole: null,
+            suspendMessage: null,
+            completedAt: cfg.threadStatus === "end" ? 1716600001000 : null,
+        },
+    });
+    // Pre-seed the ask session cache so reuse tests have something to find.
+    if (cfg.preCachedForkSessionId !== null) {
+        const cachePath = join(tmpDir, "cache", "mock-sessions.json");
+        await mkdir(dirname(cachePath), { recursive: true });
+        await writeFile(cachePath, `${JSON.stringify({ [`${stepHash}:ask`]: cfg.preCachedForkSessionId }, null, 2)}\n`, "utf8");
+    }
+    // Mock agent: dispatches based on `--mode` (ask|fork|run) and captures inputs.
+    // - --mode ask --session <id> --prompt <text>: writes to ask capture; echoes a fixed answer to stdout
+    // - --mode fork --session <id>: writes to fork capture; prints "forked-from-<id>" sessionId on stdout
+    // - default (uwf-* style invocation): captures and echoes adapter JSON (not used in this suite)
+    await writeFile(mockAgentPath, `#!/bin/sh
+mode=""
+prompt=""
+session=""
+detail=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --mode) mode="$2"; shift 2 ;;
+    --prompt) prompt="$2"; shift 2 ;;
+    --session) session="$2"; shift 2 ;;
+    --detail) detail="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+printf '%s' "$mode" > '${modeCapturePath}'
+printf '%s' "$prompt" > '${promptCapturePath}'
+printf 'OCAS_HOME=%s\\n' "$OCAS_HOME" > '${envCapturePath}'
+case "$mode" in
+  fork)
+    printf '%s' "$session" > '${forkSessionCapturePath}'
+    new_id="forked-from-$session"
+    printf '%s\\n' "$new_id"
+    ;;
+  ask)
+    printf '%s' "$session" > '${askSessionCapturePath}'
+    # Print a deterministic answer that the cmdStepAsk path will hand back.
+    printf 'MOCK_ANSWER prompt=%s session=%s detail=%s\\n' "$prompt" "$session" "$detail"
+    ;;
+  *)
+    echo "{\\"stepHash\\":\\"unused\\"}"
+    ;;
+esac
+`, { mode: 0o755 });
+    await writeFile(failingAgentPath, `#!/bin/sh
+echo "boom" >&2
+exit 7
+`, { mode: 0o755 });
+    // Minimal config so loadWorkflowConfig succeeds.
+    const configPath = join(tmpDir, "config.yaml");
+    await writeFile(configPath, `defaultAgent: uwf-hermes\nagentOverrides: null\nagents:\n  uwf-hermes:\n    command: uwf-hermes\n`);
+    return {
+        casDir,
+        stepHash,
+        startHash,
+        workflowHash,
+        detailHash,
+        mockAgentPath,
+        failingAgentPath,
+        promptCapturePath,
+        modeCapturePath,
+        forkSessionCapturePath,
+        askSessionCapturePath,
+        envCapturePath,
+    };
+}
+function runUwf(args, casDir) {
+    const cliPath = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "dist", "cli.js");
+    try {
+        const stdout = execFileSync(process.execPath, [cliPath, ...args], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "pipe"],
+            env: {
+                ...process.env,
+                UWF_HOME: tmpDir,
+                OCAS_HOME: casDir,
+            },
+            cwd: tmpDir,
+            timeout: 30000,
+        });
+        return { stdout, stderr: "", status: 0 };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            stdout: typeof err.stdout === "string" ? err.stdout : (err.stdout?.toString("utf8") ?? ""),
+            stderr: typeof err.stderr === "string" ? err.stderr : (err.stderr?.toString("utf8") ?? ""),
+            status: err.status ?? 1,
+        };
+    }
+}
+// ── Group 1: CLI argument validation ───────────────────────────────────────
+describe("uwf step ask - CLI argument validation", () => {
+    test("1.1 missing step-hash exits non-zero", async () => {
+        const { casDir } = await setupAskFixture();
+        const result = runUwf(["step", "ask"], casDir);
+        expect(result.status).not.toBe(0);
+    });
+    test("1.2 missing -p flag exits non-zero", async () => {
+        const { casDir, stepHash } = await setupAskFixture();
+        const result = runUwf(["step", "ask", stepHash], casDir);
+        expect(result.status).not.toBe(0);
+        expect(result.stderr.toLowerCase()).toMatch(/required|missing|prompt/);
+    });
+    test("1.3 step-hash and -p accepted as valid invocation", async () => {
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture();
+        const result = runUwf(["step", "ask", stepHash, "-p", "why?", "--agent", mockAgentPath], casDir);
+        expect(result.status).toBe(0);
+    });
+});
+// ── Group 2: CAS validation errors ────────────────────────────────────────
+describe("uwf step ask - CAS validation errors", () => {
+    test("2.1 non-existent CAS hash exits non-zero with 'not found'", async () => {
+        const { casDir, mockAgentPath } = await setupAskFixture();
+        const result = runUwf(["step", "ask", "0000000000000", "-p", "why?", "--agent", mockAgentPath], casDir);
+        expect(result.status).not.toBe(0);
+        expect(result.stderr.toLowerCase()).toContain("not found");
+    });
+    test("2.2 hash that is not a StepNode exits non-zero", async () => {
+        const { casDir, startHash, mockAgentPath } = await setupAskFixture();
+        // Use the StartNode hash — it exists but is not a StepNode
+        const result = runUwf(["step", "ask", startHash, "-p", "why?", "--agent", mockAgentPath], casDir);
+        expect(result.status).not.toBe(0);
+        expect(result.stderr.toLowerCase()).toContain("not a stepnode");
+    });
+    test("2.3 step with no detail ref exits non-zero", async () => {
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture({ withDetail: false });
+        const result = runUwf(["step", "ask", stepHash, "-p", "why?", "--agent", mockAgentPath], casDir);
+        expect(result.status).not.toBe(0);
+        expect(result.stderr.toLowerCase()).toMatch(/no detail|detail.*missing|missing.*detail/);
+    });
+});
+// ── Group 3: Successful ask (core behavior) ───────────────────────────────
+describe("uwf step ask - successful ask (core)", () => {
+    test("3.1 stdout contains agent's response text", async () => {
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture();
+        const result = runUwf(["step", "ask", stepHash, "-p", "why tar not zip?", "--agent", mockAgentPath], casDir);
+        expect(result.status).toBe(0);
+        expect(result.stdout).toContain("MOCK_ANSWER");
+        expect(result.stdout).toContain("why tar not zip?");
+    });
+    test("3.2 thread index entry (head, status) is identical before and after ask", async () => {
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture();
+        // Before ask: snapshot the thread state
+        const { createUwfStore, getThread } = await import("../store.js");
+        const before = await createUwfStore(tmpDir);
+        const beforeEntry = getThread(before.varStore, THREAD_ID);
+        expect(beforeEntry).not.toBeNull();
+        const result = runUwf(["step", "ask", stepHash, "-p", "anything", "--agent", mockAgentPath], casDir);
+        expect(result.status).toBe(0);
+        // After ask: thread state should be unchanged
+        const after = await createUwfStore(tmpDir);
+        const afterEntry = getThread(after.varStore, THREAD_ID);
+        expect(afterEntry).not.toBeNull();
+        expect(afterEntry?.head).toBe(beforeEntry?.head);
+        expect(afterEntry?.status).toBe(beforeEntry?.status);
+    });
+    test("3.3 no new StepNode is written to CAS (step count unchanged)", async () => {
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture();
+        // Count StepNodes before
+        const { createUwfStore } = await import("../store.js");
+        const before = await createUwfStore(tmpDir);
+        const stepSchemaHash = before.schemas.stepNode;
+        function countStepNodes(uwfStore) {
+            const candidates = [stepHash];
+            let count = 0;
+            for (const h of candidates) {
+                const node = uwfStore.store.cas.get(h);
+                if (node !== null && node.type === stepSchemaHash)
+                    count++;
+            }
+            return count;
+        }
+        const beforeCount = countStepNodes(before);
+        expect(beforeCount).toBe(1);
+        const result = runUwf(["step", "ask", stepHash, "-p", "anything", "--agent", mockAgentPath], casDir);
+        expect(result.status).toBe(0);
+        // After ask: still only the seeded StepNode exists at head; no new step appended.
+        const after = await createUwfStore(tmpDir);
+        const headNode = after.store.cas.get(stepHash);
+        expect(headNode).not.toBeNull();
+        expect(headNode?.type).toBe(after.schemas.stepNode);
+        // Confirm thread head still points to the original step hash
+        const { getThread } = await import("../store.js");
+        const entry = getThread(after.varStore, THREAD_ID);
+        expect(entry?.head).toBe(stepHash);
+    });
+});
+// ── Group 4: Fork cache semantics ─────────────────────────────────────────
+describe("uwf step ask - fork cache", { timeout: 15_000 }, () => {
+    test("4.1 first ask creates a fork session and caches it", async () => {
+        const { casDir, stepHash, mockAgentPath, forkSessionCapturePath } = await setupAskFixture();
+        const result = runUwf(["step", "ask", stepHash, "-p", "first ask", "--agent", mockAgentPath], casDir);
+        expect(result.status).toBe(0);
+        // The mock agent in fork mode receives the source session id
+        const forkArg = await readFile(forkSessionCapturePath, "utf8");
+        expect(forkArg).toBe(STEP_SESSION_ID);
+        // Cache file should now contain the ask key
+        const cachePath = join(tmpDir, "cache", "mock-sessions.json");
+        const raw = await readFile(cachePath, "utf8");
+        const parsed = JSON.parse(raw);
+        expect(parsed[`${stepHash}:ask`]).toBeDefined();
+        expect(parsed[`${stepHash}:ask`]).toBe(`forked-from-${STEP_SESSION_ID}`);
+    });
+    test("4.2 second ask on same step reuses the cached fork session", async () => {
+        const cachedFork = "ses-already-forked-once";
+        const { casDir, stepHash, mockAgentPath, modeCapturePath, askSessionCapturePath } = await setupAskFixture({ preCachedForkSessionId: cachedFork });
+        const result = runUwf(["step", "ask", stepHash, "-p", "second ask", "--agent", mockAgentPath], casDir);
+        expect(result.status).toBe(0);
+        // The mock agent must have been invoked in `ask` mode (no fork performed).
+        const mode = await readFile(modeCapturePath, "utf8");
+        expect(mode).toBe("ask");
+        // The ask invocation should have received the cached fork session id.
+        const askArg = await readFile(askSessionCapturePath, "utf8");
+        expect(askArg).toBe(cachedFork);
+    });
+    test("4.3 different step hash creates an independent fork", async () => {
+        // Run a first ask on the base step → caches forkA
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture();
+        const r1 = runUwf(["step", "ask", stepHash, "-p", "ask on step A", "--agent", mockAgentPath], casDir);
+        expect(r1.status).toBe(0);
+        // Build a second StepNode (different hash) with a different sessionId so
+        // its detail-derived ask session is independent of the first.
+        const { createUwfStore } = await import("../store.js");
+        const uwf = await createUwfStore(tmpDir);
+        const detailSchemaHash = await putSchema(uwf.store, DETAIL_SCHEMA);
+        const outputSchemaHash = await putSchema(uwf.store, OUTPUT_SCHEMA);
+        const otherDetailHash = await uwf.store.cas.put(detailSchemaHash, {
+            sessionId: "ses-original-step-002",
+            model: "test-model",
+            duration: 1000,
+            turnCount: 0,
+            turns: [],
+        });
+        const otherOutputHash = await uwf.store.cas.put(outputSchemaHash, {
+            $status: "ok",
+            note: "alt",
+        });
+        // Reuse the same start ref the first step points to so the new step is a valid sibling.
+        const head = uwf.store.cas.get(stepHash);
+        const startRefFromHead = (head?.payload).start;
+        const properOtherStep = await uwf.store.cas.put(uwf.schemas.stepNode, {
+            start: startRefFromHead,
+            prev: null,
+            role: "worker",
+            output: otherOutputHash,
+            detail: otherDetailHash,
+            agent: mockAgentPath,
+            edgePrompt: "Start work",
+            startedAtMs: 1716600002000,
+            completedAtMs: 1716600003000,
+            cwd: tmpDir,
+            assembledPrompt: null,
+            usage: null,
+        });
+        // sanity check we constructed a separate hash
+        expect(properOtherStep).not.toBe(stepHash);
+        const r2 = runUwf(["step", "ask", properOtherStep, "-p", "ask on step B", "--agent", mockAgentPath], casDir);
+        expect(r2.status).toBe(0);
+        const cachePath = join(tmpDir, "cache", "mock-sessions.json");
+        const raw = await readFile(cachePath, "utf8");
+        const parsed = JSON.parse(raw);
+        expect(parsed[`${stepHash}:ask`]).toBeDefined();
+        expect(parsed[`${properOtherStep}:ask`]).toBeDefined();
+        expect(parsed[`${stepHash}:ask`]).not.toBe(parsed[`${properOtherStep}:ask`]);
+    });
+});
+// ── Group 5: Fallback (agent has no fork support) ─────────────────────────
+describe("uwf step ask - fallback path", () => {
+    test("5.1 fallback agent (no fork support) still answers via stdout", async () => {
+        // Use a fallback agent that ONLY supports `ask` mode without ever being asked
+        // to fork. The CLI should detect missing fork support and inject context instead.
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture();
+        // Create a fallback agent script that fails with non-zero exit on "fork" mode.
+        // Fallback path must NOT call mode=fork; it should call mode=ask directly.
+        const fallbackPath = join(tmpDir, "fallback-agent.sh");
+        const promptCapture = join(tmpDir, "fallback-prompt.txt");
+        const sessionCapture = join(tmpDir, "fallback-session.txt");
+        const modeCapture = join(tmpDir, "fallback-mode.txt");
+        await writeFile(fallbackPath, `#!/bin/sh
+mode=""
+prompt=""
+session=""
+detail=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --mode) mode="$2"; shift 2 ;;
+    --prompt) prompt="$2"; shift 2 ;;
+    --session) session="$2"; shift 2 ;;
+    --detail) detail="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+printf '%s' "$mode" > '${modeCapture}'
+printf '%s' "$prompt" > '${promptCapture}'
+printf '%s' "$session" > '${sessionCapture}'
+case "$mode" in
+  fork) echo "fork not supported" >&2; exit 99 ;;
+  ask) printf 'FALLBACK_ANSWER for: %s (detail=%s)\\n' "$prompt" "$detail" ;;
+  *) echo "unknown" >&2; exit 1 ;;
+esac
+`, { mode: 0o755 });
+        const result = runUwf(["step", "ask", stepHash, "-p", "explain context", "--agent", fallbackPath, "--no-fork"], casDir);
+        expect(result.status).toBe(0);
+        expect(result.stdout).toContain("FALLBACK_ANSWER");
+        expect(result.stdout).toContain("explain context");
+        // The fallback agent should be invoked in `ask` mode, with NO session id
+        // (since no fork happened). The detail ref must be passed for context injection.
+        const mode = await readFile(modeCapture, "utf8");
+        expect(mode).toBe("ask");
+        const session = await readFile(sessionCapture, "utf8");
+        expect(session).toBe("");
+        // Make sure mockAgentPath's mock never ran.
+        void mockAgentPath;
+    });
+    test("5.2 fallback ask still does NOT mutate thread state", async () => {
+        const { casDir, stepHash } = await setupAskFixture();
+        const fallbackPath = join(tmpDir, "fallback-agent.sh");
+        await writeFile(fallbackPath, `#!/bin/sh
+mode=""
+prompt=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --mode) mode="$2"; shift 2 ;;
+    --prompt) prompt="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+case "$mode" in
+  fork) echo "fork not supported" >&2; exit 99 ;;
+  ask) printf 'OK %s\\n' "$prompt" ;;
+  *) exit 1 ;;
+esac
+`, { mode: 0o755 });
+        const { createUwfStore, getThread } = await import("../store.js");
+        const before = await createUwfStore(tmpDir);
+        const beforeEntry = getThread(before.varStore, THREAD_ID);
+        const result = runUwf(["step", "ask", stepHash, "-p", "any", "--agent", fallbackPath, "--no-fork"], casDir);
+        expect(result.status).toBe(0);
+        const after = await createUwfStore(tmpDir);
+        const afterEntry = getThread(after.varStore, THREAD_ID);
+        expect(afterEntry?.head).toBe(beforeEntry?.head);
+        expect(afterEntry?.status).toBe(beforeEntry?.status);
+    });
+});
+// ── Group 6: Agent resolution ─────────────────────────────────────────────
+describe("uwf step ask - agent resolution", () => {
+    test("6.1 without --agent flag, agent is resolved from step's agent field", async () => {
+        // Step's agent field points at mockAgentPath by default.
+        const { casDir, stepHash, modeCapturePath, promptCapturePath } = await setupAskFixture();
+        const result = runUwf(["step", "ask", stepHash, "-p", "explain"], casDir);
+        expect(result.status).toBe(0);
+        // The mockAgentPath must have been invoked in ask mode with the user prompt.
+        const mode = await readFile(modeCapturePath, "utf8");
+        expect(mode).toBe("ask");
+        const captured = await readFile(promptCapturePath, "utf8");
+        expect(captured).toBe("explain");
+    });
+    test("6.2 --agent override beats step's recorded agent", async () => {
+        // Record a non-existent agent in step.agent. Provide a working one via --agent.
+        const { casDir, stepHash, mockAgentPath } = await setupAskFixture({
+            stepAgentNameOverride: "uwf-does-not-exist",
+        });
+        const result = runUwf(["step", "ask", stepHash, "-p", "explain", "--agent", mockAgentPath], casDir);
+        expect(result.status).toBe(0);
+        expect(result.stdout).toContain("MOCK_ANSWER");
+    });
+});
+//# sourceMappingURL=step-ask.test.js.map