@creativeintelligence/abbie 0.1.3 → 0.1.5

package/src/lib/backlog.ts

@@ -1,428 +0,0 @@
-import {
-  existsSync,
-  mkdirSync,
-  readdirSync,
-  readFileSync,
-  unlinkSync,
-  writeFileSync,
-} from "node:fs";
-import { join } from "node:path";
-
-/**
- * Backlog item status.
- */
-export type BacklogStatus =
-  | "pending"
-  | "claimed"
-  | "in_progress"
-  | "blocked"
-  | "completed"
-  | "abandoned";
-
-/**
- * Backlog item representing a work item.
- */
-export interface BacklogItem {
-  id: string;
-  type: "issue" | "pr" | "task";
-  ref: string; // e.g., ZO-123, #456, custom-task-id
-  title: string;
-  project: string;
-  priority: number; // 1 (urgent) - 4 (low)
-  status: BacklogStatus;
-  claimed_by?: string; // session_id
-  claimed_at?: string;
-  source: "linear" | "github" | "manual";
-  metadata?: Record<string, unknown>;
-  created_at: string;
-  updated_at: string;
-}
-
-/**
- * Claim result.
- */
-export interface ClaimResult {
-  success: boolean;
-  item?: BacklogItem;
-  reason?: string;
-}
-
-/**
- * Backlog manager for work item deduplication.
- */
-export class BacklogManager {
-  private basePath: string;
-
-  constructor(basePath: string = "~/.abbie/backlog") {
-    this.basePath = basePath.replace("~", process.env.HOME || "");
-    if (!existsSync(this.basePath)) {
-      mkdirSync(this.basePath, { recursive: true });
-    }
-  }
-
-  /**
-   * Get item file path.
-   */
-  private getItemPath(project: string, id: string): string {
-    const projectDir = join(this.basePath, project);
-    if (!existsSync(projectDir)) {
-      mkdirSync(projectDir, { recursive: true });
-    }
-    return join(projectDir, `${id}.json`);
-  }
-
-  /**
-   * Generate a unique item ID.
-   */
-  private generateId(): string {
-    const timestamp = Date.now().toString(36);
-    const random = Math.random().toString(36).slice(2, 6);
-    return `${timestamp}-${random}`;
-  }
-
-  /**
-   * Add an item to the backlog.
-   */
-  add(item: Omit<BacklogItem, "id" | "status" | "created_at" | "updated_at">): BacklogItem {
-    const id = this.generateId();
-    const now = new Date().toISOString();
-
-    const fullItem: BacklogItem = {
-      ...item,
-      id,
-      status: "pending",
-      created_at: now,
-      updated_at: now,
-    };
-
-    // Check for duplicates
-    const existing = this.findByRef(item.project, item.ref);
-    if (existing) {
-      return existing;
-    }
-
-    const path = this.getItemPath(item.project, id);
-    writeFileSync(path, JSON.stringify(fullItem, null, 2));
-    return fullItem;
-  }
-
-  /**
-   * Find item by reference (e.g., ZO-123).
-   */
-  findByRef(project: string, ref: string): BacklogItem | undefined {
-    const items = this.listItems(project);
-    return items.find((item) => item.ref === ref);
-  }
-
-  /**
-   * Get an item by ID.
-   */
-  get(project: string, id: string): BacklogItem | undefined {
-    const path = this.getItemPath(project, id);
-    if (!existsSync(path)) {
-      return undefined;
-    }
-    return JSON.parse(readFileSync(path, "utf-8"));
-  }
-
-  /**
-   * Update an item.
-   */
-  update(project: string, id: string, updates: Partial<BacklogItem>): BacklogItem | undefined {
-    const item = this.get(project, id);
-    if (!item) {
-      return undefined;
-    }
-
-    const updated: BacklogItem = {
-      ...item,
-      ...updates,
-      id: item.id, // Prevent ID change
-      updated_at: new Date().toISOString(),
-    };
-
-    const path = this.getItemPath(project, id);
-    writeFileSync(path, JSON.stringify(updated, null, 2));
-    return updated;
-  }
-
-  /**
-   * Claim an item for a session.
-   */
-  claim(project: string, id: string, sessionId: string): ClaimResult {
-    const item = this.get(project, id);
-    if (!item) {
-      return { success: false, reason: "Item not found" };
-    }
-
-    // Check if already claimed
-    if (item.claimed_by && item.claimed_by !== sessionId) {
-      return {
-        success: false,
-        reason: `Already claimed by ${item.claimed_by}`,
-        item,
-      };
-    }
-
-    // Check if in terminal state
-    if (item.status === "completed" || item.status === "abandoned") {
-      return {
-        success: false,
-        reason: `Item is ${item.status}`,
-        item,
-      };
-    }
-
-    const updated = this.update(project, id, {
-      status: "claimed",
-      claimed_by: sessionId,
-      claimed_at: new Date().toISOString(),
-    });
-
-    return { success: true, item: updated };
-  }
-
-  /**
-   * Start work on a claimed item.
-   */
-  startWork(project: string, id: string, sessionId: string): ClaimResult {
-    const item = this.get(project, id);
-    if (!item) {
-      return { success: false, reason: "Item not found" };
-    }
-
-    if (item.claimed_by !== sessionId) {
-      return { success: false, reason: "Not claimed by this session", item };
-    }
-
-    const updated = this.update(project, id, { status: "in_progress" });
-    return { success: true, item: updated };
-  }
-
-  /**
-   * Mark item as blocked.
-   */
-  block(project: string, id: string, reason: string): BacklogItem | undefined {
-    return this.update(project, id, {
-      status: "blocked",
-      metadata: { block_reason: reason },
-    });
-  }
-
-  /**
-   * Complete an item.
-   */
-  complete(project: string, id: string): BacklogItem | undefined {
-    return this.update(project, id, { status: "completed" });
-  }
-
-  /**
-   * Abandon an item (release claim).
-   */
-  abandon(project: string, id: string): BacklogItem | undefined {
-    return this.update(project, id, {
-      status: "abandoned",
-      claimed_by: undefined,
-      claimed_at: undefined,
-    });
-  }
-
-  /**
-   * Release a claim without abandoning.
-   */
-  release(project: string, id: string): BacklogItem | undefined {
-    return this.update(project, id, {
-      status: "pending",
-      claimed_by: undefined,
-      claimed_at: undefined,
-    });
-  }
-
-  /**
-   * List all items for a project.
-   */
-  listItems(project: string): BacklogItem[] {
-    const projectDir = join(this.basePath, project);
-    if (!existsSync(projectDir)) {
-      return [];
-    }
-
-    return readdirSync(projectDir)
-      .filter((f) => f.endsWith(".json"))
-      .map((f) => {
-        const content = readFileSync(join(projectDir, f), "utf-8");
-        return JSON.parse(content) as BacklogItem;
-      })
-      .sort((a, b) => a.priority - b.priority || a.created_at.localeCompare(b.created_at));
-  }
-
-  /**
-   * Get pending items (unclaimed, not blocked).
-   */
-  getPending(project: string): BacklogItem[] {
-    return this.listItems(project).filter((item) => item.status === "pending");
-  }
-
-  /**
-   * Get items claimed by a session.
-   */
-  getBySession(project: string, sessionId: string): BacklogItem[] {
-    return this.listItems(project).filter((item) => item.claimed_by === sessionId);
-  }
-
-  /**
-   * Get the next available item (highest priority, unclaimed).
-   */
-  getNext(project: string): BacklogItem | undefined {
-    return this.getPending(project)[0];
-  }
-
-  /**
-   * Pick and claim the next available item.
-   */
-  pickNext(project: string, sessionId: string): ClaimResult {
-    const next = this.getNext(project);
-    if (!next) {
-      return { success: false, reason: "No pending items" };
-    }
-    return this.claim(project, next.id, sessionId);
-  }
-
-  /**
-   * Sync from Linear issues.
-   */
-  syncFromLinear(
-    project: string,
-    issues: Array<{
-      id: string;
-      title: string;
-      priority: number;
-      identifier: string;
-    }>,
-  ): number {
-    let added = 0;
-
-    for (const issue of issues) {
-      const existing = this.findByRef(project, issue.identifier);
-      if (!existing) {
-        this.add({
-          type: "issue",
-          ref: issue.identifier,
-          title: issue.title,
-          project,
-          priority: issue.priority || 3,
-          source: "linear",
-          metadata: { linear_id: issue.id },
-        });
-        added++;
-      }
-    }
-
-    return added;
-  }
-
-  /**
-   * Sync from GitHub PRs/issues.
-   */
-  syncFromGitHub(
-    project: string,
-    items: Array<{
-      number: number;
-      title: string;
-      type: "issue" | "pr";
-    }>,
-  ): number {
-    let added = 0;
-
-    for (const item of items) {
-      const ref = `#${item.number}`;
-      const existing = this.findByRef(project, ref);
-      if (!existing) {
-        this.add({
-          type: item.type,
-          ref,
-          title: item.title,
-          project,
-          priority: 3,
-          source: "github",
-          metadata: { github_number: item.number },
-        });
-        added++;
-      }
-    }
-
-    return added;
-  }
-
-  /**
-   * Clean up completed/abandoned items older than N days.
-   */
-  cleanup(project: string, olderThanDays: number = 30): number {
-    const cutoff = new Date();
-    cutoff.setDate(cutoff.getDate() - olderThanDays);
-    const cutoffStr = cutoff.toISOString();
-
-    const items = this.listItems(project);
-    let removed = 0;
-
-    for (const item of items) {
-      if (
-        (item.status === "completed" || item.status === "abandoned") &&
-        item.updated_at < cutoffStr
-      ) {
-        const path = this.getItemPath(project, item.id);
-        unlinkSync(path);
-        removed++;
-      }
-    }
-
-    return removed;
-  }
-
-  /**
-   * List all projects with backlog items.
-   */
-  listProjects(): string[] {
-    if (!existsSync(this.basePath)) {
-      return [];
-    }
-
-    return readdirSync(this.basePath).filter((name) => {
-      const path = join(this.basePath, name);
-      try {
-        const stat = require("node:fs").statSync(path);
-        return stat.isDirectory();
-      } catch {
-        return false;
-      }
-    });
-  }
-}
-
-/**
- * Create a singleton backlog manager.
- */
-let _manager: BacklogManager | undefined;
-
-export function getBacklogManager(): BacklogManager {
-  if (!_manager) {
-    _manager = new BacklogManager();
-  }
-  return _manager;
-}
-
-/**
- * Add a new item to the backlog.
- */
-export function addBacklogItem(
-  item: Omit<BacklogItem, "id" | "status" | "created_at" | "updated_at">,
-): BacklogItem {
-  return getBacklogManager().add(item);
-}
-
-/**
- * Claim a backlog item for a session.
- */
-export function claimBacklogItem(project: string, id: string, sessionId: string): ClaimResult {
-  return getBacklogManager().claim(project, id, sessionId);
-}