@backlog-md/core 0.2.2 → 0.3.0

package/dist/utils/milestones.js

@@ -0,0 +1,191 @@
+/**
+ * Milestone utilities for @backlog-md/core
+ *
+ * Functions for grouping tasks by milestone and calculating progress.
+ */
+/** Key used for tasks without a milestone */
+const NO_MILESTONE_KEY = "__none";
+/**
+ * Normalize a milestone name by trimming whitespace
+ */
+export function normalizeMilestoneName(name) {
+    return name.trim();
+}
+/**
+ * Get a lowercase key for milestone comparison
+ */
+export function milestoneKey(name) {
+    return normalizeMilestoneName(name ?? "").toLowerCase();
+}
+/**
+ * Check if a status represents a "done" state
+ */
+export function isDoneStatus(status) {
+    const normalized = (status ?? "").toLowerCase();
+    return normalized.includes("done") || normalized.includes("complete");
+}
+/**
+ * Get the display label for a milestone
+ * Uses the milestone entity title if available, otherwise returns the ID
+ */
+export function getMilestoneLabel(milestoneId, milestoneEntities) {
+    if (!milestoneId) {
+        return "Tasks without milestone";
+    }
+    const entity = milestoneEntities.find((m) => milestoneKey(m.id) === milestoneKey(milestoneId));
+    return entity?.title || milestoneId;
+}
+/**
+ * Collect all unique milestone IDs from tasks and milestone entities
+ */
+export function collectMilestoneIds(tasks, milestoneEntities) {
+    const merged = [];
+    const seen = new Set();
+    const addMilestone = (value) => {
+        const normalized = normalizeMilestoneName(value);
+        if (!normalized)
+            return;
+        const key = milestoneKey(normalized);
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        merged.push(normalized);
+    };
+    // Add milestone entities first (they have priority for ordering)
+    for (const entity of milestoneEntities) {
+        addMilestone(entity.id);
+    }
+    // Then add any milestones from tasks that aren't in entities
+    for (const task of tasks) {
+        addMilestone(task.milestone ?? "");
+    }
+    return merged;
+}
+/**
+ * Collect milestones from tasks and config (legacy support)
+ */
+export function collectMilestones(tasks, configMilestones) {
+    const merged = [];
+    const seen = new Set();
+    const addMilestone = (value) => {
+        const normalized = normalizeMilestoneName(value);
+        if (!normalized)
+            return;
+        const key = milestoneKey(normalized);
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        merged.push(normalized);
+    };
+    for (const m of configMilestones) {
+        addMilestone(m);
+    }
+    for (const task of tasks) {
+        addMilestone(task.milestone ?? "");
+    }
+    return merged;
+}
+/**
+ * Create a milestone bucket for a given milestone
+ */
+function createBucket(milestoneId, tasks, statuses, milestoneEntities, isNoMilestone) {
+    const bucketMilestoneKey = milestoneKey(milestoneId);
+    const bucketTasks = tasks.filter((task) => {
+        const taskMilestoneKey = milestoneKey(task.milestone);
+        return bucketMilestoneKey
+            ? taskMilestoneKey === bucketMilestoneKey
+            : !taskMilestoneKey;
+    });
+    const counts = {};
+    for (const status of statuses) {
+        counts[status] = 0;
+    }
+    for (const task of bucketTasks) {
+        const status = task.status ?? "";
+        counts[status] = (counts[status] ?? 0) + 1;
+    }
+    const doneCount = bucketTasks.filter((t) => isDoneStatus(t.status)).length;
+    const progress = bucketTasks.length > 0
+        ? Math.round((doneCount / bucketTasks.length) * 100)
+        : 0;
+    const key = bucketMilestoneKey ? bucketMilestoneKey : NO_MILESTONE_KEY;
+    const label = getMilestoneLabel(milestoneId, milestoneEntities);
+    return {
+        key,
+        label,
+        milestone: milestoneId,
+        isNoMilestone,
+        tasks: bucketTasks,
+        statusCounts: counts,
+        total: bucketTasks.length,
+        doneCount,
+        progress,
+    };
+}
+/**
+ * Build milestone buckets from tasks and milestone entities
+ *
+ * @param tasks - All tasks to group
+ * @param milestoneEntities - Milestone entities (for titles)
+ * @param statuses - Configured statuses (for status counts)
+ * @returns Array of milestone buckets
+ */
+export function buildMilestoneBuckets(tasks, milestoneEntities, statuses) {
+    const allMilestoneIds = collectMilestoneIds(tasks, milestoneEntities);
+    const buckets = [
+        // "No milestone" bucket first
+        createBucket(undefined, tasks, statuses, milestoneEntities, true),
+        // Then each milestone bucket
+        ...allMilestoneIds.map((m) => createBucket(m, tasks, statuses, milestoneEntities, false)),
+    ];
+    return buckets;
+}
+/**
+ * Build milestone buckets using config milestone strings (legacy support)
+ *
+ * @deprecated Use buildMilestoneBuckets with Milestone entities instead
+ */
+export function buildMilestoneBucketsFromConfig(tasks, configMilestones, statuses) {
+    // Convert config milestone strings to minimal Milestone entities
+    const milestoneEntities = configMilestones.map((id) => ({
+        id,
+        title: id,
+        description: "",
+        rawContent: "",
+        tasks: [],
+    }));
+    return buildMilestoneBuckets(tasks, milestoneEntities, statuses);
+}
+/**
+ * Build a complete milestone summary
+ *
+ * @param tasks - All tasks
+ * @param milestoneEntities - Milestone entities
+ * @param statuses - Configured statuses
+ * @returns MilestoneSummary with milestones and buckets
+ */
+export function buildMilestoneSummary(tasks, milestoneEntities, statuses) {
+    const milestones = collectMilestoneIds(tasks, milestoneEntities);
+    const buckets = buildMilestoneBuckets(tasks, milestoneEntities, statuses);
+    return {
+        milestones,
+        buckets,
+    };
+}
+/**
+ * Group tasks by milestone (simple version using config milestones)
+ *
+ * @param tasks - Tasks to group
+ * @param configMilestones - Milestones from config
+ * @param statuses - Configured statuses
+ * @returns MilestoneSummary
+ */
+export function groupTasksByMilestone(tasks, configMilestones, statuses) {
+    const milestones = collectMilestones(tasks, configMilestones);
+    const buckets = buildMilestoneBucketsFromConfig(tasks, configMilestones, statuses);
+    return {
+        milestones,
+        buckets,
+    };
+}
+//# sourceMappingURL=milestones.js.map

package/dist/utils/milestones.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backlog-md/core",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Runtime-agnostic core package for Backlog.md task management",
   "author": "Backlog.md Team",
   "license": "MIT",