ridgeline 0.5.9 → 0.7.2

package/dist/engine/pipeline/pipeline.shared.js

@@ -33,8 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.commonInvokeOptions = exports.appendConstraintsAndTaste = exports.formatProposalHeading = exports.createStderrHandler = exports.prepareAgentsAndPlugins = void 0;
+exports.commonInvokeOptions = exports.appendDesign = exports.appendConstraintsAndTaste = exports.formatProposalHeading = exports.createStderrHandler = exports.prepareAgentsAndPlugins = void 0;
 const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
 const agent_registry_1 = require("../discovery/agent.registry");
 const flavour_resolve_1 = require("../discovery/flavour.resolve");
 const plugin_scan_1 = require("../discovery/plugin.scan");
@@ -103,6 +104,28 @@ const appendConstraintsAndTaste = (sections, config) => {
     }
 };
 exports.appendConstraintsAndTaste = appendConstraintsAndTaste;
+/**
+ * Append design.md sections to a prompt sections array.
+ * Checks both project-level (.ridgeline/design.md) and feature-level (buildDir/design.md).
+ * Both can coexist — injected as separate labeled sections.
+ */
+const appendDesign = (sections, config) => {
+    const projectDesignPath = path.join(config.ridgelineDir, "design.md");
+    const featureDesignPath = path.join(config.buildDir, "design.md");
+    const hasProject = fs.existsSync(projectDesignPath);
+    const hasFeature = fs.existsSync(featureDesignPath);
+    if (hasProject) {
+        sections.push("## Project Design\n");
+        sections.push(fs.readFileSync(projectDesignPath, "utf-8"));
+        sections.push("");
+    }
+    if (hasFeature) {
+        sections.push("## Feature Design\n");
+        sections.push(fs.readFileSync(featureDesignPath, "utf-8"));
+        sections.push("");
+    }
+};
+exports.appendDesign = appendDesign;
 /**
  * Build the common invokeClaude options shared across pipeline agents.
  */

package/dist/engine/pipeline/pipeline.shared.js.map

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

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

@@ -45,6 +45,7 @@ const assembleBaseUserPrompt = (config) => {
     sections.push(fs.readFileSync(specPath, "utf-8"));
     sections.push("");
     (0, pipeline_shared_1.appendConstraintsAndTaste)(sections, config);
+    (0, pipeline_shared_1.appendDesign)(sections, config);
     sections.push("## Target Model\n");
     sections.push(`The builder will use the \`${config.model}\` model.`);
     return sections.join("\n");

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

@@ -1 +1 @@
-{"version":3,"file":"plan.exec.js","sourceRoot":"","sources":["../../../src/engine/pipeline/plan.exec.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAEjC,uDAA6D;AAE7D,8FAA8F;AACvF,MAAM,sBAAsB,GAAG,CAAC,MAAuB,EAAU,EAAE;IACxE,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IACtD,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEjB,IAAA,2CAAyB,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAE3C,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,KAAK,WAAW,CAAC,CAAA;IAEpE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAA;AAdY,QAAA,sBAAsB,0BAclC"}
+{"version":3,"file":"plan.exec.js","sourceRoot":"","sources":["../../../src/engine/pipeline/plan.exec.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAEjC,uDAA2E;AAE3E,8FAA8F;AACvF,MAAM,sBAAsB,GAAG,CAAC,MAAuB,EAAU,EAAE;IACxE,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IACtD,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEjB,IAAA,2CAAyB,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC3C,IAAA,8BAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAE9B,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,KAAK,WAAW,CAAC,CAAA;IAEpE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAA;AAfY,QAAA,sBAAsB,0BAelC"}

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

@@ -0,0 +1,10 @@
+import { ClaudeResult } from "../../types";
+export type RefineConfig = {
+    model: string;
+    timeoutMinutes: number;
+    buildDir: string;
+    flavour: string | null;
+    changelogMd: string | null;
+    iterationNumber: number;
+};
+export declare const invokeRefiner: (specMd: string, researchMd: string, constraintsMd: string, tasteMd: string | null, config: RefineConfig) => Promise<ClaudeResult>;

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

@@ -0,0 +1,91 @@
+"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.invokeRefiner = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const claude_exec_1 = require("../claude/claude.exec");
+const stream_display_1 = require("../claude/stream.display");
+const agent_registry_1 = require("../discovery/agent.registry");
+const flavour_resolve_1 = require("../discovery/flavour.resolve");
+const pipeline_shared_1 = require("./pipeline.shared");
+const research_exec_1 = require("./research.exec");
+const invokeRefiner = async (specMd, researchMd, constraintsMd, tasteMd, config) => {
+    const registry = (0, agent_registry_1.buildAgentRegistry)((0, flavour_resolve_1.resolveFlavour)(config.flavour));
+    const systemPrompt = registry.getCorePrompt("refiner.md");
+    const sections = (0, research_exec_1.assembleInputSections)(specMd, constraintsMd, tasteMd);
+    // Insert research.md after spec.md section
+    const constraintsIdx = sections.indexOf("## constraints.md\n");
+    sections.splice(constraintsIdx, 0, "## research.md\n", researchMd, "");
+    // Insert spec.changelog.md after research.md (if it exists)
+    if (config.changelogMd) {
+        const newConstraintsIdx = sections.indexOf("## constraints.md\n");
+        sections.splice(newConstraintsIdx, 0, "## spec.changelog.md (your prior changes)\n", config.changelogMd, "");
+    }
+    sections.push("## Output\n");
+    sections.push(`1. Rewrite the spec incorporating research findings. Write the revised spec to: ${config.buildDir}/spec.md`);
+    sections.push(`2. Document your changes. Write the changelog to: ${config.buildDir}/spec.changelog.md`);
+    sections.push(`   - ${config.changelogMd ? "Read the existing spec.changelog.md first, then prepend" : "Create"} a new ## Iteration ${config.iterationNumber} section.`);
+    sections.push("Use the Write tool for both files.");
+    const userPrompt = sections.join("\n");
+    const { onStdout, flush } = (0, stream_display_1.createDisplayCallbacks)({ projectRoot: process.cwd() });
+    let result;
+    try {
+        result = await (0, claude_exec_1.invokeClaude)({
+            systemPrompt,
+            userPrompt,
+            model: config.model,
+            allowedTools: ["Read", "Write"],
+            cwd: process.cwd(),
+            timeoutMs: config.timeoutMinutes * 60 * 1000,
+            onStdout,
+            onStderr: (0, pipeline_shared_1.createStderrHandler)("refiner"),
+        });
+    }
+    finally {
+        flush();
+    }
+    // Verify spec.md was rewritten
+    if (!fs.existsSync(path.join(config.buildDir, "spec.md"))) {
+        throw new Error("Refiner did not write spec.md");
+    }
+    // Verify spec.changelog.md was written
+    if (!fs.existsSync(path.join(config.buildDir, "spec.changelog.md"))) {
+        throw new Error("Refiner did not write spec.changelog.md");
+    }
+    return result;
+};
+exports.invokeRefiner = invokeRefiner;
+//# sourceMappingURL=refine.exec.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { EnsembleResult } from "../../types";
+/** Build the common spec + constraints + taste sections for research/refine prompts. */
+export declare const assembleInputSections: (specMd: string, constraintsMd: string, tasteMd: string | null) => string[];
+export type ResearchConfig = {
+    model: string;
+    timeoutMinutes: number;
+    maxBudgetUsd: number | null;
+    buildDir: string;
+    flavour: string | null;
+    isDeep: boolean;
+    networkAllowlist: string[];
+    sandboxProvider?: import("../../types").RidgelineConfig["sandboxProvider"];
+    existingResearchMd: string | null;
+    changelogMd: string | null;
+    iterationNumber: number;
+};
+export declare const invokeResearcher: (specMd: string, constraintsMd: string, tasteMd: string | null, config: ResearchConfig) => Promise<EnsembleResult>;

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

@@ -0,0 +1,196 @@
+"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.invokeResearcher = exports.assembleInputSections = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ensemble_exec_1 = require("./ensemble.exec");
+const claude_exec_1 = require("../claude/claude.exec");
+const agent_registry_1 = require("../discovery/agent.registry");
+const flavour_resolve_1 = require("../discovery/flavour.resolve");
+const pipeline_shared_1 = require("./pipeline.shared");
+// ---------------------------------------------------------------------------
+// Shared prompt helpers
+// ---------------------------------------------------------------------------
+/** Build the common spec + constraints + taste sections for research/refine prompts. */
+const assembleInputSections = (specMd, constraintsMd, tasteMd) => {
+    const sections = [];
+    sections.push("## spec.md\n");
+    sections.push(specMd);
+    sections.push("");
+    sections.push("## constraints.md\n");
+    sections.push(constraintsMd);
+    sections.push("");
+    if (tasteMd) {
+        sections.push("## taste.md\n");
+        sections.push(tasteMd);
+        sections.push("");
+    }
+    return sections;
+};
+exports.assembleInputSections = assembleInputSections;
+// ---------------------------------------------------------------------------
+// Research agenda
+// ---------------------------------------------------------------------------
+const AGENDA_SYSTEM_PROMPT = `You are a research agenda planner. Given a specification and a domain gap checklist, identify what the spec is missing or vague about, and produce a focused research agenda.
+
+Your output is a markdown research agenda that will be given to research specialists to focus their web searches. Be specific — name the gaps, suggest search terms, and prioritize by impact.
+
+If prior research findings are provided, note which areas are already well-covered and should not be re-researched unless contradictory information is found. Focus the agenda on unexplored territory.
+
+Keep your response concise — under 500 words. No preamble.`;
+const buildAgendaUserPrompt = (specMd, gapsMd, existingResearchMd, changelogMd) => {
+    const sections = [];
+    sections.push("## spec.md\n");
+    sections.push(specMd);
+    sections.push("");
+    if (gapsMd) {
+        sections.push("## Domain Gap Checklist\n");
+        sections.push(gapsMd);
+        sections.push("");
+    }
+    if (existingResearchMd) {
+        sections.push("## Prior Research (already conducted)\n");
+        sections.push(existingResearchMd);
+        sections.push("");
+    }
+    if (changelogMd) {
+        sections.push("## Spec Changelog (recommendations already incorporated)\n");
+        sections.push(changelogMd);
+        sections.push("");
+    }
+    sections.push("Produce a focused research agenda identifying gaps and specific questions for specialists to investigate.");
+    return sections.join("\n");
+};
+const buildResearchAgenda = async (specMd, gapsMd, existingResearchMd, changelogMd, model, timeoutMinutes) => {
+    const result = await (0, claude_exec_1.invokeClaude)({
+        systemPrompt: AGENDA_SYSTEM_PROMPT,
+        userPrompt: buildAgendaUserPrompt(specMd, gapsMd, existingResearchMd, changelogMd),
+        model: "sonnet",
+        allowedTools: [],
+        cwd: process.cwd(),
+        timeoutMs: Math.min(timeoutMinutes * 60 * 1000, 3 * 60 * 1000), // cap at 3 min
+        onStderr: (0, pipeline_shared_1.createStderrHandler)("agenda"),
+    });
+    return result.result ?? "";
+};
+// ---------------------------------------------------------------------------
+// Prompt construction
+// ---------------------------------------------------------------------------
+/** Build a research specialist system prompt from shared context + overlay. */
+const buildResearchSpecialistPrompt = (context, overlay) => {
+    return `${context}\n\n${overlay}`;
+};
+/** Assemble the user prompt for a research specialist. */
+const assembleSpecialistUserPrompt = (specMd, constraintsMd, tasteMd, agenda) => {
+    const sections = (0, exports.assembleInputSections)(specMd, constraintsMd, tasteMd);
+    if (agenda) {
+        sections.push("## Research Agenda\n");
+        sections.push("The following gaps and questions were identified. Focus your research on these areas:\n");
+        sections.push(agenda);
+        sections.push("");
+    }
+    sections.push("Research this spec thoroughly using your web tools. Produce a markdown research report as your response.");
+    return sections.join("\n");
+};
+/** Assemble the user prompt for the research synthesizer. */
+const assembleSynthesizerUserPrompt = (specMd, buildDir, drafts, existingResearchMd, changelogMd, iterationNumber) => {
+    const sections = [];
+    sections.push("## spec.md\n");
+    sections.push(specMd);
+    sections.push("");
+    sections.push("## Specialist Research Reports\n");
+    for (const { perspective, draft } of drafts) {
+        sections.push(`### ${perspective.charAt(0).toUpperCase() + perspective.slice(1)} Specialist Report\n`);
+        sections.push(draft);
+        sections.push("\n---\n");
+    }
+    if (existingResearchMd) {
+        sections.push("## Existing research.md (to be updated, not replaced)\n");
+        sections.push(existingResearchMd);
+        sections.push("");
+    }
+    if (changelogMd) {
+        sections.push("## spec.changelog.md (recommendations already acted on)\n");
+        sections.push(changelogMd);
+        sections.push("");
+    }
+    sections.push("## Current Iteration\n");
+    sections.push(`Iteration: ${iterationNumber}`);
+    sections.push("");
+    sections.push("## Output\n");
+    sections.push(`Write the ${existingResearchMd ? "updated" : "new"} research report to: ${buildDir}/research.md`);
+    sections.push("Use the Write tool to create the file.");
+    return sections.join("\n");
+};
+const invokeResearcher = async (specMd, constraintsMd, tasteMd, config) => {
+    const registry = (0, agent_registry_1.buildAgentRegistry)((0, flavour_resolve_1.resolveFlavour)(config.flavour));
+    const context = registry.getContext("researchers") ?? "";
+    const gapsMd = registry.getGaps("researchers");
+    const allSpecialists = registry.getSpecialists("researchers");
+    // Quick mode: use only the first specialist (ecosystem by default — most broadly useful)
+    // Deep mode: use all specialists
+    const specialists = config.isDeep
+        ? allSpecialists
+        : allSpecialists.length > 0
+            ? [allSpecialists[0]]
+            : [];
+    // Build a research agenda before dispatching specialists
+    const agenda = await buildResearchAgenda(specMd, gapsMd, config.existingResearchMd, config.changelogMd, config.model, config.timeoutMinutes);
+    return (0, ensemble_exec_1.invokeEnsemble)({
+        label: "Researching",
+        specialists,
+        isStructured: false,
+        buildSpecialistPrompt: (overlay) => buildResearchSpecialistPrompt(context, overlay),
+        specialistUserPrompt: assembleSpecialistUserPrompt(specMd, constraintsMd, tasteMd, agenda || null),
+        specialistSchema: "", // unused when isStructured is false
+        specialistTools: ["WebFetch", "WebSearch", "Bash"],
+        synthesizerPrompt: registry.getCorePrompt("researcher.md"),
+        buildSynthesizerUserPrompt: (drafts) => assembleSynthesizerUserPrompt(specMd, config.buildDir, drafts, config.existingResearchMd, config.changelogMd, config.iterationNumber),
+        synthesizerTools: ["Write"],
+        model: config.model,
+        timeoutMinutes: config.timeoutMinutes,
+        maxBudgetUsd: config.maxBudgetUsd,
+        networkAllowlist: config.networkAllowlist,
+        sandboxProvider: config.sandboxProvider,
+        verify: () => {
+            if (!fs.existsSync(path.join(config.buildDir, "research.md"))) {
+                throw new Error("Synthesizer did not create research.md");
+            }
+        },
+    });
+};
+exports.invokeResearcher = invokeResearcher;
+//# sourceMappingURL=research.exec.js.map

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

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

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

@@ -43,6 +43,8 @@ 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 state_1 = require("../../stores/state");
+const detect_1 = require("../../shapes/detect");
 const assembleUserPrompt = (config, phase, checkpointTag) => {
     const sections = [];
     sections.push("## Phase Spec\n");
@@ -62,6 +64,27 @@ const assembleUserPrompt = (config, phase, checkpointTag) => {
     sections.push("## constraints.md\n");
     sections.push(fs.readFileSync(config.constraintsPath, "utf-8"));
     sections.push("");
+    // Inject design.md
+    (0, pipeline_shared_1.appendDesign)(sections, config);
+    // Inject reviewer context from matched shapes
+    const matchedShapeNames = (0, state_1.getMatchedShapes)(config.buildDir);
+    if (matchedShapeNames.length > 0) {
+        const allDefs = (0, detect_1.loadShapeDefinitions)();
+        const matchedDefs = allDefs.filter((d) => matchedShapeNames.includes(d.name));
+        if (matchedDefs.length > 0) {
+            sections.push("## Visual Design Review Context\n");
+            sections.push("The following visual design heuristics apply to this phase:\n");
+            for (const def of matchedDefs) {
+                sections.push(`### ${def.name}\n`);
+                sections.push(def.reviewerContext);
+                sections.push("");
+            }
+            sections.push("**Review rules for design.md:**");
+            sections.push("- Hard token violations (specific values with imperative language) → severity: blocking");
+            sections.push("- Soft guidance deviations (directional language) → severity: suggestion");
+            sections.push("");
+        }
+    }
     return sections.join("\n");
 };
 const invokeReviewer = async (config, phase, checkpointTag) => {

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

@@ -1 +1 @@
-{"version":3,"file":"review.exec.js","sourceRoot":"","sources":["../../../src/engine/pipeline/review.exec.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAE7B,uDAAoD;AACpD,6DAAiE;AACjE,mCAAmC;AACnC,oEAA4D;AAC5D,0DAA4D;AAC5D,gEAAgE;AAChE,kEAA6D;AAC7D,uDAAgF;AAEhF,MAAM,kBAAkB,GAAG,CACzB,MAAuB,EACvB,KAAgB,EAChB,aAAqB,EACb,EAAE;IACV,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEjB,MAAM,IAAI,GAAG,IAAA,aAAO,EAAC,aAAa,CAAC,CAAA;IACnC,QAAQ,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;IACnD,IAAI,IAAI,EAAE,CAAC;QACT,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACxB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IACvC,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEjB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEjB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAA;AAEM,MAAM,cAAc,GAAG,KAAK,EACjC,MAAuB,EACvB,KAAgB,EAChB,aAAqB,EACsC,EAAE;IAC7D,MAAM,QAAQ,GAAG,IAAA,mCAAkB,EAAC,IAAA,gCAAc,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IACnE,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;IAC1D,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAA;IACnE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAA,uCAAsB,EAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC3G,MAAM,QAAQ,GAAG,IAAA,yCAAuB,EAAC,MAAM,CAAC,CAAA;IAEhD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAY,EAAC;YAChC,YAAY;YACZ,UAAU;YACV,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;YACvD,GAAG,IAAA,qCAAmB,EAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;SACnD,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,IAAA,+BAAY,EAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IAC5B,CAAC;YAAS,CAAC;QACT,KAAK,EAAE,CAAA;QACP,IAAA,+BAAiB,EAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IACxC,CAAC;AACH,CAAC,CAAA;AA1BY,QAAA,cAAc,kBA0B1B"}
+{"version":3,"file":"review.exec.js","sourceRoot":"","sources":["../../../src/engine/pipeline/review.exec.ts"],"names":[],"mappings":"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"}

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

@@ -5,5 +5,6 @@ export type SpecEnsembleConfig = {
     maxBudgetUsd: number | null;
     buildDir: string;
     flavour: string | null;
+    matchedShapes: string[];
 };
 export declare const invokeSpecifier: (shapeMd: string, config: SpecEnsembleConfig) => Promise<EnsembleResult>;