sandstream-kit 1.0.0

package/dist/plugins-cli.js

@@ -0,0 +1,157 @@
+/**
+ * `kit plugin <list|search|info|install|scaffold|tags>` — plugin
+ * discovery + management CLI dispatch. Extracted from cli.ts
+ * (codebase-review follow-up). Registry logic lives in plugins.ts;
+ * scaffolding in create-plugin.ts — this module is the argv-facing shell.
+ */
+import { searchPlugins, listPlugins, getPluginInfo, getAllTags, formatPluginForDisplay, isPluginInstalled, installPlugin, } from "./plugins.js";
+import { createPlugin } from "./create-plugin.js";
+import { c } from "./utils/colors.js";
+export async function cmdPlugin() {
+    const subcommand = process.argv[3];
+    const args = process.argv.slice(4);
+    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+        console.log(`${c.bold}kit plugin${c.reset} — discover and manage kit plugins\n`);
+        console.log(`${c.bold}Usage:${c.reset}`);
+        console.log(`  kit plugin list ${c.dim}[--tag TAG]${c.reset}      List all available plugins`);
+        console.log(`  kit plugin search <query>            Search for plugins by name/description`);
+        console.log(`  kit plugin info <name>               Show detailed info about a plugin`);
+        console.log(`  kit plugin install <name>            Install a plugin`);
+        console.log(`  kit plugin scaffold <name>           Create a new plugin from template`);
+        console.log(`  kit plugin tags                      List all available plugin tags\n`);
+        console.log(`${c.dim}Examples:${c.reset}`);
+        console.log(`  kit plugin search stripe             # Search for stripe plugins`);
+        console.log(`  kit plugin list --tag database       # Show all database adapters`);
+        console.log(`  kit plugin info stripe/payments      # Get plugin details`);
+        console.log(`  kit plugin install stripe/payments   # Install a plugin`);
+        console.log(`  kit plugin scaffold my-service       # Create a plugin package`);
+        return true;
+    }
+    try {
+        switch (subcommand) {
+            case "list": {
+                const tagIndex = args.indexOf("--tag");
+                const tag = tagIndex !== -1 ? args[tagIndex + 1] : undefined;
+                const plugins = listPlugins(tag);
+                if (plugins.length === 0) {
+                    console.log(`${c.dim}No plugins found${tag ? ` with tag: ${tag}` : ""}${c.reset}`);
+                    return true;
+                }
+                console.log(`${c.bold}Available Plugins${tag ? ` (${tag})` : ""}${c.reset} — ${plugins.length} found\n`);
+                for (const plugin of plugins) {
+                    console.log(formatPluginForDisplay(plugin));
+                }
+                return true;
+            }
+            case "search": {
+                const query = args.join(" ");
+                if (!query) {
+                    console.error(`${c.red}Error: search query required${c.reset}`);
+                    return false;
+                }
+                const results = searchPlugins(query);
+                if (results.length === 0) {
+                    console.log(`${c.dim}No plugins found matching: ${query}${c.reset}`);
+                    return true;
+                }
+                console.log(`${c.bold}Search Results${c.reset} for "${query}" — ${results.length} found\n`);
+                for (const plugin of results) {
+                    console.log(formatPluginForDisplay(plugin));
+                }
+                return true;
+            }
+            case "info": {
+                const name = args[0];
+                if (!name) {
+                    console.error(`${c.red}Error: plugin name required${c.reset}`);
+                    return false;
+                }
+                const plugin = getPluginInfo(name);
+                if (!plugin) {
+                    console.error(`${c.red}Error: plugin not found: ${name}${c.reset}`);
+                    return false;
+                }
+                console.log(`${c.bold}Plugin Details${c.reset}\n`);
+                console.log(formatPluginForDisplay(plugin, true));
+                return true;
+            }
+            case "install": {
+                const name = args[0];
+                if (!name) {
+                    console.error(`${c.red}Error: plugin name required${c.reset}`);
+                    return false;
+                }
+                const plugin = getPluginInfo(name);
+                if (!plugin) {
+                    console.error(`${c.red}Error: plugin not found: ${name}${c.reset}`);
+                    return false;
+                }
+                const isInstalled = await isPluginInstalled(plugin.package || name);
+                if (isInstalled) {
+                    console.log(`${c.green}✓${c.reset} Plugin already installed: ${name}`);
+                    return true;
+                }
+                console.log(`${c.dim}Installing ${name}...${c.reset}`);
+                const result = await installPlugin(name, plugin);
+                if (result.success) {
+                    console.log(`${c.green}✓${c.reset} ${result.message}`);
+                    return true;
+                }
+                else {
+                    console.error(`${c.red}✗${c.reset} ${result.message}`);
+                    return false;
+                }
+            }
+            case "tags": {
+                const tags = getAllTags();
+                console.log(`${c.bold}Available Tags${c.reset} — ${tags.length} categories\n`);
+                const columns = 3;
+                const maxLen = Math.max(...tags.map((t) => t.length));
+                for (let i = 0; i < tags.length; i += columns) {
+                    const row = tags.slice(i, i + columns);
+                    console.log(row
+                        .map((tag) => tag.padEnd(maxLen + 1))
+                        .join("  "));
+                }
+                return true;
+            }
+            case "scaffold": {
+                const name = args[0];
+                if (!name) {
+                    console.error(`${c.red}Error: plugin name required${c.reset}`);
+                    console.error(`Usage: kit plugin scaffold <name>`);
+                    console.error(`Example: kit plugin scaffold my-stripe-adapter`);
+                    return false;
+                }
+                console.log(`${c.dim}Scaffolding plugin: ${name}...${c.reset}`);
+                const result = await createPlugin({
+                    name,
+                    cwd: process.cwd(),
+                    skipInstall: false,
+                });
+                if (result.success) {
+                    console.log(`${c.green}✓${c.reset} ${result.message}`);
+                    console.log(`\n${c.bold}Next steps:${c.reset}`);
+                    for (const step of result.nextSteps) {
+                        console.log(`  ${step}`);
+                    }
+                    return true;
+                }
+                else {
+                    console.error(`${c.red}✗${c.reset} Failed to create plugin`);
+                    return false;
+                }
+            }
+            default:
+                console.error(`${c.red}Unknown subcommand: ${subcommand}${c.reset}`);
+                console.error(`Run 'kit plugin --help' for usage information.`);
+                return false;
+        }
+    }
+    catch (err) {
+        const error = err;
+        console.error(`${c.red}Error: ${error.message}${c.reset}`);
+        return false;
+    }
+}
+//# sourceMappingURL=plugins-cli.js.map

package/dist/plugins-cli.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Plugin registry and management
+ *
+ * kit plugins are ServiceAdapter-based packages that can be discovered,
+ * installed, and registered in .kit.toml. This module provides:
+ * - Plugin registry search and discovery
+ * - Plugin installation and configuration
+ * - Metadata management
+ */
+/**
+ * Plugin metadata as it appears in the registry
+ */
+export interface PluginMetadata {
+    /** Unique identifier: provider/service (e.g., "stripe/payments") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Plugin version */
+    version: string;
+    /** Plugin author */
+    author: string;
+    /** License SPDX identifier */
+    license: string;
+    /** Repository URL (for source discovery) */
+    repository: string;
+    /** npm package name (if published) */
+    package?: string;
+    /** Minimum kit version required */
+    kitVersion: string;
+    /** Array of tags for categorization */
+    tags: string[];
+    /** Date published (ISO 8601) */
+    published: string;
+    /** Download count in last 30 days */
+    downloads?: number;
+    /** Average rating (0-5 stars) */
+    rating?: number;
+    /** Installation instructions / command */
+    install: string;
+}
+/**
+ * Plugin registry — centralized list of available plugins
+ */
+export interface PluginRegistry {
+    version: string;
+    updated: string;
+    plugins: PluginMetadata[];
+}
+/**
+ * Local default registry embedded in kit
+ * This provides a foundation registry of official plugins
+ */
+export declare const DEFAULT_REGISTRY: PluginRegistry;
+/**
+ * Search the plugin registry for matching plugins
+ *
+ * @param query - Search query (name, description, or tags)
+ * @param registry - Plugin registry (uses default if not provided)
+ * @returns Matching plugins sorted by relevance
+ */
+export declare function searchPlugins(query: string, registry?: PluginRegistry): PluginMetadata[];
+/**
+ * List all plugins in the registry, optionally filtered by tag
+ */
+export declare function listPlugins(tag?: string, registry?: PluginRegistry): PluginMetadata[];
+/**
+ * Get detailed information about a single plugin
+ */
+export declare function getPluginInfo(name: string, registry?: PluginRegistry): PluginMetadata | null;
+/**
+ * Get all unique tags in the registry
+ */
+export declare function getAllTags(registry?: PluginRegistry): string[];
+/**
+ * Format a plugin for display in CLI output
+ */
+export declare function formatPluginForDisplay(plugin: PluginMetadata, detailed?: boolean): string;
+/**
+ * Check if a plugin is installed by attempting to require/import it
+ */
+export declare function isPluginInstalled(packageName: string): Promise<boolean>;
+/**
+ * Install a plugin via npm
+ */
+export declare function installPlugin(pluginName: string, metadata: PluginMetadata): Promise<{
+    success: boolean;
+    message: string;
+}>;

package/dist/plugins.js

@@ -0,0 +1,251 @@
+/**
+ * Plugin registry and management
+ *
+ * kit plugins are ServiceAdapter-based packages that can be discovered,
+ * installed, and registered in .kit.toml. This module provides:
+ * - Plugin registry search and discovery
+ * - Plugin installation and configuration
+ * - Metadata management
+ */
+import { exec } from "./utils/exec.js";
+/**
+ * Local default registry embedded in kit
+ * This provides a foundation registry of official plugins
+ */
+export const DEFAULT_REGISTRY = {
+    version: "1.0.0",
+    updated: new Date().toISOString(),
+    plugins: [
+        {
+            name: "stripe/payments",
+            description: "Stripe payment processing and billing adapter",
+            version: "1.0.0",
+            author: "Sandstream",
+            license: "MIT",
+            repository: "https://github.com/sandstream/kit-stripe",
+            package: "@kit/plugins/stripe",
+            kitVersion: ">=0.1.0",
+            tags: ["payments", "adapter", "official"],
+            published: "2026-04-15T00:00:00Z",
+            downloads: 1250,
+            rating: 4.8,
+            install: "npm install @kit/plugins/stripe",
+        },
+        {
+            name: "supabase/database",
+            description: "PostgreSQL database via Supabase with real-time APIs",
+            version: "1.0.0",
+            author: "Sandstream",
+            license: "MIT",
+            repository: "https://github.com/sandstream/kit-supabase",
+            package: "@kit/plugins/supabase",
+            kitVersion: ">=0.1.0",
+            tags: ["database", "adapter", "official"],
+            published: "2026-04-15T00:00:00Z",
+            downloads: 1890,
+            rating: 4.9,
+            install: "npm install @kit/plugins/supabase",
+        },
+        {
+            name: "vercel/hosting",
+            description: "Vercel serverless deployment platform",
+            version: "1.0.0",
+            author: "Sandstream",
+            license: "MIT",
+            repository: "https://github.com/sandstream/kit-vercel",
+            package: "@kit/plugins/vercel",
+            kitVersion: ">=0.1.0",
+            tags: ["hosting", "adapter", "official"],
+            published: "2026-04-15T00:00:00Z",
+            downloads: 2340,
+            rating: 4.7,
+            install: "npm install @kit/plugins/vercel",
+        },
+        {
+            name: "railway/hosting",
+            description: "Railway infrastructure platform deployment",
+            version: "1.0.0",
+            author: "Sandstream",
+            license: "MIT",
+            repository: "https://github.com/sandstream/kit-railway",
+            package: "@kit/plugins/railway",
+            kitVersion: ">=0.1.0",
+            tags: ["hosting", "adapter", "official"],
+            published: "2026-04-15T00:00:00Z",
+            downloads: 890,
+            rating: 4.6,
+            install: "npm install @kit/plugins/railway",
+        },
+        {
+            name: "flyio/hosting",
+            description: "Fly.io container deployment platform",
+            version: "1.0.0",
+            author: "Sandstream",
+            license: "MIT",
+            repository: "https://github.com/sandstream/kit-flyio",
+            package: "@kit/plugins/flyio",
+            kitVersion: ">=0.1.0",
+            tags: ["hosting", "adapter", "official"],
+            published: "2026-04-15T00:00:00Z",
+            downloads: 650,
+            rating: 4.5,
+            install: "npm install @kit/plugins/flyio",
+        },
+    ],
+};
+/**
+ * Search the plugin registry for matching plugins
+ *
+ * @param query - Search query (name, description, or tags)
+ * @param registry - Plugin registry (uses default if not provided)
+ * @returns Matching plugins sorted by relevance
+ */
+export function searchPlugins(query, registry = DEFAULT_REGISTRY) {
+    const q = query.toLowerCase();
+    return registry.plugins
+        .map((plugin) => {
+        let score = 0;
+        // Exact name match
+        if (plugin.name.toLowerCase() === q)
+            score += 1000;
+        // Name prefix match
+        if (plugin.name.toLowerCase().startsWith(q))
+            score += 500;
+        // Name contains
+        if (plugin.name.toLowerCase().includes(q))
+            score += 100;
+        // Description match
+        if (plugin.description.toLowerCase().includes(q))
+            score += 50;
+        // Tag match
+        if (plugin.tags.some((tag) => tag.toLowerCase().includes(q)))
+            score += 75;
+        return { plugin, score };
+    })
+        .filter(({ score }) => score > 0)
+        .sort((a, b) => {
+        // Primary: relevance score
+        if (b.score !== a.score)
+            return b.score - a.score;
+        // Secondary: download count
+        return (b.plugin.downloads ?? 0) - (a.plugin.downloads ?? 0);
+    })
+        .map(({ plugin }) => plugin);
+}
+/**
+ * List all plugins in the registry, optionally filtered by tag
+ */
+export function listPlugins(tag, registry = DEFAULT_REGISTRY) {
+    if (!tag) {
+        return registry.plugins.sort((a, b) => (b.downloads ?? 0) - (a.downloads ?? 0));
+    }
+    return registry.plugins
+        .filter((plugin) => plugin.tags.includes(tag.toLowerCase()))
+        .sort((a, b) => (b.downloads ?? 0) - (a.downloads ?? 0));
+}
+/**
+ * Get detailed information about a single plugin
+ */
+export function getPluginInfo(name, registry = DEFAULT_REGISTRY) {
+    const normalized = name.toLowerCase();
+    return (registry.plugins.find((p) => p.name.toLowerCase() === normalized) || null);
+}
+/**
+ * Get all unique tags in the registry
+ */
+export function getAllTags(registry = DEFAULT_REGISTRY) {
+    const tags = new Set();
+    for (const plugin of registry.plugins) {
+        for (const tag of plugin.tags) {
+            tags.add(tag);
+        }
+    }
+    return Array.from(tags).sort();
+}
+/**
+ * Format a plugin for display in CLI output
+ */
+export function formatPluginForDisplay(plugin, detailed = false) {
+    const lines = [];
+    // Header line: name, version, rating
+    const ratingStr = plugin.rating
+        ? ` ${formatStars(plugin.rating)}`
+        : "";
+    lines.push(`  ${plugin.name} ${plugin.version}${ratingStr}`);
+    // Description
+    lines.push(`    ${plugin.description}`);
+    if (detailed) {
+        // Author and license
+        lines.push(`    Author: ${plugin.author} | License: ${plugin.license}`);
+        // Tags
+        if (plugin.tags.length > 0) {
+            lines.push(`    Tags: ${plugin.tags.join(", ")}`);
+        }
+        // Downloads
+        if (plugin.downloads !== undefined) {
+            lines.push(`    Downloads: ${plugin.downloads.toLocaleString()} (last 30 days)`);
+        }
+        // Installation command
+        lines.push(`    Install: ${plugin.install}`);
+        // Repository
+        lines.push(`    Repository: ${plugin.repository}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a numeric rating (0-5) as star display
+ */
+function formatStars(rating) {
+    const full = Math.floor(rating);
+    const half = rating - full >= 0.5 ? 1 : 0;
+    const empty = 5 - full - half;
+    return "★".repeat(full) + (half ? "◆" : "") + "☆".repeat(empty) + ` ${rating.toFixed(1)}`;
+}
+/**
+ * Check if a plugin is installed by attempting to require/import it
+ */
+export async function isPluginInstalled(packageName) {
+    try {
+        const result = await exec("npm", ["ls", packageName, "--depth=0"], {
+            timeout: 5000,
+        });
+        return result.stdout.includes(packageName);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Install a plugin via npm
+ */
+export async function installPlugin(pluginName, metadata) {
+    try {
+        // Use npm to install the package
+        const packageName = metadata.package || pluginName;
+        const cmd = metadata.install;
+        // Extract the actual npm install command
+        const match = cmd.match(/npm install (.+)/);
+        const pkgToInstall = match ? match[1] : packageName;
+        const { stderr } = await exec("npm", ["install", pkgToInstall], {
+            timeout: 60000,
+        });
+        if (stderr && stderr.includes("ERR!")) {
+            return {
+                success: false,
+                message: `Installation failed: ${stderr}`,
+            };
+        }
+        return {
+            success: true,
+            message: `Installed ${pluginName} (${metadata.version})`,
+        };
+    }
+    catch (err) {
+        const error = err;
+        return {
+            success: false,
+            message: `Installation error: ${error.message || error.stderr || String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AA4CvC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACjC,OAAO,EAAE;QACP;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,+CAA+C;YAC5D,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,0CAA0C;YACtD,OAAO,EAAE,qBAAqB;YAC9B,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;YACzC,SAAS,EAAE,sBAAsB;YACjC,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,iCAAiC;SAC3C;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,sDAAsD;YACnE,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,4CAA4C;YACxD,OAAO,EAAE,uBAAuB;YAChC,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;YACzC,SAAS,EAAE,sBAAsB;YACjC,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,uCAAuC;YACpD,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,0CAA0C;YACtD,OAAO,EAAE,qBAAqB;YAC9B,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;YACxC,SAAS,EAAE,sBAAsB;YACjC,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,iCAAiC;SAC3C;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,4CAA4C;YACzD,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,2CAA2C;YACvD,OAAO,EAAE,sBAAsB;YAC/B,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;YACxC,SAAS,EAAE,sBAAsB;YACjC,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,kCAAkC;SAC5C;QACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,sCAAsC;YACnD,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,yCAAyC;YACrD,OAAO,EAAE,oBAAoB;YAC7B,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;YACxC,SAAS,EAAE,sBAAsB;YACjC,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,gCAAgC;SAC1C;KACF;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,WAA2B,gBAAgB;IAE3C,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAE9B,OAAO,QAAQ,CAAC,OAAO;SACpB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,mBAAmB;QACnB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;YAAE,KAAK,IAAI,IAAI,CAAC;QACnD,oBAAoB;QACpB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,GAAG,CAAC;QAC1D,gBAAgB;QAChB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,GAAG,CAAC;QAExD,oBAAoB;QACpB,IAAI,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,EAAE,CAAC;QAE9D,YAAY;QACZ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,KAAK,IAAI,EAAE,CAAC;QAE1E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,2BAA2B;QAC3B,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAClD,4BAA4B;QAC5B,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,GAAY,EACZ,WAA2B,gBAAgB;IAE3C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAClD,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO;SACpB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;SAC3D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,WAA2B,gBAAgB;IAE3C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACL,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,IAAI,IAAI,CAC1E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,WAA2B,gBAAgB;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAsB,EACtB,WAAoB,KAAK;IAEzB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,qCAAqC;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM;QAC7B,CAAC,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;QAClC,CAAC,CAAC,EAAE,CAAC;IACP,KAAK,CAAC,IAAI,CACR,KAAK,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,GAAG,SAAS,EAAE,CACjD,CAAC;IAEF,cAAc;IACd,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAExC,IAAI,QAAQ,EAAE,CAAC;QACb,qBAAqB;QACrB,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,MAAM,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAExE,OAAO;QACP,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,YAAY;QACZ,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QACnF,CAAC;QAED,uBAAuB;QACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAE7C,aAAa;QACb,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAE9B,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE;YACjE,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,QAAwB;IAExB,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,IAAI,UAAU,CAAC;QACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;QAE7B,yCAAyC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAEpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE;YAC9D,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,wBAAwB,MAAM,EAAE;aAC1C,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,aAAa,UAAU,KAAK,QAAQ,CAAC,OAAO,GAAG;SACzD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,GAA4C,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,uBAAuB,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;SAC/E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/policy.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Agent-write pre-approval policy.
+ *
+ * `.kit.toml [policy.agent_writes]` declares which sensitive vendor
+ * operations the operator pre-authorizes for this repository. Classifiers
+ * and agents read a stable hash of the policy via `KIT_POLICY_HASH` so
+ * the in-scope ops can run without per-call human confirmation, while
+ * out-of-scope ops still require explicit elevation.
+ *
+ * Format in .kit.toml:
+ *
+ *   [policy.agent_writes]
+ *   sentry = ["resolve_issue", "create_release"]
+ *   supabase = ["rotate_jwt", "list_projects"]
+ *   vercel = ["env_set", "trigger_deploy"]
+ *   stripe = []        # all writes still gated
+ *
+ *   [policy]
+ *   default_mode = "read-only"   # force --read-only globally for this repo
+ *
+ * Runtime contract:
+ *   1. At boot, the orchestrator (cli.ts:main) reads `[policy]` from the
+ *      loaded config, computes a SHA-256 of the canonical JSON, exports
+ *      `KIT_POLICY_HASH=<hex>` to env so child processes / classifiers
+ *      see the same identity.
+ *   2. Callers that mutate vendor state call `checkPolicy(vendor, op)` —
+ *      returns true if the op appears in `agent_writes[vendor]`. False
+ *      means the op is gated and requires elevation.
+ *   3. Every policy check emits an audit event with `policy_scope_matched`
+ *      so the forensic trail covers both grants and denials.
+ *
+ * This module deliberately does NOT enforce — it just SURFACES. The
+ * existing elevation + read-only gates remain authoritative; the policy
+ * block is the explicit "operator agreed to this scope" signal that
+ * upstream classifiers (Claude Code, etc.) can honor.
+ */
+import type { PolicyConfig } from "./config.js";
+export declare function hashPolicy(policy: PolicyConfig | undefined): string | null;
+/**
+ * Computes the policy hash and exports it to env. Called once from main()
+ * after config is loaded. Idempotent.
+ */
+export declare function installPolicyHash(policy: PolicyConfig | undefined): void;
+export declare function currentPolicyHash(): string | null;
+export interface PolicyCheckResult {
+    /** True when the (vendor, op) pair is explicitly pre-authorized. */
+    approved: boolean;
+    /** Reason / detail for diagnostics. */
+    reason: string;
+    /** Policy hash at the time of check, for audit-log correlation. */
+    policyHash: string | null;
+}
+/**
+ * Check whether `op` against `vendor` is pre-approved by the policy.
+ *
+ * Returns `{ approved: false }` when the policy is missing, the vendor
+ * isn't declared, or the op isn't in the vendor's allow-list. Callers
+ * should treat false as "elevation still required" — this is not a
+ * substitute for the elevation gate, just an explicit declaration that
+ * the OPERATOR consented to this scope at configuration time.
+ */
+export declare function checkPolicy(policy: PolicyConfig | undefined, vendor: string, op: string): Promise<PolicyCheckResult>;
+/**
+ * Test-only: reset env var so tests start fresh.
+ */
+export declare function _resetPolicyHashForTests(): void;