@kindgi/cli 0.1.2 → 0.1.3

package/dist/dev/project-database.d.ts

@@ -0,0 +1,68 @@
+import type { DevProject } from './project.js';
+/** The bundled Postgres's container (compose and plain-docker starts alike). */
+export declare const BUNDLED_POSTGRES_CONTAINER = "kindgi-dev_postgres";
+/** One SQL statement's tuples-only output, or why it failed. */
+export type SqlRunner = (sql: string) => Promise<{
+    readonly ok: true;
+    readonly out: string;
+} | {
+    readonly ok: false;
+    readonly error: string;
+}>;
+/** Who owns a project database, as its comment records it. */
+export interface DatabaseOwner {
+    readonly root: string;
+    readonly createdBy: string;
+}
+export type EnsureOutcome = {
+    readonly kind: 'created';
+} | {
+    readonly kind: 'exists';
+}
+/** The owner's folder moved (the recorded one is gone): the database is this folder's now. */
+ | {
+    readonly kind: 'adopted';
+    readonly previousRoot: string;
+} | {
+    readonly kind: 'refused';
+    readonly message: string;
+} | {
+    readonly kind: 'error';
+    readonly message: string;
+};
+export interface ProjectDatabases {
+    /** The URL the runtime connects with, for a database in the bundled Postgres. */
+    urlFor(database: string): string;
+    /** Make sure the project's database exists and belongs to this folder. */
+    ensure(project: DevProject, cliVersion: string): Promise<EnsureOutcome>;
+    /** Drop the project's database, disconnecting whoever is on it (`--reset`). */
+    drop(database: string): Promise<{
+        readonly ok: true;
+    } | {
+        readonly ok: false;
+        readonly error: string;
+    }>;
+    /** Whether a database is there (the old shared `kindgi` one, say). */
+    exists(database: string): Promise<boolean>;
+}
+/**
+ * The bundled Postgres's project databases. `run` executes one statement
+ * in the container's `kindgi` database; `baseUrl` is the shared
+ * database's URL (only the database name changes per project).
+ */
+export declare function createProjectDatabases(input: {
+    readonly run: SqlRunner;
+    readonly baseUrl: string;
+    /** Whether a folder exists (test seam). */
+    readonly folderExists?: (path: string) => boolean;
+}): ProjectDatabases;
+/**
+ * The real runner: `docker exec kindgi-dev_postgres psql -U kindgi -d kindgi
+ * -tA -v ON_ERROR_STOP=1 -c <sql>`, through the CLI's docker helper.
+ */
+export declare function bundledSqlRunner(docker: (args: readonly string[]) => Promise<{
+    readonly code: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+}>): SqlRunner;
+//# sourceMappingURL=project-database.d.ts.map

package/dist/dev/project-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-database.d.ts","sourceRoot":"","sources":["../../src/dev/project-database.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,KACR,OAAO,CACV;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAC7F,CAAC;AAEF,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE;AAC7B,8FAA8F;GAC5F;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,0EAA0E;IAC1E,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACxE,+EAA+E;IAC/E,IAAI,CACF,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,sEAAsE;IACtE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACnD,GAAG,gBAAgB,CA6FnB;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,CACN,IAAI,EAAE,SAAS,MAAM,EAAE,KACpB,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/F,SAAS,CAoBX"}

package/dist/dev/project-database.js

@@ -0,0 +1,142 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * A project's database in the bundled Postgres (`kindgi-dev_postgres`):
+ * created when missing, and owned by one folder. The owner is recorded in
+ * the database's comment (`{"kindgi":{"root":…,"createdBy":…}}`), so two
+ * unrelated folders that resolve to the same project name don't share a
+ * database and a tenant without knowing it. Statements go through
+ * `docker exec … psql` in the container: the CLI carries no Postgres
+ * client, and only manages the bundled Postgres (never a database a
+ * `--database-url` names).
+ */
+import { existsSync } from 'node:fs';
+/** The bundled Postgres's container (compose and plain-docker starts alike). */
+export const BUNDLED_POSTGRES_CONTAINER = 'kindgi-dev_postgres';
+/**
+ * The bundled Postgres's project databases. `run` executes one statement
+ * in the container's `kindgi` database; `baseUrl` is the shared
+ * database's URL (only the database name changes per project).
+ */
+export function createProjectDatabases(input) {
+    const { run } = input;
+    const folderExists = input.folderExists ?? existsSync;
+    const exists = async (database) => {
+        const found = await run(`SELECT 1 FROM pg_database WHERE datname = ${literal(database)}`);
+        return found.ok && found.out.trim() === '1';
+    };
+    const owner = async (database) => {
+        const read = await run(`SELECT shobj_description(oid, 'pg_database') FROM pg_database WHERE datname = ${literal(database)}`);
+        if (!read.ok)
+            return undefined;
+        try {
+            const parsed = JSON.parse(read.out.trim());
+            const root = parsed.kindgi?.root;
+            return typeof root === 'string'
+                ? { root, createdBy: String(parsed.kindgi?.createdBy ?? 'unknown') }
+                : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const setOwner = (database, value) => run(`COMMENT ON DATABASE ${identifier(database)} IS ${literal(JSON.stringify({ kindgi: value }))}`);
+    return {
+        urlFor(database) {
+            const url = new URL(input.baseUrl);
+            url.pathname = `/${database}`;
+            return url.toString();
+        },
+        exists,
+        async ensure(project, cliVersion) {
+            const recorded = { root: project.root, createdBy: cliVersion };
+            if (!(await exists(project.database))) {
+                const created = await run(`CREATE DATABASE ${identifier(project.database)}`);
+                // Two packs of one project starting at once: the other one made it.
+                if (!created.ok && !/already exists/.test(created.error)) {
+                    return {
+                        kind: 'error',
+                        message: `could not create ${project.database}: ${created.error}`,
+                    };
+                }
+                if (created.ok) {
+                    const commented = await setOwner(project.database, recorded);
+                    if (!commented.ok) {
+                        return {
+                            kind: 'error',
+                            message: `could not record ${project.database}'s folder: ${commented.error}`,
+                        };
+                    }
+                    return { kind: 'created' };
+                }
+            }
+            const current = await owner(project.database);
+            if (current === undefined) {
+                // A database without Kindgi's record (made by hand): this folder's now.
+                const commented = await setOwner(project.database, recorded);
+                return commented.ok
+                    ? { kind: 'exists' }
+                    : {
+                        kind: 'error',
+                        message: `could not record ${project.database}'s folder: ${commented.error}`,
+                    };
+            }
+            if (current.root === project.root)
+                return { kind: 'exists' };
+            if (folderExists(current.root)) {
+                return {
+                    kind: 'refused',
+                    message: `the database ${project.database} belongs to ${current.root}, another folder whose project is also named "${project.name}". Give this one its own name: set \`project\` in kindgi.config.ts (or \`project\` under [tool.kindgi] in pyproject.toml), or pass --database-url.`,
+                };
+            }
+            const moved = await setOwner(project.database, {
+                root: project.root,
+                createdBy: current.createdBy,
+            });
+            return moved.ok
+                ? { kind: 'adopted', previousRoot: current.root }
+                : {
+                    kind: 'error',
+                    message: `could not record ${project.database}'s folder: ${moved.error}`,
+                };
+        },
+        async drop(database) {
+            const dropped = await run(`DROP DATABASE IF EXISTS ${identifier(database)} WITH (FORCE)`);
+            return dropped.ok ? { ok: true } : { ok: false, error: dropped.error };
+        },
+    };
+}
+/** A database name as a quoted identifier (names from `projectDatabaseName` are already plain). */
+function identifier(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+/** A SQL string literal. */
+function literal(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+/**
+ * The real runner: `docker exec kindgi-dev_postgres psql -U kindgi -d kindgi
+ * -tA -v ON_ERROR_STOP=1 -c <sql>`, through the CLI's docker helper.
+ */
+export function bundledSqlRunner(docker) {
+    return async (sql) => {
+        const out = await docker([
+            'exec',
+            BUNDLED_POSTGRES_CONTAINER,
+            'psql',
+            '-U',
+            'kindgi',
+            '-d',
+            'kindgi',
+            '-tA',
+            '-v',
+            'ON_ERROR_STOP=1',
+            '-c',
+            sql,
+        ]);
+        return out.code === 0
+            ? { ok: true, out: out.stdout }
+            : { ok: false, error: out.stderr.trim() || `psql exited ${out.code ?? 'without a code'}` };
+    };
+}
+//# sourceMappingURL=project-database.js.map

package/dist/dev/project-database.js.map

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

package/dist/dev/project.d.ts

@@ -0,0 +1,59 @@
+/** Where the project's name came from. */
+export type ProjectNameSource = 'config' | 'repository' | 'workspace' | 'pack folder';
+export interface DevProject {
+    /** The project's name, as given or found. */
+    readonly name: string;
+    readonly nameFrom: ProjectNameSource;
+    /** This checkout's root: the worktree's, or the repository's, or the workspace's, or the pack's. */
+    readonly root: string;
+    /** In a linked git worktree: git's name for it. */
+    readonly worktree?: string;
+    /** The database in the bundled Postgres. */
+    readonly database: string;
+    /** The dev tenant every pack of this project (and worktree) shares. */
+    readonly tenantId: string;
+    /** The dev user the tenant's token resolves to. */
+    readonly userId: string;
+}
+/** What `git rev-parse` says about a folder: `undefined` outside a repository. */
+export interface GitLocation {
+    readonly toplevel: string;
+    readonly gitDir: string;
+    readonly commonDir: string;
+}
+export type GitLocator = (dir: string) => Promise<GitLocation | undefined>;
+export type ProjectOutcome = {
+    readonly kind: 'ok';
+    readonly project: DevProject;
+} | {
+    readonly kind: 'invalid';
+    readonly message: string;
+};
+/**
+ * Resolve the project for a pack at `packDir`. `configured` is the
+ * config's `project` value, as loaded (validated here).
+ */
+export declare function resolveDevProject(input: {
+    readonly packDir: string;
+    readonly configured: unknown;
+    readonly git?: GitLocator;
+}): Promise<ProjectOutcome>;
+/**
+ * The database's name: `kindgi_<project>`, plus `__<worktree>` in a linked
+ * worktree, in Postgres's plain-identifier characters. A name past 63
+ * bytes keeps its start and ends with a hash of the whole.
+ */
+export declare function projectDatabaseName(project: string, worktree?: string): string;
+/**
+ * The nearest folder at or above `dir` that roots a workspace: a
+ * `pnpm-workspace.yaml`, a `package.json` with `workspaces`, or a
+ * `pyproject.toml` with a uv workspace.
+ */
+export declare function findWorkspaceRoot(dir: string): string | undefined;
+/** `git rev-parse` for `dir`, with absolute paths; `undefined` outside a repository or without git. */
+export declare const locateGit: GitLocator;
+/** A name-based UUID (RFC 9562 version 5, SHA-1) in the dev namespace. */
+export declare function uuidV5(name: string): string;
+/** A name-based UUID (RFC 9562 version 5, SHA-1) in `namespace`. */
+export declare function uuidV5In(namespace: string, name: string): string;
+//# sourceMappingURL=project.d.ts.map

package/dist/dev/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/dev/project.ts"],"names":[],"mappings":"AA0BA,0CAA0C;AAC1C,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtF,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,oGAAoG;IACpG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;AAQ3E,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;CAC3B,GAAG,OAAO,CAAC,cAAc,CAAC,CA8C1B;AAOD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9E;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQjE;AAwBD,uGAAuG;AACvG,eAAO,MAAM,SAAS,EAAE,UAmBpB,CAAC;AAEL,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWhE"}

package/dist/dev/project.js

@@ -0,0 +1,182 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * The project `kindgi dev` runs in, and what it gets from it: one database
+ * in the bundled Postgres, and one dev tenant and user, for every pack of
+ * the project.
+ *
+ * - **The name:** `project` in the Kindgi config (`kindgi.config.ts`, or
+ *   `[tool.kindgi]` in `pyproject.toml`); else the git repository's name
+ *   (its main checkout's folder, the same in every worktree); else the
+ *   nearest workspace root's folder; else the pack's folder.
+ * - **A linked git worktree** gets a database of its own,
+ *   `kindgi_<project>__<worktree>`, named after git's own (unique) name for
+ *   the worktree: branches on different Kindgi versions usually live in
+ *   worktrees, and must not share a schema. The main checkout has
+ *   `kindgi_<project>`.
+ * - **The tenant and user** derive from the database's name, so every pack
+ *   of the project, and every restart, get the same ones.
+ */
+import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+/** Postgres's identifier limit, in bytes. */
+const MAX_IDENTIFIER = 63;
+/** The namespace of the dev tenants' and users' UUIDs (v5). Never change it. */
+const DEV_NAMESPACE = '7a1c5e2e-4b8f-5d6a-9c3e-1f0b2d4e6a8c';
+/**
+ * Resolve the project for a pack at `packDir`. `configured` is the
+ * config's `project` value, as loaded (validated here).
+ */
+export async function resolveDevProject(input) {
+    const packDir = resolve(input.packDir);
+    const configured = input.configured;
+    if (configured !== undefined && !isProjectName(configured)) {
+        return {
+            kind: 'invalid',
+            message: '`project` in the Kindgi config must be a name with at least one letter or digit, e.g. "acme-app".',
+        };
+    }
+    const git = await (input.git ?? locateGit)(packDir);
+    // A workspace root above the pack. The pack's own folder is no workspace
+    // of its own: `kindgi init` gives a pack its own pnpm-workspace.yaml.
+    const found = git === undefined ? findWorkspaceRoot(packDir) : undefined;
+    const workspace = found !== undefined && found !== packDir ? found : undefined;
+    const worktree = git !== undefined && linkedWorktree(git) ? basename(git.gitDir) : undefined;
+    let name;
+    let nameFrom;
+    if (configured !== undefined) {
+        name = configured;
+        nameFrom = 'config';
+    }
+    else if (git !== undefined) {
+        name = repositoryName(git);
+        nameFrom = 'repository';
+    }
+    else if (workspace !== undefined) {
+        name = basename(workspace);
+        nameFrom = 'workspace';
+    }
+    else {
+        name = basename(packDir);
+        nameFrom = 'pack folder';
+    }
+    const root = git?.toplevel ?? workspace ?? packDir;
+    const database = projectDatabaseName(name, worktree);
+    return {
+        kind: 'ok',
+        project: {
+            name,
+            nameFrom,
+            root,
+            ...(worktree !== undefined && { worktree }),
+            database,
+            tenantId: uuidV5(`tenant:${database}`),
+            userId: uuidV5(`user:${database}`),
+        },
+    };
+}
+/** A usable `project` value: a string with a letter or digit in it. */
+function isProjectName(value) {
+    return typeof value === 'string' && slug(value) !== '';
+}
+/**
+ * The database's name: `kindgi_<project>`, plus `__<worktree>` in a linked
+ * worktree, in Postgres's plain-identifier characters. A name past 63
+ * bytes keeps its start and ends with a hash of the whole.
+ */
+export function projectDatabaseName(project, worktree) {
+    const full = `kindgi_${slug(project) || 'project'}${worktree === undefined ? '' : `__${slug(worktree) || 'worktree'}`}`;
+    if (full.length <= MAX_IDENTIFIER)
+        return full;
+    const hash = createHash('sha256').update(full).digest('hex').slice(0, 8);
+    return `${full.slice(0, MAX_IDENTIFIER - hash.length - 1).replace(/_+$/, '')}_${hash}`;
+}
+/** Lowercase letters, digits and single underscores: each other run becomes one `_`. */
+function slug(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+}
+/** A linked worktree: its git dir isn't the repository's common one. */
+function linkedWorktree(git) {
+    return resolve(git.gitDir) !== resolve(git.commonDir);
+}
+/** The repository's name: its main checkout's folder (`<root>/.git`), or a bare repository's. */
+function repositoryName(git) {
+    const common = resolve(git.commonDir);
+    if (basename(common) === '.git')
+        return basename(dirname(common));
+    return basename(common).replace(/\.git$/, '') || basename(git.toplevel);
+}
+/**
+ * The nearest folder at or above `dir` that roots a workspace: a
+ * `pnpm-workspace.yaml`, a `package.json` with `workspaces`, or a
+ * `pyproject.toml` with a uv workspace.
+ */
+export function findWorkspaceRoot(dir) {
+    let current = resolve(dir);
+    for (;;) {
+        if (isWorkspaceRoot(current))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+function isWorkspaceRoot(dir) {
+    if (existsSync(join(dir, 'pnpm-workspace.yaml')))
+        return true;
+    const pkg = readIfExists(join(dir, 'package.json'));
+    if (pkg !== undefined) {
+        try {
+            if (JSON.parse(pkg).workspaces !== undefined)
+                return true;
+        }
+        catch {
+            // Not JSON: not a workspace root.
+        }
+    }
+    const pyproject = readIfExists(join(dir, 'pyproject.toml'));
+    return pyproject !== undefined && /^\s*\[tool\.uv\.workspace\]/m.test(pyproject);
+}
+function readIfExists(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** `git rev-parse` for `dir`, with absolute paths; `undefined` outside a repository or without git. */
+export const locateGit = (dir) => new Promise((resolvePromise) => {
+    execFile('git', ['rev-parse', '--path-format=absolute', '--show-toplevel', '--git-dir', '--git-common-dir'], { cwd: dir, timeout: 5000 }, (err, stdout) => {
+        if (err !== null) {
+            resolvePromise(undefined);
+            return;
+        }
+        const [toplevel, gitDir, commonDir] = stdout.trim().split('\n');
+        resolvePromise(toplevel !== undefined && gitDir !== undefined && commonDir !== undefined
+            ? { toplevel, gitDir, commonDir }
+            : undefined);
+    });
+});
+/** A name-based UUID (RFC 9562 version 5, SHA-1) in the dev namespace. */
+export function uuidV5(name) {
+    return uuidV5In(DEV_NAMESPACE, name);
+}
+/** A name-based UUID (RFC 9562 version 5, SHA-1) in `namespace`. */
+export function uuidV5In(namespace, name) {
+    const bytes = createHash('sha1')
+        .update(Buffer.concat([Buffer.from(namespace.replace(/-/g, ''), 'hex'), Buffer.from(name, 'utf8')]))
+        .digest()
+        .subarray(0, 16);
+    bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x50;
+    bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+//# sourceMappingURL=project.js.map

package/dist/dev/project.js.map

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

package/dist/dev/providers.d.ts

@@ -0,0 +1,96 @@
+import type { Provider, RegisterProviderInput } from '@kindgi/client';
+import { type ProviderPreset } from '../providers/preset-loader.js';
+/** A provider the config declares, as it will be registered. */
+export interface DeclaredProvider {
+    readonly id: string;
+    readonly input: RegisterProviderInput;
+}
+export type DeclaredProvidersOutcome = {
+    readonly kind: 'ok';
+    readonly providers: readonly DeclaredProvider[];
+} | {
+    readonly kind: 'invalid';
+    readonly message: string;
+};
+/**
+ * The config's `providers`, as registration bodies. `file` names the
+ * config in the messages (`kindgi.config.ts`, `pyproject.toml`).
+ */
+export declare function declaredProviders(config: Readonly<Record<string, unknown>> | undefined, file: string, presets: Readonly<Record<string, ProviderPreset>>): DeclaredProvidersOutcome;
+/** What this pack registered: hashes of the declared body and of the runtime's listing after. */
+export interface OwnedProvider {
+    readonly declared: string;
+    readonly registered: string;
+}
+export type OwnedProviders = Readonly<Record<string, OwnedProvider>>;
+/** Where `kindgi dev` records which providers this pack registered. */
+export declare function devProvidersRecordPath(packDir: string): string;
+/**
+ * The record's key: the dev database (host, port, name; never the
+ * credentials) and the tenant. Another database, or a new tenant, starts
+ * with nothing owned.
+ */
+export declare function devProvidersKey(databaseUrl: string | undefined, tenantId: string): string;
+/** This pack's providers in that database and tenant; nothing when the record is missing or unreadable. */
+export declare function readOwnedProviders(path: string, key: string): Promise<OwnedProviders>;
+export declare function writeOwnedProviders(path: string, key: string, owned: OwnedProviders): Promise<void>;
+export interface ProvidersClient {
+    /** Every provider of the tenant (all pages). */
+    readonly list: () => Promise<readonly Provider[]>;
+    readonly register: (input: RegisterProviderInput) => Promise<unknown>;
+    readonly unregister: (id: string) => Promise<unknown>;
+}
+export type ProviderOutcome = {
+    readonly id: string;
+    readonly kind: 'registered' | 'updated' | 'unchanged' | 'removed';
+}
+/** Registered already, as declared, but not by this pack: left. */
+ | {
+    readonly id: string;
+    readonly kind: 'present';
+}
+/** Registered already, differently, not by this pack: left. */
+ | {
+    readonly id: string;
+    readonly kind: 'conflict';
+}
+/** This pack's before, changed since in the runtime: left, and no longer this pack's. */
+ | {
+    readonly id: string;
+    readonly kind: 'released';
+}
+/** Its secret isn't in the env files: not registered. */
+ | {
+    readonly id: string;
+    readonly kind: 'skipped';
+    readonly secret: string;
+} | {
+    readonly id: string;
+    readonly kind: 'failed';
+    readonly message: string;
+};
+export interface ReconcileInputs {
+    readonly declared: readonly DeclaredProvider[];
+    readonly owned: OwnedProviders;
+    readonly client: ProvidersClient;
+    /** Whether a secret of `local` can be resolved (it's in the pack's env files). */
+    readonly hasSecret: (name: string) => boolean;
+}
+export interface ReconcileResult {
+    readonly outcomes: readonly ProviderOutcome[];
+    /** The record to keep. */
+    readonly owned: OwnedProviders;
+}
+/** Bring the runtime's providers in step with the config's. Throws only when they can't be listed. */
+export declare function reconcileProviders(inputs: ReconcileInputs): Promise<ReconcileResult>;
+export interface DescribeInputs {
+    /** The config's file name. */
+    readonly file: string;
+    /** A `kindgi` command line, in the pack's own runner. */
+    readonly kindgi: (...args: string[]) => string;
+    /** The env files `local` reads, for a missing secret's line. */
+    readonly envFiles: string;
+}
+/** The boot log's lines for a reconcile; none when the config declares nothing and nothing changed. */
+export declare function describeReconcile(outcomes: readonly ProviderOutcome[], inputs: DescribeInputs): readonly string[];
+//# sourceMappingURL=providers.d.ts.map

package/dist/dev/providers.d.ts.map

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