dsh-git-worktree 0.1.2 → 0.3.0

package/lib/console-remote/descriptors.js

@@ -0,0 +1,105 @@
+import { booleanSchema, checkoutIdSchema, commitMessageSchema, createResponseSchema, currentResponseSchema, inspectResponseSchema, listResponseSchema, mutationResponseSchema, optionalBooleanSchema, outcomeSchema, preflightResponseSchema, retainedModeSchema, retentionSchema, reviewDiffResponseSchema, reviewIdSchema, revisionSchema, sessionIdSchema, } from './schemas.js';
+const PACKAGE = 'dsh-git-worktree';
+const SERVICE = 'gitWorktree';
+const AGENT_WIRE_TYPE = '@deepseek-ai/dsh-session/types#SessionId';
+const agentParameter = {
+    name: 'agent',
+    wire: 'agentId',
+    source: 'lookup',
+    lookup: 'agent',
+    codec: { mode: 'strict', typeSymbol: AGENT_WIRE_TYPE, schema: sessionIdSchema },
+};
+function json(name, schema, typeSymbol, acceptsUndefined = false) {
+    return {
+        name,
+        wire: name,
+        source: 'json',
+        ...(acceptsUndefined ? { acceptsUndefined: true } : {}),
+        codec: { mode: 'strict', typeSymbol, schema },
+    };
+}
+function descriptor(method, parameters, resultSchema, resultType) {
+    return {
+        id: `${PACKAGE}#${SERVICE}/${method}`,
+        service: SERVICE,
+        namespace: SERVICE,
+        method,
+        invocation: { kind: 'direct' },
+        parameters: [agentParameter, ...parameters],
+        result: { mode: 'strict', typeSymbol: `${PACKAGE}/console-contract#${resultType}`, schema: resultSchema },
+    };
+}
+export const WORKTREE_CONSOLE_DESCRIPTORS = Object.freeze([
+    descriptor('current', [], outcomeSchema(currentResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleCurrentResponse>'),
+    descriptor('list', [
+        json('needsAttention', optionalBooleanSchema, 'boolean | undefined', true),
+        json('includeDelivered', optionalBooleanSchema, 'boolean | undefined', true),
+    ], outcomeSchema(listResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleListResponse>'),
+    descriptor('create', [], outcomeSchema(createResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleCreateResponse>'),
+    descriptor('inspect', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleInspectRequest.checkoutId`),
+    ], outcomeSchema(inspectResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleInspectResponse>'),
+    descriptor('reviewDiff', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleReviewDiffRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleReviewDiffRequest.expectedRevision`),
+        json('expectedReviewId', reviewIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleReviewDiffRequest.expectedReviewId`),
+    ], outcomeSchema(reviewDiffResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleReviewDiffResponse>'),
+    descriptor('preflight', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsolePreflightRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsolePreflightRequest.expectedRevision`),
+        json('expectedReviewId', reviewIdSchema, `${PACKAGE}/console-contract#WorktreeConsolePreflightRequest.expectedReviewId`),
+    ], outcomeSchema(preflightResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsolePreflightResponse>'),
+    descriptor('preview', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsolePreviewRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsolePreviewRequest.expectedRevision`),
+        json('expectedReviewId', reviewIdSchema, `${PACKAGE}/console-contract#WorktreeConsolePreviewRequest.expectedReviewId`),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('resumeRevision', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleResumeRevisionRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleResumeRevisionRequest.expectedRevision`),
+        json('expectedReviewId', reviewIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleResumeRevisionRequest.expectedReviewId`),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('rollbackPreview', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleRollbackPreviewRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleRollbackPreviewRequest.expectedRevision`),
+        json('resumeRevision', optionalBooleanSchema, `${PACKAGE}/console-contract#WorktreeConsoleRollbackPreviewRequest.resumeRevision`, true),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('discard', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleDiscardRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleDiscardRequest.expectedRevision`),
+        json('confirmDirty', booleanSchema, 'boolean'),
+        json('rollbackPreview', optionalBooleanSchema, `${PACKAGE}/console-contract#WorktreeConsoleDiscardRequest.rollbackPreview`, true),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('finalize', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizeRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizeRequest.expectedRevision`),
+        json('expectedReviewId', reviewIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizeRequest.expectedReviewId`),
+        json('commitMessage', commitMessageSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizeRequest.commitMessage`),
+        json('retention', retentionSchema, `${PACKAGE}/types#WorktreeRetentionMode`),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('finalizePreview', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizePreviewRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizePreviewRequest.expectedRevision`),
+        json('expectedReviewId', reviewIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizePreviewRequest.expectedReviewId`),
+        json('commitMessage', commitMessageSchema, `${PACKAGE}/console-contract#WorktreeConsoleFinalizePreviewRequest.commitMessage`),
+        json('retention', retentionSchema, `${PACKAGE}/types#WorktreeRetentionMode`),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('setRetention', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleSetRetentionRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleSetRetentionRequest.expectedRevision`),
+        json('retention', retainedModeSchema, `${PACKAGE}/console-contract#WorktreeConsoleSetRetentionRequest.retention`),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('retryCleanup', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleRetryCleanupRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleRetryCleanupRequest.expectedRevision`),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+    descriptor('beginNextIteration', [
+        json('checkoutId', checkoutIdSchema, `${PACKAGE}/console-contract#WorktreeConsoleBeginNextIterationRequest.checkoutId`),
+        json('expectedRevision', revisionSchema, `${PACKAGE}/console-contract#WorktreeConsoleBeginNextIterationRequest.expectedRevision`),
+    ], outcomeSchema(mutationResponseSchema), 'WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>'),
+]);
+export const WORKTREE_CONSOLE_REMOTE = Object.freeze({
+    package: PACKAGE,
+    descriptors: WORKTREE_CONSOLE_DESCRIPTORS,
+});
+//# sourceMappingURL=descriptors.js.map

package/lib/console-remote/descriptors.js.map

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

package/lib/console-remote/remote.d.ts

@@ -0,0 +1,29 @@
+import type { RemoteResult, TypertRemoteNamespace } from '@deepseek-ai/dsh-typert-protocol';
+import type { WorktreeConsoleCreateResponse, WorktreeConsoleCurrentResponse, WorktreeConsoleInspectResponse, WorktreeConsoleListResponse, WorktreeConsoleMutationResponse, WorktreeConsoleOutcome, WorktreeConsolePreflightResponse, WorktreeConsoleReviewDiffResponse } from '../console-contract.js';
+import type { WorktreeRetentionMode } from '../types.js';
+import { WORKTREE_CONSOLE_REMOTE } from './descriptors.js';
+export type GitWorktreeRemote = TypertRemoteNamespace<'gitWorktree'>;
+export default WORKTREE_CONSOLE_REMOTE;
+export { WORKTREE_CONSOLE_DESCRIPTORS, WORKTREE_CONSOLE_REMOTE } from './descriptors.js';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteMap {
+        'gitWorktree/current': (agentId: string) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleCurrentResponse>>>;
+        'gitWorktree/list': (agentId: string, needsAttention?: boolean, includeDelivered?: boolean) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleListResponse>>>;
+        'gitWorktree/create': (agentId: string) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleCreateResponse>>>;
+        'gitWorktree/inspect': (agentId: string, checkoutId: string) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleInspectResponse>>>;
+        'gitWorktree/reviewDiff': (agentId: string, checkoutId: string, expectedRevision: number, expectedReviewId: string) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleReviewDiffResponse>>>;
+        'gitWorktree/preflight': (agentId: string, checkoutId: string, expectedRevision: number, expectedReviewId: string) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsolePreflightResponse>>>;
+        'gitWorktree/preview': (agentId: string, checkoutId: string, expectedRevision: number, expectedReviewId: string) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/resumeRevision': (agentId: string, checkoutId: string, expectedRevision: number, expectedReviewId: string) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/rollbackPreview': (agentId: string, checkoutId: string, expectedRevision: number, resumeRevision?: boolean) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/discard': (agentId: string, checkoutId: string, expectedRevision: number, confirmDirty: boolean, rollbackPreview?: boolean) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/finalize': (agentId: string, checkoutId: string, expectedRevision: number, expectedReviewId: string, commitMessage: string, retention: WorktreeRetentionMode) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/finalizePreview': (agentId: string, checkoutId: string, expectedRevision: number, expectedReviewId: string, commitMessage: string, retention: WorktreeRetentionMode) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/setRetention': (agentId: string, checkoutId: string, expectedRevision: number, retention: Exclude<WorktreeRetentionMode, 'cleanup'>) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/retryCleanup': (agentId: string, checkoutId: string, expectedRevision: number) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+        'gitWorktree/beginNextIteration': (agentId: string, checkoutId: string, expectedRevision: number) => Promise<RemoteResult<WorktreeConsoleOutcome<WorktreeConsoleMutationResponse>>>;
+    }
+    interface TypertRemoteNamespaceMap {
+        gitWorktree: TypertRemoteNamespace<'gitWorktree'>;
+    }
+}

package/lib/console-remote/remote.js

@@ -0,0 +1,4 @@
+import { WORKTREE_CONSOLE_REMOTE } from './descriptors.js';
+export default WORKTREE_CONSOLE_REMOTE;
+export { WORKTREE_CONSOLE_DESCRIPTORS, WORKTREE_CONSOLE_REMOTE } from './descriptors.js';
+//# sourceMappingURL=remote.js.map

package/lib/console-remote/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/console-remote/remote.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAI1D,eAAe,uBAAuB,CAAA;AACtC,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA"}

package/lib/console-remote/schemas.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { type WorktreeConsoleCreateResponse, type WorktreeConsoleCurrentResponse, type WorktreeConsoleInspectResponse, type WorktreeConsoleListResponse, type WorktreeConsoleMutationResponse, type WorktreeConsoleOutcome, type WorktreeConsolePreflightResponse, type WorktreeConsoleReviewDiffResponse } from '../console-contract.js';
+export declare const sessionIdSchema: z.ZodString;
+export declare const checkoutIdSchema: z.ZodString;
+export declare const reviewIdSchema: z.ZodString;
+export declare const commitMessageSchema: z.ZodString;
+export declare const revisionSchema: z.ZodNumber;
+export declare const oidSchema: z.ZodUnion<readonly [z.ZodLiteral<"unversioned">, z.ZodString]>;
+export declare const booleanSchema: z.ZodBoolean;
+export declare const optionalBooleanSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodUndefined]>;
+export declare const retentionSchema: z.ZodEnum<{
+    cleanup: "cleanup";
+    retain_24h: "retain_24h";
+    retain_3d: "retain_3d";
+    retain_manual: "retain_manual";
+}>;
+export declare const retainedModeSchema: z.ZodEnum<{
+    retain_24h: "retain_24h";
+    retain_3d: "retain_3d";
+    retain_manual: "retain_manual";
+}>;
+export declare function outcomeSchema<T>(value: z.ZodType<T>): z.ZodType<WorktreeConsoleOutcome<T>>;
+export declare const currentResponseSchema: z.ZodType<WorktreeConsoleCurrentResponse>;
+export declare const createResponseSchema: z.ZodType<WorktreeConsoleCreateResponse>;
+export declare const inspectResponseSchema: z.ZodType<WorktreeConsoleInspectResponse>;
+export declare const listResponseSchema: z.ZodType<WorktreeConsoleListResponse>;
+export declare const mutationResponseSchema: z.ZodType<WorktreeConsoleMutationResponse>;
+export declare const preflightResponseSchema: z.ZodType<WorktreeConsolePreflightResponse>;
+export declare const reviewDiffResponseSchema: z.ZodType<WorktreeConsoleReviewDiffResponse>;

package/lib/console-remote/schemas.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+import { WORKTREE_CONSOLE_ERROR_CODES, WORKTREE_CONSOLE_TARGET_STATES, } from '../console-contract.js';
+const strict = (shape) => z.object(shape).strict();
+export const sessionIdSchema = z.string().min(1);
+export const checkoutIdSchema = z.string().min(1).refine(value => !value.includes('..') && !/[\\/\0]/u.test(value), 'unsafe checkout id');
+export const reviewIdSchema = z.string().min(1);
+export const commitMessageSchema = z.string().trim().min(1).max(500);
+export const revisionSchema = z.number().int().nonnegative();
+export const oidSchema = z.union([
+    z.literal('unversioned'),
+    z.string().regex(/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/iu),
+]);
+export const booleanSchema = z.boolean();
+export const optionalBooleanSchema = z.union([booleanSchema, z.undefined()]);
+export const retentionSchema = z.enum(['cleanup', 'retain_24h', 'retain_3d', 'retain_manual']);
+export const retainedModeSchema = z.enum(['retain_24h', 'retain_3d', 'retain_manual']);
+const projectSchema = strict({ id: z.string().min(1), name: z.string().min(1) });
+const validationItemSchema = strict({
+    command: z.string(),
+    status: z.enum(['passed', 'failed', 'not_run']),
+    summary: z.string().optional(),
+});
+const reviewSchema = strict({
+    reviewId: reviewIdSchema,
+    revision: revisionSchema,
+    iteration: z.number().int().nonnegative(),
+    preparedAt: z.number().finite(),
+    summary: z.string(),
+    validationStatus: z.enum(['passed', 'failed', 'partial', 'not_run']),
+    validationSummary: z.string().optional(),
+    tests: z.array(validationItemSchema),
+    changedFiles: z.array(z.string()),
+    suggestedCommitMessage: z.string().min(1),
+});
+const capabilitiesSchema = strict({
+    create: z.boolean(),
+    open: z.boolean(),
+    inspect: z.boolean(),
+    discard: z.boolean(),
+    preflight: z.boolean(),
+    preview: z.boolean(),
+    resumeRevision: z.boolean(),
+    rollbackPreview: z.boolean(),
+    finalize: z.boolean(),
+    finalizePreview: z.boolean(),
+    setRetention: z.boolean(),
+    retryCleanup: z.boolean(),
+    beginNextIteration: z.boolean(),
+});
+const targetSummarySchema = strict({
+    project: projectSchema,
+    checkoutId: checkoutIdSchema.nullable(),
+    sourceSessionId: sessionIdSchema,
+    ownerSessionId: sessionIdSchema,
+    targetSessionId: sessionIdSchema.nullable(),
+    iteration: z.number().int().nonnegative(),
+    revision: revisionSchema,
+    state: z.enum(WORKTREE_CONSOLE_TARGET_STATES),
+    phase: z.enum(['local', 'preparing', 'ready', 'applying', 'mutating', 'recovery_required', 'finalized', 'retained', 'discarded']),
+    dirty: z.boolean(),
+    currentOid: oidSchema,
+    commitOid: oidSchema.nullable(),
+    retention: retainedModeSchema.optional(),
+    retainedAt: z.number().finite().optional(),
+    expiresAt: z.number().finite().nullable().optional(),
+    cleanupMessage: z.string().optional(),
+    review: reviewSchema.optional(),
+    reviewSlot: z.enum(['available', 'waiting']).optional(),
+    reviewSlotOwnerSessionId: sessionIdSchema.optional(),
+    previewRecovery: strict({
+        reason: z.enum(['stale_local', 'preview_modified']),
+        attemptedAction: z.enum(['rollback_preview', 'finalize_preview', 'discard']),
+    }).optional(),
+    capabilities: capabilitiesSchema,
+});
+const targetDetailsSchema = targetSummarySchema.extend({
+    managedRoot: z.string().min(1).nullable(),
+    sourceOid: oidSchema,
+    currentBranch: z.string().nullable(),
+}).strict();
+const consoleErrorSchema = strict({
+    code: z.enum(WORKTREE_CONSOLE_ERROR_CODES),
+    message: z.string(),
+    details: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()])).optional(),
+});
+export function outcomeSchema(value) {
+    return z.discriminatedUnion('ok', [
+        strict({ ok: z.literal(true), value }),
+        strict({ ok: z.literal(false), error: consoleErrorSchema }),
+    ]);
+}
+export const currentResponseSchema = strict({ target: targetDetailsSchema });
+export const createResponseSchema = strict({
+    target: targetDetailsSchema,
+    targetSessionId: sessionIdSchema,
+    managedRoot: z.string().min(1),
+});
+export const inspectResponseSchema = strict({ target: targetDetailsSchema });
+export const listResponseSchema = strict({ project: projectSchema, worktrees: z.array(targetSummarySchema) });
+export const mutationResponseSchema = strict({
+    target: targetSummarySchema,
+    changedFiles: z.array(z.string()).optional(),
+    commitOid: oidSchema.nullable().optional(),
+});
+const diffFileSchema = strict({
+    path: z.string(),
+    previousPath: z.string().optional(),
+    status: z.enum(['added', 'modified', 'deleted', 'renamed', 'binary']),
+    patch: z.string().nullable(),
+    truncated: z.boolean(),
+});
+const preflightFactsSchema = {
+    localModified: z.literal(false),
+    checkoutId: checkoutIdSchema,
+    reviewId: reviewIdSchema,
+    revision: revisionSchema,
+    configuredBaseOid: oidSchema,
+    effectiveBaseOid: oidSchema,
+    baseStrategy: z.enum(['recorded_base', 'isolated_contains_local_head', 'local_contains_isolated_head']),
+    localBranch: z.string().nullable(),
+    localHeadOid: oidSchema,
+    isolatedHeadOid: oidSchema,
+    changedFiles: z.array(z.string()),
+};
+const preflightSchema = z.union([
+    strict({ status: z.enum(['ready', 'local_advanced', 'already_in_local']), ...preflightFactsSchema }),
+    strict({ status: z.literal('conflict'), ...preflightFactsSchema, conflictingFiles: z.array(z.string()) }),
+    strict({
+        status: z.literal('blocked'),
+        localModified: z.literal(false),
+        checkoutId: z.string(),
+        reviewId: reviewIdSchema.nullable(),
+        revision: revisionSchema,
+        reason: z.enum(['not_owner', 'not_ready_for_review', 'stale_target', 'stale_isolated', 'project_acceptance_busy', 'checkout_unavailable', 'git_error']),
+        message: z.string(),
+    }),
+]);
+export const preflightResponseSchema = strict({ preflight: preflightSchema });
+export const reviewDiffResponseSchema = strict({
+    reviewId: reviewIdSchema,
+    revision: revisionSchema,
+    files: z.array(diffFileSchema).max(200),
+    truncated: z.boolean(),
+});
+//# sourceMappingURL=schemas.js.map

package/lib/console-remote/schemas.js.map

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

package/lib/console-remote/typert.d.ts

@@ -0,0 +1,3 @@
+import type { TypertContribution } from '@deepseek-ai/dsh-typert-registry/types';
+/** Manual strict Host contribution discovered by the official Typert Loader through `./typert`. */
+export declare const TYPERT: TypertContribution;

package/lib/console-remote/typert.js

@@ -0,0 +1,14 @@
+import { WORKTREE_CONSOLE_DESCRIPTORS } from './descriptors.js';
+/** Manual strict Host contribution discovered by the official Typert Loader through `./typert`. */
+export const TYPERT = Object.freeze({
+    package: 'dsh-git-worktree',
+    face: 'host',
+    schemas: [],
+    model: {
+        services: [],
+        events: [],
+        objects: [],
+    },
+    invocations: WORKTREE_CONSOLE_DESCRIPTORS,
+});
+//# sourceMappingURL=typert.js.map

package/lib/console-remote/typert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typert.js","sourceRoot":"","sources":["../../src/console-remote/typert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAE/D,mGAAmG;AACnG,MAAM,CAAC,MAAM,MAAM,GAAuB,MAAM,CAAC,MAAM,CAAC;IACtD,OAAO,EAAE,kBAAkB;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,EAAE;IACX,KAAK,EAAE;QACL,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;KACZ;IACD,WAAW,EAAE,4BAA4B;CAC1C,CAAC,CAAA"}

package/lib/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * dsh-git-worktree plugin entry. The session-checkout domain (state machine,
  * apply engine, ports) is Domi-ported and host-agnostic; this file is the DSH
- * plugin face: exports the domain error type and the module contract, builds
- * the DSH adapters, mounts the state machine, and registers the model tools,
- * `/worktree` command, and session context note.
+ * plugin face: exports the domain error type and module contract, builds the
+ * DSH adapters, mounts the state machine, and registers safe model tools,
+ * human `/worktree` acceptance commands, and Session Target runtime context.
  * @module dsh-git-worktree
  */
 import type { Context } from '@deepseek-ai/cordis';
@@ -29,6 +29,7 @@ export interface ManageManagedWorktreeInput {
     action: 'cleanup_retained' | 'retry_cleanup' | 'set_retention' | 'discard';
     retention?: Exclude<WorktreeRetentionMode, 'cleanup'>;
     confirmDirty?: boolean;
+    rollbackPreview?: boolean;
 }
 export interface ListManagedWorktreesInput {
     projectId?: string;
@@ -44,19 +45,35 @@ export interface MarkReadyForReviewInput {
     tests: WorktreeValidationItem[];
     suggestedCommitMessage: string;
 }
+/** Handoff data used by the client to create the authoritative isolated Workspace/Session. */
+export interface IsolatedTargetLaunch {
+    targetSessionId: string;
+    managedRoot: string;
+    target: SessionTargetView;
+}
 /** Complete core interface the session-checkout module exposes to business callers. */
 export interface SessionCheckoutModule {
     inspect(sessionId: string): Promise<SessionTargetView>;
+    /** Synchronous registry snapshot for replay-stable model runtime context. */
+    runtimeContext(sessionId: string): string;
     /** Read-only sync preflight; modifies no Local, worktree, registry, review state, or Git refs. */
     preflight?(sessionId: string, expectedRevision: number): Promise<WorktreeApplyPreflightView>;
     /** Cross-module mutation under the same exclusive lock as bind/apply/discard/cleanup. */
     runExclusiveSessionMutation<T>(sessionId: string, operation: (target: SessionTargetView) => Promise<T>): Promise<T>;
     bind(sessionId: string, choice: SessionTargetBindChoice): Promise<SessionTargetView>;
-    /** Lazily create the next isolated checkout when a delivered owner session needs code changes. */
-    beginNextIteration(sessionId: string): Promise<SessionTargetView>;
+    /** Reserve a distinct owner session and checkout without changing the source session cwd/identity. */
+    createIsolatedTarget(sourceSessionId: string, targetSessionId: string): Promise<IsolatedTargetLaunch>;
+    /** Recreate a cleaned delivered owner's immutable cwd as the next isolated iteration. */
+    beginNextIteration(sessionId: string, expectedRevision: number): Promise<SessionTargetView>;
+    /** Invalidate an unsynced review and resume the same iteration without touching Local. */
+    resumeRevision(sessionId: string, expectedRevision: number, expectedReviewId: string): Promise<SessionTargetView>;
     markReadyForReview(sessionId: string, input: MarkReadyForReviewInput): Promise<SessionTargetView>;
     operate(input: SessionCheckoutOperation): Promise<SessionCheckoutOperationResult>;
     listManagedWorktrees(input?: ListManagedWorktreesInput): Promise<ManagedWorktreeSummaryView[]>;
+    /** Caller-scoped list for model and human session surfaces. */
+    listManagedWorktreesForSession(sessionId: string, input?: Omit<ListManagedWorktreesInput, 'projectId'>): Promise<ManagedWorktreeSummaryView[]>;
+    /** Caller-scoped management; never treats persisted owner ids as authorization. */
+    manageManagedWorktreeForSession(sessionId: string, input: ManageManagedWorktreeInput): Promise<ManagedWorktreeSummaryView>;
     /** Main-owned read-only cleanup inspection; writes no registry, refs, or directories. */
     inspectManagedWorktreeCleanup(input?: ListManagedWorktreesInput): Promise<ManagedWorktreeSummaryView[]>;
     bulkCleanupManagedWorktrees(candidates: BulkCleanupManagedWorktreeCandidate[]): Promise<BulkCleanupManagedWorktreesResult>;
@@ -66,11 +83,12 @@ export interface SessionCheckoutModule {
     cleanupExpiredRetained(now?: number): Promise<string[]>;
     reconcile(): Promise<SessionCheckoutReconcileSummary>;
 }
+export * from './console-contract.js';
 export declare const inject: string[];
 /**
- * Mount the plugin: DSH adapters, the session-checkout module, the seven
- * worktree tools, the `/worktree` command, the once-per-session worktree
- * context note, startup reconciliation, and the retention-expiry timer.
+ * Mount the plugin: DSH adapters, the session-checkout module, safe worktree
+ * tools, human acceptance command, dynamic target context, startup recovery,
+ * and the retention-expiry timer.
  */
 export declare function apply(ctx: Context, config?: {
     stateDir?: string;

package/lib/index.js

@@ -1,9 +1,9 @@
 /**
  * dsh-git-worktree plugin entry. The session-checkout domain (state machine,
  * apply engine, ports) is Domi-ported and host-agnostic; this file is the DSH
- * plugin face: exports the domain error type and the module contract, builds
- * the DSH adapters, mounts the state machine, and registers the model tools,
- * `/worktree` command, and session context note.
+ * plugin face: exports the domain error type and module contract, builds the
+ * DSH adapters, mounts the state machine, and registers safe model tools,
+ * human `/worktree` acceptance commands, and Session Target runtime context.
  * @module dsh-git-worktree
  */
 /** Stable domain failure raised by the session-checkout state machine and its adapters. */
@@ -32,6 +32,11 @@ import { createSessionCheckoutApplyEngine } from './session-checkout-apply.js';
 import { createSessionCheckoutModule } from './session-checkout-module.js';
 import { registerTools } from './tools.js';
 import { registerWorktreeCommand } from './commands.js';
+import { registerSessionTargetContext } from './session-target-context.js';
+import { createWorktreeConsoleControlPlane } from './console-host/control-plane.js';
+import { createGitWorktreeReviewDiffReader } from './console-host/review-diff.js';
+import { WorktreeConsoleService } from './console-host/service.js';
+export * from './console-contract.js';
 const name = 'git-worktree';
 // Named export: the loader reads inject/apply named exports as plugin
 // metadata. A bare function export mounts with no injection list, and the
@@ -54,26 +59,39 @@ function resolveStateDir(config) {
 }
 const RETENTION_MAINTENANCE_INTERVAL_MS = 15 * 60 * 1000;
 /**
- * Mount the plugin: DSH adapters, the session-checkout module, the seven
- * worktree tools, the `/worktree` command, the once-per-session worktree
- * context note, startup reconciliation, and the retention-expiry timer.
+ * Mount the plugin: DSH adapters, the session-checkout module, safe worktree
+ * tools, human acceptance command, dynamic target context, startup recovery,
+ * and the retention-expiry timer.
  */
 export function apply(ctx, config = {}) {
     const stateDir = resolveStateDir(config);
     mkdirSync(stateDir, { recursive: true });
     const hooksPath = join(stateDir, 'disabled-git-hooks');
     mkdirSync(hooksPath, { recursive: true });
+    const lookup = createDshLookupPort(ctx);
+    const git = createDshGitPort(ctx, { hooksPath });
+    const files = createNodeFilesPort();
+    const registry = new AtomicJsonCheckoutRegistry(join(stateDir, 'managed-checkouts.json'));
     const module = createSessionCheckoutModule({
-        lookup: createDshLookupPort(ctx),
-        git: createDshGitPort(ctx, { hooksPath }),
-        files: createNodeFilesPort(),
-        registry: new AtomicJsonCheckoutRegistry(join(stateDir, 'managed-checkouts.json')),
+        lookup,
+        git,
+        files,
+        registry,
         applyEngine: createSessionCheckoutApplyEngine(),
         managedCheckoutsRoot: stateDir,
         createCheckoutId: randomUUID,
     });
+    new WorktreeConsoleService(ctx, createWorktreeConsoleControlPlane({
+        module,
+        lookup,
+        files,
+        registry,
+        git,
+        reviewDiff: createGitWorktreeReviewDiffReader(),
+    }));
     registerTools(ctx, module);
     registerWorktreeCommand(ctx, module);
+    registerSessionTargetContext(ctx, module);
     // Startup recovery plus periodic expiry of retained worktrees. cordis's
     // typed Events map omits the runtime 'ready' event; the events service's
     // loose runtime signature covers it.

package/lib/index.js.map

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

package/lib/managed-worktree-path.d.ts

@@ -1,27 +1,28 @@
-/** 将会话标题转换为跨平台安全、可读的单个目录名片段。 */
-export declare function sanitizeManagedWorktreeLabel(rawTitle: string | undefined): string;
+/** Convert a canonical repository basename into one safe, readable path segment. */
+export declare function sanitizeManagedWorktreeLabel(rawName: string | undefined): string;
+/** Stable fallback partition that distinguishes repositories sharing one basename. */
+export declare function createManagedWorktreeRepositoryKey(canonicalGitRoot: string): string;
+/** Physical basename: repository identity + trusted checkout identity only. */
 export declare function createManagedWorktreeDirectoryName(input: {
-    sessionId: string;
-    sessionTitle?: string;
-    checkoutId?: string;
-    iteration?: number;
+    repositoryName: string;
+    checkoutId: string;
+    identityLength?: number;
 }): string;
 export interface ManagedWorktreePathCandidates {
     siblingContainer: string;
     siblingRoot: string;
+    fallbackContainer: string;
     fallbackRoot: string;
 }
 /**
- * 只生成候选路径，不访问文件系统：
- * - siblingRoot：Git 根目录同级的可读容器；
- * - fallbackRoot：原 Domi 数据目录下、按 repository key 分组的安全回退。
+ * Generate one collision-length candidate without touching the filesystem.
+ * The caller probes 8/12/full checkout identities and chooses the first path
+ * that does not already exist.
  */
 export declare function createManagedWorktreePathCandidates(input: {
     localGitRoot: string;
     managedCheckoutsRoot: string;
     repositoryKey: string;
-    sessionId: string;
-    sessionTitle?: string;
-    checkoutId?: string;
-    iteration?: number;
+    checkoutId: string;
+    identityLength?: number;
 }): ManagedWorktreePathCandidates;