ridgeline 0.7.21 → 0.8.2

package/dist/engine/index.js

@@ -1,14 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDisplayCallbacks = exports.extractResult = exports.createStreamHandler = exports.parseStreamLine = exports.invokeReviewer = exports.cleanupPluginDirs = exports.discoverPluginDirs = exports.invokePlanner = exports.runPhase = exports.invokeClaude = exports.invokeBuilder = exports.resolveFlavour = exports.buildAgentRegistry = exports.buildAgentsFlag = exports.discoverAgentsInDir = exports.parseFrontmatter = void 0;
+exports.createDisplayCallbacks = exports.extractResult = exports.createStreamHandler = exports.parseStreamLine = exports.invokeReviewer = exports.cleanupPluginDirs = exports.discoverPluginDirs = exports.invokePlanner = exports.runPhase = exports.invokeClaude = exports.invokeBuilder = exports.buildAgentRegistry = exports.buildAgentsFlag = exports.discoverAgentsInDir = exports.parseFrontmatter = void 0;
 var agent_scan_1 = require("./discovery/agent.scan");
 Object.defineProperty(exports, "parseFrontmatter", { enumerable: true, get: function () { return agent_scan_1.parseFrontmatter; } });
 Object.defineProperty(exports, "discoverAgentsInDir", { enumerable: true, get: function () { return agent_scan_1.discoverAgentsInDir; } });
 Object.defineProperty(exports, "buildAgentsFlag", { enumerable: true, get: function () { return agent_scan_1.buildAgentsFlag; } });
 var agent_registry_1 = require("./discovery/agent.registry");
 Object.defineProperty(exports, "buildAgentRegistry", { enumerable: true, get: function () { return agent_registry_1.buildAgentRegistry; } });
-var flavour_resolve_1 = require("./discovery/flavour.resolve");
-Object.defineProperty(exports, "resolveFlavour", { enumerable: true, get: function () { return flavour_resolve_1.resolveFlavour; } });
 var build_exec_1 = require("./pipeline/build.exec");
 Object.defineProperty(exports, "invokeBuilder", { enumerable: true, get: function () { return build_exec_1.invokeBuilder; } });
 var claude_exec_1 = require("./claude/claude.exec");

package/dist/engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":";;;AAAA,qDAK+B;AAH7B,8GAAA,gBAAgB,OAAA;AAChB,iHAAA,mBAAmB,OAAA;AACnB,6GAAA,eAAe,OAAA;AAEjB,6DAAmF;AAAtD,oHAAA,kBAAkB,OAAA;AAC/C,+DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,oDAAqD;AAA5C,2GAAA,aAAa,OAAA;AACtB,oDAAuE;AAA1C,2GAAA,YAAY,OAAA;AACzC,4DAAoD;AAA3C,0GAAA,QAAQ,OAAA;AACjB,0DAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,uDAGgC;AAF9B,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AAEnB,sDAAuD;AAA9C,6GAAA,cAAc,OAAA;AACvB,sDAG8B;AAF5B,+GAAA,eAAe,OAAA;AACf,mHAAA,mBAAmB,OAAA;AAErB,wDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,0DAAgE;AAAvD,wHAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":";;;AAAA,qDAK+B;AAH7B,8GAAA,gBAAgB,OAAA;AAChB,iHAAA,mBAAmB,OAAA;AACnB,6GAAA,eAAe,OAAA;AAEjB,6DAAmF;AAAtD,oHAAA,kBAAkB,OAAA;AAC/C,oDAAqD;AAA5C,2GAAA,aAAa,OAAA;AACtB,oDAAuE;AAA1C,2GAAA,YAAY,OAAA;AACzC,4DAAoD;AAA3C,0GAAA,QAAQ,OAAA;AACjB,0DAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,uDAGgC;AAF9B,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AAEnB,sDAAuD;AAA9C,6GAAA,cAAc,OAAA;AACvB,sDAG8B;AAF5B,+GAAA,eAAe,OAAA;AACf,mHAAA,mBAAmB,OAAA;AAErB,wDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,0DAAgE;AAAvD,wHAAA,sBAAsB,OAAA"}

package/dist/engine/pipeline/build.exec.js

@@ -41,10 +41,22 @@ const stream_display_1 = require("../claude/stream.display");
 const handoff_1 = require("../../stores/handoff");
 const plugin_scan_1 = require("../discovery/plugin.scan");
 const agent_registry_1 = require("../discovery/agent.registry");
-const flavour_resolve_1 = require("../discovery/flavour.resolve");
 const pipeline_shared_1 = require("./pipeline.shared");
 const prompt_document_1 = require("./prompt.document");
-const assembleUserPrompt = (config, phase, feedbackPath) => {
+/**
+ * Resolve the file path the builder should append handoff notes to.
+ * In the sequential path (cwd unset), this is the canonical handoff.md.
+ * In the wave path (cwd is a worktree), this is a per-phase fragment
+ * inside the worktree's buildDir, so concurrent phases never collide
+ * on the same file at git-merge time. Fragments are stitched back into
+ * the canonical handoff.md by consolidateHandoffs after the wave merges.
+ */
+const resolveHandoffTarget = (config, phase, cwd) => {
+    if (!cwd)
+        return path.join(config.buildDir, "handoff.md");
+    return path.join(cwd, ".ridgeline", "builds", config.buildName, `handoff-${phase.id}.md`);
+};
+const assembleUserPrompt = (config, phase, feedbackPath, cwd) => {
     const doc = new prompt_document_1.PromptDocument();
     (0, pipeline_shared_1.appendConstraintsAndTaste)(doc, config);
     (0, pipeline_shared_1.appendDesign)(doc, config);
@@ -65,8 +77,9 @@ const assembleUserPrompt = (config, phase, feedbackPath) => {
     if (config.checkCommand) {
         doc.instruction("Check Command", `Run this command after making changes to verify correctness:\n\n\`\`\`\n${config.checkCommand}\n\`\`\``);
     }
-    // Handoff file path for the builder to append to
-    doc.instruction("Handoff File", `Append your handoff notes to: ${path.join(config.buildDir, "handoff.md")}`);
+    // Handoff file path for the builder to append to. Wave runs use a
+    // per-phase fragment so parallel phases don't collide at merge time.
+    doc.instruction("Handoff File", `Append your handoff notes to: ${resolveHandoffTarget(config, phase, cwd)}`);
     if (feedbackPath && fs.existsSync(feedbackPath)) {
         doc.data("Reviewer Feedback (RETRY)", "This is a retry. The reviewer found issues with your previous attempt.\n" +
             "Focus on fixing these issues. Do not redo work that already passed.\n\n" +
@@ -75,9 +88,9 @@ const assembleUserPrompt = (config, phase, feedbackPath) => {
     return doc.render();
 };
 const invokeBuilder = async (config, phase, feedbackPath, cwd) => {
-    const registry = (0, agent_registry_1.buildAgentRegistry)((0, flavour_resolve_1.resolveFlavour)(config.flavour));
+    const registry = (0, agent_registry_1.buildAgentRegistry)();
     const systemPrompt = registry.getCorePrompt("builder.md");
-    const userPrompt = assembleUserPrompt(config, phase, feedbackPath);
+    const userPrompt = assembleUserPrompt(config, phase, feedbackPath, cwd);
     const { onStdout, flush } = (0, stream_display_1.createDisplayCallbacks)({ projectRoot: cwd ?? process.cwd() });
     const prepared = (0, pipeline_shared_1.prepareAgentsAndPlugins)(config);
     try {

package/dist/engine/pipeline/build.exec.js.map

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

package/dist/engine/pipeline/ensemble.exec.d.ts

@@ -1,4 +1,4 @@
-import { RidgelineConfig, PhaseInfo, ClaudeResult, EnsembleResult } from "../../types";
+import { RidgelineConfig, PhaseInfo, ClaudeResult, EnsembleResult, SpecialistStage } from "../../types";
 import { SpecialistDef } from "../discovery/agent.registry";
 /**
  * Attempt to extract a JSON object from a string that may be wrapped in
@@ -37,8 +37,13 @@ type EnsembleConfig<TDraft> = {
     specialistTools?: string[];
     /** Model name for invokeClaude */
     model: string;
-    /** Timeout in minutes */
+    /** Synthesizer timeout in minutes. */
     timeoutMinutes: number;
+    /**
+     * Per-specialist call timeout in seconds. Defaults to 180. When `isStructured`
+     * is false (research), caller may override with a longer value.
+     */
+    specialistTimeoutSeconds?: number;
     /** Budget cap (null = unlimited) */
     maxBudgetUsd: number | null;
     /** Optional post-synthesis verification. Throw to signal failure. */
@@ -53,7 +58,6 @@ type EnsembleConfig<TDraft> = {
      * Enable two-round ensemble: after round 1 (independent drafts), each specialist
      * sees all other drafts and produces annotations (concerns, agreements, gaps).
      * The synthesizer then receives both drafts and annotations.
-     * Default: false (opt-in, because it roughly doubles specialist cost).
      */
     isTwoRound?: boolean;
     /** Build the annotation prompt for round 2, given other drafts. Requires isTwoRound. */
@@ -61,8 +65,42 @@ type EnsembleConfig<TDraft> = {
         perspective: string;
         draft: TDraft;
     }[]) => string;
+    /** Stage identifier for structured-verdict agreement detection. */
+    stage?: SpecialistStage;
+    /**
+     * Build directory used for trajectory logging. When absent, specialist
+     * failures and agreement skips are logged to stderr only.
+     */
+    buildDir?: string;
+    /**
+     * Extract the raw string used for skeleton parsing from a specialist's draft.
+     * Defaults to the ClaudeResult.result text.
+     */
+    skeletonSource?: (result: ClaudeResult, draft: TDraft) => string;
+    /**
+     * When all specialists' skeletons agree, produce the canonical artifact
+     * from the first specialist's draft and return a synthetic synthesizer
+     * result describing the skip. When absent, agreement detection is disabled.
+     */
+    onAgreementSkip?: (successful: {
+        perspective: string;
+        result: ClaudeResult;
+        draft: TDraft;
+    }[]) => Promise<ClaudeResult> | ClaudeResult;
 };
 export declare const invokeEnsemble: <TDraft>(config: EnsembleConfig<TDraft>) => Promise<EnsembleResult>;
+/**
+ * Cap a registered specialist list to the configured ensemble size.
+ * Default size: 2; thorough mode: 3.
+ */
+export declare const selectSpecialists: (all: SpecialistDef[], { isThorough }: {
+    isThorough: boolean;
+}) => SpecialistDef[];
+/**
+ * Append the audit note that marks an agreement-based synthesis skip.
+ * Idempotent when applied more than once to the same artifact.
+ */
+export declare const appendSkipAuditNote: (filepath: string, count: number, stage: SpecialistStage) => void;
 export declare const invokePlanner: (config: RidgelineConfig) => Promise<{
     result: ClaudeResult;
     phases: PhaseInfo[];