@synctek/forgeos 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SyncTek LLC
+
+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,386 @@
+# @synctek/forgeos-mcp
+
+MCP server that connects Claude Code (and any MCP-compatible AI agent) to the
+[ForgeOS](https://synctek.io/forgeos) governance engine.
+
+ForgeOS enforces structured software development through gates, initiatives,
+and quality reviews. This server exposes the ForgeOS engine as 12 typed MCP
+tools so your AI agent can create initiatives, propose changesets, submit
+evidence, run structured reviews, promote gates, and query institutional
+knowledge — all from within a single Claude Code session.
+
+---
+
+## Quick Start (stdio — recommended for Claude Code)
+
+No install required:
+
+```bash
+npx -y @synctek/forgeos-mcp
+```
+
+Set your API key and engine URL before running:
+
+```bash
+FORGEOS_API_KEY=your-key FORGEOS_ENGINE_URL=https://api.synctek.io npx -y @synctek/forgeos-mcp
+```
+
+---
+
+## Claude Desktop Integration
+
+Add to your `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`):
+
+```json
+{
+  "mcpServers": {
+    "forgeos": {
+      "command": "npx",
+      "args": ["-y", "@synctek/forgeos-mcp"],
+      "env": {
+        "FORGEOS_API_KEY": "your-api-key-here",
+        "FORGEOS_ENGINE_URL": "https://api.synctek.io"
+      }
+    }
+  }
+}
+```
+
+For Claude Code (`~/.claude/mcp.json` or project-level `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "forgeos": {
+      "command": "npx",
+      "args": ["-y", "@synctek/forgeos-mcp"],
+      "env": {
+        "FORGEOS_API_KEY": "your-api-key-here",
+        "FORGEOS_ENGINE_URL": "https://api.synctek.io"
+      }
+    }
+  }
+}
+```
+
+---
+
+## HTTP/SSE Mode
+
+For remote deployments or multi-tenant scenarios, run the HTTP server instead
+of stdio. Each request carries its own Bearer token — no shared state between
+callers.
+
+```bash
+# Start the HTTP server (default port 8401)
+npx -y @synctek/forgeos-mcp forgeos-mcp-http
+
+# Or after installing globally:
+npm install -g @synctek/forgeos-mcp
+forgeos-mcp-http
+```
+
+### Endpoints
+
+| Method   | Path      | Description                              |
+|----------|-----------|------------------------------------------|
+| `POST`   | `/mcp`    | StreamableHTTP main channel (JSON-RPC)   |
+| `GET`    | `/mcp`    | SSE fallback (server-to-client events)   |
+| `DELETE` | `/mcp`    | Session cleanup                          |
+| `GET`    | `/health` | Liveness probe — no auth required        |
+
+### Calling the HTTP endpoint
+
+```bash
+# Health check
+curl http://localhost:8401/health
+
+# MCP request with Bearer token
+curl -X POST http://localhost:8401/mcp \
+  -H "Authorization: Bearer your-api-key" \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
+```
+
+### Connecting an MCP client to the HTTP endpoint
+
+```json
+{
+  "mcpServers": {
+    "forgeos": {
+      "transport": "http",
+      "url": "http://localhost:8401/mcp",
+      "headers": {
+        "Authorization": "Bearer your-api-key"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Configuration
+
+| Environment Variable   | Default                  | Description                                         |
+|------------------------|--------------------------|-----------------------------------------------------|
+| `FORGEOS_API_KEY`      | _(empty)_                | API key sent as `X-ForgeOS-API-Key` header          |
+| `FORGEOS_ENGINE_URL`   | `http://localhost:8400`  | Base URL of the ForgeOS engine                      |
+| `MCP_HTTP_PORT`        | `8401`                   | Port for the HTTP/SSE server                        |
+| `RATE_LIMIT_MAX`       | `60`                     | Max requests per window (HTTP mode)                 |
+| `RATE_LIMIT_WINDOW_MS` | `60000`                  | Rate limit window in milliseconds (HTTP mode)       |
+
+---
+
+## Tools Reference
+
+All tools return JSON. Errors surface as `{ "ok": false, "error": "..." }`.
+
+### `forge_init`
+
+Initialize a ForgeOS governance session. Returns project state, active work,
+governance rules, and workflow runbook. Call on every session start.
+
+| Parameter      | Type     | Required | Description                      |
+|----------------|----------|----------|----------------------------------|
+| `project_id`   | `string` | Yes      | Project to initialize            |
+| `developer_id` | `string` | No       | Developer identifier (default: `local`) |
+
+---
+
+### `forge_create_initiative`
+
+Create a new initiative to track a piece of work. Returns the initiative with
+a generated ID.
+
+| Parameter     | Type     | Required | Description                             |
+|---------------|----------|----------|-----------------------------------------|
+| `project_id`  | `string` | Yes      | Project ID                              |
+| `title`       | `string` | Yes      | Initiative title                        |
+| `description` | `string` | Yes      | What this initiative accomplishes       |
+| `priority`    | `string` | No       | `low` \| `medium` \| `high` \| `critical` (default: `medium`) |
+
+---
+
+### `forge_propose_changeset`
+
+Propose a changeset for an initiative. The engine computes a risk score and
+determines required gates, reviewer roles, and evidence. Returns the changeset
+with a full gate pipeline.
+
+| Parameter          | Type       | Required | Description                        |
+|--------------------|------------|----------|------------------------------------|
+| `project_id`       | `string`   | Yes      | Project ID                         |
+| `initiative_id`    | `string`   | Yes      | Parent initiative                  |
+| `description`      | `string`   | Yes      | What changed and why               |
+| `files_changed`    | `string[]` | Yes      | File paths that changed            |
+| `modules_affected` | `string[]` | Yes      | Module/area names affected         |
+| `branch`           | `string`   | No       | Git branch name                    |
+
+---
+
+### `forge_get_profile`
+
+Fetch a reviewer persona profile for subagent injection. When a `project_id`
+is provided, the profile is enriched with Shared Mind patterns from prior
+reviews. Use the returned `system_prompt` as the subagent's instructions.
+
+| Parameter          | Type       | Required | Description                                             |
+|--------------------|------------|----------|---------------------------------------------------------|
+| `role`             | `string`   | Yes      | `architect` \| `qa_test` \| `security` \| `performance` \| `reliability` \| `accessibility` \| `docs_release` |
+| `project_id`       | `string`   | No       | Project for contextualization                           |
+| `team_id`          | `string`   | No       | Team ID for Shared Mind context (default: `default`)    |
+| `modules_affected` | `string[]` | No       | Modules to focus on                                     |
+| `files_changed`    | `string[]` | No       | Files to focus on                                       |
+
+---
+
+### `forge_submit_evidence`
+
+Submit evidence (test results, scan outputs, etc.) for a changeset.
+Auto-populates gate evidence requirements.
+
+| Parameter      | Type       | Required | Description                                                                                   |
+|----------------|------------|----------|-----------------------------------------------------------------------------------------------|
+| `project_id`   | `string`   | Yes      | Project ID                                                                                    |
+| `changeset_id` | `string`   | Yes      | Changeset ID                                                                                  |
+| `type`         | `string`   | Yes      | `unit_test` \| `coverage` \| `lint` \| `security_scan` \| `benchmark` \| `migration_plan` \| `ux_snapshot` \| `a11y_audit` \| `ai_review` |
+| `summary`      | `string`   | Yes      | Summary of the evidence                                                                       |
+| `file_refs`    | `string[]` | No       | File references                                                                               |
+
+---
+
+### `forge_submit_review`
+
+Submit a complete review with findings and verdict. Creates and finalizes the
+review in one call.
+
+| Parameter      | Type       | Required | Description                                   |
+|----------------|------------|----------|-----------------------------------------------|
+| `project_id`   | `string`   | Yes      | Project ID                                    |
+| `changeset_id` | `string`   | Yes      | Changeset ID                                  |
+| `role`         | `string`   | Yes      | Reviewer role (e.g. `security`, `architect`)  |
+| `status`       | `string`   | Yes      | `approved` \| `blocked` \| `pending`          |
+| `notes`        | `string`   | Yes      | Review summary                                |
+| `findings`     | `object[]` | Yes      | Structured findings (see below)               |
+
+Each finding in `findings`:
+
+| Field            | Type     | Required | Description                                    |
+|------------------|----------|----------|------------------------------------------------|
+| `category`       | `string` | Yes      | Finding category                               |
+| `severity`       | `string` | Yes      | `pass` \| `warning` \| `concern` \| `fail`    |
+| `observation`    | `string` | Yes      | What was observed                              |
+| `recommendation` | `string` | No       | Suggested fix                                  |
+
+---
+
+### `forge_check_gates`
+
+Get the gate pipeline status for a changeset. Shows which gates are passed,
+pending, or failed, and what is needed to advance.
+
+| Parameter      | Type     | Required | Description    |
+|----------------|----------|----------|----------------|
+| `project_id`   | `string` | Yes      | Project ID     |
+| `changeset_id` | `string` | Yes      | Changeset ID   |
+
+---
+
+### `forge_promote_gate`
+
+Promote a gate to passed status. All requirements (evidence + reviews) must be
+satisfied. Advances the pipeline to the next gate.
+
+| Parameter      | Type     | Required | Description                                                                                     |
+|----------------|----------|----------|-------------------------------------------------------------------------------------------------|
+| `project_id`   | `string` | Yes      | Project ID                                                                                      |
+| `changeset_id` | `string` | Yes      | Changeset ID                                                                                    |
+| `gate_id`      | `string` | Yes      | `intent` \| `design` \| `implementation` \| `verification` \| `hardening` \| `release`         |
+| `promoted_by`  | `string` | No       | Who is promoting (default: `local_agent`)                                                       |
+
+---
+
+### `forge_release_check`
+
+Check if a changeset is ready to release. Returns `can_release` status and any
+remaining blockers.
+
+| Parameter      | Type     | Required | Description    |
+|----------------|----------|----------|----------------|
+| `project_id`   | `string` | Yes      | Project ID     |
+| `changeset_id` | `string` | Yes      | Changeset ID   |
+
+---
+
+### `forge_query_mind`
+
+Search the Shared Mind for institutional knowledge. Returns patterns,
+anti-patterns, and lessons relevant to the given context.
+
+| Parameter | Type     | Required | Description                              |
+|-----------|----------|----------|------------------------------------------|
+| `context` | `string` | Yes      | Search context (keywords, module names)  |
+| `team_id` | `string` | No       | Team ID (default: `default`)             |
+| `domain`  | `string` | No       | Specific domain to search                |
+
+---
+
+### `forge_observe`
+
+Record an observation to the Shared Mind. Use when you discover patterns,
+anti-patterns, or lessons during development.
+
+| Parameter          | Type       | Required | Description                                                                     |
+|--------------------|------------|----------|---------------------------------------------------------------------------------|
+| `domain`           | `string`   | Yes      | Knowledge domain (e.g. module name, technology)                                 |
+| `observation_type` | `string`   | Yes      | `pattern` \| `anti-pattern` \| `fix-recipe` \| `architecture-decision` \| `lesson` |
+| `content`          | `string`   | Yes      | What was observed                                                               |
+| `team_id`          | `string`   | No       | Team ID (default: `default`)                                                    |
+| `confidence`       | `number`   | No       | Confidence 0.0–1.0 (default: `0.8`)                                             |
+| `tags`             | `string[]` | No       | Tags for categorization                                                         |
+
+---
+
+### `forge_get_workflow`
+
+Get the current workflow state for an initiative. Shows which step the
+developer is on, what is needed next, and overall progress.
+
+| Parameter       | Type     | Required | Description    |
+|-----------------|----------|----------|----------------|
+| `initiative_id` | `string` | Yes      | Initiative ID  |
+
+---
+
+## Typical Workflow
+
+```
+forge_init             → bootstrap session, get runbook
+forge_create_initiative → create initiative, get initiative_id
+forge_propose_changeset → propose work, engine computes risk + gates
+forge_get_profile       → fetch reviewer persona (optional: enrich with Shared Mind)
+  (run subagent review using returned system_prompt)
+forge_submit_evidence   → upload test results, scan output, etc.
+forge_submit_review     → record reviewer verdict + findings
+forge_check_gates       → inspect gate pipeline status
+forge_promote_gate      → advance gates as evidence accumulates
+forge_release_check     → confirm all gates cleared before shipping
+forge_observe           → record lessons learned back to Shared Mind
+```
+
+---
+
+## Security
+
+- **Per-request auth isolation** — the HTTP server creates a new `ForgeOSClient`
+  per request, threaded from the `Authorization: Bearer <key>` header.
+  `process.env` is never mutated and there is no shared singleton across requests.
+- **Rate limiting** — token-bucket per API key (or IP fallback).
+  Default: 60 requests per 60-second window. Configurable via `RATE_LIMIT_MAX`
+  and `RATE_LIMIT_WINDOW_MS`.
+- **No credential leakage** — stdio mode reads `FORGEOS_API_KEY` from env once
+  at startup (single-tenant). HTTP mode never touches env for key resolution.
+- **CORS** — all origins allowed by default (clients are local AI agents).
+  Restrict in production by configuring a reverse proxy.
+
+---
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/synctek/forgeos-mcp
+cd forgeos-mcp
+npm install
+
+# Run stdio server in dev mode (tsx, no build required)
+npm run dev
+
+# Run HTTP server in dev mode
+npm run dev:http
+
+# Build
+npm run build
+
+# Run built stdio server
+npm start
+
+# Run built HTTP server
+npm run start:http
+```
+
+---
+
+## Links
+
+- Product: [synctek.io/forgeos](https://synctek.io/forgeos)
+- Docs: [docs.synctek.io/forgeos](https://docs.synctek.io/forgeos)
+- Issues: [github.com/synctek/forgeos-mcp/issues](https://github.com/synctek/forgeos-mcp/issues)
+- npm: [@synctek/forgeos-mcp](https://www.npmjs.com/package/@synctek/forgeos-mcp)
+
+---
+
+## License
+
+MIT

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

@@ -0,0 +1,14 @@
+/**
+ * `forge analyze` — Local analysis entry point.
+ *
+ * Subcommands:
+ *   forge analyze [path] [--init]      — initialise keys (--init) or run analysis
+ *   forge analyze [path] --project <pid> — submit analysis to engine
+ *
+ * If --init: initialises the local keypair + ledger directories.
+ * Otherwise: POSTs analysis request to engine, or hints to install forgeos-analysis.
+ */
+import { Command } from "commander";
+import { ForgeOSClient } from "../../shared/client.js";
+export declare function registerAnalyzeCommands(parent: Command, client: ForgeOSClient): void;
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAWvD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa,GACpB,IAAI,CA4GN"}

package/dist/cli/commands/analyze.js

@@ -0,0 +1,94 @@
+/**
+ * `forge analyze` — Local analysis entry point.
+ *
+ * Subcommands:
+ *   forge analyze [path] [--init]      — initialise keys (--init) or run analysis
+ *   forge analyze [path] --project <pid> — submit analysis to engine
+ *
+ * If --init: initialises the local keypair + ledger directories.
+ * Otherwise: POSTs analysis request to engine, or hints to install forgeos-analysis.
+ */
+import { mkdirSync } from "fs";
+import { join, resolve } from "path";
+import { KeyManager } from "../../trust/signing.js";
+import { formatTable, formatJSON, formatSuccess, formatWarning, formatError, } from "../output.js";
+export function registerAnalyzeCommands(parent, client) {
+    parent
+        .command("analyze [path]")
+        .description("Analyse a project: initialise keys (--init) or submit to engine")
+        .option("--init", "Initialise local keypair and .forgeos directory structure")
+        .option("-p, --project <pid>", "Project ID (for engine-based analysis)")
+        .option("--json", "Output raw JSON")
+        .action(async (pathArg, opts) => {
+        const projectPath = resolve(pathArg ?? process.cwd());
+        // ------------------------------------------------------------------
+        // --init: generate keys + create directory structure
+        // ------------------------------------------------------------------
+        if (opts.init) {
+            try {
+                const forgeoDir = join(projectPath, ".forgeos");
+                mkdirSync(join(forgeoDir, "keys"), { recursive: true });
+                const km = new KeyManager(projectPath);
+                const fingerprint = km.generateKeypair();
+                if (opts.json) {
+                    console.log(formatJSON({
+                        initialized: true,
+                        project_path: projectPath,
+                        fingerprint,
+                        private_key: km.privateKeyPath,
+                        public_key: km.publicKeyPath,
+                    }));
+                    return;
+                }
+                console.log(formatSuccess("Project initialised."));
+                console.log(formatTable(["Field", "Value"], [
+                    ["Path", projectPath],
+                    ["Fingerprint", fingerprint],
+                    ["Private Key", km.privateKeyPath],
+                    ["Public Key", km.publicKeyPath],
+                ]));
+                console.log("\nNext steps:\n" +
+                    "  forge analyze [path]            — run analysis via engine\n" +
+                    "  pip install forgeos-analysis    — run local ruff/AST analysis\n" +
+                    "  forge trust verify [path]       — verify chain integrity\n");
+            }
+            catch (err) {
+                console.error(formatError(err));
+                process.exit(1);
+            }
+            return;
+        }
+        // ------------------------------------------------------------------
+        // Engine-based analysis
+        // ------------------------------------------------------------------
+        if (opts.project) {
+            try {
+                const data = await client.post(`/api/projects/${opts.project}/analyze`, { path: projectPath });
+                if (opts.json) {
+                    console.log(formatJSON(data));
+                    return;
+                }
+                console.log(formatSuccess("Analysis submitted."));
+                console.log(formatJSON(data));
+            }
+            catch (err) {
+                console.error(formatError(err));
+                process.exit(1);
+            }
+            return;
+        }
+        // ------------------------------------------------------------------
+        // Local analysis hint (no engine, no --init)
+        // ------------------------------------------------------------------
+        console.log(formatWarning("No --project specified. To run local ruff/AST analysis:\n\n" +
+            "  pip install forgeos-analysis\n" +
+            "  forgeos-analysis " +
+            projectPath +
+            "\n\n" +
+            "Or submit to the ForgeOS engine:\n\n" +
+            "  forge analyze " +
+            pathArg +
+            " --project <pid>"));
+    });
+}
+//# sourceMappingURL=analyze.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * `forge build` — Build and delivery commands.
+ *
+ * Subcommands:
+ *   forge build start  --project <pid> --changeset <cid>
+ *   forge build status --project <pid> --changeset <cid>
+ */
+import { Command } from "commander";
+import { ForgeOSClient } from "../../shared/client.js";
+export declare function registerBuildCommands(parent: Command, client: ForgeOSClient): void;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA6BvD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa,GACpB,IAAI,CAuFN"}

package/dist/cli/commands/build.js

@@ -0,0 +1,86 @@
+/**
+ * `forge build` — Build and delivery commands.
+ *
+ * Subcommands:
+ *   forge build start  --project <pid> --changeset <cid>
+ *   forge build status --project <pid> --changeset <cid>
+ */
+import { formatTable, formatJSON, formatSuccess, formatError, formatStatus, green, yellow, red, } from "../output.js";
+function buildStatusColor(status) {
+    const s = status.toLowerCase();
+    if (s === "success" || s === "complete" || s === "passed")
+        return green(status);
+    if (s === "running" || s === "pending")
+        return yellow(status);
+    if (s === "failed" || s === "error")
+        return red(status);
+    return status;
+}
+export function registerBuildCommands(parent, client) {
+    const build = parent
+        .command("build")
+        .description("Trigger and monitor changeset builds");
+    // -------------------------------------------------------------------------
+    // build start
+    // -------------------------------------------------------------------------
+    build
+        .command("start")
+        .description("Start a build for a changeset")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .requiredOption("--changeset <cid>", "Changeset ID")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = (await client.post(`/api/projects/${opts.project}/changesets/${opts.changeset}/build`));
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatSuccess("Build started."));
+            console.log(formatTable(["Field", "Value"], [
+                ["Build ID", data.build_id ?? "—"],
+                ["Status", buildStatusColor(data.status ?? "pending")],
+                ["Started At", data.started_at ?? "—"],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // build status
+    // -------------------------------------------------------------------------
+    build
+        .command("status")
+        .description("Check build status for a changeset")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .requiredOption("--changeset <cid>", "Changeset ID")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = (await client.get(`/api/projects/${opts.project}/changesets/${opts.changeset}/build`));
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const status = data.status ?? "unknown";
+            console.log(formatStatus("Build status", buildStatusColor(status)));
+            console.log(formatTable(["Field", "Value"], [
+                ["Build ID", data.build_id ?? "—"],
+                ["Status", buildStatusColor(status)],
+                ["Started At", data.started_at ?? "—"],
+                ["Completed At", data.completed_at ?? "—"],
+            ]));
+            if (data.logs) {
+                console.log("\nBuild logs:");
+                console.log(data.logs);
+            }
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=build.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * `forge changeset` — Changeset operations.
+ *
+ * Subcommands:
+ *   forge changeset propose  --project <pid> --description <desc> [--modules m1,m2] [--files f1,f2]
+ *   forge changeset list     --project <pid>
+ *   forge changeset show     --project <pid> <id>
+ *   forge changeset warnings --project <pid> <id>
+ */
+import { Command } from "commander";
+import { ForgeOSClient } from "../../shared/client.js";
+export declare function registerChangesetCommands(parent: Command, client: ForgeOSClient): void;
+//# sourceMappingURL=changeset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changeset.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/changeset.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAYvD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa,GACpB,IAAI,CAuNN"}