@plumbus/core 0.4.0 → 0.4.2

package/dist/cli/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCpC,wBAAgB,SAAS,IAAI,OAAO,CA+CnC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CpC,wBAAgB,SAAS,IAAI,OAAO,CAiDnC"}

package/dist/cli/cli.js

@@ -2,7 +2,7 @@
 // Main `plumbus` command with subcommands
 import { createRequire } from 'node:module';
 import { Command } from 'commander';
-import { registerAgentCommand, registerCapabilityCommand, registerCertifyCommand, registerCreateCommand, registerDbCommand, registerDevCommand, registerDoctorCommand, registerE2ECommand, registerEntityCommand, registerEventCommand, registerFlowCommand, registerGenerateCommand, registerInitCommand, registerMcpCommand, registerMigrateCommand, registerPromptCommand, registerRagCommand, registerRunCommand, registerSeedCommand, registerStartCommand, registerTestCommand, registerTranslationCommand, registerUiCommand, registerUpgradeCommand, registerVerifyCommand, } from './commands/index.js';
+import { registerAgentCommand, registerApiCommand, registerBrowserExtensionCommand, registerCapabilityCommand, registerCertifyCommand, registerCreateCommand, registerDbCommand, registerDevCommand, registerDoctorCommand, registerE2ECommand, registerEntityCommand, registerEventCommand, registerFlowCommand, registerGenerateCommand, registerInitCommand, registerMcpCommand, registerMigrateCommand, registerPromptCommand, registerRagCommand, registerRunCommand, registerSeedCommand, registerStartCommand, registerTestCommand, registerTranslationCommand, registerUiCommand, registerUpgradeCommand, registerVerifyCommand, } from './commands/index.js';
 import { assertInsidePlumbusProject, commandRequiresProject } from './utils.js';
 function getVersion() {
     try {
@@ -40,6 +40,7 @@ export function createCli() {
     registerPromptCommand(program);
     registerGenerateCommand(program);
     registerMcpCommand(program);
+    registerApiCommand(program);
     registerMigrateCommand(program);
     registerDbCommand(program);
     registerVerifyCommand(program);
@@ -49,6 +50,7 @@ export function createCli() {
     registerRunCommand(program);
     registerSeedCommand(program);
     registerUiCommand(program);
+    registerBrowserExtensionCommand(program);
     registerUpgradeCommand(program);
     registerDoctorCommand(program);
     registerDevCommand(program);

package/dist/cli/cli.js.map

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

package/dist/cli/commands/api-manifest.d.ts

@@ -0,0 +1,26 @@
+import type { CapabilityContract } from '../../types/capability.js';
+export interface ApiManifestLoader {
+    parseManifest: (source: string, format: 'yaml' | 'json') => unknown;
+    buildDefaultManifest: (capabilities: CapabilityContract[]) => unknown;
+}
+export declare class ApiManifestLoadError extends Error {
+    readonly filePath: string;
+    readonly reason: 'not-found' | 'invalid';
+    constructor(filePath: string, reason: 'not-found' | 'invalid', message: string);
+}
+/**
+ * Load an API manifest from disk. Falls back to inline defaults only when the
+ * default manifest path is missing (ENOENT). Explicit --manifest paths and
+ * parse/schema failures always surface as errors.
+ */
+export declare function resolveApiManifest(opts: {
+    filePath: string;
+    explicitManifest: boolean;
+    capabilities: CapabilityContract[];
+    api: ApiManifestLoader;
+    readFileFn?: (path: string) => Promise<string>;
+}): Promise<{
+    manifest: unknown;
+    warning?: string;
+}>;
+//# sourceMappingURL=api-manifest.d.ts.map

package/dist/cli/commands/api-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-manifest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/api-manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC;IACpE,oBAAoB,EAAE,CAAC,YAAY,EAAE,kBAAkB,EAAE,KAAK,OAAO,CAAC;CACvE;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;gBAE7B,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM;CAM/E;AAWD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,GAAG,EAAE,iBAAiB,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyCnD"}

package/dist/cli/commands/api-manifest.js

@@ -0,0 +1,54 @@
+import { readFile } from 'node:fs/promises';
+export class ApiManifestLoadError extends Error {
+    filePath;
+    reason;
+    constructor(filePath, reason, message) {
+        super(message);
+        this.name = 'ApiManifestLoadError';
+        this.filePath = filePath;
+        this.reason = reason;
+    }
+}
+function isENOENT(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'code' in err &&
+        err.code === 'ENOENT');
+}
+/**
+ * Load an API manifest from disk. Falls back to inline defaults only when the
+ * default manifest path is missing (ENOENT). Explicit --manifest paths and
+ * parse/schema failures always surface as errors.
+ */
+export async function resolveApiManifest(opts) {
+    const format = opts.filePath.endsWith('.json') ? 'json' : 'yaml';
+    try {
+        const source = opts.readFileFn
+            ? await opts.readFileFn(opts.filePath)
+            : await readFile(opts.filePath, 'utf8');
+        try {
+            return { manifest: opts.api.parseManifest(source, format) };
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            throw new ApiManifestLoadError(opts.filePath, 'invalid', `Failed to parse API manifest at ${opts.filePath}: ${detail}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof ApiManifestLoadError) {
+            throw err;
+        }
+        if (isENOENT(err)) {
+            if (opts.explicitManifest) {
+                throw new ApiManifestLoadError(opts.filePath, 'not-found', `API manifest not found: ${opts.filePath}`);
+            }
+            return {
+                manifest: opts.api.buildDefaultManifest(opts.capabilities),
+                warning: `No manifest at ${opts.filePath} — using inline api metadata only`,
+            };
+        }
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new ApiManifestLoadError(opts.filePath, 'invalid', `Failed to read API manifest at ${opts.filePath}: ${detail}`);
+    }
+}
+//# sourceMappingURL=api-manifest.js.map

package/dist/cli/commands/api-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-manifest.js","sourceRoot":"","sources":["../../../src/cli/commands/api-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,QAAQ,CAAS;IACjB,MAAM,CAA0B;IAEzC,YAAY,QAAgB,EAAE,MAA+B,EAAE,OAAe;QAC5E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACZ,GAAyB,CAAC,IAAI,KAAK,QAAQ,CAC7C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAMxC;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAEjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU;YAC5B,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YACtC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,IAAI,oBAAoB,CAC5B,IAAI,CAAC,QAAQ,EACb,SAAS,EACT,mCAAmC,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;YACxC,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,MAAM,IAAI,oBAAoB,CAC5B,IAAI,CAAC,QAAQ,EACb,WAAW,EACX,2BAA2B,IAAI,CAAC,QAAQ,EAAE,CAC3C,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,YAAY,CAAC;gBAC1D,OAAO,EAAE,kBAAkB,IAAI,CAAC,QAAQ,mCAAmC;aAC5E,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,IAAI,oBAAoB,CAC5B,IAAI,CAAC,QAAQ,EACb,SAAS,EACT,kCAAkC,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAC7D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cli/commands/api.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerApiCommand(program: Command): void;
+//# sourceMappingURL=api.d.ts.map

package/dist/cli/commands/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/api.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqGzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0IzD"}

package/dist/cli/commands/api.js

@@ -0,0 +1,179 @@
+// ── plumbus api ──
+// External API contract validation, OpenAPI/docs generation, and compatibility diff.
+import { readFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { apiRules } from '../../governance/rules/api.js';
+import { createGovernanceRuleEngine } from '../../governance/rule-engine.js';
+import { ApiManifestLoadError, resolveApiManifest } from './api-manifest.js';
+import { discoverResources } from '../discover.js';
+import { info, resolvePath, success, warn, writeFile } from '../utils.js';
+async function loadApiRuntime() {
+    try {
+        const mod = '@plumbus/api';
+        return (await import(mod));
+    }
+    catch {
+        console.error('');
+        console.error('API runtime not installed.');
+        console.error('Run: pnpm add @plumbus/api');
+        console.error('');
+        process.exit(1);
+    }
+}
+async function loadManifestAndCaps(manifestPath) {
+    const api = await loadApiRuntime();
+    const resources = await discoverResources();
+    const capabilities = resources.capabilities;
+    const file = manifestPath ?? resolvePath('api.yaml');
+    let manifest;
+    try {
+        const loaded = await resolveApiManifest({
+            filePath: file,
+            explicitManifest: manifestPath !== undefined,
+            capabilities,
+            api,
+        });
+        manifest = loaded.manifest;
+        if (loaded.warning) {
+            warn(loaded.warning);
+        }
+    }
+    catch (err) {
+        if (err instanceof ApiManifestLoadError) {
+            console.error('');
+            console.error(err.message);
+            console.error('');
+            process.exit(1);
+        }
+        throw err;
+    }
+    return { api, manifest, capabilities, appRoot: process.cwd() };
+}
+export function registerApiCommand(program) {
+    const apiCmd = program
+        .command('api')
+        .description('External API contract — validate, generate OpenAPI/docs, diff');
+    apiCmd
+        .command('validate')
+        .description('Validate API manifest, policy, path params, fixtures, and governance')
+        .option('--manifest <path>', 'Path to API manifest (default: ./api.yaml)')
+        .option('--json', 'Output results as JSON')
+        .action(async (opts) => {
+        const { api, manifest, capabilities, appRoot } = await loadManifestAndCaps(opts.manifest);
+        const result = await api.validateApiContract(manifest, capabilities, appRoot);
+        const engine = createGovernanceRuleEngine();
+        engine.registerMany(apiRules);
+        const gov = engine.evaluate({
+            capabilities,
+            entities: [],
+            flows: [],
+            events: [],
+            prompts: [],
+        });
+        const allFindings = [
+            ...result.manifest,
+            ...result.policy,
+            ...result.pathParams,
+            ...result.fixtures,
+        ];
+        const govSignals = gov.effective;
+        if (opts.json) {
+            console.log(JSON.stringify({ ...result, governance: govSignals }, null, 2));
+        }
+        else {
+            for (const f of allFindings) {
+                warn(`[${f.code}] ${f.message}`);
+            }
+            for (const s of govSignals) {
+                warn(`[${s.rule}] ${s.description}`);
+            }
+        }
+        if (allFindings.length > 0 || govSignals.length > 0) {
+            process.exit(1);
+        }
+        success('API contract validation passed');
+    });
+    const generate = apiCmd.command('generate').description('Generate API artifacts');
+    generate
+        .command('openapi')
+        .description('Generate OpenAPI specification')
+        .requiredOption('--out <file>', 'Output file path')
+        .option('--format <format>', 'json or yaml', 'json')
+        .option('--manifest <path>', 'Path to API manifest')
+        .action(async (opts) => {
+        const { api, manifest, capabilities } = await loadManifestAndCaps(opts.manifest);
+        const doc = api.generateOpenApi(capabilities, manifest);
+        const outPath = resolvePath(opts.out);
+        const format = opts.format === 'yaml' ? 'yaml' : 'json';
+        const content = api.serializeOpenApiDocument(doc, format);
+        writeFile(outPath, content);
+        success(`Wrote OpenAPI spec to ${outPath}`);
+    });
+    generate
+        .command('docs')
+        .description('Generate Markdown API documentation')
+        .requiredOption('--out <dir>', 'Output directory')
+        .option('--manifest <path>', 'Path to API manifest')
+        .action(async (opts) => {
+        const { api, manifest, capabilities } = await loadManifestAndCaps(opts.manifest);
+        const files = api.generateApiDocs(capabilities, manifest);
+        const outDir = resolvePath(opts.out);
+        for (const [rel, content] of files) {
+            writeFile(path.join(outDir, rel), content);
+        }
+        success(`Wrote ${files.size} doc file(s) to ${outDir}`);
+    });
+    apiCmd
+        .command('diff')
+        .description('Compare current OpenAPI against a published spec')
+        .requiredOption('--against <file>', 'Previously published OpenAPI file')
+        .option('--manifest <path>', 'Path to API manifest')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        const { api, manifest, capabilities } = await loadManifestAndCaps(opts.manifest);
+        const current = api.generateOpenApi(capabilities, manifest);
+        const againstPath = resolvePath(opts.against);
+        const prevRaw = await readFile(againstPath, 'utf8');
+        const prev = api.parseOpenApiDocument(prevRaw, againstPath);
+        const diff = api.diffOpenApi(prev, current);
+        if (opts.json) {
+            console.log(JSON.stringify(diff, null, 2));
+        }
+        else {
+            for (const b of diff.breaking) {
+                warn(`[BREAKING] ${b.message}`);
+            }
+            for (const nb of diff.nonBreaking) {
+                info(`[non-breaking] ${nb.message}`);
+            }
+        }
+        if (diff.breaking.length > 0) {
+            process.exit(1);
+        }
+        success('No breaking API changes detected');
+    });
+    const testFixtures = apiCmd
+        .command('test-fixtures')
+        .description('Validate API test fixtures against capability schemas');
+    testFixtures
+        .command('validate')
+        .description('Validate fixture files')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        const { api, manifest, capabilities, appRoot } = await loadManifestAndCaps();
+        const findings = await api.validateTestFixtures(capabilities, appRoot, manifest);
+        if (opts.json) {
+            console.log(JSON.stringify({ findings }, null, 2));
+        }
+        else {
+            for (const f of findings) {
+                warn(`[${f.code}] ${f.message}`);
+            }
+        }
+        if (findings.length > 0) {
+            process.exit(1);
+        }
+        success('All test fixtures are valid');
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/cli/commands/api.js.map

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

package/dist/cli/commands/browser-extension.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+export interface BrowserExtensionScaffoldOptions {
+    appName?: string;
+    apiBaseUrl: string;
+    browser?: string;
+    force?: boolean;
+    json?: boolean;
+}
+export declare function registerBrowserExtensionCommand(program: Command): void;
+//# sourceMappingURL=browser-extension.d.ts.map

package/dist/cli/commands/browser-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-extension.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/browser-extension.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDzC,MAAM,WAAW,+BAA+B;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAyHD,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkJtE"}

package/dist/cli/commands/browser-extension.js

@@ -0,0 +1,235 @@
+// ── plumbus browser-extension ──
+// Scaffold a wxt Chrome/Firefox extension wired to Plumbus capabilities.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { discoverResources } from '../discover.js';
+import { writeGeneratedFiles, writeScaffoldFiles } from '../scaffold-write.js';
+import { findGitRoot, info, resolvePath, success, warn } from '../utils.js';
+function toFlowTriggers(flows) {
+    return flows.map((flow) => ({
+        name: flow.name,
+        domain: flow.domain,
+        description: flow.description,
+    }));
+}
+function parseBrowsers(value) {
+    const v = value ?? 'both';
+    if (v === 'chrome')
+        return ['chrome'];
+    if (v === 'firefox')
+        return ['firefox'];
+    if (v === 'both')
+        return ['chrome', 'firefox'];
+    throw new Error(`Invalid --browser "${v}". Use chrome, firefox, or both.`);
+}
+function validateApiBaseUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid --api-base-url "${url}". Must be an absolute http(s) URL.`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error(`--api-base-url must use http: or https: (got ${parsed.protocol}).`);
+    }
+    const bad = ['chrome-extension:', 'moz-extension:', 'file:'];
+    if (bad.includes(parsed.protocol)) {
+        throw new Error(`--api-base-url must not use ${parsed.protocol}`);
+    }
+}
+function normalizeApiBaseUrl(url) {
+    validateApiBaseUrl(url);
+    return url.replace(/\/+$/, '');
+}
+function inferAppName(cwd) {
+    let dir = cwd;
+    for (let i = 0; i < 8; i++) {
+        const pkgPath = path.join(dir, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+                if (typeof pkg.name === 'string' && pkg.name.length > 0) {
+                    return pkg.name.replace(/^@[^/]+\//, '');
+                }
+            }
+            catch {
+                // continue
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
+function resolveRepoRootFromOutput(outputDir) {
+    const gitRoot = findGitRoot(path.resolve(outputDir));
+    return gitRoot;
+}
+async function loadUiGenerators() {
+    const resolvedPath = path.join(process.cwd(), 'node_modules', '@plumbus', 'ui', 'dist', 'index.js');
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error('missing-ui');
+    }
+    return (await import(pathToFileURL(resolvedPath).href));
+}
+async function loadBrowserExtensionGenerators() {
+    const resolvedPath = path.join(process.cwd(), 'node_modules', '@plumbus', 'browser-extension', 'dist', 'index.js');
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error('missing-browser-extension');
+    }
+    return (await import(pathToFileURL(resolvedPath).href));
+}
+async function loadScaffoldDeps() {
+    try {
+        const ui = await loadUiGenerators();
+        const browserExtension = await loadBrowserExtensionGenerators();
+        return { ui, browserExtension };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        if (reason === 'missing-ui' || reason === 'missing-browser-extension') {
+            console.error('');
+            console.error('Browser extension scaffolder dependencies are not installed.');
+            console.error('Run: pnpm add @plumbus/ui @plumbus/browser-extension');
+            console.error('');
+            process.exit(1);
+        }
+        throw err;
+    }
+}
+const CLIENT_HEADER = `// Generated by plumbus browser-extension scaffold.
+// Do not edit manually. Re-run the scaffold command after capability changes.
+
+`;
+export function registerBrowserExtensionCommand(program) {
+    const browserExtension = program
+        .command('browser-extension')
+        .description('Scaffold a wxt browser extension wired to Plumbus capabilities');
+    browserExtension
+        .command('scaffold [output-dir]')
+        .description('Generate a Chrome/Firefox extension project')
+        .option('--app-name <name>', 'Application name for the generated extension')
+        .option('--api-base-url <url>', 'Absolute API base URL (required)', '')
+        .option('--browser <target>', 'chrome | firefox | both', 'both')
+        .option('--force', 'Overwrite existing scaffold files')
+        .option('--json', 'Emit machine-readable result JSON')
+        .action(async (outputDir, opts) => {
+        if (!opts.apiBaseUrl) {
+            console.error('--api-base-url is required');
+            process.exit(1);
+        }
+        let apiBaseUrl;
+        try {
+            apiBaseUrl = normalizeApiBaseUrl(opts.apiBaseUrl);
+            parseBrowsers(opts.browser);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+        const outputRoot = resolvePath(outputDir ?? 'extension');
+        const repoRoot = resolveRepoRootFromOutput(outputRoot);
+        if (repoRoot && path.resolve(outputRoot) === path.resolve(repoRoot) && !opts.force) {
+            console.error('Refusing to scaffold into repository root. Pass a subdirectory or use --force.');
+            process.exit(1);
+        }
+        let appName = opts.appName;
+        if (!appName) {
+            appName = inferAppName(process.cwd());
+            if (appName && !opts.json) {
+                info(`Inferred --app-name ${appName}`);
+            }
+        }
+        if (!appName) {
+            console.error('--app-name is required (could not infer from package.json)');
+            process.exit(1);
+        }
+        const { ui, browserExtension } = await loadScaffoldDeps();
+        try {
+            browserExtension.assertValidAppName(appName);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+        if (!opts.json) {
+            info('Discovering capabilities and flows...');
+        }
+        const resources = await discoverResources();
+        const flows = toFlowTriggers(resources.flows);
+        const browsers = parseBrowsers(opts.browser);
+        const registryEntries = [
+            ...resources.capabilities.map((cap) => {
+                const exportName = ui.capabilityClientFnName(cap);
+                browserExtension.assertValidClientExportName(exportName, `capability "${cap.name}"`);
+                return { messageKey: exportName, exportName };
+            }),
+            ...flows.map((flow) => {
+                const exportName = ui.flowTriggerFnName(flow);
+                browserExtension.assertValidClientExportName(exportName, `flow "${flow.name}"`);
+                return { messageKey: exportName, exportName };
+            }),
+        ];
+        const sampleSel = browserExtension.selectSampleCapability(resources.capabilities);
+        const sampleMessageKey = sampleSel.mode === 'zero-input' && sampleSel.capability
+            ? ui.capabilityClientFnName(sampleSel.capability)
+            : undefined;
+        const clientContent = CLIENT_HEADER +
+            ui.generateClientModule(resources.capabilities, flows, { baseUrl: apiBaseUrl });
+        const shellFiles = browserExtension.generateBrowserExtensionScaffold({
+            config: {
+                appName,
+                apiBaseUrl,
+                browsers,
+                auth: true,
+                registryEntries,
+                sampleMessageKey,
+            },
+            capabilities: resources.capabilities,
+            flows,
+        });
+        const clientFile = { path: 'src/client/api.ts', content: clientContent };
+        const scaffoldResult = writeScaffoldFiles(outputRoot, shellFiles, opts.force);
+        const clientWritten = writeGeneratedFiles(outputRoot, [clientFile]);
+        const plumbusCache = resolvePath('.plumbus/generated/browser-extension');
+        if (path.resolve(plumbusCache) !== path.resolve(outputRoot)) {
+            writeGeneratedFiles(plumbusCache, [clientFile]);
+        }
+        const warnings = [];
+        if (scaffoldResult.skipped.length > 0) {
+            warnings.push(`${scaffoldResult.skipped.length} scaffold file(s) skipped (already exist)`);
+        }
+        if (opts.force && scaffoldResult.overwritten.length > 0) {
+            warnings.push('Existing scaffold files were overwritten — local edits may be lost');
+        }
+        const result = {
+            outputDir: outputRoot,
+            written: [...scaffoldResult.written, ...clientWritten],
+            skipped: scaffoldResult.skipped,
+            overwritten: scaffoldResult.overwritten,
+            generatedClient: 'src/client/api.ts',
+            warnings,
+        };
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        for (const file of scaffoldResult.written) {
+            success(`Generated ${path.relative(process.cwd(), file)}`);
+        }
+        for (const file of clientWritten) {
+            success(`Generated ${path.relative(process.cwd(), file)}`);
+        }
+        for (const file of scaffoldResult.skipped) {
+            warn(`Skipped (exists): ${path.relative(process.cwd(), file)}`);
+        }
+        if (opts.force && scaffoldResult.overwritten.length > 0) {
+            warn('Used --force: existing scaffold files may have been overwritten.');
+        }
+    });
+}
+//# sourceMappingURL=browser-extension.js.map

package/dist/cli/commands/browser-extension.js.map

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

package/dist/cli/commands/index.d.ts

@@ -1,4 +1,6 @@
 export { registerAgentCommand } from './agent.js';
+export { registerApiCommand } from './api.js';
+export { registerBrowserExtensionCommand } from './browser-extension.js';
 export { registerCapabilityCommand } from './capability.js';
 export { registerCertifyCommand } from './certify.js';
 export { registerCreateCommand } from './create.js';

package/dist/cli/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/commands/index.js

@@ -4,6 +4,7 @@
 //
 // Available commands:
 //   agent      — Generate AI agent briefs for resources
+//   api        — External API contract validate, generate, diff
 //   capability — Scaffold a new capability
 //   certify    — Run compliance profile assessment
 //   create     — Scaffold a new Plumbus application
@@ -27,6 +28,8 @@
 //   upgrade    — Migrate legacy artifacts after framework upgrades
 //   verify     — Run governance rules
 export { registerAgentCommand } from './agent.js';
+export { registerApiCommand } from './api.js';
+export { registerBrowserExtensionCommand } from './browser-extension.js';
 export { registerCapabilityCommand } from './capability.js';
 export { registerCertifyCommand } from './certify.js';
 export { registerCreateCommand } from './create.js';