@chrisjowen/wheelhouse 0.1.1 → 0.2.1

package/build/server/chunks/chunks/access.js-XFAczbHS.js

@@ -1,816 +0,0 @@
-import path from 'node:path';
-import { j as json } from './utils.js-DTSGDHlH.js';
-import { N as NO_STORE } from './http.js-TzZuOtxn.js';
-import { e as currentFleet, k as defaultStateDir, g as getRuntime, m as isInside, t as trackChild } from './runtime.js-fVZqJsqU.js';
-import { stat, readFile, readdir, mkdir, writeFile, rename, rm } from 'node:fs/promises';
-import { spawn } from 'node:child_process';
-import { S as SPEC_SECTIONS, a as SPEC_ID, s as summarize, n as normalizeSpec, e as emptySpec, i as isSectionId, M as MAX_COMMENTS, C as COMMENT_ID, I as IMAGE_NAME, c as changedSections, b as MAX_TURNS } from './spec.js-B0yI1XqG.js';
-import { randomBytes } from 'node:crypto';
-
-const CLAUDE_EFFORTS = ["low", "medium", "high"];
-const READ_ONLY_TOOLS = /* @__PURE__ */ new Set(["Read", "Grep", "Glob"]);
-function claudeArgs(c) {
-  const tools = c.tools.filter((t) => READ_ONLY_TOOLS.has(t));
-  return [
-    "-p",
-    "--output-format",
-    "stream-json",
-    "--verbose",
-    "--include-partial-messages",
-    "--model",
-    c.model,
-    "--effort",
-    c.effort,
-    "--system-prompt",
-    c.systemPrompt,
-    "--tools",
-    tools.join(","),
-    // The captain's hooks, plugins and MCP servers are for their own sessions, not this one.
-    "--setting-sources",
-    "",
-    "--strict-mcp-config",
-    "--no-session-persistence"
-  ];
-}
-const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : 0;
-function usageOf(o) {
-  const u = o.usage && typeof o.usage === "object" ? o.usage : {};
-  return {
-    inputTokens: num(u.input_tokens) + num(u.cache_read_input_tokens) + num(u.cache_creation_input_tokens),
-    outputTokens: num(u.output_tokens),
-    costUsd: num(o.total_cost_usd)
-  };
-}
-function toolDetail(input) {
-  if (!input || typeof input !== "object") return "";
-  const i = input;
-  const v = i.file_path ?? i.pattern ?? i.path ?? "";
-  return typeof v === "string" ? v.slice(0, 200) : "";
-}
-function readLine(line, emit) {
-  let o;
-  try {
-    const v = JSON.parse(line);
-    if (!v || typeof v !== "object") return null;
-    o = v;
-  } catch {
-    return null;
-  }
-  if (o.type === "stream_event" && o.event && typeof o.event === "object") {
-    const ev = o.event;
-    const delta = ev.delta;
-    if (ev.type === "message_start") emit({ type: "message" });
-    else if (ev.type === "content_block_delta" && delta?.type === "text_delta") {
-      if (typeof delta.text === "string" && delta.text) emit({ type: "text", text: delta.text });
-    }
-    return null;
-  }
-  if (o.type === "assistant" && o.message && typeof o.message === "object") {
-    const content = o.message.content;
-    for (const c of Array.isArray(content) ? content : []) {
-      if (c && typeof c === "object" && c.type === "tool_use") {
-        const t = c;
-        emit({ type: "tool", name: String(t.name ?? "tool"), detail: toolDetail(t.input) });
-      }
-    }
-    return null;
-  }
-  if (o.type === "result") {
-    const usage = usageOf(o);
-    const text = typeof o.result === "string" ? o.result : "";
-    if (o.is_error === true || o.subtype !== "success") {
-      return {
-        result: { ok: false, message: text || `claude stopped (${String(o.subtype)}).`, usage }
-      };
-    }
-    return { result: { ok: true, text, usage } };
-  }
-  return null;
-}
-const NO_USAGE = { inputTokens: 0, outputTokens: 0, costUsd: 0 };
-function runClaude(config, opts) {
-  return new Promise((resolve) => {
-    let child;
-    try {
-      child = spawn(config.bin, claudeArgs(config), {
-        cwd: config.cwd,
-        env: opts.env ?? process.env,
-        shell: false,
-        detached: true,
-        stdio: ["pipe", "pipe", "pipe"]
-      });
-    } catch (err) {
-      resolve({ ok: false, message: spawnMessage(config.bin, err), usage: NO_USAGE });
-      return;
-    }
-    const kill = trackChild(child);
-    let result = null;
-    let failure = null;
-    let settled = false;
-    let pending = "";
-    let stderr = "";
-    const finish = (fallback) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      opts.signal?.removeEventListener("abort", abort);
-      if (pending.trim()) handle(pending);
-      resolve(
-        failure ? { ok: false, message: failure, usage: result?.usage ?? NO_USAGE } : result ?? { ok: false, message: fallback, usage: NO_USAGE }
-      );
-    };
-    const stop = (why) => {
-      failure ??= why;
-      kill();
-    };
-    const timer = setTimeout(
-      () => stop(`The interviewer took longer than ${Math.round(opts.timeoutMs / 1e3)} s.`),
-      opts.timeoutMs
-    );
-    const abort = () => stop("Stopped.");
-    if (opts.signal?.aborted) abort();
-    opts.signal?.addEventListener("abort", abort);
-    const handle = (line) => {
-      const r = readLine(line, (e) => opts.onEvent?.(e));
-      if (r) result = r.result;
-    };
-    child.stdout?.setEncoding("utf8");
-    child.stdout?.on("data", (chunk) => {
-      pending += chunk;
-      let nl;
-      while ((nl = pending.indexOf("\n")) >= 0) {
-        const line = pending.slice(0, nl);
-        pending = pending.slice(nl + 1);
-        if (line.trim()) handle(line);
-      }
-      if (pending.length > 4 * 1024 * 1024) stop("The interviewer wrote more than expected.");
-    });
-    child.stderr?.setEncoding("utf8");
-    child.stderr?.on("data", (chunk) => {
-      if (stderr.length < 8192) stderr += chunk;
-    });
-    child.stdin?.on("error", () => {
-    });
-    child.stdin?.end(opts.prompt);
-    child.on("error", (err) => {
-      failure ??= spawnMessage(config.bin, err);
-      finish(failure);
-    });
-    child.on("close", (code) => {
-      const why = stderr.trim().split("\n").filter(Boolean).pop();
-      finish(
-        code === 0 ? "claude finished without an answer." : `claude exited with code ${code}${why ? `: ${why.slice(0, 300)}` : ""}.`
-      );
-    });
-  });
-}
-function spawnMessage(bin, err) {
-  const code = err?.code;
-  if (code === "ENOENT") {
-    return `Could not find the claude CLI (${bin}). Install Claude Code, or point WHEELHOUSE_CLAUDE_BIN at it.`;
-  }
-  return `Could not start claude: ${err instanceof Error ? err.message : String(err)}`;
-}
-const SPEC_MARKER = "===SPEC===";
-const FIELDS = {
-  title: false,
-  project: false,
-  summary: false,
-  problem: false,
-  goal: false,
-  audience: false,
-  journeys: true,
-  scope: false,
-  nonGoals: false,
-  requirements: true,
-  uiNotes: false,
-  links: true,
-  constraints: false,
-  risks: false,
-  questions: true
-};
-const FALLBACK_INTERVIEW_SKILL = `Interview the captain relentlessly about every aspect of this until you reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one by one. For each question, give your recommended answer.
-
-Ask the questions one at a time, waiting for an answer to each before continuing. Asking several questions at once is bewildering.
-
-If a fact can be found by exploring the project (its files), look it up rather than asking. The decisions, though, are the captain's: put each one to them and wait for their answer.`;
-async function findInterviewSkill(dirs) {
-  const read = async (name) => {
-    for (const dir of dirs) {
-      try {
-        const raw = await readFile(path.join(dir, name, "SKILL.md"), "utf8");
-        const body = raw.replace(/^---\n[\s\S]*?\n---\n?/, "").trim();
-        if (body) return body.slice(0, 8e3);
-      } catch {
-      }
-    }
-    return null;
-  };
-  const grilling = await read("grilling");
-  if (grilling) return grilling;
-  const grill = await read("grill-me");
-  if (!grill) return null;
-  const pointer = grill.match(/^Run an? `\/([\w-]+)` session\.?$/);
-  return pointer ? await read(pointer[1]) : grill;
-}
-function skillDirs(env = process.env) {
-  const home = env.HOME ?? "";
-  const config = env.CLAUDE_CONFIG_DIR || path.join(home, ".claude");
-  return [path.join(config, "skills"), path.join(home, ".agents", "skills")];
-}
-function systemPrompt(skill) {
-  const sections = SPEC_SECTIONS.map((s) => `- ${s.title}: ${s.prompt}`).join("\n");
-  return `You are the spec interviewer in Wheelhouse, the captain's window onto Firstmate, an AI crew that builds software. The captain has an idea for a piece of work. Your job is to grill them, one question at a time, until the idea is a clear, buildable spec, and to keep the spec up to date after every answer. When the spec is done the captain sends it to Firstmate as a build request. You never build, change or write anything yourself: you only ask, read and update the spec.
-
-# How to interview
-
-${skill ?? FALLBACK_INTERVIEW_SKILL}
-
-In this interview, also:
-- Ask exactly one question per turn. Keep each message short: a sentence or two of context at most, then the question.
-- Challenge vague answers ("fast", "simple", "users") and ask for the concrete case.
-- Offer 2 to 4 short answers the captain can pick from, and say which one you recommend and why, in a few words. The captain may answer in their own words instead.
-- Cover the spec's sections in a sensible order, skipping what does not apply:
-${sections}
-- Turn what the captain says into testable requirements, one check each.
-- Know when to stop. When the spec covers the problem, who it is for, how they use it, scope, testable requirements and the main risks, and nothing important is left open, say the spec looks ready to send to build, ask whether anything is missing, and set "done" to true. Do not drag the interview on with minor questions.
-
-# Comments
-
-The captain can comment on parts of the spec. Address every open comment you are given: revise the spec to reflect it, or ask a follow-up question when it needs a decision. Mark each one you addressed as resolved with a one-line reply saying what you did.
-
-# How to answer
-
-Write your message to the captain in plain Markdown. Then, on its own line, write ${SPEC_MARKER} and after it one JSON object, with no code fence:
-
-{"spec": {<only the fields you changed>}, "options": ["...", "..."], "recommended": 0, "resolved": [{"id": "c-...", "reply": "..."}], "done": false}
-
-- "spec" holds the fields you changed, each with its whole new value. Text fields: title, project, summary, problem, goal, audience, scope, nonGoals, uiNotes, constraints, risks. List fields (arrays of strings): journeys, requirements, links, questions. Keep the captain's words where you can; write in plain, short sentences. "questions" holds what is still undecided.
-- "options" are the answers you offer for your question (may be empty); "recommended" is the index of the one you recommend, or null.
-- "resolved" lists the comments you addressed (may be empty).
-- Put the options in "options", not in your message.`;
-}
-function specFields(d) {
-  const out = {};
-  for (const f of Object.keys(FIELDS)) out[f] = d[f];
-  return out;
-}
-const sectionTitle = (id) => SPEC_SECTIONS.find((s) => s.id === id)?.title ?? id;
-function openComments(d) {
-  return d.comments.filter((c) => !c.resolvedAt);
-}
-function turnPrompt(d) {
-  const transcript = d.interview.turns.map((t) => `${t.role === "agent" ? "You" : "Captain"}: ${t.text}`).join("\n\n");
-  const comments = openComments(d).map(
-    (c) => `- [${c.id}] on "${sectionTitle(c.section)}"${c.quote ? `, about "${c.quote}"` : ""}: ${c.text}`
-  ).join("\n");
-  const turns = d.interview.turns;
-  const next = turns.at(-1)?.role === "captain" ? turns.length <= 1 ? "The captain has just described what they want built (the last message above). Start the interview: fill in what you can of the spec from it, then ask your first question." : "The captain has just answered (the last message above). Update the spec with the answer, then ask your next question, or say the spec is ready." : comments ? "The captain has added comments on the spec. Address them, then carry on with the interview." : "Carry on with the interview: ask your next question, or say the spec is ready.";
-  return [
-    `# The spec so far
-
-${JSON.stringify(specFields(d), null, 2)}`,
-    transcript ? `# The interview so far
-
-${transcript}` : "",
-    comments ? `# The captain's open comments on the spec
-
-${comments}` : "",
-    `# Your turn
-
-${next}`
-  ].filter(Boolean).join("\n\n");
-}
-function parseTail(tail) {
-  const body = tail.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "");
-  const start = body.indexOf("{");
-  const end = body.lastIndexOf("}");
-  if (start < 0 || end < start) return null;
-  try {
-    const v = JSON.parse(body.slice(start, end + 1));
-    return v && typeof v === "object" && !Array.isArray(v) ? v : null;
-  } catch {
-    return null;
-  }
-}
-function parseReply(raw) {
-  const at = raw.indexOf(SPEC_MARKER);
-  const message = (at < 0 ? raw : raw.slice(0, at)).trim();
-  const tail = at < 0 ? null : parseTail(raw.slice(at + SPEC_MARKER.length));
-  const reply = {
-    message,
-    spec: {},
-    options: [],
-    recommended: null,
-    resolved: [],
-    done: false
-  };
-  if (!tail) return reply;
-  const spec = tail.spec && typeof tail.spec === "object" ? tail.spec : {};
-  for (const f of Object.keys(FIELDS)) {
-    const v = spec[f];
-    if (FIELDS[f] && Array.isArray(v)) {
-      reply.spec[f] = v.filter((x) => typeof x === "string");
-    } else if (!FIELDS[f] && typeof v === "string") {
-      reply.spec[f] = v;
-    }
-  }
-  if (Array.isArray(tail.options)) {
-    reply.options = tail.options.filter((x) => typeof x === "string" && !!x.trim()).map((x) => x.trim().slice(0, 500)).slice(0, 6);
-  }
-  const rec = tail.recommended;
-  reply.recommended = typeof rec === "number" && Number.isInteger(rec) && rec >= 0 && rec < reply.options.length ? rec : null;
-  if (Array.isArray(tail.resolved)) {
-    for (const r of tail.resolved) {
-      if (r && typeof r === "object" && typeof r.id === "string") {
-        const { id, reply: text } = r;
-        reply.resolved.push({ id, reply: typeof text === "string" ? text : "" });
-      }
-    }
-  }
-  reply.done = tail.done === true;
-  return reply;
-}
-function applyReply(d, reply, now = /* @__PURE__ */ new Date()) {
-  const at = now.toISOString();
-  const edited = normalizeSpec({ ...d, ...reply.spec }, d.id, now) ?? d;
-  const next = {
-    ...d,
-    ...Object.fromEntries(Object.keys(FIELDS).map((f) => [f, edited[f]]))
-  };
-  const changed = changedSections(d, next);
-  const resolved = new Map(reply.resolved.map((r) => [r.id, r.reply]));
-  next.comments = d.comments.map(
-    (c) => !c.resolvedAt && resolved.has(c.id) ? { ...c, resolvedAt: at, reply: (resolved.get(c.id) ?? "").slice(0, 2e3) } : c
-  );
-  next.interview = {
-    ...d.interview,
-    done: reply.done,
-    turns: [
-      ...d.interview.turns,
-      {
-        role: "agent",
-        text: reply.message || "I have updated the spec.",
-        at,
-        options: reply.options,
-        recommended: reply.recommended,
-        changed
-      }
-    ]
-  };
-  next.updatedAt = at;
-  return { draft: next, changed };
-}
-class MessageStream {
-  text = "";
-  shown = 0;
-  ended = false;
-  /** New text to show, if any. */
-  push(chunk) {
-    if (this.ended) return "";
-    this.text += chunk;
-    const at = this.text.indexOf(SPEC_MARKER);
-    if (at >= 0) {
-      this.ended = true;
-      return this.take(at);
-    }
-    let safe = this.text.length;
-    for (let k = Math.min(SPEC_MARKER.length - 1, this.text.length); k > 0; k--) {
-      if (SPEC_MARKER.startsWith(this.text.slice(-k))) {
-        safe = this.text.length - k;
-        break;
-      }
-    }
-    return this.take(safe);
-  }
-  /** Start over (the agent began a new message, e.g. after reading a file). */
-  reset() {
-    this.text = "";
-    this.shown = 0;
-    this.ended = false;
-  }
-  take(upTo) {
-    const out = this.text.slice(this.shown, upTo);
-    this.shown = Math.max(this.shown, upTo);
-    return out;
-  }
-}
-function interviewerSettings(env = process.env) {
-  const effort = env.WHEELHOUSE_SPEC_EFFORT;
-  return {
-    bin: env.WHEELHOUSE_CLAUDE_BIN || "claude",
-    model: env.WHEELHOUSE_SPEC_MODEL || "sonnet",
-    effort: CLAUDE_EFFORTS.includes(effort) ? effort : "low"
-  };
-}
-const TURN_TIMEOUT_MS = 5 * 6e4;
-class Interviewer {
-  constructor(store, opts) {
-    this.store = store;
-    this.opts = opts;
-  }
-  store;
-  opts;
-  busy = /* @__PURE__ */ new Set();
-  get settings() {
-    return this.opts.settings;
-  }
-  isBusy(id) {
-    return this.busy.has(id);
-  }
-  /**
-   * One turn: `answer` is what the captain just said (null to have the agent
-   * address new comments, or try again after a failed turn).
-   */
-  async turn(id, answer, onEvent = () => {
-  }, signal) {
-    if (this.busy.has(id)) {
-      return {
-        ok: false,
-        status: 409,
-        message: "The interviewer is already working on this spec.",
-        draft: null
-      };
-    }
-    this.busy.add(id);
-    try {
-      let draft = await this.store.get(id);
-      if (!draft) return { ok: false, status: 404, message: "That spec no longer exists.", draft };
-      const said = answer?.trim() ?? "";
-      if (said) draft = await this.store.addAnswer(id, said);
-      if (!draft) return { ok: false, status: 404, message: "That spec no longer exists.", draft };
-      if (!said && !draft.interview.turns.length && !openComments(draft).length) {
-        return {
-          ok: false,
-          status: 400,
-          message: "Say what you want built first.",
-          draft
-        };
-      }
-      const project = draft.project.trim();
-      const cwd = project && await this.opts.projectPath?.(project) || null;
-      const readable = !!cwd && await isDir(cwd);
-      const config = {
-        ...this.opts.settings,
-        systemPrompt: systemPrompt(await findInterviewSkill(this.opts.skillDirs ?? skillDirs())),
-        tools: readable ? ["Read", "Grep", "Glob"] : [],
-        cwd: readable ? cwd : this.store.dir
-      };
-      const stream = new MessageStream();
-      const result = await runClaude(config, {
-        prompt: turnPrompt(draft),
-        env: this.opts.env,
-        timeoutMs: this.opts.timeoutMs ?? TURN_TIMEOUT_MS,
-        signal,
-        onEvent: (e) => {
-          if (e.type === "message") {
-            stream.reset();
-            onEvent({ type: "reset" });
-          } else if (e.type === "text") {
-            const text = stream.push(e.text);
-            if (text) onEvent({ type: "text", text });
-          } else onEvent(e);
-        }
-      });
-      if (!result.ok) {
-        const after = await this.store.addUsage(id, result.usage);
-        return { ok: false, status: 502, message: result.message, draft: after ?? draft };
-      }
-      const saved = await this.store.applyAgent(id, parseReply(result.text), result.usage);
-      if (!saved) return { ok: false, status: 404, message: "That spec no longer exists.", draft };
-      return { ok: true, draft: saved };
-    } finally {
-      this.busy.delete(id);
-    }
-  }
-}
-async function isDir(p) {
-  try {
-    return (await stat(p)).isDirectory();
-  } catch {
-    return false;
-  }
-}
-const SPEC_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
-const SPEC_IMAGE_TYPES = {
-  "image/png": "png",
-  "image/jpeg": "jpg",
-  "image/webp": "webp",
-  "image/gif": "gif"
-};
-const CONTENT_TYPE = {
-  png: "image/png",
-  jpg: "image/jpeg",
-  jpeg: "image/jpeg",
-  webp: "image/webp",
-  gif: "image/gif"
-};
-const STALE_EDITABLE = ["project", "title", "mode"];
-const token = () => randomBytes(6).toString("hex");
-const addUsage = (d, u) => ({
-  turns: d.interview.usage.turns + 1,
-  inputTokens: d.interview.usage.inputTokens + u.inputTokens,
-  outputTokens: d.interview.usage.outputTokens + u.outputTokens,
-  costUsd: d.interview.usage.costUsd + u.costUsd
-});
-class SpecStore {
-  constructor(dir) {
-    this.dir = dir;
-  }
-  dir;
-  queues = /* @__PURE__ */ new Map();
-  /** Run one read-change-write of a draft after any already under way for it. */
-  serial(id, fn) {
-    const run = (this.queues.get(id) ?? Promise.resolve()).then(fn, fn);
-    const tail = run.catch(() => {
-    });
-    this.queues.set(id, tail);
-    void tail.then(() => {
-      if (this.queues.get(id) === tail) this.queues.delete(id);
-    });
-    return run;
-  }
-  file(id) {
-    return path.join(this.dir, `${id}.json`);
-  }
-  /** Where a spec's pictures live (also what the message to Firstmate names). */
-  imageDir(id) {
-    return path.join(this.dir, id);
-  }
-  /** Every draft, most recently edited first. Unreadable files are skipped. */
-  async list() {
-    let names;
-    try {
-      names = await readdir(this.dir);
-    } catch {
-      return [];
-    }
-    const out = [];
-    for (const n of names) {
-      const id = n.endsWith(".json") ? n.slice(0, -5) : "";
-      if (!SPEC_ID.test(id)) continue;
-      const d = await this.get(id);
-      if (d) out.push(summarize(d));
-    }
-    return out.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
-  }
-  async get(id) {
-    if (!SPEC_ID.test(id)) return null;
-    try {
-      return normalizeSpec(JSON.parse(await readFile(this.file(id), "utf8")), id);
-    } catch {
-      return null;
-    }
-  }
-  async create(now = /* @__PURE__ */ new Date()) {
-    const d = emptySpec(`spec-${token()}`, now);
-    await this.write(d);
-    return d;
-  }
-  /**
-   * Save the captain's edits over an existing draft. The id, creation time,
-   * pictures (which only upload and remove change), when it was last sent
-   * (which only `markSent` changes), the interview and the comments (which
-   * only their own calls change) are kept from the stored draft. Edits made
-   * on a copy older than the interview's last turn keep the spec as that
-   * turn left it, apart from those of the project, the title and the mode
-   * the edit lists in `edited` as changed by the captain.
-   */
-  save(id, edit, now = /* @__PURE__ */ new Date()) {
-    return this.serial(id, async () => {
-      const before = await this.get(id);
-      if (!before) return null;
-      const next = normalizeSpec(edit, id, now);
-      if (!next) return null;
-      const captions = new Map(next.images.map((i) => [i.name, i.caption]));
-      const stale = next.interview.turns.at(-1)?.at !== before.interview.turns.at(-1)?.at;
-      const listed = edit.edited;
-      const edited = new Set(Array.isArray(listed) ? listed : []);
-      const merged = stale ? { ...before } : next;
-      if (stale) {
-        for (const f of STALE_EDITABLE) if (edited.has(f)) Object.assign(merged, { [f]: next[f] });
-      }
-      const d = {
-        ...merged,
-        createdAt: before.createdAt,
-        updatedAt: now.toISOString(),
-        sentAt: before.sentAt,
-        interview: before.interview,
-        comments: before.comments,
-        images: before.images.map((i) => ({
-          ...i,
-          caption: captions.get(i.name) ?? i.caption
-        }))
-      };
-      await this.write(d);
-      return d;
-    });
-  }
-  /** Record that the draft was sent to Firstmate, changing nothing else. */
-  markSent(id, now = /* @__PURE__ */ new Date()) {
-    return this.serial(id, async () => {
-      const d = await this.get(id);
-      if (!d) return null;
-      const next = { ...d, sentAt: now.toISOString() };
-      await this.write(next);
-      return next;
-    });
-  }
-  /** Change a draft with `fn` (null when there is no such draft), stamped and written. */
-  change(id, now, fn) {
-    return this.serial(id, async () => {
-      const d = await this.get(id);
-      const next = d && fn(d);
-      if (!next) return null;
-      const out = { ...next, updatedAt: now.toISOString() };
-      await this.write(out);
-      return out;
-    });
-  }
-  /** Add what the captain said to the interview. */
-  addAnswer(id, text, now = /* @__PURE__ */ new Date()) {
-    return this.change(id, now, (d) => ({
-      ...d,
-      mode: "interview",
-      interview: {
-        ...d.interview,
-        turns: [
-          ...d.interview.turns,
-          {
-            role: "captain",
-            text: text.slice(0, 2e4),
-            at: now.toISOString(),
-            options: [],
-            recommended: null,
-            changed: []
-          }
-        ].slice(-MAX_TURNS)
-      }
-    }));
-  }
-  /**
-   * Apply the agent's reply to the draft as it is now (comments added while
-   * the agent worked are kept), and count what the turn cost.
-   */
-  applyAgent(id, reply, usage, now = /* @__PURE__ */ new Date()) {
-    return this.change(id, now, (d) => {
-      const { draft } = applyReply(d, reply, now);
-      draft.interview.turns = draft.interview.turns.slice(-MAX_TURNS);
-      draft.interview.usage = addUsage(d, usage);
-      return draft;
-    });
-  }
-  /** Count what a turn that produced no reply cost. */
-  addUsage(id, usage, now = /* @__PURE__ */ new Date()) {
-    return this.change(id, now, (d) => ({
-      ...d,
-      interview: { ...d.interview, usage: addUsage(d, usage) }
-    }));
-  }
-  /**
-   * Leave a comment on a section of the spec, for the agent to address. The
-   * oldest resolved comments make room for it; null when too many are open.
-   */
-  addComment(id, c, now = /* @__PURE__ */ new Date()) {
-    const text = typeof c.text === "string" ? c.text.trim().slice(0, 4e3) : "";
-    if (!isSectionId(c.section) || !text) return Promise.resolve(null);
-    const comment = {
-      id: `c-${token()}`,
-      section: c.section,
-      quote: typeof c.quote === "string" ? c.quote.trim().slice(0, 2e3) : "",
-      text,
-      at: now.toISOString(),
-      resolvedAt: null,
-      reply: ""
-    };
-    return this.change(id, now, (d) => {
-      if (openComments(d).length >= MAX_COMMENTS) return null;
-      let drop = d.comments.length + 1 - MAX_COMMENTS;
-      const kept = d.comments.filter((c2) => !(drop > 0 && c2.resolvedAt && drop-- > 0));
-      return { ...d, comments: [...kept, comment] };
-    });
-  }
-  /** Take a comment back. */
-  removeComment(id, commentId, now = /* @__PURE__ */ new Date()) {
-    if (!COMMENT_ID.test(commentId)) return Promise.resolve(null);
-    return this.change(
-      id,
-      now,
-      (d) => d.comments.some((c) => c.id === commentId) ? { ...d, comments: d.comments.filter((c) => c.id !== commentId) } : null
-    );
-  }
-  /**
-   * Write the whole spec beside the draft as `spec.md`, for a spec too long
-   * to send as one message; returns the file's path.
-   */
-  async writeAttachment(id, markdown) {
-    if (!SPEC_ID.test(id) || !await this.get(id)) return null;
-    const file = path.join(this.imageDir(id), "spec.md");
-    await mkdir(this.imageDir(id), { recursive: true });
-    const tmp = `${file}.${token()}.tmp`;
-    await writeFile(tmp, markdown);
-    await rename(tmp, file);
-    return file;
-  }
-  remove(id) {
-    return this.serial(id, async () => {
-      if (!SPEC_ID.test(id) || !await this.get(id)) return false;
-      await rm(this.file(id), { force: true });
-      await rm(this.imageDir(id), { recursive: true, force: true });
-      return true;
-    });
-  }
-  /** Store a picture for a draft and list it on the draft. */
-  addImage(id, type, bytes, caption, now = /* @__PURE__ */ new Date()) {
-    return this.serial(id, async () => {
-      const ext = SPEC_IMAGE_TYPES[type];
-      const d = await this.get(id);
-      if (!ext || !d) return null;
-      const name = `img-${token()}.${ext}`;
-      await mkdir(this.imageDir(id), { recursive: true });
-      await writeFile(path.join(this.imageDir(id), name), bytes);
-      const next = {
-        ...d,
-        updatedAt: now.toISOString(),
-        images: [...d.images, { name, caption: caption.slice(0, 500) }]
-      };
-      await this.write(next);
-      return next;
-    });
-  }
-  removeImage(id, name, now = /* @__PURE__ */ new Date()) {
-    return this.serial(id, async () => {
-      const d = await this.get(id);
-      if (!d || !IMAGE_NAME.test(name)) return null;
-      await rm(path.join(this.imageDir(id), name), { force: true });
-      const next = {
-        ...d,
-        updatedAt: now.toISOString(),
-        images: d.images.filter((i) => i.name !== name)
-      };
-      await this.write(next);
-      return next;
-    });
-  }
-  /** A picture the draft lists, with its content type; null for anything else. */
-  async readImage(id, name) {
-    if (!SPEC_ID.test(id) || !IMAGE_NAME.test(name)) return null;
-    const d = await this.get(id);
-    if (!d?.images.some((i) => i.name === name)) return null;
-    try {
-      const bytes = await readFile(path.join(this.imageDir(id), name));
-      return {
-        bytes,
-        type: CONTENT_TYPE[name.split(".").pop() ?? ""] ?? "application/octet-stream"
-      };
-    } catch {
-      return null;
-    }
-  }
-  async write(d) {
-    await mkdir(this.dir, { recursive: true });
-    const file = this.file(d.id);
-    const tmp = `${file}.${token()}.tmp`;
-    await writeFile(tmp, JSON.stringify(d, null, 2));
-    await rename(tmp, file);
-  }
-}
-let cached = null;
-let interviewer = null;
-async function specStore(env = process.env) {
-  const stateDir = defaultStateDir(env);
-  const runtime = await getRuntime();
-  if (runtime.configured && isInside(stateDir, runtime.install.homeDir)) {
-    return {
-      ok: false,
-      reason: `The Wheelhouse state directory ${stateDir} is inside the Firstmate home, so specs cannot be saved; choose one outside it with --state-dir.`
-    };
-  }
-  const dir = path.join(stateDir, "specs");
-  if (cached?.dir !== dir) cached = new SpecStore(dir);
-  return { ok: true, store: cached };
-}
-async function specStoreOrResponse() {
-  const s = await specStore();
-  return s.ok ? s.store : json({ message: s.reason }, { status: 503, headers: NO_STORE });
-}
-const notFound = () => json({ message: "That spec no longer exists." }, { status: 404, headers: NO_STORE });
-function specInterviewer(store) {
-  if (interviewer?.store !== store) {
-    interviewer = new Interviewer(store, {
-      settings: interviewerSettings(),
-      projectPath: async (name) => {
-        const want = name.toLowerCase();
-        const fleet = await currentFleet();
-        const p = fleet.projects.find(
-          (x) => x.name.toLowerCase() === want || x.id.toLowerCase() === want
-        );
-        return p?.path ?? null;
-      }
-    });
-  }
-  return interviewer;
-}
-
-export { SPEC_IMAGE_TYPES as S, specInterviewer as a, specStoreOrResponse as b, SPEC_IMAGE_MAX_BYTES as c, notFound as n, openComments as o, specStore as s };
-//# sourceMappingURL=access.js-XFAczbHS.js.map