@cr8rcho/alkahest 0.1.1

package/dist/cli.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { Command } from "commander";
+import { scan } from "./commands/scan.js";
+import { view } from "./commands/view.js";
+import { mcp } from "./commands/mcp.js";
+import { hook } from "./commands/hook.js";
+import { publish } from "./commands/publish.js";
+import { login } from "./commands/login.js";
+import { update } from "./commands/update.js";
+import { maybeNotifyUpdate } from "./core/version.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+const program = new Command();
+program
+    .name("alkahest")
+    .description("Screen-graph CLI that reverse-engineers a product from code (static analysis → product map)")
+    .version(pkg.version);
+program
+    .command("scan")
+    .description("Analyze a project → .alkahest/map.json + index.html (incremental by default)")
+    .argument("[path]", "project path to analyze", ".")
+    .option("--full", "ignore the baseline and rescan everything", false)
+    .option("--open", "open the dashboard right after scanning", false)
+    .action(async (path, opts) => {
+    await scan(path, opts);
+    await maybeNotifyUpdate();
+});
+program
+    .command("view")
+    .description("open the .alkahest/ dashboard via a local server")
+    .argument("[path]", "project path", ".")
+    .action((path) => view(path));
+program
+    .command("login")
+    .description("save your personal publish token (from the web app) so 'publish' can authenticate")
+    .option("--token <token>", "alk_… token from the web app (Account → Create token)")
+    .option("--api <url>", "API base URL (or env ALKAHEST_API_URL)")
+    .action((opts) => login(opts));
+program
+    .command("publish")
+    .description("upload .alkahest/map.json to the hosted viewer → shareable link (no login to view)")
+    .argument("[path]", "project path", ".")
+    .option("--api <url>", "API base URL (or env ALKAHEST_API_URL)")
+    .option("--name <name>", "project name (first publish only)")
+    .action(async (path, opts) => {
+    await publish(path, opts);
+    await maybeNotifyUpdate();
+});
+program
+    .command("mcp")
+    .description("run the MCP server over stdio (agents query the product map; no key)")
+    .action(() => mcp());
+program
+    .command("hook")
+    .description("install/remove git hooks — run scan on commit/merge (diff-driven refresh)")
+    .argument("<action>", "install | uninstall")
+    .action((action) => hook(action));
+program
+    .command("update")
+    .description("update alkahest to the latest GitHub release (--check: only report)")
+    .option("--check", "only report current vs latest, don't change anything", false)
+    .action((opts) => update(opts));
+program.parseAsync().catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/hook.d.ts

@@ -0,0 +1 @@
+export declare function hook(action: string): Promise<void>;

package/dist/commands/hook.js

@@ -0,0 +1,64 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+/**
+ * Install/remove a git hook that auto-refreshes the product map on diffs (ALKAHEST.md §10).
+ * Incremental logic lives in `scan`; this hook only triggers it — the two are separate.
+ */
+const HOOKS = ["post-commit", "post-merge"];
+const START = "# >>> alkahest >>>";
+const END = "# <<< alkahest <<<";
+const BLOCK = `${START}\n` +
+    `# Auto-refresh the product map on diffs (ALKAHEST.md §10). Remove: alkahest hook uninstall\n` +
+    `alkahest scan >/dev/null 2>&1 || npx --no-install alkahest scan >/dev/null 2>&1 || true\n` +
+    `${END}\n`;
+export async function hook(action) {
+    const root = resolve(".");
+    const gitPath = join(root, ".git");
+    if (!existsSync(gitPath)) {
+        console.log("[alkahest] not a git repository (no .git).");
+        return;
+    }
+    if (!statSync(gitPath).isDirectory()) {
+        console.log("[alkahest] .git is a file (worktree/submodule) — install the hook manually.");
+        return;
+    }
+    const hooksDir = join(gitPath, "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    if (action === "install") {
+        for (const h of HOOKS)
+            installOne(join(hooksDir, h));
+        console.log(`[alkahest] git hooks installed: ${HOOKS.join(", ")} → runs 'alkahest scan' (incremental) on commit/merge`);
+    }
+    else if (action === "uninstall") {
+        for (const h of HOOKS)
+            uninstallOne(join(hooksDir, h));
+        console.log(`[alkahest] git hooks removed: ${HOOKS.join(", ")}`);
+    }
+    else {
+        console.log("usage: alkahest hook <install|uninstall>");
+    }
+}
+function installOne(file) {
+    let content = existsSync(file) ? readFileSync(file, "utf8") : "#!/bin/sh\n";
+    if (content.includes(START))
+        return; // already installed (idempotent)
+    if (!content.startsWith("#!"))
+        content = "#!/bin/sh\n" + content;
+    if (!content.endsWith("\n"))
+        content += "\n";
+    writeFileSync(file, content + "\n" + BLOCK);
+    chmodSync(file, 0o755);
+}
+function uninstallOne(file) {
+    if (!existsSync(file))
+        return;
+    const content = readFileSync(file, "utf8");
+    const re = new RegExp(`\\n?${escapeRe(START)}[\\s\\S]*?${escapeRe(END)}\\n?`, "g");
+    const next = content.replace(re, "\n");
+    if (next !== content)
+        writeFileSync(file, next);
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=hook.js.map

package/dist/commands/hook.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Save a personal publish token so `alkahest publish` can authenticate as you.
+ * Get the token from the web app (Account → Create token) after signing in with GitHub.
+ */
+export interface LoginOptions {
+    /** The alk_… token from the web app. If omitted, we print instructions. */
+    token?: string;
+    /** API base URL (or env ALKAHEST_API_URL). */
+    api?: string;
+}
+export declare function login(options: LoginOptions): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,27 @@
+import { loadCredentials, resolveApiUrl, saveCredentials } from "../core/credentials.js";
+export async function login(options) {
+    const creds = loadCredentials();
+    const apiUrl = resolveApiUrl(options.api, creds);
+    if (!options.token) {
+        console.log("[alkahest] login — paste a token from the web app:");
+        console.log("  1. Open the Alkahest web app and sign in with GitHub");
+        console.log("  2. Account → Create token, copy the alk_… value");
+        console.log("  3. Run: alkahest login --token alk_xxxxx" + (apiUrl ? "" : " --api <url>"));
+        process.exitCode = 1;
+        return;
+    }
+    if (!options.token.startsWith("alk_")) {
+        console.error("[alkahest] that doesn't look like a token (expected alk_…).");
+        process.exitCode = 1;
+        return;
+    }
+    creds.token = options.token;
+    if (apiUrl)
+        creds.apiUrl = apiUrl;
+    saveCredentials(creds);
+    console.log("[alkahest] logged in. Token saved to ~/.alkahest/credentials.json");
+    if (!apiUrl) {
+        console.log("  note: no API URL set — pass --api <url> or set ALKAHEST_API_URL before publishing.");
+    }
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAazF,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAqB;IAC/C,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEjD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,4CAA4C,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QAC3F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,MAAM;QAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IAClC,eAAe,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACjF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,sFAAsF,CAAC,CAAC;IACtG,CAAC;AACH,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Run the Alkahest MCP server over stdio (ALKAHEST.md §7, agent mode).
+ * Connect from an agent's MCP config via `command: "alkahest", args: ["mcp"]`.
+ * stdout is reserved for JSON-RPC, so never console.log here.
+ */
+export declare function mcp(): Promise<void>;

package/dist/commands/mcp.js

@@ -0,0 +1,13 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { buildServer } from "../mcp/server.js";
+/**
+ * Run the Alkahest MCP server over stdio (ALKAHEST.md §7, agent mode).
+ * Connect from an agent's MCP config via `command: "alkahest", args: ["mcp"]`.
+ * stdout is reserved for JSON-RPC, so never console.log here.
+ */
+export async function mcp() {
+    const server = buildServer();
+    await server.connect(new StdioServerTransport());
+    // After connecting, the process stays alive while stdio is open.
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,iEAAiE;AACnE,CAAC"}

package/dist/commands/publish.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Upload `<projectRoot>/.alkahest/map.json` to the hosted viewer so non-developers
+ * can open the product map at a shareable link — no install, no login to view.
+ * Only map.json is uploaded; source code never leaves the machine.
+ *
+ * Auth is a personal token from `alkahest login` (or the ALKAHEST_TOKEN env).
+ * First publish of a project auto-creates it under your account; the returned slug
+ * is remembered per project path so later publishes update the same link.
+ *
+ * The actual work lives in core/publish.ts (shared with the MCP `publish` tool); this
+ * command only maps the result to console output and an exit code.
+ */
+export interface PublishOptions {
+    /** API base URL (or env ALKAHEST_API_URL). */
+    api?: string;
+    /** Project name shown in the URL/dashboard (first publish only; defaults to folder name). */
+    name?: string;
+}
+export declare function publish(path: string, options: PublishOptions): Promise<void>;

package/dist/commands/publish.js

@@ -0,0 +1,27 @@
+import { publishMap } from "../core/publish.js";
+export async function publish(path, options) {
+    const res = await publishMap(path, { ...options, source: "cli" });
+    if (!res.ok) {
+        if (res.code === "no_map") {
+            console.error(`[alkahest] no .alkahest/map.json found — run 'alkahest scan' first.`);
+        }
+        else if (res.code === "plan_limit") {
+            console.error(`[alkahest] ✗ Publish blocked — ${res.message}`);
+            console.error("  Upgrade to Pro, or 'alkahest view' still works locally for free.");
+        }
+        else if (res.code === "invalid_token") {
+            console.error("[alkahest] ✗ Token invalid or revoked. Run 'alkahest login' again.");
+        }
+        else if (res.code === "client_too_old") {
+            console.error(`[alkahest] ✗ ${res.message}`);
+        }
+        else {
+            console.error(`[alkahest] publish failed: ${res.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`[alkahest] published ${res.slug}`);
+    console.log(`  → ${res.viewerUrl ?? res.mapUrl}`);
+}
+//# sourceMappingURL=publish.js.map

package/dist/commands/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAqBhD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,OAAuB;IACjE,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACvF,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACtF,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACtF,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,8BAA8B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/commands/scan.d.ts

@@ -0,0 +1,11 @@
+export interface ScanOptions {
+    /** Ignore the baseline and rescan everything (ALKAHEST.md §10) */
+    full: boolean;
+    /** Open the dashboard right after scanning */
+    open: boolean;
+}
+/**
+ * Analyze → `.alkahest/map.json` + `index.html` (ALKAHEST.md §4).
+ * The core pipeline lives in runScan; this only adds logging and open.
+ */
+export declare function scan(path: string, options: ScanOptions): Promise<void>;

package/dist/commands/scan.js

@@ -0,0 +1,29 @@
+import { relative, resolve } from "node:path";
+import { runScan } from "../core/pipeline.js";
+import { serveDashboard } from "../core/serve.js";
+/**
+ * Analyze → `.alkahest/map.json` + `index.html` (ALKAHEST.md §4).
+ * The core pipeline lives in runScan; this only adds logging and open.
+ */
+export async function scan(path, options) {
+    const projectRoot = resolve(path);
+    const result = runScan(projectRoot, { full: options.full });
+    if (!result) {
+        console.log(`[alkahest] ${projectRoot}: no screens found.`);
+        console.log("  └─ Phase 1 supports only Next app-router (page.* under app/ or src/app/).");
+        return;
+    }
+    const { map, outFile, stats } = result;
+    console.log(`[alkahest] scan: ${projectRoot}`);
+    const mode = stats.incremental ? `incremental (reused ${stats.reused} / reparsed ${stats.reparsed})` : "full";
+    console.log(`  framework=${map.meta.framework} router=${map.meta.router} screens=${map.screens.length} · ${mode}`);
+    const unresolvedNav = map.transitions.filter((t) => t.to === null).length;
+    const unresolvedCall = map.calls.filter((c) => c.to === null).length;
+    console.log(`  → ${relative(projectRoot, outFile) || outFile} (+ index.html)`);
+    console.log(`  screens=${map.screens.length} resources=${map.resources.length} ` +
+        `transitions=${map.transitions.length}(unresolved ${unresolvedNav}) ` +
+        `calls=${map.calls.length}(unresolved ${unresolvedCall})`);
+    if (options.open)
+        await serveDashboard(projectRoot);
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASlD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAY,EAAE,OAAoB;IAC3D,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,qBAAqB,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,uBAAuB,KAAK,CAAC,MAAM,eAAe,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9G,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,SAAS,WAAW,GAAG,CAAC,IAAI,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAEnH,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IAC1E,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,OAAO,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,OAAO,iBAAiB,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CACT,aAAa,GAAG,CAAC,OAAO,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG;QAClE,eAAe,GAAG,CAAC,WAAW,CAAC,MAAM,eAAe,aAAa,IAAI;QACrE,SAAS,GAAG,CAAC,KAAK,CAAC,MAAM,eAAe,cAAc,GAAG,CAC5D,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI;QAAE,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC"}

package/dist/commands/update.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Update the installed alkahest to the latest version.
+ *
+ * Version source is GitHub Releases (no npm) — see core/version.ts. The update mechanism
+ * adapts to the install:
+ *  - git checkout (`git clone` + `npm link`): `git pull` + reinstall in place (`npm install`
+ *    re-runs the `prepare` build), so the linked `alkahest` updates.
+ *  - anything else (e.g. `npm i -g github:…`, which strips .git): print the reinstall command.
+ *
+ * `--check` only reports current-vs-latest and changes nothing.
+ */
+export interface UpdateOptions {
+    check?: boolean;
+}
+export declare function update(options?: UpdateOptions): Promise<void>;

package/dist/commands/update.js

@@ -0,0 +1,41 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { checkForUpdate, repoSlug } from "../core/version.js";
+export async function update(options = {}) {
+    const require = createRequire(import.meta.url);
+    const pkgRoot = dirname(require.resolve("../../package.json"));
+    const { current, latest, behind } = await checkForUpdate();
+    console.log(`[alkahest] current version ${current}`);
+    if (latest && !behind) {
+        console.log(`[alkahest] already up to date (latest release ${latest}).`);
+        return;
+    }
+    if (latest)
+        console.log(`[alkahest] update available: ${current} → ${latest}`);
+    else
+        console.log(`[alkahest] (no published GitHub release to compare against — will pull latest source.)`);
+    if (options.check)
+        return; // report-only
+    if (!existsSync(join(pkgRoot, ".git"))) {
+        console.log("[alkahest] this install isn't a git checkout — update by reinstalling:");
+        console.log(`  npm install -g github:${repoSlug()}`);
+        return;
+    }
+    const run = (cmd, args) => execFileSync(cmd, args, { cwd: pkgRoot, stdio: "inherit" });
+    try {
+        console.log("[alkahest] git pull…");
+        run("git", ["pull", "--ff-only"]);
+        console.log("[alkahest] npm install (rebuilds via prepare)…");
+        run("npm", ["install"]);
+    }
+    catch (err) {
+        console.error("[alkahest] update failed: " + (err instanceof Error ? err.message : String(err)));
+        console.error(`  resolve it by hand in ${pkgRoot} (e.g. check 'git status'), then re-run.`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log("[alkahest] done — restart the MCP server / reopen your tools to pick up the new version.");
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAiB9D,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,UAAyB,EAAE;IACtD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAE/D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;IACrD,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,iDAAiD,MAAM,IAAI,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IACD,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC,OAAO,MAAM,MAAM,EAAE,CAAC,CAAC;;QAC1E,OAAO,CAAC,GAAG,CAAC,wFAAwF,CAAC,CAAC;IAE3G,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,cAAc;IAEzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACzG,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,0CAA0C,CAAC,CAAC;QAC5F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,0FAA0F,CAAC,CAAC;AAC1G,CAAC"}

package/dist/commands/view.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Serve the `.alkahest/` dashboard over a local server to explore the
+ * screen-flow / call graph (ALKAHEST.md §5). Regenerates index.html from
+ * map.json each time so the latest template is applied.
+ */
+export declare function view(path: string): Promise<void>;

package/dist/commands/view.js

@@ -0,0 +1,21 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { emitDashboard, OUTPUT_DIR } from "../core/emit.js";
+import { serveDashboard } from "../core/serve.js";
+/**
+ * Serve the `.alkahest/` dashboard over a local server to explore the
+ * screen-flow / call graph (ALKAHEST.md §5). Regenerates index.html from
+ * map.json each time so the latest template is applied.
+ */
+export async function view(path) {
+    const projectRoot = resolve(path);
+    const mapPath = join(projectRoot, OUTPUT_DIR, "map.json");
+    if (!existsSync(mapPath)) {
+        console.log(`[alkahest] ${mapPath} not found — run 'alkahest scan' first.`);
+        return;
+    }
+    const map = JSON.parse(readFileSync(mapPath, "utf8"));
+    emitDashboard(projectRoot, map);
+    await serveDashboard(projectRoot);
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/commands/view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAY;IACrC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,yCAAyC,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAe,CAAC;IACpE,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAChC,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/dist/core/adapters/angular.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkAdapter } from "./types.js";
+export declare const angularAdapter: FrameworkAdapter;