pi-harness-runtime 0.9.22 → 0.10.0

package/packages/react-vite-plugin/dist/analyzer.js

@@ -6,14 +6,14 @@
 import { existsSync } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
-// ─── Detection ───────────────────────────────────────────────────────────────
+// --- Detection ---------------------------------------------------------------
 function isReactViteWorkspace(root) {
     return (existsSync(join(root, "vite.config.ts")) ||
         existsSync(join(root, "vite.config.js")) ||
         existsSync(join(root, "vite.config.mjs")) ||
         (existsSync(join(root, "package.json")) && existsSync(join(root, "src"))));
 }
-// ─── Version & Dependencies ─────────────────────────────────────────────────
+// --- Version & Dependencies -------------------------------------------------
 async function detectVersionAndDeps(root) {
     try {
         const pkg = JSON.parse(await readFile(join(root, "package.json"), "utf-8"));
@@ -47,7 +47,7 @@ async function detectVersionAndDeps(root) {
         return { plugins: [], hasRouter: false };
     }
 }
-// ─── Config Files ────────────────────────────────────────────────────────────
+// --- Config Files ------------------------------------------------------------
 async function findConfigFiles(root) {
     const candidates = [
         join(root, "vite.config.ts"),
@@ -64,7 +64,7 @@ async function findConfigFiles(root) {
     }
     return configs;
 }
-// ─── Alias Parsing ───────────────────────────────────────────────────────────
+// --- Alias Parsing -----------------------------------------------------------
 async function parseAliases(root) {
     const aliases = {};
     // Parse vite.config.ts/js for path aliases
@@ -124,7 +124,7 @@ async function parseAliases(root) {
     }
     return aliases;
 }
-// ─── Component Scanner ───────────────────────────────────────────────────────
+// --- Component Scanner -------------------------------------------------------
 async function walkComponents(dir, exts = [".tsx", ".jsx", ".ts", ".js"]) {
     const components = [];
     try {
@@ -149,7 +149,7 @@ async function walkComponents(dir, exts = [".tsx", ".jsx", ".ts", ".js"]) {
     }
     return components;
 }
-// ─── Pages Scanner ───────────────────────────────────────────────────────────
+// --- Pages Scanner -----------------------------------------------------------
 async function findPages(root) {
     for (const d of [
         join(root, "src", "pages"),
@@ -163,7 +163,7 @@ async function findPages(root) {
     }
     return [];
 }
-// ─── Main Analyzer ─────────────────────────────────────────────────────────
+// --- Main Analyzer ---------------------------------------------------------
 export async function analyzeReactVite(root) {
     if (!isReactViteWorkspace(root))
         return null;

package/packages/react-vite-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/react-vite-plugin",
-  "version": "0.9.15",
+  "version": "0.9.25",
   "description": "React/Vite framework analysis — components, config, TypeScript setup",
   "type": "module",
   "main": "./dist/index.js",

package/packages/react-vite-plugin/src/analyzer.ts

@@ -9,7 +9,7 @@ import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
 import type { ReactViteAnalysis, ConfigFile } from "./types.js";
 
-// ─── Detection ───────────────────────────────────────────────────────────────
+// --- Detection ---------------------------------------------------------------
 
 function isReactViteWorkspace(root: string): boolean {
 	return (
@@ -20,7 +20,7 @@ function isReactViteWorkspace(root: string): boolean {
 	);
 }
 
-// ─── Version & Dependencies ─────────────────────────────────────────────────
+// --- Version & Dependencies -------------------------------------------------
 
 async function detectVersionAndDeps(
 	root: string,
@@ -62,7 +62,7 @@ async function detectVersionAndDeps(
 	}
 }
 
-// ─── Config Files ────────────────────────────────────────────────────────────
+// --- Config Files ------------------------------------------------------------
 
 async function findConfigFiles(root: string): Promise<ConfigFile[]> {
 	const candidates = [
@@ -81,7 +81,7 @@ async function findConfigFiles(root: string): Promise<ConfigFile[]> {
 	return configs;
 }
 
-// ─── Alias Parsing ───────────────────────────────────────────────────────────
+// --- Alias Parsing -----------------------------------------------------------
 
 async function parseAliases(root: string): Promise<Record<string, string>> {
 	const aliases: Record<string, string> = {};
@@ -149,7 +149,7 @@ async function parseAliases(root: string): Promise<Record<string, string>> {
 	return aliases;
 }
 
-// ─── Component Scanner ───────────────────────────────────────────────────────
+// --- Component Scanner -------------------------------------------------------
 
 async function walkComponents(
 	dir: string,
@@ -176,7 +176,7 @@ async function walkComponents(
 	return components;
 }
 
-// ─── Pages Scanner ───────────────────────────────────────────────────────────
+// --- Pages Scanner -----------------------------------------------------------
 
 async function findPages(root: string): Promise<string[]> {
 	for (const d of [
@@ -192,7 +192,7 @@ async function findPages(root: string): Promise<string[]> {
 	return [];
 }
 
-// ─── Main Analyzer ─────────────────────────────────────────────────────────
+// --- Main Analyzer ---------------------------------------------------------
 
 export async function analyzeReactVite(
 	root: string,

package/packages/release-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/release-manager",
-  "version": "0.9.15",
+  "version": "0.9.25",
   "type": "module",
   "description": "Release management for pi-harness",
   "main": "dist/index.js",

package/packages/requirement-compiler/dist/compiler.js

@@ -18,24 +18,24 @@ export async function compileRequirement(raw, deps) {
         ...deps,
     };
     const clock = deps?.clock ?? (() => new Date());
-    // ─── Pre-flight validation ────────────────────────────────────────────────
+    // --- Pre-flight validation ------------------------------------------------
     if (!raw.text.trim() && !raw.title?.trim()) {
         throw new RequirementCompileError(RequirementCompileErrorCodes.EMPTY_REQUIREMENT, `Requirement ${raw.id} has no text or title.`, { requirementId: raw.id });
     }
-    // ─── Step 1: Extract statements ─────────────────────────────────────────
+    // --- Step 1: Extract statements -----------------------------------------
     const extractor = deps?.extractor ?? { extract: extractStatements };
     const extractionResult = extractor.extract(raw);
-    // ─── Step 2: Classify statements ──────────────────────────────────────
+    // --- Step 2: Classify statements --------------------------------------
     const classifier = deps?.classifier ?? { classify: classifyStatements };
     const classification = classifier.classify(extractionResult.statements, config);
-    // ─── Step 3: Build goals ─────────────────────────────────────────────────
+    // --- Step 3: Build goals -------------------------------------------------
     const goals = classification.goals.map((stmt, i) => ({
         id: `goal-${i + 1}`,
         description: stmt.originalText,
         sourceRefs: [stmt.sourceRef],
         priority: undefined,
     }));
-    // ─── Step 4: Build constraints ────────────────────────────────────────────
+    // --- Step 4: Build constraints --------------------------------------------
     const constraints = classification.constraints.map((stmt, i) => ({
         id: `constraint-${i + 1}`,
         description: stmt.originalText,
@@ -43,7 +43,7 @@ export async function compileRequirement(raw, deps) {
         sourceRefs: [stmt.sourceRef],
         blocking: true,
     }));
-    // ─── Step 5: Build preferences ───────────────────────────────────────────
+    // --- Step 5: Build preferences -------------------------------------------
     const preferenceConstraints = classification.preferences.map((stmt, i) => ({
         id: `pref-constraint-${i + 1}`,
         description: stmt.originalText,
@@ -51,12 +51,12 @@ export async function compileRequirement(raw, deps) {
         sourceRefs: [stmt.sourceRef],
         blocking: false,
     }));
-    // ─── Step 6: Detect ambiguities ───────────────────────────────────────────
+    // --- Step 6: Detect ambiguities -------------------------------------------
     const ambiguityDetector = deps?.ambiguityDetector ?? {
         detect: detectAmbiguities,
     };
     const ambiguities = ambiguityDetector.detect(classification, config);
-    // ─── Step 7: Normalize acceptance criteria ────────────────────────────────
+    // --- Step 7: Normalize acceptance criteria --------------------------------
     const acceptanceNormalizer = deps?.acceptanceNormalizer ?? {
         normalize: normalizeAcceptanceCriteria,
     };
@@ -74,17 +74,17 @@ export async function compileRequirement(raw, deps) {
             automatable: false,
         }));
     }
-    // ─── Step 8: Detect risks ─────────────────────────────────────────────────
+    // --- Step 8: Detect risks -------------------------------------------------
     const riskDetector = deps?.riskDetector ?? { detect: detectRisks };
     const riskTags = riskDetector.detect(classification);
-    // ─── Step 9: Extract terminology ──────────────────────────────────────────
+    // --- Step 9: Extract terminology ------------------------------------------
     const terminology = classification.terminologyMentions.map((stmt) => ({
         term: stmt.originalText,
         definition: stmt.normalizedText,
         language: /[ก-๙]/.test(stmt.originalText) ? "th" : "en",
         sourceRef: stmt.sourceRef,
     }));
-    // ─── Step 10: Identify actors ──────────────────────────────────────────────
+    // --- Step 10: Identify actors ----------------------------------------------
     const actors = [];
     const actorNames = new Set();
     // Scan all meaningful statements for actor mentions
@@ -143,7 +143,7 @@ export async function compileRequirement(raw, deps) {
             }
         }
     }
-    // ─── Step 11: Identify non-goals ──────────────────────────────────────────
+    // --- Step 11: Identify non-goals ------------------------------------------
     const nonGoals = [];
     for (const stmt of classification.constraints) {
         // Explicit "will not" or "should not" statements in non-goal context
@@ -152,7 +152,7 @@ export async function compileRequirement(raw, deps) {
             nonGoals.push(stmt.originalText);
         }
     }
-    // ─── Step 12: Build workflows ─────────────────────────────────────────────
+    // --- Step 12: Build workflows ---------------------------------------------
     const workflows = [];
     // Group consecutive statements into workflows heuristically
     const goalStatements = [
@@ -170,7 +170,7 @@ export async function compileRequirement(raw, deps) {
             sourceRefs: goalStatements.flatMap((s) => [s.sourceRef]),
         });
     }
-    // ─── Step 13: Determine status ────────────────────────────────────────────
+    // --- Step 13: Determine status --------------------------------------------
     let status = "ready";
     const blockingAmbiguities = ambiguities.filter((a) => a.blocking);
     if (blockingAmbiguities.length > 0 &&
@@ -196,13 +196,13 @@ export async function compileRequirement(raw, deps) {
         (!raw.text.trim() || isVague)) {
         throw new RequirementCompileError(RequirementCompileErrorCodes.EMPTY_REQUIREMENT, `Requirement ${raw.id} contains no identifiable goals or constraints.`, { requirementId: raw.id });
     }
-    // ─── Step 14: Build source references ────────────────────────────────────
+    // --- Step 14: Build source references ------------------------------------
     const sourceRefs = extractionResult.statements.map((s) => s.sourceRef);
-    // ─── Step 15: Assemble problem statement ─────────────────────────────────
+    // --- Step 15: Assemble problem statement ---------------------------------
     const problemStatement = goals.length > 0
         ? goals.map((g) => g.description).join("; ")
         : (raw.title ?? raw.text.slice(0, 200));
-    // ─── Step 16: Build final compiled requirement ────────────────────────────
+    // --- Step 16: Build final compiled requirement ----------------------------
     const compiled = {
         id: raw.id,
         title: raw.title ?? problemStatement.slice(0, 80),

package/packages/requirement-compiler/dist/types.js

@@ -3,7 +3,7 @@
  *
  * Type definitions for raw and compiled requirements.
  */
-// ─── SDK Version ────────────────────────────────────────────────────────────
+// --- SDK Version ------------------------------------------------------------
 export const SDK_VERSION = "1.0.0";
 export const DEFAULT_COMPILER_CONFIG = {
     projectLanguage: "en",
@@ -101,7 +101,7 @@ export const DEFAULT_COMPILER_CONFIG = {
         "ควร",
     ],
 };
-// ─── Compiler Errors ──────────────────────────────────────────────────────
+// --- Compiler Errors ------------------------------------------------------
 /**
  * Error codes for requirement compilation failures.
  * Use this enum-like object for programmatic error checking.

package/packages/requirement-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/requirement-compiler",
-  "version": "0.9.15",
+  "version": "0.9.25",
   "description": "Compiles raw requirements into validated CompiledRequirement with ambiguity detection and risk tagging",
   "type": "module",
   "main": "./dist/index.js",

package/packages/requirement-compiler/src/compiler.ts

@@ -34,7 +34,7 @@ export async function compileRequirement(
 
 	const clock = deps?.clock ?? (() => new Date());
 
-	// ─── Pre-flight validation ────────────────────────────────────────────────
+	// --- Pre-flight validation ------------------------------------------------
 
 	if (!raw.text.trim() && !raw.title?.trim()) {
 		throw new RequirementCompileError(
@@ -44,12 +44,12 @@ export async function compileRequirement(
 		);
 	}
 
-	// ─── Step 1: Extract statements ─────────────────────────────────────────
+	// --- Step 1: Extract statements -----------------------------------------
 
 	const extractor = deps?.extractor ?? { extract: extractStatements };
 	const extractionResult = extractor.extract(raw);
 
-	// ─── Step 2: Classify statements ──────────────────────────────────────
+	// --- Step 2: Classify statements --------------------------------------
 
 	const classifier = deps?.classifier ?? { classify: classifyStatements };
 	const classification: ClassificationResult = classifier.classify(
@@ -57,7 +57,7 @@ export async function compileRequirement(
 		config,
 	);
 
-	// ─── Step 3: Build goals ─────────────────────────────────────────────────
+	// --- Step 3: Build goals -------------------------------------------------
 
 	const goals = classification.goals.map((stmt, i) => ({
 		id: `goal-${i + 1}`,
@@ -66,7 +66,7 @@ export async function compileRequirement(
 		priority: undefined as "high" | "medium" | "low" | undefined,
 	}));
 
-	// ─── Step 4: Build constraints ────────────────────────────────────────────
+	// --- Step 4: Build constraints --------------------------------------------
 
 	const constraints = classification.constraints.map((stmt, i) => ({
 		id: `constraint-${i + 1}`,
@@ -76,7 +76,7 @@ export async function compileRequirement(
 		blocking: true,
 	}));
 
-	// ─── Step 5: Build preferences ───────────────────────────────────────────
+	// --- Step 5: Build preferences -------------------------------------------
 
 	const preferenceConstraints = classification.preferences.map((stmt, i) => ({
 		id: `pref-constraint-${i + 1}`,
@@ -86,14 +86,14 @@ export async function compileRequirement(
 		blocking: false,
 	}));
 
-	// ─── Step 6: Detect ambiguities ───────────────────────────────────────────
+	// --- Step 6: Detect ambiguities -------------------------------------------
 
 	const ambiguityDetector = deps?.ambiguityDetector ?? {
 		detect: detectAmbiguities,
 	};
 	const ambiguities = ambiguityDetector.detect(classification, config);
 
-	// ─── Step 7: Normalize acceptance criteria ────────────────────────────────
+	// --- Step 7: Normalize acceptance criteria --------------------------------
 
 	const acceptanceNormalizer = deps?.acceptanceNormalizer ?? {
 		normalize: normalizeAcceptanceCriteria,
@@ -116,12 +116,12 @@ export async function compileRequirement(
 		}));
 	}
 
-	// ─── Step 8: Detect risks ─────────────────────────────────────────────────
+	// --- Step 8: Detect risks -------------------------------------------------
 
 	const riskDetector = deps?.riskDetector ?? { detect: detectRisks };
 	const riskTags = riskDetector.detect(classification);
 
-	// ─── Step 9: Extract terminology ──────────────────────────────────────────
+	// --- Step 9: Extract terminology ------------------------------------------
 
 	const terminology = classification.terminologyMentions.map((stmt) => ({
 		term: stmt.originalText,
@@ -130,7 +130,7 @@ export async function compileRequirement(
 		sourceRef: stmt.sourceRef,
 	}));
 
-	// ─── Step 10: Identify actors ──────────────────────────────────────────────
+	// --- Step 10: Identify actors ----------------------------------------------
 
 	const actors: CompiledRequirement["actors"] = [];
 	const actorNames = new Set<string>();
@@ -208,7 +208,7 @@ export async function compileRequirement(
 		}
 	}
 
-	// ─── Step 11: Identify non-goals ──────────────────────────────────────────
+	// --- Step 11: Identify non-goals ------------------------------------------
 
 	const nonGoals: string[] = [];
 	for (const stmt of classification.constraints) {
@@ -221,7 +221,7 @@ export async function compileRequirement(
 		}
 	}
 
-	// ─── Step 12: Build workflows ─────────────────────────────────────────────
+	// --- Step 12: Build workflows ---------------------------------------------
 
 	const workflows: CompiledRequirement["workflows"] = [];
 	// Group consecutive statements into workflows heuristically
@@ -241,7 +241,7 @@ export async function compileRequirement(
 		});
 	}
 
-	// ─── Step 13: Determine status ────────────────────────────────────────────
+	// --- Step 13: Determine status --------------------------------------------
 
 	let status: CompiledRequirement["status"] = "ready";
 
@@ -287,18 +287,18 @@ export async function compileRequirement(
 		);
 	}
 
-	// ─── Step 14: Build source references ────────────────────────────────────
+	// --- Step 14: Build source references ------------------------------------
 
 	const sourceRefs = extractionResult.statements.map((s) => s.sourceRef);
 
-	// ─── Step 15: Assemble problem statement ─────────────────────────────────
+	// --- Step 15: Assemble problem statement ---------------------------------
 
 	const problemStatement =
 		goals.length > 0
 			? goals.map((g) => g.description).join("; ")
 			: (raw.title ?? raw.text.slice(0, 200));
 
-	// ─── Step 16: Build final compiled requirement ────────────────────────────
+	// --- Step 16: Build final compiled requirement ----------------------------
 
 	const compiled: CompiledRequirement = {
 		id: raw.id,

package/packages/requirement-compiler/src/types.ts

@@ -4,11 +4,11 @@
  * Type definitions for raw and compiled requirements.
  */
 
-// ─── SDK Version ────────────────────────────────────────────────────────────
+// --- SDK Version ------------------------------------------------------------
 
 export const SDK_VERSION = "1.0.0";
 
-// ─── Source Reference ─────────────────────────────────────────────────────
+// --- Source Reference -----------------------------------------------------
 
 /**
  * Reference to a source location in the original requirement.
@@ -26,7 +26,7 @@ export interface SourceReference {
 	text: string;
 }
 
-// ─── Attachment ────────────────────────────────────────────────────────────
+// --- Attachment ------------------------------------------------------------
 
 /**
  * Reference to an attached file (screenshot, document, etc.).
@@ -42,7 +42,7 @@ export interface AttachmentReference {
 	description?: string;
 }
 
-// ─── Raw Requirement (Input) ─────────────────────────────────────────────
+// --- Raw Requirement (Input) ---------------------------------------------
 
 /**
  * Raw requirement as submitted by a user or received from an API.
@@ -64,7 +64,7 @@ export interface RawRequirement {
 	submittedAt: string;
 }
 
-// ─── Statement Types ──────────────────────────────────────────────────────
+// --- Statement Types ------------------------------------------------------
 
 /**
  * Kinds of statements extracted from raw requirement text.
@@ -109,7 +109,7 @@ export interface ExtractedStatement {
 	userMarkedMandatory?: boolean;
 }
 
-// ─── Goals ────────────────────────────────────────────────────────────────
+// --- Goals ----------------------------------------------------------------
 
 /**
  * A goal extracted from the requirement.
@@ -125,7 +125,7 @@ export interface RequirementGoal {
 	priority?: "high" | "medium" | "low";
 }
 
-// ─── Constraints ──────────────────────────────────────────────────────────
+// --- Constraints ----------------------------------------------------------
 
 /**
  * A constraint that the solution must satisfy.
@@ -145,7 +145,7 @@ export interface RequirementConstraint {
 	blocking: boolean;
 }
 
-// ─── Actors ───────────────────────────────────────────────────────────────
+// --- Actors ---------------------------------------------------------------
 
 /**
  * An actor (user role, system, service) identified in the requirement.
@@ -161,7 +161,7 @@ export interface RequirementActor {
 	sourceRefs: SourceReference[];
 }
 
-// ─── Workflows ────────────────────────────────────────────────────────────
+// --- Workflows ------------------------------------------------------------
 
 /**
  * A workflow or use case described in the requirement.
@@ -183,7 +183,7 @@ export interface RequirementWorkflow {
 	sourceRefs: SourceReference[];
 }
 
-// ─── Acceptance Criteria ─────────────────────────────────────────────────
+// --- Acceptance Criteria -------------------------------------------------
 
 /**
  * Normalized acceptance criterion using Given/When/Then format.
@@ -205,7 +205,7 @@ export interface AcceptanceCriterion {
 	originalText?: string;
 }
 
-// ─── Ambiguities ──────────────────────────────────────────────────────────
+// --- Ambiguities ----------------------------------------------------------
 
 /**
  * An ambiguous area in the requirement that needs clarification.
@@ -231,7 +231,7 @@ export interface RequirementAmbiguity {
 		| "unknown";
 }
 
-// ─── Assumptions ─────────────────────────────────────────────────────────
+// --- Assumptions ---------------------------------------------------------
 
 /**
  * An assumption that was made to fill a gap.
@@ -247,7 +247,7 @@ export interface RequirementAssumption {
 	reversible: boolean;
 }
 
-// ─── Terminology ───────────────────────────────────────────────────────────
+// --- Terminology -----------------------------------------------------------
 
 /**
  * Domain terminology mapping.
@@ -263,7 +263,7 @@ export interface TerminologyEntry {
 	sourceRef?: SourceReference;
 }
 
-// ─── Risk Tags ────────────────────────────────────────────────────────────
+// --- Risk Tags ------------------------------------------------------------
 
 /**
  * Risk areas that require additional review.
@@ -289,7 +289,7 @@ export interface RiskTag {
 	description: string;
 }
 
-// ─── Compilation Status ───────────────────────────────────────────────────
+// --- Compilation Status ---------------------------------------------------
 
 /**
  * Status of a compiled requirement.
@@ -302,7 +302,7 @@ export type RequirementStatus =
 	/** Rejected (empty, impossible, or policy violation) */
 	| "rejected";
 
-// ─── Compiled Requirement (Output) ────────────────────────────────────────
+// --- Compiled Requirement (Output) ----------------------------------------
 
 /**
  * Fully compiled requirement with validated structure.
@@ -344,7 +344,7 @@ export interface CompiledRequirement {
 	compiledAt: string;
 }
 
-// ─── Extraction Result ────────────────────────────────────────────────────
+// --- Extraction Result ----------------------------------------------------
 
 /**
  * Result of statement extraction from raw text.
@@ -356,7 +356,7 @@ export interface ExtractionResult {
 	lines: string[];
 }
 
-// ─── Classification Result ─────────────────────────────────────────────────
+// --- Classification Result -------------------------------------------------
 
 /**
  * Result of statement classification.
@@ -384,7 +384,7 @@ export interface ClassificationResult {
 	unknown: ExtractedStatement[];
 }
 
-// ─── Compiler Configuration ────────────────────────────────────────────────
+// --- Compiler Configuration ------------------------------------------------
 
 /**
  * Configuration for the Requirement Compiler.
@@ -517,7 +517,7 @@ export const DEFAULT_COMPILER_CONFIG: RequirementCompilerConfig = {
 	],
 };
 
-// ─── Compiler Dependencies ─────────────────────────────────────────────────
+// --- Compiler Dependencies -------------------------------------------------
 
 /**
  * Dependencies injected into the compiler.
@@ -564,7 +564,7 @@ export interface AcceptanceNormalizer {
 	normalize(statements: ExtractedStatement[]): AcceptanceCriterion[];
 }
 
-// ─── Compiler Errors ──────────────────────────────────────────────────────
+// --- Compiler Errors ------------------------------------------------------
 
 /**
  * Error codes for requirement compilation failures.