@wildorder/nightshift 0.3.0 → 0.4.0

package/dist/author.js

@@ -0,0 +1,476 @@
+import { readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { defaultAgentRunner, describeAgent, invokeAgent, resolveAuthorAgent, resolveDeciderAgent, } from "./agent-runner.js";
+import { resolveSummary, summaryContract } from "./agent-summary.js";
+import { decisionContract, decisionFingerprint, extractDecisions, } from "./decision.js";
+import { appendLedgerEvents } from "./decision-ledger.js";
+import { reviewDecisions } from "./decider-review.js";
+import { findCycles, topologicalLevels } from "./graph.js";
+import { loadManifest, saveManifest, } from "./manifest.js";
+import { defaultGitOps, downstreamCone } from "./run-program.js";
+/**
+ * The authoring stage: for every workstream whose spec does not exist, a
+ * clean agent writes it — human-first, grounded in the repository,
+ * accounting for the manifest's success criteria — before the build stage
+ * runs. Decisions authors surface flow through the same ledger and decider
+ * review as build decisions, and dependencies an author discovers merge into
+ * the manifest rather than stopping the run. Only an unorderable graph (a
+ * merge that creates a cycle) terminates it.
+ */
+/** Total character budget for dependency specs included in one brief. */
+const DEPENDENCY_SPEC_BUDGET = 100_000;
+/** A finished spec's content, or undefined when missing or whitespace-only. */
+async function readFinishedSpec(root, workstream) {
+    try {
+        const content = await readFile(join(root, workstream.taskFile), "utf8");
+        return content.trim() === "" ? undefined : content;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function programDocumentSection(root, manifest) {
+    const relPath = join("docs", "programs", `${manifest.program.id}-program.md`);
+    let content;
+    try {
+        content = await readFile(join(root, relPath), "utf8");
+    }
+    catch {
+        return [
+            "## Program document",
+            "",
+            `No program document exists at ${relPath.replaceAll("\\", "/")}.`,
+            "",
+        ];
+    }
+    return ["## Program document", "", content.trim(), ""];
+}
+function successCriteriaSection(manifest) {
+    if (manifest.successCriteria.length === 0) {
+        return ["## Success criteria", "", "None recorded in the manifest.", ""];
+    }
+    const lines = [
+        "## Success criteria",
+        "",
+        "Account in the spec for every criterion relevant to this workstream's",
+        "scope, referring to each by its id below. This list is canonical in the",
+        "manifest — refer to ids in the spec, never restate the text as a second",
+        "copy.",
+        "",
+    ];
+    for (const criterion of manifest.successCriteria) {
+        lines.push(`- **${criterion.id}**: ${criterion.description}`);
+    }
+    lines.push("");
+    return lines;
+}
+function scopeSection(workstream) {
+    const scope = workstream.scope;
+    if (!scope)
+        return ["## Scope", "", "No scope recorded in the manifest.", ""];
+    const lines = ["## Scope", "", scope.summary, ""];
+    if (scope.includes.length > 0) {
+        lines.push("Includes:", "", ...scope.includes.map((entry) => `- ${entry}`), "");
+    }
+    if (scope.excludes.length > 0) {
+        lines.push("Excludes:", "", ...scope.excludes.map((entry) => `- ${entry}`), "");
+    }
+    return lines;
+}
+function rosterSection(manifest) {
+    return [
+        "## Roster",
+        "",
+        "Every workstream in the program, so you know what exists and never",
+        "write a spec that quietly absorbs a neighbor's job — it says what",
+        "exists, not how it works:",
+        "",
+        ...manifest.workstreams.map((entry) => `- ${entry.id} ${entry.name}: ${entry.scope?.summary ?? entry.name}`),
+        "",
+    ];
+}
+async function dependencySpecsSection(root, workstream, rosterById) {
+    if (workstream.dependencies.length === 0) {
+        return {
+            section: ["## Dependency specs", "", "No dependencies declared.", ""],
+            demoted: [],
+        };
+    }
+    const entries = await Promise.all(workstream.dependencies
+        .map((id) => rosterById.get(id))
+        .filter((entry) => entry !== undefined)
+        .map(async (entry) => ({
+        entry,
+        content: await readFinishedSpec(root, entry),
+    })));
+    let total = entries.reduce((sum, e) => sum + (e.content?.length ?? 0), 0);
+    const demoted = new Set();
+    const bySizeDesc = entries
+        .filter((e) => e.content !== undefined)
+        .sort((a, b) => (b.content?.length ?? 0) - (a.content?.length ?? 0));
+    for (const e of bySizeDesc) {
+        if (total <= DEPENDENCY_SPEC_BUDGET)
+            break;
+        demoted.add(e.entry.id);
+        total -= e.content?.length ?? 0;
+    }
+    const lines = ["## Dependency specs", ""];
+    for (const { entry, content } of entries) {
+        const scopeSummary = entry.scope?.summary ?? entry.name;
+        if (content === undefined) {
+            lines.push(`- ${entry.id} ${entry.name}: ${scopeSummary} — no finished spec yet.`);
+            continue;
+        }
+        if (demoted.has(entry.id)) {
+            lines.push(`- ${entry.id} ${entry.name}: ${scopeSummary} — its spec was too large ` +
+                "to include in full; ask for what you need in your dependencies " +
+                "declaration rather than guessing.");
+            continue;
+        }
+        lines.push(`### ${entry.id} ${entry.name}`, "", content.trim(), "");
+    }
+    lines.push("");
+    return { section: lines, demoted: [...demoted] };
+}
+const SPEC_CONTRACT = [
+    "## Write a spec for a human",
+    "",
+    "Write a narrative document for a human reader first — what this",
+    "workstream is, why it exists, how it fits the program, and the tricky",
+    "parts spelled out plainly. A suggested skeleton, offered as a",
+    "convenience and not a contract — use these headings, different ones, or",
+    "none at all, whatever serves the reader best:",
+    "",
+    "- Objective and context",
+    "- Design",
+    "- Files to create or modify",
+    "- Testing",
+    "- Definition of done",
+    "",
+].join("\n");
+const GROUNDING_CONTRACT = [
+    "## Ground the spec in the repository",
+    "",
+    "Explore the actual codebase before writing — entry points, signatures,",
+    "existing patterns — so the spec checks the plan's assumptions instead of",
+    "inheriting them unexamined.",
+    "",
+].join("\n");
+const DEPENDENCIES_CONTRACT = `
+## Dependencies you discover (when you find one)
+
+While grounding this spec in the repository you may find that this
+workstream actually consumes another workstream's output, beyond what the
+roster above already declares as a dependency. Report every such id in one
+fenced block, anywhere in your reply before the summary:
+
+\`\`\`dependencies
+["WS-02", "WS-05"]
+\`\`\`
+
+A JSON array of workstream ids this spec depends on. Use only ids that
+already appear in the roster — never invent a new workstream. Omit the
+block entirely when you have nothing to add.
+`.trim();
+function dependenciesContract() {
+    return DEPENDENCIES_CONTRACT;
+}
+async function authorBrief(root, manifest, workstream, rosterById, reauthorNote) {
+    const programDoc = await programDocumentSection(root, manifest);
+    const deps = await dependencySpecsSection(root, workstream, rosterById);
+    const brief = [
+        `# Workstream ${workstream.id}: ${workstream.name}`,
+        "",
+        `Program: ${manifest.program.id} — ${manifest.program.name}`,
+        "",
+        "Write this workstream's specification document — the narrative file a",
+        "human and a later implementing agent will both read to build it.",
+        "",
+        ...programDoc,
+        ...successCriteriaSection(manifest),
+        ...scopeSection(workstream),
+        ...rosterSection(manifest),
+        ...deps.section,
+        ...(reauthorNote ? [reauthorNote, ""] : []),
+        SPEC_CONTRACT,
+        GROUNDING_CONTRACT,
+        dependenciesContract(),
+        "",
+        "## Rules",
+        "",
+        "- Write exactly one file: this workstream's taskFile (create parent",
+        "  directories as needed). Do not write or edit any other file.",
+        "- Never commit; the runner owns commits.",
+        "",
+        decisionContract(),
+        "",
+        summaryContract(),
+    ].join("\n");
+    return { brief, demoted: deps.demoted };
+}
+function mergeDependencies(workstream, rosterIds, declaredIds) {
+    const merged = [];
+    const unknown = [];
+    for (const id of declaredIds) {
+        if (!rosterIds.has(id)) {
+            unknown.push(id);
+            continue;
+        }
+        if (workstream.dependencies.includes(id))
+            continue;
+        workstream.dependencies.push(id);
+        merged.push(id);
+    }
+    return { merged, unknown };
+}
+const DEPENDENCIES_BLOCK_PATTERN = /```dependencies[^\S\r\n]*\r?\n([\s\S]*?)```/gu;
+/** The last ```dependencies block in an agent's reply; tolerates garbage. */
+function extractDependenciesDeclaration(output) {
+    const matches = [...output.matchAll(DEPENDENCIES_BLOCK_PATTERN)];
+    if (matches.length === 0)
+        return { ids: [] };
+    const body = matches[matches.length - 1]?.[1]?.trim() ?? "";
+    if (body === "")
+        return { ids: [] };
+    let json;
+    try {
+        json = JSON.parse(body);
+    }
+    catch (error) {
+        return {
+            ids: [],
+            error: `dependencies block is not valid JSON: ${error.message}`,
+        };
+    }
+    if (!Array.isArray(json) || !json.every((item) => typeof item === "string")) {
+        return {
+            ids: [],
+            error: "dependencies block must be a JSON array of workstream id strings",
+        };
+    }
+    return { ids: json };
+}
+/**
+ * The authoring stage: writes every missing workstream spec, one clean agent
+ * at a time, in dependency-level order. Shaped like `runProgram` — plain
+ * inputs, injected boundaries, a structured result the CLI and `run` both
+ * consume.
+ */
+export async function authorProgram(options) {
+    const root = resolve(options.cwd);
+    const config = options.config;
+    const agentRunner = options.agentRunner ?? defaultAgentRunner;
+    const git = options.git ?? defaultGitOps;
+    const log = options.log ?? ((line) => console.log(line));
+    const now = options.now ?? (() => new Date());
+    const only = options.only;
+    const force = options.force === true;
+    const manifest = await loadManifest(root, options.programId);
+    const resolvedAuthor = resolveAuthorAgent(config);
+    if (!resolvedAuthor) {
+        throw new Error("No author agent configured, and no implementer to fall back to. Set " +
+            "the `authorAgent` or `agent` block in nightshift.config.json.");
+    }
+    const author = resolvedAuthor.agent;
+    const borrowedImplementer = resolvedAuthor.borrowedImplementer;
+    log(borrowedImplementer
+        ? `author: ${describeAgent(author)} (borrowed from the implementer — ` +
+            "configure `authorAgent` for a dedicated model)"
+        : `author: ${describeAgent(author)}`);
+    const decider = resolveDeciderAgent(config);
+    const cycles = findCycles(manifest.workstreams);
+    if (cycles.length > 0) {
+        throw new Error(`Dependency cycle(s) in the manifest: ${cycles
+            .map((cycle) => cycle.join(" -> "))
+            .join("; ")}. Re-plan with /plan-program.`);
+    }
+    const isRepository = await git.isRepository(root);
+    if (!isRepository) {
+        log("warning: not a git repository — commits and decision anchors are unavailable");
+    }
+    else {
+        // Authoring commits with `git add -A`, same sweep risk as the build
+        // stage — refuse a dirty start except when resuming a run whose own
+        // leftover work (a prior parked or failed attempt) is exactly what a
+        // resume needs.
+        const dirty = (await git.dirtyPaths(root)).filter((path) => !path.replaceAll("\\", "/").startsWith("docs/programs/"));
+        const resuming = manifest.workstreams.some((workstream) => workstream.status === "failed" ||
+            workstream.status === "in_progress" ||
+            workstream.status === "parked");
+        if (dirty.length > 0 && !resuming) {
+            throw new Error(`The working tree has uncommitted changes authoring would sweep into its commits:\n` +
+                dirty.map((path) => `  ${path}`).join("\n") +
+                `\nCommit or stash them, then re-run.`);
+        }
+    }
+    const results = [];
+    const processed = new Set();
+    const blockedCone = new Set();
+    while (processed.size < manifest.workstreams.length) {
+        const remaining = manifest.workstreams.filter((w) => !processed.has(w.id));
+        const levels = topologicalLevels(remaining);
+        const next = levels[0]?.[0];
+        if (!next)
+            break;
+        processed.add(next.id);
+        results.push(await handle(next));
+    }
+    const complete = results.every((result) => result.outcome.status === "authored" || result.outcome.status === "kept");
+    return {
+        programId: options.programId,
+        complete,
+        results,
+        borrowedImplementer,
+    };
+    async function handle(workstream) {
+        const base = {
+            id: workstream.id,
+            name: workstream.name,
+            outcome: { status: "kept" },
+            decisionIds: [],
+            decisionErrors: [],
+            mergedDependencies: [],
+            unknownDependencyIds: [],
+            demotedDependencies: [],
+            reauthored: false,
+        };
+        if (blockedCone.has(workstream.id)) {
+            workstream.status = "parked";
+            await saveManifest(root, options.programId, manifest);
+            base.outcome = {
+                status: "parked",
+                reason: "an upstream dependency's authoring failed; parked, not attempted",
+            };
+            return base;
+        }
+        const existing = await readFinishedSpec(root, workstream);
+        const shouldAuthor = existing === undefined || (force && only !== undefined && only.includes(workstream.id));
+        if (!shouldAuthor)
+            return base;
+        log(`${workstream.id} ${workstream.name}: authoring`);
+        const rosterById = new Map(manifest.workstreams.map((w) => [w.id, w]));
+        const rosterIds = new Set(rosterById.keys());
+        const baseCommit = isRepository ? await git.currentCommit(root) : undefined;
+        const allDecisions = [];
+        const first = await authorBrief(root, manifest, workstream, rosterById);
+        base.demotedDependencies = first.demoted;
+        let invocation = await invokeAgent(agentRunner, author, first.brief, root);
+        base.summary = resolveSummary(invocation.output).text;
+        let parsed = extractDecisions(invocation.output);
+        base.decisionErrors.push(...parsed.errors);
+        allDecisions.push(...parsed.decisions);
+        await journalDecisions(workstream, parsed.decisions, baseCommit);
+        base.decisionIds.push(...parsed.decisions.map((decision) => decisionFingerprint(workstream.id, decision)));
+        const declaration = extractDependenciesDeclaration(invocation.output);
+        if (declaration.error)
+            log(`${workstream.id}: ${declaration.error}`);
+        const merge = mergeDependencies(workstream, rosterIds, declaration.ids);
+        base.unknownDependencyIds = merge.unknown;
+        if (merge.unknown.length > 0) {
+            log(`${workstream.id}: unknown dependency id(s) declared, ignored: ${merge.unknown.join(", ")}`);
+        }
+        if (merge.merged.length > 0) {
+            const originalDependencies = workstream.dependencies.filter((id) => !merge.merged.includes(id));
+            base.mergedDependencies = merge.merged;
+            await saveManifest(root, options.programId, manifest);
+            log(`${workstream.id}: merged new dependency edge(s): ${merge.merged.join(", ")}`);
+            const cyclesNow = findCycles(manifest.workstreams);
+            if (cyclesNow.length > 0) {
+                workstream.dependencies = originalDependencies;
+                await saveManifest(root, options.programId, manifest);
+                throw new Error(`Dependency cycle(s) created by a discovered edge from ${workstream.id}: ` +
+                    `${cyclesNow.map((cycle) => cycle.join(" -> ")).join("; ")}. Re-plan with /plan-program.`);
+            }
+            const needsReauthor = [];
+            for (const id of merge.merged) {
+                const dep = rosterById.get(id);
+                if (!dep)
+                    continue;
+                if ((await readFinishedSpec(root, dep)) !== undefined)
+                    needsReauthor.push(id);
+            }
+            if (needsReauthor.length > 0) {
+                base.reauthored = true;
+                log(`${workstream.id}: re-authoring once with newly discovered dependency spec(s): ` +
+                    needsReauthor.join(", "));
+                const note = [
+                    "## You are being re-authored",
+                    "",
+                    "Your previous pass declared a new dependency whose finished spec is",
+                    "now included below, in the dependency specs section. Revise your",
+                    "spec to account for it. Any further dependency declaration in this",
+                    "pass will be logged but not acted on — this workstream gets one",
+                    "re-author pass.",
+                    "",
+                ].join("\n");
+                const second = await authorBrief(root, manifest, workstream, rosterById, note);
+                base.demotedDependencies = second.demoted;
+                invocation = await invokeAgent(agentRunner, author, second.brief, root);
+                base.summary = resolveSummary(invocation.output).text;
+                parsed = extractDecisions(invocation.output);
+                base.decisionErrors.push(...parsed.errors);
+                allDecisions.push(...parsed.decisions);
+                await journalDecisions(workstream, parsed.decisions, baseCommit);
+                base.decisionIds.push(...parsed.decisions.map((decision) => decisionFingerprint(workstream.id, decision)));
+                const secondDeclaration = extractDependenciesDeclaration(invocation.output);
+                if (secondDeclaration.ids.length > 0) {
+                    log(`${workstream.id}: additional dependency declaration after the ` +
+                        `re-author pass was not honored: ${secondDeclaration.ids.join(", ")}`);
+                }
+            }
+        }
+        const final = await readFinishedSpec(root, workstream);
+        if (final === undefined) {
+            workstream.status = "parked";
+            await saveManifest(root, options.programId, manifest);
+            for (const id of downstreamCone(manifest.workstreams, [workstream.id])) {
+                blockedCone.add(id);
+            }
+            base.outcome = {
+                status: "failed",
+                reason: `no spec was written to ${workstream.taskFile} (or it was left empty)`,
+            };
+            await reviewWorkstreamDecisions(workstream.id, allDecisions, baseCommit);
+            return base;
+        }
+        let commit;
+        if (isRepository) {
+            commit = await git.commitAll(root, `nightshift(${options.programId}): author ${workstream.id} ${workstream.name}`);
+        }
+        await reviewWorkstreamDecisions(workstream.id, allDecisions, baseCommit);
+        base.outcome = { status: "authored", ...(commit === undefined ? {} : { commit }) };
+        return base;
+    }
+    async function journalDecisions(workstream, decisions, baseCommit) {
+        const events = decisions.map((decision) => ({
+            kind: "decision-recorded",
+            at: now().toISOString(),
+            id: decisionFingerprint(workstream.id, decision),
+            workstream: workstream.id,
+            decision,
+            ...(baseCommit === undefined ? {} : { baseCommit }),
+            decidedBy: "implementer",
+        }));
+        await appendLedgerEvents(root, options.programId, events);
+        for (const decision of decisions) {
+            log(`${workstream.id} decision: ${decision.title} -> ${decision.chosen}`);
+        }
+    }
+    function reviewWorkstreamDecisions(workstreamId, decisions, baseCommit) {
+        return reviewDecisions({
+            root,
+            programId: options.programId,
+            manifest,
+            workstreamId,
+            decisions,
+            baseCommit,
+            decider,
+            agentRunner,
+            git,
+            isRepository,
+            now,
+            log,
+        });
+    }
+}
+//# sourceMappingURL=author.js.map

package/dist/author.js.map

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

package/dist/cli.js

@@ -9,7 +9,9 @@ import { ALL_TARGETS, DEFAULT_TARGETS, detectTargets, doctor, installSkills, ove
 import { installArgv, planSkillInstall } from "./install-wizard.js";
 import { packageVersion } from "./package-assets.js";
 import { createProjectManifest } from "./project-manifest.js";
+import { authorProgram } from "./author.js";
 import { loadConfig } from "./config.js";
+import { decide } from "./decide.js";
 import { runProgram } from "./run-program.js";
 const SCOPES = ["user", "project", "both"];
 function parseScope(value) {
@@ -232,6 +234,102 @@ program
     if (!result.complete)
         process.exitCode = 1;
 });
+function renderAuthorResult(result) {
+    console.log(`${result.id} ${result.name}: ${result.outcome.status}`);
+    if (result.outcome.status === "failed" || result.outcome.status === "parked") {
+        console.log(`  ${result.outcome.reason}`);
+    }
+    if (result.mergedDependencies.length > 0) {
+        console.log(`  merged dependencies: ${result.mergedDependencies.join(", ")}`);
+    }
+    if (result.unknownDependencyIds.length > 0) {
+        console.log(`  unknown dependency id(s) ignored: ${result.unknownDependencyIds.join(", ")}`);
+    }
+    if (result.demotedDependencies.length > 0) {
+        console.log(`  dependency spec(s) too large, demoted: ${result.demotedDependencies.join(", ")}`);
+    }
+    if (result.reauthored) {
+        console.log("  re-authored once after discovering a new dependency");
+    }
+}
+program
+    .command("author")
+    .description("Write every missing workstream spec with a clean agent, in dependency-level order")
+    .argument("<program-id>", "Program ID from /plan-program")
+    .option("--only <ids>", "Comma-separated workstream ids eligible for --force re-authoring")
+    .option("--force", "Re-author specs named in --only even though they already exist", false)
+    .option("--cwd <path>", "Project directory", process.cwd())
+    .action(async (programId, options) => {
+    const { config } = await loadConfig(resolve(options.cwd));
+    const only = options.only
+        ?.split(",")
+        .map((id) => id.trim())
+        .filter((id) => id !== "");
+    const result = await authorProgram({
+        cwd: options.cwd,
+        programId,
+        config,
+        ...(only === undefined ? {} : { only }),
+        force: options.force,
+    });
+    if (result.borrowedImplementer) {
+        console.log("note: no authorAgent configured; the implementer agent authored specs instead");
+    }
+    for (const entry of result.results)
+        renderAuthorResult(entry);
+    const authored = result.results.filter((entry) => entry.outcome.status === "authored").length;
+    const kept = result.results.filter((entry) => entry.outcome.status === "kept").length;
+    const failed = result.results.filter((entry) => entry.outcome.status === "failed" || entry.outcome.status === "parked").length;
+    console.log(`\n${authored} authored, ${kept} kept, ${failed} failed/parked.`);
+    if (!result.complete)
+        process.exitCode = 1;
+});
+function renderDecideResult(result) {
+    switch (result.kind) {
+        case "confirmed":
+            console.log("no replay needed; the human ruling matches what was built");
+            break;
+        case "replay-unavailable":
+            console.log(`replay unavailable: ${result.reason}`);
+            break;
+        case "replay-preview":
+            console.log(`the choice differs from what was built.`);
+            console.log(`anchor commit: ${result.anchor}`);
+            console.log(`replay would reset ${result.resetWorkstreams.length} workstream(s): ` +
+                `${result.resetWorkstreams.join(", ") || "(none)"}`);
+            console.log("re-run with --replay to roll back and rebuild them");
+            break;
+        case "replayed":
+            console.log(`anchor commit: ${result.anchor}`);
+            console.log(`pre-replay HEAD preserved at ${result.preReplayRef} (${result.preReplayCommit})`);
+            console.log(`reset ${result.resetWorkstreams.length} workstream(s) to not_started: ` +
+                `${result.resetWorkstreams.join(", ") || "(none)"}`);
+            console.log(`next: ${result.nextCommand}`);
+            break;
+    }
+}
+program
+    .command("decide")
+    .description("Record a human ruling on a ledgered decision, and optionally replay to " +
+    "rebuild the workstreams it affects")
+    .argument("<program-id>", "Program ID from /plan-program")
+    .argument("<decision-id>", "Decision ledger id shown in the run report")
+    .requiredOption("--choose <label>", "The option label the human is ruling on")
+    .requiredOption("--reason <text>", "Why, for the human record")
+    .option("--replay", "When the choice differs from what was built, roll back to the anchor " +
+    "commit and reset the affected workstreams", false)
+    .option("--cwd <path>", "Project directory", process.cwd())
+    .action(async (programId, decisionId, options) => {
+    const result = await decide({
+        cwd: options.cwd,
+        programId,
+        decisionId,
+        choose: options.choose,
+        reason: options.reason,
+        replay: options.replay,
+    });
+    renderDecideResult(result);
+});
 program
     .command("doctor")
     .description("Verify packaged assets and print the resolved skills root for each target")
@@ -256,5 +354,16 @@ program
         console.error(problem);
     process.exitCode = 1;
 });
-await program.parseAsync();
+try {
+    await program.parseAsync();
+}
+catch (error) {
+    // Guard refusals and validation failures are guidance for a human, not
+    // crashes: print the message, not a stack trace. The stack is available
+    // under NIGHTSHIFT_DEBUG for actual bug hunts.
+    if (process.env.NIGHTSHIFT_DEBUG)
+        throw error;
+    console.error(error.message);
+    process.exitCode = 1;
+}
 //# sourceMappingURL=cli.js.map