@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/report/approval-flags.js

@@ -0,0 +1,138 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { parseEventLines } from './report-events.js';
+/** The fixed flag ids in the order the digest emits them. */
+const FLAG_IDS = [
+    'shared_file',
+    'sensitive_path',
+    'verify_without_test',
+    'removed_requirement',
+    'unknown_capability',
+    'verify_starts_conflict',
+];
+/** The key used for changes whose recorded flag ids are empty. */
+export const NO_APPROVAL_FLAGS = 'none';
+/** Every reported key, never recomputed: the flag ids then `none`. */
+export const APPROVAL_FLAG_KEYS = [...FLAG_IDS, NO_APPROVAL_FLAGS];
+function emptyFlagOutcome() {
+    return {
+        shown: { fired: 0, troubled: 0 },
+        confirmed: { fired: 0, troubled: 0 },
+    };
+}
+/**
+ * The recorded `approvalFlags` of a manifest, or null when the file is
+ * malformed or the field is absent or does not carry a valid `ids` array and
+ * `shown`/`confirmed` mode.
+ */
+function parseRecordedFlags(content) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return null;
+    const flags = parsed.approvalFlags;
+    if (!flags || typeof flags !== 'object' || Array.isArray(flags))
+        return null;
+    const record = flags;
+    if (record.mode !== 'shown' && record.mode !== 'confirmed')
+        return null;
+    if (!Array.isArray(record.ids))
+        return null;
+    if (!record.ids.every((id) => typeof id === 'string'))
+        return null;
+    return { ids: record.ids, mode: record.mode };
+}
+/** One numbered task stream; `change.jsonl` is the change-level stream. */
+function isTaskStream(entry) {
+    return /^\d+\.jsonl$/.test(entry);
+}
+/** True when a stream carries trouble: a task `dead` or any kind of `regressed`. */
+function streamHasTrouble(entry, content) {
+    const taskStream = isTaskStream(entry);
+    return parseEventLines(content).some((event) => {
+        if (event.type === 'regressed')
+            return true;
+        return taskStream && event.type === 'dead';
+    });
+}
+/**
+ * A change has later trouble when any numbered task stream holds a `dead`
+ * event, or any task or change stream holds a `regressed` event.
+ */
+async function changeHasTrouble(folderPath) {
+    const eventsDir = path.join(folderPath, '.run', 'events');
+    let entries = [];
+    try {
+        entries = await fs.readdir(eventsDir);
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        if (!entry.endsWith('.jsonl'))
+            continue;
+        if (!isTaskStream(entry) && entry !== 'change.jsonl')
+            continue;
+        const content = await fs.readFile(path.join(eventsDir, entry), 'utf8').catch(() => '');
+        if (streamHasTrouble(entry, content))
+            return true;
+    }
+    return false;
+}
+/** Every reported key starts at zero so callers never infer an absent key. */
+function emptyByFlag() {
+    const byFlag = {};
+    for (const key of APPROVAL_FLAG_KEYS)
+        byFlag[key] = emptyFlagOutcome();
+    return byFlag;
+}
+/**
+ * Reads recorded `approvalFlags` from every given change folder's manifest and
+ * counts, per key and mode, how many changes fired it and how many later had
+ * trouble. Folders without a valid recorded field contribute nothing; flags
+ * are never recomputed from the authored change.
+ */
+export async function collectApprovalFlagOutcomes(folders) {
+    const byFlag = emptyByFlag();
+    let changes = 0;
+    for (const folderPath of folders) {
+        const content = await fs
+            .readFile(path.join(folderPath, '.run', 'manifest.json'), 'utf8')
+            .catch(() => null);
+        if (content === null)
+            continue;
+        const recorded = parseRecordedFlags(content);
+        if (!recorded)
+            continue;
+        changes++;
+        const troubled = await changeHasTrouble(folderPath);
+        const keys = new Set(recorded.ids.length === 0 ? [NO_APPROVAL_FLAGS] : recorded.ids);
+        for (const key of keys) {
+            const outcome = byFlag[key];
+            if (!outcome)
+                continue;
+            const bucket = recorded.mode === 'confirmed' ? outcome.confirmed : outcome.shown;
+            bucket.fired++;
+            if (troubled)
+                bucket.troubled++;
+        }
+    }
+    return { changes, byFlag };
+}
+/** Render the `Approval flags:` body, one line per key in fixed order. */
+export function formatApprovalFlagOutcomes(outcomes) {
+    const lines = [`  ${outcomes.changes} approved changes recorded flags`];
+    for (const key of APPROVAL_FLAG_KEYS) {
+        const outcome = outcomes.byFlag[key] ?? emptyFlagOutcome();
+        const fired = outcome.shown.fired + outcome.confirmed.fired;
+        const troubled = outcome.shown.troubled + outcome.confirmed.troubled;
+        lines.push(`  ${key}: fired ${fired} (shown ${outcome.shown.fired}, confirmed ${outcome.confirmed.fired}), later trouble ${troubled} (shown ${outcome.shown.troubled}, confirmed ${outcome.confirmed.troubled})`);
+    }
+    return lines;
+}
+//# sourceMappingURL=approval-flags.js.map

package/dist/core/report/approval-flags.js.map

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

package/dist/core/report/planning-economics.d.ts

@@ -0,0 +1,39 @@
+/** Per-kind planning token totals of one change; null means nothing reported. */
+export interface PlanningChangeTokens {
+    readonly input: number | null;
+    readonly output: number | null;
+    readonly cacheRead: number | null;
+    readonly cacheWrite: number | null;
+    readonly reasoning: number | null;
+}
+/** Per-change planning economics derived from slices, usage, and measures. */
+export interface PlanningChangeEconomics {
+    readonly sessions: number;
+    readonly tokens: PlanningChangeTokens;
+    readonly activeMinutes: number | null;
+    readonly cost: number | null;
+    readonly specWords: number | null;
+    readonly changedLines: number | null;
+    readonly specWordsPerChangedLine: number | null;
+    readonly minutesLastEditToApproval: number | null;
+}
+/** One side of the planning-versus-execution comparison. */
+export interface PlanningComparisonSide {
+    /** Null when nothing on this side reported that kind of token. */
+    readonly input: number | null;
+    readonly output: number | null;
+    readonly cached: number | null;
+    readonly reasoning: number | null;
+    /** Null when nothing on this side reported a cost. */
+    readonly cost: number | null;
+}
+/** Planning against executor tokens and cost, in totals. */
+export interface PlanningComparison {
+    readonly planning: PlanningComparisonSide;
+    readonly execution: PlanningComparisonSide;
+}
+/** Planning economics for every change folder carrying a valid planning start. */
+export declare function computePlanningByChange(folders: readonly string[]): Promise<Record<string, PlanningChangeEconomics>>;
+/** Planning against execution totals, with null costs when nothing reported. */
+export declare function buildPlanningComparison(planning: PlanningComparisonSide, execution: PlanningComparisonSide): PlanningComparison;
+//# sourceMappingURL=planning-economics.d.ts.map

package/dist/core/report/planning-economics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-economics.d.ts","sourceRoot":"","sources":["../../../src/core/report/planning-economics.ts"],"names":[],"mappings":"AAMA,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;CAC5C;AA+JD,kFAAkF;AAClF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAOlD;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,sBAAsB,GAChC,kBAAkB,CAEpB"}

package/dist/core/report/planning-economics.js

@@ -0,0 +1,168 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { compareNumericPrefix } from '../status/state.js';
+import { readPlanningSessions } from './planning-records.js';
+import { asData, parseEventLines } from './report-events.js';
+function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+/** Sum a nullable observation, staying null until the first report arrives. */
+function addNullable(current, value) {
+    if (value === null)
+        return current;
+    return current === null ? value : current + value;
+}
+/** Epoch milliseconds for a persisted ISO timestamp, or null when invalid. */
+function parseTimeMs(value) {
+    if (typeof value !== 'string' || !value)
+        return null;
+    const ms = Date.parse(value);
+    return Number.isFinite(ms) ? ms : null;
+}
+function finiteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+/** Task event files (`<n>.jsonl`) in stable numeric order. */
+function numericTaskFiles(entries) {
+    return entries.filter((entry) => /^\d+\.jsonl$/.test(entry)).sort(compareNumericPrefix);
+}
+/**
+ * One change's spec words and changed lines from `measures` events. Spec words
+ * are the first task start's `proposalWords` plus every task's first start
+ * `taskWords`; changed lines sum each task's last end `changedLines`.
+ */
+async function readMeasuresTotals(folderPath) {
+    const eventsDir = path.join(folderPath, '.run', 'events');
+    let entries = [];
+    try {
+        entries = numericTaskFiles(await fs.readdir(eventsDir));
+    }
+    catch {
+        return { specWords: null, changedLines: null };
+    }
+    let sawStart = false;
+    let firstProposalWords = null;
+    let taskWordsTotal = null;
+    let changedLines = null;
+    for (const entry of entries) {
+        const content = await fs.readFile(path.join(eventsDir, entry), 'utf8').catch(() => null);
+        if (content === null)
+            continue;
+        let firstStart = null;
+        let lastEndChanged = null;
+        for (const event of parseEventLines(content)) {
+            if (event.type !== 'measures')
+                continue;
+            const data = asData(event);
+            if (!data)
+                continue;
+            if (data.phase === 'start' && firstStart === null) {
+                firstStart = data;
+                if (!sawStart) {
+                    sawStart = true;
+                    firstProposalWords = finiteNumber(data.proposalWords);
+                }
+            }
+            else if (data.phase === 'end') {
+                const value = finiteNumber(data.changedLines);
+                lastEndChanged = value !== null && value >= 0 ? value : null;
+            }
+        }
+        if (firstStart !== null) {
+            const taskWords = finiteNumber(firstStart.taskWords);
+            if (taskWords !== null)
+                taskWordsTotal = (taskWordsTotal ?? 0) + taskWords;
+        }
+        if (lastEndChanged !== null)
+            changedLines = (changedLines ?? 0) + lastEndChanged;
+    }
+    return {
+        specWords: sawStart ? (firstProposalWords ?? 0) + (taskWordsTotal ?? 0) : null,
+        changedLines,
+    };
+}
+/**
+ * Per-change planning economics for one folder, or null when it has no valid
+ * planning start. Sliced sessions contribute their slice; legacy sessions
+ * contribute usage input, output, and reasoning with a null cache split.
+ */
+async function changeEconomics(folderPath) {
+    const sessions = await readPlanningSessions(folderPath);
+    const validSessions = sessions.filter((session) => session.started !== null);
+    if (validSessions.length === 0)
+        return null;
+    let tokens = {
+        input: null,
+        output: null,
+        cacheRead: null,
+        cacheWrite: null,
+        reasoning: null,
+    };
+    let activeMinutes = null;
+    let cost = null;
+    let latestApprovedMs = null;
+    let latestLastEditMs = null;
+    for (const session of validSessions) {
+        const exited = session.exited;
+        if (!exited)
+            continue;
+        const usage = exited.data.usage;
+        const slice = exited.data.slice;
+        if (slice) {
+            tokens = {
+                input: addNullable(tokens.input, slice.tokens.input),
+                output: addNullable(tokens.output, slice.tokens.output),
+                cacheRead: addNullable(tokens.cacheRead, slice.tokens.cacheRead),
+                cacheWrite: addNullable(tokens.cacheWrite, slice.tokens.cacheWrite),
+                reasoning: addNullable(tokens.reasoning, slice.tokens.reasoning),
+            };
+            activeMinutes = addNullable(activeMinutes, slice.activeMinutes);
+            const approvedMs = parseTimeMs(slice.approvedAt);
+            if (approvedMs !== null)
+                latestApprovedMs = Math.max(latestApprovedMs ?? approvedMs, approvedMs);
+            const lastEditMs = parseTimeMs(slice.lastEditAt);
+            if (lastEditMs !== null)
+                latestLastEditMs = Math.max(latestLastEditMs ?? lastEditMs, lastEditMs);
+        }
+        else {
+            tokens = {
+                ...tokens,
+                input: addNullable(tokens.input, usage.inputTokens),
+                output: addNullable(tokens.output, usage.outputTokens),
+                reasoning: addNullable(tokens.reasoning, usage.reasoningTokens),
+            };
+        }
+        cost = addNullable(cost, usage.cost);
+    }
+    const measures = await readMeasuresTotals(folderPath);
+    const ratio = measures.specWords !== null && measures.changedLines !== null && measures.changedLines !== 0
+        ? round2(measures.specWords / measures.changedLines)
+        : null;
+    return {
+        sessions: validSessions.length,
+        tokens,
+        activeMinutes,
+        cost,
+        specWords: measures.specWords,
+        changedLines: measures.changedLines,
+        specWordsPerChangedLine: ratio,
+        minutesLastEditToApproval: latestApprovedMs !== null && latestLastEditMs !== null
+            ? round2((latestApprovedMs - latestLastEditMs) / 60000)
+            : null,
+    };
+}
+/** Planning economics for every change folder carrying a valid planning start. */
+export async function computePlanningByChange(folders) {
+    const byChange = {};
+    for (const folderPath of folders) {
+        const economics = await changeEconomics(folderPath);
+        if (economics)
+            byChange[path.basename(folderPath)] = economics;
+    }
+    return byChange;
+}
+/** Planning against execution totals, with null costs when nothing reported. */
+export function buildPlanningComparison(planning, execution) {
+    return { planning, execution };
+}
+//# sourceMappingURL=planning-economics.js.map

package/dist/core/report/planning-economics.js.map

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

package/dist/core/report/planning-observed.d.ts

@@ -0,0 +1,59 @@
+import { type PlanningConfig } from '../foundation/config-planning.js';
+import { type PlanningUsage } from './planning-records.js';
+import { type PlanningSlice, type PlanningTurn } from './planning-slice.js';
+export type { PlanningSlice, PlanningTurn } from './planning-slice.js';
+export { isSegmentContained, normalizeObservedTarget } from './planning-slice.js';
+export { resolveChangeApprovalTime, resolveChangeCreationTime } from './planning-slice-lookup.js';
+export interface PlanningSessionEdit {
+    /** Path exactly as reported by the native tool call, absolute or relative. */
+    readonly path: string;
+    readonly timestamp: string;
+}
+/** The reader port every harness returns; one turn per native model response. */
+export interface ObservedPlanningSession {
+    readonly harness: string;
+    readonly nativeSessionId: string;
+    readonly sessionDir: string | null;
+    readonly model: string | null;
+    /** Harness version when the transcript records one. */
+    readonly harnessVersion?: string | null;
+    /** Whole-session reported cost when the harness records one. */
+    readonly sessionCost?: number | null;
+    readonly turns: readonly PlanningTurn[];
+}
+/** Independent local reader for one harness. Failure degrades to no matches. */
+export type PlanningSessionReader = () => Promise<readonly ObservedPlanningSession[]>;
+/** A session reduced to the turns the selected change owns. */
+export interface PlanningObservation {
+    readonly harness: string;
+    readonly nativeSessionId: string;
+    readonly sessionId: string;
+    readonly model: string | null;
+    readonly startedAt: string;
+    readonly endedAt: string;
+    readonly usage: PlanningUsage;
+    readonly slice: PlanningSlice;
+}
+export interface FindPlanningSessionsOptions {
+    /** Persisted change creation time; invalid or absent yields no matches. */
+    readonly createdAt: string | null;
+    /** Single captured observation end. */
+    readonly observedAt: string;
+    /** Directory holding the session's change folders and their `archive/`. */
+    readonly changesDir?: string;
+    /** Resolved planning measurement settings. */
+    readonly planning?: PlanningConfig;
+    readonly readers: readonly PlanningSessionReader[];
+}
+export interface AppendObservedOptions {
+    /** SHA-256 digest of the current `brief.md` bytes. */
+    readonly briefHash: string;
+    readonly osqVersion: string;
+}
+/** Stable observed session id derived from reader name and native id. */
+export declare function observedSessionId(harness: string, nativeSessionId: string): string;
+/** Ask every reader for sessions editing inside the change during the window. */
+export declare function findPlanningSessions(changeFolder: string, options: FindPlanningSessionsOptions): Promise<PlanningObservation[]>;
+/** Append one deterministic observed pair per native session, idempotently. */
+export declare function appendObservedSessions(changeFolder: string, observations: readonly PlanningObservation[], options: AppendObservedOptions): Promise<number>;
+//# sourceMappingURL=planning-observed.d.ts.map

package/dist/core/report/planning-observed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-observed.d.ts","sourceRoot":"","sources":["../../../src/core/report/planning-observed.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAmB,KAAK,aAAa,EAAmB,MAAM,uBAAuB,CAAC;AAG7F,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAwB,MAAM,qBAAqB,CAAC;AAGlG,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAElG,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,iFAAiF;AACjF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACzC;AAED,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;AAEtF,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAUD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAElF;AAUD,iFAAiF;AACjF,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA4DhC;AASD,+EAA+E;AAC/E,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,SAAS,mBAAmB,EAAE,EAC5C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAsCjB"}

package/dist/core/report/planning-observed.js

@@ -0,0 +1,135 @@
+import { DEFAULT_PLANNING_CONFIG } from '../foundation/config-planning.js';
+import { readPlanRecords } from './planning-records.js';
+import { resolveChangeApprovalTime } from './planning-slice-lookup.js';
+import { firstMatchingEdit, lastTurnModel, parseMs, sessionEdits } from './planning-slice-turns.js';
+import { sliceChangeOwnership } from './planning-slice.js';
+import { appendPlanRecord } from './planning.js';
+export { isSegmentContained, normalizeObservedTarget } from './planning-slice.js';
+export { resolveChangeApprovalTime, resolveChangeCreationTime } from './planning-slice-lookup.js';
+/** Fixed reader order so appended records are deterministic. */
+const HARNESS_ORDER = ['codex', 'opencode', 'claude'];
+function harnessRank(harness) {
+    const index = HARNESS_ORDER.indexOf(harness);
+    return index === -1 ? HARNESS_ORDER.length : index;
+}
+/** Stable observed session id derived from reader name and native id. */
+export function observedSessionId(harness, nativeSessionId) {
+    return `observed:${harness}:${nativeSessionId}`;
+}
+function compareObservations(a, b) {
+    const rank = harnessRank(a.harness) - harnessRank(b.harness);
+    if (rank !== 0)
+        return rank;
+    const start = a.startedAt.localeCompare(b.startedAt);
+    if (start !== 0)
+        return start;
+    return a.nativeSessionId.localeCompare(b.nativeSessionId);
+}
+/** Ask every reader for sessions editing inside the change during the window. */
+export async function findPlanningSessions(changeFolder, options) {
+    const createdMs = parseMs(options.createdAt);
+    const observedMs = parseMs(options.observedAt);
+    if (createdMs === null || observedMs === null || observedMs < createdMs)
+        return [];
+    const approvedAt = options.observedAt;
+    const planning = options.planning ?? DEFAULT_PLANNING_CONFIG;
+    const approvalCache = new Map();
+    const bySessionId = new Map();
+    for (const reader of options.readers) {
+        let candidates;
+        try {
+            candidates = await reader();
+        }
+        catch {
+            continue;
+        }
+        if (!Array.isArray(candidates))
+            continue;
+        const ordered = [...candidates].sort((a, b) => (a.nativeSessionId ?? '').localeCompare(b.nativeSessionId ?? ''));
+        for (const candidate of ordered) {
+            if (!candidate?.harness || !candidate?.nativeSessionId)
+                continue;
+            const sessionDir = candidate.sessionDir ?? null;
+            const edit = firstMatchingEdit(sessionEdits(candidate), sessionDir, changeFolder, createdMs, observedMs);
+            if (!edit)
+                continue;
+            const sessionId = observedSessionId(candidate.harness, candidate.nativeSessionId);
+            if (bySessionId.has(sessionId))
+                continue;
+            const result = await sliceChangeOwnership({
+                changeFolder,
+                changesDir: options.changesDir ?? null,
+                sessionId,
+                sessionDir,
+                approvedAt,
+                turns: candidate.turns,
+                sessionCost: candidate.sessionCost ?? null,
+                idleGapMinutes: planning.idleGapMinutes,
+                ...(planning.prices ? { prices: planning.prices } : {}),
+                resolveApproval: (folder, id) => resolveChangeApprovalTime(folder, id, approvalCache),
+            });
+            if (!result)
+                continue;
+            const sessionModel = candidate.model && candidate.model.length > 0 ? candidate.model : null;
+            bySessionId.set(sessionId, {
+                harness: candidate.harness,
+                nativeSessionId: candidate.nativeSessionId,
+                sessionId,
+                model: lastTurnModel(result.ownedTurns) ?? sessionModel,
+                startedAt: result.slice.start,
+                endedAt: result.slice.end,
+                usage: result.usage,
+                slice: result.slice,
+            });
+        }
+    }
+    return [...bySessionId.values()].sort(compareObservations);
+}
+function observedWallSeconds(startedAt, endedAt) {
+    const start = Date.parse(startedAt);
+    const end = Date.parse(endedAt);
+    if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start)
+        return 0;
+    return (end - start) / 1000;
+}
+/** Append one deterministic observed pair per native session, idempotently. */
+export async function appendObservedSessions(changeFolder, observations, options) {
+    if (observations.length === 0)
+        return 0;
+    const existing = new Set((await readPlanRecords(changeFolder))
+        .filter((record) => record.type === 'plan_started')
+        .map((record) => record.sessionId));
+    let appended = 0;
+    for (const observation of observations) {
+        if (existing.has(observation.sessionId))
+            continue;
+        existing.add(observation.sessionId);
+        await appendPlanRecord(changeFolder, {
+            type: 'plan_started',
+            sessionId: observation.sessionId,
+            timestamp: observation.startedAt,
+            source: 'observed',
+            data: {
+                harness: observation.harness,
+                model: observation.model,
+                osqVersion: options.osqVersion,
+                briefHash: options.briefHash,
+            },
+        });
+        await appendPlanRecord(changeFolder, {
+            type: 'plan_exited',
+            sessionId: observation.sessionId,
+            timestamp: observation.endedAt,
+            source: 'observed',
+            data: {
+                exitCode: null,
+                wallSeconds: observedWallSeconds(observation.startedAt, observation.endedAt),
+                usage: observation.usage,
+                slice: observation.slice,
+            },
+        });
+        appended++;
+    }
+    return appended;
+}
+//# sourceMappingURL=planning-observed.js.map

package/dist/core/report/planning-observed.js.map

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

package/dist/core/report/planning-records.d.ts

@@ -0,0 +1,69 @@
+import type { PlanningSlice } from './planning-slice.js';
+/** Origin of one lifecycle record: osq-owned interactive session or local observation. */
+export type PlanningSource = 'owned' | 'observed';
+/** Observed-only planning usage. Every field is independently nullable. */
+export interface PlanningUsage {
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cachedTokens: number | null;
+    reasoningTokens: number | null;
+    cost: number | null;
+}
+/** Value used when no reader exists or a reader cannot supply values. */
+export declare const NULL_PLANNING_USAGE: PlanningUsage;
+/** Interval and working directory passed to an optional harness usage reader. */
+export interface PlanningUsageReaderOptions {
+    readonly cwd: string;
+    readonly startedAt: string;
+    readonly endedAt: string;
+}
+/** Structural port matching the optional `HarnessAdapter.readInteractiveUsage`. */
+export type PlanningUsageReader = (options: PlanningUsageReaderOptions) => Promise<PlanningUsage>;
+export interface PlanStartedRecord {
+    type: 'plan_started';
+    sessionId: string;
+    timestamp: string;
+    /** Absent on legacy records; absence reads as owned. */
+    source?: PlanningSource;
+    data: {
+        harness: string;
+        model: string | null;
+        agent?: string;
+        osqVersion: string;
+        briefHash: string;
+    };
+}
+export interface PlanExitedRecord {
+    type: 'plan_exited';
+    sessionId: string;
+    timestamp: string;
+    /** Absent on legacy records; absence reads as owned. */
+    source?: PlanningSource;
+    data: {
+        exitCode: number | null;
+        wallSeconds: number;
+        usage: PlanningUsage;
+        /** Observed slice measures; absent on legacy or malformed records. */
+        slice?: PlanningSlice;
+    };
+}
+export type PlanRecord = PlanStartedRecord | PlanExitedRecord;
+/** A lifecycle pair correlated by planning-session identifier. */
+export interface PlanningSession {
+    sessionId: string;
+    started: PlanStartedRecord | null;
+    exited: PlanExitedRecord | null;
+}
+/** Source of one record, reading a legacy record without a source as owned. */
+export declare function planningRecordSource(record: PlanRecord): PlanningSource;
+/** `<changeFolder>/.run/plan.jsonl`. */
+export declare function getPlanLogPath(changeFolder: string): string;
+/** Parses a `plan.jsonl` body, skipping blank and malformed lines. */
+export declare function parsePlanRecords(content: string): PlanRecord[];
+/** Reads `<change>/.run/plan.jsonl`; a missing log yields an empty array. */
+export declare function readPlanRecords(changeFolder: string): Promise<PlanRecord[]>;
+/** Correlates records by session id, returning sessions in start order. */
+export declare function correlatePlanSessions(records: readonly PlanRecord[]): PlanningSession[];
+/** Reads and correlates a change's planning log in one call. */
+export declare function readPlanningSessions(changeFolder: string): Promise<PlanningSession[]>;
+//# sourceMappingURL=planning-records.d.ts.map