@cr8rcho/alkahest 0.1.1

package/dist/core/pipeline.js

@@ -0,0 +1,122 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { createRequire } from "node:module";
+import { selectAdapter } from "./adapters/index.js";
+import { buildMap, screenFromRaw, resolveTransitions, resolveContains, resolveCalls, assembleMap, isExternalUrl, } from "./resolve.js";
+import { emitMap, emitDashboard, OUTPUT_DIR } from "./emit.js";
+import { hashContent } from "./hash.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../../package.json");
+/**
+ * Core pipeline detect→discover→parse→resolve→emit (no console output).
+ * Framework is auto-selected via adapters (ALKAHEST.md §8). Incremental by default (§10).
+ * Null if no screens are found. Shared by the CLI (scan) and the MCP server.
+ */
+export function runScan(projectRoot, options = {}) {
+    const adapter = selectAdapter(projectRoot);
+    if (!adapter)
+        return null;
+    const files = adapter.discover(projectRoot);
+    if (!files.length)
+        return null;
+    const hashes = new Map();
+    for (const file of files)
+        hashes.set(file.relPath, hashContent(readFileSync(file.absPath, "utf8")));
+    const prev = options.full ? null : loadMap(projectRoot);
+    const result = prev
+        ? incrementalBuild(adapter, files, hashes, prev, projectRoot)
+        : fullBuild(adapter, files, hashes, projectRoot);
+    const outFile = emitMap(projectRoot, result.map);
+    emitDashboard(projectRoot, result.map);
+    return { ...result, outFile };
+}
+function fullBuild(adapter, files, hashes, projectRoot) {
+    const parsed = new Map();
+    for (const file of files)
+        parsed.set(file.relPath, adapter.parse(file));
+    const map = buildMap({
+        files,
+        parsed,
+        hashes,
+        framework: adapter.id,
+        router: adapter.router,
+        projectRoot,
+        scannedAt: new Date().toISOString(),
+        alkahestVersion: pkg.version,
+    });
+    return { map, stats: { reused: 0, reparsed: map.screens.length, total: map.screens.length, incremental: false } };
+}
+function incrementalBuild(adapter, files, hashes, prev, projectRoot) {
+    const screenIds = new Set(files.map((f) => f.id));
+    const prevScreenByFile = new Map(prev.screens.map((s) => [s.sourceFile, s]));
+    const prevResById = new Map(prev.resources.map((r) => [r.id, r]));
+    const screens = [];
+    const transitions = [];
+    const calls = [];
+    const resources = new Map();
+    let reused = 0;
+    let reparsed = 0;
+    for (const file of files) {
+        const prevScreen = prevScreenByFile.get(file.relPath);
+        const unchanged = prevScreen && prev.meta.fileHashes[file.relPath] === hashes.get(file.relPath);
+        if (unchanged) {
+            reused++;
+            screens.push(prevScreen); // preserve as-is, including summary
+            transitions.push(...prev.transitions.filter((t) => t.loc.file === file.relPath));
+            for (const c of prev.calls.filter((c) => c.loc.file === file.relPath)) {
+                calls.push(c);
+                if (c.to) {
+                    const r = prevResById.get(c.to);
+                    if (r && !resources.has(r.id))
+                        resources.set(r.id, r);
+                }
+            }
+        }
+        else {
+            reparsed++;
+            const raw = adapter.parse(file);
+            screens.push(screenFromRaw(file, hashes.get(file.relPath) ?? "", raw));
+            const navTrans = resolveTransitions(file.id, raw.navs, screenIds, file.relPath);
+            transitions.push(...navTrans);
+            transitions.push(...resolveContains(file.id, raw.contains, screenIds, navTrans, file.relPath));
+            calls.push(...resolveCalls(file.id, raw.calls, file.relPath, resources));
+        }
+    }
+    // Re-resolve reused edges against the new screen set: internal transitions pointing to a vanished screen become unresolved.
+    for (const t of transitions) {
+        if (t.to && !isExternalUrl(t.to) && !screenIds.has(t.to)) {
+            t.rawTarget = t.rawTarget ?? t.to;
+            t.to = null;
+        }
+    }
+    const map = assembleMap({
+        screens,
+        transitions,
+        calls,
+        resources: [...resources.values()],
+        hashes,
+        framework: adapter.id,
+        router: adapter.router,
+        projectRoot,
+        scannedAt: new Date().toISOString(),
+        alkahestVersion: pkg.version,
+    });
+    return { map, stats: { reused, reparsed, total: screens.length, incremental: true } };
+}
+/** Reads an existing `.alkahest/map.json` (null if absent). */
+export function loadMap(projectRoot) {
+    const file = join(projectRoot, OUTPUT_DIR, "map.json");
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** Reads map.json if present, otherwise scans on the fly. Null if both fail. */
+export function loadOrScan(projectRoot) {
+    return loadMap(projectRoot) ?? runScan(projectRoot)?.map ?? null;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

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

package/dist/core/publish.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared publish logic used by both the `alkahest publish` CLI command and the MCP
+ * `publish` tool. Uploads `<projectRoot>/.alkahest/map.json` to the hosted viewer.
+ * Only map.json is sent; source code never leaves the machine.
+ *
+ * This returns a structured result and never writes to stdout/stderr — the MCP server
+ * reserves stdout for JSON-RPC, so callers (CLI) own all user-facing output.
+ */
+export interface PublishParams {
+    /** API base URL (else env ALKAHEST_API_URL / saved creds). */
+    api?: string;
+    /** Project name shown in the URL/dashboard (first publish only; defaults to folder name). */
+    name?: string;
+    /** Publish token (else env ALKAHEST_TOKEN / saved creds). */
+    token?: string;
+    /** Which surface initiated this — sent to the server for version/compat handling. */
+    source?: "cli" | "mcp";
+}
+export interface PublishResult {
+    ok: boolean;
+    slug?: string;
+    viewerUrl?: string | null;
+    mapUrl?: string;
+    /** Whether this was the project's first publish (a new slug was created). */
+    created?: boolean;
+    /** Machine-readable failure code: no_map | no_api | no_token | network | <server error>. */
+    code?: string;
+    /** Human-readable failure message. */
+    message?: string;
+}
+export declare function publishMap(path: string, params?: PublishParams): Promise<PublishResult>;

package/dist/core/publish.js

@@ -0,0 +1,87 @@
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { createRequire } from "node:module";
+import { OUTPUT_DIR } from "./emit.js";
+import { loadCredentials, resolveApiUrl, resolveToken, saveCredentials } from "./credentials.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../../package.json");
+async function postJson(url, body, token) {
+    let res;
+    try {
+        res = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ok: false, status: "network", body: { error: `could not reach ${url} (${msg})` } };
+    }
+    let parsed = null;
+    try {
+        parsed = await res.json();
+    }
+    catch {
+        /* non-JSON error body */
+    }
+    return { ok: res.ok, status: String(res.status), body: parsed };
+}
+export async function publishMap(path, params = {}) {
+    const projectRoot = resolve(path);
+    const mapFile = join(projectRoot, OUTPUT_DIR, "map.json");
+    if (!existsSync(mapFile)) {
+        return { ok: false, code: "no_map", message: `No ${OUTPUT_DIR}/map.json found — run scan first.` };
+    }
+    const map = JSON.parse(readFileSync(mapFile, "utf8"));
+    const creds = loadCredentials();
+    const apiUrl = resolveApiUrl(params.api, creds);
+    if (!apiUrl) {
+        return {
+            ok: false,
+            code: "no_api",
+            message: "Missing API URL. Set ALKAHEST_API_URL (or pass --api / run 'alkahest login --api <url>').",
+        };
+    }
+    const token = resolveToken(params.token, creds);
+    if (!token) {
+        return {
+            ok: false,
+            code: "no_token",
+            message: "Not authenticated. Set ALKAHEST_TOKEN (or run 'alkahest login --token alk_…').",
+        };
+    }
+    // Known project → send its slug (update). New project → omit slug (server creates it).
+    const known = creds.projects?.[projectRoot];
+    const reqBody = {
+        map,
+        client: { source: params.source ?? "cli", version: pkg.version },
+    };
+    if (known)
+        reqBody.slug = known.slug;
+    else
+        reqBody.name = params.name || basename(projectRoot);
+    const pub = await postJson(`${apiUrl}/publish`, reqBody, token);
+    if (!pub.ok) {
+        return {
+            ok: false,
+            code: pub.body?.error ?? "http",
+            message: pub.body?.message ?? pub.body?.error ?? `publish failed (${pub.status})`,
+        };
+    }
+    // Remember the slug for this project path so future publishes update the same link.
+    const created = !known && Boolean(pub.body.slug);
+    if (created) {
+        creds.projects = creds.projects ?? {};
+        creds.projects[projectRoot] = { slug: pub.body.slug };
+        saveCredentials(creds);
+    }
+    return {
+        ok: true,
+        slug: pub.body.slug,
+        viewerUrl: pub.body.viewerUrl ?? null,
+        mapUrl: pub.body.mapUrl,
+        created,
+    };
+}
+//# sourceMappingURL=publish.js.map

package/dist/core/publish.js.map

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

package/dist/core/resolve.d.ts

@@ -0,0 +1,42 @@
+import type { ProductMap, Screen, Resource, Transition, Call, Framework, Router } from "./types.js";
+import type { ScreenFile, RawScreen, RawNav, RawCall } from "./adapters/types.js";
+export interface ResolveInput {
+    files: ScreenFile[];
+    /** key = ScreenFile.relPath */
+    parsed: Map<string, RawScreen>;
+    /** key = ScreenFile.relPath → content hash */
+    hashes: Map<string, string>;
+    framework: Framework;
+    router: Router;
+    projectRoot: string;
+    scannedAt: string;
+    alkahestVersion: string;
+}
+/** Raw signals (parse) → 2-layer ProductMap (full build, ALKAHEST.md §3). Adapter-agnostic. */
+export declare function buildMap(input: ResolveInput): ProductMap;
+/** One screen file's raw signals → Screen node (excluding edges). title/id use the values the adapter assigned. */
+export declare function screenFromRaw(file: ScreenFile, hash: string, raw: RawScreen): Screen;
+/** A screen's navs → Transition[] (resolved against the set of screen ids). */
+export declare function resolveTransitions(from: string, navs: RawNav[], screenIds: Set<string>, file: string): Transition[];
+/**
+ * Child screens a screen instantiates → "contains" edges (structural flow, for identifying the start point).
+ * Only contains candidates that are real screens (screenIds); excludes itself and any already linked via nav.
+ */
+export declare function resolveContains(from: string, candidates: string[], screenIds: Set<string>, existingNav: Transition[], file: string): Transition[];
+/** A screen's calls → Call[]. Loads discovered Resources into resourceMap, deduplicated. */
+export declare function resolveCalls(from: string, raw: RawCall[], file: string, resourceMap: Map<string, Resource>): Call[];
+export declare function isExternalUrl(s: string): boolean;
+export interface AssembleInput {
+    screens: Screen[];
+    transitions: Transition[];
+    calls: Call[];
+    resources: Resource[];
+    hashes: Map<string, string>;
+    framework: Framework;
+    router: Router;
+    projectRoot: string;
+    scannedAt: string;
+    alkahestVersion: string;
+}
+/** Nodes/edges/resources → final ProductMap (fills meta, sorts resources). */
+export declare function assembleMap(a: AssembleInput): ProductMap;

package/dist/core/resolve.js

@@ -0,0 +1,128 @@
+/** Raw signals (parse) → 2-layer ProductMap (full build, ALKAHEST.md §3). Adapter-agnostic. */
+export function buildMap(input) {
+    const { files, parsed, hashes } = input;
+    const screenIds = new Set(files.map((f) => f.id));
+    const screens = [];
+    const transitions = [];
+    const calls = [];
+    const resources = new Map();
+    for (const file of files) {
+        const raw = parsed.get(file.relPath);
+        if (!raw)
+            continue;
+        screens.push(screenFromRaw(file, hashes.get(file.relPath) ?? "", raw));
+        const navTrans = resolveTransitions(file.id, raw.navs, screenIds, file.relPath);
+        transitions.push(...navTrans);
+        // contains: other screens this screen directly instantiates → structural flow (entry point→tabs, etc.). §11
+        transitions.push(...resolveContains(file.id, raw.contains, screenIds, navTrans, file.relPath));
+        calls.push(...resolveCalls(file.id, raw.calls, file.relPath, resources));
+    }
+    return assembleMap({
+        screens,
+        transitions,
+        calls,
+        resources: [...resources.values()],
+        hashes,
+        framework: input.framework,
+        router: input.router,
+        projectRoot: input.projectRoot,
+        scannedAt: input.scannedAt,
+        alkahestVersion: input.alkahestVersion,
+    });
+}
+/** One screen file's raw signals → Screen node (excluding edges). title/id use the values the adapter assigned. */
+export function screenFromRaw(file, hash, raw) {
+    return {
+        id: file.id,
+        route: file.route,
+        sourceFile: file.relPath,
+        sourceHash: hash,
+        title: file.title,
+        summary: "",
+        features: raw.features.map((f) => ({ kind: f.kind, label: f.label, detail: f.detail, loc: { file: file.relPath, line: f.line } })),
+        components: raw.components,
+        isEntry: file.isEntry,
+    };
+}
+/** A screen's navs → Transition[] (resolved against the set of screen ids). */
+export function resolveTransitions(from, navs, screenIds, file) {
+    return navs.map((nav) => resolveTransition(from, nav, screenIds, file));
+}
+/**
+ * Child screens a screen instantiates → "contains" edges (structural flow, for identifying the start point).
+ * Only contains candidates that are real screens (screenIds); excludes itself and any already linked via nav.
+ */
+export function resolveContains(from, candidates, screenIds, existingNav, file) {
+    const navTargets = new Set(existingNav.map((t) => t.to).filter(Boolean));
+    const out = [];
+    const seen = new Set();
+    for (const c of candidates) {
+        if (c === from || !screenIds.has(c) || navTargets.has(c) || seen.has(c))
+            continue;
+        seen.add(c);
+        out.push({ from, to: c, kind: "contains", trigger: "embed", loc: { file, line: 0 } });
+    }
+    return out;
+}
+/** A screen's calls → Call[]. Loads discovered Resources into resourceMap, deduplicated. */
+export function resolveCalls(from, raw, file, resourceMap) {
+    return raw.map((call) => resolveCall(from, call, resourceMap, file));
+}
+export function isExternalUrl(s) {
+    return /^https?:\/\//.test(s);
+}
+/** Nodes/edges/resources → final ProductMap (fills meta, sorts resources). */
+export function assembleMap(a) {
+    return {
+        screens: a.screens,
+        resources: a.resources.sort((x, y) => x.id.localeCompare(y.id)),
+        transitions: a.transitions,
+        calls: a.calls,
+        meta: {
+            framework: a.framework,
+            router: a.router,
+            scannedAt: a.scannedAt,
+            projectRoot: a.projectRoot,
+            fileHashes: Object.fromEntries(a.hashes),
+            alkahestVersion: a.alkahestVersion,
+        },
+    };
+}
+// ---------- internals ----------
+function resolveTransition(from, nav, screenIds, file) {
+    const loc = { file, line: nav.line };
+    const base = { from, kind: "navigate", trigger: nav.trigger, loc };
+    if (nav.target == null) {
+        return { ...base, to: null, rawTarget: nav.raw };
+    }
+    if (isExternalUrl(nav.target)) {
+        return { ...base, to: nav.target.split(/[?#]/)[0] };
+    }
+    const candidates = [nav.target, normalizeRoute(nav.target)];
+    const hit = candidates.find((c) => screenIds.has(c));
+    if (hit)
+        return { ...base, to: hit };
+    return { ...base, to: null, rawTarget: nav.target };
+}
+function normalizeRoute(target) {
+    const clean = target.split(/[?#]/)[0];
+    let route = clean.startsWith("/") ? clean : "/" + clean;
+    if (route.length > 1)
+        route = route.replace(/\/+$/, "");
+    return route;
+}
+function resolveCall(from, call, resources, file) {
+    const loc = { file, line: call.line };
+    if (call.url == null) {
+        return { from, to: null, rawTarget: call.raw, trigger: call.trigger, loc };
+    }
+    const path = call.url.split("#")[0];
+    const external = isExternalUrl(path);
+    const method = (call.method ?? "GET").toUpperCase();
+    const id = `${method} ${path}`;
+    if (!resources.has(id)) {
+        resources.set(id, { id, kind: external ? "external" : "endpoint", label: id, method, path });
+    }
+    return { from, to: id, trigger: call.trigger, loc };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/core/resolve.js.map

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

package/dist/core/serve.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Serves `<projectRoot>/.alkahest` as a local static server and opens the browser.
+ * The server keeps the event loop alive, so the process stays up until Ctrl+C.
+ */
+export declare function serveDashboard(projectRoot: string): Promise<void>;

package/dist/core/serve.js

@@ -0,0 +1,52 @@
+import { createServer } from "node:http";
+import { readFile } from "node:fs/promises";
+import { extname, resolve } from "node:path";
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
+import { OUTPUT_DIR } from "./emit.js";
+const MIME = {
+    ".html": "text/html; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+};
+/**
+ * Serves `<projectRoot>/.alkahest` as a local static server and opens the browser.
+ * The server keeps the event loop alive, so the process stays up until Ctrl+C.
+ */
+export async function serveDashboard(projectRoot) {
+    const root = resolve(projectRoot, OUTPUT_DIR);
+    const server = createServer(async (req, res) => {
+        try {
+            const urlPath = decodeURIComponent((req.url || "/").split("?")[0]);
+            const filePath = resolve(root, "." + (urlPath === "/" ? "/index.html" : urlPath));
+            if (filePath !== root && !filePath.startsWith(root + "/")) {
+                res.writeHead(403).end("Forbidden");
+                return;
+            }
+            const data = await readFile(filePath);
+            res.writeHead(200, { "content-type": MIME[extname(filePath)] ?? "application/octet-stream" });
+            res.end(data);
+        }
+        catch {
+            res.writeHead(404).end("Not found");
+        }
+    });
+    await new Promise((res) => server.listen(0, "127.0.0.1", res));
+    const addr = server.address();
+    const port = typeof addr === "object" && addr ? addr.port : 0;
+    const url = `http://127.0.0.1:${port}/`;
+    console.log(`[alkahest] dashboard: ${url}  (Ctrl+C to stop)`);
+    openBrowser(url);
+}
+function openBrowser(url) {
+    const isWin = platform() === "win32";
+    const cmd = platform() === "darwin" ? "open" : isWin ? "start" : "xdg-open";
+    try {
+        spawn(cmd, [url], { stdio: "ignore", detached: true, shell: isWin }).unref();
+    }
+    catch {
+        /* ignore browser auto-open failures — the URL is printed above */
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/core/serve.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Alkahest core data model — the implementation of ALKAHEST.md §3.
+ *
+ * `map.json` is the canonical serialization of ProductMap; the dashboard (view)
+ * and PRD generation (prd) all read this structure. If the model changes, update
+ * ALKAHEST.md first.
+ */
+/** A source code location — clickable to jump in an editor. */
+export interface SourceLoc {
+    /** Path relative to the project root */
+    file: string;
+    line: number;
+}
+/**
+ * One UI element inside a screen — something the user *sees or interacts with*.
+ * The element's *effect* (navigating to another screen / calling a backend) is
+ * NOT a Feature; it's represented as an edge (Transition / Call). (ALKAHEST.md §3)
+ */
+export interface Feature {
+    kind: "form" | "button" | "input" | "list" | "conditional";
+    /** Human-readable name — "Login form", "Checkout button" */
+    label: string;
+    /** Evidence: component/handler name, condition expression, etc. */
+    detail: string;
+    loc: SourceLoc;
+}
+/** A graph node = one screen (route/page). */
+export interface Screen {
+    /** Stable identifier based on the route path */
+    id: string;
+    /** "/dashboard/settings" */
+    route: string;
+    /** "app/dashboard/settings/page.tsx" (relative to project root) */
+    sourceFile: string;
+    /** File content hash for incremental refresh — ALKAHEST.md §9 */
+    sourceHash: string;
+    /** Human-readable screen name */
+    title: string;
+    /** Agent-written one-liner "what the user does on this screen" — empty until set via MCP */
+    summary: string;
+    /** Agent-written PRD/requirements markdown for this screen — empty until set via MCP. Shown in the dashboard panel. */
+    prd?: string;
+    features: Feature[];
+    /** Names of the main components used on this screen */
+    components: string[];
+    /** Whether this is the app entry point (root launched by @main/App, or the "/" route). Marks the start point / layout root. */
+    isEntry?: boolean;
+}
+/** Layer-1 edge = navigation from screen → screen (or an external URL). */
+export interface Transition {
+    from: string;
+    /** Target Screen.id, or an external URL, or null if not statically resolved */
+    to: string | null;
+    /**
+     * Edge kind:
+     *  - "navigate": user-triggered navigation (Link/router.push/.sheet/NavigationLink, etc.)
+     *  - "contains": a screen containing a child screen (TabView/embed) — structural flow, used to find the start point.
+     */
+    kind: "navigate" | "contains";
+    /** Original expression text when unresolved (e.g. "router.push(path)") */
+    rawTarget?: string;
+    /** "<Link href>" | "router.push" | "form action" | "redirect()" | "<a href>" | "Tab"/"embed" */
+    trigger: string;
+    loc: SourceLoc;
+}
+/**
+ * Layer-2 node = a backend/data capability a screen *calls* (ALKAHEST.md §3).
+ * When several screens call the same resource they share one node → revealing "which screens use it together".
+ */
+export interface Resource {
+    /** Stable identifier based on method+path or an identifiable name */
+    id: string;
+    kind: "endpoint" | "server-action" | "rpc" | "data-source" | "external";
+    /** Human-readable name — "GET /api/orders" */
+    label: string;
+    /** HTTP method (when an endpoint) */
+    method?: string;
+    /** Path or URL — "/api/orders" */
+    path?: string;
+}
+/** Layer-2 edge = call from screen → resource. */
+export interface Call {
+    from: string;
+    /** Target Resource.id, or null if not statically resolved */
+    to: string | null;
+    /** Original expression text when unresolved */
+    rawTarget?: string;
+    /** "fetch" | "useQuery" | "useMutation" | "server action" | handler name, etc. */
+    trigger: string;
+    loc: SourceLoc;
+}
+export type Framework = "next" | "react-router" | "vite-react" | "react-native" | "vue" | "nuxt" | "svelte" | "remix" | "astro" | "angular" | "static" | "swiftui" | "uikit" | "compose" | "flutter" | "django" | "flask" | "rails" | "unknown";
+export type Router = "next-app" | "next-pages" | "react-router" | "expo-router" | "react-navigation" | "vue-router" | "nuxt-pages" | "sveltekit" | "remix-routes" | "astro-pages" | "angular-router" | "static-html" | "swiftui-views" | "uikit-vc" | "compose-nav" | "flutter-nav" | "django-urls" | "flask-routes" | "rails-routes" | "unknown";
+export interface ProductMapMeta {
+    framework: Framework;
+    router: Router;
+    /** ISO 8601 — scan time */
+    scannedAt: string;
+    /** Absolute path */
+    projectRoot: string;
+    /** Incremental baseline: per-file content hashes — ALKAHEST.md §9 */
+    fileHashes: Record<string, string>;
+    /** alkahest version that produced this map */
+    alkahestVersion: string;
+}
+/** The full product map — the root of `.alkahest/map.json`. */
+export interface ProductMap {
+    /** Layer-1 nodes: screens */
+    screens: Screen[];
+    /** Layer-2 nodes: resources a screen calls (API/data/server action) */
+    resources: Resource[];
+    /** Layer-1 edges: screen → screen navigation */
+    transitions: Transition[];
+    /** Layer-2 edges: screen → resource calls */
+    calls: Call[];
+    meta: ProductMapMeta;
+}

package/dist/core/types.js

@@ -0,0 +1,9 @@
+/**
+ * Alkahest core data model — the implementation of ALKAHEST.md §3.
+ *
+ * `map.json` is the canonical serialization of ProductMap; the dashboard (view)
+ * and PRD generation (prd) all read this structure. If the model changes, update
+ * ALKAHEST.md first.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}