@plumbus/core 0.1.0

package/dist/cli/commands/ui.js

@@ -0,0 +1,291 @@
+// ── plumbus ui ──
+// Generate frontend-facing source files and scaffolds via @plumbus/ui.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { generateE2ETest, } from '../../testing/scaffolding.js';
+import { discoverResources } from '../discover.js';
+import { info, resolvePath, success, writeFile } from '../utils.js';
+function toFlowTriggers(flows) {
+    return flows.map((flow) => ({
+        name: flow.name,
+        domain: flow.domain,
+        description: flow.description,
+    }));
+}
+// ── E2E Page Discovery ──
+/**
+ * Scan a Next.js frontend for page.tsx files that contain ActionPanel components.
+ * Extracts route, panel titles, submit labels, and field names from the source.
+ */
+function discoverFrontendPages(frontendDir) {
+    const appDir = path.join(frontendDir, 'app');
+    if (!fs.existsSync(appDir))
+        return [];
+    const pages = [];
+    scanPagesRecursive(appDir, '', pages);
+    return pages;
+}
+function scanPagesRecursive(dir, routePrefix, out) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name === 'api')
+            continue; // skip API routes
+        if (entry.isDirectory()) {
+            scanPagesRecursive(path.join(dir, entry.name), `${routePrefix}/${entry.name}`, out);
+        }
+        if (entry.name === 'page.tsx' || entry.name === 'page.ts') {
+            const filePath = path.join(dir, entry.name);
+            const source = fs.readFileSync(filePath, 'utf-8');
+            const page = parsePageSource(source, routePrefix || '/');
+            if (page)
+                out.push(page);
+        }
+    }
+}
+function parsePageSource(source, route) {
+    // Extract ActionPanel usages
+    const actionPanelRegex = /<ActionPanel\s[\s\S]*?\/>/gs;
+    const panels = [...source.matchAll(actionPanelRegex)];
+    if (panels.length === 0) {
+        // Page might still be worth testing if it has headings
+        const hasH1 = /<h1[^>]*>/.test(source);
+        if (!hasH1)
+            return null;
+    }
+    const actions = [];
+    for (const match of panels) {
+        const panelStr = match[0];
+        const titleMatch = panelStr.match(/title="([^"]+)"/);
+        const submitMatch = panelStr.match(/submitLabel="([^"]+)"/);
+        const fieldsMatch = panelStr.match(/fields=\{(\w+)\}/);
+        const title = titleMatch?.[1] ?? 'Unknown panel';
+        const submitLabel = submitMatch?.[1] ?? 'Submit';
+        // Try to extract field names from the fields array variable
+        let fields = [];
+        if (fieldsMatch) {
+            const varName = fieldsMatch[1];
+            // Find the const declaration for this fields array
+            const varRegex = new RegExp(`const\\s+${varName}[^=]*=\\s*\\[([\\s\\S]*?)\\];`);
+            const varMatch = source.match(varRegex);
+            if (varMatch?.[1]) {
+                const nameMatches = [...varMatch[1].matchAll(/name:\s*"([^"]+)"/g)];
+                fields = nameMatches.map((m) => m[1] ?? '');
+            }
+        }
+        actions.push({ title, submitLabel, fields });
+    }
+    // Detect query panels (NextTargetPanel, BudgetPanel, etc. — articles with status-card class)
+    const queries = [];
+    const queryHeadings = [...source.matchAll(/<h3>([^<]+)<\/h3>/g)];
+    for (const h of queryHeadings) {
+        if (h[1] && !actions.some((a) => a.title === h[1])) {
+            queries.push({ title: h[1] });
+        }
+    }
+    const pageName = route === '/'
+        ? 'Home'
+        : route
+            .replace(/^\//, '')
+            .replace(/\//g, ' ')
+            .replace(/\b\w/g, (c) => c.toUpperCase());
+    return { route, pageName, actions, queries };
+}
+export function generateE2EVitestConfig(baseUrl) {
+    return `export default {
+  test: {
+    include: ["**/*.e2e.ts"],
+    testTimeout: 30_000,
+    hookTimeout: 30_000,
+    pool: "forks",
+    poolOptions: {
+      forks: { singleFork: true },
+    },
+  },
+};
+
+// E2E_BASE_URL default: ${baseUrl}
+`;
+}
+function nextEnvTypesFile() {
+    return {
+        path: 'next-env.d.ts',
+        content: `/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// This file is auto-generated by Next.js.
+`,
+    };
+}
+export function generateUiModuleFiles(capabilities, flows, generators, options, directoryPrefix = '') {
+    const prefix = directoryPrefix ? `${directoryPrefix}/` : '';
+    const clientConfig = {
+        baseUrl: options.baseUrl,
+        includeJsDoc: options.includeJsDoc,
+    };
+    const authConfig = {
+        provider: options.authProvider ?? 'jwt',
+        tokenKey: options.tokenKey,
+        multiTenant: options.multiTenant,
+    };
+    return [
+        {
+            path: `${prefix}client.ts`,
+            content: generators.generateClientModule(capabilities, toFlowTriggers(flows), clientConfig),
+        },
+        {
+            path: `${prefix}hooks.ts`,
+            content: generators.generateHooksModule(capabilities, clientConfig),
+        },
+        {
+            path: `${prefix}auth.ts`,
+            content: generators.generateAuthModule(authConfig),
+        },
+        {
+            path: `${prefix}form-hints.ts`,
+            content: generators.generateFormHintsModule(capabilities),
+        },
+    ];
+}
+export function generateNextjsAppFiles(appName, capabilities, flows, generators, options) {
+    const templateFiles = generators.generateNextjsTemplate({
+        appName,
+        auth: options.auth,
+        apiBaseUrl: options.apiBaseUrl,
+    }, capabilities);
+    const moduleFiles = generateUiModuleFiles(capabilities, flows, generators, {
+        ...options,
+        baseUrl: options.baseUrl ?? '/api/plumbus',
+    }, 'generated');
+    return [...templateFiles, nextEnvTypesFile(), ...moduleFiles];
+}
+async function loadUiGenerators() {
+    try {
+        const resolvedPath = path.join(process.cwd(), 'node_modules', '@plumbus', 'ui', 'dist', 'index.js');
+        if (!fs.existsSync(resolvedPath)) {
+            throw new Error('missing-ui-dist');
+        }
+        return (await import(pathToFileURL(resolvedPath).href));
+    }
+    catch {
+        throw new Error('Could not load @plumbus/ui. Install or link @plumbus/ui in the application before running `plumbus ui` commands.');
+    }
+}
+function writeGeneratedFiles(outputRoot, files) {
+    const written = [];
+    for (const file of files) {
+        writeFile(path.join(outputRoot, file.path), file.content);
+        written.push(path.join(outputRoot, file.path));
+    }
+    return written;
+}
+/** Auto-detect the frontend generated dir. If a Next.js frontend exists, write there. */
+function resolveGenerateOutDir(explicit) {
+    if (explicit)
+        return explicit;
+    // Check common Next.js frontend locations
+    for (const candidate of ['frontend', 'web', 'client', 'app']) {
+        const tsconfigPath = path.join(process.cwd(), candidate, 'tsconfig.json');
+        if (fs.existsSync(tsconfigPath)) {
+            return path.join(candidate, 'generated');
+        }
+    }
+    return '.plumbus/generated/ui';
+}
+export function registerUiCommand(program) {
+    const ui = program
+        .command('ui')
+        .description('Generate frontend source files and scaffolds with @plumbus/ui');
+    ui.command('generate')
+        .description('Generate UI modules (client, hooks, auth, form hints) from discovered contracts')
+        .option('--out-dir <path>', 'Output directory (auto-detects frontend/generated if a Next.js app exists)')
+        .option('--base-url <url>', 'Base URL prepended to generated API calls', '')
+        .option('--auth-provider <provider>', 'Auth provider for generated auth helpers', 'jwt')
+        .option('--token-key <key>', 'Storage key for generated auth helpers')
+        .option('--multi-tenant', 'Include tenant helpers in generated auth module')
+        .option('--include-jsdoc', 'Emit JSDoc comments in generated client and hook modules')
+        .option('--json', 'Output generated file list as JSON')
+        .action(async (opts) => {
+        info('Loading @plumbus/ui generators...');
+        const generators = await loadUiGenerators();
+        info('Discovering capabilities and flows...');
+        const resources = await discoverResources();
+        const outDir = resolveGenerateOutDir(opts.outDir);
+        const outputRoot = resolvePath(outDir);
+        info(`Writing UI modules to ${outDir}`);
+        const files = generateUiModuleFiles(resources.capabilities, resources.flows, generators, opts);
+        const written = writeGeneratedFiles(outputRoot, files);
+        // Also write to .plumbus/generated/ui/ as the contract artifact cache
+        const plumbusOutDir = resolvePath('.plumbus/generated/ui');
+        if (outputRoot !== plumbusOutDir) {
+            writeGeneratedFiles(plumbusOutDir, files);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ generated: written }, null, 2));
+            return;
+        }
+        for (const file of written) {
+            success(`Generated ${path.relative(process.cwd(), file)}`);
+        }
+    });
+    ui.command('nextjs [output-dir]')
+        .description('Scaffold a Next.js frontend wired to generated Plumbus UI modules')
+        .option('--app-name <name>', 'Application name used in the generated Next.js app')
+        .option('--api-base-url <url>', 'Upstream Plumbus API base URL', 'http://localhost:3000')
+        .option('--base-url <url>', 'Client base URL used by generated frontend modules')
+        .option('--auth-provider <provider>', 'Auth provider for generated auth helpers', 'jwt')
+        .option('--token-key <key>', 'Storage key for generated auth helpers')
+        .option('--multi-tenant', 'Include tenant helpers in generated auth module')
+        .option('--include-jsdoc', 'Emit JSDoc comments in generated client and hook modules')
+        .option('--no-auth', 'Disable auth wiring in the generated Next.js app')
+        .option('--json', 'Output generated file list as JSON')
+        .action(async (outputDir, opts) => {
+        info('Loading @plumbus/ui generators...');
+        const generators = await loadUiGenerators();
+        info('Discovering capabilities and flows...');
+        const resources = await discoverResources();
+        const appName = opts.appName ?? path.basename(process.cwd());
+        const outputRoot = resolvePath(outputDir ?? 'frontend');
+        const files = generateNextjsAppFiles(appName, resources.capabilities, resources.flows, generators, opts);
+        const written = writeGeneratedFiles(outputRoot, files);
+        // Also write contract artifacts to .plumbus/generated/ui/
+        const uiModuleFiles = generateUiModuleFiles(resources.capabilities, resources.flows, generators, { ...opts, baseUrl: opts.baseUrl ?? '/api/plumbus' });
+        writeGeneratedFiles(resolvePath('.plumbus/generated/ui'), uiModuleFiles);
+        if (opts.json) {
+            console.log(JSON.stringify({ generated: written }, null, 2));
+            return;
+        }
+        for (const file of written) {
+            success(`Generated ${path.relative(process.cwd(), file)}`);
+        }
+    });
+    // ── plumbus ui e2e ──
+    ui.command('e2e [output-dir]')
+        .description('Scaffold vitest + Playwright E2E test files by scanning the frontend pages')
+        .option('--frontend-dir <dir>', 'Frontend directory to scan for pages', 'frontend')
+        .option('--base-url <url>', 'Base URL for E2E tests', 'http://localhost:3001')
+        .action(async (outputDir, opts) => {
+        const frontendDir = resolvePath(opts.frontendDir);
+        const outRoot = resolvePath(outputDir ?? path.join(opts.frontendDir, 'e2e'));
+        info('Scanning frontend pages for ActionPanel usage...');
+        const pages = discoverFrontendPages(frontendDir);
+        if (pages.length === 0) {
+            info('No pages with ActionPanel forms found.');
+            return;
+        }
+        // Generate vitest e2e config
+        const configContent = generateE2EVitestConfig(opts.baseUrl);
+        writeFile(path.join(outRoot, 'vitest.config.e2e.ts'), configContent);
+        success(`Generated vitest.config.e2e.ts`);
+        // Generate test files
+        for (const page of pages) {
+            const testContent = generateE2ETest(page);
+            const testPath = path.join(outRoot, `${page.route.replace(/^\//, '') || 'home'}.e2e.ts`);
+            writeFile(testPath, testContent);
+            success(`Generated ${path.relative(process.cwd(), testPath)}`);
+        }
+        info(`\nE2E tests generated in ${path.relative(process.cwd(), outRoot)}`);
+        info(`Run with: plumbus e2e --config ${path.relative(process.cwd(), path.join(outRoot, 'vitest.config.e2e.ts'))}`);
+    });
+}
+//# sourceMappingURL=ui.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { Command } from 'commander';
+import type { CapabilityContract } from '../../types/capability.js';
+import type { EntityDefinition } from '../../types/entity.js';
+import type { GovernanceSignal } from '../../types/governance.js';
+export interface VerifyOptions {
+    json?: boolean;
+}
+/** Check that all capabilities have access policies */
+export declare function ruleCapabilityAccessPolicy(capabilities: CapabilityContract[]): GovernanceSignal[];
+/** Check that capabilities declare their effects */
+export declare function ruleCapabilityEffects(capabilities: CapabilityContract[]): GovernanceSignal[];
+/** Check that entity fields with sensitive data have classifications */
+export declare function ruleEntityFieldClassification(entities: EntityDefinition[]): GovernanceSignal[];
+/** Check that sensitive fields are encrypted */
+export declare function ruleEncryptedSensitiveFields(entities: EntityDefinition[]): GovernanceSignal[];
+/** Check entities have tenant isolation */
+export declare function ruleEntityTenantIsolation(entities: EntityDefinition[]): GovernanceSignal[];
+/** Run all governance rules against a system inventory */
+export declare function runGovernanceRules(capabilities: CapabilityContract[], entities: EntityDefinition[]): GovernanceSignal[];
+export declare function registerVerifyCommand(program: Command): void;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,uDAAuD;AACvD,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,EAAE,CAiBjG;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,EAAE,CAiB5F;AAED,wEAAwE;AACxE,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAmB9F;AAED,gDAAgD;AAChD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAyB7F;AAED,2CAA2C;AAC3C,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAc1F;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,kBAAkB,EAAE,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,gBAAgB,EAAE,CAQpB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD5D"}

package/dist/cli/commands/verify.js

@@ -0,0 +1,153 @@
+// ── plumbus verify ──
+// Run all governance checks and report results
+import { FieldClassification, GovernanceSeverity } from '../../types/enums.js';
+import { discoverResources } from '../discover.js';
+import { info, error as logError, success, warn } from '../utils.js';
+// ── Built-in Governance Rules ──
+/** Check that all capabilities have access policies */
+export function ruleCapabilityAccessPolicy(capabilities) {
+    const signals = [];
+    for (const cap of capabilities) {
+        if (!cap.access ||
+            (!cap.access.roles?.length && !cap.access.scopes?.length && !cap.access.public)) {
+            signals.push({
+                severity: GovernanceSeverity.High,
+                rule: 'security.capability-access-policy',
+                description: `Capability "${cap.name}" has no access policy defined`,
+                affectedComponent: `capability:${cap.name}`,
+                remediation: 'Add an access policy with roles, scopes, or mark as public',
+            });
+        }
+    }
+    return signals;
+}
+/** Check that capabilities declare their effects */
+export function ruleCapabilityEffects(capabilities) {
+    const signals = [];
+    for (const cap of capabilities) {
+        const e = cap.effects;
+        const totalEffects = (e.data?.length ?? 0) + (e.events?.length ?? 0) + (e.external?.length ?? 0);
+        if (totalEffects > 10) {
+            signals.push({
+                severity: GovernanceSeverity.Warning,
+                rule: 'architecture.excessive-effects',
+                description: `Capability "${cap.name}" declares ${totalEffects} effects — consider splitting`,
+                affectedComponent: `capability:${cap.name}`,
+                remediation: 'Break the capability into smaller, focused capabilities',
+            });
+        }
+    }
+    return signals;
+}
+/** Check that entity fields with sensitive data have classifications */
+export function ruleEntityFieldClassification(entities) {
+    const signals = [];
+    const sensitivePatterns = /email|password|ssn|social_security|credit_card|phone|address|dob|date_of_birth/i;
+    for (const entity of entities) {
+        for (const [fieldName, fieldDef] of Object.entries(entity.fields)) {
+            if (sensitivePatterns.test(fieldName) && !fieldDef.options.classification) {
+                signals.push({
+                    severity: GovernanceSeverity.Warning,
+                    rule: 'privacy.missing-field-classification',
+                    description: `Entity "${entity.name}" field "${fieldName}" appears sensitive but has no classification`,
+                    affectedComponent: `entity:${entity.name}.${fieldName}`,
+                    remediation: `Add classification (e.g., personal, sensitive) to field "${fieldName}"`,
+                });
+            }
+        }
+    }
+    return signals;
+}
+/** Check that sensitive fields are encrypted */
+export function ruleEncryptedSensitiveFields(entities) {
+    const signals = [];
+    const highClassifications = [
+        FieldClassification.Sensitive,
+        FieldClassification.HighlySensitive,
+    ];
+    for (const entity of entities) {
+        for (const [fieldName, fieldDef] of Object.entries(entity.fields)) {
+            if (fieldDef.options.classification &&
+                highClassifications.includes(fieldDef.options.classification) &&
+                !fieldDef.options.encrypted) {
+                signals.push({
+                    severity: GovernanceSeverity.High,
+                    rule: 'privacy.sensitive-field-unencrypted',
+                    description: `Entity "${entity.name}" field "${fieldName}" is classified as ${fieldDef.options.classification} but not encrypted`,
+                    affectedComponent: `entity:${entity.name}.${fieldName}`,
+                    remediation: 'Add `encrypted: true` to the field definition',
+                });
+            }
+        }
+    }
+    return signals;
+}
+/** Check entities have tenant isolation */
+export function ruleEntityTenantIsolation(entities) {
+    const signals = [];
+    for (const entity of entities) {
+        if (!entity.tenantScoped) {
+            signals.push({
+                severity: GovernanceSeverity.Info,
+                rule: 'security.no-tenant-isolation',
+                description: `Entity "${entity.name}" is not tenant-scoped`,
+                affectedComponent: `entity:${entity.name}`,
+                remediation: 'Set `tenantScoped: true` if this entity holds tenant-specific data',
+            });
+        }
+    }
+    return signals;
+}
+/** Run all governance rules against a system inventory */
+export function runGovernanceRules(capabilities, entities) {
+    return [
+        ...ruleCapabilityAccessPolicy(capabilities),
+        ...ruleCapabilityEffects(capabilities),
+        ...ruleEntityFieldClassification(entities),
+        ...ruleEncryptedSensitiveFields(entities),
+        ...ruleEntityTenantIsolation(entities),
+    ];
+}
+export function registerVerifyCommand(program) {
+    program
+        .command('verify')
+        .description('Run governance checks and report results')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        info('Running governance verification...');
+        let capabilities = [];
+        let entities = [];
+        try {
+            const resources = await discoverResources();
+            capabilities = resources.capabilities;
+            entities = resources.entities;
+            info(`Discovered ${capabilities.length} capability(ies), ${entities.length} entity(ies)`);
+        }
+        catch {
+            warn('Could not auto-discover resources (app/ directory may not exist)');
+        }
+        const signals = runGovernanceRules(capabilities, entities);
+        if (opts.json) {
+            console.log(JSON.stringify({ signals, highCount: 0, warningCount: 0, infoCount: 0 }, null, 2));
+            return;
+        }
+        if (signals.length === 0) {
+            success('No governance issues detected.');
+            return;
+        }
+        const high = signals.filter((s) => s.severity === GovernanceSeverity.High);
+        const warnings = signals.filter((s) => s.severity === GovernanceSeverity.Warning);
+        const infos = signals.filter((s) => s.severity === GovernanceSeverity.Info);
+        for (const s of high)
+            logError(`[HIGH] ${s.rule}: ${s.description}`);
+        for (const s of warnings)
+            warn(`[WARN] ${s.rule}: ${s.description}`);
+        for (const s of infos)
+            info(`[INFO] ${s.rule}: ${s.description}`);
+        console.log(`\nTotal: ${high.length} high, ${warnings.length} warnings, ${infos.length} info`);
+        if (high.length > 0) {
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=verify.js.map

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

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

package/dist/cli/discover.d.ts

@@ -0,0 +1,26 @@
+import type { CapabilityContract } from '../types/capability.js';
+import type { EntityDefinition } from '../types/entity.js';
+import type { EventDefinition } from '../types/event.js';
+import type { FlowDefinition } from '../types/flow.js';
+import type { PromptDefinition } from '../types/prompt.js';
+export interface DiscoveredResources {
+    capabilities: CapabilityContract[];
+    entities: EntityDefinition[];
+    flows: FlowDefinition[];
+    events: EventDefinition[];
+    prompts: PromptDefinition[];
+}
+/**
+ * Discover all Plumbus resources from the app/ directory.
+ * Scans each subdirectory (capabilities, entities, flows, events, prompts)
+ * and classifies exported values by type.
+ *
+ * @param appRoot - Path to the project root (default: process.cwd())
+ */
+export declare function discoverResources(appRoot?: string): Promise<DiscoveredResources>;
+/**
+ * Synchronous check: does the app/ directory exist?
+ * Useful for quick validation before attempting discovery.
+ */
+export declare function hasAppDirectory(appRoot?: string): boolean;
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/cli/discover.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAyFD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAExE"}

package/dist/cli/discover.js

@@ -0,0 +1,127 @@
+// ── Resource Auto-Discovery ──
+// Scans app/ directories for defineCapability, defineEntity, defineFlow,
+// defineEvent, definePrompt exports and returns them.
+import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/**
+ * Scan a directory for .ts/.js files and dynamically import all exports.
+ * Returns an array of all exported values.
+ */
+async function scanDir(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const files = fs
+        .readdirSync(dir, { recursive: true })
+        .map((f) => String(f))
+        .filter((f) => (f.endsWith('.ts') || f.endsWith('.js')) &&
+        !f.endsWith('.d.ts') &&
+        !f.endsWith('.test.ts') &&
+        !f.endsWith('.test.js'));
+    const exports = [];
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        const fileUrl = pathToFileURL(filePath).href;
+        try {
+            const mod = (await import(fileUrl));
+            for (const value of Object.values(mod)) {
+                exports.push(value);
+            }
+        }
+        catch {
+            // Skip files that fail to import
+        }
+    }
+    return exports;
+}
+function isCapability(v) {
+    return (typeof v === 'object' &&
+        v !== null &&
+        'name' in v &&
+        'kind' in v &&
+        'domain' in v &&
+        'handler' in v &&
+        'effects' in v);
+}
+function isEntity(v) {
+    return (typeof v === 'object' &&
+        v !== null &&
+        'name' in v &&
+        'fields' in v &&
+        !('kind' in v) &&
+        !('handler' in v) &&
+        !('steps' in v) &&
+        !('payload' in v) &&
+        !('input' in v));
+}
+function isFlow(v) {
+    return typeof v === 'object' && v !== null && 'name' in v && 'steps' in v && 'domain' in v;
+}
+function isEvent(v) {
+    return (typeof v === 'object' &&
+        v !== null &&
+        'name' in v &&
+        'payload' in v &&
+        !('input' in v) &&
+        !('handler' in v));
+}
+function isPrompt(v) {
+    return (typeof v === 'object' &&
+        v !== null &&
+        'name' in v &&
+        'input' in v &&
+        'output' in v &&
+        !('handler' in v) &&
+        !('effects' in v));
+}
+/**
+ * Discover all Plumbus resources from the app/ directory.
+ * Scans each subdirectory (capabilities, entities, flows, events, prompts)
+ * and classifies exported values by type.
+ *
+ * @param appRoot - Path to the project root (default: process.cwd())
+ */
+export async function discoverResources(appRoot = process.cwd()) {
+    const appDir = path.join(appRoot, 'app');
+    // Register tsx to allow importing TypeScript files from consumer projects.
+    // Use createRequire to resolve tsx from the framework's own node_modules,
+    // since it may not be installed in the consumer project.
+    let unregister;
+    try {
+        const require = createRequire(import.meta.url);
+        const tsxPath = require.resolve('tsx/esm/api');
+        const tsx = await import(pathToFileURL(tsxPath).href);
+        unregister = tsx.register();
+    }
+    catch {
+        // tsx not available; only .js files will be importable
+    }
+    try {
+        const [capExports, entityExports, flowExports, eventExports, promptExports] = await Promise.all([
+            scanDir(path.join(appDir, 'capabilities')),
+            scanDir(path.join(appDir, 'entities')),
+            scanDir(path.join(appDir, 'flows')),
+            scanDir(path.join(appDir, 'events')),
+            scanDir(path.join(appDir, 'prompts')),
+        ]);
+        return {
+            capabilities: capExports.filter(isCapability),
+            entities: entityExports.filter(isEntity),
+            flows: flowExports.filter(isFlow),
+            events: eventExports.filter(isEvent),
+            prompts: promptExports.filter(isPrompt),
+        };
+    }
+    finally {
+        unregister?.();
+    }
+}
+/**
+ * Synchronous check: does the app/ directory exist?
+ * Useful for quick validation before attempting discovery.
+ */
+export function hasAppDirectory(appRoot = process.cwd()) {
+    return fs.existsSync(path.join(appRoot, 'app'));
+}
+//# sourceMappingURL=discover.js.map