@descryy/mcp 0.11.1 → 0.11.2

package/dist/tools/workspace.js

@@ -0,0 +1,101 @@
+/**
+ * `workspace` — merges `analyze`, `analyze_workspace` and `link_workspace`
+ * behind one `verb` (documents/plans/mcp-surface-consolidation.md §2, group 1).
+ * All three are `stateful-read`/`evidence`, so the merge crosses neither
+ * boundary.
+ *
+ * Dispatch only. Each verb's own `run()` body is untouched and stays in its
+ * own module (`analyze.ts` / `analyze-workspace.ts` / `link-workspace.ts`) —
+ * this file never holds a second copy of that logic, it only routes to it
+ * after `selectVerb` has re-established, per verb, the argument strength a
+ * flat union schema loses (`verb.ts`'s own header explains why that is
+ * mandatory once a schema covers more than one verb).
+ */
+import { selectVerb } from "./verb.js";
+import { analyzeTool } from "./analyze.js";
+import { analyzeWorkspaceTool } from "./analyze-workspace.js";
+import { linkWorkspaceTool } from "./link-workspace.js";
+const VERBS = ["analyze", "index", "link"];
+const VERB_SPECS = [
+    { verb: "analyze", accepts: ["includeHistory", "maxCommits", "reload"] },
+    { verb: "index", accepts: ["includeHistory", "maxCommits"] },
+    { verb: "link", accepts: ["workspace", "repos"] },
+];
+const SCHEMA = {
+    type: "object",
+    properties: {
+        verb: {
+            type: "string",
+            enum: [...VERBS],
+            description: '"analyze" — read this repository into the code graph. "index" — read every repository a ' +
+                'prior "link" declared into one shared graph. "link" — declare which repositories share a ' +
+                "workspace.",
+        },
+        includeHistory: {
+            type: "boolean",
+            description: "analyze/index. Read git history for co-change coupling. Default true.",
+        },
+        maxCommits: {
+            type: "integer",
+            minimum: 1,
+            description: "analyze/index. Cap on commits read from history. Default 2000.",
+        },
+        reload: {
+            type: "boolean",
+            description: "analyze only. Re-read .descry/config.json from disk before this run, instead of the " +
+                "configuration this server started with.",
+        },
+        workspace: {
+            type: "string",
+            description: 'link only. The workspace id to write into every repository in "repos", byte-identical.',
+        },
+        repos: {
+            type: "array",
+            minItems: 2,
+            items: {
+                type: "object",
+                properties: {
+                    path: { type: "string", description: "Absolute path to the repository on disk." },
+                    repo: { type: "string", description: "This repository's identity, written explicitly." },
+                },
+                required: ["path", "repo"],
+                additionalProperties: false,
+            },
+            description: "link only. Every repository that should share this workspace, including the current one " +
+                "if it should join. Only ones the user has explicitly confirmed belong together — never " +
+                "inferred.",
+        },
+    },
+    required: ["verb"],
+    additionalProperties: false,
+};
+const DISPATCH = {
+    analyze: analyzeTool,
+    index: analyzeWorkspaceTool,
+    link: linkWorkspaceTool,
+};
+async function run(args, ctx) {
+    const verb = selectVerb(args, "verb", VERB_SPECS);
+    // `ToolDefinition` erases its answer's type parameter — it has to, the
+    // registry is one array of many shapes — so the delegated call comes back as
+    // an erased answer type. The verb table is what makes the union true: every
+    // entry's own `run` is declared against one of WorkspaceData's members, and a verb
+    // added without its shape stops compiling at the union. The assertion
+    // re-applies what the table already guarantees rather than asserting
+    // something unchecked.
+    return (await DISPATCH[verb].run(args, ctx));
+}
+export const workspaceTool = {
+    name: "workspace",
+    class: "stateful-read",
+    tier: "evidence",
+    version: "1.0.0",
+    title: "Analyse a repository or workspace into the code graph",
+    description: "Read source into the code graph, or declare which repositories share a workspace, by verb: " +
+        '"analyze" (one repository, with its configured adapters), "index" (every repository a prior ' +
+        '"link" call declared, into one shared graph), "link" (write a workspace id into each named ' +
+        "repository's config — only after the user has explicitly confirmed they belong together).",
+    inputSchema: SCHEMA,
+    run,
+};
+//# sourceMappingURL=workspace.js.map

package/dist/tools/workspace.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@descryy/mcp",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "type": "module",
-  "description": "Descry's MCP server: the agent-facing front door over the query layer. The stdio transport is JSON-RPC 2.0 by hand rather than seventeen packages of HTTP and OAuth. Thirty-eight tools; most read the graph and nothing else. The @descryy dependencies are here for the three that do more: observe_runtime boots or attaches to a real application, observe_tests runs the project's own test suite, and the browser tools drive a real browser — each writing what it witnessed into the graph as R4 facts. @descryy/runtime-browser is declared below like the others. It is still imported by specifier at call time rather than statically — not because it is unpublished (it is not) but because that indirection is an injection seam real tests use to drive the settle logic against a fake module with no real browser involved; see playwright-driver.ts. A missing package, a missing Chromium binary, or an import failure each still returns a named, remediable refusal rather than a crash or an empty result.",
+  "description": "Descry's MCP server: the agent-facing front door over the query layer. The stdio transport is JSON-RPC 2.0 by hand rather than seventeen packages of HTTP and OAuth. Twenty tools; most read the graph and nothing else. The @descryy dependencies are here for the three that do more: observe_runtime boots or attaches to a real application, observe_tests runs the project's own test suite, and the browser tools drive a real browser — each writing what it witnessed into the graph as R4 facts. @descryy/runtime-browser is declared below like the others. It is still imported by specifier at call time rather than statically — not because it is unpublished (it is not) but because that indirection is an injection seam real tests use to drive the settle logic against a fake module with no real browser involved; see playwright-driver.ts. A missing package, a missing Chromium binary, or an import failure each still returns a named, remediable refusal rather than a crash or an empty result.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -36,7 +36,7 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/core": "0.9.0",
+    "@descryy/core": "0.8.0",
     "@descryy/ir": "0.10.0",
     "@descryy/runtime-backend-observation": "0.3.5",
     "@descryy/runtime-browser": "0.4.6",