@gajae-code/coding-agent 0.11.0 → 0.11.2

package/dist/types/gjc-runtime/goal-mode-request.d.ts

@@ -1,4 +1,4 @@
-import { type Goal } from "../goals/state";
+import { type Goal, type GoalProvenance } from "../goals/state";
 export declare const GJC_SESSION_FILE_ENV = "GJC_SESSION_FILE";
 export declare const GJC_SESSION_ID_ENV = "GJC_SESSION_ID";
 export declare const GJC_SESSION_CWD_ENV = "GJC_SESSION_CWD";
@@ -11,6 +11,9 @@ export interface PendingGoalModeRequest {
     objective: string;
     createdAt: string;
     goalsPath?: string;
+    provenance: Extract<GoalProvenance, {
+        source: "ultragoal";
+    }>;
     /**
      * Session id that produced this request (from GJC_SESSION_ID). When present,
      * only the originating session may consume it, so concurrent sessions sharing
@@ -33,16 +36,23 @@ export declare function isUltragoalCreateGoalsInvocation(args: readonly string[]
 export declare function readUltragoalGjcObjective(cwd: string, sessionId?: string | null): Promise<{
     objective: string;
     goalsPath: string;
+    provenance: Extract<GoalProvenance, {
+        source: "ultragoal";
+    }>;
 }>;
 export declare function writePendingGoalModeRequest(input: {
     cwd: string;
     objective: string;
     goalsPath?: string;
     sessionId?: string | null;
+    provenance?: Extract<GoalProvenance, {
+        source: "ultragoal";
+    }>;
 }): Promise<PendingGoalModeRequest>;
 export declare function writeCurrentSessionGoalModeState(input: {
     sessionFile?: string | null;
     objective: string;
+    provenance?: Goal["provenance"];
 }): Promise<CurrentSessionGoalModeWriteResult>;
 export declare function consumePendingGoalModeRequest(cwd: string, currentSessionId?: string | null): Promise<PendingGoalModeRequest | null>;
 export declare function buildGjcRuntimeSessionEnv(input: {

package/dist/types/gjc-runtime/launch-worktree.d.ts

@@ -37,10 +37,12 @@ export declare function ensureLaunchWorktree(plan: GjcLaunchWorktreePlan | {
     enabled: false;
 };
 export declare function ensureReusableNodeModules(sourceRoot: string, worktreePath: string): "symlink" | "present" | "missing";
-export declare function prepareLaunchWorktree(cwd: string, args: string[]): {
+/** Result of {@link prepareLaunchWorktree}: the effective working directory, remaining args, and resolved worktree plan. */
+export interface PreparedLaunchWorktree {
     cwd: string;
     args: string[];
     worktree: GjcLaunchWorktreeResult | {
         enabled: false;
     };
-};
+}
+export declare function prepareLaunchWorktree(cwd: string, args: string[]): PreparedLaunchWorktree;

package/dist/types/gjc-runtime/linux-proc.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared helpers for reading Linux `/proc/<pid>/stat` process start time.
+ *
+ * The `comm` field (field 2, wrapped in parentheses) may itself contain spaces
+ * and parentheses, so the only robust anchor is the *last* `)` in the stat
+ * string. Field 22 (the process start time in clock ticks since boot) is the
+ * 20th whitespace-separated token after that closing paren (index 19).
+ *
+ * Every caller previously parsed this format independently, with subtly
+ * different failure handling. This module fails closed: any malformed input
+ * (missing `)`, non-numeric field 22, unreadable `/proc` file, non-Linux
+ * platform) yields `null` rather than an inconsistent sentinel.
+ */
+/**
+ * Parse field 22 (process start time, in clock ticks since boot) from one
+ * `/proc/<pid>/stat` record. Returns the raw numeric token, or `null` when the
+ * record shape is malformed or field 22 is absent/non-numeric.
+ */
+export declare function parseLinuxProcStartTime(stat: string | null | undefined): string | null;
+/**
+ * Read `/proc/<pid>/stat` synchronously and return the parsed start time.
+ * Returns `null` on non-Linux platforms, unreadable files, or malformed input.
+ */
+export declare function readLinuxProcStartTimeSync(pid: number): string | null;
+/**
+ * Read `/proc/<pid>/stat` asynchronously and return the parsed start time.
+ * Returns `null` on non-Linux platforms, unreadable files, or malformed input.
+ */
+export declare function readLinuxProcStartTime(pid: number): Promise<string | null>;

package/dist/types/gjc-runtime/session-resolution.d.ts

@@ -8,8 +8,8 @@ export interface SessionIdSources {
     envSessionId?: string | undefined;
 }
 export declare class SessionResolutionError extends Error {
-    readonly code: "blank_flag" | "no_session" | "ambiguous" | "missing_for_write";
-    constructor(message: string, code: "blank_flag" | "no_session" | "ambiguous" | "missing_for_write");
+    readonly code: "blank_flag" | "unsafe_session" | "no_session" | "ambiguous" | "missing_for_write";
+    constructor(message: string, code: "blank_flag" | "unsafe_session" | "no_session" | "ambiguous" | "missing_for_write");
 }
 interface ResolvedFromSources {
     gjcSessionId: string;

package/dist/types/gjc-runtime/state-migrations.d.ts

@@ -7,7 +7,7 @@ export interface MigrateAndPersistLegacyStateArgs {
     cwd: string;
     skill: string;
     statePath: string;
-    sessionId?: string;
+    sessionId: string;
 }
 export interface MigrateAndPersistLegacyStateResult {
     migrated: boolean;

package/dist/types/gjc-runtime/state-writer.d.ts

@@ -21,7 +21,7 @@ export interface StateWriterReceiptContext {
     skill: CanonicalGjcWorkflowSkill;
     owner: WorkflowStateMutationOwner;
     command: string;
-    sessionId?: string;
+    sessionId: string;
     mutationId?: string;
     nowIso?: string;
     verb?: string;
@@ -62,6 +62,7 @@ export interface GuardedStateWriterOptions extends StateWriterOptions {
     policy: StateWritePolicy;
     expectedRevision?: number;
     sourceRevision?: number;
+    lockHeld?: boolean;
 }
 export type GuardedWriteResult = {
     path: string;

package/dist/types/gjc-runtime/team-launch.d.ts

@@ -0,0 +1,59 @@
+import type { GjcTeamConfig, GjcTeamSnapshot, GjcTeamStartOptions, GjcTeamTask, GjcTeamWorker, GjcTeamWorkerCli, GjcTeamWorkerLifecycle, GjcTeamWorktreeMode } from "./team-runtime";
+/** Launch-specific option wiring kept separate from runtime dispatch. */
+export declare function withTeamLaunchTransport(options: GjcTeamStartOptions, mailboxDeliveryTransport: GjcTeamStartOptions["mailboxDeliveryTransport"]): GjcTeamStartOptions;
+/** @internal Exported for unit tests. */
+export declare function buildWorkerCommand(config: GjcTeamConfig, worker: GjcTeamWorker, platform?: NodeJS.Platform): string;
+interface GjcTmuxBinary {
+    command: string;
+    isPsmux: boolean;
+}
+interface GjcTmuxLeaderContext {
+    sessionName: string;
+    windowIndex: string;
+    leaderPaneId: string;
+    target: string;
+}
+export interface GjcTeamLaunchRuntime {
+    maxWorkers: number;
+    resolveWorkerCliPlan(workerCount: number, env: NodeJS.ProcessEnv): GjcTeamWorkerCli[];
+    resolveStateRoot(cwd: string, env: NodeJS.ProcessEnv): string;
+    sanitizeName(value: string): string;
+    makeTeamName(task: string, env: NodeJS.ProcessEnv): string;
+    teamDir(stateRoot: string, teamName: string): string;
+    resolveDefaultWorktreeMode(mode?: GjcTeamWorktreeMode): GjcTeamWorktreeMode;
+    resolveTmuxBinary(input: {
+        env: NodeJS.ProcessEnv;
+        platform: NodeJS.Platform;
+    }): GjcTmuxBinary;
+    readTmuxLeaderContext(tmuxCommand: string, env: NodeJS.ProcessEnv): GjcTmuxLeaderContext;
+    buildWorkers(workerCount: number, agentType: string, stateRoot: string): GjcTeamWorker[];
+    buildInitialTasks(task: string, workers: GjcTeamWorker[]): GjcTeamTask[];
+    ensureWorkerWorktree(cwd: string, dir: string, teamName: string, worker: GjcTeamWorker, mode: GjcTeamWorktreeMode, platform: NodeJS.Platform, isPsmux: boolean): Promise<GjcTeamWorker>;
+    rollbackCreatedWorktrees(workers: GjcTeamWorker[]): Promise<void>;
+    resolveWorkerCommand(cwd: string, env: NodeJS.ProcessEnv): string;
+    mailboxDirPath(dir: string, worker: string): string;
+    mailboxPath(dir: string, worker: string): string;
+    workerDir(dir: string, worker: string): string;
+    workerLifecyclePath(dir: string, worker: string): string;
+    writeJson(filePath: string, value: unknown): Promise<void>;
+    now(): string;
+    writePhase(dir: string, phase: "starting" | "running" | "failed"): Promise<void>;
+    writeTask(dir: string, task: GjcTeamTask): Promise<void>;
+    appendEvent(dir: string, event: {
+        type: string;
+        message: string;
+        data?: Record<string, unknown>;
+    }): Promise<unknown>;
+    appendTelemetry(dir: string, event: {
+        type: string;
+        message: string;
+        data?: Record<string, unknown>;
+    }): Promise<unknown>;
+    startTmuxSession(config: GjcTeamConfig, dir: string, dryRun: boolean, env: NodeJS.ProcessEnv): Promise<GjcTeamWorker[]>;
+    killWorkerPanes(config: GjcTeamConfig): void;
+    writeWorkerLifecycleForConfig(dir: string, config: GjcTeamConfig, state: "starting", updates: (worker: GjcTeamWorker) => Partial<GjcTeamWorkerLifecycle>): Promise<unknown>;
+    readSnapshot(teamName: string, cwd: string, env: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot>;
+}
+/** Creates persistent team state, worktrees, and tmux worker panes. */
+export declare function startGjcTeamLaunch(runtime: GjcTeamLaunchRuntime, options: GjcTeamStartOptions): Promise<GjcTeamSnapshot>;
+export {};

package/dist/types/gjc-runtime/team-notify.d.ts

@@ -0,0 +1,45 @@
+import type { GjcTeamConfig, GjcTeamMailboxMessage } from "./team-runtime";
+import type { GjcTeamMailboxDeliveryInput, GjcTeamMailboxDeliveryResult, GjcTeamMailboxDeliveryTransport, GjcTeamNotification, GjcTeamNotificationDeliveryState, GjcTeamNotificationSummary } from "./team-store";
+/** Runtime-owned filesystem and participant operations used by notification delivery. */
+export interface TeamNotificationRuntime {
+    findTeamDir(teamName: string, cwd: string, env: NodeJS.ProcessEnv): Promise<string>;
+    readConfig(dir: string): Promise<GjcTeamConfig>;
+    assertKnownParticipant(config: GjcTeamConfig, participant: string): void;
+    messageId(input: {
+        teamName: string;
+        fromWorker: string;
+        toWorker: string;
+        body: string;
+        idempotencyKey?: string;
+        createdKey: string;
+    }): string;
+    messageNotificationId(teamName: string, recipient: string, messageId: string): string;
+    now(): string;
+    randomId(): string;
+    appendEvent(dir: string, event: {
+        type: string;
+        worker?: string;
+        message?: string;
+        data?: Record<string, unknown>;
+    }): Promise<void>;
+    readMailbox(dir: string, worker: string): Promise<{
+        messages: GjcTeamMailboxMessage[];
+    }>;
+    writeMailboxMessage(dir: string, worker: string, message: GjcTeamMailboxMessage): Promise<GjcTeamMailboxMessage>;
+    listNotifications(dir: string): Promise<GjcTeamNotification[]>;
+    readNotification(dir: string, id: string): Promise<GjcTeamNotification>;
+    writeNotification(dir: string, notification: GjcTeamNotification): Promise<GjcTeamNotification>;
+}
+export declare function deliverTeamMailboxMessage(transport: GjcTeamMailboxDeliveryTransport | undefined, input: GjcTeamMailboxDeliveryInput): Promise<GjcTeamMailboxDeliveryResult | null>;
+export declare function emptyTeamNotificationSummary(): GjcTeamNotificationSummary;
+export declare function isReplayEligibleTeamNotification(state: GjcTeamNotificationDeliveryState): boolean;
+export declare function summarizeTeamNotifications(notifications: GjcTeamNotification[]): GjcTeamNotificationSummary;
+export declare function createTeamMessageNotification(runtime: TeamNotificationRuntime, dir: string, teamName: string, message: GjcTeamMailboxMessage, state?: GjcTeamNotificationDeliveryState): Promise<GjcTeamNotification>;
+export declare function reconcileTeamNotifications(runtime: TeamNotificationRuntime, dir: string, config: GjcTeamConfig): Promise<GjcTeamNotificationSummary>;
+export declare function replayTeamNotifications(runtime: TeamNotificationRuntime, teamName: string, cwd: string, env: NodeJS.ProcessEnv, transport?: GjcTeamMailboxDeliveryTransport): Promise<{
+    notifications: GjcTeamNotification[];
+    summary: GjcTeamNotificationSummary;
+}>;
+export declare function sendTeamMessage(runtime: TeamNotificationRuntime, teamName: string, fromWorker: string, toWorker: string, body: string, cwd: string, env: NodeJS.ProcessEnv, idempotencyKey?: string, transport?: GjcTeamMailboxDeliveryTransport): Promise<GjcTeamMailboxMessage>;
+export declare function listTeamMailbox(runtime: TeamNotificationRuntime, teamName: string, worker: string, cwd: string, env: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage[]>;
+export declare function markTeamMailboxMessage(runtime: TeamNotificationRuntime, teamName: string, worker: string, messageId: string, field: "delivered_at" | "notified_at", cwd: string, env: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage>;

package/dist/types/gjc-runtime/team-runtime.d.ts

@@ -1,10 +1,7 @@
 import type { WorkflowHudSummary } from "../skill-state/active-state";
 import type { GcPidProbe, GcRecord } from "./gc-runtime";
-export type GjcTeamPhase = "starting" | "running" | "awaiting_integration" | "complete" | "failed" | "cancelled";
-export type GjcTeamTaskStatus = "pending" | "blocked" | "in_progress" | "completed" | "failed";
-export type GjcWorkerStatusState = "idle" | "working" | "blocked" | "done" | "failed" | "draining" | "unknown";
-export type GjcTeamWorkerLifecycleState = "starting" | "ready" | "working" | "draining" | "stopped" | "failed" | "unknown";
-export type GjcTeamShutdownMode = "graceful" | "force" | "abort";
+import type { GjcTeamApiClaimResult, GjcTeamMailboxDeliveryTransport, GjcTeamNotification, GjcTeamNotificationSummary, GjcTeamTask, GjcTeamTaskMetadataInput, GjcTeamTaskStatus } from "./team-store";
+export type { GjcTeamApiClaimResult, GjcTeamMailboxDeliveryInput, GjcTeamMailboxDeliveryResult, GjcTeamMailboxDeliveryTransport, GjcTeamMailboxDeliveryTransportKind, GjcTeamNotification, GjcTeamNotificationDeliveryState, GjcTeamNotificationSummary, GjcTeamPaneAttemptResult, GjcTeamTask, GjcTeamTaskClaim, GjcTeamTaskMetadataInput, GjcTeamTaskStatus, } from "./team-store";
 export declare const GJC_TEAM_DEFAULT_WORKERS = 3;
 export declare const GJC_TEAM_MAX_WORKERS = 20;
 export type GjcTeamWorkerCli = "gjc";
@@ -31,53 +28,10 @@ export interface GjcTeamWorker {
     worktree_base_ref?: string;
     team_state_root?: string;
 }
-export interface GjcTeamTaskClaim {
-    owner: string;
-    token: string;
-    leased_until: string;
-}
-export type GjcTeamTaskCompletionEvidenceKind = "command" | "inspection" | "artifact";
-export type GjcTeamTaskCompletionEvidenceStatus = "passed" | "failed" | "not_run" | "verified" | "rejected";
-export interface GjcTeamTaskCompletionEvidenceItem {
-    kind: GjcTeamTaskCompletionEvidenceKind;
-    status: GjcTeamTaskCompletionEvidenceStatus;
-    summary: string;
-    command?: string;
-    artifact?: string;
-    location?: string;
-    output?: string;
-}
-export interface GjcTeamTaskCompletionEvidence {
-    summary: string;
-    items: GjcTeamTaskCompletionEvidenceItem[];
-    files?: string[];
-    notes?: string;
-    recorded_by: string;
-    recorded_at: string;
-}
-export interface GjcTeamTask {
-    id: string;
-    subject: string;
-    description: string;
-    title: string;
-    objective: string;
-    status: GjcTeamTaskStatus;
-    assignee?: string;
-    owner?: string;
-    result?: string;
-    completion_evidence?: GjcTeamTaskCompletionEvidence;
-    error?: string;
-    blocked_by?: string[];
-    depends_on?: string[];
-    lane?: string;
-    required_role?: string;
-    allowed_roles?: string[];
-    version: number;
-    claim?: GjcTeamTaskClaim;
-    created_at: string;
-    updated_at: string;
-    completed_at?: string;
-}
+export type GjcTeamPhase = "starting" | "running" | "awaiting_integration" | "complete" | "failed" | "cancelled";
+export type GjcWorkerStatusState = "idle" | "working" | "blocked" | "done" | "failed" | "draining" | "unknown";
+export type GjcTeamWorkerLifecycleState = "starting" | "ready" | "working" | "draining" | "stopped" | "failed" | "unknown";
+export type GjcTeamShutdownMode = "graceful" | "force" | "abort";
 export type GjcTeamWorktreeMode = {
     enabled: false;
 } | {
@@ -98,6 +52,7 @@ export interface GjcTeamConfig {
     worker_count: number;
     max_workers: number;
     state_root: string;
+    gjc_session_id?: string;
     worker_command: string;
     worker_cli_plan: GjcTeamWorkerCli[];
     tmux_command: string;
@@ -144,55 +99,6 @@ export interface GjcTeamWorkerLifecycle {
     shutdown_ack_status?: string;
     shutdown_mode?: GjcTeamShutdownMode;
 }
-export type GjcTeamNotificationDeliveryState = "pending" | "sent" | "queued" | "deferred" | "failed" | "delivered" | "acknowledged";
-export type GjcTeamPaneAttemptResult = "sent" | "queued" | "deferred" | "failed";
-export type GjcTeamMailboxDeliveryTransportKind = "sdk" | "pane";
-export interface GjcTeamNotification {
-    id: string;
-    kind: "mailbox_message" | "worker_lifecycle" | "invalid_attempt";
-    team_name: string;
-    recipient: string;
-    source: {
-        type: "message" | "task" | "worker" | "event";
-        id: string;
-    };
-    idempotency_key?: string;
-    delivery_state: GjcTeamNotificationDeliveryState;
-    pane_attempt_result?: GjcTeamPaneAttemptResult;
-    pane_attempt_reason?: string;
-    pane_attempt_at?: string;
-    created_at: string;
-    updated_at: string;
-    replay_count: number;
-}
-export interface GjcTeamMailboxDeliveryInput {
-    team_name: string;
-    state_dir: string;
-    config: GjcTeamConfig;
-    notification: GjcTeamNotification;
-    message: GjcTeamMailboxMessage;
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-}
-export type GjcTeamMailboxDeliveryResult = {
-    transport: "sdk";
-    state: GjcTeamNotificationDeliveryState;
-    reason?: string;
-} | {
-    transport: "pane";
-    state: GjcTeamPaneAttemptResult;
-    reason?: string;
-};
-export interface GjcTeamMailboxDeliveryTransport {
-    deliverMailboxMessage(input: GjcTeamMailboxDeliveryInput): Promise<GjcTeamMailboxDeliveryResult | null>;
-}
-export declare function setGjcTeamMailboxDeliveryTransport(transport: GjcTeamMailboxDeliveryTransport | undefined): () => void;
-export declare function setGjcTeamMailboxDeliveryTransportForTest(transport: GjcTeamMailboxDeliveryTransport | undefined): () => void;
-export interface GjcTeamNotificationSummary {
-    total: number;
-    replay_eligible: number;
-    by_state: Record<GjcTeamNotificationDeliveryState, number>;
-}
 export interface GjcTeamSnapshot {
     team_name: string;
     display_name: string;
@@ -224,13 +130,6 @@ export interface GjcTeamStartOptions {
     platform?: NodeJS.Platform;
     mailboxDeliveryTransport?: GjcTeamMailboxDeliveryTransport;
 }
-export interface GjcTeamApiClaimResult {
-    ok: boolean;
-    task?: GjcTeamTask;
-    worker_id?: string;
-    claim_token?: string;
-    reason?: string;
-}
 export type GjcTeamLivenessRecoveryReason = "claim_expired" | "stale_heartbeat" | "missing_pane" | "worker_lifecycle_failed" | "worker_lifecycle_stopped";
 export interface GjcTeamRecoveredClaim {
     task_id: string;
@@ -276,13 +175,13 @@ export interface GjcTeamTraceEvent {
     evidence_refs?: string[];
     data?: Record<string, unknown>;
 }
-interface WorkerStatusFile {
+export interface WorkerStatusFile {
     state: GjcWorkerStatusState;
     current_task_id?: string;
     reason?: string;
     updated_at: string;
 }
-interface WorkerHeartbeatFile {
+export interface WorkerHeartbeatFile {
     pid: number;
     last_turn_at: string;
     turn_count: number;
@@ -297,7 +196,19 @@ export interface GjcWorkerIntegrationAttemptRequestResult {
     head?: string | null;
     status?: GjcWorkerCheckpointClassification["kind"];
 }
+export interface GjcWorkerIntegrationAttemptOptions {
+    signal?: AbortSignal;
+}
 export declare const GJC_TEAM_API_OPERATIONS: readonly ["send-message", "broadcast", "mailbox-list", "mailbox-mark-delivered", "mailbox-mark-notified", "notification-list", "notification-read", "notification-replay", "notification-mark-pane-attempt", "worker-startup-ack", "create-task", "read-task", "list-tasks", "update-task", "claim-task", "transition-task-status", "transition-task", "release-task-claim", "read-config", "read-manifest", "read-worker-status", "update-worker-status", "read-worker-heartbeat", "recover-stale-claims", "update-worker-heartbeat", "write-worker-inbox", "write-worker-identity", "append-event", "read-events", "read-traces", "await-event", "write-shutdown-request", "read-shutdown-ack", "read-monitor-snapshot", "write-monitor-snapshot", "read-task-approval", "write-task-approval"];
+export interface GjcTeamRuntimeTestSeams {
+    nowMs?: () => number;
+    continuationTmuxDispatch?: (command: string, args: readonly string[]) => {
+        exitCode?: number;
+    };
+    continuationBeforeDispatch?: () => Promise<void>;
+}
+/** @internal Test-only seam; production code leaves the real clock and tmux dispatch intact. */
+export declare function __setGjcTeamRuntimeTestSeamsForTests(seams: GjcTeamRuntimeTestSeams | undefined): void;
 export declare function resolveGjcTeamStateRoot(cwd?: string, env?: NodeJS.ProcessEnv): string;
 /** @internal */
 export declare function listTeamWorkerGcRecords(teamRoot: string, probe: GcPidProbe): Promise<GcRecord[]>;
@@ -305,7 +216,6 @@ export declare function listTeamWorkerGcRecords(teamRoot: string, probe: GcPidPr
 export declare function pruneTeamWorkerGcRecord(record: GcRecord, probe: GcPidProbe): Promise<boolean>;
 export declare function persistGjcTeamModeStateSummary(snapshot: GjcTeamSnapshot, cwd?: string): Promise<void>;
 export declare function recoverGjcTeamStaleClaims(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamLivenessRecoveryResult>;
-type GjcTeamTaskMetadataInput = Partial<Pick<GjcTeamTask, "owner" | "lane" | "required_role" | "allowed_roles" | "depends_on" | "blocked_by">>;
 export declare function resolveWorkerWorktreePath(input: {
     repoRoot: string;
     stateDir: string;
@@ -315,8 +225,7 @@ export declare function resolveWorkerWorktreePath(input: {
     isPsmux: boolean;
 }): string;
 export declare function resolveGjcWorkerCommand(cwd?: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, argv?: string[], execPath?: string): string;
-/** @internal Exported for unit tests. */
-export declare function buildWorkerCommand(config: GjcTeamConfig, worker: GjcTeamWorker, platform?: NodeJS.Platform): string;
+export { buildWorkerCommand } from "./team-launch";
 export type GjcWorkerCheckpointClassification = {
     kind: "clean";
     files: string[];
@@ -339,11 +248,11 @@ export declare function classifyGjcTeamCheckpointFiles(files: string[]): {
     protected: string[];
 };
 export declare function classifyWorkerCheckpointStatus(cwd: string): GjcWorkerCheckpointClassification;
-export declare function classifyWorkerCheckpointStatusAsync(cwd: string): Promise<GjcWorkerCheckpointClassification>;
+export declare function classifyWorkerCheckpointStatusAsync(cwd: string, signal?: AbortSignal): Promise<GjcWorkerCheckpointClassification>;
 export declare function startGjcTeam(options: GjcTeamStartOptions): Promise<GjcTeamSnapshot>;
 export declare function readGjcTeamSnapshot(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv, options?: GjcTeamSnapshotOptions): Promise<GjcTeamSnapshot>;
 export declare function monitorGjcTeamSnapshot(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot>;
-export declare function requestGjcWorkerIntegrationAttempt(cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcWorkerIntegrationAttemptRequestResult>;
+export declare function requestGjcWorkerIntegrationAttempt(cwd?: string, env?: NodeJS.ProcessEnv, options?: GjcWorkerIntegrationAttemptOptions): Promise<GjcWorkerIntegrationAttemptRequestResult>;
 export declare function buildTeamHudSummary(snapshot: GjcTeamSnapshot, latestEvent?: GjcTeamEvent, latestMessage?: GjcTeamMailboxMessage): Promise<WorkflowHudSummary>;
 export declare function monitorGjcTeam(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot>;
 export declare function listGjcTeams(cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot[]>;
@@ -356,17 +265,17 @@ export declare function claimGjcTeamTask(teamName: string, workerId: string, cwd
 export declare function transitionGjcTeamTaskStatus(teamName: string, taskId: string, status: GjcTeamTaskStatus, cwd?: string, env?: NodeJS.ProcessEnv, claimToken?: string, workerId?: string, completionEvidenceInput?: unknown): Promise<GjcTeamTask>;
 export declare function transitionGjcTeamTask(teamName: string, taskId: string, status: GjcTeamTaskStatus | "complete", cwd?: string, env?: NodeJS.ProcessEnv, claimToken?: string, completionEvidenceInput?: unknown): Promise<GjcTeamTask>;
 export declare function releaseGjcTeamTaskClaim(teamName: string, taskId: string, claimToken: string, workerId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTask>;
-export declare function replayGjcTeamNotifications(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
+export declare function replayGjcTeamNotifications(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv, transport?: GjcTeamMailboxDeliveryTransport): Promise<{
     notifications: GjcTeamNotification[];
     summary: GjcTeamNotificationSummary;
 }>;
-export declare function sendGjcTeamMessage(teamName: string, fromWorker: string, toWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv, idempotencyKey?: string): Promise<GjcTeamMailboxMessage>;
+export declare function sendGjcTeamMessage(teamName: string, fromWorker: string, toWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv, idempotencyKey?: string, transport?: GjcTeamMailboxDeliveryTransport): Promise<GjcTeamMailboxMessage>;
 export declare function broadcastGjcTeamMessage(teamName: string, fromWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv, idempotencyKey?: string): Promise<GjcTeamMailboxMessage[]>;
 export declare function listGjcTeamMailbox(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage[]>;
 export declare function markGjcTeamMailboxMessage(teamName: string, worker: string, messageId: string, field: "delivered_at" | "notified_at", cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamMailboxMessage>;
-export declare function readGjcWorkerStatus(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerStatusFile>;
+export declare const readGjcWorkerStatus: (teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv) => Promise<WorkerStatusFile>;
 export declare function updateGjcWorkerStatus(teamName: string, worker: string, status: GjcWorkerStatusState, cwd?: string, env?: NodeJS.ProcessEnv, currentTaskId?: string, reason?: string): Promise<WorkerStatusFile>;
-export declare function readGjcWorkerHeartbeat(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerHeartbeatFile | null>;
+export declare const readGjcWorkerHeartbeat: (teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv) => Promise<WorkerHeartbeatFile | null>;
 export declare function updateGjcWorkerHeartbeat(teamName: string, worker: string, heartbeat: WorkerHeartbeatFile, cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerHeartbeatFile>;
 export declare function writeGjcWorkerInbox(teamName: string, worker: string, content: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
     path: string;
@@ -384,7 +293,6 @@ export declare function readGjcMonitorSnapshot(teamName: string, cwd?: string, e
 export declare function writeGjcTaskApproval(teamName: string, taskId: string, approval: Record<string, unknown>, cwd?: string, env?: NodeJS.ProcessEnv): Promise<Record<string, unknown>>;
 export declare function readGjcTaskApproval(teamName: string, taskId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<Record<string, unknown> | null>;
 export declare function writeGjcShutdownRequest(teamName: string, worker: string, requestedBy: string, cwd?: string, env?: NodeJS.ProcessEnv, requestId?: string, mode?: GjcTeamShutdownMode, requestedAt?: string): Promise<Record<string, unknown>>;
-export declare function readGjcShutdownAck(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<Record<string, unknown> | null>;
+export declare const readGjcShutdownAck: (teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv) => Promise<Record<string, unknown> | null>;
 export declare function executeGjcTeamApiOperation(operation: string, input: Record<string, unknown>, cwd?: string, env?: NodeJS.ProcessEnv): Promise<unknown>;
 export declare function parseTeamLaunchArgs(argv: string[]): GjcTeamStartOptions;
-export {};

package/dist/types/gjc-runtime/team-store.d.ts

@@ -0,0 +1,160 @@
+import type { GjcTeamConfig, GjcTeamMailboxMessage } from "./team-runtime";
+export type GjcTeamNotificationDeliveryState = "pending" | "sent" | "queued" | "deferred" | "failed" | "delivered" | "acknowledged";
+export type GjcTeamPaneAttemptResult = "sent" | "queued" | "deferred" | "failed";
+export type GjcTeamMailboxDeliveryTransportKind = "sdk" | "pane";
+export interface GjcTeamNotification {
+    id: string;
+    kind: "mailbox_message" | "worker_lifecycle" | "invalid_attempt";
+    team_name: string;
+    recipient: string;
+    source: {
+        type: "message" | "task" | "worker" | "event";
+        id: string;
+    };
+    idempotency_key?: string;
+    delivery_state: GjcTeamNotificationDeliveryState;
+    pane_attempt_result?: GjcTeamPaneAttemptResult;
+    pane_attempt_reason?: string;
+    pane_attempt_at?: string;
+    created_at: string;
+    updated_at: string;
+    replay_count: number;
+}
+export interface GjcTeamNotificationSummary {
+    total: number;
+    replay_eligible: number;
+    by_state: Record<GjcTeamNotificationDeliveryState, number>;
+}
+export interface GjcTeamMailboxDeliveryInput {
+    team_name: string;
+    state_dir: string;
+    config: GjcTeamConfig;
+    notification: GjcTeamNotification;
+    message: GjcTeamMailboxMessage;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}
+export type GjcTeamMailboxDeliveryResult = {
+    transport: "sdk";
+    state: GjcTeamNotificationDeliveryState;
+    reason?: string;
+} | {
+    transport: "pane";
+    state: GjcTeamPaneAttemptResult;
+    reason?: string;
+};
+export interface GjcTeamMailboxDeliveryTransport {
+    deliverMailboxMessage(input: GjcTeamMailboxDeliveryInput): Promise<GjcTeamMailboxDeliveryResult | null>;
+}
+export type GjcTeamTaskStatus = "pending" | "blocked" | "in_progress" | "completed" | "failed";
+export interface GjcTeamTaskClaim {
+    owner: string;
+    token: string;
+    leased_until: string;
+}
+export type GjcTeamTaskCompletionEvidenceKind = "command" | "inspection" | "artifact";
+export type GjcTeamTaskCompletionEvidenceStatus = "passed" | "failed" | "not_run" | "verified" | "rejected";
+export interface GjcTeamTaskCompletionEvidenceItem {
+    kind: GjcTeamTaskCompletionEvidenceKind;
+    status: GjcTeamTaskCompletionEvidenceStatus;
+    summary: string;
+    command?: string;
+    artifact?: string;
+    location?: string;
+    output?: string;
+}
+export interface GjcTeamTaskCompletionEvidence {
+    summary: string;
+    items: GjcTeamTaskCompletionEvidenceItem[];
+    files?: string[];
+    notes?: string;
+    recorded_by: string;
+    recorded_at: string;
+}
+export interface GjcTeamTask {
+    id: string;
+    subject: string;
+    description: string;
+    title: string;
+    objective: string;
+    status: GjcTeamTaskStatus;
+    assignee?: string;
+    owner?: string;
+    result?: string;
+    completion_evidence?: GjcTeamTaskCompletionEvidence;
+    error?: string;
+    blocked_by?: string[];
+    depends_on?: string[];
+    lane?: string;
+    required_role?: string;
+    allowed_roles?: string[];
+    version: number;
+    claim?: GjcTeamTaskClaim;
+    created_at: string;
+    updated_at: string;
+    completed_at?: string;
+}
+export type GjcTeamTaskMetadataInput = Partial<Pick<GjcTeamTask, "owner" | "lane" | "required_role" | "allowed_roles" | "depends_on" | "blocked_by">>;
+export interface GjcTeamTaskWorker {
+    id: string;
+    role: string;
+    agent_type: string;
+}
+export interface GjcTeamApiClaimResult {
+    ok: boolean;
+    task?: GjcTeamTask;
+    worker_id?: string;
+    claim_token?: string;
+    reason?: string;
+}
+type EventAppender = (event: {
+    type: string;
+    task_id?: string;
+    worker?: string;
+    message: string;
+    data?: Record<string, unknown>;
+}) => Promise<void>;
+/** The sole strict schema gate for persisted task and claim authority records. */
+export declare function isCanonicalPersistedGjcTeamTaskClaim(value: unknown): value is GjcTeamTaskClaim;
+export declare function isCanonicalPersistedGjcTeamTask(value: unknown, fileId?: string): value is GjcTeamTask;
+/**
+ * Serializes mutable team facts across processes. Callers must not re-enter this
+ * fence; use unlocked helpers when composing operations under one transaction.
+ */
+export declare function withGjcTeamMutationFence<T>(dir: string, fn: () => Promise<T>): Promise<T>;
+export declare function taskMetadataFromInput(input: Record<string, unknown>, includeOwner?: boolean): GjcTeamTaskMetadataInput;
+export declare function normalizeGjcTeamTask(raw: GjcTeamTask): GjcTeamTask;
+export declare function normalizeGjcTeamTaskCompletionEvidence(id: string, owner: string, input: unknown, recordedAt?: string): GjcTeamTaskCompletionEvidence;
+export declare function getGjcTeamTaskCompletionEvidenceFailure(task: GjcTeamTask): string | null;
+export declare const isGjcTeamTaskCompletionVerified: (task: GjcTeamTask) => boolean;
+export declare function readGjcTeamTasksFromDir(dir: string): Promise<GjcTeamTask[]>;
+declare const teamTaskMutationCapability: unique symbol;
+/**
+ * This is intentionally structural only: callers can invoke methods supplied by
+ * `withGjcTeamTaskMutation`, but cannot create an active capability. Each method
+ * closes over a private brand and is revoked when that callback settles.
+ */
+export interface GjcTeamTaskMutationCapability {
+    create(subject: string, description: string, options: GjcTeamTaskMetadataInput): Promise<GjcTeamTask>;
+    update(id: string, updates: Partial<Pick<GjcTeamTask, "subject" | "description" | "blocked_by" | "depends_on" | "lane" | "required_role" | "allowed_roles">>): Promise<GjcTeamTask>;
+    claim(worker: GjcTeamTaskWorker, id?: string): Promise<GjcTeamApiClaimResult>;
+    transition(id: string, status: GjcTeamTaskStatus, token?: string, workerId?: string, evidenceInput?: unknown): Promise<GjcTeamTask>;
+    release(id: string, token: string, workerId: string): Promise<GjcTeamTask>;
+    writeRecovered(task: GjcTeamTask): Promise<void>;
+}
+export declare function withGjcTeamTaskMutation<T>(store: GjcTeamTaskStore, fn: (capability: GjcTeamTaskMutationCapability) => Promise<T>): Promise<T>;
+export declare class GjcTeamTaskStore {
+    #private;
+    readonly dir: string;
+    readonly appendEvent: EventAppender;
+    constructor(dir: string, appendEvent: EventAppender);
+    withMutationCapability<T>(capabilityBrand: typeof teamTaskMutationCapability, fn: (capability: GjcTeamTaskMutationCapability) => Promise<T>): Promise<T>;
+    list(): Promise<GjcTeamTask[]>;
+    read(id: string): Promise<GjcTeamTask>;
+    create(subject: string, description: string, options: GjcTeamTaskMetadataInput): Promise<GjcTeamTask>;
+    update(id: string, updates: Partial<Pick<GjcTeamTask, "subject" | "description" | "blocked_by" | "depends_on" | "lane" | "required_role" | "allowed_roles">>): Promise<GjcTeamTask>;
+    claim(worker: GjcTeamTaskWorker, id?: string): Promise<GjcTeamApiClaimResult>;
+    transition(id: string, status: GjcTeamTaskStatus, token?: string, workerId?: string, evidenceInput?: unknown): Promise<GjcTeamTask>;
+    release(id: string, token: string, workerId: string): Promise<GjcTeamTask>;
+}
+export {};