claude-code-session-manager 0.57.1 → 0.59.0

package/src/preload/api.d.ts

@@ -171,10 +171,20 @@ export type TranscriptEventKind =
   | 'message'
   | string;
 
+export interface TranscriptEventRef {
+  filePath: string;
+  byteOffset: number;
+  byteLength: number;
+}
+
 export interface TranscriptEvent {
   kind: TranscriptEventKind;
   data: unknown;
   raw: unknown;
+  /** Short, bounded human-scannable preview of `data` — never the source of truth. */
+  previewText: string;
+  /** Byte range of this event's source line on disk; null when classified with no file context. */
+  ref: TranscriptEventRef | null;
 }
 
 export interface SubscribeResult {
@@ -396,7 +406,6 @@ export interface ScheduleConfig {
   /** Minutes to wait after the 5h reset before firing pending jobs.
    *  Used by 'on-reset'. Ignored by 'when-available' and 'manual'. */
   offsetMinutes: number;
-  concurrencyCap: number;
   defaultCwd: string;
   /** Auto-fire policy. Default 'when-available'. */
   firePolicy: ScheduleFirePolicy;
@@ -547,14 +556,45 @@ export interface SchedulePollHealth {
   lastFailureKind: string | null;
 }
 
+/** One `pending` job held by an unsatisfied dependency, and which dep. */
+export interface ScheduleJobHold {
+  slug: string;
+  dep: string;
+  depStatus: string;
+}
+
+/** Outcome of the scheduler's last tick — why the batch was (or wasn't) fired.
+ *  Every field is computed by tickQueue; nothing here is derived in the UI. */
+export interface ScheduleLastTick {
+  fired: boolean;
+  reason: 'held' | 'slots-exhausted' | 'memory-deferred' | 'already-running' | 'drained' | 'paused' | string;
+  /** Human-readable one-liner for the binding constraint, when there is one. */
+  detail?: string;
+  deferredCount?: number;
+  runningCount?: number;
+  count?: number;
+  availableMb?: number;
+  threshold?: number;
+  holders?: { owner: string; at: string }[];
+  holds?: ScheduleJobHold[];
+  at: string;
+}
+
 export interface ScheduleEffectiveConcurrency {
+  /** Total slots in the machine-wide sessionSlots pool — the ONLY concurrency
+   *  limit. The scheduler no longer carries a private concurrencyCap. */
   cap: number;
-  /** 'env' when SM_SCHEDULER_MAX_CONCURRENCY pins the cap; 'config' when concurrencyCap governs. */
-  source: 'env' | 'config';
+  /** Slots free right now (pool total minus held, incl. chat runs). */
+  free: number;
+  /** 'env' when SM_SESSION_SLOTS pins the pool; 'pool' when the persisted
+   *  Home-tab value governs. */
+  source: 'env' | 'pool';
 }
 
 export interface ScheduleStateSnapshot {
   config: ScheduleConfig & { supervisor?: SupervisorConfig };
+  /** Why the last tick fired (or didn't). Null before the first tick. */
+  lastTick?: ScheduleLastTick | null;
   jobs: ScheduleJob[];
   scheduledFor: string | null;
   lastRunAt: string | null;
@@ -699,47 +739,6 @@ export interface FilesDuplicateResult { ok: boolean; path?: string; error?: stri
 export interface DocEditResult { ok: boolean; after?: string; error?: string }
 export interface DocEditSessionResult { tabId: string; requestId: string; ok: boolean; after?: string; error?: string }
 
-export interface SearchFileEntry {
-  name: string;
-  path: string;
-  isDirectory: false;
-  isFile: true;
-}
-export interface SearchFilesResult {
-  ok: boolean;
-  files: SearchFileEntry[];
-  error: string | null;
-  usedRipgrep: boolean;
-}
-export interface SearchTextMatch {
-  path: string;
-  line: number;
-  column: number;
-  text: string;
-}
-export interface SearchTextResult {
-  ok: boolean;
-  matches: SearchTextMatch[];
-  error: string | null;
-  usedRipgrep: boolean;
-}
-
-export interface RepoLanguageStats { files: number; lines: number }
-export interface RepoTopDirectory { path: string; fileCount: number; totalLines: number }
-export interface RepoGitStatusSummary { uncommitted: number; branch: string | null }
-export interface RepoAnalyzeResult {
-  ok: true;
-  cwd: string;
-  totalFiles: number;
-  totalLines: number;
-  languageBreakdown: Record<string, RepoLanguageStats>;
-  topDirectories: RepoTopDirectory[];
-  gitStatus: RepoGitStatusSummary;
-  truncated: boolean;
-  durationMs: number;
-}
-export interface RepoAnalyzeError { ok: false; error: string }
-
 export interface WatcherInfo {
   watcherId: string;
   tabId: string;
@@ -989,17 +988,28 @@ export type ProjectBriefUpdateResult =
   | { ok: true; brief: ProjectBrief }
   | { ok: false; error: string };
 
-// ────────────────────────────────────────────── Project Pages (PRD 929-932)
+// ────────────────────────────────────────────── Project Pages (PRD 929-932, 969, project-home-hosted-html-spec)
 export interface ProjectPagesOutput {
   home: string;
-  marketing: string;
-  feature: string;
-  architecture: string;
-  generatedAt: string;
+  /** Absent when `isDefault` is true — the shipped default only covers the home lens. */
+  marketing?: string;
+  /** Absent when `isDefault` is true — the shipped default only covers the home lens. */
+  feature?: string;
+  /** Absent when `isDefault` is true — the shipped default only covers the home lens. */
+  architecture?: string;
+  /** Absent for output generated before the 'brief' lens existed (PRD 969), or
+   *  when `isDefault` is true — a project must regenerate to pick it up. */
+  brief?: string;
+  /** null for the shipped default (never generated). */
+  generatedAt: string | null;
+  /** True when `home` is the build-time shipped default, not this project's own
+   *  generated output — the renderer must label provenance rather than infer it. */
+  isDefault: boolean;
 }
 
 export interface ProjectPagesGetResult {
-  /** null when no manifest/output files exist yet — the empty-state signal. */
+  /** Never null in practice — a project with no generated output still gets the
+   *  shipped default (isDefault: true). The type stays nullable defensively. */
   output: ProjectPagesOutput | null;
 }
 
@@ -1398,6 +1408,11 @@ export interface SessionManagerAPI {
     /** Permanently destroy the sub (genuine tab close). */
     closeTab: (tabId: string) => Promise<{ ok: boolean }>;
     buffer: (tabId: string) => Promise<TranscriptEvent[]>;
+    /** Paged read over the subscribed transcript's line-offset index — [startLine, endLine] inclusive, 0-based.
+     *  Reads only the requested byte range from disk; never materializes the whole file. */
+    page: (tabId: string, startLine: number, endLine: number) => Promise<{ events: (TranscriptEvent & { lineNumber: number })[]; totalLines: number }>;
+    /** Full untruncated single-line read via a classifier byte reference (expand-to-full path). */
+    readRef: (ref: TranscriptEventRef) => Promise<{ ok: boolean; text?: string; error?: string }>;
     pathFor: (cwd: string, sessionUuid: string) => Promise<string>;
     /** Batched token-usage totals, one map entry per requested sessionId. A
      *  session with no transcript file yet (or one over the main-process size
@@ -1521,13 +1536,6 @@ export interface SessionManagerAPI {
         | { as: 'revealPath'; path: string }
     ) => Promise<{ ok: boolean; opener?: string; error?: string }>;
   };
-  search: {
-    files: (cwd: string, query?: string, opts?: { limit?: number }) => Promise<SearchFilesResult>;
-    text: (cwd: string, query: string, opts?: { limit?: number; caseSensitive?: boolean }) => Promise<SearchTextResult>;
-  };
-  repo: {
-    analyze: (cwd: string) => Promise<RepoAnalyzeResult | RepoAnalyzeError>;
-  };
   history: {
     aggregate: (req?: HistoryAggregateRequest) => Promise<HistoryAggregateResult>;
     scanProjects: () => Promise<SessionScanResult>;
@@ -1765,6 +1773,12 @@ export interface SessionManagerAPI {
      *  in-memory contribution for the cwd; disk stays main's truth, merged
      *  inside the same lock epicMint.cjs's ensureEpic serializes through. */
     mergeActiveIndex: (payload: PromptSessionsMergeActiveIndexPayload) => Promise<PromptSessionsMergeActiveIndexResult>;
+    /** Mints a brand-new 'proposed' Epic through main's own ensureEpic()
+     *  (lib/promptSessionsCreateEpic.cjs) instead of the renderer
+     *  hand-constructing the PromptSession record itself. Unused today —
+     *  additive step 1 of a two-PRD chain; a later PRD routes
+     *  createPromptSession through this. */
+    create: (payload: PromptSessionsCreateEpicPayload) => Promise<PromptSessionsCreateEpicResult>;
   };
 }
 
@@ -1782,6 +1796,35 @@ export interface PromptSessionsMergeActiveIndexResult {
   events: Record<string, unknown[]>;
 }
 
+// ─────────────────────────────────── PromptSessions create-epic (main-side ensureEpic)
+export interface PromptSessionsCreateEpicPayload {
+  cwd: string;
+  goalText: string;
+  tag?: 'feature' | 'bug' | 'discussion' | 'build' | 'project-home-builder' | 'bilko-host-publisher';
+  agentType?: string;
+  source?: {
+    producer: 'new-epic-ui' | 'scheduler-dispatch';
+    prdSlug?: string;
+    runId?: string;
+    sourceTabId?: string;
+  };
+  /** Full first-prompt body + its labeled sections (epicIntake.ts's
+   *  composeEpicIntake) — carried alongside goalText so the Epic's first
+   *  turn can render a structured AIM briefing card. */
+  openingPrompt?: string;
+  sections?: Array<{
+    kind: 'actor' | 'injection' | 'input' | 'mission' | 'goal' | 'reference';
+    label: string;
+    text: string;
+    source?: string;
+  }>;
+}
+
+export interface PromptSessionsCreateEpicResult {
+  epicId: string;
+  session: Record<string, unknown>;
+}
+
 // ─────────────────────────────────── PromptSession event-appended broadcast
 
 export interface PromptSessionEventAppendedPayload {

package/src/preload/index.cjs

@@ -121,6 +121,9 @@ contextBridge.exposeInMainWorld('api', {
     unsubscribe: (tabId) => ipcRenderer.invoke('transcript:unsubscribe', { tabId }),
     closeTab: (tabId) => ipcRenderer.invoke('transcript:close', { tabId }),
     buffer: (tabId) => ipcRenderer.invoke('transcript:buffer', { tabId }),
+    page: (tabId, startLine, endLine) =>
+      ipcRenderer.invoke('transcript:page', { tabId, startLine, endLine }),
+    readRef: (ref) => ipcRenderer.invoke('transcript:readRef', ref),
     pathFor: (cwd, sessionUuid) =>
       ipcRenderer.invoke('transcript:path', { cwd, sessionUuid }),
     usageFor: (cwd, sessionIds) =>
@@ -258,13 +261,6 @@ contextBridge.exposeInMainWorld('api', {
   shell: {
     open: (opts) => ipcRenderer.invoke('shell:open', opts),
   },
-  search: {
-    files: (cwd, query, opts) => ipcRenderer.invoke('search:files', { cwd, query, opts }),
-    text: (cwd, query, opts) => ipcRenderer.invoke('search:text', { cwd, query, opts }),
-  },
-  repo: {
-    analyze: (cwd) => ipcRenderer.invoke('repo:analyze', { cwd }),
-  },
   schedule: {
     state: () => ipcRenderer.invoke('schedule:state'),
     sessionSlots: () => ipcRenderer.invoke('schedule:session-slots'),
@@ -493,5 +489,11 @@ contextBridge.exposeInMainWorld('api', {
      *  renderer-side read-merge-write. Payload carries only this renderer's
      *  own in-memory contribution for the cwd; disk stays main's truth. */
     mergeActiveIndex: (payload) => ipcRenderer.invoke('promptSessions:merge-active-index', payload),
+    /** Mints a brand-new 'proposed' Epic through main's own ensureEpic()
+     *  (lib/promptSessionsCreateEpic.cjs) instead of the renderer
+     *  hand-constructing the PromptSession record itself. Unused today —
+     *  additive step 1 of a two-PRD chain; a later PRD routes
+     *  createPromptSession through this. */
+    create: (payload) => ipcRenderer.invoke('promptSessions:create-epic', payload),
   },
 });