praetom 0.1.0

package/dist/browser.js

@@ -0,0 +1,357 @@
+/**
+ * praetom — client-side customer API.
+ *
+ * Two exports, mirroring /server:
+ *   - register({ ingestId })  — call once at boot (root layout / entry)
+ *   - emit(eventName, payload?) — point-in-time event from business logic
+ *
+ *   // In a Next.js root layout or _app.tsx:
+ *   import { register } from "praetom";
+ *   register({ ingestId: "praetom_..." });  // DSN-style, public OK
+ *
+ *   // Inside a component's interaction handler:
+ *   import { emit } from "praetom";
+ *   <button onClick={() => {
+ *     emit("checkout:button-clicked");
+ *     submit();
+ *   }} />
+ *
+ * Auto-instrumentation: praetom's DB names the components that count
+ * as feature entry points. The praetom/vite (and webpack/rollup
+ * variants to follow) read the same config at build time and inject the
+ * wrap automatically — no source-level feature() calls in customer code.
+ *
+ * v1 internals:
+ *   • No native AsyncLocalStorage → module-level "current feature" stack.
+ *     Safe for single-threaded JS in the common case (one user action =
+ *     one in-flight feature). Concurrent features in true parallel (e.g.
+ *     two Promise.all-ed unrelated wraps) may attribute fetches to
+ *     whichever wrap was entered last; accepted for v1.
+ *   • Wire shape mirrors the server: OTLP/JSON via beacon on page hide,
+ *     or via fetch on interval flush. Same trace context propagation via
+ *     W3C traceparent.
+ */
+const DEFAULT_OTLP_ENDPOINT = "https://praetom.com/api/otlp/v1/traces";
+const DEFAULT_CONFIG_ENDPOINT = "https://praetom.com/api/runtime/config";
+const FLUSH_INTERVAL_MS = 5_000;
+const FLUSH_BATCH_SIZE = 50;
+let _config = null;
+let _featureMap = [];
+const _stack = [];
+let _buffer = [];
+let _flushTimer = null;
+let _fetchPatched = false;
+export async function register(opts) {
+    const silent = opts.silent ?? false;
+    const warn = silent
+        ? () => { }
+        : (msg) => {
+            // eslint-disable-next-line no-console
+            console.warn(`[praetom] ${msg}`);
+        };
+    if (!opts.ingestId) {
+        warn("register() called without ingestId; instrumentation disabled");
+        return;
+    }
+    _config = {
+        ingestId: opts.ingestId,
+        endpoint: opts.endpoint ?? DEFAULT_OTLP_ENDPOINT,
+        configEndpoint: opts.configEndpoint ?? DEFAULT_CONFIG_ENDPOINT,
+        silent,
+    };
+    const repo = resolveRepo(opts.repo);
+    if (!repo) {
+        warn("could not detect repo; pass repo to register() or set data-praetom-repo on <script>");
+        return;
+    }
+    try {
+        const res = await fetch(`${_config.configEndpoint}?repo=${encodeURIComponent(repo)}`, { headers: { authorization: `Bearer ${_config.ingestId}` } });
+        if (!res.ok) {
+            warn(`runtime/config fetch failed: HTTP ${res.status}`);
+            return;
+        }
+        const data = (await res.json());
+        _featureMap = data.features ?? [];
+    }
+    catch (e) {
+        warn(`runtime/config fetch error: ${e.message}`);
+        return;
+    }
+    patchFetch();
+    installFlushHooks();
+}
+function resolveRepo(override) {
+    if (override)
+        return override;
+    if (typeof document !== "undefined") {
+        const el = document.currentScript;
+        if (el?.dataset.praetomRepo)
+            return el.dataset.praetomRepo;
+        const tag = document.querySelector("[data-praetom-repo]");
+        if (tag?.dataset.praetomRepo)
+            return tag.dataset.praetomRepo;
+    }
+    return null;
+}
+/**
+ * Internal — wrap a callback as a feature entry point. NOT a public
+ * export. The bundler plugin (`praetom/vite` and friends)
+ * generates code that calls this around the entry symbols praetom's
+ * DB names. Customer source code does not contain feature() calls.
+ */
+async function feature(slug, fn) {
+    const ctx = {
+        traceId: randHex(16),
+        spanId: randHex(8),
+        slug,
+    };
+    const startMs = Date.now();
+    _stack.push(ctx);
+    try {
+        const result = await fn();
+        record(ctx, null, startMs, false);
+        return result;
+    }
+    catch (e) {
+        record(ctx, null, startMs, true);
+        throw e;
+    }
+    finally {
+        const i = _stack.lastIndexOf(ctx);
+        if (i >= 0)
+            _stack.splice(i, 1);
+    }
+}
+/**
+ * Fire a point-in-time event tagged with the current feature context
+ * if one exists. Use inside component code to mark interactions,
+ * business events, or latency-relevant moments that the entry-point
+ * wrap doesn't capture.
+ */
+export function emit(eventName, payload) {
+    if (!_config)
+        return;
+    const ctx = currentContext();
+    const now = Date.now();
+    const attrs = payload
+        ? Object.fromEntries(Object.entries(payload)
+            .filter(([, v]) => v != null)
+            .map(([k, v]) => [k, typeof v === "string" ? v : JSON.stringify(v)]))
+        : undefined;
+    _buffer.push({
+        featureSlug: ctx?.slug ?? eventName,
+        traceId: ctx?.traceId ?? randHex(16),
+        spanId: randHex(8),
+        parentSpanId: ctx?.spanId ?? null,
+        startMs: now,
+        endMs: now,
+        isError: false,
+        name: eventName,
+        attributes: attrs,
+    });
+    if (_buffer.length >= FLUSH_BATCH_SIZE) {
+        void flushNow();
+        return;
+    }
+    if (!_flushTimer) {
+        _flushTimer = setTimeout(() => {
+            _flushTimer = null;
+            void flushNow();
+        }, FLUSH_INTERVAL_MS);
+    }
+}
+/**
+ * Internal escape hatch for the bundler plugin's generated code. NOT
+ * a public export. Exported under an underscored name so the build-
+ * tool plugin can import it without polluting the customer-facing
+ * surface. May be removed once the plugin codegen stabilizes.
+ */
+export const __praetomFeature = feature;
+/**
+ * Browser counterpart of the server's `__praetomWrapEntryPoint`. Same
+ * shape so the bundler plugin can emit a single `__praetomWrapEntryPoint`
+ * call regardless of build layer; browser ignores `entryName` since
+ * there's no HTTP request context to continue a trace from.
+ */
+export function __praetomWrapEntryPoint(slug, _entryName, original) {
+    const wrapped = function (...args) {
+        return feature(slug, async () => {
+            const result = original.apply(this, args);
+            return result instanceof Promise ? result : Promise.resolve(result);
+        });
+    };
+    Object.defineProperty(wrapped, "name", { value: _entryName });
+    return wrapped;
+}
+function currentContext() {
+    return _stack.length > 0 ? _stack[_stack.length - 1] : null;
+}
+function record(ctx, parentSpanId, startMs, isError) {
+    if (!_config)
+        return;
+    _buffer.push({
+        featureSlug: ctx.slug,
+        traceId: ctx.traceId,
+        spanId: ctx.spanId,
+        parentSpanId,
+        startMs,
+        endMs: Date.now(),
+        isError,
+    });
+    if (_buffer.length >= FLUSH_BATCH_SIZE) {
+        void flushNow();
+        return;
+    }
+    if (!_flushTimer) {
+        _flushTimer = setTimeout(() => {
+            _flushTimer = null;
+            void flushNow();
+        }, FLUSH_INTERVAL_MS);
+    }
+}
+function patchFetch() {
+    if (_fetchPatched)
+        return;
+    if (typeof globalThis.fetch !== "function")
+        return;
+    const original = globalThis.fetch.bind(globalThis);
+    globalThis.fetch = ((input, init) => {
+        const ctx = currentContext();
+        if (!ctx)
+            return original(input, init);
+        const headers = new Headers(init?.headers ?? {});
+        if (!headers.has("traceparent")) {
+            headers.set("traceparent", `00-${ctx.traceId}-${ctx.spanId}-01`);
+        }
+        return original(input, { ...init, headers });
+    });
+    _fetchPatched = true;
+}
+function installFlushHooks() {
+    if (typeof window === "undefined")
+        return;
+    // sendBeacon on page hide is the right primitive for in-flight spans.
+    window.addEventListener("pagehide", () => {
+        flushViaBeacon();
+    });
+    window.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden") {
+            flushViaBeacon();
+        }
+    });
+}
+function flushViaBeacon() {
+    if (!_config)
+        return;
+    if (_buffer.length === 0)
+        return;
+    if (typeof navigator === "undefined" || typeof navigator.sendBeacon !== "function") {
+        void flushNow();
+        return;
+    }
+    const spans = _buffer;
+    _buffer = [];
+    const body = JSON.stringify(encodeOtlp(spans));
+    const blob = new Blob([body], { type: "application/json" });
+    // sendBeacon doesn't let us set Authorization. We pass the ingest ID
+    // as a query parameter for beacon flushes only; the receiver accepts
+    // both header and query forms (handled in a follow-up to the OTLP
+    // route — until that ships, beacon flushes may be dropped at the
+    // edge. flushNow() with fetch+Authorization still works as the
+    // primary path; beacon is the unload fallback.)
+    const url = `${_config.endpoint}?ingest=${encodeURIComponent(_config.ingestId)}`;
+    navigator.sendBeacon(url, blob);
+}
+async function flushNow() {
+    if (!_config)
+        return;
+    if (_buffer.length === 0)
+        return;
+    const spans = _buffer;
+    _buffer = [];
+    const body = encodeOtlp(spans);
+    try {
+        await fetch(_config.endpoint, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${_config.ingestId}`,
+            },
+            body: JSON.stringify(body),
+            keepalive: true,
+        });
+    }
+    catch {
+        // network error — drop, same as server side.
+    }
+}
+function randHex(bytes) {
+    // Web Crypto API is widely supported; fall back to Math.random for
+    // hyper-old environments (tracing IDs only — not cryptographically
+    // sensitive in the DSN-low-trust model).
+    if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+        const arr = new Uint8Array(bytes);
+        crypto.getRandomValues(arr);
+        return [...arr].map((b) => b.toString(16).padStart(2, "0")).join("");
+    }
+    let out = "";
+    for (let i = 0; i < bytes; i++) {
+        out += Math.floor(Math.random() * 256)
+            .toString(16)
+            .padStart(2, "0");
+    }
+    return out;
+}
+function encodeOtlp(spans) {
+    return {
+        resourceSpans: [
+            {
+                scopeSpans: [
+                    {
+                        scope: { name: "praetom", version: "0.4.0" },
+                        spans: spans.map((s) => {
+                            const attrs = [
+                                { key: "praetom.feature", value: { stringValue: s.featureSlug } },
+                            ];
+                            if (s.attributes) {
+                                for (const [k, v] of Object.entries(s.attributes)) {
+                                    attrs.push({ key: k, value: { stringValue: v } });
+                                }
+                            }
+                            return {
+                                traceId: s.traceId,
+                                spanId: s.spanId,
+                                parentSpanId: s.parentSpanId ?? undefined,
+                                name: s.name ?? s.featureSlug,
+                                kind: 3, // SPAN_KIND_CLIENT — browser-initiated
+                                startTimeUnixNano: `${s.startMs}000000`,
+                                endTimeUnixNano: `${s.endMs}000000`,
+                                attributes: attrs,
+                                status: { code: s.isError ? 2 : 1 },
+                            };
+                        }),
+                    },
+                ],
+            },
+        ],
+    };
+}
+/**
+ * Test-only — reset module state between tests.
+ */
+export function _resetForTests() {
+    _config = null;
+    _featureMap = [];
+    _stack.length = 0;
+    _buffer = [];
+    _flushTimer = null;
+    _fetchPatched = false;
+}
+/**
+ * Read the current feature map. Useful for v1.5 bundler-plugin work
+ * where the plugin asks the runtime which paths to wrap.
+ */
+export function getFeatureMap() {
+    return _featureMap;
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/cli/cli.d.ts

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

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

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

package/dist/cli/cli.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { initCommand } from "./commands/init.js";
+import { loginCommand } from "./commands/login.js";
+import { logoutCommand } from "./commands/logout.js";
+import { whoamiCommand } from "./commands/whoami.js";
+import { statusCommand } from "./commands/status.js";
+import { usageCommand } from "./commands/usage.js";
+import { featuresAddCommand, featuresListCommand, featuresShowCommand, } from "./commands/features.js";
+import { rotateCommand } from "./commands/rotate.js";
+import { uninstallCommand } from "./commands/uninstall.js";
+import { discoverCommand } from "./commands/discover.js";
+import { detectAgent } from "./util/agent-env.js";
+import { runCommand } from "./util/run.js";
+const program = new Command();
+program
+    .name("praetom")
+    .description("Install praetom into a repository, manage features, rotate ingest tokens.")
+    .version("0.1.0", "-v, --version")
+    .option("--workspace <slug>", "override the workspace")
+    .option("--repo <owner/name>", "override the repository")
+    .option("--json", "machine-readable output (auto-enabled when invoked from an AI coding agent)")
+    .option("--non-interactive", "fail instead of prompting; for automation");
+program
+    .command("init")
+    .description("Authenticate, connect the current repository, open the install pull request.")
+    .action(() => runCommand(program, initCommand));
+program
+    .command("login")
+    .description("Open a browser to authenticate this terminal session.")
+    .action(() => runCommand(program, loginCommand));
+program
+    .command("logout")
+    .description("Clear the local authentication artifact.")
+    .action(() => runCommand(program, logoutCommand));
+program
+    .command("whoami")
+    .description("Print the currently authenticated user.")
+    .action(() => runCommand(program, whoamiCommand));
+program
+    .command("status")
+    .description("Show the install lifecycle for the current repository.")
+    .action(() => runCommand(program, statusCommand));
+program
+    .command("usage")
+    .description("Workspace usage — span volume, discovery runs, MCP calls.")
+    .action(() => runCommand(program, usageCommand));
+const features = program
+    .command("features")
+    .description("Manage features in this workspace.");
+features
+    .command("list")
+    .description("List features defined in the workspace.")
+    .action(() => runCommand(program, featuresListCommand));
+features
+    .command("add <name>")
+    .description("Create a feature; opens an editor for the description.")
+    .action((name) => runCommand(program, (ctx) => featuresAddCommand(ctx, name)));
+features
+    .command("show <slug>")
+    .description("Full detail for a feature.")
+    .action((slug) => runCommand(program, (ctx) => featuresShowCommand(ctx, slug)));
+program
+    .command("rotate")
+    .description("Rotate the per-repository ingest token; opens a pull request swapping it in.")
+    .action(() => runCommand(program, rotateCommand));
+program
+    .command("uninstall")
+    .description("Open a pull request removing praetom wiring; revoke the per-repository token.")
+    .action(() => runCommand(program, uninstallCommand));
+program
+    .command("discover")
+    .description("Run feature discovery on the current repository.")
+    .action(() => runCommand(program, discoverCommand));
+// Agent auto-detection: flip --json on by default when running inside one of
+// the known AI coding agents, so the agent gets parseable output without the
+// user having to pass the flag.
+const agent = detectAgent();
+if (agent) {
+    const opts = program.opts();
+    if (opts["json"] === undefined)
+        opts["json"] = true;
+    if (opts["nonInteractive"] === undefined)
+        opts["nonInteractive"] = true;
+}
+program.parseAsync(process.argv).catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    const opts = program.opts();
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ ok: false, error: msg }) + "\n");
+    }
+    else {
+        process.stderr.write(`praetom: ${msg}\n`);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

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

package/dist/cli/commands/discover.d.ts

@@ -0,0 +1,3 @@
+import type { RunContext } from "../util/run.js";
+export declare function discoverCommand(ctx: RunContext): void;
+//# sourceMappingURL=discover.d.ts.map

package/dist/cli/commands/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/discover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAerD"}

package/dist/cli/commands/discover.js

@@ -0,0 +1,15 @@
+export function discoverCommand(ctx) {
+    const message = "praetom discover isn't implemented yet (v0.1). " +
+        "Run discovery via your AI coding agent today: praetom's MCP plugin exposes " +
+        "`start_discovery` and `accept_discovery_candidates`. From Claude Code, that " +
+        "looks like: `@praetom map this repository` then `accept all` once the " +
+        "candidates list streams in.";
+    if (ctx.json) {
+        process.stdout.write(JSON.stringify({ ok: false, error: "not_implemented", command: "discover" }) + "\n");
+    }
+    else {
+        process.stderr.write(`${message}\n`);
+    }
+    process.exit(2);
+}
+//# sourceMappingURL=discover.js.map

package/dist/cli/commands/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/cli/commands/discover.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,GAAe;IAC7C,MAAM,OAAO,GACX,iDAAiD;QACjD,6EAA6E;QAC7E,8EAA8E;QAC9E,wEAAwE;QACxE,6BAA6B,CAAC;IAChC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CACpF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/cli/commands/features.d.ts

@@ -0,0 +1,5 @@
+import type { RunContext } from "../util/run.js";
+export declare function featuresListCommand(ctx: RunContext): Promise<void>;
+export declare function featuresShowCommand(ctx: RunContext, slug: string): Promise<void>;
+export declare function featuresAddCommand(ctx: RunContext, name: string): Promise<void>;
+//# sourceMappingURL=features.d.ts.map

package/dist/cli/commands/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/features.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAkCjD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BxE;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/cli/commands/features.js

@@ -0,0 +1,83 @@
+import { createInterface } from "node:readline/promises";
+import { apiRequest, workspaceQuery } from "../util/api.js";
+export async function featuresListCommand(ctx) {
+    const res = await apiRequest("/api/cli/features", {
+        query: workspaceQuery(ctx),
+    });
+    if (ctx.json) {
+        process.stdout.write(JSON.stringify(res) + "\n");
+        return;
+    }
+    if (res.count === 0) {
+        process.stdout.write(`No features in ${res.workspaceSlug} yet.\n`);
+        return;
+    }
+    process.stdout.write(`${res.count} feature(s) in ${res.workspaceSlug}:\n\n`);
+    for (const f of res.features) {
+        const tags = [];
+        if (f.instrumentationScore)
+            tags.push(`${Math.round(f.instrumentationScore.score * 100)}% instrumented`);
+        if (f.activitySignal?.commits_30d != null)
+            tags.push(`${f.activitySignal.commits_30d} commits/30d`);
+        if (f.criticVerdict)
+            tags.push(f.criticVerdict);
+        process.stdout.write(`  ${f.slug.padEnd(28)} ${f.event}\n`);
+        if (tags.length > 0)
+            process.stdout.write(`  ${" ".repeat(28)} ${tags.join(" · ")}\n`);
+    }
+}
+export async function featuresShowCommand(ctx, slug) {
+    const res = await apiRequest(`/api/cli/features/${encodeURIComponent(slug)}`, { query: workspaceQuery(ctx) });
+    if (ctx.json) {
+        process.stdout.write(JSON.stringify(res) + "\n");
+        return;
+    }
+    const f = res.feature;
+    process.stdout.write(`${f.slug}  (workspace: ${res.workspaceSlug})\n` +
+        `${"─".repeat(60)}\n\n` +
+        `${f.plainEnglish}\n\n` +
+        `created  ${f.createdAt}\n` +
+        (f.signalsRefreshedAt ? `signals  ${f.signalsRefreshedAt}\n` : "") +
+        (f.criticVerdict ? `verdict  ${f.criticVerdict}\n` : "") +
+        (f.criticCritique ? `\ncritique:\n  ${f.criticCritique}\n` : ""));
+}
+export async function featuresAddCommand(ctx, name) {
+    const slug = name.trim().toLowerCase();
+    if (!/^[a-z][a-z0-9-_]*$/.test(slug)) {
+        fail(ctx, "slug must start with a letter and contain only lowercase letters, digits, hyphens, or underscores");
+    }
+    if (ctx.nonInteractive) {
+        fail(ctx, "praetom features add: --non-interactive set; cannot prompt for description. Use the dashboard for now.");
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    process.stdout.write(`Creating feature \`${slug}\`. Press enter to skip optional fields.\n\n`);
+    const event = (await rl.question("Event (one sentence — what happens): ")).trim();
+    if (!event) {
+        rl.close();
+        fail(ctx, "event is required");
+    }
+    const description = (await rl.question("Description (optional): ")).trim();
+    const healthy = (await rl.question("Healthy (optional): ")).trim();
+    const incident = (await rl.question("Incident (optional): ")).trim();
+    rl.close();
+    const result = await apiRequest("/api/cli/features", {
+        method: "POST",
+        body: { slug, event, description, healthy, incident },
+        query: workspaceQuery(ctx),
+    });
+    if (ctx.json) {
+        process.stdout.write(JSON.stringify(result) + "\n");
+        return;
+    }
+    process.stdout.write(`\nCreated feature \`${result.slug}\`.\n`);
+}
+function fail(ctx, message) {
+    if (ctx.json) {
+        process.stdout.write(JSON.stringify({ ok: false, error: message }) + "\n");
+    }
+    else {
+        process.stderr.write(`${message}\n`);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=features.js.map

package/dist/cli/commands/features.js.map

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

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { RunContext } from "../util/run.js";
+export declare function initCommand(ctx: RunContext): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYjD,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDhE"}