@descryy/mcp 0.11.3 → 0.11.5

package/dist/tools/kit.js

@@ -1,153 +0,0 @@
-/** What every tool is handed and returns. A tool produces a `ToolAnswer`, never content —
- *  `render.ts` alone turns it into a reply, attaching the staleness stamp, reliability cap and
- *  disclosures. A tool cannot ship a result with the caveats stripped off. */
-import { dirname } from "node:path";
-import { CONFIG_RELATIVE_PATH } from "../session.js";
-/** An argument the caller can fix — distinct from a thrown `Error` (a bug here). This becomes an
- *  `isError` result the agent can read and retry from; a bug becomes an unreadable JSON-RPC error. */
-export class ToolInputError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "ToolInputError";
-    }
-}
-// Hand-written, not schema-validated: a validator would be a second source of truth for the
-// schemas already declared to the client.
-export function optionalString(args, key) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (typeof value !== "string")
-        throw new ToolInputError(`"${key}" must be a string`);
-    return value;
-}
-export function requiredString(args, key) {
-    const value = optionalString(args, key);
-    if (value === undefined || value === "")
-        throw new ToolInputError(`"${key}" is required`);
-    return value;
-}
-export function optionalStringArray(args, key) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (!Array.isArray(value) || value.some((v) => typeof v !== "string")) {
-        throw new ToolInputError(`"${key}" must be an array of strings`);
-    }
-    return value;
-}
-export function optionalInteger(args, key, min) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (typeof value !== "number" || !Number.isInteger(value) || value < min) {
-        throw new ToolInputError(`"${key}" must be an integer of at least ${min}`);
-    }
-    return value;
-}
-export function optionalEnum(args, key, allowed) {
-    const value = optionalString(args, key);
-    if (value === undefined)
-        return undefined;
-    if (!allowed.includes(value)) {
-        throw new ToolInputError(`"${key}" must be one of: ${allowed.join(", ")}`);
-    }
-    return value;
-}
-export function optionalBoolean(args, key) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (typeof value !== "boolean")
-        throw new ToolInputError(`"${key}" must be a boolean`);
-    return value;
-}
-/** Wraps data that did not come from the query layer in the same envelope — e.g. `analyze`, which
- *  writes rather than reads and has no `QueryResult`, so its reply still carries the same stamp. */
-export function answer(options) {
-    const result = {
-        data: options.data,
-        stamp: {
-            commitSha: options.commitSha,
-            graphBuiltAt: options.graphBuiltAt,
-            irSchemaVersion: options.irSchemaVersion,
-            commitSpread: options.commitSpread,
-            repoCount: options.repoCount,
-            resolutionFloor: options.resolutionFloor,
-        },
-        truncated: options.truncated ?? false,
-        notes: options.notes,
-    };
-    return {
-        result,
-        nameLevel: options.nameLevel,
-        headline: options.headline,
-        ...(options.state === undefined ? {} : { state: options.state }),
-        ...(options.truncatedDetail === undefined ? {} : { truncatedDetail: options.truncatedDetail }),
-        ...(options.refusalSummary === undefined ? {} : { refusalSummary: options.refusalSummary }),
-        ...(options.fitToBudget === undefined ? {} : { fitToBudget: options.fitToBudget }),
-        ...(options.runtimeEvidence === undefined ? {} : { runtimeEvidence: options.runtimeEvidence }),
-    };
-}
-/** Trim an IR node down to what an agent needs, so a 1,000-node reply stays readable. */
-export function briefNode(node) {
-    return {
-        id: node.id,
-        type: node.type,
-        name: node.name,
-        ...(node.file === null ? {} : { file: node.file }),
-        ...(node.range === null ? {} : { line: node.range.startLine }),
-        ...(node.language === null ? {} : { language: node.language }),
-        resolution: node.resolution,
-    };
-}
-/**
- * Descry's own state inside this repository, which is not the developer's
- * uncommitted change.
- *
- * ## Two paths, not one, and the second is the one that bit
- *
- * The first version derived this from the configured graph path alone. That is
- * right for a single repository, where the graph sits in this repo's own
- * `.descry/` — and wrong the moment two repositories share one graph, which is
- * exactly what `link_workspace` produces:
- *
- * ```json
- * // sherpa-backend/.descry/config.json
- * "graph": "/home/…/sherpa-frontend/.descry/graph.db"
- * ```
- *
- * The derived exclusion then pointed into the *other* repository, and this
- * repository's own `.descry/config.json` was excluded by nothing. Measured on a
- * real workspace: it was reported as the developer's uncommitted work. Not an
- * edge case — every shared-graph workspace has it.
- *
- * `.descry/evidence.db` escaped only because that repository's `.gitignore`
- * happened to carry `*.db`. **The exclusion must not depend on the user having
- * gitignored anything**, which is what that near-miss shows: a tool's own state
- * is excluded because it is the tool's, not because someone tidied up.
- *
- * ## Why the graph path is still consulted
- *
- * It is configurable, so it can be moved out of `.descry/` and stay inside the
- * repository. A path outside the repository costs nothing to list — it is not
- * in this working tree — and is kept rather than special-cased, because the
- * test for "is this path inside this repo" is the kind that is subtly wrong on
- * symlinks and relative paths.
- *
- * Returned as directory prefixes matched at a segment boundary by the git
- * helpers, so `.descry` excludes `.descry/config.json` and leaves
- * `src/.descryfile.py` alone.
- */
-export function descryOwnState(graphPath) {
-    // This repository's own state directory, always — whatever the graph does.
-    const out = new Set([dirname(CONFIG_RELATIVE_PATH)]);
-    if (graphPath !== ":memory:" && graphPath !== "") {
-        const normalised = graphPath.replace(/\\/g, "/").replace(/^\.\//, "");
-        const slash = normalised.lastIndexOf("/");
-        // The directory, not the file: SQLite writes `-wal` and `-shm` beside it.
-        out.add(slash === -1 ? normalised : normalised.slice(0, slash));
-    }
-    return [...out];
-}
-//# sourceMappingURL=kit.js.map

package/dist/tools/kit.js.map

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

package/dist/tools/link-workspace.d.ts

@@ -1,24 +0,0 @@
-/** `link_workspace` — the agent-mediated door onto what `descry init` writes from the CLI
- *  (shared `writeConfig`). Closes `analyze`'s "no workspace configured" disclosure (DEC-054),
- *  previously a dead end. Never infers pairing — `repos` must come from the user's explicit
- *  confirmation, not the caller's guess (workspace.ts's rule: never infer, always declare).
- *  The only tool writing outside its session root; a path that fails to exist is disclosed, never silently skipped. */
-import { type ToolDefinition } from "./kit.ts";
-/** A repository the workspace id was actually written into. */
-export interface LinkedRepo {
-    /** Resolved to absolute. */
-    readonly path: string;
-    readonly repo: string;
-    /** The `.descry/config.json` that was written. */
-    readonly configPath: string;
-}
-export interface LinkWorkspaceData {
-    readonly workspace: string;
-    /** Only the repositories actually written. A path that didn't exist is absent from this
-     *  list and disclosed — a partial link that looks complete is the failure this exists to catch. */
-    readonly written: readonly LinkedRepo[];
-    /** How many were asked for. Compare against `written.length`. */
-    readonly requested: number;
-}
-export declare const linkWorkspaceTool: ToolDefinition;
-//# sourceMappingURL=link-workspace.d.ts.map

package/dist/tools/link-workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"link-workspace.d.ts","sourceRoot":"","sources":["../../src/tools/link-workspace.ts"],"names":[],"mappings":"AAAA;;;;uHAIuH;AAMvH,OAAO,EAA4D,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAGzG,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;uGACmG;IACnG,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAsID,eAAO,MAAM,iBAAiB,EAAE,cAe/B,CAAC"}

package/dist/tools/link-workspace.js

@@ -1,131 +0,0 @@
-/** `link_workspace` — the agent-mediated door onto what `descry init` writes from the CLI
- *  (shared `writeConfig`). Closes `analyze`'s "no workspace configured" disclosure (DEC-054),
- *  previously a dead end. Never infers pairing — `repos` must come from the user's explicit
- *  confirmation, not the caller's guess (workspace.ts's rule: never infer, always declare).
- *  The only tool writing outside its session root; a path that fails to exist is disclosed, never silently skipped. */
-import { existsSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-import { writeConfig, writeWorkspaceRepos } from "../session.js";
-import { answer, requiredString, ToolInputError } from "./kit.js";
-const SCHEMA = {
-    type: "object",
-    properties: {
-        workspace: {
-            type: "string",
-            description: "The workspace id to write into every repository listed in `repos`, byte-identical. " +
-                "Choose a short, stable name — it becomes part of every workspace-scoped node id.",
-        },
-        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 rather than defaulted.",
-                    },
-                },
-                required: ["path", "repo"],
-                additionalProperties: false,
-            },
-            description: "Every repository that should share this workspace, INCLUDING the current one if it should " +
-                "join. Only call this with repositories the user has explicitly confirmed belong together " +
-                "— a directory sitting next to another is a suggestion to put in front of the user, never " +
-                "a decision this tool or the caller makes on its own (workspace.ts's pairing rule, one " +
-                "level up: never infer, always declare).",
-        },
-    },
-    required: ["workspace", "repos"],
-    additionalProperties: false,
-};
-function parseRepos(value) {
-    if (!Array.isArray(value) || value.length < 2) {
-        throw new ToolInputError('"repos" must be an array of at least two {path, repo} entries — a workspace of one ' +
-            "repository joins nothing, so linking one is never the right call.");
-    }
-    return value.map((entry, index) => {
-        if (typeof entry !== "object" || entry === null) {
-            throw new ToolInputError(`repos[${index}] must be an object`);
-        }
-        const path = requiredString(entry, "path");
-        const repo = requiredString(entry, "repo");
-        return { path, repo };
-    });
-}
-async function run(args, ctx) {
-    const workspace = requiredString(args, "workspace");
-    const repos = parseRepos(args["repos"]);
-    const seen = new Set();
-    for (const entry of repos) {
-        const absolute = resolve(entry.path);
-        if (seen.has(absolute)) {
-            throw new ToolInputError(`"${entry.path}" is listed more than once`);
-        }
-        seen.add(absolute);
-    }
-    const written = [];
-    const notes = [];
-    for (const entry of repos) {
-        const absolute = resolve(entry.path);
-        if (!existsSync(absolute) || !statSync(absolute).isDirectory()) {
-            notes.push(`"${entry.path}" does not exist or is not a directory — nothing was written there.`);
-            continue;
-        }
-        ctx.progress(`Writing .descry/config.json in ${entry.repo}`, written.length, repos.length);
-        const result = await writeConfig(absolute, { repo: entry.repo, workspace });
-        written.push({ path: absolute, repo: entry.repo, configPath: result.path });
-        if (result.previousWorkspace !== undefined && result.previousWorkspace !== workspace) {
-            notes.push(`${entry.repo}: replaced previous workspace "${result.previousWorkspace}" with "${workspace}".`);
-        }
-    }
-    // Membership list, written after the loop so it names repos the link actually reached, not
-    // what it was asked about. A workspace name alone doesn't say where siblings live on disk
-    // (DEC-NEXT-workspace-scoped-confirmed-facts). Still the caller's own list — nothing inferred.
-    const members = written.map((w) => ({ path: w.path, repo: w.repo }));
-    for (const member of members) {
-        await writeWorkspaceRepos(member.path, members);
-    }
-    if (written.length < repos.length) {
-        notes.push(`${repos.length - written.length} of ${repos.length} repositories were skipped. The workspace ` +
-            "id is only byte-identical where it was actually written — re-run for the skipped paths " +
-            "once they are correct.");
-    }
-    notes.push(`Run "analyze" again in each linked repository so its graph is rebuilt under the "${workspace}" ` +
-        "workspace — writing the config here does not itself rebuild anything.");
-    return answer({
-        headline: written.length === 0
-            ? `No repository was linked — every path in "repos" failed to resolve.`
-            : `Linked ${written.length} of ${repos.length} repositor${repos.length === 1 ? "y" : "ies"} ` +
-                `to workspace "${workspace}".`,
-        state: written.length === 0 ? "refused" : "ok",
-        nameLevel: true,
-        // Writing a config file is not evidence about code — R0, the same choice `analyze`
-        // makes when no code-reading source ran.
-        resolutionFloor: 0,
-        commitSha: null,
-        graphBuiltAt: null,
-        irSchemaVersion: ctx.session.provider().baseStamp().irSchemaVersion,
-        commitSpread: ctx.session.provider().baseStamp().commitSpread,
-        repoCount: ctx.session.provider().baseStamp().repoCount,
-        notes,
-        data: { workspace, written, requested: repos.length },
-    });
-}
-export const linkWorkspaceTool = {
-    name: "link_workspace",
-    class: "stateful-read",
-    tier: "evidence",
-    version: "1.0.0",
-    title: "Declare which repositories share a workspace",
-    description: "Write the workspace id that lets multiple repositories' graphs join (DEC-054) into each " +
-        "repository's .descry/config.json. Call this ONLY after the user has explicitly confirmed " +
-        "which repositories belong together — you may point out sibling directories you can see as a " +
-        "suggestion, but you must never decide on your own that they are related and call this " +
-        "unprompted. The same file `descry init` writes from the command line; this is the " +
-        "conversational door onto it.",
-    inputSchema: SCHEMA,
-    run,
-};
-//# sourceMappingURL=link-workspace.js.map

package/dist/tools/link-workspace.js.map

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

package/dist/tools/lookup.d.ts

@@ -1,19 +0,0 @@
-/** Turns what a developer typed into exactly one node, or refuses to. With no signal to pick
- *  between two nodes plausibly named `charge`, picking would be inventing evidence — so ambiguity
- *  returns with candidates and how to narrow, the same discipline the graph builder applies to an
- *  unresolvable edge (never stub a node) and adapters apply to an unreadable receiver. */
-import type { IRNode } from "@descryy/ir";
-import type { Session } from "../session.ts";
-export interface Lookup {
-    /** Null when nothing matched, or when more than one thing did. */
-    readonly node: IRNode | null;
-    readonly candidates: readonly IRNode[];
-    readonly headline: string;
-    readonly notes: readonly string[];
-}
-export declare function resolveOneNode(session: Session, criteria: {
-    readonly nodeId?: string | undefined;
-    readonly symbol?: string | undefined;
-    readonly file?: string | undefined;
-}): Lookup;
-//# sourceMappingURL=lookup.d.ts.map

package/dist/tools/lookup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/tools/lookup.ts"],"names":[],"mappings":"AAAA;;;0FAG0F;AAG1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,MAAM;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE;IACR,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GACA,MAAM,CA+DR"}

package/dist/tools/lookup.js

@@ -1,63 +0,0 @@
-/** Turns what a developer typed into exactly one node, or refuses to. With no signal to pick
- *  between two nodes plausibly named `charge`, picking would be inventing evidence — so ambiguity
- *  returns with candidates and how to narrow, the same discipline the graph builder applies to an
- *  unresolvable edge (never stub a node) and adapters apply to an unreadable receiver. */
-import { findNodes, getNode } from "@descryy/core";
-export function resolveOneNode(session, criteria) {
-    const driver = session.store().driver;
-    if (criteria.nodeId !== undefined) {
-        const node = getNode(driver, criteria.nodeId);
-        return node === undefined
-            ? {
-                node: null,
-                candidates: [],
-                headline: `No node with id ${criteria.nodeId} is in the graph.`,
-                notes: [
-                    "The id may be from an older graph. Node ids are hashes over the repository scope, " +
-                        "kind and qualified symbol path, so they survive file moves but not a change to the " +
-                        "configured repository name. Run analyze and use an id from its output.",
-                ],
-            }
-            : { node, candidates: [node], headline: node.name, notes: [] };
-    }
-    const matches = findNodes(driver, {
-        ...(criteria.symbol === undefined ? {} : { name: criteria.symbol }),
-        ...(criteria.file === undefined ? {} : { file: criteria.file }),
-    });
-    const named = criteria.symbol ?? criteria.file ?? "";
-    if (matches.length === 0) {
-        return {
-            node: null,
-            candidates: [],
-            headline: `Nothing named "${named}" is in the graph.`,
-            notes: [
-                "This does not mean it does not exist. It means no configured adapter read it, or the " +
-                    "graph predates it. Run analyze, and check its disclosures for languages that were not " +
-                    "analysable.",
-            ],
-        };
-    }
-    if (matches.length === 1) {
-        return { node: matches[0], candidates: matches, headline: matches[0].name, notes: [] };
-    }
-    // More than one. Only a file narrows it, and only if the caller did not already
-    // give one — in which case the file genuinely declares two things of that name.
-    const where = matches
-        .slice(0, 8)
-        .map((m) => `${m.type} ${m.name}${m.file === null ? "" : ` (${m.file})`}`)
-        .join(", ");
-    return {
-        node: null,
-        candidates: matches,
-        headline: `"${named}" is ambiguous — ${matches.length} nodes match.`,
-        notes: [
-            `Candidates: ${where}${matches.length > 8 ? ", …" : ""}. ` +
-                (criteria.file === undefined
-                    ? 'Narrow it with "file", or pass "nodeId" directly.'
-                    : "They are in the same file, so pass \"nodeId\" directly."),
-            "No answer was computed. Choosing one of these by a heuristic would produce a confident " +
-                "answer about a symbol you did not ask about.",
-        ],
-    };
-}
-//# sourceMappingURL=lookup.js.map

package/dist/tools/lookup.js.map

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

package/dist/tools/mark-incident.d.ts

@@ -1,28 +0,0 @@
-/** `mark_incident` — "that was a bug, I fixed it": the only incident-minting path with
- *  precision 1.0 (a person asserts it). Needed because automatic detection (reverts,
- *  `Fixes #123`) found zero incidents in 3 repos, and a fix-forward heuristic scored 25%
- *  against a 90% threshold and was refused. Stored in `.descry/config.json` (DEC-223,
- *  DEC-017 — derived tables don't survive rebuilds) and capped at class B; `action` class per DEC-278, gated by the `confirmToken` handshake. */
-import type { ConfirmedIncident } from "@descryy/ir";
-import { type ToolDefinition } from "./kit.ts";
-export interface MarkIncidentData {
-    /** The record as written. Read it back to see exactly what was stored. */
-    readonly recorded: ConfirmedIncident;
-    /** The `INCIDENT` node id, so a caller can query it immediately. */
-    readonly incidentNodeId: string;
-    /** Where the durable record lives — a file a person can read and correct. */
-    readonly configPath: string;
-    /** How many confirmed incidents this repository now has on record. */
-    readonly totalConfirmed: number;
-    /** Paths named that the graph has no node for. Still recorded and correlated — a
-     *  developer naming a file Descry can't read is a gap in Descry, not a mistake. */
-    readonly filesNotInGraph: readonly string[];
-    /** True when this call's content (same summary and error text) matched a record
-     *  already on file — merged into it rather than minting a second `INCIDENT` node
-     *  (UAT phase 5, F9). */
-    readonly merged: boolean;
-    /** How many times this exact content has now been reported, this call included. */
-    readonly occurrences: number;
-}
-export declare const markIncidentTool: ToolDefinition;
-//# sourceMappingURL=mark-incident.d.ts.map

package/dist/tools/mark-incident.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mark-incident.d.ts","sourceRoot":"","sources":["../../src/tools/mark-incident.ts"],"names":[],"mappings":"AAAA;;;;iJAIiJ;AAUjJ,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;uFACmF;IACnF,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C;;6BAEyB;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAkMD,eAAO,MAAM,gBAAgB,EAAE,cAkB9B,CAAC"}