popeye-cli 1.5.0 → 1.7.0

package/dist/workflow/tester.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Tester (QA) skill module
+ * Provides test planning, review, and fix plan capabilities.
+ * Provider-agnostic -- uses whichever AI provider is configured.
+ */
+import type { ProjectState, Task, Milestone } from '../types/workflow.js';
+import type { ConsensusConfig } from '../types/consensus.js';
+import type { TestPlanOutput, TestRunReview, DiscoveredTestCommands } from '../types/tester.js';
+import type { OutputLanguage } from '../types/project.js';
+import { type ConsensusProcessResult } from './consensus.js';
+import type { TestResult } from './test-runner.js';
+/**
+ * Inspect the project directory to discover available test/lint/build commands.
+ * Checks package.json scripts, pyproject.toml, Makefile, and common config files.
+ *
+ * @param projectDir - Root of the project
+ * @param language - Project language
+ * @returns Discovered command references
+ */
+export declare function discoverTestCommands(projectDir: string, language: OutputLanguage): Promise<DiscoveredTestCommands>;
+/**
+ * Return language-specific testing guidance for the Tester persona.
+ *
+ * @param language - Project output language
+ * @returns Playbook text to embed in the Tester prompt
+ */
+export declare function getComponentPlaybook(language: OutputLanguage): string;
+/**
+ * Build the prompt for the Tester to create a TestPlan.
+ * Provider-agnostic -- refers to "the Tester", not any specific AI.
+ */
+export declare function buildTestPlanPrompt(task: Task, milestone: Milestone, state: ProjectState, approvedCodePlan: string, discoveredCommands: DiscoveredTestCommands): string;
+/**
+ * Build the prompt for the Tester to review test execution results.
+ * Provider-agnostic.
+ */
+export declare function buildTestRunReviewPrompt(task: Task, approvedTestPlan: string, testResult: TestResult, state: ProjectState): string;
+/**
+ * Build the prompt for the Tester to create a fix plan after test failures.
+ * Provider-agnostic.
+ */
+export declare function buildTestFixPlanPrompt(task: Task, approvedTestPlan: string, testResult: TestResult, review: TestRunReview, state: ProjectState): string;
+/**
+ * Result of the test planning phase
+ */
+export interface TestPlanningResult {
+    testPlanText: string;
+    testPlanParsed: TestPlanOutput | null;
+    consensusResult: ConsensusProcessResult;
+    error?: string;
+}
+/**
+ * Run the test planning phase: discover commands -> create test plan -> consensus.
+ *
+ * @param task - The task to plan tests for
+ * @param milestone - Parent milestone
+ * @param state - Current project state
+ * @param approvedCodePlan - The consensus-approved code plan
+ * @param options - Workflow options (projectDir, consensusConfig, onProgress)
+ * @returns Test plan result with consensus outcome
+ */
+export declare function runTestPlanningPhase(task: Task, milestone: Milestone, state: ProjectState, approvedCodePlan: string, options: {
+    projectDir: string;
+    consensusConfig?: Partial<ConsensusConfig>;
+    onProgress?: (phase: string, message: string) => void;
+}): Promise<TestPlanningResult>;
+/**
+ * Run the test review phase: AI reviews test results and issues a verdict.
+ * ONLY the Tester decides PASS/FAIL -- the coder cannot bypass this.
+ *
+ * @param task - The task whose tests were run
+ * @param approvedTestPlan - The approved test plan text
+ * @param testResult - Test execution results
+ * @param state - Current project state
+ * @param onProgress - Progress callback
+ * @returns Structured TestRunReview
+ */
+export declare function runTestReviewPhase(task: Task, approvedTestPlan: string, testResult: TestResult, state: ProjectState, onProgress?: (phase: string, message: string) => void): Promise<TestRunReview>;
+/**
+ * Create a fix plan from the Tester when tests fail.
+ *
+ * @param task - The task whose tests failed
+ * @param approvedTestPlan - The approved test plan text
+ * @param testResult - Test execution results
+ * @param review - The Tester's review with verdict
+ * @param state - Current project state
+ * @param onProgress - Progress callback
+ * @returns Fix plan text for consensus review
+ */
+export declare function createTesterFixPlan(task: Task, approvedTestPlan: string, testResult: TestResult, review: TestRunReview, state: ProjectState, onProgress?: (phase: string, message: string) => void): Promise<string>;
+/**
+ * Document an approved test plan to docs/qa/test-plans/
+ *
+ * @param projectDir - Project root
+ * @param milestone - Parent milestone
+ * @param task - The task
+ * @param testPlan - Test plan text
+ * @param consensusResult - Consensus outcome
+ * @returns Relative path to the doc
+ */
+export declare function documentTestPlan(projectDir: string, milestone: Milestone, task: Task, testPlan: string, consensusResult: ConsensusProcessResult): Promise<string>;
+/**
+ * Document a test run review to docs/qa/test-runs/
+ *
+ * @param projectDir - Project root
+ * @param milestone - Parent milestone
+ * @param task - The task
+ * @param review - Tester's review
+ * @returns Relative path to the doc
+ */
+export declare function documentTestReview(projectDir: string, milestone: Milestone, task: Task, review: TestRunReview): Promise<string>;
+/**
+ * Check whether QA is enabled for the given project state.
+ * Defaults to false for existing projects (undefined), true only when explicitly set.
+ *
+ * @param state - Current project state
+ * @returns Whether the QA Tester skill is active
+ */
+export declare function isQaEnabled(state: ProjectState): boolean;
+//# sourceMappingURL=tester.d.ts.map

package/dist/workflow/tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tester.d.ts","sourceRoot":"","sources":["../../src/workflow/tester.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAuD,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAClH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,sBAAsB,CAAC,CA4DjC;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAsCrE;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,YAAY,EACnB,gBAAgB,EAAE,MAAM,EACxB,kBAAkB,EAAE,sBAAsB,GACzC,MAAM,CA8ER;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,YAAY,GAClB,MAAM,CAuDR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,YAAY,GAClB,MAAM,CAmDR;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,sBAAsB,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,YAAY,EACnB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD,GACA,OAAO,CAAC,kBAAkB,CAAC,CAuG7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,YAAY,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACpD,OAAO,CAAC,aAAa,CAAC,CA+CxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,YAAY,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACpD,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAMD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,sBAAsB,GACtC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAExD"}