@descent-vtt/spec-guard 0.11.0 → 0.12.0

package/dist/types.d.ts

@@ -80,11 +80,42 @@ export interface SpecStatus {
     /** Whether the directives in this document execute. */
     active: boolean;
 }
+/**
+ * Something about how a spec document was read that a reader should know and
+ * that fails nothing: a status that could not be read, a block that is never
+ * closed. Each changes which of the document's rules run, which is why none is
+ * left unsaid.
+ */
+export interface SpecWarning {
+    location: SourceLocation;
+    /** Which of them, in words that stay the same while the document changes around it. */
+    kind: 'unreadable-status' | 'unclosed-block';
+    message: string;
+}
+/** What hides a directive-shaped comment from being read as a directive. */
+export type MaskedContext = 'fenced code' | 'indented code' | 'code span' | 'raw HTML' | 'front matter';
+/**
+ * A comment shaped like a directive - `<!-- @assert-...` - that was not read as
+ * one, because it sits in text no directive is read from.
+ *
+ * Usually an example, shown on purpose. But which text is code decides which
+ * rules run, and a document whose code ends somewhere other than where its
+ * author thinks - an indented line, a `---` read as front matter - loses its
+ * rules without a word. So they are counted and named, never run.
+ */
+export interface MaskedDirective {
+    location: SourceLocation;
+    inside: MaskedContext;
+}
 export interface ParseResult {
     directives: Directive[];
     errors: DirectiveError[];
     /** The document's declared status, when it declares one. */
     status?: SpecStatus;
+    /** Present only when there is something to say. */
+    warnings?: SpecWarning[];
+    /** Present only when there are any. */
+    masked?: MaskedDirective[];
 }
 /** A spec file whose status withheld its directives from execution. */
 export interface InactiveSpec {
@@ -355,6 +386,18 @@ export interface RunReport {
      * tool exists to prevent.
      */
     inactiveSpecs: InactiveSpec[];
+    /**
+     * What changed how a spec document was read: a status that could not be
+     * read, a block never closed. Not failures, and never left unsaid, since
+     * each decides which of a document's rules run.
+     */
+    specWarnings?: SpecWarning[];
+    /**
+     * Directive-shaped comments in code, raw HTML or front matter, which no rule
+     * was read from. Counted and named, as a withheld document is, so that text
+     * read as code by accident is not a rule gone quiet without a word.
+     */
+    maskedDirectives?: MaskedDirective[];
     /**
      * The project's exclusions, added to every rule that takes `exclude`, and
      * empty when there were none.
@@ -368,4 +411,154 @@ export interface RunReport {
     /** What the command line took from the project's configuration, when it took anything. */
     config?: ConfigUse;
 }
+/**
+ * The bound of a rule a violation was made to cross: its maximum, a minimum
+ * above zero, or, for `@assert-present`, the files it names. ADR-0016.
+ */
+export type ProveClaim = 'max' | 'min' | 'present';
+/** What `spec-guard prove` found for a rule. */
+export type ProveOutcome = 'killed' | 'survived' | 'unprovable';
+/** One change a violation made to the tree, in memory and nowhere else. */
+export interface TreeChange {
+    /** Path relative to the root, forward slashes. */
+    path: string;
+    change: 'added' | 'replaced' | 'removed';
+    /** How many bytes an added or replaced file holds now. */
+    bytes?: number;
+}
+/** A violation made to cross one claim of a rule, and what the rule said about it. */
+export interface ProveProbe {
+    claim: ProveClaim;
+    /** `killed` when the rule failed on the claim; `survived` when it still passed. */
+    outcome: 'killed' | 'survived';
+    /** The violation, as a sentence: what was added, put or removed, and where. */
+    violation: string;
+    changes: TreeChange[];
+    /** The rule's own message over the changed tree. */
+    message: string;
+    /** What the rule counted over the changed tree. */
+    actual: number;
+}
+export interface ProveResult {
+    kind: DirectiveKind;
+    location: SourceLocation;
+    description: string;
+    reason?: string;
+    outcome: ProveOutcome;
+    /** Why no violation could be made, when the outcome is `unprovable`. */
+    unprovable?: string;
+    /**
+     * One probe per claim a violation could be made for, in order: the maximum,
+     * then the minimum. A rule survives when any probe survives.
+     */
+    probes: ProveProbe[];
+    durationMs: number;
+}
+export interface ProveReport {
+    /** Whether no rule survived and every directive could be read. */
+    ok: boolean;
+    root: string;
+    durationMs: number;
+    summary: {
+        specs: number;
+        total: number;
+        killed: number;
+        survived: number;
+        unprovable: number;
+        /** Rules not proved because their document is not in force. */
+        inactive: number;
+    };
+    results: ProveResult[];
+    errors: DirectiveError[];
+    inactiveSpecs: InactiveSpec[];
+    /** As a run's: what changed how a document was read. */
+    specWarnings?: SpecWarning[];
+    /** As a run's: directive-shaped comments no rule was read from. */
+    maskedDirectives?: MaskedDirective[];
+    exclude: string[];
+    config?: ConfigUse;
+    /** Spec files that were read, relative to the root. */
+    specFiles: string[];
+}
+/**
+ * One family of citable documents, as `.spec-guard.json` names it: an id
+ * template whose `{n}` is a run of digits, and a glob naming the documents
+ * with `{n}` standing for the number. ADR-0017.
+ */
+export interface CiteFamily {
+    /** The id as comments write it, e.g. `ADR-{n}`. */
+    id: string;
+    /** The documents, e.g. `docs/adr/{n}-*.md`. */
+    files: string;
+}
+/** What a citation found wrong: the document is not there, or not in force. */
+export type CiteRule = 'ghost-citation' | 'stale-citation';
+/** One citation of a document that does not exist or is no longer in force. */
+export interface CiteFinding {
+    rule: CiteRule;
+    /** A ghost is an error; a stale citation a warning, or an error under `--strict`. */
+    severity: 'error' | 'warning';
+    /** The file whose comment cites, root-relative, forward slashes. */
+    file: string;
+    line: number;
+    column: number;
+    /** The id as the comment wrote it: `ADR-7`, `ADR-0007`. */
+    cited: string;
+    /** The family's id template. */
+    family: string;
+    /** The document cited, when there is one. */
+    document?: string;
+    /** Its status word, for a stale citation. */
+    status?: string;
+    /** The id to cite instead, when the document's status line names one in force. */
+    successor?: string;
+    message: string;
+    /** What to do next. */
+    hint: string;
+}
+/** A family as a report shows it: where it came from, and what it found. */
+export interface CiteFamilyReport extends CiteFamily {
+    /** `config` when `cites` named it; `derived` when read off the spec files. */
+    source: 'config' | 'derived';
+    /** Documents the glob matched. */
+    documents: number;
+}
+/** A file whose comments could not all be read, and why. */
+export interface CiteGap {
+    file: string;
+    reason: 'unreadable' | 'binary' | 'too-large' | 'lost-scan';
+    detail: string;
+}
+export interface CitesReport {
+    /** No ghost, and under `--strict` no stale citation and no file left unread. */
+    ok: boolean;
+    root: string;
+    durationMs: number;
+    families: CiteFamilyReport[];
+    summary: {
+        /** Source files whose comments were read. */
+        files: number;
+        /** Citations found, one per file, line and document. */
+        citations: number;
+        ghosts: number;
+        stale: number;
+        /** Ids another owner qualifies - `spec-core's ADR-0005` - which are that owner's documents, and not checked. */
+        qualified: number;
+        /** Files left unread because no comment syntax is known for their extension. */
+        unclassified: number;
+    };
+    /** Ghost and stale citations, by file, line and column. */
+    findings: CiteFinding[];
+    /** Files that should have been read and could not be read in full. */
+    gaps: CiteGap[];
+    /** The extensions of the files left unclassified, most common first, with their counts. */
+    unclassified: Array<{
+        extension: string;
+        files: number;
+    }>;
+    /** What a reader should know about how the families were chosen. */
+    notes: string[];
+    exclude: string[];
+    config?: ConfigUse;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/vendor/spec-core/jsonrpc/index.d.ts

@@ -0,0 +1,3 @@
+export { classifyRequest, createMcpServer, envelopeIssue, isObject, isRequestId, negotiateLegacyVersion, serveLines, toolError, unknownArguments, ProtocolError, CLIENT_CAPABILITIES_KEY, CLIENT_INFO_KEY, INTERNAL_ERROR, INVALID_PARAMS, INVALID_REQUEST, LEGACY_PROTOCOL_VERSIONS, LEGACY_RESOURCE_NOT_FOUND, METHOD_NOT_FOUND, MODERN_PROTOCOL_VERSIONS, PARSE_ERROR, PROTOCOL_VERSION_KEY, SERVER_INFO_KEY, UNSUPPORTED_PROTOCOL_VERSION, } from './mcp.js';
+export type { ByteSource, Era, ErrorObject, JsonObject, McpServerDefinition, OutgoingMessage, PromptDefinition, RequestId, ResourceProvider, ToolDefinition, ToolOutcome, } from './mcp.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/vendor/spec-core/jsonrpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vendor/spec-core/jsonrpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,UAAU,EACV,GAAG,EACH,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAC"}

package/dist/vendor/spec-core/jsonrpc/index.js

@@ -0,0 +1,2 @@
+export { classifyRequest, createMcpServer, envelopeIssue, isObject, isRequestId, negotiateLegacyVersion, serveLines, toolError, unknownArguments, ProtocolError, CLIENT_CAPABILITIES_KEY, CLIENT_INFO_KEY, INTERNAL_ERROR, INVALID_PARAMS, INVALID_REQUEST, LEGACY_PROTOCOL_VERSIONS, LEGACY_RESOURCE_NOT_FOUND, METHOD_NOT_FOUND, MODERN_PROTOCOL_VERSIONS, PARSE_ERROR, PROTOCOL_VERSION_KEY, SERVER_INFO_KEY, UNSUPPORTED_PROTOCOL_VERSION, } from './mcp.js';
+//# sourceMappingURL=index.js.map

package/dist/vendor/spec-core/jsonrpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/vendor/spec-core/jsonrpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,UAAU,CAAC"}

package/dist/vendor/spec-core/jsonrpc/mcp.d.ts

@@ -0,0 +1,158 @@
+/**
+ * The Model Context Protocol over JSON-RPC 2.0, without an SDK.
+ *
+ * MCP over stdio is JSON-RPC 2.0, one message per line, and what a server must
+ * get right fits here: framing, the two eras of the protocol, and the methods
+ * that serve tools, resources and prompts. The official SDK brings a schema
+ * library and a dependency tree to do the same; every spec-* tool promises no
+ * runtime dependencies. Moved here from spec-guard (its ADR-0012), where it
+ * was first written and measured, so that a second server does not relearn it.
+ *
+ * Two eras, served side by side. Revisions up to 2025-11-25 open with an
+ * `initialize` handshake; 2026-07-28 has none, and every request carries its
+ * protocol version in `_meta`. Clients of both are in use - the newest
+ * revision is not yet the one most clients speak - so each request is
+ * classified on its own, by the rule the TypeScript SDK's server applies: a
+ * request that claims a version in `_meta` is modern and its claim is
+ * validated; anything else, `initialize` included, is legacy.
+ *
+ * Nothing here touches a stream or a file. A server is a function from one
+ * parsed message to the message owed back; `serveLines` binds one to any
+ * source of bytes with `on('data')`, which on Node is `process.stdin`.
+ */
+/** Revisions that carry their version on every request. Newest first. */
+export declare const MODERN_PROTOCOL_VERSIONS: readonly string[];
+/** Revisions negotiated by `initialize`, newest first - the SDK's own list. */
+export declare const LEGACY_PROTOCOL_VERSIONS: readonly string[];
+export declare const PROTOCOL_VERSION_KEY = "io.modelcontextprotocol/protocolVersion";
+export declare const CLIENT_CAPABILITIES_KEY = "io.modelcontextprotocol/clientCapabilities";
+export declare const CLIENT_INFO_KEY = "io.modelcontextprotocol/clientInfo";
+export declare const SERVER_INFO_KEY = "io.modelcontextprotocol/serverInfo";
+export declare const PARSE_ERROR = -32700;
+export declare const INVALID_REQUEST = -32600;
+export declare const METHOD_NOT_FOUND = -32601;
+export declare const INVALID_PARAMS = -32602;
+export declare const INTERNAL_ERROR = -32603;
+/** Resource not found before 2026-07-28, which forbids it in favour of -32602. */
+export declare const LEGACY_RESOURCE_NOT_FOUND = -32002;
+export declare const UNSUPPORTED_PROTOCOL_VERSION = -32022;
+export type RequestId = string | number;
+export type Era = 'legacy' | 'modern';
+export type JsonObject = Record<string, unknown>;
+export interface ErrorObject {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+}
+/** Everything a server here writes. It never sends a request. */
+export type OutgoingMessage = {
+    readonly jsonrpc: '2.0';
+    readonly id: RequestId;
+    readonly result: JsonObject;
+} | {
+    readonly jsonrpc: '2.0';
+    readonly id?: RequestId;
+    readonly error: ErrorObject;
+};
+/** An error that becomes a JSON-RPC error response with its code. */
+export declare class ProtocolError extends Error {
+    readonly code: number;
+    readonly data: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+export declare function isObject(value: unknown): value is JsonObject;
+/** JSON-RPC allows a null id; MCP does not, and wants an integer if a number. */
+export declare function isRequestId(value: unknown): value is RequestId;
+/**
+ * What is wrong with a request's `_meta` once it claims a protocol version,
+ * or `undefined`. A claim is never ignored: a malformed one is an error, not
+ * a reason to fall back to the legacy handling.
+ */
+export declare function envelopeIssue(meta: JsonObject): string | undefined;
+/**
+ * The era a request belongs to, or the error that answers it instead.
+ *
+ * `initialize` is the legacy handshake unless it carries a valid modern claim.
+ * Any other request is modern exactly when `_meta` holds the version key - its
+ * presence is the claim, whatever its value - and legacy otherwise.
+ */
+export declare function classifyRequest(method: string, params: JsonObject | undefined): Era;
+/** The version `initialize` settles on: the one asked for, or the newest legacy one. */
+export declare function negotiateLegacyVersion(requested: unknown): string;
+/** What a tool call produced: text for the model, and the same as data. */
+export interface ToolOutcome {
+    readonly text: string;
+    readonly structured?: JsonObject | undefined;
+    readonly isError?: boolean | undefined;
+}
+export interface ToolDefinition {
+    /** The descriptor `tools/list` returns: name, title, description, inputSchema, annotations. */
+    readonly descriptor: JsonObject & {
+        readonly name: string;
+    };
+    /** Runs the tool. Arguments arrive as an object, unvalidated beyond that. */
+    call(args: JsonObject): Promise<ToolOutcome>;
+}
+export interface ResourceProvider {
+    /** Concrete resources, as `resources/list` returns them. */
+    list(): Promise<readonly JsonObject[]>;
+    /** URI templates, as `resources/templates/list` returns them. */
+    readonly templates?: readonly JsonObject[] | undefined;
+    /** The contents of one resource, or `null` when there is no such resource. */
+    read(uri: string): Promise<readonly JsonObject[] | null>;
+}
+export interface PromptDefinition {
+    /** The descriptor `prompts/list` returns: name, title, description, arguments. */
+    readonly descriptor: JsonObject & {
+        readonly name: string;
+    };
+    /** The messages the prompt expands to, given its arguments as strings. */
+    get(args: Readonly<Record<string, string>>): Promise<JsonObject>;
+}
+export interface McpServerDefinition {
+    readonly name: string;
+    readonly version: string;
+    /** Sent in the handshake: what the server is for, and when to call what. */
+    readonly instructions: string;
+    readonly tools?: readonly ToolDefinition[] | undefined;
+    readonly resources?: ResourceProvider | undefined;
+    readonly prompts?: readonly PromptDefinition[] | undefined;
+    /**
+     * Whether results other than a tool call's may be cached by a modern
+     * client, and for how long. Absent: every result is stale at once and
+     * private, which is right for a server that reads the repository afresh
+     * on each request.
+     */
+    readonly cacheTtlMs?: number | undefined;
+}
+/** A tool's failure, reported to the model rather than as a protocol error it cannot read. */
+export declare function toolError(text: string): ToolOutcome;
+/**
+ * Arguments a tool does not declare, which the model should hear about rather
+ * than have silently dropped. `undefined` when there are none.
+ */
+export declare function unknownArguments(args: JsonObject, allowed: readonly string[]): ToolOutcome | undefined;
+/**
+ * Builds the function that answers one parsed JSON-RPC message: the message
+ * to send back, or `null` when nothing is owed - a notification, or a
+ * response the client should not have sent.
+ */
+export declare function createMcpServer(definition: McpServerDefinition): (message: unknown) => Promise<OutgoingMessage | null>;
+/** Anything that delivers bytes and says when it has finished: `process.stdin`, or a test's stand-in. */
+export interface ByteSource {
+    on(event: 'data', listener: (chunk: Uint8Array) => void): unknown;
+    once(event: 'end', listener: () => void): unknown;
+    once(event: 'error', listener: (error: Error) => void): unknown;
+}
+/**
+ * Serves a handler over newline-delimited JSON-RPC until the input ends.
+ *
+ * Messages are split on `\n`; a CRLF line keeps its `\r`, which JSON reads
+ * as whitespace. Blank lines are skipped, and every response is written as a
+ * single line - `JSON.stringify` never emits a raw newline, which is what the
+ * binding requires. Requests are answered concurrently, in whatever order
+ * they finish. A request the client cancels gets no response. When the input
+ * closes, requests still running finish and then this resolves.
+ */
+export declare function serveLines(input: ByteSource, write: (line: string) => void, handle: (message: unknown) => Promise<OutgoingMessage | null>): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/vendor/spec-core/jsonrpc/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../../src/vendor/spec-core/jsonrpc/mcp.ts"],"names":[],"mappings":"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"}