@backlog-md/core 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+# @backlog-md/core
+
+Runtime-agnostic core package for Backlog.md task management.
+
+## Status
+
+**Planning Phase** - This repository contains design documentation and architecture diagrams for extracting the core functionality from [Backlog.md](https://github.com/yourusername/Backlog.md) into a standalone package.
+
+## Goals
+
+1. **Runtime Independence** - Core logic works in Bun, Node.js, or browser environments
+2. **Adapter Pattern** - All I/O operations abstracted via injectable adapters
+3. **Testability** - Full test coverage using in-memory adapters
+4. **Reusability** - Use Backlog.md's task management as a library
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Core Package Extraction Design](docs/doc-003%20-%20Core-Package-Extraction-Design.md) | Architecture and migration plan |
+| [Test Adapter Specification](docs/test-adapter-specification.md) | Functionality requirements for test adapters |
+
+## Architecture Diagrams
+
+Located in `.principal-views/`:
+
+- **architecture.canvas** - Core package internal structure
+- **package-boundaries.canvas** - What goes in core vs CLI
+- **extraction-checklist.canvas** - Migration review items
+
+View with [Principal View CLI](https://github.com/principal-ai/principal-view-cli):
+
+```bash
+npx @principal-ai/principal-view-cli validate .principal-views/*.canvas
+```
+
+## Adapter Interfaces
+
+The core package will expose these adapter interfaces:
+
+```typescript
+// FileSystemAdapter - file operations
+interface FileSystemAdapter {
+  readFile(path: string): Promise<string>
+  writeFile(path: string, content: string): Promise<void>
+  exists(path: string): Promise<boolean>
+  createDir(path: string, options?: { recursive?: boolean }): Promise<void>
+  deleteFile(path: string): Promise<void>
+  rename(from: string, to: string): Promise<void>
+  // ...
+}
+
+// GlobAdapter - pattern matching
+interface GlobAdapter {
+  scan(pattern: string, options?: { cwd?: string }): AsyncIterable<string>
+}
+
+// GitAdapter - git operations
+interface GitAdapter {
+  exec(args: string[], options?: { cwd?: string }): Promise<ExecResult>
+  isGitRepository(root: string): Promise<boolean>
+  initRepository(root: string): Promise<void>
+}
+```
+
+## Usage (Planned)
+
+```typescript
+import { Core } from "@backlog-md/core";
+import { bunAdapters } from "@backlog-md/bun-adapters";
+
+const core = new Core("/path/to/project", {
+  adapters: bunAdapters,
+});
+
+// Create a task
+const task = await core.createTaskFromData({
+  title: "Implement feature",
+  status: "todo",
+  priority: "high",
+});
+
+// Query tasks
+const tasks = await core.queryTasks({
+  filters: { status: "in-progress" },
+});
+
+// Full-text search
+const searchService = await core.getSearchService();
+const results = await searchService.search({ query: "authentication" });
+```
+
+## Testing (Planned)
+
+```typescript
+import { Core } from "@backlog-md/core";
+import { createTestAdapters } from "@backlog-md/core/test-adapters";
+
+const adapters = createTestAdapters();
+adapters.fs.seedFiles({
+  "/project/backlog.json": '{"projectName": "Test"}',
+});
+adapters.git.mockBranch("main");
+
+const core = new Core("/project", { adapters });
+
+// Tests run in-memory, no filesystem access
+const task = await core.createTaskFromData({ title: "Test", status: "todo" });
+expect(task.id).toBe("1");
+```
+
+## License
+
+MIT

package/dist/abstractions/GitAdapter.d.ts

@@ -0,0 +1,83 @@
+/**
+ * GitAdapter - Abstract interface for Git operations
+ *
+ * This interface abstracts away the underlying git implementation,
+ * allowing the same business logic to run in different environments:
+ * - Bun (BunGitAdapter - uses Bun.spawn)
+ * - Node.js (NodeGitAdapter - uses child_process)
+ * - Browser (IsomorphicGitAdapter - uses isomorphic-git library)
+ * - Tests (MockGitAdapter - configurable mock responses)
+ */
+export interface GitExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GitExecOptions {
+    /** Whether this is a read-only operation (can use GIT_OPTIONAL_LOCKS=0) */
+    readOnly?: boolean;
+    /** Working directory for the command */
+    cwd?: string;
+    /** Environment variables to pass */
+    env?: Record<string, string>;
+}
+/**
+ * Low-level git command executor
+ * This is the core abstraction - higher-level operations are built on top
+ */
+export interface GitAdapter {
+    /**
+     * Execute a git command with the given arguments
+     * @param args - Git command arguments (e.g., ["status", "--porcelain"])
+     * @param options - Execution options
+     * @returns Command output
+     * @throws Error if the command fails (non-zero exit code)
+     */
+    exec(args: string[], options?: GitExecOptions): Promise<GitExecResult>;
+    /**
+     * Check if we're in a git repository
+     */
+    isGitRepository(path: string): Promise<boolean>;
+    /**
+     * Initialize a new git repository
+     */
+    initRepository(path: string): Promise<void>;
+    /**
+     * The project root this adapter operates on
+     */
+    readonly projectRoot: string;
+}
+/**
+ * High-level git operations interface
+ * These are convenience methods built on top of GitAdapter.exec()
+ * The GitOperations class implements these using a GitAdapter
+ */
+export interface GitOperationsInterface {
+    addFile(filePath: string): Promise<void>;
+    addFiles(filePaths: string[]): Promise<void>;
+    stageBacklogDirectory(backlogDir?: string): Promise<void>;
+    stageFileMove(fromPath: string, toPath: string): Promise<void>;
+    commitChanges(message: string): Promise<void>;
+    commitStagedChanges(message: string): Promise<void>;
+    commitTaskChange(taskId: string, message: string): Promise<void>;
+    addAndCommitTaskFile(taskId: string, filePath: string, action: "create" | "update" | "archive"): Promise<void>;
+    resetIndex(): Promise<void>;
+    getStatus(): Promise<string>;
+    isClean(): Promise<boolean>;
+    hasUncommittedChanges(): Promise<boolean>;
+    getLastCommitMessage(): Promise<string>;
+    getCurrentBranch(): Promise<string>;
+    listLocalBranches(): Promise<string[]>;
+    listAllBranches(remote?: string): Promise<string[]>;
+    listRemoteBranches(remote?: string): Promise<string[]>;
+    listRecentBranches(daysAgo: number): Promise<string[]>;
+    listRecentRemoteBranches(daysAgo: number, remote?: string): Promise<string[]>;
+    hasAnyRemote(): Promise<boolean>;
+    hasRemote(remote?: string): Promise<boolean>;
+    fetch(remote?: string): Promise<void>;
+    listFilesInTree(ref: string, path: string): Promise<string[]>;
+    showFile(ref: string, filePath: string): Promise<string>;
+    getBranchLastModifiedMap(ref: string, dir: string, sinceDays?: number): Promise<Map<string, Date>>;
+    getFileLastModifiedBranch(filePath: string): Promise<string | null>;
+}
+//# sourceMappingURL=GitAdapter.d.ts.map

package/dist/abstractions/GitAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitAdapter.d.ts","sourceRoot":"","sources":["../../src/abstractions/GitAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvE;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IAErC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,qBAAqB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG/D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGxC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAG9E,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGtC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,wBAAwB,CACtB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9B,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACrE"}

package/dist/abstractions/GitAdapter.js

@@ -0,0 +1,12 @@
+/**
+ * GitAdapter - Abstract interface for Git operations
+ *
+ * This interface abstracts away the underlying git implementation,
+ * allowing the same business logic to run in different environments:
+ * - Bun (BunGitAdapter - uses Bun.spawn)
+ * - Node.js (NodeGitAdapter - uses child_process)
+ * - Browser (IsomorphicGitAdapter - uses isomorphic-git library)
+ * - Tests (MockGitAdapter - configurable mock responses)
+ */
+export {};
+//# sourceMappingURL=GitAdapter.js.map

package/dist/abstractions/GitAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitAdapter.js","sourceRoot":"","sources":["../../src/abstractions/GitAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/abstractions/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Adapter abstractions for @backlog-md/core
+ *
+ * Re-exports common adapters from @principal-ai/repository-abstraction
+ * and adds backlog-specific adapters (GitAdapter).
+ */
+export type { FileSystemAdapter, FileStats, GlobAdapter, GlobOptions, } from "@principal-ai/repository-abstraction";
+export type { GitAdapter, GitExecResult, GitExecOptions, GitOperationsInterface, } from "./GitAdapter";
+//# sourceMappingURL=index.d.ts.map

package/dist/abstractions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abstractions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,sCAAsC,CAAC;AAG9C,YAAY,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/abstractions/index.js

@@ -0,0 +1,8 @@
+/**
+ * Adapter abstractions for @backlog-md/core
+ *
+ * Re-exports common adapters from @principal-ai/repository-abstraction
+ * and adds backlog-specific adapters (GitAdapter).
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/abstractions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/abstractions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/Core.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Core - Main entry point for @backlog-md/core
+ *
+ * Provides a runtime-agnostic API for managing Backlog.md projects
+ * by accepting adapter implementations for I/O operations.
+ */
+import type { FileSystemAdapter } from "@principal-ai/repository-abstraction";
+import type { Task, BacklogConfig, TaskListFilter } from "../types";
+/**
+ * Options for creating a Core instance
+ */
+export interface CoreOptions {
+    /** Root directory of the project */
+    projectRoot: string;
+    /** Adapter implementations for I/O operations */
+    adapters: {
+        /** FileSystem adapter (required) */
+        fs: FileSystemAdapter;
+    };
+}
+/**
+ * Core class for Backlog.md operations
+ *
+ * @example
+ * ```typescript
+ * const core = new Core({
+ *   projectRoot: '/path/to/project',
+ *   adapters: { fs: new NodeFileSystemAdapter() }
+ * });
+ *
+ * await core.initialize();
+ * const tasks = core.listTasks();
+ * const grouped = core.getTasksByStatus();
+ * ```
+ */
+export declare class Core {
+    private readonly projectRoot;
+    private readonly fs;
+    private config;
+    private tasks;
+    private initialized;
+    constructor(options: CoreOptions);
+    /**
+     * Check if projectRoot contains a valid Backlog.md project
+     */
+    isBacklogProject(): Promise<boolean>;
+    /**
+     * Initialize the Core instance
+     *
+     * Loads configuration and discovers all tasks.
+     * Must be called before using other methods.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the loaded configuration
+     *
+     * @throws Error if not initialized
+     */
+    getConfig(): BacklogConfig;
+    /**
+     * List all tasks, optionally filtered
+     *
+     * @param filter - Optional filter criteria
+     * @returns Sorted array of tasks
+     */
+    listTasks(filter?: TaskListFilter): Task[];
+    /**
+     * Get tasks grouped by status
+     *
+     * This is the primary method for kanban-style displays.
+     * Returns a Map with status as key and sorted tasks as value.
+     * The Map preserves the order of statuses from config.
+     */
+    getTasksByStatus(): Map<string, Task[]>;
+    /**
+     * Get a single task by ID
+     *
+     * @param id - Task ID
+     * @returns Task or undefined if not found
+     */
+    getTask(id: string): Task | undefined;
+    /**
+     * Reload all tasks from disk
+     *
+     * Useful after external changes to task files.
+     */
+    reload(): Promise<void>;
+    private ensureInitialized;
+    private loadTasksFromDirectory;
+}
+//# sourceMappingURL=Core.d.ts.map

package/dist/core/Core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Core.d.ts","sourceRoot":"","sources":["../../src/core/Core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAKpE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,QAAQ,EAAE;QACR,oCAAoC;QACpC,EAAE,EAAE,iBAAiB,CAAC;KACvB,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IAEvC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,WAAW;IAKhC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1C;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BjC;;;;OAIG;IACH,SAAS,IAAI,aAAa;IAK1B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAAE;IAyB1C;;;;;;OAMG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAMvC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAKrC;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,OAAO,CAAC,iBAAiB;YAMX,sBAAsB;CAiCrC"}

package/dist/core/Core.js

@@ -0,0 +1,170 @@
+/**
+ * Core - Main entry point for @backlog-md/core
+ *
+ * Provides a runtime-agnostic API for managing Backlog.md projects
+ * by accepting adapter implementations for I/O operations.
+ */
+import { parseBacklogConfig } from "./config-parser";
+import { parseTaskMarkdown } from "../markdown";
+import { sortTasks, groupTasksByStatus } from "../utils";
+/**
+ * Core class for Backlog.md operations
+ *
+ * @example
+ * ```typescript
+ * const core = new Core({
+ *   projectRoot: '/path/to/project',
+ *   adapters: { fs: new NodeFileSystemAdapter() }
+ * });
+ *
+ * await core.initialize();
+ * const tasks = core.listTasks();
+ * const grouped = core.getTasksByStatus();
+ * ```
+ */
+export class Core {
+    projectRoot;
+    fs;
+    config = null;
+    tasks = new Map();
+    initialized = false;
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.fs = options.adapters.fs;
+    }
+    /**
+     * Check if projectRoot contains a valid Backlog.md project
+     */
+    async isBacklogProject() {
+        const configPath = this.fs.join(this.projectRoot, "backlog", "config.yml");
+        return this.fs.exists(configPath);
+    }
+    /**
+     * Initialize the Core instance
+     *
+     * Loads configuration and discovers all tasks.
+     * Must be called before using other methods.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        // Load config
+        const configPath = this.fs.join(this.projectRoot, "backlog", "config.yml");
+        const configExists = await this.fs.exists(configPath);
+        if (!configExists) {
+            throw new Error(`Not a Backlog.md project: config.yml not found at ${configPath}`);
+        }
+        const configContent = await this.fs.readFile(configPath);
+        this.config = parseBacklogConfig(configContent);
+        // Load tasks from tasks/ directory
+        const tasksDir = this.fs.join(this.projectRoot, "backlog", "tasks");
+        if (await this.fs.exists(tasksDir)) {
+            await this.loadTasksFromDirectory(tasksDir, "local");
+        }
+        // Load tasks from completed/ directory
+        const completedDir = this.fs.join(this.projectRoot, "backlog", "completed");
+        if (await this.fs.exists(completedDir)) {
+            await this.loadTasksFromDirectory(completedDir, "completed");
+        }
+        this.initialized = true;
+    }
+    /**
+     * Get the loaded configuration
+     *
+     * @throws Error if not initialized
+     */
+    getConfig() {
+        this.ensureInitialized();
+        return this.config;
+    }
+    /**
+     * List all tasks, optionally filtered
+     *
+     * @param filter - Optional filter criteria
+     * @returns Sorted array of tasks
+     */
+    listTasks(filter) {
+        this.ensureInitialized();
+        let tasks = Array.from(this.tasks.values());
+        if (filter?.status) {
+            tasks = tasks.filter((t) => t.status === filter.status);
+        }
+        if (filter?.assignee) {
+            tasks = tasks.filter((t) => t.assignee.includes(filter.assignee));
+        }
+        if (filter?.priority) {
+            tasks = tasks.filter((t) => t.priority === filter.priority);
+        }
+        if (filter?.labels && filter.labels.length > 0) {
+            tasks = tasks.filter((t) => filter.labels.some((label) => t.labels.includes(label)));
+        }
+        if (filter?.parentTaskId) {
+            tasks = tasks.filter((t) => t.parentTaskId === filter.parentTaskId);
+        }
+        return sortTasks(tasks);
+    }
+    /**
+     * Get tasks grouped by status
+     *
+     * This is the primary method for kanban-style displays.
+     * Returns a Map with status as key and sorted tasks as value.
+     * The Map preserves the order of statuses from config.
+     */
+    getTasksByStatus() {
+        this.ensureInitialized();
+        const tasks = Array.from(this.tasks.values());
+        return groupTasksByStatus(tasks, this.config.statuses);
+    }
+    /**
+     * Get a single task by ID
+     *
+     * @param id - Task ID
+     * @returns Task or undefined if not found
+     */
+    getTask(id) {
+        this.ensureInitialized();
+        return this.tasks.get(id);
+    }
+    /**
+     * Reload all tasks from disk
+     *
+     * Useful after external changes to task files.
+     */
+    async reload() {
+        this.tasks.clear();
+        this.initialized = false;
+        await this.initialize();
+    }
+    // --- Private methods ---
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error("Core not initialized. Call initialize() first.");
+        }
+    }
+    async loadTasksFromDirectory(dir, source) {
+        const entries = await this.fs.readDir(dir);
+        for (const entry of entries) {
+            const fullPath = this.fs.join(dir, entry);
+            // Skip directories
+            if (await this.fs.isDirectory(fullPath)) {
+                continue;
+            }
+            // Only process markdown files
+            if (!entry.endsWith(".md")) {
+                continue;
+            }
+            try {
+                const content = await this.fs.readFile(fullPath);
+                const task = parseTaskMarkdown(content, fullPath);
+                // Set source based on directory
+                task.source = source;
+                this.tasks.set(task.id, task);
+            }
+            catch (error) {
+                // Log but don't fail on individual task parse errors
+                console.warn(`Failed to parse task file ${fullPath}:`, error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=Core.js.map

package/dist/core/Core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Core.js","sourceRoot":"","sources":["../../src/core/Core.ts"],"names":[],"mappings":"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"}

package/dist/core/config-parser.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Backlog.md Config Parser
+ *
+ * Parses config.yml using a line-by-line approach matching the official Backlog.md
+ * implementation. This is more reliable than a generic YAML parser for this format.
+ */
+import type { BacklogConfig } from "../types";
+/**
+ * Parse Backlog.md config.yml content
+ */
+export declare function parseBacklogConfig(content: string): BacklogConfig;
+/**
+ * Serialize BacklogConfig to config.yml format
+ */
+export declare function serializeBacklogConfig(config: BacklogConfig): string;
+//# sourceMappingURL=config-parser.d.ts.map

package/dist/core/config-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-parser.d.ts","sourceRoot":"","sources":["../../src/core/config-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA6GjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA8DpE"}