portable-agent-layer 0.24.0 → 0.24.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.24.0",
+  "version": "0.24.2",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {

package/src/cli/index.ts

@@ -288,6 +288,38 @@ interface HookHealth {
   lastError: string | null;
 }
 
+function checkClaudeHooksRegistered(): boolean {
+  const settingsPath = resolve(platform.claudeDir(), "settings.json");
+  if (!existsSync(settingsPath)) return false;
+  try {
+    const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    const groups = settings?.hooks?.SessionStart;
+    if (!Array.isArray(groups)) return false;
+    return groups.some((g: { hooks?: { command?: string }[] }) =>
+      g?.hooks?.some((h) => h?.command?.includes("LoadContext"))
+    );
+  } catch {
+    return false;
+  }
+}
+
+function checkCursorHooksRegistered(): boolean {
+  const hooksPath = resolve(platform.cursorDir(), "hooks.json");
+  if (!existsSync(hooksPath)) return false;
+  try {
+    const data = JSON.parse(readFileSync(hooksPath, "utf-8"));
+    const hooks = data?.hooks?.sessionStart;
+    if (!Array.isArray(hooks)) return false;
+    return hooks.some((h: { command?: string }) => h?.command?.includes("LoadContext"));
+  } catch {
+    return false;
+  }
+}
+
+function checkOpencodePluginInstalled(): boolean {
+  return existsSync(resolve(platform.opencodeDir(), "plugins", "pal-plugin.ts"));
+}
+
 function checkHookHealth(home: string): HookHealth {
   const logPath = resolve(home, "memory", "state", "debug.log");
 
@@ -375,6 +407,97 @@ function doctor(silent = false): DoctorResult {
     ok(`PAL home: ${home}`);
     telosCount > 0 ? ok(`TELOS: ${telosCount} files`) : fail("TELOS: not scaffolded");
 
+    // Identity
+    const palSettingsPath = resolve(home, "memory", "pal-settings.json");
+    if (existsSync(palSettingsPath)) {
+      try {
+        const s = JSON.parse(readFileSync(palSettingsPath, "utf-8"));
+        const hasIdentity = s?.identity?.principal?.name && s?.identity?.ai?.name;
+        hasIdentity
+          ? ok("Identity configured")
+          : warn("Identity — incomplete (run 'pal cli install')");
+      } catch {
+        warn("Identity — could not read pal-settings.json");
+      }
+    } else {
+      warn("Identity — pal-settings.json missing (run 'pal cli install')");
+    }
+
+    // AGENTS.md
+    const agentsMdPath = resolve(platform.opencodeDir(), "AGENTS.md");
+    existsSync(agentsMdPath)
+      ? ok("AGENTS.md present")
+      : fail("AGENTS.md — missing (run 'pal cli install')");
+
+    if (claude.available) {
+      const claudeMdPath = resolve(platform.claudeDir(), "CLAUDE.md");
+      existsSync(claudeMdPath)
+        ? ok("CLAUDE.md present")
+        : fail("CLAUDE.md — missing (run 'pal cli install --claude')");
+    }
+
+    // Setup state
+    const setupPath = resolve(home, "memory", "state", "setup.json");
+    if (existsSync(setupPath)) {
+      try {
+        const setup = JSON.parse(readFileSync(setupPath, "utf-8"));
+        setup?.completed
+          ? ok("TELOS setup complete")
+          : warn("TELOS setup incomplete — run 'pal cli install' or start a session");
+      } catch {
+        warn("TELOS setup — could not read setup.json");
+      }
+    } else {
+      warn("TELOS setup — setup.json missing (run 'pal cli install')");
+    }
+
+    // Skills (per installed agent)
+    const countSkillsIn = (dir: string) =>
+      existsSync(dir)
+        ? readdirSync(dir).filter((f) => existsSync(resolve(dir, f, "SKILL.md"))).length
+        : 0;
+    if (claude.available) {
+      const n = countSkillsIn(resolve(platform.claudeDir(), "skills"));
+      n > 0
+        ? ok(`Claude Code skills: ${n}`)
+        : warn("Claude Code skills — none found (run 'pal cli install --claude')");
+    }
+    if (opencode.available) {
+      const n = countSkillsIn(resolve(platform.agentsDir(), "skills"));
+      n > 0
+        ? ok(`opencode skills: ${n}`)
+        : warn("opencode skills — none found (run 'pal cli install --opencode')");
+    }
+    if (cursor.available) {
+      const n = countSkillsIn(resolve(platform.cursorDir(), "skills"));
+      n > 0
+        ? ok(`Cursor skills: ${n}`)
+        : warn("Cursor skills — none found (run 'pal cli install --cursor')");
+    }
+
+    // Dependencies
+    const nodeModulesPath = resolve(palPkg(), "node_modules");
+    existsSync(nodeModulesPath)
+      ? ok("Dependencies installed")
+      : fail("Dependencies missing — run 'pal cli install'");
+
+    // Hook registration (per installed agent)
+    if (claude.available) {
+      checkClaudeHooksRegistered()
+        ? ok("Claude Code hooks registered")
+        : fail("Claude Code hooks — not registered (run 'pal cli install --claude')");
+    }
+    if (opencode.available) {
+      checkOpencodePluginInstalled()
+        ? ok("opencode plugin installed")
+        : fail("opencode plugin — not installed (run 'pal cli install --opencode')");
+    }
+    if (cursor.available) {
+      checkCursorHooksRegistered()
+        ? ok("Cursor hooks registered")
+        : fail("Cursor hooks — not registered (run 'pal cli install --cursor')");
+    }
+
     // API key checks
     process.env.PAL_ANTHROPIC_API_KEY
       ? ok("PAL_ANTHROPIC_API_KEY is set")
@@ -382,6 +505,12 @@ function doctor(silent = false): DoctorResult {
     process.env.PAL_GEMINI_API_KEY
       ? ok("PAL_GEMINI_API_KEY is set")
       : warn("PAL_GEMINI_API_KEY — not set (optional, for YouTube analysis)");
+    process.env.PAL_XAI_API_KEY
+      ? ok("PAL_XAI_API_KEY is set")
+      : warn("PAL_XAI_API_KEY — not set (optional, for Grok researcher)");
+    process.env.PAL_PERPLEXITY_API_KEY
+      ? ok("PAL_PERPLEXITY_API_KEY is set")
+      : warn("PAL_PERPLEXITY_API_KEY — not set (optional, for Perplexity researcher)");
 
     // Hook health from debug.log
     const hookHealth = checkHookHealth(home);