claude-code-session-manager 0.55.1 → 0.57.0

package/src/main/ipcSchemas.cjs

@@ -486,6 +486,31 @@ const projectBriefCwd = z.object({
 const projectPagesCwd = z.object({
   cwd: z.string().min(1).max(4096),
 }).strict();
+
+// ──────────────────────────────────────────── Host on Bilko.run
+// Same validation split: real path validation is config.cjs's validatePath
+// at first fs access in bilkoHost.cjs — these schemas only bound wire shape.
+const bilkoHostCwd = z.object({
+  cwd: z.string().min(1).max(4096),
+}).strict();
+const bilkoHostPrepareBundle = z.object({
+  cwd: z.string().min(1).max(4096),
+  slug: z.string().min(1).max(64).regex(/^[a-z0-9-]+$/, 'slug must be lowercase kebab-case'),
+}).strict();
+const BILKO_HOST_DOCUMENT_SOURCE = z.union([
+  z.object({ kind: z.literal('project-page-lens'), lens: z.enum(['home', 'marketing', 'feature', 'architecture']) }).strict(),
+  z.object({ kind: z.literal('file'), path: z.string().min(1).max(4096) }).strict(),
+]);
+const bilkoHostAddDocument = z.object({
+  cwd: z.string().min(1).max(4096),
+  subpath: z.string().min(1).max(200),
+  title: z.string().min(1).max(200),
+  source: BILKO_HOST_DOCUMENT_SOURCE,
+}).strict();
+const bilkoHostRemoveDocument = z.object({
+  cwd: z.string().min(1).max(4096),
+  id: z.string().min(1).max(200),
+}).strict();
 const projectBriefSetPin = z.object({
   cwd: z.string().min(1).max(4096),
   block: PROJECT_BRIEF_BLOCK,
@@ -937,6 +962,10 @@ module.exports = {
     memoryStale,
     projectBriefCwd,
     projectPagesCwd,
+    bilkoHostCwd,
+    bilkoHostPrepareBundle,
+    bilkoHostAddDocument,
+    bilkoHostRemoveDocument,
     projectBriefSetPin,
     projectBriefUpdate,
     promptSessionTranscriptAppend,

package/src/main/lib/epicMint.cjs

@@ -215,6 +215,12 @@ function withPathLock(lockPath, task) {
  */
 function ensureEpic(cwd, { goalText, tag, reuseByGoal = false, epicId: explicitEpicId, status = 'proposed', openingPrompt = null, mintIfMissing = true, source = null, forceNewEpic = false } = {}) {
   if (!cwd || typeof cwd !== 'string') throw new Error('ensureEpic: cwd is required');
+  // A relative cwd (e.g. a caller passing '.') would otherwise get stored
+  // verbatim on the minted Epic's `cwd` field — the renderer's EpicsWorkspace
+  // matches Epics to a tab by exact `s.cwd === effectiveCwd` string equality
+  // against the tab's absolute path, so a relative value silently produces an
+  // Epic that exists on disk but never renders in any project's queue.
+  cwd = path.resolve(cwd);
   return withPathLock(activeIndexPath(cwd), () => {
     const index = readActiveIndex(cwd);
 

package/src/main/lib/opsOwnership.cjs

@@ -48,12 +48,15 @@ const OWNERS = Object.freeze({
   'scheduler': 'scheduler',
   // Project Home owns the synthesized Brief (generate + hand-edit).
   'project-brief': 'project-home',
-  // The feedback intake folder — written by the RCA hook and feedback filing.
-  'feedback': 'feedback',
   // Browser tab scratch saves (DOM captures, screenshots, recorded flows).
   'browser': 'browser',
   // Structured per-tab error log lines (JSONL), tagged for tracing/analysis.
   'logs': 'logs',
+  // Host on Bilko.run tab's deterministic bundle prep (dist/index.html +
+  // dist/manifest.json only — publish-state.json and anything the
+  // bilko-host-publisher Epic authors beyond dist/ is agent-Write-tool
+  // output, same unenforceable-by-construction class as project-pages/output.
+  'bilko-host': 'bilko-host',
 });
 
 /**

package/src/main/projectPages.cjs

@@ -21,7 +21,7 @@ function outputDir(cwd) {
   return path.join(cwd, 'session-manager-operations', 'project-pages', 'output');
 }
 
-const LENSES = ['marketing', 'feature', 'architecture'];
+const LENSES = ['home', 'marketing', 'feature', 'architecture'];
 
 async function get({ cwd }) {
   const realCwd = config.validatePath(cwd);
@@ -38,7 +38,7 @@ async function get({ cwd }) {
     return { output: null };
   }
 
-  const [marketing, feature, architecture] = htmlResults;
+  const [home, marketing, feature, architecture] = htmlResults;
   const generatedAt = typeof manifestResult.data.generatedAt === 'string' ? manifestResult.data.generatedAt : null;
   if (!generatedAt) {
     return { output: null };
@@ -46,6 +46,7 @@ async function get({ cwd }) {
 
   return {
     output: {
+      home: home.text,
       marketing: marketing.text,
       feature: feature.text,
       architecture: architecture.text,

package/src/main/scheduler.cjs

@@ -1138,11 +1138,26 @@ async function reconcile(state) {
 
   const next = [];
   const seen = new Set();
+  // Terminal (completed/failed) jobs whose .md vanished from disk BEFORE
+  // their row ever crossed HISTORY_RETENTION_MS in partitionJobs — i.e. the
+  // common case, since archiveCompletedPrd() (called right when a job
+  // finishes, scheduler.cjs's `newlyCompletedPrds` handling) moves the PRD
+  // file immediately, while partitionJobs' appendHistory only fires after 7
+  // days. Bug found 2026-08-02: the old code below dropped these rows on the
+  // very next reconcile() pass with NO history write at all — the file-gone
+  // check couldn't tell "already recorded to history.jsonl on a prior pass"
+  // apart from "never recorded anywhere", so a job that completed and had
+  // its file auto-archived within minutes lost its history entirely. Both
+  // Queue and History tabs then read as empty even for projects with real,
+  // successfully-completed work. Collected here; reconciled against
+  // historyTerminalBySlug() below and backfilled before being dropped.
+  const terminalDroppedNeedingHistoryCheck = [];
   for (const job of state.jobs) {
     const p = onDisk.get(job.slug);
     if (!p) {
       // A terminal job whose .md is gone was archived on purpose — dropping
-      // its row is the intended end of the auto-archive flow.
+      // its row is the intended end of the auto-archive flow, PROVIDED it's
+      // already durably recorded in history.jsonl (checked below).
       //
       // A PENDING or RUNNING job whose .md is merely not VISIBLE is a
       // different thing entirely, and dropping it destroys queued work: the
@@ -1163,6 +1178,8 @@ async function reconcile(state) {
         seen.add(job.slug);
         next.push({ ...job });
         console.warn(`[scheduler] reconcile: keeping ${job.status} job ${job.slug} — PRD source not visible in any candidate dir`);
+      } else if (job.status === 'completed' || job.status === 'failed') {
+        terminalDroppedNeedingHistoryCheck.push(job);
       }
       continue;
     }
@@ -1198,10 +1215,24 @@ async function reconcile(state) {
   for (const [slug] of onDisk) {
     if (!seen.has(slug)) unmatchedSlugs.push(slug);
   }
-  const historyBySlug = unmatchedSlugs.length > 0
+  const historyBySlug = (unmatchedSlugs.length > 0 || terminalDroppedNeedingHistoryCheck.length > 0)
     ? await queueHistory.historyTerminalBySlug()
     : new Map();
 
+  // Backfill: any terminal job dropped above whose slug isn't already in
+  // history.jsonl gets written now, before its row is gone for good. This is
+  // the fix for the bug described where the loop collects
+  // terminalDroppedNeedingHistoryCheck — without it, a job whose PRD file was
+  // auto-archived immediately on completion (the normal case) is lost from
+  // both jobs[] and history.jsonl in the same reconcile pass.
+  if (terminalDroppedNeedingHistoryCheck.length > 0) {
+    const missing = terminalDroppedNeedingHistoryCheck.filter((j) => !historyBySlug.has(j.slug));
+    if (missing.length > 0) {
+      await queueHistory.appendHistory(missing);
+      console.log(`[scheduler] reconcile: backfilled ${missing.length} completed/failed job(s) into history.jsonl (PRD file already archived, row about to drop)`);
+    }
+  }
+
   // Terminal-in-history slugs whose .md file is still on disk: fed into the
   // auto-archive selection pass below (as synthetic completed entries) so
   // their file can still be swept, without ever creating a live job row

package/src/preload/api.d.ts

@@ -133,7 +133,7 @@ export interface ImportRef {
 /** Declared owner ids for the single-writer law over a project's
  *  session-manager-operations/ root. Mirrors OWNERS in
  *  src/main/lib/opsOwnership.cjs — one writer per namespace; everyone reads. */
-export type OpsWriter = 'epics' | 'scheduler' | 'project-home' | 'feedback' | 'browser';
+export type OpsWriter = 'epics' | 'scheduler' | 'project-home' | 'browser';
 
 export interface WriteResult {
   ok: boolean;
@@ -267,6 +267,9 @@ export interface AgentPersona {
   color: string | null;
   /** Epic intent tags (tagLibrary.ts's TAG_LIBRARY) this persona is associated with. */
   tags: string[];
+  /** "<Department> — <Human title>" (e.g. "Engineering — Architect"), free text — drives
+   *  department grouping in the New Epic Agent picker. Optional/null when not set. */
+  title?: string | null;
   path: string;
   body: string;
   /** Project names (basename of cwd) whose currently-open tab overlays this agent. */
@@ -283,6 +286,7 @@ export interface AgentPersonaSaveInput {
   model: string;
   color: string;
   tags: string[];
+  title?: string;
   body: string;
 }
 
@@ -987,6 +991,7 @@ export type ProjectBriefUpdateResult =
 
 // ────────────────────────────────────────────── Project Pages (PRD 929-932)
 export interface ProjectPagesOutput {
+  home: string;
   marketing: string;
   feature: string;
   architecture: string;
@@ -998,6 +1003,76 @@ export interface ProjectPagesGetResult {
   output: ProjectPagesOutput | null;
 }
 
+// ────────────────────────────────────────────── Host on Bilko.run
+export interface BilkoHostBundleManifest {
+  schemaVersion: 1;
+  slug: string;
+  version: string;
+  builtAt: string;
+  gitSha: string;
+  gitBranch: string;
+  hostKit: { version: string };
+  golden: { path: string; expect: string };
+  health: Record<string, unknown>;
+  bundle: { sizeBytesGz: number; fileCount: number };
+  /** Not part of the host-contract schema itself — this app's own staleness bookkeeping (see BilkoHostGetResult.bundleStale). */
+  documentCount: number;
+  documents: Array<{ subpath: string; title: string }>;
+}
+
+export type BilkoHostPublishStatus =
+  | 'not-published'
+  | 'bundle-ready'
+  | 'publishing'
+  | 'published'
+  | 'publish-failed';
+
+export interface BilkoHostPublishState {
+  status: BilkoHostPublishStatus;
+  slug: string;
+  url?: string;
+  lastAttemptAt?: string;
+  lastError?: string;
+}
+
+export type BilkoHostDocumentSource =
+  | { kind: 'project-page-lens'; lens: 'home' | 'marketing' | 'feature' | 'architecture' }
+  | { kind: 'file'; path: string };
+
+export interface BilkoHostDocument {
+  id: string;
+  /** '' for the root document (dist/index.html); otherwise a '/'-joined lowercase-kebab path, e.g. 'special-doc/01'. */
+  subpath: string;
+  title: string;
+  source: BilkoHostDocumentSource;
+  addedAt: string;
+  /** Where this document resolves once published, given the project's current/derived slug. */
+  url: string;
+}
+
+export interface BilkoHostGetResult {
+  hasMarketingPage: boolean;
+  projectName: string;
+  packagePrivate: boolean;
+  packageHomepage: string | null;
+  packageVersion: string;
+  defaultSlug: string;
+  documents: BilkoHostDocument[];
+  /** True when the on-disk dist/ bundle doesn't reflect the current document list — Prepare Bundle (then Publish) is owed. */
+  bundleStale: boolean;
+  bundleManifest: BilkoHostBundleManifest | null;
+  publishState: BilkoHostPublishState | null;
+}
+
+export interface BilkoHostPrepareBundleResult {
+  distPath: string;
+  manifest: BilkoHostBundleManifest;
+}
+
+export interface BilkoHostDocumentListResult {
+  documents: Array<Omit<BilkoHostDocument, 'url'>>;
+}
+
 // ────────────────────────────────────────────── Per-subagent memory
 // Stored at ~/.claude/session-manager/agent-memory/<agentId>.json. Keyed by
 // agent name (the .md filename in ~/.claude/agents/), not by workspace cwd.
@@ -1148,7 +1223,7 @@ export interface ChatCreatePrdPayload {
   /** Originating tab id — used at job completion to route a status prompt back into the tab. */
   sourceTabId?: string;
   /** User-selected Feature/Bug tag (PRD 774) carried from the originating PromptTicket. */
-  tag?: 'feature' | 'bug' | 'discussion' | 'build' | 'project-home-builder';
+  tag?: 'feature' | 'bug' | 'discussion' | 'build' | 'project-home-builder' | 'bilko-host-publisher';
 }
 
 export type ChatCreatePrdResult =
@@ -1568,6 +1643,16 @@ export interface SessionManagerAPI {
     /** Read output/*.html + manifest.json (or `{output: null}` if none exist yet). Never fires an LLM call. */
     get: (cwd: string) => Promise<ProjectPagesGetResult>;
   };
+  bilkoHost: {
+    /** Read compatibility-gate inputs + any existing bundle/publish state. Never fires an LLM call. */
+    get: (cwd: string) => Promise<BilkoHostGetResult>;
+    /** Stage A: rebuild the whole dist/ tree + dist/manifest.json from the current document list. Pure, no cost, idempotent. */
+    prepareBundle: (cwd: string, slug: string) => Promise<BilkoHostPrepareBundleResult>;
+    /** Add a hosted sub-path document (never the root, which always exists). Does not touch dist/ — Prepare Bundle picks it up. */
+    addDocument: (cwd: string, subpath: string, title: string, source: BilkoHostDocumentSource) => Promise<BilkoHostDocumentListResult>;
+    /** Remove a hosted document (never the root). Only updates documents.json — the file stays live until the next Prepare Bundle + Publish. */
+    removeDocument: (cwd: string, id: string) => Promise<BilkoHostDocumentListResult>;
+  };
   promptSessionTranscript: {
     /** Append one full-text turn to an Epic's durable JSONL transcript. Best-effort — resolves `{ok:false}` rather than throwing on failure. */
     append: (

package/src/preload/index.cjs

@@ -343,6 +343,13 @@ contextBridge.exposeInMainWorld('api', {
   projectPages: {
     get: (cwd) => ipcRenderer.invoke('project-pages:get', { cwd }),
   },
+  bilkoHost: {
+    get: (cwd) => ipcRenderer.invoke('bilko-host:get', { cwd }),
+    prepareBundle: (cwd, slug) => ipcRenderer.invoke('bilko-host:prepare-bundle', { cwd, slug }),
+    addDocument: (cwd, subpath, title, source) =>
+      ipcRenderer.invoke('bilko-host:add-document', { cwd, subpath, title, source }),
+    removeDocument: (cwd, id) => ipcRenderer.invoke('bilko-host:remove-document', { cwd, id }),
+  },
   promptSessionTranscript: {
     append: (cwd, epicId, turn) =>
       ipcRenderer.invoke('promptSessionTranscript:append', { cwd, epicId, ...turn }),