@backlog-md/core 0.2.1 → 0.3.0

package/dist/core/Core.d.ts

@@ -5,7 +5,8 @@
  * by accepting adapter implementations for I/O operations.
  */
 import type { FileSystemAdapter } from "@principal-ai/repository-abstraction";
-import type { Task, BacklogConfig, TaskListFilter, PaginationOptions, PaginatedResult, PaginatedTasksByStatus, PaginatedTasksBySource, TaskIndexEntry, SourcePaginationOptions } from "../types";
+import type { Task, BacklogConfig, TaskListFilter, PaginationOptions, PaginatedResult, PaginatedTasksByStatus, PaginatedTasksBySource, TaskIndexEntry, SourcePaginationOptions, MilestoneSummary, TaskCreateInput, TaskUpdateInput } from "../types";
+import type { Milestone } from "../types";
 /**
  * Options for initializing a new Backlog.md project
  */
@@ -31,6 +32,24 @@ export interface CoreOptions {
         fs: FileSystemAdapter;
     };
 }
+/**
+ * Input for creating a new milestone
+ */
+export interface MilestoneCreateInput {
+    /** Milestone title (required) */
+    title: string;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Input for updating an existing milestone
+ */
+export interface MilestoneUpdateInput {
+    /** New title (optional) */
+    title?: string;
+    /** New description (optional) */
+    description?: string;
+}
 /**
  * Core class for Backlog.md operations
  *
@@ -169,6 +188,65 @@ export declare class Core {
      * The Map preserves the order of statuses from config.
      */
     getTasksByStatus(): Map<string, Task[]>;
+    /**
+     * Get tasks grouped by milestone
+     *
+     * Returns a MilestoneSummary with:
+     * - milestones: List of milestone IDs in display order
+     * - buckets: Array of MilestoneBucket with tasks, progress, status counts
+     *
+     * The first bucket is always "Tasks without milestone".
+     * Each bucket includes progress percentage based on done status.
+     *
+     * @example
+     * ```typescript
+     * const summary = core.getTasksByMilestone();
+     * for (const bucket of summary.buckets) {
+     *   console.log(`${bucket.label}: ${bucket.progress}% complete`);
+     *   console.log(`  ${bucket.doneCount}/${bucket.total} tasks done`);
+     * }
+     * ```
+     */
+    getTasksByMilestone(): MilestoneSummary;
+    /**
+     * Get the milestones directory path
+     */
+    private getMilestonesDir;
+    /**
+     * List all milestones from the milestones directory
+     *
+     * @returns Array of Milestone objects sorted by ID
+     */
+    listMilestones(): Promise<Milestone[]>;
+    /**
+     * Load a single milestone by ID
+     *
+     * @param id - Milestone ID (e.g., "m-0")
+     * @returns Milestone or null if not found
+     */
+    loadMilestone(id: string): Promise<Milestone | null>;
+    /**
+     * Create a new milestone
+     *
+     * @param input - Milestone creation input
+     * @returns Created milestone
+     */
+    createMilestone(input: MilestoneCreateInput): Promise<Milestone>;
+    /**
+     * Update an existing milestone
+     *
+     * @param id - Milestone ID to update
+     * @param input - Fields to update
+     * @returns Updated milestone or null if not found
+     */
+    updateMilestone(id: string, input: MilestoneUpdateInput): Promise<Milestone | null>;
+    /**
+     * Delete a milestone
+     *
+     * @param id - Milestone ID to delete
+     * @returns true if deleted, false if not found
+     */
+    deleteMilestone(id: string): Promise<boolean>;
     /**
      * Get a single task by ID
      *
@@ -208,5 +286,56 @@ export declare class Core {
     private ensureInitialized;
     private applyFilters;
     private loadTasksFromDirectory;
+    /**
+     * Add a task ID to a milestone's tasks array
+     *
+     * @param taskId - Task ID to add
+     * @param milestoneId - Milestone ID to update
+     */
+    private addTaskToMilestone;
+    /**
+     * Remove a task ID from a milestone's tasks array
+     *
+     * @param taskId - Task ID to remove
+     * @param milestoneId - Milestone ID to update
+     */
+    private removeTaskFromMilestone;
+    /**
+     * Write a milestone to disk
+     */
+    private writeMilestoneFile;
+    /**
+     * Get the tasks directory path
+     */
+    private getTasksDir;
+    /**
+     * Create a new task
+     *
+     * @param input - Task creation input
+     * @returns Created task
+     */
+    createTask(input: TaskCreateInput): Promise<Task>;
+    /**
+     * Update an existing task
+     *
+     * @param id - Task ID to update
+     * @param input - Fields to update
+     * @returns Updated task or null if not found
+     */
+    updateTask(id: string, input: TaskUpdateInput): Promise<Task | null>;
+    /**
+     * Delete a task
+     *
+     * @param id - Task ID to delete
+     * @returns true if deleted, false if not found
+     */
+    deleteTask(id: string): Promise<boolean>;
+    /**
+     * Load specific tasks by their IDs (for lazy loading milestone tasks)
+     *
+     * @param ids - Array of task IDs to load
+     * @returns Array of loaded tasks (missing tasks excluded)
+     */
+    loadTasksByIds(ids: string[]): Promise<Task[]>;
 }
 //# sourceMappingURL=Core.d.ts.map

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

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