claude-code-session-manager 0.86.0 → 0.88.0

package/scripts/render-project-pages.cjs

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-// Bash-invocable CLI wrapping the Stage 0 renderer (render.tsx →
-// scripts/render-project-pages/dist/renderer.cjs, built by
-// `npm run build:project-pages`). Requires that build to have already run —
-// this script does NOT bundle on the fly, since PRD authoring standards
-// forbid unbounded/slow steps inside a headless job.
-//
-// Usage:
-//   node scripts/render-project-pages.cjs <summary.json> <picks.json> <output dir> <generatedAt>
-//
-// generatedAt (4th arg, required) is an ISO 8601 timestamp string the CALLER
-// stamps — Date.now() is unavailable in some execution contexts (e.g.
-// workflow scripts) that may drive this CLI, so this script never generates
-// its own timestamp. This is the "accept generatedAt as a 4th CLI arg"
-// option from the PRD's two documented choices (the alternative — omitting
-// generatedAt from manifest.json entirely — was not taken).
-//
-// Writes <output dir>/home.html, marketing.html, feature.html,
-// architecture.html, brief.html, and manifest.json ({ generatedAt }).
-//
-// Path arguments are used as-is (no allowedRoots validation like
-// config.cjs's validatePath) — this is a standalone local dev/ops script run
-// by a trusted human or agent shell, not an IPC-reachable surface, so it's
-// out of scope for that guard by design.
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-function fail(message) {
-  console.error(`render-project-pages: ${message}`);
-  process.exit(1);
-}
-
-function main() {
-  const [summaryPath, picksPath, outDir, generatedAt] = process.argv.slice(2);
-  if (!summaryPath || !picksPath || !outDir || !generatedAt) {
-    fail('usage: node scripts/render-project-pages.cjs <summary.json> <picks.json> <output dir> <generatedAt>');
-  }
-  if (Number.isNaN(Date.parse(generatedAt))) {
-    fail(`generatedAt must be an ISO 8601 timestamp, got: ${generatedAt}`);
-  }
-
-  const bundlePath = path.join(__dirname, 'render-project-pages', 'dist', 'renderer.cjs');
-  if (!fs.existsSync(bundlePath)) {
-    fail(`build bundle not found at ${bundlePath} — run "npm run build:project-pages" first`);
-  }
-
-  let renderProjectPages;
-  try {
-    ({ renderProjectPages } = require(bundlePath));
-  } catch (err) {
-    fail(`failed to load ${bundlePath}: ${err.message}`);
-  }
-
-  const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
-  const picks = JSON.parse(fs.readFileSync(picksPath, 'utf8'));
-
-  const pages = renderProjectPages(summary, picks);
-
-  fs.mkdirSync(outDir, { recursive: true });
-  for (const lens of ['home', 'marketing', 'feature', 'architecture', 'brief']) {
-    fs.writeFileSync(path.join(outDir, `${lens}.html`), pages[lens]);
-  }
-  fs.writeFileSync(path.join(outDir, 'manifest.json'), JSON.stringify({ generatedAt }, null, 2));
-
-  console.log(`Wrote home.html, marketing.html, feature.html, architecture.html, brief.html, manifest.json to ${outDir}`);
-}
-
-main();

package/scripts/validate-project-pages-summary.cjs

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-// Thin CLI wrapper around validateProjectPageSummary (src/renderer/lib/
-// projectPages/summaryValidate.ts), compiled into
-// scripts/project-pages-logic/dist/logic.cjs by `npm run
-// build:project-pages-logic`. The project-home-builder Epic runs this
-// against its own summary.json before proceeding to Stage 2/3 (see
-// .claude/agents/project-home-builder.md).
-//
-// Usage: node scripts/validate-project-pages-summary.cjs <summary.json path>
-// Exits 0 and prints "valid" on success; exits 1 and prints each error on
-// failure. Same CLI-wrapper pattern as scripts/render-project-pages.cjs.
-//
-// The path argument is used as-is (no allowedRoots validation like
-// config.cjs's validatePath) — this is a standalone local dev/ops script run
-// by a trusted human or agent shell, not an IPC-reachable surface, so it's
-// out of scope for that guard by design.
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-function fail(message) {
-  console.error(`validate-project-pages-summary: ${message}`);
-  process.exit(1);
-}
-
-function main() {
-  const [summaryPath] = process.argv.slice(2);
-  if (!summaryPath) {
-    fail('usage: node scripts/validate-project-pages-summary.cjs <summary.json path>');
-  }
-
-  const bundlePath = path.join(__dirname, 'project-pages-logic', 'dist', 'logic.cjs');
-  if (!fs.existsSync(bundlePath)) {
-    fail(`build bundle not found at ${bundlePath} — run "npm run build:project-pages-logic" first`);
-  }
-
-  let validateProjectPageSummary;
-  try {
-    ({ validateProjectPageSummary } = require(bundlePath));
-  } catch (err) {
-    fail(`failed to load ${bundlePath}: ${err.message}`);
-  }
-
-  let summary;
-  try {
-    summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
-  } catch (err) {
-    fail(`could not read/parse ${summaryPath}: ${err.message}`);
-  }
-
-  const result = validateProjectPageSummary(summary);
-  if (!result.ok) {
-    console.error('validate-project-pages-summary: invalid summary:');
-    for (const err of result.errors) console.error(`  - ${err}`);
-    process.exit(1);
-  }
-
-  console.log('valid');
-}
-
-main();

package/src/main/lib/projectPageSummarySchema.cjs

@@ -1,181 +0,0 @@
-'use strict';
-
-/**
- * projectPageSummarySchema.cjs — hand-authored JSON Schema description of
- * `ProjectPageSummary` (src/renderer/lib/projectPages/summaryType.ts), for
- * the /admin/project-home/contract route (PRD: project-home-admin-routes).
- *
- * This schema is DESCRIPTIVE, not the enforcement mechanism — the actual
- * gate a posted summary must pass is `validateProjectPageSummary` (shipped
- * in scripts/project-pages-logic/dist/logic.cjs, called by
- * /admin/project-home/validate-summary and /admin/project-home/render).
- * Kept hand-written rather than derived at runtime so the contract route
- * never needs to load the TypeScript source; if summaryType.ts's shape
- * changes, update this alongside it (same discipline as any other
- * TS-type-mirrored constant in this codebase).
- */
-
-const PROJECT_PAGE_SUMMARY_JSON_SCHEMA = Object.freeze({
-  $schema: 'http://json-schema.org/draft-07/schema#',
-  title: 'ProjectPageSummary',
-  type: 'object',
-  required: ['identity', 'stats', 'pillars', 'feature', 'architecture', 'quotes'],
-  properties: {
-    identity: {
-      type: 'object',
-      required: ['name', 'tag', 'version', 'oneLine', 'claim', 'sub', 'audience', 'install'],
-      properties: {
-        name: { type: 'string' },
-        tag: { type: 'string' },
-        version: { type: 'string' },
-        oneLine: { type: 'string' },
-        claim: { type: 'string' },
-        sub: { type: 'string' },
-        audience: { type: 'string' },
-        install: { type: 'string' },
-      },
-      description: 'Every string field must be non-empty and must not be the literal "TODO".',
-    },
-    stats: {
-      type: 'array',
-      items: {
-        type: 'object',
-        required: ['v', 'k', 'n'],
-        properties: { v: { type: 'string' }, k: { type: 'string' }, n: { type: 'string' } },
-      },
-    },
-    pillars: {
-      type: 'array',
-      items: {
-        type: 'object',
-        required: ['t', 'd', 'k'],
-        properties: { t: { type: 'string' }, d: { type: 'string' }, k: { type: 'string' } },
-      },
-    },
-    quotes: {
-      type: 'array',
-      description: 'Never fabricate testimonials — omit entirely rather than invent a quote.',
-      items: {
-        type: 'object',
-        required: ['q', 'a', 'r'],
-        properties: { q: { type: 'string' }, a: { type: 'string' }, r: { type: 'string' } },
-      },
-    },
-    feature: {
-      type: 'object',
-      required: ['name', 'kicker', 'status', 'owner', 'oneLine', 'problem', 'solution', 'steps', 'rules', 'specs', 'faq', 'timeline'],
-      properties: {
-        name: { type: 'string' },
-        kicker: { type: 'string' },
-        status: { type: 'string' },
-        owner: { type: 'string' },
-        oneLine: { type: 'string' },
-        problem: { type: 'string' },
-        solution: { type: 'string' },
-        steps: { type: 'array', items: { type: 'object', required: ['t', 'd'], properties: { t: { type: 'string' }, d: { type: 'string' } } } },
-        rules: { type: 'array', items: { type: 'object', required: ['t', 'd'], properties: { t: { type: 'string' }, d: { type: 'string' } } } },
-        specs: { type: 'array', items: { type: 'array', description: '[label, value, note]', items: { type: 'string' }, minItems: 3, maxItems: 3 } },
-        faq: { type: 'array', items: { type: 'object', required: ['q', 'a'], properties: { q: { type: 'string' }, a: { type: 'string' } } } },
-        timeline: {
-          type: 'array',
-          items: {
-            type: 'object',
-            required: ['w', 't', 's'],
-            properties: { w: { type: 'string' }, t: { type: 'string' }, s: { type: 'string', enum: ['done', 'next', 'idea'] } },
-          },
-        },
-      },
-    },
-    architecture: {
-      type: 'object',
-      required: ['summary', 'principles', 'layers', 'modules', 'flow', 'decisions', 'risks'],
-      properties: {
-        summary: { type: 'string' },
-        principles: { type: 'array', items: { type: 'object', required: ['t', 'd'], properties: { t: { type: 'string' }, d: { type: 'string' } } } },
-        layers: {
-          type: 'array',
-          items: {
-            type: 'object',
-            required: ['n', 'd', 'f', 'tone'],
-            properties: { n: { type: 'string' }, d: { type: 'string' }, f: { type: 'string' }, tone: { type: 'string', enum: ['accent', 'butter', 'sage', 'mute'] } },
-          },
-        },
-        modules: {
-          type: 'array',
-          items: {
-            type: 'object',
-            required: ['n', 'd', 'f', 'dep', 'heat'],
-            properties: { n: { type: 'string' }, d: { type: 'string' }, f: { type: 'number' }, dep: { type: 'array', items: { type: 'string' } }, heat: { type: 'number' } },
-          },
-        },
-        flow: {
-          type: 'array',
-          items: {
-            type: 'object',
-            required: ['a', 'b', 't', 'n'],
-            properties: { a: { type: 'string' }, b: { type: 'string' }, t: { type: 'string' }, n: { type: 'string' } },
-          },
-        },
-        decisions: {
-          type: 'array',
-          items: {
-            type: 'object',
-            required: ['id', 't', 'w', 's'],
-            properties: { id: { type: 'string' }, t: { type: 'string' }, w: { type: 'string' }, s: { type: 'string', enum: ['accepted', 'proposed', 'superseded'] } },
-          },
-        },
-        risks: {
-          type: 'array',
-          description: 'No clean source in the Brief — leave empty rather than invent.',
-          items: {
-            type: 'object',
-            required: ['t', 'd', 's'],
-            properties: { t: { type: 'string' }, d: { type: 'string' }, s: { type: 'string', enum: ['open', 'watching', 'mitigated'] } },
-          },
-        },
-      },
-    },
-    brief: {
-      type: 'object',
-      description: 'OPTIONAL — omit entirely when this project has no generated brief.json yet.',
-      required: ['purpose', 'what', 'areas', 'scope', 'conventions'],
-      properties: {
-        purpose: { type: 'string' },
-        what: { type: 'array', items: { type: 'string' } },
-        areas: {
-          type: 'array',
-          items: {
-            type: 'object',
-            required: ['name', 'files', 'note', 'epic', 'heat'],
-            properties: { name: { type: 'string' }, files: { type: 'number' }, note: { type: 'string' }, epic: { type: ['string', 'null'] }, heat: { type: 'number' } },
-          },
-        },
-        scope: {
-          type: 'array',
-          items: {
-            type: 'object',
-            required: ['when', 'kind', 'text', 'src'],
-            properties: { when: { type: 'string' }, kind: { type: 'string', enum: ['added', 'narrowed', 'decided'] }, text: { type: 'string' }, src: { type: 'string' } },
-          },
-        },
-        conventions: { type: 'array', items: { type: 'string' } },
-      },
-    },
-  },
-});
-
-// ProjectPagePicks — Record<lensId, Record<slotId, variantId>>. Matched
-// against each lens's own catalog.slots[].variants[].id at render time by
-// the renderer bundle itself, so this schema only bounds the wire shape.
-const PROJECT_PAGE_PICKS_JSON_SCHEMA = Object.freeze({
-  $schema: 'http://json-schema.org/draft-07/schema#',
-  title: 'ProjectPagePicks',
-  type: 'object',
-  additionalProperties: {
-    type: 'object',
-    additionalProperties: { type: 'string' },
-  },
-  description: 'lensId -> slotId -> variantId. Every lensId/slotId/variantId must match one from the catalog.',
-});
-
-module.exports = { PROJECT_PAGE_SUMMARY_JSON_SCHEMA, PROJECT_PAGE_PICKS_JSON_SCHEMA };

package/src/main/teams.cjs

@@ -1,95 +0,0 @@
-/**
- * Teams enumerator — surfaces ~/.claude/teams/<name>/ to the renderer.
- *
- * Each team is a directory containing:
- *   - config.json: { name, description?, members: [{ name, agentType, model, cwd?, ... }], ... }
- *   - inboxes/<thread>.json: one file per pending message thread (depth = file count)
- *
- * We treat teams as feature-flagged: enabled when env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === "1"
- * is set in merged Claude settings. The renderer does its own check; this
- * handler always returns the on-disk roster so the UI can keep recovering
- * gracefully even if settings are unparseable.
- *
- * All reads route through config.cjs (validatePath + atomic semantics).
- * Complexity: O(T·M) where T = teams and M = members; both are small (< 20).
- */
-
-const { ipcMain } = require('electron');
-const os = require('node:os');
-const path = require('node:path');
-const configMgr = require('./config.cjs');
-const logs = require('./logs.cjs');
-
-const TEAMS_ROOT = path.join(os.homedir(), '.claude', 'teams');
-
-/**
- * Enumerate teams. Returns { teams: TeamInfo[] }.
- * Failures per-team (unreadable config.json, missing inbox dir) are swallowed —
- * the team is included with whatever data we could recover. The renderer
- * decides how to render incomplete entries.
- */
-async function listTeams() {
-  let dir;
-  try {
-    dir = await configMgr.listDir(TEAMS_ROOT, { dirsOnly: true });
-  } catch {
-    // listDir throws when path is outside allowed boundaries — should not
-    // happen for ~/.claude/teams, but guard anyway.
-    return { teams: [] };
-  }
-  if (!dir.ok) {
-    if (dir.error) logs.writeLine({ level: 'warn', scope: 'teams', message: 'listDir failed', meta: { error: dir.error } });
-    return { teams: [] };
-  }
-  if (dir.entries.length === 0) return { teams: [] };
-
-  const teams = [];
-  for (const entry of dir.entries) {
-    const teamName = entry.name;
-    const configPath = path.join(entry.path, 'config.json');
-    const inboxDir = path.join(entry.path, 'inboxes');
-
-    let config = null;
-    try {
-      const r = await configMgr.readJson(configPath);
-      if (r.exists && !r.parseError) config = r.data;
-    } catch { /* unreadable — leave config null */ }
-
-    let inboxDepth = 0;
-    try {
-      const inbox = await configMgr.listDir(inboxDir, { filesOnly: true });
-      if (inbox.ok) {
-        inboxDepth = inbox.entries.filter((f) => f.name.endsWith('.json')).length;
-      }
-    } catch { /* no inbox dir is fine */ }
-
-    const members = Array.isArray(config?.members)
-      ? config.members.map((m) => ({
-          name: typeof m?.name === 'string' ? m.name : 'unnamed',
-          agentType: typeof m?.agentType === 'string' ? m.agentType : null,
-          model: typeof m?.model === 'string' ? m.model : null,
-        }))
-      : [];
-
-    teams.push({
-      name: teamName,
-      configPath,
-      description: typeof config?.description === 'string' ? config.description : null,
-      leadAgentId: typeof config?.leadAgentId === 'string' ? config.leadAgentId : null,
-      members,
-      memberCount: members.length,
-      inboxDepth,
-    });
-  }
-  return { teams };
-}
-
-function registerTeamsHandlers() {
-  ipcMain.handle('teams:list', () => listTeams());
-}
-
-module.exports = {
-  registerTeamsHandlers,
-  // exported for direct use / tests
-  listTeams,
-};