pi-crew 0.2.3 → 0.2.5

package/src/state/task-claims.ts

@@ -1,44 +1,44 @@
-import { randomUUID } from "node:crypto";
-import type { TeamTaskState } from "./types.ts";
-
-export interface TaskClaimState {
-	owner: string;
-	token: string;
-	leasedUntil: string;
-}
-
-export function createTaskClaim(owner: string, leaseMs = 5 * 60_000, now = new Date()): TaskClaimState {
-	return { owner, token: randomUUID(), leasedUntil: new Date(now.getTime() + leaseMs).toISOString() };
-}
-
-export function isTaskClaimExpired(claim: TaskClaimState | undefined, now = new Date()): boolean {
-	if (!claim) return false;
-	const parsed = Date.parse(claim.leasedUntil);
-	// Corrupt or invalid date strings produce NaN — treat as expired immediately.
-	return Number.isFinite(parsed) ? parsed <= now.getTime() : true;
-}
-
-export function canUseTaskClaim(task: Pick<TeamTaskState, "claim">, owner: string, token: string, now = new Date()): boolean {
-	return task.claim?.owner === owner && task.claim.token === token && !isTaskClaimExpired(task.claim, now);
-}
-
-export function claimTask<T extends TeamTaskState>(task: T, owner: string, leaseMs?: number, now = new Date()): T {
-	if (task.claim && !isTaskClaimExpired(task.claim, now)) {
-		throw new Error(`Task '${task.id}' is already claimed by '${task.claim.owner}'.`);
-	}
-	return { ...task, claim: createTaskClaim(owner, leaseMs, now) };
-}
-
-export function releaseTaskClaim<T extends TeamTaskState>(task: T, owner: string, token: string, now = new Date()): T {
-	if (!canUseTaskClaim(task, owner, token, now)) {
-		throw new Error(`Task '${task.id}' claim is not held by '${owner}' or has expired.`);
-	}
-	return { ...task, claim: undefined };
-}
-
-export function transitionClaimedTaskStatus<T extends TeamTaskState>(task: T, owner: string, token: string, status: T["status"], now = new Date()): T {
-	if (!canUseTaskClaim(task, owner, token, now)) {
-		throw new Error(`Task '${task.id}' claim is not held by '${owner}' or has expired.`);
-	}
-	return { ...task, status };
-}
+import { randomUUID } from "node:crypto";
+import type { TeamTaskState } from "./types.ts";
+
+export interface TaskClaimState {
+	owner: string;
+	token: string;
+	leasedUntil: string;
+}
+
+export function createTaskClaim(owner: string, leaseMs = 5 * 60_000, now = new Date()): TaskClaimState {
+	return { owner, token: randomUUID(), leasedUntil: new Date(now.getTime() + leaseMs).toISOString() };
+}
+
+export function isTaskClaimExpired(claim: TaskClaimState | undefined, now = new Date()): boolean {
+	if (!claim) return false;
+	const parsed = Date.parse(claim.leasedUntil);
+	// Corrupt or invalid date strings produce NaN — treat as expired immediately.
+	return Number.isFinite(parsed) ? parsed <= now.getTime() : true;
+}
+
+export function canUseTaskClaim(task: Pick<TeamTaskState, "claim">, owner: string, token: string, now = new Date()): boolean {
+	return task.claim?.owner === owner && task.claim.token === token && !isTaskClaimExpired(task.claim, now);
+}
+
+export function claimTask<T extends TeamTaskState>(task: T, owner: string, leaseMs?: number, now = new Date()): T {
+	if (task.claim && !isTaskClaimExpired(task.claim, now)) {
+		throw new Error(`Task '${task.id}' is already claimed by '${task.claim.owner}'.`);
+	}
+	return { ...task, claim: createTaskClaim(owner, leaseMs, now) };
+}
+
+export function releaseTaskClaim<T extends TeamTaskState>(task: T, owner: string, token: string, now = new Date()): T {
+	if (!canUseTaskClaim(task, owner, token, now)) {
+		throw new Error(`Task '${task.id}' claim is not held by '${owner}' or has expired.`);
+	}
+	return { ...task, claim: undefined };
+}
+
+export function transitionClaimedTaskStatus<T extends TeamTaskState>(task: T, owner: string, token: string, status: T["status"], now = new Date()): T {
+	if (!canUseTaskClaim(task, owner, token, now)) {
+		throw new Error(`Task '${task.id}' claim is not held by '${owner}' or has expired.`);
+	}
+	return { ...task, status };
+}

package/src/state/types.ts

@@ -1,285 +1,285 @@
-import type { TeamRunStatus, TeamTaskStatus } from "./contracts.ts";
-import type { TaskClaimState } from "./task-claims.ts";
-import type { WorkerHeartbeatState } from "../runtime/worker-heartbeat.ts";
-import type { CrewAgentProgress } from "../runtime/crew-agent-runtime.ts";
-export type { TeamRunStatus, TeamTaskStatus } from "./contracts.ts";
-
-export interface ArtifactDescriptor {
-	kind: "plan" | "prompt" | "result" | "summary" | "log" | "diff" | "patch" | "progress" | "notepad" | "metadata";
-	path: string;
-	createdAt: string;
-	producer: string;
-	sizeBytes?: number;
-	contentHash?: string;
-	retention: "run" | "project" | "temporary";
-	expiresAt?: string;
-}
-
-export type TaskScope = "workspace" | "module" | "single_file" | "custom";
-export type GreenLevel = "none" | "targeted" | "package" | "workspace" | "merge_ready";
-
-export interface VerificationCommandResult {
-	cmd: string;
-	status: "passed" | "failed" | "not_run";
-	exitCode?: number | null;
-	outputArtifact?: ArtifactDescriptor;
-}
-
-export interface VerificationContract {
-	requiredGreenLevel: GreenLevel;
-	commands: string[];
-	allowManualEvidence: boolean;
-}
-
-export interface VerificationEvidence {
-	requiredGreenLevel: GreenLevel;
-	observedGreenLevel: GreenLevel;
-	satisfied: boolean;
-	commands: VerificationCommandResult[];
-	notes?: string;
-}
-
-export interface TaskOutputSchema {
-	/** Output format expected from the worker */
-	format: "json" | "markdown" | "text";
-	/** JTD or JSON Schema for validating JSON output (only when format="json") */
-	schema?: Record<string, unknown>;
-	/** Human-readable description of expected output */
-	description?: string;
-	/** Example of valid output (for prompt guidance) */
-	example?: string;
-}
-
-export interface TaskPacket {
-	objective: string;
-	scope: TaskScope;
-	scopePath?: string;
-	repo: string;
-	worktree?: string;
-	branchPolicy: string;
-	acceptanceTests: string[];
-	commitPolicy: string;
-	reportingContract: string;
-	escalationPolicy: string;
-	constraints: string[];
-	expectedArtifacts: string[];
-	verification: VerificationContract;
-	outputSchema?: TaskOutputSchema;
-}
-
-export type PolicyDecisionAction = "retry" | "reassign" | "escalate" | "block" | "notify" | "cleanup" | "closeout" | "fail";
-export type PolicyDecisionReason = "task_failed" | "worker_stale" | "green_unsatisfied" | "limit_exceeded" | "run_complete" | "mailbox_timeout" | "review_rejected" | "branch_stale" | "scope_mismatch" | "ineffective_worker";
-
-export interface PolicyDecision {
-	action: PolicyDecisionAction;
-	reason: PolicyDecisionReason;
-	message: string;
-	taskId?: string;
-	createdAt: string;
-}
-
-export interface TaskGraphNode {
-	taskId: string;
-	parentId?: string;
-	children: string[];
-	dependencies: string[];
-	queue: "ready" | "blocked" | "running" | "done";
-	sessionForkFrom?: string;
-}
-
-export interface AsyncRunState {
-	pid?: number;
-	logPath: string;
-	spawnedAt: string;
-}
-
-export interface RuntimeResolutionState {
-	kind: "scaffold" | "child-process" | "live-session";
-	requestedMode: "auto" | "scaffold" | "child-process" | "live-session";
-	safety: "trusted" | "explicit_dry_run" | "blocked";
-	available: boolean;
-	fallback?: "scaffold" | "child-process" | "live-session";
-	reason?: string;
-	resolvedAt: string;
-}
-
-export interface WorkerExitStatus {
-	exitCode: number | null;
-	cancelled: boolean;
-	timedOut: boolean;
-	killed: boolean;
-	signal?: string;
-	cleanupErrors: string[];
-	finalDrainMs: number;
-}
-
-export interface OperationTerminalEvidence {
-	operation: "worker" | "tool" | "model";
-	status: "cancelled" | "failed" | "completed";
-	startedAt?: string;
-	finishedAt: string;
-	attemptId?: string;
-	reason?: {
-		code: string;
-		message: string;
-	};
-	exitStatus?: WorkerExitStatus;
-}
-
-export interface PlanApprovalState {
-	required: boolean;
-	status: "pending" | "approved" | "cancelled";
-	requestedAt: string;
-	updatedAt: string;
-	approvedAt?: string;
-	cancelledAt?: string;
-	planTaskId?: string;
-	planArtifactPath?: string;
-}
-
-export type CrewActivityState = "active" | "active_long_running" | "needs_attention" | "stale";
-export type CrewAttentionReason = "idle" | "tool_failures" | "completion_guard" | "heartbeat_stale" | "plan_approval_pending";
-
-export interface CrewAttentionEventData {
-	activityState: CrewActivityState;
-	reason: CrewAttentionReason;
-	elapsedMs?: number;
-	taskId?: string;
-	agentName?: string;
-	suggestedAction?: string;
-	observedTools?: string[];
-}
-
-export interface TeamRunManifest {
-	schemaVersion: 1;
-	runId: string;
-	team: string;
-	workflow?: string;
-	goal: string;
-	status: TeamRunStatus;
-	workspaceMode: "single" | "worktree";
-	createdAt: string;
-	updatedAt: string;
-	cwd: string;
-	stateRoot: string;
-	artifactsRoot: string;
-	tasksPath: string;
-	eventsPath: string;
-	artifacts: ArtifactDescriptor[];
-	async?: AsyncRunState;
-	planApproval?: PlanApprovalState;
-	/** Pi session that created the run, when available. Used to prevent cross-session destructive actions. */
-	ownerSessionId?: string;
-	/** pi-crew skill override selected when the run was created. false disables injected skill instructions. */
-	skillOverride?: string[] | false;
-	/** Resolved runtime/safety mode used for execution. Optional for backward compatibility with older manifests. */
-	runtimeResolution?: RuntimeResolutionState;
-	/** Effective run config snapshot used by async background workers. Optional for backward compatibility. */
-	runConfig?: unknown;
-	summary?: string;
-	policyDecisions?: PolicyDecision[];
-}
-
-export interface UsageState {
-	input?: number;
-	output?: number;
-	cacheRead?: number;
-	cacheWrite?: number;
-	cost?: number;
-	turns?: number;
-}
-
-export interface ModelAttemptState {
-	model: string;
-	success: boolean;
-	exitCode?: number | null;
-	error?: string;
-}
-
-export interface ModelRoutingState {
-	requested?: string;
-	resolved: string;
-	fallbackChain: string[];
-	reason?: string;
-	usedAttempt: number;
-}
-
-export interface TaskWorktreeState {
-	path: string;
-	branch: string;
-	reused: boolean;
-}
-
-export interface TaskCheckpointState {
-	phase: "started" | "child-spawned" | "child-stdout-final" | "artifact-written";
-	updatedAt: string;
-	childPid?: number;
-}
-
-export interface TaskAttemptState {
-	attemptId?: string;
-	startedAt: string;
-	endedAt?: string;
-	error?: string;
-}
-
-export interface TeamTaskState {
-	id: string;
-	runId: string;
-	stepId?: string;
-	role: string;
-	agent: string;
-	title: string;
-	displayName?: string;
-	status: TeamTaskStatus;
-	dependsOn: string[];
-	cwd: string;
-	worktree?: TaskWorktreeState;
-	promptArtifact?: ArtifactDescriptor;
-	resultArtifact?: ArtifactDescriptor;
-	logArtifact?: ArtifactDescriptor;
-	transcriptArtifact?: ArtifactDescriptor;
-	startedAt?: string;
-	finishedAt?: string;
-	exitCode?: number | null;
-	model?: string;
-	modelAttempts?: ModelAttemptState[];
-	modelRouting?: ModelRoutingState;
-	usage?: UsageState;
-	jsonEvents?: number;
-	agentProgress?: CrewAgentProgress;
-	error?: string;
-	claim?: TaskClaimState;
-	heartbeat?: WorkerHeartbeatState;
-	checkpoint?: TaskCheckpointState;
-	attempts?: TaskAttemptState[];
-	workerExitStatus?: WorkerExitStatus;
-	terminalEvidence?: OperationTerminalEvidence[];
-	taskPacket?: TaskPacket;
-	verification?: VerificationEvidence;
-	graph?: TaskGraphNode;
-	adaptive?: {
-		phase: string;
-		task: string;
-	};
-	policy?: {
-		retryCount?: number;
-		lastDecision?: PolicyDecision;
-	};
-	controlReservation?: ControlReservation;
-
-	/** Structured diagnostics per task (ASI pattern from pi-autoresearch). */
-	diagnostics?: Record<string, unknown>;
-
-	/** Segment counter for task retry isolation. Default 0 (first attempt). Incremented on retry. */
-	segment?: number;
-
-	/** Parsed metric key-values from worker output (CREW_METRIC lines). */
-	metrics?: Record<string, number>;
-}
-
-export interface ControlReservation {
-	reservedAt: string;
-	controllerId: string;
-	acceptsControlEvents: boolean;
-}
+import type { TeamRunStatus, TeamTaskStatus } from "./contracts.ts";
+import type { TaskClaimState } from "./task-claims.ts";
+import type { WorkerHeartbeatState } from "../runtime/worker-heartbeat.ts";
+import type { CrewAgentProgress } from "../runtime/crew-agent-runtime.ts";
+export type { TeamRunStatus, TeamTaskStatus } from "./contracts.ts";
+
+export interface ArtifactDescriptor {
+	kind: "plan" | "prompt" | "result" | "summary" | "log" | "diff" | "patch" | "progress" | "notepad" | "metadata";
+	path: string;
+	createdAt: string;
+	producer: string;
+	sizeBytes?: number;
+	contentHash?: string;
+	retention: "run" | "project" | "temporary";
+	expiresAt?: string;
+}
+
+export type TaskScope = "workspace" | "module" | "single_file" | "custom";
+export type GreenLevel = "none" | "targeted" | "package" | "workspace" | "merge_ready";
+
+export interface VerificationCommandResult {
+	cmd: string;
+	status: "passed" | "failed" | "not_run";
+	exitCode?: number | null;
+	outputArtifact?: ArtifactDescriptor;
+}
+
+export interface VerificationContract {
+	requiredGreenLevel: GreenLevel;
+	commands: string[];
+	allowManualEvidence: boolean;
+}
+
+export interface VerificationEvidence {
+	requiredGreenLevel: GreenLevel;
+	observedGreenLevel: GreenLevel;
+	satisfied: boolean;
+	commands: VerificationCommandResult[];
+	notes?: string;
+}
+
+export interface TaskOutputSchema {
+	/** Output format expected from the worker */
+	format: "json" | "markdown" | "text";
+	/** JTD or JSON Schema for validating JSON output (only when format="json") */
+	schema?: Record<string, unknown>;
+	/** Human-readable description of expected output */
+	description?: string;
+	/** Example of valid output (for prompt guidance) */
+	example?: string;
+}
+
+export interface TaskPacket {
+	objective: string;
+	scope: TaskScope;
+	scopePath?: string;
+	repo: string;
+	worktree?: string;
+	branchPolicy: string;
+	acceptanceTests: string[];
+	commitPolicy: string;
+	reportingContract: string;
+	escalationPolicy: string;
+	constraints: string[];
+	expectedArtifacts: string[];
+	verification: VerificationContract;
+	outputSchema?: TaskOutputSchema;
+}
+
+export type PolicyDecisionAction = "retry" | "reassign" | "escalate" | "block" | "notify" | "cleanup" | "closeout" | "fail";
+export type PolicyDecisionReason = "task_failed" | "worker_stale" | "green_unsatisfied" | "limit_exceeded" | "run_complete" | "mailbox_timeout" | "review_rejected" | "branch_stale" | "scope_mismatch" | "ineffective_worker";
+
+export interface PolicyDecision {
+	action: PolicyDecisionAction;
+	reason: PolicyDecisionReason;
+	message: string;
+	taskId?: string;
+	createdAt: string;
+}
+
+export interface TaskGraphNode {
+	taskId: string;
+	parentId?: string;
+	children: string[];
+	dependencies: string[];
+	queue: "ready" | "blocked" | "running" | "done";
+	sessionForkFrom?: string;
+}
+
+export interface AsyncRunState {
+	pid?: number;
+	logPath: string;
+	spawnedAt: string;
+}
+
+export interface RuntimeResolutionState {
+	kind: "scaffold" | "child-process" | "live-session";
+	requestedMode: "auto" | "scaffold" | "child-process" | "live-session";
+	safety: "trusted" | "explicit_dry_run" | "blocked";
+	available: boolean;
+	fallback?: "scaffold" | "child-process" | "live-session";
+	reason?: string;
+	resolvedAt: string;
+}
+
+export interface WorkerExitStatus {
+	exitCode: number | null;
+	cancelled: boolean;
+	timedOut: boolean;
+	killed: boolean;
+	signal?: string;
+	cleanupErrors: string[];
+	finalDrainMs: number;
+}
+
+export interface OperationTerminalEvidence {
+	operation: "worker" | "tool" | "model";
+	status: "cancelled" | "failed" | "completed";
+	startedAt?: string;
+	finishedAt: string;
+	attemptId?: string;
+	reason?: {
+		code: string;
+		message: string;
+	};
+	exitStatus?: WorkerExitStatus;
+}
+
+export interface PlanApprovalState {
+	required: boolean;
+	status: "pending" | "approved" | "cancelled";
+	requestedAt: string;
+	updatedAt: string;
+	approvedAt?: string;
+	cancelledAt?: string;
+	planTaskId?: string;
+	planArtifactPath?: string;
+}
+
+export type CrewActivityState = "active" | "active_long_running" | "needs_attention" | "stale";
+export type CrewAttentionReason = "idle" | "tool_failures" | "completion_guard" | "heartbeat_stale" | "plan_approval_pending";
+
+export interface CrewAttentionEventData {
+	activityState: CrewActivityState;
+	reason: CrewAttentionReason;
+	elapsedMs?: number;
+	taskId?: string;
+	agentName?: string;
+	suggestedAction?: string;
+	observedTools?: string[];
+}
+
+export interface TeamRunManifest {
+	schemaVersion: 1;
+	runId: string;
+	team: string;
+	workflow?: string;
+	goal: string;
+	status: TeamRunStatus;
+	workspaceMode: "single" | "worktree";
+	createdAt: string;
+	updatedAt: string;
+	cwd: string;
+	stateRoot: string;
+	artifactsRoot: string;
+	tasksPath: string;
+	eventsPath: string;
+	artifacts: ArtifactDescriptor[];
+	async?: AsyncRunState;
+	planApproval?: PlanApprovalState;
+	/** Pi session that created the run, when available. Used to prevent cross-session destructive actions. */
+	ownerSessionId?: string;
+	/** pi-crew skill override selected when the run was created. false disables injected skill instructions. */
+	skillOverride?: string[] | false;
+	/** Resolved runtime/safety mode used for execution. Optional for backward compatibility with older manifests. */
+	runtimeResolution?: RuntimeResolutionState;
+	/** Effective run config snapshot used by async background workers. Optional for backward compatibility. */
+	runConfig?: unknown;
+	summary?: string;
+	policyDecisions?: PolicyDecision[];
+}
+
+export interface UsageState {
+	input?: number;
+	output?: number;
+	cacheRead?: number;
+	cacheWrite?: number;
+	cost?: number;
+	turns?: number;
+}
+
+export interface ModelAttemptState {
+	model: string;
+	success: boolean;
+	exitCode?: number | null;
+	error?: string;
+}
+
+export interface ModelRoutingState {
+	requested?: string;
+	resolved: string;
+	fallbackChain: string[];
+	reason?: string;
+	usedAttempt: number;
+}
+
+export interface TaskWorktreeState {
+	path: string;
+	branch: string;
+	reused: boolean;
+}
+
+export interface TaskCheckpointState {
+	phase: "started" | "child-spawned" | "child-stdout-final" | "artifact-written";
+	updatedAt: string;
+	childPid?: number;
+}
+
+export interface TaskAttemptState {
+	attemptId?: string;
+	startedAt: string;
+	endedAt?: string;
+	error?: string;
+}
+
+export interface TeamTaskState {
+	id: string;
+	runId: string;
+	stepId?: string;
+	role: string;
+	agent: string;
+	title: string;
+	displayName?: string;
+	status: TeamTaskStatus;
+	dependsOn: string[];
+	cwd: string;
+	worktree?: TaskWorktreeState;
+	promptArtifact?: ArtifactDescriptor;
+	resultArtifact?: ArtifactDescriptor;
+	logArtifact?: ArtifactDescriptor;
+	transcriptArtifact?: ArtifactDescriptor;
+	startedAt?: string;
+	finishedAt?: string;
+	exitCode?: number | null;
+	model?: string;
+	modelAttempts?: ModelAttemptState[];
+	modelRouting?: ModelRoutingState;
+	usage?: UsageState;
+	jsonEvents?: number;
+	agentProgress?: CrewAgentProgress;
+	error?: string;
+	claim?: TaskClaimState;
+	heartbeat?: WorkerHeartbeatState;
+	checkpoint?: TaskCheckpointState;
+	attempts?: TaskAttemptState[];
+	workerExitStatus?: WorkerExitStatus;
+	terminalEvidence?: OperationTerminalEvidence[];
+	taskPacket?: TaskPacket;
+	verification?: VerificationEvidence;
+	graph?: TaskGraphNode;
+	adaptive?: {
+		phase: string;
+		task: string;
+	};
+	policy?: {
+		retryCount?: number;
+		lastDecision?: PolicyDecision;
+	};
+	controlReservation?: ControlReservation;
+
+	/** Structured diagnostics per task (ASI pattern from pi-autoresearch). */
+	diagnostics?: Record<string, unknown>;
+
+	/** Segment counter for task retry isolation. Default 0 (first attempt). Incremented on retry. */
+	segment?: number;
+
+	/** Parsed metric key-values from worker output (CREW_METRIC lines). */
+	metrics?: Record<string, number>;
+}
+
+export interface ControlReservation {
+	reservedAt: string;
+	controllerId: string;
+	acceptsControlEvents: boolean;
+}