@macula-io/mcp 0.3.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Hecate contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,192 @@
+# macula-mcp
+
+[![CI](https://img.shields.io/github/actions/workflow/status/macula-io/macula-mcp/ci.yml?branch=main&label=CI)](https://github.com/macula-io/macula-mcp/actions/workflows/ci.yml)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](#license)
+[![Node](https://img.shields.io/badge/node-20%2B-339933?logo=node.js&logoColor=white)](https://nodejs.org)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow.svg)](https://buymeacoffee.com/rlefever)
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/macula-mcp-full-dark.svg">
+    <img src="assets/macula-mcp-full-light.svg" alt="Macula MCP" width="320">
+  </picture>
+</p>
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that
+exposes the Macula mesh to any agent harness: Claude Code, Cursor, Cline,
+Continue, and anything else that speaks MCP.
+
+```jsonc
+// .mcp.json (or your harness's MCP config)
+{
+  "mcpServers": {
+    "macula": { "command": "macula-mcp" }
+  }
+}
+```
+
+## What it is
+
+The 2026 equivalent of "an editor plugin" is an MCP server: editor- and
+harness-agnostic, agent-native. `macula-mcp` is deliberately thin — it does
+**not** speak QUIC, DHT, or Macula RPC itself. It speaks MCP over stdio to
+the agent, and shells out to
+[`macula-cli`](https://github.com/macula-io/macula-cli), a one-shot
+scriptable CLI built directly on `macula-go-sdk`, for every mesh operation.
+`macula-cli` does the actual QUIC handshake/call/publish/watch/content
+transfer as a subprocess per tool call; `macula-mcp` carries no mesh logic
+of its own.
+
+```
+┌───────────────┐   MCP/stdio   ┌────────────┐  spawns, parses stdout  ┌────────────┐   QUIC    ┌──────────────┐
+│ agent harness │ ────────────▶ │ macula-mcp │ ──────────────────────▶ │ macula-cli │ ─────────▶│ Macula mesh  │
+└───────────────┘               └────────────┘                        └────────────┘           └──────────────┘
+```
+
+**Reworked 2026-08-29** from an earlier design that proxied to a local
+`hecate-daemon` over a Unix socket. `hecate-daemon` is a leftover of an
+abandoned local browser/UI plan and is no longer something this server
+depends on. This is a deliberately **lean** rework, not a like-for-like
+swap: `macula-cli` is a one-shot process with no daemon and no storage, so
+a few things the daemon-backed version had don't carry over — see
+[Status](#status).
+
+## Why a mesh-MCP at all
+
+As agents do more of the typing, the scarce resources stop being "code
+completion" and become **federated shared memory** and **cross-party agent
+coordination** — exactly what Macula provides and what a centralised,
+US-owned AI coding tool structurally cannot. `mesh_call`/`mesh_publish`/
+`mesh_watch`/`mesh_put`/`mesh_get` let an agent reach a peer's advertised
+capability, emit a fact other parties' agents can react to, watch for
+inbound facts, and exchange content-addressed artifacts — all over real
+QUIC/DHT wire protocol, not a mock.
+
+## Tools
+
+| Tool | Primitive | What it does |
+|---|---|---|
+| `mesh_call` | RPC | Invoke a capability a peer advertises (build, test, search, deploy) over the mesh. Returns the result + `duration_ms`. |
+| `mesh_put` | Content Sharing | Publish a content-addressed artifact; returns its MCID hex. |
+| `mesh_get` | Content Sharing | Fetch a content-addressed artifact by MCID hex. |
+| `mesh_publish` | Pub/Sub | Emit an integration fact to a topic (business verbs only, never CRUD). Returns `topic`/`seq`. |
+| `mesh_watch` | Pub/Sub | Watch a topic for up to `duration_seconds` (max 120) and return whatever arrived. **Blocks for the call's duration** — there's no standing background subscription; call again to keep watching. |
+
+Every tool takes an optional `host` (`"host[:port]"`) to pick which station
+to connect through; all default to `MACULA_MESH_STATION` (see
+[Environment](#environment)).
+
+## Resources
+
+| Resource | Content |
+|---|---|
+| `mesh://identity` | This node's Ed25519 identity (node ID), minted and persisted locally by `macula-cli`. |
+
+## Prerequisites
+
+- Node.js 20+ (the one thing the installer below checks but won't install for
+  you — get it from [nodejs.org](https://nodejs.org), nvm, fnm, or volta).
+
+Everything else — [`macula-cli`](https://github.com/macula-io/macula-cli),
+the `@macula-io/mcp` package itself, and registering with your MCP client — is
+handled by the installer.
+
+## Install
+
+**Linux / macOS:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/macula-io/macula-mcp/main/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/macula-io/macula-mcp/main/install.ps1 | iex
+```
+
+Both check Node.js, install `macula-cli` if it isn't already on `PATH`,
+`npm install -g @macula-io/mcp`, then run `macula-mcp-install` to register the
+`macula` MCP server with every detected client (Claude Code, Claude Desktop,
+Cursor, Windsurf) — safe-merges into existing configs and backs them up
+first. Idempotent; re-running is a no-op if everything's already current.
+
+To uninstall (unregisters from every MCP client, then removes the `npm`
+package — leaves `macula-cli` untouched, that has its own
+[install/uninstall](https://github.com/macula-io/macula-cli#quick-start)):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/macula-io/macula-mcp/main/uninstall.sh | bash
+```
+
+```powershell
+irm https://raw.githubusercontent.com/macula-io/macula-mcp/main/uninstall.ps1 | iex
+```
+
+**From source** (contributing, or before a version is published):
+
+```bash
+npm install
+npm run build
+npm link            # puts `macula-mcp` on PATH
+macula-mcp-install  # register with detected MCP clients
+```
+
+See the [guide](guides/HOWTO.md) for env var overrides (pinning a version,
+skipping the `macula-cli` step, installing without registering any client)
+and troubleshooting.
+
+## Environment
+
+| Variable | Purpose | Default |
+|---|---|---|
+| `MACULA_CLI_BIN` | Override the `macula-cli` binary path/name. | `macula-cli` (resolved via `PATH`) |
+| `MACULA_MESH_STATION` | Default station every tool connects through when a call doesn't override `host`. | `station-de-frankfurt.macula.io:4433` |
+| `MACULA_MCP_WATCH_IDENTITY` | Override `mesh_watch`'s dedicated identity file path (kept separate from every other tool's default identity — see the [guide](guides/HOWTO.md) §2). | `~/.macula-mcp/watch-identity.seed` |
+
+## Status
+
+**v0.3.0 — reworked onto `macula-cli`, 2026-08-29.** Every tool shells out
+to a real `macula-cli` subprocess and has been exercised against the live
+demo fleet through `macula-cli` itself (see that repo's own README/HOWTO
+guide for the underlying live verification). `npm run typecheck`/`build`
+are clean; `parseWatchOutput`'s NDJSON-vs-error-envelope parsing has a real
+unit test (`src/macula_cli.test.ts`) guarding a bug caught while writing
+it — a naive try/catch around `JSON.parse` never distinguishes a
+wrong-shape-but-valid-JSON error envelope from a real event, so it needs
+an explicit shape check.
+
+**Dropped in this rework, not carried over from the daemon-backed
+design** — `macula-cli` is a one-shot process with no daemon and no
+storage, so none of these have an honest equivalent without `macula-mcp`
+itself becoming a stateful daemon (a real design fork that was deliberately
+not taken; see `macula-io/macula-cli`'s own project memory for the
+tradeoff):
+- **Standing subscriptions + inbox.** The old `mesh_subscribe`/
+  `mesh_unsubscribe`/`mesh_subscriptions`/`mesh_inbox` quartet relied on
+  the daemon's own event-sourced background subscription that outlived any
+  one call. Replaced by `mesh_watch`, which blocks for a bounded duration
+  and returns what arrived — call it again to keep watching.
+- **Activity audit log** (`mesh://activity/{realm}`, `fact_id` on every
+  write). That was hecate-daemon's own ReckonDB-backed accountability
+  trail. Writes still happen for real on the mesh; there's just no local
+  log of them anymore.
+- **`mesh://peers`.** Already an admitted stub even under the old
+  design ("v1 surfaces an empty list until `hecate_mesh:get_peers/0`
+  returns real data") — `macula-go-sdk` has no peer-listing API either, so
+  there was nothing real to carry forward.
+
+Known mesh limits, unchanged from before (memory:
+`project_inter_station_routing_unshipped`): cross-station DHT replication
+is not fully shipped — `mesh_put`/`mesh_get` is reliable same-station,
+best-effort cross-station.
+
+## Documentation
+
+| Guide | Description |
+|---|---|
+| [HOW-TO Guide](guides/HOWTO.md) | Install/uninstall env var reference, each tool's exact behavior, troubleshooting a failed tool call, the two real gotchas found live-testing this rework |
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).

package/dist/bin/install.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/install.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+// macula-mcp install — wire macula-cli into every detected MCP client's
+// config in one shot.
+//
+// Scope:
+//   * Detects an installed macula-cli binary (identity probe, no
+//     network), prints its node ID for visual confirmation.
+//   * Detects installed MCP clients (Claude Code, Claude Desktop,
+//     Cursor, Windsurf) by their canonical paths.
+//   * Safe-merges a `macula` mcpServers entry into each — idempotent
+//     re-runs are no-ops; conflicting entries skip with a remediation
+//     hint unless --force is passed.
+//   * Backs up any existing config to `<path>.macula-bak-<timestamp>`
+//     before writing.
+//
+// Reworked 2026-08-29: this used to detect a running hecate-daemon and
+// offer to fetch+launch one; hecate-daemon is now treated as obsolete
+// and macula-mcp shells out to macula-cli instead (src/macula_cli.ts).
+// If macula-cli isn't found, this prints the install command rather
+// than fetching a binary itself -- macula-cli already ships its own
+// tested cross-platform install.sh/install.ps1, no reason to duplicate
+// that fetch/verify logic here.
+//
+// Exit codes: 0 = ok, 1 = bad input, 2 = no MCP clients detected.
+import { detect } from "../install/platform.js";
+import { probe } from "../install/existing_cli.js";
+import { ALL, detected } from "../install/mcp_clients/index.js";
+const VERSION = "0.3.0";
+function parseArgs(argv) {
+    const a = { force: false, help: false, only: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h")
+            a.help = true;
+        else if (arg === "--force")
+            a.force = true;
+        else if (arg === "--only")
+            a.only = (argv[++i] ?? "").split(",").filter(Boolean);
+        else if (arg.startsWith("--")) {
+            err(`unknown flag: ${arg}`);
+            process.exit(1);
+        }
+    }
+    return a;
+}
+function help() {
+    console.log(`macula-mcp install ${VERSION}
+
+Usage: npx @macula-io/mcp install [--force] [--only <client[,client,...]>]
+
+Detects installed MCP clients and registers the 'macula' MCP server,
+which shells out to macula-cli for mesh operations. Idempotent;
+safe-merges into existing configs and backs up first.
+
+Supported MCP clients:
+  claude-code, claude-desktop, cursor, windsurf
+
+Flags:
+  --force                Replace an existing 'macula' entry that
+                         differs from the new one. Without --force
+                         conflicting entries are left alone.
+  --only <a,b,c>         Only configure the listed clients.
+  --help, -h             This message.
+
+After install: restart your MCP client; ask your LLM to read the
+mesh://identity resource or call mesh_publish on any topic.
+`);
+}
+function ok(msg) {
+    console.log(`[macula-mcp install] ✓ ${msg}`);
+}
+function info(msg) {
+    console.log(`[macula-mcp install]   ${msg}`);
+}
+function warn(msg) {
+    console.warn(`[macula-mcp install] ! ${msg}`);
+}
+function err(msg) {
+    console.error(`[macula-mcp install] ✗ ${msg}`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        help();
+        return;
+    }
+    const p = detect();
+    info(`platform: ${p.label}`);
+    // 1) Probe for an installed macula-cli binary.
+    const cp = await probe();
+    if (cp.available && cp.nodeId) {
+        ok(`macula-cli found`);
+        info(`node id:  ${cp.nodeId}`);
+    }
+    else {
+        warn(`macula-cli not found on PATH`);
+        info("macula-mcp shells out to macula-cli for every mesh operation --");
+        info("install it before the registered MCP entry will actually work:");
+        info("  curl -fsSL https://raw.githubusercontent.com/macula-io/macula-cli/master/install.sh | bash");
+        info("  (Windows: irm https://raw.githubusercontent.com/macula-io/macula-cli/master/install.ps1 | iex)");
+        info("Continuing with MCP-config registration anyway.");
+    }
+    // 2) Detect MCP clients.
+    const requested = args.only.length > 0 ? args.only : null;
+    const targets = (requested ? ALL.filter((c) => requested.includes(c.CLIENT_ID)) : detected());
+    if (targets.length === 0) {
+        err("no MCP clients detected.");
+        info("install Claude Code, Claude Desktop, Cursor, or Windsurf and re-run.");
+        info("or pass --only <id> to force configuration anyway.");
+        process.exit(2);
+    }
+    info(`detected MCP clients: ${targets.map((c) => c.CLIENT_LABEL).join(", ")}`);
+    // 3) Register macula entry in each.
+    for (const client of targets) {
+        await configureOne(client);
+    }
+    console.log("");
+    ok("done.");
+    console.log(`\nRestart your MCP client(s). To test, ask your LLM:\n` +
+        `  "Read the mesh://identity resource and tell me my node ID."\n`);
+}
+async function configureOne(c) {
+    try {
+        const result = await c.install();
+        const tag = result.outcome === "added"
+            ? "added"
+            : result.outcome === "replaced"
+                ? "replaced"
+                : result.outcome === "unchanged"
+                    ? "unchanged"
+                    : "skipped";
+        info(`${c.CLIENT_LABEL}: ${tag} (${result.configPath})`);
+        if (result.backupPath)
+            info(`  backup: ${result.backupPath}`);
+        if (result.outcome === "skipped_conflict")
+            warn(`  ${result.message}`);
+    }
+    catch (e) {
+        err(`${c.CLIENT_LABEL}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+main().catch((e) => {
+    err(`fatal: ${e instanceof Error ? e.stack ?? e.message : String(e)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=install.js.map

package/dist/bin/install.js.map

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

package/dist/bin/status.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/status.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+// macula-mcp status — at-a-glance report of:
+//   * whether macula-cli is installed and functional
+//   * which MCP clients are installed
+//   * which already have a `macula` entry configured
+//
+// Read-only: never writes config, never touches the mesh. Safe to
+// run any time.
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { detect } from "../install/platform.js";
+import { probe } from "../install/existing_cli.js";
+import { ALL } from "../install/mcp_clients/index.js";
+const VERSION = "0.3.0";
+function help() {
+    console.log(`macula-mcp status ${VERSION}
+
+Usage: npx @macula-io/mcp status
+
+Read-only diagnostic. Reports macula-cli availability and MCP-client
+configuration state.
+`);
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.includes("--help") || argv.includes("-h")) {
+        help();
+        return;
+    }
+    const p = detect();
+    line("platform", p.label);
+    const cp = await probe();
+    if (cp.available && cp.nodeId) {
+        line("macula-cli", "available");
+        line("  node id", cp.nodeId);
+    }
+    else {
+        line("macula-cli", "NOT found on PATH");
+        if (cp.reason)
+            line("  reason", cp.reason);
+    }
+    console.log("");
+    console.log("MCP clients:");
+    for (const client of ALL) {
+        await reportClient(client);
+    }
+}
+async function reportClient(c) {
+    const installed = c.isInstalled();
+    const cfgPath = c.configPath();
+    if (!installed) {
+        console.log(`  ${pad(c.CLIENT_LABEL)} not installed`);
+        return;
+    }
+    const configured = await hasMaculaEntry(cfgPath);
+    if (!existsSync(cfgPath)) {
+        console.log(`  ${pad(c.CLIENT_LABEL)} installed, no config file (${cfgPath})`);
+        return;
+    }
+    console.log(`  ${pad(c.CLIENT_LABEL)} installed, ${configured ? "✓ macula registered" : "✗ macula NOT registered"} (${cfgPath})`);
+}
+async function hasMaculaEntry(path) {
+    if (!existsSync(path))
+        return false;
+    try {
+        const raw = await readFile(path, "utf8");
+        if (raw.trim().length === 0)
+            return false;
+        const parsed = JSON.parse(raw);
+        return Boolean(parsed.mcpServers && "macula" in parsed.mcpServers);
+    }
+    catch {
+        return false;
+    }
+}
+function line(k, v) {
+    console.log(`${pad(k)} ${v}`);
+}
+function pad(s) {
+    return (s + " ".repeat(18)).slice(0, 18);
+}
+main().catch((e) => {
+    console.error(`[macula-mcp status] fatal: ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=status.js.map

package/dist/bin/status.js.map

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

package/dist/bin/uninstall.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};