@synctek/forgeos 2.0.0

package/dist/cli/commands/trust.js

@@ -0,0 +1,261 @@
+/**
+ * `forge trust` — Local trust ledger commands.
+ *
+ * These commands operate ENTIRELY locally — no engine HTTP calls.
+ * They use the src/trust/ modules directly.
+ *
+ * Subcommands:
+ *   forge trust init   [path]                          — generate keypair + create ledger dirs
+ *   forge trust verify [path]                          — verify chain integrity
+ *   forge trust stats  [path]                          — show chain statistics
+ *   forge trust share  [path] [--endpoint <url>]       — transmit shareable metadata
+ *   forge trust config [path]                          — show key configuration
+ */
+import { existsSync, mkdirSync } from "fs";
+import { join, resolve } from "path";
+import { createInterface } from "readline";
+import { KeyManager } from "../../trust/signing.js";
+import { TrustLedger } from "../../trust/ledger.js";
+import { prepareTransmission, generateManifest, generatePlainManifest, sendTransmission, loadAllowedEndpoints, } from "../../trust/transmission.js";
+import { formatTable, formatJSON, formatSuccess, formatWarning, formatError, formatStatus, green, red, } from "../output.js";
+const DEFAULT_TRUST_ENDPOINT = "https://api.forgeos.synctek.io/api/trust/submit";
+/** Resolve the project path: explicit arg → cwd. */
+function resolvePath(pathArg) {
+    return resolve(pathArg ?? process.cwd());
+}
+/** Ask a yes/no question on stdin; returns true for "y"/"yes". */
+async function confirmPrompt(question) {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(`${question} [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+        });
+    });
+}
+export function registerTrustCommands(parent, _client // not used — all trust commands are local
+) {
+    const trust = parent
+        .command("trust")
+        .description("Manage the local trust ledger (local only — no engine)");
+    // -------------------------------------------------------------------------
+    // trust init [path]
+    // -------------------------------------------------------------------------
+    trust
+        .command("init [path]")
+        .description("Generate an Ed25519 keypair and initialise the trust ledger")
+        .option("--json", "Output raw JSON")
+        .action(async (pathArg, opts) => {
+        try {
+            const projectPath = resolvePath(pathArg);
+            const forgeoDir = join(projectPath, ".forgeos");
+            // Create .forgeos/ and .forgeos/keys/ directories
+            mkdirSync(join(forgeoDir, "keys"), { recursive: true });
+            const km = new KeyManager(projectPath);
+            const fingerprint = km.generateKeypair();
+            if (opts.json) {
+                console.log(formatJSON({
+                    project_path: projectPath,
+                    fingerprint,
+                    private_key: km.privateKeyPath,
+                    public_key: km.publicKeyPath,
+                    ledger_path: join(forgeoDir, "ledger.jsonl"),
+                }));
+                return;
+            }
+            console.log(formatSuccess("Trust ledger initialised."));
+            console.log(formatTable(["Field", "Value"], [
+                ["Project Path", projectPath],
+                ["Fingerprint", fingerprint],
+                ["Private Key", km.privateKeyPath],
+                ["Public Key", km.publicKeyPath],
+                ["Ledger", join(forgeoDir, "ledger.jsonl")],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // trust verify [path]
+    // -------------------------------------------------------------------------
+    trust
+        .command("verify [path]")
+        .description("Verify chain integrity of the trust ledger")
+        .option("--json", "Output raw JSON")
+        .action(async (pathArg, opts) => {
+        try {
+            const projectPath = resolvePath(pathArg);
+            const ledger = new TrustLedger(projectPath);
+            const result = ledger.verifyChain();
+            if (opts.json) {
+                console.log(formatJSON(result));
+                return;
+            }
+            if (result.valid) {
+                console.log(formatSuccess(result.message));
+            }
+            else {
+                console.log(formatWarning(result.message));
+                if (result.first_break_at !== null) {
+                    console.log(formatStatus("First break at seq", String(result.first_break_at), "red"));
+                }
+            }
+            console.log(formatTable(["Field", "Value"], [
+                ["Total Entries", String(result.total_entries)],
+                ["Chain Valid", result.valid ? green("yes") : red("no")],
+                ["First Break At", result.first_break_at !== null ? String(result.first_break_at) : "—"],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // trust stats [path]
+    // -------------------------------------------------------------------------
+    trust
+        .command("stats [path]")
+        .description("Show chain statistics for the trust ledger")
+        .option("--json", "Output raw JSON")
+        .action(async (pathArg, opts) => {
+        try {
+            const projectPath = resolvePath(pathArg);
+            const ledger = new TrustLedger(projectPath);
+            const stats = ledger.getChainStats();
+            if (opts.json) {
+                console.log(formatJSON(stats));
+                return;
+            }
+            const byTypeRows = Object.entries(stats.by_type).map(([type, count]) => [
+                type,
+                String(count),
+            ]);
+            console.log(formatTable(["Field", "Value"], [
+                ["Entry Count", String(stats.entry_count)],
+                ["Chain Valid", stats.chain_valid ? green("yes") : red("no")],
+                ["First Entry", stats.first_timestamp ?? "—"],
+                ["Last Entry", stats.last_timestamp ?? "—"],
+                ["Shareable Hash", stats.shareable_chain_hash?.substring(0, 16) ?? "—"],
+            ]));
+            if (byTypeRows.length > 0) {
+                console.log("\nEntries by type:");
+                console.log(formatTable(["Type", "Count"], byTypeRows));
+            }
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // trust share [path]
+    // -------------------------------------------------------------------------
+    trust
+        .command("share [path]")
+        .description("Transmit shareable trust metadata to a ForgeOS hub")
+        .option("--endpoint <url>", "Target endpoint URL", DEFAULT_TRUST_ENDPOINT)
+        .option("--yes", "Skip confirmation prompt (non-interactive)")
+        .option("--json", "Output raw JSON")
+        .action(async (pathArg, opts) => {
+        try {
+            const projectPath = resolvePath(pathArg);
+            const ledger = new TrustLedger(projectPath);
+            const entries = ledger.readEntries();
+            if (entries.length === 0) {
+                console.log(formatWarning("No entries in ledger — nothing to transmit."));
+                return;
+            }
+            const payload = prepareTransmission(entries);
+            const isTTY = process.stdout.isTTY;
+            if (!opts.yes) {
+                // Show manifest
+                if (isTTY) {
+                    console.log(generateManifest(payload, opts.endpoint));
+                }
+                else {
+                    console.log(generatePlainManifest(payload, opts.endpoint));
+                }
+                const confirmed = await confirmPrompt("Proceed with transmission?");
+                if (!confirmed) {
+                    console.log("Transmission cancelled.");
+                    return;
+                }
+            }
+            const result = await sendTransmission(opts.endpoint, payload, projectPath, opts.yes ?? false);
+            if (opts.json) {
+                console.log(formatJSON(result));
+                return;
+            }
+            if (result.status === "sent") {
+                console.log(formatSuccess(`Transmitted ${payload.entry_count} entries. HTTP ${result.http_status}.`));
+            }
+            else {
+                console.log(formatWarning(`Transmission status: ${result.status}`));
+            }
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // trust config [path]
+    // -------------------------------------------------------------------------
+    trust
+        .command("config [path]")
+        .description("Show key configuration and ledger paths")
+        .option("--json", "Output raw JSON")
+        .action(async (pathArg, opts) => {
+        try {
+            const projectPath = resolvePath(pathArg);
+            const km = new KeyManager(projectPath);
+            const forgeoDir = join(projectPath, ".forgeos");
+            const ledgerPath = join(forgeoDir, "ledger.jsonl");
+            const keysExist = existsSync(km.privateKeyPath) && existsSync(km.publicKeyPath);
+            let fingerprint = "—";
+            if (keysExist) {
+                try {
+                    fingerprint = km.getFingerprint();
+                }
+                catch {
+                    fingerprint = "(error reading key)";
+                }
+            }
+            const allowedEndpoints = loadAllowedEndpoints(projectPath);
+            if (opts.json) {
+                console.log(formatJSON({
+                    project_path: projectPath,
+                    keys_exist: keysExist,
+                    fingerprint,
+                    private_key: km.privateKeyPath,
+                    public_key: km.publicKeyPath,
+                    ledger_path: ledgerPath,
+                    ledger_exists: existsSync(ledgerPath),
+                    allowed_endpoints: allowedEndpoints,
+                }));
+                return;
+            }
+            console.log(formatTable(["Field", "Value"], [
+                ["Project Path", projectPath],
+                ["Keys Exist", keysExist ? green("yes") : red("no — run: forge trust init")],
+                ["Fingerprint", fingerprint],
+                ["Private Key", km.privateKeyPath],
+                ["Public Key", km.publicKeyPath],
+                ["Ledger", ledgerPath],
+                ["Ledger Exists", existsSync(ledgerPath) ? green("yes") : "no"],
+                ["Allowed Endpoints", allowedEndpoints.join(", ") || "—"],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=trust.js.map

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

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

package/dist/cli/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * `forge` CLI entry point — ForgeOS v2.0.0
+ *
+ * Engine URL resolution (first match wins):
+ *   1. FORGE_ENGINE_URL environment variable
+ *   2. ~/.forgeos/config.json  →  engine_url field
+ *   3. default: http://localhost:8000
+ *
+ * API key resolution (first match wins):
+ *   1. FORGE_API_KEY environment variable
+ *   2. ~/.forgeos/config.json  →  api_key field
+ *
+ * All command groups delegate to their respective modules in ./commands/.
+ * Trust and score commands are local-only; all others call the engine via
+ * ForgeOSClient (src/shared/client.ts).
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cli/index.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * `forge` CLI entry point — ForgeOS v2.0.0
+ *
+ * Engine URL resolution (first match wins):
+ *   1. FORGE_ENGINE_URL environment variable
+ *   2. ~/.forgeos/config.json  →  engine_url field
+ *   3. default: http://localhost:8000
+ *
+ * API key resolution (first match wins):
+ *   1. FORGE_API_KEY environment variable
+ *   2. ~/.forgeos/config.json  →  api_key field
+ *
+ * All command groups delegate to their respective modules in ./commands/.
+ * Trust and score commands are local-only; all others call the engine via
+ * ForgeOSClient (src/shared/client.ts).
+ */
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { Command } from "commander";
+import { ForgeOSClient } from "../shared/client.js";
+import { registerProjectCommands } from "./commands/project.js";
+import { registerInitiativeCommands } from "./commands/initiative.js";
+import { registerChangesetCommands } from "./commands/changeset.js";
+import { registerGateCommands } from "./commands/gate.js";
+import { registerEvidenceCommands } from "./commands/evidence.js";
+import { registerReviewCommands } from "./commands/review.js";
+import { registerSessionCommands } from "./commands/session.js";
+import { registerMindCommands } from "./commands/mind.js";
+import { registerTrustCommands } from "./commands/trust.js";
+import { registerFederationCommands } from "./commands/federation.js";
+import { registerAnalyzeCommands } from "./commands/analyze.js";
+import { registerScoreCommands } from "./commands/score.js";
+import { registerBuildCommands } from "./commands/build.js";
+import { registerOutcomeCommands } from "./commands/outcome.js";
+function loadConfig() {
+    const configPath = join(homedir(), ".forgeos", "config.json");
+    if (!existsSync(configPath))
+        return {};
+    try {
+        const raw = readFileSync(configPath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+// ---------------------------------------------------------------------------
+// Credential resolution
+// ---------------------------------------------------------------------------
+const config = loadConfig();
+const engineUrl = process.env.FORGE_ENGINE_URL ??
+    config.engine_url ??
+    "http://localhost:8000";
+const apiKey = process.env.FORGE_API_KEY ??
+    config.api_key ??
+    "";
+// ---------------------------------------------------------------------------
+// Build ForgeOSClient shared instance
+// ---------------------------------------------------------------------------
+const client = new ForgeOSClient(engineUrl, apiKey);
+// ---------------------------------------------------------------------------
+// Root program
+// ---------------------------------------------------------------------------
+const program = new Command();
+program
+    .name("forge")
+    .description("ForgeOS CLI — governance, memory, and trust for AI-powered teams")
+    .version("2.0.0")
+    .addHelpText("after", `
+Engine:   ${engineUrl}
+Auth:     ${apiKey ? "API key set" : "no API key (set FORGE_API_KEY or ~/.forgeos/config.json)"}
+`);
+// ---------------------------------------------------------------------------
+// Register all command groups
+// ---------------------------------------------------------------------------
+registerProjectCommands(program, client);
+registerInitiativeCommands(program, client);
+registerChangesetCommands(program, client);
+registerGateCommands(program, client);
+registerEvidenceCommands(program, client);
+registerReviewCommands(program, client);
+registerSessionCommands(program, client);
+registerMindCommands(program, client);
+registerTrustCommands(program, client);
+registerFederationCommands(program, client);
+registerAnalyzeCommands(program, client);
+registerScoreCommands(program, client);
+registerBuildCommands(program, client);
+registerOutcomeCommands(program, client);
+// ---------------------------------------------------------------------------
+// Parse
+// ---------------------------------------------------------------------------
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,uBAAuB,EAAE,MAAS,uBAAuB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAO,yBAAyB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAY,oBAAoB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAQ,wBAAwB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAU,sBAAsB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAS,uBAAuB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAY,oBAAoB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAW,qBAAqB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAS,uBAAuB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAW,qBAAqB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAW,qBAAqB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAS,uBAAuB,CAAC;AAWnE,SAAS,UAAU;IACjB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAE5B,MAAM,SAAS,GACb,OAAO,CAAC,GAAG,CAAC,gBAAgB;IAC5B,MAAM,CAAC,UAAU;IACjB,uBAAuB,CAAC;AAE1B,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,aAAa;IACzB,MAAM,CAAC,OAAO;IACd,EAAE,CAAC;AAEL,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAEpD,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,kEAAkE,CAAC;KAC/E,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CACV,OAAO,EACP;YACQ,SAAS;YACT,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,0DAA0D;CAC9F,CACE,CAAC;AAEJ,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACzC,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC5C,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3C,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtC,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC1C,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACxC,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACzC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtC,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvC,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC5C,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACzC,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvC,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvC,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAEzC,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IACpD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/output.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Terminal output formatting helpers for the `forge` CLI.
+ *
+ * All formatting is done via ANSI escape codes — no external colour libraries.
+ * Respects the NO_COLOR environment variable (https://no-color.org/).
+ */
+import { ForgeAPIError } from "../shared/errors.js";
+export declare const green: (t: string) => string;
+export declare const yellow: (t: string) => string;
+export declare const red: (t: string) => string;
+export declare const cyan: (t: string) => string;
+export declare const bold: (t: string) => string;
+export declare const dim: (t: string) => string;
+/**
+ * Render a table with a header row and data rows.
+ *
+ * Example:
+ *   formatTable(["ID", "Name"], [["abc", "My project"], ["def", "Other"]])
+ *
+ * Produces:
+ *   ┌─────┬────────────┐
+ *   │ ID  │ Name       │
+ *   ├─────┼────────────┤
+ *   │ abc │ My project │
+ *   │ def │ Other      │
+ *   └─────┴────────────┘
+ */
+export declare function formatTable(headers: string[], rows: string[][]): string;
+/** Pretty-print any value as indented JSON. */
+export declare function formatJSON(data: unknown): string;
+/**
+ * A single labelled status line.
+ *
+ * Example:  formatStatus("Status", "active", "green") → "Status: active"  (coloured)
+ */
+export declare function formatStatus(label: string, value: string, color?: string): string;
+/** Green checkmark prefix. */
+export declare function formatSuccess(message: string): string;
+/** Yellow warning prefix. */
+export declare function formatWarning(message: string): string;
+/**
+ * Structured error display.
+ *
+ * For ForgeAPIError: shows HTTP status, detail, context, and suggestion.
+ * For generic Error: shows message.
+ */
+export declare function formatError(error: ForgeAPIError | Error): string;
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAapD,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,WAAkB,CAAC;AAClD,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,WAAkB,CAAC;AACnD,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAAkB,CAAC;AAChD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAAkB,CAAC;AACjD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAAiB,CAAC;AAChD,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAAiB,CAAC;AAqB/C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAuCvE;AAMD,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEhD;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjF;AAMD,8BAA8B;AAC9B,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,6BAA6B;AAC7B,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAkBhE"}

package/dist/cli/output.js

@@ -0,0 +1,139 @@
+/**
+ * Terminal output formatting helpers for the `forge` CLI.
+ *
+ * All formatting is done via ANSI escape codes — no external colour libraries.
+ * Respects the NO_COLOR environment variable (https://no-color.org/).
+ */
+import { ForgeAPIError } from "../shared/errors.js";
+// ---------------------------------------------------------------------------
+// ANSI colour helpers
+// ---------------------------------------------------------------------------
+const NO_COLOR = process.env.NO_COLOR !== undefined;
+function ansi(code, text) {
+    if (NO_COLOR)
+        return text;
+    return `\x1b[${code}m${text}\x1b[0m`;
+}
+export const green = (t) => ansi("32", t);
+export const yellow = (t) => ansi("33", t);
+export const red = (t) => ansi("31", t);
+export const cyan = (t) => ansi("36", t);
+export const bold = (t) => ansi("1", t);
+export const dim = (t) => ansi("2", t);
+// ---------------------------------------------------------------------------
+// Named colour selector (used by formatStatus)
+// ---------------------------------------------------------------------------
+function colorize(text, color) {
+    switch (color) {
+        case "green": return green(text);
+        case "yellow": return yellow(text);
+        case "red": return red(text);
+        case "cyan": return cyan(text);
+        case "bold": return bold(text);
+        default: return text;
+    }
+}
+// ---------------------------------------------------------------------------
+// Table formatter
+// ---------------------------------------------------------------------------
+/**
+ * Render a table with a header row and data rows.
+ *
+ * Example:
+ *   formatTable(["ID", "Name"], [["abc", "My project"], ["def", "Other"]])
+ *
+ * Produces:
+ *   ┌─────┬────────────┐
+ *   │ ID  │ Name       │
+ *   ├─────┼────────────┤
+ *   │ abc │ My project │
+ *   │ def │ Other      │
+ *   └─────┴────────────┘
+ */
+export function formatTable(headers, rows) {
+    const colCount = headers.length;
+    // Compute column widths: max of header width and all row cell widths
+    const widths = headers.map((h) => h.length);
+    for (const row of rows) {
+        for (let i = 0; i < colCount; i++) {
+            const cell = row[i] ?? "";
+            if (cell.length > widths[i])
+                widths[i] = cell.length;
+        }
+    }
+    const pad = (s, w) => s.padEnd(w);
+    const hLine = (left, mid, right, fill) => left + widths.map((w) => fill.repeat(w + 2)).join(mid) + right;
+    const top = hLine("┌", "┬", "┐", "─");
+    const divider = hLine("├", "┼", "┤", "─");
+    const bottom = hLine("└", "┴", "┘", "─");
+    const renderRow = (cells, colorFn) => {
+        const line = "│ " +
+            cells
+                .map((c, i) => pad(c ?? "", widths[i]))
+                .join(" │ ") +
+            " │";
+        return colorFn ? colorFn(line) : line;
+    };
+    const lines = [
+        top,
+        renderRow(headers, bold),
+        divider,
+        ...rows.map((r) => renderRow(r)),
+        bottom,
+    ];
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// JSON formatter
+// ---------------------------------------------------------------------------
+/** Pretty-print any value as indented JSON. */
+export function formatJSON(data) {
+    return JSON.stringify(data, null, 2);
+}
+// ---------------------------------------------------------------------------
+// Status line
+// ---------------------------------------------------------------------------
+/**
+ * A single labelled status line.
+ *
+ * Example:  formatStatus("Status", "active", "green") → "Status: active"  (coloured)
+ */
+export function formatStatus(label, value, color) {
+    return `${bold(label + ":")} ${colorize(value, color)}`;
+}
+// ---------------------------------------------------------------------------
+// Success / warning / error banners
+// ---------------------------------------------------------------------------
+/** Green checkmark prefix. */
+export function formatSuccess(message) {
+    return `${green("✓")} ${message}`;
+}
+/** Yellow warning prefix. */
+export function formatWarning(message) {
+    return `${yellow("⚠")} ${message}`;
+}
+/**
+ * Structured error display.
+ *
+ * For ForgeAPIError: shows HTTP status, detail, context, and suggestion.
+ * For generic Error: shows message.
+ */
+export function formatError(error) {
+    if (error instanceof ForgeAPIError) {
+        const lines = [
+            `${red("✗")} ${bold("Error " + error.status + ":")} ${error.detail}`,
+        ];
+        if (error.context && Object.keys(error.context).length > 0) {
+            lines.push(dim("  Context: " + JSON.stringify(error.context)));
+        }
+        if (error.suggestion) {
+            lines.push(yellow("  Suggestion: " + error.suggestion));
+        }
+        if (error.docsUrl) {
+            lines.push(cyan("  Docs: " + error.docsUrl));
+        }
+        return lines.join("\n");
+    }
+    return `${red("✗")} ${error.message}`;
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC;AAEpD,SAAS,IAAI,CAAC,IAAY,EAAE,IAAY;IACtC,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,QAAQ,IAAI,IAAI,IAAI,SAAS,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAE/C,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAc;IAC5C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO,CAAC,CAAG,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,QAAQ,CAAC,CAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,KAAK,CAAC,CAAK,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,MAAM,CAAC,CAAI,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,MAAM,CAAC,CAAI,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,CAAQ,OAAO,IAAI,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,OAAiB,EAAE,IAAgB;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAEhC,qEAAqE;IACrE,MAAM,MAAM,GAAa,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACvD,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE,CACvE,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAEjE,MAAM,GAAG,GAAM,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAEzC,MAAM,SAAS,GAAG,CAAC,KAAe,EAAE,OAA+B,EAAE,EAAE;QACrE,MAAM,IAAI,GACR,IAAI;YACJ,KAAK;iBACF,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;iBACtC,IAAI,CAAC,KAAK,CAAC;YACd,IAAI,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC,CAAC;IAEF,MAAM,KAAK,GAAa;QACtB,GAAG;QACH,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC;QACxB,OAAO;QACP,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM;KACP,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAa,EAAE,KAAc;IACvE,OAAO,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAE9E,8BAA8B;AAC9B,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAA4B;IACtD,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,MAAM,KAAK,GAAa;YACtB,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE;SACrE,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AACxC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,46 @@
+/**
+ * ForgeOS Engine HTTP client.
+ * Thin wrapper over fetch() that calls the ForgeOS Engine REST API.
+ *
+ * Board Conditions (Engineering Director):
+ * - 10-second timeout per request (AbortController)
+ * - One automatic retry on network errors (fetch failures, not HTTP errors)
+ * - X-ForgeOS-API-Key header when apiKey is provided
+ *
+ * Design note: API key is accepted only as a constructor parameter.
+ * The module-level singleton `client` uses env vars for backward-compat
+ * with the stdio transport. The HTTP transport creates per-request instances
+ * with the key threaded from the Authorization header — no env mutation.
+ */
+export declare class ForgeOSClient {
+    private baseUrl;
+    private apiKey;
+    /**
+     * @param baseUrl  Engine base URL. Defaults to FORGEOS_ENGINE_URL env var or http://localhost:8400.
+     * @param apiKey   API key to send as X-ForgeOS-API-Key. Pass explicitly; do NOT read from env here.
+     */
+    constructor(baseUrl?: string, apiKey?: string);
+    /** Build common headers for every request. */
+    private headers;
+    /**
+     * Core fetch wrapper with timeout and retry.
+     * - Aborts after REQUEST_TIMEOUT_MS via AbortController.
+     * - Retries once on network errors (TypeError from fetch).
+     * - Does NOT retry on HTTP error responses (4xx/5xx) or timeouts.
+     */
+    private fetchWithRetry;
+    /** Parse a non-ok response into a descriptive error. */
+    private throwHttpError;
+    get(path: string, params?: Record<string, string>): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    patch(path: string, body?: unknown): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+}
+/**
+ * Module-level singleton for the stdio transport path.
+ * Reads FORGEOS_API_KEY from env at startup — safe because stdio is
+ * single-tenant (one process = one user). The HTTP transport MUST NOT
+ * use this singleton; it must construct per-request ForgeOSClient instances.
+ */
+export declare const client: ForgeOSClient;
+//# sourceMappingURL=client.d.ts.map