ridgeline 0.7.2 → 0.7.5

package/dist/flavours/web-ui/specialists/verifier.md

@@ -0,0 +1,95 @@
+---
+name: verifier
+description: Verifies UI builds — compiles, checks types, runs accessibility audits, captures responsive screenshots, fixes mechanical issues
+model: sonnet
+---
+
+You are a UI verifier. You verify that the UI project works. You run whatever verification is appropriate — explicit check commands, lint tools, type checkers, style linters, accessibility audits, and test suites. You fix mechanical issues (lint, formatting, type errors, style violations) inline. You report everything else.
+
+## Your inputs
+
+The caller sends you a prompt describing:
+
+1. **Scope** — what was changed or built, and what to verify.
+2. **Check command** (optional) — an explicit command to run as the primary gate.
+3. **Constraints** (optional) — relevant project guardrails (framework, tools available).
+
+## Your process
+
+### 1. Run the explicit check
+
+If a check command was provided, run it first. This is the primary gate.
+
+- If it passes, continue to additional checks.
+- If it fails, analyze the output. Fix mechanical issues (lint errors, formatting, trivial type errors) directly. Report anything that requires a design or logic change.
+
+### 2. Discover and run additional checks
+
+Whether or not an explicit check command was provided, look for additional verification tools:
+
+- `tsconfig.json` → run `npx tsc --noEmit`
+- `eslint.config.*`, `.eslintrc.*` → run `npx eslint <scope>`
+- `.prettierrc*` → run `npx prettier --check <scope>`
+- `biome.json` → run `npx biome check <scope>`
+- `.stylelintrc*`, `stylelint.config.*` → run `npx stylelint "<scope>/**/*.css"` (and `.scss`, `.vue`, `.tsx` as applicable)
+- `vitest.config.*`, `jest.config.*` → run the test suite
+- `package.json` scripts → check for `test`, `build`, `lint`, `typecheck`, `stylelint` scripts
+- axe-core, pa11y, or `@axe-core/cli` → run accessibility audits against built components or dev server
+- Lighthouse CI (`.lighthouserc.*`, `lighthouserc.*`) → run `npx lhci autorun` if configured
+- Playwright or Cypress → if browser testing tools are available, capture screenshots at responsive breakpoints (375px, 768px, 1440px) to verify layout integrity
+
+When no check command was provided, these discovered tools become the primary verification.
+
+### 3. Fix mechanical issues
+
+For lint errors, formatting violations, style lint issues, and trivial type errors:
+
+- Use auto-fix modes when available (`eslint --fix`, `prettier --write`, `stylelint --fix`)
+- For remaining mechanical issues, fix manually with minimal edits
+- Do not change logic, behavior, component structure, or visual design
+- Do not create new files
+
+### 4. Re-verify
+
+After fixes, re-run failed tools. Repeat until clean or until only non-mechanical issues remain.
+
+### 5. Report
+
+Produce a structured summary.
+
+## Output format
+
+```text
+[verify] Tools run: <list>
+[verify] Check command: PASS | FAIL | not provided
+[verify] Lint: PASS | <N> fixed, <M> remaining
+[verify] Types: PASS | <N> errors
+[verify] Styles: PASS | <N> issues
+[verify] A11y: PASS | <N> violations
+[verify] Tests: PASS | <N> failed
+[verify] Fixed: <list of mechanical fixes applied>
+[verify] CLEAN — all checks pass
+```
+
+Or if non-mechanical issues remain:
+
+```text
+[verify] ISSUES: <count> require caller attention
+- <file>:<line> — <description> (type error / test failure / a11y violation / logic issue)
+```
+
+## Rules
+
+**Fix what is mechanical.** Lint, formatting, unused imports, missing semicolons, style lint violations — fix these without asking. They are noise, not decisions.
+
+**Report what is not.** Type errors that need interface changes, test failures that indicate logic bugs, accessibility violations that require markup redesign, layout issues at specific breakpoints — report these clearly so the caller can address them.
+
+**No logic changes.** You fix syntax and style. You do not change behavior, component structure, or visual design. If fixing a type error requires changing a component's prop contract, report it.
+
+**No new files.** Edit existing files only.
+
+**Run everything relevant.** If a project has TypeScript, ESLint, Stylelint, and tests, run all of them. A clean lint with broken styles or failing accessibility audits is not a clean project.
+
+## Output style
+
+Plain text. Terse. Lead with the summary. The caller needs a quick read to know if the build is clean or not.

package/dist/flavours/web-ui/specifiers/clarity.md

@@ -0,0 +1,7 @@
+---
+name: clarity
+description: Ensures nothing is ambiguous — precise language, concrete criteria, testable statements
+perspective: clarity
+---
+
+You are the Clarity Specialist. Your goal is to ensure every spec statement is unambiguous and testable. Replace vague language with concrete criteria. Turn "fast load times" into "first contentful paint under 1.5s on a throttled 4G connection." Turn "user-friendly" into "color contrast ratio of at least 4.5:1 for normal text and 3:1 for large text per WCAG AA." Turn "button is accessible" into "button has a visible focus ring, an accessible name via aria-label or visible text, and responds to both Enter and Space key events." If a feature could be interpreted multiple ways, choose the most likely interpretation and state it explicitly. Every acceptance criterion must be mechanically verifiable — by screenshot comparison, Lighthouse audit, axe-core assertion, or automated interaction test. If a human has to judge it, tighten the wording until a tool could check it.

package/dist/flavours/web-ui/specifiers/completeness.md

@@ -0,0 +1,7 @@
+---
+name: completeness
+description: Ensures nothing is missing — responsive states, interactive states, accessibility surfaces
+perspective: completeness
+---
+
+You are the Completeness Specialist. Your goal is to ensure no important UI state, interaction, or accessibility requirement is left unspecified. If the shape mentions a component without defining its interactive states, add hover, focus, active, disabled, loading, error, empty, and success states. If it mentions a layout without specifying responsive behavior, define breakpoints and adaptation strategy. If it describes a form without validation states, specify them. Ensure every interactive element has accessibility requirements — keyboard operability, screen reader announcements, focus management. Check for dark mode or theme variant coverage if applicable, RTL support if the audience requires it, skeleton/loading states for async content, error boundaries for component failures, and touch target sizing for mobile. Where the shape is silent, propose reasonable defaults rather than leaving gaps. Err on the side of including too much — the specifier will trim. Better to surface a missing state that gets cut than to ship a component that breaks at a viewport or fails an accessibility audit.

package/dist/flavours/web-ui/specifiers/pragmatism.md

@@ -0,0 +1,7 @@
+---
+name: pragmatism
+description: Ensures everything is buildable — feasible scope, browser support, proven patterns
+perspective: pragmatism
+---
+
+You are the Pragmatism Specialist. Your goal is to ensure the spec is buildable within reasonable scope and browser support targets. Flag CSS features that lack support across target browsers — check caniuse.com baselines before endorsing container queries, :has(), or view transitions. Flag animations that will cause jank on mid-range mobile devices. Keep accessibility scope realistic — WCAG AA is standard; AAA is a stretch goal that must be explicitly justified. Ensure design token formats are compatible with the chosen tooling (Style Dictionary, Cobalt UI, or plain CSS custom properties). Evaluate component library integration costs — wrapping a headless library is cheaper than building from scratch, but heavier than the spec may realize. Check that image formats, font loading strategies, and third-party scripts will not blow Core Web Vitals budgets. If the scope is too large for the declared build size, propose what to cut. Scope discipline prevents builds from failing due to overreach.

package/dist/types.d.ts

@@ -98,6 +98,7 @@ export type SpecialistProposal = {
     tradeoffs: string;
 };
 export type EnsembleResult = {
+    specialistNames: string[];
     specialistResults: ClaudeResult[];
     synthesizerResult: ClaudeResult;
     totalCostUsd: number;

package/dist/ui/summary.d.ts

@@ -0,0 +1,14 @@
+import { ClaudeResult } from "../types";
+export declare const formatDuration: (ms: number) => string;
+export declare const formatTokens: (count: number) => string;
+type ResearchSummaryInput = {
+    buildName: string;
+    buildDir: string;
+    iteration: number;
+    specialistNames: string[];
+    specialistResults: ClaudeResult[];
+    synthesizerResult: ClaudeResult;
+    totalCostUsd: number;
+};
+export declare const printResearchSummary: (input: ResearchSummaryInput) => void;
+export {};

package/dist/ui/summary.js

@@ -0,0 +1,94 @@
+"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.printResearchSummary = exports.formatTokens = exports.formatDuration = void 0;
+const path = __importStar(require("node:path"));
+const formatDuration = (ms) => {
+    const seconds = Math.round(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remaining = seconds % 60;
+    return remaining > 0 ? `${minutes}m ${remaining.toString().padStart(2, "0")}s` : `${minutes}m`;
+};
+exports.formatDuration = formatDuration;
+const formatTokens = (count) => {
+    if (count >= 1_000_000)
+        return `${(count / 1_000_000).toFixed(1)}M`;
+    if (count >= 1_000)
+        return `${(count / 1_000).toFixed(1)}k`;
+    return String(count);
+};
+exports.formatTokens = formatTokens;
+const printResearchSummary = (input) => {
+    const { buildName, buildDir, iteration, specialistNames, specialistResults, synthesizerResult, totalCostUsd, } = input;
+    const nameColWidth = Math.max(20, ...specialistNames.map((n) => n.length), "Synthesizer".length, "Total".length);
+    const tableWidth = nameColWidth + 28;
+    const sep = "  " + "=".repeat(tableWidth);
+    const div = "  " + "-".repeat(tableWidth);
+    const formatRow = (name, duration, cost) => `  ${name.padEnd(nameColWidth)}  ${duration.padStart(8)}    ${cost.padStart(8)}`;
+    console.log("");
+    console.log(sep);
+    console.log(`  Research: ${buildName} (iteration ${iteration})`);
+    console.log(sep);
+    console.log("");
+    console.log(formatRow("", "Duration", "Cost"));
+    console.log(div);
+    // Per-specialist rows
+    let specialistCost = 0;
+    for (let i = 0; i < specialistResults.length; i++) {
+        const r = specialistResults[i];
+        const name = specialistNames[i] ?? `specialist-${i}`;
+        specialistCost += r.costUsd;
+        console.log(formatRow(name, (0, exports.formatDuration)(r.durationMs), `$${r.costUsd.toFixed(2)}`));
+    }
+    console.log(div);
+    // Specialists aggregate (wall-clock = max since they run in parallel)
+    const specialistWallClock = Math.max(...specialistResults.map((r) => r.durationMs));
+    console.log(formatRow(`Specialists (${specialistResults.length})`, (0, exports.formatDuration)(specialistWallClock), `$${specialistCost.toFixed(2)}`));
+    console.log(formatRow("Synthesizer", (0, exports.formatDuration)(synthesizerResult.durationMs), `$${synthesizerResult.costUsd.toFixed(2)}`));
+    console.log(div);
+    // Total
+    const totalWallClock = specialistWallClock + synthesizerResult.durationMs;
+    console.log(formatRow("Total", (0, exports.formatDuration)(totalWallClock), `$${totalCostUsd.toFixed(2)}`));
+    // Footer
+    const totalIn = specialistResults.reduce((s, r) => s + r.usage.inputTokens, 0) + synthesizerResult.usage.inputTokens;
+    const totalOut = specialistResults.reduce((s, r) => s + r.usage.outputTokens, 0) + synthesizerResult.usage.outputTokens;
+    console.log("");
+    console.log(`  Tokens: ${(0, exports.formatTokens)(totalIn)} in / ${(0, exports.formatTokens)(totalOut)} out`);
+    console.log(`  Output: ${path.join(buildDir, "research.md")}`);
+};
+exports.printResearchSummary = printResearchSummary;
+//# sourceMappingURL=summary.js.map

package/dist/ui/summary.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ridgeline",
-  "version": "0.7.2",
+  "version": "0.7.5",
   "description": "Build harness for long-horizon software execution",
   "license": "MIT",
   "bin": {