ridgeline 0.7.5 → 0.7.11

package/README.md

@@ -42,6 +42,8 @@ tracks costs, and supports resumable execution when things go wrong.
 npm install -g ridgeline
 ```
 
+**Platform:** macOS and Linux. Windows is not supported.
+
 Ridgeline requires the [Claude CLI](https://docs.anthropic.com/en/docs/claude-code)
 to be installed and authenticated.
 

package/dist/agents/core/designer.md

@@ -53,12 +53,22 @@ Round 1 — Art Direction:
 - Art style: pixel art, vector, 3D, hand-drawn, realistic
 - Color palette: mood, saturation level, palette constraints
 - Asset dimensions: sprite sizes, texture resolutions, canvas size
+- Shape language: proportions (chunky/slim), corners (rounded/sharp), detail level
+- Rendering: pixel scale, scaling mode (nearest/bilinear), canvas size
 
 Round 2 — UI & HUD:
 
 - HUD/overlay style: transparency, position, font choices
 - Menu design: navigation patterns, transition styles
 - In-game text: dialogue boxes, tooltips, damage numbers
+- Layout regions: where health, score, inventory, and action buttons go
+- Mood: overall atmosphere and tone in a brief phrase
+
+Round 3 — Asset Integration (when asset catalog data is in context):
+
+- Asset manifest review: confirm discovered assets match creative intent
+- Background treatment: mood, parallax, scroll behavior for each background
+- Asset loading strategy: preload vs lazy, atlas format, base path
 
 **For print-layout projects:**
 
@@ -129,3 +139,11 @@ The format is flexible — brand guidelines, informal notes, formal style guides
 **Respect existing design.md.** If one exists, read it as starting context. Offer to refine or extend, don't start from scratch unless asked.
 
 **Stay in design territory.** Don't ask about code architecture, error handling, or implementation details. Those belong to the shaper and specifier.
+
+**When asset catalog data is present in context:**
+
+- Propose palette, style, resolution, and scaling defaults derived from the catalog's visual identity analysis. Include these as `suggestedAnswer` values.
+- Present the asset manifest summary for user confirmation.
+- Use layout region data (if available) to propose HUD/menu arrangements.
+- Flag any catalog warnings about palette mismatches for user review.
+- Cover asset loading strategy (preload/lazy, format, base path) in your questions.

package/dist/agents/core/planner.md

@@ -65,6 +65,38 @@ Every phase file must follow this structure exactly:
 <Relevant sections of spec.md for this phase, quoted or summarized.>
 ```
 
+## Phase Dependencies (Parallel Execution)
+
+Phases can declare dependencies to enable parallel execution. When a phase depends only on a subset of prior phases (not the immediately preceding one), add YAML frontmatter:
+
+```markdown
+---
+depends_on: [01-scaffold]
+---
+# Phase 3: API Endpoints
+...
+```
+
+**Rules for dependencies:**
+
+- Phases without frontmatter automatically depend on the immediately preceding phase (sequential execution).
+- A phase can only depend on phases with a lower index number.
+- If a phase reads or modifies files created by another phase, it must depend on that phase.
+- Phase 01 never has dependencies (it is the root).
+- Use dependencies to enable parallelism when phases work on independent parts of the codebase.
+- When in doubt, omit the frontmatter. False parallelism is worse than false sequentiality.
+
+**Example: fan-out pattern**
+
+```text
+01-scaffold       (no deps — root)
+02-api            depends_on: [01-scaffold]
+03-ui             depends_on: [01-scaffold]
+04-integration    depends_on: [02-api, 03-ui]
+```
+
+Phases 02 and 03 run in parallel after 01 completes. Phase 04 waits for both.
+
 ## Rules
 
 **No implementation details.** Do not specify creation order, internal structure, sub-agent assignments, implementation patterns, or approach. The builder decides all of this. You describe the destination, not the route.

package/dist/agents/core/retrospective.md

@@ -0,0 +1,64 @@
+---
+name: retrospective
+description: Analyzes a completed build to extract learnings, patterns, and recommendations for future builds
+model: opus
+---
+
+You are a build retrospective analyst. After a build completes, you analyze the trajectory, budget, feedback files, and final state to extract actionable learnings.
+
+## Your inputs
+
+These are injected into your context:
+
+1. **trajectory.jsonl** — chronological event log of the entire build (plan, build, review, retry events with durations and costs)
+2. **budget.json** — per-phase, per-role cost breakdown
+3. **Feedback files** — reviewer verdicts and feedback from any retried phases
+4. **state.json** — final build state with phase statuses, durations, and retry counts
+
+## Your process
+
+### 1. Analyze the build trajectory
+
+- Which phases completed cleanly on the first attempt?
+- Which phases required retries? What were the reviewer's objections?
+- Where was the most time and money spent?
+- Were there any patterns in failures (e.g., the same type of issue recurring)?
+
+### 2. Extract learnings
+
+Produce a structured retrospective in the following format. Be specific — name files, patterns, and concrete observations. Avoid generic advice.
+
+```markdown
+## Build: {build-name} ({date})
+
+### What Worked
+- Specific things that went well (clean passes, efficient phases)
+
+### What Didn't
+- Specific failures, retries, and their root causes
+
+### Patterns to Repeat
+- Concrete patterns worth carrying forward (spec structures, constraint phrasings, phase granularity choices)
+
+### Patterns to Avoid
+- Anti-patterns observed (overly broad phases, missing constraints, spec ambiguities)
+
+### Cost Analysis
+- Total cost and duration
+- Most expensive phases and why
+- Efficiency observations
+
+### Recommendations for Next Build
+- Specific, actionable suggestions for improving spec, constraints, or phase structure
+```
+
+### 3. Write the output
+
+Append your retrospective to the learnings file. Do NOT overwrite previous entries — each build's learnings accumulate.
+
+## Rules
+
+- Be concrete and specific, not generic. "Phase 03 failed because the spec didn't mention auth middleware" is useful. "Consider being more specific in specs" is not.
+- Focus on what the build artifacts reveal, not hypotheticals.
+- Keep each section to 3-5 bullet points. Quality over quantity.
+- If the build completed cleanly with no retries, say so — a clean build is still worth noting.

package/dist/catalog/build-catalog.d.ts

@@ -0,0 +1,21 @@
+import { AssetCatalog, CatalogOptions } from "./types";
+export type CatalogResult = {
+    catalog: AssetCatalog;
+    stats: {
+        total: number;
+        added: number;
+        updated: number;
+        unchanged: number;
+        pruned: number;
+        classified: number;
+    };
+    /** Files in auto-describe categories that need vision enrichment. */
+    needsVisionDescribe: string[];
+};
+type BuildCatalogOpts = Pick<CatalogOptions, "isForce" | "isClassify" | "model" | "timeout">;
+/**
+ * Build or update the asset catalog.
+ * Handles all media types. Vision enrichment and sprite packing are handled separately.
+ */
+export declare const buildCatalog: (assetDir: string, buildDir: string, opts: BuildCatalogOpts) => Promise<CatalogResult>;
+export {};

package/dist/catalog/build-catalog.js

@@ -0,0 +1,305 @@
+"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.buildCatalog = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const parse_conventions_1 = require("./parse-conventions");
+const extract_metadata_1 = require("./extract-metadata");
+const classify_1 = require("./classify");
+/** Map file extensions to media types. */
+const MEDIA_EXTENSIONS = {
+    // images
+    ".png": "image", ".jpg": "image", ".jpeg": "image",
+    ".gif": "image", ".webp": "image", ".svg": "image", ".avif": "image",
+    // audio
+    ".mp3": "audio", ".wav": "audio", ".ogg": "audio",
+    ".flac": "audio", ".aac": "audio", ".m4a": "audio",
+    // video
+    ".mp4": "video", ".webm": "video", ".mov": "video", ".avi": "video",
+    // text
+    ".txt": "text", ".json": "text", ".csv": "text",
+    ".md": "text", ".yaml": "text", ".yml": "text",
+};
+/** Detect media type from file extension. */
+const detectMediaType = (filePath) => MEDIA_EXTENSIONS[path.extname(filePath).toLowerCase()] ?? null;
+/** Recursively walk a directory tree and return all asset file paths (relative to root). */
+const walkAssets = (dir, root) => {
+    const base = root ?? dir;
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...walkAssets(fullPath, base));
+        }
+        else if (detectMediaType(entry.name) !== null) {
+            results.push(path.relative(base, fullPath));
+        }
+    }
+    return results;
+};
+/** Load existing catalog from disk, if present. */
+const loadExistingCatalog = (catalogPath) => {
+    if (!fs.existsSync(catalogPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(catalogPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+};
+/** Build a lookup map from an existing catalog for incremental updates. */
+const buildHashIndex = (catalog) => {
+    const index = new Map();
+    if (!catalog)
+        return index;
+    for (const entry of catalog.assets) {
+        index.set(entry.file, entry);
+    }
+    return index;
+};
+/** Detect the most common resolution among square or nearly-square image assets. */
+const detectResolution = (assets) => {
+    const sizes = new Map();
+    for (const a of assets) {
+        if (a.mediaType !== "image")
+            continue;
+        if (a.isSpritesheet && a.frameSize) {
+            const key = `${a.frameSize.w}x${a.frameSize.h}`;
+            sizes.set(key, (sizes.get(key) ?? 0) + 1);
+        }
+        else if (a.width && a.height && a.width === a.height && a.width <= 256) {
+            const key = `${a.width}x${a.height}`;
+            sizes.set(key, (sizes.get(key) ?? 0) + 1);
+        }
+    }
+    if (sizes.size === 0)
+        return null;
+    return [...sizes.entries()].sort((a, b) => b[1] - a[1])[0][0];
+};
+/** Build aggregate palette from all image assets (top 8 most frequent colours). */
+const detectPalette = (assets) => {
+    const freq = new Map();
+    for (const a of assets) {
+        if (!a.palette)
+            continue;
+        for (const c of a.palette) {
+            freq.set(c, (freq.get(c) ?? 0) + 1);
+        }
+    }
+    return [...freq.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8)
+        .map(([colour]) => colour);
+};
+/** Detect visual style from image asset properties. */
+const detectStyle = (assets) => {
+    const imageAssets = assets.filter((a) => a.mediaType === "image");
+    if (imageAssets.length === 0)
+        return null;
+    const smallAssets = imageAssets.filter((a) => {
+        const size = a.isSpritesheet && a.frameSize
+            ? Math.max(a.frameSize.w, a.frameSize.h)
+            : Math.max(a.width ?? 0, a.height ?? 0);
+        return size <= 128;
+    });
+    if (smallAssets.length > imageAssets.length * 0.6)
+        return "pixel-art";
+    const svgCount = imageAssets.filter((a) => a.format === "svg").length;
+    if (svgCount > imageAssets.length * 0.5)
+        return "vector";
+    return null;
+};
+/** Derive aggregate visual identity from all cataloged assets. */
+const deriveVisualIdentity = (assets) => {
+    const style = detectStyle(assets);
+    return {
+        detectedStyle: style,
+        detectedPalette: detectPalette(assets),
+        detectedResolution: detectResolution(assets),
+        detectedScaling: style === "pixel-art" ? "nearest" : null,
+    };
+};
+/** Compare detected palette against design.md palette and produce warnings. */
+const checkPaletteMismatches = (assets, buildDir, ridgelineDir) => {
+    const warnings = [];
+    const designPaths = [
+        path.join(buildDir, "design.md"),
+        path.join(ridgelineDir, "design.md"),
+    ];
+    let designContent = null;
+    for (const p of designPaths) {
+        if (fs.existsSync(p)) {
+            designContent = fs.readFileSync(p, "utf-8");
+            break;
+        }
+    }
+    if (!designContent)
+        return warnings;
+    const hexPattern = /#[0-9a-fA-F]{6}/g;
+    const designColours = new Set([...designContent.matchAll(hexPattern)].map((m) => m[0].toLowerCase()));
+    if (designColours.size === 0)
+        return warnings;
+    for (const asset of assets) {
+        if (!asset.palette)
+            continue;
+        const offPalette = asset.palette.filter((c) => !designColours.has(c.toLowerCase()));
+        if (offPalette.length > 0) {
+            warnings.push(`${asset.file} uses colours (${offPalette.join(", ")}) not found in design.md palette. This may be intentional.`);
+        }
+    }
+    return warnings;
+};
+/**
+ * Build or update the asset catalog.
+ * Handles all media types. Vision enrichment and sprite packing are handled separately.
+ */
+const buildCatalog = async (assetDir, buildDir, opts) => {
+    const ridgelineDir = path.join(process.cwd(), ".ridgeline");
+    const catalogPath = path.join(buildDir, "asset-catalog.json");
+    const existing = loadExistingCatalog(catalogPath);
+    const hashIndex = buildHashIndex(existing);
+    const assetFiles = walkAssets(assetDir);
+    const existingFiles = new Set(hashIndex.keys());
+    const assets = [];
+    const needsVisionDescribe = [];
+    let added = 0;
+    let updated = 0;
+    let unchanged = 0;
+    let classified = 0;
+    const timeoutMs = opts.timeout * 60 * 1000;
+    const totalFiles = assetFiles.length;
+    let processedCount = 0;
+    for (const relPath of assetFiles) {
+        const absPath = path.join(assetDir, relPath);
+        const hash = (0, extract_metadata_1.computeContentHash)(absPath);
+        const prev = hashIndex.get(relPath);
+        existingFiles.delete(relPath);
+        // Skip unchanged files (unless --force)
+        if (!opts.isForce && prev && prev.hash === hash) {
+            assets.push(prev);
+            unchanged++;
+            // Still track if auto-describe category needs vision
+            if (prev.mediaType === "image") {
+                const conv = (0, parse_conventions_1.parseConventions)(relPath);
+                if (parse_conventions_1.AUTO_DESCRIBE_CATEGORIES.has(conv.category) && !prev.description) {
+                    needsVisionDescribe.push(relPath);
+                }
+            }
+            continue;
+        }
+        processedCount++;
+        const mediaType = detectMediaType(relPath);
+        const conventions = (0, parse_conventions_1.parseConventions)(relPath);
+        const basic = (0, extract_metadata_1.extractBasicMetadata)(absPath);
+        // Build the entry — image-specific metadata only for images
+        const entry = {
+            file: relPath,
+            hash,
+            mediaType,
+            category: conventions.category,
+            name: conventions.name,
+            subject: conventions.subject,
+            state: conventions.state,
+            fileSizeBytes: basic.fileSizeBytes,
+            extension: basic.extension,
+        };
+        if (mediaType === "image") {
+            const meta = await (0, extract_metadata_1.extractImageMetadata)(absPath);
+            const palette = await (0, extract_metadata_1.extractPalette)(absPath);
+            const spritesheet = (0, extract_metadata_1.detectSpritesheet)(meta.width, meta.height);
+            const isTileable = await (0, extract_metadata_1.detectTileable)(absPath, meta.width, meta.height);
+            const defaults = (0, parse_conventions_1.inferDefaults)(conventions.category);
+            entry.width = meta.width;
+            entry.height = meta.height;
+            entry.format = meta.format;
+            entry.hasAlpha = meta.hasAlpha;
+            entry.channels = meta.channels;
+            entry.dominantColour = palette.dominantColour;
+            entry.palette = palette.palette;
+            entry.isSpritesheet = spritesheet.isSpritesheet;
+            entry.frameCount = spritesheet.frameCount;
+            entry.frameSize = spritesheet.frameSize;
+            entry.frameDirection = spritesheet.frameDirection;
+            entry.suggestedAnchor = defaults.anchor;
+            entry.suggestedZLayer = defaults.zLayer;
+            entry.isTileable = isTileable;
+        }
+        // Classify uncategorized files when --classify is set
+        if (conventions.category === "uncategorized" && opts.isClassify) {
+            process.stderr.write(`\x1b[90m  Classifying ${relPath} (${processedCount}/${totalFiles})...\x1b[0m\n`);
+            const result = (0, classify_1.classifyByHeuristics)(relPath, basic.extension, mediaType)
+                ?? (0, classify_1.classifyWithAI)(absPath, relPath, basic.extension, mediaType, opts.model, timeoutMs);
+            entry.category = result.category;
+            entry.isClassified = true;
+            entry.classificationConfidence = result.confidence;
+            classified++;
+            // Update anchor/zLayer defaults based on new category
+            if (mediaType === "image") {
+                const defaults = (0, parse_conventions_1.inferDefaults)(entry.category);
+                entry.suggestedAnchor = defaults.anchor;
+                entry.suggestedZLayer = defaults.zLayer;
+            }
+        }
+        assets.push(entry);
+        if (mediaType === "image" && parse_conventions_1.AUTO_DESCRIBE_CATEGORIES.has(entry.category)) {
+            needsVisionDescribe.push(relPath);
+        }
+        if (prev) {
+            updated++;
+        }
+        else {
+            added++;
+        }
+    }
+    // Remaining entries in existingFiles are pruned (files removed from disk)
+    const pruned = existingFiles.size;
+    const catalog = {
+        generatedAt: new Date().toISOString(),
+        assetDir,
+        isDescribed: existing?.isDescribed ?? false,
+        visualIdentity: deriveVisualIdentity(assets),
+        warnings: checkPaletteMismatches(assets, buildDir, ridgelineDir),
+        assets,
+    };
+    return {
+        catalog,
+        stats: { total: assets.length, added, updated, unchanged, pruned, classified },
+        needsVisionDescribe,
+    };
+};
+exports.buildCatalog = buildCatalog;
+//# sourceMappingURL=build-catalog.js.map

package/dist/catalog/build-catalog.js.map

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

package/dist/catalog/classify.d.ts

@@ -0,0 +1,16 @@
+import { MediaType } from "./types";
+type ClassificationResult = {
+    category: string;
+    confidence: "high" | "medium" | "low";
+};
+/**
+ * Attempt to classify a file using filename pattern matching.
+ * Returns null if no heuristic matches confidently.
+ */
+export declare const classifyByHeuristics: (filename: string, ext: string, mediaType: MediaType) => ClassificationResult | null;
+/**
+ * Classify a single file using AI.
+ * Dispatches to vision (images) or text-only (audio/video/text).
+ */
+export declare const classifyWithAI: (absPath: string, filename: string, ext: string, mediaType: MediaType, model: string, timeoutMs: number) => ClassificationResult;
+export {};