@creativeintelligence/abbie 0.1.0

package/dist/lib/doctor/index.js

@@ -0,0 +1,547 @@
+/**
+ * Doctor - Environment validation for abbie CLI
+ *
+ * Checks:
+ * - ~/.abbie directories existence
+ * - Runtime detection (node/bun)
+ * - Agent binaries (claude, codex, copilot, gemini)
+ * - Optional tools (slack, messages, linear) - warn not fail
+ * - Template system (v2)
+ * - Per-repo contracts (v2)
+ */
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, accessSync, constants as fsConstants } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { getDefaultSlackWorkspace, toSlackTokenEnvVar } from "../slack-workspace.js";
+import { checkRepos, summarizeRepoChecks } from "./repos.js";
+// v2 imports
+import { checkTemplates } from "./templates.js";
+import { getSyncDir, getAdapter, getLatestBackup } from "../config-sync/index.js";
+// ============================================================================
+// Directory checks
+// ============================================================================
+const REQUIRED_DIRS = ["plans", "active-sessions", "prompts", "events", "resources"];
+function getAgentsRoot() {
+    return join(homedir(), ".abbie");
+}
+export function checkDirectories() {
+    const root = getAgentsRoot();
+    const checks = [];
+    // Check root directory
+    if (existsSync(root)) {
+        checks.push({
+            name: "agents-root",
+            status: "ok",
+            detail: `~/.abbie exists`,
+        });
+    }
+    else {
+        checks.push({
+            name: "agents-root",
+            status: "missing",
+            detail: `~/.abbie directory not found`,
+        });
+    }
+    // Check subdirectories
+    for (const dir of REQUIRED_DIRS) {
+        const path = join(root, dir);
+        if (existsSync(path)) {
+            checks.push({
+                name: `dir-${dir}`,
+                status: "ok",
+                detail: `~/.abbie/${dir} exists`,
+            });
+        }
+        else {
+            checks.push({
+                name: `dir-${dir}`,
+                status: "missing",
+                detail: `~/.abbie/${dir} not found`,
+            });
+        }
+    }
+    return checks;
+}
+export function fixDirectories() {
+    const root = getAgentsRoot();
+    const created = [];
+    // Create root if missing
+    if (!existsSync(root)) {
+        mkdirSync(root, { recursive: true });
+        created.push(root);
+    }
+    // Create subdirectories
+    for (const dir of REQUIRED_DIRS) {
+        const path = join(root, dir);
+        if (!existsSync(path)) {
+            mkdirSync(path, { recursive: true });
+            created.push(path);
+        }
+    }
+    return created;
+}
+// ============================================================================
+// Runtime detection
+// ============================================================================
+export function checkRuntime() {
+    // Check if running under bun or node
+    const isBun = typeof process.versions.bun !== "undefined";
+    const runtime = isBun ? "bun" : "node";
+    const version = isBun ? process.versions.bun : process.versions.node;
+    return {
+        name: "runtime",
+        status: "ok",
+        detail: `${runtime} ${version}`,
+    };
+}
+// ============================================================================
+// Binary checks
+// ============================================================================
+function commandExists(cmd) {
+    try {
+        // Try to get version - most CLIs support --version
+        const output = execSync(`${cmd} --version 2>/dev/null`, {
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        // Extract first line and limit length
+        const version = output.split("\n")[0]?.slice(0, 50) || "installed";
+        return { exists: true, version };
+    }
+    catch {
+        // Try just running with no args to see if it exists
+        try {
+            execSync(`which ${cmd} 2>/dev/null`, {
+                encoding: "utf-8",
+                timeout: 2000,
+            });
+            return { exists: true, version: "installed" };
+        }
+        catch {
+            return { exists: false };
+        }
+    }
+}
+// Core agents expected on every machine. Extended agents (pi, opencode, droid) are optional.
+const REQUIRED_BINARIES = ["claude", "codex", "copilot", "gemini"];
+const _OPTIONAL_AGENT_BINARIES = ["pi", "opencode", "droid"];
+const OPTIONAL_BINARIES = ["slack", "messages", "linear"];
+export function checkBinaries() {
+    const checks = [];
+    // Required binaries - status: ok or missing
+    for (const bin of REQUIRED_BINARIES) {
+        const result = commandExists(bin);
+        if (result.exists) {
+            checks.push({
+                name: `bin-${bin}`,
+                status: "ok",
+                detail: result.version || "installed",
+            });
+        }
+        else {
+            checks.push({
+                name: `bin-${bin}`,
+                status: "missing",
+                detail: `${bin} not found in PATH`,
+            });
+        }
+    }
+    // Optional binaries - status: ok or warn (not missing)
+    for (const bin of OPTIONAL_BINARIES) {
+        const result = commandExists(bin);
+        if (result.exists) {
+            checks.push({
+                name: `bin-${bin}`,
+                status: "ok",
+                detail: result.version || "installed",
+            });
+        }
+        else {
+            checks.push({
+                name: `bin-${bin}`,
+                status: "warn",
+                detail: `${bin} not found (optional)`,
+            });
+        }
+    }
+    return checks;
+}
+// ============================================================================
+// Environment variable checks
+// ============================================================================
+const DEFAULT_SLACK_WORKSPACE = getDefaultSlackWorkspace();
+const OPTIONAL_ENV_VARS = [
+    { name: "LINEAR_API_KEY", description: "Linear integration" },
+    { name: "SLACK_BOT_TOKEN", description: "Slack integration" },
+    {
+        name: toSlackTokenEnvVar(DEFAULT_SLACK_WORKSPACE),
+        description: `Slack (${DEFAULT_SLACK_WORKSPACE} workspace)`,
+    },
+];
+export function checkEnvVars() {
+    const checks = [];
+    for (const { name, description } of OPTIONAL_ENV_VARS) {
+        const value = process.env[name];
+        if (value) {
+            checks.push({
+                name: `env-${name}`,
+                status: "ok",
+                detail: `${description} configured`,
+            });
+        }
+        else {
+            checks.push({
+                name: `env-${name}`,
+                status: "warn",
+                detail: `${name} not set (${description})`,
+            });
+        }
+    }
+    return checks;
+}
+// ============================================================================
+// Symlink checks for unified tooling
+// ============================================================================
+import { lstatSync, readlinkSync } from "node:fs";
+const EXPECTED_SYMLINKS = [
+    {
+        name: "claude-commands",
+        path: join(homedir(), ".claude", "commands"),
+        expectedTarget: join(homedir(), ".abbie", "prompts", "commands", "core"),
+        description: "Claude Code commands",
+    },
+    {
+        name: "codex-prompts",
+        path: join(homedir(), ".codex", "prompts"),
+        expectedTarget: join(homedir(), ".abbie", "prompts", "commands", "core"),
+        description: "Codex custom prompts",
+    },
+    {
+        name: "claude-rules",
+        path: join(homedir(), ".claude", "rules"),
+        expectedTarget: join(homedir(), ".abbie", "rules"),
+        description: "Claude Code rules",
+    },
+    {
+        name: "codex-rules",
+        path: join(homedir(), ".codex", "rules"),
+        expectedTarget: join(homedir(), ".abbie", "rules"),
+        description: "Codex rules",
+    },
+    {
+        name: "claude-skills",
+        path: join(homedir(), ".claude", "skills"),
+        expectedTarget: join(homedir(), ".abbie", "skills"),
+        description: "Claude Code skills",
+    },
+    {
+        name: "codex-skills",
+        path: join(homedir(), ".codex", "skills"),
+        expectedTarget: join(homedir(), ".abbie", "skills"),
+        description: "Codex skills",
+    },
+    {
+        name: "copilot-skills",
+        path: join(homedir(), ".copilot", "skills"),
+        expectedTarget: join(homedir(), ".abbie", "skills"),
+        description: "Copilot CLI skills",
+    },
+];
+export function checkSymlinks() {
+    const checks = [];
+    for (const spec of EXPECTED_SYMLINKS) {
+        try {
+            const stats = lstatSync(spec.path);
+            if (stats.isSymbolicLink()) {
+                const target = readlinkSync(spec.path);
+                if (target === spec.expectedTarget) {
+                    checks.push({
+                        name: `symlink-${spec.name}`,
+                        status: "ok",
+                        detail: `${spec.description} → ~/.abbie/...`,
+                    });
+                }
+                else {
+                    checks.push({
+                        name: `symlink-${spec.name}`,
+                        status: "warn",
+                        detail: `${spec.description} points to ${target} (expected ${spec.expectedTarget})`,
+                    });
+                }
+            }
+            else {
+                checks.push({
+                    name: `symlink-${spec.name}`,
+                    status: "warn",
+                    detail: `${spec.description} exists but is not a symlink`,
+                });
+            }
+        }
+        catch {
+            checks.push({
+                name: `symlink-${spec.name}`,
+                status: "missing",
+                detail: `${spec.description} not found`,
+            });
+        }
+    }
+    return checks;
+}
+// ============================================================================
+// Fix suggestions
+// ============================================================================
+const SYMLINK_FIX_COMMANDS = {
+    "claude-commands": "ln -s ~/.abbie/prompts/commands/core ~/.claude/commands",
+    "codex-prompts": "ln -s ~/.abbie/prompts/commands/core ~/.codex/prompts",
+    "claude-rules": "ln -s ~/.abbie/rules ~/.claude/rules",
+    "codex-rules": "ln -s ~/.abbie/rules ~/.codex/rules",
+    "claude-skills": "ln -s ~/.abbie/skills ~/.claude/skills",
+    "codex-skills": "ln -s ~/.abbie/skills ~/.codex/skills",
+    "copilot-skills": "ln -s ~/.abbie/skills ~/.copilot/skills",
+};
+export function generateFixes(checks) {
+    const fixes = [];
+    for (const check of checks) {
+        if (check.status === "missing") {
+            // Directory fixes
+            if (check.name === "agents-root" || check.name.startsWith("dir-")) {
+                fixes.push({
+                    if: check.detail,
+                    hint: "Run `abbie doctor --fix` to create missing directories",
+                });
+            }
+            // Binary fixes
+            else if (check.name.startsWith("bin-")) {
+                const bin = check.name.replace("bin-", "");
+                const hints = {
+                    claude: "Install Claude Code: https://claude.ai/download",
+                    codex: "Install Codex: npm install -g @openai/codex",
+                    copilot: "Install Copilot CLI: npm install -g @github/copilot-cli",
+                    gemini: "Install Gemini CLI: npm install -g @google/gemini-cli",
+                };
+                fixes.push({
+                    if: check.detail,
+                    hint: hints[bin] || `Install ${bin}`,
+                });
+            }
+            // Symlink fixes
+            else if (check.name.startsWith("symlink-")) {
+                const name = check.name.replace("symlink-", "");
+                const cmd = SYMLINK_FIX_COMMANDS[name];
+                if (cmd) {
+                    fixes.push({
+                        if: check.detail,
+                        hint: `Create symlink: ${cmd}`,
+                    });
+                }
+            }
+        }
+        // Warn status for symlinks (wrong target or not a symlink)
+        else if (check.status === "warn" && check.name.startsWith("symlink-")) {
+            const name = check.name.replace("symlink-", "");
+            const cmd = SYMLINK_FIX_COMMANDS[name];
+            if (cmd) {
+                fixes.push({
+                    if: check.detail,
+                    hint: `Remove and recreate: rm -f <path> && ${cmd}`,
+                });
+            }
+        }
+    }
+    return fixes;
+}
+// ============================================================================
+// Config sync checks
+// ============================================================================
+export function checkConfigSync() {
+    const checks = [];
+    const syncDir = getSyncDir();
+    const statePath = join(syncDir, "config-sync-state.json");
+    // Check sync freshness
+    if (existsSync(statePath)) {
+        try {
+            const state = JSON.parse(readFileSync(statePath, "utf-8"));
+            const lastSync = state.lastSuccessAt ?? 0;
+            const hoursSinceSync = (Date.now() - lastSync) / (1000 * 60 * 60);
+            if (hoursSinceSync > 12) {
+                checks.push({
+                    name: "config-sync-freshness",
+                    status: "warn",
+                    detail: `Last config sync ${Math.round(hoursSinceSync)}h ago (>12h stale)`,
+                });
+            }
+            else {
+                checks.push({
+                    name: "config-sync-freshness",
+                    status: "ok",
+                    detail: `Last config sync ${Math.round(hoursSinceSync)}h ago`,
+                });
+            }
+            if (state.consecutiveFailures > 0) {
+                checks.push({
+                    name: "config-sync-failures",
+                    status: state.consecutiveFailures >= 5 ? "missing" : "warn",
+                    detail: `${state.consecutiveFailures} consecutive sync failures`,
+                });
+            }
+        }
+        catch {
+            checks.push({
+                name: "config-sync-freshness",
+                status: "warn",
+                detail: "Config sync state file corrupt",
+            });
+        }
+    }
+    else {
+        checks.push({
+            name: "config-sync-freshness",
+            status: "warn",
+            detail: "Config sync has never run",
+        });
+    }
+    // Check per-agent config file writability
+    const AGENTS = ["claude", "codex", "copilot", "gemini"];
+    for (const agent of AGENTS) {
+        const adapter = getAdapter(agent);
+        if (!adapter)
+            continue;
+        const configPath = adapter.configPath();
+        const dir = configPath.substring(0, configPath.lastIndexOf("/"));
+        if (existsSync(dir)) {
+            try {
+                accessSync(dir, fsConstants.W_OK);
+                checks.push({
+                    name: `config-${agent}-writable`,
+                    status: "ok",
+                    detail: `${configPath} directory writable`,
+                });
+            }
+            catch {
+                checks.push({
+                    name: `config-${agent}-writable`,
+                    status: "missing",
+                    detail: `${configPath} directory not writable`,
+                });
+            }
+        }
+        // Check if config file parses correctly
+        if (adapter.configExists()) {
+            try {
+                adapter.read();
+                checks.push({
+                    name: `config-${agent}-parseable`,
+                    status: "ok",
+                    detail: `${configPath} parses correctly`,
+                });
+            }
+            catch {
+                checks.push({
+                    name: `config-${agent}-parseable`,
+                    status: "warn",
+                    detail: `${configPath} failed to parse`,
+                });
+            }
+        }
+        // Check backup existence
+        const hasBackup = !!getLatestBackup(agent);
+        if (hasBackup) {
+            checks.push({
+                name: `config-${agent}-backup`,
+                status: "ok",
+                detail: `Backup exists for ${agent}`,
+            });
+        }
+        // Don't warn about missing backups — they appear after first sync
+    }
+    return checks;
+}
+export async function runDoctor(options = {}) {
+    const checks = [];
+    // Run all environment checks
+    checks.push(...checkDirectories());
+    checks.push(checkRuntime());
+    checks.push(...checkBinaries());
+    checks.push(...checkEnvVars());
+    checks.push(...checkSymlinks());
+    checks.push(...checkConfigSync());
+    // Apply fixes if requested
+    if (options.fix) {
+        const _created = fixDirectories();
+        // Update checks for fixed directories
+        for (const check of checks) {
+            if (check.status === "missing" &&
+                (check.name === "agents-root" || check.name.startsWith("dir-"))) {
+                check.status = "ok";
+                check.detail = `${check.detail.replace(" not found", "")} (created)`;
+            }
+        }
+    }
+    // Generate fix suggestions for remaining issues
+    const fixes = generateFixes(checks);
+    // v2: Template checks
+    let templateChecks;
+    if (options.includeTemplates) {
+        templateChecks = checkTemplates();
+        // Add template fixes
+        for (const check of templateChecks) {
+            if (check.status === "missing" && check.name === "templates-root") {
+                fixes.push({
+                    if: check.detail,
+                    hint: "Create templates: mkdir -p ~/.abbie/templates/schemas",
+                });
+            }
+        }
+    }
+    // v2: Repo contract checks
+    let repoResults;
+    if (options.includeRepos) {
+        repoResults = checkRepos(options.reposPath);
+        // Add repo fixes
+        for (const result of repoResults) {
+            for (const check of result.checks) {
+                if (check.status === "missing" && check.name.includes("-extends")) {
+                    fixes.push({
+                        if: check.detail,
+                        hint: `Create missing template or update extends path in ${result.repo}`,
+                    });
+                }
+            }
+        }
+    }
+    // Calculate summary
+    const envChecks = checks;
+    const summary = {
+        environment: {
+            ok: envChecks.filter((c) => c.status === "ok").length,
+            warn: envChecks.filter((c) => c.status === "warn").length,
+            missing: envChecks.filter((c) => c.status === "missing").length,
+        },
+    };
+    if (templateChecks) {
+        summary.templates = {
+            ok: templateChecks.filter((c) => c.status === "ok").length,
+            warn: templateChecks.filter((c) => c.status === "warn").length,
+            missing: templateChecks.filter((c) => c.status === "missing").length,
+        };
+    }
+    if (repoResults) {
+        summary.repos = summarizeRepoChecks(repoResults);
+    }
+    // Determine overall status - ok if no "missing" status (warns are acceptable)
+    const allChecks = [
+        ...checks,
+        ...(templateChecks || []),
+        ...(repoResults?.flatMap((r) => r.checks) || []),
+    ];
+    const ok = !allChecks.some((c) => c.status === "missing");
+    return { ok, checks, fixes, templateChecks, repoResults, summary };
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export { REQUIRED_DIRS, REQUIRED_BINARIES, OPTIONAL_BINARIES, OPTIONAL_ENV_VARS, getAgentsRoot };
+export * from "./repos.js";
+// Re-export v2 modules
+export * from "./templates.js";

package/dist/lib/doctor/repos.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Per-repo contract validation for agents doctor
+ *
+ * Checks:
+ * - .abbie/config.json or .loop.json exists
+ * - Config is valid JSON
+ * - extends references resolve
+ * - Required fields present
+ * - AGENTS.md exists
+ * - CLAUDE.md → AGENTS.md symlink
+ */
+import type { Check } from "./index.js";
+export interface RepoConfig {
+    path: string;
+    name: string;
+    configType: "agents-config" | "loop-json" | "none";
+    configPath?: string;
+    config?: Record<string, unknown>;
+    hasAgentsMd: boolean;
+    hasClaudeMd: boolean;
+    agentsIsSymlink: boolean;
+    claudeIsSymlink: boolean;
+    agentsSymlinkTarget?: string;
+    claudeSymlinkTarget?: string;
+    extendsResolved?: boolean;
+}
+export interface RepoCheckResult {
+    repo: string;
+    checks: Check[];
+}
+declare const DEFAULT_REPOS_PATH: string;
+export declare function discoverRepos(basePath?: string): string[];
+export declare function analyzeRepo(repoPath: string): RepoConfig;
+export declare function checkRepo(repo: RepoConfig): Check[];
+export declare function checkRepos(basePath?: string): RepoCheckResult[];
+export declare function summarizeRepoChecks(results: RepoCheckResult[]): {
+    total: number;
+    ok: number;
+    warn: number;
+    missing: number;
+    repos: {
+        withConfig: number;
+        withAgentsConfig: number;
+        withLoopJson: number;
+        noConfig: number;
+    };
+};
+export { DEFAULT_REPOS_PATH };
+//# sourceMappingURL=repos.d.ts.map

package/dist/lib/doctor/repos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.d.ts","sourceRoot":"","sources":["../../../src/lib/doctor/repos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAOxC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,eAAe,GAAG,WAAW,GAAG,MAAM,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAMD,QAAA,MAAM,kBAAkB,QAAuC,CAAC;AAMhE,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAA2B,GAAG,MAAM,EAAE,CAqC7E;AAMD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CA0ExD;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,KAAK,EAAE,CAiInD;AAMD,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAe/D;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAgCA;AAMD,OAAO,EAAE,kBAAkB,EAAE,CAAC"}