@wildorder/nightshift 0.1.0 → 0.3.0

package/dist/index.js

@@ -7,4 +7,13 @@ export * from "./project-manifest.js";
 export * from "./program-memory.js";
 export * from "./worktree-guard.js";
 export * from "./detect-package-manager.js";
+export * from "./decision.js";
+export * from "./decision-ledger.js";
+export * from "./manifest.js";
+export * from "./run-program.js";
+export * from "./init-project.js";
+export * from "./install-skills.js";
+export * from "./install-prefs.js";
+export * from "./install-wizard.js";
+export * from "./package-assets.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/init-project.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export declare const initOptionsSchema: z.ZodObject<{
+    cwd: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    stack: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    home: z.ZodOptional<z.ZodString>;
+    directivesPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InitOptions = z.infer<typeof initOptionsSchema>;
+export interface InitResult {
+    created: string[];
+    updated: string[];
+    skipped: string[];
+    warnings: string[];
+}
+export declare function initProject(input: InitOptions): Promise<InitResult>;
+//# sourceMappingURL=init-project.d.ts.map

package/dist/init-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-project.d.ts","sourceRoot":"","sources":["../src/init-project.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoPD,wBAAsB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8FzE"}

package/dist/init-project.js

@@ -0,0 +1,259 @@
+import { access, appendFile, mkdir, readdir, readFile, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, relative, resolve } from "node:path";
+import { z } from "zod";
+import { PACKAGE_ROOT, packageVersion } from "./package-assets.js";
+export const initOptionsSchema = z.object({
+    cwd: z.string().min(1),
+    name: z.string().min(1).optional(),
+    stack: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    home: z.string().min(1).optional(),
+    directivesPath: z.string().min(1).optional(),
+});
+const UNIVERSAL_PATTERN = /<!-- BEGIN UNIVERSAL[\s\S]*?<!-- END UNIVERSAL -->/u;
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function interpolate(template, values) {
+    return Object.entries(values).reduce((output, [key, value]) => output.replaceAll(`{{${key}}}`, value), template);
+}
+async function writeIfMissing(root, relativePath, content, result) {
+    const destination = join(root, relativePath);
+    if (await exists(destination)) {
+        result.skipped.push(relativePath);
+        return;
+    }
+    await mkdir(dirname(destination), { recursive: true });
+    await writeFile(destination, content, "utf8");
+    result.created.push(relativePath);
+}
+async function loadUniversalDirectives(home, explicitPath) {
+    if (explicitPath) {
+        const path = resolve(explicitPath);
+        if (!(await exists(path))) {
+            throw new Error(`Universal directives override not found: ${path}`);
+        }
+        return { content: await readFile(path, "utf8"), source: path };
+    }
+    const override = join(home, ".nightshift", "universal-directives.md");
+    if (await exists(override)) {
+        return { content: await readFile(override, "utf8"), source: override };
+    }
+    return {
+        content: await loadTemplate("universal-directives.md"),
+        source: "@wildorder/nightshift packaged default",
+    };
+}
+async function loadTemplate(name) {
+    return readFile(join(PACKAGE_ROOT, "templates", name), "utf8");
+}
+async function readPackageMetadata(root) {
+    try {
+        return JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function detectVerifyCommands(pkg) {
+    const scripts = pkg?.scripts ?? {};
+    const verify = {};
+    if (scripts.build)
+        verify.build = "npm run build";
+    if (scripts.typecheck)
+        verify.typecheck = "npm run typecheck";
+    if (scripts.lint)
+        verify.lint = "npm run lint";
+    if (scripts.test)
+        verify.test = "npm test";
+    return verify;
+}
+const KNOWN_FRAMEWORKS = {
+    react: "React",
+    next: "Next.js",
+    vue: "Vue",
+    svelte: "Svelte",
+    express: "Express",
+    fastify: "Fastify",
+    "@nestjs/core": "NestJS",
+    electron: "Electron",
+    commander: "Commander CLI",
+};
+const KNOWN_TEST_RUNNERS = ["vitest", "jest", "mocha", "playwright"];
+async function detectStack(root, pkg) {
+    const parts = [];
+    if (pkg) {
+        const dependencies = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        const usesTypeScript = Boolean(dependencies.typescript) ||
+            (await exists(join(root, "tsconfig.json")));
+        const node = pkg.engines?.node ? `Node ${pkg.engines.node}` : "Node.js";
+        parts.push(usesTypeScript ? `TypeScript on ${node}` : `JavaScript on ${node}`);
+        const frameworks = Object.entries(KNOWN_FRAMEWORKS)
+            .filter(([dependency]) => dependencies[dependency])
+            .map(([, label]) => label);
+        if (frameworks.length > 0)
+            parts.push(`frameworks: ${frameworks.join(", ")}`);
+        const testRunners = KNOWN_TEST_RUNNERS.filter((runner) => dependencies[runner]);
+        if (testRunners.length > 0)
+            parts.push(`tests: ${testRunners.join(", ")}`);
+    }
+    if ((await exists(join(root, "pyproject.toml"))) ||
+        (await exists(join(root, "requirements.txt")))) {
+        parts.push("Python");
+    }
+    if (await exists(join(root, "go.mod")))
+        parts.push("Go");
+    if (await exists(join(root, "Cargo.toml")))
+        parts.push("Rust");
+    return parts.length > 0 ? parts.join("; ") : undefined;
+}
+function dependencyRows(pkg) {
+    const entries = Object.entries(pkg?.dependencies ?? {}).slice(0, 15);
+    if (entries.length === 0)
+        return "| [Package] | [Version] |";
+    return entries
+        .map(([name, version]) => `| ${name} | ${version} |`)
+        .join("\n");
+}
+const PIPELINE_OWNED_DOCS = new Set(["AGENTS.md", "CLAUDE.md"]);
+const CONTEXT_DOC_LIMIT = 25;
+async function detectContextDocs(root) {
+    const docs = [];
+    try {
+        for (const entry of await readdir(root, { withFileTypes: true })) {
+            if (entry.isFile() &&
+                entry.name.toLowerCase().endsWith(".md") &&
+                !PIPELINE_OWNED_DOCS.has(entry.name)) {
+                docs.push(entry.name);
+            }
+        }
+    }
+    catch {
+        return [];
+    }
+    try {
+        for (const entry of await readdir(join(root, "docs"), {
+            recursive: true,
+            withFileTypes: true,
+        })) {
+            if (!entry.isFile() || !entry.name.toLowerCase().endsWith(".md"))
+                continue;
+            const relativePath = relative(root, join(entry.parentPath, entry.name)).replaceAll("\\", "/");
+            if (relativePath === "docs/vision.md" ||
+                relativePath === "docs/as-built.md" ||
+                relativePath.startsWith("docs/programs/") ||
+                relativePath.startsWith("docs/snapshots/")) {
+                continue;
+            }
+            docs.push(relativePath);
+        }
+    }
+    catch {
+        // No docs directory yet.
+    }
+    return [...new Set(docs)].sort().slice(0, CONTEXT_DOC_LIMIT);
+}
+async function upsertUniversalBlock(root, block, values, result) {
+    const destination = join(root, "AGENTS.md");
+    if (!(await exists(destination))) {
+        const template = await loadTemplate("AGENTS.md");
+        await writeFile(destination, interpolate(template, values), "utf8");
+        result.created.push("AGENTS.md");
+        return;
+    }
+    const current = await readFile(destination, "utf8");
+    if (UNIVERSAL_PATTERN.test(current)) {
+        const next = current.replace(UNIVERSAL_PATTERN, block);
+        if (next === current) {
+            result.skipped.push("AGENTS.md");
+        }
+        else {
+            await writeFile(destination, next, "utf8");
+            result.updated.push("AGENTS.md (universal block updated)");
+        }
+        return;
+    }
+    await writeFile(destination, `${block}\n\n---\n\n${current}`, "utf8");
+    result.updated.push("AGENTS.md (universal block added)");
+}
+export async function initProject(input) {
+    const options = initOptionsSchema.parse(input);
+    const root = resolve(options.cwd);
+    const home = resolve(options.home ?? homedir());
+    const result = { created: [], updated: [], skipped: [], warnings: [] };
+    const pkg = await readPackageMetadata(root);
+    const name = options.name ?? pkg?.name;
+    if (!name) {
+        throw new Error("Project name not provided and no package.json name found; pass --name.");
+    }
+    const description = options.description ?? pkg?.description;
+    if (!description) {
+        throw new Error("Project description not provided and no package.json description found; pass --description.");
+    }
+    let stack = options.stack ?? (await detectStack(root, pkg));
+    if (!stack) {
+        stack = "[Document the stack]";
+        result.warnings.push("Stack not provided and none detected; edit the Tech Stack sections or re-run with --stack.");
+    }
+    const contextDocs = await detectContextDocs(root);
+    const universal = await loadUniversalDirectives(home, options.directivesPath);
+    const values = {
+        PROJECT_NAME: name,
+        STACK: stack,
+        DESCRIPTION: description,
+        UNIVERSAL_DIRECTIVES: universal.content.trim(),
+        UNIVERSAL_SOURCE: universal.source,
+        DEPENDENCY_ROWS: dependencyRows(pkg),
+    };
+    const universalBlock = `<!-- BEGIN UNIVERSAL — source: ${universal.source} -->\n${universal.content.trim()}\n<!-- END UNIVERSAL -->`;
+    await mkdir(root, { recursive: true });
+    await Promise.all([
+        mkdir(join(root, "docs", "programs"), { recursive: true }),
+        mkdir(join(root, "docs", "snapshots"), { recursive: true }),
+        mkdir(join(root, "tasks"), { recursive: true }),
+        mkdir(join(root, "build-logs"), { recursive: true }),
+    ]);
+    await upsertUniversalBlock(root, universalBlock, values, result);
+    for (const [relativePath, templateName] of [
+        ["docs/vision.md", "vision.md"],
+        ["CLAUDE.md", "CLAUDE.md"],
+    ]) {
+        const template = await loadTemplate(templateName);
+        await writeIfMissing(root, relativePath, interpolate(template, values), result);
+    }
+    const config = `${JSON.stringify({
+        schemaVersion: 1,
+        nightshiftVersion: await packageVersion(),
+        visionPath: "docs/vision.md",
+        verify: detectVerifyCommands(pkg),
+        contextDocs,
+    }, null, 2)}\n`;
+    await writeIfMissing(root, "nightshift.config.json", config, result);
+    const gitignore = join(root, ".gitignore");
+    if (!(await exists(gitignore))) {
+        await writeFile(gitignore, "build-logs/\n", "utf8");
+        result.created.push(".gitignore");
+    }
+    else {
+        const content = await readFile(gitignore, "utf8");
+        if (!content.split(/\r?\n/u).includes("build-logs/")) {
+            await appendFile(gitignore, `${content.endsWith("\n") ? "" : "\n"}build-logs/\n`, "utf8");
+            result.created.push(".gitignore (updated)");
+        }
+        else {
+            result.skipped.push(".gitignore");
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=init-project.js.map

package/dist/init-project.js.map

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

package/dist/install-prefs.d.ts

@@ -0,0 +1,17 @@
+import { type InstallScope, type SkillTarget } from "./skill-roots.js";
+/**
+ * Which agent tools a developer uses is a property of the developer, not of
+ * any one repository — so the wizard's answer is remembered per machine.
+ * Without this, the `prepare` hook and every later non-interactive run would
+ * silently re-derive defaults and undo the choice.
+ */
+export declare const PREFS_PATH: string;
+export type PreferredScope = InstallScope | "both";
+export interface InstallPrefs {
+    targets: SkillTarget[];
+    scope: PreferredScope;
+}
+/** Returns undefined when no usable preference has been recorded yet. */
+export declare function loadInstallPrefs(home?: string): Promise<InstallPrefs | undefined>;
+export declare function saveInstallPrefs(prefs: InstallPrefs, home?: string): Promise<string>;
+//# sourceMappingURL=install-prefs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-prefs.d.ts","sourceRoot":"","sources":["../src/install-prefs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAAsC,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAQnD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;CACvB;AAMD,yEAAyE;AACzE,wBAAsB,gBAAgB,CACpC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA2BnC;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/dist/install-prefs.js

@@ -0,0 +1,55 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { z } from "zod";
+import { ALL_TARGETS } from "./skill-roots.js";
+/**
+ * Which agent tools a developer uses is a property of the developer, not of
+ * any one repository — so the wizard's answer is remembered per machine.
+ * Without this, the `prepare` hook and every later non-interactive run would
+ * silently re-derive defaults and undo the choice.
+ */
+export const PREFS_PATH = join(".nightshift", "install.json");
+const prefsSchema = z.object({
+    schemaVersion: z.literal(1),
+    targets: z.array(z.string()).default([]),
+    scope: z.enum(["user", "project", "both"]).default("user"),
+});
+function prefsFile(home) {
+    return join(resolve(home ?? homedir()), PREFS_PATH);
+}
+/** Returns undefined when no usable preference has been recorded yet. */
+export async function loadInstallPrefs(home) {
+    let raw;
+    try {
+        raw = await readFile(prefsFile(home), "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // A hand-corrupted preference file must not break installs; the caller
+        // falls back to detection.
+        return undefined;
+    }
+    const result = prefsSchema.safeParse(parsed);
+    if (!result.success)
+        return undefined;
+    // Unknown targets are dropped rather than rejected, so a file written by a
+    // newer version stays usable after a downgrade.
+    const targets = result.data.targets.filter((target) => ALL_TARGETS.includes(target));
+    if (targets.length === 0)
+        return undefined;
+    return { targets, scope: result.data.scope };
+}
+export async function saveInstallPrefs(prefs, home) {
+    const path = prefsFile(home);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify({ schemaVersion: 1, ...prefs }, null, 2)}\n`, "utf8");
+    return path;
+}
+//# sourceMappingURL=install-prefs.js.map

package/dist/install-prefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-prefs.js","sourceRoot":"","sources":["../src/install-prefs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAuC,MAAM,kBAAkB,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;AAI9D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CAC3D,CAAC,CAAC;AAOH,SAAS,SAAS,CAAC,IAAwB;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAa;IAEb,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,2BAA2B;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAEtC,2EAA2E;IAC3E,gDAAgD;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAyB,EAAE,CAC3E,WAAW,CAAC,QAAQ,CAAC,MAAqB,CAAC,CAC5C,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAmB,EACnB,IAAa;IAEb,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CACb,IAAI,EACJ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAC9D,MAAM,CACP,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/install-skills.d.ts

@@ -0,0 +1,83 @@
+import { type InstallScope, type SkillTarget } from "./skill-roots.js";
+export { ALL_TARGETS, DEFAULT_TARGETS, detectTargets, overrideEnvName, parseRootOverrides, parseTargets, type DetectedTarget, type InstallScope, type RootSource, type SkillTarget, } 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 declare const WORKFLOWS: readonly ["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 declare const RETIRED_WORKFLOWS: readonly [];
+export type Workflow = (typeof WORKFLOWS)[number];
+export type RetiredWorkflow = (typeof RETIRED_WORKFLOWS)[number];
+export type KnownWorkflow = Workflow | RetiredWorkflow;
+export interface InstallSkillsOptions {
+    cwd: string;
+    targets: SkillTarget[];
+    force?: boolean;
+    home?: string;
+    /**
+     * Where the skills land. Defaults to project scope so existing programmatic
+     * callers keep their behavior; the CLI chooses user scope explicitly.
+     */
+    scopes?: InstallScope[];
+    /**
+     * Remove project-scope copies that this package generated and the user has
+     * not edited. Project skills shadow user skills in most harnesses, so a
+     * user-scope install is silently ineffective until the stale copies go.
+     */
+    pruneProject?: boolean;
+    /** Per-target root overrides, from `--root <target>=<path>`. */
+    roots?: Partial<Record<SkillTarget, string>>;
+    env?: NodeJS.ProcessEnv;
+}
+export interface DefinitionWarning {
+    workflow: KnownWorkflow;
+    kind: "command" | "skill";
+    scope: InstallScope;
+    target: SkillTarget;
+    path: string;
+    packageManaged: boolean;
+}
+export interface InstallSkillsResult {
+    installed: string[];
+    updated: string[];
+    skipped: string[];
+    conflicts: string[];
+    warnings: DefinitionWarning[];
+    /** Project-scope copies removed because their marker proved them unmodified. */
+    pruned: string[];
+    /** Project-scope copies left alone because the user had edited them. */
+    pruneSkipped: string[];
+    /** Retired skills removed because their marker proved them unmodified. */
+    retired: string[];
+    /** Retired skills left in place because the user had edited them. */
+    retiredKept: string[];
+    aborted: boolean;
+}
+export interface ProjectCopies {
+    /** Generated by this package and unmodified — safe to remove. */
+    managed: string[];
+    /** Edited since generation, or never ours — only a human should touch these. */
+    modified: string[];
+}
+/**
+ * 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 declare function findProjectCopies(cwd: string, targets: SkillTarget[], options?: {
+    home?: string;
+    env?: NodeJS.ProcessEnv;
+    roots?: Partial<Record<SkillTarget, string>>;
+}): Promise<ProjectCopies>;
+export declare function installSkills(input: InstallSkillsOptions): Promise<InstallSkillsResult>;
+export declare function doctor(): Promise<string[]>;
+//# sourceMappingURL=install-skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.d.ts","sourceRoot":"","sources":["../src/install-skills.ts"],"names":[],"mappings":"AAKA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,eAAe,EACf,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,eAAO,MAAM,SAAS,2CAA4C,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,aAAc,CAAC;AAE7C,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAClD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,eAAe,CAAC;AAQvD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gFAAgF;IAChF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wEAAwE;IACxE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAsGD,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;CAAO,GACrG,OAAO,CAAC,aAAa,CAAC,CAwBxB;AA+ED,wBAAsB,aAAa,CACjC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA6G9B;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBhD"}