@pellux/goodvibes-agent 1.1.7 → 1.3.0

package/src/input/agent-workspace-snapshot.ts

@@ -1,11 +1,15 @@
 import { basename, sep } from 'node:path';
 import { listAvailableSubscriptionProviders } from '@pellux/goodvibes-sdk/platform/config';
+import type { ArtifactDescriptor } from '@pellux/goodvibes-sdk/platform/artifacts';
 import type { MemoryRecord } from '@pellux/goodvibes-sdk/platform/state';
 import type { CommandContext } from './command-registry.ts';
 import { AgentNoteRegistry, type AgentNoteRecord } from '../agent/note-registry.ts';
+import { AgentDocumentRegistry, type AgentDocumentRecord } from '../agent/document-registry.ts';
 import { AgentPersonaRegistry, type AgentPersonaRecord } from '../agent/persona-registry.ts';
 import { formatAgentRecordOrigin } from '../agent/record-labels.ts';
 import { AgentRoutineRegistry, evaluateAgentRoutineReadiness, type AgentRoutineRecord } from '../agent/routine-registry.ts';
+import { AgentResearchRunRegistry, researchRunLogTail } from '../agent/research-run-registry.ts';
+import { AgentResearchSourceRegistry } from '../agent/research-source-registry.ts';
 import {
   AgentSkillRegistry,
   evaluateAgentSkillBundleReadiness,
@@ -16,21 +20,43 @@ import {
 } from '../agent/skill-registry.ts';
 import { summarizeAgentBehaviorDiscovery } from '../agent/behavior-discovery-summary.ts';
 import { isPromptActiveMemory } from '../agent/memory-prompt.ts';
+import type { PromptContextReceipt } from '../agent/prompt-context-receipts.ts';
+import { discoverProjectContextFiles } from '../agent/project-context-files.ts';
 import { getAgentRuntimeProfilesRoot, listAgentRuntimeProfiles, listAgentRuntimeProfileTemplates, readAgentRuntimeProfileSelection } from '../agent/runtime-profile.ts';
 import { RoutineScheduleReceiptStore } from '../agent/routine-schedule-receipts.ts';
+import { buildSetupWizardDurableReceipts } from '../agent/setup-wizard-artifact-receipts.ts';
+import { mergeSetupWizardDurableReceipts, setupWizardLiveDurableReceipts } from './setup-wizard-live-receipts.ts';
+import { readSetupWizardCheckpoint } from '../agent/setup-wizard-checkpoint.ts';
+import { discoverVibeFiles } from '../agent/vibe-file.ts';
+import {
+  DEFAULT_AGENT_SETUP_WIZARD_CLEAR_CHECKPOINT_ROUTE,
+  DEFAULT_AGENT_SETUP_WIZARD_INSPECT_CHECKPOINT_ROUTE,
+  DEFAULT_AGENT_SETUP_WIZARD_MARK_CHECKPOINT_ROUTE,
+  DEFAULT_AGENT_SETUP_WIZARD_RERUN_SMOKE_ROUTE,
+  DEFAULT_AGENT_SETUP_WIZARD_SAVE_SMOKE_ROUTE,
+  buildAgentSetupWizard,
+  emptyAgentSetupSmokeHistory,
+  emptyAgentSetupWizardCheckpoint,
+  setupStepHasSatisfyingReceipt,
+  type AgentSetupWizard,
+  type AgentSetupWizardBlockedCheckFrequency,
+  type AgentSetupWizardCheckpoint,
+  type AgentSetupWizardSmokeHistory,
+  type AgentSetupWizardSourceItem,
+} from '../agent/setup-wizard.ts';
 import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../config/surface.ts';
 import { connectedHostOperatorTokenFingerprint, readConnectedHostOperatorToken, type ConnectedHostOperatorToken } from '../runtime/connected-host-auth.ts';
-import { buildAgentWorkspaceChannels } from './agent-workspace-channels.ts';
+import { buildAgentWorkspaceChannelSetupGuide, buildAgentWorkspaceChannels } from './agent-workspace-channels.ts';
 import { getAgentWorkspaceConfigReader } from './agent-workspace-config-reader.ts';
-import { buildAgentWorkspaceSetupChecklist } from './agent-workspace-setup.ts';
+import { buildAgentWorkspaceSetupChecklist, type AgentWorkspaceSetupChecklistItem } from './agent-workspace-setup.ts';
 import { buildAgentWorkspaceVoiceMediaReadiness, type AgentWorkspaceVoiceMediaProviderDescriptor } from './agent-workspace-voice-media.ts';
-import type {
-  AgentWorkspaceLocalLibraryItem,
-  AgentWorkspaceRoutineScheduleReceiptSummary,
-  AgentWorkspaceRuntimeProfileItem,
-  AgentWorkspaceRuntimeSnapshot,
-  AgentWorkspaceRuntimeStarterTemplateItem,
-} from './agent-workspace-types.ts';
+import { buildProcessSupervisionSummary, buildProjectContextSummary, buildPromptContextReceiptTimeline, buildResearchBrowserRunnerContract, buildResearchVisualReportContract, buildVibeSummary } from './agent-workspace-context-snapshot.ts';
+import { summarizeMemoryItem, summarizeNoteItem, summarizePersonaItem, summarizeResearchRunItem, summarizeRoutineItem, summarizeRoutineScheduleReceipt, summarizeRuntimeProfile, summarizeSkillBundleItem, summarizeSkillItem, summarizeStarterTemplate } from './agent-workspace-local-library-snapshot.ts';
+import { buildReviewPacketDefaults, buildReviewPacketTimeline, buildReviewPacketWizard, readDocumentDrafts, reviewerReadinessBadge } from './agent-workspace-review-packet-snapshot.ts';
+import { isReviewerHandoffArtifact, summarizeReviewerHandoffArtifact } from './agent-workspace-review-packet-utils.ts';
+import { buildSetupSmokeHistory, buildSetupWizardCheckpoint, buildWorkspaceSetupWizard, setupCompletionMarkerExists } from './agent-workspace-setup-snapshot.ts';
+import { readOnboardingCompletionMarker } from '../runtime/onboarding/index.ts';
+import type { AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
 
 function readConfigString(context: CommandContext, key: string, fallback: string): string {
   try {
@@ -80,144 +106,6 @@ function inferRuntimeProfileBaseHome(homeDirectory: string): string {
   return markerIndex >= 0 ? homeDirectory.slice(0, markerIndex) : homeDirectory;
 }
 
-function summarizePersonaItem(persona: AgentPersonaRecord, activePersonaId: string | null): AgentWorkspaceLocalLibraryItem {
-  return {
-    id: persona.id,
-    name: persona.name,
-    description: persona.description,
-    reviewState: persona.reviewState,
-    source: formatAgentRecordOrigin(persona.source, persona.provenance),
-    tags: persona.tags,
-    triggers: persona.triggers,
-    active: persona.id === activePersonaId,
-  };
-}
-
-function summarizeSkillItem(skill: AgentSkillRecord): AgentWorkspaceLocalLibraryItem {
-  const readiness = evaluateAgentSkillReadiness(skill);
-  return {
-    id: skill.id,
-    name: skill.name,
-    description: skill.description,
-    reviewState: skill.reviewState,
-    source: formatAgentRecordOrigin(skill.source, skill.provenance),
-    tags: skill.tags,
-    triggers: skill.triggers,
-    enabled: skill.enabled,
-    requirementCount: skill.requirements.length,
-    missingRequirementCount: readiness.missing.length,
-    missingRequirements: readiness.missing.map(formatAgentSkillRequirement),
-  };
-}
-
-function summarizeSkillBundleItem(bundle: AgentSkillBundleRecord, skills: readonly AgentSkillRecord[]): AgentWorkspaceLocalLibraryItem {
-  const readiness = evaluateAgentSkillBundleReadiness(bundle, skills);
-  const missing = [
-    ...readiness.missingRequirements.map(formatAgentSkillRequirement),
-    ...readiness.missingSkillIds.map((skillId) => `skill:${skillId}`),
-  ];
-  return {
-    id: bundle.id,
-    name: bundle.name,
-    description: `${bundle.description} Skills: ${bundle.skillIds.join(', ')}`,
-    reviewState: bundle.reviewState,
-    source: formatAgentRecordOrigin(bundle.source, bundle.provenance),
-    tags: bundle.skillIds,
-    triggers: [],
-    enabled: bundle.enabled,
-    requirementCount: readiness.includedSkills.reduce((total, skill) => total + skill.requirements.length, 0) + readiness.missingSkillIds.length,
-    missingRequirementCount: missing.length,
-    missingRequirements: missing,
-  };
-}
-
-function summarizeRoutineItem(routine: AgentRoutineRecord): AgentWorkspaceLocalLibraryItem {
-  const readiness = evaluateAgentRoutineReadiness(routine);
-  return {
-    id: routine.id,
-    name: routine.name,
-    description: routine.description,
-    reviewState: routine.reviewState,
-    source: formatAgentRecordOrigin(routine.source, routine.provenance),
-    tags: routine.tags,
-    triggers: routine.triggers,
-    enabled: routine.enabled,
-    requirementCount: routine.requirements.length,
-    missingRequirementCount: readiness.missing.length,
-    missingRequirements: readiness.missing.map(formatAgentSkillRequirement),
-    startCount: routine.startCount,
-  };
-}
-
-function summarizeRoutineScheduleReceipt(
-  receipt: ReturnType<RoutineScheduleReceiptStore['snapshot']>['receipts'][number],
-): AgentWorkspaceRoutineScheduleReceiptSummary {
-  return {
-    id: receipt.id,
-    status: receipt.status,
-    routineId: receipt.routineId,
-    routineName: receipt.routineName,
-    scheduleName: receipt.scheduleName,
-    scheduleKind: receipt.scheduleKind,
-    scheduleValue: receipt.scheduleValue,
-    createdAt: receipt.createdAt,
-  };
-}
-
-function summarizeMemoryItem(record: MemoryRecord): AgentWorkspaceLocalLibraryItem {
-  const detail = record.detail?.trim();
-  return {
-    id: record.id,
-    name: record.summary,
-    description: detail && detail.length > 0 ? detail : `${record.scope}/${record.cls}`,
-    reviewState: record.reviewState,
-    source: 'Agent memory',
-    tags: record.tags,
-    triggers: [],
-    scope: record.scope,
-    cls: record.cls,
-    confidence: record.confidence,
-  };
-}
-
-function summarizeNoteItem(note: AgentNoteRecord): AgentWorkspaceLocalLibraryItem {
-  const preview = note.body.replace(/\s+/g, ' ').trim();
-  const description = note.sourceUrl
-    ? `${preview.slice(0, 160)}${preview.length > 160 ? '...' : ''} Origin URL ${note.sourceUrl}`
-    : preview;
-  return {
-    id: note.id,
-    name: note.title,
-    description,
-    reviewState: note.reviewState,
-    source: formatAgentRecordOrigin(note.source, note.provenance),
-    tags: note.tags,
-    triggers: [],
-  };
-}
-
-function summarizeRuntimeProfile(profile: ReturnType<typeof listAgentRuntimeProfiles>[number]): AgentWorkspaceRuntimeProfileItem {
-  return {
-    id: profile.id,
-    homeDirectory: profile.homeDirectory,
-    createdAt: profile.createdAt,
-    starterTemplateId: profile.starterTemplateId,
-    starterTemplateName: profile.starterTemplateName,
-  };
-}
-
-function summarizeStarterTemplate(template: ReturnType<typeof listAgentRuntimeProfileTemplates>[number]): AgentWorkspaceRuntimeStarterTemplateItem {
-  return {
-    id: template.id,
-    name: template.name,
-    description: template.description,
-    personaName: template.personaName,
-    skillNames: template.skillNames,
-    routineNames: template.routineNames,
-    source: template.source,
-  };
-}
-
 export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): AgentWorkspaceRuntimeSnapshot {
   const host = readConfigString(context, 'controlPlane.host', '127.0.0.1');
   const port = readConfigNumber(context, 'controlPlane.port', 3421);
@@ -327,6 +215,98 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
       return { count: 0, successful: 0, failed: 0, latest: null };
     }
   })();
+  const researchSourceSnapshot = (() => {
+    try {
+      const shellPaths = context.workspace?.shellPaths;
+      if (!shellPaths) return { count: 0, candidate: 0, reviewed: 0, rejected: 0, used: 0 };
+      const snapshot = AgentResearchSourceRegistry.fromShellPaths(shellPaths).snapshot();
+      return {
+        count: snapshot.sources.length,
+        candidate: snapshot.candidates.length,
+        reviewed: snapshot.reviewed.length,
+        rejected: snapshot.rejected.length,
+        used: snapshot.used.length,
+      };
+    } catch {
+      return { count: 0, candidate: 0, reviewed: 0, rejected: 0, used: 0 };
+    }
+  })();
+  const researchRunSnapshot = (() => {
+    try {
+      const shellPaths = context.workspace?.shellPaths;
+      if (!shellPaths) return { count: 0, planned: 0, running: 0, paused: 0, blocked: 0, terminal: 0, items: [] };
+      const snapshot = AgentResearchRunRegistry.fromShellPaths(shellPaths).snapshot();
+      const actionable = [
+        ...snapshot.blocked,
+        ...snapshot.running,
+        ...snapshot.paused,
+        ...snapshot.planned,
+        ...snapshot.failed,
+        ...snapshot.completed,
+        ...snapshot.cancelled,
+      ];
+      return {
+        count: snapshot.runs.length,
+        planned: snapshot.planned.length,
+        running: snapshot.running.length,
+        paused: snapshot.paused.length,
+        blocked: snapshot.blocked.length,
+        terminal: snapshot.cancelled.length + snapshot.completed.length + snapshot.failed.length,
+        items: actionable.slice(0, 8).map(summarizeResearchRunItem),
+      };
+    } catch {
+      return { count: 0, planned: 0, running: 0, paused: 0, blocked: 0, terminal: 0, items: [] };
+    }
+  })();
+  const artifactListSnapshot = (() => {
+    try {
+      const list = context.platform?.artifactStore?.list;
+      return {
+        available: Boolean(list),
+        items: [...(list?.(100) ?? [])],
+      };
+    } catch {
+      return { available: false, items: [] };
+    }
+  })();
+  const setupSmokeHistory = buildSetupSmokeHistory(artifactListSnapshot.items, artifactListSnapshot.available);
+  const durableSetupReceipts = mergeSetupWizardDurableReceipts(
+    buildSetupWizardDurableReceipts(artifactListSnapshot.items),
+    setupWizardLiveDurableReceipts(context),
+  );
+  const recentReviewerHandoffs = (() => {
+    try {
+      const handoffs = artifactListSnapshot.items
+        .filter(isReviewerHandoffArtifact)
+        .sort((left, right) => right.createdAt - left.createdAt);
+      return {
+        count: handoffs.length,
+        items: handoffs.slice(0, 6).map(summarizeReviewerHandoffArtifact),
+      };
+    } catch {
+      return { count: 0, items: [] };
+    }
+  })();
+  const documentDrafts = readDocumentDrafts(context);
+  const reviewerBadge = reviewerReadinessBadge(
+    documentDrafts,
+    artifactListSnapshot.items,
+    artifactListSnapshot.available,
+  );
+  const reviewPacketTimeline = buildReviewPacketTimeline(
+    documentDrafts,
+    artifactListSnapshot.items,
+    artifactListSnapshot.available,
+  );
+  const reviewPacketDefaults = buildReviewPacketDefaults(
+    documentDrafts,
+    artifactListSnapshot.items,
+  );
+  const reviewPacketWizard = buildReviewPacketWizard(
+    documentDrafts,
+    artifactListSnapshot.available,
+    reviewPacketDefaults,
+  );
   const discoveredBehavior = summarizeAgentBehaviorDiscovery(context.workspace?.shellPaths);
   const profileBaseHome = inferRuntimeProfileBaseHome(context.workspace?.shellPaths?.homeDirectory ?? '');
   const runtimeProfiles = (() => {
@@ -474,15 +454,27 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     }
   })();
   const channels = buildAgentWorkspaceChannels(context);
+  const channelSetupGuide = buildAgentWorkspaceChannelSetupGuide(channels);
   const voiceMediaReadiness = buildAgentWorkspaceVoiceMediaReadiness({
     context,
     voiceProviders: voiceProviderDescriptors,
     mediaProviders: mediaProviderDescriptors,
   });
+  const browserPwaEnabled = readConfigBoolean(context, 'web.enabled', false);
+  const browserPwaPublicBaseUrl = readConfigString(context, 'web.publicBaseUrl', '(not configured)');
+  const connectedHostAuthReceiptReady = setupStepHasSatisfyingReceipt(durableSetupReceipts, 'connected-host-auth');
+  const installSmokeReceiptReady = setupSmokeHistory.latestResult === 'ready-for-user-run'
+    || setupStepHasSatisfyingReceipt(durableSetupReceipts, 'install-smoke');
+  const browserPwaReceiptReady = setupStepHasSatisfyingReceipt(durableSetupReceipts, 'browser-pwa');
   const setupChecklist = buildAgentWorkspaceSetupChecklist({
     provider,
     model,
     runtimeBaseUrl,
+    connectedHostTokenPresent: companionAccess.tokenPresent,
+    connectedHostTokenReadable: companionAccess.tokenReadable,
+    connectedHostTokenPath: companionAccess.tokenPath,
+    connectedHostTokenError: companionAccess.tokenError,
+    connectedHostAuthReceiptReady,
     activeSubscriptionCount: subscriptionSnapshot.active,
     pendingSubscriptionCount: subscriptionSnapshot.pending,
     availableSubscriptionProviderCount: subscriptionSnapshot.available,
@@ -506,9 +498,26 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     readyChannelCount: channels.filter((channel) => channel.ready).length,
     voiceProviderCount: voiceProviders.length,
     mediaProviderCount: mediaProviders.length,
+    installSmokeReceiptReady,
+    browserPwaEnabled,
+    browserPwaPublicBaseUrl,
+    browserPwaFirstRunReceiptStatus: browserPwaReceiptReady ? 'published' : 'not-published',
     runtimeProfileCount: runtimeProfiles.length,
     runtimeStarterTemplateCount: runtimeStarterTemplates.length,
   });
+  const setupWizard = buildWorkspaceSetupWizard(
+    setupChecklist,
+    setupSmokeHistory,
+    buildSetupWizardCheckpoint(context),
+    setupCompletionMarkerExists(context),
+    durableSetupReceipts,
+  );
+  const researchBrowserRunnerContract = buildResearchBrowserRunnerContract(context);
+  const researchVisualReportContract = buildResearchVisualReportContract(researchSourceSnapshot);
+  const vibe = buildVibeSummary(context);
+  const projectContext = buildProjectContextSummary(context);
+  const promptContextReceipts = buildPromptContextReceiptTimeline(context);
+  const processSupervision = buildProcessSupervisionSummary(context);
 
   return {
     provider,
@@ -565,6 +574,30 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     localNoteCount: noteSnapshot.count,
     localNoteReviewQueueCount: noteSnapshot.reviewQueueCount,
     localNotes: noteSnapshot.items,
+    researchSourceCount: researchSourceSnapshot.count,
+    researchSourceCandidateCount: researchSourceSnapshot.candidate,
+    researchSourceReviewedCount: researchSourceSnapshot.reviewed,
+    researchSourceRejectedCount: researchSourceSnapshot.rejected,
+    researchSourceUsedCount: researchSourceSnapshot.used,
+    researchRunCount: researchRunSnapshot.count,
+    researchRunPlannedCount: researchRunSnapshot.planned,
+    researchRunRunningCount: researchRunSnapshot.running,
+    researchRunPausedCount: researchRunSnapshot.paused,
+    researchRunBlockedCount: researchRunSnapshot.blocked,
+    researchRunTerminalCount: researchRunSnapshot.terminal,
+    researchRuns: researchRunSnapshot.items,
+    researchBrowserRunnerContract,
+    researchVisualReportContract,
+    vibe,
+    projectContext,
+    promptContextReceipts,
+    processSupervision,
+    recentReviewerHandoffArtifactCount: recentReviewerHandoffs.count,
+    recentReviewerHandoffArtifacts: recentReviewerHandoffs.items,
+    reviewerReadinessBadge: reviewerBadge,
+    reviewPacketTimeline,
+    reviewPacketDefaults,
+    reviewPacketWizard,
     localRoutineCount: routineSnapshot.count,
     enabledRoutineCount: routineSnapshot.enabled,
     localRoutines: routineSnapshot.items,
@@ -589,6 +622,7 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     delegatedReviewPolicy: 'explicit-build-delegation-only',
     companionAccess,
     channels,
+    channelSetupGuide,
     voiceProviderCount: voiceProviders.length,
     voiceStreamingProviderCount: voiceProviders.filter((entry) => entry.capabilities.includes('tts-stream')).length,
     voiceSttProviderCount: voiceProviders.filter((entry) => entry.capabilities.includes('stt')).length,
@@ -605,8 +639,8 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     mcpConnectedServerCount: mcpSnapshot.connectedCount,
     mcpQuarantinedServerCount: mcpSnapshot.quarantinedCount,
     mcpAllowAllServerCount: mcpSnapshot.allowAllCount,
-    browserToolExposureEnabled: readConfigBoolean(context, 'web.enabled', false),
-    browserToolPublicBaseUrl: readConfigString(context, 'web.publicBaseUrl', '(not configured)'),
+    browserToolExposureEnabled: browserPwaEnabled,
+    browserToolPublicBaseUrl: browserPwaPublicBaseUrl,
     activeRuntimeProfile: inferActiveRuntimeProfile(context.workspace?.shellPaths?.homeDirectory ?? ''),
     selectedRuntimeProfile: selectedRuntimeProfile?.id ?? null,
     selectedRuntimeProfileExists: selectedRuntimeProfile?.exists ?? false,
@@ -618,6 +652,7 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     localStarterTemplateCount: runtimeStarterTemplates.filter((template) => template.source === 'local').length,
     runtimeStarterTemplates: runtimeStarterTemplates.map(summarizeStarterTemplate),
     setupChecklist,
+    setupWizard,
     warnings,
   };
 }