@creativeintelligence/abbie 0.1.4 → 0.1.5

package/src/cli/commands/digest/index.ts

@@ -1,245 +0,0 @@
-import { execSync } from "node:child_process";
-import { basename } from "node:path";
-import { Args, Flags } from "@oclif/core";
-import {
-  calculateStatus,
-  type DigestResult,
-  discoverProjects,
-  fetchLinearIssues,
-  type Project,
-  resolveProject,
-  runDigests,
-} from "../../../lib/digest/index.js";
-import { BaseCommand } from "../../base-command.js";
-
-type DigestOutput = {
-  dryRun: boolean;
-  projects: Array<{
-    name: string;
-    repo: string;
-    commits7d: number;
-    uncommitted: number;
-    status: string;
-    linearIssues?: number;
-  }>;
-  results?: DigestResult[];
-  outputDir: string;
-  window: { start: string; end: string; days: number };
-};
-
-export default class DigestCommand extends BaseCommand {
-  static override hidden = false;
-  static override summary = "Generate project progress digests";
-  static override description =
-    `Analyze projects and generate world-class progress digests using codex.
-
-Accepts explicit project names, paths, or discovery flags.`;
-
-  static override examples = [
-    "<%= config.bin %> digest arbor luke kumori",
-    "<%= config.bin %> digest -n 5",
-    "<%= config.bin %> digest --all --min-commits 10",
-    "<%= config.bin %> digest arbor --dry-run",
-  ];
-
-  static override args = {
-    projects: Args.string({
-      description: "Project names or paths to analyze",
-      required: false,
-    }),
-  };
-
-  static override strict = false;
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    n: Flags.integer({
-      char: "n",
-      description: "Discover and analyze top N projects by commits",
-    }),
-    all: Flags.boolean({
-      description: "Discover and analyze all projects with activity",
-      default: false,
-    }),
-    "min-commits": Flags.integer({
-      description: "Minimum commits to include in discovery",
-      default: 1,
-    }),
-    output: Flags.string({
-      char: "o",
-      description: "Output directory",
-      default: "/tmp/agent-digest-results",
-    }),
-    days: Flags.integer({
-      char: "d",
-      description: "Look back N days",
-      default: 7,
-    }),
-    concurrency: Flags.integer({
-      char: "c",
-      description: "Max parallel codex processes",
-      default: 2,
-    }),
-    linear: Flags.boolean({
-      description: "Include Linear issue correlation",
-      default: true,
-      allowNo: true,
-    }),
-    "dry-run": Flags.boolean({
-      description: "Show what would be analyzed without running",
-      default: false,
-    }),
-  };
-
-  protected async execute(): Promise<DigestOutput> {
-    const { argv, flags } = await this.parse(DigestCommand);
-    this.parsedFlags = flags;
-
-    const projectArgs = argv as string[];
-
-    // Calculate window
-    const windowEnd = new Date();
-    const windowStart = new Date();
-    windowStart.setDate(windowStart.getDate() - flags.days);
-    const windowStartStr = windowStart.toISOString().split("T")[0];
-    const windowEndStr = windowEnd.toISOString().split("T")[0];
-
-    // Build project list
-    let projects: Project[] = [];
-
-    if (projectArgs.length > 0) {
-      // Explicit projects
-      for (const name of projectArgs) {
-        const repo = resolveProject(name);
-        if (!repo) {
-          this.logWarn(`Project not found: ${name}`);
-          continue;
-        }
-
-        let commits = 0;
-        let uncommitted = 0;
-        let branch = "main";
-
-        try {
-          const log = execSync(
-            `git -C "${repo}" log --since="${windowStartStr}" --oneline 2>/dev/null`,
-            {
-              encoding: "utf-8",
-            },
-          );
-          commits = log.trim().split("\n").filter(Boolean).length;
-
-          const status = execSync(`git -C "${repo}" status --porcelain 2>/dev/null`, {
-            encoding: "utf-8",
-          });
-          uncommitted = status.trim().split("\n").filter(Boolean).length;
-
-          branch =
-            execSync(`git -C "${repo}" branch --show-current 2>/dev/null`, {
-              encoding: "utf-8",
-            }).trim() || "main";
-        } catch {
-          // ignore
-        }
-
-        const project: Project = {
-          name: basename(repo),
-          repo,
-          commits7d: commits,
-          uncommitted,
-          branch,
-          status: calculateStatus(commits, uncommitted),
-        };
-
-        if (flags.linear) {
-          project.linearIssues = fetchLinearIssues(project.name);
-        }
-
-        projects.push(project);
-      }
-    } else if (flags.all || flags.n) {
-      // Discovery mode
-      projects = discoverProjects({
-        minCommits: flags["min-commits"],
-        maxProjects: flags.n,
-        days: flags.days,
-      });
-
-      // Fetch Linear issues if enabled
-      if (flags.linear) {
-        for (const project of projects) {
-          project.linearIssues = fetchLinearIssues(project.name);
-        }
-      }
-    } else {
-      this.error("Provide project names, or use -n N or --all for discovery");
-    }
-
-    if (projects.length === 0) {
-      this.error("No projects found matching criteria");
-    }
-
-    // Build output
-    const projectSummaries = projects.map((p) => ({
-      name: p.name,
-      repo: p.repo,
-      commits7d: p.commits7d,
-      uncommitted: p.uncommitted,
-      status: `${p.status.emoji} ${p.status.label}`,
-      linearIssues: p.linearIssues?.length,
-    }));
-
-    this.logInfo(`Analyzing ${projects.length} projects...`);
-    this.logInfo(`  Window: ${windowStartStr} → ${windowEndStr}`);
-    this.logInfo(`  Output: ${flags.output}`);
-    this.logInfo("");
-
-    for (const p of projectSummaries) {
-      const issueInfo = p.linearIssues ? `, ${p.linearIssues} issues` : "";
-      this.logInfo(
-        `  ${p.status} ${p.name}: ${p.commits7d} commits, ${p.uncommitted} uncommitted${issueInfo}`,
-      );
-    }
-    this.logInfo("");
-
-    const output: DigestOutput = {
-      dryRun: flags["dry-run"],
-      projects: projectSummaries,
-      outputDir: flags.output,
-      window: { start: windowStartStr, end: windowEndStr, days: flags.days },
-    };
-
-    if (flags["dry-run"]) {
-      this.logInfo("(dry run - no analysis performed)");
-      return output;
-    }
-
-    // Run digests
-    const results = await runDigests({
-      projects: projects.map((p) => p.name),
-      outputDir: flags.output,
-      days: flags.days,
-      concurrency: flags.concurrency,
-      linear: flags.linear,
-    });
-
-    output.results = results;
-
-    // Print results
-    this.logInfo("Results:");
-    for (const r of results) {
-      if (r.success) {
-        this.logInfo(`  ✓ ${r.project} (${r.rawBytes} bytes raw, ${r.digestBytes} bytes digest)`);
-      } else {
-        this.logInfo(`  ✗ ${r.project}: ${r.error}`);
-      }
-    }
-
-    const succeeded = results.filter((r) => r.success).length;
-    const failed = results.filter((r) => !r.success).length;
-    this.logInfo("");
-    this.logInfo(`Summary: ${succeeded} completed, ${failed} failed`);
-
-    return output;
-  }
-}

package/src/cli/commands/docs/lint.ts

@@ -1,93 +0,0 @@
-import { Flags } from "@oclif/core";
-import { type AgentsDocsLintResult, lintAgentsDocs } from "../../../lib/docs/lint.js";
-import { BaseCommand } from "../../base-command.js";
-
-export default class DocsLintCommand extends BaseCommand {
-  static override summary = "Lint AGENTS.md contracts across the workspace";
-
-  static override description =
-    `Scans ~/Developer/{apps,packages,utils} for AGENTS.md files and validates:
-- AGENTS.md is canonical, CLAUDE.md → AGENTS.md symlink
-- Markdown structure (H1, headings)
-- XML-ish / non-Markdown AGENTS.md detection
-- Duplicate-content clusters (drift report)
-
-Excludes common vendor/build directories (node_modules, dist, build, .git, .next, etc.).`;
-
-  static override examples = [
-    "$ abbie docs lint",
-    "$ abbie docs lint --json --quiet",
-    "$ abbie docs lint --root ~/Developer --include apps --include packages --include utils",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    root: Flags.string({
-      description: "Workspace root (defaults to ~/Developer)",
-      default: undefined,
-    }),
-    include: Flags.string({
-      description: "Subdirectory under root to scan (repeatable)",
-      multiple: true,
-      default: ["apps", "packages", "utils"],
-    }),
-  };
-
-  async execute(): Promise<AgentsDocsLintResult> {
-    const { flags } = await this.parse(DocsLintCommand);
-    this.parsedFlags = flags;
-
-    const result = lintAgentsDocs({
-      workspaceRoot: flags.root,
-      include: flags.include,
-    });
-
-    if (!this.jsonEnabled?.()) {
-      this.renderText(result);
-      if (!result.ok) this.exit(1);
-    }
-
-    return { ...result, exitCode: result.ok ? 0 : 1 };
-  }
-
-  private renderText(result: AgentsDocsLintResult): void {
-    this.log("");
-    this.log("abbie docs lint");
-    this.log("─".repeat(50));
-    this.log("");
-
-    this.log(`Workspace: ${result.workspaceRoot}`);
-    this.log(`Include:   ${result.includedRoots.join(", ") || "(none found)"}`);
-    this.log(`AGENTS.md: ${result.agentsFiles}`);
-    this.log(`Issues:    ${result.errors} error, ${result.warnings} warn`);
-    this.log(`Duplicates:${result.duplicateGroups.length} groups`);
-    this.log("");
-
-    if (result.issues.length > 0) {
-      this.log("Issues:");
-      for (const issue of result.issues) {
-        const level = issue.severity === "error" ? "✗" : "!";
-        this.log(`  ${level} ${issue.path}: ${issue.detail}`);
-      }
-      this.log("");
-    }
-
-    if (result.duplicateGroups.length > 0) {
-      this.log("Duplicate clusters (by content hash):");
-      for (const group of result.duplicateGroups.slice(0, 25)) {
-        this.log(`  ${group.hash} (${group.count})`);
-        for (const p of group.paths) this.log(`    - ${p}`);
-      }
-      if (result.duplicateGroups.length > 25) {
-        this.log(`  … ${result.duplicateGroups.length - 25} more`);
-      }
-      this.log("");
-    }
-
-    if (result.ok) {
-      this.log("✓ OK");
-    } else {
-      this.log("✗ Issues found");
-    }
-  }
-}

package/src/cli/commands/docs/sync.ts

@@ -1,90 +0,0 @@
-import { Flags } from "@oclif/core";
-import { type AgentsDocsSyncResult, syncAgentsDocs } from "../../../lib/docs/sync.js";
-import { BaseCommand } from "../../base-command.js";
-
-export default class DocsSyncCommand extends BaseCommand {
-  static override summary = "Sync AGENTS.md spawn protocol across the workspace";
-
-  static override description =
-    `Scans ~/Developer/{apps,packages,utils} for AGENTS.md and appends a standard
-"Agent Spawn Protocol (Recommended)" section when missing.
-
-This is non-blocking guidance (warn/log policy): skills are preferred but not required.`;
-
-  static override examples = [
-    "$ abbie docs sync --dry-run",
-    "$ abbie docs sync",
-    "$ abbie docs sync --root ~/Developer --include apps --include packages --include utils",
-    "$ abbie docs sync --json --quiet",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    root: Flags.string({
-      description: "Workspace root (defaults to ~/Developer)",
-      default: undefined,
-    }),
-    include: Flags.string({
-      description: "Subdirectory under root to scan (repeatable)",
-      multiple: true,
-      default: ["apps", "packages", "utils"],
-    }),
-    "dry-run": Flags.boolean({
-      description: "Preview changes without writing files",
-      default: false,
-    }),
-  };
-
-  async execute(): Promise<AgentsDocsSyncResult> {
-    const { flags } = await this.parse(DocsSyncCommand);
-    this.parsedFlags = flags;
-
-    const result = syncAgentsDocs({
-      workspaceRoot: flags.root,
-      include: flags.include,
-      dryRun: flags["dry-run"],
-    });
-
-    if (!this.jsonEnabled?.()) {
-      this.renderText(result);
-    }
-
-    return result;
-  }
-
-  private renderText(result: AgentsDocsSyncResult): void {
-    this.log("");
-    this.log("abbie docs sync");
-    this.log("─".repeat(50));
-    this.log("");
-
-    this.log(`Workspace: ${result.workspaceRoot}`);
-    this.log(`Include:   ${result.includedRoots.join(", ") || "(none found)"}`);
-    this.log(`Scanned:   ${result.scanned}`);
-    this.log(`Updated:   ${result.updated}`);
-    this.log(`Skipped:   ${result.skipped}`);
-    this.log(`Mode:      ${result.dryRun ? "dry-run" : "write"}`);
-    this.log("");
-
-    if (result.touchedPaths.length > 0) {
-      this.log("Updated files:");
-      for (const path of result.touchedPaths) {
-        this.log(`  ✓ ${path}`);
-      }
-      this.log("");
-    }
-
-    if (result.skippedPaths.length > 0 && !this.parsedFlags?.quiet) {
-      this.log("Skipped files:");
-      for (const entry of result.skippedPaths.slice(0, 50)) {
-        this.log(`  - ${entry.path} (${entry.reason})`);
-      }
-      if (result.skippedPaths.length > 50) {
-        this.log(`  … ${result.skippedPaths.length - 50} more`);
-      }
-      this.log("");
-    }
-
-    this.log(result.dryRun ? "✓ Dry-run complete" : "✓ Sync complete");
-  }
-}

package/src/cli/commands/doctor.ts

@@ -1,267 +0,0 @@
-import { Flags } from "@oclif/core";
-import {
-  type Check,
-  type DoctorResult,
-  type RepoCheckResult,
-  runDoctor,
-} from "../../lib/doctor/index.js";
-import { BaseCommand } from "../base-command.js";
-
-export default class DoctorCommand extends BaseCommand {
-  static override summary = "Validate abbie CLI environment";
-
-  static override description = `Check that the abbie CLI environment is properly configured.
-
-Validates:
-- ~/.abbie directories exist
-- Runtime detection (node/bun)
-- Required agent binaries (claude, codex, copilot, gemini)
-- Optional tools (slack, messages, linear)
-- Environment variables for integrations
-- Unified tooling symlinks (commands → claude/codex, skills → claude/codex/copilot/gemini)
-
-With --templates:
-- ~/.abbie/templates/ exists
-- Required templates present and valid
-- JSON Schema validation
-
-With --repos:
-- Per-repo .abbie/config.json or .loop.json
-- Config validity and extends resolution
-- AGENTS.md / CLAUDE.md presence
-
-With --all:
-- All checks above`;
-
-  static override examples = [
-    "$ abbie doctor",
-    "$ abbie doctor --fix",
-    "$ abbie doctor --templates",
-    "$ abbie doctor --repos",
-    "$ abbie doctor --all",
-    "$ abbie doctor --all --json --quiet",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    fix: Flags.boolean({
-      description: "Create missing directories automatically",
-      default: false,
-    }),
-    templates: Flags.boolean({
-      description: "Include template system validation",
-      default: false,
-    }),
-    repos: Flags.boolean({
-      description: "Include per-repo contract validation",
-      default: false,
-    }),
-    all: Flags.boolean({
-      description: "Run all checks (environment + templates + repos)",
-      default: false,
-    }),
-    "repos-path": Flags.string({
-      description: "Custom path to scan for repos",
-      default: undefined,
-    }),
-  };
-
-  async execute(): Promise<DoctorResult> {
-    const { flags } = await this.parse(DoctorCommand);
-    this.parsedFlags = flags;
-
-    const includeTemplates = flags.all || flags.templates;
-    const includeRepos = flags.all || flags.repos;
-
-    const result = await runDoctor({
-      fix: flags.fix,
-      includeTemplates,
-      includeRepos,
-      reposPath: flags["repos-path"],
-    });
-
-    if (!this.jsonEnabled?.()) {
-      this.renderText(result, flags.fix, includeTemplates, includeRepos);
-      // Exit non-zero if not ok (only in text mode)
-      if (!result.ok) {
-        this.exit(1);
-      }
-    }
-
-    // In JSON mode, return result with exitCode embedded
-    return {
-      ...result,
-      exitCode: result.ok ? 0 : 1,
-    };
-  }
-
-  private renderText(
-    result: DoctorResult,
-    _didFix: boolean,
-    includeTemplates: boolean,
-    includeRepos: boolean,
-  ): void {
-    this.log("");
-    this.log("abbie doctor");
-    this.log("─".repeat(50));
-    this.log("");
-
-    // Group checks by category
-    const dirChecks = result.checks.filter(
-      (c) => c.name === "agents-root" || c.name.startsWith("dir-"),
-    );
-    const runtimeCheck = result.checks.find((c) => c.name === "runtime");
-    const binChecks = result.checks.filter((c) => c.name.startsWith("bin-"));
-    const envChecks = result.checks.filter((c) => c.name.startsWith("env-"));
-    const symlinkChecks = result.checks.filter((c) => c.name.startsWith("symlink-"));
-
-    // Directories
-    this.log("Directories:");
-    for (const check of dirChecks) {
-      this.log(`  ${this.statusIcon(check.status)} ${check.detail}`);
-    }
-    this.log("");
-
-    // Runtime
-    if (runtimeCheck) {
-      this.log("Runtime:");
-      this.log(`  ${this.statusIcon(runtimeCheck.status)} ${runtimeCheck.detail}`);
-      this.log("");
-    }
-
-    // Binaries
-    this.log("Agent Binaries:");
-    for (const check of binChecks) {
-      const name = check.name.replace("bin-", "");
-      this.log(`  ${this.statusIcon(check.status)} ${name}: ${check.detail}`);
-    }
-    this.log("");
-
-    // Environment
-    this.log("Environment:");
-    for (const check of envChecks) {
-      this.log(`  ${this.statusIcon(check.status)} ${check.detail}`);
-    }
-    this.log("");
-
-    // Symlinks
-    if (symlinkChecks.length > 0) {
-      this.log("Unified Tooling Symlinks:");
-      for (const check of symlinkChecks) {
-        this.log(`  ${this.statusIcon(check.status)} ${check.detail}`);
-      }
-      this.log("");
-    }
-
-    // Templates (v2)
-    if (includeTemplates && result.templateChecks) {
-      this.log("Templates:");
-      for (const check of result.templateChecks) {
-        this.log(`  ${this.statusIcon(check.status)} ${check.detail}`);
-      }
-      this.log("");
-    }
-
-    // Repos (v2)
-    if (includeRepos && result.repoResults) {
-      this.log("Repos:");
-      this.renderRepoResults(result.repoResults);
-      this.log("");
-    }
-
-    // Summary
-    this.log("─".repeat(50));
-    if (result.summary) {
-      this.log("Summary:");
-      this.log(
-        `  Environment: ${result.summary.environment.ok} ok, ${result.summary.environment.warn} warn, ${result.summary.environment.missing} missing`,
-      );
-      if (result.summary.templates) {
-        this.log(
-          `  Templates: ${result.summary.templates.ok} ok, ${result.summary.templates.warn} warn, ${result.summary.templates.missing} missing`,
-        );
-      }
-      if (result.summary.repos) {
-        const r = result.summary.repos;
-        this.log(
-          `  Repos: ${r.repos.withAgentsConfig} with .abbie/config.json, ${r.repos.withLoopJson} with .loop.json, ${r.repos.noConfig} no config`,
-        );
-      }
-      this.log("");
-    }
-
-    if (result.ok) {
-      this.log("✓ Environment ready");
-    } else {
-      this.log("✗ Issues found");
-      this.log("");
-
-      // Show fixes
-      if (result.fixes.length > 0) {
-        this.log("Fixes:");
-        for (const fix of result.fixes) {
-          this.log(`  • ${fix.hint}`);
-        }
-      }
-    }
-
-    this.log("");
-  }
-
-  private renderRepoResults(results: RepoCheckResult[]): void {
-    // Group by status
-    const ok: string[] = [];
-    const warn: string[] = [];
-    const missing: string[] = [];
-
-    for (const result of results) {
-      const hasMissing = result.checks.some((c) => c.status === "missing");
-      const hasWarn = result.checks.some((c) => c.status === "warn");
-
-      if (hasMissing) {
-        missing.push(result.repo);
-      } else if (hasWarn) {
-        warn.push(result.repo);
-      } else {
-        ok.push(result.repo);
-      }
-    }
-
-    // Show counts
-    this.log(`  ${this.statusIcon("ok")} ${ok.length} repos fully configured`);
-    if (warn.length > 0) {
-      this.log(
-        `  ${this.statusIcon("warn")} ${warn.length} repos with warnings: ${warn.join(", ")}`,
-      );
-    }
-    if (missing.length > 0) {
-      this.log(
-        `  ${this.statusIcon("missing")} ${missing.length} repos with issues: ${missing.join(", ")}`,
-      );
-    }
-
-    // Show detailed issues for repos with problems
-    const problemRepos = results.filter((r) => r.checks.some((c) => c.status === "missing"));
-    if (problemRepos.length > 0 && problemRepos.length <= 5) {
-      this.log("");
-      this.log("  Issues:");
-      for (const repo of problemRepos) {
-        const issues = repo.checks.filter((c) => c.status === "missing");
-        for (const issue of issues) {
-          this.log(`    ${repo.repo}: ${issue.detail}`);
-        }
-      }
-    }
-  }
-
-  private statusIcon(status: Check["status"]): string {
-    switch (status) {
-      case "ok":
-        return "✓";
-      case "missing":
-        return "✗";
-      case "warn":
-        return "⚠";
-    }
-  }
-}