@gajae-code/coding-agent 0.14.2 → 0.15.0

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

@@ -1,336 +0,0 @@
-import type { WorkflowHudSummary } from "../skill-state/active-state";
-import type { GcPidProbe, GcRecord } from "./gc-runtime";
-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";
-export interface GjcTeamLeader {
-    session_id: string;
-    pane_id: string;
-    cwd: string;
-}
-export interface GjcTeamWorker {
-    id: string;
-    name: string;
-    index: number;
-    agent_type: string;
-    role: string;
-    pane_id?: string;
-    status: "starting" | "idle" | "busy" | "stopped";
-    last_heartbeat: string;
-    assigned_tasks: string[];
-    worktree_repo_root?: string;
-    worktree_path?: string;
-    worktree_branch?: string | null;
-    worktree_detached?: boolean;
-    worktree_created?: boolean;
-    worktree_base_ref?: string;
-    team_state_root?: 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;
-} | {
-    enabled: true;
-    detached: true;
-    name: null;
-} | {
-    enabled: true;
-    detached: false;
-    name: string;
-};
-export interface GjcTeamConfig {
-    /**
-     * Launch-time platform. Persisted so the monitor path resolves the same
-     * provider context the launch did instead of re-reading `process.platform`,
-     * which makes Windows-authority branches unreachable off Windows.
-     */
-    platform?: NodeJS.Platform;
-    team_name: string;
-    display_name: string;
-    requested_name: string;
-    task: string;
-    agent_type: string;
-    worker_count: number;
-    max_workers: number;
-    state_root: string;
-    gjc_session_id?: string;
-    worker_command: string;
-    worker_cli_plan: GjcTeamWorkerCli[];
-    tmux_command: string;
-    tmux_session: string;
-    tmux_session_name: string;
-    tmux_target: string;
-    tmux_provider_generation?: string;
-    tmux_provider_state_dir?: string;
-    tmux_provider_session_id?: string;
-    workspace_mode: "direct" | "worktree";
-    dry_run: boolean;
-    leader: GjcTeamLeader;
-    leader_cwd: string;
-    team_state_root: string;
-    workers: GjcTeamWorker[];
-    created_at: string;
-    updated_at: string;
-}
-export type GjcTeamIntegrationStatus = "idle" | "integrated" | "integration_failed" | "merge_conflict" | "cherry_pick_conflict" | "rebase_conflict";
-export interface GjcTeamWorkerIntegrationState {
-    last_seen_head?: string;
-    last_integrated_head?: string;
-    last_leader_head?: string;
-    last_rebased_leader_head?: string;
-    status?: GjcTeamIntegrationStatus;
-    conflict_commit?: string;
-    conflict_files?: string[];
-    updated_at?: string;
-}
-export interface GjcTeamMonitorSnapshot {
-    integration_by_worker: Record<string, GjcTeamWorkerIntegrationState>;
-    updated_at: string;
-}
-export interface GjcTeamWorkerLifecycle {
-    worker: string;
-    lifecycle_state: GjcTeamWorkerLifecycleState;
-    worker_status_state: GjcWorkerStatusState;
-    pane_id?: string;
-    pid?: number;
-    started_at?: string;
-    updated_at: string;
-    stopped_at?: string;
-    stop_reason?: string;
-    shutdown_request_id?: string;
-    shutdown_requested_at?: string;
-    shutdown_acknowledged_at?: string;
-    shutdown_ack_status?: string;
-    shutdown_mode?: GjcTeamShutdownMode;
-}
-export interface GjcTeamSnapshot {
-    team_name: string;
-    display_name: string;
-    phase: GjcTeamPhase;
-    state_dir: string;
-    tmux_session: string;
-    tmux_session_name: string;
-    tmux_target: string;
-    task_total: number;
-    task_counts: Record<GjcTeamTaskStatus, number>;
-    workers: GjcTeamWorker[];
-    integration_by_worker?: Record<string, GjcTeamWorkerIntegrationState>;
-    worker_lifecycle_by_id: Record<string, GjcTeamWorkerLifecycle>;
-    notification_summary: GjcTeamNotificationSummary;
-    updated_at: string;
-}
-export interface GjcTeamSnapshotOptions {
-    reconcileNotifications?: boolean;
-}
-export interface GjcTeamStartOptions {
-    workerCount: number;
-    agentType: string;
-    task: string;
-    teamName?: string;
-    worktreeMode?: GjcTeamWorktreeMode;
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    dryRun?: boolean;
-    platform?: NodeJS.Platform;
-    mailboxDeliveryTransport?: GjcTeamMailboxDeliveryTransport;
-}
-export type GjcTeamLivenessRecoveryReason = "claim_expired" | "stale_heartbeat" | "missing_pane" | "worker_lifecycle_failed" | "worker_lifecycle_stopped";
-export interface GjcTeamRecoveredClaim {
-    task_id: string;
-    worker: string;
-    reasons: GjcTeamLivenessRecoveryReason[];
-}
-export interface GjcTeamLivenessRecoveryResult {
-    recovered_claims: GjcTeamRecoveredClaim[];
-    stale_workers: Record<string, GjcTeamLivenessRecoveryReason[]>;
-}
-export interface GjcTeamMailboxMessage {
-    message_id: string;
-    from_worker: string;
-    to_worker: string;
-    body: string;
-    created_at: string;
-    delivered_at?: string;
-    notified_at?: string;
-    idempotency_key?: string;
-}
-export declare function resolveGjcTeamWorkerCli(env?: NodeJS.ProcessEnv): GjcTeamWorkerCli;
-export declare function resolveGjcTeamWorkerCliPlan(workerCount: number, env?: NodeJS.ProcessEnv): GjcTeamWorkerCli[];
-export declare function translateGjcWorkerLaunchArgsForCli(workerCli: GjcTeamWorkerCli, args: string[]): string[];
-export interface GjcTeamEvent {
-    event_id: string;
-    ts: string;
-    type: string;
-    worker?: string;
-    task_id?: string;
-    message?: string;
-    data?: Record<string, unknown>;
-}
-export interface GjcTeamTraceEvent {
-    schema_version: 1;
-    trace_id: string;
-    span_id: string;
-    source_event_id: string;
-    event_type: string;
-    ts: string;
-    worker?: string;
-    task_id?: string;
-    message?: string;
-    evidence_refs?: string[];
-    data?: Record<string, unknown>;
-}
-export interface WorkerStatusFile {
-    state: GjcWorkerStatusState;
-    current_task_id?: string;
-    reason?: string;
-    updated_at: string;
-}
-export interface WorkerHeartbeatFile {
-    pid: number;
-    last_turn_at: string;
-    turn_count: number;
-    alive: boolean;
-    process_start_time?: string;
-}
-export interface GjcWorkerIntegrationAttemptRequestResult {
-    requested: boolean;
-    reason: "requested" | "not_worker" | "missing_worktree" | "no_changes" | "deduped" | "git_error";
-    worker?: string;
-    team_name?: string;
-    fingerprint?: string;
-    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", "worker-continuation-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", "read-worker-memory-guard", "update-worker-memory-guard", "apply-worker-memory-guard", "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 type GjcTeamApiOperation = (typeof GJC_TEAM_API_OPERATIONS)[number];
-export declare class UnknownGjcTeamApiOperationError extends Error {
-    readonly code = "unknown_team_api_operation";
-    readonly operation: string;
-    readonly suggestions: readonly string[];
-    constructor(operation: string, suggestions: readonly string[]);
-}
-export interface GjcTeamRuntimeTestSeams {
-    nowMs?: () => number;
-    continuationTmuxDispatch?: (command: string, args: readonly string[]) => {
-        exitCode?: number;
-    } | Promise<{
-        exitCode?: number;
-    }>;
-    continuationBeforeDispatch?: () => Promise<void>;
-    continuationAckPoll?: () => 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[]>;
-/** @internal */
-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>;
-export declare function resolveWorkerWorktreePath(input: {
-    repoRoot: string;
-    stateDir: string;
-    teamName: string;
-    workerId: string;
-    platform: NodeJS.Platform;
-    isPsmux: boolean;
-}): string;
-/**
- * Check whether the current process can launch a team without changing tmux state.
- * Unlike the launch path, this never adopts or tags an unmanaged tmux session.
- */
-export declare function probeGjcTeamAvailability(env?: NodeJS.ProcessEnv): {
-    available: true;
-} | {
-    available: false;
-    reason: string;
-};
-export declare function resolveGjcWorkerCommand(cwd?: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, argv?: string[], execPath?: string): string;
-export { buildWorkerCommand } from "./team-launch";
-export type GjcWorkerCheckpointClassification = {
-    kind: "clean";
-    files: string[];
-} | {
-    kind: "eligible";
-    files: string[];
-} | {
-    kind: "protected_only";
-    files: string[];
-} | {
-    kind: "conflicted";
-    files: string[];
-} | {
-    kind: "git_error";
-    files: string[];
-    detail: string;
-};
-export declare function classifyGjcTeamCheckpointFiles(files: string[]): {
-    eligible: string[];
-    protected: string[];
-};
-export declare function classifyWorkerCheckpointStatus(cwd: string): 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, 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[]>;
-/** Positive stale windows are clamped so a worker can publish strictly before expiry. */
-export declare function parseHeartbeatStaleMs(env: NodeJS.ProcessEnv): number;
-export declare function shutdownGjcTeam(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamSnapshot>;
-export declare function listGjcTeamTasks(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTask[]>;
-export declare function readGjcTeamTask(teamName: string, taskId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTask>;
-export declare function createGjcTeamTask(teamName: string, subject: string, description: string, cwd?: string, env?: NodeJS.ProcessEnv, taskOptions?: GjcTeamTaskMetadataInput): Promise<GjcTeamTask>;
-export declare function updateGjcTeamTask(teamName: string, taskId: string, updates: Partial<Pick<GjcTeamTask, "subject" | "description" | "blocked_by" | "depends_on" | "lane" | "required_role" | "allowed_roles">>, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTask>;
-export declare function claimGjcTeamTask(teamName: string, workerId: string, cwd?: string, env?: NodeJS.ProcessEnv, taskId?: string): Promise<GjcTeamApiClaimResult>;
-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, 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, 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 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 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>;
-/**
- * Refresh liveness without discarding metadata written by other heartbeat
- * producers. The read/merge/write sequence shares the team mutation fence with
- * CLI heartbeat updates, so a runtime tick cannot overwrite a newer turn count.
- */
-export declare function refreshGjcWorkerHeartbeat(teamName: string, worker: string, pid: number, 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;
-}>;
-export declare function writeGjcWorkerIdentity(teamName: string, worker: GjcTeamWorker, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamWorker>;
-export declare function readGjcTeamEvents(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamEvent[]>;
-export declare function readGjcTeamTraces(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamTraceEvent[]>;
-export declare function appendGjcTeamEvent(teamName: string, type: string, worker?: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<GjcTeamEvent>;
-export declare function awaitGjcTeamEvent(teamName: string, _timeoutMs?: number, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
-    status: "event" | "timeout";
-    event?: GjcTeamEvent;
-}>;
-export declare function writeGjcMonitorSnapshot(teamName: string, snapshot: unknown, cwd?: string, env?: NodeJS.ProcessEnv): Promise<unknown>;
-export declare function readGjcMonitorSnapshot(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<unknown>;
-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 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;

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

@@ -1,168 +0,0 @@
-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;
-}
-export type GjcTeamWorkerClaimSelection = {
-    kind: "none";
-} | {
-    kind: "exact";
-    task: GjcTeamTask;
-    claim: GjcTeamTaskClaim;
-} | {
-    kind: "ambiguous";
-    tasks: GjcTeamTask[];
-};
-export declare function selectCurrentClaimedTaskForWorker(tasks: readonly GjcTeamTask[], workerId: string): GjcTeamWorkerClaimSelection;
-export declare function findGjcTeamClaimedTaskForWorker(tasks: readonly GjcTeamTask[], workerId: string): GjcTeamTask | undefined;
-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;
-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 {};

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

@@ -1,43 +0,0 @@
-import { type WorkerHeartbeatFile } from "./team-runtime";
-export interface GjcTeamWorkerIdentity {
-    teamName: string;
-    workerId: string;
-}
-/** Resolves the team identity injected into a worker pane by `gjc team` startup. */
-export declare function resolveGjcTeamWorkerIdentity(env?: NodeJS.ProcessEnv): GjcTeamWorkerIdentity | undefined;
-/** Refresh cadence derived from the leader's stale window; `0` disables publishing. */
-export declare function resolveGjcTeamWorkerHeartbeatIntervalMs(env?: NodeJS.ProcessEnv): number;
-/**
- * Publish one runtime-owned heartbeat for the worker this process is running as.
- * Returns `undefined` when the process is not a team worker.
- *
- * `turn_count` and process-incarnation metadata are merged under the same
- * mutation fence used by CLI heartbeat updates.
- */
-export declare function writeGjcTeamWorkerRuntimeHeartbeat(cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerHeartbeatFile | undefined>;
-export interface GjcTeamWorkerHeartbeatReporterOptions {
-    write: () => Promise<void>;
-    intervalMs: number;
-}
-/**
- * Publishes a worker heartbeat while a turn is in flight.
- *
- * Writes never overlap; a slow or failing write is logged and skipped rather
- * than queued, because only the most recent record matters. The timer is
- * unreferenced so it can never hold the process open.
- */
-export declare class GjcTeamWorkerHeartbeatReporter {
-    #private;
-    constructor(options: GjcTeamWorkerHeartbeatReporterOptions);
-    /** Reporter for the current process, or `undefined` when it is not a team worker. */
-    static forProcess(cwd: () => string, env?: NodeJS.ProcessEnv): GjcTeamWorkerHeartbeatReporter | undefined;
-    get isRunning(): boolean;
-    /** Publish immediately, then keep publishing until {@link stop} or {@link dispose}. */
-    start(): void;
-    /** Stop periodic publishing after one final record, so the idle stamp is fresh. */
-    stop(): void;
-    /** Await the write in flight, if any. */
-    flush(): Promise<void>;
-    /** Permanently stop publishing. Idempotent. */
-    dispose(): void;
-}

package/dist/types/gjc-runtime/team-worker-memory-guard.d.ts

@@ -1,92 +0,0 @@
-import { type StateWriterOptions } from "./state-writer";
-export type GjcTeamWorkerMemoryGuardState = "idle" | "advisory" | "retrying" | "checkpointed" | "replaced" | "blocked";
-export type GjcTeamWorkerMemoryGuardCheckpointKind = "clean" | "eligible" | "protected_only" | "conflicted" | "git_error";
-export type GjcTeamWorkerMemoryGuardPidProbe = {
-    kind: "live";
-    start_time: string;
-} | {
-    kind: "absent";
-} | {
-    kind: "unverifiable";
-    reason: string;
-};
-export interface GjcTeamWorkerMemoryGuardCheckpoint {
-    kind: GjcTeamWorkerMemoryGuardCheckpointKind;
-    files: string[];
-    head?: string | null;
-    commit?: string | null;
-    recorded_at: string;
-}
-export interface GjcTeamWorkerMemoryGuardReplacement {
-    old_pane_id?: string;
-    new_pane_id?: string;
-    recorded_at: string;
-}
-export interface GjcTeamWorkerMemoryGuardLedger {
-    schema_version: 1;
-    worker_id: string;
-    platform: string;
-    state: GjcTeamWorkerMemoryGuardState;
-    automatic_action_allowed: boolean;
-    retry_count: number;
-    retry_limit: number;
-    current_task_id?: string;
-    last_incident_id?: string;
-    last_reason?: string;
-    last_pid_probe?: GjcTeamWorkerMemoryGuardPidProbe;
-    last_checkpoint?: GjcTeamWorkerMemoryGuardCheckpoint;
-    last_replacement?: GjcTeamWorkerMemoryGuardReplacement;
-    updated_at: string;
-}
-export interface GjcTeamWorkerMemoryGuardSelectionCandidate {
-    worker_id: string;
-    platform: string;
-    excess_bytes: number;
-    retry_count: number;
-    retry_limit: number;
-    blocked?: boolean;
-    current_task_id?: string;
-}
-export interface GjcTeamWorkerMemoryGuardSelection {
-    worker_id: string;
-    excess_bytes: number;
-    retry_count: number;
-    current_task_id?: string;
-}
-export declare function workerMemoryGuardLedgerPath(dir: string, workerId: string): string;
-export declare function normalizeGjcTeamWorkerMemoryGuardPidProbe(value: unknown): GjcTeamWorkerMemoryGuardPidProbe | undefined;
-export declare function isCanonicalGjcTeamWorkerMemoryGuardCheckpoint(value: unknown): value is GjcTeamWorkerMemoryGuardCheckpoint;
-export declare function isCanonicalGjcTeamWorkerMemoryGuardReplacement(value: unknown): value is GjcTeamWorkerMemoryGuardReplacement;
-export declare function isCanonicalGjcTeamWorkerMemoryGuardPidProbe(value: unknown): value is GjcTeamWorkerMemoryGuardPidProbe;
-export declare function isCanonicalGjcTeamWorkerMemoryGuardLedger(value: unknown): value is GjcTeamWorkerMemoryGuardLedger;
-export declare function createInitialGjcTeamWorkerMemoryGuardLedger(input: {
-    workerId: string;
-    platform: string;
-    now: string;
-    retryLimit?: number;
-}): GjcTeamWorkerMemoryGuardLedger;
-export declare function selectGjcTeamWorkerMemoryGuardCandidate(candidates: readonly GjcTeamWorkerMemoryGuardSelectionCandidate[]): GjcTeamWorkerMemoryGuardSelection | undefined;
-export type TeamWorkerMemoryGuardAction = "advisory" | "replace" | "blocked";
-export type TeamWorkerMemoryGuardResult = "noop" | "scheduled" | "succeeded" | "failed" | "blocked";
-export interface TeamWorkerMemoryGuardLedgerEntry {
-    schema_version: 1;
-    recorded_at: string;
-    incident_id: string;
-    team_name: string;
-    worker_id: string;
-    task_id: string;
-    claim_token: string;
-    attempt: number;
-    platform: NodeJS.Platform;
-    action: TeamWorkerMemoryGuardAction;
-    result: TeamWorkerMemoryGuardResult;
-    reason: string;
-}
-export declare function isCanonicalTeamWorkerMemoryGuardLedgerEntry(value: unknown): value is TeamWorkerMemoryGuardLedgerEntry;
-export declare function teamWorkerMemoryGuardDir(workerDirPath: string): string;
-export declare function teamWorkerMemoryGuardLedgerPath(workerDirPath: string): string;
-export declare function canMutateTeamWorkerMemoryGuard(platform: NodeJS.Platform): boolean;
-export declare function advisoryReasonForTeamWorkerMemoryGuard(platform: NodeJS.Platform): string | undefined;
-export declare function appendTeamWorkerMemoryGuardLedgerEntry(workerDirPath: string, entry: TeamWorkerMemoryGuardLedgerEntry, options?: StateWriterOptions): Promise<string>;
-export declare function readTeamWorkerMemoryGuardLedger(workerDirPath: string): Promise<TeamWorkerMemoryGuardLedgerEntry[]>;
-export declare function nextTeamWorkerMemoryGuardAttempt(entries: readonly TeamWorkerMemoryGuardLedgerEntry[], incidentId: string): number;