backlog.md 0.1.0 → 0.1.3

package/src/constants/index.ts

@@ -1,48 +0,0 @@
-/**
- * Default directory structure for backlog projects
- */
-export const DEFAULT_DIRECTORIES = {
-	/** Main backlog directory */
-	BACKLOG: ".backlog",
-	/** Active tasks directory */
-	TASKS: "tasks",
-	/** Draft tasks directory */
-	DRAFTS: "drafts",
-	/** Archive root directory */
-	ARCHIVE: "archive",
-	/** Archived tasks directory */
-	ARCHIVE_TASKS: "archive/tasks",
-	/** Archived drafts directory */
-	ARCHIVE_DRAFTS: "archive/drafts",
-	/** Documentation directory */
-	DOCS: "docs",
-	/** Decision logs directory */
-	DECISIONS: "decisions",
-} as const;
-
-/**
- * Default configuration file names
- */
-export const DEFAULT_FILES = {
-	/** Main configuration file */
-	CONFIG: "config.yml",
-	/** Local user settings file */
-	USER: ".user",
-} as const;
-
-/**
- * Default task statuses
- */
-export const DEFAULT_STATUSES = ["To Do", "In Progress", "Done"] as const;
-
-/**
- * Fallback status when no default is configured
- */
-export const FALLBACK_STATUS = "To Do";
-
-/**
- * Maximum width for wrapped text lines in UI components
- */
-export const WRAP_LIMIT = 72;
-
-export * from "../guidelines/index.ts";

package/src/core/backlog.ts

@@ -1,183 +0,0 @@
-import { join } from "node:path";
-import { DEFAULT_STATUSES, FALLBACK_STATUS } from "../constants/index.ts";
-import { FileSystem } from "../file-system/operations.ts";
-import { GitOperations } from "../git/operations.ts";
-import type { BacklogConfig, DecisionLog, Document, Task } from "../types/index.ts";
-
-function ensureDescriptionHeader(description: string): string {
-	const trimmed = description.trim();
-	if (trimmed === "") {
-		return "## Description";
-	}
-	return /^##\s+Description/i.test(trimmed) ? trimmed : `## Description\n\n${trimmed}`;
-}
-
-export class Core {
-	private fs: FileSystem;
-	private git: GitOperations;
-
-	constructor(projectRoot: string) {
-		this.fs = new FileSystem(projectRoot);
-		this.git = new GitOperations(projectRoot);
-	}
-
-	// File system operations
-	get filesystem() {
-		return this.fs;
-	}
-
-	// Git operations
-	get gitOps() {
-		return this.git;
-	}
-
-	// High-level operations that combine filesystem and git
-	async createTask(task: Task, autoCommit = true): Promise<void> {
-		if (!task.status) {
-			const config = await this.fs.loadConfig();
-			task.status = config?.defaultStatus || FALLBACK_STATUS;
-		}
-
-		// Normalize assignee to array if it's a string (YAML allows both string and array)
-		// biome-ignore lint/suspicious/noExplicitAny: Required for YAML flexibility
-		if (typeof (task as any).assignee === "string") {
-			// biome-ignore lint/suspicious/noExplicitAny: Required for YAML flexibility
-			(task as any).assignee = [(task as any).assignee];
-		}
-
-		task.description = ensureDescriptionHeader(task.description);
-		await this.fs.saveTask(task);
-
-		if (autoCommit) {
-			const tasksDir = this.fs.tasksDir;
-			const files = await Array.fromAsync(new Bun.Glob("*.md").scan({ cwd: tasksDir }));
-			const taskFile = files.find((file) => file.startsWith(`task-${task.id} -`));
-			if (taskFile) {
-				const filePath = join(tasksDir, taskFile);
-				await this.git.addAndCommitTaskFile(task.id, filePath, "create");
-			}
-		}
-	}
-
-	async createDraft(task: Task, autoCommit = true): Promise<void> {
-		// Drafts always have status "Draft", regardless of config default
-		task.status = "Draft";
-
-		// Normalize assignee to array if it's a string (YAML allows both string and array)
-		// biome-ignore lint/suspicious/noExplicitAny: Required for YAML flexibility
-		if (typeof (task as any).assignee === "string") {
-			// biome-ignore lint/suspicious/noExplicitAny: Required for YAML flexibility
-			(task as any).assignee = [(task as any).assignee];
-		}
-
-		task.description = ensureDescriptionHeader(task.description);
-		await this.fs.saveDraft(task);
-
-		if (autoCommit) {
-			const draftsDir = this.fs.draftsDir;
-			const files = await Array.fromAsync(new Bun.Glob("*.md").scan({ cwd: draftsDir }));
-			const taskFile = files.find((file) => file.startsWith(`task-${task.id} -`));
-			if (taskFile) {
-				const filePath = join(draftsDir, taskFile);
-				await this.git.addFile(filePath);
-				await this.git.commitTaskChange(task.id, `Create draft ${task.id}`);
-			}
-		}
-	}
-
-	async updateTask(task: Task, autoCommit = true): Promise<void> {
-		// Normalize assignee to array if it's a string (YAML allows both string and array)
-		// biome-ignore lint/suspicious/noExplicitAny: Required for YAML flexibility
-		if (typeof (task as any).assignee === "string") {
-			// biome-ignore lint/suspicious/noExplicitAny: Required for YAML flexibility
-			(task as any).assignee = [(task as any).assignee];
-		}
-
-		task.description = ensureDescriptionHeader(task.description);
-		await this.fs.saveTask(task);
-
-		if (autoCommit) {
-			const tasksDir = this.fs.tasksDir;
-			const files = await Array.fromAsync(new Bun.Glob("*.md").scan({ cwd: tasksDir }));
-			const taskFile = files.find((file) => file.startsWith(`task-${task.id} -`));
-
-			if (taskFile) {
-				const filePath = join(tasksDir, taskFile);
-				await this.git.addAndCommitTaskFile(task.id, filePath, "update");
-			}
-		}
-	}
-
-	async archiveTask(taskId: string, autoCommit = true): Promise<boolean> {
-		const success = await this.fs.archiveTask(taskId);
-
-		if (success && autoCommit) {
-			await this.git.commitBacklogChanges(`Archive task ${taskId}`);
-		}
-
-		return success;
-	}
-
-	async archiveDraft(taskId: string, autoCommit = true): Promise<boolean> {
-		const success = await this.fs.archiveDraft(taskId);
-
-		if (success && autoCommit) {
-			await this.git.commitBacklogChanges(`Archive draft ${taskId}`);
-		}
-
-		return success;
-	}
-
-	async promoteDraft(taskId: string, autoCommit = true): Promise<boolean> {
-		const success = await this.fs.promoteDraft(taskId);
-
-		if (success && autoCommit) {
-			await this.git.commitBacklogChanges(`Promote draft ${taskId}`);
-		}
-
-		return success;
-	}
-
-	async demoteTask(taskId: string, autoCommit = true): Promise<boolean> {
-		const success = await this.fs.demoteTask(taskId);
-
-		if (success && autoCommit) {
-			await this.git.commitBacklogChanges(`Demote task ${taskId}`);
-		}
-
-		return success;
-	}
-
-	async createDecisionLog(decision: DecisionLog, autoCommit = true): Promise<void> {
-		await this.fs.saveDecisionLog(decision);
-
-		if (autoCommit) {
-			await this.git.commitBacklogChanges(`Add decision ${decision.id}`);
-		}
-	}
-
-	async createDocument(doc: Document, autoCommit = true, subPath = ""): Promise<void> {
-		await this.fs.saveDocument(doc, subPath);
-
-		if (autoCommit) {
-			await this.git.commitBacklogChanges(`Add document ${doc.id}`);
-		}
-	}
-
-	async initializeProject(projectName: string): Promise<void> {
-		await this.fs.ensureBacklogStructure();
-
-		const config: BacklogConfig = {
-			projectName: projectName,
-			statuses: [...DEFAULT_STATUSES],
-			labels: [],
-			milestones: [],
-			defaultStatus: DEFAULT_STATUSES[0], // Use first status as default
-			dateFormat: "yyyy-mm-dd",
-			maxColumnWidth: 20, // Default for terminal display
-		};
-
-		await this.fs.saveConfig(config);
-		await this.git.commitBacklogChanges(`Initialize backlog project: ${projectName}`);
-	}
-}

package/src/core/remote-tasks.ts

@@ -1,168 +0,0 @@
-/**
- * Helper functions for loading remote tasks in parallel
- */
-
-import { parseTask } from "../markdown/parser.ts";
-import type { Task } from "../types/index.ts";
-import type { GitOps } from "./git-ops.ts";
-
-export interface TaskWithMetadata extends Task {
-	lastModified?: Date;
-	source: "local" | "remote";
-	branch?: string;
-}
-
-interface RemoteTaskLoadResult {
-	task: TaskWithMetadata;
-	error?: never;
-}
-
-interface RemoteTaskLoadError {
-	task?: never;
-	error: Error;
-	file: string;
-	branch: string;
-}
-
-type RemoteTaskResult = RemoteTaskLoadResult | RemoteTaskLoadError;
-
-/**
- * Load all remote tasks in parallel for better performance
- */
-export async function loadRemoteTasks(
-	gitOps: GitOps,
-	onProgress?: (message: string) => void,
-): Promise<TaskWithMetadata[]> {
-	const tasks: TaskWithMetadata[] = [];
-
-	try {
-		// Fetch remote branches
-		onProgress?.("Fetching remote branches...");
-		await gitOps.fetch();
-		const branches = await gitOps.listRemoteBranches();
-
-		if (branches.length === 0) {
-			return tasks;
-		}
-
-		onProgress?.(`Found ${branches.length} remote branches`);
-
-		// Process all branches in parallel
-		const branchPromises = branches.map(async (branch) => {
-			const ref = `origin/${branch}`;
-
-			try {
-				// List files in the branch
-				const files = await gitOps.listFilesInTree(ref, ".backlog/tasks");
-
-				if (files.length === 0) {
-					return [];
-				}
-
-				// Load all files in this branch in parallel
-				const filePromises = files.map(async (file): Promise<RemoteTaskResult> => {
-					try {
-						// Load file content and timestamp in parallel
-						const [content, lastModified] = await Promise.all([
-							gitOps.showFile(ref, file),
-							gitOps.getFileLastModifiedTime(ref, file),
-						]);
-
-						const task = parseTask(content);
-
-						return {
-							task: {
-								...task,
-								lastModified: lastModified || undefined,
-								source: "remote" as const,
-								branch,
-							},
-						};
-					} catch (error) {
-						return {
-							error: error as Error,
-							file,
-							branch,
-						};
-					}
-				});
-
-				const results = await Promise.all(filePromises);
-
-				// Extract successful tasks and report errors
-				const branchTasks: TaskWithMetadata[] = [];
-				for (const result of results) {
-					if (result.task) {
-						branchTasks.push(result.task);
-					} else if (result.error) {
-						// Log error but continue processing
-						console.error(`Failed to load task from ${result.branch}:${result.file}: ${result.error.message}`);
-					}
-				}
-
-				onProgress?.(`Loaded ${branchTasks.length} tasks from ${branch}`);
-				return branchTasks;
-			} catch (error) {
-				console.error(`Failed to process branch ${branch}:`, error);
-				return [];
-			}
-		});
-
-		// Wait for all branches to complete
-		const branchResults = await Promise.all(branchPromises);
-
-		// Flatten results
-		for (const branchTasks of branchResults) {
-			tasks.push(...branchTasks);
-		}
-
-		onProgress?.(`Loaded ${tasks.length} total remote tasks`);
-	} catch (error) {
-		// If fetch fails, we can still work with local tasks
-		console.error("Failed to fetch remote tasks:", error);
-	}
-
-	return tasks;
-}
-
-/**
- * Resolve conflicts between local and remote tasks based on strategy
- */
-export function resolveTaskConflict(
-	existing: TaskWithMetadata,
-	incoming: TaskWithMetadata,
-	statuses: string[],
-	strategy: "most_recent" | "most_progressed" = "most_progressed",
-): TaskWithMetadata {
-	if (strategy === "most_recent") {
-		// First try to use updated_date from the task metadata
-		const existingDate = existing.updatedDate ? new Date(existing.updatedDate) : existing.lastModified;
-		const incomingDate = incoming.updatedDate ? new Date(incoming.updatedDate) : incoming.lastModified;
-
-		if (existingDate && incomingDate) {
-			return existingDate >= incomingDate ? existing : incoming;
-		}
-		// If we can't compare dates, fall back to most_progressed
-	}
-
-	// Default to most_progressed strategy
-	const currentIdx = statuses.indexOf(existing.status);
-	const newIdx = statuses.indexOf(incoming.status);
-
-	// If incoming task has a more progressed status, use it
-	if (newIdx > currentIdx || currentIdx === -1) {
-		return incoming;
-	}
-
-	// If statuses are equal and we have dates, use the most recent
-	if (newIdx === currentIdx) {
-		const existingDate = existing.updatedDate ? new Date(existing.updatedDate) : existing.lastModified;
-		const incomingDate = incoming.updatedDate ? new Date(incoming.updatedDate) : incoming.lastModified;
-
-		if (existingDate && incomingDate) {
-			return existingDate >= incomingDate ? existing : incoming;
-		}
-	}
-
-	return existing;
-}