@ambitresearch/genie 1.3.1

package/dist/server.d.ts

@@ -0,0 +1,96 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ProjectStore } from "./tools/create_project.js";
+import { type ConjureDeps } from "./tools/conjure.js";
+import { type PreviewLocality, type ViewerBooter } from "./tools/preview.js";
+import type { KitStore } from "./store/interface.js";
+import { type TransportKind } from "./transport.js";
+/** Server identity. The package manifest is Release Please's version source of truth. */
+export declare const SERVER_INFO: {
+    readonly name: "genie";
+    readonly version: string;
+};
+/**
+ * Build the genie MCP server.
+ *
+ * M0 ships an *empty but bootable* server: it negotiates the MCP handshake,
+ * advertises capabilities, and answers `tools/list` — but the only tool is a
+ * built-in `ping` health check. The real surfaces arrive in later milestones:
+ *   - M1: genie's 19 core tools (13 kit verbs + 6 project verbs) (`mcp__genie__*`)
+ *   - M2: generation tools (conjure, refine) via the configured LLM endpoint
+ *   - M3: @genie marker validator + manifest compiler
+ *   - M4: the ui://genie/grid MCP-Apps resource + Vite viewer
+ *
+ * Keeping this a single factory means every transport (stdio, HTTP) shares one
+ * registration — see transport.ts.
+ */
+export interface CreateServerOptions {
+    /**
+     * Transport used by an embedder that connects the returned server directly.
+     * Pass `"http"` for Streamable HTTP so preview never opens a browser on the
+     * server machine. {@link startTransport} records its own resolved kind when
+     * the built-in transport launcher is used.
+     */
+    transportKind?: TransportKind;
+    /** Whether the viewer URL is reachable from the host running the MCP client. */
+    previewLocality?: PreviewLocality;
+    /** Injectable preview viewer seam for embedders and transport-level tests. */
+    previewBooter?: ViewerBooter;
+    projectsRoot?: string;
+    kitsRoot?: string;
+    reportsDir?: string;
+    /**
+     * Injectable kit backend (AC1 / DRO-523; kit-file verbs added in
+     * M1-14a-1a / DRO-540). When supplied, the kit verbs route through this store
+     * instead of the default `LocalFsKitStore(kitsRoot)`:
+     *   - metadata: `create_kit`, `get_kit`, `list_kits`, `list_components`,
+     *     plus `conjure_screen`'s explicit-kitId validation and `bind_kit`'s
+     *     kit-existence check (via `KitStore.getKit`/`listKits`/`createKit`/…);
+     *   - files: `read_file`, `list_files`, `delete_files` (via
+     *     `KitStore.readFile`/`listFiles`/`deleteFile`).
+     * Defaulting to LocalFs keeps every existing caller (`createServer()`,
+     * `createServer({ kitsRoot })`) byte-for-byte unchanged, so injecting a
+     * `GitHostKitStore` points the whole kit surface at the git host.
+     *
+     * Remaining holdout (tracked, deliberately out of scope here): `write_files`
+     * still binds to `kitsRoot` + the on-disk plan registry — its atomic
+     * rename-to-temp / streaming / rollback transaction doesn't map onto the
+     * git-host REST model without its own design, so it is a sibling follow-up.
+     * The rich project family (`create_project`/`get_project`/`bind_kit` write
+     * side/`recordScreen`) also still uses the concrete fs-backed `ProjectStore`
+     * (see `projectStore` below); `delete_project` already routes through it
+     * (M1-14a-1 / DRO-531).
+     */
+    kitStore?: KitStore;
+    /**
+     * Injectable project backend (AC1 / DRO-523). When supplied, the project
+     * family (`create_project`, `list_projects`, `get_project`, `bind_kit`, and
+     * `conjure_screen`'s project read/record) route through this store instead of
+     * the default `new ProjectStore(projectsRoot, kitStore)`. Defaulting to the
+     * LocalFs-backed `ProjectStore` keeps every existing caller unchanged.
+     *
+     * Same partial-seam caveat as `kitStore`: this is the concrete
+     * fs-backed `ProjectStore` class (create_project.ts), which owns blueprints,
+     * kitBindings, screens, and `canEdit` — capabilities the thin
+     * `GitHostProjectStore` in the store layer does NOT yet implement. So a
+     * git-host project backend that satisfies the full tool-surface contract is
+     * still to-build (tracked follow-up); this seam is what lets it be dropped in
+     * once it exists, and lets tests substitute a fake. `delete_project` now
+     * routes through this store too (M1-14a-1 / DRO-531); the kit-file verbs
+     * (`read_file`/`list_files`/`delete_files` via DRO-540, and `write_files` via
+     * M1-14a-1b / DRO-565) all now route through `kitStore` — no fs-native holdout
+     * remains.
+     */
+    projectStore?: ProjectStore;
+    /**
+     * Injectable `conjure` dependencies (test seam only — e.g. a stubbed `chat`
+     * function so a smoke test can drive a genuinely SUCCESSFUL
+     * `conjure -> plan -> write_files -> preview` chain without a real network
+     * call, or explicitly the real default so the same test can also assert the
+     * live-endpoint path when `GENIE_LLM_*` is configured). Defaults to `{}`,
+     * which is `registerConjureTool`'s own default: the real endpoint via the
+     * lazily-imported LLM client.
+     */
+    conjureDeps?: ConjureDeps;
+}
+export declare function createServer(options?: CreateServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,YAAY,EAA6B,MAAM,2BAA2B,CAAC;AAMpF,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAW3E,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAkD,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpG,yFAAyF;AACzF,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gFAAgF;IAChF,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CA6PzE"}

package/dist/server.js

@@ -0,0 +1,258 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { join } from "node:path";
+import packageJson from "../package.json" with { type: "json" };
+import { ProjectStore, registerCreateProjectTool } from "./tools/create_project.js";
+import { registerListProjectsTool } from "./tools/list_projects.js";
+import { registerGetProjectTool } from "./tools/get_project.js";
+import { registerDeleteProjectTool } from "./tools/delete_project.js";
+import { registerBindKitTool } from "./tools/bind_kit.js";
+import { LocalScaffoldScreenGenerator, registerConjureScreenTool } from "./tools/conjure_screen.js";
+import { registerConjureTool } from "./tools/conjure.js";
+import { registerRefineTool } from "./tools/refine.js";
+import { registerCreateKit } from "./tools/create_kit.js";
+import { registerReadFile } from "./tools/read_file.js";
+import { registerValidate } from "./tools/validate.js";
+import { registerListFilesTool } from "./tools/list_files.js";
+import { registerListKits } from "./tools/list_kits.js";
+import { registerListComponents } from "./tools/list_components.js";
+import { registerPlan } from "./tools/plan.js";
+import { registerDeleteFilesTool } from "./tools/delete_files.js";
+import { registerWriteFilesTool } from "./tools/write_files.js";
+import { MCP_APP_MIME, UI_EXTENSION_ID, registerPreviewTool, } from "./tools/preview.js";
+import { normalizePreviewsBaseUrl, registerGridResource } from "./ui/grid-resource.js";
+import { startCardAssetBroker } from "./ui/card-asset-broker.js";
+import { LocalFsKitStore } from "./store/local.js";
+import { registerGetKitTool } from "./tools/get_kit.js";
+import { getServerTransportKind, registerServerDisposer } from "./transport.js";
+/** Server identity. The package manifest is Release Please's version source of truth. */
+export const SERVER_INFO = {
+    name: "genie",
+    version: packageJson.version,
+};
+export function createServer(options = {}) {
+    const server = new McpServer(SERVER_INFO, {
+        capabilities: {
+            extensions: {
+                [UI_EXTENSION_ID]: { mimeTypes: [MCP_APP_MIME] },
+            },
+        },
+        instructions: "genie generates UI components against your own UI kit, inside your coding " +
+            "harness. (Scaffold build — the registered tools are ping, kit listing, kit component " +
+            "listing, kit creation, kit lookup, file listing, file reading, validation, project " +
+            "create/list/get/delete/bind_kit, conjure_screen, conjure (LLM component generation), " +
+            "refine (LLM component iteration — diff + updated files against existing kit source), " +
+            "plan creation (the capability-grant " +
+            "boundary for write/delete verbs), write_files, delete_files, and preview (returns the " +
+            "viewer URL + a local-only file:// fallback plus a ui://genie/grid resource pointer in " +
+            "_meta.ui.resourceUri). write_files and " +
+            "delete_files share one plan-boundary validation middleware — every call is checked " +
+            "for planId presence/existence/expiry and per-path glob membership before the tool " +
+            "handler runs.)",
+    });
+    // A single built-in tool. Registering it makes the SDK wire up the
+    // tools/list + tools/call handlers (they are lazy-initialized on first
+    // registration), so capability negotiation is honest from M0 onward.
+    // It also gives every harness a trivial "is genie alive?" probe.
+    server.registerTool("ping", {
+        title: "Ping",
+        description: "Health check — returns 'pong' and the server version. Confirms genie is " +
+            "connected and responding.",
+        inputSchema: {},
+    }, () => ({
+        content: [
+            {
+                type: "text",
+                text: `pong — ${SERVER_INFO.name} ${SERVER_INFO.version}`,
+            },
+        ],
+    }));
+    const projectsRoot = options.projectsRoot ??
+        process.env.GENIE_PROJECTS_ROOT ??
+        join(process.cwd(), ".genie", "projects");
+    // Resolve the kits root ONCE so every kit verb agrees on where kits live.
+    // `create_kit` (via LocalFsKitStore) writes here, `read_file` reads here, and
+    // `list_files` walks here — threading the same value into all of them (via the
+    // shared kitStore below) is what keeps them consistent.
+    const kitsRoot = options.kitsRoot ?? process.env.GENIE_KITS_ROOT ?? join(process.cwd(), ".genie", "kits");
+    // Shared instance: `bind_kit` (via ProjectStore) validates kitId through the
+    // same store `create_kit`/`get_kit` already write through, so a kit created
+    // in this process is immediately bindable without a second construction.
+    //
+    // AC1 (DRO-523): an injected `options.kitStore` overrides the default so an
+    // in-process MCP walk can be pointed at `GitHostKitStore` (or any KitStore).
+    // Absent injection, this is exactly the pre-seam `new LocalFsKitStore(kitsRoot)`.
+    const kitStore = options.kitStore ?? new LocalFsKitStore(kitsRoot);
+    // AC1 (DRO-523): an injected `options.projectStore` overrides the default so
+    // the project family can be pointed at an alternate backend. Absent injection
+    // this is exactly the pre-seam `new ProjectStore(projectsRoot, kitStore)` —
+    // sharing the same `kitStore` above so `bind_kit`/`conjure_screen` validate
+    // kitIds through the store `create_kit` writes to.
+    const projectStore = options.projectStore ?? new ProjectStore(projectsRoot, kitStore);
+    registerCreateProjectTool(server, projectStore);
+    registerListProjectsTool(server, projectStore);
+    registerGetProjectTool(server, projectStore);
+    // delete_project (M1-14a-1 / DRO-531): routes through the injected
+    // `projectStore` — the same instance the rest of the project family uses —
+    // instead of a raw `projectsRoot` path, so a non-LocalFs backend reaches this
+    // verb too. Persistence + read-only policy live in `ProjectStore.deleteProject`.
+    registerDeleteProjectTool(server, projectStore);
+    registerBindKitTool(server, projectStore);
+    // conjure_screen (M1-21): project-aware screen generation. The M1 generator is
+    // an offline deterministic scaffold (LocalScaffoldScreenGenerator) — no model
+    // call, so it runs in CI unchanged; M2 swaps in the real endpoint client
+    // behind the same ScreenGenerator seam. It shares the same projectStore
+    // (screen recording) and kitStore (explicit-kitId validation) the project and
+    // kit verbs already use.
+    registerConjureScreenTool(server, {
+        projectStore,
+        kitStore,
+        generator: new LocalScaffoldScreenGenerator(),
+    });
+    // conjure (M2-03): genie's headline verb — real LLM component generation
+    // against the caller's UI kit. Calls the configured OpenAI-compatible endpoint
+    // (M2-01 client) with a COMPONENT_SCHEMA json_schema response_format (M2-02),
+    // validates the reply with Ajv, and retries once on a validation failure. Pure
+    // generation: it does NOT write files (AC9) and takes no store — the default
+    // `chat` seam lazily imports the LLM client only on first call, so registering
+    // it here never requires GENIE_LLM_* to be set just to build the server.
+    registerConjureTool(server, options.conjureDeps);
+    // refine (M2-04): iterate on an existing component. Loads the component's
+    // current files from the kit (`kitStore.listFiles`/`readFile`), sends them plus
+    // a free-form instruction (and, for a canvas-style edit, an optional region
+    // rect rendered as a crop) to the configured endpoint behind the SAME
+    // request/validate/retry harness `conjure` uses, and returns a unified diff +
+    // the full updated files. The region crop uses Playwright as an OPTIONAL peer
+    // dependency (M3-02's validator setup) via a lazy import that degrades
+    // gracefully when absent, so registering it here never requires Playwright or
+    // GENIE_LLM_* to be set just to build the server.
+    registerRefineTool(server, { kitStore });
+    registerListKits(server, kitStore);
+    registerListComponents(server, kitStore);
+    registerCreateKit(server, kitStore);
+    registerGetKitTool(server, kitStore);
+    // M1 kit-file verbs. Re-plumbed onto the injected `kitStore` (M1-14a-1a /
+    // DRO-540): `read_file`, `list_files`, and `delete_files` now route through
+    // `KitStore.readFile`/`listFiles`/`deleteFile` instead of a raw `kitsRoot`
+    // path, so injecting a `GitHostKitStore` carries these verbs onto the git
+    // host too (not just the metadata verbs). The store owns MIME/encoding, the
+    // 256 KiB cap, SRI hashing, and `.genieignore`/default-dir exclusion; the
+    // tools keep plan-gating (delete_files) and request-shape guards.
+    registerReadFile(server, kitStore);
+    registerListFilesTool(server, kitStore);
+    // Plan capability-grant boundary (M1-07). Locks writes/deletes/localDir and
+    // issues a planId; write_files (below) validates every call against it via
+    // the M1-13 plan-guard middleware (`middleware/plan-guard.ts`).
+    // `plans/index.ts` owns its own persistence root (`${GENIE_HOME}/plans`) and
+    // TTL (`GENIE_PLAN_TTL`) internally, so there's no store instance to thread
+    // through here — the module singleton is shared across the guard and the
+    // plan tool.
+    registerPlan(server);
+    // write_files (M1-08; store-routed in M1-14a-1b / DRO-565): validates planId +
+    // writes-glob membership via the M1-13 plan-guard middleware (one shared seam
+    // with delete_files, below), then commits the batch atomically into the kit
+    // via the injected `kitStore.writeFiles(plan.kitId, ops)` — the same store the
+    // read/list/delete verbs route through. `plan.localDir` is now only the
+    // local SOURCE base for `localPath` reads; the kit is the write destination.
+    registerWriteFilesTool(server, kitStore);
+    // validate (D-A — one verb, two facets):
+    //   • Counter-persistence facet (M1-12): persists caller-supplied validation
+    //     counts + emits Prometheus metrics. No planId required (read-side).
+    //   • Full-scan facet (M3-04 / DRO-260): when called WITHOUT `counts`, walks
+    //     every `.html` in the kit through the injected `kitStore` and runs the
+    //     @genie-marker / thin-render / variants-identical checks, returning
+    //     structured findings and persisting the derived counters via the same
+    //     path. The headless render uses Playwright as an OPTIONAL peer dependency
+    //     (createDefaultRenderer degrades to marker-only when it is absent), so
+    //     registering this here never requires Playwright to build/run the server.
+    registerValidate(server, {
+        reportsDir: options.reportsDir ??
+            process.env.GENIE_REPORTS_DIR ??
+            join(process.cwd(), ".genie", "reports"),
+        kitStore,
+    });
+    // Plan-gated destructive verb (M1-09): deletes are authorized by a plan's
+    // `deletes` globs and hit the SAME kit tree read_file/list_files read (via
+    // the shared `kitStore`, M1-14a-1a). Shares the M1-07 plan boundary and the
+    // M1-13 plan-guard middleware (`middleware/plan-guard.ts`) with write_files
+    // so the two verbs enforce plan authorization through one identical seam.
+    registerDeleteFilesTool(server, kitStore);
+    // Keep locality unresolved when an embedder has not selected its transport
+    // yet. `startTransport` records the actual kind before connecting, and both
+    // preview plus the lazy broker provider resolve against that runtime value.
+    const previewLocality = options.previewLocality ??
+        (options.transportKind === undefined
+            ? undefined
+            : options.transportKind === "stdio"
+                ? "local"
+                : "remote");
+    const mayNeedLocalCardBroker = options.transportKind !== "http" &&
+        options.previewLocality !== "remote" &&
+        normalizePreviewsBaseUrl(process.env.GENIE_PREVIEWS_BASE_URL) === undefined;
+    // Local stdio app surfaces share one loopback card-asset broker. Explicit
+    // remote/HTTP configurations omit the provider; an unresolved embedder gets
+    // a guarded provider that cannot bind until startup records local stdio.
+    let cardAssetBrokerPromise;
+    let cardAssetBrokerDisposed = false;
+    const getCardAssetBroker = mayNeedLocalCardBroker
+        ? async () => {
+            if (cardAssetBrokerDisposed) {
+                throw new Error("Card asset broker provider is disposed.");
+            }
+            const transportKind = options.transportKind ?? getServerTransportKind(server);
+            const locality = options.previewLocality ?? (transportKind === "stdio" ? "local" : "remote");
+            if (transportKind !== "stdio" || locality !== "local") {
+                throw new Error("Card asset broker requires a local stdio transport.");
+            }
+            if (cardAssetBrokerPromise === undefined) {
+                const startup = startCardAssetBroker();
+                cardAssetBrokerPromise = startup;
+                // Preserve single-flight startup while allowing a transient bind
+                // failure to recover on the next preview/resource request.
+                void startup.catch(() => {
+                    if (cardAssetBrokerPromise === startup)
+                        cardAssetBrokerPromise = undefined;
+                });
+            }
+            return cardAssetBrokerPromise;
+        }
+        : undefined;
+    if (getCardAssetBroker !== undefined) {
+        registerServerDisposer(server, async () => {
+            cardAssetBrokerDisposed = true;
+            const startup = cardAssetBrokerPromise;
+            if (startup === undefined)
+                return;
+            const cardAssetBroker = await startup.catch(() => undefined);
+            await cardAssetBroker?.close();
+        });
+    }
+    // preview (M4-05 / DRO-267): returns local viewer/file URLs only to local
+    // clients, and points ui://-capable hosts at the inline `ui://genie/grid`
+    // resource (registered by M4-06) via `_meta.ui.resourceUri`. Boots the Vite
+    // viewer on demand and reuses it across calls (its own ViewerRegistry),
+    // falling back to a local file URL or CSP-safe embedded manifest when needed.
+    // Bound to the same `kitsRoot` the kit verbs resolve against so a `kitId`
+    // maps to the same on-disk kit dir the viewer serves.
+    const previewRegistry = registerPreviewTool(server, {
+        kitsRoot,
+        transportKind: options.transportKind,
+        locality: previewLocality,
+        ...(options.previewBooter !== undefined ? { booter: options.previewBooter } : {}),
+        ...(getCardAssetBroker !== undefined ? { getCardAssetBroker } : {}),
+    });
+    registerServerDisposer(server, () => previewRegistry.closeAll());
+    // ui://genie/grid (M4-06 / DRO-268): the embedded MCP-Apps resource the
+    // `preview` tool's `_meta.ui.resourceUri` points at. A ui://-capable host
+    // (Claude, VS Code ≥Jan 2026, ChatGPT, Cursor) reads this resource and renders
+    // the card grid inline in its own sandboxed iframe. The handler compiles the
+    // requested kit's manifest (M3-03) and inlines it as
+    // `<script type="application/json" id="manifest">` so the iframe — whose CSP
+    // is `connect-src 'none'` — needs no fetch. Bound to the same `kitsRoot` as
+    // the kit verbs + `preview`, so a `kitId` resolves to the same on-disk kit.
+    registerGridResource(server, {
+        kitsRoot,
+        ...(getCardAssetBroker !== undefined ? { getCardAssetBroker } : {}),
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store/empty-manifest.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Empty-manifest seed for `createKit` (DRO-764 AC3).
+ *
+ * A freshly created kit has zero components — the M3-03 compiler
+ * (`../manifest/compiler.ts`) hasn't run yet, and won't until a watcher
+ * cycle or an explicit call walks the kit's `components` tree. But the viewer's
+ * `file://` and localhost-Vite vehicles (unlike `ui://genie/grid`, which
+ * calls `compileManifest` live per request — see `../ui/grid-resource.ts`)
+ * only ever `fetch(".genie/manifest.json")` off disk (`static/viewer.js`'s
+ * `boot()`). A missing file there is a REJECTED fetch (browsers do not
+ * synthesize a 404 Response for a nonexistent `file://` resource — a
+ * network error is a rejected promise), which `boot()`'s `.catch` turns
+ * into the `.ds-error` "run the genie MCP server against this kit first"
+ * message — not the `.ds-empty` "no components yet" state AC3 requires.
+ *
+ * `create_kit` therefore seeds a valid, empty manifest at creation time —
+ * `{version: 1, name, generatedAt, groups: [], components: []}`, BYTE-SHAPE
+ * IDENTICAL to what `compileManifest` itself would produce for a kit whose
+ * `components/` directory doesn't exist yet (see
+ * `manifest/compiler.test.ts`'s "AC4: top-level shape" and "empty
+ * components/ dir" cases) — so this is a real, valid manifest snapshot, not
+ * a viewer-only special case, and the M3-03 compiler transparently
+ * overwrites it the moment any component is actually added.
+ *
+ * A tiny standalone literal builder — not a call into
+ * `../manifest/compiler.ts`'s `compileManifest` — deliberately: that
+ * function's job is walking the kit's `components` tree off disk, which for a
+ * brand-new kit (no such directory yet) is strictly more IO than a
+ * `createKit` call needs to pay just to learn "there are no components",
+ * and would introduce a `store/*` → `manifest/*` import direction with no
+ * corresponding need elsewhere in this file. Both branches are asserted
+ * byte-shape-identical by `empty-manifest.test.ts`, so they cannot silently
+ * drift apart.
+ */
+/** The exact empty-manifest envelope shape `compileManifest` emits for a kit
+ * with no `components/` directory yet (`manifest/compiler.ts`'s `Manifest`). */
+export interface EmptyManifest {
+    version: 1;
+    name: string;
+    generatedAt: string;
+    groups: never[];
+    components: never[];
+}
+/**
+ * Build the empty-manifest envelope for a newly created kit (AC3). `name`
+ * should be the kit's own name (the same string `createKit` already
+ * received) — purely descriptive metadata: `static/viewer.js` never reads
+ * this top-level `name` field (only each card's own `name`), so its exact
+ * value has no rendering effect; it exists only so a manifest read back off
+ * disk looks like a normal compiler snapshot, not a hand-wired special case.
+ */
+export declare function buildEmptyManifest(name: string): EmptyManifest;
+/** `buildEmptyManifest`, serialized exactly as `compiler.ts`'s
+ * `writeManifestAtomic` serializes a real compiled manifest (2-space
+ * indent, UTF-8) — so a byte-diff between a seeded and a freshly-compiled
+ * empty manifest is whitespace-only. */
+export declare function serializeEmptyManifest(name: string): string;
+//# sourceMappingURL=empty-manifest.d.ts.map

package/dist/store/empty-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-manifest.d.ts","sourceRoot":"","sources":["../../src/store/empty-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;gFACgF;AAChF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,KAAK,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAQ9D;AAED;;;wCAGwC;AACxC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/store/empty-manifest.js

@@ -0,0 +1,59 @@
+/**
+ * Empty-manifest seed for `createKit` (DRO-764 AC3).
+ *
+ * A freshly created kit has zero components — the M3-03 compiler
+ * (`../manifest/compiler.ts`) hasn't run yet, and won't until a watcher
+ * cycle or an explicit call walks the kit's `components` tree. But the viewer's
+ * `file://` and localhost-Vite vehicles (unlike `ui://genie/grid`, which
+ * calls `compileManifest` live per request — see `../ui/grid-resource.ts`)
+ * only ever `fetch(".genie/manifest.json")` off disk (`static/viewer.js`'s
+ * `boot()`). A missing file there is a REJECTED fetch (browsers do not
+ * synthesize a 404 Response for a nonexistent `file://` resource — a
+ * network error is a rejected promise), which `boot()`'s `.catch` turns
+ * into the `.ds-error` "run the genie MCP server against this kit first"
+ * message — not the `.ds-empty` "no components yet" state AC3 requires.
+ *
+ * `create_kit` therefore seeds a valid, empty manifest at creation time —
+ * `{version: 1, name, generatedAt, groups: [], components: []}`, BYTE-SHAPE
+ * IDENTICAL to what `compileManifest` itself would produce for a kit whose
+ * `components/` directory doesn't exist yet (see
+ * `manifest/compiler.test.ts`'s "AC4: top-level shape" and "empty
+ * components/ dir" cases) — so this is a real, valid manifest snapshot, not
+ * a viewer-only special case, and the M3-03 compiler transparently
+ * overwrites it the moment any component is actually added.
+ *
+ * A tiny standalone literal builder — not a call into
+ * `../manifest/compiler.ts`'s `compileManifest` — deliberately: that
+ * function's job is walking the kit's `components` tree off disk, which for a
+ * brand-new kit (no such directory yet) is strictly more IO than a
+ * `createKit` call needs to pay just to learn "there are no components",
+ * and would introduce a `store/*` → `manifest/*` import direction with no
+ * corresponding need elsewhere in this file. Both branches are asserted
+ * byte-shape-identical by `empty-manifest.test.ts`, so they cannot silently
+ * drift apart.
+ */
+/**
+ * Build the empty-manifest envelope for a newly created kit (AC3). `name`
+ * should be the kit's own name (the same string `createKit` already
+ * received) — purely descriptive metadata: `static/viewer.js` never reads
+ * this top-level `name` field (only each card's own `name`), so its exact
+ * value has no rendering effect; it exists only so a manifest read back off
+ * disk looks like a normal compiler snapshot, not a hand-wired special case.
+ */
+export function buildEmptyManifest(name) {
+    return {
+        version: 1,
+        name,
+        generatedAt: new Date().toISOString(),
+        groups: [],
+        components: [],
+    };
+}
+/** `buildEmptyManifest`, serialized exactly as `compiler.ts`'s
+ * `writeManifestAtomic` serializes a real compiled manifest (2-space
+ * indent, UTF-8) — so a byte-diff between a seeded and a freshly-compiled
+ * empty manifest is whitespace-only. */
+export function serializeEmptyManifest(name) {
+    return JSON.stringify(buildEmptyManifest(name), null, 2);
+}
+//# sourceMappingURL=empty-manifest.js.map

package/dist/store/empty-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-manifest.js","sourceRoot":"","sources":["../../src/store/empty-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAYH;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI;QACJ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC;AAED;;;wCAGwC;AACxC,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/store/git-host.d.ts

@@ -0,0 +1,120 @@
+/**
+ * GitHostStore — shared adapter for any git host (GitHub / Gitea / GitLab).
+ *
+ * AC4: Uses a git-host SDK against an operator-configured base URL.
+ *   plan = branch `plan/${planId}`, commit on `commitPlan`, no auto-merge.
+ * AC6: Honours its token from env (`GENIE_GIT_TOKEN`), fails fast with a
+ *   clear error if missing.
+ *
+ * The adapter communicates with the git host via its HTTP REST API (Gitea is
+ * the reference instance). No git host is privileged in the abstraction and
+ * no provider URL is baked into the code.
+ */
+import type { FileOp, KitFileContent, KitFileEntry, KitId, KitMeta, KitStore, PlanId, ProjectId, ProjectMeta, ProjectStore, WriteOp } from "./interface.js";
+export interface GitHostConfig {
+    /** Base URL of the git host API (e.g. "https://gitea.example.com/api/v1"). */
+    baseUrl: string;
+    /** API token. If not provided, reads from GENIE_GIT_TOKEN env var. */
+    token?: string;
+    /** Owner / org name on the git host. */
+    owner: string;
+}
+/**
+ * Maps kits to repositories on the git host.
+ * A kitId is the repository name under the configured owner.
+ */
+export declare class GitHostKitStore implements KitStore {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly owner;
+    private readonly kitMetaPath;
+    constructor(config: GitHostConfig);
+    private api;
+    private repoPath;
+    private readKitMeta;
+    private writeKitMeta;
+    /**
+     * Create a single file on the repo's default branch via one contents-API
+     * POST. Shares `writeKitMeta`'s "fresh repo, no prior content at this path"
+     * assumption — used by `createKit` for both `.kit.json` and (DRO-764) the
+     * viewer's static scaffold, all written into a repo `auto_init` just
+     * created moments earlier under names (`index.html`/`viewer.js`/
+     * `viewer.css`/`.kit.json`) that don't collide with a host's own auto-init
+     * output (README/LICENSE/.gitignore).
+     */
+    private writeRepoFile;
+    listKits(): Promise<KitMeta[]>;
+    getKit(kitId: KitId): Promise<KitMeta>;
+    listFiles(kitId: KitId): Promise<KitFileEntry[]>;
+    listComponents(params: {
+        kitId: KitId;
+        group?: string;
+    }): Promise<import("./interface.js").ComponentEntry[]>;
+    /** Fetch repo metadata, mapping a 404 to NotFoundError("Kit"). */
+    private getRepo;
+    /**
+     * Read the kit's committed `.genieignore` (default branch) into active
+     * pattern lines. Absent file → no extra patterns (default-dir exclusion still
+     * applies via buildIgnoreMatcher).
+     */
+    private readIgnorePatterns;
+    private listTree;
+    /**
+     * GET a single contents entry, mapping a 404 to NotFoundError("File").
+     * Encodes each path segment to handle spaces, #, ?, etc.
+     */
+    private fetchContentEntry;
+    /** Fetch a file's raw bytes off the default branch (base64 or utf-8 payload). */
+    private fetchFileBytes;
+    readFile(kitId: KitId, path: string): Promise<KitFileContent>;
+    deleteFile(kitId: KitId, path: string): Promise<{
+        existed: boolean;
+    }>;
+    writeFiles(kitId: KitId, ops: WriteOp[]): Promise<{
+        writtenPaths: string[];
+    }>;
+    /**
+     * Fetch a path's current blob state on the default branch for a write:
+     * `{ existed: true, sha, contentB64 }` if present (needed to update AND to
+     * restore on rollback), `{ existed: false }` if absent (we'd be creating it).
+     * A directory at the path is treated as "not a writable file" and surfaces as
+     * absent — the subsequent write then fails and rolls back, matching LocalFs's
+     * directory-target refusal.
+     */
+    private getContentForWrite;
+    /**
+     * Unwind a partially-applied writeFiles batch. For each committed file: if it
+     * pre-existed, PUT its captured content back; if we created it, DELETE it.
+     * Every step is attempted even if an earlier one fails — failures are
+     * collected and returned so the caller can raise RollbackIncompleteError
+     * rather than mask an incomplete restore.
+     */
+    private unwriteFiles;
+    createKit(name: string, kitId?: string): Promise<KitMeta>;
+    openPlan(kitId: KitId, ops: FileOp[]): Promise<PlanId>;
+    commitPlan(kitId: KitId, planId: PlanId, ops: FileOp[]): Promise<void>;
+    closePlan(kitId: KitId, planId: PlanId): Promise<void>;
+    private applyOps;
+}
+/**
+ * Stores project metadata in a dedicated repo (`_genie-projects`) as JSON files.
+ * Each project is a file `projects/<projectId>.json`.
+ */
+export declare class GitHostProjectStore implements ProjectStore {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly owner;
+    private readonly metaRepo;
+    constructor(config: GitHostConfig);
+    private api;
+    private projectPath;
+    private ensureMetaRepo;
+    listProjects(): Promise<ProjectMeta[]>;
+    getProject(projectId: ProjectId): Promise<ProjectMeta>;
+    createProject(name: string): Promise<ProjectMeta>;
+    deleteProject(projectId: ProjectId): Promise<void>;
+    bindKit(projectId: ProjectId, kitId: KitId): Promise<void>;
+    recordScreen(projectId: ProjectId, screenRef: string): Promise<void>;
+    private updateProjectMeta;
+}
+//# sourceMappingURL=git-host.d.ts.map

package/dist/store/git-host.d.ts.map

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