@iowarp/clio-coder 0.4.3 → 0.4.5

package/dist/wiki-generate-C7IQOXSP.js

@@ -1,469 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  armInternalDispatchDeadline
-} from "./chunk-MNJGS2IN.js";
-import {
-  SchedulingDomainModule,
-  createPromptsDomainModule
-} from "./chunk-WCXUNS7U.js";
-import {
-  SafetyDomainModule
-} from "./chunk-YQWYVTMC.js";
-import {
-  ConfigDomainModule,
-  loadDomains
-} from "./chunk-WBKFA554.js";
-import {
-  createObservabilityDomainModule
-} from "./chunk-MWUZBSAQ.js";
-import "./chunk-VA5FNYMT.js";
-import "./chunk-4WR7VSYB.js";
-import {
-  ContextDomainModule,
-  buildWikiPagePrompt,
-  buildWikiPlanPrompt
-} from "./chunk-KK4JZPBQ.js";
-import "./chunk-R6Q67RJH.js";
-import "./chunk-Y3CBHOR6.js";
-import "./chunk-BEPZRGGU.js";
-import {
-  MAX_PAGE_ATTEMPTS,
-  pendingPages,
-  readAuthoredWikiPlan,
-  writeWikiPlanFile
-} from "./chunk-NDINPTJ4.js";
-import "./chunk-MXHC5QYU.js";
-import {
-  ResourcesDomainModule
-} from "./chunk-G76U63X4.js";
-import {
-  AgentsDomainModule
-} from "./chunk-UPZU6GE4.js";
-import "./chunk-RRNP2ANY.js";
-import "./chunk-DR52UMZW.js";
-import {
-  DispatchDomainModule
-} from "./chunk-AF4YM7Z4.js";
-import "./chunk-B4VEBZKF.js";
-import "./chunk-E3TPLWFX.js";
-import "./chunk-WRBAGUNF.js";
-import "./chunk-IWT4SF4R.js";
-import {
-  SessionDomainModule
-} from "./chunk-JKKCYP3C.js";
-import "./chunk-FTMGRKEF.js";
-import "./chunk-XRZT5WY5.js";
-import "./chunk-RVG5JXAL.js";
-import "./chunk-VIA6RFQZ.js";
-import "./chunk-T56WDKA5.js";
-import "./chunk-W6GROXXM.js";
-import "./chunk-2VIKGWFZ.js";
-import "./chunk-RKKLTLYB.js";
-import "./chunk-6PTFB5VS.js";
-import "./chunk-TXOTCRLG.js";
-import "./chunk-VKPAQYEB.js";
-import "./chunk-LCGCVYZ4.js";
-import "./chunk-LDJG7DW3.js";
-import "./chunk-NDDGJUXD.js";
-import "./chunk-CE5AX47J.js";
-import "./chunk-3DPEIQKN.js";
-import "./chunk-7DRAWPTZ.js";
-import "./chunk-5MEZN6CB.js";
-import "./chunk-4O6MANBS.js";
-import "./chunk-JVCV3ICN.js";
-import "./chunk-HVDIIIQW.js";
-import {
-  MiddlewareDomainModule
-} from "./chunk-2UG5F4C5.js";
-import "./chunk-5PSMVOLM.js";
-import "./chunk-2WZ546HR.js";
-import "./chunk-VG7TBQIY.js";
-import "./chunk-PAJQJ7BS.js";
-import "./chunk-EKCHAPYA.js";
-import "./chunk-L47TF46W.js";
-import "./chunk-RSJ25QSL.js";
-import "./chunk-XIVNBFZS.js";
-import "./chunk-NEDJ26B5.js";
-import "./chunk-42FMPA75.js";
-import "./chunk-H7IXIC72.js";
-import "./chunk-7DICMOS6.js";
-import "./chunk-OQE5J4C6.js";
-import "./chunk-HHV2GANA.js";
-import "./chunk-B4OAX3SI.js";
-import "./chunk-I7ZPNEJM.js";
-import "./chunk-GYV6VZOC.js";
-import "./chunk-UL3WSD3F.js";
-import "./chunk-JDAY6FIL.js";
-import "./chunk-OZNBF4L3.js";
-import "./chunk-ECH6PKUQ.js";
-import "./chunk-6XLNIQDB.js";
-import "./chunk-5B2AEOW5.js";
-import "./chunk-VAVR4IJY.js";
-import "./chunk-JGRC33J2.js";
-import "./chunk-4BJ5BYCE.js";
-import {
-  ToolNames
-} from "./chunk-K6BSR66V.js";
-import {
-  ProvidersDomainModule,
-  canonicalizeWireModelId
-} from "./chunk-XPWWI35G.js";
-import "./chunk-CFGTUFWB.js";
-import "./chunk-NZMNUPZZ.js";
-import "./chunk-2JH2WHGE.js";
-import "./chunk-HAXOFFRH.js";
-import "./chunk-R346GLFC.js";
-import "./chunk-KXDSS5WJ.js";
-import "./chunk-GHS5EBTQ.js";
-import "./chunk-D7E7WCDF.js";
-import "./chunk-BTK3SSSK.js";
-import "./chunk-NMJXSHBJ.js";
-import "./chunk-PMZVFWSR.js";
-import "./chunk-F4EKGO4N.js";
-import "./chunk-BWH6N36D.js";
-import "./chunk-UUVG37B4.js";
-import "./chunk-LBMZMYH2.js";
-import "./chunk-XAKHZX5N.js";
-import "./chunk-33YXPOE3.js";
-import "./chunk-7CR24IG7.js";
-import "./chunk-XPLRXC72.js";
-import "./chunk-IWHMRKLL.js";
-import "./chunk-VW6DOEDG.js";
-import "./chunk-UXCU4E3T.js";
-import "./chunk-LL4KHSZI.js";
-import "./chunk-JSC3U7TI.js";
-import "./chunk-S66XZJOF.js";
-import "./chunk-JIEGK6UF.js";
-import "./chunk-EBY63B7G.js";
-import "./chunk-6EJMN2Y3.js";
-import "./chunk-LLDJM5XK.js";
-import "./chunk-ID64D7PE.js";
-import "./chunk-336NSSKI.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
-import "./chunk-APJ265NV.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-NUGM5KR6.js";
-import "./chunk-5OIVVPHF.js";
-import "./chunk-YPC6ZR5L.js";
-import "./chunk-YXLYO42X.js";
-import "./chunk-2LEAKD4C.js";
-import "./chunk-BYP5D4HI.js";
-import {
-  init_esm_shims
-} from "./chunk-3R73A4XB.js";
-
-// src/cli/wiki-generate.ts
-init_esm_shims();
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { performance } from "node:perf_hooks";
-var UNRESOLVED_DOCUMENTER_MODEL = "unresolved-documenter-target";
-var WIKI_AGENT_ID = "wiki-writer";
-var PAGE_DEADLINE_MS = 6 * 60 * 1e3;
-var PLAN_DEADLINE_MS = 8 * 60 * 1e3;
-var RUN_BUDGET_MS = 60 * 60 * 1e3;
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function routeFields(route) {
-  return {
-    ...route.target !== void 0 ? { target: route.target } : {},
-    ...route.model !== void 0 ? { model: route.model } : {},
-    ...route.thinkingLevel !== void 0 ? { thinkingLevel: route.thinkingLevel } : {}
-  };
-}
-function eventPayloadString(event, key) {
-  if (!isRecord(event) || !isRecord(event.payload)) return null;
-  const value = event.payload[key];
-  return typeof value === "string" && value.length > 0 ? value : null;
-}
-function formatElapsed(ms) {
-  if (!Number.isFinite(ms) || ms < 0) return "elapsed unknown";
-  if (ms < 1e3) return `elapsed ${Math.round(ms)}ms`;
-  return `elapsed ${Math.round(ms / 1e3)}s`;
-}
-var BLOCK_REASON_MAX_CHARS = 80;
-function summarizeBlockReason(reason) {
-  const firstSentence = reason.split(/(?<=[.;])\s/, 1)[0]?.trim() ?? reason.trim();
-  const collapsed = firstSentence.replace(/\s+/g, " ");
-  return collapsed.length <= BLOCK_REASON_MAX_CHARS ? collapsed : `${collapsed.slice(0, BLOCK_REASON_MAX_CHARS - 1).trimEnd()}\u2026`;
-}
-var HEARTBEAT_MS = 3e4;
-async function drainDispatchEvents(events, onActivity) {
-  const tools = /* @__PURE__ */ new Map();
-  let completed = 0;
-  let errors = 0;
-  let blocked = 0;
-  let firstBlockReason = null;
-  for await (const event of events) {
-    if (!isRecord(event) || event.type !== "clio_coder_tool_finish") continue;
-    const tool = eventPayloadString(event, "tool");
-    if (!tool) continue;
-    const outcome = eventPayloadString(event, "outcome") ?? "done";
-    completed += 1;
-    tools.set(tool, (tools.get(tool) ?? 0) + 1);
-    if (outcome === "error") errors += 1;
-    if (outcome === "blocked") {
-      blocked += 1;
-      firstBlockReason ??= eventPayloadString(event, "reason");
-    }
-    onActivity?.(completed);
-  }
-  const mix = [...tools.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([tool, count]) => `${tool}=${count}`).join(", ");
-  return { tools: completed, errors, blocked, firstBlockReason, mix };
-}
-function summaryDetail(summary, startedAtClock) {
-  const blockedDetail = summary.blocked > 0 ? `; blocked=${summary.blocked}${summary.firstBlockReason ? ` (${summarizeBlockReason(summary.firstBlockReason)})` : ""}` : "";
-  return `${formatElapsed(performance.now() - startedAtClock)}; ${summary.mix || "no tools completed"}${summary.errors > 0 ? `; errors=${summary.errors}` : ""}${blockedDetail}`;
-}
-async function runWikiDispatch(input) {
-  const startedAt = Date.now();
-  const startedAtClock = performance.now();
-  let handle;
-  try {
-    handle = await input.dispatch.dispatch({
-      agentId: WIKI_AGENT_ID,
-      executionRole: "builder",
-      task: input.task,
-      cwd: input.cwd,
-      requestOrigin: "internal",
-      noSkills: true,
-      ...routeFields(input.route),
-      // `git` cannot answer anything for this dispatch. The prompt already
-      // embeds `git status` and `git log` verbatim, and the staging dir is
-      // under the gitignored `.clio-coder/`, so `op=diff` cannot see the pages this
-      // run is writing.
-      denyTools: [ToolNames.Git],
-      // Containment: the worker safety seam blocks any write-class tool call
-      // whose target escapes the staging dir.
-      writeRoots: [input.outputDir],
-      // Admission patience must match execution patience. Without this the
-      // queue applies its 60s default while `deadlineMs` below allows six
-      // minutes to run, so a page waiting behind two in-flight writers was
-      // dropped before it ever started. Observed live: a 33-page plan lost
-      // `core.md` to `dispatch: admission timed_out` at 10/33 while every
-      // page ahead of it was taking 110 to 125 seconds. A page the caller is
-      // willing to wait six minutes for is a page it should be willing to
-      // queue for six minutes.
-      assignmentDeadlineAt: startedAt + input.deadlineMs
-    });
-  } catch (err) {
-    return { ok: false, detail: err instanceof Error ? err.message : String(err) };
-  }
-  const deadline = armInternalDispatchDeadline(input.dispatch, handle.runId, input.label, input.deadlineMs);
-  let lastHeartbeatAt = startedAtClock;
-  try {
-    const summary = await drainDispatchEvents(handle.events, (tools) => {
-      const nowMs = performance.now();
-      if (!input.onHeartbeat || nowMs - lastHeartbeatAt < HEARTBEAT_MS) return;
-      lastHeartbeatAt = nowMs;
-      input.onHeartbeat({ elapsedMs: Math.round(nowMs - startedAtClock), tools });
-    });
-    const receipt = await handle.finalPromise;
-    if (deadline.timedOut()) return { ok: false, detail: `timed out; ${summaryDetail(summary, startedAtClock)}` };
-    if (receipt.exitCode !== 0) {
-      input.dispatch.abort(handle.runId);
-      return { ok: false, detail: `${receiptFailure(receipt)}; ${summaryDetail(summary, startedAtClock)}` };
-    }
-    return { ok: true, detail: summaryDetail(summary, startedAtClock) };
-  } catch (err) {
-    if (!deadline.timedOut()) input.dispatch.abort(handle.runId);
-    await handle.finalPromise.catch(() => void 0);
-    const reason = deadline.timedOut() ? "timed out" : err instanceof Error ? err.message : String(err);
-    return { ok: false, detail: `${reason}; ${formatElapsed(performance.now() - startedAtClock)}` };
-  } finally {
-    deadline.clear();
-  }
-}
-function receiptFailure(receipt) {
-  const code = receipt.outcomeCode ? ` (${receipt.outcomeCode})` : "";
-  return `exit ${receipt.exitCode}${code}`;
-}
-async function runPlanPhase(dispatch, input, route) {
-  input.progress?.({ phase: "generate", status: "running", message: "planning wiki pages" });
-  const outcome = await runWikiDispatch({
-    dispatch,
-    cwd: input.cwd,
-    outputDir: input.outputDir,
-    task: buildWikiPlanPrompt({
-      cwd: input.cwd,
-      mode: input.mode,
-      codewiki: input.codewiki,
-      generation: input.generation,
-      plan: input.plan,
-      unclaimedAreas: input.unclaimedAreas,
-      outputDir: input.outputDir,
-      gitHead: input.gitHead ?? null
-    }),
-    route,
-    deadlineMs: PLAN_DEADLINE_MS,
-    label: "wiki planner",
-    onHeartbeat: ({ elapsedMs, tools }) => input.progress?.({
-      phase: "generate",
-      status: "running",
-      message: `still planning (${formatElapsed(elapsedMs)}, ${tools} tool calls)`,
-      detail: `planner deadline ${Math.round(PLAN_DEADLINE_MS / 6e4)}m`
-    })
-  });
-  const revised = readAuthoredWikiPlan(input.outputDir, input.plan);
-  const plan = revised ?? input.plan;
-  input.progress?.({
-    phase: "generate",
-    status: "running",
-    message: outcome.ok ? `plan has ${plan.pages.length} page${plan.pages.length === 1 ? "" : "s"}` : "planner did not finish; using the indexed candidate plan",
-    detail: outcome.detail
-  });
-  return plan;
-}
-async function runPagePhase(dispatch, input, plan, page, route, position) {
-  const seeded = existsSync(join(input.outputDir, page.path));
-  const outcome = await runWikiDispatch({
-    dispatch,
-    cwd: input.cwd,
-    outputDir: input.outputDir,
-    task: buildWikiPagePrompt({
-      cwd: input.cwd,
-      mode: input.mode,
-      codewiki: input.codewiki,
-      page,
-      siblings: plan.pages,
-      outputDir: input.outputDir,
-      seeded
-    }),
-    route,
-    deadlineMs: PAGE_DEADLINE_MS,
-    label: `wiki page ${page.path}`,
-    onHeartbeat: ({ elapsedMs, tools }) => input.progress?.({
-      phase: "generate",
-      status: "running",
-      message: `still writing ${page.path} (${position.index}/${position.total}, ${formatElapsed(elapsedMs)}, ${tools} tool calls)`,
-      detail: `page deadline ${Math.round(PAGE_DEADLINE_MS / 6e4)}m`
-    })
-  });
-  const written = existsSync(join(input.outputDir, page.path));
-  const next = {
-    ...plan,
-    pages: plan.pages.map(
-      (entry) => entry.path === page.path ? { ...entry, status: written ? "written" : "pending", attempts: entry.attempts + 1 } : entry
-    )
-  };
-  writeWikiPlanFile(input.outputDir, next);
-  input.progress?.({
-    phase: "generate",
-    status: "running",
-    message: `${written ? "wrote" : "could not write"} ${page.path} (${position.index}/${position.total})`,
-    detail: outcome.detail
-  });
-  return next;
-}
-async function generateWikiWithDocumenter(dispatch, input, route = {}, runBudgetMs = RUN_BUDGET_MS) {
-  const startedAtClock = performance.now();
-  const routeDetail = [route.target, route.model, route.thinkingLevel ? `thinking=${route.thinkingLevel}` : void 0].filter((value) => value !== void 0).join("/");
-  input.progress?.({
-    phase: "generate",
-    status: "running",
-    message: "dispatching wiki writers",
-    detail: `one page per dispatch${routeDetail ? `; ${routeDetail}` : ""}`
-  });
-  let plan = input.resumed ? input.plan : await runPlanPhase(dispatch, input, route);
-  if (!input.resumed) writeWikiPlanFile(input.outputDir, plan);
-  const queue = pendingPages(plan);
-  if (queue.length === 0) {
-    input.progress?.({ phase: "generate", status: "running", message: "every planned page is already current" });
-    return;
-  }
-  {
-    const worstCaseMs = Math.min(runBudgetMs, queue.length * PAGE_DEADLINE_MS);
-    input.progress?.({
-      phase: "generate",
-      status: "running",
-      message: `${queue.length} page${queue.length === 1 ? "" : "s"} to write, one model run each`,
-      detail: `up to ${Math.round(worstCaseMs / 6e4)}m; progress is reported at least every ${Math.round(HEARTBEAT_MS / 1e3)}s and finished pages are kept if the run stops early`
-    });
-  }
-  for (const [index, page] of queue.entries()) {
-    if (performance.now() - startedAtClock >= runBudgetMs) {
-      const left = queue.length - index;
-      input.progress?.({
-        phase: "generate",
-        status: "running",
-        message: `run budget reached with ${left} page${left === 1 ? "" : "s"} unwritten`,
-        detail: `${formatElapsed(performance.now() - startedAtClock)}; staged pages are kept and promoted`
-      });
-      return;
-    }
-    const current = plan.pages.find((entry) => entry.path === page.path) ?? page;
-    if (current.status === "written" || current.attempts >= MAX_PAGE_ATTEMPTS) continue;
-    plan = await runPagePhase(dispatch, input, plan, current, route, {
-      index: index + 1,
-      total: queue.length
-    });
-  }
-}
-async function loadWikiDispatch() {
-  const loaded = await loadDomains([
-    ConfigDomainModule,
-    ResourcesDomainModule,
-    ContextDomainModule,
-    ProvidersDomainModule,
-    SafetyDomainModule,
-    createPromptsDomainModule({ noContextFiles: true }),
-    AgentsDomainModule,
-    MiddlewareDomainModule,
-    SessionDomainModule,
-    createObservabilityDomainModule({ dispatchTrace: false }),
-    SchedulingDomainModule,
-    DispatchDomainModule
-  ]);
-  const dispatch = loaded.getContract("dispatch");
-  if (!dispatch) {
-    await loaded.stop();
-    throw new Error("wiki writer dispatch unavailable");
-  }
-  return { dispatch, loaded };
-}
-async function resolveDocumenterModelId(route = {}) {
-  const loaded = await loadDomains([ConfigDomainModule, ResourcesDomainModule, ProvidersDomainModule]);
-  try {
-    const config = loaded.getContract("config");
-    const providers = loaded.getContract("providers");
-    if (!config || !providers) return UNRESOLVED_DOCUMENTER_MODEL;
-    const settings = config.get();
-    const workers = settings.fleet;
-    const bindingProfileName = workers?.agentProfiles?.[WIKI_AGENT_ID];
-    const profile = bindingProfileName ? workers?.profiles?.[bindingProfileName] : void 0;
-    const targetId = route.target ?? profile?.target ?? workers?.default?.target ?? settings.targets?.[0]?.id ?? null;
-    if (!targetId) return UNRESOLVED_DOCUMENTER_MODEL;
-    const target = providers.getTarget(targetId);
-    const requestedModel = route.model ?? profile?.model ?? workers?.default?.model ?? target?.defaultModel ?? null;
-    if (!requestedModel) return UNRESOLVED_DOCUMENTER_MODEL;
-    const status = providers.list().find((entry) => entry.target.id === targetId);
-    return status ? canonicalizeWireModelId(status, requestedModel) : requestedModel;
-  } catch {
-    return UNRESOLVED_DOCUMENTER_MODEL;
-  } finally {
-    await loaded.stop();
-  }
-}
-function modelWikiGenerate(options = {}) {
-  return async (input) => {
-    let loaded = null;
-    try {
-      if (options.dispatch) {
-        await generateWikiWithDocumenter(options.dispatch, input, options.route, options.runBudgetMs);
-        return;
-      }
-      const lazy = await loadWikiDispatch();
-      loaded = lazy.loaded;
-      await generateWikiWithDocumenter(lazy.dispatch, input, options.route, options.runBudgetMs);
-    } finally {
-      if (loaded) await loaded.stop();
-    }
-  };
-}
-export {
-  modelWikiGenerate,
-  resolveDocumenterModelId
-};
-//# sourceMappingURL=wiki-generate-C7IQOXSP.js.map