@ai-devkit/agent-manager 0.32.0 → 0.33.0

package/dist/readiness/AgentReadiness.js

@@ -1,36 +1,36 @@
-import { constants } from 'node:fs';
-import { access as fsAccess, readFile as fsReadFile } from 'node:fs/promises';
-import { execFile } from 'node:child_process';
-import { delimiter, join } from 'node:path';
-import { promisify } from 'node:util';
-import { getCodexCapacityReport } from '../capacity/index.js';
-import { AGENTS } from '../utils/agents.js';
+import { constants } from "node:fs";
+import { access as fsAccess, readFile as fsReadFile } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { delimiter, join } from "node:path";
+import { promisify } from "node:util";
+import { getCodexCapacityReport } from "../capacity/index.js";
+import { AGENTS } from "../utils/agents.js";
 const execFileAsync = promisify(execFile);
 const READINESS_AGENT_TYPES = [
-    'claude',
-    'codex',
-    'copilot',
-    'grok_cli',
-    'opencode',
-    'pi'
+    "claude",
+    "codex",
+    "copilot",
+    "grok_cli",
+    "opencode",
+    "pi"
 ];
-const ANSI_ESCAPE_PATTERN = new RegExp(`${String.fromCharCode(27)}\\[[0-?]*[ -/]*[@-~]`, 'g');
+const ANSI_ESCAPE_PATTERN = new RegExp(`${String.fromCharCode(27)}\\[[0-?]*[ -/]*[@-~]`, "g");
 const AGENT_HOME_DIRS = {
-    claude: '.claude',
-    codex: '.codex',
-    copilot: '.copilot',
-    grok_cli: '.grok',
-    opencode: '.config/opencode',
-    pi: '.pi'
+    claude: ".claude",
+    codex: ".codex",
+    copilot: ".copilot",
+    grok_cli: ".grok",
+    opencode: ".config/opencode",
+    pi: ".pi"
 };
 function runtime(options) {
     return {
-        homeDir: options.homeDir ?? process.env.HOME ?? '',
-        path: options.path ?? process.env.PATH ?? '',
+        homeDir: options.homeDir ?? process.env.HOME ?? "",
+        path: options.path ?? process.env.PATH ?? "",
         assetRoot: options.assetRoot ?? null,
         builtInSkillNames: options.builtInSkillNames ?? [],
         skillRoots: options.skillRoots ?? {},
-        readFile: options.readFile ?? ((target)=>fsReadFile(target, 'utf8')),
+        readFile: options.readFile ?? ((target)=>fsReadFile(target, "utf8")),
         access: options.access ?? ((target, mode = constants.R_OK)=>fsAccess(target, mode)),
         runCommand: options.runCommand ?? defaultRunCommand,
         codexAuth: options.codexAuth ?? (async ()=>(await getCodexCapacityReport()).authenticated)
@@ -38,7 +38,7 @@ function runtime(options) {
 }
 async function defaultRunCommand(command, args) {
     const result = await execFileAsync(command, args, {
-        encoding: 'utf8',
+        encoding: "utf8",
         timeout: 5000,
         maxBuffer: 1024 * 1024
     });
@@ -48,19 +48,19 @@ async function defaultRunCommand(command, args) {
     };
 }
 function statusRank(status) {
-    return status === 'fail' ? 2 : status === 'warn' ? 1 : 0;
+    return status === "fail" ? 2 : status === "warn" ? 1 : 0;
 }
 export function worstReadinessStatus(statuses) {
-    return statuses.reduce((worst, current)=>statusRank(current) > statusRank(worst) ? current : worst, 'pass');
+    return statuses.reduce((worst, current)=>statusRank(current) > statusRank(worst) ? current : worst, "pass");
 }
 function displayHome(target, homeDir) {
-    return target === homeDir ? '~' : target.startsWith(`${homeDir}/`) ? `~${target.slice(homeDir.length)}` : target;
+    return target === homeDir ? "~" : target.startsWith(`${homeDir}/`) ? `~${target.slice(homeDir.length)}` : target;
 }
 function record(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null;
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
 function nonEmpty(value) {
-    return typeof value === 'string' && value.trim().length > 0;
+    return typeof value === "string" && value.trim().length > 0;
 }
 async function accessible(target, rt, mode = constants.R_OK) {
     try {
@@ -84,7 +84,7 @@ async function executableCheck(agent, rt) {
     return {
         command,
         path: resolvedPath,
-        status: resolvedPath ? 'pass' : 'fail',
+        status: resolvedPath ? "pass" : "fail",
         errors: resolvedPath ? [] : [
             `${command} was not found on PATH`
         ]
@@ -97,9 +97,9 @@ async function directoryCheck(agent, rt) {
         path: displayHome(target, rt.homeDir),
         present: readable,
         readable,
-        status: readable ? 'pass' : 'fail',
+        status: readable ? "pass" : "fail",
         errors: readable ? [] : [
-            'global configuration directory is unavailable'
+            "global configuration directory is unavailable"
         ]
     };
 }
@@ -113,14 +113,14 @@ async function builtInSkillsCheck(agent, rt) {
             missing: [
                 ...rt.builtInSkillNames
             ],
-            status: 'info',
+            status: "info",
             errors: []
         };
     }
     const root = join(rt.homeDir, relativeRoot);
     const checks = await Promise.all(rt.builtInSkillNames.map(async (name)=>({
             name,
-            present: await accessible(join(root, name, 'SKILL.md'), rt)
+            present: await accessible(join(root, name, "SKILL.md"), rt)
         })));
     const present = checks.filter((check)=>check.present).map((check)=>check.name);
     const missing = rt.builtInSkillNames.filter((name)=>!present.includes(name));
@@ -131,7 +131,7 @@ async function builtInSkillsCheck(agent, rt) {
         missing: [
             ...missing
         ],
-        status: 'info',
+        status: "info",
         errors: []
     };
 }
@@ -145,9 +145,9 @@ async function scriptCheck(installed, bundled, rt) {
             present: false,
             readable: false,
             matchesBundledAsset: false,
-            status: 'fail',
+            status: "fail",
             errors: [
-                'hook script is unavailable'
+                "hook script is unavailable"
             ]
         };
     }
@@ -159,9 +159,9 @@ async function scriptCheck(installed, bundled, rt) {
             present: true,
             readable: true,
             matchesBundledAsset: matches,
-            status: matches ? 'pass' : 'fail',
+            status: matches ? "pass" : "fail",
             errors: matches ? [] : [
-                'hook script differs from the bundled AI DevKit asset'
+                "hook script differs from the bundled AI DevKit asset"
             ]
         };
     } catch  {
@@ -170,9 +170,9 @@ async function scriptCheck(installed, bundled, rt) {
             present: true,
             readable: true,
             matchesBundledAsset: false,
-            status: 'fail',
+            status: "fail",
             errors: [
-                'bundled hook asset is unavailable'
+                "bundled hook asset is unavailable"
             ]
         };
     }
@@ -185,7 +185,7 @@ function containsHook(root, event, command) {
         const commands = record(entry)?.hooks;
         return Array.isArray(commands) && commands.some((hook)=>{
             const item = record(hook);
-            return item?.type === 'command' && item.command === command;
+            return item?.type === "command" && item.command === command;
         });
     });
 }
@@ -199,9 +199,9 @@ async function registrationCheck(target, event, command, rt) {
             command,
             present: true,
             valid,
-            status: valid ? 'pass' : 'fail',
+            status: valid ? "pass" : "fail",
             errors: valid ? [] : [
-                'required hook registration is missing'
+                "required hook registration is missing"
             ]
         };
     } catch  {
@@ -211,9 +211,9 @@ async function registrationCheck(target, event, command, rt) {
             command,
             present: false,
             valid: false,
-            status: 'fail',
+            status: "fail",
             errors: [
-                'hook configuration is missing or invalid'
+                "hook configuration is missing or invalid"
             ]
         };
     }
@@ -229,9 +229,9 @@ async function mappingCheck(target, rt) {
             valid: false,
             invalidEntries: 0,
             staleEntries: 0,
-            status: 'warn',
+            status: "warn",
             errors: [
-                'session mapping has not been created'
+                "session mapping has not been created"
             ]
         };
     }
@@ -248,14 +248,14 @@ async function mappingCheck(target, rt) {
             valid: false,
             invalidEntries: 0,
             staleEntries: 0,
-            status: 'fail',
+            status: "fail",
             errors: [
-                'session mapping is invalid'
+                "session mapping is invalid"
             ]
         };
     }
     const entries = await Promise.all(Object.entries(parsed).map(async ([pid, sessionPath])=>{
-        if (!/^\d+$/.test(pid) || typeof sessionPath !== 'string' || !sessionPath) {
+        if (!/^\d+$/.test(pid) || typeof sessionPath !== "string" || !sessionPath) {
             return {
                 valid: false,
                 stale: false
@@ -275,11 +275,11 @@ async function mappingCheck(target, rt) {
         valid,
         invalidEntries,
         staleEntries,
-        status: !valid ? 'fail' : staleEntries ? 'warn' : 'pass',
+        status: !valid ? "fail" : staleEntries ? "warn" : "pass",
         errors: !valid ? [
-            'session mapping contains invalid entries'
+            "session mapping contains invalid entries"
         ] : staleEntries ? [
-            'session mapping contains stale entries'
+            "session mapping contains stale entries"
         ] : []
     };
 }
@@ -287,57 +287,57 @@ async function codexAuthCheck(rt) {
     try {
         const value = await rt.codexAuth();
         return {
-            state: value === true ? 'authenticated' : value === false ? 'unauthenticated' : 'unknown',
-            source: displayHome(join(rt.homeDir, '.codex', 'auth.json'), rt.homeDir),
+            state: value === true ? "authenticated" : value === false ? "unauthenticated" : "unknown",
+            source: displayHome(join(rt.homeDir, ".codex", "auth.json"), rt.homeDir),
             provider: null,
             availableProviders: [],
-            status: value === true ? 'pass' : value === false ? 'fail' : 'warn',
+            status: value === true ? "pass" : value === false ? "fail" : "warn",
             errors: value === true ? [] : [
-                value === false ? 'Codex is not authenticated' : 'Codex authentication is unknown'
+                value === false ? "Codex is not authenticated" : "Codex authentication is unknown"
             ]
         };
     } catch  {
         return {
-            state: 'unknown',
-            source: '~/.codex/auth.json',
+            state: "unknown",
+            source: "~/.codex/auth.json",
             provider: null,
             availableProviders: [],
-            status: 'warn',
+            status: "warn",
             errors: [
-                'Codex authentication probe failed'
+                "Codex authentication probe failed"
             ]
         };
     }
 }
 async function claudeAuthCheck(rt) {
     try {
-        const result = await rt.runCommand('claude', [
-            'auth',
-            'status',
-            '--json'
+        const result = await rt.runCommand("claude", [
+            "auth",
+            "status",
+            "--json"
         ]);
         const parsed = record(JSON.parse(result.stdout));
         const authenticated = parsed?.loggedIn === true || parsed?.authenticated === true;
         const unauthenticated = parsed?.loggedIn === false || parsed?.authenticated === false;
         return {
-            state: authenticated ? 'authenticated' : unauthenticated ? 'unauthenticated' : 'unknown',
-            source: 'claude auth status --json',
+            state: authenticated ? "authenticated" : unauthenticated ? "unauthenticated" : "unknown",
+            source: "claude auth status --json",
             provider: null,
             availableProviders: [],
-            status: authenticated ? 'pass' : unauthenticated ? 'fail' : 'warn',
+            status: authenticated ? "pass" : unauthenticated ? "fail" : "warn",
             errors: authenticated ? [] : [
-                unauthenticated ? 'Claude is not authenticated' : 'Claude authentication is unknown'
+                unauthenticated ? "Claude is not authenticated" : "Claude authentication is unknown"
             ]
         };
     } catch  {
         return {
-            state: 'unknown',
-            source: 'claude auth status --json',
+            state: "unknown",
+            source: "claude auth status --json",
             provider: null,
             availableProviders: [],
-            status: 'warn',
+            status: "warn",
             errors: [
-                'Claude authentication probe failed'
+                "Claude authentication probe failed"
             ]
         };
     }
@@ -352,7 +352,7 @@ function piProviderNames(parsed) {
         }
     }
     for (const [name, value] of Object.entries(parsed)){
-        if (name === 'provider' || name === 'providers') continue;
+        if (name === "provider" || name === "providers") continue;
         if (record(value) && name.trim()) names.add(name);
     }
     return [
@@ -360,96 +360,96 @@ function piProviderNames(parsed) {
     ].sort();
 }
 async function piAuthCheck(rt) {
-    const sourcePath = join(rt.homeDir, '.pi', 'agent', 'auth.json');
+    const sourcePath = join(rt.homeDir, ".pi", "agent", "auth.json");
     try {
         const parsed = record(JSON.parse(await rt.readFile(sourcePath)));
-        if (!parsed) throw new Error('invalid');
+        if (!parsed) throw new Error("invalid");
         const availableProviders = piProviderNames(parsed);
         const provider = nonEmpty(parsed.provider) ? parsed.provider.trim() : null;
         const authenticated = availableProviders.length > 0;
         return {
-            state: authenticated ? 'authenticated' : 'unauthenticated',
+            state: authenticated ? "authenticated" : "unauthenticated",
             source: displayHome(sourcePath, rt.homeDir),
             provider,
             availableProviders,
-            status: authenticated ? 'pass' : 'fail',
+            status: authenticated ? "pass" : "fail",
             errors: authenticated ? [] : [
-                'Pi credential file has no configured model provider'
+                "Pi credential file has no configured model provider"
             ]
         };
     } catch  {
         return {
-            state: 'unauthenticated',
+            state: "unauthenticated",
             source: displayHome(sourcePath, rt.homeDir),
             provider: null,
             availableProviders: [],
-            status: 'fail',
+            status: "fail",
             errors: [
-                'Pi credential file is missing or invalid'
+                "Pi credential file is missing or invalid"
             ]
         };
     }
 }
 async function opencodeAuthCheck(rt) {
     try {
-        const result = await rt.runCommand('opencode', [
-            'auth',
-            'list'
+        const result = await rt.runCommand("opencode", [
+            "auth",
+            "list"
         ]);
         const availableProviders = opencodeAuthProviderNames(result.stdout);
         const authenticated = availableProviders.length > 0;
         return {
-            state: authenticated ? 'authenticated' : 'unauthenticated',
-            source: 'opencode auth list',
+            state: authenticated ? "authenticated" : "unauthenticated",
+            source: "opencode auth list",
             provider: null,
             availableProviders,
-            status: authenticated ? 'pass' : 'fail',
+            status: authenticated ? "pass" : "fail",
             errors: authenticated ? [] : [
-                'OpenCode has no configured credentials'
+                "OpenCode has no configured credentials"
             ]
         };
     } catch  {
         return {
-            state: 'unknown',
-            source: 'opencode auth list',
+            state: "unknown",
+            source: "opencode auth list",
             provider: null,
             availableProviders: [],
-            status: 'warn',
+            status: "warn",
             errors: [
-                'OpenCode authentication probe failed'
+                "OpenCode authentication probe failed"
             ]
         };
     }
 }
 async function copilotAuthCheck(rt) {
     try {
-        await rt.runCommand('gh', [
-            'auth',
-            'status',
-            '--hostname',
-            'github.com'
+        await rt.runCommand("gh", [
+            "auth",
+            "status",
+            "--hostname",
+            "github.com"
         ]);
         return {
-            state: 'authenticated',
-            source: 'gh auth status --hostname github.com',
-            provider: 'github',
+            state: "authenticated",
+            source: "gh auth status --hostname github.com",
+            provider: "github",
             availableProviders: [
-                'GitHub'
+                "GitHub"
             ],
-            status: 'pass',
+            status: "pass",
             errors: []
         };
     } catch  {
         return {
-            state: 'unknown',
-            source: 'gh auth status --hostname github.com',
+            state: "unknown",
+            source: "gh auth status --hostname github.com",
             provider: null,
             availableProviders: [
-                'GitHub'
+                "GitHub"
             ],
-            status: 'warn',
+            status: "warn",
             errors: [
-                'Copilot authentication could not be verified through GitHub CLI'
+                "Copilot authentication could not be verified through GitHub CLI"
             ]
         };
     }
@@ -459,7 +459,7 @@ function opencodeAuthProviderNames(output) {
     for (const line of stripAnsi(output).split(/\r?\n/)){
         const match = /^\s*[●*+-]\s+(.+?)\s*$/.exec(line);
         if (!match) continue;
-        const name = match[1].replace(/\s+(?:api|oauth|[\w-]*token|[A-Z][A-Z0-9_]+)$/i, '').trim();
+        const name = match[1].replace(/\s+(?:api|oauth|[\w-]*token|[A-Z][A-Z0-9_]+)$/i, "").trim();
         if (name && !/^\d+\s+(?:credentials?|environment variables?)$/i.test(name)) names.add(name);
     }
     return [
@@ -467,15 +467,15 @@ function opencodeAuthProviderNames(output) {
     ].sort();
 }
 function stripAnsi(value) {
-    return value.replace(ANSI_ESCAPE_PATTERN, '');
+    return value.replace(ANSI_ESCAPE_PATTERN, "");
 }
 async function codexIntegrationCheck(rt) {
-    const script = await scriptCheck(join(rt.homeDir, '.codex', 'hooks', 'codex-session-mapping.cjs'), join(rt.assetRoot ?? '', 'codex', 'codex-session-mapping.cjs'), rt);
-    const registration = await registrationCheck(join(rt.homeDir, '.codex', 'hooks.json'), 'SessionStart', 'node ~/.codex/hooks/codex-session-mapping.cjs', rt);
-    const mappingFile = await mappingCheck(join(rt.homeDir, '.codex', 'ai-devkit', 'sessions.json'), rt);
-    const installed = script.status === 'pass' && registration.status === 'pass';
+    const script = await scriptCheck(join(rt.homeDir, ".codex", "hooks", "codex-session-mapping.cjs"), join(rt.assetRoot ?? "", "codex", "codex-session-mapping.cjs"), rt);
+    const registration = await registrationCheck(join(rt.homeDir, ".codex", "hooks.json"), "SessionStart", "node ~/.codex/hooks/codex-session-mapping.cjs", rt);
+    const mappingFile = await mappingCheck(join(rt.homeDir, ".codex", "ai-devkit", "sessions.json"), rt);
+    const installed = script.status === "pass" && registration.status === "pass";
     return {
-        label: 'ai-devkit hook',
+        label: "ai-devkit hook",
         installed,
         status: worstReadinessStatus([
             script.status,
@@ -495,11 +495,11 @@ async function codexIntegrationCheck(rt) {
     };
 }
 async function claudeIntegrationCheck(rt) {
-    const script = await scriptCheck(join(rt.homeDir, '.claude', 'hooks', 'claude-prompt-hook.js'), join(rt.assetRoot ?? '', 'claude', 'claude-prompt-hook.js'), rt);
-    const registration = await registrationCheck(join(rt.homeDir, '.claude', 'settings.json'), 'PreToolUse', 'node ~/.claude/hooks/claude-prompt-hook.js', rt);
-    const installed = script.status === 'pass' && registration.status === 'pass';
+    const script = await scriptCheck(join(rt.homeDir, ".claude", "hooks", "claude-prompt-hook.js"), join(rt.assetRoot ?? "", "claude", "claude-prompt-hook.js"), rt);
+    const registration = await registrationCheck(join(rt.homeDir, ".claude", "settings.json"), "PreToolUse", "node ~/.claude/hooks/claude-prompt-hook.js", rt);
+    const installed = script.status === "pass" && registration.status === "pass";
     return {
-        label: 'ai-devkit hook',
+        label: "ai-devkit hook",
         installed,
         status: worstReadinessStatus([
             script.status,
@@ -518,31 +518,31 @@ async function claudeIntegrationCheck(rt) {
 async function piIntegrationCheck(rt) {
     let installed = false;
     try {
-        const result = await rt.runCommand('pi', [
-            'list'
+        const result = await rt.runCommand("pi", [
+            "list"
         ]);
         installed = isPiSessionTrackerListed(result.stdout);
     } catch  {
     // Safe fixed result below.
     }
-    const mapping = await mappingCheck(join(rt.homeDir, '.pi', 'agent', 'sessions.json'), rt);
-    const mappingStatus = mapping.valid || !mapping.present ? 'pass' : 'fail';
+    const mapping = await mappingCheck(join(rt.homeDir, ".pi", "agent", "sessions.json"), rt);
+    const mappingStatus = mapping.valid || !mapping.present ? "pass" : "fail";
     const status = worstReadinessStatus([
-        installed ? 'pass' : 'fail',
+        installed ? "pass" : "fail",
         mappingStatus
     ]);
     return {
-        label: 'ai-devkit plugin',
+        label: "ai-devkit plugin",
         installed,
         status,
         errors: [
             ...!installed ? [
-                'Pi session tracker is not registered'
+                "Pi session tracker is not registered"
             ] : [],
-            ...mappingStatus === 'fail' ? mapping.errors : []
+            ...mappingStatus === "fail" ? mapping.errors : []
         ],
         details: {
-            package: '@ai-devkit/pi-session-tracker',
+            package: "@ai-devkit/pi-session-tracker",
             registryPath: mapping.path,
             registryValid: mapping.valid,
             invalidEntries: mapping.invalidEntries,
@@ -552,7 +552,7 @@ async function piIntegrationCheck(rt) {
 }
 function isPiSessionTrackerListed(output) {
     const normalized = output.toLowerCase();
-    return normalized.includes('@ai-devkit/pi-session-tracker') || /\bsession[\s-]+tracker\b/.test(normalized);
+    return normalized.includes("@ai-devkit/pi-session-tracker") || /\bsession[\s-]+tracker\b/.test(normalized);
 }
 const AUTH_CHECKS = {
     claude: claudeAuthCheck,