@kindgi/cli 0.1.2 → 0.1.4-rc.0

package/dist/dev/providers.js

@@ -0,0 +1,456 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * The model providers a pack declares in its config, kept in step by
+ * `kindgi dev`: `providers` in `kindgi.config.ts`, or
+ * `[[tool.kindgi.providers]]` in `pyproject.toml`.
+ *
+ * Each project (and each git worktree) has its own dev database, so a
+ * provider registered by hand has to be registered again per worktree,
+ * after every `--reset`, and on every teammate's machine. Declared here,
+ * `kindgi dev` registers them on boot.
+ *
+ * A declaration is a preset with the choices `providers register
+ * --preset` takes, or a full registration body (`spec`), as `--spec`
+ * takes it. A credential is always a secret's name, resolved in `local`
+ * (the pack's env files); a `spec` that carries one in `adapter_config`
+ * is refused.
+ *
+ * The reconcile reads the runtime's providers first, so a fresh or reset
+ * database is handled. A provider is this pack's only while it is as
+ * this pack registered it: `.kindgi/dev/providers.json` records, per dev
+ * database and tenant, a hash of what was declared and of what the
+ * runtime listed after registering it. Anything else in the runtime —
+ * registered by hand, by another pack of the project, or changed since —
+ * is never touched.
+ */
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { LOCAL_ENV_NAME } from '@kindgi/secrets-dotenv';
+import { stableStringify } from '../build/envelope.js';
+import { presetRegistration } from '../providers/preset-loader.js';
+const PRESET_KEYS = new Set([
+    'preset',
+    'models',
+    'project',
+    'secret',
+    'maxOutputTokens',
+]);
+/**
+ * `adapter_config` keys that hold a credential, compared lowercase with
+ * `-`/`_` dropped. A credential goes in `secret_ref`, by name.
+ */
+const CREDENTIAL_KEYS = new Set([
+    'apikey',
+    'key',
+    'token',
+    'accesstoken',
+    'bearertoken',
+    'authtoken',
+    'secret',
+    'clientsecret',
+    'password',
+    'authorization',
+    'credentials',
+    'privatekey',
+    'serviceaccountkey',
+]);
+/**
+ * The config's `providers`, as registration bodies. `file` names the
+ * config in the messages (`kindgi.config.ts`, `pyproject.toml`).
+ */
+export function declaredProviders(config, file, presets) {
+    const raw = config?.providers;
+    if (raw === undefined)
+        return { kind: 'ok', providers: [] };
+    const invalid = (message) => ({
+        kind: 'invalid',
+        message: `\`providers\` in ${file}: ${message}`,
+    });
+    if (!Array.isArray(raw)) {
+        return invalid('must be a list, each a `{ preset: … }` or a `{ spec: … }`.');
+    }
+    const out = [];
+    for (const [i, entry] of raw.entries()) {
+        const at = `entry ${i + 1}`;
+        if (!isRecord(entry))
+            return invalid(`${at} must be a \`{ preset: … }\` or a \`{ spec: … }\`.`);
+        if ('preset' in entry === 'spec' in entry) {
+            return invalid(`${at} must have one of \`preset\` or \`spec\`.`);
+        }
+        const built = 'preset' in entry ? fromPreset(entry, presets) : fromSpec(entry.spec);
+        if (built.kind === 'invalid')
+            return invalid(`${at}: ${built.message}`);
+        if (out.some((p) => p.id === built.provider.id)) {
+            return invalid(`${at}: provider "${built.provider.id}" is declared twice.`);
+        }
+        out.push(built.provider);
+    }
+    return { kind: 'ok', providers: out };
+}
+function fromPreset(entry, presets) {
+    const invalid = (message) => ({ kind: 'invalid', message });
+    const problem = presetEntryProblem(entry);
+    if (problem !== undefined)
+        return invalid(problem);
+    const { preset: name, models, project, secret, maxOutputTokens } = entry;
+    const preset = presets[name];
+    if (preset === undefined) {
+        return invalid(`no provider preset "${name}"; there are ${Object.keys(presets).join(', ')}.`);
+    }
+    const built = presetRegistration(preset, {
+        ...(models !== undefined && { models: models }),
+        ...(secret !== undefined && { secret: secret }),
+        envName: LOCAL_ENV_NAME,
+        settings: { project: project },
+        ...(maxOutputTokens !== undefined && { maxOutputTokens: maxOutputTokens }),
+    });
+    if (built.kind === 'err') {
+        // The preset's messages name the CLI flags (`--project=<…>`); the config names keys.
+        return invalid(built.message.replace(/--([a-z]+)=<…>/g, '`$1`'));
+    }
+    return { kind: 'ok', provider: { id: built.input.metadata.id, input: built.input } };
+}
+/** What's wrong with a preset entry's keys and values, before the preset is looked up. */
+function presetEntryProblem(entry) {
+    const unknown = Object.keys(entry).filter((k) => !PRESET_KEYS.has(k));
+    if (unknown.length > 0) {
+        return `a preset takes ${[...PRESET_KEYS].map((k) => `\`${k}\``).join(', ')}; not ${unknown.map((k) => `\`${k}\``).join(', ')}.`;
+    }
+    const { preset: name, models, project, secret, maxOutputTokens } = entry;
+    if (typeof name !== 'string' || name === '')
+        return '`preset` must be a preset name.';
+    if (models !== undefined &&
+        (!Array.isArray(models) ||
+            models.length === 0 ||
+            !models.every((m) => typeof m === 'string' && m !== ''))) {
+        return '`models` must be a non-empty list of model names.';
+    }
+    for (const [key, value] of [
+        ['project', project],
+        ['secret', secret],
+    ]) {
+        if (value !== undefined && (typeof value !== 'string' || value === '')) {
+            return `\`${key}\` must be a non-empty string.`;
+        }
+    }
+    if (maxOutputTokens !== undefined &&
+        (typeof maxOutputTokens !== 'number' ||
+            !Number.isInteger(maxOutputTokens) ||
+            maxOutputTokens < 1)) {
+        return '`maxOutputTokens` must be a whole number of at least 1.';
+    }
+    return undefined;
+}
+function fromSpec(spec) {
+    const invalid = (message) => ({ kind: 'invalid', message });
+    if (!isRecord(spec)) {
+        return invalid('`spec` must be a registration body, as `providers register --spec` takes it.');
+    }
+    const metadata = spec.metadata;
+    if (!isRecord(metadata) || typeof metadata.id !== 'string' || metadata.id === '') {
+        return invalid('`spec.metadata.id` must name the provider.');
+    }
+    if (typeof spec.adapter_id !== 'string' || spec.adapter_id === '') {
+        return invalid('`spec.adapter_id` must name the adapter.');
+    }
+    const config = spec.adapter_config;
+    if (config !== undefined) {
+        if (!isRecord(config))
+            return invalid('`spec.adapter_config` must be an object.');
+        // Keys may be dotted (`extraBody.x`, one per request field): any part counts.
+        const credentials = Object.keys(config).filter((k) => k.split('.').some((part) => CREDENTIAL_KEYS.has(part.toLowerCase().replace(/[-_]/g, ''))));
+        if (credentials.length > 0) {
+            return invalid(`\`spec.adapter_config.${credentials[0]}\` looks like a credential. Credentials go in \`secret_ref\`, by name ({ name: "MY_API_KEY" }), with the value in the env files.`);
+        }
+    }
+    const ref = spec.secret_ref;
+    if (ref !== undefined && (!isRecord(ref) || typeof ref.name !== 'string' || ref.name === '')) {
+        return invalid('`spec.secret_ref` must be `{ name: "<SECRET_NAME>" }`.');
+    }
+    // Under `kindgi dev`, secrets resolve in `local`: the pack's env files.
+    const input = (ref === undefined
+        ? spec
+        : {
+            ...spec,
+            secret_ref: { envName: LOCAL_ENV_NAME, ...ref },
+        });
+    return { kind: 'ok', provider: { id: metadata.id, input } };
+}
+/** Where `kindgi dev` records which providers this pack registered. */
+export function devProvidersRecordPath(packDir) {
+    return join(packDir, '.kindgi', 'dev', 'providers.json');
+}
+/**
+ * The record's key: the runtime (`DevProvidersTarget`; never credentials)
+ * and the tenant. Another runtime, or a new tenant, starts with nothing
+ * owned.
+ */
+export function devProvidersKey(target, tenantId) {
+    if (target.kind === 'runtime')
+        return `runtime ${originOf(target.url)} tenant ${tenantId}`;
+    if (target.kind === 'bundled')
+        return `bundled ${target.database} tenant ${tenantId}`;
+    return `${databaseOf(target.url)} tenant ${tenantId}`;
+}
+function originOf(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return url;
+    }
+}
+function databaseOf(databaseUrl) {
+    if (databaseUrl === undefined)
+        return 'unknown';
+    try {
+        const url = new URL(databaseUrl);
+        return `${url.hostname}:${url.port === '' ? '5432' : url.port}${url.pathname}`;
+    }
+    catch {
+        return createHash('sha256').update(databaseUrl).digest('hex').slice(0, 16);
+    }
+}
+/**
+ * Up to 0.1.3 the bundled Postgres's entries were keyed on its host and
+ * port (`127.0.0.1:<port>/<database> tenant <id>`, a loopback host), and the port changes
+ * when the container comes back. Moves such entries for this database and
+ * tenant to the `bundled` key, once: else the providers this pack
+ * registered would read as someone else's. A one-time migration of a
+ * local file: remove it after 0.1.5.
+ */
+export async function adoptLegacyBundledEntries(path, database, tenantId) {
+    const file = await readRecordFile(path);
+    if (file === undefined)
+        return;
+    const key = devProvidersKey({ kind: 'bundled', database }, tenantId);
+    if (file.runtimes[key] !== undefined)
+        return;
+    const legacy = Object.keys(file.runtimes).filter((k) => isLegacyBundledKey(k, database, tenantId));
+    if (legacy.length === 0)
+        return;
+    const runtimes = { ...file.runtimes };
+    const adopted = {};
+    for (const k of legacy) {
+        Object.assign(adopted, runtimes[k]);
+        delete runtimes[k];
+    }
+    runtimes[key] = adopted;
+    await writeRecordFile(path, { v: 1, runtimes });
+}
+function isLegacyBundledKey(key, database, tenantId) {
+    const suffix = `/${database} tenant ${tenantId}`;
+    if (!key.endsWith(suffix))
+        return false;
+    // The bundled Postgres is on this machine; a database elsewhere was named.
+    return /^(127\.0\.0\.1|localhost|\[::1\]):\d+$/.test(key.slice(0, -suffix.length));
+}
+/** This pack's providers in that runtime and tenant; nothing when the record is missing or unreadable. */
+export async function readOwnedProviders(path, key) {
+    const file = await readRecordFile(path);
+    return file?.runtimes[key] ?? {};
+}
+export async function writeOwnedProviders(path, key, owned) {
+    const file = await readRecordFile(path);
+    const runtimes = { ...(file?.runtimes ?? {}) };
+    if (Object.keys(owned).length === 0)
+        delete runtimes[key];
+    else
+        runtimes[key] = owned;
+    if (file === undefined && Object.keys(runtimes).length === 0)
+        return;
+    await writeRecordFile(path, { v: 1, runtimes });
+}
+async function writeRecordFile(path, next) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.${process.pid}.tmp`;
+    await writeFile(tmp, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
+    await rename(tmp, path);
+}
+async function readRecordFile(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (isRecord(parsed) && parsed.v === 1 && isRecord(parsed.runtimes)) {
+            return parsed;
+        }
+    }
+    catch {
+        // A record that can't be read owns nothing: providers are then left alone.
+    }
+    return undefined;
+}
+/** Bring the runtime's providers in step with the config's. Throws only when they can't be listed. */
+export async function reconcileProviders(inputs) {
+    const runtime = new Map((await inputs.client.list()).map((p) => [p.id, p]));
+    const owned = {};
+    const outcomes = [];
+    const toRecord = [];
+    for (const provider of inputs.declared) {
+        const step = await reconcileDeclared(provider, runtime.get(provider.id), inputs);
+        outcomes.push(step.outcome);
+        if (step.keep !== undefined)
+            owned[provider.id] = step.keep;
+        if (step.registered)
+            toRecord.push(provider);
+    }
+    // This pack's providers its config no longer declares.
+    for (const [id, before] of Object.entries(inputs.owned)) {
+        if (inputs.declared.some((p) => p.id === id))
+            continue;
+        const step = await removeUndeclared(id, before, runtime.get(id), inputs.client);
+        if (step.outcome !== undefined)
+            outcomes.push(step.outcome);
+        if (step.keep !== undefined)
+            owned[id] = step.keep;
+    }
+    Object.assign(owned, await recordRegistered(toRecord, inputs.client));
+    return { outcomes, owned };
+}
+/**
+ * A provider this pack registered and its config no longer declares:
+ * unregistered when it is as this pack registered it, else left.
+ */
+async function removeUndeclared(id, before, current, client) {
+    if (current === undefined)
+        return {};
+    if (hashOf(current) !== before.registered)
+        return { outcome: { id, kind: 'released' } };
+    try {
+        await client.unregister(id);
+        return { outcome: { id, kind: 'removed' } };
+    }
+    catch (err) {
+        return { outcome: { id, kind: 'failed', message: messageOf(err) }, keep: before };
+    }
+}
+/**
+ * The record entries for providers registered now, as the runtime lists
+ * them: that is what "still this pack's" is checked against. Not listed,
+ * they aren't recorded, and the next boot leaves them as they are.
+ */
+async function recordRegistered(registered, client) {
+    if (registered.length === 0)
+        return {};
+    const after = await client.list().then((all) => new Map(all.map((p) => [p.id, p])), () => new Map());
+    const owned = {};
+    for (const provider of registered) {
+        const listed = after.get(provider.id);
+        if (listed !== undefined) {
+            owned[provider.id] = { declared: hashOf(provider.input), registered: hashOf(listed) };
+        }
+    }
+    return owned;
+}
+/** One declared provider against the runtime's `current`. */
+async function reconcileDeclared(provider, current, inputs) {
+    const { id } = provider;
+    const before = inputs.owned[id];
+    // This pack's: registered by it, and as it registered it.
+    const mine = current !== undefined && before?.registered === hashOf(current) ? before : undefined;
+    if (current !== undefined && mine === undefined) {
+        return {
+            outcome: { id, kind: covers(provider.input.metadata, current) ? 'present' : 'conflict' },
+        };
+    }
+    const keep = mine !== undefined ? { keep: mine } : {};
+    if (mine !== undefined && mine.declared === hashOf(provider.input)) {
+        return { outcome: { id, kind: 'unchanged' }, ...keep };
+    }
+    const ref = provider.input.secret_ref;
+    if (ref !== undefined && ref.envName === LOCAL_ENV_NAME && !inputs.hasSecret(ref.name)) {
+        return { outcome: { id, kind: 'skipped', secret: ref.name }, ...keep };
+    }
+    // There's no update: a changed provider is unregistered, then registered.
+    try {
+        if (mine !== undefined)
+            await inputs.client.unregister(id);
+    }
+    catch (err) {
+        return { outcome: { id, kind: 'failed', message: messageOf(err) }, ...keep };
+    }
+    try {
+        await inputs.client.register(provider.input);
+        return {
+            outcome: { id, kind: mine !== undefined ? 'updated' : 'registered' },
+            registered: true,
+        };
+    }
+    catch (err) {
+        return { outcome: { id, kind: 'failed', message: messageOf(err) } };
+    }
+}
+/** The boot log's lines for a reconcile; none when the config declares nothing and nothing changed. */
+export function describeReconcile(outcomes, inputs) {
+    if (outcomes.length === 0)
+        return [];
+    const unchanged = outcomes.filter((o) => o.kind === 'unchanged').map((o) => o.id);
+    if (unchanged.length === outcomes.length) {
+        return [`✓ Providers from ${inputs.file}: ${unchanged.join(', ')} (unchanged)`];
+    }
+    const unregister = (id) => `${inputs.kindgi('providers', 'unregister', id)}, then restart kindgi dev`;
+    const lines = [`Providers from ${inputs.file}:`];
+    if (unchanged.length > 0)
+        lines.push(`  · ${unchanged.join(', ')}: unchanged`);
+    for (const o of outcomes) {
+        switch (o.kind) {
+            case 'unchanged':
+                break;
+            case 'registered':
+                lines.push(`  ✓ ${o.id}: registered`);
+                break;
+            case 'updated':
+                lines.push(`  ✓ ${o.id}: registered again (changed in ${inputs.file})`);
+                break;
+            case 'removed':
+                lines.push(`  ✓ ${o.id}: unregistered (no longer in ${inputs.file})`);
+                break;
+            case 'present':
+                lines.push(`  · ${o.id}: registered already, not from ${inputs.file}, with the same models (its adapter settings and key aren't listed to compare); left as it is. For the config's: ${unregister(o.id)}`);
+                break;
+            case 'conflict':
+                lines.push(`  ⚠ ${o.id}: registered already, not from ${inputs.file}, with another region or models; left as it is. For the config's: ${unregister(o.id)}`);
+                break;
+            case 'released':
+                lines.push(`  · ${o.id}: changed in the runtime since kindgi dev registered it; left as it is`);
+                break;
+            case 'skipped':
+                lines.push(`  ⚠ ${o.id}: not registered: ${o.secret} is not in ${inputs.envFiles}. Set it (${inputs.kindgi('secrets', 'set', o.secret, `--env=${LOCAL_ENV_NAME}`, '--scope=tenant')}), then restart kindgi dev`);
+                break;
+            case 'failed':
+                lines.push(`  ✗ ${o.id}: ${o.message}`);
+                break;
+        }
+    }
+    return lines;
+}
+function hashOf(value) {
+    return `sha256:${createHash('sha256').update(stableStringify(value)).digest('hex')}`;
+}
+/** Whether everything `expected` says, `actual` says too (the runtime may add defaults). */
+function covers(expected, actual) {
+    if (Array.isArray(expected)) {
+        return (Array.isArray(actual) &&
+            expected.length === actual.length &&
+            expected.every((item, i) => covers(item, actual[i])));
+    }
+    if (isRecord(expected)) {
+        return isRecord(actual) && Object.entries(expected).every(([k, v]) => covers(v, actual[k]));
+    }
+    return expected === actual;
+}
+function messageOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=providers.js.map

package/dist/dev/providers.js.map

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

package/dist/dev/python-builder.d.ts

@@ -7,9 +7,15 @@ export interface PythonPackBuilderOptions {
     /** The pack's environment. */
     readonly env: () => Promise<Readonly<Record<string, string>>>;
     readonly debounceMs?: number;
+    /** How often the sources are also scanned (`fs.watch` can miss events). */
+    readonly scanIntervalMs?: number;
     /** Test seam: `node:fs.watch`. */
     readonly watchFs?: typeof watch;
+    /** Test seam: what the sources are now (`pythonSourcesSignature`). */
+    readonly scanSources?: () => Promise<string>;
 }
+/** The sources a build reads, with their mtimes and sizes (`scan-backstop.ts`). */
+export declare function pythonSourcesSignature(packDir: string): Promise<string>;
 /** Whether a change to `relPath` (relative to the pack root) is a change to the pack's code. */
 export declare function isPythonSourceChange(relPath: string): boolean;
 export declare function createPythonPackBuilder(options: PythonPackBuilderOptions): PackBuilder;

package/dist/dev/python-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-builder.d.ts","sourceRoot":"","sources":["../../src/dev/python-builder.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAkB,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,cAAc,CAAC;AAgC3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAChD,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACjC;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CAmEtF"}
+{"version":3,"file":"python-builder.d.ts","sourceRoot":"","sources":["../../src/dev/python-builder.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,cAAc,CAAC;AAsC3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAChD,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOvE;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CAiFtF"}

package/dist/dev/python-builder.js

@@ -9,10 +9,12 @@
  * service and index in place, as a bundle error does.
  *
  * The watch covers any `.py` file under the pack root — shared modules
- * outside the discovery folders included — and `pyproject.toml`.
+ * outside the discovery folders included — and `pyproject.toml`, with a
+ * scan behind it (`scan-backstop.ts`): `fs.watch` can drop events.
  */
 import { spawn } from 'node:child_process';
 import { watch } from 'node:fs';
+import { DEFAULT_SCAN_INTERVAL_MS, scanSignature, startScanBackstop, } from './scan-backstop.js';
 const SKIPPED_DIRS = ['__pycache__', 'node_modules', 'venv', 'site-packages'];
 const DEFAULT_DEBOUNCE_MS = 150;
 /**
@@ -41,6 +43,15 @@ for dirpath, dirnames, filenames in os.walk(root):
             errors.append({"file": rel, "line": 0, "col": 0, "message": f"{type(e).__name__}: {e}"})
 print(json.dumps(errors))
 `;
+/** The sources a build reads, with their mtimes and sizes (`scan-backstop.ts`). */
+export function pythonSourcesSignature(packDir) {
+    return scanSignature({
+        folders: [{ abs: packDir, rel: '' }],
+        includes: isPythonSourceChange,
+        // Exactly the folders `isPythonSourceChange` never counts.
+        skipDir: (name) => name.startsWith('.') || SKIPPED_DIRS.includes(name),
+    });
+}
 /** Whether a change to `relPath` (relative to the pack root) is a change to the pack's code. */
 export function isPythonSourceChange(relPath) {
     const segments = relPath.split(/[\\/]/);
@@ -52,7 +63,9 @@ export function isPythonSourceChange(relPath) {
 }
 export function createPythonPackBuilder(options) {
     const watchFs = options.watchFs ?? watch;
+    const scan = options.scanSources ?? (() => pythonSourcesSignature(options.packDir));
     let watcher;
+    let backstop;
     let timer;
     async function build() {
         const [program, ...prefix] = options.python;
@@ -98,15 +111,25 @@ export function createPythonPackBuilder(options) {
         async watch(onBuild) {
             if (watcher !== undefined)
                 return;
-            watcher = watchFs(options.packDir, { recursive: true }, (_event, filename) => {
-                if (filename === null || !isPythonSourceChange(filename.toString()))
-                    return;
+            const schedule = () => {
                 if (timer !== undefined)
                     clearTimeout(timer);
                 timer = setTimeout(() => {
                     timer = undefined;
-                    void build().then(onBuild);
+                    // This build reads the sources as they are now: the scan then
+                    // fires only for later changes.
+                    void (backstop?.mark() ?? Promise.resolve()).then(build).then(onBuild);
                 }, options.debounceMs ?? DEFAULT_DEBOUNCE_MS);
+            };
+            watcher = watchFs(options.packDir, { recursive: true }, (_event, filename) => {
+                if (filename === null || !isPythonSourceChange(filename.toString()))
+                    return;
+                schedule();
+            });
+            backstop = await startScanBackstop({
+                scan,
+                intervalMs: options.scanIntervalMs ?? DEFAULT_SCAN_INTERVAL_MS,
+                onChange: schedule,
             });
         },
         // New or removed files need no entry list: the next build sees what is there.
@@ -114,6 +137,8 @@ export function createPythonPackBuilder(options) {
         async dispose() {
             if (timer !== undefined)
                 clearTimeout(timer);
+            backstop?.stop();
+            backstop = undefined;
             watcher?.close();
             watcher = undefined;
         },

package/dist/dev/python-builder.js.map

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

package/dist/dev/runners.d.ts

@@ -7,6 +7,8 @@
  * `runIndexer` (`@kindgi/handler-runtime`), and an `fs.watch` bridge.
  */
 import type { PackServiceSupervisor, PackServiceSupervisorEvent } from '@kindgi/handler-runtime/pack-service';
+import type { ProjectDatabases } from './project-database.js';
+import type { ProjectOutcome } from './project.js';
 import type { PackCode } from './pack-code.js';
 /** The running Kindgi runtime `kindgi dev` talks to. */
 export interface RunningApiServer {
@@ -37,6 +39,11 @@ export interface RunningApiServer {
 export interface StartApiServerOptions {
     /** The host port the API is reached on (`127.0.0.1` only). */
     readonly port: number;
+    /**
+     * `kindgi dev`'s stop (Ctrl+C, SIGTERM): a wait for the runtime ends at
+     * once with `RuntimeStartStopped`, and a container it started is removed.
+     */
+    readonly signal?: AbortSignal;
     /** Postgres, as this machine reaches it. */
     readonly databaseUrl: string;
     readonly tenantId: string;
@@ -217,6 +224,12 @@ export interface StartedServicesHandle {
     readonly startedWith: 'docker compose' | 'docker';
     /** What the developer should know about this start: a flag that needs compose. */
     readonly notes?: readonly string[];
+    /**
+     * The project databases in this Postgres (`project-database.ts`): each
+     * project gets one, and the runtime connects to it. Absent: the shared
+     * `databaseUrl` is used as is.
+     */
+    readonly projectDatabases?: ProjectDatabases;
 }
 /**
  * Outcome of `startServices`. `kind: 'ok'` = started (with docker
@@ -308,5 +321,14 @@ export interface DevRunners {
     readonly startServices?: (options: {
         readonly recreate: boolean;
     }) => Promise<StartServicesResult>;
+    /** Resolve the project (default: `resolveDevProject`, with git). Tests pass their own. */
+    readonly resolveProject?: (input: {
+        readonly packDir: string;
+        readonly configured: unknown;
+    }) => Promise<ProjectOutcome>;
+    /** Whether there's a person at a terminal to ask (default: stdin and stderr are TTYs). */
+    readonly interactive?: () => boolean;
+    /** Ask a yes/no question (default: on the terminal). */
+    readonly confirm?: (question: string) => Promise<boolean>;
 }
 //# sourceMappingURL=runners.d.ts.map