planfs-core 1.2.0

package/dist/backlog.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Backlog filtering, ordering, and hygiene helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTaskRefinementState = getTaskRefinementState;
+exports.listBacklogTasks = listBacklogTasks;
+exports.getBacklogReadiness = getBacklogReadiness;
+exports.reviewBacklog = reviewBacklog;
+exports.isStaleBacklogTask = isStaleBacklogTask;
+const next_work_1 = require("./next-work");
+const DEFAULT_STALE_AFTER_DAYS = 60;
+const PRIORITY_RANK = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3
+};
+function getTaskRefinementState(task) {
+    return task.refinementState ?? 'ready';
+}
+function listBacklogTasks(repository, options = {}) {
+    return Array.from(repository.tasks.values())
+        .filter(task => options.includeDone || task.status !== 'done')
+        .filter(task => matchesBacklogFilters(task, options))
+        .sort((a, b) => compareBacklogTasks(a, b, repository, options.now ?? new Date()));
+}
+function getBacklogReadiness(task, repository, options = {}) {
+    const missing = [];
+    if (!task.body.trim()) {
+        missing.push('body');
+    }
+    if (!task.priority) {
+        missing.push('priority');
+    }
+    if (options.requireEpic && !task.epic) {
+        missing.push('epic');
+    }
+    if (options.requireMilestone && !task.milestone) {
+        missing.push('milestone');
+    }
+    const readiness = (0, next_work_1.getTaskReadiness)(task, repository);
+    return {
+        ready: missing.length === 0
+            && readiness.blockingTaskIds.length === 0
+            && readiness.missingDependencyIds.length === 0,
+        missing,
+        blockingTaskIds: readiness.blockingTaskIds,
+        missingDependencyIds: readiness.missingDependencyIds
+    };
+}
+function reviewBacklog(repository, options = {}) {
+    const now = options.now ?? new Date();
+    return listBacklogTasks(repository, { ...options, now })
+        .map(task => {
+        const readiness = getBacklogReadiness(task, repository, options);
+        const stale = isStaleBacklogTask(task, {
+            now,
+            staleAfterDays: options.staleAfterDays
+        });
+        const reasons = [
+            ...readiness.missing.map(field => `Missing ${field}`),
+            ...readiness.blockingTaskIds.map(id => `Blocked by ${id}`),
+            ...readiness.missingDependencyIds.map(id => `Missing dependency ${id}`)
+        ];
+        if (stale) {
+            reasons.push(`No updates in ${options.staleAfterDays ?? DEFAULT_STALE_AFTER_DAYS} days`);
+        }
+        return {
+            task,
+            stale,
+            incomplete: !readiness.ready,
+            reasons,
+            recommendations: reviewRecommendations(task, readiness, stale)
+        };
+    })
+        .filter(item => item.stale || item.incomplete);
+}
+function isStaleBacklogTask(task, options = {}) {
+    const state = getTaskRefinementState(task);
+    if (task.status === 'done' || state === 'discarded') {
+        return false;
+    }
+    const updatedAt = task.updatedAt ? Date.parse(task.updatedAt) : undefined;
+    if (!updatedAt || Number.isNaN(updatedAt)) {
+        return true;
+    }
+    const staleAfterDays = options.staleAfterDays ?? DEFAULT_STALE_AFTER_DAYS;
+    const now = options.now ?? new Date();
+    return now.getTime() - updatedAt >= staleAfterDays * 86400000;
+}
+function matchesBacklogFilters(task, options) {
+    if (options.refinementState) {
+        const states = Array.isArray(options.refinementState)
+            ? options.refinementState
+            : [options.refinementState];
+        if (!states.includes(getTaskRefinementState(task))) {
+            return false;
+        }
+    }
+    if (options.assignee && task.assignee !== options.assignee) {
+        return false;
+    }
+    if (options.epic && task.epic !== options.epic) {
+        return false;
+    }
+    if (options.milestone && task.milestone !== options.milestone) {
+        return false;
+    }
+    if (options.priority && task.priority !== options.priority) {
+        return false;
+    }
+    if (options.tags?.length) {
+        const tags = new Set(task.tags ?? []);
+        if (!options.tags.every(tag => tags.has(tag))) {
+            return false;
+        }
+    }
+    if (options.query && !searchableText(task).includes(options.query.trim().toLowerCase())) {
+        return false;
+    }
+    return true;
+}
+function compareBacklogTasks(a, b, repository, now) {
+    return compareScopedOrder(a, b)
+        || comparePriority(a.priority, b.priority)
+        || compareDates(a.dueDate, b.dueDate, now)
+        || compareDates(targetDateForTask(a, repository), targetDateForTask(b, repository), now)
+        || a.id.localeCompare(b.id);
+}
+function compareScopedOrder(a, b) {
+    const aScope = a.epic ?? 'global';
+    const bScope = b.epic ?? 'global';
+    if (aScope === bScope) {
+        return orderValue(a) - orderValue(b);
+    }
+    return aScope.localeCompare(bScope);
+}
+function comparePriority(a, b) {
+    return priorityValue(a) - priorityValue(b);
+}
+function priorityValue(priority) {
+    return priority ? PRIORITY_RANK[priority] : 99;
+}
+function orderValue(task) {
+    return typeof task.backlogOrder === 'number'
+        ? task.backlogOrder
+        : Number.POSITIVE_INFINITY;
+}
+function compareDates(a, b, now) {
+    return dateRank(a, now) - dateRank(b, now);
+}
+function dateRank(value, now) {
+    if (!value) {
+        return Number.POSITIVE_INFINITY;
+    }
+    const time = Date.parse(value);
+    return Number.isNaN(time) ? Number.POSITIVE_INFINITY : time - now.getTime();
+}
+function targetDateForTask(task, repository) {
+    return task.epic
+        ? repository.epics.get(task.epic)?.targetDate
+        : task.milestone
+            ? repository.milestones.get(task.milestone)?.targetDate
+            : undefined;
+}
+function reviewRecommendations(task, readiness, stale) {
+    const recommendations = [];
+    if (readiness.missing.includes('body')) {
+        recommendations.push('refine');
+    }
+    if (readiness.missing.includes('priority')) {
+        recommendations.push('prioritize');
+    }
+    if (readiness.missing.includes('epic')) {
+        recommendations.push('link to an epic');
+    }
+    if (readiness.missing.includes('milestone')) {
+        recommendations.push('link to a milestone');
+    }
+    if (readiness.blockingTaskIds.length || readiness.missingDependencyIds.length) {
+        recommendations.push('review dependencies');
+    }
+    if (stale && getTaskRefinementState(task) === 'deferred') {
+        recommendations.push('discard or reactivate');
+    }
+    else if (stale) {
+        recommendations.push('refine, defer, or discard');
+    }
+    return Array.from(new Set(recommendations));
+}
+function searchableText(task) {
+    return [
+        task.id,
+        task.title,
+        task.status,
+        task.priority,
+        task.assignee,
+        task.epic,
+        task.milestone,
+        getTaskRefinementState(task),
+        task.tags?.join(' '),
+        task.body
+    ].filter(Boolean).join(' ').toLowerCase();
+}
+//# sourceMappingURL=backlog.js.map

package/dist/backlog.js.map

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

package/dist/bulk.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Transaction-like bulk task update workflows.
+ */
+import { Repository, Task } from './types';
+export type BulkTaskUpdateField = 'status' | 'priority' | 'assignee' | 'milestone' | 'estimate';
+export type BulkTaskUpdatePatch = Partial<Pick<Task, 'status' | 'priority' | 'assignee' | 'milestone' | 'estimate'>>;
+export interface BulkTaskUpdateOptions {
+    taskIds: string[];
+    patch: BulkTaskUpdatePatch;
+    dryRun?: boolean;
+    now?: Date;
+    expectedUpdatedAt?: Record<string, string | undefined>;
+}
+export interface BulkTaskUpdateChange {
+    id: string;
+    before: Task;
+    task: Task;
+    changedFields: BulkTaskUpdateField[];
+    preview: string;
+}
+export interface BulkTaskUpdateResult {
+    dryRun: boolean;
+    taskIds: string[];
+    changedTasks: BulkTaskUpdateChange[];
+    changedFields: BulkTaskUpdateField[];
+}
+export declare function bulkUpdateTasks(rootPath: string, repository: Repository, options: BulkTaskUpdateOptions): Promise<BulkTaskUpdateResult>;
+export declare function normalizeBulkTaskPatch(patch: BulkTaskUpdatePatch): BulkTaskUpdatePatch;
+//# sourceMappingURL=bulk.d.ts.map

package/dist/bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../src/bulk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,UAAU,EAAE,IAAI,EAA6C,MAAM,SAAS,CAAC;AAEtF,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,UAAU,GACV,UAAU,GACV,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAC5C,IAAI,EACJ,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAC9D,CAAC,CAAC;AAEH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAKD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAiF/B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,CAoBtF"}

package/dist/bulk.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Transaction-like bulk task update workflows.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bulkUpdateTasks = bulkUpdateTasks;
+exports.normalizeBulkTaskPatch = normalizeBulkTaskPatch;
+const files_1 = require("./files");
+const repositoryApi = __importStar(require("./repository"));
+const TASK_STATUSES = ['todo', 'in-progress', 'review', 'done'];
+const TASK_PRIORITIES = ['low', 'medium', 'high', 'critical'];
+async function bulkUpdateTasks(rootPath, repository, options) {
+    const taskIds = normalizeTaskIds(options.taskIds);
+    if (taskIds.length === 0) {
+        throw new Error('At least one task ID is required');
+    }
+    const patch = normalizeBulkTaskPatch(options.patch);
+    const conflicts = findBulkUpdateConflicts(repository, taskIds, options.expectedUpdatedAt);
+    if (conflicts.length > 0) {
+        throw new Error(`Bulk update conflict: ${conflicts.join('; ')}`);
+    }
+    const originals = new Map();
+    const changedTasks = [];
+    const changedFields = new Set();
+    const updatedAt = (options.now ?? new Date()).toISOString();
+    try {
+        for (const taskId of taskIds) {
+            const task = repository.tasks.get(taskId);
+            const before = cloneTask(task);
+            const updated = cloneTask(task);
+            const fields = applyBulkTaskPatch(updated, patch);
+            originals.set(taskId, before);
+            if (fields.length === 0) {
+                continue;
+            }
+            updated.updatedAt = updatedAt;
+            repository.tasks.set(taskId, updated);
+            fields.forEach(field => changedFields.add(field));
+            changedTasks.push({
+                id: taskId,
+                before,
+                task: updated,
+                changedFields: fields,
+                preview: repositoryApi.generateEntityContent(updated)
+            });
+        }
+        const validation = repositoryApi.validateRepositoryState(repository);
+        const errors = validation.errors.filter(error => error.severity === 'error');
+        if (errors.length > 0) {
+            throw new Error(`Bulk update failed validation: ${formatValidationErrors(errors)}`);
+        }
+    }
+    finally {
+        for (const [taskId, original] of originals) {
+            repository.tasks.set(taskId, original);
+        }
+    }
+    const result = {
+        dryRun: Boolean(options.dryRun),
+        taskIds,
+        changedTasks,
+        changedFields: Array.from(changedFields)
+    };
+    if (options.dryRun || changedTasks.length === 0) {
+        return result;
+    }
+    const originalContents = new Map();
+    try {
+        for (const change of changedTasks) {
+            if (!change.before.filePath) {
+                throw new Error(`Task file path is unavailable: ${change.id}`);
+            }
+            originalContents.set(change.before.filePath, await (0, files_1.readFile)(change.before.filePath));
+        }
+        for (const change of changedTasks) {
+            await repositoryApi.saveEntity(rootPath, change.task);
+        }
+    }
+    catch (error) {
+        await rollbackTaskFiles(originalContents);
+        throw error;
+    }
+    return result;
+}
+function normalizeBulkTaskPatch(patch) {
+    const normalized = {};
+    for (const [field, value] of Object.entries(patch)) {
+        switch (field) {
+            case 'status':
+                normalized.status = parseEnum(value, TASK_STATUSES, 'status');
+                break;
+            case 'priority':
+                normalized.priority = parseOptionalEnum(value, TASK_PRIORITIES, 'priority');
+                break;
+            case 'assignee':
+            case 'milestone':
+            case 'estimate':
+                normalized[field] = parseOptionalString(value);
+                break;
+            default:
+                throw new Error(`Unsupported bulk task update field: ${field}`);
+        }
+    }
+    return normalized;
+}
+function findBulkUpdateConflicts(repository, taskIds, expectedUpdatedAt) {
+    const conflicts = [];
+    for (const taskId of taskIds) {
+        const task = repository.tasks.get(taskId);
+        if (!task) {
+            conflicts.push(`Task not found: ${taskId}`);
+            continue;
+        }
+        if (!task.filePath) {
+            conflicts.push(`Task file path is unavailable: ${taskId}`);
+        }
+        if (expectedUpdatedAt
+            && Object.prototype.hasOwnProperty.call(expectedUpdatedAt, taskId)
+            && task.updatedAt !== expectedUpdatedAt[taskId]) {
+            conflicts.push(`Task changed since preview: ${taskId}`);
+        }
+    }
+    return conflicts;
+}
+function applyBulkTaskPatch(task, patch) {
+    const changed = [];
+    for (const field of Object.keys(patch)) {
+        const nextValue = patch[field];
+        if (task[field] === nextValue) {
+            continue;
+        }
+        task[field] = nextValue;
+        changed.push(field);
+    }
+    return changed;
+}
+function normalizeTaskIds(taskIds) {
+    return Array.from(new Set(taskIds.map(taskId => taskId.trim()).filter(Boolean)));
+}
+function cloneTask(task) {
+    return {
+        ...task,
+        dependsOn: task.dependsOn ? [...task.dependsOn] : undefined,
+        tags: task.tags ? [...task.tags] : undefined,
+        links: task.links ? { ...task.links } : undefined,
+        metadata: { ...task.metadata }
+    };
+}
+async function rollbackTaskFiles(originalContents) {
+    await Promise.all(Array.from(originalContents.entries()).map(([filePath, content]) => (0, files_1.writeFile)(filePath, content)));
+}
+function parseEnum(value, allowed, field) {
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new Error(`${field} must be one of: ${allowed.join(', ')}`);
+    }
+    return value;
+}
+function parseOptionalEnum(value, allowed, field) {
+    if (value === '') {
+        return undefined;
+    }
+    return parseEnum(value, allowed, field);
+}
+function parseOptionalString(value) {
+    if (typeof value !== 'string') {
+        throw new Error('Expected a string value');
+    }
+    return value.trim() || undefined;
+}
+function formatValidationErrors(errors) {
+    return errors.slice(0, 3).map(error => error.message).join('; ');
+}
+//# sourceMappingURL=bulk.js.map

package/dist/bulk.js.map

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

package/dist/files.d.ts

@@ -0,0 +1,38 @@
+/**
+ * File discovery module
+ * Discovers and loads PlanFS files from a repository
+ */
+export interface DiscoveredFile {
+    path: string;
+    name: string;
+    type: 'task' | 'epic' | 'milestone' | 'decision';
+    archived?: boolean;
+}
+export interface PlanfsInitializationResult {
+    root: string;
+    created: string[];
+    existing: string[];
+}
+/**
+ * Discover all PlanFS files in a repository
+ */
+export declare function discoverFiles(rootPath: string): Promise<DiscoveredFile[]>;
+export declare function discoverArchiveFiles(rootPath: string): Promise<DiscoveredFile[]>;
+/**
+ * Read file content
+ */
+export declare function readFile(filePath: string): Promise<string>;
+/**
+ * Write file content
+ */
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+export declare function deleteFile(filePath: string): Promise<void>;
+/**
+ * Check if .planfs directory exists
+ */
+export declare function planfsDirectoryExists(rootPath: string): Promise<boolean>;
+/**
+ * Ensure .planfs directory structure exists
+ */
+export declare function ensurePlanfsStructure(rootPath: string): Promise<PlanfsInitializationResult>;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAcD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CA8B3B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CA6B3B;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9E;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,0BAA0B,CAAC,CAkBrC"}