@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/build/runners.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Injectable seams for `kindgi build`. Every side effect flows through
+ * this interface so tests can substitute fixtures without invoking real
+ * esbuild, real `tar`, real `fetch`, or Docker. Production wiring lives
+ * at `packages/cli/src/build/defaults.ts`.
+ *
+ * `kindgi build` is the CLI-side orchestrator, in nine steps:
+ *
+ *   1. Local indexer pass (integrity gate baseline)
+ *   2. esbuild bundle
+ *   3. Generate multi-stage Containerfile
+ *   4. Tar the bundle
+ *   5. Compute sha256(pack.tgz)
+ *   6. POST /v1/build + subscribe to SSE build logs (terminal payload =
+ *      { imageRef, imageDigest, indexJson, indexHash, buildLogsUrl })
+ *   7. Local integrity gate — hash diff + optional docker pull + diff
+ *   8. Sign locally (Ed25519 over canonicalised envelope body)
+ *   9. Emit deploy-envelope.json (`kindgi deploy` POSTs this file)
+ *
+ * The full pipeline is composed by `commands/build.ts` from the seams
+ * declared here. Each seam is named per its pipeline step so a test
+ * looking at a failing stage can substitute only that field.
+ */
+import type { IndexResult } from '../dev/runners.js';
+/**
+ * The manifest slot the local integrity gate uses. Kept structural so
+ * tests hand back plain objects without importing
+ * `@kindgi/handler-runtime`. Production wiring runs the bundled
+ * `kindgi-index.mjs` over the bundles, as the image's indexer stage
+ * does, and reads `expected-index.json` back off disk.
+ */
+export type LocalIndexResult = IndexResult;
+export interface RunLocalIndexerOptions {
+    readonly packDir: string;
+    /** The bundles (`esbuildBundle`'s `outputDir`): the indexer, the config, the bundle map. */
+    readonly bundleDir: string;
+    readonly outputPath: string;
+    readonly artifactVersion: string;
+    readonly publishedAt: string;
+}
+export interface EsbuildBundleOptions {
+    readonly packDir: string;
+    readonly outputDir: string;
+    /**
+     * The pack's discovery patterns (defaults filled in) — every file
+     * they match is bundled as an entrypoint, the same set the indexer
+     * discovers.
+     */
+    readonly discoveryPatterns: readonly string[];
+    /** The pack's `kindgi.config.*`, bundled to `kindgi.config.mjs`. */
+    readonly configPath: string;
+    /** The Node major the image runs: the bundles' esbuild target. */
+    readonly nodeMajor: number;
+}
+export interface EsbuildBundleResult {
+    /** Absolute paths of every emitted file (bundles and sourcemaps). */
+    readonly emitted: readonly string[];
+    /** Total bundle byte size — surfaced in the summary. */
+    readonly totalBytes: number;
+    /** The packages the pack's bundles import from `node_modules`, sorted. */
+    readonly externals: readonly string[];
+    /** Each primitive's source path → its bundle, under `outputDir` (`bundle-map.json`). */
+    readonly bundleMap: Readonly<Record<string, string>>;
+}
+import type { HostInstall, HostSecret } from './host-install.js';
+import type { ResolvedImage } from './image-config.js';
+import type { PythonInstaller } from './python-image.js';
+export interface WriteContainerfileOptions {
+    readonly outputPath: string;
+    readonly artifactVersion: string;
+    readonly publishedAt: string;
+    /** The pinned base image (`node-image.ts`). */
+    readonly baseImageRef: string;
+    /** buildTarget threaded into the ARG for the indexer stage. */
+    readonly buildTarget: string;
+    readonly install: HostInstall;
+    /** What `image` in `kindgi.config` adds. */
+    readonly image: ResolvedImage;
+    /** Whether the context has `include/` (`bundle.include` files). */
+    readonly hasIncludes: boolean;
+}
+export interface WriteContextOptions {
+    readonly contextDir: string;
+    readonly packDir: string;
+    readonly install: HostInstall;
+    readonly bundleDir: string;
+    readonly containerfilePath: string;
+    /** `bundle.include` files, relative to `packDir`. */
+    readonly includes: readonly string[];
+    /** The files the image's build extensions read, relative to `packDir`. */
+    readonly extensionFiles: readonly string[];
+}
+export interface TarPackOptions {
+    /** A context `writeContext` wrote; removed once tarred. */
+    readonly contextDir: string;
+    readonly outputPath: string;
+}
+export interface DockerBuildOptions {
+    readonly contextDir: string;
+    readonly tag: string;
+    readonly buildTarget: string;
+    /** The image's platform (`linux/amd64`). Absent: this machine's. */
+    readonly platform?: string;
+    /** Push `tag` to its registry instead of loading it into the local image store. */
+    readonly push?: boolean;
+    /** Registry config for the install, as BuildKit secrets. */
+    readonly secrets: readonly (Pick<HostSecret, 'id'> & {
+        readonly src: string;
+    })[];
+    readonly onLog?: (line: string) => void;
+}
+export type DockerBuildResult = {
+    readonly kind: 'ok';
+    /** Loaded: the local image id. Pushed: the pushed manifest's digest. */
+    readonly imageId: string;
+    /** Pushed: the digest the registry has (`sha256:…`). */
+    readonly digest?: string;
+} | {
+    readonly kind: 'err';
+    readonly message: string;
+};
+export interface TarPackResult {
+    readonly path: string;
+    readonly bytes: Uint8Array;
+    readonly size: number;
+}
+export interface PostBuildOptions {
+    readonly endpoint: string;
+    readonly tarballBytes: Uint8Array;
+    readonly tarballSha256: string;
+    readonly buildTarget: string;
+    readonly registryPushCredsRef?: string;
+    readonly fetchImpl: typeof fetch;
+}
+export interface PostBuildResult {
+    readonly buildJobId: string;
+    readonly status: 'queued' | 'running' | 'completed' | 'failed';
+    readonly buildLogsUrl: string;
+    /**
+     * When the build server replays an idempotent hit (200 with existing
+     * completed job), the terminal payload is returned inline — the caller
+     * can skip the SSE stream.
+     */
+    readonly terminal?: TerminalPayload;
+}
+export interface TerminalPayload {
+    readonly status: 'completed' | 'failed';
+    readonly imageRef?: string;
+    readonly imageDigest?: string;
+    readonly indexJson?: Readonly<Record<string, unknown>>;
+    readonly indexHash?: string;
+    readonly buildLogsUrl?: string;
+    readonly error?: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+export interface StreamBuildLogsOptions {
+    readonly endpoint: string;
+    readonly buildJobId: string;
+    readonly fetchImpl: typeof fetch;
+    readonly onLog: (line: string) => void;
+    readonly signal?: AbortSignal;
+}
+export interface PullImageIndexOptions {
+    readonly imageRef: string;
+    readonly workDir: string;
+    /** `false`: the image is in the local store already (`--local`). Default: pull it. */
+    readonly pull?: boolean;
+    /** The image's platform, when it isn't this machine's (an amd64 image on Apple silicon). */
+    readonly platform?: string;
+    readonly onLog?: (line: string) => void;
+    readonly signal?: AbortSignal;
+}
+export interface PullImageIndexResult {
+    /** Raw bytes of `/app/index.json` extracted from the image. */
+    readonly bytes: Uint8Array;
+}
+export interface SignOptions {
+    /** PEM-encoded PKCS8 Ed25519 private key. */
+    readonly privateKeyPem: string;
+    /** Bytes to sign — the canonicalised signature body. */
+    readonly message: Uint8Array;
+}
+export interface SignResult {
+    /** Base64-encoded 64-byte signature. */
+    readonly signatureBase64: string;
+    /** PEM-encoded public key derived from the private key. */
+    readonly publicKeyPem: string;
+}
+/**
+ * The steps that differ for a Python pack (`[tool.kindgi]` in
+ * `pyproject.toml`): no bundle — its own indexer with the pack's
+ * interpreter, its own Containerfile, the pack root as the context.
+ */
+export interface PythonBuildRunners {
+    readonly runLocalIndexer: (opts: Omit<RunLocalIndexerOptions, 'bundleDir'> & {
+        readonly python: readonly [string, ...string[]];
+        readonly env: Readonly<Record<string, string>>;
+    }) => Promise<LocalIndexResult>;
+    readonly writeContainerfile: (opts: Omit<WriteContainerfileOptions, 'baseImageRef' | 'install' | 'image' | 'hasIncludes'> & {
+        readonly baseImageRef: string;
+        readonly uvImageRef: string;
+        readonly installer: PythonInstaller;
+        /** Debian packages for the image, checked (`checkAptPackages`). */
+        readonly systemPackages: readonly string[];
+    }) => Promise<void>;
+    /** Tars `files` (pack-relative) and the Containerfile, deterministically. */
+    readonly tarContext: (opts: {
+        readonly packDir: string;
+        readonly files: readonly string[];
+        readonly containerfilePath: string;
+        readonly outputPath: string;
+    }) => Promise<TarPackResult>;
+}
+/**
+ * Injected seams the `build` command consumes. Every side effect must
+ * pass through one of these — no `import('esbuild')` / `import('tar')`
+ * inside `commands/build.ts` and no direct docker or filesystem writes
+ * outside these methods. Tests substitute per-field to exercise every
+ * pipeline branch without ever booting real esbuild / real tar / real
+ * docker / real network.
+ */
+export interface BuildRunners {
+    /** Runs the CLI's own indexer against the pack + writes to `outputPath`. */
+    readonly runLocalIndexer: (opts: RunLocalIndexerOptions) => Promise<LocalIndexResult>;
+    /** Bundles the pack source + framework entrypoints into `outputDir`. */
+    readonly esbuildBundle: (opts: EsbuildBundleOptions) => Promise<EsbuildBundleResult>;
+    /** Emits the multi-stage Containerfile at `outputPath`. */
+    readonly writeContainerfile: (opts: WriteContainerfileOptions) => Promise<void>;
+    /** Writes the image's build context: the install's files, the bundles, the includes, the Containerfile. */
+    readonly writeContext: (opts: WriteContextOptions) => Promise<void>;
+    /** Tars a written context into a single gzipped archive. */
+    readonly tarPack: (opts: TarPackOptions) => Promise<TarPackResult>;
+    /** `--local`: builds the image into the local Docker image store. */
+    readonly dockerBuild?: (opts: DockerBuildOptions) => Promise<DockerBuildResult>;
+    /** POSTs the tarball to `POST /v1/build`. */
+    readonly postBuild: (opts: PostBuildOptions) => Promise<PostBuildResult>;
+    /**
+     * Subscribes to `GET /v1/build/:jobId/stream`. Forwards each `log`
+     * event to `onLog`. Resolves with the terminal payload the server
+     * emits before closing the stream.
+     */
+    readonly streamBuildLogs: (opts: StreamBuildLogsOptions) => Promise<TerminalPayload>;
+    /**
+     * Optional docker-pull-and-extract path. When absent OR when the
+     * command runs with `--skip-image-pull`, the integrity gate uses only
+     * the hash-comparison path.
+     */
+    readonly pullImageIndex?: (opts: PullImageIndexOptions) => Promise<PullImageIndexResult>;
+    /**
+     * Ed25519 signature over the canonicalised envelope body. Returns the
+     * base64-encoded signature + the derived public key in PEM.
+     */
+    readonly signEnvelope: (opts: SignOptions) => Promise<SignResult>;
+    /** A Python pack's steps; absent → `kindgi build` refuses a Python pack. */
+    readonly python?: PythonBuildRunners;
+}
+//# sourceMappingURL=runners.d.ts.map

package/dist/build/runners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../../src/build/runners.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE3C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,KAAK,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,KAAK,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,CACxB,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,GAAG;QAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAChD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAChD,KACE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC,GAAG;QAC5F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;QACpC,mEAAmE;QACnE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;KAC5C,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtF,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrF,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,2GAA2G;IAC3G,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,qEAAqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChF,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACzE;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACrF;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzF;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CACtC"}

package/dist/build/runners.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=runners.js.map

package/dist/build/runners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners.js","sourceRoot":"","sources":["../../src/build/runners.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}

package/dist/build/version-specifier.d.ts

@@ -0,0 +1,2 @@
+export declare function satisfiesSpecifiers(version: string, specifiers: string): boolean | undefined;
+//# sourceMappingURL=version-specifier.d.ts.map

package/dist/build/version-specifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-specifier.d.ts","sourceRoot":"","sources":["../../src/build/version-specifier.ts"],"names":[],"mappings":"AAaA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAe5F"}

package/dist/build/version-specifier.js

@@ -0,0 +1,70 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export function satisfiesSpecifiers(version, specifiers) {
+    const v = parseRelease(version);
+    if (v === undefined)
+        return undefined;
+    const clauses = specifiers
+        .split(',')
+        .map((c) => c.trim())
+        .filter((c) => c !== '');
+    if (clauses.length === 0)
+        return undefined;
+    let all = true;
+    for (const clause of clauses) {
+        const ok = satisfies(v, clause);
+        if (ok === undefined)
+            return undefined;
+        all &&= ok;
+    }
+    return all;
+}
+function satisfies(v, clause) {
+    const m = /^(~=|===|==|!=|<=|>=|<|>)\s*([0-9]+(?:\.[0-9]+)*)(\.\*)?$/.exec(clause);
+    if (m === null)
+        return undefined;
+    const [, op, raw, wildcard] = m;
+    const target = parseRelease(raw);
+    if (wildcard !== undefined) {
+        if (op !== '==' && op !== '!=')
+            return undefined;
+        const prefix = startsWith(v, target);
+        return op === '==' ? prefix : !prefix;
+    }
+    const c = compare(v, target);
+    switch (op) {
+        case '==':
+        case '===':
+            return c === 0;
+        case '!=':
+            return c !== 0;
+        case '<':
+            return c < 0;
+        case '<=':
+            return c <= 0;
+        case '>':
+            return c > 0;
+        case '>=':
+            return c >= 0;
+        default:
+            // `~=X.Y.Z` is `>=X.Y.Z, ==X.Y.*`; it needs two release segments.
+            if (target.length < 2)
+                return undefined;
+            return c >= 0 && startsWith(v, target.slice(0, -1));
+    }
+}
+function parseRelease(text) {
+    return /^[0-9]+(\.[0-9]+)*$/.test(text) ? text.split('.').map(Number) : undefined;
+}
+function compare(a, b) {
+    for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
+        const d = (a[i] ?? 0) - (b[i] ?? 0);
+        if (d !== 0)
+            return d;
+    }
+    return 0;
+}
+function startsWith(v, prefix) {
+    return prefix.every((part, i) => (v[i] ?? 0) === part);
+}
+//# sourceMappingURL=version-specifier.js.map

package/dist/build/version-specifier.js.map

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

package/dist/cli-package.d.ts

@@ -0,0 +1,15 @@
+/** The running `@kindgi/cli` package — its root, version, and the SDK spec it depends on. */
+export interface CliPackageInfo {
+    readonly root: string;
+    readonly version: string;
+    /** `dependencies['@kindgi/sdk']` — `workspace:*` in a checkout, a version once published. */
+    readonly sdkDependency: string | undefined;
+}
+/**
+ * Walk up from this module to the `package.json` named `@kindgi/cli`.
+ * Works from `src/` (tests) and `dist/` (built), in a checkout or under
+ * `node_modules`. Companion to `resolveSdkPackageRoot` — no repo-layout
+ * assumption. `undefined` when not found (broken install).
+ */
+export declare function resolveCliPackage(): CliPackageInfo | undefined;
+//# sourceMappingURL=cli-package.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-package.d.ts","sourceRoot":"","sources":["../src/cli-package.ts"],"names":[],"mappings":"AAOA,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAS9D"}

package/dist/cli-package.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Walk up from this module to the `package.json` named `@kindgi/cli`.
+ * Works from `src/` (tests) and `dist/` (built), in a checkout or under
+ * `node_modules`. Companion to `resolveSdkPackageRoot` — no repo-layout
+ * assumption. `undefined` when not found (broken install).
+ */
+export function resolveCliPackage() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (;;) {
+        const info = readCliPackageJson(join(dir, 'package.json'));
+        if (info !== undefined)
+            return { root: dir, ...info };
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+function readCliPackageJson(path) {
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (pkg.name !== '@kindgi/cli' || typeof pkg.version !== 'string')
+        return undefined;
+    const sdk = pkg.dependencies?.['@kindgi/sdk'];
+    return { version: pkg.version, sdkDependency: typeof sdk === 'string' ? sdk : undefined };
+}
+//# sourceMappingURL=cli-package.js.map

package/dist/cli-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-package.js","sourceRoot":"","sources":["../src/cli-package.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUzC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;QAC3D,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QACrC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAY;IAEZ,IAAI,GAAkF,CAAC;IACvF,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpF,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,aAAa,CAAC,CAAC;IAC9C,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC5F,CAAC"}

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { runCli } from './main.js';
+import { createStopSignal } from './stop-signal.js';
+import { writeFully } from './write-fully.js';
+async function main() {
+    // SIGINT/SIGTERM → an AbortSignal so long-lived commands (currently
+    // only `kindgi dev` — the watch loop) can shut down cleanly; a second
+    // signal forces the exit. Short-lived commands never observe it.
+    const stopSignal = createStopSignal(process, (code) => process.exit(code));
+    const outcome = await runCli({
+        argv: process.argv.slice(2),
+        env: process.env,
+        stopSignal,
+    });
+    // Exit once the output is out: piped output would be cut otherwise.
+    await writeFully(process.stdout, outcome.stdout);
+    await writeFully(process.stderr, outcome.stderr);
+    process.exit(outcome.exitCode);
+}
+main().catch(async (err) => {
+    await writeFully(process.stderr, `Fatal: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,oEAAoE;IACpE,sEAAsE;IACtE,iEAAiE;IACjE,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3E,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU;KACX,CAAC,CAAC;IACH,oEAAoE;IACpE,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAY,EAAE,EAAE;IAClC,MAAM,UAAU,CACd,OAAO,CAAC,MAAM,EACd,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC9E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/adapters.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from './types.js';
+export declare const adaptersCommand: Command;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/commands/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/commands/adapters.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,YAAY,CAAC;AAiJtE,eAAO,MAAM,eAAe,EAAE,OAM7B,CAAC"}

package/dist/commands/adapters.js

@@ -0,0 +1,148 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { commandResultFromThrown, requiredPositional, stringFlag } from './helpers.js';
+const prepareCmd = {
+    kind: 'leaf',
+    name: 'prepare',
+    description: 'Pre-warm an adapter (download weights, initialize sessions). Streams SSE progress. Call after `providers register`, before `runs start`.',
+    usage: 'kindgi adapters prepare <adapter-id> [--model=<key>] [--params=<json-or-@file>]',
+    optionSpec: {
+        model: {
+            type: 'string',
+            description: 'The model to prepare, by key: shorthand for a `model` field in `--params`, and wins over it.',
+        },
+        params: {
+            type: 'string',
+            description: "The adapter's prepare settings, as an inline JSON object.",
+        },
+    },
+    run: async (ctx) => {
+        let adapterId;
+        try {
+            adapterId = requiredPositional(ctx, 0, 'adapter-id');
+        }
+        catch (err) {
+            return { kind: 'error', stderr: `${err.message}\n`, exitCode: 2 };
+        }
+        // Compose adapter params. `--model=<key>` is a shorthand for the
+        // in-process ONNX adapter (its only meaningful param); `--params`
+        // accepts an arbitrary JSON blob for any adapter.
+        const paramsFlag = stringFlag(ctx, 'params');
+        const modelFlag = stringFlag(ctx, 'model');
+        let params;
+        if (paramsFlag !== undefined) {
+            try {
+                params = JSON.parse(paramsFlag);
+            }
+            catch (err) {
+                return {
+                    kind: 'error',
+                    stderr: `Malformed --params JSON: ${err.message}\n`,
+                    exitCode: 2,
+                };
+            }
+        }
+        if (modelFlag !== undefined) {
+            params = { ...(params ?? {}), model: modelFlag };
+        }
+        // Wire SIGINT / stopSignal to the SSE stream so Ctrl-C aborts
+        // mid-download cleanly instead of leaving a dangling connection.
+        const controller = new AbortController();
+        const upstream = ctx.stopSignal;
+        if (upstream !== undefined) {
+            if (upstream.aborted)
+                controller.abort();
+            else
+                upstream.addEventListener('abort', () => controller.abort(), { once: true });
+        }
+        const iterable = ctx.client().adapters.prepare({
+            adapterId,
+            ...(params !== undefined && { params }),
+            signal: controller.signal,
+        });
+        const jsonMode = ctx.globals.format === 'json';
+        const events = [];
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        stderrChunks.push(`\n  Preparing ${adapterId}${params !== undefined ? ` (${JSON.stringify(params)})` : ''}…\n`);
+        try {
+            for await (const event of iterable) {
+                events.push(event);
+                if (jsonMode) {
+                    stdoutChunks.push(`${JSON.stringify(event)}\n`);
+                }
+                else {
+                    stderrChunks.push(renderProgressLine(event));
+                }
+                if (event.kind === 'ready' || event.kind === 'error')
+                    break;
+            }
+        }
+        catch (err) {
+            return commandResultFromThrown(err, ctx, 'kindgi adapters prepare');
+        }
+        const terminal = events[events.length - 1];
+        if (terminal?.kind === 'error') {
+            return {
+                kind: 'error',
+                stderr: [...stderrChunks, `\n  Failed: ${terminal.message}\n\n`].join(''),
+                exitCode: 1,
+            };
+        }
+        if (jsonMode) {
+            return {
+                kind: 'ok',
+                rendered: {
+                    stdout: stdoutChunks.join(''),
+                    stderr: stderrChunks.join(''),
+                },
+            };
+        }
+        const summary = terminal?.kind === 'ready'
+            ? (terminal.message ?? 'ready')
+            : 'stream ended without terminal event';
+        stderrChunks.push(`\n  Ready: ${summary}\n\n`);
+        return {
+            kind: 'ok',
+            rendered: {
+                stdout: '',
+                stderr: stderrChunks.join(''),
+            },
+        };
+    },
+};
+function renderProgressLine(event) {
+    if (event.kind === 'ready') {
+        return `  ✓ ${event.message ?? 'ready'}\n`;
+    }
+    if (event.kind === 'error') {
+        return `  ✗ ${event.message}\n`;
+    }
+    // progress
+    const parts = [];
+    if (event.message !== undefined)
+        parts.push(event.message);
+    if (typeof event.ratio === 'number') {
+        parts.push(`${Math.round(event.ratio * 100)}%`);
+    }
+    if (typeof event.loadedBytes === 'number' && typeof event.totalBytes === 'number') {
+        parts.push(`(${formatBytes(event.loadedBytes)} / ${formatBytes(event.totalBytes)})`);
+    }
+    return `  ${parts.join('  ')}\n`;
+}
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    if (n < 1024 * 1024 * 1024)
+        return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(n / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+export const adaptersCommand = {
+    kind: 'group',
+    name: 'adapters',
+    description: 'Manage adapter lifecycle (prepare / warmup). Read-side lives on `kindgi providers`.',
+    subcommands: [prepareCmd],
+};
+//# sourceMappingURL=adapters.js.map

package/dist/commands/adapters.js.map

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

package/dist/commands/agents.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from './types.js';
+export declare const agentsCommand: Command;
+//# sourceMappingURL=agents.d.ts.map

package/dist/commands/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AAwFvD,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC"}