dsh-git-worktree 0.3.2 → 0.6.0

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,2FAA2F;AAC3F,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAA0B;IAEvC;;;OAGG;IACH,YAAY,IAA8B,EAAE,OAAe;QACzD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AA6ED,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAA;AACnF,OAAO,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAA;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAElE,cAAc,uBAAuB,CAAA;AAErC,MAAM,IAAI,GAAG,cAAc,CAAA;AAC3B,sEAAsE;AACtE,0EAA0E;AAC1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;AAEzD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAA;AAEF,SAAS,eAAe,CAAC,MAA6B;IACpD,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAA;IACpE,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,iCAAiC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAExD;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAgC,EAAE;IACpE,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACxC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAA;IACtD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAEzC,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAA;IACvC,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAA;IACnC,MAAM,QAAQ,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAA;IACzF,MAAM,MAAM,GAAG,2BAA2B,CAAC;QACzC,MAAM;QACN,GAAG;QACH,KAAK;QACL,QAAQ;QACR,WAAW,EAAE,gCAAgC,EAAE;QAC/C,oBAAoB,EAAE,QAAQ;QAC9B,gBAAgB,EAAE,UAAU;KAC7B,CAAC,CAAA;IAEF,IAAI,sBAAsB,CAAC,GAAG,EAAE,iCAAiC,CAAC;QAChE,MAAM;QACN,MAAM;QACN,KAAK;QACL,QAAQ;QACR,GAAG;QACH,UAAU,EAAE,iCAAiC,EAAE;KAChD,CAAC,CAAC,CAAA;IAEH,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAC1B,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACpC,4BAA4B,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAEzC,wEAAwE;IACxE,yEAAyE;IACzE,qCAAqC;IACrC,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACnD,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACtC,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAA;QAC7D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,KAAK,MAAM,CAAC,sBAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACnD,OAAO,CAAC,IAAI,CAAC,0DAA0D,EAAE,KAAK,CAAC,CAAA;QACjF,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,iCAAiC,CAAC,CAAA;IACrC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAA;IACxB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;QACpB,gBAAgB,EAAE,CAAA;QAClB,aAAa,CAAC,cAAc,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/ports.d.ts

@@ -44,6 +44,8 @@ export interface SessionCheckoutGitPort {
     retainApplyBase(localRoot: string, checkoutId: string, oid: string): Promise<void>;
     releaseApplyBase(localRoot: string, checkoutId: string): Promise<void>;
     retainInternalArtifact(localRoot: string, checkoutId: string, artifactName: string, oid: string): Promise<void>;
+    /** Read one retained internal ref without modifying refs or object storage. */
+    readInternalArtifact(localRoot: string, checkoutId: string, artifactName: string): Promise<string | null>;
     releaseInternalArtifacts(localRoot: string, checkoutId: string, artifactPrefix?: string): Promise<void>;
     /** Read-only ancestry proof; only accepts host-verified checkout roots and OIDs. */
     isAncestor(root: string, ancestorOid: string, descendantOid: string): Promise<boolean>;
@@ -87,7 +89,7 @@ export interface ManagedCheckoutCreateJournal extends ManagedCheckoutJournalBase
     step: 'creating_worktree';
 }
 export interface ManagedCheckoutMutationJournal extends ManagedCheckoutJournalBase {
-    operation: 'apply' | 'preview' | 'rollback_preview' | 'finish' | 'finalize_preview' | 'cleanup';
+    operation: 'apply' | 'preview' | 'checkpoint' | 'rollback_preview' | 'finish' | 'finalize_preview' | 'cleanup';
     step: 'planning' | 'artifacts_retained' | 'writing_local' | 'updating_ref' | 'replacing_index' | 'removing_worktree';
     baseOid?: string;
     planRevision?: string;
@@ -100,7 +102,15 @@ export interface ManagedCheckoutMutationJournal extends ManagedCheckoutJournalBa
     localHeadOid?: string;
     isolatedHeadOid?: string;
     commitOid?: string;
+    checkpointId?: string;
+    checkpointSequence?: number;
+    checkpointRequestId?: string;
+    checkpointRequestedRevision?: number;
+    checkpointMessage?: string;
+    checkpointIndexTreeOid?: string;
+    parentOid?: string;
     retention?: WorktreeRetentionMode;
+    recoveryGeneration?: string;
     /** rollback_preview crash recovery must preserve whether the review returns to working or ready_for_review. */
     resumeRevision?: boolean;
     changedFiles?: string[];
@@ -108,6 +118,32 @@ export interface ManagedCheckoutMutationJournal extends ManagedCheckoutJournalBa
     cleanupQuarantinePath?: string;
 }
 export type ManagedCheckoutJournal = ManagedCheckoutCreateJournal | ManagedCheckoutMutationJournal;
+export interface ManagedWorktreeCheckpointRecord {
+    checkpointId: string;
+    sequence: number;
+    reviewId: string;
+    /** Idempotency key for the exact user-confirmed checkpoint request. */
+    requestId?: string;
+    /** Review revision and Host generation accepted for the request. */
+    requestedRevision?: number;
+    generation?: string;
+    iteration: number;
+    createdAt: number;
+    commitOid: string;
+    parentOid: string;
+    summary: string;
+    commitMessage: string;
+    validationStatus: WorktreeValidationStatus;
+    changedFiles: string[];
+}
+/** Bounded context for the next cumulative review; never replaces the final diff as fact source. */
+export interface ManagedWorktreePreviousReviewRecord {
+    reviewId: string;
+    iteration: number;
+    summary: string;
+    suggestedCommitMessage: string;
+    changedFiles: string[];
+}
 export interface ManagedWorktreeReviewRecord {
     reviewId: string;
     iteration: number;
@@ -147,7 +183,43 @@ export interface ManagedDeliveryProof {
     localHeadBefore: string;
     localHeadAfter: string;
     changedFiles: string[];
+    /** Optional for backward compatibility with historical version-2 registries. */
+    validationStatus?: WorktreeValidationStatus;
+    validationSummary?: string;
+}
+export interface ManagedApplyConflictRecoveryContinuation {
+    kind: 'worktree_apply_conflict';
+    requestId: string;
+    reviewId: string;
+    readyRevision: number;
+    workingRevision: number;
+    localHeadOid: string;
+    conflictingFiles: string[];
+}
+export interface ManagedReviewRegenerationContinuation {
+    kind: 'worktree_review_regeneration';
+    requestId: string;
+    reviewId: string;
+    revision: number;
+}
+export interface ManagedPreviewRecoveryAnalysisContinuation {
+    kind: 'worktree_preview_recovery_analysis';
+    requestId: string;
+    reviewId: string;
+    previewId: string;
+    revision: number;
+    generation: string;
+}
+export interface ManagedPreviewRecoveryHandoffContinuation {
+    kind: 'worktree_preview_recovery_handoff';
+    requestId: string;
+    sourceCheckoutId: string;
+    reviewId: string;
+    previewId: string;
+    sourceRevision: number;
+    generation: string;
 }
+export type ManagedRecoveryContinuation = ManagedApplyConflictRecoveryContinuation | ManagedReviewRegenerationContinuation | ManagedPreviewRecoveryAnalysisContinuation | ManagedPreviewRecoveryHandoffContinuation;
 export type ManagedCheckoutDelivery = {
     state: 'working';
     iteration: number;
@@ -214,6 +286,12 @@ export interface ManagedCheckoutRecord {
     baseOid: string;
     /** Last successfully applied isolated snapshot; does not change the user-visible Session Base. */
     applyBaseOid?: string;
+    /** Bounded cumulative-review context retained after a review is invalidated. */
+    previousReview?: ManagedWorktreePreviousReviewRecord;
+    /** Linear saved stages that remain private to the managed Worktree. */
+    checkpoints?: ManagedWorktreeCheckpointRecord[];
+    /** Host-authoritative one-shot context for an explicitly resumed apply conflict. */
+    recoveryContinuation?: ManagedRecoveryContinuation;
     sourceRef: string;
     phase: SessionCheckoutPhase;
     delivery: ManagedCheckoutDelivery;

package/lib/session-checkout-apply.d.ts

@@ -95,6 +95,60 @@ export interface RollbackSuccessResult {
     changedFiles: string[];
 }
 export type RollbackResult = RollbackSuccessResult | ApplyErrorResult;
+export interface CheckpointInput {
+    isolatedPath: string;
+    expectedFingerprint: string;
+    expectedHeadOid: string;
+    commitMessage: string;
+    /** Persist the prepared commit and Host journal before detached HEAD/index mutation. */
+    beforeCommit?(prepared: {
+        commitOid: string;
+        parentOid: string;
+        indexTreeOid: string;
+        changedFiles: string[];
+    }): Promise<void>;
+}
+export interface CheckpointSuccessResult {
+    status: 'checkpointed';
+    commitOid: string;
+    parentOid: string;
+    changedFiles: string[];
+    isolatedFingerprint: string;
+}
+export type CheckpointResult = CheckpointSuccessResult | ApplyErrorResult;
+export interface CheckpointRecoverySuccessResult {
+    status: 'checkpoint_recovered' | 'checkpoint_aborted';
+    isolatedFingerprint: string;
+}
+export type CheckpointRecoveryResult = CheckpointRecoverySuccessResult | ApplyErrorResult;
+export type PreviewRecoveryActionBlockCode = 'stale_local' | 'preview_modified' | 'commit_isolation_conflict' | 'operation_not_allowed';
+export interface PreviewRecoveryBlockedAction {
+    status: 'blocked';
+    code: PreviewRecoveryActionBlockCode;
+    message: string;
+    conflictingFiles?: string[];
+}
+export interface PreviewRecoverySafeRollback {
+    status: 'safe';
+    targetTreeOid: string;
+}
+export interface PreviewRecoverySafeFinalize {
+    status: 'safe';
+    taskTreeOid: string;
+    finalIndexTreeOid: string;
+    expectedWorkingTreeOid: string;
+    commitRequired: boolean;
+}
+export interface PreviewRecoveryAssessment {
+    localFingerprint: string;
+    localHeadOid: string;
+    localHeadRef: string | null;
+    localHeadTreeOid: string;
+    localIndexTreeOid: string;
+    localWorkingTreeOid: string;
+    rollback: PreviewRecoverySafeRollback | PreviewRecoveryBlockedAction;
+    finalize: PreviewRecoverySafeFinalize | PreviewRecoveryBlockedAction;
+}
 export interface InvalidInputApplyError {
     code: 'invalid_input';
     message: string;
@@ -114,6 +168,8 @@ export interface StaleIsolatedApplyError {
 export interface GitApplyError {
     code: 'git_error';
     message: string;
+    /** Host may clear only a planning journal when the engine proved Local was restored exactly. */
+    recoveryState?: 'unchanged' | 'uncertain';
 }
 export interface CommitIsolationApplyError {
     code: 'commit_isolation_conflict';
@@ -130,6 +186,13 @@ export interface PreviewModifiedApplyError {
 export type ApplyError = InvalidInputApplyError | InvalidPlanApplyError | StaleLocalApplyError | StaleIsolatedApplyError | GitApplyError | CommitIsolationApplyError | OperationNotAllowedApplyError | PreviewModifiedApplyError;
 export interface SessionCheckoutApplyEngine {
     inspectReview(input: ApplyPlanInput): Promise<InspectReviewResult>;
+    checkpoint(input: CheckpointInput): Promise<CheckpointResult>;
+    recoverCheckpoint(input: {
+        isolatedPath: string;
+        commitOid: string;
+        parentOid: string;
+        expectedIndexTreeOid: string;
+    }): Promise<CheckpointRecoveryResult>;
     /** 复用真实 Apply merge 计算，但不持久化可执行 plan，也不修改任一 checkout。 */
     preflight(input: ApplyPlanInput): Promise<ApplyPlanResult>;
     plan(input: ApplyPlanInput): Promise<ApplyPlanResult>;
@@ -144,9 +207,16 @@ export interface SessionCheckoutApplyEngine {
         /** Local 写入前持久化 receipt artifacts/journal；失败时不得触碰 Local。 */
         beforeWrite?(receipt: PreviewReceipt): Promise<void>;
     }): Promise<PreviewResult>;
+    /** Strictly read-only detached Preview recovery assessment; it persists no executable plan. */
+    assessPreviewRecovery(input: {
+        localPath: string;
+        receipt: PreviewReceipt;
+    }): Promise<PreviewRecoveryAssessment | ApplyErrorResult>;
     rollback(input: {
         localPath: string;
         receipt: PreviewReceipt;
+        /** Persists the mutation journal before the final Local CAS; no Local write may happen before it resolves. */
+        beforeWrite?(): Promise<void>;
     }): Promise<RollbackResult>;
     finalize(input: {
         localPath: string;
@@ -159,5 +229,11 @@ export interface SessionCheckoutApplyEngine {
 export interface SessionCheckoutApplyEngineOptions {
     /** 测试/宿主 seam：在最后一次 Local fingerprint 校验前执行。 */
     beforeFinalLocalValidation?(): Promise<void> | void;
+    /** 测试/宿主 seam：在 Local 写入完成、独立写后验证开始前执行。 */
+    afterLocalWriteBeforeVerification?(): Promise<void> | void;
+    /** Test seam immediately before the authoritative managed-Worktree checkpoint CAS. */
+    beforeFinalIsolatedValidation?(): Promise<void> | void;
+    /** Test seam after checkpoint HEAD/index writes and before independent verification. */
+    afterIsolatedWriteBeforeVerification?(): Promise<void> | void;
 }
 export declare function createSessionCheckoutApplyEngine(options?: SessionCheckoutApplyEngineOptions): SessionCheckoutApplyEngine;