@wildorder/nightshift 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wing It Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# nightshift
+
+**The crew that builds while you're gone.**
+
+Nightshift runs walk-away, CI-dispatched, multi-workstream engineering
+programs: a human plans interactively, launches, and leaves. The run always
+terminates — in either a draft PR with a run report and a decision ledger,
+or a partial build with a diagnosis, a rollback point, and a one-command
+retry. Nothing blocks silently; nothing waits mid-run for a human who is
+not there.
+
+Trust comes from **reversibility and legibility, not prevention**: every
+decision an agent makes is journaled with its alternatives, tagged to the
+commit before it applied, and revocable by replay. You come back to a shift
+handover note — what got built, what was decided along the way and why, and
+how to flip anything you disagree with.
+
+## Install
+
+Published as
+[`@wildorder/nightshift`](https://www.npmjs.com/package/@wildorder/nightshift);
+the executable is named `nightshift`. Always spell the full scoped name when
+using `npx` outside a project that has it installed — `npx nightshift` looks
+up the unscoped name on the registry, which is not this package (and an
+unrelated `night-shift` package exists, so a typo installs someone else's
+code):
+
+```sh
+npx --yes @wildorder/nightshift --help
+```
+
+## Status
+
+Pre-alpha. The repository currently contains the founding charter
+([docs/learnings.md](docs/learnings.md) — what its predecessor,
+`@wildorder/program-pipeline`, taught us) and the harvested mechanical
+core: headless agent spawning, the dependency graph, the manifest, the
+append-only program memory that becomes the decision ledger, worktree
+capture/restore, and package-manager detection. All ported with their
+tests.
+
+## The shape of a run
+
+```text
+  /plan-program        HUMAN   design, scope, decompose (interactive)
+    nightshift run ┬ author            one clean agent per workstream, by dependency level
+                   ├ review            critic→writer rounds (2–3), fail-open into the ledger
+                   ├ build             implement, verify, commit; decisions journaled
+                   └ report            run report + decision ledger on the draft PR
+```
+
+Four agent roles, four jobs (`nightshift.config.json`):
+
+| Block | Job |
+| --- | --- |
+| `agent` | Implements workstreams. A cheaper model is usually right. |
+| `deciderAgent` | Makes, ratifies, or escalates decisions — and composes the human ping when one is warranted. Expensive model, different provider than `agent`. |
+| `reviewerAgent` | Independent second opinion: spec critique, test critique, whole-program review. Never the implementer. |
+| `recoveryAgent` | Retries failed workstreams; a distinct provider also survives primary quota/session failures. |
+
+Core rules, inherited from hard experience:
+
+- **Decide-and-continue.** Agents surface decisions as fenced blocks; the
+  runner journals them, tags the pre-decision commit, and proceeds on the
+  best default. Two-way doors are ratified post-hoc by the decider;
+  one-way doors are decided before they apply. Escalation pings the human
+  but never blocks a reversible path.
+- **Bounded loops fail open into the ledger, never closed into a gate.**
+- **No self-grading.** Reviewer and decider are different providers than
+  the implementer; the runner runs verification itself and owns commits.
+- **Failure isolation.** A failed workstream parks; everything outside its
+  downstream cone still builds. Partial + diagnosis is a valid outcome.
+- **Every artifact is written for a human first.** Specs are narrative
+  documents; machine data lives in the manifest.
+
+## Development
+
+Requires Node.js 20+.
+
+```sh
+npm ci
+npm run build
+npm run typecheck
+npm test
+npm run lint
+```
+
+## License
+
+MIT © 2026 Wing It Labs

package/dist/agent-runner.d.ts

@@ -0,0 +1,64 @@
+import type { AgentConfig, NightshiftConfig } from "./config.js";
+export interface CommandResult {
+    exitCode: number;
+    output: string;
+    /** Set when the prompt could not be fully delivered to the process stdin. */
+    inputError?: string;
+}
+export interface AgentInvocation {
+    command: string;
+    args: string[];
+    prompt: string;
+    promptMode: "stdin" | "argument";
+    cwd: string;
+    onOutput?: (chunk: string) => void;
+}
+export type AgentRunner = (invocation: AgentInvocation) => Promise<CommandResult>;
+export type VerifyRunner = (command: string, cwd: string) => Promise<CommandResult>;
+/**
+ * Environment for spawned agents: the parent may itself be an agent session
+ * (Claude Code, Cursor), and inherited session markers can make the child CLI
+ * behave as if attached to that session instead of running as a clean
+ * headless agent.
+ */
+export declare function sanitizedEnvironment(base?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function runProcess(command: string, args: string[], options: {
+    cwd: string;
+    input?: string;
+    shell: boolean;
+    onOutput?: (chunk: string) => void;
+    env?: NodeJS.ProcessEnv;
+}): Promise<CommandResult>;
+export declare const defaultAgentRunner: AgentRunner;
+export declare const defaultVerifyRunner: VerifyRunner;
+export declare function tail(output: string, limit?: number): string;
+/**
+ * The implementer: the `agent` block, or the environment fallback for hosts
+ * that have no config file yet.
+ */
+export declare function resolveAgent(config: NightshiftConfig): AgentConfig | undefined;
+export interface ResolvedRecoveryAgent {
+    agent: AgentConfig;
+    /** True when no dedicated recovery agent was configured. */
+    borrowedImplementer: boolean;
+}
+/** Recovery agent, falling back explicitly to the implementer. */
+export declare function resolveRecoveryAgent(config: NightshiftConfig): ResolvedRecoveryAgent | undefined;
+/**
+ * The decider: makes, ratifies, or escalates decisions. Deliberately never
+ * falls back to the implementer — an absent decider means implementer
+ * defaults stand unratified, which is a policy the caller must surface, not
+ * a substitution to make silently. The implementer grading its own decisions
+ * is exactly the conflict of interest this role exists to remove.
+ */
+export declare function resolveDeciderAgent(config: NightshiftConfig): AgentConfig | undefined;
+/**
+ * The reviewer: the independent second opinion for spec critique, test
+ * critique, and whole-program review. Never falls back to the implementer —
+ * a reviewer that is the same process as the author defeats the point, so an
+ * absent block is reported to the caller rather than silently substituted.
+ */
+export declare function resolveReviewerAgent(config: NightshiftConfig): AgentConfig | undefined;
+/** Human-readable form of a resolved agent, for plan and report output. */
+export declare function describeAgent(agent: AgentConfig): string;
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../src/agent-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAClF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAMpF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,GAAE,MAAM,CAAC,UAAwB,GACpC,MAAM,CAAC,UAAU,CAQnB;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GACA,OAAO,CAAC,aAAa,CAAC,CAiCxB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAqB9B,CAAC;AAEJ,eAAO,MAAM,mBAAmB,EAAE,YACa,CAAC;AAEhD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAO9E;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,4DAA4D;IAC5D,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,GACvB,qBAAqB,GAAG,SAAS,CAOnC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,GACvB,WAAW,GAAG,SAAS,CAEzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,GACvB,WAAW,GAAG,SAAS,CAOzB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAExD"}

package/dist/agent-runner.js

@@ -0,0 +1,128 @@
+import { spawn } from "node:child_process";
+// In-memory output is kept to a bounded tail; full output belongs in the
+// per-workstream log via onOutput streaming.
+const OUTPUT_TAIL_LIMIT = 200_000;
+/**
+ * Environment for spawned agents: the parent may itself be an agent session
+ * (Claude Code, Cursor), and inherited session markers can make the child CLI
+ * behave as if attached to that session instead of running as a clean
+ * headless agent.
+ */
+export function sanitizedEnvironment(base = process.env) {
+    const env = {};
+    for (const [key, value] of Object.entries(base)) {
+        if (key === "CLAUDECODE" || key.startsWith("CLAUDE_CODE_"))
+            continue;
+        if (key === "CURSOR_AGENT" || key.startsWith("CURSOR_TRACE_"))
+            continue;
+        env[key] = value;
+    }
+    return env;
+}
+export function runProcess(command, args, options) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            shell: options.shell,
+            windowsHide: true,
+            stdio: ["pipe", "pipe", "pipe"],
+            ...(options.env ? { env: options.env } : {}),
+        });
+        let buffered = "";
+        const push = (chunk) => {
+            options.onOutput?.(chunk);
+            buffered = (buffered + chunk).slice(-OUTPUT_TAIL_LIMIT);
+        };
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", push);
+        child.stderr.on("data", push);
+        child.on("error", rejectPromise);
+        let inputError;
+        child.stdin.on("error", (error) => {
+            inputError = error;
+        });
+        child.on("close", (code) => resolvePromise({
+            exitCode: code ?? 1,
+            output: buffered,
+            ...(inputError ? { inputError: inputError.message } : {}),
+        }));
+        if (options.input !== undefined)
+            child.stdin.end(options.input);
+        else
+            child.stdin.end();
+    });
+}
+export const defaultAgentRunner = (invocation) => runProcess(invocation.command, invocation.promptMode === "argument"
+    ? [...invocation.args, invocation.prompt]
+    : invocation.args, {
+    cwd: invocation.cwd,
+    // A shell re-parses the argument list, and on Windows cmd.exe mangles
+    // multiline prompt arguments — so argument mode always spawns the
+    // command directly. The shell is only used on Windows for stdin mode,
+    // where it is needed to launch .cmd shims and cannot corrupt the
+    // prompt (which travels via stdin, not argv).
+    shell: process.platform === "win32" && invocation.promptMode !== "argument",
+    env: sanitizedEnvironment(),
+    ...(invocation.onOutput ? { onOutput: invocation.onOutput } : {}),
+    ...(invocation.promptMode === "stdin"
+        ? { input: invocation.prompt }
+        : {}),
+});
+export const defaultVerifyRunner = (command, cwd) => runProcess(command, [], { cwd, shell: true });
+export function tail(output, limit = 2000) {
+    return output.length > limit ? output.slice(-limit) : output;
+}
+/**
+ * The implementer: the `agent` block, or the environment fallback for hosts
+ * that have no config file yet.
+ */
+export function resolveAgent(config) {
+    if (config.agent)
+        return config.agent;
+    const command = process.env.NIGHTSHIFT_AGENT_COMMAND;
+    if (command && command.trim().length > 0) {
+        return { command, args: [], promptMode: "stdin" };
+    }
+    return undefined;
+}
+/** Recovery agent, falling back explicitly to the implementer. */
+export function resolveRecoveryAgent(config) {
+    if (config.recoveryAgent) {
+        return { agent: config.recoveryAgent, borrowedImplementer: false };
+    }
+    const implementer = resolveAgent(config);
+    if (implementer)
+        return { agent: implementer, borrowedImplementer: true };
+    return undefined;
+}
+/**
+ * The decider: makes, ratifies, or escalates decisions. Deliberately never
+ * falls back to the implementer — an absent decider means implementer
+ * defaults stand unratified, which is a policy the caller must surface, not
+ * a substitution to make silently. The implementer grading its own decisions
+ * is exactly the conflict of interest this role exists to remove.
+ */
+export function resolveDeciderAgent(config) {
+    return config.deciderAgent;
+}
+/**
+ * The reviewer: the independent second opinion for spec critique, test
+ * critique, and whole-program review. Never falls back to the implementer —
+ * a reviewer that is the same process as the author defeats the point, so an
+ * absent block is reported to the caller rather than silently substituted.
+ */
+export function resolveReviewerAgent(config) {
+    if (config.reviewerAgent)
+        return config.reviewerAgent;
+    const command = process.env.NIGHTSHIFT_REVIEWER_COMMAND;
+    if (command && command.trim().length > 0) {
+        return { command, args: [], promptMode: "stdin" };
+    }
+    return undefined;
+}
+/** Human-readable form of a resolved agent, for plan and report output. */
+export function describeAgent(agent) {
+    return [agent.command, ...agent.args].join(" ");
+}
+//# sourceMappingURL=agent-runner.js.map

package/dist/agent-runner.js.map

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

package/dist/agent-summary.d.ts

@@ -0,0 +1,35 @@
+/** The contract text, appended verbatim to every brief the runner composes. */
+export declare function summaryContract(): string;
+export interface AgentSummary {
+    /** The agent's own words, or an output tail when it emitted no block. */
+    text: string;
+    /** False when no block was found and `text` is a fallback tail. */
+    available: boolean;
+}
+/**
+ * The last summary block in the output. Last rather than first for the same
+ * reason {@link extractJson} takes the last json block: an agent that echoes
+ * the contract back before answering would otherwise have its echo parsed as
+ * the answer.
+ */
+export declare function extractSummary(output: string): string | undefined;
+/**
+ * The summary for an agent reply, degrading to an output tail when the agent
+ * emitted no block. Never throws and never signals failure: callers record
+ * what they got and carry on.
+ */
+export declare function resolveSummary(output: string, tailLimit?: number): AgentSummary;
+/**
+ * Event payload fields, so every emitter names them the same way. `role` is
+ * the job the agent held (`build`, `critic`, `writer`, `author`, `validator`,
+ * `reviewer`), not the command it ran.
+ *
+ * `promptBytes` is deliberate telemetry: brief size is the input to every
+ * decision about how much context an agent can be given, and estimating it
+ * from spec line counts is guesswork. Recording it per invocation turns that
+ * into a measurement after one real run.
+ */
+export declare function summaryEventData(role: string, prompt: string, summary: AgentSummary): Record<string, unknown>;
+/** Single-line form for progress output; the events log keeps the full text. */
+export declare function summaryLine(summary: AgentSummary, limit?: number): string;
+//# sourceMappingURL=agent-summary.d.ts.map

package/dist/agent-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-summary.d.ts","sourceRoot":"","sources":["../src/agent-summary.ts"],"names":[],"mappings":"AAuCA,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,YAAY,CAQ5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,SAAM,GAAG,MAAM,CAKtE"}

package/dist/agent-summary.js

@@ -0,0 +1,95 @@
+import { tail } from "./agent-runner.js";
+/**
+ * Every spawned agent ends its reply with a summary block, and the runner
+ * reads it back verbatim.
+ *
+ * Before this, agent output had exactly two destinations: a machine parse
+ * (findings, verdicts) or a failure path (`tail()` inside an error message).
+ * A workstream that passed surfaced nothing about what the agent actually
+ * concluded — the only record was the raw stdout firehose in the
+ * per-workstream log, which is the entire transcript and therefore unread.
+ * And when the pipeline was driven from inside an orchestrating agent
+ * session, that orchestrator paraphrased whatever little did surface.
+ *
+ * The fix is the one the brief composer already applies in the other
+ * direction: the package owns the contract. Every brief the runner composes
+ * ends with the block below, every runner reads it back, and the text lands
+ * in the events log as the agent wrote it — not summarized, not rewritten.
+ *
+ * A missing block is never fatal. An agent that forgets the fence still did
+ * the work, and failing a verified workstream over a formatting slip would
+ * trade a real result for a cosmetic one.
+ */
+const CONTRACT = `
+## Summary (required)
+
+End your reply with this block. It is the only part of your output a human
+will read, so write it for a human:
+
+\`\`\`summary
+Two to five sentences: what you did, the decisions you made and why, and
+anything you were unsure about or had to assume. Do not restate these
+instructions.
+\`\`\`
+
+Put it last. If you also return a \`\`\`json block, both must be present.
+`.trim();
+/** The contract text, appended verbatim to every brief the runner composes. */
+export function summaryContract() {
+    return CONTRACT;
+}
+/**
+ * The last summary block in the output. Last rather than first for the same
+ * reason {@link extractJson} takes the last json block: an agent that echoes
+ * the contract back before answering would otherwise have its echo parsed as
+ * the answer.
+ */
+export function extractSummary(output) {
+    const matches = [...output.matchAll(/```summary[^\S\r\n]*\r?\n([\s\S]*?)```/gu)];
+    for (const match of matches.reverse()) {
+        const text = match[1]?.trim();
+        if (text !== undefined && text !== "")
+            return text;
+    }
+    return undefined;
+}
+/**
+ * The summary for an agent reply, degrading to an output tail when the agent
+ * emitted no block. Never throws and never signals failure: callers record
+ * what they got and carry on.
+ */
+export function resolveSummary(output, tailLimit = 600) {
+    const text = extractSummary(output);
+    if (text !== undefined)
+        return { text, available: true };
+    const fallback = tail(output, tailLimit).trim();
+    return {
+        text: fallback === "" ? "(no output)" : fallback,
+        available: false,
+    };
+}
+/**
+ * Event payload fields, so every emitter names them the same way. `role` is
+ * the job the agent held (`build`, `critic`, `writer`, `author`, `validator`,
+ * `reviewer`), not the command it ran.
+ *
+ * `promptBytes` is deliberate telemetry: brief size is the input to every
+ * decision about how much context an agent can be given, and estimating it
+ * from spec line counts is guesswork. Recording it per invocation turns that
+ * into a measurement after one real run.
+ */
+export function summaryEventData(role, prompt, summary) {
+    return {
+        role,
+        summary: summary.text,
+        summaryAvailable: summary.available,
+        promptBytes: Buffer.byteLength(prompt, "utf8"),
+    };
+}
+/** Single-line form for progress output; the events log keeps the full text. */
+export function summaryLine(summary, limit = 240) {
+    const collapsed = summary.text.replace(/\s+/gu, " ").trim();
+    const clipped = collapsed.length > limit ? `${collapsed.slice(0, limit - 1)}…` : collapsed;
+    return summary.available ? clipped : `(no summary block) ${clipped}`;
+}
+//# sourceMappingURL=agent-summary.js.map

package/dist/agent-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-summary.js","sourceRoot":"","sources":["../src/agent-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,QAAQ,GAAG;;;;;;;;;;;;;CAahB,CAAC,IAAI,EAAE,CAAC;AAET,+EAA+E;AAC/E,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC;AAClB,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,0CAA0C,CAAC,CAAC,CAAC;IACjF,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,SAAS,GAAG,GAAG;IAC5D,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,OAAO;QACL,IAAI,EAAE,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ;QAChD,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,MAAc,EACd,OAAqB;IAErB,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,gBAAgB,EAAE,OAAO,CAAC,SAAS;QACnC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,OAAqB,EAAE,KAAK,GAAG,GAAG;IAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,MAAM,OAAO,GACX,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,OAAO,EAAE,CAAC;AACvE,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+async function packageVersion() {
+    const raw = await readFile(resolve(packageRoot, "package.json"), "utf8");
+    return JSON.parse(raw).version;
+}
+const program = new Command();
+program
+    .name("nightshift")
+    .description("The crew that builds while you're gone: walk-away engineering programs " +
+    "with a decision ledger instead of gates.")
+    .version(await packageVersion());
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAE3E,KAAK,UAAU,cAAc;IAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;IACzE,OAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC,OAAO,CAAC;AAC1D,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACV,yEAAyE;IACvE,0CAA0C,CAC7C;KACA,OAAO,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;AAEnC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,74 @@
+import { z } from "zod";
+export declare const NIGHTSHIFT_CONFIG_FILE = "nightshift.config.json";
+declare const agentSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    promptMode: z.ZodDefault<z.ZodEnum<{
+        stdin: "stdin";
+        argument: "argument";
+    }>>;
+}, z.core.$strip>;
+export type AgentConfig = z.infer<typeof agentSchema>;
+/**
+ * Four roles, four jobs:
+ *
+ * - `agent` implements workstreams. A cheaper model is usually the right call.
+ * - `deciderAgent` makes, ratifies, or escalates decisions. Decisions are the
+ *   highest-leverage, lowest-token work in a run — put the expensive model
+ *   here, and by convention a different provider than `agent`.
+ * - `reviewerAgent` is the independent second opinion: spec critique, test
+ *   critique, whole-program review. Never falls back to `agent` — a reviewer
+ *   that is the same process as the author defeats the point.
+ * - `recoveryAgent` retries failed workstreams. A distinct provider also lets
+ *   the runner recover from a primary token, quota, or session failure.
+ */
+declare const configSchema: z.ZodObject<{
+    agent: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        promptMode: z.ZodDefault<z.ZodEnum<{
+            stdin: "stdin";
+            argument: "argument";
+        }>>;
+    }, z.core.$strip>>;
+    deciderAgent: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        promptMode: z.ZodDefault<z.ZodEnum<{
+            stdin: "stdin";
+            argument: "argument";
+        }>>;
+    }, z.core.$strip>>;
+    reviewerAgent: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        promptMode: z.ZodDefault<z.ZodEnum<{
+            stdin: "stdin";
+            argument: "argument";
+        }>>;
+    }, z.core.$strip>>;
+    recoveryAgent: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        promptMode: z.ZodDefault<z.ZodEnum<{
+            stdin: "stdin";
+            argument: "argument";
+        }>>;
+    }, z.core.$strip>>;
+    verify: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type NightshiftConfig = z.infer<typeof configSchema>;
+export declare const DEFAULT_CONFIG: NightshiftConfig;
+export interface LoadedConfig {
+    config: NightshiftConfig;
+    /** Absolute path of the file that was read, when one existed. */
+    path?: string;
+}
+/**
+ * Read `nightshift.config.json` from the project root. A missing file is the
+ * defaults; a malformed file is an error — silently substituting defaults for
+ * a config the user wrote would run the wrong agents.
+ */
+export declare function loadConfig(cwd: string): Promise<LoadedConfig>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,QAAA,MAAM,WAAW;;;;;;;iBAIf,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOhB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE5D,eAAO,MAAM,cAAc,EAAE,gBAAyC,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyBnE"}

package/dist/config.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+export const NIGHTSHIFT_CONFIG_FILE = "nightshift.config.json";
+const agentSchema = z.object({
+    command: z.string().min(1),
+    args: z.array(z.string()).default([]),
+    promptMode: z.enum(["stdin", "argument"]).default("stdin"),
+});
+/**
+ * Four roles, four jobs:
+ *
+ * - `agent` implements workstreams. A cheaper model is usually the right call.
+ * - `deciderAgent` makes, ratifies, or escalates decisions. Decisions are the
+ *   highest-leverage, lowest-token work in a run — put the expensive model
+ *   here, and by convention a different provider than `agent`.
+ * - `reviewerAgent` is the independent second opinion: spec critique, test
+ *   critique, whole-program review. Never falls back to `agent` — a reviewer
+ *   that is the same process as the author defeats the point.
+ * - `recoveryAgent` retries failed workstreams. A distinct provider also lets
+ *   the runner recover from a primary token, quota, or session failure.
+ */
+const configSchema = z.object({
+    agent: agentSchema.optional(),
+    deciderAgent: agentSchema.optional(),
+    reviewerAgent: agentSchema.optional(),
+    recoveryAgent: agentSchema.optional(),
+    /** Named verification commands run by the runner itself, never by agents. */
+    verify: z.record(z.string(), z.string()).default({}),
+});
+export const DEFAULT_CONFIG = configSchema.parse({});
+/**
+ * Read `nightshift.config.json` from the project root. A missing file is the
+ * defaults; a malformed file is an error — silently substituting defaults for
+ * a config the user wrote would run the wrong agents.
+ */
+export async function loadConfig(cwd) {
+    const path = join(cwd, NIGHTSHIFT_CONFIG_FILE);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return { config: DEFAULT_CONFIG };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`${NIGHTSHIFT_CONFIG_FILE} is not valid JSON: ${error.message}`, { cause: error });
+    }
+    const result = configSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`)
+            .join("; ");
+        throw new Error(`${NIGHTSHIFT_CONFIG_FILE} is invalid: ${issues}`);
+    }
+    return { config: result.data, path };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;CAC3D,CAAC,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,WAAW,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,WAAW,CAAC,QAAQ,EAAE;IACrC,6EAA6E;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACrD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAqB,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAQvE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAC/C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,GAAG,sBAAsB,uBAAwB,KAAe,CAAC,OAAO,EAAE,EAC1E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACvE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,GAAG,sBAAsB,gBAAgB,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/detect-package-manager.d.ts

@@ -0,0 +1,15 @@
+export declare const PACKAGE_MANAGERS: readonly ["npm", "pnpm", "yarn", "bun"];
+export type PackageManager = (typeof PACKAGE_MANAGERS)[number];
+export declare function parsePackageManager(value: string): PackageManager;
+/**
+ * Detect the project's package manager, walking up from `cwd` because in
+ * workspaces the lockfile and `packageManager` field live at the repo root,
+ * not necessarily in the package directory. Falls back to npm.
+ */
+export declare function detectPackageManager(cwd: string): PackageManager;
+/** pnpm workspaces are always declared by a pnpm-workspace.yaml at the root. */
+export declare function isPnpmWorkspaceRoot(directory: string): boolean;
+export declare function addDevDependencyCommand(manager: PackageManager, packageName: string, options?: {
+    pnpmWorkspaceRoot?: boolean;
+}): string;
+//# sourceMappingURL=detect-package-manager.d.ts.map