@schnick371/devsteps-shared 0.0.1 → 0.5.0

package/dist/core/context.js

@@ -0,0 +1,198 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { CACHE_CONFIG, getCache } from '../utils/cache.js';
+/**
+ * Analyze packages from workspace (with caching)
+ */
+export async function analyzePackages(projectDir) {
+    const cache = getCache();
+    const cacheKey = `package_analysis:${projectDir}`;
+    const packagesDir = path.join(projectDir, 'packages');
+    // Try cache first
+    const cached = cache.get(cacheKey, CACHE_CONFIG.PACKAGE_ANALYSIS_TTL, packagesDir);
+    if (cached) {
+        return cached;
+    }
+    const packages = [];
+    try {
+        const entries = await fs.readdir(packagesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const pkgPath = path.join(packagesDir, entry.name, 'package.json');
+                try {
+                    const content = await fs.readFile(pkgPath, 'utf-8');
+                    const pkg = JSON.parse(content);
+                    packages.push({
+                        name: pkg.name || entry.name,
+                        purpose: pkg.description || 'No description',
+                        dependencies: Object.keys(pkg.dependencies || {}),
+                    });
+                }
+                catch {
+                    // Skip if no package.json
+                }
+            }
+        }
+    }
+    catch {
+        // No packages directory
+    }
+    // Cache the result
+    cache.set(cacheKey, packages, packagesDir);
+    return packages;
+}
+/**
+ * Get item counts from index (with caching)
+ */
+export async function getItemCounts(devcrumbsDir) {
+    const cache = getCache();
+    const cacheKey = `item_counts:${devcrumbsDir}`;
+    const indexPath = path.join(devcrumbsDir, 'index.json');
+    // Try cache first
+    const cached = cache.get(cacheKey, CACHE_CONFIG.ITEM_COUNTS_TTL, indexPath);
+    if (cached) {
+        return cached;
+    }
+    try {
+        const content = await fs.readFile(indexPath, 'utf-8');
+        const index = JSON.parse(content);
+        const counts = {
+            total: index.items.length,
+            by_type: {},
+            by_status: {},
+        };
+        for (const item of index.items) {
+            counts.by_type[item.type] = (counts.by_type[item.type] || 0) + 1;
+            counts.by_status[item.status] = (counts.by_status[item.status] || 0) + 1;
+        }
+        // Cache the result
+        cache.set(cacheKey, counts, indexPath);
+        return counts;
+    }
+    catch {
+        return { total: 0, by_type: {}, by_status: {} };
+    }
+}
+/**
+ * Get recent updates (last N days) (with caching)
+ */
+export async function getRecentUpdates(devcrumbsDir, days) {
+    const cache = getCache();
+    const cacheKey = `recent_updates:${devcrumbsDir}:${days}`;
+    const indexPath = path.join(devcrumbsDir, 'index.json');
+    // Try cache first
+    const cached = cache.get(cacheKey, CACHE_CONFIG.RECENT_UPDATES_TTL, indexPath);
+    if (cached) {
+        return cached;
+    }
+    const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+    try {
+        const content = await fs.readFile(indexPath, 'utf-8');
+        const index = JSON.parse(content);
+        const updates = index.items
+            .filter((item) => new Date(item.updated).getTime() > cutoff)
+            .sort((a, b) => new Date(b.updated).getTime() - new Date(a.updated).getTime())
+            .slice(0, 10)
+            .map((item) => ({
+            id: item.id,
+            type: item.type,
+            title: item.title,
+            updated: item.updated,
+        }));
+        // Cache the result
+        cache.set(cacheKey, updates, indexPath);
+        return updates;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read PROJECT.md if exists (with caching)
+ */
+export async function readProjectMd(devcrumbsDir) {
+    const cache = getCache();
+    const cacheKey = `project_md:${devcrumbsDir}`;
+    const projectPath = path.join(devcrumbsDir, 'PROJECT.md');
+    // Try cache first
+    const cached = cache.get(cacheKey, CACHE_CONFIG.PROJECT_MD_TTL, projectPath);
+    if (cached !== null) {
+        return cached;
+    }
+    try {
+        const content = await fs.readFile(projectPath, 'utf-8');
+        // Parse markdown to extract context (simplified)
+        // In production, use a proper markdown parser
+        const techStack = {};
+        const packages = [];
+        // Extract tech stack (look for bullet points after "### Tech Stack")
+        const techStackMatch = content.match(/### Tech Stack\n([\s\S]*?)(?=\n###|$)/);
+        if (techStackMatch) {
+            const lines = techStackMatch[1].split('\n');
+            for (const line of lines) {
+                const match = line.match(/- \*\*(.+?)\*\*: (.+)/);
+                if (match) {
+                    techStack[match[1]] = match[2];
+                }
+            }
+        }
+        // Extract project type
+        const projectTypeMatch = content.match(/### Project Type\n(.+)/);
+        const projectType = projectTypeMatch?.[1] || 'Unknown';
+        const result = {
+            tech_stack: techStack,
+            packages,
+            project_type: projectType,
+        };
+        // Cache the result
+        cache.set(cacheKey, result, projectPath);
+        return result;
+    }
+    catch {
+        // Cache the null result (file doesn't exist)
+        cache.set(cacheKey, null);
+        return null;
+    }
+}
+/**
+ * Estimate token count (rough approximation: 1 token ≈ 4 chars)
+ */
+export function estimateTokens(obj) {
+    const str = JSON.stringify(obj);
+    return Math.ceil(str.length / 4);
+}
+/**
+ * Get quick context
+ */
+export async function getQuickContext(projectDir, devcrumbsDir) {
+    const packages = await analyzePackages(projectDir);
+    const activeItems = await getItemCounts(devcrumbsDir);
+    const recentUpdates = await getRecentUpdates(devcrumbsDir, 7);
+    const staticContext = await readProjectMd(devcrumbsDir);
+    const response = {
+        context_level: 'quick',
+        tokens_used: 0,
+        dynamic_context: {
+            packages,
+            active_items: activeItems,
+            recent_updates: recentUpdates,
+        },
+    };
+    if (staticContext) {
+        response.static_context = staticContext;
+    }
+    response.tokens_used = estimateTokens(response);
+    // Add suggestions
+    const suggestions = [];
+    if (!staticContext) {
+        suggestions.push('Consider creating .devcrumbs/PROJECT.md for static context');
+    }
+    if (activeItems.by_status.blocked > 0) {
+        suggestions.push(`${activeItems.by_status.blocked} blocked items need attention`);
+    }
+    if (suggestions.length > 0) {
+        response.suggestions = suggestions;
+    }
+    return response;
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

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

package/dist/core/get.d.ts

@@ -0,0 +1,10 @@
+import type { ItemMetadata } from '../schemas/index.js';
+export interface GetItemResult {
+    metadata: ItemMetadata;
+    description: string;
+}
+/**
+ * Core business logic for getting an item
+ */
+export declare function getItem(devcrumbsDir: string, itemId: string): Promise<GetItemResult>;
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/core/get.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyB1F"}

package/dist/core/get.js

@@ -0,0 +1,28 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { TYPE_TO_DIRECTORY, parseItemId } from '../utils/index.js';
+/**
+ * Core business logic for getting an item
+ */
+export async function getItem(devcrumbsDir, itemId) {
+    if (!existsSync(devcrumbsDir)) {
+        throw new Error('Project not initialized. Run devcrumbs-init first.');
+    }
+    const parsed = parseItemId(itemId);
+    if (!parsed) {
+        throw new Error(`Invalid item ID: ${itemId}`);
+    }
+    const typeFolder = TYPE_TO_DIRECTORY[parsed.type];
+    const metadataPath = join(devcrumbsDir, typeFolder, `${itemId}.json`);
+    const descriptionPath = join(devcrumbsDir, typeFolder, `${itemId}.md`);
+    if (!existsSync(metadataPath)) {
+        throw new Error(`Item not found: ${itemId}`);
+    }
+    const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+    const description = existsSync(descriptionPath) ? readFileSync(descriptionPath, 'utf-8') : '';
+    return {
+        metadata,
+        description,
+    };
+}
+//# sourceMappingURL=get.js.map

package/dist/core/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/core/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOnE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,YAAoB,EAAE,MAAc;IAChE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC;IAEvE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAiB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9F,OAAO;QACL,QAAQ;QACR,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,9 @@
+export { addItem, type AddItemArgs, type AddItemResult } from './add.js';
+export { getItem, type GetItemResult } from './get.js';
+export { listItems, type ListItemsArgs, type ListItemsResult } from './list.js';
+export { updateItem, type UpdateItemArgs, type UpdateItemResult } from './update.js';
+export { archiveItem, type ArchiveItemResult, purgeItems, type PurgeItemsArgs, type PurgeItemsResult, } from './archive.js';
+export { getQuickContext, analyzePackages, getItemCounts, getRecentUpdates, readProjectMd, estimateTokens, } from './context.js';
+export { bulkUpdateItems, bulkAddTags, bulkRemoveTags, type BulkUpdateResult, } from './bulk-update.js';
+export { validateRelationship, type ValidationResult, type WorkItem } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EACL,WAAW,EACX,KAAK,iBAAiB,EACtB,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,WAAW,EACX,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,9 @@
+export { addItem } from './add.js';
+export { getItem } from './get.js';
+export { listItems } from './list.js';
+export { updateItem } from './update.js';
+export { archiveItem, purgeItems, } from './archive.js';
+export { getQuickContext, analyzePackages, getItemCounts, getRecentUpdates, readProjectMd, estimateTokens, } from './context.js';
+export { bulkUpdateItems, bulkAddTags, bulkRemoveTags, } from './bulk-update.js';
+export { validateRelationship } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAwC,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,OAAO,EAAsB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAA4C,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAA8C,MAAM,aAAa,CAAC;AACrF,OAAO,EACL,WAAW,EAEX,UAAU,GAGX,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,WAAW,EACX,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAwC,MAAM,iBAAiB,CAAC"}

package/dist/core/list.d.ts

@@ -0,0 +1,19 @@
+import type { DevCrumbsIndex, EisenhowerQuadrant, ItemStatus, ItemType, Priority } from '../schemas/index.js';
+export interface ListItemsArgs {
+    type?: ItemType;
+    status?: ItemStatus;
+    priority?: Priority;
+    assignee?: string;
+    tags?: string[];
+    eisenhower?: EisenhowerQuadrant;
+    limit?: number;
+}
+export interface ListItemsResult {
+    count: number;
+    items: DevCrumbsIndex['items'];
+}
+/**
+ * Core business logic for listing items with filters
+ */
+export declare function listItems(devcrumbsDir: string, args?: ListItemsArgs): Promise<ListItemsResult>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/core/list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,eAAe,CAAC,CA+D1B"}

package/dist/core/list.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { TYPE_TO_DIRECTORY } from '../utils/index.js';
+/**
+ * Core business logic for listing items with filters
+ */
+export async function listItems(devcrumbsDir, args = {}) {
+    if (!existsSync(devcrumbsDir)) {
+        throw new Error('Project not initialized. Run devcrumbs-init first.');
+    }
+    const indexPath = join(devcrumbsDir, 'index.json');
+    const index = JSON.parse(readFileSync(indexPath, 'utf-8'));
+    let items = [...index.items];
+    // Apply filters
+    if (args.type) {
+        items = items.filter((i) => i.type === args.type);
+    }
+    if (args.status) {
+        items = items.filter((i) => i.status === args.status);
+    }
+    if (args.priority) {
+        items = items.filter((i) => i.priority === args.priority);
+    }
+    if (args.assignee) {
+        // Load full metadata for assignee filter
+        items = items.filter((i) => {
+            const metadataPath = join(devcrumbsDir, TYPE_TO_DIRECTORY[i.type], `${i.id}.json`);
+            if (!existsSync(metadataPath))
+                return false;
+            const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+            return metadata.assignee === args.assignee;
+        });
+    }
+    if (args.tags && args.tags.length > 0) {
+        // Load full metadata for tags filter
+        const filterTags = args.tags;
+        items = items.filter((i) => {
+            const metadataPath = join(devcrumbsDir, TYPE_TO_DIRECTORY[i.type], `${i.id}.json`);
+            if (!existsSync(metadataPath))
+                return false;
+            const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+            return filterTags.every((tag) => metadata.tags.includes(tag));
+        });
+    }
+    if (args.eisenhower) {
+        // Load full metadata for eisenhower filter
+        items = items.filter((i) => {
+            const metadataPath = join(devcrumbsDir, TYPE_TO_DIRECTORY[i.type], `${i.id}.json`);
+            if (!existsSync(metadataPath))
+                return false;
+            const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+            return metadata.eisenhower === args.eisenhower;
+        });
+    }
+    // Apply limit
+    if (args.limit && args.limit > 0) {
+        items = items.slice(0, args.limit);
+    }
+    return {
+        count: items.length,
+        items,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/core/list.js.map

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

package/dist/core/update.d.ts

@@ -0,0 +1,23 @@
+import type { EisenhowerQuadrant, ItemMetadata, ItemStatus, Priority } from '../schemas/index.js';
+export interface UpdateItemArgs {
+    id: string;
+    status?: ItemStatus;
+    priority?: Priority;
+    eisenhower?: EisenhowerQuadrant;
+    superseded_by?: string;
+    title?: string;
+    description?: string;
+    append_description?: string;
+    assignee?: string;
+    tags?: string[];
+    affected_paths?: string[];
+}
+export interface UpdateItemResult {
+    metadata: ItemMetadata;
+    oldStatus: ItemStatus;
+}
+/**
+ * Core business logic for updating an item
+ */
+export declare function updateItem(devcrumbsDir: string, args: UpdateItemArgs): Promise<UpdateItemResult>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/core/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAqH3B"}

package/dist/core/update.js

@@ -0,0 +1,118 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { TYPE_TO_DIRECTORY, getCurrentTimestamp, parseItemId } from '../utils/index.js';
+/**
+ * Core business logic for updating an item
+ */
+export async function updateItem(devcrumbsDir, args) {
+    if (!existsSync(devcrumbsDir)) {
+        throw new Error('Project not initialized. Run devcrumbs-init first.');
+    }
+    const parsed = parseItemId(args.id);
+    if (!parsed) {
+        throw new Error(`Invalid item ID: ${args.id}`);
+    }
+    const typeFolder = TYPE_TO_DIRECTORY[parsed.type];
+    const metadataPath = join(devcrumbsDir, typeFolder, `${args.id}.json`);
+    const descriptionPath = join(devcrumbsDir, typeFolder, `${args.id}.md`);
+    if (!existsSync(metadataPath)) {
+        throw new Error(`Item not found: ${args.id}`);
+    }
+    // Read and update metadata
+    const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+    const oldStatus = metadata.status;
+    // Validate status transitions (parent-child rules)
+    if (args.status === 'done') {
+        // Helper function to validate children are complete
+        const validateChildren = (relationshipType) => {
+            const children = metadata.linked_items[relationshipType];
+            if (children.length > 0) {
+                const openChildren = [];
+                for (const childId of children) {
+                    const childParsed = parseItemId(childId);
+                    if (childParsed) {
+                        const childFolder = TYPE_TO_DIRECTORY[childParsed.type];
+                        const childPath = join(devcrumbsDir, childFolder, `${childId}.json`);
+                        if (existsSync(childPath)) {
+                            const childMeta = JSON.parse(readFileSync(childPath, 'utf-8'));
+                            if (childMeta.status !== 'done' && childMeta.status !== 'cancelled' && childMeta.status !== 'obsolete') {
+                                openChildren.push(childId);
+                            }
+                        }
+                    }
+                }
+                if (openChildren.length > 0) {
+                    const relationLabel = relationshipType === 'implemented-by' ? 'implementation' : 'test';
+                    throw new Error(`Cannot close ${args.id}: ${openChildren.length} ${relationLabel} item(s) still open: ${openChildren.join(', ')}`);
+                }
+            }
+        };
+        // Validate implemented-by children (Scrum: Epic→Story, Story→Task; Waterfall: Requirement→Feature, Feature→Task)
+        if (['epic', 'story', 'requirement', 'feature'].includes(metadata.type)) {
+            validateChildren('implemented-by');
+        }
+        // Validate tested-by children (all parent types must have tests complete)
+        if (['epic', 'story', 'requirement', 'feature'].includes(metadata.type)) {
+            validateChildren('tested-by');
+        }
+    }
+    if (args.status)
+        metadata.status = args.status;
+    if (args.priority)
+        metadata.priority = args.priority;
+    if (args.eisenhower)
+        metadata.eisenhower = args.eisenhower;
+    if (args.superseded_by !== undefined)
+        metadata.superseded_by = args.superseded_by;
+    if (args.title)
+        metadata.title = args.title;
+    if (args.assignee !== undefined)
+        metadata.assignee = args.assignee;
+    if (args.tags)
+        metadata.tags = args.tags;
+    if (args.affected_paths)
+        metadata.affected_paths = args.affected_paths;
+    metadata.updated = getCurrentTimestamp();
+    writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+    // Update description
+    if (args.description && args.append_description) {
+        throw new Error('Cannot use both description and append_description simultaneously');
+    }
+    if (args.description) {
+        // Replace entire description
+        writeFileSync(descriptionPath, args.description);
+    }
+    else if (args.append_description) {
+        // Append to existing (or create new if doesn't exist)
+        const existing = existsSync(descriptionPath)
+            ? readFileSync(descriptionPath, 'utf-8')
+            : '';
+        writeFileSync(descriptionPath, existing + args.append_description);
+    }
+    // Update index
+    const indexPath = join(devcrumbsDir, 'index.json');
+    const index = JSON.parse(readFileSync(indexPath, 'utf-8'));
+    const itemIndex = index.items.findIndex((i) => i.id === args.id);
+    if (itemIndex !== -1) {
+        if (args.status)
+            index.items[itemIndex].status = args.status;
+        if (args.priority)
+            index.items[itemIndex].priority = args.priority;
+        if (args.title)
+            index.items[itemIndex].title = args.title;
+        index.items[itemIndex].updated = metadata.updated;
+        // Update stats
+        if (args.status && oldStatus !== args.status) {
+            index.stats = index.stats || { total: 0, by_type: {}, by_status: {} };
+            index.stats.by_status[oldStatus] = (index.stats.by_status[oldStatus] || 1) - 1;
+            index.stats.by_status[args.status] = (index.stats.by_status[args.status] || 0) + 1;
+        }
+    }
+    index.last_updated = metadata.updated;
+    writeFileSync(indexPath, JSON.stringify(index, null, 2));
+    return {
+        metadata,
+        oldStatus,
+    };
+}
+//# sourceMappingURL=update.js.map

package/dist/core/update.js.map

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

package/dist/core/validation.d.ts

@@ -0,0 +1,28 @@
+import type { ItemType, Methodology } from '../schemas/index.js';
+/**
+ * Validation result with detailed error messaging
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    suggestion?: string;
+}
+/**
+ * Minimal work item info needed for validation
+ */
+export interface WorkItem {
+    id: string;
+    type: ItemType;
+}
+/**
+ * Validate relationship between two items based on methodology
+ * Only validates "implements" relationships - all other relations are flexible
+ *
+ * @param source - Item creating the relationship (child in hierarchy)
+ * @param target - Item being referenced (parent in hierarchy)
+ * @param relationType - Type of relationship
+ * @param methodology - Project methodology (scrum, waterfall, hybrid)
+ * @returns ValidationResult with valid flag and optional error/suggestion
+ */
+export declare function validateRelationship(source: WorkItem, target: WorkItem, relationType: string, methodology: Methodology): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,gBAAgB,CA8ClB"}