@planu/cli 0.99.0 → 1.0.0

package/dist/config/license-plans.json

@@ -284,6 +284,7 @@
     "activate_license",
     "deactivate_license",
     "license_status",
+    "start_trial",
     "usage_stats",
     "usage_report",
     "start_dashboard",

package/dist/engine/agent-orchestrator/coordinator-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { CoordinatorPromptInput } from '../../types/agent-orchestration.js';
+export declare function buildCoordinatorPrompt(input: CoordinatorPromptInput): string;
+//# sourceMappingURL=coordinator-prompt.d.ts.map

package/dist/engine/agent-orchestrator/coordinator-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-prompt.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/coordinator-prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEjF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAoC5E"}

package/dist/engine/agent-orchestrator/coordinator-prompt.js

@@ -0,0 +1,38 @@
+// engine/agent-orchestrator/coordinator-prompt.ts — Build coordinator agent prompt
+export function buildCoordinatorPrompt(input) {
+    const { spec, specContent, technicalContent, count } = input;
+    return `# Coordinator Agent — ${spec.id}: ${spec.title}
+
+## Your Role
+You are the **Coordinator** for implementing SPEC **${spec.id}**. Your job is to:
+1. Read and fully understand the spec and technical design
+2. Break the implementation into ${String(count)} parallel workstreams
+3. Produce a detailed workstream breakdown document for the Specialist agents
+4. Do NOT write implementation code yourself
+
+## Model Recommendation
+Use **claude-opus** for this planning task.
+
+## Spec Content
+${specContent || '(spec.md not available — use spec title and ID to reason about scope)'}
+
+## Technical Design
+${technicalContent || '(technical.md not available — derive workstreams from logical layers: storage, engine, tools, tests)'}
+
+## Your Output (REQUIRED)
+Produce a markdown document titled "## Workstream Breakdown — ${spec.id}" with:
+- One section per Specialist (Specialist-1 through Specialist-${String(count)})
+- Each section: file ownership list, acceptance criteria assigned, implementation notes
+- Any shared types or interfaces that all specialists must agree on BEFORE starting
+- Integration points where specialists must coordinate
+
+This document will be given to each Specialist agent as their briefing.
+
+## Success Criteria
+- All ${String(count)} workstreams have clear, non-overlapping file ownership
+- Every acceptance criterion is assigned to exactly one Specialist
+- Shared interfaces are defined upfront to prevent merge conflicts
+- Each Specialist has enough context to work autonomously
+`;
+}
+//# sourceMappingURL=coordinator-prompt.js.map

package/dist/engine/agent-orchestrator/coordinator-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-prompt.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/coordinator-prompt.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAInF,MAAM,UAAU,sBAAsB,CAAC,KAA6B;IAClE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAE7D,OAAO,yBAAyB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK;;;sDAGF,IAAI,CAAC,EAAE;;mCAE1B,MAAM,CAAC,KAAK,CAAC;;;;;;;;EAQ9C,WAAW,IAAI,uEAAuE;;;EAGtF,gBAAgB,IAAI,sGAAsG;;;gEAG5D,IAAI,CAAC,EAAE;gEACP,MAAM,CAAC,KAAK,CAAC;;;;;;;;QAQrE,MAAM,CAAC,KAAK,CAAC;;;;CAIpB,CAAC;AACF,CAAC"}

package/dist/engine/agent-orchestrator/execution-guide.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutionGuideInput } from '../../types/agent-orchestration.js';
+export declare function buildExecutionGuide(input: ExecutionGuideInput): string;
+//# sourceMappingURL=execution-guide.d.ts.map

package/dist/engine/agent-orchestrator/execution-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-guide.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/execution-guide.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAgEtE"}

package/dist/engine/agent-orchestrator/execution-guide.js

@@ -0,0 +1,59 @@
+// engine/agent-orchestrator/execution-guide.ts — Generate markdown execution guide
+export function buildExecutionGuide(input) {
+    const { spec, count, roles } = input;
+    const specialistNames = roles
+        .filter((r) => r.role === 'specialist')
+        .map((r) => `- **${r.name}** — files: ${r.files.slice(0, 3).join(', ')}${r.files.length > 3 ? '...' : ''}`)
+        .join('\n');
+    return `# Orchestration Execution Guide — ${spec.id}: ${spec.title}
+
+## Overview
+This plan uses **3 sequential waves** with **${String(count)} parallel specialists** in Wave 2.
+Total agents: ${String(roles.length)} (1 Coordinator + ${String(count)} Specialists + 1 Verifier)
+
+---
+
+## Wave 1 — Coordinator (run first, alone)
+Launch one Claude Code session with the **Coordinator** prompt.
+Wait until it produces the "Workstream Breakdown" document before proceeding to Wave 2.
+
+**When to move to Wave 2:** Coordinator has delivered the workstream breakdown with assigned files and criteria for each Specialist.
+
+---
+
+## Wave 2 — Specialists (run in parallel)
+Launch ${String(count)} Claude Code sessions simultaneously, one per Specialist:
+
+${specialistNames}
+
+Each Specialist works exclusively on their assigned files.
+Wait until ALL Specialists report completion before proceeding to Wave 3.
+
+**Tip:** Open ${String(count)} terminal windows and paste each Specialist prompt into a separate \`claude\` session.
+
+---
+
+## Wave 3 — Verifier (run last, alone)
+Launch one Claude Code session with the **Verifier** prompt.
+The Verifier reads all changes from Wave 2 and validates every acceptance criterion.
+
+**Done when:** Verifier reports PASS on all criteria and \`pnpm test:coverage\` passes.
+
+---
+
+## Quick Reference — File Ownership
+
+${roles
+        .filter((r) => r.role === 'specialist')
+        .map((r) => `### ${r.name}\n${r.files.length > 0 ? r.files.map((f) => `  - \`${f}\``).join('\n') : '  - (See Coordinator breakdown)'}`)
+        .join('\n\n')}
+
+---
+
+## Troubleshooting
+- **Merge conflicts**: means two Specialists touched the same file — re-assign ownership and re-run
+- **Type errors after merge**: run \`pnpm typecheck\` to identify the conflict
+- **Coverage drop**: re-run the affected Specialist's tests with \`pnpm test:coverage\`
+`;
+}
+//# sourceMappingURL=execution-guide.js.map

package/dist/engine/agent-orchestrator/execution-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-guide.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/execution-guide.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAInF,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC5D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAErC,MAAM,eAAe,GAAG,KAAK;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;SACtC,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACjG;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,qCAAqC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK;;;+CAGrB,MAAM,CAAC,KAAK,CAAC;gBAC5C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;SAa7D,MAAM,CAAC,KAAK,CAAC;;EAEpB,eAAe;;;;;gBAKD,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;;EAc3B,KAAK;SACJ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;SACtC,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iCAAiC,EAAE,CAC7H;SACA,IAAI,CAAC,MAAM,CAAC;;;;;;;;CAQd,CAAC;AACF,CAAC"}

package/dist/engine/agent-orchestrator/file-partitioner.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Partition a list of files into `count` non-overlapping groups.
+ * Uses round-robin distribution so each specialist gets a balanced share.
+ * Guarantees no file appears in more than one partition.
+ */
+export declare function partitionFiles(files: string[], count: number): string[][];
+//# sourceMappingURL=file-partitioner.d.ts.map

package/dist/engine/agent-orchestrator/file-partitioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-partitioner.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/file-partitioner.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAazE"}

package/dist/engine/agent-orchestrator/file-partitioner.js

@@ -0,0 +1,19 @@
+// engine/agent-orchestrator/file-partitioner.ts — Partition files into non-overlapping workstreams
+/**
+ * Partition a list of files into `count` non-overlapping groups.
+ * Uses round-robin distribution so each specialist gets a balanced share.
+ * Guarantees no file appears in more than one partition.
+ */
+export function partitionFiles(files, count) {
+    const partitions = Array.from({ length: count }, () => []);
+    files.forEach((file, i) => {
+        const bucket = i % count;
+        const partition = partitions[bucket];
+        /* v8 ignore next 1 */
+        if (partition !== undefined) {
+            partition.push(file);
+        }
+    });
+    return partitions;
+}
+//# sourceMappingURL=file-partitioner.js.map

package/dist/engine/agent-orchestrator/file-partitioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-partitioner.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/file-partitioner.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,KAAa;IAC3D,MAAM,UAAU,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAEvE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,sBAAsB;QACtB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/engine/agent-orchestrator/index.d.ts

@@ -0,0 +1,12 @@
+import type { Spec } from '../../types/index.js';
+import type { OrchestratorAgentRole, OrchestrationPlan } from '../../types/agent-orchestration.js';
+export type { OrchestrationPlan, OrchestratorAgentRole };
+/**
+ * Generate a declarative multi-agent orchestration plan from a spec.
+ *
+ * @param spec        - Spec metadata from spec-store
+ * @param agentCount  - Number of specialist agents (2–8)
+ * @param projectPath - Absolute path to the project root
+ */
+export declare function generateOrchestrationPlan(spec: Spec, agentCount: number, projectPath: string): Promise<OrchestrationPlan>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/agent-orchestrator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAQnG,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAkE5B"}

package/dist/engine/agent-orchestrator/index.js

@@ -0,0 +1,131 @@
+// engine/agent-orchestrator/index.ts — SPEC-331: Declarative Multi-Agent Orchestration
+// Generates a structured OrchestrationPlan from an approved spec.
+// Pure: no network calls; reads spec data already passed in by the handler.
+import { readFileContent } from './spec-reader.js';
+import { partitionFiles } from './file-partitioner.js';
+import { buildCoordinatorPrompt } from './coordinator-prompt.js';
+import { buildSpecialistPrompt } from './specialist-prompt.js';
+import { buildVerifierPrompt } from './verifier-prompt.js';
+import { buildExecutionGuide } from './execution-guide.js';
+/**
+ * Generate a declarative multi-agent orchestration plan from a spec.
+ *
+ * @param spec        - Spec metadata from spec-store
+ * @param agentCount  - Number of specialist agents (2–8)
+ * @param projectPath - Absolute path to the project root
+ */
+export async function generateOrchestrationPlan(spec, agentCount, projectPath) {
+    const count = Math.max(2, Math.min(8, agentCount));
+    // Read spec markdown content (acceptance criteria, technical file list)
+    const specContent = await readFileContent(spec.specPath, projectPath);
+    const technicalContent = await readFileContent(spec.technicalPath, projectPath);
+    // Extract acceptance criteria lines from spec markdown
+    const criteria = extractCriteria(specContent);
+    // Extract file list from technical.md (or fall back to logical layers)
+    const allFiles = extractFiles(technicalContent);
+    // Partition files across N specialist workstreams (non-overlapping)
+    const workstreams = partitionFiles(allFiles, count);
+    // Build roles
+    const roles = [];
+    // Wave 1 — Coordinator
+    roles.push({
+        role: 'coordinator',
+        name: 'Coordinator',
+        files: [],
+        wave: 1,
+        prompt: buildCoordinatorPrompt({ spec, specContent, technicalContent, count }),
+    });
+    // Wave 2 — Specialists (parallel)
+    for (let i = 0; i < count; i++) {
+        const files = workstreams[i] ?? [];
+        const label = deriveLabel(files, i);
+        roles.push({
+            role: 'specialist',
+            name: `Specialist-${String(i + 1)}: ${label}`,
+            files,
+            wave: 2,
+            prompt: buildSpecialistPrompt({
+                spec,
+                specContent,
+                index: i + 1,
+                label,
+                files,
+                criteria,
+                totalSpecialists: count,
+            }),
+        });
+    }
+    // Wave 3 — Verifier
+    roles.push({
+        role: 'verifier',
+        name: 'Verifier',
+        files: allFiles,
+        wave: 3,
+        prompt: buildVerifierPrompt({ spec, criteria, allFiles }),
+    });
+    return {
+        specId: spec.id,
+        specTitle: spec.title,
+        agentCount: count,
+        totalWaves: 3,
+        roles,
+        executionGuide: buildExecutionGuide({ spec, count, roles }),
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function extractCriteria(specContent) {
+    const lines = specContent.split('\n');
+    return lines
+        .filter((l) => /^\s*-\s*\[[ x]\]/.test(l))
+        .map((l) => l.replace(/^\s*-\s*\[[ x]\]\s*/, '').trim())
+        .filter((l) => l.length > 0);
+}
+function extractFiles(technicalContent) {
+    if (!technicalContent) {
+        // Fallback to logical layers when no technical.md available
+        return ['src/storage/', 'src/engine/', 'src/tools/', 'tests/'];
+    }
+    const lines = technicalContent.split('\n');
+    const files = [];
+    const filePattern = /`([^`]+\.[a-zA-Z]+)`|^\s*[-*]\s+(src\/[^\s]+|tests\/[^\s]+)/;
+    for (const line of lines) {
+        const match = filePattern.exec(line);
+        if (match) {
+            const candidate = (match[1] ?? match[2] ?? '').trim();
+            if (candidate.length > 0 && !files.includes(candidate)) {
+                files.push(candidate);
+            }
+        }
+    }
+    if (files.length === 0) {
+        return ['src/storage/', 'src/engine/', 'src/tools/', 'tests/'];
+    }
+    return files;
+}
+function deriveLabel(files, index) {
+    if (files.length === 0) {
+        return `Workstream ${String(index + 1)}`;
+    }
+    // Heuristic: derive label from most common path segment
+    const segments = files.flatMap((f) => f.split('/').filter(Boolean));
+    const freq = new Map();
+    for (const seg of segments) {
+        freq.set(seg, (freq.get(seg) ?? 0) + 1);
+    }
+    // Ignore generic segments
+    const ignored = new Set(['src', 'tests', 'ts', 'js', 'index']);
+    const ranked = [...freq.entries()]
+        .filter(([k]) => !ignored.has(k) && k.length > 2)
+        .sort((a, b) => b[1] - a[1]);
+    const top = ranked[0];
+    if (top) {
+        return capitalize(top[0]);
+    }
+    return `Workstream ${String(index + 1)}`;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/agent-orchestrator/index.js.map

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

package/dist/engine/agent-orchestrator/spec-reader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read a spec file's content.
+ * Returns empty string if the file does not exist or the path is empty.
+ */
+export declare function readFileContent(filePath: string | undefined, projectPath: string): Promise<string>;
+//# sourceMappingURL=spec-reader.d.ts.map

package/dist/engine/agent-orchestrator/spec-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/spec-reader.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/engine/agent-orchestrator/spec-reader.js

@@ -0,0 +1,20 @@
+// engine/agent-orchestrator/spec-reader.ts — Read spec file content from disk
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+/**
+ * Read a spec file's content.
+ * Returns empty string if the file does not exist or the path is empty.
+ */
+export async function readFileContent(filePath, projectPath) {
+    if (!filePath) {
+        return '';
+    }
+    try {
+        const absolute = filePath.startsWith('/') ? filePath : resolve(projectPath, filePath);
+        return await readFile(absolute, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=spec-reader.js.map

package/dist/engine/agent-orchestrator/spec-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/spec-reader.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAA4B,EAC5B,WAAmB;IAEnB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtF,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/engine/agent-orchestrator/specialist-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { SpecialistPromptInput } from '../../types/agent-orchestration.js';
+export declare function buildSpecialistPrompt(input: SpecialistPromptInput): string;
+//# sourceMappingURL=specialist-prompt.d.ts.map

package/dist/engine/agent-orchestrator/specialist-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-prompt.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/specialist-prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEhF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CA0D1E"}

package/dist/engine/agent-orchestrator/specialist-prompt.js

@@ -0,0 +1,56 @@
+// engine/agent-orchestrator/specialist-prompt.ts — Build specialist agent prompts
+export function buildSpecialistPrompt(input) {
+    const { spec, index, label, files, criteria, totalSpecialists } = input;
+    const fileList = files.length > 0
+        ? files.map((f) => `  - \`${f}\``).join('\n')
+        : '  - (See Coordinator workstream breakdown for your assigned files)';
+    const criteriaSection = criteria.length > 0
+        ? criteria.map((c) => `- [ ] ${c}`).join('\n')
+        : '- [ ] (Refer to spec.md for your assigned acceptance criteria)';
+    return `# Specialist-${String(index)} Agent: ${label} — ${spec.id}: ${spec.title}
+
+## Your Role
+You are **Specialist-${String(index)} (${label})** for implementing SPEC **${spec.id}**.
+You work in parallel with ${String(totalSpecialists - 1)} other Specialist(s). Each specialist has exclusive file ownership — you must NOT modify files outside your list.
+
+## Model Recommendation
+Use **claude-sonnet** for implementation tasks.
+
+## Your Exclusive File Ownership
+${fileList}
+
+Do NOT create or modify files outside this list. If you discover a shared dependency, coordinate with the Coordinator's workstream breakdown.
+
+## Acceptance Criteria (full list — implement the ones in your workstream)
+${criteriaSection}
+
+## Spec Context
+**ID:** ${spec.id}
+**Title:** ${spec.title}
+**Status:** ${spec.status}
+**Risk:** ${spec.risk}
+
+## Implementation Instructions
+1. Read the Coordinator's workstream breakdown to understand your exact assigned criteria
+2. Implement ONLY the files in your ownership list above
+3. Write tests alongside implementation (same branch of work)
+4. Follow existing codebase conventions: TypeScript strict mode, ES modules, explicit return types
+5. Use \`import type\` for type-only imports
+6. All types must be defined in \`src/types/\` (not alongside implementation)
+7. Run \`pnpm typecheck && pnpm lint\` before finishing
+
+## Success Criteria
+- All acceptance criteria assigned to you are implemented and tested
+- \`pnpm typecheck\` passes with 0 errors
+- \`pnpm lint\` passes with 0 warnings
+- No files modified outside your exclusive ownership list
+- Code coverage for your files ≥ 95%
+
+## Output When Done
+Report back:
+1. Files created/modified
+2. Acceptance criteria implemented (checked off)
+3. Any open questions or blockers for the Verifier
+`;
+}
+//# sourceMappingURL=specialist-prompt.js.map

package/dist/engine/agent-orchestrator/specialist-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-prompt.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/specialist-prompt.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAIlF,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAExE,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7C,CAAC,CAAC,oEAAoE,CAAC;IAE3E,MAAM,eAAe,GACnB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,gEAAgE,CAAC;IAEvE,OAAO,gBAAgB,MAAM,CAAC,KAAK,CAAC,WAAW,KAAK,MAAM,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK;;;uBAG3D,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,+BAA+B,IAAI,CAAC,EAAE;4BACxD,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC;;;;;;EAMtD,QAAQ;;;;;EAKR,eAAe;;;UAGP,IAAI,CAAC,EAAE;aACJ,IAAI,CAAC,KAAK;cACT,IAAI,CAAC,MAAM;YACb,IAAI,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;CAuBpB,CAAC;AACF,CAAC"}

package/dist/engine/agent-orchestrator/verifier-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { VerifierPromptInput } from '../../types/agent-orchestration.js';
+export declare function buildVerifierPrompt(input: VerifierPromptInput): string;
+//# sourceMappingURL=verifier-prompt.d.ts.map

package/dist/engine/agent-orchestrator/verifier-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier-prompt.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/verifier-prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAuEtE"}

package/dist/engine/agent-orchestrator/verifier-prompt.js

@@ -0,0 +1,69 @@
+// engine/agent-orchestrator/verifier-prompt.ts — Build verifier agent prompt
+export function buildVerifierPrompt(input) {
+    const { spec, criteria, allFiles } = input;
+    const criteriaList = criteria.length > 0
+        ? criteria.map((c) => `- [ ] ${c}`).join('\n')
+        : '- [ ] (Read spec.md acceptance criteria section)';
+    /* v8 ignore next 3 */
+    const fileList = allFiles.length > 0
+        ? allFiles.map((f) => `  - \`${f}\``).join('\n')
+        : '  - (Scan the full project for changes related to this spec)';
+    return `# Verifier Agent — ${spec.id}: ${spec.title}
+
+## Your Role
+You are the **Verifier** for SPEC **${spec.id}**. You run AFTER all Specialist agents have completed. Your job is to validate that EVERY acceptance criterion has been correctly implemented.
+
+## Model Recommendation
+Use **claude-opus** for deep validation and cross-cutting analysis.
+
+## Spec Reference
+**ID:** ${spec.id}
+**Title:** ${spec.title}
+**Status:** ${spec.status}
+
+## All Acceptance Criteria to Verify
+${criteriaList}
+
+## Files to Inspect
+${fileList}
+
+## Verification Instructions
+For each acceptance criterion:
+1. Find the implementation in the codebase
+2. Confirm the behavior matches what the criterion specifies
+3. Check edge cases: error paths, empty inputs, boundary values
+4. Verify tests exist and actually cover the criterion
+5. Run \`pnpm typecheck && pnpm lint && pnpm test:coverage\` and confirm all pass
+
+## Cross-Cutting Checks
+- No file ownership violations (each specialist only touched their assigned files)
+- No circular imports introduced
+- Type definitions are in \`src/types/\` (not in engine/tools files)
+- All public functions have explicit return types
+- No \`any\` types introduced
+
+## Output Report (REQUIRED)
+Produce a Verification Report:
+\`\`\`
+## Verification Report — ${spec.id}
+
+### ✅ Criteria Met
+(list each passing criterion with file reference)
+
+### ❌ Criteria Missing or Incorrect
+(list each failing criterion with explanation)
+
+### Test Coverage
+(summarize coverage results)
+
+### Decision: PASS / FAIL
+(if FAIL, list exact actions needed before marking spec done)
+\`\`\`
+
+## Success Criteria
+- All acceptance criteria are implemented and verifiably working
+- \`pnpm test:coverage\` passes with coverage ≥ 95%
+- Verification Report is produced with PASS/FAIL decision
+`;
+}
+//# sourceMappingURL=verifier-prompt.js.map

package/dist/engine/agent-orchestrator/verifier-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier-prompt.js","sourceRoot":"","sources":["../../../src/engine/agent-orchestrator/verifier-prompt.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAI7E,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC5D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAE3C,MAAM,YAAY,GAChB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,kDAAkD,CAAC;IAEzD,sBAAsB;IACtB,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,8DAA8D,CAAC;IAErE,OAAO,sBAAsB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK;;;sCAGf,IAAI,CAAC,EAAE;;;;;;UAMnC,IAAI,CAAC,EAAE;aACJ,IAAI,CAAC,KAAK;cACT,IAAI,CAAC,MAAM;;;EAGvB,YAAY;;;EAGZ,QAAQ;;;;;;;;;;;;;;;;;;;;2BAoBiB,IAAI,CAAC,EAAE;;;;;;;;;;;;;;;;;;;CAmBjC,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { TrialStatus, RequestTrialResult } from '../../types/index.js';
+import { isTrialActive as storeIsTrialActive } from '../../storage/trial-store.js';
+/**
+ * Generates a deterministic, anonymous installation ID from machine attributes.
+ * Uses SHA-256(hostname + platform + arch) — no personal data.
+ */
+export declare function getInstallationId(): string;
+/**
+ * Sends a trial activation request to the Planu trial API.
+ * On success the server inserts a row in the `trials` table and returns
+ * a UUID trialKey + expiry date.
+ */
+export declare function requestTrial(email: string): Promise<RequestTrialResult>;
+/**
+ * Returns the current trial status. Fast local read — no network call.
+ */
+export declare function getTrialStatus(): Promise<TrialStatus>;
+export { storeIsTrialActive as isTrialActive };
+/**
+ * Validates the trial key against the server. If the server says the key is
+ * invalid or revoked, marks the trial as expired locally by clearing trialKey.
+ * Fire-and-forget — never awaited by callers.
+ */
+export declare function validateTrialBackground(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/trial/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAGL,aAAa,IAAI,kBAAkB,EAEpC,MAAM,8BAA8B,CAAC;AActC;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAMD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwC7E;AAMD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAe3D;AAMD,OAAO,EAAE,kBAAkB,IAAI,aAAa,EAAE,CAAC;AAM/C;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B7D"}