@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/web/web-data-observations.d.ts

@@ -0,0 +1,30 @@
+import type { WebCoverage, WebMetricObservation } from './web-data-types.js';
+/** Execution observations for one change plus its total recorded attempts. */
+export interface ChangeExecutionObservation {
+    readonly attempts: number;
+    readonly observation: WebMetricObservation;
+}
+/** Numbered task event streams only; `change.jsonl` is never a task stream. */
+export declare function listTaskEventFiles(folderPath: string): Promise<string[]>;
+/** Per-task execution observations for one numbered event stream. */
+export interface TaskEventObservation {
+    readonly attempts: number;
+    readonly cost: number | null;
+    readonly costCoverage: WebCoverage;
+    readonly duration: number | null;
+}
+/** Reads one numbered task stream into its task-level execution observations. */
+export declare function observeTaskFile(folderPath: string, taskNumber: string): Promise<TaskEventObservation>;
+/**
+ * Aggregates per-change execution evidence from numbered task streams only.
+ * `cost` stays null when no attempt reported a cost; no value is estimated.
+ */
+export declare function observeExecution(folderPath: string): Promise<ChangeExecutionObservation>;
+/**
+ * Aggregates per-change planning evidence from valid `.run/plan.jsonl`
+ * lifecycle pairs. Cost coverage counts only sessions whose `usage.cost` was
+ * recorded; tokens alone yield a null cost and `reported: 0` rather than a
+ * summed zero.
+ */
+export declare function observePlanning(folderPath: string): Promise<WebMetricObservation>;
+//# sourceMappingURL=web-data-observations.d.ts.map

package/dist/core/web/web-data-observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-data-observations.d.ts","sourceRoot":"","sources":["../../../src/core/web/web-data-observations.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,8EAA8E;AAC9E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;CAC5C;AAwBD,+EAA+E;AAC/E,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAK9E;AAaD,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,iFAAiF;AACjF,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAS/B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAuC9F;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2EvF"}

package/dist/core/web/web-data-observations.js

@@ -0,0 +1,181 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readPlanningSessions } from '../report/planning.js';
+import { asData, eventTimestampMs, observeAttempts, observeTaskStream, parseEventLines, } from '../report/report-events.js';
+import { mergeTokenDraft, observeTokenGroups, sortedTokenGroups, } from './web-data-tokens.js';
+/** Covered duration in seconds from valid measures start-to-end pairs. */
+function measureDurationSeconds(events) {
+    let pendingStartMs = null;
+    let coveredMs = 0;
+    let hasDuration = false;
+    for (const event of events) {
+        if (event.type !== 'measures')
+            continue;
+        const data = asData(event);
+        if (data?.phase === 'start') {
+            pendingStartMs = eventTimestampMs(event);
+        }
+        else if (data?.phase === 'end') {
+            const endMs = eventTimestampMs(event);
+            if (pendingStartMs !== null && endMs !== null && endMs >= pendingStartMs) {
+                coveredMs += endMs - pendingStartMs;
+                hasDuration = true;
+            }
+            pendingStartMs = null;
+        }
+    }
+    return hasDuration ? coveredMs / 1000 : null;
+}
+/** Numbered task event streams only; `change.jsonl` is never a task stream. */
+export async function listTaskEventFiles(folderPath) {
+    const entries = await fs.readdir(path.join(folderPath, '.run', 'events')).catch(() => []);
+    return entries
+        .filter((entry) => /^\d+\.jsonl$/.test(entry))
+        .sort((a, b) => Number.parseInt(a, 10) - Number.parseInt(b, 10));
+}
+async function readEvents(folderPath, file) {
+    const content = await fs
+        .readFile(path.join(folderPath, '.run', 'events', file), 'utf8')
+        .catch(() => '');
+    return parseEventLines(content);
+}
+function sum(values) {
+    return values.reduce((total, value) => total + value, 0);
+}
+/** Reads one numbered task stream into its task-level execution observations. */
+export async function observeTaskFile(folderPath, taskNumber) {
+    const events = await readEvents(folderPath, `${taskNumber}.jsonl`);
+    const stream = observeTaskStream(events);
+    return {
+        attempts: stream.attempts,
+        cost: stream.costReportedAttempts === 0 ? null : sum(stream.costValues),
+        costCoverage: { reported: stream.costReportedAttempts, total: stream.attempts },
+        duration: measureDurationSeconds(events),
+    };
+}
+/**
+ * Aggregates per-change execution evidence from numbered task streams only.
+ * `cost` stays null when no attempt reported a cost; no value is estimated.
+ */
+export async function observeExecution(folderPath) {
+    const files = await listTaskEventFiles(folderPath);
+    const groups = new Map();
+    const costValues = [];
+    const durations = [];
+    let attempts = 0;
+    let reported = 0;
+    let passTotal = 0;
+    let passPassed = 0;
+    for (const file of files) {
+        const events = await readEvents(folderPath, file);
+        const stream = observeTaskStream(events);
+        attempts += stream.attempts;
+        reported += stream.costReportedAttempts;
+        costValues.push(...stream.costValues);
+        const duration = measureDurationSeconds(events);
+        if (duration !== null)
+            durations.push(duration);
+        const attempt = observeAttempts(events);
+        if (attempt.attempts > 0) {
+            passTotal++;
+            if (attempt.firstAttemptPass)
+                passPassed++;
+        }
+        for (const [key, draft] of observeTokenGroups(events))
+            groups.set(key, draft);
+    }
+    const costCoverage = { reported, total: attempts };
+    return {
+        attempts,
+        observation: {
+            cost: reported === 0 ? null : sum(costValues),
+            costCoverage,
+            tokens: sortedTokenGroups(groups),
+            durations,
+            firstAttemptPass: { reported: passPassed, total: passTotal },
+        },
+    };
+}
+/**
+ * Aggregates per-change planning evidence from valid `.run/plan.jsonl`
+ * lifecycle pairs. Cost coverage counts only sessions whose `usage.cost` was
+ * recorded; tokens alone yield a null cost and `reported: 0` rather than a
+ * summed zero.
+ */
+export async function observePlanning(folderPath) {
+    const sessions = (await readPlanningSessions(folderPath)).filter((session) => session.started);
+    if (sessions.length === 0) {
+        return {
+            cost: null,
+            costCoverage: { reported: 0, total: 0 },
+            tokens: [],
+            durations: [],
+            firstAttemptPass: { reported: 0, total: 0 },
+        };
+    }
+    const groups = new Map();
+    const durations = [];
+    const costValues = [];
+    let reported = 0;
+    for (const session of sessions) {
+        const started = session.started;
+        if (!started)
+            continue;
+        const exited = session.exited;
+        if (!exited)
+            continue;
+        const usage = exited.data.usage;
+        const harness = started.data.harness || '';
+        const model = started.data.model;
+        if (usage.inputTokens !== null) {
+            mergeTokenDraft(groups, harness, model, {
+                input: usage.inputTokens,
+                cachedInput: 0,
+                output: 0,
+                reasoning: 0,
+                total: usage.inputTokens,
+            });
+        }
+        if (usage.outputTokens !== null) {
+            mergeTokenDraft(groups, harness, model, {
+                input: 0,
+                cachedInput: 0,
+                output: usage.outputTokens,
+                reasoning: 0,
+                total: usage.outputTokens,
+            });
+        }
+        if (usage.cachedTokens !== null) {
+            mergeTokenDraft(groups, harness, model, {
+                input: 0,
+                cachedInput: usage.cachedTokens,
+                output: 0,
+                reasoning: 0,
+                total: 0,
+            });
+        }
+        if (usage.reasoningTokens !== null) {
+            mergeTokenDraft(groups, harness, model, {
+                input: 0,
+                cachedInput: 0,
+                output: 0,
+                reasoning: usage.reasoningTokens,
+                total: 0,
+            });
+        }
+        if (usage.cost !== null) {
+            costValues.push(usage.cost);
+            reported++;
+        }
+        if (Number.isFinite(exited.data.wallSeconds))
+            durations.push(exited.data.wallSeconds);
+    }
+    return {
+        cost: reported === 0 ? null : sum(costValues),
+        costCoverage: { reported, total: sessions.length },
+        tokens: sortedTokenGroups(groups),
+        durations,
+        firstAttemptPass: { reported: 0, total: 0 },
+    };
+}
+//# sourceMappingURL=web-data-observations.js.map

package/dist/core/web/web-data-observations.js.map

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

package/dist/core/web/web-data-tokens.d.ts

@@ -0,0 +1,29 @@
+import type { WebTokenGroup } from './web-data-types.js';
+/** Mutable accumulator for one harness/model token group. */
+export interface TokenDraft {
+    harness: string;
+    model: string | null;
+    input: number;
+    cachedInput: number;
+    output: number;
+    reasoning: number;
+    total: number;
+}
+/** Adds one token delta to its harness/model group, creating it when absent. */
+export declare function mergeTokenDraft(groups: Map<string, TokenDraft>, harness: string, model: string | null, delta: {
+    input: number;
+    cachedInput: number;
+    output: number;
+    reasoning: number;
+    total: number;
+}): void;
+/** Materializes one token group map in stable harness/model order. */
+export declare function sortedTokenGroups(groups: Map<string, TokenDraft>): WebTokenGroup[];
+/**
+ * Groups token counters by the recorded harness and nullable model. The current
+ * provenance comes from the most recent `started` event unless a token event
+ * explicitly carries its own; keys include both fields so unlike provenance is
+ * never merged.
+ */
+export declare function observeTokenGroups(events: readonly Record<string, unknown>[]): Map<string, TokenDraft>;
+//# sourceMappingURL=web-data-tokens.d.ts.map

package/dist/core/web/web-data-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-data-tokens.d.ts","sourceRoot":"","sources":["../../../src/core/web/web-data-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9F,IAAI,CAiBN;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,aAAa,EAAE,CAMlF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACzC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAwBzB"}

package/dist/core/web/web-data-tokens.js

@@ -0,0 +1,62 @@
+import { asData, parseTokenEvent } from '../report/report-events.js';
+function tokenGroupKey(harness, model) {
+    return `${harness}\u0000${model ?? ''}`;
+}
+/** Adds one token delta to its harness/model group, creating it when absent. */
+export function mergeTokenDraft(groups, harness, model, delta) {
+    const key = tokenGroupKey(harness, model);
+    const draft = groups.get(key) ?? {
+        harness,
+        model,
+        input: 0,
+        cachedInput: 0,
+        output: 0,
+        reasoning: 0,
+        total: 0,
+    };
+    draft.input += delta.input;
+    draft.cachedInput += delta.cachedInput;
+    draft.output += delta.output;
+    draft.reasoning += delta.reasoning;
+    draft.total += delta.total;
+    groups.set(key, draft);
+}
+/** Materializes one token group map in stable harness/model order. */
+export function sortedTokenGroups(groups) {
+    return [...groups.values()]
+        .map((draft) => ({ ...draft }))
+        .sort((a, b) => a.harness.localeCompare(b.harness) || (a.model ?? '').localeCompare(b.model ?? ''));
+}
+/**
+ * Groups token counters by the recorded harness and nullable model. The current
+ * provenance comes from the most recent `started` event unless a token event
+ * explicitly carries its own; keys include both fields so unlike provenance is
+ * never merged.
+ */
+export function observeTokenGroups(events) {
+    const groups = new Map();
+    let harness = '';
+    let model = null;
+    for (const event of events) {
+        const data = asData(event);
+        if (!data)
+            continue;
+        if (event.type === 'started') {
+            if (typeof data.harness === 'string')
+                harness = data.harness;
+            model = typeof data.model === 'string' && data.model ? data.model : null;
+            continue;
+        }
+        if (event.type !== 'tokens')
+            continue;
+        const eventHarness = typeof data.harness === 'string' && data.harness ? data.harness : harness;
+        const eventModel = typeof data.model === 'string' && data.model
+            ? data.model
+            : data.model === null
+                ? null
+                : model;
+        mergeTokenDraft(groups, eventHarness, eventModel, parseTokenEvent(data));
+    }
+    return groups;
+}
+//# sourceMappingURL=web-data-tokens.js.map

package/dist/core/web/web-data-tokens.js.map

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

package/dist/core/web/web-data-types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Public read-only web documents derived from the current project tree. These
+ * contracts are data only: no function in this module performs I/O, caches an
+ * index, or estimates a missing observation.
+ */
+/** Where a change folder currently lives. */
+export type WebLocation = 'active' | 'archived' | 'rejected';
+/** Typed selector failure consumed by the HTTP layer without string parsing. */
+export type WebDataErrorKind = 'not-found' | 'ambiguous';
+/** Distinguishable selector failure for absent and ambiguous changes. */
+export declare class WebDataError extends Error {
+    readonly kind: WebDataErrorKind;
+    constructor(kind: WebDataErrorKind, message: string);
+}
+/** One current `openspec/specs/<id>/spec.md` capability with its full text. */
+export interface WebCapabilityNode {
+    readonly kind: 'capability';
+    readonly id: string;
+    readonly folderKey: string;
+    /** Complete UTF-8 contents of the living capability spec. */
+    readonly spec: string;
+}
+/** Token totals grouped by recorded harness and nullable model. */
+export interface WebTokenGroup {
+    readonly harness: string;
+    readonly model: string | null;
+    readonly input: number;
+    readonly cachedInput: number;
+    readonly output: number;
+    readonly reasoning: number;
+    readonly total: number;
+}
+/** `reported of total` coverage for one cost or pass observation. */
+export interface WebCoverage {
+    readonly reported: number;
+    readonly total: number;
+}
+/**
+ * One compact observation series. `cost` is null when no valid record exists;
+ * it is never estimated and never a fabricated zero.
+ */
+export interface WebMetricObservation {
+    readonly cost: number | null;
+    readonly costCoverage: WebCoverage;
+    readonly tokens: readonly WebTokenGroup[];
+    /** Observed durations in seconds, one per covered task or session. */
+    readonly durations: readonly number[];
+    readonly firstAttemptPass: WebCoverage;
+}
+interface WebChangeNodeBase {
+    readonly kind: 'change';
+    /** Preserved directory basename; stable identity within its location. */
+    readonly folderKey: string;
+    readonly id: number | null;
+    readonly slug: string;
+    readonly title: string;
+    readonly state: WebLocation;
+    readonly created: string | null;
+    readonly approved: string | null;
+    readonly landed: string | null;
+    readonly rejection: {
+        readonly reason: string;
+        readonly timestamp: string;
+    } | null;
+    readonly planner: string | null;
+    readonly taskCount: number;
+    /**
+     * Tasks with a done marker, manual done included; same derivation as
+     * `osq status`. Derived graph documents always set it.
+     */
+    readonly doneCount?: number;
+    readonly attempts: number;
+    readonly execution: WebMetricObservation;
+    readonly planning: WebMetricObservation;
+}
+/** One change folder projected for the archive graph. */
+export type WebChangeNode = WebChangeNodeBase;
+export type WebEdgeKind = 'depends_on' | 'reads' | 'writes';
+/** One typed relationship between a change and a change or capability. */
+export interface WebGraphEdge {
+    readonly key: string;
+    readonly kind: WebEdgeKind;
+    readonly from: string;
+    readonly to: string;
+}
+/** Deterministically ordered capability/change nodes plus typed edges. */
+export interface WebGraph {
+    readonly capabilities: readonly WebCapabilityNode[];
+    readonly changes: readonly WebChangeNode[];
+    readonly edges: readonly WebGraphEdge[];
+}
+/** One resolved scope declaration with its readable path when it exists. */
+export interface WebResolvedScope {
+    readonly relativePath: string;
+    readonly absolutePath: string | null;
+}
+/** Attribution for one differing path in a human recertification. */
+export interface WebRecertificationAttribution {
+    readonly path: string;
+    readonly attribution: string;
+}
+/** One typed human recertification decision. */
+export interface WebRecertification {
+    readonly taskNumber: string;
+    readonly timestamp: string | null;
+    readonly outcome: 'passed' | 'requeued' | null;
+    readonly actor: 'human';
+    readonly differingPaths: readonly string[];
+    readonly attribution: readonly WebRecertificationAttribution[];
+    readonly verify: string | null;
+    readonly exitCode: number | null;
+    readonly timedOut: boolean | null;
+}
+/** One task in a detailed change document. */
+export interface WebTask {
+    readonly taskNumber: string;
+    readonly title: string;
+    readonly declaredScope: readonly string[];
+    readonly resolvedScope: readonly WebResolvedScope[];
+    readonly acceptance: readonly string[];
+    readonly verify: string;
+    readonly state: string;
+    readonly attempts: number;
+    readonly reason: string | null;
+    readonly runningStart: string | null;
+    readonly runningElapsedSeconds: number | null;
+    readonly duration: number | null;
+    readonly cost: number | null;
+    readonly costCoverage: WebCoverage;
+    readonly recertifications: readonly WebRecertification[];
+    readonly result: string | null;
+}
+/** One unambiguous change with its proposal, brief, and task detail. */
+export interface WebChange {
+    readonly folderKey: string;
+    readonly id: number | null;
+    readonly slug: string;
+    readonly title: string;
+    readonly state: WebLocation;
+    readonly location: WebLocation;
+    readonly planner: string | null;
+    readonly brief: string | null;
+    readonly goal: string;
+    readonly rejection: {
+        readonly reason: string;
+        readonly timestamp: string;
+    } | null;
+    readonly dependsOn: readonly string[];
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+    /** Derivation timestamp supplied by the caller. */
+    readonly asOf: string;
+    readonly tasks: readonly WebTask[];
+}
+export {};
+//# sourceMappingURL=web-data-types.d.ts.map

package/dist/core/web/web-data-types.d.ts.map

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

package/dist/core/web/web-data-types.js

@@ -0,0 +1,15 @@
+/**
+ * Public read-only web documents derived from the current project tree. These
+ * contracts are data only: no function in this module performs I/O, caches an
+ * index, or estimates a missing observation.
+ */
+/** Distinguishable selector failure for absent and ambiguous changes. */
+export class WebDataError extends Error {
+    kind;
+    constructor(kind, message) {
+        super(message);
+        this.name = 'WebDataError';
+        this.kind = kind;
+    }
+}
+//# sourceMappingURL=web-data-types.js.map

package/dist/core/web/web-data-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-data-types.js","sourceRoot":"","sources":["../../../src/core/web/web-data-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,yEAAyE;AACzE,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IAEhC,YAAY,IAAsB,EAAE,OAAe;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/core/web/web-data.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public read-only web inspection entrypoints. Both derive every document from
+ * the current project tree, store no index, and estimate no absent evidence.
+ */
+export { getWebGraph } from './web-data-graph.js';
+export { getWebChange } from './web-data-change.js';
+export { WebDataError } from './web-data-types.js';
+export type { WebDataErrorKind } from './web-data-types.js';
+export type { WebCapabilityNode, WebChange, WebChangeNode, WebCoverage, WebEdgeKind, WebGraph, WebGraphEdge, WebLocation, WebMetricObservation, WebRecertification, WebRecertificationAttribution, WebResolvedScope, WebTask, WebTokenGroup, } from './web-data-types.js';
+//# sourceMappingURL=web-data.d.ts.map

package/dist/core/web/web-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-data.d.ts","sourceRoot":"","sources":["../../../src/core/web/web-data.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,EAC7B,gBAAgB,EAChB,OAAO,EACP,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/dist/core/web/web-data.js

@@ -0,0 +1,8 @@
+/**
+ * Public read-only web inspection entrypoints. Both derive every document from
+ * the current project tree, store no index, and estimate no absent evidence.
+ */
+export { getWebGraph } from './web-data-graph.js';
+export { getWebChange } from './web-data-change.js';
+export { WebDataError } from './web-data-types.js';
+//# sourceMappingURL=web-data.js.map

package/dist/core/web/web-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-data.js","sourceRoot":"","sources":["../../../src/core/web/web-data.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/web/web-events.d.ts

@@ -0,0 +1,54 @@
+import type http from 'node:http';
+/** Framed invalidation payload: affected numeric ids, empty for shared documents. */
+export interface InvalidationBatch {
+    readonly ids: readonly number[];
+}
+/** Watcher events that can change dashboard documents. */
+export type WatchEvent = 'add' | 'change' | 'unlink' | 'addDir' | 'unlinkDir' | 'error';
+/** Minimal chokidar-compatible seam so focused tests can inject a fake watcher. */
+export interface WatcherLike {
+    on(event: WatchEvent, listener: (target: string) => void): unknown;
+    close(): Promise<void>;
+}
+export interface WatchOptions {
+    readonly ignoreInitial: boolean;
+}
+export type WatcherFactory = (paths: readonly string[], options: WatchOptions) => WatcherLike;
+/** Cancellable debounce timer seam for deterministic tests. */
+export interface TimerHandle {
+    cancel(): void;
+}
+export type ScheduleFn = (callback: () => void, delayMs: number) => TimerHandle;
+export interface InvalidationHubOptions {
+    readonly projectRoot: string;
+    readonly openspecRoot: string;
+    readonly debounceMs: number;
+    readonly watch?: WatcherFactory;
+    readonly schedule?: ScheduleFn;
+}
+/** One server-owned subscription surface; clients never create a watcher. */
+export interface InvalidationHub {
+    subscribe(listener: (batch: InvalidationBatch) => void): () => void;
+    cancelPending(): void;
+    close(): Promise<void>;
+}
+/** SSE response headers shared by GET and HEAD. */
+export declare const SSE_HEADERS: http.OutgoingHttpHeaders;
+/**
+ * Leading numeric id for a path inside exactly one change folder, or `null`
+ * when the path belongs to shared state: capability specs, root layout, or an
+ * unrecognized folder.
+ */
+export declare function classifyChangePath(target: string, changesDir: string, archiveDir: string, rejectedDir: string): number | null;
+/** Create the one watcher and debounce accumulator owned by a server. */
+export declare function createInvalidationHub(options: InvalidationHubOptions): InvalidationHub;
+/** The exact wire frame for one debounced invalidation. */
+export declare function formatChangedEvent(ids: readonly number[]): string;
+/** One broadcast surface for every connected `/api/events` response. */
+export interface EventStream {
+    handle(res: http.ServerResponse, head: boolean): void;
+    close(): void;
+}
+/** Track connected SSE responses and fan out one frame per derived batch. */
+export declare function createEventStream(hub: InvalidationHub): EventStream;
+//# sourceMappingURL=web-events.d.ts.map

package/dist/core/web/web-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-events.d.ts","sourceRoot":"","sources":["../../../src/core/web/web-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAMlC,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAExF,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,WAAW,CAAC;AAE9F,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,WAAW,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpE,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,mDAAmD;AACnD,eAAO,MAAM,WAAW,EAAE,IAAI,CAAC,mBAI9B,CAAC;AA4BF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAQf;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAuEtF;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEjE;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACtD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,WAAW,CAgCnE"}