@dzhechkov/harness-core 0.8.2 → 0.8.6

package/dist/restart-advisor.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Deterministic, advisory-only policy for recognising a trailing low-grade QE streak.
+ *
+ * This module is intentionally value-in/value-out. The CLI owns filesystem reads, path confinement,
+ * defaults, and presentation; the core owns parsing, corroboration, policy, and the decision record.
+ */
+export declare const RESTART_ADVISOR_SCHEMA: "restart-advisor/1";
+export declare const RESTART_ADVISOR_MAX_EVIDENCE = 20;
+export declare const RESTART_ADVISOR_MAX_DIAGNOSTICS = 20;
+export type RestartGrade = 'A' | 'B' | 'C' | 'D' | 'F';
+export type RestartThreshold = 'C' | 'D';
+export type RestartSource = 'checkpoints' | 'training-pairs' | 'none';
+export type RestartPolicyOrigin = 'default' | 'flag' | 'caller';
+export type RestartRecommendation = 'RESTART_CODE_STAGE' | 'NO_RESTART_RECOMMENDATION' | 'NOT_ESTABLISHED' | 'INVALID_INPUT';
+export type RestartReason = 'TRAILING_STREAK_AT_OR_BELOW_THRESHOLD' | 'TRAILING_STREAK_INTERRUPTED' | 'INSUFFICIENT_TRAILING_EVIDENCE' | 'OPAQUE_TRAILING_EVIDENCE' | 'ROUND_GAP' | 'NO_QE_HISTORY' | 'SOURCE_CONFLICT' | 'SOURCE_EVIDENCE_INVALID' | 'POLICY_INVALID' | 'INPUT_INVALID';
+export interface RestartNormalizedRound {
+    readonly round: number;
+    readonly line: number;
+    readonly grade: RestartGrade | null;
+    readonly problem: 'UNSUPPORTED_GRADE' | 'MALFORMED_JSON' | 'INVALID_RECORD' | null;
+}
+export interface ParsedRestartHistory {
+    readonly source: Exclude<RestartSource, 'none'>;
+    readonly present: boolean;
+    readonly recordsRead: number;
+    readonly qeCandidates: number;
+    readonly identityMode: 'none' | 'explicit' | 'implicit' | 'mixed';
+    readonly rounds: readonly RestartNormalizedRound[];
+    readonly diagnostics: readonly string[];
+    readonly fatal: boolean;
+}
+export interface RestartDecisionInput {
+    readonly history: readonly RestartNormalizedRound[];
+    readonly threshold?: RestartThreshold;
+    readonly rounds?: number;
+}
+export interface RestartDecision {
+    readonly recommendation: RestartRecommendation;
+    readonly recommendRestart: boolean;
+    readonly autoAction: false;
+    readonly trailingAtOrBelow: number;
+    readonly reason: RestartReason;
+    readonly evidence: readonly RestartNormalizedRound[];
+}
+export interface RestartAdvisorInput {
+    readonly slug: string;
+    readonly checkpointsJsonl?: string | null;
+    readonly trainingPairsJsonl?: string | null;
+    /** I/O boundary failures already converted to deterministic, operator-visible diagnostics. */
+    readonly readDiagnostics?: readonly string[];
+    /** CLI/input-boundary refusals that must remain one versioned INVALID_INPUT result. */
+    readonly inputErrors?: readonly string[];
+}
+export interface RestartAdvisorPolicy {
+    readonly threshold?: RestartThreshold;
+    readonly rounds?: number;
+    readonly thresholdOrigin?: RestartPolicyOrigin;
+    readonly roundsOrigin?: RestartPolicyOrigin;
+}
+export interface RestartAdvice {
+    readonly schema: typeof RESTART_ADVISOR_SCHEMA;
+    readonly slug: string;
+    readonly source: RestartSource;
+    readonly sourcePath: string | null;
+    readonly inspectedPaths: readonly string[];
+    readonly corroborated: boolean;
+    readonly policy: {
+        readonly threshold: RestartThreshold | null;
+        readonly thresholdOrigin: RestartPolicyOrigin;
+        readonly rounds: number | null;
+        readonly roundsOrigin: RestartPolicyOrigin;
+    };
+    readonly counts: {
+        readonly recordsRead: number;
+        readonly qeCandidates: number;
+        readonly normalizedRounds: number;
+        readonly trailingAtOrBelow: number;
+    };
+    readonly evidence: readonly RestartNormalizedRound[];
+    readonly evidenceSummary: {
+        readonly total: number;
+        readonly returned: number;
+        readonly truncated: boolean;
+    };
+    readonly diagnostics: readonly string[];
+    readonly diagnosticsSummary: {
+        readonly total: number;
+        readonly returned: number;
+        readonly truncated: boolean;
+    };
+    readonly recommendation: RestartRecommendation;
+    readonly recommendRestart: boolean;
+    readonly autoAction: false;
+    readonly trailingAtOrBelow: number;
+    readonly reason: RestartReason;
+    readonly decisionLogLine: string;
+}
+export declare function parseCheckpointQeHistory(jsonl: string | null | undefined): ParsedRestartHistory;
+export declare function parseTrainingPairQeHistory(jsonl: string | null | undefined): ParsedRestartHistory;
+export declare function decideRestartRecommendation(input: RestartDecisionInput): RestartDecision;
+export declare function renderRestartDecisionLog(advice: RestartAdvice): string;
+export declare function adviseRestart(input: RestartAdvisorInput, policy?: RestartAdvisorPolicy): RestartAdvice;
+//# sourceMappingURL=restart-advisor.d.ts.map

package/dist/restart-advisor.d.ts.map

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

package/dist/restart-advisor.js

@@ -0,0 +1,445 @@
+/**
+ * Deterministic, advisory-only policy for recognising a trailing low-grade QE streak.
+ *
+ * This module is intentionally value-in/value-out. The CLI owns filesystem reads, path confinement,
+ * defaults, and presentation; the core owns parsing, corroboration, policy, and the decision record.
+ */
+export const RESTART_ADVISOR_SCHEMA = 'restart-advisor/1';
+export const RESTART_ADVISOR_MAX_EVIDENCE = 20;
+export const RESTART_ADVISOR_MAX_DIAGNOSTICS = 20;
+const GRADES = new Set(['A', 'B', 'C', 'D', 'F']);
+const GRADE_RANK = { A: 5, B: 4, C: 3, D: 2, F: 1 };
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function canonicalGrade(value) {
+    return typeof value === 'string' && GRADES.has(value)
+        ? value
+        : null;
+}
+function boundedValue(value) {
+    let rendered;
+    try {
+        rendered = JSON.stringify(value);
+    }
+    catch {
+        rendered = String(value);
+    }
+    if (rendered === undefined)
+        rendered = String(value);
+    return rendered.length <= 120 ? rendered : `${rendered.slice(0, 117)}...`;
+}
+function nestedRecord(source, record) {
+    if (source === 'training-pairs')
+        return isRecord(record.evaluation) ? record.evaluation : null;
+    const result = isRecord(record.result) ? record.result : null;
+    return result !== null && isRecord(result.qe) ? result.qe : null;
+}
+function roundIdentity(record, nested) {
+    const values = [];
+    if (Object.prototype.hasOwnProperty.call(record, 'round'))
+        values.push(record.round);
+    if (nested !== null && Object.prototype.hasOwnProperty.call(nested, 'round'))
+        values.push(nested.round);
+    if (values.length === 0)
+        return { explicit: false, round: null, fatal: false, diagnostic: null };
+    if (!values.every((value) => Number.isInteger(value) && value > 0)) {
+        return {
+            explicit: true,
+            round: null,
+            fatal: true,
+            diagnostic: `invalid explicit round identity ${values.map(boundedValue).join(' / ')}`,
+        };
+    }
+    const distinct = [...new Set(values)];
+    if (distinct.length !== 1) {
+        return {
+            explicit: true,
+            round: null,
+            fatal: true,
+            diagnostic: `conflicting explicit round identities ${distinct.join(' / ')}`,
+        };
+    }
+    return { explicit: true, round: distinct[0], fatal: false, diagnostic: null };
+}
+function parseHistory(jsonl, source) {
+    const present = jsonl !== null && jsonl !== undefined;
+    if (!present || jsonl === '') {
+        return {
+            source, present, recordsRead: 0, qeCandidates: 0, identityMode: 'none',
+            rounds: [], diagnostics: [], fatal: false,
+        };
+    }
+    const candidates = [];
+    const diagnostics = [];
+    let recordsRead = 0;
+    let qeCandidates = 0;
+    let fatal = false;
+    const lines = jsonl.split(/\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        let physical = lines[index].replace(/\r$/, '');
+        if (index === 0)
+            physical = physical.replace(/^\uFEFF/, '');
+        if (physical.trim() === '')
+            continue;
+        recordsRead += 1;
+        const line = index + 1;
+        let parsed;
+        try {
+            parsed = JSON.parse(physical);
+        }
+        catch (error) {
+            diagnostics.push(`${source} line ${line}: malformed JSON (${error.message})`);
+            candidates.push({
+                line, fingerprint: physical, explicitIdentity: false, explicitRound: null,
+                grade: null, problem: 'MALFORMED_JSON',
+            });
+            continue;
+        }
+        if (!isRecord(parsed)) {
+            diagnostics.push(`${source} line ${line}: JSON record is not an object`);
+            candidates.push({
+                line, fingerprint: physical, explicitIdentity: false, explicitRound: null,
+                grade: null, problem: 'INVALID_RECORD',
+            });
+            continue;
+        }
+        if (parsed.stage !== 'qe')
+            continue;
+        qeCandidates += 1;
+        const nested = nestedRecord(source, parsed);
+        const identity = roundIdentity(parsed, nested);
+        if (identity.fatal) {
+            fatal = true;
+            diagnostics.push(`${source} line ${line}: ${identity.diagnostic}`);
+        }
+        const rawGrade = nested?.grade;
+        const grade = canonicalGrade(rawGrade);
+        const problem = grade === null ? 'UNSUPPORTED_GRADE' : null;
+        if (problem !== null) {
+            diagnostics.push(`${source} line ${line}: unsupported grade ${boundedValue(rawGrade)}; expected A|B|C|D|F`);
+        }
+        candidates.push({
+            line,
+            fingerprint: physical,
+            explicitIdentity: identity.explicit,
+            explicitRound: identity.round,
+            grade,
+            problem,
+        });
+    }
+    const identityCandidates = candidates.filter((candidate) => candidate.problem !== 'MALFORMED_JSON' && candidate.problem !== 'INVALID_RECORD');
+    const explicitCount = identityCandidates.filter((candidate) => candidate.explicitIdentity).length;
+    const implicitCount = identityCandidates.length - explicitCount;
+    const identityMode = candidates.length === 0
+        ? 'none'
+        : identityCandidates.length === 0
+            ? 'implicit'
+            : explicitCount === identityCandidates.length
+                ? 'explicit'
+                : implicitCount === identityCandidates.length
+                    ? 'implicit'
+                    : 'mixed';
+    if (identityMode === 'mixed') {
+        fatal = true;
+        diagnostics.push(`${source}: mixed explicit and implicit round identities are ambiguous`);
+    }
+    if (identityMode === 'explicit' && identityCandidates.length !== candidates.length) {
+        fatal = true;
+        diagnostics.push(`${source}: malformed records cannot be placed among explicit round identities`);
+    }
+    const rounds = [];
+    if (identityMode === 'implicit') {
+        let priorFingerprint = null;
+        for (const candidate of candidates) {
+            if (candidate.fingerprint === priorFingerprint)
+                continue;
+            priorFingerprint = candidate.fingerprint;
+            rounds.push({ round: rounds.length + 1, line: candidate.line, grade: candidate.grade, problem: candidate.problem });
+        }
+    }
+    else if (identityMode === 'explicit') {
+        const byRound = new Map();
+        for (const candidate of candidates) {
+            if (candidate.explicitRound === null)
+                continue;
+            const next = {
+                round: candidate.explicitRound,
+                line: candidate.line,
+                grade: candidate.grade,
+                problem: candidate.problem,
+            };
+            const prior = byRound.get(candidate.explicitRound);
+            if (prior === undefined) {
+                byRound.set(candidate.explicitRound, next);
+            }
+            else if (prior.grade !== next.grade || prior.problem !== next.problem) {
+                fatal = true;
+                diagnostics.push(`${source}: conflicting duplicate round ${candidate.explicitRound} at lines ${prior.line} and ${next.line}`);
+            }
+        }
+        rounds.push(...[...byRound.values()].sort((left, right) => left.round - right.round));
+    }
+    return {
+        source,
+        present,
+        recordsRead,
+        qeCandidates,
+        identityMode,
+        rounds,
+        diagnostics,
+        fatal,
+    };
+}
+export function parseCheckpointQeHistory(jsonl) {
+    return parseHistory(jsonl, 'checkpoints');
+}
+export function parseTrainingPairQeHistory(jsonl) {
+    return parseHistory(jsonl, 'training-pairs');
+}
+function boundedEvidence(history) {
+    return history.slice(-RESTART_ADVISOR_MAX_EVIDENCE).map((round) => ({ ...round }));
+}
+function invalidDecision(history) {
+    return {
+        recommendation: 'INVALID_INPUT',
+        recommendRestart: false,
+        autoAction: false,
+        trailingAtOrBelow: 0,
+        reason: 'POLICY_INVALID',
+        evidence: boundedEvidence(history),
+    };
+}
+export function decideRestartRecommendation(input) {
+    const { history, threshold, rounds } = input;
+    if ((threshold !== 'C' && threshold !== 'D')
+        || !Number.isFinite(rounds)
+        || !Number.isInteger(rounds)
+        || (rounds ?? 0) < 1) {
+        return invalidDecision(history);
+    }
+    const requiredRounds = rounds;
+    for (let index = 0; index < history.length; index += 1) {
+        const current = history[index];
+        if (!Number.isInteger(current.round) || current.round < 1
+            || (index > 0 && current.round <= history[index - 1].round)) {
+            return invalidDecision(history);
+        }
+    }
+    if (history.length === 0) {
+        return {
+            recommendation: 'NOT_ESTABLISHED', recommendRestart: false, autoAction: false,
+            trailingAtOrBelow: 0, reason: 'NO_QE_HISTORY', evidence: [],
+        };
+    }
+    let trailing = 0;
+    let expectedRound = history[history.length - 1].round;
+    let boundary = 'start';
+    for (let index = history.length - 1; index >= 0; index -= 1) {
+        const current = history[index];
+        if (current.round !== expectedRound) {
+            boundary = 'gap';
+            break;
+        }
+        if (current.grade === null || current.problem !== null) {
+            boundary = 'opaque';
+            break;
+        }
+        if (GRADE_RANK[current.grade] > GRADE_RANK[threshold]) {
+            boundary = 'better';
+            break;
+        }
+        trailing += 1;
+        expectedRound -= 1;
+    }
+    const evidence = boundedEvidence(history);
+    if (trailing >= requiredRounds) {
+        return {
+            recommendation: 'RESTART_CODE_STAGE', recommendRestart: true, autoAction: false,
+            trailingAtOrBelow: trailing, reason: 'TRAILING_STREAK_AT_OR_BELOW_THRESHOLD', evidence,
+        };
+    }
+    if (boundary === 'better') {
+        return {
+            recommendation: 'NO_RESTART_RECOMMENDATION', recommendRestart: false, autoAction: false,
+            trailingAtOrBelow: trailing, reason: 'TRAILING_STREAK_INTERRUPTED', evidence,
+        };
+    }
+    return {
+        recommendation: 'NOT_ESTABLISHED', recommendRestart: false, autoAction: false,
+        trailingAtOrBelow: trailing,
+        reason: boundary === 'gap'
+            ? 'ROUND_GAP'
+            : boundary === 'opaque'
+                ? 'OPAQUE_TRAILING_EVIDENCE'
+                : 'INSUFFICIENT_TRAILING_EVIDENCE',
+        evidence,
+    };
+}
+function sameNormalizedHistory(left, right) {
+    if (left.rounds.length !== right.rounds.length)
+        return false;
+    return left.rounds.every((round, index) => {
+        const other = right.rounds[index];
+        return other !== undefined
+            && round.round === other.round
+            && round.grade === other.grade
+            && round.problem === other.problem;
+    });
+}
+function sourcePath(slug, source) {
+    if (source === 'checkpoints')
+        return `features/${slug}/.fa-state/checkpoints.jsonl`;
+    if (source === 'training-pairs')
+        return `.dz/fa-training/${slug}/qe.jsonl`;
+    return null;
+}
+function assembleAdvice(checkpoints, trainingPairs, readDiagnostics, decisionInput) {
+    const diagnostics = [...readDiagnostics, ...checkpoints.diagnostics, ...trainingPairs.diagnostics];
+    if (readDiagnostics.length > 0 || checkpoints.fatal || trainingPairs.fatal) {
+        return {
+            source: 'none', selected: null, corroborated: false, diagnostics,
+            decision: {
+                recommendation: 'NOT_ESTABLISHED', recommendRestart: false, autoAction: false,
+                trailingAtOrBelow: 0, reason: 'SOURCE_EVIDENCE_INVALID', evidence: [],
+            },
+        };
+    }
+    const checkpointHasHistory = checkpoints.qeCandidates > 0;
+    const trainingHasHistory = trainingPairs.qeCandidates > 0;
+    if (!checkpointHasHistory && !trainingHasHistory) {
+        return {
+            source: 'none', selected: null, corroborated: false, diagnostics,
+            decision: decideRestartRecommendation({ history: [], ...decisionInput }),
+        };
+    }
+    if (checkpointHasHistory && trainingHasHistory && !sameNormalizedHistory(checkpoints, trainingPairs)) {
+        diagnostics.push('checkpoint and training-pair histories do not normalize to the same rounds; refusing to union them');
+        return {
+            source: 'none', selected: null, corroborated: false, diagnostics,
+            decision: {
+                recommendation: 'NOT_ESTABLISHED', recommendRestart: false, autoAction: false,
+                trailingAtOrBelow: 0, reason: 'SOURCE_CONFLICT', evidence: [],
+            },
+        };
+    }
+    const selected = checkpointHasHistory ? checkpoints : trainingPairs;
+    return {
+        source: selected.source,
+        selected,
+        corroborated: checkpointHasHistory && trainingHasHistory,
+        diagnostics,
+        decision: decideRestartRecommendation({ history: selected.rounds, ...decisionInput }),
+    };
+}
+function decisionLogPayload(advice) {
+    return {
+        slug: advice.slug,
+        recommendation: advice.recommendation,
+        autoAction: false,
+        threshold: advice.policy.threshold,
+        thresholdOrigin: advice.policy.thresholdOrigin,
+        rounds: advice.policy.rounds,
+        roundsOrigin: advice.policy.roundsOrigin,
+        trailingAtOrBelow: advice.trailingAtOrBelow,
+        source: advice.sourcePath ?? 'none',
+        evidence: advice.evidence.map((round) => ({
+            round: round.round,
+            grade: round.grade,
+            ...(round.problem === null ? {} : { problem: round.problem }),
+        })),
+        diagnostics: advice.diagnosticsSummary.total,
+        reason: advice.reason,
+    };
+}
+export function renderRestartDecisionLog(advice) {
+    return `restart-advisor decision ${JSON.stringify(decisionLogPayload(advice))}`;
+}
+export function adviseRestart(input, policy = {}) {
+    const checkpoints = parseCheckpointQeHistory(input.checkpointsJsonl);
+    const trainingPairs = parseTrainingPairQeHistory(input.trainingPairsJsonl);
+    const threshold = policy.threshold === 'C' || policy.threshold === 'D' ? policy.threshold : null;
+    const validRounds = Number.isFinite(policy.rounds) && Number.isInteger(policy.rounds) && (policy.rounds ?? 0) > 0
+        ? policy.rounds
+        : null;
+    const thresholdOrigin = policy.thresholdOrigin ?? 'caller';
+    const roundsOrigin = policy.roundsOrigin ?? 'caller';
+    const inspectedPaths = [
+        `features/${input.slug}/.fa-state/checkpoints.jsonl`,
+        `.dz/fa-training/${input.slug}/qe.jsonl`,
+    ];
+    let assembly;
+    if ((input.inputErrors?.length ?? 0) > 0) {
+        assembly = {
+            source: 'none', selected: null, corroborated: false,
+            diagnostics: [...(input.inputErrors ?? [])],
+            decision: {
+                recommendation: 'INVALID_INPUT', recommendRestart: false, autoAction: false,
+                trailingAtOrBelow: 0, reason: 'INPUT_INVALID', evidence: [],
+            },
+        };
+    }
+    else if (input.slug.trim() === '') {
+        assembly = {
+            source: 'none', selected: null, corroborated: false,
+            diagnostics: ['slug must be a non-empty string'],
+            decision: {
+                recommendation: 'INVALID_INPUT', recommendRestart: false, autoAction: false,
+                trailingAtOrBelow: 0, reason: 'INPUT_INVALID', evidence: [],
+            },
+        };
+    }
+    else if (threshold === null || validRounds === null) {
+        const invalid = decideRestartRecommendation({
+            history: [],
+            ...(threshold === null ? {} : { threshold }),
+            ...(validRounds === null ? {} : { rounds: validRounds }),
+        });
+        assembly = {
+            source: 'none', selected: null, corroborated: false,
+            diagnostics: ['threshold must be C|D and rounds must be a positive integer; core supplies no defaults'],
+            decision: invalid,
+        };
+    }
+    else {
+        assembly = assembleAdvice(checkpoints, trainingPairs, input.readDiagnostics ?? [], { threshold, rounds: validRounds });
+    }
+    const selected = assembly.selected;
+    const evidence = assembly.decision.evidence;
+    const boundedDiagnostics = assembly.diagnostics.slice(0, RESTART_ADVISOR_MAX_DIAGNOSTICS);
+    const base = {
+        schema: RESTART_ADVISOR_SCHEMA,
+        slug: input.slug,
+        source: assembly.source,
+        sourcePath: sourcePath(input.slug, assembly.source),
+        inspectedPaths,
+        corroborated: assembly.corroborated,
+        policy: { threshold, thresholdOrigin, rounds: validRounds, roundsOrigin },
+        counts: {
+            recordsRead: selected?.recordsRead ?? checkpoints.recordsRead + trainingPairs.recordsRead,
+            qeCandidates: selected?.qeCandidates ?? checkpoints.qeCandidates + trainingPairs.qeCandidates,
+            normalizedRounds: selected?.rounds.length ?? 0,
+            trailingAtOrBelow: assembly.decision.trailingAtOrBelow,
+        },
+        evidence,
+        evidenceSummary: {
+            total: selected?.rounds.length ?? evidence.length,
+            returned: evidence.length,
+            truncated: (selected?.rounds.length ?? evidence.length) > evidence.length,
+        },
+        diagnostics: boundedDiagnostics,
+        diagnosticsSummary: {
+            total: assembly.diagnostics.length,
+            returned: boundedDiagnostics.length,
+            truncated: assembly.diagnostics.length > boundedDiagnostics.length,
+        },
+        recommendation: assembly.decision.recommendation,
+        recommendRestart: assembly.decision.recommendRestart,
+        autoAction: false,
+        trailingAtOrBelow: assembly.decision.trailingAtOrBelow,
+        reason: assembly.decision.reason,
+    };
+    const advice = { ...base, decisionLogLine: '' };
+    return { ...advice, decisionLogLine: renderRestartDecisionLog(advice) };
+}
+//# sourceMappingURL=restart-advisor.js.map

package/dist/restart-advisor.js.map

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