toolfactory 0.1.1

package/dist/surfaces/shared.js

@@ -0,0 +1,112 @@
+/** Helpers shared by surface projectors. Pure. */
+import { projectName } from "../identity/name.js";
+import { PORTABLE_CAPABILITIES } from "../model.js";
+import { defaultVerdict } from "../report/coverage.js";
+export const TOOLFACTORY_DIR = "dev.toolfactory";
+export function json(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+/** Drop undefined values so projections never emit `"key": undefined`. */
+export function compact(record) {
+    return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+}
+export function has(project, surface) {
+    return project.tool.surfaces.includes(surface);
+}
+export function npmName(project) {
+    return projectName.npm(project.identity.name, project.tool.npm?.scope);
+}
+export function pypiName(project) {
+    return projectName.pypi(project.identity.name);
+}
+/** The launch command for the kernel MCP server as an installed package or a committed build. */
+export function kernelLaunch(project, placeholderRoot) {
+    const { binding, bundle } = project.tool;
+    const version = project.identity.version ?? "latest";
+    if (bundle.runtime === "bundled") {
+        return binding === "python"
+            ? { command: "python3", args: [`${placeholderRoot}/bin/mcp.py`] }
+            : { command: "node", args: [`${placeholderRoot}/bin/mcp.js`] };
+    }
+    return binding === "python"
+        ? {
+            command: "uvx",
+            args: ["--from", `${pypiName(project)}==${version}`, project.identity.name, "mcp"],
+        }
+        : { command: "npx", args: ["-y", `${npmName(project)}@${version}`, "mcp"] };
+}
+/** Verdict for surfaces that only carry MCP tool calls: no host capabilities at all. */
+export function mcpVerdict(operation) {
+    const verdict = defaultVerdict(operation);
+    return verdict.kind === "excluded"
+        ? { kind: "excluded", reason: "excluded:mcp-no-host-capabilities" }
+        : verdict;
+}
+/** Verdict for skills hosts: non-portable operations are bridged by the agent driving the host's own tools. */
+/** A CLI has a human at the terminal, so user-input is native there; other host capabilities are not. */
+export function cliVerdict(operation) {
+    const portable = operation.requires.every((capability) => PORTABLE_CAPABILITIES.has(capability) || capability === "user-input");
+    return portable
+        ? { kind: "native" }
+        : { kind: "excluded", reason: "excluded:cli-no-host-capabilities" };
+}
+/** A skill never executes: the agent drives the CLI or MCP server, so everything it can reach is bridged. */
+export function skillVerdict(operation) {
+    if (operation.requires.includes("channel"))
+        return { kind: "excluded", reason: "excluded:no-channel-bridge" };
+    return { kind: "bridged", reason: "bridged:agent-mediated" };
+}
+export function configProperties(project) {
+    const properties = project.tool.config?.properties;
+    return properties && typeof properties === "object"
+        ? properties
+        : {};
+}
+export function isSensitive(property) {
+    const meta = property["x-toolfactory"];
+    return meta?.sensitive === true;
+}
+export function requiredConfig(project) {
+    const required = project.tool.config?.required;
+    return Array.isArray(required) ? required : [];
+}
+/** The environment variable a config key is read from, on every surface and in every environment. */
+export function envName(key) {
+    return key.toUpperCase().replace(/[^A-Z0-9]/g, "_");
+}
+/**
+ * Environment variable a host-native shim reads to find the tool's checkout when the host
+ * copied the plugin elsewhere (Hermes' doctor, OpenClaw's extensions directory).
+ */
+export function rootEnvName(project) {
+    return `${project.identity.name.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_ROOT`;
+}
+/**
+ * The environment variable a host passes the tool's per-instance data directory
+ * (caches, session state) through, on every surface. The kernel falls back to an
+ * XDG-style default when it is unset.
+ */
+export function dataDirEnvName(project) {
+    return `${project.identity.name.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_DATA_DIR`;
+}
+/**
+ * The credentials a live run needs: every config key that is both `required` and sensitive.
+ * A tool with none has nothing to gate a live tier on, so no live test and no `live` CI job.
+ */
+export function liveCredentials(project) {
+    const properties = configProperties(project);
+    const required = new Set(requiredConfig(project));
+    return Object.keys(properties).filter((key) => required.has(key) && isSensitive(properties[key]));
+}
+/**
+ * The operation the generated example test calls: the first one with arguments in
+ * `tool.json` `tests.examples`, else the first operation with no arguments.
+ */
+export function liveExample(project) {
+    const examples = project.tool.tests.examples;
+    const withExample = project.operations.find((operation) => examples[operation.name]);
+    const operation = withExample ?? project.operations[0];
+    if (!operation)
+        return undefined;
+    return { name: operation.name, args: examples[operation.name] ?? {} };
+}

package/dist/surfaces/skill.d.ts

@@ -0,0 +1,7 @@
+import { type Project, type Surface } from "../model.js";
+export declare const OPERATIONS_BEGIN = "<!-- tf:operations -->";
+export declare const OPERATIONS_END = "<!-- /tf:operations -->";
+export declare function skillPath(project: Project): string;
+export declare function renderOperations(project: Project): string;
+export declare function frontmatter(project: Project): string;
+export declare const surface: Surface;

package/dist/surfaces/skill.js

@@ -0,0 +1,118 @@
+/**
+ * Agent Skills: one `skills/<N>/SKILL.md` per tool. toolfactory owns the frontmatter and
+ * the `<!-- tf:operations -->` block; the body is the author's prose and is never generated.
+ * The bundle formats (Agent Plugins, Claude, Codex, Cursor) fix `skills/` at the bundle root,
+ * while Copilot, Codex, Hermes and DSH read a project's skills only from `.agents/skills/`
+ * (and `npx skills add` reads both): a symbolic link there is the one directory that serves all.
+ */
+import { stringify as yaml } from "yaml";
+import { isInstructionOnly, } from "../model.js";
+import { compact, has, skillVerdict } from "./shared.js";
+export const OPERATIONS_BEGIN = "<!-- tf:operations -->";
+export const OPERATIONS_END = "<!-- /tf:operations -->";
+export function skillPath(project) {
+    return `skills/${project.identity.name}/SKILL.md`;
+}
+/** The `.agents/` canon's view of the same skill, which `.agents/sync.py` fans out to every harness. */
+function skillLinkPath(project) {
+    return `.agents/skills/${project.identity.name}`;
+}
+function invocation(project, operation) {
+    const name = project.identity.name;
+    const lines = [];
+    if (has(project, "cli"))
+        lines.push(`\`${name} ${operation.name} --json '<arguments>'\` prints a JSON result.`);
+    if (has(project, "mcp") || has(project, "agent-plugins")) {
+        lines.push(`MCP tool \`${operation.name}\` on server \`${name}\` returns the same result as \`structuredContent\`.`);
+    }
+    return lines.join(" ");
+}
+/** How an agent bridges each non-portable capability before calling the operation. */
+const GUIDANCE = {
+    browser: "drive this host's own browser tools and pass what they return as arguments",
+    model: "do that reasoning yourself and pass the result as an argument",
+    "user-input": "ask the user for what it needs before calling it",
+};
+export function renderOperations(project) {
+    if (isInstructionOnly(project.tool))
+        return "";
+    const lines = ["", "## Operations", ""];
+    if (project.operations.length === 0) {
+        lines.push("_No operations yet: run `toolfactory introspect` after adding one to the kernel._");
+    }
+    for (const operation of project.operations) {
+        const verdict = skillVerdict(operation);
+        if (verdict.kind === "excluded")
+            continue;
+        const required = Object.keys(operation.inputSchema.properties ?? {});
+        lines.push(`### ${operation.name}`, "");
+        if (operation.description)
+            lines.push(operation.description, "");
+        if (required.length)
+            lines.push(`Arguments: ${required.map((k) => `\`${k}\``).join(", ")}.`, "");
+        const how = invocation(project, operation);
+        if (how)
+            lines.push(how, "");
+        const needs = operation.requires.filter((capability) => GUIDANCE[capability]);
+        if (verdict.kind === "bridged" && needs.length) {
+            lines.push(`This operation needs ${needs.join(", ")}: ${needs.map((capability) => GUIDANCE[capability]).join("; ")}.`, "");
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function frontmatter(project) {
+    const document = compact({
+        name: project.identity.name,
+        description: project.identity.description ?? `Use the ${project.identity.name} tool.`,
+        license: project.identity.license,
+    });
+    return `\n${yaml(document).trimEnd()}\n`;
+}
+export const surface = {
+    id: "skill",
+    plan(project) {
+        const path = skillPath(project);
+        const regions = [
+            { begin: "---", end: "---", content: frontmatter(project) },
+            { begin: OPERATIONS_BEGIN, end: OPERATIONS_END, content: renderOperations(project) },
+        ];
+        const template = [
+            "---",
+            "---",
+            "",
+            `# ${project.identity.name}`,
+            "",
+            "Explain here when an agent should reach for this tool and how to combine its operations.",
+            "",
+            OPERATIONS_BEGIN,
+            OPERATIONS_END,
+            "",
+        ].join("\n");
+        return [
+            { kind: "region", path, regions, template },
+            {
+                kind: "file",
+                path: skillLinkPath(project),
+                content: `../../skills/${project.identity.name}`,
+                symlink: true,
+            },
+        ];
+    },
+    validate(project) {
+        return [
+            {
+                label: "agentskills validate",
+                command: "uvx",
+                args: [
+                    "--from",
+                    "skills-ref",
+                    "agentskills",
+                    "validate",
+                    `skills/${project.identity.name}`,
+                ],
+                cwd: project.root,
+            },
+        ];
+    },
+    verdict: skillVerdict,
+};

package/dist/surfaces/skill.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/surfaces/skill.test.js

@@ -0,0 +1,87 @@
+import { describe, expect, it } from "vitest";
+import { parse as parseYaml } from "yaml";
+import { frontmatter, renderOperations, skillPath, surface } from "./skill.js";
+const echo = {
+    name: "echo",
+    description: "Return the text you pass in.",
+    inputSchema: {
+        type: "object",
+        properties: { text: { type: "string" } },
+        required: ["text"],
+    },
+    requires: [],
+};
+const screenshot = {
+    name: "screenshot",
+    description: "Capture the current page.",
+    inputSchema: { type: "object", properties: {} },
+    requires: ["browser"],
+};
+const notify = {
+    name: "notify",
+    description: "Post a message into the live conversation.",
+    inputSchema: { type: "object", properties: {} },
+    requires: ["channel"],
+};
+function project(overrides = {}) {
+    return {
+        root: "/repo",
+        tool: {
+            schemaVersion: 1,
+            identity: "package.json",
+            binding: "typescript",
+            surfaces: ["skill", "cli", "mcp"],
+            bundle: { runtime: "package" },
+            tests: { examples: {} },
+        },
+        identity: { name: "hello", version: "1.0.0", description: "Say hello", license: "MIT" },
+        identityExtra: {},
+        operations: [echo, screenshot, notify],
+        toolfactoryVersion: "0.1.0",
+        ...overrides,
+    };
+}
+describe("skill surface", () => {
+    it("names the file after the tool and links it into the .agents canon", () => {
+        const target = project();
+        expect(skillPath(target)).toBe("skills/hello/SKILL.md");
+        expect(surface.plan(target)).toMatchObject([
+            { kind: "region", path: "skills/hello/SKILL.md" },
+            { kind: "file", path: ".agents/skills/hello", content: "../../skills/hello", symlink: true },
+        ]);
+    });
+    it("frontmatter carries the 6 spec fields, falling back to a description", () => {
+        const document = parseYaml(frontmatter(project()));
+        expect(document).toEqual({ name: "hello", description: "Say hello", license: "MIT" });
+        const noDescription = parseYaml(frontmatter(project({ identity: { name: "hello", description: undefined } })));
+        expect(noDescription.description).toBe("Use the hello tool.");
+    });
+    it("the operations block includes a portable op's CLI/MCP invocation and a bridged op's text, and omits an excluded op", () => {
+        const body = renderOperations(project());
+        expect(body).toContain("### echo");
+        expect(body).toContain("`hello echo --json '<arguments>'` prints a JSON result.");
+        expect(body).toContain("MCP tool `echo` on server `hello`");
+        expect(body).toContain("Arguments: `text`.");
+        expect(body).toContain("### screenshot");
+        expect(body).toContain("This operation needs browser: drive this host's own browser tools and pass what they return as arguments.");
+        expect(body).not.toContain("### notify");
+    });
+    it("leaves the operations region empty for an instruction-only skill", () => {
+        const target = project({
+            tool: { ...project().tool, runtime: "none", surfaces: ["skill", "codex"] },
+            operations: [],
+        });
+        expect(renderOperations(target)).toBe("");
+    });
+    it("validate runs the upstream agentskills validator against skills/<name>", () => {
+        const commands = surface.validate?.(project()) ?? [];
+        expect(commands).toEqual([
+            {
+                label: "agentskills validate",
+                command: "uvx",
+                args: ["--from", "skills-ref", "agentskills", "validate", "skills/hello"],
+                cwd: "/repo",
+            },
+        ]);
+    });
+});

package/dist/surfaces/web.d.ts

@@ -0,0 +1,97 @@
+import type { Surface } from "../model.js";
+export declare const WEB_DIR = "web";
+/**
+ * Everything the upstream generators wrote, transcribed once; `validate()` proves it current.
+ * Sources, in the order `src/hosts/web.ts` replays them:
+ *   npm create vite@latest <dir> -- --template react-ts
+ *   ui.shadcn.com/docs/installation/vite  (Tailwind, the `@/*` alias, vite.config.ts)
+ *   npx shadcn@latest init -y --base base --preset nova
+ *   npx shadcn@latest add -y <components>
+ */
+export declare const WEB_SCAFFOLD: {
+    readonly viteTemplate: "react-ts";
+    readonly base: "base";
+    readonly preset: "nova";
+    /** The shadcn components the page composes; the CLI copies them into src/components/ui. */
+    readonly components: readonly ["alert", "badge", "button", "card", "empty", "field", "input", "select", "switch", "tabs", "textarea", "toggle-group"];
+    /** toolfactory's own addition: the browser the smoke script drives. */
+    readonly playwright: "^1.62.1";
+    /** `npm create vite` output, before the shadcn documentation's edits. */
+    readonly vite: {
+        readonly "vite.config.ts": "import react from '@vitejs/plugin-react'\nimport { defineConfig } from 'vite'\n\n// https://vite.dev/config/\nexport default defineConfig({\n  plugins: [react()],\n})\n";
+        readonly "tsconfig.json": "{\n  \"files\": [],\n  \"references\": [\n    { \"path\": \"./tsconfig.app.json\" },\n    { \"path\": \"./tsconfig.node.json\" }\n  ]\n}\n";
+        readonly "tsconfig.app.json": "{\n  \"compilerOptions\": {\n    \"tsBuildInfoFile\": \"./node_modules/.tmp/tsconfig.app.tsbuildinfo\",\n    \"target\": \"es2023\",\n    \"lib\": [\"ES2023\", \"DOM\"],\n    \"module\": \"esnext\",\n    \"types\": [\"vite/client\"],\n    \"allowArbitraryExtensions\": true,\n    \"skipLibCheck\": true,\n\n    /* Bundler mode */\n    \"moduleResolution\": \"bundler\",\n    \"allowImportingTsExtensions\": true,\n    \"verbatimModuleSyntax\": true,\n    \"moduleDetection\": \"force\",\n    \"noEmit\": true,\n    \"jsx\": \"react-jsx\",\n\n    /* Linting */\n    \"noUnusedLocals\": true,\n    \"noUnusedParameters\": true,\n    \"erasableSyntaxOnly\": true,\n    \"noFallthroughCasesInSwitch\": true\n  },\n  \"include\": [\"src\"]\n}\n";
+        readonly "tsconfig.node.json": "{\n  \"compilerOptions\": {\n    \"tsBuildInfoFile\": \"./node_modules/.tmp/tsconfig.node.tsbuildinfo\",\n    \"target\": \"es2023\",\n    \"lib\": [\"ES2023\"],\n    \"types\": [\"node\"],\n    \"skipLibCheck\": true,\n\n    /* Bundler mode */\n    \"module\": \"nodenext\",\n    \"allowImportingTsExtensions\": true,\n    \"verbatimModuleSyntax\": true,\n    \"moduleDetection\": \"force\",\n    \"noEmit\": true,\n\n    /* Linting */\n    \"noUnusedLocals\": true,\n    \"noUnusedParameters\": true,\n    \"erasableSyntaxOnly\": true,\n    \"noFallthroughCasesInSwitch\": true\n  },\n  \"include\": [\"vite.config.ts\"]\n}\n";
+        readonly ".oxlintrc.json": "{\n  \"$schema\": \"./node_modules/oxlint/configuration_schema.json\",\n  \"plugins\": [\"react\", \"typescript\", \"oxc\"],\n  \"rules\": {\n    \"react/rules-of-hooks\": \"error\",\n    \"react/only-export-components\": [\"warn\", { \"allowConstantExport\": true }]\n  }\n}\n";
+    };
+    readonly packageJson: {
+        readonly scripts: {
+            readonly dev: "vite";
+            readonly build: "tsc -b && vite build";
+            readonly lint: "oxlint";
+            readonly preview: "vite preview";
+        };
+        readonly dependencies: {
+            readonly "@base-ui/react": "^1.8.0";
+            readonly "@fontsource-variable/geist": "^5.3.0";
+            readonly "@tailwindcss/vite": "^4.3.3";
+            readonly "class-variance-authority": "^0.7.1";
+            readonly cn: "^0.2.6";
+            readonly "lucide-react": "^1.42.0";
+            readonly react: "^19.2.8";
+            readonly "react-dom": "^19.2.8";
+            readonly shadcn: "^4.21.0";
+            readonly tailwindcss: "^4.3.3";
+            readonly "tw-animate-css": "^1.4.0";
+        };
+        readonly devDependencies: {
+            readonly "@types/node": "^24.13.3";
+            readonly "@types/react": "^19.2.18";
+            readonly "@types/react-dom": "^19.2.4";
+            readonly "@vitejs/plugin-react": "^6.1.0";
+            readonly oxlint: "^1.79.0";
+            readonly typescript: "~6.0.2";
+            readonly vite: "^8.2.2";
+        };
+    };
+    readonly componentsJson: {
+        readonly $schema: "https://ui.shadcn.com/schema.json";
+        readonly style: "base-nova";
+        readonly rsc: false;
+        readonly tsx: true;
+        readonly tailwind: {
+            readonly config: "";
+            readonly css: "src/index.css";
+            readonly baseColor: "neutral";
+            readonly cssVariables: true;
+            readonly prefix: "";
+        };
+        readonly iconLibrary: "lucide";
+        readonly rtl: false;
+        readonly aliases: {
+            readonly components: "@/components";
+            readonly utils: "@/lib/utils";
+            readonly ui: "@/components/ui";
+            readonly lib: "@/lib";
+            readonly hooks: "@/hooks";
+        };
+        readonly menuColor: "default";
+        readonly menuAccent: "subtle";
+        readonly registries: {};
+    };
+    readonly indexCss: "@import \"tailwindcss\";\n@import \"tw-animate-css\";\n@import \"shadcn/tailwind.css\";\n@import \"@fontsource-variable/geist\";\n\n@custom-variant dark (&:is(.dark *));\n\n@theme inline {\n    --font-heading: var(--font-sans);\n    --font-sans: 'Geist Variable', sans-serif;\n    --color-sidebar-ring: var(--sidebar-ring);\n    --color-sidebar-border: var(--sidebar-border);\n    --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);\n    --color-sidebar-accent: var(--sidebar-accent);\n    --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);\n    --color-sidebar-primary: var(--sidebar-primary);\n    --color-sidebar-foreground: var(--sidebar-foreground);\n    --color-sidebar: var(--sidebar);\n    --color-chart-5: var(--chart-5);\n    --color-chart-4: var(--chart-4);\n    --color-chart-3: var(--chart-3);\n    --color-chart-2: var(--chart-2);\n    --color-chart-1: var(--chart-1);\n    --color-ring: var(--ring);\n    --color-input: var(--input);\n    --color-border: var(--border);\n    --color-destructive: var(--destructive);\n    --color-accent-foreground: var(--accent-foreground);\n    --color-accent: var(--accent);\n    --color-muted-foreground: var(--muted-foreground);\n    --color-muted: var(--muted);\n    --color-secondary-foreground: var(--secondary-foreground);\n    --color-secondary: var(--secondary);\n    --color-primary-foreground: var(--primary-foreground);\n    --color-primary: var(--primary);\n    --color-popover-foreground: var(--popover-foreground);\n    --color-popover: var(--popover);\n    --color-card-foreground: var(--card-foreground);\n    --color-card: var(--card);\n    --color-foreground: var(--foreground);\n    --color-background: var(--background);\n    --radius-sm: calc(var(--radius) * 0.6);\n    --radius-md: calc(var(--radius) * 0.8);\n    --radius-lg: var(--radius);\n    --radius-xl: calc(var(--radius) * 1.4);\n    --radius-2xl: calc(var(--radius) * 1.8);\n    --radius-3xl: calc(var(--radius) * 2.2);\n    --radius-4xl: calc(var(--radius) * 2.6);\n}\n\n:root {\n    --background: oklch(1 0 0);\n    --foreground: oklch(0.145 0 0);\n    --card: oklch(1 0 0);\n    --card-foreground: oklch(0.145 0 0);\n    --popover: oklch(1 0 0);\n    --popover-foreground: oklch(0.145 0 0);\n    --primary: oklch(0.205 0 0);\n    --primary-foreground: oklch(0.985 0 0);\n    --secondary: oklch(0.97 0 0);\n    --secondary-foreground: oklch(0.205 0 0);\n    --muted: oklch(0.97 0 0);\n    --muted-foreground: oklch(0.556 0 0);\n    --accent: oklch(0.97 0 0);\n    --accent-foreground: oklch(0.205 0 0);\n    --destructive: oklch(0.577 0.245 27.325);\n    --border: oklch(0.922 0 0);\n    --input: oklch(0.922 0 0);\n    --ring: oklch(0.708 0 0);\n    --chart-1: oklch(0.87 0 0);\n    --chart-2: oklch(0.556 0 0);\n    --chart-3: oklch(0.439 0 0);\n    --chart-4: oklch(0.371 0 0);\n    --chart-5: oklch(0.269 0 0);\n    --radius: 0.625rem;\n    --sidebar: oklch(0.985 0 0);\n    --sidebar-foreground: oklch(0.145 0 0);\n    --sidebar-primary: oklch(0.205 0 0);\n    --sidebar-primary-foreground: oklch(0.985 0 0);\n    --sidebar-accent: oklch(0.97 0 0);\n    --sidebar-accent-foreground: oklch(0.205 0 0);\n    --sidebar-border: oklch(0.922 0 0);\n    --sidebar-ring: oklch(0.708 0 0);\n}\n\n.dark {\n    --background: oklch(0.145 0 0);\n    --foreground: oklch(0.985 0 0);\n    --card: oklch(0.205 0 0);\n    --card-foreground: oklch(0.985 0 0);\n    --popover: oklch(0.205 0 0);\n    --popover-foreground: oklch(0.985 0 0);\n    --primary: oklch(0.922 0 0);\n    --primary-foreground: oklch(0.205 0 0);\n    --secondary: oklch(0.269 0 0);\n    --secondary-foreground: oklch(0.985 0 0);\n    --muted: oklch(0.269 0 0);\n    --muted-foreground: oklch(0.708 0 0);\n    --accent: oklch(0.269 0 0);\n    --accent-foreground: oklch(0.985 0 0);\n    --destructive: oklch(0.704 0.191 22.216);\n    --border: oklch(1 0 0 / 10%);\n    --input: oklch(1 0 0 / 15%);\n    --ring: oklch(0.556 0 0);\n    --chart-1: oklch(0.87 0 0);\n    --chart-2: oklch(0.556 0 0);\n    --chart-3: oklch(0.439 0 0);\n    --chart-4: oklch(0.371 0 0);\n    --chart-5: oklch(0.269 0 0);\n    --sidebar: oklch(0.205 0 0);\n    --sidebar-foreground: oklch(0.985 0 0);\n    --sidebar-primary: oklch(0.488 0.243 264.376);\n    --sidebar-primary-foreground: oklch(0.985 0 0);\n    --sidebar-accent: oklch(0.269 0 0);\n    --sidebar-accent-foreground: oklch(0.985 0 0);\n    --sidebar-border: oklch(1 0 0 / 10%);\n    --sidebar-ring: oklch(0.556 0 0);\n}\n\n@layer base {\n  * {\n    @apply border-border outline-ring/50;\n    }\n  body {\n    @apply bg-background text-foreground;\n    }\n  html {\n    @apply font-sans;\n    }\n}";
+    readonly utils: "export { cn } from \"cn\"\n";
+};
+/** `src/index.css` after the documentation's Tailwind step and before `shadcn init` rewrites it. */
+export declare const TAILWIND_CSS = "@import \"tailwindcss\";\n";
+/**
+ * `src/App.tsx` is a RegionFile: the generated region is the operations page (everything
+ * the operator forms need, over `ops.json`) exported as `OperationsPage`; the template's tail —
+ * never touched again once the file exists — is the author's `pages` array and the shell that
+ * renders whichever one is active. A page an author adds below the end marker (the d3
+ * degree-planner graph vutoolkit needs, say) survives every `toolfactory build` because
+ * `apply()` only ever replaces the text between the markers (src/project/apply.ts `render()`).
+ */
+export declare const APP_BEGIN = "// tf:app";
+export declare const APP_END = "// /tf:app";
+export declare const surface: Surface;