@codyswann/lisa 2.133.4 → 2.134.1

package/README.md

@@ -51,14 +51,53 @@ Templates follow governance rules: some files are overwritten on every update (e
 ## Quick Start
 
 ```bash
-curl -fsSL https://claude.ai/install.sh | bash
+npm install -g @codyswann/lisa
+lisa setup-project --type rails my-app
+cd my-app
 ```
 
-> Ask Claude: "I just cloned this repo. Walk me through setup."
+To add Lisa to an existing project instead, run:
+
+```bash
+lisa apply /path/to/project
+```
+
+The historical positional form still works for backwards compatibility:
+
+```bash
+lisa /path/to/project
+```
 
 ## Working With Lisa
 
-Lisa exposes a small set of top-level commands that map to the work lifecycle. Run them in Claude Code; everything underneath — agents, sub-flows, and the supporting libraries that power each step — happens automatically.
+Lisa exposes a small global CLI for project setup plus slash commands for the work lifecycle. Everything underneath — agents, sub-flows, and the supporting libraries that power each step — happens automatically.
+
+### Global CLI
+
+Install Lisa once and use the explicit setup commands for new or existing projects:
+
+```bash
+npm install -g @codyswann/lisa
+lisa setup-project --type rails my-app
+lisa setup-wiki
+lisa apply /path/to/project
+```
+
+Supported starter-backed setup types are `rails`, `typescript`, `expo`, `nestjs`, `cdk`, `wiki`, and `harper-wiki`. `setup-project --type wiki` creates a wiki-first repository; `setup-wiki` adds or repairs an embedded `wiki/` in the current project.
+
+Maintenance commands are intentionally small:
+
+```bash
+lisa doctor [path]
+lisa version
+lisa update
+```
+
+`lisa version` reports the installed package version, latest npm version, install path, and default harness. `lisa update` prints the package-manager update command and only runs it when `--yes` is supplied. Normal commands perform a non-fatal npm update check unless `--no-update-check` or `LISA_SKIP_UPDATE_CHECK=1` is set.
+
+### Lisa Workflow Commands
+
+Run these in Claude Code or the supported harness for the project.
 
 ### The Lifecycle
 

package/dist/cli/doctor.d.ts

@@ -0,0 +1,35 @@
+import { runUpdateCheck } from "./update-check.js";
+/** Status values emitted by Lisa doctor checks. */
+type DoctorStatus = "ok" | "warn" | "fail";
+/** One Lisa doctor check result. */
+export interface DoctorCheck {
+    name: string;
+    status: DoctorStatus;
+    detail: string;
+}
+/** Machine-readable doctor result. */
+export interface DoctorResult {
+    checks: DoctorCheck[];
+}
+/** Options parsed for `lisa doctor`. */
+export interface DoctorOptions {
+    json?: boolean;
+    offline?: boolean;
+}
+/** Runtime collaborators for doctor. */
+export interface DoctorDependencies {
+    fetchImpl: typeof fetch;
+    runUpdateCheck: typeof runUpdateCheck;
+    setExitCode: (code: number) => void;
+    write: (message: string) => void;
+}
+/**
+ * Run Lisa doctor checks.
+ * @param targetPath - Optional project path
+ * @param options - Parsed command options
+ * @param dependencies - Optional collaborators for tests
+ * @returns Doctor result
+ */
+export declare function runDoctor(targetPath: string | undefined, options: DoctorOptions, dependencies?: Partial<DoctorDependencies>): Promise<DoctorResult>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,mDAAmD;AACnD,KAAK,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAM3C,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,KAAK,CAAC;IACxB,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAmMD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,aAAa,EACtB,YAAY,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC7C,OAAO,CAAC,YAAY,CAAC,CA8BvB"}

package/dist/cli/doctor.js

@@ -0,0 +1,204 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import * as path from "node:path";
+import { createDetectorRegistry } from "../detection/index.js";
+import { STARTERS } from "./starters.js";
+import { runUpdateCheck } from "./update-check.js";
+const VERSION_CHECK_NAME = "Lisa version current?";
+const STARTER_HEALTH_NAME = "Starter health";
+const PROJECT_CONFIG_CHECK_NAME = "Project Lisa config present?";
+const DEFAULT_DEPENDENCIES = {
+    fetchImpl: fetch,
+    runUpdateCheck,
+    setExitCode: code => {
+        process.exitCode = code;
+    },
+    write: message => console.log(message),
+};
+/**
+ * Check Lisa's installed version against npm.
+ * @param deps - Runtime dependencies
+ * @param offline - Skip network check
+ * @returns Doctor check result
+ */
+async function checkVersion(deps, offline) {
+    if (offline) {
+        return {
+            name: VERSION_CHECK_NAME,
+            status: "ok",
+            detail: "Skipped network check in offline mode",
+        };
+    }
+    const result = await deps.runUpdateCheck();
+    if (result.isOutdated && result.latest) {
+        return {
+            name: VERSION_CHECK_NAME,
+            status: "warn",
+            detail: `Installed ${result.current}; latest is ${result.latest}`,
+        };
+    }
+    return {
+        name: VERSION_CHECK_NAME,
+        status: result.latest ? "ok" : "warn",
+        detail: result.latest
+            ? `Installed ${result.current}; latest is ${result.latest}`
+            : `Latest version unavailable${result.reason ? ` (${result.reason})` : ""}`,
+    };
+}
+/**
+ * Validate Lisa project configuration files.
+ * @param targetPath - Project path to inspect
+ * @returns Doctor check result
+ */
+async function checkProjectConfig(targetPath) {
+    const configPaths = [".lisa.config.json", ".lisa.config.local.json"]
+        .map(fileName => path.join(targetPath, fileName))
+        .filter(configPath => existsSync(configPath));
+    if (configPaths.length === 0) {
+        return {
+            name: PROJECT_CONFIG_CHECK_NAME,
+            status: "warn",
+            detail: "No .lisa.config.json or .lisa.config.local.json found",
+        };
+    }
+    for (const configPath of configPaths) {
+        try {
+            JSON.parse(await readFile(configPath, "utf8"));
+        }
+        catch (error) {
+            return {
+                name: PROJECT_CONFIG_CHECK_NAME,
+                status: "fail",
+                detail: `${path.basename(configPath)} is not parseable JSON: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    return {
+        name: PROJECT_CONFIG_CHECK_NAME,
+        status: "ok",
+        detail: configPaths.map(configPath => path.basename(configPath)).join(", "),
+    };
+}
+/**
+ * Detect the target project type.
+ * @param targetPath - Project path to inspect
+ * @returns Doctor check result
+ */
+async function checkProjectType(targetPath) {
+    const detectorRegistry = createDetectorRegistry();
+    const detectedTypes = detectorRegistry.expandAndOrderTypes(await detectorRegistry.detectAll(targetPath));
+    if (detectedTypes.length === 0) {
+        return {
+            name: "Project type detection",
+            status: "warn",
+            detail: "No Lisa project type detected",
+        };
+    }
+    return {
+        name: "Project type detection",
+        status: "ok",
+        detail: detectedTypes.join(", "),
+    };
+}
+/**
+ * Confirm starter repositories are reachable and marked as templates.
+ * @param deps - Runtime dependencies
+ * @param offline - Skip network checks
+ * @returns Doctor check result
+ */
+async function checkStarterHealth(deps, offline) {
+    if (offline) {
+        return {
+            name: STARTER_HEALTH_NAME,
+            status: "ok",
+            detail: "Skipped GitHub starter checks in offline mode",
+        };
+    }
+    const checks = await Promise.all(Object.values(STARTERS).map(async (starter) => {
+        const failurePrefix = `${starter.repo}:`;
+        try {
+            const response = await deps.fetchImpl(`https://api.github.com/repos/${starter.owner}/${starter.repo}`);
+            if (!response.ok) {
+                return `${failurePrefix} http-${response.status}`;
+            }
+            const body = (await response.json());
+            if (body.is_template !== true) {
+                return `${failurePrefix} not-template`;
+            }
+        }
+        catch {
+            return `${failurePrefix} unreachable`;
+        }
+        return null;
+    }));
+    const failures = checks.filter((check) => check !== null);
+    return {
+        name: STARTER_HEALTH_NAME,
+        status: failures.length === 0 ? "ok" : "warn",
+        detail: failures.length === 0
+            ? "Starter repositories are reachable templates"
+            : failures.join(", "),
+    };
+}
+/**
+ * Check basic wiki contract files when a wiki exists.
+ * @param targetPath - Project path to inspect
+ * @returns Doctor check result
+ */
+function checkWiki(targetPath) {
+    const wikiPath = path.join(targetPath, "wiki");
+    if (!existsSync(wikiPath)) {
+        return {
+            name: "Wiki health",
+            status: "ok",
+            detail: "No wiki directory present",
+        };
+    }
+    const required = [
+        "lisa-wiki.config.json",
+        "schema/llm-wiki-contract.md",
+        "index.md",
+    ];
+    const missing = required.filter(fileName => {
+        return !existsSync(path.join(wikiPath, fileName));
+    });
+    return {
+        name: "Wiki health",
+        status: missing.length === 0 ? "ok" : "fail",
+        detail: missing.length === 0
+            ? "Required wiki files are present"
+            : `Missing ${missing.join(", ")}`,
+    };
+}
+/**
+ * Run Lisa doctor checks.
+ * @param targetPath - Optional project path
+ * @param options - Parsed command options
+ * @param dependencies - Optional collaborators for tests
+ * @returns Doctor result
+ */
+export async function runDoctor(targetPath, options, dependencies = {}) {
+    const deps = { ...DEFAULT_DEPENDENCIES, ...dependencies };
+    const resolvedTarget = path.resolve(targetPath ?? process.cwd());
+    const checks = [
+        await checkVersion(deps, options.offline === true),
+        await checkProjectConfig(resolvedTarget),
+        await checkProjectType(resolvedTarget),
+        await checkStarterHealth(deps, options.offline === true),
+        checkWiki(resolvedTarget),
+    ];
+    const result = { checks };
+    if (options.json) {
+        deps.write(JSON.stringify(result, null, 2));
+    }
+    else {
+        deps.write(checks
+            .map(check => `${check.status.toUpperCase()} ${check.name}: ${check.detail}`)
+            .join("\n"));
+    }
+    if (checks.some(check => check.status === "fail")) {
+        deps.setExitCode(1);
+    }
+    return result;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/index.d.ts

@@ -1,8 +1,12 @@
 import { Command } from "commander";
 import { runApply } from "./apply.js";
+import { runDoctor } from "./doctor.js";
 import { printUpdateWarning } from "./print-update-warning.js";
 import { runSetupProject } from "./setup-project.js";
+import { runSetupWiki } from "./setup-wiki.js";
+import { runUpdate } from "./update-cmd.js";
 import { runUpdateCheck } from "./update-check.js";
+import { runVersion } from "./version-cmd.js";
 /**
  * Injectable collaborators for {@link createProgram}. Defaults wire the real
  * apply action and npm update-check; tests override them to observe the program
@@ -13,6 +17,14 @@ export interface ProgramDependencies {
     runApply: typeof runApply;
     /** Creates a starter-backed project and applies Lisa overlays. */
     runSetupProject: typeof runSetupProject;
+    /** Prepares an existing project for embedded wiki setup. */
+    runSetupWiki: typeof runSetupWiki;
+    /** Prints Lisa CLI version metadata. */
+    runVersion: typeof runVersion;
+    /** Prints or runs the package-manager update command. */
+    runUpdate: typeof runUpdate;
+    /** Diagnoses Lisa project health. */
+    runDoctor: typeof runDoctor;
     /** Runs the non-fatal npm update check (defaults to {@link runUpdateCheck}). */
     runUpdateCheck: typeof runUpdateCheck;
     /** Prints the update warning (defaults to {@link printUpdateWarning}). */

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,kEAAkE;IAClE,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,gFAAgF;IAChF,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,0EAA0E;IAC1E,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;CAC/C;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,YAAY,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC9C,OAAO,CA0DT;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,kEAAkE;IAClE,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,4DAA4D;IAC5D,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,wCAAwC;IACxC,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,yDAAyD;IACzD,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,qCAAqC;IACrC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,gFAAgF;IAChF,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,0EAA0E;IAC1E,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;CAC/C;AAwDD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,YAAY,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC9C,OAAO,CAwET;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/cli/index.js

@@ -1,17 +1,59 @@
 import { Command } from "commander";
 import { runApply } from "./apply.js";
+import { runDoctor } from "./doctor.js";
 import { printUpdateWarning } from "./print-update-warning.js";
 import { runSetupProject } from "./setup-project.js";
+import { runSetupWiki } from "./setup-wiki.js";
 import { addSharedOptions } from "./shared-options.js";
 import { SETUP_TYPES } from "./starters.js";
+import { runUpdate } from "./update-cmd.js";
 import { runUpdateCheck } from "./update-check.js";
+import { runVersion } from "./version-cmd.js";
 import { getPackageVersion } from "./version.js";
 const DEFAULT_DEPENDENCIES = {
     runApply,
     runSetupProject,
+    runSetupWiki,
+    runVersion,
+    runUpdate,
+    runDoctor,
     runUpdateCheck,
     printUpdateWarning,
 };
+/**
+ * Register CLI maintenance commands that do not run the root update warning.
+ * @param program - Commander program to mutate
+ * @param deps - Program dependencies
+ * @returns The same Commander program
+ */
+function addMaintenanceCommands(program, deps) {
+    program
+        .command("version")
+        .description("Print Lisa CLI version info")
+        .action(async () => {
+        await deps.runVersion();
+    });
+    program
+        .command("update")
+        .description("Print (or run with --yes) the recommended package-manager update command")
+        .option("--yes", "Execute the update command after printing it")
+        .action(async (options) => {
+        const code = await deps.runUpdate(options);
+        if (code !== 0) {
+            process.exitCode = code;
+        }
+    });
+    program
+        .command("doctor")
+        .description("Diagnose Lisa, project, starter, and wiki health")
+        .argument("[path]", "Project path to inspect")
+        .option("--json", "Emit JSON")
+        .option("--offline", "Skip network checks")
+        .action(async (targetPath, options) => {
+        await deps.runDoctor(targetPath, options);
+    });
+    return program;
+}
 /**
  * Create and configure the CLI program.
  *
@@ -36,7 +78,10 @@ export function createProgram(dependencies = {}) {
         .option("--no-update-check", "Skip the npm latest-version check");
     // Run the npm update-check once per invocation, before the matched action.
     // It is non-fatal: a failed check never blocks the action from running.
-    program.hook("preAction", async () => {
+    program.hook("preAction", async (_thisCommand, actionCommand) => {
+        if (["doctor", "update", "version"].includes(actionCommand.name())) {
+            return;
+        }
         if (program.opts().updateCheck === false) {
             return;
         }
@@ -61,6 +106,13 @@ export function createProgram(dependencies = {}) {
         .argument("[destination]", "Project name or path (default: ./<type>-app)")).action(async (destination, options) => {
         await deps.runSetupProject(destination, options);
     });
+    addSharedOptions(program
+        .command("setup-wiki")
+        .description("Prepare an existing project for embedded Lisa wiki setup")
+        .argument("[path]", "Project path (default: current directory)")).action(async (destination, options) => {
+        await deps.runSetupWiki(destination, options);
+    });
+    addMaintenanceCommands(program, deps);
     return program;
 }
 export { createPrompter } from "./prompts.js";

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAkBjD,MAAM,oBAAoB,GAAwB;IAChD,QAAQ;IACR,eAAe;IACf,cAAc;IACd,kBAAkB;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,eAA6C,EAAE;IAE/C,MAAM,IAAI,GAAwB;QAChC,GAAG,oBAAoB;QACvB,GAAG,YAAY;KAChB,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CACV,0FAA0F,CAC3F;SACA,OAAO,CAAC,iBAAiB,EAAE,CAAC;SAC5B,MAAM,CAAC,mBAAmB,EAAE,mCAAmC,CAAC,CAAC;IAEpE,2EAA2E;IAC3E,wEAAwE;IACxE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;QACnC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,4EAA4E;IAC5E,8EAA8E;IAC9E,0EAA0E;IAC1E,uEAAuE;IACvE,gBAAgB,CACd,OAAO;SACJ,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SACrC,WAAW,CAAC,0DAA0D,CAAC;SACvE,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC,CAC9D,CAAC,MAAM,CAAC,KAAK,EAAE,WAA+B,EAAE,OAAmB,EAAE,EAAE;QACtE,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,gBAAgB,CACd,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,uDAAuD,CAAC;SACpE,cAAc,CACb,eAAe,EACf,iBAAiB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAC3C;SACA,QAAQ,CAAC,eAAe,EAAE,8CAA8C,CAAC,CAC7E,CAAC,MAAM,CACN,KAAK,EACH,WAA+B,EAC/B,OAAuC,EACvC,EAAE;QACF,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC,CACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/setup-wiki.d.ts

@@ -0,0 +1,21 @@
+import { type CLIOptions } from "./shared-options.js";
+/** Options parsed for the setup-wiki command. */
+export type SetupWikiOptions = CLIOptions;
+/** Runtime collaborators for setup-wiki. */
+export interface SetupWikiDependencies {
+    runApply: (destination: string | undefined, options: CLIOptions) => Promise<void>;
+}
+/**
+ * Prepare an existing project for embedded Lisa wiki setup.
+ *
+ * The wiki kernel is delivered through Lisa's plugin and skill overlay, so the
+ * CLI command reuses the normal apply path against the target project. After
+ * apply, the runtime-specific `/setup:wiki` or `$lisa-wiki-setup` command owns
+ * the interactive wiki scaffold/repair workflow.
+ * @param destination - Optional project path, defaults to the current directory
+ * @param options - Parsed shared Lisa options
+ * @param dependencies - Injectable collaborators
+ * @returns Promise that resolves after Lisa apply completes
+ */
+export declare function runSetupWiki(destination: string | undefined, options: SetupWikiOptions, dependencies?: SetupWikiDependencies): Promise<void>;
+//# sourceMappingURL=setup-wiki.d.ts.map

package/dist/cli/setup-wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wiki.d.ts","sourceRoot":"","sources":["../../src/cli/setup-wiki.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE1C,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CACR,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,UAAU,KAChB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,gBAAgB,EACzB,YAAY,GAAE,qBAA4C,GACzD,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/cli/setup-wiki.js

@@ -0,0 +1,20 @@
+import { runApply } from "./apply.js";
+const DEFAULT_DEPENDENCIES = {
+    runApply,
+};
+/**
+ * Prepare an existing project for embedded Lisa wiki setup.
+ *
+ * The wiki kernel is delivered through Lisa's plugin and skill overlay, so the
+ * CLI command reuses the normal apply path against the target project. After
+ * apply, the runtime-specific `/setup:wiki` or `$lisa-wiki-setup` command owns
+ * the interactive wiki scaffold/repair workflow.
+ * @param destination - Optional project path, defaults to the current directory
+ * @param options - Parsed shared Lisa options
+ * @param dependencies - Injectable collaborators
+ * @returns Promise that resolves after Lisa apply completes
+ */
+export async function runSetupWiki(destination, options, dependencies = DEFAULT_DEPENDENCIES) {
+    await dependencies.runApply(destination ?? ".", options);
+}
+//# sourceMappingURL=setup-wiki.js.map

package/dist/cli/setup-wiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wiki.js","sourceRoot":"","sources":["../../src/cli/setup-wiki.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatC,MAAM,oBAAoB,GAA0B;IAClD,QAAQ;CACT,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAA+B,EAC/B,OAAyB,EACzB,eAAsC,oBAAoB;IAE1D,MAAM,YAAY,CAAC,QAAQ,CAAC,WAAW,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/cli/update-cmd.d.ts

@@ -0,0 +1,39 @@
+import { spawn } from "node:child_process";
+/** Options parsed for `lisa update`. */
+export interface UpdateCommandOptions {
+    yes?: boolean;
+}
+/** Runtime collaborators for the update command. */
+export interface UpdateCommandDependencies {
+    /** Current working directory. */
+    cwd: string;
+    /** Environment map used for package-manager detection. */
+    env: NodeJS.ProcessEnv;
+    /** Spawn implementation used when --yes is passed. */
+    spawn: typeof spawn;
+    /** Write user-facing output. */
+    write: (message: string) => void;
+}
+/**
+ * Detect the preferred package manager from the user agent or lockfiles.
+ * @param deps - Runtime dependencies
+ * @returns Package manager command
+ */
+export declare function detectPackageManager(deps: Pick<UpdateCommandDependencies, "cwd" | "env">): "npm" | "pnpm" | "yarn" | "bun";
+/**
+ * Compose the global Lisa update command for a package manager.
+ * @param packageManager - Detected package manager
+ * @returns Command and arguments ready for spawn
+ */
+export declare function getUpdateCommand(packageManager: string): {
+    command: string;
+    args: string[];
+};
+/**
+ * Run `lisa update`.
+ * @param options - Parsed command options
+ * @param dependencies - Optional collaborators for tests
+ * @returns Child exit code when --yes runs, otherwise 0
+ */
+export declare function runUpdate(options: UpdateCommandOptions, dependencies?: Partial<UpdateCommandDependencies>): Promise<number>;
+//# sourceMappingURL=update-cmd.d.ts.map

package/dist/cli/update-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/update-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,sDAAsD;IACtD,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,gCAAgC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAmBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,KAAK,GAAG,KAAK,CAAC,GACnD,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CA0BjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAoBA;AAqBD;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,oBAAoB,EAC7B,YAAY,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACpD,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/cli/update-cmd.js

@@ -0,0 +1,105 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+const LISA_LATEST_PACKAGE = "@codyswann/lisa@latest";
+const DEFAULT_DEPENDENCIES = {
+    cwd: process.cwd(),
+    env: getProcessEnv(),
+    spawn,
+    write: message => console.log(message),
+};
+/**
+ * Read process.env through one explicit, reviewable exception to the app-template
+ * env rule. The CLI needs externally supplied package-manager metadata.
+ * @returns Current process environment
+ */
+function getProcessEnv() {
+    // eslint-disable-next-line no-restricted-syntax -- CLI package-manager detection must read externally supplied process env once
+    return process.env;
+}
+/**
+ * Detect the preferred package manager from the user agent or lockfiles.
+ * @param deps - Runtime dependencies
+ * @returns Package manager command
+ */
+export function detectPackageManager(deps) {
+    const userAgent = deps.env.npm_config_user_agent ?? "";
+    if (userAgent.startsWith("pnpm")) {
+        return "pnpm";
+    }
+    if (userAgent.startsWith("yarn")) {
+        return "yarn";
+    }
+    if (userAgent.startsWith("bun")) {
+        return "bun";
+    }
+    if (userAgent.startsWith("npm")) {
+        return "npm";
+    }
+    if (existsSync(path.join(deps.cwd, "bun.lockb"))) {
+        return "bun";
+    }
+    if (existsSync(path.join(deps.cwd, "pnpm-lock.yaml"))) {
+        return "pnpm";
+    }
+    if (existsSync(path.join(deps.cwd, "yarn.lock"))) {
+        return "yarn";
+    }
+    return "npm";
+}
+/**
+ * Compose the global Lisa update command for a package manager.
+ * @param packageManager - Detected package manager
+ * @returns Command and arguments ready for spawn
+ */
+export function getUpdateCommand(packageManager) {
+    switch (packageManager) {
+        case "bun":
+            return { command: "bun", args: ["add", "-g", LISA_LATEST_PACKAGE] };
+        case "pnpm":
+            return {
+                command: "pnpm",
+                args: ["add", "-g", LISA_LATEST_PACKAGE],
+            };
+        case "yarn":
+            return {
+                command: "yarn",
+                args: ["global", "add", LISA_LATEST_PACKAGE],
+            };
+        default:
+            return {
+                command: "npm",
+                args: ["install", "-g", LISA_LATEST_PACKAGE],
+            };
+    }
+}
+/**
+ * Execute a child command and resolve to its exit code.
+ * @param deps - Runtime dependencies
+ * @param command - Executable name
+ * @param args - Command arguments
+ * @returns Child process exit code
+ */
+async function runSpawn(deps, command, args) {
+    return await new Promise((resolve, reject) => {
+        const child = deps.spawn(command, args, { stdio: "inherit" });
+        child.once("error", reject);
+        child.once("exit", code => resolve(code ?? 1));
+    });
+}
+/**
+ * Run `lisa update`.
+ * @param options - Parsed command options
+ * @param dependencies - Optional collaborators for tests
+ * @returns Child exit code when --yes runs, otherwise 0
+ */
+export async function runUpdate(options, dependencies = {}) {
+    const deps = { ...DEFAULT_DEPENDENCIES, ...dependencies };
+    const updateCommand = getUpdateCommand(detectPackageManager(deps));
+    deps.write([updateCommand.command, ...updateCommand.args].join(" "));
+    if (!options.yes) {
+        return 0;
+    }
+    return await runSpawn(deps, updateCommand.command, updateCommand.args);
+}
+//# sourceMappingURL=update-cmd.js.map

package/dist/cli/update-cmd.js.map

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