doc-detective 4.29.1 → 4.31.0

package/dist/lsp/json/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../../src/lsp/json/positions.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,IAAI,EACJ,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAOrD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CASnF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,GACnB,WAAW,GAAG,IAAI,CAWpB;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,QAAQ,EAAE,WAAW,CAAC;IACtB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;CACjB;AASD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CASxE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,EAAE,CA2BlE"}

package/dist/lsp/json/positions.js

@@ -0,0 +1,101 @@
+import { parseTree, findNodeAtLocation, getNodePath, } from "jsonc-parser";
+/**
+ * Parse JSON(-with-comments) into a position-preserving CST. jsonc-parser is
+ * tolerant of the half-typed, comma-trailing states an editor streams, and
+ * collects syntax errors rather than throwing.
+ */
+export function parseJsonTree(text) {
+    const errors = [];
+    const root = parseTree(text, errors, {
+        allowTrailingComma: true,
+        disallowComments: false,
+    });
+    return { root, errors };
+}
+/**
+ * Turn an AJV `instancePath` (`/tests/0/steps/1/goTo`) into path segments,
+ * decoding the JSON-Pointer escapes (`~1`→`/`, `~0`→`~`) and numeric indices.
+ */
+export function instancePathToSegments(instancePath) {
+    if (!instancePath)
+        return [];
+    return instancePath
+        .split("/")
+        .slice(1)
+        .map((seg) => {
+        const unescaped = seg.replace(/~1/g, "/").replace(/~0/g, "~");
+        return /^\d+$/.test(unescaped) ? Number(unescaped) : unescaped;
+    });
+}
+/**
+ * Resolve the source span for an AJV `instancePath`. When the exact node is
+ * absent (e.g. a `required` error names an object whose child doesn't exist),
+ * walks up to the nearest present ancestor so the diagnostic still anchors
+ * somewhere sensible instead of vanishing. Returns `null` only when even the
+ * root can't be located (unparseable input).
+ */
+export function rangeForInstancePath(root, instancePath) {
+    const segments = instancePathToSegments(instancePath);
+    for (let end = segments.length; end >= 0; end--) {
+        const node = end === 0 ? root : findNodeAtLocation(root, segments.slice(0, end));
+        if (node) {
+            return { start: node.offset, end: node.offset + node.length };
+        }
+    }
+    /* c8 ignore next 2 - root is always locatable when this is called with a real tree */
+    return null;
+}
+function visit(node, cb) {
+    cb(node);
+    if (node.children) {
+        for (const child of node.children)
+            visit(child, cb);
+    }
+}
+/**
+ * Build a JSON-Pointer from path segments, escaping `~`→`~0` and `/`→`~1` per
+ * RFC 6901. Shared by the JSON and YAML action-keyed detectors.
+ */
+export function pointerFromPath(segments) {
+    /* c8 ignore next - defensive: callers pass a nested node's path, never the empty root path */
+    if (segments.length === 0)
+        return "";
+    return ("/" +
+        segments
+            .map((s) => String(s).replace(/~/g, "~0").replace(/\//g, "~1"))
+            .join("/"));
+}
+/**
+ * Find every step written as an object carrying an `action` property inside a
+ * `steps` array — the classic Doc Detective mistake (action name as a *value*
+ * under `action`, instead of the compact action-as-key form). Returns the
+ * `"action"` key span (to squiggle) and the step's JSON-Pointer (to suppress
+ * the otherwise-overwhelming `anyOf` schema failures for that same step).
+ */
+export function findActionKeyedSteps(root) {
+    const found = [];
+    visit(root, (node) => {
+        if (node.type !== "property" ||
+            !node.children ||
+            node.children[0]?.value !== "steps") {
+            return;
+        }
+        const arr = node.children[1];
+        if (arr?.type !== "array" || !arr.children)
+            return;
+        for (const el of arr.children) {
+            if (el.type !== "object" || !el.children)
+                continue;
+            const actionProp = el.children.find((p) => p.type === "property" && p.children?.[0]?.value === "action");
+            if (actionProp && actionProp.children) {
+                const keyNode = actionProp.children[0];
+                found.push({
+                    keyRange: { start: keyNode.offset, end: keyNode.offset + keyNode.length },
+                    pointer: pointerFromPath(getNodePath(el)),
+                });
+            }
+        }
+    });
+    return found;
+}
+//# sourceMappingURL=positions.js.map

package/dist/lsp/json/positions.js.map

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

package/dist/lsp/messages.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared diagnostic strings and the AJV-error→message formatter. Kept in its own
+ * module so both the spec pipeline (diagnostics.ts) and the inline pipeline
+ * (inline.ts) can use them without a circular import.
+ */
+/** Diagnostic `source` label shown in the editor gutter/problems panel. */
+export declare const DIAGNOSTIC_SOURCE = "doc-detective";
+/**
+ * The flagship message: the single most common Doc Detective authoring mistake
+ * gets one clear diagnostic instead of the wall of `anyOf` failures the raw
+ * schema produces. Mirrors the plugin's write-blocking hook. Fires only on an
+ * INVALID document/step — a valid legacy v2 form gets the softer deprecation
+ * warning instead.
+ */
+export declare const ACTION_KEYED_MESSAGE: string;
+/**
+ * The version-mixing nudge: a document/step that is *valid* but uses the legacy
+ * v2 `action`-keyed form gets a non-blocking warning steering it to compact v3.
+ */
+export declare const V2_DEPRECATION_MESSAGE = "Legacy v2 step form. Prefer the compact v3 form \u2014 the action name is the key, e.g. `{\"goTo\": \u2026}`.";
+/** Format a single AJV error into a concise human message. */
+export declare function schemaMessage(error: {
+    message?: string;
+    keyword?: string;
+    params?: Record<string, any>;
+}): string;
+//# sourceMappingURL=messages.d.ts.map

package/dist/lsp/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/lsp/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAEQ,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,kHACkE,CAAC;AAEtG,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B,GAAG,MAAM,CAST"}

package/dist/lsp/messages.js

@@ -0,0 +1,33 @@
+/**
+ * Shared diagnostic strings and the AJV-error→message formatter. Kept in its own
+ * module so both the spec pipeline (diagnostics.ts) and the inline pipeline
+ * (inline.ts) can use them without a circular import.
+ */
+/** Diagnostic `source` label shown in the editor gutter/problems panel. */
+export const DIAGNOSTIC_SOURCE = "doc-detective";
+/**
+ * The flagship message: the single most common Doc Detective authoring mistake
+ * gets one clear diagnostic instead of the wall of `anyOf` failures the raw
+ * schema produces. Mirrors the plugin's write-blocking hook. Fires only on an
+ * INVALID document/step — a valid legacy v2 form gets the softer deprecation
+ * warning instead.
+ */
+export const ACTION_KEYED_MESSAGE = 'The action name is the key: write `{"goTo": …}`, not an object with an "action" property. ' +
+    'Each step is `{"<action>": <value>}`.';
+/**
+ * The version-mixing nudge: a document/step that is *valid* but uses the legacy
+ * v2 `action`-keyed form gets a non-blocking warning steering it to compact v3.
+ */
+export const V2_DEPRECATION_MESSAGE = 'Legacy v2 step form. Prefer the compact v3 form — the action name is the key, e.g. `{"goTo": …}`.';
+/** Format a single AJV error into a concise human message. */
+export function schemaMessage(error) {
+    const base = error.message || "does not match the schema";
+    const params = error.params || {};
+    if (error.keyword === "additionalProperties" && params.additionalProperty) {
+        return `${base}: "${params.additionalProperty}"`;
+    }
+    // AJV's `required` message already names the missing property, so `base`
+    // needs no augmentation — it falls through to the return below.
+    return base;
+}
+//# sourceMappingURL=messages.js.map

package/dist/lsp/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/lsp/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,4FAA4F;IAC5F,uCAAuC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,mGAAmG,CAAC;AAEtG,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,KAI7B;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,IAAI,2BAA2B,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,KAAK,sBAAsB,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC1E,OAAO,GAAG,IAAI,MAAM,MAAM,CAAC,kBAAkB,GAAG,CAAC;IACnD,CAAC;IACD,yEAAyE;IACzE,gEAAgE;IAChE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lsp/model.d.ts

@@ -0,0 +1,27 @@
+import { OffsetRange, ActionKeyedStep } from "./json/positions.js";
+/** A syntax error reduced to an offset span + message, format-agnostic. */
+export interface SyntaxErrorSpan {
+    range: OffsetRange;
+    message: string;
+}
+/**
+ * A format-agnostic view of a parsed spec/config buffer. JSON and YAML each
+ * provide one; the diagnostics (and, later, inline) pipeline works against this
+ * interface so the schema/action logic is written once.
+ */
+export interface SpecModel {
+    /** The plain JS value (undefined for empty/unparseable buffers). */
+    value: any;
+    /** Syntax-error spans + messages (empty when the buffer parses cleanly). */
+    syntaxErrors: SyntaxErrorSpan[];
+    /** Source span for an AJV instancePath, or null if unlocatable. */
+    rangeForPath(instancePath: string): OffsetRange | null;
+    /** Steps written in the legacy `action`-keyed form. */
+    actionKeyedSteps(): ActionKeyedStep[];
+}
+/**
+ * Build the right model for a buffer by extension, or null for an unsupported
+ * one. Callers gate on the classifier separately (spec vs config).
+ */
+export declare function buildModel(uri: string, text: string): SpecModel | null;
+//# sourceMappingURL=model.d.ts.map

package/dist/lsp/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/lsp/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,WAAW,EACX,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAQ7B,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,KAAK,EAAE,GAAG,CAAC;IACX,4EAA4E;IAC5E,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,mEAAmE;IACnE,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACvD,uDAAuD;IACvD,gBAAgB,IAAI,eAAe,EAAE,CAAC;CACvC;AAqCD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAItE"}

package/dist/lsp/model.js

@@ -0,0 +1,49 @@
+import { getNodeValue, printParseErrorCode } from "jsonc-parser";
+import { isJsonUri, isYamlUri } from "./gate.js";
+import { parseJsonTree, rangeForInstancePath, findActionKeyedSteps, } from "./json/positions.js";
+import { parseYamlTree, yamlSyntaxErrors, rangeForInstancePathYaml, findActionKeyedStepsYaml, } from "./yaml/positions.js";
+function buildJsonModel(text) {
+    const { root, errors } = parseJsonTree(text);
+    return {
+        value: root ? getNodeValue(root) : undefined,
+        syntaxErrors: errors.map((e) => ({
+            range: { start: e.offset, end: e.offset + e.length },
+            message: `JSON syntax: ${printParseErrorCode(e.error)}`,
+        })),
+        rangeForPath: (path) => (root ? rangeForInstancePath(root, path) : null),
+        actionKeyedSteps: () => (root ? findActionKeyedSteps(root) : []),
+    };
+}
+function buildYamlModel(text) {
+    const { doc, value, valueError } = parseYamlTree(text);
+    const syntaxErrors = yamlSyntaxErrors(doc).map((e) => ({
+        range: e.range,
+        message: `YAML syntax: ${e.message}`,
+    }));
+    // A `toJS()` failure (e.g. an alias bomb) has no single node to blame; anchor
+    // it at the document start so the author still sees the problem.
+    if (valueError) {
+        syntaxErrors.push({
+            range: { start: 0, end: Math.min(text.length, 1) },
+            message: `YAML error: ${valueError}`,
+        });
+    }
+    return {
+        value,
+        syntaxErrors,
+        rangeForPath: (path) => rangeForInstancePathYaml(doc, path),
+        actionKeyedSteps: () => findActionKeyedStepsYaml(doc),
+    };
+}
+/**
+ * Build the right model for a buffer by extension, or null for an unsupported
+ * one. Callers gate on the classifier separately (spec vs config).
+ */
+export function buildModel(uri, text) {
+    if (isJsonUri(uri))
+        return buildJsonModel(text);
+    if (isYamlUri(uri))
+        return buildYamlModel(text);
+    return null;
+}
+//# sourceMappingURL=model.js.map

package/dist/lsp/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/lsp/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAwB7B,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5C,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE;YACpD,OAAO,EAAE,gBAAgB,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;SACxD,CAAC,CAAC;QACH,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,YAAY,GAAsB,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,gBAAgB,CAAC,CAAC,OAAO,EAAE;KACrC,CAAC,CAAC,CAAC;IACJ,8EAA8E;IAC9E,iEAAiE;IACjE,IAAI,UAAU,EAAE,CAAC;QACf,YAAY,CAAC,IAAI,CAAC;YAChB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;YAClD,OAAO,EAAE,eAAe,UAAU,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,KAAK;QACL,YAAY;QACZ,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC;QAC3D,gBAAgB,EAAE,GAAG,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC;KACtD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY;IAClD,IAAI,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lsp/registry.d.ts

@@ -0,0 +1,61 @@
+/** The kind of scalar an action's compact form accepts, if any. */
+export type PrimitiveKind = "string" | "number" | "boolean" | null;
+/**
+ * A field inside an action's object form — used for field-name completion and
+ * (Phase 3) enum-value completion.
+ */
+export interface ActionField {
+    name: string;
+    description?: string;
+    /**
+     * The scalar kind this field accepts, or null for object/array fields. Drives
+     * whether a completion snippet quotes the value placeholder.
+     */
+    primitiveKind: PrimitiveKind;
+    /** Enumerated values, when the field's schema (or a branch) pins them. */
+    enumValues?: Array<string | number | boolean>;
+}
+/** Everything the language features need to know about one action. */
+export interface ActionInfo {
+    /** The action key, which IS the step key (`goTo`, `find`, …). */
+    key: string;
+    title?: string;
+    description?: string;
+    /** True when the compact scalar form (e.g. `"goTo": "https://…"`) is valid. */
+    acceptsPrimitive: boolean;
+    /**
+     * The scalar kind the compact form accepts (`"goTo"` → string, `"wait"` →
+     * number, `"stopRecord"` → boolean), or null for object-only actions. Drives
+     * whether a completion snippet quotes the placeholder.
+     */
+    primitiveKind: PrimitiveKind;
+    /** Fields available inside the object form. */
+    fields: ActionField[];
+}
+export interface Registry {
+    actions: ActionInfo[];
+    byKey: Map<string, ActionInfo>;
+}
+/** Collect the candidate sub-schemas of a schema: itself plus anyOf/oneOf/allOf. */
+export declare function branchesOf(schema: any): any[];
+/** Dig for a human description across a schema and its immediate branches. */
+export declare function findDescription(schema: any): string | undefined;
+/**
+ * The scalar kind a schema (or a branch) accepts in its compact form, or null.
+ * The first primitive type encountered across branches wins.
+ */
+export declare function primitiveKindOf(schema: any): PrimitiveKind;
+/** Does the schema (or a branch) accept a primitive scalar value? */
+export declare function acceptsPrimitive(schema: any): boolean;
+/** Merge the `properties` maps found across a schema's object branches. */
+export declare function collectFields(schema: any): ActionField[];
+/** Pull an enum list from a schema or its branches, if any. */
+export declare function extractEnum(schema: any): Array<string | number | boolean> | undefined;
+/**
+ * Build the action registry from the live `step_v3` schema. Derived at runtime
+ * (not a build step) so a new action added to the schemas automatically appears
+ * in completion/hover — the anti-drift test pins that guarantee.
+ */
+export declare function buildRegistry(step?: any): Registry;
+export declare function getRegistry(): Registry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lsp/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lsp/registry.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,EAAE,aAAa,CAAC;IAC7B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC/C;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,aAAa,EAAE,aAAa,CAAC;IAC7B,+CAA+C;IAC/C,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAChC;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,CAO7C;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAO/D;AAUD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,aAAa,CAU1D;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAErD;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,WAAW,EAAE,CAgBxD;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAKrF;AAgBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,GAAiC,GAAG,QAAQ,CAoB/E;AAID,wBAAgB,WAAW,IAAI,QAAQ,CAGtC"}

package/dist/lsp/registry.js

@@ -0,0 +1,124 @@
+import { schemas } from "../common/src/schemas/index.js";
+/** Collect the candidate sub-schemas of a schema: itself plus anyOf/oneOf/allOf. */
+export function branchesOf(schema) {
+    if (!schema || typeof schema !== "object")
+        return [];
+    const out = [schema];
+    for (const key of ["anyOf", "oneOf", "allOf"]) {
+        if (Array.isArray(schema[key]))
+            out.push(...schema[key]);
+    }
+    return out;
+}
+/** Dig for a human description across a schema and its immediate branches. */
+export function findDescription(schema) {
+    for (const branch of branchesOf(schema)) {
+        if (typeof branch.description === "string" && branch.description.length > 0) {
+            return branch.description;
+        }
+    }
+    return undefined;
+}
+/** Map a JSON-Schema scalar type onto the snippet-relevant primitive kind. */
+function normalizePrimitive(type) {
+    if (type === "string")
+        return "string";
+    if (type === "number" || type === "integer")
+        return "number";
+    if (type === "boolean")
+        return "boolean";
+    return null;
+}
+/**
+ * The scalar kind a schema (or a branch) accepts in its compact form, or null.
+ * The first primitive type encountered across branches wins.
+ */
+export function primitiveKindOf(schema) {
+    for (const branch of branchesOf(schema)) {
+        const type = branch.type;
+        const types = typeof type === "string" ? [type] : Array.isArray(type) ? type : [];
+        for (const t of types) {
+            const kind = normalizePrimitive(t);
+            if (kind)
+                return kind;
+        }
+    }
+    return null;
+}
+/** Does the schema (or a branch) accept a primitive scalar value? */
+export function acceptsPrimitive(schema) {
+    return primitiveKindOf(schema) !== null;
+}
+/** Merge the `properties` maps found across a schema's object branches. */
+export function collectFields(schema) {
+    const seen = new Map();
+    for (const branch of branchesOf(schema)) {
+        const props = branch.properties;
+        if (!props || typeof props !== "object")
+            continue;
+        for (const [name, propSchema] of Object.entries(props)) {
+            if (name === "$schema" || seen.has(name))
+                continue;
+            seen.set(name, {
+                name,
+                description: findDescription(propSchema),
+                primitiveKind: primitiveKindOf(propSchema),
+                enumValues: extractEnum(propSchema),
+            });
+        }
+    }
+    return [...seen.values()];
+}
+/** Pull an enum list from a schema or its branches, if any. */
+export function extractEnum(schema) {
+    for (const branch of branchesOf(schema)) {
+        if (Array.isArray(branch.enum))
+            return branch.enum.slice();
+    }
+    return undefined;
+}
+/**
+ * The `allOf` element of a `step_v3` anyOf branch that carries the action: the
+ * one whose `required` names exactly the action key (never `$schema`).
+ */
+function actionPartOf(branch) {
+    const parts = Array.isArray(branch.allOf) ? branch.allOf : [branch];
+    return parts.find((p) => Array.isArray(p.required) &&
+        p.required.length === 1 &&
+        p.required[0] !== "$schema");
+}
+/**
+ * Build the action registry from the live `step_v3` schema. Derived at runtime
+ * (not a build step) so a new action added to the schemas automatically appears
+ * in completion/hover — the anti-drift test pins that guarantee.
+ */
+export function buildRegistry(step = schemas["step_v3"]) {
+    const actions = [];
+    for (const branch of step.anyOf || []) {
+        const part = actionPartOf(branch);
+        /* c8 ignore next - every step_v3 anyOf branch has an action part; defensive */
+        if (!part)
+            continue;
+        const key = part.required[0];
+        const propSchema = part.properties?.[key];
+        const primitiveKind = primitiveKindOf(propSchema);
+        actions.push({
+            key,
+            title: part.title || key,
+            description: findDescription(propSchema),
+            acceptsPrimitive: primitiveKind !== null,
+            primitiveKind,
+            fields: collectFields(propSchema),
+        });
+    }
+    const byKey = new Map(actions.map((a) => [a.key, a]));
+    return { actions, byKey };
+}
+/** Lazily-built shared registry (the schemas are static within a process). */
+let cached;
+export function getRegistry() {
+    if (!cached)
+        cached = buildRegistry();
+    return cached;
+}
+//# sourceMappingURL=registry.js.map

package/dist/lsp/registry.js.map

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

package/dist/lsp/server.d.ts

@@ -0,0 +1,40 @@
+import { type InitializeResult } from "vscode-languageserver/node.js";
+import type { CompletionItem, CompletionParams, Hover, HoverParams } from "vscode-languageserver";
+import { TextDocument } from "vscode-languageserver-textdocument";
+/**
+ * The subset of a `Connection` the handlers touch. Narrowed to an interface so
+ * tests can drive the wiring with a fake instead of a live stdio transport.
+ */
+export interface DiagnosticsConnection {
+    onInitialize(handler: () => InitializeResult): void;
+    sendDiagnostics(params: {
+        uri: string;
+        diagnostics: unknown[];
+    }): void;
+    onCompletion(handler: (params: CompletionParams) => CompletionItem[]): void;
+    onHover(handler: (params: HoverParams) => Hover | null): void;
+}
+/**
+ * The subset of a `TextDocuments` manager the handlers subscribe to.
+ */
+export interface DocumentEvents {
+    onDidChangeContent(handler: (event: {
+        document: TextDocument;
+    }) => void): void;
+    onDidClose(handler: (event: {
+        document: TextDocument;
+    }) => void): void;
+    get(uri: string): TextDocument | undefined;
+}
+/**
+ * Wire language-server behavior onto a connection + document manager. Pure of
+ * any transport, so a unit test can pass fakes, capture the registered
+ * callbacks, and assert what gets published — no real process required.
+ */
+export declare function registerHandlers(connection: DiagnosticsConnection, documents: DocumentEvents): void;
+/**
+ * Boot the language server over stdio. Called by the `doc-detective lsp`
+ * subcommand.
+ */
+export declare function startServer(): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/lsp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/lsp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,KAAK,EACL,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAKlE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,OAAO,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IACpD,eAAe,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,YAAY,CACV,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,cAAc,EAAE,GACtD,IAAI,CAAC;IACR,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,qBAAqB,EACjC,SAAS,EAAE,cAAc,GACxB,IAAI,CAsCN;AAKD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAclC"}

package/dist/lsp/server.js

@@ -0,0 +1,64 @@
+import { createConnection, TextDocuments, ProposedFeatures, StreamMessageReader, StreamMessageWriter, TextDocumentSyncKind, } from "vscode-languageserver/node.js";
+import { TextDocument } from "vscode-languageserver-textdocument";
+import { computeDiagnostics } from "./diagnostics.js";
+import { computeCompletions } from "./completion.js";
+import { computeHover } from "./hover.js";
+/**
+ * Wire language-server behavior onto a connection + document manager. Pure of
+ * any transport, so a unit test can pass fakes, capture the registered
+ * callbacks, and assert what gets published — no real process required.
+ */
+export function registerHandlers(connection, documents) {
+    connection.onInitialize(() => ({
+        capabilities: {
+            // Full sync keeps Phase 1 simple; jsonc-parser reparses the whole buffer
+            // on each change anyway, so incremental patching buys nothing yet.
+            textDocumentSync: TextDocumentSyncKind.Full,
+            completionProvider: { triggerCharacters: ['"', "{"] },
+            hoverProvider: true,
+        },
+    }));
+    const publish = (document) => {
+        connection.sendDiagnostics({
+            uri: document.uri,
+            diagnostics: computeDiagnostics(document),
+        });
+    };
+    // Fires on open and on every edit — the single hook we need for live
+    // diagnostics.
+    documents.onDidChangeContent((event) => publish(event.document));
+    // Clear diagnostics when a document closes so stale squiggles don't linger.
+    documents.onDidClose((event) => connection.sendDiagnostics({ uri: event.document.uri, diagnostics: [] }));
+    connection.onCompletion((params) => {
+        const document = documents.get(params.textDocument.uri);
+        if (!document)
+            return [];
+        return computeCompletions(document, params.position);
+    });
+    connection.onHover((params) => {
+        const document = documents.get(params.textDocument.uri);
+        if (!document)
+            return null;
+        return computeHover(document, params.position);
+    });
+}
+/* c8 ignore start - real stdio bootstrap: no injectable seam; the pure wiring
+   in registerHandlers is unit-tested, and the whole server is exercised
+   end-to-end by the spawned protocol test. */
+/**
+ * Boot the language server over stdio. Called by the `doc-detective lsp`
+ * subcommand.
+ */
+export function startServer() {
+    // Explicit stdio streams so the server works no matter how it's launched —
+    // the `doc-detective lsp` subcommand OR the bare `doc-detective-lsp` bin.
+    // (createConnection(ProposedFeatures.all) alone sniffs argv for `--stdio`,
+    // which the bare bin doesn't pass.)
+    const connection = createConnection(ProposedFeatures.all, new StreamMessageReader(process.stdin), new StreamMessageWriter(process.stdout));
+    const documents = new TextDocuments(TextDocument);
+    registerHandlers(connection, documents);
+    documents.listen(connection);
+    connection.listen();
+}
+/* c8 ignore stop */
+//# sourceMappingURL=server.js.map

package/dist/lsp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/lsp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwB1C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAiC,EACjC,SAAyB;IAEzB,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7B,YAAY,EAAE;YACZ,yEAAyE;YACzE,mEAAmE;YACnE,gBAAgB,EAAE,oBAAoB,CAAC,IAAI;YAC3C,kBAAkB,EAAE,EAAE,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;YACrD,aAAa,EAAE,IAAI;SACpB;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GAAG,CAAC,QAAsB,EAAE,EAAE;QACzC,UAAU,CAAC,eAAe,CAAC;YACzB,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,WAAW,EAAE,kBAAkB,CAAC,QAAQ,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,qEAAqE;IACrE,eAAe;IACf,SAAS,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjE,4EAA4E;IAC5E,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7B,UAAU,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CACzE,CAAC;IAEF,UAAU,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;8CAE8C;AAC9C;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,2EAA2E;IAC3E,0EAA0E;IAC1E,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,UAAU,GAAe,gBAAgB,CAC7C,gBAAgB,CAAC,GAAG,EACpB,IAAI,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,EACtC,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CACxC,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;IAClD,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACxC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7B,UAAU,CAAC,MAAM,EAAE,CAAC;AACtB,CAAC;AACD,oBAAoB"}

package/dist/lsp/yaml/positions.d.ts

@@ -0,0 +1,32 @@
+import YAML from "yaml";
+import type { OffsetRange, ActionKeyedStep } from "../json/positions.js";
+/** Result of parsing YAML: the document (for node lookups) plus its value. */
+export interface YamlParse {
+    doc: YAML.Document.Parsed;
+    value: any;
+    /** Set when `doc.toJS()` threw (e.g. an alias-bomb exceeding maxAliasCount). */
+    valueError?: string;
+}
+/** Parse YAML into a position-preserving document plus its plain JS value. */
+export declare function parseYamlTree(text: string): YamlParse;
+/** A YAML syntax error reduced to an offset span and message. */
+export interface YamlSyntaxError {
+    range: OffsetRange;
+    message: string;
+}
+/** Collect YAML syntax errors as offset spans (empty when the doc is clean). */
+export declare function yamlSyntaxErrors(doc: YAML.Document.Parsed): YamlSyntaxError[];
+/**
+ * Resolve the source span for an AJV `instancePath` in a YAML document. Walks
+ * up to the nearest present ancestor (like the JSON resolver) so a
+ * `required`-style error still anchors somewhere. Returns null only when even
+ * the document contents can't be located.
+ */
+export declare function rangeForInstancePathYaml(doc: YAML.Document.Parsed, instancePath: string): OffsetRange | null;
+/**
+ * Find every step written as a map carrying an `action` key inside a `steps`
+ * sequence — the YAML twin of the JSON detector. Returns the offending `action`
+ * key span and the step's JSON-Pointer.
+ */
+export declare function findActionKeyedStepsYaml(doc: YAML.Document.Parsed): ActionKeyedStep[];
+//# sourceMappingURL=positions.d.ts.map

package/dist/lsp/yaml/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../../src/lsp/yaml/positions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGzE,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,GAAG,CAAC;IACX,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAarD;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,eAAe,EAAE,CAK7E;AASD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EACzB,YAAY,EAAE,MAAM,GACnB,WAAW,GAAG,IAAI,CAUpB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GACxB,eAAe,EAAE,CAqCnB"}