@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/report/report-pre-spawn.js

@@ -0,0 +1,40 @@
+/** Pre-spawn verify counts beyond runs and mismatches, derived from task events. */
+import { asData } from './report-events.js';
+function isStartState(value) {
+    return value === 'red' || value === 'green' || value === 'any';
+}
+function emptyCounts() {
+    return {
+        red: { runs: 0, passed: 0 },
+        green: { runs: 0, passed: 0 },
+        any: { runs: 0, passed: 0 },
+    };
+}
+/**
+ * Counts one numbered task stream's pre-spawn verify runs: how many recorded a
+ * non-empty `missingPaths`, and, per declared `expected` start, how many ran and
+ * how many exited zero. Post-spawn runs, absent or unknown expected values, and
+ * empty missing-path lists are left out.
+ */
+export function observePreSpawnEvents(events) {
+    let missingPathRuns = 0;
+    const byStart = emptyCounts();
+    for (const event of events) {
+        if (event.type !== 'verify_ran')
+            continue;
+        const data = asData(event);
+        if (data?.phase !== 'pre_spawn')
+            continue;
+        if (Array.isArray(data.missingPaths) && data.missingPaths.length > 0)
+            missingPathRuns++;
+        const expected = data.expected;
+        if (!isStartState(expected))
+            continue;
+        const bucket = byStart[expected];
+        bucket.runs++;
+        if (data.exitCode === 0)
+            bucket.passed++;
+    }
+    return { missingPathRuns, byStart };
+}
+//# sourceMappingURL=report-pre-spawn.js.map

package/dist/core/report/report-pre-spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-pre-spawn.js","sourceRoot":"","sources":["../../../src/core/report/report-pre-spawn.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAqB5C,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,KAAK,CAAC;AACjE,CAAC;AAED,SAAS,WAAW;IAClB,OAAO;QACL,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAC7B,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAA0C;IAE1C,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,SAAS;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,EAAE,KAAK,KAAK,WAAW;YAAE,SAAS;QAE1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,eAAe,EAAE,CAAC;QAExF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;YAAE,SAAS;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;YAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/report/report-retries.d.ts

@@ -0,0 +1,30 @@
+/** Pure retry-history observation shared by the terminal report and web documents. */
+/** One side of the retry split: automatic or manual. */
+export interface RetryGroupHistory {
+    readonly count: number;
+    readonly reachedDone: number;
+    readonly cost: number;
+    readonly costReportedAttempts: number;
+}
+/**
+ * Retry outcomes split by who requested them, plus the number of `stuck`
+ * events. Costs never mix attempts: a pre-retry cost is not part of any
+ * retry-opened attempt.
+ */
+export interface RetryHistory {
+    readonly automatic: RetryGroupHistory;
+    readonly manual: RetryGroupHistory;
+    readonly stuck: number;
+}
+/** An all-zero retry history, used as the accumulation seed. */
+export declare function emptyRetryHistory(): RetryHistory;
+/**
+ * Projects one numbered task stream. Each `retry` event opens an attempt that
+ * runs to the next `retry` or the end of the stream; a `done` inside it counts
+ * as reached, and finite cost values inside it sum into the group. A cost
+ * before the first retry belongs to no retry-opened attempt and is ignored.
+ */
+export declare function observeRetries(events: readonly Record<string, unknown>[]): RetryHistory;
+/** Sums two retry histories field by field. */
+export declare function addRetryHistory(left: RetryHistory, right: RetryHistory): RetryHistory;
+//# sourceMappingURL=report-retries.d.ts.map

package/dist/core/report/report-retries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-retries.d.ts","sourceRoot":"","sources":["../../../src/core/report/report-retries.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAItF,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAgCD,gEAAgE;AAChE,wBAAgB,iBAAiB,IAAI,YAAY,CAgBhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,YAAY,CA4CvF;AAWD,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAMrF"}

package/dist/core/report/report-retries.js

@@ -0,0 +1,100 @@
+/** Pure retry-history observation shared by the terminal report and web documents. */
+import { asData } from './report-events.js';
+function emptyMutableGroup() {
+    return {
+        count: 0,
+        reachedDone: 0,
+        cost: 0,
+        costReportedAttempts: 0,
+        doneThisAttempt: false,
+        reportedThisAttempt: false,
+    };
+}
+function freezeGroup(group) {
+    return {
+        count: group.count,
+        reachedDone: group.reachedDone,
+        cost: group.cost,
+        costReportedAttempts: group.costReportedAttempts,
+    };
+}
+/** An all-zero retry history, used as the accumulation seed. */
+export function emptyRetryHistory() {
+    return {
+        automatic: {
+            count: 0,
+            reachedDone: 0,
+            cost: 0,
+            costReportedAttempts: 0,
+        },
+        manual: {
+            count: 0,
+            reachedDone: 0,
+            cost: 0,
+            costReportedAttempts: 0,
+        },
+        stuck: 0,
+    };
+}
+/**
+ * Projects one numbered task stream. Each `retry` event opens an attempt that
+ * runs to the next `retry` or the end of the stream; a `done` inside it counts
+ * as reached, and finite cost values inside it sum into the group. A cost
+ * before the first retry belongs to no retry-opened attempt and is ignored.
+ */
+export function observeRetries(events) {
+    const automatic = emptyMutableGroup();
+    const manual = emptyMutableGroup();
+    let stuck = 0;
+    let active = null;
+    for (const event of events) {
+        const type = event.type;
+        const data = asData(event);
+        if (type === 'retry') {
+            active = data?.automatic === true ? automatic : manual;
+            active.count++;
+            active.doneThisAttempt = false;
+            active.reportedThisAttempt = false;
+            continue;
+        }
+        if (type === 'stuck') {
+            stuck++;
+            continue;
+        }
+        if (active === null)
+            continue;
+        if (type === 'done') {
+            if (!active.doneThisAttempt) {
+                active.doneThisAttempt = true;
+                active.reachedDone++;
+            }
+            continue;
+        }
+        const rawCost = data?.cost;
+        if (typeof rawCost === 'number' && Number.isFinite(rawCost)) {
+            active.cost += rawCost;
+            if (!active.reportedThisAttempt) {
+                active.reportedThisAttempt = true;
+                active.costReportedAttempts++;
+            }
+        }
+    }
+    return { automatic: freezeGroup(automatic), manual: freezeGroup(manual), stuck };
+}
+function addGroup(left, right) {
+    return {
+        count: left.count + right.count,
+        reachedDone: left.reachedDone + right.reachedDone,
+        cost: left.cost + right.cost,
+        costReportedAttempts: left.costReportedAttempts + right.costReportedAttempts,
+    };
+}
+/** Sums two retry histories field by field. */
+export function addRetryHistory(left, right) {
+    return {
+        automatic: addGroup(left.automatic, right.automatic),
+        manual: addGroup(left.manual, right.manual),
+        stuck: left.stuck + right.stuck,
+    };
+}
+//# sourceMappingURL=report-retries.js.map

package/dist/core/report/report-retries.js.map

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

package/dist/core/report/report.d.ts

@@ -0,0 +1,276 @@
+import { type OsqConfig } from '../foundation/config.js';
+import { type QueueReport } from '../status/queue-report.js';
+import { type ApprovalFlagOutcomes } from './approval-flags.js';
+import { type PlanningChangeEconomics, type PlanningComparison } from './planning-economics.js';
+import { type PreSpawnStartCounts } from './report-pre-spawn.js';
+import { type RetryHistory } from './report-retries.js';
+export interface SpecMetrics {
+    readonly total: number;
+    readonly active: number;
+    readonly archived: number;
+}
+/**
+ * Current task state derived exclusively from marker files. Verified and
+ * manual are always present, including when zero, so consumers never have to
+ * infer their absence.
+ */
+export interface NowMetrics {
+    readonly total: number;
+    readonly done: number;
+    readonly verified: number;
+    readonly manual: number;
+    readonly dead: number;
+    readonly regressed: number;
+    readonly running: number;
+    readonly pending: number;
+    readonly unmarked: number;
+}
+export interface DurationMetrics {
+    readonly totalMs: number;
+    readonly totalSeconds: number;
+    readonly avgMs: number;
+    readonly avgSeconds: number;
+    readonly formattedTotal: string;
+    readonly formattedAvg: string;
+}
+export interface TokenMetrics {
+    readonly input: number;
+    readonly cached_input: number;
+    readonly output: number;
+    readonly reasoning: number;
+    readonly total: number;
+    readonly cacheSharePercent: number;
+}
+export interface FileChangeMetrics {
+    readonly totalChanges: number;
+    readonly uniqueCount: number;
+    readonly uniqueFiles: readonly string[];
+}
+export interface AttemptMetrics {
+    readonly total: number;
+    readonly byTask: Record<string, number>;
+    readonly multipleAttempts: readonly string[];
+}
+export interface UnexplainedReruns {
+    readonly total: number;
+    readonly byTask: Record<string, number>;
+}
+export interface VerifyRunMetrics {
+    readonly total: number;
+    readonly missingExitCode: number;
+    readonly byTask: Record<string, readonly (number | null)[]>;
+}
+/**
+ * Historical cost derived only from finite cost values on task events. The
+ * total is never estimated; coverage states how many attempts reported cost
+ * out of every recorded attempt.
+ */
+export interface CostHistory {
+    readonly total: number;
+    readonly perSpec: Record<string, number>;
+    readonly formattedTotal: string;
+    readonly provenance: 'harness-reported';
+    readonly coverage: {
+        readonly reportedAttempts: number;
+        readonly totalAttempts: number;
+    };
+}
+/** One ordered size bucket with first-attempt outcome aggregates. */
+export interface SizeBucketRow {
+    readonly bucket: string;
+    readonly tasks: number;
+    readonly firstAttemptPassRate: number;
+    readonly meanAttempts: number;
+    readonly medianDurationSeconds: number | null;
+}
+/** The first-attempt pass with the greatest observed scope size. */
+export interface LargestFirstAttemptPass {
+    readonly change: string;
+    readonly task: string;
+    readonly title: string;
+    readonly scopeFiles: number;
+    readonly acceptanceLines: number;
+}
+/** Size-against-outcome buckets for one scope-file resolver generation. */
+export interface ScopeFileSeries {
+    readonly resolver: 'legacy' | 'resolver-2';
+    readonly startsAtChange: string | null;
+    readonly byScopeFiles: readonly SizeBucketRow[];
+    readonly largestFirstAttemptPass: LargestFirstAttemptPass | null;
+}
+/**
+ * Acceptance-line buckets plus the ordered legacy and resolver-2 scope-file
+ * series. Scope-file counts never compare across resolver generations; the
+ * acceptance-line unit did not change, so it stays one combined series.
+ */
+export interface SizeMetrics {
+    readonly scopeFileSeries: readonly ScopeFileSeries[];
+    readonly byAcceptanceLines: readonly SizeBucketRow[];
+}
+/**
+ * Scope-regression detection and recertification counters derived only from
+ * typed events in numbered task streams. Legacy scope detections without a
+ * finite exit code remain visible in `detected` without guessed pass/fail.
+ */
+export interface ScopeRegressionHistory {
+    readonly detected: number;
+    readonly verificationPassedAtDetection: number;
+    readonly verificationFailedAtDetection: number;
+    readonly recertifiedByHuman: number;
+    readonly requeuedForAgent: number;
+}
+/** Execution history derived exclusively from append-only task event files. */
+export interface HistoryMetrics {
+    readonly attempts: AttemptMetrics;
+    readonly deadByReason: Record<string, number>;
+    readonly unexplainedReruns: UnexplainedReruns;
+    readonly verifyRuns: VerifyRunMetrics;
+    readonly preSpawnVerify: PreSpawnVerifyHistory;
+    readonly cost: CostHistory;
+    readonly retries: RetryHistory;
+    readonly rejections: RejectionHistory;
+    readonly sizes: SizeMetrics;
+    readonly scopeRegressions: ScopeRegressionHistory;
+}
+/**
+ * Pre-spawn verify runs and mismatches, counted apart from verification gates.
+ * `mismatchedTasks` lists the change-and-task references of tasks with at least
+ * one mismatch, in the same form as `verifyRuns.byTask` keys.
+ */
+export interface PreSpawnVerifyHistory {
+    readonly runs: number;
+    readonly mismatches: number;
+    readonly mismatchedTasks: readonly string[];
+    /** Runs whose pre-spawn event recorded a non-empty `missingPaths`. */
+    readonly missingPathRuns: number;
+    /** Runs and zero-exit passes for each declared `expected` start state. */
+    readonly byStart: PreSpawnStartCounts;
+}
+/**
+ * Rejected-change history. A folder contributes at most once, and only when its
+ * change-level event stream contains a valid `rejected` event; planner grouping
+ * comes solely from `brief.md` frontmatter.
+ */
+export interface RejectionHistory {
+    readonly total: number;
+    readonly byPlannerModel: Record<string, number>;
+}
+export interface CoverageByChange {
+    readonly withEvents: readonly string[];
+    readonly withoutEvents: readonly string[];
+}
+/** Event-file coverage for every discovered task. */
+export interface CoverageMetrics {
+    readonly withEvents: number;
+    readonly withoutEvents: number;
+    readonly byChange: Record<string, CoverageByChange>;
+}
+export interface MetricsReport {
+    readonly approvalFlags: ApprovalFlagOutcomes;
+    readonly completionRate: number;
+    readonly coverage: CoverageMetrics;
+    readonly cycle: CycleMetrics;
+    readonly durations: DurationMetrics;
+    readonly fileChanges: FileChangeMetrics;
+    readonly history: HistoryMetrics;
+    readonly now: NowMetrics;
+    readonly planning: PlanningMetrics;
+    readonly queue: QueueReport;
+    readonly specs: SpecMetrics;
+    readonly tokens: TokenMetrics;
+}
+/** Aggregate planning usage derived only from `.run/plan.jsonl` lifecycle pairs. */
+export interface PlanningMetrics {
+    readonly sessions: number;
+    /**
+     * Distinct active and archived changes carrying at least one valid
+     * `plan_started` record of either source. Exit-only and malformed lines do
+     * not cover a change, and repeated sessions for one change count once.
+     */
+    readonly changesWithPlanningRecords: number;
+    readonly wallSeconds: number;
+    readonly wallSecondsByChange: Record<string, number>;
+    readonly tokens: {
+        readonly input: number;
+        readonly output: number;
+        readonly cached: number;
+        readonly reasoning: number;
+    };
+    readonly cost: {
+        readonly total: number;
+        readonly formattedTotal: string;
+        readonly provenance: 'harness-reported';
+    };
+    readonly coverage: {
+        readonly reportedSessions: number;
+        readonly totalSessions: number;
+    };
+    /** Per change planning economics for every change with a valid start. */
+    readonly byChange: Record<string, PlanningChangeEconomics>;
+    /** Planning against executor tokens and cost, in totals. */
+    readonly comparison: PlanningComparison;
+}
+/** One aggregate over archived changes for a single lifecycle phase. */
+export interface CyclePhaseMetrics {
+    readonly totalSeconds: number;
+    readonly averageSeconds: number;
+    readonly coveredChanges: number;
+    readonly totalChanges: number;
+}
+/** Nullable lifecycle durations for one archived change. */
+export interface CycleChangeMetrics {
+    readonly change: string;
+    readonly briefToApprovalSeconds: number | null;
+    readonly approvalToFirstTaskSeconds: number | null;
+    readonly firstTaskToArchiveSeconds: number | null;
+    readonly totalSeconds: number | null;
+}
+/** Archived change cycle time, with aggregate phase lines and per-change rows. */
+export interface CycleMetrics {
+    readonly phases: {
+        readonly briefToApproval: CyclePhaseMetrics;
+        readonly approvalToFirstTask: CyclePhaseMetrics;
+        readonly firstTaskToArchive: CyclePhaseMetrics;
+        readonly total: CyclePhaseMetrics;
+    };
+    readonly byChange: readonly CycleChangeMetrics[];
+}
+export declare function formatDuration(ms: number): string;
+export declare function formatCost(total: number): string;
+export declare function getMetricsReport(projectRoot: string, config?: OsqConfig): Promise<MetricsReport>;
+/**
+ * Alias for {@link getMetricsReport} matching the report-generation name used
+ * by the metrics-and-reporting spec.
+ */
+export declare const generateReport: typeof getMetricsReport;
+/** One historical dead outcome rendered in the repository record. */
+export interface RepositoryDeadOutcome {
+    readonly change: string;
+    readonly title: string;
+    readonly reason: string;
+}
+/** Bounded repository record derived only from recent archived changes. */
+export interface RepositoryRecord {
+    readonly measuredTasks: number;
+    readonly firstAttemptPassRate: number;
+    readonly medianDurationSeconds: number | null;
+    readonly largestFirstAttemptPass: LargestFirstAttemptPass | null;
+    /** Resolver generation behind the largest scope pass, or null when none. */
+    readonly scopeFileResolver: 'legacy' | 'resolver-2' | null;
+    readonly deadOutcomes: readonly RepositoryDeadOutcome[];
+}
+export declare const REPOSITORY_RECORD_MIN_MEASURED_TASKS = 5;
+export declare const REPOSITORY_RECORD_MAX_ARCHIVED_CHANGES = 20;
+export declare const REPOSITORY_RECORD_MAX_DEAD_OUTCOMES = 10;
+/**
+ * Shared bounded repository record: at most the 20 newest canonical archived
+ * changes by numeric id, with measured outcomes and up to ten dead rows.
+ */
+export declare function getRepositoryRecord(projectRoot: string, config?: OsqConfig): Promise<RepositoryRecord>;
+/**
+ * Body of the planning prompt's repository-record section. The caller owns the
+ * heading. Fewer than five measured tasks print only the too-small sentence.
+ */
+export declare function formatRepositoryRecordBody(record: RepositoryRecord): string;
+export declare function formatMetricsReport(report: MetricsReport, config?: OsqConfig): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/core/report/report.d.ts.map

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