kozou 0.0.2 → 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+declare const configSchema: z.ZodObject<{
+    database: z.ZodObject<{
+        url: z.ZodString;
+        schemas: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        schemas: string[];
+    }, {
+        url: string;
+        schemas?: string[] | undefined;
+    }>;
+    server: z.ZodDefault<z.ZodObject<{
+        ui: z.ZodDefault<z.ZodObject<{
+            port: z.ZodDefault<z.ZodNumber>;
+            host: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            port: number;
+            host: string;
+        }, {
+            port?: number | undefined;
+            host?: string | undefined;
+        }>>;
+        mcp: z.ZodDefault<z.ZodObject<{
+            http: z.ZodDefault<z.ZodObject<{
+                port: z.ZodDefault<z.ZodNumber>;
+                host: z.ZodDefault<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                port: number;
+                host: string;
+            }, {
+                port?: number | undefined;
+                host?: string | undefined;
+            }>>;
+            stdio: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            http: {
+                port: number;
+                host: string;
+            };
+            stdio: boolean;
+        }, {
+            http?: {
+                port?: number | undefined;
+                host?: string | undefined;
+            } | undefined;
+            stdio?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        ui: {
+            port: number;
+            host: string;
+        };
+        mcp: {
+            http: {
+                port: number;
+                host: string;
+            };
+            stdio: boolean;
+        };
+    }, {
+        ui?: {
+            port?: number | undefined;
+            host?: string | undefined;
+        } | undefined;
+        mcp?: {
+            http?: {
+                port?: number | undefined;
+                host?: string | undefined;
+            } | undefined;
+            stdio?: boolean | undefined;
+        } | undefined;
+    }>>;
+    adapter: z.ZodDefault<z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"postgrest">>;
+        url: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "postgrest";
+        url: string;
+    }, {
+        type?: "postgrest" | undefined;
+        url?: string | undefined;
+    }>>;
+    uiHints: z.ZodDefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string | null;
+    }, {
+        path?: string | null | undefined;
+    }>>;
+    cache: z.ZodDefault<z.ZodObject<{
+        ttlMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        ttlMs: number;
+    }, {
+        ttlMs?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    database: {
+        url: string;
+        schemas: string[];
+    };
+    server: {
+        ui: {
+            port: number;
+            host: string;
+        };
+        mcp: {
+            http: {
+                port: number;
+                host: string;
+            };
+            stdio: boolean;
+        };
+    };
+    adapter: {
+        type: "postgrest";
+        url: string;
+    };
+    uiHints: {
+        path: string | null;
+    };
+    cache: {
+        ttlMs: number;
+    };
+}, {
+    database: {
+        url: string;
+        schemas?: string[] | undefined;
+    };
+    server?: {
+        ui?: {
+            port?: number | undefined;
+            host?: string | undefined;
+        } | undefined;
+        mcp?: {
+            http?: {
+                port?: number | undefined;
+                host?: string | undefined;
+            } | undefined;
+            stdio?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    adapter?: {
+        type?: "postgrest" | undefined;
+        url?: string | undefined;
+    } | undefined;
+    uiHints?: {
+        path?: string | null | undefined;
+    } | undefined;
+    cache?: {
+        ttlMs?: number | undefined;
+    } | undefined;
+}>;
+export type KozouConfig = z.infer<typeof configSchema>;
+export type KozouConfigIssue = {
+    path: string;
+    message: string;
+};
+export declare class KozouConfigError extends Error {
+    readonly issues: KozouConfigIssue[];
+    readonly filePath: string | null;
+    constructor(message: string, filePath: string | null, issues: KozouConfigIssue[]);
+}
+export type LoadConfigOptions = {
+    /** Path to kozou.config.yaml. Default: ./kozou.config.yaml relative to cwd. */
+    path?: string;
+    /** Environment variables for ${VAR} expansion. Default: process.env. */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * If true, do not read any file from disk; only honor explicit options and
+     * environment variables. Useful for unit tests.
+     */
+    skipFile?: boolean;
+};
+export declare function loadConfig(opts?: LoadConfigOptions): Promise<KozouConfig>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwDxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIvD,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE;CAMjF;AAMD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA6CF,wBAAsB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2CnF"}

package/dist/config.js

@@ -0,0 +1,154 @@
+// kozou.config.yaml loader.
+//
+// Reads the YAML config file, expands ${VAR} / ${VAR:-default} placeholders
+// against the process environment, fills in defaults, and validates the
+// result with zod. Every field has a default so kozou can run with only the
+// DATABASE_URL environment variable set, per the Kozou v0.1 design spec §9.2.
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { resolve, isAbsolute } from 'node:path';
+import { parse as parseYAML } from 'yaml';
+import { z } from 'zod';
+// ---- Schema ---------------------------------------------------------------
+const uiServerSchema = z
+    .object({
+    port: z.number().int().min(0).max(65_535).default(3333),
+    host: z.string().min(1).default('0.0.0.0'),
+})
+    .default({});
+const mcpHttpServerSchema = z
+    .object({
+    port: z.number().int().min(0).max(65_535).default(3334),
+    host: z.string().min(1).default('0.0.0.0'),
+})
+    .default({});
+const mcpServerSchema = z
+    .object({
+    http: mcpHttpServerSchema,
+    stdio: z.boolean().default(false),
+})
+    .default({});
+const serverSchema = z
+    .object({
+    ui: uiServerSchema,
+    mcp: mcpServerSchema,
+})
+    .default({});
+const adapterSchema = z
+    .object({
+    type: z.literal('postgrest').default('postgrest'),
+    url: z.string().min(1).default('http://postgrest:3000'),
+})
+    .default({});
+const uiHintsSchema = z
+    .object({
+    path: z.string().nullable().default(null),
+})
+    .default({});
+const cacheSchema = z
+    .object({
+    ttlMs: z.number().int().min(0).default(60_000),
+})
+    .default({});
+const databaseSchema = z.object({
+    url: z.string().min(1, 'database.url is required (set DATABASE_URL or kozou.config.yaml)'),
+    schemas: z.array(z.string().min(1)).default(['public']),
+});
+const configSchema = z.object({
+    database: databaseSchema,
+    server: serverSchema,
+    adapter: adapterSchema,
+    uiHints: uiHintsSchema,
+    cache: cacheSchema,
+});
+export class KozouConfigError extends Error {
+    issues;
+    filePath;
+    constructor(message, filePath, issues) {
+        super(message);
+        this.name = 'KozouConfigError';
+        this.filePath = filePath;
+        this.issues = issues;
+    }
+}
+// ---- Loader --------------------------------------------------------------
+const DEFAULT_CONFIG_PATH = 'kozou.config.yaml';
+const ENV_VAR_RE = /\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\}/g;
+function expandEnvVars(value, env) {
+    if (typeof value === 'string') {
+        return value.replace(ENV_VAR_RE, (_match, name, fallback) => {
+            const v = env[name];
+            if (v !== undefined)
+                return v;
+            if (fallback !== undefined)
+                return fallback;
+            return '';
+        });
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => expandEnvVars(v, env));
+    }
+    if (value !== null && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = expandEnvVars(v, env);
+        }
+        return out;
+    }
+    return value;
+}
+function injectDatabaseUrlFromEnv(raw, env) {
+    if (raw === null || typeof raw !== 'object')
+        return raw;
+    const obj = raw;
+    const envUrl = env.DATABASE_URL;
+    if (envUrl === undefined || envUrl === '')
+        return obj;
+    const existing = obj.database;
+    if (existing === undefined) {
+        return { ...obj, database: { url: envUrl } };
+    }
+    if (existing !== null && typeof existing === 'object') {
+        const db = existing;
+        if (db.url === undefined || db.url === '') {
+            return { ...obj, database: { ...db, url: envUrl } };
+        }
+    }
+    return obj;
+}
+export async function loadConfig(opts = {}) {
+    const env = opts.env ?? process.env;
+    const requestedPath = opts.path ?? DEFAULT_CONFIG_PATH;
+    const absPath = isAbsolute(requestedPath)
+        ? requestedPath
+        : resolve(process.cwd(), requestedPath);
+    let raw = {};
+    let fileLoaded = null;
+    if (!opts.skipFile && existsSync(absPath)) {
+        const content = await readFile(absPath, 'utf8');
+        try {
+            raw = parseYAML(content) ?? {};
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new KozouConfigError(`Failed to parse kozou config: ${message}`, absPath, [{ path: '<yaml>', message }]);
+        }
+        fileLoaded = absPath;
+    }
+    // Fall back to DATABASE_URL env if database.url is not set in the file.
+    const withDbDefault = injectDatabaseUrlFromEnv(raw, env);
+    const expanded = expandEnvVars(withDbDefault, env);
+    try {
+        return configSchema.parse(expanded);
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            throw new KozouConfigError(`Invalid kozou config: ${err.issues.length} issue(s)`, fileLoaded, err.issues.map((i) => ({
+                path: i.path.join('.') || '<root>',
+                message: i.message,
+            })));
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/create-kozou.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=create-kozou.d.ts.map

package/dist/create-kozou.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kozou.d.ts","sourceRoot":"","sources":["../src/create-kozou.ts"],"names":[],"mappings":""}

package/dist/create-kozou.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// `create-kozou` bin entry. Thin wrapper around createKozouScaffold().
+import { createKozouScaffold, KozouScaffoldError } from './scaffold.js';
+async function main() {
+    const target = process.argv[2];
+    if (!target || target === '--help' || target === '-h') {
+        process.stderr.write('Usage: create-kozou <directory>\n');
+        process.exit(target ? 0 : 1);
+    }
+    try {
+        await createKozouScaffold({ target });
+    }
+    catch (err) {
+        if (err instanceof KozouScaffoldError) {
+            process.stderr.write(`${err.message}\n`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    process.stderr.write(`Scaffolded ${target}/\n`);
+    process.stderr.write(`Next: cd ${target} && cp .env.example .env && docker compose up\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`create-kozou: fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=create-kozou.js.map

package/dist/create-kozou.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kozou.js","sourceRoot":"","sources":["../src/create-kozou.ts"],"names":[],"mappings":";AACA,uEAAuE;AAEvE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,MAAM,iDAAiD,CACpE,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export declare const PACKAGE_VERSION = "0.1.0";
+export { loadConfig, KozouConfigError } from './config.js';
+export type { KozouConfig, KozouConfigIssue, LoadConfigOptions } from './config.js';
+export { inspectCommand } from './commands/inspect.js';
+export type { InspectOptions } from './commands/inspect.js';
+export { mcpCommand } from './commands/mcp.js';
+export type { McpOptions } from './commands/mcp.js';
+export { devCommand } from './commands/dev.js';
+export type { DevOptions } from './commands/dev.js';
+export { createKozouScaffold, KozouScaffoldError } from './scaffold.js';
+export type { CreateScaffoldOptions } from './scaffold.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// kozou (CLI package): public API surface for adopters embedding the
+// commands programmatically. The bin entry points live in cli.ts and
+// create-kozou.ts; this module re-exports the underlying primitives so
+// integrators can build their own glue if they need to.
+export const PACKAGE_VERSION = '0.1.0';
+export { loadConfig, KozouConfigError } from './config.js';
+export { inspectCommand } from './commands/inspect.js';
+export { mcpCommand } from './commands/mcp.js';
+export { devCommand } from './commands/dev.js';
+export { createKozouScaffold, KozouScaffoldError } from './scaffold.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qEAAqE;AACrE,uEAAuE;AACvE,wDAAwD;AAExD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,11 @@
+export type CreateScaffoldOptions = {
+    /** Target directory. Must not already exist. */
+    target: string;
+    /** Override the templates directory (used by unit tests). */
+    templatesDir?: string;
+};
+export declare class KozouScaffoldError extends Error {
+    constructor(message: string);
+}
+export declare function createKozouScaffold(opts: CreateScaffoldOptions): Promise<void>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,qBAAqB,GAAG;IAClC,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAyBD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpF"}

package/dist/scaffold.js

@@ -0,0 +1,54 @@
+// `create-kozou` scaffolding logic.
+//
+// Copies the contents of packages/kozou/src/templates/ into the target
+// directory the user picks. Renames env.example to .env.example along
+// the way so the scaffolded project ships a real dotfile (the template
+// stays a normal file because npm's tarball handling for dotfiles
+// inside published packages can be surprising).
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const DEFAULT_TEMPLATE_DIR = fileURLToPath(new URL('./templates', import.meta.url));
+export class KozouScaffoldError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'KozouScaffoldError';
+    }
+}
+async function copyRecursive(src, dest) {
+    const entries = await readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const sourcePath = join(src, entry.name);
+        let targetName = entry.name;
+        // env.example -> .env.example so the scaffolded project has a real
+        // dotfile but the template itself stays out of dotfile-tooling
+        // edge cases when published to npm.
+        if (entry.isFile() && entry.name === 'env.example') {
+            targetName = '.env.example';
+        }
+        const destPath = join(dest, targetName);
+        if (entry.isDirectory()) {
+            await mkdir(destPath, { recursive: true });
+            await copyRecursive(sourcePath, destPath);
+        }
+        else if (entry.isFile()) {
+            const content = await readFile(sourcePath, 'utf8');
+            await writeFile(destPath, content, 'utf8');
+        }
+        // Symlinks and other entry kinds are skipped intentionally.
+    }
+}
+export async function createKozouScaffold(opts) {
+    const target = (opts.target ?? '').trim();
+    if (target === '') {
+        throw new KozouScaffoldError('create-kozou: target directory is required');
+    }
+    if (existsSync(target)) {
+        throw new KozouScaffoldError(`create-kozou: "${target}" already exists`);
+    }
+    const templatesDir = opts.templatesDir ?? DEFAULT_TEMPLATE_DIR;
+    await mkdir(target, { recursive: true });
+    await copyRecursive(templatesDir, target);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,uEAAuE;AACvE,kEAAkE;AAClE,gDAAgD;AAEhD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,oBAAoB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AASpF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY;IACpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;QAC5B,mEAAmE;QACnE,+DAA+D;QAC/D,oCAAoC;QACpC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACnD,UAAU,GAAG,cAAc,CAAC;QAC9B,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,MAAM,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,4DAA4D;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA2B;IACnE,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,kBAAkB,CAAC,4CAA4C,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,kBAAkB,CAAC,kBAAkB,MAAM,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,oBAAoB,CAAC;IAC/D,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/templates/docker-compose.yml

@@ -0,0 +1,63 @@
+# Docker Compose stack for a kozou project.
+#
+# Brings up (v0.1.0):
+#   - postgres   PostgreSQL 16 (the source of truth)
+#   - postgrest  REST adapter consumed by the Kozou DataAdapter
+#                (MIT-licensed external dependency, not bundled)
+#
+# The `kozou` service block is commented out for v0.1.0: the
+# published `ghcr.io/kozou-dev/kozou:v0.1.0` image's entrypoint is
+# the `kozou` CLI, which does not bind a port. Host integration
+# (`kozou dev` spawning the bundled Admin UI + MCP HTTP server)
+# lands in v0.1.1; uncomment the block then.
+#
+# Customize the credentials in .env before running `docker compose up`.
+
+services:
+  postgres:
+    image: postgres:16
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-kozou}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-kozou}
+      POSTGRES_DB: ${POSTGRES_DB:-kozou}
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"
+    volumes:
+      - ./migrations:/docker-entrypoint-initdb.d:ro
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-kozou}"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  postgrest:
+    image: postgrest/postgrest:latest
+    environment:
+      PGRST_DB_URI: postgres://${POSTGRES_USER:-kozou}:${POSTGRES_PASSWORD:-kozou}@postgres:5432/${POSTGRES_DB:-kozou}
+      PGRST_DB_SCHEMA: public
+      PGRST_DB_ANON_ROLE: ${POSTGRES_USER:-kozou}
+    ports:
+      - "3000:3000"
+    depends_on:
+      postgres:
+        condition: service_healthy
+
+  # kozou:
+  #   # v0.1.1: reactivate once `kozou dev` spawns the bundled
+  #   # @kozou/svelte-ui Admin UI + MCP HTTP server. v0.1.0 only
+  #   # ships the CLI entrypoint, which exits immediately when
+  #   # run without arguments and therefore would bring no port
+  #   # online.
+  #   image: ghcr.io/kozou-dev/kozou:v0.1.0
+  #   command: ["dev"]
+  #   environment:
+  #     DATABASE_URL: postgres://${POSTGRES_USER:-kozou}:${POSTGRES_PASSWORD:-kozou}@postgres:5432/${POSTGRES_DB:-kozou}
+  #     KOZOU_ADAPTER_URL: http://postgrest:3000
+  #   depends_on:
+  #     postgres:
+  #       condition: service_healthy
+  #     postgrest:
+  #       condition: service_started
+  #   ports:
+  #     - "3333:3333"   # Admin UI
+  #     - "3334:3334"   # MCP HTTP

package/dist/templates/env.example

@@ -0,0 +1,11 @@
+# Copy this file to .env and fill in the real values before running
+# `docker compose up`.
+
+POSTGRES_USER=kozou
+POSTGRES_PASSWORD=change-me
+POSTGRES_DB=kozou
+POSTGRES_PORT=5432
+
+# Used by kozou + postgrest at runtime; defaults match the compose stack.
+DATABASE_URL=postgres://kozou:change-me@postgres:5432/kozou
+KOZOU_ADAPTER_URL=http://postgrest:3000

package/dist/templates/kozou.config.yaml

@@ -0,0 +1,29 @@
+# kozou.config.yaml
+#
+# Every field has a sensible default; only set what you need to override.
+# All ${VAR} and ${VAR:-fallback} placeholders are expanded against the
+# process environment at startup.
+
+database:
+  url: ${DATABASE_URL}
+  schemas: [public]
+
+server:
+  ui:
+    port: 3333
+    host: 0.0.0.0
+  mcp:
+    http:
+      port: 3334
+      host: 0.0.0.0
+    stdio: false
+
+adapter:
+  type: postgrest
+  url: ${KOZOU_ADAPTER_URL:-http://postgrest:3000}
+
+uiHints:
+  path: ./ui-hints.yaml
+
+cache:
+  ttlMs: 60000

package/dist/templates/migrations/0001_init.sql

@@ -0,0 +1,25 @@
+-- 0001_init.sql
+--
+-- Add your CREATE TABLE / CREATE VIEW / COMMENT ON statements here.
+-- kozou reads from this database at runtime; the COMMENT ON text is what
+-- shapes the Admin UI and the MCP context handed to AI agents.
+--
+-- See https://kozou.org for documentation on the COMMENT conventions
+-- (@ai / @widget / @policy / @example tags), VIEW-as-domain-concept,
+-- and the recommended layout for migrations.
+
+-- Example (delete and replace with your own schema):
+--
+-- CREATE TABLE users (
+--   id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+--   email text NOT NULL UNIQUE,
+--   full_name text,
+--   created_at timestamptz NOT NULL DEFAULT now(),
+--   deleted_at timestamptz
+-- );
+--
+-- COMMENT ON TABLE users IS
+--   'Application users.
+--    @ai: rows with deleted_at IS NOT NULL must be excluded from queries.';
+--
+-- COMMENT ON COLUMN users.email IS 'Login email (unique).';

package/dist/templates/ui-hints.yaml

@@ -0,0 +1,26 @@
+# ui-hints.yaml (optional)
+#
+# COMMENT ON and CREATE VIEW already give kozou enough information to
+# render a usable Admin UI out of the box. Use this file only to fine-tune
+# presentation: override a table label, force a specific widget for a
+# column, or surface relation search fields.
+#
+# See Kozou v0.1 design spec §4.3 for the full schema.
+
+tables: {}
+
+# Example overrides (uncomment and adapt):
+#
+# tables:
+#   users:
+#     label: People
+#     displayField: full_name
+#     columns:
+#       bio:
+#         widget: textarea
+#       avatar_url:
+#         widget: image-url
+#
+# views:
+#   vw_active_users:
+#     label: Active users