@weave-kit/engine 0.1.0

package/dist/cli/mcp-config-snippets.js

@@ -0,0 +1,54 @@
+/**
+ * Ready-to-paste MCP client configuration for a WeaveKit `/mcp` endpoint.
+ * Pure (no I/O) so it is unit-testable and reused by `weave mcp:config`.
+ *
+ * Host specifics (verified 2026-09):
+ * - Claude Code: `claude mcp add --transport http <name> <url> --header "K: v"`
+ * - Claude Desktop / Cursor: `{"mcpServers": { "<name>": { type:"http", url, headers } }}`
+ * - VS Code: `{"servers": { "<name>": { type:"http", url, headers } }}` (note the `servers` key)
+ * - stdio-only hosts: bridge via `npx mcp-remote <url> --header "K: v"`
+ */
+export const MCP_HOSTS = ['claude-code', 'claude-desktop', 'cursor', 'vscode', 'stdio', 'curl'];
+/** build the JSON headers block shared by every config-file host */
+function headers(input) {
+    return {
+        Authorization: `Bearer ${input.key}`,
+        'X-Weavekit-On-Behalf-Of': input.identity,
+    };
+}
+/** ready-to-paste configuration for each supported MCP host */
+export function mcpConfigSnippets(input) {
+    const mcpServers = {
+        weavekit: { type: 'http', url: input.url, headers: headers(input) },
+    };
+    return {
+        'claude-code': [
+            'claude mcp add --transport http weavekit ' + input.url,
+            `  --header "Authorization: Bearer ${input.key}"`,
+            `  --header "X-Weavekit-On-Behalf-Of: ${input.identity}"`,
+        ].join(' \\\n'),
+        'claude-desktop': JSON.stringify({ mcpServers }, null, 2),
+        cursor: JSON.stringify({ mcpServers }, null, 2),
+        vscode: JSON.stringify({ servers: mcpServers }, null, 2),
+        stdio: [
+            'npx -y mcp-remote ' + input.url,
+            `  --header "Authorization: Bearer ${input.key}"`,
+            `  --header "X-Weavekit-On-Behalf-Of: ${input.identity}"`,
+        ].join(' \\\n'),
+        curl: [
+            `curl -s -X POST ${input.url}`,
+            `  -H 'content-type: application/json'`,
+            `  -H 'accept: application/json, text/event-stream'`,
+            `  -H 'authorization: Bearer ${input.key}'`,
+            `  -H 'x-weavekit-on-behalf-of: ${input.identity}'`,
+            `  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'`,
+        ].join(' \\\n'),
+    };
+}
+/** file each config-file snippet belongs in (for CLI labels) */
+export const MCP_HOST_FILES = {
+    'claude-desktop': 'claude_desktop_config.json',
+    cursor: '.cursor/mcp.json',
+    vscode: '.vscode/mcp.json',
+};
+//# sourceMappingURL=mcp-config-snippets.js.map

package/dist/cli/mcp-config-snippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config-snippets.js","sourceRoot":"","sources":["../../src/cli/mcp-config-snippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAqBzG,oEAAoE;AACpE,SAAS,OAAO,CAAC,KAAqB;IACpC,OAAO;QACL,aAAa,EAAE,UAAU,KAAK,CAAC,GAAG,EAAE;QACpC,yBAAyB,EAAE,KAAK,CAAC,QAAQ;KAC1C,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,MAAM,UAAU,GAAG;QACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;KACpE,CAAC;IAEF,OAAO;QACL,aAAa,EAAE;YACb,2CAA2C,GAAG,KAAK,CAAC,GAAG;YACvD,qCAAqC,KAAK,CAAC,GAAG,GAAG;YACjD,wCAAwC,KAAK,CAAC,QAAQ,GAAG;SAC1D,CAAC,IAAI,CAAC,OAAO,CAAC;QAEf,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzD,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAExD,KAAK,EAAE;YACL,oBAAoB,GAAG,KAAK,CAAC,GAAG;YAChC,qCAAqC,KAAK,CAAC,GAAG,GAAG;YACjD,wCAAwC,KAAK,CAAC,QAAQ,GAAG;SAC1D,CAAC,IAAI,CAAC,OAAO,CAAC;QAEf,IAAI,EAAE;YACJ,mBAAmB,KAAK,CAAC,GAAG,EAAE;YAC9B,uCAAuC;YACvC,oDAAoD;YACpD,+BAA+B,KAAK,CAAC,GAAG,GAAG;YAC3C,kCAAkC,KAAK,CAAC,QAAQ,GAAG;YACnD,gKAAgK;SACjK,CAAC,IAAI,CAAC,OAAO,CAAC;KAChB,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAuE;IAChG,gBAAgB,EAAE,4BAA4B;IAC9C,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,kBAAkB;CAC3B,CAAC"}

package/dist/cli/ready-screen.d.ts

@@ -0,0 +1,47 @@
+import type { CliPrinter } from './render.js';
+/** one advertised endpoint on the value screen */
+export interface ReadyEndpoint {
+    label: string;
+    url: string;
+    note?: string;
+}
+/** the `weave dev` "value screen" — shown once on startup */
+export interface ReadyScreen {
+    projectType?: string;
+    endpoints: ReadyEndpoint[];
+    objects: string[];
+    capabilities: {
+        label: string;
+        value: string;
+    }[];
+    nextSteps: string[];
+    /** true when the project has no objects yet (first-run guidance) */
+    empty: boolean;
+    /** the first statically-configured API key, when one exists (never a function/env secret) */
+    apiKey?: string;
+}
+export interface ReadyScreenInput {
+    port: number;
+    projectType?: string;
+    restEnabled: boolean;
+    restPrefix: string;
+    mcpEnabled: boolean;
+    mcpEndpoint: string;
+    eventsEnabled: boolean;
+    eventsPrefix: string;
+    objects: string[];
+    audit: boolean;
+    script: boolean;
+    events: boolean;
+    customTools: number;
+    /** first statically-configured API key (undefined → placeholder) */
+    apiKey?: string;
+}
+/**
+ * Build the `weave dev` value screen from runtime facts. Pure (no I/O) so it is
+ * unit-testable; `renderReadyScreen` handles the colored/human presentation.
+ */
+export declare function readyScreen(input: ReadyScreenInput): ReadyScreen;
+/** render the value screen (human mode) or emit it as JSON (`--json`) */
+export declare function renderReadyScreen(p: CliPrinter, screen: ReadyScreen): void;
+//# sourceMappingURL=ready-screen.d.ts.map

package/dist/cli/ready-screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-screen.d.ts","sourceRoot":"","sources":["../../src/cli/ready-screen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAoChE;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAsB1E"}

package/dist/cli/ready-screen.js

@@ -0,0 +1,71 @@
+import kleur from 'kleur';
+/**
+ * Build the `weave dev` value screen from runtime facts. Pure (no I/O) so it is
+ * unit-testable; `renderReadyScreen` handles the colored/human presentation.
+ */
+export function readyScreen(input) {
+    const base = `http://localhost:${input.port}`;
+    const endpoints = [];
+    if (input.restEnabled)
+        endpoints.push({ label: 'REST', url: `${base}${input.restPrefix}`, note: 'objects' });
+    if (input.mcpEnabled)
+        endpoints.push({ label: 'MCP', url: `${base}${input.mcpEndpoint}`, note: 'tools for agents' });
+    if (input.eventsEnabled)
+        endpoints.push({ label: 'events', url: `${base}${input.eventsPrefix}/events`, note: 'live SSE' });
+    const empty = input.objects.length === 0;
+    const key = input.apiKey ?? '<your API key>';
+    const nextSteps = empty
+        ? [
+            'Import an existing database:  weave introspect',
+            'Or create one:                weave object:create <name>',
+        ]
+        : [
+            `Try the API:      curl -H "Authorization: Bearer ${key}" ${base}${input.restPrefix}/objects/${input.objects[0]}`,
+            'Connect an agent: `weave mcp:config` (guide: docs/practices/06-connect-agent.md)',
+            'Edit schema:      objects/<name>/schema.json — save to hot-reload',
+        ];
+    const screen = {
+        endpoints,
+        objects: input.objects,
+        capabilities: [
+            { label: 'audit', value: input.audit ? 'on' : 'off' },
+            { label: 'script', value: input.script ? 'on' : 'off' },
+            { label: 'events', value: input.events ? 'on' : 'off' },
+            { label: 'custom tools', value: String(input.customTools) },
+        ],
+        nextSteps,
+        empty,
+    };
+    if (input.projectType !== undefined)
+        screen.projectType = input.projectType;
+    if (input.apiKey !== undefined)
+        screen.apiKey = input.apiKey;
+    return screen;
+}
+/** render the value screen (human mode) or emit it as JSON (`--json`) */
+export function renderReadyScreen(p, screen) {
+    if (p.json) {
+        p.data(screen);
+        return;
+    }
+    p.log('');
+    p.log(kleur.bold(`WeaveKit ready${screen.projectType !== undefined ? ` · ${screen.projectType}` : ''}`));
+    for (const e of screen.endpoints) {
+        const note = e.note === undefined ? '' : kleur.dim(`  ${e.note}`);
+        p.log(`  ${kleur.dim(e.label.padEnd(7))} ${kleur.cyan(e.url)}${note}`);
+    }
+    p.log('');
+    if (screen.empty) {
+        p.log(kleur.yellow('  No objects yet.'));
+    }
+    else {
+        p.log(`  ${screen.objects.length} object(s): ${screen.objects.join(', ')}`);
+    }
+    p.log(`  ${screen.capabilities.map((c) => `${c.label}: ${c.value}`).join('   ')}`);
+    p.log('');
+    p.log(kleur.bold('Next steps'));
+    for (const step of screen.nextSteps)
+        p.log(`  • ${step}`);
+    p.log('');
+}
+//# sourceMappingURL=ready-screen.js.map

package/dist/cli/ready-screen.js.map

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

package/dist/cli/render.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CLI output contract. `createPrinter` emits key/value, an aligned table, or
+ * raw JSON (`--json`). Tables/keys use `cli-table3`/`kleur`; inline coloring in
+ * commands goes through `kleur` directly (JSON mode never reaches the colored
+ * `log()`). The engine's own errors stay i18n'd; CLI messages are plain English.
+ */
+export interface CliPrinter {
+    /** whether `--json` was requested (machine-readable output) */
+    readonly json: boolean;
+    /** key/value block for each row; blank line between rows */
+    kv(rows: Record<string, string | number | undefined | boolean>[]): void;
+    /** aligned table (first row = header) */
+    table(rows: string[][]): void;
+    /** emit a raw structured payload in JSON mode (no-op otherwise) */
+    data(payload: unknown): void;
+    /** plain log line (suppressed in JSON mode) */
+    log(message: string): void;
+    /** log to stderr (shown in both modes) */
+    error(message: string): void;
+}
+/**
+ * Build a CLI printer — key/value, aligned table, or raw JSON (`--json`).
+ */
+export declare function createPrinter(options: {
+    json: boolean;
+}): CliPrinter;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/cli/render.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;IACxE,yCAAyC;IACzC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0CAA0C;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CA6CpE"}

package/dist/cli/render.js

@@ -0,0 +1,54 @@
+import Table from 'cli-table3';
+import kleur from 'kleur';
+/**
+ * Build a CLI printer — key/value, aligned table, or raw JSON (`--json`).
+ */
+export function createPrinter(options) {
+    if (options.json) {
+        return {
+            json: true,
+            kv() { },
+            table() { },
+            data(payload) {
+                console.log(JSON.stringify(payload, null, 2));
+            },
+            log() { },
+            error(message) {
+                console.error(message);
+            },
+        };
+    }
+    return {
+        json: false,
+        kv(rows) {
+            for (const row of rows) {
+                for (const [key, value] of Object.entries(row)) {
+                    if (value !== undefined)
+                        console.log(`${kleur.dim(key)}: ${value}`);
+                }
+                console.log('');
+            }
+        },
+        table(rows) {
+            if (rows.length === 0)
+                return;
+            const [head, ...body] = rows;
+            const table = new Table({
+                head: (head ?? []).map((cell) => kleur.cyan(cell)),
+                // disable cli-table3's own styling; kleur handles the head color
+                style: { head: [], border: [] },
+            });
+            for (const row of body)
+                table.push(row);
+            console.log(table.toString());
+        },
+        data() { },
+        log(message) {
+            console.log(message);
+        },
+        error(message) {
+            console.error(message);
+        },
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/cli/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAuB1B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,EAAE,KAAI,CAAC;YACP,KAAK,KAAI,CAAC;YACV,IAAI,CAAC,OAAO;gBACV,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,GAAG,KAAI,CAAC;YACR,KAAK,CAAC,OAAO;gBACX,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK;QACX,EAAE,CAAC,IAAI;YACL,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/C,IAAI,KAAK,KAAK,SAAS;wBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;gBACtE,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI;YACR,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC9B,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;gBACtB,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,iEAAiE;gBACjE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;aAChC,CAAC,CAAC;YACH,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,KAAI,CAAC;QACT,GAAG,CAAC,OAAO;YACT,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,OAAO;YACX,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/scaffold.d.ts

@@ -0,0 +1,20 @@
+import type { ProjectType } from './types/index.js';
+export interface ScaffoldProjectOptions {
+    /** starting-preset narrative; undefined = generic WeaveKit project */
+    type?: ProjectType;
+    /** overwrite existing files */
+    force?: boolean;
+    /** initialize a git repository (default true) when cwd is not already one */
+    git?: boolean;
+}
+export interface ScaffoldProjectResult {
+    /** files written (relative to cwd); `(overwritten)` marks force-replacements */
+    created: string[];
+    /** files skipped because they already exist (force=false) */
+    skipped: string[];
+    /** whether a git repo was initialized (cwd was not already a repo) */
+    gitInit: boolean;
+}
+/** scaffold a WeaveKit project into `cwd`; shared by `create-weavekit-app` */
+export declare function scaffoldProject(cwd: string, options?: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgLpD,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwCvH"}

package/dist/cli/scaffold.js

@@ -0,0 +1,204 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { FIELD_TYPES, SCHEMA_FORMAT_VERSION } from '../core/index.js';
+import { PRIMITIVE_FIELD_TYPES as PRIMITIVES, SEMANTIC_FIELD_TYPES as SEMANTICS } from '../core/types/registry.js';
+import { runGit } from '../runtime/git/index.js';
+import { version } from '../version.js';
+/** project-type presets (starting subsystem composition + narrative); core is never trimmed */
+const TYPE_NARRATIVES = {
+    agent: 'AI-Agent backend: metadata-driven objects with REST access for AI agents',
+    governance: 'Governance platform: auditable, permission-scoped business objects',
+    service: 'Business service: headless backend with RBAC and a REST API',
+    business: 'Business backend: objects and formulas on Postgres',
+};
+const LEADS_OBJECT = {
+    schemaVersion: SCHEMA_FORMAT_VERSION,
+    name: 'leads',
+    label: 'Leads',
+    fields: [
+        { name: 'id', type: FIELD_TYPES.STRING, primary: true },
+        { name: 'title', type: FIELD_TYPES.STRING, required: true },
+        { name: 'status', type: FIELD_TYPES.ENUM, options: ['active', 'archived'] },
+        // row-level ownership marker: read: "own" scopes queries to this field.
+        // The field name is arbitrary — only the `ownership: true` flag matters.
+        { name: 'owner_id', type: FIELD_TYPES.STRING, ownership: true },
+        // team marker: read: "team" scopes queries to this field (sales_manager).
+        { name: 'team_id', type: FIELD_TYPES.STRING, team: true },
+        { name: 'company', type: FIELD_TYPES.STRING },
+        { name: 'amount', type: FIELD_TYPES.CURRENCY },
+        // sales cannot read this field; sales_manager can (fields.exclude strips on read).
+        { name: 'source', type: FIELD_TYPES.STRING },
+    ],
+    permissions: {
+        // roles are user-defined — they must match the keys in your schema's permissions.
+        // update: true = all fields updatable, string[] = whitelist.
+        admin: { read: 'all', create: true, update: true, delete: true },
+        sales: {
+            read: 'own',
+            create: true,
+            update: ['title', 'status'],
+            delete: false,
+            fields: { exclude: ['source'] },
+        },
+        sales_manager: {
+            read: 'team',
+            create: true,
+            update: ['title', 'status'],
+            delete: false,
+            // no exclude → sales_manager sees `source` (only admin + managers can)
+        },
+    },
+};
+/** presets whose starting subsystem set includes the script sandbox */
+const SCRIPT_TYPES = new Set(['service', 'business']);
+/** engine primitives — always enabled */
+const BASE_FIELD_TYPES = PRIMITIVES;
+/** semantic types gated by `features.fieldTypes` */
+const SEMANTIC_FIELD_TYPES = SEMANTICS;
+/** per-projectType default `features.fieldTypes` whitelist (config gating, fail-closed) */
+const DEFAULT_FIELD_TYPES_BY_TYPE = {
+    // pure API tooling, no UI — identity/avatar semantics unused; extend via config
+    agent: [...BASE_FIELD_TYPES],
+    // governance: backend members/teams (person/department) of the user's own system
+    governance: [...BASE_FIELD_TYPES, ...SEMANTIC_FIELD_TYPES],
+    service: [...BASE_FIELD_TYPES, ...SEMANTIC_FIELD_TYPES],
+    business: [...BASE_FIELD_TYPES, ...SEMANTIC_FIELD_TYPES],
+};
+/** `features.fieldTypes` snippet for a project-type preset (undefined → no gating) */
+function renderFeatures(type) {
+    if (type === undefined)
+        return '';
+    const fieldTypes = DEFAULT_FIELD_TYPES_BY_TYPE[type];
+    return `  features: {
+    // field-type whitelist — a schema using a type outside this list is rejected
+    fieldTypes: [${fieldTypes.map((t) => `'${t}'`).join(', ')}],
+  },
+`;
+}
+function renderConfig(type) {
+    const narrative = type === undefined ? '' : `  // ${TYPE_NARRATIVES[type] ?? 'custom project'}\n`;
+    const projectType = type === undefined ? '' : `  projectType: '${type}',\n`;
+    const subsystems = type !== undefined && SCRIPT_TYPES.has(type)
+        ? `  subsystems: {
+    // sandbox hooks run in isolated workers (*.server.js)
+    script: { enabled: true },
+  },
+`
+        : '';
+    const features = renderFeatures(type);
+    return `import type { EngineConfig } from '@weave-kit/engine';\n
+  // WeaveKit engine configuration.
+${narrative}export default {
+${projectType}${subsystems}${features}  schemaDir: '.',
+  auth: {
+    source: {
+      // Replace with real keys; prefer env references:
+      // process.env.WEAVEKIT_ADMIN_KEY ?? 'sk-admin'
+      'sk-admin': { id: 'admin', roles: ['admin'] },
+    },
+  },
+  adapters: {
+    rest: { enabled: true, prefix: '/api' },
+    // MCP endpoint /mcp is enabled by default; configure on-behalf-of identities
+    // that agents may act as (RBAC decides each identity's tool surface).
+    mcp: {
+      identities: {
+        // on-behalf-of identity directory: ref -> subject.
+        // roles must match the permissions keys in your schema.json
+        // (the leads object declares admin, sales and sales_manager).
+        // alice: { id: 'u-alice', roles: ['sales'] },
+      },
+      guardrails: {
+        rateLimit: { windowMs: 60_000, max: 100 },
+        alerts: { channel: 'console' },
+      },
+    },
+  },
+} satisfies EngineConfig;
+`;
+}
+const MAIN_ENTRY = `import { createEngine } from '@weave-kit/engine';\nimport config from './weavekit.config.js';\n
+const engine = await createEngine(config);
+const port = Number(process.env.PORT ?? 3000);
+await engine.app.listen({ host: '0.0.0.0', port });
+engine.app.log.info(\`weavekit engine listening on http://localhost:\${port}\`);
+
+// graceful shutdown: flush audit buffer and release the pool on SIGTERM/SIGINT
+const shutdown = async () => {
+  // lifecycle.shutdown is emitted inside engine.close()
+  await engine.close();
+  process.exit(0);
+};
+process.on('SIGINT', () => void shutdown());
+process.on('SIGTERM', () => void shutdown());
+`;
+const GITIGNORE = `node_modules/\ndist/\n.env\n`;
+const ENV_EXAMPLE = `# Copy to .env and fill in your PostgreSQL connection.\nDATABASE_URL=postgres://postgres:postgres@localhost:5432/weavekit\n# HTTP port the engine listens on (default 3000)\n# PORT=3000\n`;
+function renderPackageJson(name) {
+    return JSON.stringify({
+        name,
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'weave dev',
+            migrate: 'weave migrate',
+            build: 'weave build',
+            test: 'weave test',
+        },
+        dependencies: { '@weave-kit/engine': `^${version}` },
+    }, null, 2);
+}
+function renderReadme(dir, type) {
+    const line = type === undefined ? 'WeaveKit project' : `${type}: ${TYPE_NARRATIVES[type] ?? 'WeaveKit project'}`;
+    const business = type === 'business'
+        ? `\n> **Backend preset.** \`business\` currently scaffolds the headless engine only (REST/MCP/RBAC/audit/script) — no UI. Files such as \`objects/<name>/show.client.js\` and \`pages/<name>/layout.json\` are experimental groundwork for a future product line and have **no in-project renderer yet**.\n`
+        : '';
+    return `# ${basename(dir)}\n\n${line}\n${business}\n- \`weave dev\` — run with hot reload\n- \`weave migrate\` — sync schema to PostgreSQL\n- \`weave build\` — production bundle\n- \`weave test\` — run tests\nObjects live in \`objects/<name>/schema.json\`.\n`;
+}
+async function isGitRepo(cwd) {
+    const result = await runGit(['rev-parse', '--is-inside-work-tree'], { cwd, allowFailure: true });
+    return result.stdout.trim() === 'true';
+}
+/** scaffold a WeaveKit project into `cwd`; shared by `create-weavekit-app` */
+export async function scaffoldProject(cwd, options = {}) {
+    const files = {
+        'weavekit.config.ts': renderConfig(options.type),
+        'main.ts': MAIN_ENTRY,
+        'package.json': renderPackageJson(basename(cwd)),
+        '.gitignore': GITIGNORE,
+        '.env.example': ENV_EXAMPLE,
+        'README.md': renderReadme(cwd, options.type),
+        [join('objects', 'leads', 'schema.json')]: `${JSON.stringify(LEADS_OBJECT, null, 2)}\n`,
+    };
+    const created = [];
+    const skipped = [];
+    for (const [rel, content] of Object.entries(files)) {
+        const full = join(cwd, rel);
+        await mkdir(dirname(full), { recursive: true });
+        try {
+            await writeFile(full, content, { flag: 'wx' });
+            created.push(rel);
+        }
+        catch (error) {
+            if (error.code === 'EEXIST') {
+                if (options.force) {
+                    await writeFile(full, content);
+                    created.push(`${rel} (overwritten)`);
+                }
+                else {
+                    skipped.push(rel);
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    let gitInit = false;
+    if ((options.git ?? true) && !(await isGitRepo(cwd))) {
+        await runGit(['init'], { cwd });
+        gitInit = true;
+    }
+    return { created, skipped, gitInit };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/cli/scaffold.js.map

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

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

@@ -0,0 +1,102 @@
+import type { CliPrinter } from '../render.js';
+/** `weave migrate` options */
+export interface MigrateOptions {
+    /** generate DDL without executing */
+    dryRun?: boolean;
+    printer: CliPrinter;
+}
+/** `weave dev` options */
+export interface DevOptions {
+    /** HTTP port (defaults to 3000) */
+    port: number;
+    printer: CliPrinter;
+}
+/** `weave build` options */
+export interface BuildOptions {
+    /** server entry file (defaults to main.ts) */
+    entry?: string;
+    printer: CliPrinter;
+}
+/** `weave test` options */
+export interface TestOptions {
+    /** extra arguments forwarded to `bun test` */
+    args: string[];
+    printer: CliPrinter;
+}
+/** `weave types` options */
+export interface TypeOptions {
+    /** output directory; defaults to `generated` under the project root */
+    outdir?: string;
+    printer: CliPrinter;
+}
+/** `weave object:create` options */
+export interface ObjectCreateOptions {
+    printer: CliPrinter;
+}
+/** `weave field:add` options */
+export interface FieldAddOptions {
+    /** snake_case field name */
+    name: string;
+    /** field type (one of FIELD_TYPES) */
+    type: string;
+    /** mark the field required */
+    required?: boolean;
+    /** add a UNIQUE constraint */
+    unique?: boolean;
+    /** default value (parsed per type) */
+    default?: string;
+    /** comma-separated options (enum) */
+    options?: string;
+    /** target object name (relation / multiRelation) */
+    target?: string;
+    printer: CliPrinter;
+}
+/** `weave module:add` / `weave module:remove` options */
+export interface ModuleOptions {
+    printer: CliPrinter;
+}
+/** `weave introspect` options */
+export interface IntrospectOptions {
+    /** output directory; defaults to `<schemaDir>/objects` */
+    out?: string;
+    /** comma-separated table names to include */
+    include?: string;
+    /** comma-separated table names to exclude */
+    exclude?: string;
+    /** overwrite existing `objects/<name>/schema.json` */
+    force?: boolean;
+    /** report only, do not write */
+    dryRun?: boolean;
+    /** auto-commit the generated metadata (default true; `--no-commit` disables) */
+    commit?: boolean;
+    printer: CliPrinter;
+}
+/** `weave mcp:config` options */
+export interface McpConfigOptions {
+    /** target host: claude-code | claude-desktop | cursor | vscode | stdio | curl (default: all) */
+    host?: string;
+    /** full MCP URL; defaults to `http://localhost:<port><mcp.endpoint>` */
+    url?: string;
+    /** engine port used to build the default URL (default 3000) */
+    port?: number;
+    /** API key; defaults to the first static key in `auth.source` */
+    key?: string;
+    /** on-behalf-of ref; defaults to the first key of `mcp.identities` */
+    identity?: string;
+    printer: CliPrinter;
+}
+/** `weave schema:map` options */
+export interface SchemaMapOptions {
+    /** restrict the report to one object (table) */
+    object?: string;
+    /** show only drifting columns and tables */
+    drift?: boolean;
+    printer: CliPrinter;
+}
+/** `weave schema:upgrade` options */
+export interface SchemaUpgradeOptions {
+    /** report what would change without writing files */
+    dryRun?: boolean;
+    printer: CliPrinter;
+}
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/types/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,0BAA0B;AAC1B,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,oCAAoC;AACpC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,qCAAqC;AACrC,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;CACrB"}

package/dist/cli/types/commands.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=commands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/cli/types/commands.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,4 @@
+export { WEAVE_COMMANDS, PROJECT_TYPES } from './values.js';
+export type { WeaveCommand, ProjectType } from './values.js';
+export type { MigrateOptions, DevOptions, BuildOptions, TestOptions, TypeOptions, ObjectCreateOptions, FieldAddOptions, ModuleOptions, IntrospectOptions, McpConfigOptions, SchemaMapOptions, SchemaUpgradeOptions } from './commands.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}