@descryy/mcp 0.11.4 → 0.11.5

package/dist/browser/fault-attribution.js

@@ -1,266 +0,0 @@
-/**
- * When a browser action fails: whose fault was it?
- *
- * ## This concept did not already exist
- *
- * `browser-reliability.md` §4.5 says "the product already carries this
- * concept". Checked before building: it does not. `descry-runtime` has four
- * incidental uses of the word "attributable" — a log envelope naming its
- * unwrapper, evidence carrying a process id, a correlator comment about not
- * blaming a producer, a test runner locating a fact — and no fault-domain type,
- * no owner vocabulary and nothing that decides between them. The nearest real
- * neighbours are `@descryy/ir`'s five **result states** and five **report
- * categories**, and both answer a different question: they say how much Descry
- * can claim, never who broke it. So this is new, and it is deliberately shaped
- * like its neighbours — a small closed vocabulary, one function that decides,
- * and an explicit value for "do not know".
- *
- * ## The one rule everything else serves
- *
- * **A timeout with nothing corroborating it is never the application's fault.**
- * A wait that expired is a fact about Descry: the page did not reach a state
- * Descry was waiting for, within a budget Descry chose. It is equally
- * consistent with a broken button, a slow one, an overlay, and an animation.
- * Reporting it as the user's bug is the single fastest way to make a testing
- * tool untrusted, and the cost of being wrong is asymmetric — an
- * `undetermined` that was really a bug costs one missed finding, and an
- * `application` that was really our timeout costs the tool's credibility.
- * That is rule 2 (precision over recall) applied to blame rather than to edges.
- *
- * So `application` is only ever named with a **first-party corroborating
- * signal** in the same window: the page threw, or a request to the
- * application's own origin failed. Never on the timeout alone.
- *
- * ## Where the corroborating signal comes from (C3)
- *
- * It does not exist yet when the failure happens. The recording decorator sees
- * the throw and must not drain evidence to enrich it — evidence is drained, not
- * peeked, and reading it there would steal what the calling tool is about to
- * report. So `attributeActionFailure` runs on the error and the clock alone and
- * most real failures start `undetermined`, which is the honest answer to what
- * it was given. `evidenceInWindow` and `refineAttribution` below are the second
- * half: the next drain of that session hands over what the page actually
- * produced, the counts are narrowed to the failed action's own window, and the
- * attribution is re-decided once. Wired at the two places a drain happens —
- * `observeAndCorrelate` for every evidence-bearing tool call, and the
- * registry's `reap` for the tail no tool call ever returns.
- */
-import { BrowserSessionCrashedError, isFailedRequest, UnknownElementRefError } from "./driver.js";
-/**
- * The four fault domains, plus the fifth value that keeps the other four
- * honest. `undetermined` is not a failure to classify — it is the correct
- * answer whenever the evidence does not reach one of the four, and a
- * vocabulary without it would force every case into a guess.
- */
-export const FAULT_OWNERS = ["application", "automation", "environment", "dependency", "undetermined"];
-/** Playwright's expiry reads as a message, not a type, on the far side of the
- *  port. Matching it is a heuristic and is treated as one: a false positive
- *  only ever routes to `undetermined`, which is where an unrecognised error
- *  goes anyway. */
-function looksLikeExpiry(error) {
-    const text = error instanceof Error ? `${error.name} ${error.message}` : String(error);
-    return /timeout|timed out|exceeded/i.test(text);
-}
-export function attributeActionFailure(failure) {
-    const { error, verb, pageErrors, failedRequests, thirdPartyFailedRequests } = failure;
-    if (error instanceof UnknownElementRefError) {
-        return {
-            owner: "automation",
-            reason: `Descry tried to ${verb} an element it no longer had a valid handle for.`,
-            evidence: "The ref named no element in the session's current snapshot — it was invented or it was superseded.",
-        };
-    }
-    if (error instanceof BrowserSessionCrashedError) {
-        return {
-            owner: "environment",
-            reason: "The browser process went away mid-action, so nothing about the page was established.",
-            evidence: "The session reported itself unusable before the action could complete.",
-        };
-    }
-    // Corroboration first, expiry second. A page that threw while Descry waited
-    // is a first-party signal and outranks the wait; the wait alone never does.
-    if (pageErrors > 0) {
-        return {
-            owner: "application",
-            reason: `The page raised errors of its own while Descry was waiting to ${verb}.`,
-            evidence: `${pageErrors} console error${pageErrors === 1 ? "" : "s"} in the same window as the failed action.`,
-        };
-    }
-    if (failedRequests > 0) {
-        if (thirdPartyFailedRequests >= failedRequests) {
-            return {
-                owner: "dependency",
-                reason: `Every request that failed while Descry was waiting to ${verb} went to a third-party origin.`,
-                evidence: `${failedRequests} failed request${failedRequests === 1 ? "" : "s"}, all of them off the application's own origin.`,
-            };
-        }
-        const firstParty = failedRequests - thirdPartyFailedRequests;
-        return {
-            owner: "application",
-            reason: `Requests to the application's own origin failed while Descry was waiting to ${verb}.`,
-            evidence: `${firstParty} of ${failedRequests} failed request${failedRequests === 1 ? "" : "s"} were first-party.`,
-        };
-    }
-    if (looksLikeExpiry(error)) {
-        return {
-            owner: "undetermined",
-            reason: `The element did not become actionable within the time Descry waited, and nothing else was observed ` +
-                `that would say why. A slow page, a covering overlay and a broken ${verb} target all look like this.`,
-            evidence: `The ${verb} expired after ${failure.elapsedMs} ms with no console error and no failed request alongside it.`,
-        };
-    }
-    return {
-        owner: "undetermined",
-        reason: `The ${verb} failed for a reason Descry could not place in any of the four fault domains.`,
-        evidence: `${error instanceof Error ? `${error.name}: ${error.message}` : String(error)} after ${failure.elapsedMs} ms, with nothing else observed.`,
-    };
-}
-/**
- * Counts, out of one drained observation, only what happened **inside a failed
- * action's own window**.
- *
- * ## Why the window, and not the drain
- *
- * A drain is not a window. A drained observation covers everything since the
- * last drain, which — because a failed verb throws and the tool never gets to
- * drain — routinely includes a later, unrelated action. Counting the whole
- * drain would let a console error caused by the *next* click decide who broke
- * the previous one, and it would say so in the report's voice. The action's own
- * start and end are recorded by the decorator for exactly this, and everything
- * outside them is discarded rather than discounted.
- *
- * ## What is excluded, and why each exclusion goes the same way
- *
- * A timestamp that will not parse, a request URL that will not parse, and an
- * `unattributed` request all resolve *away* from `application`. That is not
- * symmetry for its own sake: the asymmetric cost this module was built around
- * says an `undetermined` that was really a bug costs one finding, and an
- * `application` that was really Descry's own timeout costs the tool. So an
- * unreadable URL is counted as third-party (it cannot name the application), an
- * unreadable timestamp is counted as outside the window, and a request whose
- * terminal event could not be assigned to it is not counted as a failure at
- * all — otherwise C3's own refusal to guess a join would come straight back as
- * a guess about blame.
- */
-export function evidenceInWindow(observation, window, applicationOrigin) {
-    const inside = (at) => {
-        const ms = Date.parse(at);
-        return Number.isFinite(ms) && ms >= window.from && ms <= window.to;
-    };
-    const failed = observation.requests.filter((request) => request.outcome !== "unattributed" && isFailedRequest(request) && inside(request.at));
-    const thirdParty = failed.filter((request) => {
-        try {
-            return new URL(request.url).origin !== applicationOrigin;
-        }
-        catch {
-            return true;
-        }
-    });
-    return {
-        pageErrors: observation.consoleErrors.filter((error) => inside(error.at)).length,
-        failedRequests: failed.length,
-        thirdPartyFailedRequests: thirdParty.length,
-    };
-}
-/**
- * Re-decide an attribution once evidence that was not available at the moment
- * of failure has arrived. Only ever called on `undetermined`: an attribution
- * that already reached one of the four rested on a signal this later evidence
- * cannot withdraw, and silently rewriting it would make the same failure read
- * two ways in two replies.
- */
-export function refineAttribution(attribution, failure, later) {
-    if (attribution.owner !== "undetermined")
-        return attribution;
-    const refined = attributeActionFailure({
-        ...failure,
-        pageErrors: failure.pageErrors + later.pageErrors,
-        failedRequests: failure.failedRequests + later.failedRequests,
-        thirdPartyFailedRequests: failure.thirdPartyFailedRequests + later.thirdPartyFailedRequests,
-    });
-    if (refined.owner === "undetermined")
-        return attribution;
-    return { ...refined, evidence: `${refined.evidence} (observed after the action, in the next evidence this session flushed)` };
-}
-export function faultNote(attribution) {
-    return `Fault: ${attribution.owner}. ${attribution.reason} ${attribution.evidence}`;
-}
-/**
- * RG-12(b): the vocabulary reconciliation. The site names three layers to a
- * user — "your product", "your environment", "a dependency" — and this
- * module's own five values are `application`, `automation`, `environment`,
- * `dependency`, `undetermined`. Two real gaps, not one:
- *
- * 1. `automation` (Descry's *own* fault — a bad ref, a stale handle, a
- *    harness bug) has nowhere to go in the site's three layers, and it is
- *    the one value that most protects a user's trust: folding it into
- *    "your environment" would let Descry's own mistake read as the user's
- *    infrastructure being at fault, which is backwards.
- * 2. `undetermined` has nowhere to go either, and collapsing it into any of
- *    the three would state a layer the evidence did not actually reach.
- *
- * **Recommendation (implemented here, not on the site — that copy is a
- * different lane's to change): the site gains a fourth and fifth category
- * rather than losing this module's granularity.** "Descry itself" for
- * `automation` (visible, not hidden — this is the layer that most needs to
- * be named when the tool is the one that got it wrong) and "not
- * determined" for `undetermined` (an honest refusal is not a hidden
- * failure). No code value is deleted to fit the narrower copy; this
- * function is the one place that maps the closed five-value set onto
- * display text, so a copy change only ever touches this map.
- */
-export const FAULT_OWNER_DISPLAY_LABELS = {
-    application: "your product",
-    automation: "Descry itself",
-    environment: "your environment",
-    dependency: "a dependency",
-    undetermined: "not determined",
-};
-/**
- * RG-12(c): the type-level half of "every failure carries a layer, by
- * construction, not by convention." A `switch` with no `default` fails to
- * compile the moment `FAULT_OWNERS` gains or loses a value without this
- * function being updated to match — the same guarantee `ActionRecord`'s
- * discriminated union (`reachability.ts`) gives the *presence* of an
- * attribution; this is what gives the *display* side the same guarantee.
- */
-export function faultOwnerDisplayLabel(owner) {
-    switch (owner) {
-        case "application":
-            return FAULT_OWNER_DISPLAY_LABELS.application;
-        case "automation":
-            return FAULT_OWNER_DISPLAY_LABELS.automation;
-        case "environment":
-            return FAULT_OWNER_DISPLAY_LABELS.environment;
-        case "dependency":
-            return FAULT_OWNER_DISPLAY_LABELS.dependency;
-        case "undetermined":
-            return FAULT_OWNER_DISPLAY_LABELS.undetermined;
-        default: {
-            // Exhaustiveness check: if FAULT_OWNERS ever gains a member, `owner`
-            // stops being `never` here and this file fails to compile — the
-            // enforcement is at build time, not at review time.
-            const exhaustive = owner;
-            throw new Error(`faultOwnerDisplayLabel: unhandled FaultOwner ${String(exhaustive)}`);
-        }
-    }
-}
-/**
- * RG-12(c): the run-level half. Not a convention check — `ActionRecord`'s
- * discriminated union already makes `{ succeeded: false, attribution: null }`
- * uncoinstructable inside this module. This is the belt for a caller
- * reaching in from outside the type system (a cast, a deserialised record,
- * a future refactor that widens the type back out) — the same "trust but
- * verify" `report()`'s own filter used to need before the union made it
- * unnecessary there. Throws by name rather than silently dropping the
- * finding, which is the failure mode this whole item exists to close.
- */
-export function assertEveryFailureAttributed(actions) {
-    for (const action of actions) {
-        if (!action.succeeded && (action.attribution === null || action.attribution === undefined)) {
-            throw new Error("assertEveryFailureAttributed: a failed action carries no FaultAttribution. Every reportable failure " +
-                "must carry a layer — a failure with none must not reach a report at all.");
-        }
-    }
-}
-//# sourceMappingURL=fault-attribution.js.map

package/dist/browser/fault-attribution.js.map

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

package/dist/browser/graph-write.d.ts

@@ -1,45 +0,0 @@
-/**
- * §5.4: joins a real browser action to a real R4 edge — witnessed, not the
- * R1 string-match `impact`/`propagation` already do. Precision over recall:
- * anything unresolvable (no stack, no endpoint, ambiguous) drops the observation entirely rather than writing a weak edge. Never mints a denial.
- */
-import type { SqlDriver } from "@descryy/core";
-import { type ObservedRequest } from "./driver.ts";
-/** A graph node this browser evidence actually reached — §5.3's "any graph node reached, surfaced in the same reply". */
-export interface ReachedNode {
-    readonly nodeId: string;
-    readonly name: string;
-    readonly type: string;
-    /** The request that reached it, so a reader can see which action this was. */
-    readonly via: {
-        readonly method: string;
-        readonly url: string;
-        readonly status: number | null;
-    };
-}
-export interface BrowserGraphWrite {
-    /** Endpoints the page's own requests resolved to, whether or not an edge was written. */
-    readonly reached: readonly ReachedNode[];
-    /** Existing edges promoted to R4 by this observation. */
-    readonly promoted: readonly string[];
-    /** Edges the structural side never named, minted at R4 — the recall gap closing. */
-    readonly created: readonly string[];
-    /** Reasons an observation was declined. Kept, because a silent drop is indistinguishable from nothing having happened. */
-    readonly refused: readonly string[];
-    /** R4-vs-R4 disagreements, passed through untouched — this module does not adjudicate them. */
-    readonly contradictions: readonly string[];
-}
-export declare const NO_GRAPH_WRITE: BrowserGraphWrite;
-export interface BrowserGraphWriteInput {
-    readonly driver: SqlDriver;
-    readonly repo: string;
-    readonly runId: string;
-    readonly commitSha: string;
-    readonly repoRoot: string;
-    readonly requests: readonly ObservedRequest[];
-}
-/** Correlates what the page did against the graph, recording only what was genuinely witnessed. Runs over every request, not just failures — a successful call is what proves the arrow. */
-export declare function writeBrowserObservations(input: BrowserGraphWriteInput): BrowserGraphWrite;
-/** What a reply says about a write. Empty when nothing was reached — silence about nothing is not a disclosure gap. */
-export declare function graphWriteNotes(write: BrowserGraphWrite, requests: readonly ObservedRequest[]): string[];
-//# sourceMappingURL=graph-write.d.ts.map

package/dist/browser/graph-write.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph-write.d.ts","sourceRoot":"","sources":["../../src/browser/graph-write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpE,yHAAyH;AACzH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACjG;AAED,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0HAA0H;IAC1H,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,eAAO,MAAM,cAAc,EAAE,iBAA+F,CAAC;AAE7H,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,4LAA4L;AAC5L,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CA6DzF;AAED,uHAAuH;AACvH,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,EAAE,CA8CxG"}

package/dist/browser/graph-write.js

@@ -1,103 +0,0 @@
-/**
- * §5.4: joins a real browser action to a real R4 edge — witnessed, not the
- * R1 string-match `impact`/`propagation` already do. Precision over recall:
- * anything unresolvable (no stack, no endpoint, ambiguous) drops the observation entirely rather than writing a weak edge. Never mints a denial.
- */
-import { confirmObservedFrontendCaller, resolveEndpointNode } from "@descryy/runtime-graph-correlator";
-import { isFailedRequest } from "./driver.js";
-export const NO_GRAPH_WRITE = { reached: [], promoted: [], created: [], refused: [], contradictions: [] };
-/** Correlates what the page did against the graph, recording only what was genuinely witnessed. Runs over every request, not just failures — a successful call is what proves the arrow. */
-export function writeBrowserObservations(input) {
-    const reached = [];
-    const promoted = [];
-    const created = [];
-    const refused = [];
-    const contradictions = [];
-    const seen = new Set();
-    for (const request of input.requests) {
-        let path;
-        try {
-            path = new URL(request.url).pathname;
-        }
-        catch {
-            continue;
-        }
-        const resolution = resolveEndpointNode(input.driver, request.method, path);
-        if (resolution.outcome !== "resolved") {
-            // Not worth reporting per request: a page issues requests for
-            // stylesheets, images and third-party origins, none meant to be an
-            // endpoint here — reporting each miss would bury the real ones.
-            continue;
-        }
-        const endpoint = resolution.node;
-        const key = `${endpoint.id}::${request.method}::${path}`;
-        if (!seen.has(key)) {
-            seen.add(key);
-            reached.push({
-                nodeId: endpoint.id,
-                name: endpoint.name,
-                type: endpoint.type,
-                via: { method: request.method, url: request.url, status: request.status },
-            });
-        }
-        if (request.stackTrace === null) {
-            // Endpoint reached, but no parsed stack means no caller edge — disclosed rather than dropped ("saw the hit, not the source" is still useful).
-            refused.push(`${request.method} ${path} reached ${endpoint.name}, but no parsed call-site stack was captured, so no ` +
-                "caller edge was written. Name a stackParser on browser_start_session to capture one.");
-            continue;
-        }
-        const outcome = confirmObservedFrontendCaller(input.driver, {
-            endpointNodeId: endpoint.id,
-            stackTrace: request.stackTrace,
-            repo: input.repo,
-            runId: input.runId,
-            commitSha: input.commitSha,
-            repoRoot: input.repoRoot,
-        });
-        promoted.push(...outcome.confirmation.promoted);
-        created.push(...outcome.confirmation.created);
-        refused.push(...outcome.confirmation.refused.map((r) => r.reason));
-        contradictions.push(...outcome.confirmation.contradictions.map((c) => c.detail));
-    }
-    return { reached, promoted, created, refused, contradictions };
-}
-/** What a reply says about a write. Empty when nothing was reached — silence about nothing is not a disclosure gap. */
-export function graphWriteNotes(write, requests) {
-    const notes = [];
-    const confirmed = write.promoted.length + write.created.length;
-    if (confirmed > 0) {
-        notes.push(`${confirmed} frontend→backend edge(s) were confirmed at resolution 4 from this run — ` +
-            `${write.promoted.length} existing edge(s) promoted, ${write.created.length} minted that static ` +
-            "analysis had not found. These are witnessed, not name-matched: a real request carrying a real " +
-            "call-site stack. impact and propagation read them with no further action.");
-    }
-    if (write.reached.length > 0 && confirmed === 0) {
-        notes.push(`${write.reached.length} endpoint(s) in the graph were reached by this page, but no caller edge was ` +
-            "written — see data.graph.refused for why. The endpoints are named so the gap is visible rather than absent.");
-    }
-    // Always stated, not only when non-empty (F7, UAT Phase 5): `contradictions`
-    // covers one narrow thing — an observation disagreeing with an existing R4
-    // edge — and an empty array reads as "nothing disagreed" unless the scope is
-    // named. It has no relationship to `confirmedFacts` in `.descry/config.json`
-    // and never consults them, so a real disagreement between this run's
-    // observations and a developer-confirmed fact (an env URL, say) produces no
-    // note here at all — not because nothing disagreed, but because nothing
-    // looked. Stated whenever there is something to state it about, i.e.
-    // whenever this run actually reached or confirmed anything.
-    if (confirmed > 0 || write.reached.length > 0 || write.contradictions.length > 0) {
-        notes.push(write.contradictions.length > 0
-            ? `${write.contradictions.length} observation(s) disagree with an existing R4 edge. Reported, not resolved: ` +
-                "adjudicating two runtime observations against each other is not this call's job."
-            : "No R4 edge disagreed with this run's observations. This checks observation-versus-stored-R4-edge " +
-                'only — it does not compare against a developer-confirmed fact in .descry/config.json\'s ' +
-                '"confirmedFacts" (an env URL, say); nothing in this surface does that today.');
-    }
-    const unexplained = requests.filter((r) => r.stackTrace === null && !isFailedRequest(r)).length;
-    if (unexplained > 0 && confirmed === 0 && write.reached.length === 0) {
-        notes.push(`${requests.length} request(s) were observed and none resolved to an endpoint in the graph. If this ` +
-            "repository has not been analysed, run analyze first — nothing here can be related to code the graph " +
-            "does not hold.");
-    }
-    return notes;
-}
-//# sourceMappingURL=graph-write.js.map

package/dist/browser/graph-write.js.map

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

package/dist/browser/identity-graph-write.d.ts

@@ -1,55 +0,0 @@
-/**
- * The graph half of B1: `symbolLocationForGraph` (`@descryy/runtime-identity-grounding`)
- * already hands `resolveSymbolNode` (`@descryy/runtime-graph-correlator`) exactly its own
- * input shape and stops — its own header says so, deliberately, because a compiled location
- * is withheld there rather than passed through as if it were authored source. This file is
- * the hand-off itself: wiring, not a second resolver. It does not duplicate
- * `resolveSymbolNode`'s ambiguity refusal, line-mismatch reporting or path translation — it
- * calls it and restates the outcome in this package's own node shape.
- *
- * No new node type, no new edge type: this resolves to a `FUNCTION`/`CLASS` node an adapter
- * already produced. `descry-core`'s frozen 15/15 vocabulary is untouched.
- */
-import type { SqlDriver } from "@descryy/core";
-import { type ElementIdentity } from "@descryy/runtime-identity-grounding";
-/** The graph node an identity resolved to — only what a caller needs to name it, never the
- *  full `IRNode` (this package does not depend on `@descryy/ir`'s node shape beyond id/name/type). */
-export interface IdentityGraphNode {
-    readonly nodeId: string;
-    readonly name: string;
-    readonly type: string;
-}
-export type IdentityGraphOutcome = {
-    readonly outcome: "resolved";
-    readonly node: IdentityGraphNode;
-} | {
-    readonly outcome: "line-mismatch";
-    readonly node: IdentityGraphNode;
-    readonly reason: string;
-} | {
-    readonly outcome: "not-found";
-    readonly reason: string;
-} | {
-    readonly outcome: "ambiguous";
-    readonly reason: string;
-}
-/** Identity grounding did not produce a graph-eligible location for this element at all —
- *  a refusal, a component named with no location, or a compiled location deliberately
- *  withheld by `symbolLocationForGraph`. The element's own `identity` field already says
- *  which; this outcome exists so a caller asking "does this reach the graph" gets one
- *  answer without re-deriving it from `ElementIdentity`'s three-way split. */
- | {
-    readonly outcome: "withheld";
-    readonly reason: string;
-};
-/**
- * Resolves one grounded element to the graph node an adapter already produced from the same
- * source. `repo` has no honest default (`resolveSymbolNode`'s own discipline — DEC-054, a
- * session can hold two same-named, same-relative-path symbols from different repos), so it is
- * required here too.
- */
-export declare function resolveIdentityGraphNode(driver: SqlDriver, identity: ElementIdentity, repo: string, options?: {
-    readonly repoRoot?: string;
-    readonly cwd?: string;
-}): IdentityGraphOutcome;
-//# sourceMappingURL=identity-graph-write.d.ts.map

package/dist/browser/identity-graph-write.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity-graph-write.d.ts","sourceRoot":"","sources":["../../src/browser/identity-graph-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEnG;sGACsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC5D;;;;8EAI8E;GAC5E;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,oBAAoB,CAsBtB"}

package/dist/browser/identity-graph-write.js

@@ -1,45 +0,0 @@
-/**
- * The graph half of B1: `symbolLocationForGraph` (`@descryy/runtime-identity-grounding`)
- * already hands `resolveSymbolNode` (`@descryy/runtime-graph-correlator`) exactly its own
- * input shape and stops — its own header says so, deliberately, because a compiled location
- * is withheld there rather than passed through as if it were authored source. This file is
- * the hand-off itself: wiring, not a second resolver. It does not duplicate
- * `resolveSymbolNode`'s ambiguity refusal, line-mismatch reporting or path translation — it
- * calls it and restates the outcome in this package's own node shape.
- *
- * No new node type, no new edge type: this resolves to a `FUNCTION`/`CLASS` node an adapter
- * already produced. `descry-core`'s frozen 15/15 vocabulary is untouched.
- */
-import { resolveSymbolNode } from "@descryy/runtime-graph-correlator";
-import { symbolLocationForGraph } from "@descryy/runtime-identity-grounding";
-/**
- * Resolves one grounded element to the graph node an adapter already produced from the same
- * source. `repo` has no honest default (`resolveSymbolNode`'s own discipline — DEC-054, a
- * session can hold two same-named, same-relative-path symbols from different repos), so it is
- * required here too.
- */
-export function resolveIdentityGraphNode(driver, identity, repo, options = {}) {
-    const location = symbolLocationForGraph(identity);
-    if (location === null) {
-        return {
-            outcome: "withheld",
-            reason: "identity grounding did not produce an authored file and symbol for this element — see the " +
-                "element's own identity outcome (grounded/component-only/refused) for why.",
-        };
-    }
-    const resolution = resolveSymbolNode(driver, location, repo, options);
-    switch (resolution.outcome) {
-        case "resolved":
-            return { outcome: "resolved", node: toGraphNode(resolution.node) };
-        case "line-mismatch":
-            return { outcome: "line-mismatch", node: toGraphNode(resolution.node), reason: resolution.reason };
-        case "not-found":
-            return { outcome: "not-found", reason: resolution.reason };
-        case "ambiguous":
-            return { outcome: "ambiguous", reason: resolution.reason };
-    }
-}
-function toGraphNode(node) {
-    return { nodeId: node.id, name: node.name, type: node.type };
-}
-//# sourceMappingURL=identity-graph-write.js.map

package/dist/browser/identity-graph-write.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity-graph-write.js","sourceRoot":"","sources":["../../src/browser/identity-graph-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAwB,MAAM,qCAAqC,CAAC;AAsBnG;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,QAAyB,EACzB,IAAY,EACZ,UAAiE,EAAE;IAEnE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,MAAM,EACJ,4FAA4F;gBAC5F,2EAA2E;SAC9E,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,QAAQ,UAAU,CAAC,OAAO,EAAE,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,KAAK,eAAe;YAClB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACrG,KAAK,WAAW;YACd,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QAC7D,KAAK,WAAW;YACd,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAA2E;IAC9F,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC"}

package/dist/browser/page-probe.d.ts

@@ -1,81 +0,0 @@
-/**
- * The in-page half of the capability probe: one function, serialized into the
- * page, that counts the shapes `capability-probe.ts` turns into a reach
- * estimate.
- *
- * ## Why it lives here and not in the driver
- *
- * `playwright-driver.ts` is one lane's file and this is another's. Keeping the
- * probe body here means the driver gains a six-line delegating method rather
- * than two hundred lines of DOM walking, which is the difference between a
- * mergeable change and a rewritten file.
- *
- * ## Structural DOM types, again, and why
- *
- * `tsc` omits the DOM lib on purpose repo-wide — pulling it in would put
- * `document` and `window` in scope in every engine file. The driver already
- * declares the minimum it needs for `computeSelector`; this declares the
- * minimum the probe needs. Both are structural, both are checked by the
- * compiler, and neither leaks browser globals into modules that have no
- * business with them.
- *
- * ## Every count is defensive, and an uncountable thing is null, never zero
- *
- * A probe that throws takes the session's opening disclosure with it, and a
- * probe that reports `0` for something it could not look at teaches a false
- * fact — which is the failure the five result states exist to prevent, applied
- * one level down. So each group is wrapped, and `clientSideRouting` is
- * `boolean | null` because a static probe genuinely cannot see it.
- */
-import type { PageFingerprint } from "./capability-probe.ts";
-/** The element surface the probe reads. Structural; see this file's header. */
-export interface ProbeElement {
-    readonly ownerDocument: ProbeDocument;
-    readonly shadowRoot: ProbeRoot | null;
-    getAttribute(name: string): string | null;
-    getBoundingClientRect(): {
-        readonly width: number;
-        readonly height: number;
-    };
-    readonly scrollHeight: number;
-    readonly clientHeight: number;
-    readonly tagName: string;
-}
-export interface ProbeRoot {
-    querySelectorAll(selector: string): ArrayLike<ProbeElement>;
-}
-export interface ProbeDocument extends ProbeRoot {
-    readonly documentElement: {
-        readonly scrollHeight: number;
-    } | null;
-    readonly defaultView: ProbeView | null;
-    readonly location: {
-        readonly href: string;
-        readonly origin: string;
-    };
-}
-export interface ProbeView {
-    readonly innerWidth: number;
-    readonly innerHeight: number;
-    getComputedStyle(element: ProbeElement): {
-        readonly position: string;
-    };
-}
-/**
- * Runs inside the page. Must not close over anything in this module — it is
- * serialized, so every constant it uses is passed in.
- */
-export declare function probeInPage(root: ProbeElement, constants: {
-    readonly interactive: string;
-    readonly challengeMarkers: readonly (readonly [string, string])[];
-    readonly scrollOverflowRatio: number;
-    readonly overlayCovers: number;
-}): PageFingerprint;
-/** The constants `probeInPage` must be handed, since it cannot close over them. */
-export declare const PROBE_CONSTANTS: {
-    readonly interactive: "a, button, input, select, textarea, [role], [onclick], summary";
-    readonly challengeMarkers: readonly (readonly [string, string])[];
-    readonly scrollOverflowRatio: 1.5;
-    readonly overlayCovers: 0.4;
-};
-//# sourceMappingURL=page-probe.d.ts.map

package/dist/browser/page-probe.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"page-probe.d.ts","sourceRoot":"","sources":["../../src/browser/page-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,qBAAqB,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,CAAC,eAAe,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AA4BD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE;IACT,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAClE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACA,eAAe,CA+HjB;AAED,mFAAmF;AACnF,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC"}