@ornexus/neocortex 4.60.61 → 4.60.62

package/packages/client/dist/git/legacy-story-pr.d.ts

@@ -1,4 +1,5 @@
 import { type C12RemoteObservation, type C12RemoteReasonCode } from '../../../shared/dist/merge-readiness/c12-remote-observation.js';
+import type { ScopedCiFollowUpDebt } from '../../../shared/dist/types/scoped-ci-policy.js';
 type Result<T> = {
     readonly ok: true;
     readonly value: T;
@@ -264,6 +265,24 @@ export interface LegacyStoryC11CheckpointReceipt {
     readonly checkpointAccepted: true;
     readonly localOnly: true;
 }
+/** Read-only categorical PR observation for the root C11 report. No raw check
+ * name, URL or provider text is returned, and C12 must reobserve independently. */
+export declare function observeLegacyStoryPrReviewC11(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+}): Promise<Result<{
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c11-remote-observation';
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly observation: C12RemoteObservation;
+    readonly checkpointAccepted: false;
+    readonly mergeAuthorized: false;
+    readonly publicSafe: true;
+}>>;
 export declare function planLegacyStoryPrReview(options: {
     readonly projectRoot: string;
     readonly storyId: string;
@@ -280,6 +299,7 @@ export declare function acceptLegacyStoryPrReviewC11(options: {
     readonly reportFile: string;
     readonly authorize: boolean;
     readonly provider?: LegacyStoryPrProvider;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
     /** Synthetic seam; the productive CLI always executes the P205 complete gate. */
     readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
     readonly afterStatePersist?: () => Promise<void>;
@@ -335,6 +355,7 @@ export interface LegacyStoryPrPreparedReceipt {
     readonly originalHeadSha: string;
     readonly candidateHeadSha: string;
     readonly qaSha256: string;
+    readonly registryRecorded: boolean;
     readonly reused: boolean;
     readonly physicalMerge: false;
     readonly localOnly: true;
@@ -348,6 +369,9 @@ export declare function prepareLegacyStoryPrMergeC12(options: {
     readonly prNumber: number;
     readonly authorize: boolean;
     readonly provider?: LegacyStoryPrProvider;
+    /** Explicit root choice to commit closed remote-CI debt with the reviewed candidate. */
+    readonly recordRemoteDebt?: boolean;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
     /** Synthetic seam; the productive CLI always executes the P205 complete gate. */
     readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
     readonly afterCommit?: () => Promise<void>;
@@ -370,9 +394,7 @@ export interface LegacyStoryPrMergedReceipt {
     readonly checkpointAccepted: false;
     readonly localOnly: true;
 }
-/** Narrow root review gate until the scoped-CI debt adapter is integrated.
- * Non-blocking remote findings cannot be silently omitted or treated as green. */
-export interface LegacyStoryPrRootMergeDecision {
+interface C12RootMergeDecisionBase {
     readonly schemaVersion: 1;
     readonly kind: 'legacy-story-c12-root-merge-decision';
     readonly storyId: string;
@@ -384,9 +406,26 @@ export interface LegacyStoryPrRootMergeDecision {
     readonly remoteObservationDigest: string;
     readonly canMerge: true;
     readonly blockingChecks: readonly [];
+}
+/** A clean categorical rollup does not attest that all remote checks exist. */
+export interface LegacyStoryPrCleanMergeDecision extends C12RootMergeDecisionBase {
     readonly nonBlockingChecks: readonly [];
     readonly followUpDebt: readonly [];
 }
+export interface LegacyStoryPrRecordedDebtMergeDecision extends C12RootMergeDecisionBase {
+    readonly nonBlockingChecks: readonly {
+        readonly checkName: C12RemoteReasonCode;
+        readonly bucket: 'nonBlockingChecks';
+        readonly reason: ScopedCiFollowUpDebt['reason'];
+        readonly origin: 'remote_ci_cd';
+        readonly safeToContinueYoloop: true;
+    }[];
+    readonly followUpDebt: readonly ScopedCiFollowUpDebt[];
+    readonly registrySha256: string;
+    readonly registryItemIds: readonly string[];
+    readonly publicSafe: true;
+}
+export type LegacyStoryPrRootMergeDecision = LegacyStoryPrCleanMergeDecision | LegacyStoryPrRecordedDebtMergeDecision;
 export interface LegacyStoryPrRemoteDebtPlan {
     readonly schemaVersion: 1;
     readonly kind: 'legacy-story-c12-remote-debt-required';
@@ -402,6 +441,36 @@ export interface LegacyStoryPrRemoteDebtPlan {
     readonly canMerge: false;
     readonly publicSafe: true;
 }
+export interface LegacyStoryPrPrePrepareDebtPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-pre-prepare-debt-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly prNumber: number;
+    readonly originalHeadSha: string;
+    readonly baseSha: string;
+    readonly remoteObservationDigest: string;
+    readonly reasonCodes: readonly C12RemoteReasonCode[];
+    readonly followUpDebt: readonly ScopedCiFollowUpDebt[];
+    readonly registryExists: boolean;
+    readonly registryBeforeSha256: string;
+    readonly registryProjectedItemIds: readonly string[];
+    readonly registryProjectedAdded: number;
+    readonly registryProjectedExisting: number;
+    readonly registryMutationAuthorized: false;
+    readonly canMerge: false;
+    readonly publicSafe: true;
+}
+/** Read-only C12 observation before the reviewed metadata is committed. This
+ * gives the root the canonical debt input at the only point where a future
+ * tracked-registry write can join the reviewed PR candidate commit. */
+export declare function planLegacyStoryPrRemoteDebtBeforePrepareC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+}): Promise<Result<LegacyStoryPrPrePrepareDebtPlan>>;
 export interface LegacyStoryPrRemoteDebtReceipt {
     readonly schemaVersion: 1;
     readonly kind: 'legacy-story-c12-remote-debt-journaled';
@@ -412,15 +481,16 @@ export interface LegacyStoryPrRemoteDebtReceipt {
     readonly remoteObservationDigest: string;
     readonly reasonCodes: readonly C12RemoteReasonCode[];
     readonly reasonCounts: C12RemoteObservation['reasonCounts'];
+    readonly followUpDebt: readonly ScopedCiFollowUpDebt[];
     readonly reused: boolean;
     readonly durableObservation: true;
     readonly registryRecorded: false;
     readonly canMerge: false;
     readonly publicSafe: true;
 }
-/** Root-only readback of the prepared PR candidate. This produces a closed
- * decision only for a categorized clean rollup, otherwise a non-authorizing
- * debt plan. It neither persists debt, runs QA nor merges. */
+/** Root-only readback of the prepared PR candidate. Remote-only findings may
+ * authorize an attempt only when the exact categorical debt is already in
+ * the reviewed candidate registry; this does not guarantee provider merge. */
 export declare function planLegacyStoryPrMergeDecisionC12(options: {
     readonly projectRoot: string;
     readonly storyId: string;
@@ -511,4 +581,65 @@ export declare function acceptLegacyStoryPrPostMergeC12(options: {
     readonly afterCommit?: () => Promise<void>;
     readonly afterPush?: () => Promise<void>;
 }): Promise<Result<LegacyStoryPrPostMergeReceipt>>;
+export interface LegacyEpicTerminalPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-epic-terminal-plan';
+    readonly epicId: string;
+    readonly repositorySha256: string;
+    readonly baseBranchSha256: string;
+    readonly baseHeadSha: string;
+    readonly storyCount: number;
+    readonly storyEvidenceSha256: string;
+    readonly physicalStoriesVerified: true;
+    readonly quotaReleaseAuthorized: false;
+    readonly checkpointAccepted: false;
+    readonly localOnly: true;
+    readonly publicSafe: true;
+}
+/** Read-only, root-owned precursor for legacy epic accounting. It proves all
+ * accepted C12 checkpoints at the exact pushed base HEAD but never frees quota
+ * or declares the server workflow complete. A later accounting transaction must
+ * independently revalidate this basis at its own effect boundary. */
+export declare function planLegacyEpicFinalization(options: {
+    readonly projectRoot: string;
+    readonly epicId: string;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+    readonly issueProvider?: LegacyStoryIssueProvider;
+}): Promise<Result<LegacyEpicTerminalPlan>>;
+export interface LegacyEpicTerminalAcceptance {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-epic-terminal-root-accepted';
+    readonly epicId: string;
+    readonly baseHeadSha: string;
+    readonly storyCount: number;
+    readonly planSha256: string;
+    readonly qaEvidenceDigest: string;
+    readonly reused: boolean;
+    readonly rootAcceptanceRecorded: true;
+    readonly quotaReleaseAuthorized: false;
+    readonly serverAccountingAccepted: false;
+    readonly localOnly: true;
+    readonly publicSafe: true;
+}
+/** Rechecks the physical C12 chain before projecting a private root QA record.
+ * This is local evidence only; the server must independently bind a future
+ * quota transaction to fresh physical truth at its own effect boundary. */
+export declare function readLegacyEpicTerminalAcceptance(options: {
+    readonly projectRoot: string;
+    readonly epicId: string;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+    readonly issueProvider?: LegacyStoryIssueProvider;
+}): Promise<Result<LegacyEpicTerminalAcceptance>>;
+/** Explicit root acceptance runs fresh P205 on the exact pushed terminal HEAD
+ * and persists only a private digest-bound local record. No server accounting
+ * or quota effect is implied by this function or its public projection. */
+export declare function acceptLegacyEpicFinalization(options: {
+    readonly projectRoot: string;
+    readonly epicId: string;
+    readonly authorize: boolean;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+    readonly issueProvider?: LegacyStoryIssueProvider;
+    /** Focused-test seam only; the production CLI always executes physical P205. */
+    readonly verifyQa?: (plan: LegacyEpicTerminalPlan) => Promise<string>;
+}): Promise<Result<LegacyEpicTerminalAcceptance>>;
 export {};