@creativeintelligence/abbie 0.1.3 → 0.1.5

package/src/cli/commands/reference/save.ts

@@ -1,103 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import {
-  findReference,
-  parseUrl,
-  type Reference,
-  type ReferenceType,
-  writeReference,
-} from "../../../lib/references.js";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ReferenceSave extends BaseCommand {
-  static override description = "Save a URL or repo to the reference bank";
-  static override hidden = false;
-
-  static override examples = [
-    "<%= config.bin %> reference save https://internet.dev",
-    "<%= config.bin %> reference save https://linear.app --name linear-app",
-    "<%= config.bin %> reference save https://github.com/org/repo --name my-ref",
-    "<%= config.bin %> reference save https://example.com --type ios --tags inspiration,minimal",
-  ];
-
-  static override args = {
-    url: Args.string({
-      description: "URL to save (website or GitHub repo)",
-      required: true,
-    }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    name: Flags.string({
-      char: "n",
-      description: "Reference name (auto-generated from URL if not provided)",
-    }),
-    type: Flags.string({
-      char: "t",
-      description: "Reference type",
-      options: ["web", "ios", "android"],
-      default: "web",
-    }),
-    tags: Flags.string({
-      description: "Comma-separated tags",
-    }),
-    notes: Flags.string({
-      description: "Notes about the reference",
-    }),
-    force: Flags.boolean({
-      char: "f",
-      description: "Overwrite existing reference",
-      default: false,
-    }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { args, flags } = await this.parse(ReferenceSave);
-    this.parsedFlags = flags;
-
-    const url = args.url;
-    const { domain, suggestedName } = parseUrl(url);
-    const name = flags.name || suggestedName;
-    const type = flags.type as ReferenceType;
-
-    // Check if already exists
-    const existing = findReference(name);
-    if (existing && !flags.force) {
-      this.error(`Reference '${name}' already exists. Use --force to overwrite.`, { exit: 1 });
-    }
-
-    // Detect if it's a GitHub repo
-    const isGitHubRepo = url.includes("github.com/") && !url.includes("github.com/orgs/");
-    const repo = isGitHubRepo ? url : undefined;
-
-    // Create reference
-    const ref: Reference = {
-      name,
-      domain: isGitHubRepo ? undefined : domain,
-      url,
-      type,
-      created: new Date().toISOString(),
-      repo,
-      tags: flags.tags?.split(",").map((t) => t.trim()),
-      notes: flags.notes,
-    };
-
-    const path = writeReference(ref);
-
-    // JSON output
-    if (flags.json || flags.format === "json") {
-      return { ...ref, path };
-    }
-
-    this.logInfo(`✓ Saved reference '${name}' to ${path}`);
-    this.logInfo("");
-    this.logInfo("Next steps:");
-    this.logInfo(`  • Run www-audit to analyze: "use www-audit on ${url}"`);
-    if (isGitHubRepo) {
-      this.logInfo(`  • Clone repo: git clone --depth 1 ${url} ${path}/repo`);
-    }
-    this.logInfo(`  • View: abbie reference show ${name}`);
-
-    return { ...ref, path };
-  }
-}

package/src/cli/commands/reference/search.ts

@@ -1,85 +0,0 @@
-import { Args } from "@oclif/core";
-import { type ReferenceWithPath, searchReferences } from "../../../lib/references.js";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ReferenceSearch extends BaseCommand {
-  static override description = "Search references by text query";
-  static override hidden = false;
-
-  static override examples = [
-    '<%= config.bin %> reference search "faq pattern"',
-    "<%= config.bin %> reference search next.js",
-    "<%= config.bin %> reference search minimal",
-    '<%= config.bin %> reference search --json "typography"',
-  ];
-
-  static override args = {
-    query: Args.string({
-      description: "Search query",
-      required: true,
-    }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { args, flags } = await this.parse(ReferenceSearch);
-    this.parsedFlags = flags;
-
-    const refs = searchReferences(args.query);
-
-    // JSON output
-    if (flags.json || flags.format === "json") {
-      return refs;
-    }
-
-    // NDJSON output
-    if (this.ndjsonEnabled()) {
-      this.outputNdjson(refs);
-      return refs;
-    }
-
-    // Text output
-    if (refs.length === 0) {
-      this.logInfo(`No references found matching "${args.query}"`);
-      return [];
-    }
-
-    this.logInfo(`Found ${refs.length} reference(s) matching "${args.query}":\n`);
-
-    for (const ref of refs) {
-      const icons = this.getIcons(ref);
-      this.log(`${icons} ${ref.name} (${ref.type})`);
-      this.log(`   ${ref.url}`);
-      if (ref.patterns?.length) {
-        this.log(`   Patterns: ${ref.patterns.slice(0, 3).join(", ")}`);
-      }
-      this.log("");
-    }
-
-    return refs;
-  }
-
-  private getIcons(ref: ReferenceWithPath): string {
-    const icons: string[] = [];
-
-    switch (ref.type) {
-      case "web":
-        icons.push("🌐");
-        break;
-      case "ios":
-        icons.push("📱");
-        break;
-      case "android":
-        icons.push("🤖");
-        break;
-    }
-
-    if (ref.hasAudit) icons.push("📝");
-    if (ref.hasRepo) icons.push("📦");
-
-    return icons.join(" ");
-  }
-}

package/src/cli/commands/reference/show.ts

@@ -1,174 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import {
-  findReference,
-  formatReferenceForPrompt,
-  getAuditContent,
-} from "../../../lib/references.js";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ReferenceShow extends BaseCommand {
-  static override description = "Show details of a reference";
-  static override hidden = false;
-
-  static override examples = [
-    "<%= config.bin %> reference show int-dev",
-    "<%= config.bin %> reference show int-dev --format prompt",
-    "<%= config.bin %> reference show int-dev --audit",
-    "<%= config.bin %> reference show int-dev --json",
-  ];
-
-  static override args = {
-    name: Args.string({
-      description: "Reference name",
-      required: true,
-    }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    audit: Flags.boolean({
-      char: "a",
-      description: "Show AUDIT.md content",
-      default: false,
-    }),
-    prompt: Flags.boolean({
-      char: "p",
-      description: "Format for prompt injection (www-studio)",
-      default: false,
-    }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { args, flags } = await this.parse(ReferenceShow);
-    this.parsedFlags = flags;
-
-    const ref = findReference(args.name);
-    if (!ref) {
-      this.error(`Reference '${args.name}' not found`, { exit: 1 });
-    }
-
-    // Prompt format for www-studio consumption
-    if (flags.prompt || flags.format === "prompt") {
-      const prompt = formatReferenceForPrompt(ref);
-      this.log(prompt);
-      return { format: "prompt", content: prompt };
-    }
-
-    // Audit content
-    if (flags.audit) {
-      const audit = getAuditContent(ref.type, ref.name);
-      if (!audit) {
-        this.error(`No AUDIT.md found for '${args.name}'. Run www-audit first.`, { exit: 1 });
-      }
-      this.log(audit);
-      return { format: "audit", content: audit };
-    }
-
-    // JSON output
-    if (flags.json || flags.format === "json") {
-      return ref;
-    }
-
-    // Text output
-    this.log(`📁 ${ref.name}`);
-    this.log(`   Type: ${ref.type}`);
-    this.log(`   URL: ${ref.url}`);
-    if (ref.domain) {
-      this.log(`   Domain: ${ref.domain}`);
-    }
-    this.log(`   Path: ${ref.path}`);
-    this.log(`   Created: ${ref.created}`);
-    if (ref.updated) {
-      this.log(`   Updated: ${ref.updated}`);
-    }
-    this.log("");
-
-    if (ref.stack && Object.keys(ref.stack).length > 0) {
-      this.log("   Stack:");
-      for (const [key, value] of Object.entries(ref.stack)) {
-        if (value) {
-          this.log(`     ${key}: ${value}`);
-        }
-      }
-      this.log("");
-    }
-
-    if (ref.patterns?.length) {
-      this.log(`   Patterns: ${ref.patterns.join(", ")}`);
-    }
-
-    if (ref.tags?.length) {
-      this.log(`   Tags: ${ref.tags.join(", ")}`);
-    }
-
-    if (ref.notes) {
-      this.log(`   Notes: ${ref.notes}`);
-    }
-
-    if (ref.screenshots) {
-      const desktop = ref.screenshots.desktop;
-      const mobile = ref.screenshots.mobile;
-      if (typeof desktop === "number" || typeof mobile === "number") {
-        this.log(`   Screenshots: desktop=${desktop ?? 0}, mobile=${mobile ?? 0}`);
-      }
-    }
-
-    if (ref.extracts?.length) {
-      this.log("");
-      this.log(`   Extracts (${ref.extracts.length}):`);
-      for (const extract of ref.extracts) {
-        this.log(`     - ${extract.id}: ${extract.thing}`);
-        this.log(`       URL: ${extract.url}`);
-        if (extract.gist?.url) {
-          this.log(`       Gist: ${extract.gist.url}`);
-        }
-        if (extract.updated) {
-          this.log(`       Updated: ${extract.updated}`);
-        }
-      }
-    }
-
-    this.log("");
-    this.log("   Status:");
-    this.log(`     AUDIT.md: ${ref.hasAudit ? "✓" : "✗"}`);
-    this.log(`     Repo: ${ref.hasRepo ? "✓" : "✗"}`);
-    this.log(`     Gist: ${ref.hasGist ? "✓" : "✗"}`);
-
-    if (ref.repo) {
-      this.log(`   Repo URL: ${ref.repo}`);
-    }
-
-    if (ref.gist) {
-      this.log("");
-      this.log("   Gist Resources:");
-      if (ref.gist.auditUrl) {
-        this.log(`     Audit: ${ref.gist.auditUrl}`);
-      }
-      if (ref.gist.desktopScreenshotsUrl) {
-        this.log(`     Desktop screenshots: ${ref.gist.desktopScreenshotsUrl}`);
-      }
-      if (ref.gist.mobileScreenshotsUrl) {
-        this.log(`     Mobile screenshots: ${ref.gist.mobileScreenshotsUrl}`);
-      }
-      if (
-        !ref.gist.desktopScreenshotsUrl &&
-        !ref.gist.mobileScreenshotsUrl &&
-        ref.gist.screenshotsUrl
-      ) {
-        this.log(`     Screenshots: ${ref.gist.screenshotsUrl}`);
-      }
-      if (ref.gist.createdAt) {
-        this.log(`     Created: ${ref.gist.createdAt}`);
-      }
-      if (ref.gist.specialists && Object.keys(ref.gist.specialists).length > 0) {
-        this.log("");
-        this.log("     Specialists:");
-        for (const [name, url] of Object.entries(ref.gist.specialists)) {
-          this.log(`       ${name}: ${url}`);
-        }
-      }
-    }
-
-    return ref;
-  }
-}

package/src/cli/commands/reference/update-index.ts

@@ -1,103 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { Flags } from "@oclif/core";
-import { listReferences, type ReferenceWithPath } from "../../../lib/references.js";
-import { BaseCommand } from "../../base-command.js";
-
-const DEFAULT_INDEX_GIST_ID = "0516f750110430b9324e3373bfff955f";
-
-export default class ReferenceUpdateIndex extends BaseCommand {
-  static override description = "Update the master index gist with all references";
-  static override hidden = false;
-
-  static override examples = [
-    "<%= config.bin %> reference update-index",
-    "<%= config.bin %> reference update-index --gist-id abc123",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    "gist-id": Flags.string({
-      description:
-        "GitHub Gist ID to update (defaults to AGENTS_REFERENCE_INDEX_GIST_ID or built-in)",
-    }),
-    "dry-run": Flags.boolean({
-      description: "Generate markdown but do not update the gist",
-      default: false,
-    }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { flags } = await this.parse(ReferenceUpdateIndex);
-    this.parsedFlags = flags;
-
-    const refs = listReferences({ type: "web" });
-    const markdown = buildIndexMarkdown(refs);
-
-    const gistId =
-      flags["gist-id"] || process.env.AGENTS_REFERENCE_INDEX_GIST_ID || DEFAULT_INDEX_GIST_ID;
-
-    // Save markdown to temp file
-    const tmpFile = join(tmpdir(), `agents-reference-index-${Date.now()}.md`);
-    writeFileSync(tmpFile, markdown);
-
-    const isJson = flags.json || flags.format === "json";
-
-    if (flags["dry-run"]) {
-      if (isJson) {
-        return { dryRun: true, gistId, count: refs.length, tmpFile };
-      }
-      this.log(markdown);
-      return { dryRun: true, gistId, count: refs.length, tmpFile };
-    }
-
-    // Check if gh is installed and authenticated
-    try {
-      execSync("gh auth status", { stdio: "ignore" });
-    } catch {
-      this.error('GitHub CLI (gh) not authenticated. Please run "gh auth login".');
-    }
-
-    if (!existsSync(tmpFile)) {
-      this.error(`Temp file not found: ${tmpFile}`);
-    }
-
-    try {
-      this.logInfo("Updating Gist...");
-      execSync(`gh gist edit ${gistId} ${tmpFile}`, { stdio: flags.quiet ? "ignore" : "inherit" });
-    } catch (err) {
-      this.error(
-        `Failed to update gist ${gistId}: ${err instanceof Error ? err.message : String(err)}`,
-      );
-    }
-
-    const url = `https://gist.github.com/${gistId}`;
-
-    if (isJson) {
-      return { updated: true, gistId, url, count: refs.length };
-    }
-
-    this.logInfo(`Updated Gist: ${url}`);
-    return { updated: true, gistId, url, count: refs.length };
-  }
-}
-
-function buildIndexMarkdown(refs: ReferenceWithPath[]): string {
-  let md = "# Reference Bank Index\n\n";
-  md += "Master index of audited sites in `~/.abbie/references/`.\n\n";
-  md += "| Site | Audit Gist | Status |\n";
-  md += "|---|---|---|\n";
-
-  for (const ref of refs) {
-    const url = ref.url || ref.domain || "";
-    const auditUrl = ref.gist?.auditUrl;
-    const status = auditUrl ? "✅" : "❌";
-    const auditLink = auditUrl ? `[Link](${auditUrl})` : "Not Audited";
-    md += `| [${ref.name}](${url}) | ${auditLink} | ${status} |\n`;
-  }
-
-  md += `\n*Last updated: ${new Date().toISOString().split("T")[0]}*\n`;
-  return md;
-}

package/src/cli/commands/reference/update.ts

@@ -1,136 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { Args, Flags } from "@oclif/core";
-import { findReference, type Reference } from "../../../lib/references.js";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ReferenceUpdate extends BaseCommand {
-  static override description = "Update a reference (re-audit or git pull)";
-  static override hidden = false;
-
-  static override examples = [
-    "<%= config.bin %> reference update int-dev",
-    "<%= config.bin %> reference update int-dev --pull",
-    "<%= config.bin %> reference update int-dev --tags new-tag,another",
-    '<%= config.bin %> reference update int-dev --notes "Updated notes"',
-    "<%= config.bin %> reference update int-dev --gist-audit https://gist.github.com/user/abc123",
-  ];
-
-  static override args = {
-    name: Args.string({
-      description: "Reference name",
-      required: true,
-    }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    pull: Flags.boolean({
-      char: "p",
-      description: "Git pull the repo (if cloned)",
-      default: false,
-    }),
-    tags: Flags.string({
-      char: "t",
-      description: "Update tags (comma-separated)",
-    }),
-    notes: Flags.string({
-      char: "n",
-      description: "Update notes",
-    }),
-    patterns: Flags.string({
-      description: "Update patterns (comma-separated)",
-    }),
-    "gist-audit": Flags.string({
-      description: "Set gist URL for AUDIT.md (rendered markdown)",
-    }),
-    "gist-screenshots": Flags.string({
-      description: "Set gist URL for screenshots",
-    }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { args, flags } = await this.parse(ReferenceUpdate);
-    this.parsedFlags = flags;
-
-    const ref = findReference(args.name);
-    if (!ref) {
-      this.error(`Reference '${args.name}' not found`, { exit: 1 });
-    }
-
-    let updated = false;
-
-    // Git pull
-    if (flags.pull) {
-      const repoPath = join(ref.path, "repo");
-      if (!existsSync(repoPath)) {
-        this.error(`No repo found for '${args.name}'. Clone it first.`, { exit: 1 });
-      }
-      this.logInfo(`Pulling ${repoPath}...`);
-      try {
-        execSync("git pull --ff-only", { cwd: repoPath, stdio: "inherit" });
-        updated = true;
-      } catch {
-        this.logWarn("Git pull failed (might have local changes)");
-      }
-    }
-
-    // Update manifest fields
-    const manifestPath = join(ref.path, "reference.json");
-    const manifest: Reference = JSON.parse(readFileSync(manifestPath, "utf-8"));
-
-    if (flags.tags) {
-      manifest.tags = flags.tags.split(",").map((t) => t.trim());
-      updated = true;
-    }
-
-    if (flags.notes) {
-      manifest.notes = flags.notes;
-      updated = true;
-    }
-
-    if (flags.patterns) {
-      manifest.patterns = flags.patterns.split(",").map((p) => p.trim());
-      updated = true;
-    }
-
-    // Gist updates
-    if (flags["gist-audit"] || flags["gist-screenshots"]) {
-      if (!manifest.gist) {
-        manifest.gist = {};
-      }
-      if (flags["gist-audit"]) {
-        manifest.gist.auditUrl = flags["gist-audit"];
-        manifest.gist.createdAt = manifest.gist.createdAt || new Date().toISOString();
-      }
-      if (flags["gist-screenshots"]) {
-        manifest.gist.screenshotsUrl = flags["gist-screenshots"];
-        manifest.gist.createdAt = manifest.gist.createdAt || new Date().toISOString();
-      }
-      updated = true;
-    }
-
-    if (updated) {
-      manifest.updated = new Date().toISOString();
-      writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
-    }
-
-    // JSON output
-    if (flags.json || flags.format === "json") {
-      return { ...manifest, path: ref.path, updated };
-    }
-
-    if (updated) {
-      this.logInfo(`✓ Updated reference '${args.name}'`);
-    } else {
-      this.logInfo("No changes made. Use --pull, --tags, --notes, or --patterns to update.");
-    }
-
-    this.logInfo("");
-    this.logInfo("To re-audit this reference, run:");
-    this.logInfo(`  "use www-audit on ${ref.url}"`);
-
-    return { ...manifest, path: ref.path, updated };
-  }
-}