@schnick371/devsteps-shared 0.0.1 → 0.5.0

package/README.md

@@ -1,15 +1,74 @@
 # @schnick371/devsteps-shared
 
-**Status:** Package name reserved for the DevSteps project.
+> Never Code Alone. Shared utilities and types for DevSteps packages.
 
-## About DevSteps
+## Overview
 
-DevSteps - Never Code Alone. AI-powered task tracking and development workflow management.
+Core package providing shared types, schemas, and utilities used across all DevSteps packages (CLI, MCP Server, VS Code Extension).
 
-**Coming Soon:** Shared types, schemas, and utilities for structured software development.
+## Features
 
-For more information, visit: https://devsteps.dev (coming soon)
+- **TypeScript Types**: Complete type definitions for work items, configurations, and API responses
+- **Zod Schemas**: Runtime validation for all data structures
+- **Core Functions**: File operations, item management, relationship handling
+- **Utilities**: ID parsing, timestamp handling, configuration management
 
----
+## Installation
 
-*This package is currently a placeholder to reserve the name. Full implementation coming soon.*
+```bash
+npm install @schnick371/devsteps-shared
+```
+
+## Usage
+
+```typescript
+import { addItem, getItem, listItems } from '@schnick371/devsteps-shared';
+import type { ItemType, ItemStatus } from '@schnick371/devsteps-shared';
+
+// Add a new work item
+const result = await addItem('/path/to/.devsteps', {
+  type: 'task',
+  title: 'Implement feature',
+  priority: 'high'
+});
+
+// Get work item
+const item = await getItem('/path/to/.devsteps', 'TASK-001');
+
+// List all items
+const items = await listItems('/path/to/.devsteps');
+```
+
+## Exports
+
+### Core Functions
+- `addItem()` - Create new work item
+- `getItem()` - Retrieve work item by ID
+- `updateItem()` - Update existing work item
+- `deleteItem()` - Delete work item
+- `listItems()` - List all work items with filters
+- `searchItems()` - Full-text search across items
+- `linkItems()` - Create relationships between items
+- `archiveItem()` - Archive completed items
+
+### Types
+- `ItemType` - Epic, Story, Task, Bug, etc.
+- `ItemStatus` - Draft, In Progress, Done, etc.
+- `Priority` - Critical, High, Medium, Low
+- `Methodology` - Scrum, Waterfall, Hybrid
+- `ItemMetadata` - Complete work item structure
+
+### Schemas
+- `addItemSchema` - Validation for item creation
+- `updateItemSchema` - Validation for updates
+- `linkItemSchema` - Validation for relationships
+
+## Documentation
+
+- [DevSteps Documentation](https://devsteps.dev)
+- [GitHub Repository](https://github.com/Schnick371/devsteps)
+- [Issue Tracker](https://github.com/Schnick371/devsteps/issues)
+
+## License
+
+Apache-2.0 © Thomas Hertel

package/dist/core/add.d.ts

@@ -0,0 +1,23 @@
+import type { DevCrumbsConfig, EisenhowerQuadrant, ItemMetadata, ItemType, Priority } from '../schemas/index.js';
+export interface AddItemArgs {
+    type: ItemType;
+    title: string;
+    description?: string;
+    category?: string;
+    priority?: Priority;
+    tags?: string[];
+    affected_paths?: string[];
+    assignee?: string;
+    eisenhower?: EisenhowerQuadrant;
+}
+export interface AddItemResult {
+    itemId: string;
+    metadata: ItemMetadata;
+    config: DevCrumbsConfig;
+}
+/**
+ * Core business logic for adding a new item to devcrumbs
+ * Pure function that handles all file I/O and validation
+ */
+export declare function addItem(devcrumbsDir: string, args: AddItemArgs): Promise<AddItemResult>;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/core/add.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EAEf,kBAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA8G7F"}

package/dist/core/add.js

@@ -0,0 +1,102 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { TYPE_TO_DIRECTORY, generateItemId, getCurrentTimestamp } from '../utils/index.js';
+/**
+ * Core business logic for adding a new item to devcrumbs
+ * Pure function that handles all file I/O and validation
+ */
+export async function addItem(devcrumbsDir, args) {
+    // Check if initialized
+    if (!existsSync(devcrumbsDir)) {
+        throw new Error('Project not initialized. Run devcrumbs-init first.');
+    }
+    // Read config and index
+    const configPath = join(devcrumbsDir, 'config.json');
+    const indexPath = join(devcrumbsDir, 'index.json');
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    const index = JSON.parse(readFileSync(indexPath, 'utf-8'));
+    // Migration: Initialize counters if missing (for legacy projects)
+    if (!index.counters) {
+        index.counters = {};
+        // Calculate existing max IDs per type
+        for (const item of index.items) {
+            const match = item.id.match(/-(\d+)$/);
+            if (match) {
+                const num = Number.parseInt(match[1], 10);
+                index.counters[item.type] = Math.max(index.counters[item.type] || 0, num);
+            }
+        }
+    }
+    // Generate ID using global counter
+    const typeFolder = TYPE_TO_DIRECTORY[args.type];
+    const counter = (index.counters[args.type] || 0) + 1;
+    const itemId = generateItemId(args.type, counter);
+    // Check for duplicate ID (data integrity validation)
+    const existingIds = index.items.map((i) => i.id);
+    if (existingIds.includes(itemId)) {
+        throw new Error(`Duplicate ID detected: ${itemId}. Index may be corrupted or counter was reset. Please check .devcrumbs/index.json`);
+    }
+    // Increment counter
+    index.counters[args.type] = counter;
+    // Create metadata
+    const now = getCurrentTimestamp();
+    const metadata = {
+        id: itemId,
+        type: args.type,
+        category: args.category || 'general',
+        title: args.title,
+        status: 'draft',
+        priority: args.priority || 'medium',
+        eisenhower: args.eisenhower,
+        created: now,
+        updated: now,
+        author: args.assignee || config.settings.default_author,
+        assignee: args.assignee,
+        affected_paths: args.affected_paths || [],
+        linked_items: {
+            implements: [],
+            'implemented-by': [],
+            'tested-by': [],
+            tests: [],
+            blocks: [],
+            'blocked-by': [],
+            'relates-to': [],
+            'depends-on': [],
+            'required-by': [],
+            supersedes: [],
+            'superseded-by': [],
+        },
+        tags: args.tags || [],
+        commits: [],
+        metadata: {},
+    };
+    // Save metadata
+    const itemDir = join(devcrumbsDir, typeFolder);
+    const metadataPath = join(itemDir, `${itemId}.json`);
+    const descriptionPath = join(itemDir, `${itemId}.md`);
+    writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+    // Save description
+    const description = args.description || `# ${args.title}\n\n<!-- Add detailed description here -->\n`;
+    writeFileSync(descriptionPath, description);
+    // Update index
+    index.items.push({
+        id: itemId,
+        type: args.type,
+        title: args.title,
+        status: 'draft',
+        priority: args.priority || 'medium',
+        updated: now,
+    });
+    index.last_updated = now;
+    index.stats = index.stats || { total: 0, by_type: {}, by_status: {} };
+    index.stats.total = index.items.length;
+    index.stats.by_type[args.type] = (index.stats.by_type[args.type] || 0) + 1;
+    index.stats.by_status.draft = (index.stats.by_status.draft || 0) + 1;
+    writeFileSync(indexPath, JSON.stringify(index, null, 2));
+    return {
+        itemId,
+        metadata,
+        config,
+    };
+}
+//# sourceMappingURL=add.js.map

package/dist/core/add.js.map

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

package/dist/core/archive.d.ts

@@ -0,0 +1,24 @@
+import type { ItemStatus } from '../schemas/index.js';
+export interface ArchiveItemResult {
+    itemId: string;
+    archivedAt: string;
+    originalStatus: ItemStatus;
+}
+/**
+ * Core business logic for archiving a single item
+ */
+export declare function archiveItem(devcrumbsDir: string, itemId: string): Promise<ArchiveItemResult>;
+export interface PurgeItemsArgs {
+    status?: ItemStatus[];
+    type?: string;
+    olderThan?: Date;
+}
+export interface PurgeItemsResult {
+    count: number;
+    archivedIds: string[];
+}
+/**
+ * Core business logic for bulk archiving items
+ */
+export declare function purgeItems(devcrumbsDir: string, args?: PurgeItemsArgs): Promise<PurgeItemsResult>;
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,UAAU,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0ElG;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA6C3B"}

package/dist/core/archive.js

@@ -0,0 +1,109 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { TYPE_TO_DIRECTORY, getCurrentTimestamp, parseItemId } from '../utils/index.js';
+/**
+ * Core business logic for archiving a single item
+ */
+export async function archiveItem(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}`);
+    }
+    // Read metadata
+    const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+    const originalStatus = metadata.status;
+    // Create archive directory if not exists
+    const archiveDir = join(devcrumbsDir, 'archive', typeFolder);
+    mkdirSync(archiveDir, { recursive: true });
+    // Move files to archive
+    const archiveMetadataPath = join(archiveDir, `${itemId}.json`);
+    const archiveDescriptionPath = join(archiveDir, `${itemId}.md`);
+    renameSync(metadataPath, archiveMetadataPath);
+    if (existsSync(descriptionPath)) {
+        renameSync(descriptionPath, archiveDescriptionPath);
+    }
+    // Update index
+    const indexPath = join(devcrumbsDir, 'index.json');
+    const index = JSON.parse(readFileSync(indexPath, 'utf-8'));
+    // Remove from items
+    const itemIndex = index.items.findIndex((i) => i.id === itemId);
+    if (itemIndex !== -1) {
+        index.items.splice(itemIndex, 1);
+    }
+    // Add to archived_items
+    const archivedAt = getCurrentTimestamp();
+    index.archived_items = index.archived_items || [];
+    index.archived_items.push({
+        id: itemId,
+        type: parsed.type,
+        title: metadata.title,
+        archived_at: archivedAt,
+        original_status: originalStatus,
+    });
+    // Update stats
+    if (index.stats) {
+        index.stats.total = index.items.length;
+        index.stats.by_status[originalStatus] = Math.max((index.stats.by_status[originalStatus] || 1) - 1, 0);
+        index.stats.archived = (index.stats.archived || 0) + 1;
+    }
+    index.last_updated = archivedAt;
+    writeFileSync(indexPath, JSON.stringify(index, null, 2));
+    return {
+        itemId,
+        archivedAt,
+        originalStatus,
+    };
+}
+/**
+ * Core business logic for bulk archiving items
+ */
+export async function purgeItems(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'));
+    // Find items to archive
+    let itemsToArchive = [...index.items];
+    // Filter by status (default: done, cancelled)
+    const statusFilter = args.status || ['done', 'cancelled'];
+    itemsToArchive = itemsToArchive.filter((i) => statusFilter.includes(i.status));
+    // Filter by type
+    if (args.type) {
+        itemsToArchive = itemsToArchive.filter((i) => i.type === args.type);
+    }
+    // Filter by date
+    if (args.olderThan) {
+        const cutoffDate = args.olderThan;
+        itemsToArchive = itemsToArchive.filter((i) => {
+            const updated = new Date(i.updated);
+            return updated < cutoffDate;
+        });
+    }
+    // Archive each item
+    const archivedIds = [];
+    for (const item of itemsToArchive) {
+        try {
+            await archiveItem(devcrumbsDir, item.id);
+            archivedIds.push(item.id);
+        }
+        catch (error) {
+            // Continue with next item on error
+            console.error(`Failed to archive ${item.id}:`, error);
+        }
+    }
+    return {
+        count: archivedIds.length,
+        archivedIds,
+    };
+}
+//# sourceMappingURL=archive.js.map

package/dist/core/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQxF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,YAAoB,EAAE,MAAc;IACpE,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,gBAAgB;IAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;IAEvC,yCAAyC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC7D,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,wBAAwB;IACxB,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAC/D,MAAM,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC;IAEhE,UAAU,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,UAAU,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;IACtD,CAAC;IAED,eAAe;IACf,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,KAAK,GAAmB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,oBAAoB;IACpB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAChE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,wBAAwB;IACxB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;IAClD,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;QACxB,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,cAAc;KAChC,CAAC,CAAC;IAEH,eAAe;IACf,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,GAAG,CAC9C,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAChD,CAAC,CACF,CAAC;QACF,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,YAAY,GAAG,UAAU,CAAC;IAChC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzD,OAAO;QACL,MAAM;QACN,UAAU;QACV,cAAc;KACf,CAAC;AACJ,CAAC;AAaD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAAoB,EACpB,OAAuB,EAAE;IAEzB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,KAAK,GAAmB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,wBAAwB;IACxB,IAAI,cAAc,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAEtC,8CAA8C;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1D,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/E,iBAAiB;IACjB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,iBAAiB;IACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QAClC,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3C,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACpC,OAAO,OAAO,GAAG,UAAU,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACzC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mCAAmC;YACnC,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/core/bulk-update.d.ts

@@ -0,0 +1,34 @@
+import type { ItemMetadata } from '../schemas/index.js';
+export interface BulkUpdateResult {
+    success: string[];
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+    total: number;
+}
+/**
+ * Bulk update multiple items at once
+ * @param devcrumbsDir Path to .devcrumbs directory
+ * @param itemIds Array of item IDs to update
+ * @param updates Partial item metadata to apply to all items
+ * @returns Result with success and failure lists
+ */
+export declare function bulkUpdateItems(devcrumbsDir: string, itemIds: string[], updates: Partial<ItemMetadata>): Promise<BulkUpdateResult>;
+/**
+ * Bulk add tags to multiple items
+ * @param devcrumbsDir Path to .devcrumbs directory
+ * @param itemIds Array of item IDs
+ * @param tagsToAdd Tags to add
+ * @returns Result with success and failure lists
+ */
+export declare function bulkAddTags(devcrumbsDir: string, itemIds: string[], tagsToAdd: string[]): Promise<BulkUpdateResult>;
+/**
+ * Bulk remove tags from multiple items
+ * @param devcrumbsDir Path to .devcrumbs directory
+ * @param itemIds Array of item IDs
+ * @param tagsToRemove Tags to remove
+ * @returns Result with success and failure lists
+ */
+export declare function bulkRemoveTags(devcrumbsDir: string, itemIds: string[], tagsToRemove: string[]): Promise<BulkUpdateResult>;
+//# sourceMappingURL=bulk-update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-update.d.ts","sourceRoot":"","sources":["../../src/core/bulk-update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,qBAAqB,CAAC;AAIpE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAwD3B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAmD3B"}

package/dist/core/bulk-update.js

@@ -0,0 +1,141 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCurrentTimestamp } from '../utils/index.js';
+import { updateItem } from './update.js';
+/**
+ * Bulk update multiple items at once
+ * @param devcrumbsDir Path to .devcrumbs directory
+ * @param itemIds Array of item IDs to update
+ * @param updates Partial item metadata to apply to all items
+ * @returns Result with success and failure lists
+ */
+export async function bulkUpdateItems(devcrumbsDir, itemIds, updates) {
+    const result = {
+        success: [],
+        failed: [],
+        total: itemIds.length,
+    };
+    for (const id of itemIds) {
+        try {
+            await updateItem(devcrumbsDir, {
+                id,
+                ...updates,
+            });
+            result.success.push(id);
+        }
+        catch (error) {
+            result.failed.push({
+                id,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Bulk add tags to multiple items
+ * @param devcrumbsDir Path to .devcrumbs directory
+ * @param itemIds Array of item IDs
+ * @param tagsToAdd Tags to add
+ * @returns Result with success and failure lists
+ */
+export async function bulkAddTags(devcrumbsDir, itemIds, tagsToAdd) {
+    const result = {
+        success: [],
+        failed: [],
+        total: itemIds.length,
+    };
+    for (const id of itemIds) {
+        try {
+            const { type, folder } = await import('../utils/index.js').then((m) => ({
+                type: m.parseItemId(id)?.type,
+                folder: m.TYPE_TO_DIRECTORY[m.parseItemId(id)?.type || 'task'],
+            }));
+            if (!type) {
+                throw new Error(`Invalid item ID: ${id}`);
+            }
+            const metadataPath = join(devcrumbsDir, folder, `${id}.json`);
+            if (!existsSync(metadataPath)) {
+                throw new Error(`Item ${id} not found`);
+            }
+            const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+            // Add new tags (avoid duplicates)
+            const existingTags = new Set(metadata.tags);
+            for (const tag of tagsToAdd) {
+                existingTags.add(tag);
+            }
+            metadata.tags = Array.from(existingTags);
+            metadata.updated = getCurrentTimestamp();
+            writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+            // Update index
+            const indexPath = join(devcrumbsDir, 'index.json');
+            const index = JSON.parse(readFileSync(indexPath, 'utf-8'));
+            const itemIndex = index.items.findIndex((i) => i.id === id);
+            if (itemIndex >= 0) {
+                index.items[itemIndex].updated = metadata.updated;
+            }
+            index.last_updated = getCurrentTimestamp();
+            writeFileSync(indexPath, JSON.stringify(index, null, 2));
+            result.success.push(id);
+        }
+        catch (error) {
+            result.failed.push({
+                id,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Bulk remove tags from multiple items
+ * @param devcrumbsDir Path to .devcrumbs directory
+ * @param itemIds Array of item IDs
+ * @param tagsToRemove Tags to remove
+ * @returns Result with success and failure lists
+ */
+export async function bulkRemoveTags(devcrumbsDir, itemIds, tagsToRemove) {
+    const result = {
+        success: [],
+        failed: [],
+        total: itemIds.length,
+    };
+    for (const id of itemIds) {
+        try {
+            const { type, folder } = await import('../utils/index.js').then((m) => ({
+                type: m.parseItemId(id)?.type,
+                folder: m.TYPE_TO_DIRECTORY[m.parseItemId(id)?.type || 'task'],
+            }));
+            if (!type) {
+                throw new Error(`Invalid item ID: ${id}`);
+            }
+            const metadataPath = join(devcrumbsDir, folder, `${id}.json`);
+            if (!existsSync(metadataPath)) {
+                throw new Error(`Item ${id} not found`);
+            }
+            const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+            // Remove tags
+            metadata.tags = metadata.tags.filter((tag) => !tagsToRemove.includes(tag));
+            metadata.updated = getCurrentTimestamp();
+            writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+            // Update index
+            const indexPath = join(devcrumbsDir, 'index.json');
+            const index = JSON.parse(readFileSync(indexPath, 'utf-8'));
+            const itemIndex = index.items.findIndex((i) => i.id === id);
+            if (itemIndex >= 0) {
+                index.items[itemIndex].updated = metadata.updated;
+            }
+            index.last_updated = getCurrentTimestamp();
+            writeFileSync(indexPath, JSON.stringify(index, null, 2));
+            result.success.push(id);
+        }
+        catch (error) {
+            result.failed.push({
+                id,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=bulk-update.js.map

package/dist/core/bulk-update.js.map

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

package/dist/core/context.d.ts

@@ -0,0 +1,54 @@
+import type { ContextLevel, QuickContext } from '../schemas/project.js';
+interface PackageInfo {
+    name: string;
+    purpose: string;
+    dependencies: string[];
+}
+interface ItemCounts {
+    total: number;
+    by_type: Record<string, number>;
+    by_status: Record<string, number>;
+}
+interface RecentUpdate {
+    id: string;
+    type: string;
+    title: string;
+    updated: string;
+}
+interface ContextResponse {
+    context_level: ContextLevel;
+    tokens_used: number;
+    static_context?: unknown;
+    dynamic_context: {
+        packages: PackageInfo[];
+        active_items: ItemCounts;
+        recent_updates: RecentUpdate[];
+    };
+    suggestions?: string[];
+}
+/**
+ * Analyze packages from workspace (with caching)
+ */
+export declare function analyzePackages(projectDir: string): Promise<PackageInfo[]>;
+/**
+ * Get item counts from index (with caching)
+ */
+export declare function getItemCounts(devcrumbsDir: string): Promise<ItemCounts>;
+/**
+ * Get recent updates (last N days) (with caching)
+ */
+export declare function getRecentUpdates(devcrumbsDir: string, days: number): Promise<RecentUpdate[]>;
+/**
+ * Read PROJECT.md if exists (with caching)
+ */
+export declare function readProjectMd(devcrumbsDir: string): Promise<QuickContext | null>;
+/**
+ * Estimate token count (rough approximation: 1 token ≈ 4 chars)
+ */
+export declare function estimateTokens(obj: unknown): number;
+/**
+ * Get quick context
+ */
+export declare function getQuickContext(projectDir: string, devcrumbsDir: string): Promise<ContextResponse>;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGxE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,eAAe;IACvB,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE;QACf,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,YAAY,EAAE,UAAU,CAAC;QACzB,cAAc,EAAE,YAAY,EAAE,CAAC;KAChC,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAyChF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC7E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAsClG;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkDtF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAoC1B"}