@planu/cli 0.63.6 → 0.64.0

package/dist/config/license-plans.json

@@ -122,10 +122,13 @@
     "export_session",
     "security_report",
     "configure_workers",
+    "configure_roles",
+    "assign_role",
     "orchestrate_runtime",
     "agent_swarm_status",
     "configure_llm_providers",
     "llm_provider_status",
+    "configure_observability",
     "manage_plugins",
     "scaffold_plugin",
     "create_pr_from_spec",
@@ -155,7 +158,19 @@
     "registry_logout",
     "registry_whoami",
     "scan_project",
-    "ecosystem_status"
+    "ecosystem_status",
+    "audit_trail",
+    "generate_attestation",
+    "branch_spec",
+    "merge_spec_branch",
+    "version_spec",
+    "decompose_spec",
+    "federate_specs",
+    "federation_status",
+    "discover_registry",
+    "publish_registry",
+    "generate_infrastructure",
+    "spec_usage_report"
   ],
   "alwaysAllowed": [
     "activate_license",

package/dist/engine/a2a/capability-card.d.ts

@@ -0,0 +1,16 @@
+import type { A2ACapabilityCard } from '../../types/a2a.js';
+/**
+ * Generate Planu's A2A capability card, optionally filtered to a subset of skills.
+ *
+ * @param agentId - Unique agent identifier to embed in the card.
+ * @param version - Planu version string.
+ * @param projectId - Optional project scope for the card.
+ * @param skillFilter - Optional list of skill IDs to include. If omitted, all skills are included.
+ * @param customName - Optional custom display name.
+ */
+export declare function generateCapabilityCard(agentId: string, version: string, projectId?: string, skillFilter?: string[], customName?: string): A2ACapabilityCard;
+/**
+ * Return the list of all built-in skill IDs available to advertise.
+ */
+export declare function listBuiltInSkillIds(): string[];
+//# sourceMappingURL=capability-card.d.ts.map

package/dist/engine/a2a/capability-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-card.d.ts","sourceRoot":"","sources":["../../../src/engine/a2a/capability-card.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,oBAAoB,CAAC;AA0CtE;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,iBAAiB,CAkBnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/engine/a2a/capability-card.js

@@ -0,0 +1,69 @@
+/**
+ * The built-in set of skills Planu exposes as an A2A agent.
+ * Each entry maps to an MCP tool capability.
+ */
+const BUILT_IN_SKILLS = [
+    {
+        id: 'create-spec',
+        name: 'Create Specification',
+        description: 'Create a structured spec for a feature, bugfix, or refactor using SDD methodology.',
+    },
+    {
+        id: 'generate-tests',
+        name: 'Generate Tests',
+        description: 'Generate unit, integration, and e2e tests for a given specification.',
+    },
+    {
+        id: 'estimate',
+        name: 'Estimate Effort',
+        description: 'Estimate development effort (hours, cost, model recommendation) for a spec.',
+    },
+    {
+        id: 'validate',
+        name: 'Validate Spec',
+        description: 'Validate that a spec is complete, consistent, and implementation-ready.',
+    },
+    {
+        id: 'analyze-stack',
+        name: 'Analyze Stack',
+        description: 'Detect frameworks, languages, and tooling from a project codebase.',
+    },
+    {
+        id: 'generate-docs',
+        name: 'Generate Documentation',
+        description: 'Generate markdown or HTML documentation from specs and code.',
+    },
+];
+const SUPPORTED_SPEC_TYPES = ['feature', 'bugfix', 'refactor', 'architecture', 'migration'];
+/**
+ * Generate Planu's A2A capability card, optionally filtered to a subset of skills.
+ *
+ * @param agentId - Unique agent identifier to embed in the card.
+ * @param version - Planu version string.
+ * @param projectId - Optional project scope for the card.
+ * @param skillFilter - Optional list of skill IDs to include. If omitted, all skills are included.
+ * @param customName - Optional custom display name.
+ */
+export function generateCapabilityCard(agentId, version, projectId, skillFilter, customName) {
+    const skills = skillFilter && skillFilter.length > 0
+        ? BUILT_IN_SKILLS.filter((s) => skillFilter.includes(s.id))
+        : BUILT_IN_SKILLS;
+    return {
+        agentId,
+        name: customName ?? 'Planu SDD Agent',
+        version,
+        description: 'Planu is a Spec-Driven Development assistant that manages the full SDD lifecycle — ' +
+            'from spec creation and estimation to test generation and validation.',
+        skills,
+        supportedSpecTypes: SUPPORTED_SPEC_TYPES,
+        registeredAt: new Date().toISOString(),
+        projectId,
+    };
+}
+/**
+ * Return the list of all built-in skill IDs available to advertise.
+ */
+export function listBuiltInSkillIds() {
+    return BUILT_IN_SKILLS.map((s) => s.id);
+}
+//# sourceMappingURL=capability-card.js.map

package/dist/engine/a2a/capability-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-card.js","sourceRoot":"","sources":["../../../src/engine/a2a/capability-card.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,eAAe,GAAe;IAClC;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,oFAAoF;KACvF;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,sEAAsE;KACpF;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6EAA6E;KAC3F;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,yEAAyE;KACvF;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,oEAAoE;KAClF;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,8DAA8D;KAC5E;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;AAE5F;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,OAAe,EACf,SAAkB,EAClB,WAAsB,EACtB,UAAmB;IAEnB,MAAM,MAAM,GACV,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QACnC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,eAAe,CAAC;IAEtB,OAAO;QACL,OAAO;QACP,IAAI,EAAE,UAAU,IAAI,iBAAiB;QACrC,OAAO;QACP,WAAW,EACT,qFAAqF;YACrF,sEAAsE;QACxE,MAAM;QACN,kBAAkB,EAAE,oBAAoB;QACxC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/engine/a2a/delegate.d.ts

@@ -0,0 +1,15 @@
+import type { A2ATask, A2ADelegation } from '../../types/a2a.js';
+/**
+ * Attempt to delegate a task to the target endpoint specified in the task.
+ * Because A2A network delegation is not yet available, this always falls back
+ * to local execution and records the delegation attempt in the audit trail.
+ *
+ * Task lifecycle: pending -> running -> completed | failed
+ *
+ * When real A2A HTTP support is added, replace the body of this function
+ * with a proper fetch() call to `task.targetEndpoint.url`.
+ *
+ * @returns The A2A delegation record for audit purposes.
+ */
+export declare function delegateTask(task: A2ATask): A2ADelegation;
+//# sourceMappingURL=delegate.d.ts.map

package/dist/engine/a2a/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../../src/engine/a2a/delegate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAiB,MAAM,oBAAoB,CAAC;AAIhF;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAuBzD"}

package/dist/engine/a2a/delegate.js

@@ -0,0 +1,47 @@
+import { updateTaskStatus } from './task-manager.js';
+import { executeFallback } from './fallback.js';
+/**
+ * Attempt to delegate a task to the target endpoint specified in the task.
+ * Because A2A network delegation is not yet available, this always falls back
+ * to local execution and records the delegation attempt in the audit trail.
+ *
+ * Task lifecycle: pending -> running -> completed | failed
+ *
+ * When real A2A HTTP support is added, replace the body of this function
+ * with a proper fetch() call to `task.targetEndpoint.url`.
+ *
+ * @returns The A2A delegation record for audit purposes.
+ */
+export function delegateTask(task) {
+    const now = new Date().toISOString();
+    // Transition to 'running' before attempting execution
+    updateTaskStatus(task.taskId, 'running');
+    if (!task.targetEndpoint) {
+        // No remote endpoint — go straight to local fallback.
+        const result = executeFallback(task);
+        // Fallback provides guidance only (success: false) — mark as failed so the task is not lost.
+        updateTaskStatus(task.taskId, result.success ? 'completed' : 'failed');
+        return buildDelegation(task, now, 'No agentEndpoint specified — using local execution', result);
+    }
+    // A2A network delegation is not yet available.
+    // Future: replace with real HTTP call to task.targetEndpoint.url
+    const stubReason = `A2A network delegation not yet available for endpoint "${task.targetEndpoint.url}". ` +
+        'Falling back to local execution.';
+    const result = executeFallback(task);
+    updateTaskStatus(task.taskId, result.success ? 'completed' : 'failed');
+    return buildDelegation(task, now, stubReason, result);
+}
+/**
+ * Build a delegation record for the audit trail, including the fallback result.
+ */
+function buildDelegation(task, delegatedAt, fallbackReason, fallbackResult) {
+    return {
+        taskId: task.taskId,
+        targetEndpoint: task.targetEndpoint,
+        outcome: 'fallback',
+        fallbackReason,
+        delegatedAt,
+        fallbackResult,
+    };
+}
+//# sourceMappingURL=delegate.js.map

package/dist/engine/a2a/delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../../src/engine/a2a/delegate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,sDAAsD;IACtD,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACzB,sDAAsD;QACtD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,6FAA6F;QAC7F,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvE,OAAO,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,oDAAoD,EAAE,MAAM,CAAC,CAAC;IAClG,CAAC;IAED,+CAA+C;IAC/C,iEAAiE;IACjE,MAAM,UAAU,GACd,0DAA0D,IAAI,CAAC,cAAc,CAAC,GAAG,KAAK;QACtF,kCAAkC,CAAC;IAErC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvE,OAAO,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CACtB,IAAa,EACb,WAAmB,EACnB,cAAsB,EACtB,cAA6B;IAE7B,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,UAAU;QACnB,cAAc;QACd,WAAW;QACX,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/engine/a2a/fallback.d.ts

@@ -0,0 +1,12 @@
+import type { A2ATask, A2ATaskResult } from '../../types/a2a.js';
+/**
+ * Execute a task locally as a fallback when the remote A2A agent is unavailable
+ * or when the A2A protocol is not yet implemented.
+ *
+ * The local execution produces a structured result that explains the fallback
+ * and provides guidance on how the task should be handled manually via MCP tools.
+ *
+ * Future: when specific local MCP tool adapters are added, route by task intent.
+ */
+export declare function executeFallback(task: A2ATask): A2ATaskResult;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/engine/a2a/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/engine/a2a/fallback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAkB5D"}

package/dist/engine/a2a/fallback.js

@@ -0,0 +1,52 @@
+/**
+ * Execute a task locally as a fallback when the remote A2A agent is unavailable
+ * or when the A2A protocol is not yet implemented.
+ *
+ * The local execution produces a structured result that explains the fallback
+ * and provides guidance on how the task should be handled manually via MCP tools.
+ *
+ * Future: when specific local MCP tool adapters are added, route by task intent.
+ */
+export function executeFallback(task) {
+    const guidance = resolveFallbackGuidance(task.taskDescription);
+    // success: false — the task was NOT executed; only guidance was provided.
+    // Callers should treat this result as "pending human/tool action", not as a completed task.
+    return {
+        success: false,
+        output: {
+            fallback: true,
+            message: 'A2A network delegation not yet available. Guidance provided for local execution.',
+            taskId: task.taskId,
+            taskDescription: task.taskDescription,
+            localGuidance: guidance,
+            hint: 'Use the MCP tools listed in localGuidance to complete this task locally.',
+        },
+        source: 'guidance',
+        completedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Map a task description to suggested local MCP tools that can accomplish it.
+ * This is a simple keyword-based resolver — not a full NLI engine.
+ */
+function resolveFallbackGuidance(taskDescription) {
+    const desc = taskDescription.toLowerCase();
+    if (desc.includes('test') || desc.includes('spec coverage')) {
+        return 'Use generate_tests to create tests for the spec locally.';
+    }
+    if (desc.includes('estimate') || desc.includes('cost') || desc.includes('hours')) {
+        return 'Use estimate to compute effort and cost for the spec locally.';
+    }
+    if (desc.includes('validate') || desc.includes('check') || desc.includes('verify')) {
+        return 'Use validate to check spec completeness and consistency locally.';
+    }
+    if (desc.includes('document') || desc.includes('docs')) {
+        return 'Use generate_docs to produce documentation locally.';
+    }
+    if (desc.includes('spec') || desc.includes('create') || desc.includes('feature')) {
+        return 'Use create_spec to author a spec for this task locally.';
+    }
+    return ('No specific local tool matched. Consider using create_spec, generate_tests, ' +
+        'estimate, or validate depending on the task goal.');
+}
+//# sourceMappingURL=fallback.js.map

package/dist/engine/a2a/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../../src/engine/a2a/fallback.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE/D,0EAA0E;IAC1E,4FAA4F;IAC5F,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,kFAAkF;YAC3F,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,aAAa,EAAE,QAAQ;YACvB,IAAI,EAAE,0EAA0E;SACjF;QACD,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,eAAuB;IACtD,MAAM,IAAI,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;IAE3C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5D,OAAO,0DAA0D,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjF,OAAO,+DAA+D,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnF,OAAO,kEAAkE,CAAC;IAC5E,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjF,OAAO,yDAAyD,CAAC;IACnE,CAAC;IAED,OAAO,CACL,8EAA8E;QAC9E,mDAAmD,CACpD,CAAC;AACJ,CAAC"}

package/dist/engine/a2a/index.d.ts

@@ -0,0 +1,5 @@
+export { generateCapabilityCard, listBuiltInSkillIds } from './capability-card.js';
+export { createTask, updateTaskStatus, getTask, listTasks, cancelTask, loadTasks, clearTaskStore, } from './task-manager.js';
+export { delegateTask } from './delegate.js';
+export { executeFallback } from './fallback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/a2a/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/a2a/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/a2a/index.js

@@ -0,0 +1,6 @@
+// engine/a2a/index.ts — Barrel re-export for SPEC-169 A2A engine modules
+export { generateCapabilityCard, listBuiltInSkillIds } from './capability-card.js';
+export { createTask, updateTaskStatus, getTask, listTasks, cancelTask, loadTasks, clearTaskStore, } from './task-manager.js';
+export { delegateTask } from './delegate.js';
+export { executeFallback } from './fallback.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/a2a/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/a2a/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/a2a/task-manager.d.ts

@@ -0,0 +1,39 @@
+import type { A2ATask, A2ATaskStatus, A2AAgentEndpoint } from '../../types/a2a.js';
+/**
+ * Create a new A2A task in 'pending' state.
+ */
+export declare function createTask(projectId: string, taskDescription: string, specId?: string, targetEndpoint?: A2AAgentEndpoint): A2ATask;
+/**
+ * Transition a task to a new status. Returns the updated task, or undefined
+ * if the taskId does not exist.
+ *
+ * Valid transitions:
+ * - pending   -> running | cancelled
+ * - running   -> completed | failed | cancelled
+ * - completed -> (terminal — no further transitions allowed)
+ * - failed    -> (terminal)
+ * - cancelled -> (terminal)
+ */
+export declare function updateTaskStatus(taskId: string, status: A2ATaskStatus): A2ATask | undefined;
+/**
+ * Retrieve a task by ID.
+ */
+export declare function getTask(taskId: string): A2ATask | undefined;
+/**
+ * List all tasks for a given project.
+ */
+export declare function listTasks(projectId: string): A2ATask[];
+/**
+ * Cancel a task. Returns the updated task, or undefined if the taskId is unknown.
+ */
+export declare function cancelTask(taskId: string): A2ATask | undefined;
+/**
+ * Load tasks from a persisted array into the in-memory store.
+ * Used when the tool handler restores state from disk.
+ */
+export declare function loadTasks(tasks: A2ATask[]): void;
+/**
+ * Clear the in-memory store — useful in tests.
+ */
+export declare function clearTaskStore(): void;
+//# sourceMappingURL=task-manager.d.ts.map

package/dist/engine/a2a/task-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../../src/engine/a2a/task-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQnF;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,gBAAgB,GAChC,OAAO,CAcT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,SAAS,CAe3F;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE9D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAIhD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/engine/a2a/task-manager.js

@@ -0,0 +1,84 @@
+// engine/a2a/task-manager.ts — A2ATaskManager: create/monitor/cancel delegated tasks (SPEC-169)
+import { randomUUID } from 'node:crypto';
+/**
+ * In-memory task store — tasks are also persisted to disk by the tool handler.
+ * The manager provides lifecycle operations; persistence is handled externally.
+ */
+const taskStore = new Map();
+/**
+ * Create a new A2A task in 'pending' state.
+ */
+export function createTask(projectId, taskDescription, specId, targetEndpoint) {
+    const now = new Date().toISOString();
+    const task = {
+        taskId: randomUUID(),
+        projectId,
+        specId,
+        taskDescription,
+        status: 'pending',
+        createdAt: now,
+        updatedAt: now,
+        targetEndpoint,
+    };
+    taskStore.set(task.taskId, task);
+    return task;
+}
+/**
+ * Transition a task to a new status. Returns the updated task, or undefined
+ * if the taskId does not exist.
+ *
+ * Valid transitions:
+ * - pending   -> running | cancelled
+ * - running   -> completed | failed | cancelled
+ * - completed -> (terminal — no further transitions allowed)
+ * - failed    -> (terminal)
+ * - cancelled -> (terminal)
+ */
+export function updateTaskStatus(taskId, status) {
+    const task = taskStore.get(taskId);
+    if (!task) {
+        return undefined;
+    }
+    const TERMINAL = ['completed', 'failed', 'cancelled'];
+    if (TERMINAL.includes(task.status)) {
+        // Already terminal — return as-is without modification.
+        return task;
+    }
+    const updated = { ...task, status, updatedAt: new Date().toISOString() };
+    taskStore.set(taskId, updated);
+    return updated;
+}
+/**
+ * Retrieve a task by ID.
+ */
+export function getTask(taskId) {
+    return taskStore.get(taskId);
+}
+/**
+ * List all tasks for a given project.
+ */
+export function listTasks(projectId) {
+    return Array.from(taskStore.values()).filter((t) => t.projectId === projectId);
+}
+/**
+ * Cancel a task. Returns the updated task, or undefined if the taskId is unknown.
+ */
+export function cancelTask(taskId) {
+    return updateTaskStatus(taskId, 'cancelled');
+}
+/**
+ * Load tasks from a persisted array into the in-memory store.
+ * Used when the tool handler restores state from disk.
+ */
+export function loadTasks(tasks) {
+    for (const task of tasks) {
+        taskStore.set(task.taskId, task);
+    }
+}
+/**
+ * Clear the in-memory store — useful in tests.
+ */
+export function clearTaskStore() {
+    taskStore.clear();
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/engine/a2a/task-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.js","sourceRoot":"","sources":["../../../src/engine/a2a/task-manager.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;GAGG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,SAAiB,EACjB,eAAuB,EACvB,MAAe,EACf,cAAiC;IAEjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAY;QACpB,MAAM,EAAE,UAAU,EAAE;QACpB,SAAS;QACT,MAAM;QACN,eAAe;QACf,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,cAAc;KACf,CAAC;IACF,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,MAAqB;IACpE,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAoB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACvE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,wDAAwD;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAY,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAClF,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgB;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}

package/dist/engine/ac-gap-detector/analyze-gaps.d.ts

@@ -0,0 +1,13 @@
+import type { AcGapReport, AcGapCategory, AcGapPriority } from '../../types/ac-gap.js';
+/**
+ * Analyzes the provided spec text for missing acceptance criteria.
+ *
+ * @param specId         - Spec identifier (for the report).
+ * @param specText       - Raw text of spec.md (may include frontmatter).
+ * @param technicalText  - Raw text of technical.md (optional, pass empty string if unavailable).
+ * @param categories     - Optional list of categories to focus on (default: all).
+ * @param minPriority    - Minimum priority to include in results (default: medium).
+ * @returns AcGapReport with suggested missing ACs.
+ */
+export declare function analyzeAcGaps(specId: string, specText: string, technicalText: string, categories?: AcGapCategory[], minPriority?: AcGapPriority): AcGapReport;
+//# sourceMappingURL=analyze-gaps.d.ts.map

package/dist/engine/ac-gap-detector/analyze-gaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-gaps.d.ts","sourceRoot":"","sources":["../../../src/engine/ac-gap-detector/analyze-gaps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQvF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,aAAa,EAAE,EAC5B,WAAW,GAAE,aAAoC,GAChD,WAAW,CAoCb"}

package/dist/engine/ac-gap-detector/analyze-gaps.js

@@ -0,0 +1,43 @@
+import { extractAcLines, computeCoverageScore, containsAny } from './pattern-matcher.js';
+import { selectRules } from './gap-rules.js';
+import { PRIORITY_ORDER, WEB_UI_KEYWORDS } from './constants.js';
+/** Minimum priority filter: only include suggestions at or above this level. */
+const DEFAULT_MIN_PRIORITY = 'medium';
+/**
+ * Analyzes the provided spec text for missing acceptance criteria.
+ *
+ * @param specId         - Spec identifier (for the report).
+ * @param specText       - Raw text of spec.md (may include frontmatter).
+ * @param technicalText  - Raw text of technical.md (optional, pass empty string if unavailable).
+ * @param categories     - Optional list of categories to focus on (default: all).
+ * @param minPriority    - Minimum priority to include in results (default: medium).
+ * @returns AcGapReport with suggested missing ACs.
+ */
+export function analyzeAcGaps(specId, specText, technicalText, categories, minPriority = DEFAULT_MIN_PRIORITY) {
+    const combined = `${specText}\n${technicalText}`;
+    const fullText = combined.toLowerCase();
+    const acLines = extractAcLines(combined);
+    const hasWebUi = containsAny(fullText, WEB_UI_KEYWORDS);
+    const idCounter = { value: 0 };
+    const ctx = { fullText, acLines, hasWebUi, idCounter };
+    const rules = selectRules(categories);
+    const allGaps = rules
+        .map((rule) => rule(ctx))
+        .filter((g) => g !== null);
+    const minWeight = PRIORITY_ORDER[minPriority];
+    const filtered = allGaps.filter((g) => PRIORITY_ORDER[g.priority] >= minWeight);
+    // Sort by priority descending
+    filtered.sort((a, b) => PRIORITY_ORDER[b.priority] - PRIORITY_ORDER[a.priority]);
+    // Coverage score: ratio of rule categories that produced no gap
+    const gappedCategories = new Set(filtered.map((g) => g.category));
+    const coveredCount = rules.length - gappedCategories.size;
+    const coverageScore = computeCoverageScore(new Set(Array.from({ length: Math.max(0, coveredCount) }, (_, i) => String(i))), rules.length);
+    return {
+        specId,
+        existingAcCount: acLines.length,
+        gaps: filtered,
+        coverageScore,
+        analyzedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=analyze-gaps.js.map

package/dist/engine/ac-gap-detector/analyze-gaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-gaps.js","sourceRoot":"","sources":["../../../src/engine/ac-gap-detector/analyze-gaps.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjE,gFAAgF;AAChF,MAAM,oBAAoB,GAAkB,QAAQ,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,QAAgB,EAChB,aAAqB,EACrB,UAA4B,EAC5B,cAA6B,oBAAoB;IAEjD,MAAM,QAAQ,GAAG,GAAG,QAAQ,KAAK,aAAa,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAExC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAExD,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAEvD,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK;SAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,CAAC;IAEhF,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjF,gEAAgE;IAChE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC;IAC1D,MAAM,aAAa,GAAG,oBAAoB,CACxC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAC/E,KAAK,CAAC,MAAM,CACb,CAAC;IAEF,OAAO;QACL,MAAM;QACN,eAAe,EAAE,OAAO,CAAC,MAAM;QAC/B,IAAI,EAAE,QAAQ;QACd,aAAa;QACb,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC"}

package/dist/engine/ac-gap-detector/constants.d.ts

@@ -0,0 +1,22 @@
+import type { AcGapPriority } from '../../types/ac-gap.js';
+/** Numeric weight per priority (higher = more important). Used for sorting and scoring. */
+export declare const PRIORITY_ORDER: Record<AcGapPriority, number>;
+/** Keywords that indicate an existing AC already covers error handling. */
+export declare const ERROR_HANDLING_KEYWORDS: readonly string[];
+/** Keywords that indicate existing ACs cover security concerns. */
+export declare const SECURITY_KEYWORDS: readonly string[];
+/** Keywords that indicate existing ACs cover performance concerns. */
+export declare const PERFORMANCE_KEYWORDS: readonly string[];
+/** Keywords that indicate existing ACs cover accessibility. */
+export declare const ACCESSIBILITY_KEYWORDS: readonly string[];
+/** Keywords that indicate existing ACs cover input/data validation. */
+export declare const DATA_VALIDATION_KEYWORDS: readonly string[];
+/** Keywords that indicate existing ACs cover observability. */
+export declare const OBSERVABILITY_KEYWORDS: readonly string[];
+/** Keywords that indicate existing ACs cover edge cases broadly. */
+export declare const EDGE_CASE_KEYWORDS: readonly string[];
+/** Keywords that indicate existing ACs cover rollback / undo. */
+export declare const ROLLBACK_KEYWORDS: readonly string[];
+/** Signal words that suggest this spec likely has UI / frontend components. */
+export declare const WEB_UI_KEYWORDS: readonly string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/engine/ac-gap-detector/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/engine/ac-gap-detector/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,2FAA2F;AAC3F,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAKxD,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAepD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAiB9C,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAcjD,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAUnD,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAYrD,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAUnD,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAY/C,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAS9C,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAkB5C,CAAC"}