claude-code-session-manager 0.19.0 → 0.20.1

package/dist/assets/{xml-8idHpw2C.js → xml-CwsJEzdU.js}

@@ -1 +1 @@
-import{l as e}from"./index-BXeFi7dA.js";const n={comments:{blockComment:["<!--","-->"]},brackets:[["<",">"]],autoClosingPairs:[{open:"<",close:">"},{open:"'",close:"'"},{open:'"',close:'"'}],surroundingPairs:[{open:"<",close:">"},{open:"'",close:"'"},{open:'"',close:'"'}],onEnterRules:[{beforeText:new RegExp("<([_:\\w][_:\\w-.\\d]*)([^/>]*(?!/)>)[^<]*$","i"),afterText:/^<\/([_:\w][_:\w-.\d]*)\s*>$/i,action:{indentAction:e.IndentAction.IndentOutdent}},{beforeText:new RegExp("<(\\w[\\w\\d]*)([^/>]*(?!/)>)[^<]*$","i"),action:{indentAction:e.IndentAction.Indent}}]},o={defaultToken:"",tokenPostfix:".xml",ignoreCase:!0,qualifiedName:/(?:[\w\.\-]+:)?[\w\.\-]+/,tokenizer:{root:[[/[^<&]+/,""],{include:"@whitespace"},[/(<)(@qualifiedName)/,[{token:"delimiter"},{token:"tag",next:"@tag"}]],[/(<\/)(@qualifiedName)(\s*)(>)/,[{token:"delimiter"},{token:"tag"},"",{token:"delimiter"}]],[/(<\?)(@qualifiedName)/,[{token:"delimiter"},{token:"metatag",next:"@tag"}]],[/(<\!)(@qualifiedName)/,[{token:"delimiter"},{token:"metatag",next:"@tag"}]],[/<\!\[CDATA\[/,{token:"delimiter.cdata",next:"@cdata"}],[/&\w+;/,"string.escape"]],cdata:[[/[^\]]+/,""],[/\]\]>/,{token:"delimiter.cdata",next:"@pop"}],[/\]/,""]],tag:[[/[ \t\r\n]+/,""],[/(@qualifiedName)(\s*=\s*)("[^"]*"|'[^']*')/,["attribute.name","","attribute.value"]],[/(@qualifiedName)(\s*=\s*)("[^">?\/]*|'[^'>?\/]*)(?=[\?\/]\>)/,["attribute.name","","attribute.value"]],[/(@qualifiedName)(\s*=\s*)("[^">]*|'[^'>]*)/,["attribute.name","","attribute.value"]],[/@qualifiedName/,"attribute.name"],[/\?>/,{token:"delimiter",next:"@pop"}],[/(\/)(>)/,[{token:"tag"},{token:"delimiter",next:"@pop"}]],[/>/,{token:"delimiter",next:"@pop"}]],whitespace:[[/[ \t\r\n]+/,""],[/<!--/,{token:"comment",next:"@comment"}]],comment:[[/[^<\-]+/,"comment.content"],[/-->/,{token:"comment",next:"@pop"}],[/<!--/,"comment.content.invalid"],[/[<\-]/,"comment.content"]]}};export{n as conf,o as language};
+import{l as e}from"./index-pqnuXM14.js";const n={comments:{blockComment:["<!--","-->"]},brackets:[["<",">"]],autoClosingPairs:[{open:"<",close:">"},{open:"'",close:"'"},{open:'"',close:'"'}],surroundingPairs:[{open:"<",close:">"},{open:"'",close:"'"},{open:'"',close:'"'}],onEnterRules:[{beforeText:new RegExp("<([_:\\w][_:\\w-.\\d]*)([^/>]*(?!/)>)[^<]*$","i"),afterText:/^<\/([_:\w][_:\w-.\d]*)\s*>$/i,action:{indentAction:e.IndentAction.IndentOutdent}},{beforeText:new RegExp("<(\\w[\\w\\d]*)([^/>]*(?!/)>)[^<]*$","i"),action:{indentAction:e.IndentAction.Indent}}]},o={defaultToken:"",tokenPostfix:".xml",ignoreCase:!0,qualifiedName:/(?:[\w\.\-]+:)?[\w\.\-]+/,tokenizer:{root:[[/[^<&]+/,""],{include:"@whitespace"},[/(<)(@qualifiedName)/,[{token:"delimiter"},{token:"tag",next:"@tag"}]],[/(<\/)(@qualifiedName)(\s*)(>)/,[{token:"delimiter"},{token:"tag"},"",{token:"delimiter"}]],[/(<\?)(@qualifiedName)/,[{token:"delimiter"},{token:"metatag",next:"@tag"}]],[/(<\!)(@qualifiedName)/,[{token:"delimiter"},{token:"metatag",next:"@tag"}]],[/<\!\[CDATA\[/,{token:"delimiter.cdata",next:"@cdata"}],[/&\w+;/,"string.escape"]],cdata:[[/[^\]]+/,""],[/\]\]>/,{token:"delimiter.cdata",next:"@pop"}],[/\]/,""]],tag:[[/[ \t\r\n]+/,""],[/(@qualifiedName)(\s*=\s*)("[^"]*"|'[^']*')/,["attribute.name","","attribute.value"]],[/(@qualifiedName)(\s*=\s*)("[^">?\/]*|'[^'>?\/]*)(?=[\?\/]\>)/,["attribute.name","","attribute.value"]],[/(@qualifiedName)(\s*=\s*)("[^">]*|'[^'>]*)/,["attribute.name","","attribute.value"]],[/@qualifiedName/,"attribute.name"],[/\?>/,{token:"delimiter",next:"@pop"}],[/(\/)(>)/,[{token:"tag"},{token:"delimiter",next:"@pop"}]],[/>/,{token:"delimiter",next:"@pop"}]],whitespace:[[/[ \t\r\n]+/,""],[/<!--/,{token:"comment",next:"@comment"}]],comment:[[/[^<\-]+/,"comment.content"],[/-->/,{token:"comment",next:"@pop"}],[/<!--/,"comment.content.invalid"],[/[<\-]/,"comment.content"]]}};export{n as conf,o as language};

package/dist/assets/{yaml-Dm8NKlcv.js → yaml-BDsDjf-y.js}

@@ -1 +1 @@
-import{l as e}from"./index-BXeFi7dA.js";const t={comments:{lineComment:"#"},brackets:[["{","}"],["[","]"],["(",")"]],autoClosingPairs:[{open:"{",close:"}"},{open:"[",close:"]"},{open:"(",close:")"},{open:'"',close:'"'},{open:"'",close:"'"}],surroundingPairs:[{open:"{",close:"}"},{open:"[",close:"]"},{open:"(",close:")"},{open:'"',close:'"'},{open:"'",close:"'"}],folding:{offSide:!0},onEnterRules:[{beforeText:/:\s*$/,action:{indentAction:e.IndentAction.Indent}}]},o={tokenPostfix:".yaml",brackets:[{token:"delimiter.bracket",open:"{",close:"}"},{token:"delimiter.square",open:"[",close:"]"}],keywords:["true","True","TRUE","false","False","FALSE","null","Null","Null","~"],numberInteger:/(?:0|[+-]?[0-9]+)/,numberFloat:/(?:0|[+-]?[0-9]+)(?:\.[0-9]+)?(?:e[-+][1-9][0-9]*)?/,numberOctal:/0o[0-7]+/,numberHex:/0x[0-9a-fA-F]+/,numberInfinity:/[+-]?\.(?:inf|Inf|INF)/,numberNaN:/\.(?:nan|Nan|NAN)/,numberDate:/\d{4}-\d\d-\d\d([Tt ]\d\d:\d\d:\d\d(\.\d+)?(( ?[+-]\d\d?(:\d\d)?)|Z)?)?/,escapes:/\\(?:[btnfr\\"']|[0-7][0-7]?|[0-3][0-7]{2})/,tokenizer:{root:[{include:"@whitespace"},{include:"@comment"},[/%[^ ]+.*$/,"meta.directive"],[/---/,"operators.directivesEnd"],[/\.{3}/,"operators.documentEnd"],[/[-?:](?= )/,"operators"],{include:"@anchor"},{include:"@tagHandle"},{include:"@flowCollections"},{include:"@blockStyle"},[/@numberInteger(?![ \t]*\S+)/,"number"],[/@numberFloat(?![ \t]*\S+)/,"number.float"],[/@numberOctal(?![ \t]*\S+)/,"number.octal"],[/@numberHex(?![ \t]*\S+)/,"number.hex"],[/@numberInfinity(?![ \t]*\S+)/,"number.infinity"],[/@numberNaN(?![ \t]*\S+)/,"number.nan"],[/@numberDate(?![ \t]*\S+)/,"number.date"],[/(".*?"|'.*?'|[^#'"]*?)([ \t]*)(:)( |$)/,["type","white","operators","white"]],{include:"@flowScalars"},[/.+?(?=(\s+#|$))/,{cases:{"@keywords":"keyword","@default":"string"}}]],object:[{include:"@whitespace"},{include:"@comment"},[/\}/,"@brackets","@pop"],[/,/,"delimiter.comma"],[/:(?= )/,"operators"],[/(?:".*?"|'.*?'|[^,\{\[]+?)(?=: )/,"type"],{include:"@flowCollections"},{include:"@flowScalars"},{include:"@tagHandle"},{include:"@anchor"},{include:"@flowNumber"},[/[^\},]+/,{cases:{"@keywords":"keyword","@default":"string"}}]],array:[{include:"@whitespace"},{include:"@comment"},[/\]/,"@brackets","@pop"],[/,/,"delimiter.comma"],{include:"@flowCollections"},{include:"@flowScalars"},{include:"@tagHandle"},{include:"@anchor"},{include:"@flowNumber"},[/[^\],]+/,{cases:{"@keywords":"keyword","@default":"string"}}]],multiString:[[/^( +).+$/,"string","@multiStringContinued.$1"]],multiStringContinued:[[/^( *).+$/,{cases:{"$1==$S2":"string","@default":{token:"@rematch",next:"@popall"}}}]],whitespace:[[/[ \t\r\n]+/,"white"]],comment:[[/#.*$/,"comment"]],flowCollections:[[/\[/,"@brackets","@array"],[/\{/,"@brackets","@object"]],flowScalars:[[/"([^"\\]|\\.)*$/,"string.invalid"],[/'([^'\\]|\\.)*$/,"string.invalid"],[/'[^']*'/,"string"],[/"/,"string","@doubleQuotedString"]],doubleQuotedString:[[/[^\\"]+/,"string"],[/@escapes/,"string.escape"],[/\\./,"string.escape.invalid"],[/"/,"string","@pop"]],blockStyle:[[/[>|][0-9]*[+-]?$/,"operators","@multiString"]],flowNumber:[[/@numberInteger(?=[ \t]*[,\]\}])/,"number"],[/@numberFloat(?=[ \t]*[,\]\}])/,"number.float"],[/@numberOctal(?=[ \t]*[,\]\}])/,"number.octal"],[/@numberHex(?=[ \t]*[,\]\}])/,"number.hex"],[/@numberInfinity(?=[ \t]*[,\]\}])/,"number.infinity"],[/@numberNaN(?=[ \t]*[,\]\}])/,"number.nan"],[/@numberDate(?=[ \t]*[,\]\}])/,"number.date"]],tagHandle:[[/\![^ ]*/,"tag"]],anchor:[[/[&*][^ ]+/,"namespace"]]}};export{t as conf,o as language};
+import{l as e}from"./index-pqnuXM14.js";const t={comments:{lineComment:"#"},brackets:[["{","}"],["[","]"],["(",")"]],autoClosingPairs:[{open:"{",close:"}"},{open:"[",close:"]"},{open:"(",close:")"},{open:'"',close:'"'},{open:"'",close:"'"}],surroundingPairs:[{open:"{",close:"}"},{open:"[",close:"]"},{open:"(",close:")"},{open:'"',close:'"'},{open:"'",close:"'"}],folding:{offSide:!0},onEnterRules:[{beforeText:/:\s*$/,action:{indentAction:e.IndentAction.Indent}}]},o={tokenPostfix:".yaml",brackets:[{token:"delimiter.bracket",open:"{",close:"}"},{token:"delimiter.square",open:"[",close:"]"}],keywords:["true","True","TRUE","false","False","FALSE","null","Null","Null","~"],numberInteger:/(?:0|[+-]?[0-9]+)/,numberFloat:/(?:0|[+-]?[0-9]+)(?:\.[0-9]+)?(?:e[-+][1-9][0-9]*)?/,numberOctal:/0o[0-7]+/,numberHex:/0x[0-9a-fA-F]+/,numberInfinity:/[+-]?\.(?:inf|Inf|INF)/,numberNaN:/\.(?:nan|Nan|NAN)/,numberDate:/\d{4}-\d\d-\d\d([Tt ]\d\d:\d\d:\d\d(\.\d+)?(( ?[+-]\d\d?(:\d\d)?)|Z)?)?/,escapes:/\\(?:[btnfr\\"']|[0-7][0-7]?|[0-3][0-7]{2})/,tokenizer:{root:[{include:"@whitespace"},{include:"@comment"},[/%[^ ]+.*$/,"meta.directive"],[/---/,"operators.directivesEnd"],[/\.{3}/,"operators.documentEnd"],[/[-?:](?= )/,"operators"],{include:"@anchor"},{include:"@tagHandle"},{include:"@flowCollections"},{include:"@blockStyle"},[/@numberInteger(?![ \t]*\S+)/,"number"],[/@numberFloat(?![ \t]*\S+)/,"number.float"],[/@numberOctal(?![ \t]*\S+)/,"number.octal"],[/@numberHex(?![ \t]*\S+)/,"number.hex"],[/@numberInfinity(?![ \t]*\S+)/,"number.infinity"],[/@numberNaN(?![ \t]*\S+)/,"number.nan"],[/@numberDate(?![ \t]*\S+)/,"number.date"],[/(".*?"|'.*?'|[^#'"]*?)([ \t]*)(:)( |$)/,["type","white","operators","white"]],{include:"@flowScalars"},[/.+?(?=(\s+#|$))/,{cases:{"@keywords":"keyword","@default":"string"}}]],object:[{include:"@whitespace"},{include:"@comment"},[/\}/,"@brackets","@pop"],[/,/,"delimiter.comma"],[/:(?= )/,"operators"],[/(?:".*?"|'.*?'|[^,\{\[]+?)(?=: )/,"type"],{include:"@flowCollections"},{include:"@flowScalars"},{include:"@tagHandle"},{include:"@anchor"},{include:"@flowNumber"},[/[^\},]+/,{cases:{"@keywords":"keyword","@default":"string"}}]],array:[{include:"@whitespace"},{include:"@comment"},[/\]/,"@brackets","@pop"],[/,/,"delimiter.comma"],{include:"@flowCollections"},{include:"@flowScalars"},{include:"@tagHandle"},{include:"@anchor"},{include:"@flowNumber"},[/[^\],]+/,{cases:{"@keywords":"keyword","@default":"string"}}]],multiString:[[/^( +).+$/,"string","@multiStringContinued.$1"]],multiStringContinued:[[/^( *).+$/,{cases:{"$1==$S2":"string","@default":{token:"@rematch",next:"@popall"}}}]],whitespace:[[/[ \t\r\n]+/,"white"]],comment:[[/#.*$/,"comment"]],flowCollections:[[/\[/,"@brackets","@array"],[/\{/,"@brackets","@object"]],flowScalars:[[/"([^"\\]|\\.)*$/,"string.invalid"],[/'([^'\\]|\\.)*$/,"string.invalid"],[/'[^']*'/,"string"],[/"/,"string","@doubleQuotedString"]],doubleQuotedString:[[/[^\\"]+/,"string"],[/@escapes/,"string.escape"],[/\\./,"string.escape.invalid"],[/"/,"string","@pop"]],blockStyle:[[/[>|][0-9]*[+-]?$/,"operators","@multiString"]],flowNumber:[[/@numberInteger(?=[ \t]*[,\]\}])/,"number"],[/@numberFloat(?=[ \t]*[,\]\}])/,"number.float"],[/@numberOctal(?=[ \t]*[,\]\}])/,"number.octal"],[/@numberHex(?=[ \t]*[,\]\}])/,"number.hex"],[/@numberInfinity(?=[ \t]*[,\]\}])/,"number.infinity"],[/@numberNaN(?=[ \t]*[,\]\}])/,"number.nan"],[/@numberDate(?=[ \t]*[,\]\}])/,"number.date"]],tagHandle:[[/\![^ ]*/,"tag"]],anchor:[[/[&*][^ ]+/,"namespace"]]}};export{t as conf,o as language};

package/dist/index.html

@@ -7,8 +7,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link href="https://fonts.googleapis.com/css2?family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;0,6..72,600;0,6..72,700;1,6..72,400&family=Geist:wght@300;400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet">
-    <script type="module" crossorigin src="./assets/index-BXeFi7dA.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-BsSklu93.css">
+    <script type="module" crossorigin src="./assets/index-pqnuXM14.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BkkBX1z7.css">
   </head>
   <body class="bg-bg text-fg font-sans antialiased">
     <div id="root"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-session-manager",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "description": "Local cockpit for the Claude Code CLI — multi-tab terminal, full config surface, scheduler, voice dictation, and live observability.",
   "type": "module",
   "main": "src/main/index.cjs",
@@ -32,7 +32,8 @@
     "smoke:darwin": "playwright test tests/smoke/darwin-boot.spec.ts",
     "test:e2e:mic": "xvfb-run -a playwright test e2e/mic.spec.mjs",
     "test:e2e:gen-fixture": "espeak-ng -w /tmp/sm-raw.wav -s 140 'testing one two three four five' && ffmpeg -y -i /tmp/sm-raw.wav -ar 48000 -ac 2 -sample_fmt s16 e2e/fixtures/speech.wav",
-    "refresh:vad-assets": "cp node_modules/@ricky0123/vad-web/dist/silero_vad_v5.onnx node_modules/@ricky0123/vad-web/dist/vad.worklet.bundle.min.js src/renderer/public/vad/ && cp node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.wasm node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.mjs node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.jsep.wasm node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.jsep.mjs src/renderer/public/vad/"
+    "refresh:vad-assets": "cp node_modules/@ricky0123/vad-web/dist/silero_vad_v5.onnx node_modules/@ricky0123/vad-web/dist/vad.worklet.bundle.min.js src/renderer/public/vad/ && cp node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.wasm node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.mjs node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.jsep.wasm node_modules/onnxruntime-web/dist/ort-wasm-simd-threaded.jsep.mjs src/renderer/public/vad/",
+    "health": "node src/main/health.cjs"
   },
   "keywords": [
     "claude",
@@ -103,12 +104,14 @@
     "react-force-graph-2d": "^1.29.1",
     "recharts": "^2.15.4",
     "tiptap-markdown": "^0.9.0",
+    "ws": "^8.18.0",
     "zod": "^3.23.8",
     "zustand": "^5.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.59.1",
     "@types/node": "^22.9.0",
+    "@types/ws": "^8.5.13",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
     "@vitejs/plugin-react": "^4.3.3",

package/src/main/health.cjs

@@ -0,0 +1,216 @@
+/**
+ * health.cjs — health check for session-manager Electron app.
+ * Verifies: app startup, IPC responsiveness, scheduler health, watchers active.
+ * Exported as check() for /local-project-health skill.
+ */
+
+const fs = require('node:fs');
+const fsp = require('node:fs/promises');
+const path = require('node:path');
+const os = require('node:os');
+const { execFileSync } = require('node:child_process');
+
+const MAX_LOG_AGE_MS = 5 * 60_000; // 5 min — warn if no logs this old
+const PROJECT_ROOT = path.resolve(__dirname, '../..');
+
+function runCheck(cmd, cwd = PROJECT_ROOT) {
+  try {
+    execFileSync('bash', ['-c', cmd], {
+      cwd,
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function check() {
+  const start = Date.now();
+  const status = {
+    ok: true,
+    timestamp: new Date().toISOString(),
+    components: {},
+    issues: [],
+  };
+
+  // 1. Check Node.js and key dependencies exist.
+  try {
+    const nodeVer = execFileSync('node', ['--version'], { encoding: 'utf8' }).trim();
+    status.components.nodejs = { ok: true, version: nodeVer };
+  } catch (e) {
+    status.components.nodejs = { ok: false, error: e.message };
+    status.issues.push('Node.js not available');
+    status.ok = false;
+  }
+
+  // 1.5. Check TypeScript compilation (no errors).
+  const typesOk = runCheck('npm run typecheck 2>&1 | grep -q "error" && exit 1 || exit 0');
+  status.components.typescript = { ok: typesOk };
+  if (!typesOk) {
+    status.issues.push('TypeScript compilation has errors');
+    status.ok = false;
+  }
+
+  // 1.6. Check build artifact exists.
+  const distExists = fs.existsSync(path.join(PROJECT_ROOT, 'dist/index.html'));
+  status.components.build_artifact = { ok: distExists, path: 'dist/index.html' };
+  if (!distExists) {
+    status.issues.push('Build artifact missing (run: npm run build)');
+    status.ok = false;
+  }
+
+  // 1.7. Check test infrastructure exists.
+  const hasPlaywright = fs.existsSync(path.join(PROJECT_ROOT, 'playwright.config.ts'));
+  const hasE2E = fs.existsSync(path.join(PROJECT_ROOT, 'e2e'));
+  status.components.test_infrastructure = {
+    ok: hasPlaywright && hasE2E,
+    playwright: hasPlaywright,
+    e2e_dir: hasE2E,
+  };
+
+  // 2. Check config directory exists and is writable.
+  const configDir = path.join(os.homedir(), '.claude');
+  try {
+    await fsp.access(configDir, fs.constants.R_OK | fs.constants.W_OK);
+    const stat = await fsp.stat(configDir);
+    status.components.config_dir = {
+      ok: true,
+      path: configDir,
+      writable: true,
+    };
+  } catch (e) {
+    status.components.config_dir = {
+      ok: false,
+      error: e.message,
+      path: configDir,
+    };
+    status.issues.push(`Config dir not accessible: ${e.message}`);
+    status.ok = false;
+  }
+
+  // 3. Check scheduler PRD directory and queue.json.
+  const schedulerBaseDir = path.join(
+    os.homedir(),
+    '.claude/session-manager/scheduled-plans'
+  );
+  const queuePath = path.join(schedulerBaseDir, 'queue.json');
+  let queueState = null;
+  try {
+    const queueText = await fsp.readFile(queuePath, 'utf8');
+    queueState = JSON.parse(queueText);
+    const runningCount = Object.values(queueState.jobs || {}).filter(
+      (j) => j.status === 'running'
+    ).length;
+    const failedCount = Object.values(queueState.jobs || {}).filter(
+      (j) => j.status === 'failed'
+    ).length;
+    status.components.scheduler_queue = {
+      ok: true,
+      path: queuePath,
+      jobs: Object.keys(queueState.jobs || {}).length,
+      running: runningCount,
+      failed: failedCount,
+    };
+  } catch (e) {
+    if (e.code !== 'ENOENT') {
+      status.issues.push(`Scheduler queue unreadable: ${e.message}`);
+    }
+    status.components.scheduler_queue = {
+      ok: e.code === 'ENOENT', // ok if queue doesn't exist yet
+      path: queuePath,
+      exists: false,
+      error: e.code === 'ENOENT' ? 'not yet created' : e.message,
+    };
+  }
+
+  // 4. Check PRDs directory.
+  const prdsDir = path.join(schedulerBaseDir, 'prds');
+  try {
+    await fsp.access(prdsDir, fs.constants.R_OK);
+    const files = await fsp.readdir(prdsDir);
+    const prdFiles = files.filter((f) => f.endsWith('.md'));
+    status.components.scheduler_prds = {
+      ok: true,
+      path: prdsDir,
+      count: prdFiles.length,
+    };
+  } catch (e) {
+    if (e.code !== 'ENOENT') {
+      status.issues.push(`PRDs directory not accessible: ${e.message}`);
+    }
+    status.components.scheduler_prds = {
+      ok: e.code === 'ENOENT', // ok if not yet created
+      path: prdsDir,
+      exists: false,
+      error: e.code === 'ENOENT' ? 'not yet created' : e.message,
+    };
+  }
+
+  // 5. Check transcripts directory (where live session logs are tailed).
+  const projectsDir = path.join(os.homedir(), '.claude/projects');
+  try {
+    await fsp.access(projectsDir, fs.constants.R_OK);
+    status.components.transcripts_dir = {
+      ok: true,
+      path: projectsDir,
+    };
+  } catch (e) {
+    // Not fatal — transcripts dir may not exist until first session.
+    status.components.transcripts_dir = {
+      ok: true,
+      path: projectsDir,
+      note: 'not yet created (normal for fresh install)',
+    };
+  }
+
+  // 6. Check session-manager's own logs (informational, not blocking).
+  const smLogsDir = path.join(
+    os.homedir(),
+    '.claude/session-manager/logs'
+  );
+  let logAge = null;
+  try {
+    const files = await fsp.readdir(smLogsDir);
+    if (files.length > 0) {
+      const latestLog = files.sort().pop();
+      const logPath = path.join(smLogsDir, latestLog);
+      const stat = await fsp.stat(logPath);
+      logAge = Date.now() - stat.mtimeMs;
+    }
+    status.components.app_logs = {
+      ok: true,
+      path: smLogsDir,
+      latestLogAgeMs: logAge,
+      note: logAge ? `Last log ${Math.round(logAge / 60_000)}m ago` : 'app not yet run',
+    };
+  } catch (e) {
+    status.components.app_logs = {
+      ok: true,
+      path: smLogsDir,
+      note: 'logs directory not yet created (normal for fresh installs)',
+    };
+  }
+
+  // 7. Summary scoring: ok if all critical components pass.
+  // Critical: nodejs, config dir, typescript, build artifact, test infrastructure.
+  // Non-fatal: scheduler/transcripts dirs may not exist on fresh install.
+  // Informational: app log age (shows if app is running, but not blocking).
+  const criticalComponents = ['nodejs', 'config_dir', 'typescript', 'build_artifact', 'test_infrastructure'];
+  status.ok = criticalComponents.every((c) => status.components[c]?.ok !== false);
+
+  status.elapsedMs = Date.now() - start;
+  return status;
+}
+
+// CLI entry point: `node src/main/health.cjs`
+if (require.main === module) {
+  (async () => {
+    const result = await check();
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(result.ok ? 0 : 1);
+  })();
+}
+
+module.exports = { check };

package/src/main/historyAggregator.cjs

@@ -153,14 +153,7 @@ async function parseConversationMeta(filePath, stat) {
   return meta;
 }
 
-function registerHistoryAggregatorHandlers() {
-  ipcMain.handle('history:aggregate', async (_e, rawReq) => {
-    // Wire the historyAggregate schema (previously defined but never used).
-    // safeParse so a malformed payload still falls through to defaults
-    // (today − 30d) rather than throwing — matches the current "best-effort"
-    // semantics expected by the History tab.
-    const parsed = schemas.historyAggregate.safeParse(rawReq);
-    const req = parsed.success ? (parsed.data ?? {}) : {};
+async function aggregate(req) {
     const t0 = Date.now();
     const today = localDate(new Date());
     let effectiveTo = req?.toDate ? req.toDate : today;
@@ -258,6 +251,17 @@ function registerHistoryAggregatorHandlers() {
 
     const scannedMs = Date.now() - t0;
     return { rows, partial, scannedMs, skippedLargeFiles };
+}
+
+function registerHistoryAggregatorHandlers() {
+  ipcMain.handle('history:aggregate', async (_e, rawReq) => {
+    // Wire the historyAggregate schema (previously defined but never used).
+    // safeParse so a malformed payload still falls through to defaults
+    // (today − 30d) rather than throwing — matches the current "best-effort"
+    // semantics expected by the History tab.
+    const parsed = schemas.historyAggregate.safeParse(rawReq);
+    const req = parsed.success ? (parsed.data ?? {}) : {};
+    return aggregate(req);
   });
 
   /** Per-conversation metadata: one row per JSONL with derived duration +
@@ -303,4 +307,6 @@ function registerHistoryAggregatorHandlers() {
   });
 }
 
-module.exports = { registerHistoryAggregatorHandlers };
+const remote = { aggregate };
+
+module.exports = { registerHistoryAggregatorHandlers, remote };

package/src/main/index.cjs

@@ -35,11 +35,11 @@ const { registerDocEditorHandlers } = require('./docEditor.cjs');
 const git = require('./git.cjs');
 const superagent = require('./superagent.cjs');
 const kg = require('./kg.cjs');
-const { registerProjectSkillsHandlers } = require('./projectSkills.cjs');
 const filesIpc = require('./files.cjs');
 const searchIpc = require('./search.cjs');
 const repoAnalyzer = require('./repoAnalyzer.cjs');
 const hivesIpc = require('./hives.cjs');
+const webRemote = require('./webRemote.cjs');
 const { resolveClaudeBin } = require('./lib/claudeBin.cjs');
 const { checkInsideHome, assertInsideHome } = require('./lib/insideHome.cjs');
 const { openInEditor, openFileInEditor, openInFinder, openInTerminal } = require('./lib/openExternalApp.cjs');
@@ -626,11 +626,11 @@ agentMemory.registerAgentMemoryHandlers();
 registerDocEditorHandlers();
 git.register(ipcMain);
 superagent.registerSuperAgentHandlers();
-registerProjectSkillsHandlers();
 filesIpc.registerFilesHandlers();
 searchIpc.registerSearchHandlers();
 repoAnalyzer.register(ipcMain);
 hivesIpc.registerHiveHandlers();
+webRemote.registerRemoteHandlers();
 
 // OTEL telemetry export (opt-in via ~/.config/session-manager/otel.json).
 ipcMain.handle('otel:get-config', async () => otelSettings.load());
@@ -918,9 +918,13 @@ app.whenReady().then(async () => {
   pluginInstall.attachWindow(mainWindow);
   superagent.attachWindow(mainWindow);
   kg.attachWindow(mainWindow);
+  webRemote.attachWindow(mainWindow);
   scheduler.init().catch((e) => {
     logs.writeLine({ scope: 'scheduler', level: 'error', message: 'init failed', meta: { error: e?.message } });
   });
+  webRemote.init().catch((e) => {
+    logs.writeLine({ scope: 'webRemote', level: 'error', message: 'init failed', meta: { error: e?.message } });
+  });
   // Knowledge Graph: watch the prompt log + register kg:* IPC. Best-effort.
   try { kg.init({ logger: logs }); } catch (e) {
     logs.writeLine({ scope: 'kg', level: 'error', message: 'init failed', meta: { error: e?.message } });
@@ -964,6 +968,7 @@ let teardownDone = false;
 function runShutdownCleanup() {
   if (teardownDone) return;          // idempotent — will-quit may still fire after an app.exit path
   teardownDone = true;
+  webRemote.destroy();
   // Mark a clean exit so the next boot can distinguish a graceful quit from an
   // OOM-kill / native crash (which leaves the sentinel `open`).
   crashDiagnostics.markCleanShutdown();

package/src/main/ipcSchemas.cjs

@@ -242,6 +242,23 @@ const agentMemoryDelete = z.object({
   entryId: z.string().regex(AGENT_MEMORY_ID_RE),
 }).strict();
 
+// ──────────────────────────────────────────── Web Remote
+// OTP is 8 uppercase alphanumeric chars (case-insensitive entry, normalised to upper in handler).
+const WEB_REMOTE_OTP_RE = /^[A-Z0-9]{8}$/i;
+const DEVICE_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+
+const webRemotePair = z.object({
+  otp: z.string().regex(WEB_REMOTE_OTP_RE),
+}).strict();
+
+const webRemoteRevokeDevice = z.object({
+  deviceId: z.string().regex(DEVICE_ID_RE),
+}).strict();
+
+const webRemoteAuditTail = z.object({
+  lines: z.number().int().min(1).max(500).optional(),
+}).strict();
+
 // ──────────────────────────────────────────── History
 const DATE_YYYY_MM_DD = /^\d{4}-\d{2}-\d{2}$/;
 
@@ -365,12 +382,38 @@ function validated(schema, handler) {
   };
 }
 
+// ──────────────────────────────────────────── Web Remote command allowlist
+// Single source of truth — imported by webRemote.cjs and by the unit test.
+// Only these type strings will ever reach a handler; all others are silently
+// dropped without leaking error details back to the relay (ADR §6.2).
+const ALLOWED_COMMANDS = new Set([
+  'cmd:sessions:load',
+  'cmd:sessions:save',
+  'cmd:pty:spawn',
+  'cmd:pty:write',
+  'cmd:pty:resize',
+  'cmd:pty:kill',
+  'cmd:schedule:state',
+  'cmd:schedule:read-prd',
+  'cmd:schedule:read-log',
+  'cmd:schedule:write-prd',
+  'cmd:schedule:reset-job',
+  'cmd:schedule:run-now',
+  'cmd:schedule:set-config',
+  'cmd:history:aggregate',
+  'cmd:app:version',
+]);
+
 module.exports = {
   // Centralized slug regex — used by scheduler.cjs and queueOps.cjs for
   // direct test()/match() containment checks alongside the zod parses.
   SCHEDULE_SLUG_RE,
   SCHEDULE_RUN_ID_RE,
+  ALLOWED_COMMANDS,
   schemas: {
+    webRemotePair,
+    webRemoteRevokeDevice,
+    webRemoteAuditTail,
     ptySpawn,
     ptyTabId,
     ptyWrite,

package/src/main/lib/reaperHelpers.cjs

@@ -0,0 +1,67 @@
+'use strict';
+
+/**
+ * reaperHelpers.cjs — pure helpers for the dead-process reaper in scheduler.cjs.
+ *
+ * Kept in a separate lib file so they can be unit-tested without importing
+ * scheduler.cjs (which requires electron/ipcMain).
+ */
+
+const fs = require('node:fs');
+const { readTail } = require('./fileTail.cjs');
+
+/**
+ * Return true if pid is alive AND its cmdline looks like a claude process.
+ *
+ * Guards against PID recycling: on Linux we read /proc/<pid>/cmdline and
+ * require /\bclaude\b/ in the command. On macOS (no /proc) we can't read
+ * cmdline, so we conservatively return true — never false-reap a live PID
+ * just because we can't verify its identity.
+ *
+ * Conservative by design: a false negative (live process treated as dead) is
+ * far worse than a late reap.
+ */
+function claudePidAlive(pid) {
+  if (!pid || typeof pid !== 'number' || pid <= 1) return false;
+  try { process.kill(pid, 0); } catch { return false; }
+  try {
+    const cmd = fs.readFileSync(`/proc/${pid}/cmdline`, 'utf8').replace(/\0/g, ' ');
+    return /\bclaude\b/.test(cmd);
+  } catch {
+    // Can't read cmdline (macOS, permission denied) → assume alive.
+    return true;
+  }
+}
+
+/**
+ * Classify the terminal outcome of a completed run by reading the last 64 KB
+ * of its log file and scanning for the LAST `{"type":"result"}` JSONL event.
+ *
+ * Returns:
+ *   'success'   — last result event has subtype=success and is_error !== true
+ *   'failed'    — last result event exists but indicates an error
+ *   'no_result' — no result event found in the tail (process may have been killed
+ *                 before emitting one, or the log is absent/empty)
+ *   'unknown'   — unexpected error reading/parsing (outer catch)
+ */
+function classifyRunOutcome(logPath) {
+  try {
+    const text = readTail(logPath, 65536);
+    let lastResult = null;
+    for (const line of text.split('\n')) {
+      const t = line.trim();
+      if (!t.startsWith('{')) continue;
+      try {
+        const obj = JSON.parse(t);
+        if (obj && obj.type === 'result') lastResult = obj;
+      } catch { /* partial line at tail boundary or non-JSON scheduler log line */ }
+    }
+    if (!lastResult) return 'no_result';
+    if (lastResult.subtype === 'success' && lastResult.is_error !== true) return 'success';
+    return 'failed';
+  } catch {
+    return 'unknown';
+  }
+}
+
+module.exports = { claudePidAlive, classifyRunOutcome };