@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/dev/bundler.js

@@ -0,0 +1,235 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * `kindgi dev`'s bundler: every primitive file, with everything it
+ * imports, bundled into `.kindgi/dev/dist` by esbuild — so tsconfig
+ * `paths` (`@/…`), extensionless imports and the pack's own modules work
+ * as they do under the app's own build. What resolves into
+ * `node_modules` stays external (see `nodeModulesExternalPlugin`).
+ *
+ * In watch mode esbuild rebuilds when any file a bundle read changes —
+ * not only the discovery folders. A rebuild is reported when the files
+ * it read differ from those of the last build reported (so watch mode's
+ * own first build, right after `build()`, is not reported twice), and
+ * whenever it fails.
+ * Adding or removing a primitive file changes the entry points, so
+ * `syncEntries()` recreates the build. When the last primitive file is
+ * removed there is nothing for esbuild to build or watch, so the (empty)
+ * build is reported directly — the refresh then publishes an empty index.
+ *
+ * Each build says which packages the code loads from `node_modules`
+ * (`externals`), by the same rule as a pack image's bundles. An image
+ * bundles the pack's config too, so the config's own are added: it is
+ * bundled for them once, as `kindgi dev` reads the config once.
+ */
+import { stat } from 'node:fs/promises';
+import { relative, resolve, sep } from 'node:path';
+import { REQUIRE_BANNER, collectPackEntries, nodeModulesExternalPlugin, } from '../build/bundle.js';
+import { devDistDir } from './paths.js';
+export function createDevPackBuilder(options) {
+    const outDir = devDistDir(options.packDir);
+    let context;
+    let entries = [];
+    let entriesKey;
+    let listener;
+    /** What the last reported build read: each input's path, size and mtime. */
+    let reportedInputs;
+    /** The externals of the build running now (a new map per build, read once it ends). */
+    let importing = new Map();
+    let configImporting;
+    const configExternals = () => {
+        configImporting ??= configExternalsOf(options.packDir, options.configPath);
+        return configImporting;
+    };
+    const externalsOf = async (code) => listExternals([code, await configExternals()], options.packDir);
+    /** Each build starts with no externals; `nodeModulesExternalPlugin` records them. */
+    const collector = {
+        name: 'kindgi-dev-externals',
+        setup(build) {
+            build.onStart(() => {
+                importing = new Map();
+            });
+        },
+    };
+    /** Each build's outcome, for the listener while watching. */
+    const reporter = {
+        name: 'kindgi-dev-build-report',
+        setup(build) {
+            build.onEnd(async (result) => {
+                if (listener === undefined)
+                    return;
+                const code = importing;
+                const read = result.errors.length > 0 ? undefined : await inputsOf(result, options.packDir);
+                if (read !== undefined && read === reportedInputs)
+                    return;
+                reportedInputs = read;
+                const outcome = outcomeOf(result, entries, options.packDir, await externalsOf(code));
+                listener?.(outcome);
+            });
+        },
+    };
+    /** Recreate the esbuild context when the entry points changed. */
+    async function ensureContext() {
+        const found = await collectPackEntries(options.packDir, options.patterns);
+        const key = JSON.stringify(found.map((e) => e.sourceRel));
+        if (context !== undefined && key === entriesKey)
+            return false;
+        const esbuild = await import('esbuild');
+        await context?.dispose();
+        entries = found;
+        entriesKey = key;
+        context = await esbuild.context({
+            absWorkingDir: options.packDir,
+            entryPoints: found.map((e) => ({ in: e.abs, out: e.outRel })),
+            outdir: outDir,
+            outExtension: { '.js': '.mjs' },
+            bundle: true,
+            format: 'esm',
+            platform: 'node',
+            target: 'node22',
+            sourcemap: 'linked',
+            banner: { js: REQUIRE_BANNER },
+            plugins: [
+                collector,
+                nodeModulesExternalPlugin({
+                    onExternal: (name, importer) => add(importing, name, importer),
+                }),
+                reporter,
+            ],
+            metafile: true,
+            logLevel: 'silent',
+        });
+        return true;
+    }
+    return {
+        async build() {
+            await ensureContext();
+            if (context === undefined) {
+                return { kind: 'ok', bundleMap: {}, externals: await externalsOf(new Map()) };
+            }
+            try {
+                const result = await context.rebuild();
+                const code = importing;
+                reportedInputs = await inputsOf(result, options.packDir);
+                return outcomeOf(result, entries, options.packDir, await externalsOf(code));
+            }
+            catch (failure) {
+                return failed(failure.errors ?? [], failure);
+            }
+        },
+        async watch(onBuild) {
+            listener = onBuild;
+            await context?.watch();
+        },
+        async syncEntries() {
+            const changed = await ensureContext();
+            if (!changed || listener === undefined)
+                return changed;
+            if (entries.length === 0) {
+                reportedInputs = '';
+                const externals = await externalsOf(new Map());
+                listener?.({ kind: 'ok', bundleMap: {}, externals });
+            }
+            else {
+                // A new context doesn't watch yet; watching triggers its first build.
+                await context?.watch();
+            }
+            return changed;
+        },
+        async dispose() {
+            listener = undefined;
+            await context?.dispose();
+            context = undefined;
+        },
+    };
+}
+/**
+ * A build's outcome: each primitive's source path (as the index records
+ * it) mapped to its bundle, both relative to the pack root, and the
+ * externals — or the errors, each located `file:line:column`.
+ */
+function outcomeOf(result, entries, packDir, externals) {
+    if (result.errors.length > 0)
+        return failed(result.errors, undefined);
+    const bundleMap = {};
+    const outDir = devDistDir(packDir);
+    for (const entry of entries) {
+        bundleMap[entry.sourceRel] = toPosix(relative(packDir, `${outDir}/${entry.outRel}.mjs`));
+    }
+    return { kind: 'ok', bundleMap, externals };
+}
+/**
+ * What the config imports from `node_modules`: bundled in memory, by the
+ * externals rule. A config that doesn't bundle adds nothing here (`kindgi
+ * build` reports it).
+ */
+async function configExternalsOf(packDir, configPath) {
+    const found = new Map();
+    if (configPath === undefined)
+        return found;
+    const esbuild = await import('esbuild');
+    try {
+        await esbuild.build({
+            absWorkingDir: packDir,
+            entryPoints: [configPath],
+            bundle: true,
+            write: false,
+            format: 'esm',
+            platform: 'node',
+            target: 'node22',
+            logLevel: 'silent',
+            plugins: [
+                nodeModulesExternalPlugin({ onExternal: (name, importer) => add(found, name, importer) }),
+            ],
+        });
+    }
+    catch {
+        return new Map();
+    }
+    return found;
+}
+function add(importers, name, importer) {
+    const files = importers.get(name) ?? new Set();
+    files.add(importer);
+    importers.set(name, files);
+}
+/** The externals, merged, sorted by name; importers relative to the pack root. */
+function listExternals(sets, packDir) {
+    const merged = new Map();
+    for (const set of sets) {
+        for (const [name, files] of set)
+            for (const file of files)
+                add(merged, name, file);
+    }
+    return [...merged.keys()].sort().map((name) => ({
+        name,
+        importers: [...(merged.get(name) ?? [])].map((file) => toPosix(relative(packDir, file))).sort(),
+    }));
+}
+/** Every file a build read, with its size and mtime — equal when nothing changed. */
+async function inputsOf(result, packDir) {
+    const inputs = Object.keys(result.metafile?.inputs ?? {}).sort();
+    const stamped = await Promise.all(inputs.map(async (input) => {
+        try {
+            const s = await stat(resolve(packDir, input));
+            return `${input}:${s.size}:${s.mtimeMs}`;
+        }
+        catch {
+            return `${input}:-`;
+        }
+    }));
+    return stamped.join('\n');
+}
+function failed(errors, cause) {
+    const located = errors.map((e) => e.location === null
+        ? e.text
+        : `${e.location.file}:${e.location.line}:${e.location.column}: ${e.text}`);
+    return {
+        kind: 'err',
+        errors: located.length > 0 ? located : [cause instanceof Error ? cause.message : String(cause)],
+    };
+}
+function toPosix(path) {
+    return path.split(sep).join('/');
+}
+//# sourceMappingURL=bundler.js.map

package/dist/dev/bundler.js.map

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

package/dist/dev/defaults.d.ts

@@ -0,0 +1,140 @@
+import type { FSWatcher } from 'node:fs';
+import { watch } from 'node:fs/promises';
+import { runIndexer as runIndexerReal } from '@kindgi/handler-runtime';
+import { type PackCode } from './pack-code.js';
+import { type DockerRunner } from './postgres-container.js';
+import type { DevPackService, DevPackServiceOptions, DevRunners, IndexResult, IndexerRunOptions, PackBuilder, RunningApiServer, StartApiServerOptions, StartServicesResult, WatchHandle } from './runners.js';
+import { type RuntimeNetwork } from './runtime-container.js';
+/**
+ * The pack-service process for the pack's code: the Node pack service
+ * (loading the bundles in `.kindgi/dev/dist`, stack traces mapped back to
+ * the sources), or `python -m kindgi.pack serve` with the pack's Python.
+ */
+export declare function packServiceCommand(code: PackCode): readonly [string, ...string[]];
+/**
+ * The pack service as a child process behind the supervisor's front. The
+ * runtime calls the front over HTTP, the same address however often the
+ * code is swapped (it retries while the front answers 503 mid-swap).
+ */
+export declare function createPackServiceReal(opts: DevPackServiceOptions): DevPackService;
+/** The builder for the pack's code: esbuild bundles (Node) or the sources (Python). */
+export declare function createPackBuilderReal(opts: {
+    readonly packDir: string;
+    readonly patterns: readonly string[];
+    readonly configPath?: string;
+    readonly code: PackCode;
+    readonly env: () => Promise<Readonly<Record<string, string>>>;
+}): PackBuilder;
+export interface PythonIndexerOptions {
+    readonly packDir: string;
+    readonly outputPath: string;
+    /** The pack's interpreter (an argv prefix). */
+    readonly python: readonly [string, ...string[]];
+    readonly env: Readonly<Record<string, string>>;
+    /** Pins for a reproducible index (`kindgi build`). */
+    readonly artifactVersion?: string;
+    readonly publishedAt?: string;
+}
+/**
+ * `python -m kindgi.pack index` with the pack's Python and an environment,
+ * read back like the Node indexer's: the same one-line outcome, then the
+ * written index.
+ */
+export declare function runPythonIndexer(opts: PythonIndexerOptions): Promise<IndexResult>;
+/** Swap the staged index in: the dev index changes in one step (a rename). */
+export declare function publishIndexReal(stagedPath: string, indexPath: string): Promise<void>;
+/**
+ * The Kindgi runtime, as a container: pull the image if needed, write
+ * `runtime.env`, start it with the pack directory mounted, and wait until
+ * it serves. The runtime makes or loads its own public run token key;
+ * the developer's key file, if set, and their Google credentials are
+ * mounted read-only.
+ */
+export declare function startApiServerContainerReal(opts: StartApiServerOptions): Promise<RunningApiServer>;
+/**
+ * A runtime the developer runs themselves (`--runtime-url`), typically
+ * from source: write `runtime.env` with this machine's paths (the server
+ * binds loopback, no alias), then wait until the runtime at the URL
+ * serves and takes this session's dev token. Its lifetime isn't ours:
+ * `shutdown` leaves it running.
+ */
+export declare function attachToRuntimeReal(opts: StartApiServerOptions & {
+    readonly runtimeUrl: string;
+}): Promise<RunningApiServer>;
+/** The runtime `kindgi dev` talks to: a container, or the developer's own (`--runtime-url`). */
+export declare function startApiServerReal(opts: StartApiServerOptions): Promise<RunningApiServer>;
+/**
+ * Postgres as the container reaches it. Through the alias the container
+ * can't see the host's loopback, and a database connection isn't HTTP
+ * (the runtime's alias covers HTTP only), so a loopback host becomes
+ * `host.docker.internal` here.
+ */
+export declare function databaseUrlFrom(url: string, network: RuntimeNetwork): string;
+/**
+ * The developer's Google Application Default Credentials, mounted
+ * read-only (Kindgi keeps no key files of its own): `GOOGLE_APPLICATION_CREDENTIALS`
+ * if set, else the file `gcloud auth application-default login` writes.
+ */
+export declare function googleCredentialsPath(hostEnv: Readonly<Record<string, string | undefined>>): string | undefined;
+/**
+ * Run the indexer against a pack root. `runIndexer` writes an
+ * `index.json` on the pack root by default; we tolerate the write and
+ * read the bytes back so callers get the parsed manifest without a
+ * second walk. Failures are captured as typed `IndexFailure` — the
+ * function never throws.
+ */
+export declare function runIndexerReadReal(packDir: string, outputPath?: string, options?: IndexerRunOptions): Promise<IndexResult>;
+/**
+ * Watch the pack's discovery patterns for changes. Watches each
+ * pattern's static prefix (`kindgi/tools` for `kindgi/tools/**\/*.ts`) —
+ * never the whole host repo when the pack is embedded in an app — and
+ * fires only for paths a pattern matches, so the indexer's own output
+ * and unrelated files never trigger a re-index. `patterns` defaults to
+ * the indexer's `DEFAULT_DISCOVERY`.
+ *
+ * Uses `node:fs.watch({ recursive: true })` — dependency-free; on
+ * macOS + Linux this delivers reliable change events. Windows behavior
+ * is a known-good path per the Node docs but not exercised in CI.
+ *
+ * A single debounce timer is shared across every event → the callback
+ * fires at most once per debounce window. Roots that don't exist yet
+ * are skipped.
+ */
+export declare function watchPackReal(packDir: string, onChange: () => void, opts?: {
+    readonly debounceMs?: number;
+    readonly patterns?: readonly string[];
+    readonly files?: readonly string[];
+}): Promise<WatchHandle>;
+/**
+ * Boot the bundled services with plain `docker compose`, in the
+ * `kindgi-dev` project:
+ *
+ *   1. `up -d --wait` Postgres, which waits for its healthcheck;
+ *   2. read its published port back.
+ *
+ * Without compose (a Docker engine without the plugin), the same
+ * Postgres starts with plain `docker` (`postgres-container.ts`): the
+ * same names, so the data is shared whichever way it was started.
+ * `unavailable` only when docker itself doesn't work.
+ *
+ * Not testcontainers: its reaper (Ryuk) is handed the compose project
+ * and, when the process exits, deletes everything labelled with it —
+ * the named volumes too — so every restart came up empty. The data in
+ * the named volumes now survives `kindgi dev` restarts, as the
+ * monorepo's own dev services do (`docker compose up -d --wait`).
+ * Every `kindgi dev` on the machine shares them, so nothing here removes
+ * them; to wipe all dev data, `docker compose -p kindgi-dev down -v`.
+ * Containers left running by a killed `kindgi dev` are picked up by the
+ * next boot.
+ */
+export declare function startServicesReal(options: {
+    readonly recreate: boolean;
+}, run?: DockerRunner): Promise<StartServicesResult>;
+/** Default wiring used by the `kindgi dev` command in production. */
+export declare const REAL_DEV_RUNNERS: DevRunners;
+export declare const _internals: {
+    readonly fsWatch: typeof watch;
+    readonly runIndexer: typeof runIndexerReal;
+};
+export type { FSWatcher };
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/dev/defaults.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAA2C,KAAK,EAAa,MAAM,kBAAkB,CAAC;AAI7F,OAAO,EAML,UAAU,IAAI,cAAc,EAC7B,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,KAAK,QAAQ,EAAmB,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EACL,KAAK,YAAY,EAKlB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EAEnB,WAAW,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,KAAK,cAAc,EAKpB,MAAM,wBAAwB,CAAC;AAuBhC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAIjF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAYjF;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAC/D,GAAG,WAAW,CAQd;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,sDAAsD;IACtD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBvF;AAsFD,8EAA8E;AAC9E,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAmE3B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC,gBAAgB,CAAC,CAsE3B;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIzF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAQ5E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GACpD,MAAM,GAAG,SAAS,CAOpB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAA8B,EAC1C,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAetB;AAuCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,IAAI,EACpB,IAAI,GAAE;IACJ,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,GACL,OAAO,CAAC,WAAW,CAAC,CAuDtB;AAmJD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EACvC,GAAG,GAAE,YAAqB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAwCD,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,EAAE,UAS9B,CAAC;AAGF,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAGX,YAAY,EAAE,SAAS,EAAE,CAAC"}