forgeos 0.1.0-alpha.2 → 0.1.0-alpha.20

package/src/forge/agent-adapters/types.ts

@@ -9,8 +9,16 @@ export type AgentSubcommand =
   | "export"
   | "check"
   | "doctor"
+  | "onboard"
   | "print-context"
-  | "clean";
+  | "clean"
+  | "prepare"
+  | "hooks"
+  | "install"
+  | "ingest"
+  | "context"
+  | "memory"
+  | "timeline";
 
 export interface AgentCommandOptions {
   subcommand: AgentSubcommand;
@@ -22,6 +30,15 @@ export interface AgentCommandOptions {
   preserveUserSections: boolean;
   skills: boolean;
   rules: boolean;
+  eventName?: string;
+  hookAction?: "smoke" | "status" | string;
+  input?: unknown;
+  entry?: string;
+  current?: boolean;
+  limit?: number;
+  watch?: boolean;
+  file?: string;
+  pollIntervalMs?: number;
 }
 
 export interface AgentExportFile {
@@ -119,9 +136,207 @@ export interface AgentPrintContextResult {
   exitCode: 0 | 1;
 }
 
+export type AgentHookBridgeState = "ready" | "missing" | "not-supported" | "waiting-for-user-trust" | "memory-unavailable";
+export type AgentHookApprovalStatus = "not-required" | "waiting-for-user-trust" | "trusted" | "memory-unavailable";
+export type AgentHookReadinessLevel = "none" | "canary" | "trusted-native";
+
 export interface AgentDoctorResult {
   ok: boolean;
+  target: AgentAdapterTarget;
+  summary: {
+    adapter: "ready" | "missing" | "stale";
+    hookBridge: AgentHookBridgeState;
+    approvalRequired: boolean;
+    approvalStatus: AgentHookApprovalStatus;
+    recentEvents: number;
+    queuedEvents?: number;
+    usefulSignals: number;
+    nativeSignals: number;
+    canarySignals: number;
+    lastEventAt?: string;
+  };
+  checks: Array<{ name: string; ok: boolean; message?: string; evidence?: unknown }>;
+  nextActions: string[];
+  diagnostics: Diagnostic[];
+  exitCode: 0 | 1;
+}
+
+export interface AgentPrepareResult {
+  ok: boolean;
+  target: AgentAdapterTarget;
+  exportResult: AgentExportResult;
+  checkResult: AgentCheckResult;
+  installResult?: unknown;
+  commands: {
+    context: string;
+    export: string;
+    check: string;
+    install?: string;
+    hooksStatus?: string;
+    hooksSmoke?: string;
+    open?: string;
+  };
+  diagnostics: Diagnostic[];
+  exitCode: 0 | 1;
+}
+
+export interface AgentOnboardResult {
+  schemaVersion: "0.1.0";
+  ok: boolean;
+  target: AgentAdapterTarget;
+  readyToEdit: boolean;
+  summary: {
+    adapter: "ready" | "missing" | "stale";
+    hookBridge: AgentHookBridgeState;
+    approvalRequired: boolean;
+    approvalStatus: AgentHookApprovalStatus;
+    memorySignals: number;
+    nativeSignals: number;
+    canarySignals: number;
+    generatedFresh: boolean;
+    generatedChanged: boolean;
+    generatedChangedFiles: number;
+    safeToEdit: boolean;
+    changedFiles: number;
+    primaryAction?: string;
+  };
+  steps: Array<{
+    name: string;
+    ok: boolean;
+    message: string;
+  }>;
+  recommendedReadFiles: string[];
+  commands: {
+    changed: string;
+    dev: string;
+    context: string;
+    verify: string;
+    hooksStatus?: string;
+    hooksSmoke?: string;
+    open?: string;
+  };
+  nextActions: string[];
+  diagnostics: Diagnostic[];
+  exitCode: 0 | 1;
+}
+
+export interface AgentHooksSmokeResult {
+  ok: boolean;
+  target: AgentAdapterTarget;
+  installTarget?: string;
+  smokeReady: boolean;
+  trustedNativeReady: boolean;
+  readinessLevel: AgentHookReadinessLevel;
+  installed: boolean;
+  bridgeWritable: boolean;
+  deltaWritable: boolean;
+  visibleInMemory: boolean;
+  usefulSignals: number;
+  nativeSignals: number;
+  canarySignals: number;
+  approvalRequired: boolean;
+  approvalStatus: AgentHookApprovalStatus;
+  lastSignal?: {
+    kind: string;
+    summary?: string;
+    capturedAt: string;
+    workspaceRoot?: string;
+  };
+  canary?: {
+    marker: string;
+    source: string;
+    eventName: string;
+    ingestedEventId?: string;
+    memoryEventsChecked: number;
+    visible: boolean;
+  };
+  hookRunnerProbe?: {
+    ok: boolean;
+    durationMs: number;
+    exitCode: number | null;
+    queued: boolean;
+    stdinHangSafe: boolean;
+    stdinHangDurationMs?: number;
+    error?: string;
+  };
   checks: Array<{ name: string; ok: boolean; message?: string }>;
+  nextActions: string[];
+  installResult?: unknown;
+  ingestResult?: unknown;
+  diagnostics: Diagnostic[];
+  exitCode: 0 | 1;
+}
+
+export interface AgentHooksStatusResult {
+  ok: boolean;
+  target: AgentAdapterTarget;
+  installTarget?: string;
+  installed: boolean;
+  bridgeWritable: boolean;
+  deltaWritable: boolean;
+  visibleInMemory: boolean;
+  recentEvents: number;
+  queuedEvents?: number;
+  usefulSignals: number;
+  nativeSignals: number;
+  canarySignals: number;
+  approvalRequired: boolean;
+  approvalStatus: AgentHookApprovalStatus;
+  lastSignal?: {
+    kind: string;
+    summary?: string;
+    capturedAt: string;
+    workspaceRoot?: string;
+  };
+  workspaceRoot?: string;
+  ignoredOutOfWorkspaceEvents?: number;
+  checks: Array<{ name: string; ok: boolean; message?: string; evidence?: unknown }>;
+  nextActions: string[];
+  installResult?: unknown;
+  diagnostics: Diagnostic[];
+  exitCode: 0 | 1;
+}
+
+export interface AgentTimelineItem {
+  id: string;
+  source: string;
+  integration: string;
+  trustLevel: string;
+  kind: string;
+  capturedAt: string;
+  sessionId?: string;
+  turnId?: string;
+  summary?: string;
+  toolName?: string;
+  command?: string;
+  status?: string;
+  files: string[];
+  entries: string[];
+  proofs: string[];
+  confidence: number;
+}
+
+export interface AgentTimelineResult {
+  schemaVersion: "0.1.0";
+  ok: boolean;
+  timeline: "agent";
+  target: AgentAdapterTarget;
+  sourceFilter?: string;
+  summary: {
+    events: number;
+    sessions: number;
+    files: number;
+    entries: number;
+    proofs: number;
+    tools: number;
+    latestEventAt?: string;
+  };
+  events: AgentTimelineItem[];
+  files: string[];
+  entries: string[];
+  proofs: string[];
+  sessions: string[];
+  nextActions: string[];
   diagnostics: Diagnostic[];
   exitCode: 0 | 1;
 }