@hivehub/rulebook 1.2.0

package/dist/core/openspec-migrator.js

@@ -0,0 +1,255 @@
+import { existsSync, readdirSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { fileExists, readFile, writeFile } from '../utils/file-system.js';
+import { createTaskManager } from './task-manager.js';
+const OPENSPEC_DIR = 'openspec';
+const CHANGES_DIR = 'changes';
+const SPECS_DIR = 'specs';
+const TASKS_FILE = 'tasks.md';
+const PROPOSAL_FILE = 'proposal.md';
+const DESIGN_FILE = 'design.md';
+/**
+ * Migrate OpenSpec tasks to Rulebook format
+ */
+export async function migrateOpenSpecToRulebook(projectRoot, rulebookDir = 'rulebook') {
+    const result = {
+        migrated: 0,
+        skipped: 0,
+        errors: [],
+        migratedTasks: [],
+    };
+    const openspecPath = join(projectRoot, OPENSPEC_DIR);
+    const changesPath = join(openspecPath, CHANGES_DIR);
+    // Check if OpenSpec directory exists
+    if (!existsSync(changesPath)) {
+        return result; // No OpenSpec tasks to migrate
+    }
+    // Get all change directories
+    let changeDirs = [];
+    try {
+        changeDirs = readdirSync(changesPath, { withFileTypes: true })
+            .filter((dirent) => dirent.isDirectory())
+            .map((dirent) => dirent.name);
+    }
+    catch (error) {
+        result.errors.push(`Failed to read OpenSpec changes directory: ${error.message}`);
+        return result;
+    }
+    if (changeDirs.length === 0) {
+        return result; // No tasks to migrate
+    }
+    // Initialize TaskManager
+    const taskManager = createTaskManager(projectRoot, rulebookDir);
+    await taskManager.initialize();
+    // Migrate each task
+    for (const changeDir of changeDirs) {
+        const taskId = changeDir; // Use directory name as task ID
+        const sourceTaskPath = join(changesPath, changeDir);
+        const targetTaskPath = join(projectRoot, rulebookDir, 'tasks', taskId);
+        try {
+            // Check if task already exists in Rulebook
+            if (existsSync(targetTaskPath)) {
+                result.skipped++;
+                continue;
+            }
+            // Create target directory
+            mkdirSync(targetTaskPath, { recursive: true });
+            mkdirSync(join(targetTaskPath, SPECS_DIR), { recursive: true });
+            // Migrate proposal.md
+            const proposalSource = join(sourceTaskPath, PROPOSAL_FILE);
+            if (await fileExists(proposalSource)) {
+                const proposalContent = await readFile(proposalSource);
+                await writeFile(join(targetTaskPath, PROPOSAL_FILE), proposalContent);
+            }
+            // Migrate tasks.md
+            const tasksSource = join(sourceTaskPath, TASKS_FILE);
+            if (await fileExists(tasksSource)) {
+                const tasksContent = await readFile(tasksSource);
+                await writeFile(join(targetTaskPath, TASKS_FILE), tasksContent);
+            }
+            // Migrate design.md (if exists)
+            const designSource = join(sourceTaskPath, DESIGN_FILE);
+            if (await fileExists(designSource)) {
+                const designContent = await readFile(designSource);
+                await writeFile(join(targetTaskPath, DESIGN_FILE), designContent);
+            }
+            // Migrate specs
+            const specsSource = join(sourceTaskPath, SPECS_DIR);
+            if (existsSync(specsSource)) {
+                const specDirs = readdirSync(specsSource, { withFileTypes: true })
+                    .filter((dirent) => dirent.isDirectory())
+                    .map((dirent) => dirent.name);
+                for (const specDir of specDirs) {
+                    const specSource = join(specsSource, specDir, 'spec.md');
+                    if (await fileExists(specSource)) {
+                        const specContent = await readFile(specSource);
+                        const targetSpecDir = join(targetTaskPath, SPECS_DIR, specDir);
+                        mkdirSync(targetSpecDir, { recursive: true });
+                        await writeFile(join(targetSpecDir, 'spec.md'), specContent);
+                    }
+                }
+            }
+            result.migrated++;
+            result.migratedTasks.push(taskId);
+        }
+        catch (error) {
+            result.errors.push(`Failed to migrate task ${taskId}: ${error.message}`);
+            result.skipped++;
+        }
+    }
+    return result;
+}
+/**
+ * Migrate OpenSpec archived tasks to Rulebook format
+ */
+export async function migrateOpenSpecArchives(projectRoot, rulebookDir = 'rulebook') {
+    const result = {
+        migrated: 0,
+        skipped: 0,
+        errors: [],
+        migratedTasks: [],
+    };
+    const openspecPath = join(projectRoot, OPENSPEC_DIR);
+    const archivePath = join(openspecPath, CHANGES_DIR, 'archive');
+    // Check if OpenSpec archive directory exists
+    if (!existsSync(archivePath)) {
+        return result; // No archived tasks to migrate
+    }
+    // Get all archived task directories
+    let archiveDirs = [];
+    try {
+        archiveDirs = readdirSync(archivePath, { withFileTypes: true })
+            .filter((dirent) => dirent.isDirectory())
+            .map((dirent) => dirent.name);
+    }
+    catch (error) {
+        result.errors.push(`Failed to read OpenSpec archive directory: ${error.message}`);
+        return result;
+    }
+    if (archiveDirs.length === 0) {
+        return result; // No archived tasks to migrate
+    }
+    // Initialize TaskManager
+    const taskManager = createTaskManager(projectRoot, rulebookDir);
+    await taskManager.initialize();
+    // Migrate each archived task
+    for (const archiveDir of archiveDirs) {
+        const sourceArchivePath = join(archivePath, archiveDir);
+        // Preserve archive date prefix (YYYY-MM-DD-task-id format)
+        const archiveName = archiveDir; // Keep original name with date prefix
+        const targetArchivePath = join(projectRoot, rulebookDir, 'tasks', 'archive', archiveName);
+        try {
+            // Check if archive already exists in Rulebook
+            if (existsSync(targetArchivePath)) {
+                result.skipped++;
+                continue;
+            }
+            // Create target archive directory
+            mkdirSync(targetArchivePath, { recursive: true });
+            mkdirSync(join(targetArchivePath, SPECS_DIR), { recursive: true });
+            // Migrate proposal.md
+            const proposalSource = join(sourceArchivePath, PROPOSAL_FILE);
+            if (await fileExists(proposalSource)) {
+                const proposalContent = await readFile(proposalSource);
+                await writeFile(join(targetArchivePath, PROPOSAL_FILE), proposalContent);
+            }
+            // Migrate tasks.md
+            const tasksSource = join(sourceArchivePath, TASKS_FILE);
+            if (await fileExists(tasksSource)) {
+                const tasksContent = await readFile(tasksSource);
+                await writeFile(join(targetArchivePath, TASKS_FILE), tasksContent);
+            }
+            // Migrate design.md (if exists)
+            const designSource = join(sourceArchivePath, DESIGN_FILE);
+            if (await fileExists(designSource)) {
+                const designContent = await readFile(designSource);
+                await writeFile(join(targetArchivePath, DESIGN_FILE), designContent);
+            }
+            // Migrate specs
+            const specsSource = join(sourceArchivePath, SPECS_DIR);
+            if (existsSync(specsSource)) {
+                const specDirs = readdirSync(specsSource, { withFileTypes: true })
+                    .filter((dirent) => dirent.isDirectory())
+                    .map((dirent) => dirent.name);
+                for (const specDir of specDirs) {
+                    const specSource = join(specsSource, specDir, 'spec.md');
+                    if (await fileExists(specSource)) {
+                        const specContent = await readFile(specSource);
+                        const targetSpecDir = join(targetArchivePath, SPECS_DIR, specDir);
+                        mkdirSync(targetSpecDir, { recursive: true });
+                        await writeFile(join(targetSpecDir, 'spec.md'), specContent);
+                    }
+                }
+            }
+            result.migrated++;
+            result.migratedTasks.push(archiveName);
+        }
+        catch (error) {
+            result.errors.push(`Failed to migrate archived task ${archiveName}: ${error.message}`);
+            result.skipped++;
+        }
+    }
+    return result;
+}
+/**
+ * Remove /rulebook/OPENSPEC.md if it exists
+ */
+export async function removeOpenSpecRulebookFile(projectRoot, rulebookDir = 'rulebook') {
+    const openspecRulebookPath = join(projectRoot, rulebookDir, 'OPENSPEC.md');
+    if (await fileExists(openspecRulebookPath)) {
+        const { unlink } = await import('fs/promises');
+        await unlink(openspecRulebookPath);
+        return true;
+    }
+    return false;
+}
+/**
+ * Remove OpenSpec commands from .cursor/commands/
+ */
+export async function removeOpenSpecCommands(projectRoot) {
+    const commandsDir = join(projectRoot, '.cursor', 'commands');
+    if (!existsSync(commandsDir)) {
+        return 0;
+    }
+    const openspecCommands = ['openspec-proposal.md', 'openspec-archive.md', 'openspec-apply.md'];
+    let removed = 0;
+    for (const command of openspecCommands) {
+        const commandPath = join(commandsDir, command);
+        if (await fileExists(commandPath)) {
+            const { unlink } = await import('fs/promises');
+            await unlink(commandPath);
+            removed++;
+        }
+    }
+    return removed;
+}
+/**
+ * Archive OpenSpec directory (move to archive)
+ */
+export async function archiveOpenSpecDirectory(projectRoot) {
+    const openspecPath = join(projectRoot, OPENSPEC_DIR);
+    if (!existsSync(openspecPath)) {
+        return false;
+    }
+    const archiveDate = new Date().toISOString().split('T')[0];
+    const archivePath = join(projectRoot, `openspec-archive-${archiveDate}`);
+    try {
+        // Use mv command to move directory
+        const { execSync } = await import('child_process');
+        execSync(`mv "${openspecPath}" "${archivePath}"`, { cwd: projectRoot });
+        return true;
+    }
+    catch {
+        // Fallback: copy and remove
+        const { cpSync, rmSync } = await import('fs');
+        try {
+            cpSync(openspecPath, archivePath, { recursive: true });
+            rmSync(openspecPath, { recursive: true, force: true });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=openspec-migrator.js.map

package/dist/core/openspec-migrator.js.map

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

package/dist/core/task-manager.d.ts

@@ -0,0 +1,65 @@
+export interface RulebookTask {
+    id: string;
+    title: string;
+    proposal?: string;
+    tasks?: string;
+    design?: string;
+    specs?: Record<string, string>;
+    status: 'pending' | 'in-progress' | 'completed' | 'blocked';
+    createdAt: string;
+    updatedAt: string;
+    archivedAt?: string;
+}
+export interface TaskValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare class TaskManager {
+    private rulebookPath;
+    private tasksPath;
+    private archivePath;
+    constructor(projectRoot: string, rulebookDir?: string);
+    /**
+     * Initialize Rulebook tasks directory structure
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the path to a task directory
+     */
+    getTaskPath(taskId: string): string;
+    /**
+     * Create a new task
+     */
+    createTask(taskId: string): Promise<void>;
+    /**
+     * List all tasks
+     */
+    listTasks(includeArchived?: boolean): Promise<RulebookTask[]>;
+    /**
+     * Load a task by ID
+     */
+    loadTask(taskId: string, archived?: boolean): Promise<RulebookTask | null>;
+    /**
+     * Validate task format (OpenSpec-compatible)
+     */
+    validateTask(taskId: string): Promise<TaskValidationResult>;
+    /**
+     * Archive a completed task
+     */
+    archiveTask(taskId: string, skipValidation?: boolean): Promise<void>;
+    /**
+     * Update task status
+     */
+    updateTaskStatus(taskId: string, status: RulebookTask['status']): Promise<void>;
+    /**
+     * Show task details
+     */
+    showTask(taskId: string): Promise<RulebookTask | null>;
+    /**
+     * Delete a task permanently
+     */
+    deleteTask(taskId: string): Promise<void>;
+}
+export declare function createTaskManager(projectRoot: string, rulebookDir?: string): TaskManager;
+//# sourceMappingURL=task-manager.d.ts.map

package/dist/core/task-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/core/task-manager.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAmB;IAMjE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C/C;;OAEG;IACG,SAAS,CAAC,eAAe,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyC1E;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA8DvF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkEjE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCjF;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAarF;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiB5D;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWhD;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAmB,GAC/B,WAAW,CAEb"}

package/dist/core/task-manager.js

@@ -0,0 +1,318 @@
+import { writeFile, existsSync, mkdirSync, readdirSync, statSync } from 'fs';
+import { promisify } from 'util';
+import { join } from 'path';
+import { fileExists, readFile as readFileUtil } from '../utils/file-system.js';
+const writeFileAsync = promisify(writeFile);
+const TASKS_DIR = 'tasks';
+const ARCHIVE_DIR = 'archive';
+const SPECS_DIR = 'specs';
+export class TaskManager {
+    rulebookPath;
+    tasksPath;
+    archivePath;
+    constructor(projectRoot, rulebookDir = 'rulebook') {
+        this.rulebookPath = join(projectRoot, rulebookDir);
+        this.tasksPath = join(this.rulebookPath, TASKS_DIR);
+        this.archivePath = join(this.tasksPath, ARCHIVE_DIR);
+    }
+    /**
+     * Initialize Rulebook tasks directory structure
+     */
+    async initialize() {
+        if (!existsSync(this.rulebookPath)) {
+            mkdirSync(this.rulebookPath, { recursive: true });
+        }
+        if (!existsSync(this.tasksPath)) {
+            mkdirSync(this.tasksPath, { recursive: true });
+        }
+        if (!existsSync(this.archivePath)) {
+            mkdirSync(this.archivePath, { recursive: true });
+        }
+    }
+    /**
+     * Get the path to a task directory
+     */
+    getTaskPath(taskId) {
+        return join(this.tasksPath, taskId);
+    }
+    /**
+     * Create a new task
+     */
+    async createTask(taskId) {
+        await this.initialize();
+        const taskPath = join(this.tasksPath, taskId);
+        if (existsSync(taskPath)) {
+            throw new Error(`Task ${taskId} already exists`);
+        }
+        mkdirSync(taskPath, { recursive: true });
+        mkdirSync(join(taskPath, SPECS_DIR), { recursive: true });
+        // Create proposal.md template
+        const proposalContent = `# Proposal: ${taskId}
+
+## Why
+[Explain why this change is needed - minimum 20 characters]
+
+## What Changes
+[Describe what will change]
+
+## Impact
+- Affected specs: [list]
+- Affected code: [list]
+- Breaking change: YES/NO
+- User benefit: [describe]
+`;
+        await writeFileAsync(join(taskPath, 'proposal.md'), proposalContent);
+        // Create tasks.md template
+        const tasksContent = `## 1. Implementation
+- [ ] 1.1 First task
+- [ ] 1.2 Second task
+
+## 2. Testing
+- [ ] 2.1 Write tests
+- [ ] 2.2 Verify coverage
+
+## 3. Documentation
+- [ ] 3.1 Update README
+- [ ] 3.2 Update CHANGELOG
+`;
+        await writeFileAsync(join(taskPath, 'tasks.md'), tasksContent);
+    }
+    /**
+     * List all tasks
+     */
+    async listTasks(includeArchived = false) {
+        await this.initialize();
+        const tasks = [];
+        // List active tasks
+        if (existsSync(this.tasksPath)) {
+            const entries = readdirSync(this.tasksPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() && entry.name !== ARCHIVE_DIR) {
+                    const task = await this.loadTask(entry.name);
+                    if (task) {
+                        tasks.push(task);
+                    }
+                }
+            }
+        }
+        // List archived tasks if requested
+        if (includeArchived && existsSync(this.archivePath)) {
+            const archiveEntries = readdirSync(this.archivePath, { withFileTypes: true });
+            for (const entry of archiveEntries) {
+                if (entry.isDirectory()) {
+                    const task = await this.loadTask(entry.name, true);
+                    if (task) {
+                        // Extract date from archive name (YYYY-MM-DD-task-id format)
+                        const dateMatch = entry.name.match(/^(\d{4}-\d{2}-\d{2})-/);
+                        if (dateMatch) {
+                            task.archivedAt = dateMatch[1];
+                        }
+                        else {
+                            task.archivedAt = new Date().toISOString().split('T')[0];
+                        }
+                        tasks.push(task);
+                    }
+                }
+            }
+        }
+        return tasks;
+    }
+    /**
+     * Load a task by ID
+     */
+    async loadTask(taskId, archived = false) {
+        const basePath = archived ? this.archivePath : this.tasksPath;
+        const taskPath = join(basePath, taskId);
+        if (!existsSync(taskPath)) {
+            return null;
+        }
+        const proposalPath = join(taskPath, 'proposal.md');
+        const tasksPath = join(taskPath, 'tasks.md');
+        const designPath = join(taskPath, 'design.md');
+        const specsPath = join(taskPath, SPECS_DIR);
+        const task = {
+            id: taskId,
+            title: taskId,
+            status: 'pending',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            specs: {},
+        };
+        // Load proposal
+        if (await fileExists(proposalPath)) {
+            task.proposal = await readFileUtil(proposalPath);
+        }
+        // Load tasks
+        if (await fileExists(tasksPath)) {
+            task.tasks = await readFileUtil(tasksPath);
+        }
+        // Load design
+        if (await fileExists(designPath)) {
+            task.design = await readFileUtil(designPath);
+        }
+        // Load specs
+        if (existsSync(specsPath)) {
+            const specEntries = readdirSync(specsPath, { withFileTypes: true });
+            for (const specEntry of specEntries) {
+                if (specEntry.isDirectory()) {
+                    const specFile = join(specsPath, specEntry.name, 'spec.md');
+                    if (await fileExists(specFile)) {
+                        task.specs[specEntry.name] = await readFileUtil(specFile);
+                    }
+                }
+            }
+        }
+        // Get file stats for dates
+        try {
+            const stats = statSync(taskPath);
+            task.createdAt = stats.birthtime.toISOString();
+            task.updatedAt = stats.mtime.toISOString();
+        }
+        catch {
+            // Use defaults if stats fail
+        }
+        return task;
+    }
+    /**
+     * Validate task format (OpenSpec-compatible)
+     */
+    async validateTask(taskId) {
+        const task = await this.loadTask(taskId);
+        if (!task) {
+            return {
+                valid: false,
+                errors: [`Task ${taskId} not found`],
+                warnings: [],
+            };
+        }
+        const errors = [];
+        const warnings = [];
+        // Validate proposal
+        if (!task.proposal) {
+            errors.push('Missing proposal.md');
+        }
+        else {
+            // Check Purpose section (minimum 20 characters)
+            const purposeMatch = task.proposal.match(/## Why\s*\n([\s\S]*?)(?=\n##|$)/);
+            if (!purposeMatch || purposeMatch[1].trim().length < 20) {
+                errors.push('Purpose section (## Why) must have at least 20 characters');
+            }
+        }
+        // Validate specs
+        if (!task.specs || Object.keys(task.specs).length === 0) {
+            warnings.push('No spec files found (specs/*/spec.md)');
+        }
+        else {
+            for (const [module, specContent] of Object.entries(task.specs)) {
+                // Check for requirements with SHALL/MUST
+                const requirementMatches = specContent.match(/### Requirement:.*/g) || [];
+                for (const req of requirementMatches) {
+                    const reqText = specContent.substring(specContent.indexOf(req));
+                    const reqBody = reqText.split('\n').slice(1).join('\n').split('####')[0];
+                    if (!reqBody.match(/\b(SHALL|MUST)\b/i)) {
+                        errors.push(`Requirement in ${module}/spec.md missing SHALL or MUST keyword: ${req}`);
+                    }
+                }
+                // Check for scenarios with 4 hashtags (not 3)
+                // Only check at start of line (not in text content)
+                const scenario3Matches = specContent.match(/^### Scenario:/gm) || [];
+                if (scenario3Matches.length > 0) {
+                    errors.push(`Scenarios in ${module}/spec.md must use 4 hashtags (####), not 3 (###)`);
+                }
+                // Check for Given/When/Then structure
+                const scenarios = specContent.match(/#### Scenario:[\s\S]*?(?=####|##|$)/g) || [];
+                for (const scenario of scenarios) {
+                    const hasGiven = /Given/i.test(scenario);
+                    const hasWhen = /When/i.test(scenario);
+                    const hasThen = /Then/i.test(scenario);
+                    if (!hasGiven || !hasWhen || !hasThen) {
+                        warnings.push(`Scenario in ${module}/spec.md should use Given/When/Then structure`);
+                    }
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Archive a completed task
+     */
+    async archiveTask(taskId, skipValidation = false) {
+        const task = await this.loadTask(taskId);
+        if (!task) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        // Validate before archiving (unless skipped)
+        if (!skipValidation) {
+            const validation = await this.validateTask(taskId);
+            if (!validation.valid) {
+                throw new Error(`Task validation failed:\n${validation.errors.join('\n')}`);
+            }
+        }
+        const taskPath = join(this.tasksPath, taskId);
+        const archiveDate = new Date().toISOString().split('T')[0];
+        const archiveName = `${archiveDate}-${taskId}`;
+        const archiveTaskPath = join(this.archivePath, archiveName);
+        // Ensure archive directory exists
+        if (!existsSync(this.archivePath)) {
+            mkdirSync(this.archivePath, { recursive: true });
+        }
+        if (existsSync(archiveTaskPath)) {
+            throw new Error(`Archive ${archiveName} already exists`);
+        }
+        // Move task to archive using cross-platform filesystem operations
+        const { renameSync } = await import('fs');
+        renameSync(taskPath, archiveTaskPath);
+        // TODO: Apply spec deltas to main specifications
+        // This would require parsing the spec deltas and merging them into /rulebook/specs/
+    }
+    /**
+     * Update task status
+     */
+    async updateTaskStatus(taskId, status) {
+        const task = await this.loadTask(taskId);
+        if (!task) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        task.status = status;
+        task.updatedAt = new Date().toISOString();
+        // Status is updated in memory only
+        // In the future, we could persist this to a status.md file or update tasks.md
+    }
+    /**
+     * Show task details
+     */
+    async showTask(taskId) {
+        // Try active tasks first
+        let task = await this.loadTask(taskId, false);
+        if (task) {
+            return task;
+        }
+        // Try archived tasks
+        task = await this.loadTask(taskId, true);
+        if (task) {
+            task.archivedAt = taskId.split('-').slice(0, 3).join('-'); // Extract date from task ID
+            return task;
+        }
+        return null;
+    }
+    /**
+     * Delete a task permanently
+     */
+    async deleteTask(taskId) {
+        const taskPath = join(this.tasksPath, taskId);
+        if (!existsSync(taskPath)) {
+            throw new Error(`Task ${taskId} not found`);
+        }
+        // Remove task directory recursively
+        const { rmSync } = await import('fs');
+        rmSync(taskPath, { recursive: true, force: true });
+    }
+}
+export function createTaskManager(projectRoot, rulebookDir = 'rulebook') {
+    return new TaskManager(projectRoot, rulebookDir);
+}
+//# sourceMappingURL=task-manager.js.map