sdd-agent-platform 0.3.0 → 0.4.0

package/packages/core/dist/workflow-state/resolve.d.ts

@@ -0,0 +1,50 @@
+import { WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION } from '../contracts.js';
+import type { RunState, RunSummary } from '../run-state/model.js';
+import { type WorkflowAffectedFileConflict } from './affected-file-conflicts.js';
+import { type ContextBranchSource, type ContextResolverContract } from '../sdd-docs/context.js';
+import { type SddTaskGap, type SddTaskModel } from '../sdd-docs/task-parser.js';
+import { type WorkflowDependencyBlocker } from './dependencies.js';
+export interface WorkflowTaskCounts {
+    total: number;
+    pending: number;
+    inProgress: number;
+    completed: number;
+    blocked: number;
+    deferred: number;
+    unknown: number;
+    gaps: number;
+}
+export interface WorkflowLatestTaskRun {
+    partition: string;
+    gitBranch: string | null;
+    taskId: string;
+    runId: string;
+    runStatus: RunState['status'];
+    validationStatus: RunState['validation']['status'];
+    syncBackStatus: RunState['syncBack']['status'];
+    affectedFiles: string[];
+    updatedAt: string;
+}
+export interface WorkflowStateResolution {
+    contract: typeof WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION;
+    generatedAt: string;
+    branch: string;
+    workflowStatus: 'active' | 'not_started';
+    context: ContextResolverContract;
+    documents: SddTaskModel['documents'];
+    model: SddTaskModel;
+    taskCounts: WorkflowTaskCounts;
+    visibleGaps: SddTaskGap[];
+    latestRun: RunSummary | null;
+    latestRunState: RunState | null;
+    latestRunsByTask: WorkflowLatestTaskRun[];
+    affectedFileConflicts: WorkflowAffectedFileConflict[];
+    blockingReasons: string[];
+    dependencyBlockers: WorkflowDependencyBlocker[];
+    recommendedNextCommand: string;
+}
+export declare function resolveWorkflowState(projectRoot: string, options?: {
+    branch?: string | null;
+    branchSource?: ContextBranchSource;
+    taskId?: string | null;
+}): Promise<WorkflowStateResolution>;

package/packages/core/dist/workflow-state/resolve.js

@@ -0,0 +1,124 @@
+import { WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION } from '../contracts.js';
+import { recordRuntimeProjection } from '../storage/runtime-store.js';
+import { affectedFileConflictsForSelectedRun } from './affected-file-conflicts.js';
+import { readAllRunStates, summarizeRunState } from '../run-state/run-state.js';
+import { resolveSddContext } from '../sdd-docs/context.js';
+import { parseSddBranch } from '../sdd-docs/task-parser.js';
+import { workflowDependencyBlockers } from './dependencies.js';
+export async function resolveWorkflowState(projectRoot, options = {}) {
+    const context = await resolveSddContext(projectRoot, options);
+    const branch = context.partition;
+    const [model, states] = await Promise.all([parseSddBranch(projectRoot, branch), readAllRunStates(projectRoot)]);
+    const visibleGaps = workflowIsActive(model) ? model.gaps : [];
+    const latestRunsByTask = latestTaskRuns(states, branch);
+    const selectedTaskRun = options.taskId
+        ? latestRunsByTask.find((entry) => entry.taskId === options.taskId) ?? null
+        : latestRunsByTask.slice().sort((left, right) => Date.parse(right.updatedAt) - Date.parse(left.updatedAt))[0] ?? null;
+    const latestRunState = selectedTaskRun ? states.find((state) => state.runId === selectedTaskRun.runId) ?? null : null;
+    const affectedFileConflicts = latestRunState ? affectedFileConflictsForSelectedRun(states, latestRunState) : [];
+    const dependencyBlockers = workflowDependencyBlockers(model);
+    const blockingReasons = blockingWorkflowReasons(visibleGaps, affectedFileConflicts, dependencyBlockers);
+    const resolution = {
+        contract: WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION,
+        generatedAt: new Date().toISOString(),
+        branch,
+        workflowStatus: workflowIsActive(model) ? 'active' : 'not_started',
+        context,
+        documents: model.documents,
+        model,
+        taskCounts: taskCounts(model, visibleGaps),
+        visibleGaps,
+        latestRun: latestRunState ? summarizeRunState(latestRunState) : null,
+        latestRunState,
+        latestRunsByTask,
+        affectedFileConflicts,
+        dependencyBlockers,
+        blockingReasons,
+        recommendedNextCommand: recommendedNextCommand(context, model, latestRunState, visibleGaps, dependencyBlockers)
+    };
+    await recordRuntimeProjection(projectRoot, 'workflow_state', branch, projectWorkflowStateProjection(resolution));
+    return resolution;
+}
+function workflowIsActive(model) {
+    return model.documents.specExists || model.documents.planExists || model.documents.tasksExists;
+}
+function taskCounts(model, gaps) {
+    return {
+        total: model.tasks.length,
+        pending: model.tasks.filter((task) => task.status === 'pending').length,
+        inProgress: model.tasks.filter((task) => task.status === 'in_progress').length,
+        completed: model.tasks.filter((task) => task.status === 'completed').length,
+        blocked: model.tasks.filter((task) => task.status === 'blocked').length,
+        deferred: model.tasks.filter((task) => task.status === 'deferred').length,
+        unknown: model.tasks.filter((task) => task.status === 'unknown').length,
+        gaps: gaps.length
+    };
+}
+function latestTaskRuns(states, partition) {
+    const latest = new Map();
+    for (const state of states) {
+        if (state.status === 'archived' || state.partition !== partition || !state.taskId) {
+            continue;
+        }
+        const entry = {
+            partition,
+            gitBranch: state.gitBranch,
+            taskId: state.taskId,
+            runId: state.runId,
+            runStatus: state.status,
+            validationStatus: state.validation.status,
+            syncBackStatus: state.syncBack.status,
+            affectedFiles: state.affectedFiles,
+            updatedAt: state.updatedAt
+        };
+        const existing = latest.get(entry.taskId);
+        if (!existing || Date.parse(entry.updatedAt) > Date.parse(existing.updatedAt) || (entry.updatedAt === existing.updatedAt && entry.runId.localeCompare(existing.runId) > 0)) {
+            latest.set(entry.taskId, entry);
+        }
+    }
+    return Array.from(latest.values()).sort((left, right) => left.taskId.localeCompare(right.taskId));
+}
+function blockingWorkflowReasons(gaps, conflicts, dependencyBlockers) {
+    const reasons = gaps.filter((gap) => gap.severity === 'blocking').map((gap) => `${gap.field}: ${gap.message}`);
+    for (const conflict of conflicts) {
+        reasons.push(`Affected file ${conflict.file} is active in run ${conflict.runId} for ${conflict.partition}/${conflict.taskId}.`);
+    }
+    for (const blocker of dependencyBlockers) {
+        reasons.push(blocker.reason);
+    }
+    return reasons;
+}
+function recommendedNextCommand(context, model, latestRun, gaps, dependencyBlockers) {
+    if (!workflowIsActive(model)) {
+        return context.branchSource === 'git_branch' ? '/sdd:spec' : `/sdd:spec --branch ${context.rawBranch}`;
+    }
+    if (gaps.some((gap) => gap.severity === 'blocking')) {
+        return `sdd tasks gaps --branch ${context.partition}`;
+    }
+    const dependencyBlocker = dependencyBlockers[0];
+    if (dependencyBlocker) {
+        return `sdd tasks inspect ${dependencyBlocker.dependencyId} --branch ${context.partition}`;
+    }
+    if (latestRun?.syncBack.status === 'proposed' && latestRun.currentTask) {
+        return `sdd sync-back inspect --branch ${context.partition} --task ${latestRun.currentTask}`;
+    }
+    const pendingTask = model.tasks.find((task) => task.status === 'pending');
+    return pendingTask ? `sdd tasks inspect ${pendingTask.id} --branch ${context.partition}` : `sdd tasks list --branch ${context.partition}`;
+}
+function projectWorkflowStateProjection(resolution) {
+    return {
+        contract: resolution.contract,
+        generatedAt: resolution.generatedAt,
+        branch: resolution.branch,
+        workflowStatus: resolution.workflowStatus,
+        documents: resolution.documents,
+        taskCounts: resolution.taskCounts,
+        latestRun: resolution.latestRun,
+        latestRunsByTask: resolution.latestRunsByTask,
+        affectedFileConflicts: resolution.affectedFileConflicts,
+        dependencyBlockers: resolution.dependencyBlockers,
+        blockingReasons: resolution.blockingReasons,
+        recommendedNextCommand: resolution.recommendedNextCommand
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/packages/core/dist/workflow-state/resolve.js.map

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

package/packages/core/dist/workflow-state.d.ts

@@ -0,0 +1 @@
+export * from './workflow-state/resolve.js';

package/packages/core/dist/workflow-state.js

@@ -0,0 +1,2 @@
+export * from './workflow-state/resolve.js';
+//# sourceMappingURL=workflow-state.js.map

package/packages/core/dist/workflow-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../src/workflow-state.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/packages/core/dist/worktree/isolation.d.ts

@@ -0,0 +1,40 @@
+import type { ToolCapabilitySideEffect } from '../registries/tool-capabilities.js';
+export declare const WORKTREE_ISOLATION_CONTRACT_VERSION = "phase-3.7-worktree-isolation-contract-v1";
+export type WorktreeIsolationMode = 'none' | 'required' | 'blocked' | 'manual';
+export interface WorktreeIsolationPeer {
+    taskId: string;
+    affectedFiles: string[];
+    risk: string[];
+}
+export interface WorktreeIsolationGate {
+    name: string;
+    passed: boolean;
+    message: string;
+}
+export interface WorktreeIsolationDecision {
+    version: string;
+    taskId: string;
+    mode: WorktreeIsolationMode;
+    safeConcurrency: boolean;
+    capabilityId: string;
+    capabilitySideEffect: ToolCapabilitySideEffect;
+    affectedFiles: string[];
+    risk: string[];
+    peers: WorktreeIsolationPeer[];
+    overlaps: Array<{
+        peerTaskId: string;
+        files: string[];
+    }>;
+    gates: WorktreeIsolationGate[];
+    reasons: string[];
+}
+export declare function inspectWorktreeIsolation(projectRoot: string, options: {
+    branch?: string;
+    taskId: string;
+    capabilityId?: string;
+    peerTaskIds?: string[];
+}): Promise<WorktreeIsolationDecision>;
+export declare function inspectWorktreeIsolationContract(projectRoot: string): Promise<{
+    valid: boolean;
+    issues: string[];
+}>;

package/packages/core/dist/worktree/isolation.js

@@ -0,0 +1,89 @@
+import { inspectToolCapability, listToolCapabilities } from '../registries/tool-capabilities.js';
+import { resolveSddContext } from '../sdd-docs/context.js';
+import { inspectSddTask } from '../sdd-docs/task-inspection.js';
+import { parseSddBranch } from '../sdd-docs/task-parser.js';
+import { buildTaskRiskProfile } from '../task-risk-profile.js';
+export const WORKTREE_ISOLATION_CONTRACT_VERSION = 'phase-3.7-worktree-isolation-contract-v1';
+export async function inspectWorktreeIsolation(projectRoot, options) {
+    const branch = options.branch ?? (await resolveSddContext(projectRoot)).branch;
+    const [model, capabilityRegistry] = await Promise.all([parseSddBranch(projectRoot, branch), listToolCapabilities(projectRoot)]);
+    const inspected = inspectSddTask(model, options.taskId);
+    const capabilityId = options.capabilityId ?? 'native-file-edit';
+    const capability = capabilityRegistry.capabilities.find((candidate) => candidate.id === capabilityId);
+    const task = inspected.task;
+    const affectedFiles = task?.affectedFiles ?? [];
+    const risk = task?.risk ?? [];
+    const peers = (options.peerTaskIds ?? []).map((peerTaskId) => {
+        const peer = inspectSddTask(model, peerTaskId).task;
+        return { taskId: peerTaskId, affectedFiles: peer?.affectedFiles ?? [], risk: peer?.risk ?? [] };
+    });
+    const sideEffect = capability?.sideEffect ?? 'local_write';
+    const overlaps = peers
+        .map((peer) => ({ peerTaskId: peer.taskId, files: overlappingFiles(affectedFiles, peer.affectedFiles) }))
+        .filter((overlap) => overlap.files.length > 0);
+    const riskProfile = buildTaskRiskProfile(task);
+    const highRisk = riskProfile.riskLevel === 'high';
+    const manualRisk = riskProfile.securitySensitive || riskProfile.normalizedTags.includes('database');
+    const unsafeOverlap = overlaps.length > 0 && sideEffect !== 'read_only';
+    const reasons = [];
+    const gates = [];
+    if (!task) {
+        reasons.push(`Task ${options.taskId} is missing or ambiguous in specs/${branch}/tasks.md.`);
+    }
+    if (!capability) {
+        reasons.push(`Capability ${capabilityId} is not declared in the Phase 3.1 capability registry.`);
+    }
+    if (unsafeOverlap) {
+        reasons.push(`Writable task overlaps peer affected file(s): ${overlaps.map((overlap) => `${overlap.peerTaskId}:${overlap.files.join(',')}`).join('; ')}.`);
+    }
+    if (manualRisk) {
+        reasons.push('Database/security risk profile requires manual isolation gate before worktree lifecycle automation.');
+    }
+    else if (highRisk && sideEffect !== 'read_only') {
+        reasons.push('High-risk writable task risk profile requires worktree isolation.');
+    }
+    else if (sideEffect === 'read_only') {
+        reasons.push('Read-only capability does not require worktree isolation.');
+    }
+    else if (sideEffect === 'local_write' || sideEffect === 'command_execution') {
+        reasons.push('Writable or command-executing capability requires worktree isolation unless blocked by overlap.');
+    }
+    gates.push({ name: 'task_found', passed: task !== null, message: task ? `Task ${options.taskId} found.` : `Task ${options.taskId} missing or ambiguous.` }, { name: 'capability_declared', passed: capability !== undefined, message: capability ? `Capability ${capabilityId} side_effect=${sideEffect}.` : `Capability ${capabilityId} missing.` }, { name: 'files_overlap', passed: overlaps.length === 0, message: overlaps.length === 0 ? 'No peer affected_files overlap.' : `Overlaps: ${overlaps.map((overlap) => `${overlap.peerTaskId}:${overlap.files.join(',')}`).join('; ')}` }, { name: 'unsafe_concurrency', passed: !unsafeOverlap, message: unsafeOverlap ? 'Writable overlapping tasks are not safe to run concurrently.' : 'No unsafe writable overlap detected.' }, { name: 'read_only', passed: sideEffect === 'read_only', message: sideEffect === 'read_only' ? 'Read-only task can run without worktree.' : 'Task may mutate local state or execute commands.' });
+    const mode = !task || !capability || unsafeOverlap
+        ? 'blocked'
+        : manualRisk || sideEffect === 'external_interaction'
+            ? 'manual'
+            : sideEffect === 'read_only'
+                ? 'none'
+                : 'required';
+    return {
+        version: WORKTREE_ISOLATION_CONTRACT_VERSION,
+        taskId: options.taskId,
+        mode,
+        safeConcurrency: mode !== 'blocked',
+        capabilityId,
+        capabilitySideEffect: sideEffect,
+        affectedFiles,
+        risk,
+        peers,
+        overlaps,
+        gates,
+        reasons
+    };
+}
+export async function inspectWorktreeIsolationContract(projectRoot) {
+    const capability = await inspectToolCapability(projectRoot, 'native-file-edit');
+    const issues = [];
+    if (!capability) {
+        issues.push('native-file-edit capability is missing.');
+    }
+    return { valid: issues.length === 0, issues };
+}
+function overlappingFiles(left, right) {
+    const rightSet = new Set(right.map(normalizeComparablePath));
+    return left.filter((file) => rightSet.has(normalizeComparablePath(file)));
+}
+function normalizeComparablePath(filePath) {
+    return filePath.replace(/\\/g, '/').replace(/^\.\//, '');
+}
+//# sourceMappingURL=isolation.js.map

package/packages/core/dist/worktree/isolation.js.map

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

package/packages/core/dist/worktree/lifecycle.d.ts

@@ -0,0 +1,39 @@
+export declare const WORKTREE_LIFECYCLE_CONTRACT_VERSION = "phase-3.8-worktree-lifecycle-v1";
+export interface WorktreeLifecycleIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export type WorktreeLifecycleStatus = 'created' | 'kept' | 'removed';
+export interface WorktreeLifecycleRecord {
+    contract: typeof WORKTREE_LIFECYCLE_CONTRACT_VERSION;
+    runId: string;
+    taskId: string;
+    worktreeId: string;
+    status: WorktreeLifecycleStatus;
+    branchName: string;
+    worktreePath: string;
+    baseRef: string;
+    createdAt: string;
+    updatedAt: string;
+    removedAt: string | null;
+    keepReason: string | null;
+    dirty: boolean;
+}
+export interface WorktreeLifecycleInspection {
+    runId: string;
+    contract: typeof WORKTREE_LIFECYCLE_CONTRACT_VERSION;
+    records: WorktreeLifecycleRecord[];
+    valid: boolean;
+    issues: WorktreeLifecycleIssue[];
+}
+export declare function createWorktreeLifecycle(projectRoot: string, runId: string, options: {
+    taskId: string;
+    baseRef?: string;
+    worktreeId?: string;
+}): Promise<WorktreeLifecycleRecord>;
+export declare function inspectWorktreeLifecycle(projectRoot: string, runId: string): Promise<WorktreeLifecycleInspection>;
+export declare function keepWorktreeLifecycle(projectRoot: string, runId: string, worktreeId: string, options?: {
+    reason?: string;
+}): Promise<WorktreeLifecycleRecord>;
+export declare function removeWorktreeLifecycle(projectRoot: string, runId: string, worktreeId: string): Promise<WorktreeLifecycleRecord>;

package/packages/core/dist/worktree/lifecycle.js

@@ -0,0 +1,221 @@
+import { execFile } from 'node:child_process';
+import { mkdir, readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { parseProjectConfig } from '../config/project-config.js';
+import { assertSafePathSegment } from '../path-safety.js';
+import { appendEvent } from '../run-state/events.js';
+import { readRunState, writeRunState } from '../run-state/run-state.js';
+import { getProjectConfigPath, getWorktreesDir } from '../runtime-paths.js';
+import { exists } from '../storage/json-io.js';
+import { inspectWorktreeIsolation } from './isolation.js';
+const execFileAsync = promisify(execFile);
+export const WORKTREE_LIFECYCLE_CONTRACT_VERSION = 'phase-3.8-worktree-lifecycle-v1';
+export async function createWorktreeLifecycle(projectRoot, runId, options) {
+    await assertProjectConfigReadable(projectRoot);
+    const state = await readRunState(projectRoot, runId);
+    const decision = await inspectWorktreeIsolation(projectRoot, { taskId: options.taskId });
+    if (decision.mode === 'blocked' || decision.mode === 'none') {
+        throw new Error(`Cannot create worktree for ${options.taskId}: isolation mode is ${decision.mode}.`);
+    }
+    const gitRoot = await getGitRoot(projectRoot);
+    if (!gitRoot) {
+        throw new Error('Cannot create worktree outside a Git repository.');
+    }
+    const worktreeId = options.worktreeId ?? defaultWorktreeId(runId, options.taskId);
+    assertSafePathSegment(worktreeId, 'worktreeId');
+    const currentWorktrees = state.worktrees ?? {};
+    const existing = currentWorktrees[worktreeId];
+    if (existing && existing.status !== 'removed') {
+        throw new Error(`Worktree ${worktreeId} already exists for run ${runId}.`);
+    }
+    const baseRef = options.baseRef ?? 'HEAD';
+    const branchName = `sdd-${worktreeId}`;
+    const worktreePath = path.join(getWorktreesDir(projectRoot), worktreeId);
+    await mkdir(path.dirname(worktreePath), { recursive: true });
+    await execFileAsync('git', ['-C', projectRoot, 'worktree', 'add', '-b', branchName, worktreePath, baseRef]);
+    const now = new Date().toISOString();
+    const record = {
+        contract: WORKTREE_LIFECYCLE_CONTRACT_VERSION,
+        runId,
+        taskId: options.taskId,
+        worktreeId,
+        status: 'created',
+        branchName,
+        worktreePath: path.relative(projectRoot, worktreePath),
+        baseRef,
+        createdAt: now,
+        updatedAt: now,
+        removedAt: null,
+        keepReason: null,
+        dirty: false
+    };
+    await writeRunState(projectRoot, { ...state, worktrees: { ...currentWorktrees, [worktreeId]: record } });
+    await appendEvent(projectRoot, runId, {
+        event: 'worktree_created',
+        runId,
+        summary: `Worktree ${worktreeId} created for ${options.taskId}.`,
+        data: { worktreeId, taskId: options.taskId, path: record.worktreePath, branchName, baseRef }
+    });
+    return record;
+}
+export async function inspectWorktreeLifecycle(projectRoot, runId) {
+    const state = await readRunState(projectRoot, runId);
+    const records = await Promise.all(Object.values(state.worktrees ?? {}).map(async (record) => ({
+        ...record,
+        dirty: record.status === 'removed' ? false : await isGitWorktreeDirty(projectRoot, record.worktreePath)
+    })));
+    const issues = [];
+    const activePaths = new Set(records.filter((record) => record.status !== 'removed').map((record) => normalizeComparablePath(record.worktreePath)));
+    const registeredPaths = await listGitWorktreePaths(projectRoot);
+    for (const record of records) {
+        const absolutePath = path.resolve(projectRoot, record.worktreePath);
+        const comparablePath = normalizeComparablePath(record.worktreePath);
+        const pathExists = await exists(absolutePath);
+        if (record.contract !== WORKTREE_LIFECYCLE_CONTRACT_VERSION) {
+            issues.push(lifecycleIssue('contract', `${record.worktreeId} uses ${record.contract}.`, `Use ${WORKTREE_LIFECYCLE_CONTRACT_VERSION}.`));
+        }
+        if (record.status !== 'removed' && !pathExists) {
+            issues.push(lifecycleIssue('worktreePath', `${record.worktreeId} points to missing worktree path ${record.worktreePath}.`, 'Inspect worktree state and mark removed only through lifecycle remove.'));
+        }
+        if (record.status !== 'removed' && pathExists && !registeredPaths.has(normalizeComparablePath(absolutePath))) {
+            issues.push(lifecycleIssue('worktreePath', `${record.worktreeId} path is not registered in git worktree list.`, 'Inspect git worktree list and reconcile lifecycle state.'));
+        }
+        if (record.status === 'removed' && pathExists) {
+            issues.push(lifecycleIssue('status', `${record.worktreeId} is removed in state but path still exists.`, 'Inspect the path before deleting anything manually.'));
+        }
+        if (record.status !== 'removed' && record.dirty) {
+            issues.push(lifecycleIssue('dirty', `${record.worktreeId} has uncommitted changes.`, 'Keep the worktree or resolve changes before lifecycle remove.'));
+        }
+        if (record.status !== 'removed' && activePaths.has(comparablePath) && Array.from(activePaths).filter((item) => item === comparablePath).length > 1) {
+            issues.push(lifecycleIssue('worktreePath', `${record.worktreeId} shares a path with another active worktree.`, 'Use one lifecycle record per worktree path.'));
+        }
+    }
+    for (const orphanPath of await listOrphanWorktreeDirs(projectRoot, activePaths)) {
+        issues.push(lifecycleIssue('orphan', `${orphanPath} exists without active lifecycle state.`, 'Inspect the directory before removing it or recreate lifecycle state.'));
+    }
+    return {
+        runId,
+        contract: WORKTREE_LIFECYCLE_CONTRACT_VERSION,
+        records,
+        valid: issues.length === 0,
+        issues
+    };
+}
+export async function keepWorktreeLifecycle(projectRoot, runId, worktreeId, options = {}) {
+    assertSafePathSegment(worktreeId, 'worktreeId');
+    const state = await readRunState(projectRoot, runId);
+    const record = (state.worktrees ?? {})[worktreeId];
+    if (!record) {
+        throw new Error(`Unknown worktree ${worktreeId} for run ${runId}.`);
+    }
+    const now = new Date().toISOString();
+    const nextRecord = {
+        ...record,
+        status: 'kept',
+        updatedAt: now,
+        keepReason: options.reason ?? 'kept for later inspection',
+        dirty: await isGitWorktreeDirty(projectRoot, record.worktreePath)
+    };
+    await writeRunState(projectRoot, { ...state, worktrees: { ...(state.worktrees ?? {}), [worktreeId]: nextRecord } });
+    await appendEvent(projectRoot, runId, {
+        event: 'worktree_kept',
+        runId,
+        summary: `Worktree ${worktreeId} kept.`,
+        data: { worktreeId, reason: nextRecord.keepReason, dirty: nextRecord.dirty }
+    });
+    return nextRecord;
+}
+export async function removeWorktreeLifecycle(projectRoot, runId, worktreeId) {
+    assertSafePathSegment(worktreeId, 'worktreeId');
+    const state = await readRunState(projectRoot, runId);
+    const record = (state.worktrees ?? {})[worktreeId];
+    if (!record) {
+        throw new Error(`Unknown worktree ${worktreeId} for run ${runId}.`);
+    }
+    if (record.status === 'removed') {
+        return record;
+    }
+    const dirty = await isGitWorktreeDirty(projectRoot, record.worktreePath);
+    if (dirty) {
+        throw new Error(`Refusing to remove dirty worktree ${worktreeId}. Commit, stash, or keep it first.`);
+    }
+    await execFileAsync('git', ['-C', projectRoot, 'worktree', 'remove', path.resolve(projectRoot, record.worktreePath)]);
+    const now = new Date().toISOString();
+    const nextRecord = {
+        ...record,
+        status: 'removed',
+        updatedAt: now,
+        removedAt: now,
+        dirty: false
+    };
+    await writeRunState(projectRoot, { ...state, worktrees: { ...(state.worktrees ?? {}), [worktreeId]: nextRecord } });
+    await appendEvent(projectRoot, runId, {
+        event: 'worktree_removed',
+        runId,
+        summary: `Worktree ${worktreeId} removed.`,
+        data: { worktreeId, path: record.worktreePath }
+    });
+    return nextRecord;
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+function defaultWorktreeId(runId, taskId) {
+    return `wt-${runId}-${taskId}`.replace(/[^A-Za-z0-9._-]/g, '-');
+}
+async function isGitWorktreeDirty(projectRoot, worktreePath) {
+    const absolutePath = path.resolve(projectRoot, worktreePath);
+    if (!await exists(absolutePath)) {
+        return false;
+    }
+    try {
+        const result = await execFileAsync('git', ['-C', absolutePath, 'status', '--porcelain']);
+        return result.stdout.trim().length > 0;
+    }
+    catch {
+        return true;
+    }
+}
+async function listGitWorktreePaths(projectRoot) {
+    try {
+        const result = await execFileAsync('git', ['-C', projectRoot, 'worktree', 'list', '--porcelain']);
+        return new Set(result.stdout.split(/\r?\n/).filter((line) => line.startsWith('worktree ')).map((line) => normalizeComparablePath(path.resolve(line.slice('worktree '.length)))));
+    }
+    catch {
+        return new Set();
+    }
+}
+async function listOrphanWorktreeDirs(projectRoot, activePaths) {
+    const worktreesDir = getWorktreesDir(projectRoot);
+    if (!await exists(worktreesDir)) {
+        return [];
+    }
+    const entries = await readdir(worktreesDir, { withFileTypes: true });
+    const orphans = [];
+    for (const entry of entries.filter((candidate) => candidate.isDirectory())) {
+        const relativePath = path.relative(projectRoot, path.join(worktreesDir, entry.name));
+        if (!activePaths.has(normalizeComparablePath(relativePath))) {
+            orphans.push(relativePath);
+        }
+    }
+    return orphans;
+}
+async function getGitRoot(projectRoot) {
+    try {
+        const result = await execFileAsync('git', ['-C', projectRoot, 'rev-parse', '--show-toplevel']);
+        return result.stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeComparablePath(filePath) {
+    return filePath.replace(/\\/g, '/').replace(/^\.\//, '');
+}
+function lifecycleIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+//# sourceMappingURL=lifecycle.js.map

package/packages/core/dist/worktree/lifecycle.js.map

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

package/packages/core/dist/worktree.d.ts

@@ -0,0 +1,2 @@
+export * from './worktree/isolation.js';
+export * from './worktree/lifecycle.js';

package/packages/core/dist/worktree.js

@@ -0,0 +1,3 @@
+export * from './worktree/isolation.js';
+export * from './worktree/lifecycle.js';
+//# sourceMappingURL=worktree.js.map

package/packages/core/dist/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}