openplanr 1.25.2 → 2.0.0

package/dist/services/operate/engine.d.ts

@@ -1,151 +0,0 @@
-import { type AdvisorAdapter, type AdvisorDispatchResult } from './advisors.js';
-import { type CitationResolutionContext } from './citation-resolution.js';
-import { type ChairBoardContext, type ChairRoleContribution } from './decision-brief.js';
-import { type AdvisorGovernedGap, type AdvisorRoleSnapshot } from './lifecycle-driver.js';
-import { type OperatingCycleManifest, type OperatingDataGap, type OperatingDecision, type OperatingEvidence, type OperatingEvidenceReadiness, type OperatingFinding, type OperatingProviderManifest, type OperatingRoleId, type OperatingRoleResult, type OperatingRoutePlan, type OperatingState } from './types.js';
-export interface RunOperatingCycleInput {
-    projectRoot: string;
-    cycleId?: string;
-    focus?: OperatingCycleManifest['focus'];
-    depth?: OperatingCycleManifest['depth'];
-    runtime?: string;
-    offline?: boolean;
-    reviewOnly?: boolean;
-    preview?: boolean;
-    dryRun?: boolean;
-    confirmed?: boolean;
-    quiet?: boolean;
-    localRoot?: string;
-    now?: Date;
-    adapter?: AdvisorAdapter;
-    /** Stop after preparing a cycle when a certified runtime executes mandates. */
-    deferAdvisors?: boolean;
-    /**
-     * FR2/FR3 (SPEC-005 T-015): deterministic test hooks for the advisor lifecycle
-     * driver that drives the non-chair fan-out. Injecting `now`/`setTimer`/
-     * `clearTimer` makes the automatic lease heartbeat provable under a virtual
-     * clock, and `roleTimeoutMs`/`retryBudget` size the driver's per-attempt timeout
-     * and bounded retry budget. Absent in production, where the driver uses real
-     * timers, no per-attempt timeout, and no extra retry beyond the dispatch path's
-     * own attempt loop — so the live path is byte-identical to the pre-driver
-     * fan-out for a healthy board.
-     */
-    advisorLifecycle?: {
-        now?: () => number;
-        setTimer?: (fn: () => void, ms: number) => unknown;
-        clearTimer?: (handle: unknown) => void;
-        roleTimeoutMs?: number;
-        retryBudget?: number;
-        heartbeatIntervalMs?: number;
-        heartbeatLeadMs?: number;
-        leaseWindowMs?: number;
-    };
-}
-export interface NativeAdvisorHandoff {
-    phase: 'advisors' | 'chair';
-    cycleId: string;
-    evidenceDigest: `sha256:${string}`;
-    roles: string[];
-}
-export interface RunOperatingCycleResult {
-    preview: boolean;
-    dryRun: boolean;
-    cycle: OperatingCycleManifest;
-    evidence?: OperatingEvidence;
-    readiness?: OperatingEvidenceReadiness;
-    roleResults?: OperatingRoleResult[];
-    findings?: OperatingFinding[];
-    decisions?: OperatingDecision[];
-    gaps?: OperatingDataGap[];
-    routes?: OperatingRoutePlan[];
-    provider?: OperatingProviderManifest | null;
-    state?: OperatingState;
-    modelCalls: number;
-    warnings: string[];
-    nativeHandoff?: NativeAdvisorHandoff;
-    /** Per-role isolation provenance from this run's mandate dispatch. */
-    dispatchProvenance?: AdvisorDispatchResult['provenance'];
-    /**
-     * FR3 (SPEC-005 T-015): the advisor lifecycle driver's observable summary over
-     * the non-chair fan-out — the per-role snapshot, governed gaps for lenses that
-     * terminated without a recorded analysis, Chair-readiness, and the count of
-     * automatic lease heartbeats the driver issued. Present whenever the driver
-     * drove a live inline fan-out (absent on preview/dry-run/native-handoff returns).
-     */
-    advisorLifecycle?: {
-        snapshot: AdvisorRoleSnapshot[];
-        gaps: AdvisorGovernedGap[];
-        chairReady: boolean;
-        heartbeats: number;
-        recorded: OperatingRoleId[];
-        notEvaluated: OperatingRoleId[];
-    };
-    /**
-     * FR13 (SPEC-005 T-015): the Chair's grounded input as assembled from the
-     * partial, honestly-labelled non-chair board by `assembleChairBoardInput` —
-     * the grounded evidence (recorded proposals only, absent lenses contributing
-     * zero proposal items), the six-way per-role ledger, and the named-gap lines
-     * fed into the Chair mandate so a missing perspective is surfaced as a gap the
-     * Chair must not synthesize around.
-     */
-    chairBoard?: ChairBoardInput;
-}
-/**
- * The Chair's grounded input assembled from the board (FR13). Each recorded role
- * contributes its real analysis as synthetic advisor-result evidence, labelled
- * with its six-way outcome. Citation-rejected proposals are EXCLUDED from the
- * grounded input (never silently dropped — they are named in the gap list), so a
- * proposal Chair could not have grounded can never reach its synthesis. Roles
- * with no valid analysis (not-evaluated, failed, still-running, all-rejected)
- * contribute no proposal item: their absence is surfaced as a gap, never as a
- * fabricated conclusion.
- */
-export declare function buildChairEvidence(evidence: OperatingEvidence, results: OperatingRoleResult[], now: string, context?: ChairBoardContext): OperatingEvidence;
-/** The Chair's complete input over a partial, honestly-labelled board (FR13). */
-export interface ChairBoardInput {
-    /** Grounded evidence Chair may cite — recorded proposals only, citation-rejected ones excluded. */
-    evidence: OperatingEvidence;
-    /** The six-way per-role ledger, distinguishing recorded/quiet/not-evaluated/failed/running/rejected. */
-    contributions: ChairRoleContribution[];
-    /** Named-gap lines for every absent, failed, still-running, or rejected perspective — never a conclusion. */
-    gaps: string[];
-}
-/**
- * Assemble the Chair's input from a possibly-partial board (FR13). This is the
- * single entry point that ties the grounded evidence to the honest per-role
- * ledger and the named-gap list: one missing perspective can never destroy an
- * otherwise-useful board, and the Chair is handed a structural record of what did
- * NOT evaluate rather than a silent absence it might synthesize around.
- */
-export declare function assembleChairBoardInput(evidence: OperatingEvidence, results: OperatingRoleResult[], now: string, context?: ChairBoardContext): ChairBoardInput;
-/**
- * FR2 universal citation gate — the PRIMARY, unconditional mechanism, run on
- * every dispatch path and every evidence source (no `bearing.length === 0`
- * bypass remains, so it is entered even for a citation-free result).
- *
- * Every recorded proposal that carries citations is resolved against the cycle's
- * pinned revision through `enforceRecordedProposalCitations`. A proposal with ANY
- * unresolvable citation is DROPPED — it never reaches `consolidateOperatingResults`
- * — and exactly one `unresolvable-citation` gap is opened in its place. A proposal
- * whose citations all resolve keeps its minted evidence IDs.
- *
- * On top of that per-proposal gate, the FR2 role-level rule: a role result whose
- * proposals carried citations but whose accepted citations resolve to ZERO
- * evidence IDs is `not_evaluated` — every one of its proposals is dropped, its id
- * is returned in `notEvaluatedRoleIds`, and one governed `missing-evidence` gap
- * naming the role and its empty grounding is opened. This replaces SPEC-003's
- * mission-only, repository-only starvation gate with one rule that holds whatever
- * the dispatch path or evidence source. A v1.2 pack result (evidenceRefs, no
- * citations) carries no citation-bearing proposal, so it is never demoted — the
- * pack path stays functional until T-003 removes it.
- */
-export declare function gateRecordedProposalCitations(input: {
-    roleResults: OperatingRoleResult[];
-    context: CitationResolutionContext;
-}): Promise<{
-    roleResults: OperatingRoleResult[];
-    gaps: OperatingDataGap[];
-    notEvaluatedRoleIds: string[];
-}>;
-export declare function runOperatingCycle(input: RunOperatingCycleInput): Promise<RunOperatingCycleResult>;
-//# sourceMappingURL=engine.d.ts.map

package/dist/services/operate/engine.d.ts.map

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