@aion0/forge 0.6.1 → 0.8.0

package/lib/jobs/types.ts

@@ -0,0 +1,117 @@
+/**
+ * Job types — see docs/Jobs-Design.md.
+ */
+
+export type DispatchType = 'pipeline' | 'chat';
+export type JobRunStatus = 'running' | 'ok' | 'error';
+export type JobRunTrigger = 'schedule' | 'manual';
+export type JobDispatchStatus = 'dispatched' | 'error';
+
+export interface PipelineDispatchParams {
+  workflow_name: string;
+  project_path: string;
+  project_name: string;
+  /** Per-item template; string values render `{{item.<path>}}` substitutions. */
+  input_template: Record<string, string>;
+}
+
+export interface ChatDispatchParams {
+  /** Agent profile id (settings.agents); falls back to settings.chatAgent. */
+  agent_profile?: string;
+  session_title_template?: string;
+  message_template: string;
+  /** Append every item to one session vs fresh session per item. */
+  reuse_session?: boolean;
+  /**
+   * Mode:
+   *   'per-item' (default) — one chat message per new item; message_template
+   *                          uses {{item.X}} placeholders.
+   *   'summary'            — ALL new items in this tick are bundled into a
+   *                          single message; message_template gets
+   *                          {{items}} (JSON array) + {{items_text}} (one
+   *                          per line) + {{count}}. Lets the LLM analyze
+   *                          + summarize whatever you want.
+   */
+  mode?: 'per-item' | 'summary';
+  /**
+   * Where the message lands:
+   *   'main' (default for summary) — append into the user's persistent main
+   *                                   chat session. Triggers the agent
+   *                                   loop in the user's active sidepanel.
+   *   'new'  (default for per-item) — fresh temp session each tick (or
+   *                                   reused if reuse_session=true).
+   */
+  target?: 'main' | 'new';
+}
+
+export type DispatchParams = PipelineDispatchParams | ChatDispatchParams;
+
+export interface Job {
+  id: string;
+  name: string;
+  enabled: boolean;
+  schedule_interval_minutes: number;
+
+  source_connector: string;
+  source_tool: string;
+  source_input: Record<string, unknown>;
+
+  items_path: string;          // '' = whole result if array
+  dedup_field: string;
+
+  dispatch_type: DispatchType;
+  dispatch_params: DispatchParams;
+
+  last_run_at: string | null;
+  next_run_at: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface JobRun {
+  id: string;
+  job_id: string;
+  started_at: string;
+  finished_at: string | null;
+  status: JobRunStatus;
+  items_seen: number;
+  items_new: number;
+  items_dispatched: number;
+  error: string | null;
+  trigger: JobRunTrigger;
+  /** Diagnostic note set by the scheduler — backfill summary, missing-path hint, etc. */
+  notes: string | null;
+  /** Plain-text execution log for this tick (timestamped lines). */
+  log: string | null;
+}
+
+export interface JobDispatch {
+  id: string;
+  job_run_id: string;
+  item_key: string;
+  item_preview: string | null;
+  dispatch_type: DispatchType;
+  dispatch_target_id: string | null;
+  status: JobDispatchStatus;
+  error: string | null;
+  created_at: string;
+}
+
+export interface CreateJobInput {
+  name: string;
+  enabled?: boolean;
+  schedule_interval_minutes?: number;
+
+  source_connector: string;
+  source_tool: string;
+  source_input?: Record<string, unknown>;
+
+  items_path?: string;
+  dedup_field: string;
+
+  dispatch_type: DispatchType;
+  dispatch_params: DispatchParams;
+
+  /** Default true: first tick records existing items as seen without dispatching. */
+  mark_existing_as_seen?: boolean;
+}

package/lib/pipeline-scheduler.ts

@@ -17,12 +17,7 @@ import { execSync } from 'node:child_process';
 
 function db() { return getDb(getDbPath()); }
 
-/** Normalize SQLite datetime('now') → ISO 8601 UTC string. */
-function toIsoUTC(s: string | null): string | null {
-  if (!s) return null;
-  if (/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(s)) return s.replace(' ', 'T') + 'Z';
-  return s;
-}
+import { toIsoUTC } from './iso-time';
 
 export interface ProjectPipelineBinding {
   id: number;