@planu/cli 0.30.0 → 0.31.0

package/dist/config/orchestration-topologies.json

@@ -0,0 +1,36 @@
+{
+  "topologies": {
+    "mesh": {
+      "id": "mesh",
+      "name": "Mesh (All-to-All)",
+      "description": "All agents work in parallel without a central coordinator. Results are reconciled at the end.",
+      "maxAgents": 10,
+      "supportsFailFast": true,
+      "bestFor": ["code-review", "parallel-testing", "independent-modules"]
+    },
+    "hierarchical": {
+      "id": "hierarchical",
+      "name": "Hierarchical (Coordinator + Workers)",
+      "description": "One coordinator agent decomposes tasks, workers execute. Workers report to coordinator.",
+      "maxAgents": 8,
+      "supportsFailFast": true,
+      "bestFor": ["feature-build", "spec-implementation", "large-refactors"]
+    },
+    "pipeline": {
+      "id": "pipeline",
+      "name": "Pipeline (Sequential Stages)",
+      "description": "Agents execute in sequence. Output of each stage becomes input for the next.",
+      "maxAgents": 5,
+      "supportsFailFast": true,
+      "bestFor": ["migrations", "staged-processing", "build-chains"]
+    },
+    "star": {
+      "id": "star",
+      "name": "Star (Hub-Spoke)",
+      "description": "One hub agent coordinates N spoke agents. Spokes report only to the hub.",
+      "maxAgents": 8,
+      "supportsFailFast": true,
+      "bestFor": ["security-audit", "multi-module-analysis", "distributed-testing"]
+    }
+  }
+}

package/dist/config/plugin-marketplace.json

@@ -0,0 +1,59 @@
+{
+  "marketplace": [
+    {
+      "id": "healthcare-templates",
+      "name": "Healthcare Spec Templates",
+      "description": "HIPAA-compliant spec templates for healthcare applications. Includes patient data handling, EHR integration, and clinical workflow patterns.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/healthcare-templates",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["healthcare", "hipaa", "templates", "compliance"]
+    },
+    {
+      "id": "fintech-compliance",
+      "name": "Fintech Compliance Analyzer",
+      "description": "Analyzes specs and code for PCI-DSS, SOX, and financial regulation compliance. Detects missing security controls and audit trails.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/fintech-compliance",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["fintech", "compliance", "pci-dss", "analyzer", "security"]
+    },
+    {
+      "id": "gaming-specs",
+      "name": "Gaming Spec Templates",
+      "description": "Spec templates for game development: multiplayer networking, game state management, asset pipelines, and platform-specific builds.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/gaming-specs",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["gaming", "templates", "multiplayer", "gamedev"]
+    },
+    {
+      "id": "api-security-analyzer",
+      "name": "API Security Analyzer",
+      "description": "Detects OWASP API Top 10 vulnerabilities in specs and API definitions. Supports REST, GraphQL, and gRPC across all languages.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/api-security-analyzer",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["security", "api", "owasp", "analyzer", "rest", "graphql"]
+    },
+    {
+      "id": "mobile-platform-templates",
+      "name": "Mobile Platform Templates",
+      "description": "Spec templates for mobile development across iOS (Swift/SwiftUI), Android (Kotlin/Compose), Flutter, and React Native.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/mobile-platform-templates",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["mobile", "ios", "android", "flutter", "react-native", "templates"]
+    }
+  ]
+}

package/dist/config/security-runtime-config.json

@@ -0,0 +1,26 @@
+{
+  "level": "standard",
+  "rateLimits": {
+    "read": {
+      "maxTokens": 60,
+      "refillRatePerSecond": 1,
+      "burstMultiplier": 2,
+      "burstDurationMs": 5000
+    },
+    "write": {
+      "maxTokens": 30,
+      "refillRatePerSecond": 0.5,
+      "burstMultiplier": 2,
+      "burstDurationMs": 5000
+    },
+    "destructive": {
+      "maxTokens": 10,
+      "refillRatePerSecond": 0.167,
+      "burstMultiplier": 2,
+      "burstDurationMs": 5000
+    }
+  },
+  "allowedDirectories": [],
+  "customInjectionPatterns": [],
+  "disabledCheckers": []
+}

package/dist/config/workers-registry.json

@@ -0,0 +1,100 @@
+{
+  "workers": [
+    {
+      "name": "test-gaps",
+      "description": "Detects source files without corresponding test files across TypeScript, Python, Go, Rust, and Java projects",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.py", "**/*.go", "**/*.rs", "**/*.java", "**/*.kt"]
+      },
+      "handler": "handlers/test-gaps",
+      "priority": 7,
+      "cooldownMs": 30000,
+      "enabled": true,
+      "tier": "free"
+    },
+    {
+      "name": "security-audit",
+      "description": "Scans for hardcoded secrets, unsafe eval/exec, SQL injection patterns, and insecure defaults",
+      "trigger": {
+        "type": "file-change",
+        "patterns": [
+          "**/*.ts",
+          "**/*.js",
+          "**/*.py",
+          "**/*.go",
+          "**/*.rs",
+          "**/*.java",
+          "**/*.env",
+          "**/*.yml",
+          "**/*.yaml"
+        ]
+      },
+      "handler": "handlers/security-audit",
+      "priority": 9,
+      "cooldownMs": 30000,
+      "enabled": true,
+      "tier": "free"
+    },
+    {
+      "name": "optimization",
+      "description": "Detects large files, long functions, high cyclomatic complexity, and potential circular imports",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.js", "**/*.py", "**/*.go", "**/*.rs", "**/*.java"]
+      },
+      "handler": "handlers/optimization",
+      "priority": 5,
+      "cooldownMs": 30000,
+      "enabled": true,
+      "tier": "free"
+    },
+    {
+      "name": "code-map",
+      "description": "Builds file/export dependency map with directory tree, entry points, and import graph",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.js", "**/*.py", "**/*.go", "**/*.rs", "**/*.java"]
+      },
+      "handler": "handlers/code-map",
+      "priority": 4,
+      "cooldownMs": 60000,
+      "enabled": true,
+      "tier": "pro"
+    },
+    {
+      "name": "documentation",
+      "description": "Finds exported functions, classes, and types without JSDoc, docstrings, or doc comments",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.js", "**/*.py", "**/*.go", "**/*.rs", "**/*.java"]
+      },
+      "handler": "handlers/documentation",
+      "priority": 3,
+      "cooldownMs": 60000,
+      "enabled": true,
+      "tier": "pro"
+    },
+    {
+      "name": "dependency-health",
+      "description": "Analyzes package.json, pyproject.toml, go.mod, Cargo.toml, and pom.xml for unpinned or risky dependencies",
+      "trigger": {
+        "type": "file-change",
+        "patterns": [
+          "**/package.json",
+          "**/pyproject.toml",
+          "**/requirements.txt",
+          "**/go.mod",
+          "**/Cargo.toml",
+          "**/pom.xml",
+          "**/build.gradle"
+        ]
+      },
+      "handler": "handlers/dependency-health",
+      "priority": 6,
+      "cooldownMs": 60000,
+      "enabled": true,
+      "tier": "free"
+    }
+  ]
+}

package/dist/engine/deleter/audit-logger.d.ts

@@ -0,0 +1,11 @@
+import type { AuditEntry, DeleteAction, DeleteItemType } from '../../types/index.js';
+/**
+ * Append an audit entry. Returns the generated audit ID.
+ * The audit trail is append-only — entries are never modified or removed.
+ */
+export declare function appendAuditEntry(projectId: string, action: DeleteAction, itemType: DeleteItemType, itemId: string, details: Record<string, unknown>): Promise<string>;
+/**
+ * Read all audit entries for a project.
+ */
+export declare function getAuditEntries(projectId: string): Promise<AuditEntry[]>;
+//# sourceMappingURL=audit-logger.d.ts.map

package/dist/engine/deleter/audit-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-logger.d.ts","sourceRoot":"","sources":["../../../src/engine/deleter/audit-logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQrF;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAE9E"}

package/dist/engine/deleter/audit-logger.js

@@ -0,0 +1,30 @@
+import { readJson, writeJson, projectDataDir } from '../../storage/base-store.js';
+import { randomUUID } from 'node:crypto';
+function auditFile(projectId) {
+    return `${projectDataDir(projectId)}/audit.json`;
+}
+/**
+ * Append an audit entry. Returns the generated audit ID.
+ * The audit trail is append-only — entries are never modified or removed.
+ */
+export async function appendAuditEntry(projectId, action, itemType, itemId, details) {
+    const entries = await readJson(auditFile(projectId), []);
+    const entry = {
+        id: randomUUID(),
+        timestamp: new Date().toISOString(),
+        action,
+        itemType,
+        itemId,
+        details,
+    };
+    entries.push(entry);
+    await writeJson(auditFile(projectId), entries);
+    return entry.id;
+}
+/**
+ * Read all audit entries for a project.
+ */
+export async function getAuditEntries(projectId) {
+    return readJson(auditFile(projectId), []);
+}
+//# sourceMappingURL=audit-logger.js.map

package/dist/engine/deleter/audit-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-logger.js","sourceRoot":"","sources":["../../../src/engine/deleter/audit-logger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,SAAS,SAAS,CAAC,SAAiB;IAClC,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,aAAa,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,MAAoB,EACpB,QAAwB,EACxB,MAAc,EACd,OAAgC;IAEhC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAe,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,KAAK,GAAe;QACxB,EAAE,EAAE,UAAU,EAAE;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM;QACN,QAAQ;QACR,MAAM;QACN,OAAO;KACR,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,EAAE,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,OAAO,QAAQ,CAAe,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/engine/deleter/core.d.ts

@@ -0,0 +1,39 @@
+import type { DeleteResult } from '../../types/index.js';
+/**
+ * Check if any specs reference the given specId as a dependency.
+ * Returns a list of dependent spec IDs for cascade awareness.
+ */
+export declare function checkSpecDependencies(projectId: string, specId: string): Promise<string[]>;
+/**
+ * Preview what would be deleted for a spec.
+ */
+export declare function previewDeleteSpec(projectId: string, specIds: string[]): Promise<DeleteResult>;
+/**
+ * Execute spec deletion (soft or hard).
+ */
+export declare function executeDeleteSpec(projectId: string, specIds: string[], force: boolean): Promise<DeleteResult>;
+/**
+ * Preview what would be deleted for a project.
+ */
+export declare function previewDeleteProject(projectId: string): Promise<DeleteResult>;
+/**
+ * Execute project deletion (soft or hard).
+ */
+export declare function executeDeleteProject(projectId: string, force: boolean): Promise<DeleteResult>;
+/**
+ * Execute pattern deletion (soft or hard).
+ */
+export declare function executeDeletePattern(projectId: string, patternIds: string[], force: boolean): Promise<DeleteResult>;
+/**
+ * Preview what would be deleted for patterns.
+ */
+export declare function previewDeletePattern(projectId: string, patternIds: string[]): Promise<DeleteResult>;
+/**
+ * Execute decision deletion.
+ */
+export declare function executeDeleteDecision(projectId: string, decisionIds: string[], force: boolean): Promise<DeleteResult>;
+/**
+ * Preview what would be deleted for decisions.
+ */
+export declare function previewDeleteDecision(projectId: string, decisionIds: string[]): Promise<DeleteResult>;
+//# sourceMappingURL=core.d.ts.map

package/dist/engine/deleter/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/deleter/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUzD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAahG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,YAAY,CAAC,CAkBvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAkDvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBnF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAwCvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAqCvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CA8CvB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,YAAY,CAAC,CAevB"}

package/dist/engine/deleter/core.js

@@ -0,0 +1,267 @@
+import { writeJson, projectDataDir } from '../../storage/base-store.js';
+import * as specStore from '../../storage/spec-store.js';
+import * as patternStore from '../../storage/pattern-store.js';
+import * as decisionStore from '../../storage/decision-store.js';
+import { moveToTrash, moveDataToTrash, countFiles, pathExists } from '../../storage/trash-store.js';
+import { appendAuditEntry } from './audit-logger.js';
+import { rm, mkdir, cp } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Check if any specs reference the given specId as a dependency.
+ * Returns a list of dependent spec IDs for cascade awareness.
+ */
+export async function checkSpecDependencies(projectId, specId) {
+    const specs = await specStore.listSpecs(projectId);
+    const dependents = [];
+    for (const s of specs) {
+        if (s.id === specId) {
+            continue;
+        }
+        const deps = s.dependencies;
+        if (Array.isArray(deps) && deps.includes(specId)) {
+            dependents.push(s.id);
+        }
+    }
+    return dependents;
+}
+/**
+ * Preview what would be deleted for a spec.
+ */
+export async function previewDeleteSpec(projectId, specIds) {
+    const warnings = [];
+    let itemsAffected = 0;
+    for (const specId of specIds) {
+        const spec = await specStore.getSpec(projectId, specId);
+        if (!spec) {
+            warnings.push(`Spec "${specId}" not found.`);
+            continue;
+        }
+        itemsAffected += 1;
+        const deps = await checkSpecDependencies(projectId, specId);
+        if (deps.length > 0) {
+            warnings.push(`Spec "${specId}" is referenced by: ${deps.join(', ')}`);
+        }
+    }
+    return { success: true, action: 'preview', itemsAffected, warnings };
+}
+/**
+ * Execute spec deletion (soft or hard).
+ */
+export async function executeDeleteSpec(projectId, specIds, force) {
+    const warnings = [];
+    const action = force ? 'hard_delete' : 'soft_delete';
+    // Validate all specs exist first (atomic check)
+    for (const specId of specIds) {
+        const spec = await specStore.getSpec(projectId, specId);
+        if (!spec) {
+            return {
+                success: false,
+                action,
+                itemsAffected: 0,
+                warnings: [`Spec "${specId}" not found. No items were deleted (atomic rollback).`],
+            };
+        }
+    }
+    // Check dependencies for all
+    for (const specId of specIds) {
+        const deps = await checkSpecDependencies(projectId, specId);
+        if (deps.length > 0) {
+            warnings.push(`Spec "${specId}" is referenced by: ${deps.join(', ')}`);
+        }
+    }
+    let lastAuditId;
+    // Execute deletion for each spec
+    for (const specId of specIds) {
+        const specDir = join(projectDataDir(projectId), 'specs', specId);
+        const dirExists = await pathExists(specDir);
+        if (!force && dirExists) {
+            await moveToTrash(projectId, 'spec', specId, specDir, { specId });
+        }
+        else if (dirExists) {
+            await rm(specDir, { recursive: true, force: true });
+        }
+        await specStore.deleteSpec(projectId, specId);
+        lastAuditId = await appendAuditEntry(projectId, action, 'spec', specId, { specIds });
+    }
+    return {
+        success: true,
+        action,
+        itemsAffected: specIds.length,
+        warnings,
+        auditId: lastAuditId,
+    };
+}
+/**
+ * Preview what would be deleted for a project.
+ */
+export async function previewDeleteProject(projectId) {
+    const dataDir = projectDataDir(projectId);
+    const exists = await pathExists(dataDir);
+    if (!exists) {
+        return {
+            success: false,
+            action: 'preview',
+            itemsAffected: 0,
+            warnings: ['Project data directory not found.'],
+        };
+    }
+    const fileCount = await countFiles(dataDir);
+    return {
+        success: true,
+        action: 'preview',
+        itemsAffected: fileCount,
+        warnings: [`This will delete ${String(fileCount)} files in ${dataDir}.`],
+    };
+}
+/**
+ * Execute project deletion (soft or hard).
+ */
+export async function executeDeleteProject(projectId, force) {
+    const dataDir = projectDataDir(projectId);
+    const exists = await pathExists(dataDir);
+    if (!exists) {
+        return {
+            success: false,
+            action: force ? 'hard_delete' : 'soft_delete',
+            itemsAffected: 0,
+            warnings: ['Project data directory not found.'],
+        };
+    }
+    const fileCount = await countFiles(dataDir);
+    const action = force ? 'hard_delete' : 'soft_delete';
+    if (!force) {
+        // For soft delete of a project, move the entire directory
+        // Use a global trash since project dir itself is being deleted
+        const globalTrashDir = 'data/projects/.trash';
+        const timestamp = Date.now();
+        const trashSubdir = `${String(timestamp)}-project-${projectId}`;
+        const destPath = join(globalTrashDir, trashSubdir);
+        await mkdir(destPath, { recursive: true });
+        await cp(dataDir, destPath, { recursive: true });
+        await rm(dataDir, { recursive: true, force: true });
+    }
+    else {
+        await rm(dataDir, { recursive: true, force: true });
+    }
+    const auditId = force
+        ? undefined
+        : await appendAuditEntry(projectId, action, 'project', projectId, { fileCount });
+    return {
+        success: true,
+        action,
+        itemsAffected: fileCount,
+        warnings: [],
+        auditId,
+    };
+}
+/**
+ * Execute pattern deletion (soft or hard).
+ */
+export async function executeDeletePattern(projectId, patternIds, force) {
+    const action = force ? 'hard_delete' : 'soft_delete';
+    // Validate all patterns exist first (atomic)
+    for (const patternId of patternIds) {
+        const pattern = await patternStore.getPattern(projectId, patternId);
+        if (!pattern) {
+            return {
+                success: false,
+                action,
+                itemsAffected: 0,
+                warnings: [`Pattern "${patternId}" not found. No items were deleted (atomic rollback).`],
+            };
+        }
+    }
+    let lastAuditId;
+    for (const patternId of patternIds) {
+        const pattern = await patternStore.getPattern(projectId, patternId);
+        if (!force && pattern) {
+            await moveDataToTrash(projectId, 'pattern', patternId, pattern, { patternId });
+        }
+        await patternStore.deletePattern(projectId, patternId);
+        lastAuditId = await appendAuditEntry(projectId, action, 'pattern', patternId, { patternIds });
+    }
+    return {
+        success: true,
+        action,
+        itemsAffected: patternIds.length,
+        warnings: [],
+        auditId: lastAuditId,
+    };
+}
+/**
+ * Preview what would be deleted for patterns.
+ */
+export async function previewDeletePattern(projectId, patternIds) {
+    const warnings = [];
+    let itemsAffected = 0;
+    for (const patternId of patternIds) {
+        const pattern = await patternStore.getPattern(projectId, patternId);
+        if (!pattern) {
+            warnings.push(`Pattern "${patternId}" not found.`);
+            continue;
+        }
+        itemsAffected += 1;
+    }
+    return { success: true, action: 'preview', itemsAffected, warnings };
+}
+/**
+ * Execute decision deletion.
+ */
+export async function executeDeleteDecision(projectId, decisionIds, force) {
+    const action = force ? 'hard_delete' : 'soft_delete';
+    const decisions = await decisionStore.getDecisions(projectId);
+    // Validate all decisions exist first (atomic)
+    for (const decisionId of decisionIds) {
+        const decision = decisions.find((d) => d.id === decisionId);
+        if (!decision) {
+            return {
+                success: false,
+                action,
+                itemsAffected: 0,
+                warnings: [`Decision "${decisionId}" not found. No items were deleted (atomic rollback).`],
+            };
+        }
+    }
+    let lastAuditId;
+    for (const decisionId of decisionIds) {
+        const decision = decisions.find((d) => d.id === decisionId);
+        if (!force && decision) {
+            await moveDataToTrash(projectId, 'decision', decisionId, decision, { decisionId });
+        }
+        // Remove from decisions array and save
+        const allDecisions = await decisionStore.getDecisions(projectId);
+        const filtered = allDecisions.filter((d) => d.id !== decisionId);
+        await writeJson(`${projectDataDir(projectId)}/decisions.json`, {
+            decisions: filtered,
+            lastUpdated: new Date().toISOString(),
+        });
+        lastAuditId = await appendAuditEntry(projectId, action, 'decision', decisionId, {
+            decisionIds,
+        });
+    }
+    return {
+        success: true,
+        action,
+        itemsAffected: decisionIds.length,
+        warnings: [],
+        auditId: lastAuditId,
+    };
+}
+/**
+ * Preview what would be deleted for decisions.
+ */
+export async function previewDeleteDecision(projectId, decisionIds) {
+    const decisions = await decisionStore.getDecisions(projectId);
+    const warnings = [];
+    let itemsAffected = 0;
+    for (const decisionId of decisionIds) {
+        const decision = decisions.find((d) => d.id === decisionId);
+        if (!decision) {
+            warnings.push(`Decision "${decisionId}" not found.`);
+            continue;
+        }
+        itemsAffected += 1;
+    }
+    return { success: true, action: 'preview', itemsAffected, warnings };
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/deleter/core.js.map

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

package/dist/engine/deleter/trash-manager.d.ts

@@ -0,0 +1,18 @@
+import type { TrashItem, DeleteResult, TrashAction } from '../../types/index.js';
+/**
+ * List all items in trash for a project.
+ */
+export declare function listTrash(projectId: string): Promise<TrashItem[]>;
+/**
+ * Restore a specific item from trash.
+ */
+export declare function restoreItem(projectId: string, itemId: string): Promise<DeleteResult>;
+/**
+ * Purge items from trash (specific item or all).
+ */
+export declare function purgeTrash(projectId: string, itemId?: string): Promise<DeleteResult>;
+/**
+ * Execute a trash management action.
+ */
+export declare function executeTrashAction(projectId: string, action: TrashAction, itemId?: string): Promise<DeleteResult | TrashItem[]>;
+//# sourceMappingURL=trash-manager.d.ts.map

package/dist/engine/deleter/trash-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash-manager.d.ts","sourceRoot":"","sources":["../../../src/engine/deleter/trash-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASjF;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsB1F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA2C1F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,SAAS,EAAE,CAAC,CAkBrC"}