@plumbus/core 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/capability.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2BhE"}

package/dist/cli/commands/capability.js

@@ -0,0 +1,27 @@
+// ── plumbus capability new ──
+// Scaffold a new capability
+import * as path from 'node:path';
+import { capabilityTemplate, capabilityTestTemplate } from '../templates/resources.js';
+import { error, exists, resolvePath, success, toKebabCase, writeFile } from '../utils.js';
+export function registerCapabilityCommand(program) {
+    const cmd = program.command('capability').description('Manage capabilities');
+    cmd
+        .command('new <name>')
+        .description('Scaffold a new capability')
+        .option('--kind <kind>', 'Capability kind: query, action, job, eventHandler', 'action')
+        .option('--domain <domain>', 'Domain name', 'default')
+        .action((name, opts) => {
+        const kind = opts.kind ?? 'action';
+        const domain = opts.domain ?? 'default';
+        const kebab = toKebabCase(name);
+        const baseDir = resolvePath('app', 'capabilities', domain, kebab);
+        if (exists(baseDir)) {
+            error(`Capability "${kebab}" already exists in domain "${domain}"`);
+            process.exit(1);
+        }
+        writeFile(path.join(baseDir, 'capability.ts'), capabilityTemplate(name, kind, domain));
+        writeFile(path.join(baseDir, 'tests', `${kebab}.test.ts`), capabilityTestTemplate(name, domain));
+        success(`Created capability: app/capabilities/${domain}/${kebab}/`);
+    });
+}
+//# sourceMappingURL=capability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../../src/cli/commands/capability.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,4BAA4B;AAG5B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO1F,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAE7E,GAAG;SACA,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,eAAe,EAAE,mDAAmD,EAAE,QAAQ,CAAC;SACtF,MAAM,CAAC,mBAAmB,EAAE,aAAa,EAAE,SAAS,CAAC;SACrD,MAAM,CAAC,CAAC,IAAY,EAAE,IAA0B,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;QACxC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAElE,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,eAAe,KAAK,+BAA+B,MAAM,GAAG,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACvF,SAAS,CACP,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,UAAU,CAAC,EAC/C,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CACrC,CAAC;QAEF,OAAO,CAAC,wCAAwC,MAAM,IAAI,KAAK,GAAG,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { Command } from 'commander';
+import type { CapabilityContract } from '../../types/capability.js';
+import type { EntityDefinition } from '../../types/entity.js';
+import { GovernanceSeverity, RuleStatus } from '../../types/enums.js';
+import type { GovernanceOverride, PolicyReport } from '../../types/governance.js';
+export interface CertifyOptions {
+    json?: boolean;
+}
+export interface PolicyRule {
+    name: string;
+    severity: (typeof GovernanceSeverity)[keyof typeof GovernanceSeverity];
+    evaluate: (ctx: PolicyContext) => (typeof RuleStatus)[keyof typeof RuleStatus];
+    description: string;
+    remediation?: string;
+}
+export interface PolicyContext {
+    capabilities: CapabilityContract[];
+    entities: EntityDefinition[];
+    overrides: GovernanceOverride[];
+}
+/** Evaluate a policy profile against the system inventory */
+export declare function evaluatePolicy(policyName: string, capabilities: CapabilityContract[], entities: EntityDefinition[], overrides?: GovernanceOverride[]): PolicyReport;
+export declare function registerCertifyCommand(program: Command): void;
+//# sourceMappingURL=certify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"certify.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/certify.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;AAC9D,OAAO,EAEL,kBAAkB,EAElB,UAAU,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAkB,MAAM,2BAA2B,CAAC;AAIlG,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;IACvE,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAyKD,6DAA6D;AAC7D,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,kBAAkB,EAAE,EAClC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,SAAS,GAAE,kBAAkB,EAAO,GACnC,YAAY,CAiCd;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkD7D"}

package/dist/cli/commands/certify.js

@@ -0,0 +1,228 @@
+// ── plumbus certify policy ──
+// Run policy compatibility assessment and generate report
+import { FieldClassification, GovernanceSeverity, PolicyProfile, RuleStatus, } from '../../types/enums.js';
+import { discoverResources } from '../discover.js';
+import { info, error as logError, success, warn } from '../utils.js';
+const commonRules = [
+    {
+        name: 'access-control-required',
+        severity: GovernanceSeverity.High,
+        description: 'All capabilities must have access policies',
+        remediation: 'Add access policies to all capabilities',
+        evaluate: (ctx) => ctx.capabilities.every((c) => c.access && (c.access.roles?.length || c.access.scopes?.length || c.access.public))
+            ? RuleStatus.Pass
+            : RuleStatus.Fail,
+    },
+    {
+        name: 'tenant-isolation',
+        severity: GovernanceSeverity.High,
+        description: 'All data entities must enforce tenant isolation',
+        remediation: 'Set tenantScoped: true on all entities',
+        evaluate: (ctx) => ctx.entities.every((e) => e.tenantScoped) ? RuleStatus.Pass : RuleStatus.Partial,
+    },
+    {
+        name: 'audit-logging',
+        severity: GovernanceSeverity.High,
+        description: 'All action/job capabilities must have audit enabled',
+        remediation: 'Enable audit settings on action and job capabilities',
+        evaluate: (ctx) => {
+            const actionCaps = ctx.capabilities.filter((c) => c.kind === 'action' || c.kind === 'job');
+            return actionCaps.every((c) => c.audit?.enabled !== false)
+                ? RuleStatus.Pass
+                : RuleStatus.Fail;
+        },
+    },
+];
+const policyRuleSets = {
+    [PolicyProfile.PciDss]: [
+        ...commonRules,
+        {
+            name: 'pci-encryption-required',
+            severity: GovernanceSeverity.High,
+            description: 'Sensitive and highly_sensitive fields must be encrypted',
+            remediation: 'Add encrypted: true to all sensitive/highly_sensitive fields',
+            evaluate: (ctx) => {
+                for (const entity of ctx.entities) {
+                    for (const field of Object.values(entity.fields)) {
+                        const cls = field.options.classification;
+                        if ((cls === FieldClassification.Sensitive ||
+                            cls === FieldClassification.HighlySensitive) &&
+                            !field.options.encrypted) {
+                            return RuleStatus.Fail;
+                        }
+                    }
+                }
+                return RuleStatus.Pass;
+            },
+        },
+    ],
+    [PolicyProfile.Gdpr]: [
+        ...commonRules,
+        {
+            name: 'gdpr-data-classification',
+            severity: GovernanceSeverity.High,
+            description: 'All personal data fields must have classification metadata',
+            remediation: 'Add classification to fields containing personal data',
+            evaluate: (ctx) => {
+                for (const entity of ctx.entities) {
+                    for (const field of Object.values(entity.fields)) {
+                        if (!field.options.classification)
+                            return RuleStatus.Partial;
+                    }
+                }
+                return RuleStatus.Pass;
+            },
+        },
+        {
+            name: 'gdpr-retention-policy',
+            severity: GovernanceSeverity.Warning,
+            description: 'Entities with personal data should define retention policies',
+            remediation: 'Add retention configuration to entities with personal data',
+            evaluate: (ctx) => {
+                const hasPersonal = ctx.entities.some((e) => Object.values(e.fields).some((f) => f.options.classification === FieldClassification.Personal ||
+                    f.options.classification === FieldClassification.Sensitive));
+                if (!hasPersonal)
+                    return RuleStatus.Pass;
+                return ctx.entities
+                    .filter((e) => Object.values(e.fields).some((f) => f.options.classification === FieldClassification.Personal))
+                    .every((e) => e.retention)
+                    ? RuleStatus.Pass
+                    : RuleStatus.Partial;
+            },
+        },
+    ],
+    [PolicyProfile.Soc2]: [
+        ...commonRules,
+        {
+            name: 'soc2-comprehensive-audit',
+            severity: GovernanceSeverity.High,
+            description: 'All capabilities must have audit trails enabled',
+            remediation: 'Enable audit on all capabilities',
+            evaluate: (ctx) => ctx.capabilities.every((c) => c.audit?.enabled !== false)
+                ? RuleStatus.Pass
+                : RuleStatus.Fail,
+        },
+    ],
+    [PolicyProfile.Hipaa]: [
+        ...commonRules,
+        {
+            name: 'hipaa-phi-encryption',
+            severity: GovernanceSeverity.High,
+            description: 'All personal and sensitive fields must be encrypted (PHI protection)',
+            remediation: 'Encrypt all fields classified as personal, sensitive, or highly_sensitive',
+            evaluate: (ctx) => {
+                const protectedClassifications = [
+                    FieldClassification.Personal,
+                    FieldClassification.Sensitive,
+                    FieldClassification.HighlySensitive,
+                ];
+                for (const entity of ctx.entities) {
+                    for (const field of Object.values(entity.fields)) {
+                        if (field.options.classification &&
+                            protectedClassifications.includes(field.options.classification) &&
+                            !field.options.encrypted) {
+                            return RuleStatus.Fail;
+                        }
+                    }
+                }
+                return RuleStatus.Pass;
+            },
+        },
+        {
+            name: 'hipaa-field-masking',
+            severity: GovernanceSeverity.High,
+            description: 'Sensitive fields must be masked in logs',
+            remediation: 'Add maskedInLogs: true to sensitive fields',
+            evaluate: (ctx) => {
+                for (const entity of ctx.entities) {
+                    for (const field of Object.values(entity.fields)) {
+                        const cls = field.options.classification;
+                        if ((cls === FieldClassification.Sensitive ||
+                            cls === FieldClassification.HighlySensitive) &&
+                            !field.options.maskedInLogs) {
+                            return RuleStatus.Fail;
+                        }
+                    }
+                }
+                return RuleStatus.Pass;
+            },
+        },
+    ],
+    [PolicyProfile.InternalSecurityBaseline]: [...commonRules],
+};
+/** Evaluate a policy profile against the system inventory */
+export function evaluatePolicy(policyName, capabilities, entities, overrides = []) {
+    const rules = policyRuleSets[policyName] ?? commonRules;
+    const ctx = { capabilities, entities, overrides };
+    const results = rules.map((rule) => {
+        const overridden = overrides.some((o) => o.rule === rule.name);
+        const status = overridden ? RuleStatus.Override : rule.evaluate(ctx);
+        return {
+            rule: rule.name,
+            status,
+            severity: rule.severity,
+            description: rule.description,
+            remediation: rule.remediation,
+        };
+    });
+    const total = results.length;
+    const passCount = results.filter((r) => r.status === RuleStatus.Pass || r.status === RuleStatus.Override).length;
+    const score = total > 0 ? Math.round((passCount / total) * 100) : 100;
+    return {
+        policy: policyName,
+        timestamp: new Date(),
+        compatibilityScore: score,
+        results,
+        overrides,
+        recommendations: results
+            .filter((r) => r.status === RuleStatus.Fail || r.status === RuleStatus.Partial)
+            .map((r) => r.remediation)
+            .filter((r) => !!r),
+    };
+}
+export function registerCertifyCommand(program) {
+    const cmd = program.command('certify').description('Policy certification');
+    cmd
+        .command('policy <name>')
+        .description('Run policy compatibility assessment (pci_dss, gdpr, soc2, hipaa, internal_security_baseline)')
+        .option('--json', 'Output as JSON')
+        .action(async (name, opts) => {
+        info(`Running policy assessment: ${name}`);
+        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 report = evaluatePolicy(name, capabilities, entities);
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log(`\nPolicy: ${report.policy}`);
+        console.log(`Score: ${report.compatibilityScore}%`);
+        console.log('');
+        for (const r of report.results) {
+            const icon = r.status === RuleStatus.Pass ? '✓' : r.status === RuleStatus.Override ? '⊘' : '✗';
+            const line = `${icon} [${r.status.toUpperCase()}] ${r.rule}: ${r.description}`;
+            if (r.status === RuleStatus.Fail)
+                logError(line);
+            else if (r.status === RuleStatus.Partial)
+                warn(line);
+            else
+                success(line);
+        }
+        if (report.recommendations && report.recommendations.length > 0) {
+            console.log('\nRecommendations:');
+            for (const rec of report.recommendations) {
+                info(`  → ${rec}`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=certify.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+export interface CreateOptions {
+    database?: string;
+    auth?: string;
+    ai?: string;
+    compliance?: string;
+    git?: boolean;
+    skipInstall?: boolean;
+}
+/** Generate the repository directory structure for a new Plumbus app */
+export declare function generateProjectStructure(appName: string, options: CreateOptions): Map<string, string>;
+export declare function registerCreateCommand(program: Command): void;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,GACrB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA0KrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD5D"}

package/dist/cli/commands/create.js

@@ -0,0 +1,190 @@
+// ── plumbus create <app-name> ──
+// Interactive project scaffolding
+import { execSync } from 'node:child_process';
+import * as path from 'node:path';
+import { error, exists, info, success, toKebabCase, warn, writeFile } from '../utils.js';
+/** Generate the repository directory structure for a new Plumbus app */
+export function generateProjectStructure(appName, options) {
+    const files = new Map();
+    // package.json
+    files.set('package.json', JSON.stringify({
+        name: toKebabCase(appName),
+        version: '0.1.0',
+        type: 'module',
+        scripts: {
+            dev: 'plumbus dev',
+            build: 'tsc -b',
+            test: 'vitest run',
+            typecheck: 'tsc --noEmit',
+            'migrate:generate': 'plumbus migrate generate',
+            'migrate:apply': 'plumbus migrate apply',
+            verify: 'plumbus verify',
+        },
+        dependencies: {
+            '@plumbus/core': '^0.1.0',
+            zod: '^3.24.0',
+        },
+        devDependencies: {
+            typescript: '^5.7.0',
+            vitest: '^3.0.0',
+            '@types/node': '^22.0.0',
+        },
+    }, null, 2));
+    // tsconfig
+    files.set('tsconfig.json', JSON.stringify({
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'Node16',
+            moduleResolution: 'Node16',
+            strict: true,
+            esModuleInterop: true,
+            outDir: 'dist',
+            rootDir: 'src',
+            declaration: true,
+            declarationMap: true,
+            sourceMap: true,
+            noUnusedLocals: true,
+            noUnusedParameters: true,
+            noUncheckedIndexedAccess: true,
+        },
+        include: ['src'],
+        exclude: ['node_modules', 'dist'],
+    }, null, 2));
+    // App config
+    const complianceArr = options.compliance
+        ? options.compliance.split(',').map((c) => `"${c.trim()}"`)
+        : [];
+    files.set('config/app.config.ts', `import type { PlumbusConfig } from "@plumbus/core";
+
+export const config: PlumbusConfig = {
+  environment: "development",
+  database: {
+    host: process.env["DB_HOST"] ?? "localhost",
+    port: Number(process.env["DB_PORT"] ?? 5432),
+    database: process.env["DB_NAME"] ?? "${toKebabCase(appName)}",
+    user: process.env["DB_USER"] ?? "postgres",
+    password: process.env["DB_PASSWORD"] ?? "",
+  },
+  queue: {
+    host: process.env["QUEUE_HOST"] ?? "localhost",
+    port: Number(process.env["QUEUE_PORT"] ?? 6379),
+  },
+  auth: {
+    provider: "${options.auth ?? 'jwt'}",
+  },${options.ai ? `\n  ai: {\n    provider: "${options.ai}",\n    apiKey: process.env["AI_API_KEY"] ?? "",\n  },` : ''}${complianceArr.length > 0 ? `\n  complianceProfiles: [${complianceArr.join(', ')}],` : ''}
+};
+`);
+    // AI config
+    files.set('config/ai.config.ts', `// AI provider configuration
+export const aiConfig = {
+  provider: "${options.ai ?? 'openai'}",
+  defaultModel: "gpt-4o-mini",
+  embeddingModel: "text-embedding-3-small",
+};
+`);
+    // Directory stubs
+    files.set('app/capabilities/.gitkeep', '');
+    files.set('app/entities/.gitkeep', '');
+    files.set('app/flows/.gitkeep', '');
+    files.set('app/events/.gitkeep', '');
+    files.set('app/prompts/.gitkeep', '');
+    files.set('app/compliance/overrides/.gitkeep', '');
+    // .gitignore
+    files.set('.gitignore', `node_modules/
+dist/
+.plumbus/generated/
+.env
+*.log
+`);
+    // .env.example
+    files.set('.env.example', `DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=${toKebabCase(appName)}
+DB_USER=postgres
+DB_PASSWORD=
+QUEUE_HOST=localhost
+QUEUE_PORT=6379
+AI_API_KEY=
+`);
+    // README
+    files.set('README.md', `# ${appName}
+
+Built with [Plumbus Framework](https://github.com/plumbus/plumbus).
+
+## Getting Started
+
+\`\`\`bash
+pnpm install
+plumbus doctor        # check environment
+plumbus migrate apply # run database migrations
+plumbus dev           # start development server
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+app/
+  capabilities/   # Business logic (defineCapability)
+  entities/       # Data models (defineEntity)
+  flows/          # Multi-step workflows (defineFlow)
+  events/         # Domain events (defineEvent)
+  prompts/        # AI prompts (definePrompt)
+config/
+  app.config.ts   # Framework configuration
+  ai.config.ts    # AI provider configuration
+\`\`\`
+`);
+    return files;
+}
+export function registerCreateCommand(program) {
+    program
+        .command('create <app-name>')
+        .description('Create a new Plumbus application')
+        .option('--database <type>', 'Database type', 'postgresql')
+        .option('--auth <provider>', 'Auth provider', 'jwt')
+        .option('--ai <provider>', 'AI provider', 'openai')
+        .option('--compliance <profiles>', 'Compliance profiles (comma-separated)')
+        .option('--git', 'Initialize a git repository')
+        .option('--skip-install', 'Skip dependency installation')
+        .action(async (appName, opts) => {
+        const targetDir = path.resolve(process.cwd(), toKebabCase(appName));
+        if (exists(targetDir)) {
+            error(`Directory "${toKebabCase(appName)}" already exists`);
+            process.exit(1);
+        }
+        info(`Creating Plumbus app: ${appName}`);
+        const files = generateProjectStructure(appName, opts);
+        for (const [filePath, content] of files) {
+            writeFile(path.join(targetDir, filePath), content);
+        }
+        success(`Project created at ${targetDir}`);
+        // Git initialization (only when explicitly requested with --git)
+        if (opts.git) {
+            try {
+                execSync('git init', { cwd: targetDir, stdio: 'pipe' });
+                execSync('git add -A', { cwd: targetDir, stdio: 'pipe' });
+                execSync('git commit -m "Initial commit from plumbus create"', {
+                    cwd: targetDir,
+                    stdio: 'pipe',
+                });
+                success('Initialized git repository');
+            }
+            catch {
+                warn('Git initialization failed (git may not be installed)');
+            }
+        }
+        // Dependency installation
+        if (!opts.skipInstall) {
+            info('Installing dependencies...');
+            try {
+                execSync('pnpm install', { cwd: targetDir, stdio: 'inherit' });
+                success('Dependencies installed');
+            }
+            catch {
+                warn('Dependency installation failed. Run `pnpm install` manually.');
+            }
+        }
+        info('Run `plumbus init` inside the project to set up AI agent wiring.');
+    });
+}
+//# sourceMappingURL=create.js.map

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

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

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

@@ -0,0 +1,36 @@
+import type { Command } from 'commander';
+import { loadConfig, validateConfig } from '../../config/loader.js';
+import type { PlumbusServer } from '../../server/bootstrap.js';
+export interface DevOptions {
+    port?: string;
+    host?: string;
+    json?: boolean;
+}
+/**
+ * Run the development server config validation (sync).
+ *
+ * This:
+ * 1. Loads config from env variables with dev defaults
+ * 2. Validates the config
+ * 3. Prints server info
+ *
+ * Returns config and validation result. Call startDevServer() to start the actual server.
+ */
+export declare function runDev(options: DevOptions): {
+    config: ReturnType<typeof loadConfig>;
+    validation: ReturnType<typeof validateConfig>;
+    serverUrl: string;
+};
+/**
+ * Start the actual development server (async).
+ * Discovers resources from app/, populates registries, connects to DB,
+ * and starts the Fastify server. Sets up graceful shutdown on SIGINT/SIGTERM.
+ */
+export declare function startDevServer(options: DevOptions & {
+    db?: unknown;
+}): Promise<{
+    server: PlumbusServer;
+    shutdown: () => Promise<void>;
+}>;
+export declare function registerDevCommand(program: Command): void;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAMpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK/D,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG;IAC3C,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACtC,UAAU,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB,CAwCA;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC;IACpF,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC,CAgGD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwCzD"}