@wildorder/nightshift 0.1.0 → 0.2.0

package/dist/cli.js

@@ -1,18 +1,237 @@
 #!/usr/bin/env node
-import { readFile } from "node:fs/promises";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
 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;
+import { addDevDependencyCommand, detectPackageManager, isPnpmWorkspaceRoot, PACKAGE_MANAGERS, parsePackageManager, } from "./detect-package-manager.js";
+import { initProject } from "./init-project.js";
+import { ALL_TARGETS, DEFAULT_TARGETS, detectTargets, doctor, installSkills, overrideEnvName, parseRootOverrides, parseTargets, } from "./install-skills.js";
+import { installArgv, planSkillInstall } from "./install-wizard.js";
+import { packageVersion } from "./package-assets.js";
+import { createProjectManifest } from "./project-manifest.js";
+const SCOPES = ["user", "project", "both"];
+function parseScope(value) {
+    const scope = value.trim().toLowerCase();
+    if (!SCOPES.includes(scope)) {
+        throw new Error(`Unknown scope "${value}". Expected: ${SCOPES.join(", ")}.`);
+    }
+    return scope;
 }
-const program = new Command();
-program
+function collect(value, previous) {
+    return [...previous, value];
+}
+/** Shared option surface for `install` and `setup`. */
+function withSkillOptions(command) {
+    return command
+        .option("--cwd <path>", "Project directory", process.cwd())
+        .option("--targets <targets>", `Comma-separated targets: ${DEFAULT_TARGETS} (default: detected tools)`)
+        .option("--scope <scope>", `Install location: ${SCOPES.join(", ")} (default: user)`)
+        .option("--root <target=path>", "Override a target's skills root; repeatable", collect, [])
+        .option("--force", "Overwrite conflicting skill files", false)
+        .option("--yes", "Accept detected defaults without prompting", false)
+        .option("--prune", "Remove unmodified project-scope copies after a user-scope install")
+        .option("--no-prune", "Keep project-scope copies");
+}
+function localCliPath(root) {
+    return join(root, "node_modules", "@wildorder", "nightshift", "dist", "cli.js");
+}
+/**
+ * Resolves the plan (prompting when a human is present), runs the install, and
+ * reports it. Returns undefined when the user cancelled or a conflict aborted
+ * the write.
+ */
+async function runSkillInstall(options, command) {
+    const roots = parseRootOverrides(options.root);
+    const plan = await planSkillInstall({
+        cwd: options.cwd,
+        ...(options.targets === undefined
+            ? {}
+            : { explicitTargets: parseTargets(options.targets) }),
+        ...(options.scope === undefined
+            ? {}
+            : { explicitScope: parseScope(options.scope) }),
+        // Commander gives --prune a value either way, so ask where it came from.
+        ...(command.getOptionValueSource("prune") === "cli"
+            ? { explicitPrune: options.prune ?? false }
+            : {}),
+        roots,
+        yes: options.yes,
+    });
+    if (plan.cancelled) {
+        console.log("cancelled; nothing was written");
+        process.exitCode = 130;
+        return undefined;
+    }
+    const result = await installSkills({
+        cwd: options.cwd,
+        targets: plan.targets,
+        scopes: plan.scopes,
+        force: options.force,
+        pruneProject: plan.pruneProject,
+        roots,
+    });
+    reportInstall(result);
+    return result.aborted ? undefined : result;
+}
+function reportInstall(result) {
+    for (const path of result.installed)
+        console.log(`installed ${path}`);
+    for (const path of result.updated)
+        console.log(`updated ${path}`);
+    for (const path of result.skipped)
+        console.log(`unchanged ${path}`);
+    for (const path of result.pruned)
+        console.log(`removed ${path}`);
+    for (const path of result.retired) {
+        console.log(`retired ${path}; its work is now a CLI command`);
+    }
+    for (const path of result.retiredKept) {
+        console.warn(`warning kept ${path}; this skill is retired but you edited it, so it was left alone — delete it when you have salvaged anything you need.`);
+    }
+    for (const path of result.pruneSkipped) {
+        console.warn(`warning kept ${path}; edited since generation, so it still shadows the user-scope skill`);
+    }
+    for (const warning of result.warnings) {
+        const ownership = warning.packageManaged ? "package-managed" : "external";
+        console.warn(`warning ${warning.scope} ${warning.target} ${warning.kind} (${ownership}) for ${warning.workflow}: ${warning.path}`);
+    }
+    for (const path of result.conflicts)
+        console.warn(`conflict ${path}`);
+    if (result.aborted) {
+        console.warn("installation aborted before writing files; resolve conflicts or re-run with --force");
+    }
+    if (result.conflicts.length > 0)
+        process.exitCode = 1;
+}
+const program = new Command()
     .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();
+program
+    .command("init")
+    .description("Initialize or adopt a project with the nightshift structure")
+    .option("--name <name>", "Project name (default: package.json name)")
+    .option("--stack <stack>", "Primary language and technology stack (default: detected from the repository)")
+    .option("--description <description>", "One-line product description (default: package.json description)")
+    .option("--cwd <path>", "Project directory", process.cwd())
+    .option("--directives <path>", "Universal directives override file (defaults to ~/.nightshift/universal-directives.md, then the packaged template)")
+    .action(async (options) => {
+    const result = await initProject({
+        cwd: options.cwd,
+        ...(options.name === undefined ? {} : { name: options.name }),
+        ...(options.stack === undefined ? {} : { stack: options.stack }),
+        ...(options.description === undefined
+            ? {}
+            : { description: options.description }),
+        ...(options.directives === undefined
+            ? {}
+            : { directivesPath: options.directives }),
+    });
+    for (const path of result.created)
+        console.log(`created ${path}`);
+    for (const path of result.updated)
+        console.log(`updated ${path}`);
+    for (const path of result.skipped)
+        console.log(`skipped ${path}`);
+    for (const warning of result.warnings)
+        console.warn(`warning ${warning}`);
+});
+withSkillOptions(program
+    .command("install")
+    .description("Install portable workflow skills for the agent tools on this machine")).action(async (options, command) => {
+    await runSkillInstall(options, command);
+});
+withSkillOptions(program
+    .command("setup")
+    .description("One-step setup: add the package as a devDependency and install workflow skills"))
+    .option("--pm <manager>", `Package manager for the devDependency: ${PACKAGE_MANAGERS.join(", ")} (default: detected from the repository)`)
+    .option("--no-package-json", "Do not create a placeholder package.json when the directory has none")
+    .action(async (options, command) => {
+    const root = resolve(options.cwd);
+    if (options.packageJson && !existsSync(join(root, "package.json"))) {
+        const manifest = await createProjectManifest(root);
+        if (manifest.created) {
+            console.log(`created package.json (private placeholder, name "${manifest.name}")`);
+        }
+        else if (manifest.reason === "foreign manifest") {
+            console.warn(`warning ${manifest.foreignManifest} found; skipped creating a package.json for a non-Node project`);
+        }
+    }
+    let addedDependency = false;
+    if (existsSync(join(root, "package.json"))) {
+        const manager = options.pm === undefined
+            ? detectPackageManager(root)
+            : parsePackageManager(options.pm);
+        console.log(`adding @wildorder/nightshift as a devDependency with ${manager}`);
+        const exitCode = await new Promise((resolvePromise, rejectPromise) => {
+            const child = spawn(addDevDependencyCommand(manager, "@wildorder/nightshift", {
+                pnpmWorkspaceRoot: isPnpmWorkspaceRoot(root),
+            }), { cwd: root, shell: true, stdio: "inherit", windowsHide: true });
+            child.on("error", rejectPromise);
+            child.on("close", (code) => resolvePromise(code ?? 1));
+        });
+        if (exitCode !== 0) {
+            console.error(`${manager} install failed; skills were not installed. Fix the ${manager} error and re-run setup (use --pm to override the detected package manager).`);
+            process.exitCode = 1;
+            return;
+        }
+        addedDependency = true;
+    }
+    else {
+        console.warn("warning no package.json found; skipped adding the devDependency (run the CLI via npx @wildorder/nightshift)");
+    }
+    // The dependency install just replaced this package's own files on
+    // disk, but this process is still running the code it loaded before
+    // that happened. Continuing in-process applies the *old* version's
+    // notion of which skills exist to the *new* version's files, which
+    // breaks outright the moment a release adds or retires one. Hand off to
+    // the CLI that was just installed.
+    const upgraded = localCliPath(root);
+    if (addedDependency && existsSync(upgraded)) {
+        const exitCode = await new Promise((resolvePromise, rejectPromise) => {
+            const child = spawn(process.execPath, [
+                upgraded,
+                ...installArgv({ ...options, cwd: root }, command.getOptionValueSource("prune") === "cli"),
+            ], { cwd: root, stdio: "inherit", windowsHide: true });
+            child.on("error", rejectPromise);
+            child.on("close", (code) => resolvePromise(code ?? 1));
+        });
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+            return;
+        }
+        console.log("setup complete; run /init-project from your agent to continue");
+        return;
+    }
+    const result = await runSkillInstall({ ...options, cwd: root }, command);
+    if (result) {
+        console.log("setup complete; run /init-project from your agent to continue");
+    }
+});
+program
+    .command("doctor")
+    .description("Verify packaged assets and print the resolved skills root for each target")
+    .option("--root <target=path>", "Override a target's skills root; repeatable", collect, [])
+    .action(async (options) => {
+    const detected = await detectTargets({
+        roots: parseRootOverrides(options.root),
+    });
+    const width = Math.max(...detected.map((entry) => entry.label.length));
+    console.log("skills roots");
+    for (const entry of detected) {
+        const state = entry.detected ? "detected" : "not detected";
+        console.log(`  ${entry.label.padEnd(width)}  ${entry.userRoot}  [${state}, ${entry.source}]`);
+    }
+    console.log(`\noverride any row with --root <target>=<path> or ${overrideEnvName(ALL_TARGETS[0] ?? "claude")}-style environment variables\n`);
+    const problems = await doctor();
+    if (problems.length === 0) {
+        console.log("nightshift package is healthy.");
+        return;
+    }
+    for (const problem of problems)
+        console.error(problem);
+    process.exitCode = 1;
+});
+await program.parseAsync();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -23,6 +23,8 @@ export type AgentConfig = z.infer<typeof agentSchema>;
  *   the runner recover from a primary token, quota, or session failure.
  */
 declare const configSchema: z.ZodObject<{
+    schemaVersion: z.ZodOptional<z.ZodLiteral<1>>;
+    nightshiftVersion: z.ZodOptional<z.ZodString>;
     agent: z.ZodOptional<z.ZodObject<{
         command: z.ZodString;
         args: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -56,6 +58,8 @@ declare const configSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     verify: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    visionPath: z.ZodDefault<z.ZodString>;
+    contextDocs: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type NightshiftConfig = z.infer<typeof configSchema>;
 export declare const DEFAULT_CONFIG: NightshiftConfig;

package/dist/config.d.ts.map

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAchB,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

@@ -21,12 +21,19 @@ const agentSchema = z.object({
  *   the runner recover from a primary token, quota, or session failure.
  */
 const configSchema = z.object({
+    schemaVersion: z.literal(1).optional(),
+    /** The package version that scaffolded this project, for support triage. */
+    nightshiftVersion: z.string().optional(),
     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({}),
+    /** The anchor product vision document, read by planning. */
+    visionPath: z.string().default("docs/vision.md"),
+    /** Extra human-authored documents planning should read. */
+    contextDocs: z.array(z.string()).default([]),
 });
 export const DEFAULT_CONFIG = configSchema.parse({});
 /**

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -7,4 +7,9 @@ export * from "./project-manifest.js";
 export * from "./program-memory.js";
 export * from "./worktree-guard.js";
 export * from "./detect-package-manager.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.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","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.d.ts","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,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -7,4 +7,9 @@ export * from "./project-manifest.js";
 export * from "./program-memory.js";
 export * from "./worktree-guard.js";
 export * from "./detect-package-manager.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,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