@hongmaple0820/med-scale-research-os 0.43.0

package/dist/runtime/ModelUsageLedger.d.ts

@@ -0,0 +1,101 @@
+export interface ModelUsageInput {
+    provider: string;
+    model?: string;
+    taskId?: string;
+    sessionId?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheEligibleTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+    cachedTokens?: number;
+    estimatedCostUsd?: number;
+    metadata?: Record<string, string | number | boolean>;
+    timestamp?: string;
+}
+export interface ModelUsageRecord extends Required<Omit<ModelUsageInput, 'model' | 'taskId' | 'sessionId' | 'estimatedCostUsd' | 'metadata'>> {
+    id: string;
+    model?: string;
+    taskId?: string;
+    sessionId?: string;
+    estimatedCostUsd?: number;
+    metadata?: Record<string, string | number | boolean>;
+    totalTokens: number;
+    cacheSavingsTokens: number;
+}
+export interface ModelUsageSummary {
+    totalRecords: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalTokens: number;
+    cacheEligibleTokens: number;
+    cacheCreationInputTokens: number;
+    cacheReadInputTokens: number;
+    cachedTokens: number;
+    cacheSavingsTokens: number;
+    estimatedCostUsd?: number;
+    byProvider: Record<string, {
+        records: number;
+        totalTokens: number;
+        cacheSavingsTokens: number;
+    }>;
+}
+export interface ModelUsageFilter {
+    day?: string;
+    since?: string;
+    until?: string;
+    provider?: string;
+    model?: string;
+    taskId?: string;
+    sessionId?: string;
+    limit?: number;
+    sort?: 'asc' | 'desc';
+}
+export interface ModelUsageBreakdownRow {
+    key: string;
+    records: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cacheSavingsTokens: number;
+    estimatedCostUsd?: number;
+}
+export interface ModelUsageReport {
+    generatedAt: string;
+    filters: {
+        day?: string;
+        since?: string;
+        until?: string;
+        provider?: string;
+        model?: string;
+        taskId?: string;
+        sessionId?: string;
+        limit: number;
+    };
+    summary: ModelUsageSummary;
+    byProvider: ModelUsageBreakdownRow[];
+    byModel: ModelUsageBreakdownRow[];
+    byTask: ModelUsageBreakdownRow[];
+    byDay: ModelUsageBreakdownRow[];
+    records: ModelUsageRecord[];
+}
+export interface ModelUsagePayloadInput extends Omit<ModelUsageInput, 'inputTokens' | 'outputTokens' | 'cacheEligibleTokens' | 'cacheCreationInputTokens' | 'cacheReadInputTokens' | 'cachedTokens'> {
+    usagePayload?: unknown;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheEligibleTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+    cachedTokens?: number;
+}
+export declare class ModelUsageLedger {
+    private usageDir;
+    private usagePath;
+    constructor(scaleDir?: string);
+    record(input: ModelUsageInput): ModelUsageRecord;
+    list(filter?: ModelUsageFilter): ModelUsageRecord[];
+    summarize(filter?: ModelUsageFilter): ModelUsageSummary;
+    report(filter?: ModelUsageFilter): ModelUsageReport;
+    private readAll;
+}
+export declare function buildModelUsageInput(input: ModelUsagePayloadInput): ModelUsageInput;

package/dist/runtime/ModelUsageLedger.js

@@ -0,0 +1,296 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export class ModelUsageLedger {
+    constructor(scaleDir = process.env.SCALE_DIR ?? '.scale') {
+        this.usageDir = join(scaleDir, 'model-usage');
+        this.usagePath = join(this.usageDir, 'usage.jsonl');
+    }
+    record(input) {
+        if (!existsSync(this.usageDir))
+            mkdirSync(this.usageDir, { recursive: true });
+        const record = normalizeRecord(input);
+        appendFileSync(this.usagePath, JSON.stringify(record) + '\n', 'utf-8');
+        return record;
+    }
+    list(filter = {}) {
+        const records = this.readAll()
+            .filter(record => matchesFilter(record, filter))
+            .sort((left, right) => compareRecordTimestamp(left, right, filter.sort ?? 'desc'));
+        return applyLimit(records, filter.limit);
+    }
+    summarize(filter = {}) {
+        return summarizeRecords(this.list({ ...filter, limit: undefined }));
+    }
+    report(filter = {}) {
+        const limit = normalizeLimit(filter.limit);
+        const records = this.list({ ...filter, limit: undefined });
+        return {
+            generatedAt: new Date().toISOString(),
+            filters: {
+                day: filter.day,
+                since: filter.since,
+                until: filter.until,
+                provider: filter.provider,
+                model: filter.model,
+                taskId: filter.taskId,
+                sessionId: filter.sessionId,
+                limit,
+            },
+            summary: summarizeRecords(records),
+            byProvider: breakdownRows(records, record => record.provider),
+            byModel: breakdownRows(records, record => record.model ?? '(unknown)'),
+            byTask: breakdownRows(records, record => record.taskId ?? '(none)'),
+            byDay: breakdownRows(records, record => normalizeDay(record.timestamp) ?? '(unknown)'),
+            records: limit > 0 ? records.slice(0, limit) : records,
+        };
+    }
+    readAll() {
+        if (!existsSync(this.usagePath))
+            return [];
+        return readFileSync(this.usagePath, 'utf-8')
+            .split('\n')
+            .map(line => parseRecordLine(line))
+            .filter((record) => Boolean(record));
+    }
+}
+export function buildModelUsageInput(input) {
+    const usage = findUsagePayload(input.usagePayload);
+    const cacheCreationInputTokens = preferredNumber(input.cacheCreationInputTokens, usage, [['cache_creation_input_tokens'], ['cacheCreationInputTokens']]);
+    const cacheReadInputTokens = preferredNumber(input.cacheReadInputTokens, usage, [['cache_read_input_tokens'], ['cacheReadInputTokens']]);
+    const cachedTokens = preferredNumber(input.cachedTokens, usage, [
+        ['cached_tokens'],
+        ['prompt_tokens_details', 'cached_tokens'],
+        ['input_tokens_details', 'cached_tokens'],
+        ['promptTokensDetails', 'cachedTokens'],
+        ['inputTokensDetails', 'cachedTokens'],
+    ]);
+    return {
+        provider: input.provider,
+        model: input.model,
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+        inputTokens: preferredNumber(input.inputTokens, usage, [['input_tokens'], ['prompt_tokens'], ['inputTokens'], ['promptTokens']]),
+        outputTokens: preferredNumber(input.outputTokens, usage, [['output_tokens'], ['completion_tokens'], ['outputTokens'], ['completionTokens']]),
+        cacheEligibleTokens: preferredNumber(input.cacheEligibleTokens, usage, [['cache_eligible_tokens'], ['cacheEligibleTokens']], Math.max(cacheCreationInputTokens, cacheReadInputTokens, cachedTokens)),
+        cacheCreationInputTokens,
+        cacheReadInputTokens,
+        cachedTokens,
+        estimatedCostUsd: input.estimatedCostUsd,
+        metadata: input.metadata,
+        timestamp: input.timestamp,
+    };
+}
+function summarizeRecords(records) {
+    const summary = {
+        totalRecords: records.length,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalTokens: 0,
+        cacheEligibleTokens: 0,
+        cacheCreationInputTokens: 0,
+        cacheReadInputTokens: 0,
+        cachedTokens: 0,
+        cacheSavingsTokens: 0,
+        byProvider: {},
+    };
+    let cost;
+    for (const record of records) {
+        summary.totalInputTokens += record.inputTokens;
+        summary.totalOutputTokens += record.outputTokens;
+        summary.totalTokens += record.totalTokens;
+        summary.cacheEligibleTokens += record.cacheEligibleTokens;
+        summary.cacheCreationInputTokens += record.cacheCreationInputTokens;
+        summary.cacheReadInputTokens += record.cacheReadInputTokens;
+        summary.cachedTokens += record.cachedTokens;
+        summary.cacheSavingsTokens += record.cacheSavingsTokens;
+        if (record.estimatedCostUsd !== undefined)
+            cost = (cost ?? 0) + record.estimatedCostUsd;
+        const provider = summary.byProvider[record.provider] ?? { records: 0, totalTokens: 0, cacheSavingsTokens: 0 };
+        provider.records += 1;
+        provider.totalTokens += record.totalTokens;
+        provider.cacheSavingsTokens += record.cacheSavingsTokens;
+        summary.byProvider[record.provider] = provider;
+    }
+    if (cost !== undefined)
+        summary.estimatedCostUsd = roundCost(cost);
+    return summary;
+}
+function normalizeRecord(input) {
+    const inputTokens = nonNegative(input.inputTokens);
+    const outputTokens = nonNegative(input.outputTokens);
+    const cacheCreationInputTokens = nonNegative(input.cacheCreationInputTokens);
+    const cacheReadInputTokens = nonNegative(input.cacheReadInputTokens);
+    const cachedTokens = nonNegative(input.cachedTokens);
+    const cacheSavingsTokens = Math.max(cacheReadInputTokens, cachedTokens);
+    return {
+        id: `USAGE-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        timestamp: input.timestamp ?? new Date().toISOString(),
+        provider: input.provider,
+        model: input.model,
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+        inputTokens,
+        outputTokens,
+        cacheEligibleTokens: nonNegative(input.cacheEligibleTokens),
+        cacheCreationInputTokens,
+        cacheReadInputTokens,
+        cachedTokens,
+        estimatedCostUsd: input.estimatedCostUsd,
+        metadata: input.metadata,
+        totalTokens: inputTokens + outputTokens,
+        cacheSavingsTokens,
+    };
+}
+function breakdownRows(records, groupBy) {
+    const summaryByKey = new Map();
+    for (const record of records) {
+        const key = groupBy(record);
+        const row = summaryByKey.get(key) ?? {
+            key,
+            records: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            totalTokens: 0,
+            cacheSavingsTokens: 0,
+        };
+        row.records += 1;
+        row.inputTokens += record.inputTokens;
+        row.outputTokens += record.outputTokens;
+        row.totalTokens += record.totalTokens;
+        row.cacheSavingsTokens += record.cacheSavingsTokens;
+        if (record.estimatedCostUsd !== undefined) {
+            row.estimatedCostUsd = roundCost((row.estimatedCostUsd ?? 0) + record.estimatedCostUsd);
+        }
+        summaryByKey.set(key, row);
+    }
+    return [...summaryByKey.values()]
+        .sort((left, right) => right.totalTokens - left.totalTokens || left.key.localeCompare(right.key));
+}
+function matchesFilter(record, filter) {
+    if (filter.day && normalizeDay(record.timestamp) !== filter.day)
+        return false;
+    if (filter.provider && record.provider !== filter.provider)
+        return false;
+    if (filter.model && record.model !== filter.model)
+        return false;
+    if (filter.taskId && record.taskId !== filter.taskId)
+        return false;
+    if (filter.sessionId && record.sessionId !== filter.sessionId)
+        return false;
+    const timestamp = parseTimestamp(record.timestamp);
+    if (filter.since) {
+        const since = parseTimestamp(filter.since);
+        if (timestamp !== undefined && since !== undefined && timestamp < since)
+            return false;
+    }
+    if (filter.until) {
+        const until = parseTimestamp(filter.until);
+        if (timestamp !== undefined && until !== undefined && timestamp > until)
+            return false;
+    }
+    return true;
+}
+function compareRecordTimestamp(left, right, sort) {
+    const leftTime = parseTimestamp(left.timestamp) ?? 0;
+    const rightTime = parseTimestamp(right.timestamp) ?? 0;
+    if (leftTime === rightTime)
+        return left.id.localeCompare(right.id);
+    return sort === 'asc' ? leftTime - rightTime : rightTime - leftTime;
+}
+function applyLimit(records, limit) {
+    const normalized = normalizeLimit(limit);
+    return normalized > 0 ? records.slice(0, normalized) : records;
+}
+function normalizeLimit(limit) {
+    return Number.isFinite(limit) && (limit ?? 0) > 0 ? Number(limit) : 20;
+}
+function parseRecordLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+function findUsagePayload(payload) {
+    const root = asRecord(payload);
+    if (!root)
+        return undefined;
+    const response = asRecord(root.response);
+    const result = asRecord(root.result);
+    const data = asRecord(root.data);
+    const candidates = [
+        root,
+        asRecord(root.usage),
+        response ? asRecord(response.usage) : undefined,
+        result ? asRecord(result.usage) : undefined,
+        data ? asRecord(data.usage) : undefined,
+    ].filter((candidate) => Boolean(candidate));
+    return candidates.find(candidate => hasKnownUsageField(candidate));
+}
+function hasKnownUsageField(value) {
+    return [
+        ['input_tokens'],
+        ['prompt_tokens'],
+        ['output_tokens'],
+        ['completion_tokens'],
+        ['cache_creation_input_tokens'],
+        ['cache_read_input_tokens'],
+        ['cached_tokens'],
+        ['prompt_tokens_details', 'cached_tokens'],
+        ['input_tokens_details', 'cached_tokens'],
+    ].some(path => getNumberAtPath(value, path) !== undefined);
+}
+function preferredNumber(explicit, usage, paths, fallback = 0) {
+    if (explicit !== undefined)
+        return nonNegative(explicit);
+    if (!usage)
+        return nonNegative(fallback);
+    for (const path of paths) {
+        const value = getNumberAtPath(usage, path);
+        if (value !== undefined)
+            return nonNegative(value);
+    }
+    return nonNegative(fallback);
+}
+function getNumberAtPath(record, path) {
+    let current = record;
+    for (const key of path) {
+        const object = asRecord(current);
+        if (!object || !(key in object))
+            return undefined;
+        current = object[key];
+    }
+    return typeof current === 'number'
+        ? current
+        : typeof current === 'string' && current.trim() !== '' && !Number.isNaN(Number(current))
+            ? Number(current)
+            : undefined;
+}
+function normalizeDay(timestamp) {
+    const parsed = parseTimestamp(timestamp);
+    return parsed === undefined ? undefined : new Date(parsed).toISOString().slice(0, 10);
+}
+function parseTimestamp(value) {
+    if (!value)
+        return undefined;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function asRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function roundCost(value) {
+    return Math.round(value * 1_000_000) / 1_000_000;
+}
+function nonNegative(value) {
+    if (value === undefined || Number.isNaN(value) || value < 0)
+        return 0;
+    return value;
+}
+//# sourceMappingURL=ModelUsageLedger.js.map

package/dist/runtime/ModelUsageLedger.js.map

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

package/dist/runtime/RuntimeDoctor.d.ts

@@ -0,0 +1,23 @@
+import { type RuntimeEvidenceSummary } from './RuntimeEvidenceLedger.js';
+import { type RuntimeSessionLevel } from './SessionLedger.js';
+export type RuntimeDoctorStatus = 'ok' | 'warn' | 'fail';
+export interface RuntimeDoctorCheck {
+    name: string;
+    status: RuntimeDoctorStatus;
+    message: string;
+    fix?: string;
+}
+export interface RuntimeDoctorOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    taskId?: string;
+    sessionId?: string;
+    level?: RuntimeSessionLevel;
+}
+export interface RuntimeDoctorReport {
+    ok: boolean;
+    blocked: boolean;
+    checks: RuntimeDoctorCheck[];
+    evidence: RuntimeEvidenceSummary;
+}
+export declare function doctorRuntimeEvidence(options?: RuntimeDoctorOptions): RuntimeDoctorReport;

package/dist/runtime/RuntimeDoctor.js

@@ -0,0 +1,151 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { RuntimeEvidenceLedger } from './RuntimeEvidenceLedger.js';
+import { SessionLedger } from './SessionLedger.js';
+import { loadVerificationMatrix, resolveVerificationPolicy } from '../workflow/VerificationProfile.js';
+export function doctorRuntimeEvidence(options = {}) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const scaleRoot = isAbsolute(options.scaleDir ?? '')
+        ? options.scaleDir
+        : join(projectDir, options.scaleDir ?? '.scale');
+    const evidenceDir = join(scaleRoot, 'evidence', 'runtime');
+    const sessionsDir = join(scaleRoot, 'events', 'sessions');
+    const evidenceLedger = new RuntimeEvidenceLedger({ projectDir, scaleDir: scaleRoot, createDirs: false });
+    const sessionLedger = new SessionLedger({ projectDir, scaleDir: scaleRoot, createDirs: false });
+    const policy = resolveVerificationPolicy(loadVerificationMatrix(projectDir, scaleRoot));
+    const evidence = evidenceLedger.summary({
+        taskId: options.taskId,
+        sessionId: options.sessionId,
+    });
+    const evidenceRecords = evidenceLedger.list({
+        taskId: options.taskId,
+        sessionId: options.sessionId,
+        limit: Number.MAX_SAFE_INTEGER,
+    });
+    const checks = [];
+    checks.push(checkDirectory('Runtime evidence directory', evidenceDir, 'Run: scale runtime record ...'));
+    checks.push(checkDirectory('Runtime session directory', sessionsDir, 'Run: scale runtime start --session-id <id>'));
+    checks.push(checkSessionJsonl(sessionsDir, options.sessionId));
+    if (options.sessionId) {
+        const events = sessionLedger.listEvents(options.sessionId);
+        checks.push(events.length > 0
+            ? { name: 'Runtime session events', status: 'ok', message: `${events.length} event(s) for ${options.sessionId}` }
+            : { name: 'Runtime session events', status: 'warn', message: `No events recorded for ${options.sessionId}`, fix: 'Run: scale runtime start or append runtime events' });
+    }
+    if (evidence.failed > 0) {
+        checks.push({
+            name: 'Runtime failed evidence',
+            status: 'fail',
+            message: `${evidence.failed} failed runtime evidence record(s)`,
+            fix: 'Fix the failing command/tool output and record a passing evidence item',
+        });
+    }
+    else {
+        checks.push({
+            name: 'Runtime failed evidence',
+            status: 'ok',
+            message: evidence.expectedRed > 0
+                ? `No unresolved failed runtime evidence records; ${evidence.expectedRed} expected red reproduction record(s)`
+                : 'No failed runtime evidence records',
+        });
+    }
+    const level = options.level ?? 'M';
+    if (level !== 'S' && evidence.passed === 0) {
+        checks.push({
+            name: 'Runtime completion evidence',
+            status: 'warn',
+            message: `No passed evidence recorded for ${scopeLabel(options)}`,
+            fix: 'Record at least one passed command, gate, tool, browser, or skill evidence before claiming completion',
+        });
+    }
+    else {
+        checks.push({
+            name: 'Runtime completion evidence',
+            status: 'ok',
+            message: `${evidence.passed} passed evidence record(s)`,
+        });
+    }
+    const productSmokeMode = policy.productSmokeGate ?? 'warn';
+    if (level !== 'S' && productSmokeMode !== 'off') {
+        const productSmokePassed = evidenceRecords.some(record => record.status === 'passed' && isProductSmokeEvidence(record));
+        const productSmokeFailed = evidenceRecords.some(record => record.status === 'failed' && isProductSmokeEvidence(record));
+        if (productSmokePassed) {
+            checks.push({
+                name: 'Runtime product smoke evidence',
+                status: 'ok',
+                message: 'Passed product smoke evidence recorded',
+            });
+        }
+        else {
+            checks.push({
+                name: 'Runtime product smoke evidence',
+                status: productSmokeMode === 'block' || productSmokeFailed ? 'fail' : 'warn',
+                message: productSmokeFailed
+                    ? 'Product smoke evidence failed and no later passed product smoke evidence was recorded'
+                    : 'No passed product smoke evidence recorded for this M/L/CRITICAL task',
+                fix: 'Run a real product-path smoke check and record it with metadata.productSmoke=true or metadata.realProductPath=true',
+            });
+        }
+    }
+    const blocked = checks.some(check => check.status === 'fail');
+    return {
+        ok: !blocked,
+        blocked,
+        checks,
+        evidence,
+    };
+}
+function isProductSmokeEvidence(record) {
+    const metadata = record.metadata ?? {};
+    if (metadata.productSmoke === true || metadata.realProductPath === true)
+        return true;
+    if (metadata.gate === 'G8' || metadata.gate === 'productSmoke')
+        return true;
+    const text = `${record.title}\n${record.summary}`.toLowerCase();
+    return text.includes('product smoke') || text.includes('real product path');
+}
+function checkDirectory(name, dir, fix) {
+    if (!existsSync(dir)) {
+        return { name, status: 'warn', message: `Missing ${dir}`, fix };
+    }
+    return { name, status: 'ok', message: `Found ${dir}` };
+}
+function checkSessionJsonl(sessionsDir, sessionId) {
+    if (!existsSync(sessionsDir)) {
+        return { name: 'Runtime session JSONL', status: 'warn', message: 'No session JSONL directory yet' };
+    }
+    const files = sessionId
+        ? [`${safePathSegment(sessionId)}.jsonl`].filter(file => existsSync(join(sessionsDir, file)))
+        : readdirSync(sessionsDir).filter(file => file.endsWith('.jsonl'));
+    for (const file of files) {
+        const path = join(sessionsDir, file);
+        const lines = readFileSync(path, 'utf-8').split(/\r?\n/).filter(Boolean);
+        for (const line of lines) {
+            try {
+                JSON.parse(line);
+            }
+            catch {
+                return {
+                    name: 'Runtime session JSONL',
+                    status: 'fail',
+                    message: `${file} contains invalid JSONL`,
+                    fix: 'Remove or repair the invalid session event line',
+                };
+            }
+        }
+    }
+    return {
+        name: 'Runtime session JSONL',
+        status: 'ok',
+        message: `${files.length} session file(s) parse cleanly`,
+    };
+}
+function scopeLabel(options) {
+    if (options.taskId && options.sessionId)
+        return `${options.taskId}/${options.sessionId}`;
+    return options.taskId ?? options.sessionId ?? 'current scope';
+}
+function safePathSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, '-').slice(0, 120) || 'unknown-session';
+}
+//# sourceMappingURL=RuntimeDoctor.js.map

package/dist/runtime/RuntimeDoctor.js.map

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

package/dist/runtime/RuntimeEvidenceLedger.d.ts

@@ -0,0 +1,50 @@
+export type RuntimeEvidenceKind = 'command' | 'gate' | 'tool' | 'skill' | 'mcp' | 'browser' | 'desktop' | 'manual' | 'final-report';
+export type RuntimeEvidenceStatus = 'passed' | 'failed' | 'skipped';
+export interface RuntimeEvidenceInput {
+    taskId?: string;
+    sessionId?: string;
+    kind: RuntimeEvidenceKind;
+    title: string;
+    status: RuntimeEvidenceStatus;
+    command?: string;
+    exitCode?: number;
+    summary: string;
+    artifacts?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface RuntimeEvidenceRecord extends RuntimeEvidenceInput {
+    id: string;
+    createdAt: string;
+    sequence: number;
+    redactionApplied: boolean;
+}
+export interface RuntimeEvidenceQuery {
+    taskId?: string;
+    sessionId?: string;
+    limit?: number;
+}
+export interface RuntimeEvidenceSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    expectedRed: number;
+    ok: boolean;
+    latestFailure?: RuntimeEvidenceRecord;
+}
+export interface RuntimeEvidenceLedgerOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    now?: () => Date;
+    createDirs?: boolean;
+}
+export declare class RuntimeEvidenceLedger {
+    private rootDir;
+    private now;
+    private sequence;
+    constructor(options?: RuntimeEvidenceLedgerOptions);
+    record(input: RuntimeEvidenceInput): RuntimeEvidenceRecord;
+    list(query?: RuntimeEvidenceQuery): RuntimeEvidenceRecord[];
+    get(id: string): RuntimeEvidenceRecord | null;
+    summary(query?: RuntimeEvidenceQuery): RuntimeEvidenceSummary;
+}