nawabari 0.8.0 → 0.9.2

package/dist/session-registry.d.ts

@@ -8,7 +8,7 @@ import { type SessionLifecycleAction } from "./session-lifecycle-actions.js";
 export type { ResourceClaim, ResourceClaimRecoveryAction } from "./resource-claims.js";
 export { primarySessionLifecycleAction, primarySessionLifecycleNextAction, projectSessionLifecycleActions, projectSessionLifecycleNextActions, SESSION_LIFECYCLE_ACTION_SCHEMA_VERSION, } from "./session-lifecycle-actions.js";
 export type { SessionLifecycleAction, SessionLifecycleActionId, SessionLifecycleNextAction, SessionLifecycleNextActionId, } from "./session-lifecycle-actions.js";
-export { classifySessionLifecycle, lifecycleTransition, SESSION_LIFECYCLE_CLASSIFICATION_SCHEMA_VERSION, SESSION_LIFECYCLE_STATES, SESSION_LIFECYCLE_TRANSITION_TABLE, } from "./session-lifecycle-classification.js";
+export { availableLifecycleOperations, classifySessionLifecycle, lifecycleTransition, SESSION_LIFECYCLE_CLASSIFICATION_SCHEMA_VERSION, SESSION_LIFECYCLE_STATES, SESSION_LIFECYCLE_TRANSITION_TABLE, } from "./session-lifecycle-classification.js";
 export type { SessionLifecycleBlocker, SessionLifecycleClassification, SessionLifecycleCloseReadiness, SessionLifecycleOperation, SessionLifecycleObservation, SessionLifecyclePhase, SessionLifecycleState, SessionLifecycleTransition, } from "./session-lifecycle-classification.js";
 export type { RepositoryDiffEvidence, RepositoryDiffDiagnostic, RepositoryDiffOptions, RepositoryEvidenceBounds, RepositoryEvidenceOptions, RepositoryEvidencePaths, RepositoryEvidenceSnapshot, } from "./repository-evidence.js";
 export { DIFF_EVIDENCE_SCHEMA_VERSION, EVIDENCE_MAX_DIFF_BYTES, EVIDENCE_MAX_DIFF_HUNKS, EVIDENCE_MAX_DIFF_PATHS, REPOSITORY_EVIDENCE_SCHEMA_VERSION, } from "./repository-evidence.js";
@@ -22,6 +22,7 @@ export declare const CLEANUP_DECISION_SCHEMA_VERSION: 1;
 export declare const RECONCILIATION_SCHEMA_VERSION: 1;
 export declare const SESSION_DIAGNOSTIC_SCHEMA_VERSION: 1;
 export declare const DISCARD_RESULT_SCHEMA_VERSION: 1;
+export declare const DISCARD_PREVIEW_SCHEMA_VERSION: 1;
 /** Bounds a caller-declared commit-message pattern before it is compiled. */
 export declare const MAX_MESSAGE_PATTERN_LENGTH: 512;
 export type RegistrySchemaVersion = typeof REGISTRY_SCHEMA_VERSION;
@@ -95,6 +96,55 @@ export interface DiscardSessionResult {
     /** Present when this result completed a previously interrupted cleanup. */
     readonly reconciliation?: CleanupReconciliation;
 }
+export interface DiscardPreviewEvidence {
+    readonly code: RegistryErrorCode;
+    readonly message: string;
+    readonly details: RegistryErrorDetails;
+}
+/** Bounded, read-only destruction evidence projected by `session discard --preview`. */
+export interface DiscardPreview {
+    readonly schemaVersion: typeof DISCARD_PREVIEW_SCHEMA_VERSION;
+    readonly operation: "discard-preview";
+    readonly destructive: true;
+    readonly warning: string;
+    readonly session: SessionRecord;
+    readonly currentState: SessionState;
+    readonly persistedState: SessionState;
+    readonly physicalState: string;
+    readonly worktreePresent: boolean;
+    readonly branchPresent: boolean;
+    readonly worktreeHead: string | null;
+    readonly branchHead: string | null;
+    readonly head: string | null;
+    readonly expectedHead: string | null;
+    readonly recoverableCommits: {
+        readonly observable: boolean;
+        readonly present: boolean | null;
+        readonly evidence: readonly DiscardPreviewEvidence[];
+    };
+    readonly uncommittedWork: {
+        readonly observable: boolean;
+        readonly present: boolean | null;
+        readonly evidence: readonly DiscardPreviewEvidence[];
+    };
+    readonly claims: readonly ResourceClaim[];
+    readonly claimCount: number;
+    readonly claimsTruncated: boolean;
+    readonly destructiveScope: {
+        readonly worktree: boolean;
+        readonly branch: boolean;
+        readonly unintegratedCommits: boolean | null;
+        readonly uncommittedWork: boolean | null;
+        readonly claims: number;
+    };
+    readonly diagnostic: {
+        readonly closeReadiness: ReadinessState;
+        readonly cleanupReadiness: ReadinessState;
+        readonly resultState: DiagnosticCompleteness;
+        readonly blockers: readonly DiscardPreviewEvidence[];
+        readonly lifecycleState?: string;
+    };
+}
 export type CleanupReconciliationOutcome = "completed" | "retryable" | "unresolved";
 /** Bounded, identity-bound evidence for a destructive lifecycle retry. */
 export interface CleanupReconciliation {
@@ -178,6 +228,10 @@ export interface GarbageCollectCandidate extends SessionRecord {
     readonly suspicionReason: GarbageCollectSuspicionReason;
     readonly destructiveEligibility: GarbageCollectEligibility;
     readonly destructiveEligibilityReason: GarbageCollectEligibilityReason;
+    /** Canonical read-only lifecycle projection for this GC observation. */
+    readonly lifecycle?: SessionLifecycleClassification;
+    /** Typed caller actions projected from the same lifecycle snapshot. */
+    readonly nextActions?: readonly SessionLifecycleAction[];
 }
 export interface GarbageCollectBlocked {
     readonly sessionId: string;
@@ -411,6 +465,9 @@ export interface CommitOptions {
     readonly message: string;
     /** Concrete repository-relative paths. Globs are never accepted here. */
     readonly resources?: readonly string[];
+    /** Explicitly resolve the authoritative session claim set to concrete resources. */
+    readonly allClaimed?: boolean;
+    readonly all_claimed?: boolean;
     /** Alias for callers that name the same explicit paths as paths. */
     readonly paths?: readonly string[];
     /**
@@ -464,6 +521,9 @@ export interface PushOptions {
     readonly session_id?: string | null;
     /** Explicit claim-covered resources; push never infers these from the registry. */
     readonly resources?: readonly string[];
+    /** Explicitly resolve the authoritative session claim set to concrete resources. */
+    readonly allClaimed?: boolean;
+    readonly all_claimed?: boolean;
     readonly remote?: string | null;
     readonly branch?: string | null;
     readonly remoteBranch?: string | null;
@@ -672,6 +732,12 @@ export declare class SessionRegistry {
     /** Push the currently owned branch to an explicit remote/branch target. */
     push(options: PushOptions): PushResult;
     pushSession(options: PushOptions): PushResult;
+    /**
+     * Resolve the opt-in all-claimed selector while the mutation lock is held.
+     * Claims remain the authority, but only concrete Git/repository evidence is
+     * ever handed to the existing concrete authorization path.
+     */
+    private resolveAllClaimedResourcesUnsafe;
     private requireMutationAuthorization;
     /** Capture bounded Git evidence for the current owned session's declaration. */
     checkpoint(options?: CheckpointOptions): CheckpointEvidence;
@@ -729,9 +795,25 @@ export declare class SessionRegistry {
     /** Explicitly discard exactly one selected session; never resolves the current owner implicitly. */
     discard(sessionIdOrOptions: string | DiscardSessionOptions): DiscardSessionResult;
     discardSession(sessionIdOrOptions: string | DiscardSessionOptions): DiscardSessionResult;
+    /**
+     * Produce a bounded, side-effect-free summary of the same session/Git/claim
+     * authorities that an explicit discard observes. The preview never invokes
+     * the cleanup actor or writes registry, worktree, branch, or claim state.
+     */
+    previewDiscard(sessionIdOrOptions: string | DiscardSessionOptions): DiscardPreview;
     /** Detect stale sessions, optionally applying only cleanup that passes close preflight. */
     garbageCollect(options?: GarbageCollectOptions): GarbageCollectResult;
     gc(options?: GarbageCollectOptions): GarbageCollectResult;
+    /**
+     * Run one destructive lifecycle request through the Session actor.  The
+     * actor owns sequencing and admissibility; this class remains the adapter
+     * for authoritative Git/filesystem/registry observations and effects.
+     */
+    private coordinateCleanupUnsafe;
+    /** Build an actor input from one authoritative registry/physical diagnostic. */
+    private lifecycleActorInputUnsafe;
+    /** Preserve existing blocker/error contracts when the actor rejects a request. */
+    private lifecycleActorRejection;
     private resolveOwnerSession;
     private observeCleanupReconciliation;
     private cleanupFailure;