@wildorder/nightshift 0.1.0 → 0.3.0

package/dist/install-skills.js

@@ -0,0 +1,311 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, rm, rmdir, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { PACKAGE_ROOT } from "./package-assets.js";
+import { detectTargets, pathExists, scanRoots, } from "./skill-roots.js";
+export { ALL_TARGETS, DEFAULT_TARGETS, detectTargets, overrideEnvName, parseRootOverrides, parseTargets, } from "./skill-roots.js";
+/**
+ * The skills that ship: the two human-judgment steps that sit outside the
+ * automated loop — deciding how the project is set up, and deciding what to
+ * build. Everything downstream of planning is a CLI command that composes
+ * its own brief and spawns clean agents.
+ */
+export const WORKFLOWS = ["init-project", "plan-program"];
+/**
+ * Skills this package used to install and now removes. Empty so far — kept
+ * because the mechanism matters: a retired skill left in a skills directory
+ * keeps instructing an agent to do work that has since moved into a command.
+ * Never list another package's skills here (program-pipeline's included);
+ * retirement is only for names this package itself installed.
+ */
+export const RETIRED_WORKFLOWS = [];
+/** Every name this package has ever installed, for scanning and cleanup. */
+const ALL_KNOWN_WORKFLOWS = [
+    ...WORKFLOWS,
+    ...RETIRED_WORKFLOWS,
+];
+const MARKER_PATTERN = /<!-- nightshift:sha256=([a-f0-9]{64}) -->\n?/u;
+const COMMAND_EXTENSIONS = [".md", ".mdc", ".markdown", ".txt"];
+function normalize(content) {
+    return content.replaceAll("\r\n", "\n");
+}
+function digest(content) {
+    return createHash("sha256").update(normalize(content)).digest("hex");
+}
+function withMarker(source) {
+    const normalized = normalize(source);
+    const marker = `<!-- nightshift:sha256=${digest(normalized)} -->\n`;
+    const frontmatterEnd = normalized.indexOf("\n---\n", 4);
+    if (!normalized.startsWith("---\n") || frontmatterEnd < 0) {
+        throw new Error("Skill must contain YAML frontmatter.");
+    }
+    const insertAt = frontmatterEnd + 5;
+    return `${normalized.slice(0, insertAt)}${marker}${normalized.slice(insertAt)}`;
+}
+function generatedFileIsUnmodified(content) {
+    const normalized = normalize(content);
+    const marker = normalized.match(MARKER_PATTERN);
+    if (!marker?.[1])
+        return false;
+    const withoutMarker = normalized.replace(MARKER_PATTERN, "");
+    return digest(withoutMarker) === marker[1];
+}
+function pathKey(path) {
+    return process.platform === "win32" ? path.toLowerCase() : path;
+}
+async function findDefinitionWarnings(projectRoot, userHome, detected, targets, destinations) {
+    const warnings = [];
+    const seen = new Set();
+    const selected = detected.filter((entry) => targets.includes(entry.target));
+    for (const location of scanRoots(selected, projectRoot, userHome)) {
+        for (const workflow of ALL_KNOWN_WORKFLOWS) {
+            const candidates = location.kind === "skill"
+                ? [join(location.root, workflow, "SKILL.md")]
+                : COMMAND_EXTENSIONS.map((extension) => join(location.root, `${workflow}${extension}`));
+            for (const candidate of candidates) {
+                const key = pathKey(candidate);
+                if (destinations.has(key) ||
+                    seen.has(key) ||
+                    !(await pathExists(candidate))) {
+                    continue;
+                }
+                seen.add(key);
+                const content = await readFile(candidate, "utf8");
+                warnings.push({
+                    workflow,
+                    kind: location.kind,
+                    scope: location.scope,
+                    target: location.target,
+                    path: location.scope === "project"
+                        ? join(".", candidate.slice(projectRoot.length + 1))
+                        : candidate,
+                    packageManaged: location.kind === "skill" && generatedFileIsUnmodified(content),
+                });
+            }
+        }
+    }
+    return warnings;
+}
+/** Best-effort cleanup so pruning does not leave empty scaffolding behind. */
+async function removeIfEmpty(path) {
+    try {
+        await rmdir(path);
+    }
+    catch {
+        // Still has content, or never existed. Either way there is nothing to do.
+    }
+}
+/**
+ * Project-scope skill files for the given targets. Project skills shadow
+ * user-scope ones, so the caller needs this before a user-scope install to
+ * know whether the install would actually take effect.
+ */
+export async function findProjectCopies(cwd, targets, options = {}) {
+    const root = resolve(cwd);
+    const detected = await detectTargets({
+        home: resolve(options.home ?? homedir()),
+        ...(options.env ? { env: options.env } : {}),
+        ...(options.roots ? { roots: options.roots } : {}),
+    });
+    const copies = { managed: [], modified: [] };
+    for (const entry of detected) {
+        if (!targets.includes(entry.target))
+            continue;
+        for (const workflow of ALL_KNOWN_WORKFLOWS) {
+            const label = join(entry.projectRoot, workflow, "SKILL.md");
+            const path = join(root, label);
+            if (!(await pathExists(path)))
+                continue;
+            if (generatedFileIsUnmodified(await readFile(path, "utf8"))) {
+                copies.managed.push(label);
+            }
+            else {
+                copies.modified.push(label);
+            }
+        }
+    }
+    return copies;
+}
+async function pruneProjectCopies(projectRoot, detected, targets, result) {
+    for (const entry of detected) {
+        if (!targets.includes(entry.target))
+            continue;
+        const skillsRoot = join(projectRoot, entry.projectRoot);
+        for (const workflow of ALL_KNOWN_WORKFLOWS) {
+            const path = join(skillsRoot, workflow, "SKILL.md");
+            if (!(await pathExists(path)))
+                continue;
+            const label = join(entry.projectRoot, workflow, "SKILL.md");
+            if (generatedFileIsUnmodified(await readFile(path, "utf8"))) {
+                await rm(path);
+                await removeIfEmpty(dirname(path));
+                result.pruned.push(label);
+            }
+            else {
+                result.pruneSkipped.push(label);
+            }
+        }
+        await removeIfEmpty(skillsRoot);
+    }
+}
+/**
+ * Remove retired skills from **both** scopes, whatever scope this run is
+ * installing into.
+ *
+ * Scoping this to the install's own scopes was wrong: a stale skill almost
+ * always sits in the scope you *stopped* using. A project installed before
+ * the move to user-scope defaults keeps its project copies, and a later
+ * user-scope install would never look at them — leaving the retired skills
+ * exactly where the agent still reads them.
+ *
+ * Called only after a successful install, for the same reason pruning is: a
+ * run that aborted on a conflict must not have deleted anything.
+ */
+async function retireWorkflows(projectRoot, detected, targets, result) {
+    const scopes = ["user", "project"];
+    const seen = new Set();
+    for (const entry of detected) {
+        if (!targets.includes(entry.target))
+            continue;
+        for (const scope of scopes) {
+            const skillsRoot = scope === "user"
+                ? entry.userRoot
+                : join(projectRoot, entry.projectRoot);
+            for (const workflow of RETIRED_WORKFLOWS) {
+                const path = join(skillsRoot, workflow, "SKILL.md");
+                const key = pathKey(path);
+                // Root overrides can point two targets at one directory.
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                if (!(await pathExists(path)))
+                    continue;
+                const label = scope === "user"
+                    ? path
+                    : join(entry.projectRoot, workflow, "SKILL.md");
+                if (generatedFileIsUnmodified(await readFile(path, "utf8"))) {
+                    await rm(path);
+                    await removeIfEmpty(dirname(path));
+                    result.retired.push(label);
+                }
+                else {
+                    result.retiredKept.push(label);
+                }
+            }
+        }
+    }
+}
+export async function installSkills(input) {
+    const root = resolve(input.cwd);
+    const userHome = resolve(input.home ?? homedir());
+    const scopes = input.scopes ?? ["project"];
+    const result = {
+        installed: [],
+        updated: [],
+        skipped: [],
+        conflicts: [],
+        warnings: [],
+        pruned: [],
+        pruneSkipped: [],
+        retired: [],
+        retiredKept: [],
+        aborted: false,
+    };
+    const detected = await detectTargets({
+        home: userHome,
+        ...(input.env ? { env: input.env } : {}),
+        ...(input.roots ? { roots: input.roots } : {}),
+    });
+    const byTarget = new Map(detected.map((entry) => [entry.target, entry]));
+    const plans = [];
+    const planned = new Set();
+    for (const scope of scopes) {
+        for (const target of input.targets) {
+            const entry = byTarget.get(target);
+            if (!entry)
+                continue;
+            const skillsRoot = scope === "user" ? entry.userRoot : join(root, entry.projectRoot);
+            for (const workflow of WORKFLOWS) {
+                const destination = join(skillsRoot, workflow, "SKILL.md");
+                const key = pathKey(destination);
+                // Overrides can point two targets at one directory; write it once.
+                if (planned.has(key))
+                    continue;
+                planned.add(key);
+                const label = scope === "user"
+                    ? destination
+                    : join(entry.projectRoot, workflow, "SKILL.md");
+                const source = await readFile(join(PACKAGE_ROOT, "skills", workflow, "SKILL.md"), "utf8");
+                const desired = withMarker(source);
+                if (!(await pathExists(destination))) {
+                    plans.push({ label, destination, desired, action: "install" });
+                    continue;
+                }
+                const current = await readFile(destination, "utf8");
+                if (normalize(current) === desired) {
+                    plans.push({ label, destination, desired, action: "skip" });
+                }
+                else if (input.force || generatedFileIsUnmodified(current)) {
+                    plans.push({ label, destination, desired, action: "update" });
+                }
+                else {
+                    plans.push({ label, destination, desired, action: "conflict" });
+                }
+            }
+        }
+    }
+    result.warnings = await findDefinitionWarnings(root, userHome, detected, input.targets, planned);
+    result.conflicts = plans
+        .filter(({ action }) => action === "conflict")
+        .map(({ label }) => label);
+    result.skipped = plans
+        .filter(({ action }) => action === "skip")
+        .map(({ label }) => label);
+    if (result.conflicts.length > 0) {
+        result.aborted = true;
+        return result;
+    }
+    for (const plan of plans) {
+        if (plan.action === "install") {
+            await mkdir(dirname(plan.destination), { recursive: true });
+            await writeFile(plan.destination, plan.desired, "utf8");
+            result.installed.push(plan.label);
+        }
+        else if (plan.action === "update") {
+            await writeFile(plan.destination, plan.desired, "utf8");
+            result.updated.push(plan.label);
+        }
+    }
+    // Retired skills go from both scopes regardless of where this run installs:
+    // a stale copy anywhere keeps telling an agent to do work that is now a
+    // command.
+    await retireWorkflows(root, detected, input.targets, result);
+    // Only after a clean user-scope install: pruning first would delete the
+    // developer's working skills if the install then aborted.
+    if (input.pruneProject && scopes.includes("user") && !scopes.includes("project")) {
+        await pruneProjectCopies(root, detected, input.targets, result);
+    }
+    return result;
+}
+export async function doctor() {
+    const problems = [];
+    for (const workflow of WORKFLOWS) {
+        const path = join(PACKAGE_ROOT, "skills", workflow, "SKILL.md");
+        if (!(await pathExists(path))) {
+            problems.push(`Missing packaged skill: ${workflow}`);
+        }
+    }
+    for (const template of [
+        "vision.md",
+        "AGENTS.md",
+        "CLAUDE.md",
+        "universal-directives.md",
+    ]) {
+        if (!(await pathExists(join(PACKAGE_ROOT, "templates", template)))) {
+            problems.push(`Missing packaged template: ${template}`);
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=install-skills.js.map

package/dist/install-skills.js.map

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

package/dist/install-wizard.d.ts

@@ -0,0 +1,56 @@
+import { type PreferredScope } from "./install-prefs.js";
+import { type PromptStreams } from "./prompt.js";
+import { type DetectedTarget, type InstallScope, type SkillTarget } from "./skill-roots.js";
+export interface SkillPlanOptions {
+    cwd: string;
+    /** From `--targets`; presence alone suppresses the wizard. */
+    explicitTargets?: SkillTarget[];
+    /** From `--scope`. */
+    explicitScope?: PreferredScope;
+    /** From `--prune` / `--no-prune`. */
+    explicitPrune?: boolean;
+    /** From `--root <target>=<path>`. */
+    roots?: Partial<Record<SkillTarget, string>>;
+    /** From `--yes`: take the detected defaults without asking. */
+    yes?: boolean;
+    home?: string;
+    env?: NodeJS.ProcessEnv;
+    streams?: PromptStreams;
+    log?: (line: string) => void;
+}
+export interface SkillPlan {
+    targets: SkillTarget[];
+    scopes: InstallScope[];
+    pruneProject: boolean;
+    /** True when the user backed out; the caller must not write anything. */
+    cancelled: boolean;
+    detected: DetectedTarget[];
+}
+/** The option surface `install` and `setup` share, as plain values. */
+export interface InstallArgvOptions {
+    cwd: string;
+    targets?: string;
+    scope?: string;
+    root: string[];
+    force: boolean;
+    yes: boolean;
+    prune?: boolean;
+}
+/**
+ * Rebuild a run's skill options as an `install` argv, so `setup` can hand off
+ * to the CLI it just installed rather than continuing in its own process —
+ * where the code in memory predates the files on disk.
+ *
+ * Every option must survive the round trip. Dropping `--scope` here would
+ * silently install to a different root than the user asked for, which is the
+ * exact class of failure this handoff exists to prevent.
+ */
+export declare function installArgv(options: InstallArgvOptions, pruneCameFromCli: boolean): string[];
+export declare function scopesFor(scope: PreferredScope): InstallScope[];
+/**
+ * Decide what to install and where. Interactive only when a human is on both
+ * ends of the terminal and has not already answered on the command line;
+ * every other path resolves silently from detection and saved preferences.
+ */
+export declare function planSkillInstall(options: SkillPlanOptions): Promise<SkillPlan>;
+//# sourceMappingURL=install-wizard.d.ts.map

package/dist/install-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-wizard.d.ts","sourceRoot":"","sources":["../src/install-wizard.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,sBAAsB;IACtB,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,+DAA+D;IAC/D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,kBAAkB,EAC3B,gBAAgB,EAAE,OAAO,GACxB,MAAM,EAAE,CAUV;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,EAAE,CAG/D;AAMD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,SAAS,CAAC,CA8HpB"}

package/dist/install-wizard.js

@@ -0,0 +1,166 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { loadInstallPrefs, saveInstallPrefs, } from "./install-prefs.js";
+import { findProjectCopies } from "./install-skills.js";
+import { chooseMany, chooseOne, confirm, defaultStreams, isInteractive, } from "./prompt.js";
+import { ALL_TARGETS, detectTargets, } from "./skill-roots.js";
+/**
+ * Rebuild a run's skill options as an `install` argv, so `setup` can hand off
+ * to the CLI it just installed rather than continuing in its own process —
+ * where the code in memory predates the files on disk.
+ *
+ * Every option must survive the round trip. Dropping `--scope` here would
+ * silently install to a different root than the user asked for, which is the
+ * exact class of failure this handoff exists to prevent.
+ */
+export function installArgv(options, pruneCameFromCli) {
+    const argv = ["install", "--cwd", options.cwd];
+    if (options.targets !== undefined)
+        argv.push("--targets", options.targets);
+    if (options.scope !== undefined)
+        argv.push("--scope", options.scope);
+    for (const override of options.root)
+        argv.push("--root", override);
+    if (options.force)
+        argv.push("--force");
+    if (options.yes)
+        argv.push("--yes");
+    // Commander gives --prune a value either way, so only forward a real one.
+    if (pruneCameFromCli)
+        argv.push(options.prune ? "--prune" : "--no-prune");
+    return argv;
+}
+export function scopesFor(scope) {
+    if (scope === "both")
+        return ["user", "project"];
+    return [scope];
+}
+function describeScope(scopes) {
+    return scopes.length === 2 ? "user and project" : (scopes[0] ?? "project");
+}
+/**
+ * Decide what to install and where. Interactive only when a human is on both
+ * ends of the terminal and has not already answered on the command line;
+ * every other path resolves silently from detection and saved preferences.
+ */
+export async function planSkillInstall(options) {
+    const env = options.env ?? process.env;
+    const home = resolve(options.home ?? homedir());
+    const streams = options.streams ?? defaultStreams();
+    const log = options.log ?? ((line) => console.log(line));
+    const detected = await detectTargets({
+        home,
+        env,
+        ...(options.roots ? { roots: options.roots } : {}),
+    });
+    const present = detected.filter((entry) => entry.detected);
+    // With nothing detected — a fresh container, an unusual layout — installing
+    // everything is the old behavior and beats a silent no-op.
+    const fallbackTargets = present.length > 0 ? present.map((entry) => entry.target) : [...ALL_TARGETS];
+    const prefs = await loadInstallPrefs(home);
+    const interactive = !options.explicitTargets &&
+        !options.yes &&
+        isInteractive(streams, env);
+    if (!interactive) {
+        const targets = options.explicitTargets ?? prefs?.targets ?? fallbackTargets;
+        const scopes = scopesFor(options.explicitScope ?? prefs?.scope ?? "user");
+        if (!options.explicitTargets) {
+            const source = prefs ? "saved preferences" : "detected tools";
+            log(`installing to ${targets.join(", ")} at ${describeScope(scopes)} scope ` +
+                `(non-interactive, from ${source}; pass --targets or --scope to override)`);
+        }
+        return {
+            targets,
+            scopes,
+            pruneProject: options.explicitPrune ?? false,
+            cancelled: false,
+            detected,
+        };
+    }
+    const chosen = await chooseMany({
+        title: "Where should the workflow skills go?",
+        choices: detected.map((entry) => ({
+            value: entry.target,
+            label: entry.label,
+            hint: entry.detected
+                ? entry.userRoot
+                : `${entry.userRoot}  (not detected)`,
+        })),
+        initial: prefs?.targets ?? fallbackTargets,
+        streams,
+        env,
+    });
+    if (!chosen)
+        return emptyPlan(detected);
+    if (chosen.length === 0) {
+        log("no targets selected; nothing to install");
+        return emptyPlan(detected);
+    }
+    let scope = options.explicitScope;
+    if (!scope) {
+        const picked = await chooseOne({
+            title: "Install for this machine or just this project?",
+            choices: [
+                {
+                    value: "user",
+                    label: "This machine",
+                    hint: "one update covers every repository",
+                },
+                {
+                    value: "project",
+                    label: "This project",
+                    hint: "checked into the repo, pinned per project",
+                },
+                { value: "both", label: "Both", hint: "project copies shadow machine ones" },
+            ],
+            initial: prefs?.scope ?? "user",
+            streams,
+            env,
+        });
+        if (!picked)
+            return emptyPlan(detected);
+        scope = picked;
+    }
+    const scopes = scopesFor(scope);
+    let pruneProject = options.explicitPrune ?? false;
+    // Only worth asking when project copies would shadow what we just installed.
+    if (options.explicitPrune === undefined &&
+        scopes.includes("user") &&
+        !scopes.includes("project")) {
+        const copies = await findProjectCopies(options.cwd, chosen, {
+            home,
+            env,
+            ...(options.roots ? { roots: options.roots } : {}),
+        });
+        if (copies.managed.length > 0) {
+            const answer = await confirm({
+                title: `Found ${copies.managed.length} project-scope skill file(s) in this repo. ` +
+                    "They shadow the machine-wide ones. Remove them?",
+                initial: true,
+                streams,
+                env,
+            });
+            if (answer === undefined)
+                return emptyPlan(detected);
+            pruneProject = answer;
+        }
+        if (copies.modified.length > 0) {
+            log(`note ${copies.modified.length} edited project-scope skill file(s) will be left in place and keep shadowing:`);
+            for (const path of copies.modified)
+                log(`  ${path}`);
+        }
+    }
+    const savedTo = await saveInstallPrefs({ targets: chosen, scope }, home);
+    log(`saved install preferences to ${savedTo}`);
+    return { targets: chosen, scopes, pruneProject, cancelled: false, detected };
+}
+function emptyPlan(detected) {
+    return {
+        targets: [],
+        scopes: [],
+        pruneProject: false,
+        cancelled: true,
+        detected,
+    };
+}
+//# sourceMappingURL=install-wizard.js.map

package/dist/install-wizard.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+/**
+ * The program manifest: the single canonical home for success criteria, the
+ * workstream roster, dependencies, and scope. `/plan-program` writes it; the
+ * runner reads it and writes workstream status back. Narrative belongs in
+ * the program document, never here — one canonical home per fact.
+ */
+export declare const WORKSTREAM_STATUSES: readonly ["not_started", "in_progress", "complete", "failed", "parked"];
+export type WorkstreamStatus = (typeof WORKSTREAM_STATUSES)[number];
+declare const workstreamSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    taskFile: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<{
+        not_started: "not_started";
+        in_progress: "in_progress";
+        complete: "complete";
+        failed: "failed";
+        parked: "parked";
+    }>>;
+    size: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodString;
+        includes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        excludes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    packages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const manifestSchema: z.ZodObject<{
+    program: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            atomic: "atomic";
+            orchestrated: "orchestrated";
+        }>>;
+        executionModeReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    successCriteria: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$loose>>>;
+    packages: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    workstreams: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        taskFile: z.ZodString;
+        status: z.ZodDefault<z.ZodEnum<{
+            not_started: "not_started";
+            in_progress: "in_progress";
+            complete: "complete";
+            failed: "failed";
+            parked: "parked";
+        }>>;
+        size: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodObject<{
+            summary: z.ZodString;
+            includes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            excludes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        packages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>>;
+    outOfScope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+export type Workstream = z.infer<typeof workstreamSchema>;
+export type ProgramManifest = z.infer<typeof manifestSchema>;
+export declare function manifestPath(root: string, programId: string): string;
+export declare function loadManifest(root: string, programId: string): Promise<ProgramManifest>;
+export declare function saveManifest(root: string, programId: string, manifest: ProgramManifest): Promise<void>;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,yEAMtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAQpE,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;iBASpB,CAAC;AAEH,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBV,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE7D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAyC1B;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAMf"}