@jmoyers/harness 0.1.10 → 0.1.20

package/src/control-plane/stream-command-parser.ts

@@ -3,7 +3,6 @@ import type { StreamCommand } from './stream-protocol.ts';
 type StreamCommandType = StreamCommand['type'];
 type CommandRecord = Record<string, unknown>;
 type CommandParser = (record: CommandRecord) => StreamCommand | null;
-type ParsedTaskLinearInput = NonNullable<Extract<StreamCommand, { type: 'task.create' }>['linear']>;
 const INVALID_OPTIONAL = Symbol('invalid-optional');
 
 function asRecord(value: unknown): CommandRecord | null {
@@ -95,115 +94,6 @@ function readOptionalNullableString(
   return value;
 }
 
-function readOptionalNullableNonNegativeInteger(
-  record: CommandRecord,
-  field: string,
-): number | null | undefined | typeof INVALID_OPTIONAL {
-  const value = record[field];
-  if (value === undefined) {
-    return undefined;
-  }
-  if (value === null) {
-    return null;
-  }
-  if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
-    return INVALID_OPTIONAL;
-  }
-  return value;
-}
-
-function parseTaskLinearInput(value: unknown): ParsedTaskLinearInput | null {
-  const record = asRecord(value);
-  if (record === null) {
-    return null;
-  }
-  const issueId = readOptionalNullableString(record, 'issueId');
-  const identifier = readOptionalNullableString(record, 'identifier');
-  const url = readOptionalNullableString(record, 'url');
-  const teamId = readOptionalNullableString(record, 'teamId');
-  const projectId = readOptionalNullableString(record, 'projectId');
-  const projectMilestoneId = readOptionalNullableString(record, 'projectMilestoneId');
-  const cycleId = readOptionalNullableString(record, 'cycleId');
-  const stateId = readOptionalNullableString(record, 'stateId');
-  const assigneeId = readOptionalNullableString(record, 'assigneeId');
-  const dueDate = readOptionalNullableString(record, 'dueDate');
-  const priority = readOptionalNullableNonNegativeInteger(record, 'priority');
-  const estimate = readOptionalNullableNonNegativeInteger(record, 'estimate');
-  const labelsRaw = record['labelIds'];
-  let labelIds: string[] | null | undefined;
-  if (labelsRaw !== undefined) {
-    if (labelsRaw === null) {
-      labelIds = null;
-    } else if (Array.isArray(labelsRaw) && labelsRaw.every((entry) => typeof entry === 'string')) {
-      labelIds = [...labelsRaw];
-    } else {
-      return null;
-    }
-  }
-
-  if (
-    issueId === INVALID_OPTIONAL ||
-    identifier === INVALID_OPTIONAL ||
-    url === INVALID_OPTIONAL ||
-    teamId === INVALID_OPTIONAL ||
-    projectId === INVALID_OPTIONAL ||
-    projectMilestoneId === INVALID_OPTIONAL ||
-    cycleId === INVALID_OPTIONAL ||
-    stateId === INVALID_OPTIONAL ||
-    assigneeId === INVALID_OPTIONAL ||
-    dueDate === INVALID_OPTIONAL ||
-    priority === INVALID_OPTIONAL ||
-    estimate === INVALID_OPTIONAL
-  ) {
-    return null;
-  }
-  if (priority !== undefined && priority !== null && priority > 4) {
-    return null;
-  }
-
-  const out: ParsedTaskLinearInput = {};
-  if (issueId !== undefined) {
-    out.issueId = issueId;
-  }
-  if (identifier !== undefined) {
-    out.identifier = identifier;
-  }
-  if (url !== undefined) {
-    out.url = url;
-  }
-  if (teamId !== undefined) {
-    out.teamId = teamId;
-  }
-  if (projectId !== undefined) {
-    out.projectId = projectId;
-  }
-  if (projectMilestoneId !== undefined) {
-    out.projectMilestoneId = projectMilestoneId;
-  }
-  if (cycleId !== undefined) {
-    out.cycleId = cycleId;
-  }
-  if (stateId !== undefined) {
-    out.stateId = stateId;
-  }
-  if (assigneeId !== undefined) {
-    out.assigneeId = assigneeId;
-  }
-  if (priority !== undefined) {
-    out.priority = priority as 0 | 1 | 2 | 3 | 4 | null;
-  }
-  if (estimate !== undefined) {
-    out.estimate = estimate;
-  }
-  if (dueDate !== undefined) {
-    out.dueDate = dueDate;
-  }
-  if (labelIds !== undefined) {
-    out.labelIds = labelIds;
-  }
-  return out;
-}
-
 function parseSessionControllerType(value: unknown): 'human' | 'agent' | 'automation' | null {
   if (value === 'human' || value === 'agent' || value === 'automation') {
     return value;
@@ -586,32 +476,38 @@ function parseRepositoryArchive(record: CommandRecord): StreamCommand | null {
 }
 
 function parseTaskCreate(record: CommandRecord): StreamCommand | null {
-  const title = readString(record['title']);
-  if (title === null) {
+  const body = readString(record['body']);
+  if (body === null) {
     return null;
   }
+  const title = readOptionalNullableString(record, 'title');
   const taskId = readOptionalString(record, 'taskId');
   const tenantId = readOptionalString(record, 'tenantId');
   const userId = readOptionalString(record, 'userId');
   const workspaceId = readOptionalString(record, 'workspaceId');
   const repositoryId = readOptionalString(record, 'repositoryId');
   const projectId = readOptionalString(record, 'projectId');
-  const description = readOptionalString(record, 'description');
   if (
+    title === INVALID_OPTIONAL ||
     taskId === undefined ||
     tenantId === undefined ||
     userId === undefined ||
     workspaceId === undefined ||
     repositoryId === undefined ||
-    projectId === undefined ||
-    description === undefined
+    projectId === undefined
   ) {
     return null;
   }
+  if (repositoryId === null && projectId === null) {
+    return null;
+  }
   const command: StreamCommand = {
     type: 'task.create',
-    title,
+    body,
   };
+  if (title !== undefined) {
+    command.title = title;
+  }
   if (taskId !== null) {
     command.taskId = taskId;
   }
@@ -630,16 +526,6 @@ function parseTaskCreate(record: CommandRecord): StreamCommand | null {
   if (projectId !== null) {
     command.projectId = projectId;
   }
-  if (description !== null) {
-    command.description = description;
-  }
-  if (record['linear'] !== undefined) {
-    const linear = parseTaskLinearInput(record['linear']);
-    if (linear === null) {
-      return null;
-    }
-    command.linear = linear;
-  }
   return command;
 }
 
@@ -728,9 +614,9 @@ function parseTaskUpdate(record: CommandRecord): StreamCommand | null {
   if (taskId === null) {
     return null;
   }
-  const title = readOptionalString(record, 'title');
-  const description = readOptionalString(record, 'description');
-  if (title === undefined || description === undefined) {
+  const title = readOptionalNullableString(record, 'title');
+  const body = readOptionalString(record, 'body');
+  if (title === INVALID_OPTIONAL || body === undefined) {
     return null;
   }
   let repositoryId: string | null | undefined;
@@ -753,16 +639,19 @@ function parseTaskUpdate(record: CommandRecord): StreamCommand | null {
   } else {
     return null;
   }
+  if (repositoryId === null && projectId === null) {
+    return null;
+  }
 
   const command: StreamCommand = {
     type: 'task.update',
     taskId,
   };
-  if (title !== null) {
+  if (title !== undefined) {
     command.title = title;
   }
-  if (description !== null) {
-    command.description = description;
+  if (body !== null) {
+    command.body = body;
   }
   if (repositoryId !== undefined) {
     command.repositoryId = repositoryId;
@@ -770,17 +659,6 @@ function parseTaskUpdate(record: CommandRecord): StreamCommand | null {
   if (projectId !== undefined) {
     command.projectId = projectId;
   }
-  if (record['linear'] !== undefined) {
-    if (record['linear'] === null) {
-      command.linear = null;
-    } else {
-      const linear = parseTaskLinearInput(record['linear']);
-      if (linear === null) {
-        return null;
-      }
-      command.linear = linear;
-    }
-  }
   return command;
 }
 
@@ -1109,6 +987,25 @@ function parseGitHubProjectPr(record: CommandRecord): StreamCommand | null {
   };
 }
 
+function parseGitHubProjectReview(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  const forceRefresh = readOptionalBoolean(record, 'forceRefresh');
+  if (directoryId === null) {
+    return null;
+  }
+  if (forceRefresh === undefined) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'github.project-review',
+    directoryId,
+  };
+  if (forceRefresh !== null) {
+    command.forceRefresh = forceRefresh;
+  }
+  return command;
+}
+
 function parseGitHubPrList(record: CommandRecord): StreamCommand | null {
   const tenantId = readOptionalString(record, 'tenantId');
   const userId = readOptionalString(record, 'userId');
@@ -1256,6 +1153,47 @@ function parseGitHubRepoMyPrsUrl(record: CommandRecord): StreamCommand | null {
   };
 }
 
+function parseLinearIssueImport(record: CommandRecord): StreamCommand | null {
+  const url = readString(record['url']);
+  if (url === null) {
+    return null;
+  }
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const projectId = readOptionalString(record, 'projectId');
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    repositoryId === undefined ||
+    projectId === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'linear.issue.import',
+    url,
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (projectId !== null) {
+    command.projectId = projectId;
+  }
+  return command;
+}
+
 function parseStreamSubscribe(record: CommandRecord): StreamCommand | null {
   const tenantId = readOptionalString(record, 'tenantId');
   const userId = readOptionalString(record, 'userId');
@@ -1664,10 +1602,12 @@ export const DEFAULT_STREAM_COMMAND_PARSERS: StreamCommandParserRegistry = {
   'automation.policy-get': parseAutomationPolicyGet,
   'automation.policy-set': parseAutomationPolicySet,
   'github.project-pr': parseGitHubProjectPr,
+  'github.project-review': parseGitHubProjectReview,
   'github.pr-list': parseGitHubPrList,
   'github.pr-create': parseGitHubPrCreate,
   'github.pr-jobs-list': parseGitHubPrJobsList,
   'github.repo-my-prs-url': parseGitHubRepoMyPrsUrl,
+  'linear.issue.import': parseLinearIssueImport,
   'stream.subscribe': parseStreamSubscribe,
   'stream.unsubscribe': parseStreamUnsubscribe,
   'session.list': parseSessionList,

package/src/control-plane/stream-protocol.ts

@@ -10,6 +10,17 @@ export type StreamPromptCaptureSource = 'otlp-log' | 'hook-notify' | 'history';
 export type StreamPromptConfidence = 'high' | 'medium' | 'low';
 export type StreamSessionControllerType = 'human' | 'agent' | 'automation';
 export type StreamSessionDisplayPhase = 'needs-action' | 'starting' | 'working' | 'idle' | 'exited';
+export type StreamSessionActivityHint = 'needs-action' | 'working' | 'idle';
+
+export function isStreamSessionRuntimeStatus(value: unknown): value is StreamSessionRuntimeStatus {
+  return (
+    value === 'running' || value === 'needs-input' || value === 'completed' || value === 'exited'
+  );
+}
+
+export function parseStreamSessionRuntimeStatus(value: unknown): StreamSessionRuntimeStatus | null {
+  return isStreamSessionRuntimeStatus(value) ? value : null;
+}
 
 export interface StreamSessionController {
   controllerId: string;
@@ -35,7 +46,7 @@ export interface StreamSessionStatusModel {
   attentionReason: string | null;
   lastKnownWork: string | null;
   lastKnownWorkAt: string | null;
-  phaseHint: 'needs-action' | 'working' | 'idle' | null;
+  activityHint: StreamSessionActivityHint | null;
   observedAt: string;
 }
 
@@ -131,27 +142,10 @@ interface ConversationDeleteCommand {
 
 type StreamTaskStatus = 'draft' | 'ready' | 'in-progress' | 'completed';
 type StreamTaskScopeKind = 'global' | 'repository' | 'project';
-type StreamTaskLinearPriority = 0 | 1 | 2 | 3 | 4;
 type StreamProjectTaskFocusMode = 'balanced' | 'own-only';
 type StreamProjectThreadSpawnMode = 'new-thread' | 'reuse-thread';
 type StreamAutomationPolicyScope = 'global' | 'repository' | 'project';
 
-interface StreamTaskLinearInput {
-  issueId?: string | null;
-  identifier?: string | null;
-  url?: string | null;
-  teamId?: string | null;
-  projectId?: string | null;
-  projectMilestoneId?: string | null;
-  cycleId?: string | null;
-  stateId?: string | null;
-  assigneeId?: string | null;
-  priority?: StreamTaskLinearPriority | null;
-  estimate?: number | null;
-  dueDate?: string | null;
-  labelIds?: readonly string[] | null;
-}
-
 interface RepositoryUpsertCommand {
   type: 'repository.upsert';
   repositoryId?: string;
@@ -200,9 +194,8 @@ interface TaskCreateCommand {
   workspaceId?: string;
   repositoryId?: string;
   projectId?: string;
-  title: string;
-  description?: string;
-  linear?: StreamTaskLinearInput;
+  title?: string | null;
+  body: string;
 }
 
 interface TaskGetCommand {
@@ -225,11 +218,10 @@ interface TaskListCommand {
 interface TaskUpdateCommand {
   type: 'task.update';
   taskId: string;
-  title?: string;
-  description?: string;
+  title?: string | null;
+  body?: string;
   repositoryId?: string | null;
   projectId?: string | null;
-  linear?: StreamTaskLinearInput | null;
 }
 
 interface TaskDeleteCommand {
@@ -329,6 +321,12 @@ interface GitHubProjectPrCommand {
   directoryId: string;
 }
 
+interface GitHubProjectReviewCommand {
+  type: 'github.project-review';
+  directoryId: string;
+  forceRefresh?: boolean;
+}
+
 interface GitHubPrListCommand {
   type: 'github.pr-list';
   tenantId?: string;
@@ -366,6 +364,16 @@ interface GitHubRepoMyPrsUrlCommand {
   repositoryId: string;
 }
 
+interface LinearIssueImportCommand {
+  type: 'linear.issue.import';
+  url: string;
+  tenantId?: string;
+  userId?: string;
+  workspaceId?: string;
+  repositoryId?: string;
+  projectId?: string;
+}
+
 interface StreamSubscribeCommand {
   type: 'stream.subscribe';
   tenantId?: string;
@@ -524,10 +532,12 @@ export type StreamCommand =
   | AutomationPolicyGetCommand
   | AutomationPolicySetCommand
   | GitHubProjectPrCommand
+  | GitHubProjectReviewCommand
   | GitHubPrListCommand
   | GitHubPrCreateCommand
   | GitHubPrJobsListCommand
   | GitHubRepoMyPrsUrlCommand
+  | LinearIssueImportCommand
   | StreamSubscribeCommand
   | StreamUnsubscribeCommand
   | SessionListCommand
@@ -1097,6 +1107,13 @@ function parsePromptConfidence(value: unknown): StreamPromptConfidence | null {
   return null;
 }
 
+function parseSessionActivityHint(value: unknown): StreamSessionActivityHint | undefined {
+  if (value === 'needs-action' || value === 'working' || value === 'idle') {
+    return value;
+  }
+  return undefined;
+}
+
 function parseTelemetrySummary(value: unknown): StreamTelemetrySummary | null | undefined {
   if (value === undefined) {
     return undefined;
@@ -1131,7 +1148,9 @@ function parseTelemetrySummary(value: unknown): StreamTelemetrySummary | null |
   };
 }
 
-function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | null | undefined {
+export function parseStreamSessionStatusModel(
+  value: unknown,
+): StreamSessionStatusModel | null | undefined {
   if (value === undefined) {
     return undefined;
   }
@@ -1153,14 +1172,15 @@ function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | nul
     record['lastKnownWork'] === null ? null : readString(record['lastKnownWork']);
   const lastKnownWorkAt =
     record['lastKnownWorkAt'] === null ? null : readString(record['lastKnownWorkAt']);
-  const phaseHint = record['phaseHint'] === null ? null : readString(record['phaseHint']);
+  const activityHintValue = record['activityHint'];
+  const activityHint =
+    activityHintValue === undefined || activityHintValue === null
+      ? null
+      : parseSessionActivityHint(activityHintValue);
   const observedAt = readString(record['observedAt']);
   if (
     runtimeStatus === null ||
-    (runtimeStatus !== 'running' &&
-      runtimeStatus !== 'needs-input' &&
-      runtimeStatus !== 'completed' &&
-      runtimeStatus !== 'exited') ||
+    !isStreamSessionRuntimeStatus(runtimeStatus) ||
     phase === null ||
     (phase !== 'needs-action' &&
       phase !== 'starting' &&
@@ -1175,11 +1195,7 @@ function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | nul
     (attentionReason === null && record['attentionReason'] !== null) ||
     (lastKnownWork === null && record['lastKnownWork'] !== null) ||
     (lastKnownWorkAt === null && record['lastKnownWorkAt'] !== null) ||
-    (phaseHint === null && record['phaseHint'] !== null) ||
-    (phaseHint !== null &&
-      phaseHint !== 'needs-action' &&
-      phaseHint !== 'working' &&
-      phaseHint !== 'idle') ||
+    activityHint === undefined ||
     observedAt === null
   ) {
     return undefined;
@@ -1193,7 +1209,7 @@ function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | nul
     attentionReason,
     lastKnownWork,
     lastKnownWorkAt,
-    phaseHint,
+    activityHint,
     observedAt,
   };
 }
@@ -1599,7 +1615,7 @@ function parseStreamObservedEvent(value: unknown): StreamObservedEvent | null {
     const sessionId = readString(record['sessionId']);
     const status = readString(record['status']);
     const attentionReason = readString(record['attentionReason']);
-    const statusModel = parseSessionStatusModel(record['statusModel']);
+    const statusModel = parseStreamSessionStatusModel(record['statusModel']);
     const live = readBoolean(record['live']);
     const ts = readString(record['ts']);
     const directoryId = readString(record['directoryId']);

package/src/control-plane/stream-server-background.ts

@@ -13,6 +13,16 @@ const HISTORY_POLL_JITTER_RATIO = 0.35;
 const HISTORY_POLL_MAX_DELAY_MS = 60_000;
 const LINE_FEED_BYTE = '\n'.charCodeAt(0);
 
+function isClosedDatabaseError(error: unknown): boolean {
+  const message = error instanceof Error ? error.message : String(error);
+  const normalized = message.trim().toLowerCase();
+  return (
+    normalized.includes('database has closed') ||
+    normalized.includes('database is closed') ||
+    normalized.includes('cannot use a closed database')
+  );
+}
+
 interface GitStatusSummary {
   branch: string | null;
   changedFiles: number;
@@ -215,7 +225,10 @@ export async function pollHistoryFile(ctx: BackgroundContext): Promise<void> {
       );
       ctx.historyNextAllowedPollAtMs = Date.now() + jitterDelayMs(backoffMs);
     }
-  } catch {
+  } catch (error: unknown) {
+    if (isClosedDatabaseError(error)) {
+      throw error;
+    }
     ctx.historyIdleStreak = Math.min(ctx.historyIdleStreak + 1, 4);
     const backoffMs = Math.min(
       HISTORY_POLL_MAX_DELAY_MS,
@@ -467,7 +480,10 @@ export async function refreshGitStatusForDirectory(
       forcePublished: options.forcePublish ? 1 : 0,
       repositoryLinked: repositoryId === null ? 0 : 1,
     });
-  } catch {
+  } catch (error: unknown) {
+    if (isClosedDatabaseError(error)) {
+      throw error;
+    }
     if (previous !== null) {
       ctx.gitStatusByDirectoryId.set(directory.directoryId, {
         ...previous,