ridgeline 0.6.0 → 0.7.2

package/dist/plugin/visual-tools/skills/shader-validate/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: shader-validate
+description: Validate and cross-compile GLSL, WGSL, and SPIR-V shaders using naga. Use when writing shaders, checking shader compilation, debugging shader errors, converting between shader languages, or verifying WebGL/WebGPU shader code.
+compatibility: Requires naga-cli (cargo install naga-cli)
+metadata:
+  author: ridgeline
+  version: "1.0"
+---
+
+# Shader Validation
+
+Validate and cross-compile shaders using naga — a fast Rust-based shader translator supporting WGSL, GLSL, SPIR-V, MSL, and HLSL.
+
+## Validating a shader
+
+```bash
+naga my_shader.wgsl
+naga my_shader.frag
+naga my_shader.vert
+```
+
+Exit code 0 means the shader is valid. Non-zero prints error details with line numbers.
+
+## Cross-compiling shaders
+
+Convert between shader languages by specifying input and output files:
+
+```bash
+# WGSL to SPIR-V
+naga shader.wgsl shader.spv
+
+# GLSL to WGSL
+naga shader.frag shader.wgsl
+
+# SPIR-V to Metal
+naga shader.spv shader.metal
+
+# WGSL to GLSL (with profile)
+naga shader.wgsl shader.frag --profile es310
+```
+
+The output format is determined by file extension.
+
+## Common GLSL validation
+
+For WebGL fragment shaders:
+
+```bash
+naga my_effect.frag
+```
+
+For vertex shaders:
+
+```bash
+naga my_mesh.vert
+```
+
+## Batch validation
+
+Validate all shaders in a directory:
+
+```bash
+find src/shaders -name '*.frag' -o -name '*.vert' -o -name '*.wgsl' | xargs -I {} naga {}
+```
+
+## Common errors
+
+- **"unknown type"**: Missing uniform/varying declaration or typo in type name
+- **"expected ';'"**: Missing semicolon (GLSL) or syntax mismatch
+- **"binding collision"**: Two resources share the same binding index
+- **"entry point not found"**: Missing `main` function (GLSL) or `@vertex`/`@fragment` annotation (WGSL)
+
+## Gotchas
+
+- naga's GLSL support requires the shader stage to be inferred from the file extension (`.vert`, `.frag`, `.comp`). Use the correct extension.
+- WGSL is the native format — validation is most thorough for WGSL input.
+- naga does not execute shaders. It checks syntax, types, and resource bindings — not runtime behavior.

package/dist/plugin/visual-tools/skills/visual-diff/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: visual-diff
+description: Compare screenshots pixel-by-pixel against reference images to detect visual regressions. Use when checking for unintended visual changes, comparing before/after screenshots, or validating that UI changes match expectations.
+compatibility: Requires pixelmatch (npm i -g pixelmatch) and pngjs (npm i -g pngjs)
+metadata:
+  author: ridgeline
+  version: "1.0"
+---
+
+# Visual Diff
+
+Pixel-level screenshot comparison using pixelmatch. Compares two PNG images and produces a diff image highlighting changed pixels.
+
+## Comparing two screenshots
+
+Write and run a Node.js script:
+
+```javascript
+const fs = require('fs');
+const { PNG } = require('pngjs');
+const pixelmatch = require('pixelmatch');
+
+const img1 = PNG.sync.read(fs.readFileSync('reference.png'));
+const img2 = PNG.sync.read(fs.readFileSync('current.png'));
+const { width, height } = img1;
+const diff = new PNG({ width, height });
+
+const mismatchedPixels = pixelmatch(
+  img1.data, img2.data, diff.data, width, height,
+  { threshold: 0.1 }
+);
+
+fs.writeFileSync('diff.png', PNG.sync.write(diff));
+
+const totalPixels = width * height;
+const mismatchPercent = ((mismatchedPixels / totalPixels) * 100).toFixed(2);
+console.log(`Mismatched pixels: ${mismatchedPixels} (${mismatchPercent}%)`);
+```
+
+## Interpreting results
+
+- **< 1% mismatch**: Pass — sub-pixel rendering differences, antialiasing
+
+- **1–5% mismatch**: Review — may be intentional changes or minor regressions
+- **> 5% mismatch**: Likely regression — investigate the diff image
+
+## Creating reference images
+
+Save a known-good screenshot as the reference. Store references alongside the test:
+
+```text
+tests/visual/
+  reference/
+    homepage-mobile.png
+    homepage-desktop.png
+  current/
+    homepage-mobile.png
+    homepage-desktop.png
+  diff/
+    homepage-mobile.png
+```
+
+## Gotchas
+
+- Images must be the same dimensions. Resize first if viewports differ.
+
+- Font rendering varies across OS — set threshold to 0.1 or higher to account for antialiasing.
+- Dynamic content (timestamps, avatars) causes false positives. Mock or hide dynamic elements before capture.

package/dist/shapes/detect.d.ts

@@ -0,0 +1,8 @@
+type ShapeDefinition = {
+    name: string;
+    keywords: string[];
+    reviewerContext: string;
+};
+export declare function loadShapeDefinitions(): ShapeDefinition[];
+export declare function detectShapes(text: string, definitions: ShapeDefinition[]): ShapeDefinition[];
+export {};

package/dist/shapes/detect.js

@@ -0,0 +1,87 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadShapeDefinitions = loadShapeDefinitions;
+exports.detectShapes = detectShapes;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+function resolveShapesDir() {
+    const candidates = [
+        path.join(__dirname),
+        path.join(__dirname, "..", "shapes"),
+        path.join(__dirname, "..", "..", "src", "shapes"),
+    ];
+    for (const candidate of candidates) {
+        try {
+            const entries = fs.readdirSync(candidate);
+            const hasJson = entries.some(f => f.endsWith(".json"));
+            if (hasJson)
+                return candidate;
+        }
+        catch {
+            // directory doesn't exist or can't be read — try next
+        }
+    }
+    return null;
+}
+function loadShapeDefinitions() {
+    const dir = resolveShapesDir();
+    if (dir === null)
+        return [];
+    const entries = fs.readdirSync(dir);
+    const jsonFiles = entries.filter(f => f.endsWith(".json"));
+    const definitions = [];
+    for (const file of jsonFiles) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
+            const parsed = JSON.parse(raw);
+            if (typeof parsed.name === "string" &&
+                Array.isArray(parsed.keywords)) {
+                definitions.push(parsed);
+            }
+        }
+        catch {
+            // malformed JSON or unreadable file — skip
+        }
+    }
+    return definitions;
+}
+function detectShapes(text, definitions) {
+    if (!text || definitions.length === 0)
+        return [];
+    const lower = text.toLowerCase();
+    return definitions.filter(def => def.keywords.some(keyword => lower.includes(keyword.toLowerCase())));
+}
+//# sourceMappingURL=detect.js.map

package/dist/shapes/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/shapes/detect.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,oDAyBC;AAED,oCAQC;AAhED,4CAA6B;AAC7B,gDAAiC;AAQjC,SAAS,gBAAgB;IACvB,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC;KAClD,CAAA;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAa,CAAA;YACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;YACtD,IAAI,OAAO;gBAAE,OAAO,SAAS,CAAA;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAgB,oBAAoB;IAClC,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAA;IAC9B,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAE3B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAa,CAAA;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;IAE1D,MAAM,WAAW,GAAsB,EAAE,CAAA;IAEzC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAW,CAAA;YACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC9B,IACE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAC/B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAC9B,CAAC;gBACD,WAAW,CAAC,IAAI,CAAC,MAAyB,CAAC,CAAA;YAC7C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,SAAgB,YAAY,CAAC,IAAY,EAAE,WAA8B;IACvE,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEhD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAEhC,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC9B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CACpE,CAAA;AACH,CAAC"}

package/dist/shapes/game-visual.json

@@ -0,0 +1,8 @@
+{
+  "name": "game-visual",
+  "keywords": [
+    "game", "sprite", "texture", "3D", "scene", "canvas",
+    "WebGL", "Godot", "Unity", "Phaser"
+  ],
+"reviewerContext": "Verify asset dimensions match specification. Check color palette consistency. Validate sprite sheet layouts. Evaluate UI overlay legibility against game backgrounds."
+}

package/dist/shapes/print-layout.json

@@ -0,0 +1,8 @@
+{
+  "name": "print-layout",
+  "keywords": [
+    "print", "PDF", "document", "brochure", "typography",
+    "poster", "flyer", "report"
+  ],
+"reviewerContext": "Verify bleed and trim areas. Check font embedding. Validate resolution meets print DPI requirements. Evaluate typographic hierarchy and spacing consistency."
+}

package/dist/shapes/web-visual.json

@@ -0,0 +1,9 @@
+{
+  "name": "web-visual",
+  "keywords": [
+    "UI", "frontend", "CSS", "responsive", "web app", "dashboard",
+    "website", "landing page", "SPA", "component library", "design system",
+    "Tailwind", "React", "Vue", "Svelte"
+  ],
+"reviewerContext": "Check responsive behavior at mobile/tablet/desktop viewports. Verify interactive states. Evaluate whitespace and visual breathing room. Check color contrast ratios."
+}

package/dist/stores/budget.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTotalCost = exports.recordCost = exports.saveBudget = exports.loadBudget = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
+const atomic_write_1 = require("../utils/atomic-write");
 const budgetPath = (buildDir) => path.join(buildDir, "budget.json");
 const loadBudget = (buildDir) => {
     const fp = budgetPath(buildDir);
@@ -46,7 +47,7 @@ const loadBudget = (buildDir) => {
 };
 exports.loadBudget = loadBudget;
 const saveBudget = (buildDir, budget) => {
-    fs.writeFileSync(budgetPath(buildDir), JSON.stringify(budget, null, 2) + "\n");
+    (0, atomic_write_1.atomicWriteSync)(budgetPath(buildDir), JSON.stringify(budget, null, 2) + "\n");
 };
 exports.saveBudget = saveBudget;
 const recordCost = (buildDir, phase, role, attempt, result) => {

package/dist/stores/budget.js.map

@@ -1 +1 @@
-{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/stores/budget.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAGjC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAU,EAAE,CAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;AAE7B,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAe,EAAE;IAC1D,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAA;AACzC,CAAC,CAAA;AANY,QAAA,UAAU,cAMtB;AAEM,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,MAAmB,EAAQ,EAAE;IACxE,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AAChF,CAAC,CAAA;AAFY,QAAA,UAAU,cAEtB;AAEM,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,KAAa,EACb,IAAyB,EACzB,OAAe,EACf,MAAoB,EACP,EAAE;IACf,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,KAAK,GAAgB;QACzB,KAAK;QACL,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;QACrC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY;QACvC,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,oBAAoB;QACvD,wBAAwB,EAAE,MAAM,CAAC,KAAK,CAAC,wBAAwB;QAC/D,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAA;IACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC3E,IAAA,kBAAU,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC5B,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAxBY,QAAA,UAAU,cAwBtB;AAEM,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAU,EAAE,CACvD,IAAA,kBAAU,EAAC,QAAQ,CAAC,CAAC,YAAY,CAAA;AADtB,QAAA,YAAY,gBACU"}
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/stores/budget.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAEjC,wDAAuD;AAEvD,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAU,EAAE,CAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;AAE7B,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAe,EAAE;IAC1D,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAA;AACzC,CAAC,CAAA;AANY,QAAA,UAAU,cAMtB;AAEM,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,MAAmB,EAAQ,EAAE;IACxE,IAAA,8BAAe,EAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AAC/E,CAAC,CAAA;AAFY,QAAA,UAAU,cAEtB;AAEM,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,KAAa,EACb,IAAyB,EACzB,OAAe,EACf,MAAoB,EACP,EAAE;IACf,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,KAAK,GAAgB;QACzB,KAAK;QACL,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;QACrC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY;QACvC,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,oBAAoB;QACvD,wBAAwB,EAAE,MAAM,CAAC,KAAK,CAAC,wBAAwB;QAC/D,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAA;IACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC3E,IAAA,kBAAU,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC5B,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAxBY,QAAA,UAAU,cAwBtB;AAEM,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAU,EAAE,CACvD,IAAA,kBAAU,EAAC,QAAQ,CAAC,CAAC,YAAY,CAAA;AADtB,QAAA,YAAY,gBACU"}

package/dist/stores/feedback.format.d.ts

@@ -0,0 +1,3 @@
+import { ReviewIssue, ReviewVerdict } from "../types";
+export declare const formatIssue: (issue: ReviewIssue) => string;
+export declare const generateFeedback: (phaseId: string, verdict: ReviewVerdict) => string;

package/dist/stores/feedback.format.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFeedback = exports.formatIssue = void 0;
+// Format a ReviewIssue for display
+const formatIssue = (issue) => {
+    const parts = [];
+    if (issue.file)
+        parts.push(issue.file);
+    parts.push(issue.description);
+    return parts.join(": ");
+};
+exports.formatIssue = formatIssue;
+// Generate feedback markdown from a structured verdict
+const generateFeedback = (phaseId, verdict) => {
+    const lines = [];
+    lines.push(`# Reviewer Feedback: Phase ${phaseId}`);
+    lines.push("");
+    // Failed criteria
+    const failed = verdict.criteriaResults.filter((cr) => !cr.passed);
+    if (failed.length > 0) {
+        lines.push("## Failed Criteria");
+        lines.push("");
+        for (const cr of failed) {
+            lines.push(`### Criterion ${cr.criterion}`);
+            lines.push(`**Status:** FAIL`);
+            lines.push(`**Evidence:** ${cr.notes}`);
+            // Find matching issue with requiredState
+            const matchingIssue = verdict.issues.find((i) => i.criterion === cr.criterion);
+            if (matchingIssue?.requiredState) {
+                lines.push(`**Required state:** ${matchingIssue.requiredState}`);
+            }
+            lines.push("");
+        }
+    }
+    // Blocking issues
+    const blocking = verdict.issues.filter((i) => i.severity === "blocking");
+    if (blocking.length > 0) {
+        lines.push("## Issues");
+        lines.push("");
+        for (const issue of blocking) {
+            const filePart = issue.file ? ` (${issue.file})` : "";
+            lines.push(`- ${issue.description}${filePart}`);
+            if (issue.requiredState) {
+                lines.push(`  - **Required:** ${issue.requiredState}`);
+            }
+        }
+        lines.push("");
+    }
+    // What passed
+    const passed = verdict.criteriaResults.filter((cr) => cr.passed);
+    if (passed.length > 0) {
+        lines.push("## What Passed");
+        lines.push("");
+        for (const cr of passed) {
+            lines.push(`- Criterion ${cr.criterion}: ${cr.notes}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+};
+exports.generateFeedback = generateFeedback;
+//# sourceMappingURL=feedback.format.js.map

package/dist/stores/feedback.format.js.map

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

package/dist/stores/feedback.parse.d.ts

@@ -0,0 +1,2 @@
+import { ReviewVerdict } from "../types";
+export declare const parseVerdict: (text: string) => ReviewVerdict;

package/dist/stores/feedback.parse.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVerdict = void 0;
+// Normalize an issue entry — accept both string and object forms
+const normalizeIssue = (item, severity) => {
+    if (typeof item === "string") {
+        return { description: item, severity };
+    }
+    if (typeof item === "object" && item !== null) {
+        const obj = item;
+        return {
+            criterion: typeof obj.criterion === "number" ? obj.criterion : undefined,
+            description: typeof obj.description === "string" ? obj.description : String(obj.description ?? ""),
+            file: typeof obj.file === "string" ? obj.file : undefined,
+            severity,
+            requiredState: typeof obj.requiredState === "string" ? obj.requiredState : undefined,
+        };
+    }
+    return { description: String(item), severity };
+};
+// Try to parse a raw object as a ReviewVerdict
+const tryParseVerdict = (raw) => {
+    if (typeof raw !== "object" || raw === null)
+        return null;
+    const obj = raw;
+    if (typeof obj.passed !== "boolean")
+        return null;
+    return {
+        passed: obj.passed,
+        summary: typeof obj.summary === "string" ? obj.summary : "",
+        criteriaResults: Array.isArray(obj.criteriaResults)
+            ? obj.criteriaResults.map((cr) => ({
+                criterion: typeof cr.criterion === "number" ? cr.criterion : 0,
+                passed: typeof cr.passed === "boolean" ? cr.passed : false,
+                notes: typeof cr.notes === "string" ? cr.notes : "",
+            }))
+            : [],
+        issues: Array.isArray(obj.issues)
+            ? obj.issues.map((i) => normalizeIssue(i, "blocking"))
+            : [],
+        suggestions: Array.isArray(obj.suggestions)
+            ? obj.suggestions.map((s) => normalizeIssue(s, "suggestion"))
+            : [],
+    };
+};
+// Find the end index of a balanced JSON object starting at position 0 in `text`.
+// Returns the index of the closing brace, or -1 if no balanced pair is found.
+const findBalancedBrace = (text) => {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let j = 0; j < text.length; j++) {
+        const ch = text[j];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === "\\") {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === "{")
+            depth++;
+        if (ch === "}") {
+            depth--;
+            if (depth === 0)
+                return j;
+        }
+    }
+    return -1;
+};
+// Try to parse a JSON object starting at `text` as a ReviewVerdict.
+// First tries the full slice, then tries balanced brace extraction.
+const tryExtractVerdictAt = (text) => {
+    try {
+        return tryParseVerdict(JSON.parse(text));
+    }
+    catch {
+        const end = findBalancedBrace(text);
+        if (end === -1)
+            return null;
+        try {
+            return tryParseVerdict(JSON.parse(text.slice(0, end + 1)));
+        }
+        catch {
+            return null;
+        }
+    }
+};
+const UNPARSEABLE_VERDICT = {
+    passed: false,
+    summary: "Could not parse reviewer verdict from output",
+    criteriaResults: [],
+    issues: [{ description: "Reviewer output did not contain a valid JSON verdict", severity: "blocking" }],
+    suggestions: [],
+};
+// Extract the JSON verdict block from reviewer's text output
+const parseVerdict = (text) => {
+    // Try extracting from fenced code block first
+    const fencedMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fencedMatch) {
+        const result = tryExtractVerdictAt(fencedMatch[1]);
+        if (result)
+            return result;
+    }
+    // Scan every { and try to parse a verdict from that position
+    for (let i = text.indexOf("{"); i !== -1; i = text.indexOf("{", i + 1)) {
+        const result = tryExtractVerdictAt(text.slice(i));
+        if (result)
+            return result;
+    }
+    return UNPARSEABLE_VERDICT;
+};
+exports.parseVerdict = parseVerdict;
+//# sourceMappingURL=feedback.parse.js.map

package/dist/stores/feedback.parse.js.map

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

package/dist/stores/feedback.verdict.d.ts

@@ -1,4 +1,2 @@
-import { ReviewIssue, ReviewVerdict } from "../types";
-export declare const parseVerdict: (text: string) => ReviewVerdict;
-export declare const formatIssue: (issue: ReviewIssue) => string;
-export declare const generateFeedback: (phaseId: string, verdict: ReviewVerdict) => string;
+export { parseVerdict } from "./feedback.parse";
+export { formatIssue, generateFeedback } from "./feedback.format";