infinity-harness 2.8.9 → 2.8.11

package/dist/src/intake.js

@@ -0,0 +1,203 @@
+/**
+ * infinity-harness — the start-up wizard.
+ *
+ * The bug this module exists to kill: choosing "autopilot" used to start the
+ * run *immediately*, with no idea and no scope, so the first thing the harness
+ * did was invent a project and start building it. Autopilot was being read as
+ * "you decide everything, including what I want", which is not a mode anybody
+ * asked for.
+ *
+ * The fix was to separate two questions that were tangled together:
+ *
+ *   1. What are we building?      — always asked
+ *   2. Who signs off on what?     — the workflow
+ *
+ * And the second of those turned out to be tangled too. "copilot" and
+ * "autopilot" are one switch, and one switch cannot say "let it define and
+ * plan on its own but show me the review". So the answer is a **workflow**: a
+ * mode per phase, with the two familiar words as two named points in that
+ * space rather than the only two points in it. `src/workflow.ts` owns what a
+ * workflow is and where saved ones live.
+ *
+ * Nothing here talks to pi. It takes answers and returns a plan of record, so
+ * the flow can be unit-tested without a terminal and driven from the adapter,
+ * from a test, or from a config file.
+ */
+import { DEFAULT_ENABLED_PHASES, PHASE_ORDER } from "./core/types.js";
+import { BUILTIN_WORKFLOWS, describeModes, normalizeModes, normalizePhases, signedPhases as signedIn, } from "./workflow.js";
+import { defaultDisplay, normalizeDisplay } from "./ui/display.js";
+/** The wizard's questions, in the order they are asked. */
+export const INTAKE_STEPS = ["workflow", "brief", "handoff", "display"];
+export function builtInByName(name) {
+    return BUILTIN_WORKFLOWS.find((w) => w.id === name || w.name === name) ?? null;
+}
+/** Build an ad-hoc workflow from a phase list and a mode per phase. */
+export function customWorkflow(phases, modes, name = "custom") {
+    const ordered = normalizePhases(phases);
+    const normalized = normalizeModes(modes, ordered);
+    return {
+        id: "custom",
+        name,
+        description: describeModes(ordered, normalized),
+        builtIn: false,
+        phases: ordered,
+        modes: normalized,
+    };
+}
+/** Turn the wizard's answers into everything `initHarness` needs. */
+export function planIntake(answers) {
+    const workflow = answers.workflow;
+    const phases = normalizePhases(workflow.phases);
+    const phaseModes = normalizeModes(workflow.modes, phases);
+    const handoff = answers.handoff ?? "task";
+    const session = {
+        handoff,
+        contextThreshold: handoff === "off" ? 0 : 0.6,
+        carryNotes: true,
+    };
+    const parallelAt = answers.parallelAt ?? "task";
+    const engine = answers.engine ?? "background";
+    const maxWorkers = Math.max(1, Math.min(16, Number.isFinite(answers.maxWorkers) ? Math.floor(answers.maxWorkers) : 3));
+    const display = normalizeDisplay(answers.display ?? defaultDisplay());
+    const brief = answers.brief?.trim() ? answers.brief.trim() : null;
+    const signed = PHASE_ORDER.filter((p) => phaseModes[p] === "copilot");
+    const mode = signed.length > 0 ? "copilot" : "autopilot";
+    const warnings = [];
+    if (!brief) {
+        warnings.push("No goal was given, so the first thing the run does is ask you for one. " +
+            "It will not guess a project.");
+    }
+    if (signed.length === 0) {
+        warnings.push("Nothing is being approved by you. The model decides what to build and how, " +
+            "and you see it when it is done. This is the right setting for a run you " +
+            "want to walk away from — and the wrong one if the goal is vague.");
+    }
+    if (signed.length === phases.length) {
+        warnings.push("Every phase stops for you. Nothing moves while you are away, which is the " +
+            "point — just do not expect to start this and go to bed.");
+    }
+    if (handoff === "off") {
+        warnings.push("Session handoff is off, so the whole run shares one context window. " +
+            "Expect compaction on anything longer than a few tasks.");
+    }
+    const _researchDepth = (phases.includes("research") ? (answers.researchDepth ?? "deep") : undefined);
+    return {
+        mode,
+        workflow: { id: workflow.id, name: workflow.name },
+        researchDepth: _researchDepth,
+        brief,
+        phases,
+        phaseModes,
+        approvals: {
+            research: phaseModes.research === "copilot",
+            define: phaseModes.define === "copilot",
+            plan: phaseModes.plan === "copilot",
+        },
+        session,
+        execution: { engine, parallelAt, maxWorkers, isolation: "worktree" },
+        display,
+        router: answers.router,
+        summary: summarize(workflow, phases, phaseModes, session, display, brief, _researchDepth),
+        warnings,
+    };
+}
+function summarize(workflow, phases, modes, session, display, brief, researchDepth) {
+    const signed = phases.filter((p) => modes[p] === "copilot");
+    const L = [];
+    L.push(`Workflow  ${workflow.name}`);
+    L.push(`Pipeline  ${phases.map((p) => (modes[p] === "copilot" ? `[${p}]` : p)).join(" → ")}`);
+    L.push(`You sign  ${signed.length ? signed.map((s) => s.toUpperCase()).join(", ") : "nothing — the model decides and runs"}`);
+    L.push(`Sessions  ${session.handoff === "off"
+        ? "one session for the whole run"
+        : session.handoff === "task"
+            ? "fresh session per task and per phase"
+            : "fresh session per phase"}`);
+    L.push(`Display   ${display.preset}`);
+    if (researchDepth)
+        L.push(`Research  ${researchDepth}`);
+    L.push(`Goal      ${brief ?? "(none yet — you will be asked first thing)"}`);
+    return L.join("\n");
+}
+export const WORKFLOW_QUESTION = {
+    id: "workflow",
+    title: "How should this run — which phases, and which of them stop for you?",
+};
+export const BRIEF_QUESTION = {
+    id: "brief",
+    title: "What are you building? One or two sentences is enough.",
+    placeholder: "e.g. a CLI that reconciles Stripe payouts against our ledger",
+};
+export const HANDOFF_QUESTION = {
+    id: "handoff",
+    title: "When should the run start a fresh session?",
+    options: [
+        {
+            value: "goal",
+            label: "per goal — one session for the whole run",
+            help: "The old single-session run. Model per run (off/goal) — whole run shares its hardest model. For true per-task models use task/subtask.",
+        },
+        {
+            value: "phase",
+            label: "every phase",
+            help: "Model per phase — tasks & subtasks in a phase share the hardest model in that phase. Old default. Each phase starts clean from the brief.",
+        },
+        {
+            value: "sprint",
+            label: "every sprint",
+            help: "Model per sprint — tasks & subtasks in a sprint share the hardest model in that sprint. New session whenever the sprint changes (or phase).",
+        },
+        {
+            value: "feature",
+            label: "every feature",
+            help: "Model per feature — tasks & subtasks in a feature share the hardest model in that feature. New session on each feature boundary (and sprint/phase).",
+        },
+        {
+            value: "task",
+            label: "every task (recommended)",
+            help: "Model per task — subtasks share their parent task's model. Each task gets a clean session. Best isolation; one extra brief per task.",
+        },
+        {
+            value: "subtask",
+            label: "every subtask",
+            help: "Model per subtask — each subtask may use its own model (needs subtask difficulty). Finest grain. Most isolation, most churn.",
+        },
+        {
+            value: "off",
+            label: "never — alias for per goal",
+            help: "Model per run — same as per goal, one long session.",
+        },
+    ],
+};
+export const DISPLAY_QUESTION = {
+    id: "display",
+    title: "How much of the plan do you want on screen?",
+};
+/** The two modes, as a question about one phase. */
+export const PHASE_MODE_OPTIONS = [
+    {
+        value: "autopilot",
+        label: "autopilot — it passes the gate and moves on",
+        help: "The deterministic gate is the only referee for this phase.",
+    },
+    {
+        value: "copilot",
+        label: "copilot — it stops and waits for you",
+        help: "When the gate passes, the run parks and asks you to sign it off before advancing.",
+    },
+];
+/** What each phase is for, one line, shown while picking modes. */
+export const PHASE_PURPOSE = {
+    init: "set the project up",
+    research: "find out what it actually has to be",
+    define: "write down what is being built, and the criteria",
+    plan: "break it into ordered, dependency-aware tasks",
+    build: "implement it, one task at a time",
+    verify: "prove it behaves; hunt what the tests miss",
+    simplify: "delete more than you add",
+    review: "judge it as if someone else wrote it",
+    ship: "tag, changelog, leave the tree clean",
+};
+/** Phases someone can put in a pipeline. INIT is not one of them. */
+export const SELECTABLE_PHASES = PHASE_ORDER.filter((p) => p !== "init");
+export { DEFAULT_ENABLED_PHASES, signedIn as signedPhases };
+//# sourceMappingURL=intake.js.map

package/dist/src/intake.js.map

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