@wrongstack/tools 0.310.1 → 0.313.1

package/dist/design.js

@@ -1,303 +1,6 @@
-// src/design.ts
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
 import {
-  applyTokenOverrides,
-  getDesignKitLoader,
-  isDesignStack,
-  loadActiveKit,
-  materializeTokens,
-  recordKitChoice,
-  recordOverrides,
-  resolveSemanticTune,
-  runDesignVerify,
-  setActiveKit,
-  setDesignOverrides
-} from "@wrongstack/core/design";
-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",
-  // WS-046: gives permission decisions something to key on.
-  // The action performed; `out` is optional so it cannot be the subject.
-  subjectKey: "action",
-  mutating: true,
-  capabilities: ["fs.write"],
-  timeoutMs: 15e3,
-  inputSchema: {
-    type: "object",
-    properties: {
-      action: {
-        type: "string",
-        enum: ["list", "use", "foundations", "set", "tune", "materialize", "verify"],
-        description: "list = menu; use = load+pin a kit; foundations = baseline; set = override colors/tokens; tune = high-level knobs (radius/density/font/motion); materialize = write tokens to a theme file; verify = scan UI for token drift. 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" }
-      },
-      tune: {
-        type: "object",
-        description: 'High-level knobs for "tune": { "radius": "lg", "density": "compact", "font": "Space Grotesk", "motion": "snappy" }. radius = none|sm|md|lg|xl|full or a base length; density = compact|cozy|comfortable; motion = snappy|smooth|none. Resolved to concrete token overrides.',
-        properties: {
-          radius: { type: "string" },
-          density: { type: "string" },
-          font: { type: "string" },
-          motion: { 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 === "tune") {
-      const patch = resolveSemanticTune(input.tune ?? {});
-      if (Object.keys(patch).length === 0) {
-        return {
-          action,
-          output: 'No recognized knobs. Pass tune:{ radius:"lg", density:"compact", font:"\u2026", motion:"snappy" }.'
-        };
-      }
-      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: `Tuned. Resolved ${Object.keys(patch).length} token override(s): ${Object.entries(patch).map(([k, v]) => `${k}=${v}`).join(", ")}
-Run \`design {action:"materialize"}\` to write the tuned tokens to your 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>"}`.'
-    };
-  }
-};
+  designTool
+} from "./chunk-6RNIFLG4.js";
 export {
   designTool
 };

package/dist/diff.js

@@ -1,259 +1,7 @@
-// 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/utils";
-import { ToolValidationError } from "@wrongstack/core/types";
-
-// src/_util.ts
-import * as fsp from "node:fs/promises";
-import * as path from "node:path";
-import * as Core from "@wrongstack/core/utils";
-function resolvePath(input, ctx) {
-  return path.isAbsolute(input) ? path.normalize(input) : path.resolve(ctx.workingDir ?? ctx.cwd, input);
-}
-function allowedRoots(ctx) {
-  return [path.resolve(ctx.projectRoot), path.resolve(Core.wstackGlobalRoot())];
-}
-function isInsideAny(target, roots) {
-  return roots.some((root) => {
-    const rel = path.relative(root, target);
-    return rel === "" || !rel.startsWith("..") && !path.isAbsolute(rel);
-  });
-}
-function ensureInsideRoot(absPath, ctx) {
-  const target = path.resolve(absPath);
-  if (ctx.allowOutsideProjectRoot) return target;
-  if (isInsideAny(target, allowedRoots(ctx))) return target;
-  throw new Error(`Path "${absPath}" is outside project root "${path.resolve(ctx.projectRoot)}"`);
-}
-function safeResolve(input, ctx) {
-  return ensureInsideRoot(resolvePath(input, ctx), ctx);
-}
-async function resolveRealInsideRoot(absPath, ctx) {
-  if (ctx.allowOutsideProjectRoot) return absPath;
-  const realRoots = await Promise.all(
-    allowedRoots(ctx).map((r) => fsp.realpath(r).catch(() => path.resolve(r)))
-  );
-  let probe = absPath;
-  const pendingTail = [];
-  for (; ; ) {
-    let real;
-    try {
-      real = await fsp.realpath(probe);
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        const parent = path.dirname(probe);
-        if (parent === probe) return absPath;
-        pendingTail.unshift(path.basename(probe));
-        probe = parent;
-        continue;
-      }
-      throw err;
-    }
-    const candidate = pendingTail.length > 0 ? path.join(real, ...pendingTail) : real;
-    if (isInsideAny(candidate, realRoots)) {
-      return candidate;
-    }
-    throw new Error(
-      `Path "${absPath}" resolves through a symlink outside project root "${realRoots[0]}"`
-    );
-  }
-}
-async function safeResolveReal(input, ctx) {
-  const abs = safeResolve(input, ctx);
-  return await resolveRealInsideRoot(abs, ctx);
-}
-
-// src/diff.ts
-var MAX_FILE_DUMP_BYTES = 5 * 1024 * 1024;
-var MAX_GIT_DIFF_CHARS = 1e5;
-var diffTool = {
-  name: "diff",
-  category: "Filesystem",
-  description: "Show file content with line numbers, staged/working-tree diffs via git, or commit/branch diffs. A safer and more structured alternative to raw `git diff` via shell.",
-  usageHint: 'USE FOR CODE REVIEW AND CHANGE INSPECTION:\n\n- `files` + no `a`/`b` \u2192 show file content with line numbers (NOT a unified diff; no +/- prefixes). Result `mode` is "dump".\n- `a` and/or `b` \u2192 git-style commit/branch diff (unified format, real +/- prefixes).\n- `staged: true` \u2192 only show staged changes.\n- `mode` only affects the git-diff path: "stat" runs `git diff --stat`; "side-by-side" is not supported and falls back to unified (result `mode` reports what was produced).\n- `context` sets the unified-diff context line count on the git path (`-U<n>`); the dump path has no context notion.\n\nNOTE: For a true file-vs-file unified diff, supply `a` and `b` so the tool delegates to `git diff`. The `files`-only path is a line-numbered dump, not a diff.\n\nThis tool has important safety guards against flag injection (see previous security findings).',
-  permission: "auto",
-  mutating: false,
-  maxOutputBytes: 262144,
-  capabilities: ["fs.read"],
-  icon: "diff",
-  timeoutMs: 1e4,
-  inputSchema: {
-    type: "object",
-    properties: {
-      path: {
-        type: "string",
-        description: "Working directory for the diff operation (defaults to project root)."
-      },
-      files: {
-        type: "string",
-        description: 'Files or globs to diff (e.g. "src/**/*.ts" or comma-separated list).'
-      },
-      a: {
-        type: "string",
-        description: "First ref/commit/branch for git diff (e.g. HEAD, main, a commit hash)."
-      },
-      b: {
-        type: "string",
-        description: "Second ref/commit/branch for git diff."
-      },
-      staged: {
-        type: "boolean",
-        description: "If true, only show changes that are staged in git."
-      },
-      mode: {
-        type: "string",
-        enum: ["unified", "side-by-side", "stat"],
-        description: 'Output format for the git-diff path. "unified" is default; "stat" shows a summary only; "side-by-side" is not supported and falls back to unified. The `files`-only dump path ignores this.'
-      },
-      context: {
-        type: "integer",
-        minimum: 0,
-        description: "Number of context lines for git unified diffs (default: 3, passed as -U<n>). Ignored by the `files`-only dump path."
-      }
-    }
-  },
-  async execute(input, ctx, opts) {
-    if (input.a !== void 0 || input.b !== void 0) {
-      return await gitDiff(input, ctx, opts.signal);
-    }
-    return await fileDiff(input, ctx, opts.signal);
-  }
-};
-async function gitDiff(input, ctx, signal) {
-  if (input.a?.startsWith("-")) {
-    throw new ToolValidationError({
-      message: `diff: unsafe ref "${input.a}" \u2014 refs may not begin with '-' (flag injection)`,
-      field: "a"
-    });
-  }
-  if (input.b?.startsWith("-")) {
-    throw new ToolValidationError({
-      message: `diff: unsafe ref "${input.b}" \u2014 refs may not begin with '-' (flag injection)`,
-      field: "b"
-    });
-  }
-  const requestedMode = input.mode ?? "unified";
-  const statMode = requestedMode === "stat";
-  const effectiveMode = statMode ? "stat" : "unified";
-  const sideBySideNote = requestedMode === "side-by-side" ? "side-by-side output is not supported; a unified diff was produced instead." : void 0;
-  const gitDir = findGitDir(ctx.cwd);
-  if (!gitDir) {
-    return { diff: "", files: [], truncated: false, mode: effectiveMode };
-  }
-  const args = ["diff", "--no-color"];
-  if (statMode) args.push("--stat");
-  if (!statMode && input.context !== void 0) {
-    const contextLines = Math.max(0, Math.floor(input.context));
-    if (Number.isFinite(contextLines)) args.push(`-U${contextLines}`);
-  }
-  if (input.staged) args.push("--staged");
-  if (input.a) args.push(input.a);
-  if (input.b) args.push(input.b);
-  if (input.files) {
-    const files = Array.isArray(input.files) ? input.files : input.files.split(",");
-    args.push("--", ...files.map((f) => f.trim()));
-  }
-  const result = await runGit(args, gitDir, signal);
-  let diff = result.stdout;
-  let truncated = false;
-  if (diff.length > MAX_GIT_DIFF_CHARS) {
-    let clipped = diff.slice(0, MAX_GIT_DIFF_CHARS);
-    const nl = clipped.lastIndexOf("\n");
-    if (nl > 0) clipped = clipped.slice(0, nl);
-    diff = `${clipped}
-\u2026[git diff truncated: ${result.stdout.length - clipped.length} of ${result.stdout.length} characters omitted]`;
-    truncated = true;
-  }
-  return {
-    diff,
-    files: [],
-    truncated,
-    mode: effectiveMode,
-    note: sideBySideNote
-  };
-}
-function findGitDir(cwd) {
-  let dir = cwd;
-  for (let i = 0; i < 20; i++) {
-    try {
-      const stat2 = statSync(path2.join(dir, ".git"));
-      if (stat2.isDirectory()) return dir;
-    } catch {
-    }
-    const parent = path2.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
-}
-function runGit(args, cwd, signal) {
-  return new Promise((resolve2) => {
-    let stdout = "";
-    let stderr = "";
-    const child = spawn("git", args, {
-      cwd,
-      signal,
-      env: buildChildEnv(),
-      stdio: ["ignore", "pipe", "pipe"],
-      windowsHide: true
-    });
-    child.stdout?.on("data", (c) => {
-      stdout += c.toString();
-    });
-    child.stderr?.on("data", (c) => {
-      stderr += c.toString();
-    });
-    child.on("close", (code) => resolve2({ stdout, stderr, exitCode: code ?? 0 }));
-    child.on("error", (e) => resolve2({ stdout: "", stderr: e.message, exitCode: 1 }));
-  });
-}
-async function fileDiff(input, ctx, _signal) {
-  void input.context;
-  const files = input.files ? (Array.isArray(input.files) ? input.files : input.files.split(",")).map((f) => f.trim()).filter(Boolean) : [];
-  if (files.length === 0) {
-    return {
-      diff: "No files specified",
-      files: [],
-      truncated: false,
-      mode: "dump"
-    };
-  }
-  const results = [];
-  let truncated = false;
-  for (const file of files) {
-    const absPath = await safeResolveReal(file, ctx);
-    const stat2 = await fs.stat(absPath).catch(() => null);
-    if (!stat2?.isFile()) continue;
-    if (stat2.size > MAX_FILE_DUMP_BYTES) {
-      truncated = true;
-      results.push(
-        `--- ${file} (skipped: ${stat2.size} bytes exceeds the ${MAX_FILE_DUMP_BYTES} limit; use the read tool with offset/limit) ---`
-      );
-      continue;
-    }
-    const content = await fs.readFile(absPath, "utf8");
-    const lines = content.split(/\r?\n/);
-    results.push(formatWithLineNumbers(file, lines));
-  }
-  return {
-    diff: results.join("\n\n"),
-    files,
-    truncated,
-    // Honest mode: this path always produces a line-numbered dump — it never
-    // honors `mode`, so it must not echo the requested value back.
-    mode: "dump",
-    note: input.mode !== void 0 ? "The `files`-only path is a line-numbered dump; `mode` only affects the git-diff path (`a`/`b`)." : void 0
-  };
-}
-function formatWithLineNumbers(file, lines) {
-  const width = String(lines.length).length;
-  const numbered = lines.map((line, i) => `${String(i + 1).padStart(width)} | ${line}`).join("\n");
-  return `--- ${file} (line-numbered dump, not a unified diff) ---
-${numbered}`;
-}
+import {
+  diffTool
+} from "./chunk-UKU2ZX4C.js";
+import "./chunk-D33S4RQG.js";
 export {
   diffTool
 };