@gezelligate/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spatial Explorers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @gezelligate/core
+
+Core engine for [Gezelligate](https://github.com/gezelligate/gezelligate). Schema, loader, templating, validation, target abstraction, and the catalog bootstrap (`bootstrapCatalog`, `TarballCatalogReader`, project pin).
+
+This is a library package — most users want [`@gezelligate/studio`](https://www.npmjs.com/package/@gezelligate/studio) or [`@gezelligate/cli`](https://www.npmjs.com/package/@gezelligate/cli). Reach for `core` when you're building your own renderer / target or scripting against the same project shape.
+
+## Render with injected targets
+
+`core` has no compile-time dependency on `@gezelligate/{docker,k8s}` — callers wire the targets so the package graph stays acyclic.
+
+```ts
+import { render, bootstrapCatalog } from "@gezelligate/core";
+import { renderDockerTarget } from "@gezelligate/docker";
+import { renderKubernetesTarget } from "@gezelligate/k8s";
+
+const projectDir = process.cwd();
+const resolved = await bootstrapCatalog({ projectDir });
+
+await render({
+  projectDir,
+  repositoryDir: resolved.recipesDir,
+  providersDir: resolved.providersDir,
+  targets: { docker: renderDockerTarget, kubernetes: renderKubernetesTarget }
+});
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/bridgeManifest.d.ts

@@ -0,0 +1,67 @@
+import type { ServiceState } from "./keycloak.js";
+import type { GlobalConfig } from "./schema/configYaml.js";
+export interface BridgeManifestServiceActivity {
+    unreadEndpoint: string;
+    auth: "oidc-passthrough" | "service-token";
+}
+export interface BridgeManifestServiceRecentItems {
+    endpoint: string;
+    limit: number;
+    mapping: {
+        id: string;
+        title: string;
+        url: string;
+        timestamp: string;
+    };
+}
+export interface BridgeManifestServiceSearchApi {
+    method: "GET" | "POST";
+    endpoint: string;
+    body?: string;
+    auth: "oidc-passthrough" | "service-token";
+    mapping: {
+        id: string;
+        title: string;
+        url: string;
+        timestamp: string;
+        snippet?: string;
+    };
+}
+export interface BridgeManifestServiceSearchIndex {
+    table: string;
+    where?: string;
+    watermark: string;
+    fields: {
+        id: string;
+        title: string;
+        body: string;
+        url: string;
+        timestamp: string;
+    };
+}
+export interface BridgeManifestServiceSearch {
+    api?: BridgeManifestServiceSearchApi;
+    index?: BridgeManifestServiceSearchIndex;
+}
+export interface BridgeManifestService {
+    id: string;
+    name: string;
+    icon: string;
+    url: string;
+    activity?: BridgeManifestServiceActivity;
+    recentItems?: BridgeManifestServiceRecentItems;
+    database?: string;
+    search?: BridgeManifestServiceSearch;
+}
+export interface BridgeManifestShare {
+    mattermost: {
+        enabled: boolean;
+    };
+}
+export interface BridgeManifest {
+    apexDomain: string;
+    services: BridgeManifestService[];
+    share: BridgeManifestShare;
+}
+export declare function buildBridgeManifest(services: ServiceState[], global: GlobalConfig): BridgeManifest;
+//# sourceMappingURL=bridgeManifest.d.ts.map

package/dist/bridgeManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeManifest.d.ts","sourceRoot":"","sources":["../src/bridgeManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAAC;CAC5C;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAAC;IAC3C,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1F;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,8BAA8B,CAAC;IACrC,KAAK,CAAC,EAAE,gCAAgC,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IACzC,WAAW,CAAC,EAAE,gCAAgC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,YAAY,GACnB,cAAc,CA+BhB"}

package/dist/bridgeManifest.js

@@ -0,0 +1,35 @@
+import { renderTemplate } from "./templating.js";
+export function buildBridgeManifest(services, global) {
+    if (global.baseDomain === undefined) {
+        throw new Error("buildBridgeManifest requires global.baseDomain to be set");
+    }
+    const out = [];
+    for (const s of services) {
+        const bridge = s.def.provides.bridge;
+        if (!bridge)
+            continue;
+        const ctx = { form: s.config.form, global };
+        out.push({
+            id: s.def.name,
+            name: bridge.tile.name,
+            icon: bridge.tile.icon,
+            url: renderTemplate(bridge.tile.url, ctx),
+            activity: bridge.activity ? { ...bridge.activity.api } : undefined,
+            recentItems: bridge.recentItems ? { ...bridge.recentItems.api } : undefined,
+            database: s.def.database?.preferShared === true ? s.def.database.name : undefined,
+            search: bridge.search
+                ? {
+                    api: bridge.search.api ? { ...bridge.search.api } : undefined,
+                    index: bridge.search.index ? { ...bridge.search.index } : undefined
+                }
+                : undefined
+        });
+    }
+    const mattermostInstalled = services.some(s => s.def.name === "mattermost");
+    return {
+        apexDomain: global.baseDomain,
+        services: out,
+        share: { mattermost: { enabled: mattermostInstalled } }
+    };
+}
+//# sourceMappingURL=bridgeManifest.js.map

package/dist/bridgeManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeManifest.js","sourceRoot":"","sources":["../src/bridgeManifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAsDjD,MAAM,UAAU,mBAAmB,CACjC,QAAwB,EACxB,MAAoB;IAEpB,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;YACtB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;YACtB,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC;YACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;YAClE,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;YAC3E,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACjF,MAAM,EAAE,MAAM,CAAC,MAAM;gBACnB,CAAC,CAAC;oBACE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;oBAC7D,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;iBACpE;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC;IACD,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAC5E,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,GAAG;QACb,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/dist/capabilities.d.ts

@@ -0,0 +1,23 @@
+import type { Provides, ServiceYaml } from "./schema/serviceYaml.js";
+export interface ServiceState {
+    def: ServiceYaml;
+    env: Record<string, string>;
+}
+export type CapabilityKey = keyof Provides;
+export declare function findOne<S extends {
+    def: {
+        provides: Provides;
+    };
+}>(states: readonly S[], capability: CapabilityKey): S | undefined;
+export declare function findAll<S extends {
+    def: {
+        provides: Provides;
+    };
+}>(states: readonly S[], capability: CapabilityKey): S[];
+export declare function requireOne<S extends {
+    def: {
+        provides: Provides;
+        name: string;
+    };
+}>(states: readonly S[], capability: CapabilityKey, context: string): S;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,WAAW,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC;AAE3C,wBAAgB,OAAO,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAA;CAAE,EAC/D,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,UAAU,EAAE,aAAa,GACxB,CAAC,GAAG,SAAS,CAEf;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAA;CAAE,EAC/D,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,UAAU,EAAE,aAAa,GACxB,CAAC,EAAE,CAEL;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAChF,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,MAAM,GACd,CAAC,CASH"}

package/dist/capabilities.js

@@ -0,0 +1,15 @@
+export function findOne(states, capability) {
+    return states.find((s) => s.def.provides[capability] !== undefined);
+}
+export function findAll(states, capability) {
+    return states.filter((s) => s.def.provides[capability] !== undefined);
+}
+export function requireOne(states, capability, context) {
+    const found = findOne(states, capability);
+    if (!found) {
+        const enabled = states.map((s) => s.def.name).join(", ") || "(none)";
+        throw new Error(`No service declares provides.${capability} (needed ${context}). Enabled services: ${enabled}.`);
+    }
+    return found;
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,OAAO,CACrB,MAAoB,EACpB,UAAyB;IAEzB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,MAAoB,EACpB,UAAyB;IAEzB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAoB,EACpB,UAAyB,EACzB,OAAe;IAEf,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;QACrE,MAAM,IAAI,KAAK,CACb,gCAAgC,UAAU,YAAY,OAAO,wBAAwB,OAAO,GAAG,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/catalog/bootstrap.d.ts

@@ -0,0 +1,25 @@
+export interface BootstrapOptions {
+    projectDir: string;
+    /** Explicit catalog ref. If omitted, falls back to pin or "latest release". */
+    catalogRef?: string;
+    /** Explicit local catalog dir. Skips fetching entirely. */
+    catalogDir?: string;
+    /** GitHub org/user. Defaults to "gezelligate". */
+    owner?: string;
+    /** GitHub repo. Defaults to "catalog". */
+    repo?: string;
+    /** Caller's npm version. Recorded in the pin (diagnostic only). */
+    callerVersion?: string;
+    /** Progress sink. Defaults to writing to stdout. */
+    log?: (msg: string) => void;
+}
+export interface ResolvedCatalog {
+    /** Absolute root of the catalog (either a checkout or a fetched cache). */
+    catalogDir: string;
+    recipesDir: string;
+    providersDir: string;
+    /** "local" when --catalog-dir is used, otherwise the git ref. */
+    ref: string;
+}
+export declare function bootstrapCatalog(opts: BootstrapOptions): Promise<ResolvedCatalog>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/catalog/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/catalog/bootstrap.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4CvF"}

package/dist/catalog/bootstrap.js

@@ -0,0 +1,56 @@
+// Shared bootstrap routine used by both CLI (`gezelligate init`) and Studio's
+// first-run hook. Resolves a catalog ref, fetches the tarball if uncached,
+// writes the pin to services/.gezelligate.json, returns the on-disk paths
+// downstream code (renderer, server) needs.
+//
+// Honours three precedence rules:
+// 1. `--catalog-dir` (or programmatic catalogDir) wins outright — treat as a
+//    stable local checkout, never fetch, never pin.
+// 2. Explicit `--catalog-ref` overrides what's in the pin file.
+// 3. With neither, an existing pin's ref is reused; on first run, the latest
+//    GitHub release is resolved.
+import crypto from "node:crypto";
+import path from "node:path";
+import { catalogCacheExists, catalogCachePaths, fetchCatalogTarball, projectCatalogDir, resolveLatestCatalogRef } from "./tarball.js";
+import { readProjectPin, writeProjectPin } from "./projectPin.js";
+export async function bootstrapCatalog(opts) {
+    const log = opts.log ?? ((m) => process.stdout.write(m));
+    if (opts.catalogDir) {
+        const catalogDir = path.resolve(opts.catalogDir);
+        const paths = catalogCachePaths(catalogDir);
+        return {
+            catalogDir,
+            recipesDir: paths.recipesDir,
+            providersDir: paths.providersDir,
+            ref: "local"
+        };
+    }
+    const existing = await readProjectPin(opts.projectDir);
+    let ref = opts.catalogRef ?? existing?.catalogRef;
+    if (!ref) {
+        log("→ resolving latest catalog release …\n");
+        ref = await resolveLatestCatalogRef({ owner: opts.owner, repo: opts.repo });
+        log(`  latest release: ${ref}\n`);
+    }
+    const destDir = projectCatalogDir(opts.projectDir, ref);
+    if (!(await catalogCacheExists(opts.projectDir, ref))) {
+        const owner = opts.owner ?? "gezelligate";
+        const repo = opts.repo ?? "catalog";
+        log(`→ fetching catalog ${owner}/${repo}@${ref} …\n`);
+        await fetchCatalogTarball({ owner: opts.owner, repo: opts.repo, ref, destDir });
+        log(`  cached at ${destDir}\n`);
+    }
+    await writeProjectPin(opts.projectDir, {
+        catalogRef: ref,
+        projectId: existing?.projectId ?? crypto.randomUUID(),
+        ...(opts.callerVersion ? { studioVersion: opts.callerVersion } : {})
+    });
+    const paths = catalogCachePaths(destDir);
+    return {
+        catalogDir: destDir,
+        recipesDir: paths.recipesDir,
+        providersDir: paths.providersDir,
+        ref
+    };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/catalog/bootstrap.js.map

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

package/dist/catalog/index.d.ts

@@ -0,0 +1,4 @@
+export { ProjectPinSchema, type ProjectPin, PIN_RELATIVE_PATH, readProjectPin, writeProjectPin } from "./projectPin.js";
+export { DEFAULT_CATALOG_OWNER, DEFAULT_CATALOG_REPO, type CatalogTarballOptions, type CatalogCachePaths, catalogCachePaths, projectCatalogDir, catalogCacheExists, fetchCatalogTarball, resolveLatestCatalogRef } from "./tarball.js";
+export { type BootstrapOptions, type ResolvedCatalog, bootstrapCatalog } from "./bootstrap.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC"}

package/dist/catalog/index.js

@@ -0,0 +1,4 @@
+export { ProjectPinSchema, PIN_RELATIVE_PATH, readProjectPin, writeProjectPin } from "./projectPin.js";
+export { DEFAULT_CATALOG_OWNER, DEFAULT_CATALOG_REPO, catalogCachePaths, projectCatalogDir, catalogCacheExists, fetchCatalogTarball, resolveLatestCatalogRef } from "./tarball.js";
+export { bootstrapCatalog } from "./bootstrap.js";
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,iBAAiB,EACjB,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EAGpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAGL,gBAAgB,EACjB,MAAM,gBAAgB,CAAC"}

package/dist/catalog/projectPin.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const ProjectPinSchema: z.ZodObject<{
+    /** Git ref of the gezelligate/catalog repo (release tag preferred, sha allowed). */
+    catalogRef: z.ZodString;
+    /** Version of @gezelligate/studio (or cli) that initialized this project. Diagnostic only. */
+    studioVersion: z.ZodOptional<z.ZodString>;
+    /** Stable random uuid per project. Lets the bridge / analytics distinguish projects. */
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    catalogRef: string;
+    projectId: string;
+    studioVersion?: string | undefined;
+}, {
+    catalogRef: string;
+    projectId: string;
+    studioVersion?: string | undefined;
+}>;
+export type ProjectPin = z.infer<typeof ProjectPinSchema>;
+export declare const PIN_RELATIVE_PATH = "services/.gezelligate.json";
+export declare function readProjectPin(projectDir: string): Promise<ProjectPin | null>;
+export declare function writeProjectPin(projectDir: string, pin: ProjectPin): Promise<void>;
+//# sourceMappingURL=projectPin.d.ts.map

package/dist/catalog/projectPin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPin.d.ts","sourceRoot":"","sources":["../../src/catalog/projectPin.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;IAC3B,oFAAoF;;IAEpF,8FAA8F;;IAE9F,wFAAwF;;;;;;;;;;EAExF,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAUnF;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}

package/dist/catalog/projectPin.js

@@ -0,0 +1,39 @@
+// Per-project pin recorded at `services/.gezelligate.json`. Identifies which
+// catalog ref the project was initialized against so subsequent studio/cli
+// runs don't silently upgrade — the user has to opt in via
+// `gezelligate catalog update`.
+import fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+export const ProjectPinSchema = z.object({
+    /** Git ref of the gezelligate/catalog repo (release tag preferred, sha allowed). */
+    catalogRef: z.string().min(1),
+    /** Version of @gezelligate/studio (or cli) that initialized this project. Diagnostic only. */
+    studioVersion: z.string().min(1).optional(),
+    /** Stable random uuid per project. Lets the bridge / analytics distinguish projects. */
+    projectId: z.string().uuid()
+});
+export const PIN_RELATIVE_PATH = "services/.gezelligate.json";
+export async function readProjectPin(projectDir) {
+    const pinPath = path.join(projectDir, PIN_RELATIVE_PATH);
+    let raw;
+    try {
+        raw = await fs.readFile(pinPath, "utf8");
+    }
+    catch (err) {
+        if (isNodeErrnoException(err) && err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+    return ProjectPinSchema.parse(JSON.parse(raw));
+}
+export async function writeProjectPin(projectDir, pin) {
+    const pinPath = path.join(projectDir, PIN_RELATIVE_PATH);
+    await fs.mkdir(path.dirname(pinPath), { recursive: true });
+    const validated = ProjectPinSchema.parse(pin);
+    await fs.writeFile(pinPath, JSON.stringify(validated, null, 2) + "\n", "utf8");
+}
+function isNodeErrnoException(err) {
+    return err instanceof Error && "code" in err;
+}
+//# sourceMappingURL=projectPin.js.map

package/dist/catalog/projectPin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPin.js","sourceRoot":"","sources":["../../src/catalog/projectPin.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,2DAA2D;AAC3D,gCAAgC;AAEhC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,oFAAoF;IACpF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,8FAA8F;IAC9F,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,wFAAwF;IACxF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC7B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACzD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACpE,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB,EAAE,GAAe;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,CAAC;AAC/C,CAAC"}

package/dist/catalog/reader.d.ts

@@ -0,0 +1,44 @@
+import type { ServiceYaml } from "../schema/serviceYaml.js";
+import type { ProviderYaml } from "../schema/providerYaml.js";
+export interface RecipeMeta {
+    name: string;
+    displayName: string;
+    category: string;
+    description: string;
+    required: boolean;
+    hidden?: boolean;
+}
+export interface ProviderMeta {
+    name: string;
+    displayName: string;
+}
+export interface CatalogIndex {
+    recipes: RecipeMeta[];
+    providers: ProviderMeta[];
+    /** Catalog ref (git tag or sha) this index was generated from. */
+    ref: string;
+    /** ISO timestamp of catalog generation. */
+    generatedAt: string;
+}
+/** Templates + manifest for a single recipe, ready to render. */
+export interface RecipeBundle {
+    manifest: ServiceYaml;
+    /** Map of template-path → contents (e.g. "values.yaml.tmpl" → "..."). */
+    templates: Map<string, string>;
+    /** Optional per-recipe assets (e.g. icon.svg). */
+    assets?: Map<string, string>;
+}
+export interface ProviderBundle {
+    manifest: ProviderYaml;
+    templates: Map<string, string>;
+    /** Path to the lifecycle.ts module, suitable for dynamic import. */
+    lifecycleModulePath: string;
+}
+export interface CatalogReader {
+    index(): Promise<CatalogIndex>;
+    listRecipes(): Promise<RecipeMeta[]>;
+    listProviders(): Promise<ProviderMeta[]>;
+    recipe(name: string): Promise<RecipeBundle>;
+    provider(name: string): Promise<ProviderBundle>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/catalog/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/catalog/reader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,yEAAyE;IACzE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kDAAkD;IAClD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACrC,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACjD"}

package/dist/catalog/reader.js

@@ -0,0 +1,7 @@
+// CatalogReader abstraction: a uniform way for studio + cli to read the
+// service-recipe + provider catalog regardless of where it lives (local fs,
+// fetched tarball, lazy fetch). Step 2 introduces the interface only;
+// implementations land in later steps (FsCatalogReader = today's
+// loadRepository + loadProviders, TarballCatalogReader = step 8).
+export {};
+//# sourceMappingURL=reader.js.map

package/dist/catalog/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/catalog/reader.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4EAA4E;AAC5E,sEAAsE;AACtE,iEAAiE;AACjE,kEAAkE"}

package/dist/catalog/tarball.d.ts

@@ -0,0 +1,48 @@
+export declare const DEFAULT_CATALOG_OWNER = "gezelligate";
+export declare const DEFAULT_CATALOG_REPO = "catalog";
+export interface CatalogTarballOptions {
+    /** GitHub org/user that owns the catalog repo. Defaults to "gezelligate". */
+    owner?: string;
+    /** Repo name. Defaults to "catalog". */
+    repo?: string;
+    /** Git ref — release tag preferred, branch name or sha also accepted. */
+    ref: string;
+    /** Destination directory. Contents land directly here (strip-components=1). */
+    destDir: string;
+}
+/** Path layout inside a fetched catalog cache directory. */
+export interface CatalogCachePaths {
+    recipesDir: string;
+    providersDir: string;
+    indexFile: string;
+}
+export declare function catalogCachePaths(destDir: string): CatalogCachePaths;
+/**
+ * Compute the per-project cache directory for a given catalog ref. The Studio
+ * and CLI both write through here so the on-disk shape is identical between
+ * `init` (CLI) and first-run bootstrap (studio).
+ */
+export declare function projectCatalogDir(projectDir: string, ref: string): string;
+/**
+ * Returns true if the cache for `ref` is already populated with a recipes/
+ * subdir. We treat the presence of `recipes/` as the "fully extracted"
+ * marker — any partial fetch would have failed before reaching that step.
+ */
+export declare function catalogCacheExists(projectDir: string, ref: string): Promise<boolean>;
+/**
+ * Fetch a catalog tarball from `https://codeload.github.com/<owner>/<repo>/tar.gz/<ref>`
+ * and extract it into `destDir`. Strips the top-level directory codeload
+ * inserts so contents land directly in `destDir`. Throws on non-2xx, missing
+ * body, or non-zero tar exit.
+ */
+export declare function fetchCatalogTarball(opts: CatalogTarballOptions): Promise<void>;
+/**
+ * Resolve the latest release tag of the catalog repo via GitHub's REST API.
+ * Used by `gezelligate init` when the user doesn't pass `--catalog-ref`.
+ * Cached in memory by callers; we never write the lookup to disk.
+ */
+export declare function resolveLatestCatalogRef(opts?: {
+    owner?: string;
+    repo?: string;
+}): Promise<string>;
+//# sourceMappingURL=tarball.d.ts.map

package/dist/catalog/tarball.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../../src/catalog/tarball.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAMpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1F;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCpF;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB3G"}

package/dist/catalog/tarball.js

@@ -0,0 +1,114 @@
+// Catalog tarball fetcher. Pulls a release of gezelligate/catalog from
+// GitHub's codeload endpoint and extracts it into the per-project cache at
+// `<project>/.gezelligate/catalog/<ref>/`. The destination layout matches
+// the repo layout (recipes/, providers/, catalog.json) so the engine's
+// existing fs-based loaders can read from there directly.
+//
+// We shell out to `tar -xz` rather than depending on a node tar library —
+// tar is present on macOS, Linux, WSL, and Windows 10+. Avoids an npm dep,
+// which matters for studio bundling.
+import fs from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { Readable } from "node:stream";
+export const DEFAULT_CATALOG_OWNER = "gezelligate";
+export const DEFAULT_CATALOG_REPO = "catalog";
+export function catalogCachePaths(destDir) {
+    return {
+        recipesDir: path.join(destDir, "recipes"),
+        providersDir: path.join(destDir, "providers"),
+        indexFile: path.join(destDir, "catalog.json")
+    };
+}
+/**
+ * Compute the per-project cache directory for a given catalog ref. The Studio
+ * and CLI both write through here so the on-disk shape is identical between
+ * `init` (CLI) and first-run bootstrap (studio).
+ */
+export function projectCatalogDir(projectDir, ref) {
+    return path.join(projectDir, ".gezelligate", "catalog", ref);
+}
+/**
+ * Returns true if the cache for `ref` is already populated with a recipes/
+ * subdir. We treat the presence of `recipes/` as the "fully extracted"
+ * marker — any partial fetch would have failed before reaching that step.
+ */
+export async function catalogCacheExists(projectDir, ref) {
+    const { recipesDir } = catalogCachePaths(projectCatalogDir(projectDir, ref));
+    try {
+        const stat = await fs.stat(recipesDir);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fetch a catalog tarball from `https://codeload.github.com/<owner>/<repo>/tar.gz/<ref>`
+ * and extract it into `destDir`. Strips the top-level directory codeload
+ * inserts so contents land directly in `destDir`. Throws on non-2xx, missing
+ * body, or non-zero tar exit.
+ */
+export async function fetchCatalogTarball(opts) {
+    const owner = opts.owner ?? DEFAULT_CATALOG_OWNER;
+    const repo = opts.repo ?? DEFAULT_CATALOG_REPO;
+    const url = `https://codeload.github.com/${owner}/${repo}/tar.gz/${encodeURIComponent(opts.ref)}`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Catalog fetch failed: GET ${url} → ${res.status} ${res.statusText}`);
+    }
+    if (!res.body) {
+        throw new Error(`Catalog fetch returned no body: ${url}`);
+    }
+    await fs.mkdir(opts.destDir, { recursive: true });
+    await new Promise((resolve, reject) => {
+        const tar = spawn("tar", ["-xz", "--strip-components=1", "-C", opts.destDir], {
+            stdio: ["pipe", "inherit", "inherit"]
+        });
+        tar.on("error", (err) => reject(new Error(`tar spawn failed: ${err.message}`)));
+        tar.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`tar exited with code ${code}`));
+        });
+        // Node 20+: fetch body is a Web ReadableStream. Convert to Node Readable
+        // and pipe into tar's stdin. Cast through `never` to satisfy the strict
+        // Node type defs (Readable.fromWeb expects a node:stream/web type).
+        const nodeStream = Readable.fromWeb(res.body);
+        nodeStream.on("error", reject);
+        if (tar.stdin) {
+            nodeStream.pipe(tar.stdin);
+        }
+        else {
+            reject(new Error("tar child had no stdin"));
+        }
+    });
+}
+/**
+ * Resolve the latest release tag of the catalog repo via GitHub's REST API.
+ * Used by `gezelligate init` when the user doesn't pass `--catalog-ref`.
+ * Cached in memory by callers; we never write the lookup to disk.
+ */
+export async function resolveLatestCatalogRef(opts = {}) {
+    const owner = opts.owner ?? DEFAULT_CATALOG_OWNER;
+    const repo = opts.repo ?? DEFAULT_CATALOG_REPO;
+    const url = `https://api.github.com/repos/${owner}/${repo}/releases/latest`;
+    const res = await fetch(url, {
+        headers: { Accept: "application/vnd.github+json", "User-Agent": "gezelligate" }
+    });
+    if (res.status === 404) {
+        // No release yet — fall back to main branch HEAD. Useful before v0.1.0
+        // is tagged.
+        return "main";
+    }
+    if (!res.ok) {
+        throw new Error(`GitHub releases lookup failed: ${res.status} ${res.statusText}`);
+    }
+    const data = (await res.json());
+    if (!data.tag_name) {
+        throw new Error(`GitHub releases response missing tag_name: ${url}`);
+    }
+    return data.tag_name;
+}
+//# sourceMappingURL=tarball.js.map