@wrongstack/tools 0.284.1 → 0.286.0

package/dist/codebase-index/writer.d.ts

@@ -0,0 +1,189 @@
+import type { FileMeta, IndexStats, Ref, SearchResult, Symbol as IndexSymbol, SymbolKind, SymbolLang } from './schema.js';
+/**
+ * Resolve the per-project index directory. By default it lives under the
+ * global project dir (`~/.wrongstack/projects/<hash>/codebase-index`),
+ * matching every other piece of per-project state. Callers may pass an
+ * explicit `override` (used by tests and any wiring that already resolved the
+ * path) to avoid touching the real home directory.
+ */
+export declare function resolveIndexDir(projectRoot: string, override?: string): string;
+/**
+ * Optional index-directory override carried on the run context's `meta` bag.
+ * Production leaves it unset (the index resolves to the global per-project
+ * dir); tests and bespoke wiring set `meta.codebaseIndexDir` to redirect it.
+ */
+export declare function codebaseIndexDirOverride(ctx: {
+    meta?: Record<string, unknown>;
+}): string | undefined;
+export declare class IndexStore {
+    private db;
+    /** Absolute path to this project's index directory. */
+    private readonly indexDir;
+    /**
+     * True when the SQLite build provides FTS5 (Node's bundled SQLite does).
+     * When false, ranked search falls back to the LIKE + in-process BM25 path.
+     */
+    private ftsAvailable;
+    /**
+     * Cache of prepared statements keyed by their SQL text. `DatabaseSync`
+     * compiles SQL on every `.prepare()` call; for the fixed-SQL methods
+     * (upsertFile, getFileMeta, deleteFile, insertRefs, …) that runs thousands
+     * of times during a full reindex. `StatementSync` objects are reusable
+     * across calls on the same connection, so we compile each distinct SQL once
+     * and reuse it. Cleared in {@link close} when the connection is torn down.
+     */
+    private readonly stmtCache;
+    /** Prepare-once helper: compile `sql` on first use, reuse thereafter. */
+    private stmt;
+    /**
+     * Execute a SQLite write operation with automatic retry on lock conflicts.
+     *
+     * When another wstack process is holding the write lock the statement first
+     * waits up to `busy_timeout` ms, then throws SQLITE_BUSY.  This wrapper catches
+     * that error and retries (up to MAX_LOCK_RETRIES) with exponential backoff,
+     * giving the competing writer time to finish and release the lock.
+     *
+     * @param fn  The write operation to execute. Can return a value which is
+     *            returned to the caller on success.
+     * @throws   {@link LockError} when all retries are exhausted on a lock conflict
+     *            (non-lock errors always propagate on the first attempt).
+     */
+    runWithRetry<T>(fn: () => T): T;
+    constructor(projectRoot: string, opts?: {
+        indexDir?: string | undefined;
+    });
+    private initSchema;
+    /**
+     * Insert symbols, assigning IDs atomically inside `BEGIN IMMEDIATE` /
+     * `COMMIT`. The ID allocation (`SELECT MAX(id)`) and all `INSERT`s share
+     * the same transaction, preventing UNIQUE constraint violations when two
+     * processes index concurrently (each would see a different `MAX(id)` and
+     * neither can insert with the other's IDs).
+     *
+     * @returns The symbols array with `id` fields populated so the caller can
+     *          use them for refs without re-reading from the DB.
+     */
+    insertSymbols(symbols: IndexSymbol[]): IndexSymbol[];
+    deleteSymbolsForFile(file: string): void;
+    /**
+     * Remove every trace of a file (refs, symbols, FTS rows, file meta). Used
+     * when a source file disappears between index runs — previously this only
+     * dropped the `files` row, leaving its symbols orphaned but still searchable.
+     */
+    deleteFile(file: string): void;
+    upsertFile(meta: FileMeta): void;
+    getFileMeta(file: string): FileMeta | null;
+    getAllFileMetas(): FileMeta[];
+    search(query: string, filter?: {
+        kind?: SymbolKind | undefined;
+        lang?: SymbolLang | undefined;
+        file?: string | undefined;
+        lspKind?: number | undefined;
+    }): SearchResult[];
+    /**
+     * Ranked search — the one-stop query the codebase-search tool and plug-lsp
+     * use. With FTS5 this is a single indexed `MATCH` ranked by SQLite's native
+     * `bm25()` with a built-in `snippet()`; without FTS5 it falls back to the
+     * legacy LIKE scan + in-process BM25 (identical semantics, slower).
+     *
+     * Tokens are matched as prefixes (`"tok"*`), mirroring the old
+     * `LIKE '%tok%'` recall for the common symbol-search shapes ("user" finds
+     * "users", camelCase-split text makes "complex" find "complexOperation").
+     */
+    searchRanked(query: string, filter: {
+        kind?: SymbolKind | undefined;
+        lang?: SymbolLang | undefined;
+        file?: string | undefined;
+        lspKind?: number | undefined;
+    } | undefined, limit: number): {
+        results: SearchResult[];
+        total: number;
+    };
+    /** Legacy ranked path: LIKE candidates + in-process BM25 + JS snippets. */
+    private searchRankedFallback;
+    getAllIndexable(): Array<{
+        id: number;
+        text: string;
+    }>;
+    /**
+     * Largest symbol id currently in the table (0 when empty). New ids must be
+     * allocated from this, NOT from `COUNT(*)`: incremental reindexes delete a
+     * changed file's rows, so the row count drops below the max id and a
+     * count-based id would collide with a surviving row (UNIQUE constraint on
+     * `symbols.id`). Ids may have gaps — that is fine.
+     */
+    getMaxSymbolId(): number;
+    getStats(): IndexStats;
+    setLastIndexed(ts: number): void;
+    clearAll(): void;
+    /**
+     * Insert cross-references for a given source symbol id.
+     * Replaces any existing refs from the same source (idempotent on re-index).
+     */
+    insertRefs(fromId: number, refs: Ref[]): void;
+    /**
+     * Bulk-insert refs for many source symbols in a single transaction.
+     *
+     * Unlike {@link insertRefs} this does NOT delete per source id — the caller
+     * (the indexer) has already cleared stale refs for the file via
+     * {@link deleteRefsForFile}, so the per-source DELETE would be redundant work
+     * repeated once per symbol. One transaction for the whole file instead of one
+     * per symbol turns an O(symbols) transaction count into O(1).
+     *
+     * Each ref's own {@link Ref.fromId} is used; pass an empty array to no-op.
+     */
+    insertRefsBatch(refs: Ref[]): void;
+    /**
+     * Commit a batch of file-level symbol/refs/upserts in a single transaction.
+     *
+     * Used by the indexer to amortize SQLite commit overhead across many files.
+     * Before this, the indexer issued one transaction per file (BEGIN IMMEDIATE
+     * for symbols, plus per-file deletes and an upsertFile call), so a 20-file
+     * parallel batch cost ~5+ transactions × 20 files = 100+ commits. With
+     * this entry point we do exactly one BEGIN/COMMIT per parallel batch.
+     *
+     * Each entry must already be a fully-parsed FileSymbols (symbols + refs).
+     * The caller is responsible for the per-file prefix accounting
+     * (refsByLine → flat list with `fromId` populated). `deleteForFiles` lets
+     * the caller clear stale symbols/refs for any files being re-indexed before
+     * the inserts run (required to keep refs → symbols FK invariants).
+     *
+     * Returns the symbols back with their assigned `id` (same shape as
+     * {@link insertSymbols}) so callers can build final per-file results.
+     */
+    commitBatch(entries: Array<{
+        file: string;
+        lang: SymbolLang;
+        symbols: IndexSymbol[];
+        refs: Ref[];
+        mtimeMs: number;
+        symbolCount: number;
+    }>, options?: {
+        deleteForFiles?: string[] | undefined;
+    }): IndexSymbol[];
+    /**
+     * Delete all refs whose source symbols are in a given file.
+     * Used when re-indexing a file to clear stale refs.
+     */
+    deleteRefsForFile(file: string): void;
+    /**
+     * Resolve `to_name` → `to_id` for all refs that have a name but no id.
+     * Call this after all symbols have been inserted to fill in cross-references.
+     *
+     * Single statement: the `to_name IN (SELECT name FROM symbols)` guard restricts
+     * the UPDATE to refs that will actually resolve, so `.changes` counts only refs
+     * that found a target — matching the previous per-row loop's return value.
+     */
+    resolveRefs(): number;
+    /**
+     * Find all references TO a given symbol (who calls / uses this symbol?).
+     */
+    findRefsTo(symbolId: number): Ref[];
+    /**
+     * Find all references FROM a given symbol (what does this symbol call/use?).
+     */
+    findRefsFrom(symbolId: number): Ref[];
+    private sizeBytes;
+    close(): void;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/codebase-index/writer.d.ts.map

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

package/dist/codebase-index/yaml-parser.d.ts

@@ -0,0 +1,8 @@
+import type { FileSymbols, SymbolLang } from './schema.js';
+export declare function parseSymbols(opts: {
+    file: string;
+    content: string;
+    lang: SymbolLang;
+}): FileSymbols;
+export { detectLang } from './ts-parser.js';
+//# sourceMappingURL=yaml-parser.d.ts.map

package/dist/codebase-index/yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../src/codebase-index/yaml-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAyB,UAAU,EAAE,MAAM,aAAa,CAAC;AAGlF,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG,WAAW,CASd;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/design.d.ts

@@ -0,0 +1,38 @@
+import type { Tool } from '@wrongstack/core';
+type Overrides = Record<string, string>;
+interface DesignInput {
+    action?: 'list' | 'use' | 'foundations' | 'set' | 'materialize' | 'verify' | undefined;
+    kit?: string | undefined;
+    stack?: string | undefined;
+    /** action "set" / "use": token overrides, e.g. { primary: "oklch(...)", "dark.bg": "#111" }. */
+    set?: Overrides | undefined;
+    /** action "materialize": output path (project-relative); defaults per stack. */
+    out?: string | undefined;
+    /** action "materialize": overwrite an existing file. */
+    force?: boolean | undefined;
+    /** action "verify": explicit files to scan (project-relative). Defaults to a UI-file walk. */
+    files?: string[] | undefined;
+}
+interface DesignOutput {
+    action: string;
+    kit?: string | undefined;
+    stack?: string | undefined;
+    output: string;
+    /** action "materialize": where the theme file was (or would be) written. */
+    path?: string | undefined;
+    /** action "verify": adherence score 0..1 and violation count. */
+    score?: number | undefined;
+    violations?: number | undefined;
+}
+/**
+ * Design Studio tool — progressive disclosure + token enforcement.
+ *
+ * `list`/`use`/`foundations` browse and pin kits. `set` records structured color
+ * overrides (these win over kit tokens). `materialize` writes the active kit's
+ * (override-applied) tokens to a real, stack-appropriate theme file so the
+ * palette becomes the codebase's source of truth — not just a prompt hint.
+ * `verify` scans UI files for off-palette drift.
+ */
+export declare const designTool: Tool<DesignInput, DesignOutput>;
+export {};
+//# sourceMappingURL=design.d.ts.map

package/dist/design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../src/design.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAc1D,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA+BxC,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,KAAK,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvF,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gGAAgG;IAChG,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC9B;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAYD;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CA8QtD,CAAC"}

package/dist/design.js

@@ -0,0 +1,270 @@
+// src/design.ts
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import {
+  applyTokenOverrides,
+  getDesignKitLoader,
+  isDesignStack,
+  loadActiveKit,
+  materializeTokens,
+  recordKitChoice,
+  recordOverrides,
+  runDesignVerify,
+  setActiveKit,
+  setDesignOverrides
+} from "@wrongstack/core";
+async function resolveReal(p) {
+  const resolved = path.resolve(p);
+  let probe = resolved;
+  const missing = [];
+  for (; ; ) {
+    try {
+      return path.resolve(await fs.realpath(probe), ...missing);
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        const parent = path.dirname(probe);
+        if (parent === probe) return resolved;
+        missing.unshift(path.basename(probe));
+        probe = parent;
+        continue;
+      }
+      return resolved;
+    }
+  }
+}
+function normalizeOverrides(set) {
+  const out = {};
+  if (set && typeof set === "object") {
+    for (const [k, v] of Object.entries(set)) {
+      if (typeof v === "string") out[k] = v;
+    }
+  }
+  return out;
+}
+var designTool = {
+  name: "design",
+  category: "Design",
+  description: 'Browse, load, customize, and enforce curated frontend/mobile UI design kits. Use BEFORE writing UI code to commit to one coherent, modern, responsive, dark/light, accessible design. Actions: "list" (menu), "use" (load+pin a kit for a stack), "foundations" (baseline), "set" (override kit colors/tokens), "materialize" (write the tokens to a real theme file \u2014 CSS @theme/OKLCH or native), "verify" (scan UI files for off-palette colors).',
+  usageHint: 'Flow: `design {action:"use", kit:"minimal-clarity", stack:"web"}` \u2192 optionally `design {action:"set", set:{primary:"oklch(62% 0.2 25)"}}` \u2192 `design {action:"materialize"}` to write tokens to disk \u2192 implement against them \u2192 `design {action:"verify"}`.',
+  permission: "confirm",
+  mutating: true,
+  capabilities: ["fs.write"],
+  timeoutMs: 15e3,
+  inputSchema: {
+    type: "object",
+    properties: {
+      action: {
+        type: "string",
+        enum: ["list", "use", "foundations", "set", "materialize", "verify"],
+        description: "list = menu; use = load+pin a kit; foundations = baseline; set = override colors/tokens; materialize = write tokens to a theme file; verify = scan UI for off-palette colors. Default: list."
+      },
+      kit: {
+        type: "string",
+        description: 'Kit id (required for "use"), e.g. "minimal-clarity", "neo-brutalist".'
+      },
+      stack: {
+        type: "string",
+        enum: ["web", "react-native", "flutter", "swiftui", "compose"],
+        description: "Target stack \u2014 narrows guidance + materialize format. Default: web."
+      },
+      set: {
+        type: "object",
+        description: 'Token overrides for "set"/"use": { "primary": "oklch(\u2026)", "dark.bg": "#111" }. Bare key = both themes; "light."/"dark." prefix = that theme only. Empty value clears an override.',
+        additionalProperties: { type: "string" }
+      },
+      out: {
+        type: "string",
+        description: "Materialize output path (project-relative). Defaults to a per-stack convention."
+      },
+      force: {
+        type: "boolean",
+        description: "Materialize: overwrite an existing file (default false \u2014 refuses to clobber)."
+      },
+      files: {
+        type: "array",
+        items: { type: "string" },
+        description: "Verify: explicit project-relative files to scan. Default: a bounded UI-file walk."
+      }
+    },
+    required: []
+  },
+  async execute(input, ctx) {
+    const loader = getDesignKitLoader(ctx.projectRoot);
+    const action = input.action ?? "list";
+    const stack = input.stack && isDesignStack(input.stack) ? input.stack : void 0;
+    if (action === "foundations") {
+      const text = await loader.foundationsText(stack);
+      return { action, stack, output: text || "No foundations document is installed." };
+    }
+    if (action === "use") {
+      const kitId = input.kit?.trim();
+      if (!kitId) {
+        const menu2 = await loader.menuText();
+        return { action, output: `No kit id provided.
+
+${menu2}` };
+      }
+      const manifest = await loader.find(kitId);
+      if (!manifest) {
+        const menu2 = await loader.menuText();
+        return { action, kit: kitId, output: `Kit "${kitId}" not found.
+
+${menu2}` };
+      }
+      const resolvedStack = stack ?? manifest.stacks[0] ?? "web";
+      const body = await loader.readBody(manifest.id, resolvedStack);
+      const rawTokens = await loader.readTokens(manifest.id);
+      const persisted = await loadActiveKit(ctx.projectRoot);
+      const keepOverrides = persisted?.kit === manifest.id ? persisted.overrides ?? {} : {};
+      const overrides = { ...keepOverrides, ...normalizeOverrides(input.set) };
+      const tokens = rawTokens ? applyTokenOverrides(rawTokens, overrides) : rawTokens;
+      setActiveKit(ctx, manifest.id, resolvedStack, overrides);
+      await recordKitChoice(
+        ctx.projectRoot,
+        manifest.id,
+        resolvedStack,
+        "design-tool",
+        (/* @__PURE__ */ new Date()).toISOString(),
+        Object.keys(overrides).length ? overrides : void 0
+      );
+      const ovLine = Object.keys(overrides).length ? `
+Active color overrides: ${Object.entries(overrides).map(([k, v]) => `${k}=${v}`).join(", ")}
+` : "";
+      const header = `# Active design kit: ${manifest.name} (${manifest.id}) \u2014 stack: ${resolvedStack}
+${manifest.aesthetic}
+${ovLine}
+Implement the UI faithfully to this spec. Keep light/dark, responsive, and WCAG AA.
+`;
+      const tokenBlock = tokens ? `
+## Token snapshot (overrides applied)
+\`\`\`json
+${JSON.stringify(tokens, null, 2)}
+\`\`\`
+Tip: run \`design {action:"materialize"}\` to write these tokens to a real theme file.
+` : "";
+      return {
+        action,
+        kit: manifest.id,
+        stack: resolvedStack,
+        output: `${header}${tokenBlock}
+${body}`
+      };
+    }
+    if (action === "set") {
+      const patch = normalizeOverrides(input.set);
+      if (Object.keys(patch).length === 0) {
+        return { action, output: 'No overrides given. Pass set:{ "primary": "oklch(\u2026)" }.' };
+      }
+      const merged = await recordOverrides(ctx.projectRoot, patch, (/* @__PURE__ */ new Date()).toISOString());
+      if (!merged) {
+        return {
+          action,
+          output: 'No active kit. Pick one first: `design {action:"use", kit:"<id>"}`.'
+        };
+      }
+      setDesignOverrides(ctx, merged);
+      return {
+        action,
+        output: `Overrides updated. Active overrides: ${Object.entries(merged).map(([k, v]) => `${k}=${v}`).join(", ")}
+These win over kit tokens. Run \`design {action:"materialize"}\` to write them to a theme file.`
+      };
+    }
+    if (action === "materialize") {
+      const active = await loadActiveKit(ctx.projectRoot);
+      if (!active) {
+        return {
+          action,
+          output: 'No active kit. Pick one first: `design {action:"use", kit:"<id>"}`.'
+        };
+      }
+      const resolvedStack = stack ?? (active.stack && isDesignStack(active.stack) ? active.stack : "web");
+      const rawTokens = await loader.readTokens(active.kit);
+      if (!rawTokens) {
+        return { action, kit: active.kit, output: `Kit "${active.kit}" has no tokens.json.` };
+      }
+      const tokens = applyTokenOverrides(rawTokens, active.overrides);
+      const result = materializeTokens({
+        tokens,
+        stack: resolvedStack,
+        kitId: active.kit,
+        outPath: input.out
+      });
+      const root = await resolveReal(ctx.projectRoot);
+      const absResolved = path.isAbsolute(result.path) ? path.resolve(result.path) : path.resolve(path.join(ctx.projectRoot, result.path));
+      const absParent = await resolveReal(path.dirname(absResolved));
+      const abs = path.join(absParent, path.basename(absResolved));
+      const rel = path.relative(root, abs);
+      if (rel.startsWith("..") || path.isAbsolute(rel)) {
+        throw new Error(
+          `design: materialize path "${result.path}" would escape the project root`
+        );
+      }
+      let exists = false;
+      try {
+        await fs.access(abs);
+        exists = true;
+      } catch {
+      }
+      if (exists && !input.force) {
+        return {
+          action,
+          kit: active.kit,
+          stack: resolvedStack,
+          path: result.path,
+          output: `${result.path} already exists. Re-run with force:true to overwrite, or write this ${result.format} yourself:
+
+\`\`\`
+${result.content}
+\`\`\``
+        };
+      }
+      await fs.mkdir(path.dirname(abs), { recursive: true });
+      await fs.writeFile(abs, result.content);
+      return {
+        action,
+        kit: active.kit,
+        stack: resolvedStack,
+        path: result.path,
+        output: `Wrote ${result.format} to ${result.path}. Import these tokens in your UI so the kit palette is the source of truth. ${exists ? "(overwrote existing file)" : ""}`
+      };
+    }
+    if (action === "verify") {
+      const active = await loadActiveKit(ctx.projectRoot);
+      if (!active) {
+        return {
+          action,
+          output: 'No active kit to verify against. Pick one: `design {action:"use", kit:"<id>"}`.'
+        };
+      }
+      const rawTokens = await loader.readTokens(active.kit);
+      if (!rawTokens) {
+        return { action, kit: active.kit, output: `Kit "${active.kit}" has no tokens.json.` };
+      }
+      const tokens = applyTokenOverrides(rawTokens, active.overrides);
+      const report = await runDesignVerify(ctx.projectRoot, tokens, input.files);
+      const pct = Math.round(report.score * 100);
+      const top = report.violations.slice(0, 25).map((v) => `  ${v.file}:${v.line} \u2014 ${v.reason}: ${v.snippet}`).join("\n");
+      const summary = `Adherence: ${pct}% on-palette across ${report.filesScanned} file(s). ${report.violations.length} violation(s).` + (report.violations.length ? `
+${top}${report.violations.length > 25 ? `
+  \u2026and ${report.violations.length - 25} more` : ""}
+
+Replace off-palette colors with kit tokens (or the materialized CSS vars / token utilities).` : "\nNo off-palette colors found \u2014 UI adheres to the kit palette.");
+      return {
+        action,
+        kit: active.kit,
+        output: summary,
+        score: report.score,
+        violations: report.violations.length
+      };
+    }
+    const menu = await loader.menuText();
+    return {
+      action: "list",
+      output: (menu || "No design kits are installed.") + '\n\nLoad one with `design {action:"use", kit:"<id>", stack:"<stack>"}`.'
+    };
+  }
+};
+export {
+  designTool
+};
+//# sourceMappingURL=design.js.map

package/dist/design.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/design.ts"],
+  "sourcesContent": ["import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport type { DesignStack, Tool } from '@wrongstack/core';\nimport {\n  applyTokenOverrides,\n  getDesignKitLoader,\n  isDesignStack,\n  loadActiveKit,\n  materializeTokens,\n  recordKitChoice,\n  recordOverrides,\n  runDesignVerify,\n  setActiveKit,\n  setDesignOverrides,\n} from '@wrongstack/core';\n\ntype Overrides = Record<string, string>;\n\n/**\n * Canonicalize `p` through `fs.realpath` so symlinks / bind mounts don't\n * hide out-of-root writes. Falls back to `path.resolve(p)` when the path\n * (or any of its parents) doesn't exist yet \u2014 callers frequently pass a\n * destination that the tool is about to write.\n */\nasync function resolveReal(p: string): Promise<string> {\n  const resolved = path.resolve(p);\n  let probe = resolved;\n  const missing: string[] = [];\n  for (;;) {\n    try {\n      return path.resolve(await fs.realpath(probe), ...missing);\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        const parent = path.dirname(probe);\n        if (parent === probe) return resolved; // reached fs root\n        missing.unshift(path.basename(probe));\n        probe = parent;\n        continue;\n      }\n      // Any other error (EACCES, EBUSY, \u2026) \u2014 fall back to the lexical\n      // resolve rather than throwing, so the caller can still surface a\n      // meaningful error from the path.relative check below.\n      return resolved;\n    }\n  }\n}\n\ninterface DesignInput {\n  action?: 'list' | 'use' | 'foundations' | 'set' | 'materialize' | 'verify' | undefined;\n  kit?: string | undefined;\n  stack?: string | undefined;\n  /** action \"set\" / \"use\": token overrides, e.g. { primary: \"oklch(...)\", \"dark.bg\": \"#111\" }. */\n  set?: Overrides | undefined;\n  /** action \"materialize\": output path (project-relative); defaults per stack. */\n  out?: string | undefined;\n  /** action \"materialize\": overwrite an existing file. */\n  force?: boolean | undefined;\n  /** action \"verify\": explicit files to scan (project-relative). Defaults to a UI-file walk. */\n  files?: string[] | undefined;\n}\n\ninterface DesignOutput {\n  action: string;\n  kit?: string | undefined;\n  stack?: string | undefined;\n  output: string;\n  /** action \"materialize\": where the theme file was (or would be) written. */\n  path?: string | undefined;\n  /** action \"verify\": adherence score 0..1 and violation count. */\n  score?: number | undefined;\n  violations?: number | undefined;\n}\n\nfunction normalizeOverrides(set: unknown): Overrides {\n  const out: Overrides = {};\n  if (set && typeof set === 'object') {\n    for (const [k, v] of Object.entries(set as Record<string, unknown>)) {\n      if (typeof v === 'string') out[k] = v;\n    }\n  }\n  return out;\n}\n\n/**\n * Design Studio tool \u2014 progressive disclosure + token enforcement.\n *\n * `list`/`use`/`foundations` browse and pin kits. `set` records structured color\n * overrides (these win over kit tokens). `materialize` writes the active kit's\n * (override-applied) tokens to a real, stack-appropriate theme file so the\n * palette becomes the codebase's source of truth \u2014 not just a prompt hint.\n * `verify` scans UI files for off-palette drift.\n */\nexport const designTool: Tool<DesignInput, DesignOutput> = {\n  name: 'design',\n  category: 'Design',\n  description:\n    'Browse, load, customize, and enforce curated frontend/mobile UI design kits. Use BEFORE writing ' +\n    'UI code to commit to one coherent, modern, responsive, dark/light, accessible design. Actions: ' +\n    '\"list\" (menu), \"use\" (load+pin a kit for a stack), \"foundations\" (baseline), \"set\" (override kit ' +\n    'colors/tokens), \"materialize\" (write the tokens to a real theme file \u2014 CSS @theme/OKLCH or native), ' +\n    '\"verify\" (scan UI files for off-palette colors).',\n  usageHint:\n    'Flow: `design {action:\"use\", kit:\"minimal-clarity\", stack:\"web\"}` \u2192 optionally ' +\n    '`design {action:\"set\", set:{primary:\"oklch(62% 0.2 25)\"}}` \u2192 `design {action:\"materialize\"}` ' +\n    'to write tokens to disk \u2192 implement against them \u2192 `design {action:\"verify\"}`.',\n  permission: 'confirm',\n  mutating: true,\n  capabilities: ['fs.write'],\n  timeoutMs: 15_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      action: {\n        type: 'string',\n        enum: ['list', 'use', 'foundations', 'set', 'materialize', 'verify'],\n        description:\n          'list = menu; use = load+pin a kit; foundations = baseline; set = override colors/tokens; ' +\n          'materialize = write tokens to a theme file; verify = scan UI for off-palette colors. Default: list.',\n      },\n      kit: {\n        type: 'string',\n        description: 'Kit id (required for \"use\"), e.g. \"minimal-clarity\", \"neo-brutalist\".',\n      },\n      stack: {\n        type: 'string',\n        enum: ['web', 'react-native', 'flutter', 'swiftui', 'compose'],\n        description: 'Target stack \u2014 narrows guidance + materialize format. Default: web.',\n      },\n      set: {\n        type: 'object',\n        description:\n          'Token overrides for \"set\"/\"use\": { \"primary\": \"oklch(\u2026)\", \"dark.bg\": \"#111\" }. Bare key = ' +\n          'both themes; \"light.\"/\"dark.\" prefix = that theme only. Empty value clears an override.',\n        additionalProperties: { type: 'string' },\n      },\n      out: {\n        type: 'string',\n        description: 'Materialize output path (project-relative). Defaults to a per-stack convention.',\n      },\n      force: {\n        type: 'boolean',\n        description: 'Materialize: overwrite an existing file (default false \u2014 refuses to clobber).',\n      },\n      files: {\n        type: 'array',\n        items: { type: 'string' },\n        description: 'Verify: explicit project-relative files to scan. Default: a bounded UI-file walk.',\n      },\n    },\n    required: [],\n  },\n  async execute(input, ctx): Promise<DesignOutput> {\n    const loader = getDesignKitLoader(ctx.projectRoot);\n    const action = input.action ?? 'list';\n    const stack: DesignStack | undefined =\n      input.stack && isDesignStack(input.stack) ? input.stack : undefined;\n\n    if (action === 'foundations') {\n      const text = await loader.foundationsText(stack);\n      return { action, stack, output: text || 'No foundations document is installed.' };\n    }\n\n    if (action === 'use') {\n      const kitId = input.kit?.trim();\n      if (!kitId) {\n        const menu = await loader.menuText();\n        return { action, output: `No kit id provided.\\n\\n${menu}` };\n      }\n      const manifest = await loader.find(kitId);\n      if (!manifest) {\n        const menu = await loader.menuText();\n        return { action, kit: kitId, output: `Kit \"${kitId}\" not found.\\n\\n${menu}` };\n      }\n      const resolvedStack = stack ?? manifest.stacks[0] ?? 'web';\n      const body = await loader.readBody(manifest.id, resolvedStack);\n      const rawTokens = await loader.readTokens(manifest.id);\n      // Preserve any persisted overrides; merge in any passed with `use`.\n      const persisted = await loadActiveKit(ctx.projectRoot);\n      const keepOverrides =\n        persisted?.kit === manifest.id ? (persisted.overrides ?? {}) : {};\n      const overrides: Overrides = { ...keepOverrides, ...normalizeOverrides(input.set) };\n      const tokens = rawTokens ? applyTokenOverrides(rawTokens, overrides) : rawTokens;\n\n      setActiveKit(ctx, manifest.id, resolvedStack, overrides);\n      await recordKitChoice(\n        ctx.projectRoot,\n        manifest.id,\n        resolvedStack,\n        'design-tool',\n        new Date().toISOString(),\n        Object.keys(overrides).length ? overrides : undefined,\n      );\n\n      const ovLine = Object.keys(overrides).length\n        ? `\\nActive color overrides: ${Object.entries(overrides)\n            .map(([k, v]) => `${k}=${v}`)\n            .join(', ')}\\n`\n        : '';\n      const header =\n        `# Active design kit: ${manifest.name} (${manifest.id}) \u2014 stack: ${resolvedStack}\\n` +\n        `${manifest.aesthetic}\\n${ovLine}\\n` +\n        'Implement the UI faithfully to this spec. Keep light/dark, responsive, and WCAG AA.\\n';\n      const tokenBlock = tokens\n        ? `\\n## Token snapshot (overrides applied)\\n\\`\\`\\`json\\n${JSON.stringify(tokens, null, 2)}\\n\\`\\`\\`\\n` +\n          'Tip: run `design {action:\"materialize\"}` to write these tokens to a real theme file.\\n'\n        : '';\n      return {\n        action,\n        kit: manifest.id,\n        stack: resolvedStack,\n        output: `${header}${tokenBlock}\\n${body}`,\n      };\n    }\n\n    if (action === 'set') {\n      const patch = normalizeOverrides(input.set);\n      if (Object.keys(patch).length === 0) {\n        return { action, output: 'No overrides given. Pass set:{ \"primary\": \"oklch(\u2026)\" }.' };\n      }\n      const merged = await recordOverrides(ctx.projectRoot, patch, new Date().toISOString());\n      if (!merged) {\n        return {\n          action,\n          output: 'No active kit. Pick one first: `design {action:\"use\", kit:\"<id>\"}`.',\n        };\n      }\n      setDesignOverrides(ctx, merged);\n      return {\n        action,\n        output:\n          `Overrides updated. Active overrides: ${Object.entries(merged)\n            .map(([k, v]) => `${k}=${v}`)\n            .join(', ')}\\n` +\n          'These win over kit tokens. Run `design {action:\"materialize\"}` to write them to a theme file.',\n      };\n    }\n\n    if (action === 'materialize') {\n      const active = await loadActiveKit(ctx.projectRoot);\n      if (!active) {\n        return {\n          action,\n          output: 'No active kit. Pick one first: `design {action:\"use\", kit:\"<id>\"}`.',\n        };\n      }\n      const resolvedStack: DesignStack =\n        stack ?? (active.stack && isDesignStack(active.stack) ? active.stack : 'web');\n      const rawTokens = await loader.readTokens(active.kit);\n      if (!rawTokens) {\n        return { action, kit: active.kit, output: `Kit \"${active.kit}\" has no tokens.json.` };\n      }\n      const tokens = applyTokenOverrides(rawTokens, active.overrides);\n      const result = materializeTokens({\n        tokens,\n        stack: resolvedStack,\n        kitId: active.kit,\n        outPath: input.out,\n      });\n      // Containment: result.path derives from caller-supplied input.out and\n      // may be either relative (joined under projectRoot) or absolute\n      // (used as-is). Pin the write inside the project root, mirroring the\n      // scaffold tool.\n      //\n      // #249 (design.ts escape check): resolve both sides through fs.realpath\n      // before the relative check, so symlinks / bind mounts (e.g. /tmp on\n      // CI runners is often a symlink to /private/tmp) can't smuggle an\n      // out-of-root path past the prefix-startsWith-`..` guard. The\n      // destination file does not exist yet, so realpath the parent\n      // directory and re-join the basename.\n      //\n      // Note: on Windows, path.join(absoluteA, absoluteB) concatenates\n      // literally (path.join('C:\\\\A\\\\B', 'C:\\\\A\\\\C.css') === 'C:\\\\A\\\\B\\\\C:\\\\A\\\\C.css')\n      // rather than collapsing absoluteB onto the drive root. Treating\n      // absolute result.path as absolute (not as a join-input) keeps the\n      // behavior consistent across platforms and is what the test asserts.\n      const root = await resolveReal(ctx.projectRoot);\n      const absResolved = path.isAbsolute(result.path)\n        ? path.resolve(result.path)\n        : path.resolve(path.join(ctx.projectRoot, result.path));\n      const absParent = await resolveReal(path.dirname(absResolved));\n      const abs = path.join(absParent, path.basename(absResolved));\n      const rel = path.relative(root, abs);\n      if (rel.startsWith('..') || path.isAbsolute(rel)) {\n        throw new Error(\n          `design: materialize path \"${result.path}\" would escape the project root`,\n        );\n      }\n      let exists = false;\n      try {\n        await fs.access(abs);\n        exists = true;\n      } catch {\n        // does not exist \u2014 safe to write\n      }\n      if (exists && !input.force) {\n        return {\n          action,\n          kit: active.kit,\n          stack: resolvedStack,\n          path: result.path,\n          output:\n            `${result.path} already exists. Re-run with force:true to overwrite, or write this ` +\n            `${result.format} yourself:\\n\\n\\`\\`\\`\\n${result.content}\\n\\`\\`\\``,\n        };\n      }\n      await fs.mkdir(path.dirname(abs), { recursive: true });\n      await fs.writeFile(abs, result.content);\n      return {\n        action,\n        kit: active.kit,\n        stack: resolvedStack,\n        path: result.path,\n        output:\n          `Wrote ${result.format} to ${result.path}. Import these tokens in your UI so the kit ` +\n          `palette is the source of truth. ${exists ? '(overwrote existing file)' : ''}`,\n      };\n    }\n\n    if (action === 'verify') {\n      const active = await loadActiveKit(ctx.projectRoot);\n      if (!active) {\n        return {\n          action,\n          output: 'No active kit to verify against. Pick one: `design {action:\"use\", kit:\"<id>\"}`.',\n        };\n      }\n      const rawTokens = await loader.readTokens(active.kit);\n      if (!rawTokens) {\n        return { action, kit: active.kit, output: `Kit \"${active.kit}\" has no tokens.json.` };\n      }\n      const tokens = applyTokenOverrides(rawTokens, active.overrides);\n      const report = await runDesignVerify(ctx.projectRoot, tokens, input.files);\n      const pct = Math.round(report.score * 100);\n      const top = report.violations\n        .slice(0, 25)\n        .map((v) => `  ${v.file}:${v.line} \u2014 ${v.reason}: ${v.snippet}`)\n        .join('\\n');\n      const summary =\n        `Adherence: ${pct}% on-palette across ${report.filesScanned} file(s). ` +\n        `${report.violations.length} violation(s).` +\n        (report.violations.length\n          ? `\\n${top}${report.violations.length > 25 ? `\\n  \u2026and ${report.violations.length - 25} more` : ''}` +\n            `\\n\\nReplace off-palette colors with kit tokens (or the materialized CSS vars / token utilities).`\n          : '\\nNo off-palette colors found \u2014 UI adheres to the kit palette.');\n      return {\n        action,\n        kit: active.kit,\n        output: summary,\n        score: report.score,\n        violations: report.violations.length,\n      };\n    }\n\n    // Default: list\n    const menu = await loader.menuText();\n    return {\n      action: 'list',\n      output:\n        (menu || 'No design kits are installed.') +\n        '\\n\\nLoad one with `design {action:\"use\", kit:\"<id>\", stack:\"<stack>\"}`.',\n    };\n  },\n};\n"],
+  "mappings": "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",
+  "names": ["menu"]
+}

package/dist/diff.d.ts

@@ -1,5 +1,4 @@
-import { Tool } from '@wrongstack/core';
-
+import type { Tool } from '@wrongstack/core';
 interface DiffInput {
     path?: string | undefined;
     files?: string | string[] | undefined;
@@ -15,6 +14,6 @@ interface DiffOutput {
     truncated: boolean;
     mode: string;
 }
-declare const diffTool: Tool<DiffInput, DiffOutput>;
-
-export { diffTool };
+export declare const diffTool: Tool<DiffInput, DiffOutput>;
+export {};
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CA8DhD,CAAC"}

package/dist/diff.js

@@ -1,11 +1,13 @@
-import { spawn } from 'node:child_process';
-import { statSync } from 'node:fs';
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import * as Core from '@wrongstack/core';
-import { buildChildEnv } from '@wrongstack/core';
-
 // src/diff.ts
+import { spawn } from "node:child_process";
+import { statSync } from "node:fs";
+import * as fs from "node:fs/promises";
+import * as path2 from "node:path";
+import { buildChildEnv } from "@wrongstack/core";
+
+// src/_util.ts
+import * as path from "node:path";
+import * as Core from "@wrongstack/core";
 function resolvePath(input, ctx) {
   return path.isAbsolute(input) ? path.normalize(input) : path.resolve(ctx.workingDir ?? ctx.cwd, input);
 }
@@ -111,11 +113,11 @@ function findGitDir(cwd) {
   let dir = cwd;
   for (let i = 0; i < 20; i++) {
     try {
-      const stat2 = statSync(path.join(dir, ".git"));
+      const stat2 = statSync(path2.join(dir, ".git"));
       if (stat2.isDirectory()) return dir;
     } catch {
     }
-    const parent = path.dirname(dir);
+    const parent = path2.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
@@ -175,7 +177,7 @@ function formatWithLineNumbers(file, lines) {
   return `--- ${file} (line-numbered dump, not a unified diff) ---
 ${numbered}`;
 }
-
-export { diffTool };
+export {
+  diffTool
+};
 //# sourceMappingURL=diff.js.map
-//# sourceMappingURL=diff.js.map