@farmslot/protocol 0.7.2 → 0.7.4

package/dist/contracts/interactive-operator-packets.js

@@ -0,0 +1,274 @@
+export const INTERACTIVE_OPERATOR_PACKET_SCHEMA_V1 = 'farmslot.interactive.operator-packet.v1';
+export const INTERACTIVE_OPERATOR_PACKET_INTENTS = ['plan', 'decision', 'review', 'blocker', 'evidence', 'comparison'];
+export const INTERACTIVE_OPERATOR_PACKET_ACTION_KINDS = ['terminal.send', 'decision.resolve', 'copy', 'open-artifact'];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stringValue(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+function payloadString(payload, key) {
+    const value = payload?.[key];
+    return stringValue(value);
+}
+function isKnownString(value, known) {
+    if (typeof value !== 'string')
+        return false;
+    return known.some((candidate) => candidate === value);
+}
+function knownStringValue(value, known) {
+    return isKnownString(value, known) ? value : null;
+}
+function parseBody(value, errors) {
+    if (!isRecord(value)) {
+        errors.push('body must be an object');
+        return null;
+    }
+    if (value.format !== 'markdown') {
+        errors.push('body.format must be "markdown"');
+        return null;
+    }
+    const path = stringValue(value.path) ?? undefined;
+    const text = stringValue(value.text) ?? undefined;
+    if (!path && !text) {
+        errors.push('body must include path or text');
+        return null;
+    }
+    const body = { format: 'markdown' };
+    if (path)
+        body.path = path;
+    if (text)
+        body.text = text;
+    return body;
+}
+function parseAnchors(value, errors) {
+    if (value == null)
+        return undefined;
+    if (!Array.isArray(value)) {
+        errors.push('anchors must be an array');
+        return undefined;
+    }
+    const anchors = [];
+    const seenIds = new Set();
+    value.forEach((anchor, index) => {
+        if (!isRecord(anchor)) {
+            errors.push(`anchors[${index}] must be an object`);
+            return;
+        }
+        const id = stringValue(anchor.id);
+        const label = stringValue(anchor.label);
+        const errorCountBeforeAnchor = errors.length;
+        if (!id)
+            errors.push(`anchors[${index}].id must be a non-empty string`);
+        if (id && seenIds.has(id)) {
+            errors.push(`anchors[${index}].id must be unique`);
+        }
+        if (id)
+            seenIds.add(id);
+        if (!label) {
+            errors.push(`anchors[${index}].label must be a non-empty string`);
+        }
+        const artifactPath = stringValue(anchor.artifactPath) ?? undefined;
+        const selector = stringValue(anchor.selector) ?? undefined;
+        const line = Number.isInteger(anchor.line) ? Number(anchor.line) : undefined;
+        if (anchor.line != null && (line == null || line < 1)) {
+            errors.push(`anchors[${index}].line must be a positive integer`);
+        }
+        let range;
+        if (anchor.range != null) {
+            if (!isRecord(anchor.range)) {
+                errors.push(`anchors[${index}].range must be an object`);
+            }
+            else if (!Number.isInteger(anchor.range.start) ||
+                !Number.isInteger(anchor.range.end) ||
+                Number(anchor.range.start) < 0 ||
+                Number(anchor.range.end) < Number(anchor.range.start)) {
+                errors.push(`anchors[${index}].range must include valid start/end offsets`);
+            }
+            else {
+                range = { start: Number(anchor.range.start), end: Number(anchor.range.end) };
+            }
+        }
+        if (id && label && (anchor.line == null || line != null) && (anchor.range == null || range)) {
+            if (errors.length !== errorCountBeforeAnchor)
+                return;
+            const parsed = { id, label };
+            if (artifactPath)
+                parsed.artifactPath = artifactPath;
+            if (selector)
+                parsed.selector = selector;
+            if (line != null)
+                parsed.line = line;
+            if (range)
+                parsed.range = range;
+            anchors.push(parsed);
+        }
+    });
+    return anchors;
+}
+function validateActionPayload(kind, payload, index, errors) {
+    if (kind === 'copy' || kind === 'terminal.send') {
+        if (!payloadString(payload, 'text')) {
+            errors.push(`actions[${index}].payload.text must be a non-empty string`);
+        }
+        return;
+    }
+    if (kind === 'open-artifact') {
+        if (!payloadString(payload, 'artifactPath')) {
+            errors.push(`actions[${index}].payload.artifactPath must be a non-empty string`);
+        }
+        return;
+    }
+    if (!payloadString(payload, 'decisionId')) {
+        errors.push(`actions[${index}].payload.decisionId must be a non-empty string`);
+    }
+    if (!payloadString(payload, 'actionId')) {
+        errors.push(`actions[${index}].payload.actionId must be a non-empty string`);
+    }
+}
+function parseActions(value, errors) {
+    if (value == null)
+        return undefined;
+    if (!Array.isArray(value)) {
+        errors.push('actions must be an array');
+        return undefined;
+    }
+    const actions = [];
+    const seenIds = new Set();
+    value.forEach((action, index) => {
+        if (!isRecord(action)) {
+            errors.push(`actions[${index}] must be an object`);
+            return;
+        }
+        const id = stringValue(action.id);
+        const label = stringValue(action.label);
+        const errorCountBeforeAction = errors.length;
+        if (!id)
+            errors.push(`actions[${index}].id must be a non-empty string`);
+        if (id && seenIds.has(id)) {
+            errors.push(`actions[${index}].id must be unique`);
+        }
+        if (id)
+            seenIds.add(id);
+        if (!label) {
+            errors.push(`actions[${index}].label must be a non-empty string`);
+        }
+        const kind = knownStringValue(action.kind, INTERACTIVE_OPERATOR_PACKET_ACTION_KINDS);
+        if (!kind) {
+            errors.push(`actions[${index}].kind is unsupported`);
+        }
+        const safety = action.safety === 'read-only' || action.safety === 'operator-confirmed'
+            ? action.safety
+            : null;
+        if (!safety) {
+            errors.push(`actions[${index}].safety must be read-only or operator-confirmed`);
+        }
+        const payload = isRecord(action.payload) ? action.payload : undefined;
+        if (action.payload != null && !isRecord(action.payload)) {
+            errors.push(`actions[${index}].payload must be an object when present`);
+        }
+        if (kind)
+            validateActionPayload(kind, payload, index, errors);
+        if (id &&
+            label &&
+            kind &&
+            safety &&
+            (action.payload == null || payload) &&
+            errors.length === errorCountBeforeAction) {
+            const parsed = { id, label, kind, safety };
+            if (payload)
+                parsed.payload = payload;
+            actions.push(parsed);
+        }
+    });
+    return actions;
+}
+export function validateInteractiveOperatorPacket(value) {
+    const errors = [];
+    if (!isRecord(value))
+        return { ok: false, errors: ['packet must be an object'] };
+    if (value.schema !== INTERACTIVE_OPERATOR_PACKET_SCHEMA_V1) {
+        errors.push(`schema must be ${INTERACTIVE_OPERATOR_PACKET_SCHEMA_V1}`);
+    }
+    const id = stringValue(value.id);
+    const runId = stringValue(value.runId) ?? undefined;
+    const title = stringValue(value.title);
+    const summary = stringValue(value.summary) ?? undefined;
+    const intent = isKnownString(value.intent, INTERACTIVE_OPERATOR_PACKET_INTENTS)
+        ? value.intent
+        : null;
+    const createdAt = stringValue(value.createdAt);
+    if (!id)
+        errors.push('id must be a non-empty string');
+    if (!title)
+        errors.push('title must be a non-empty string');
+    if (!intent) {
+        errors.push('intent is unsupported');
+    }
+    const body = parseBody(value.body, errors);
+    const anchors = parseAnchors(value.anchors, errors);
+    const actions = parseActions(value.actions, errors);
+    if (!createdAt)
+        errors.push('createdAt must be a non-empty string');
+    if (errors.length > 0 || !id || !title || !intent || !body || !createdAt) {
+        return { ok: false, errors };
+    }
+    const packet = {
+        schema: INTERACTIVE_OPERATOR_PACKET_SCHEMA_V1,
+        id,
+        title,
+        intent,
+        body,
+        createdAt,
+    };
+    if (runId)
+        packet.runId = runId;
+    if (summary)
+        packet.summary = summary;
+    if (anchors)
+        packet.anchors = anchors;
+    if (actions)
+        packet.actions = actions;
+    return { ok: true, packet, errors: [] };
+}
+export function isInteractiveOperatorPacket(value) {
+    return validateInteractiveOperatorPacket(value).ok;
+}
+export function interactiveOperatorPacketActionRequest(action) {
+    switch (action.kind) {
+        case 'copy': {
+            const text = payloadString(action.payload, 'text');
+            return text ? { kind: 'copy', text } : null;
+        }
+        case 'open-artifact': {
+            const artifactPath = payloadString(action.payload, 'artifactPath');
+            return artifactPath ? { kind: 'open-artifact', artifactPath } : null;
+        }
+        case 'terminal.send': {
+            const text = payloadString(action.payload, 'text');
+            return text ? { kind: 'terminal.send', text } : null;
+        }
+        case 'decision.resolve': {
+            const decisionId = payloadString(action.payload, 'decisionId');
+            const actionId = payloadString(action.payload, 'actionId');
+            return decisionId && actionId ? { kind: 'decision.resolve', decisionId, actionId } : null;
+        }
+    }
+}
+export function isInteractiveOperatorPacketArtifact(artifact) {
+    const normalizedPath = artifact.path.replace(/\\/g, '/').toLowerCase();
+    const purpose = artifact.purpose?.toLowerCase() ?? '';
+    const type = artifact.type?.toLowerCase() ?? '';
+    const mimeType = artifact.mimeType?.toLowerCase() ?? '';
+    return (normalizedPath.endsWith('.packet.json') ||
+        purpose === 'interactive-packet' ||
+        type === 'interactive-packet' ||
+        mimeType === 'application/vnd.farmslot.operator-packet+json');
+}
+export function interactiveOperatorPacketArtifacts(artifacts) {
+    return artifacts.filter(isInteractiveOperatorPacketArtifact);
+}
+//# sourceMappingURL=interactive-operator-packets.js.map

package/dist/contracts/interactive-operator-packets.js.map

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

package/dist/contracts/recipes.d.ts

@@ -37,6 +37,12 @@ export type RecipeQualityVerdict = 'pass' | 'warn' | 'fail';
 export type RecipeQualityDimensionStatus = 'pass' | 'warn' | 'fail' | 'not_applicable';
 export type RecipeQualityEvidenceMode = 'logs' | 'state' | 'trace' | 'screenshot' | 'mixed' | 'unknown';
 export type RecipeQualityArtifactSource = 'worker' | 'gateway' | 'fallback:recipe-coverage' | 'fallback:recipe-json' | 'fallback:report' | 'fallback:missing';
+export declare const RECIPE_QUALITY_ARTIFACT_VERSION = 1;
+export declare const RECIPE_QUALITY_VERDICTS: readonly ["pass", "warn", "fail"];
+export declare const RECIPE_QUALITY_DIMENSION_STATUSES: readonly ["pass", "warn", "fail", "not_applicable"];
+export declare const RECIPE_QUALITY_PROOF_MODES: readonly ["logs", "state", "trace", "screenshot", "mixed", "unknown"];
+export declare const RECIPE_QUALITY_ARTIFACT_SOURCES: readonly ["worker", "gateway", "fallback:recipe-coverage", "fallback:recipe-json", "fallback:report", "fallback:missing"];
+export declare const RECIPE_QUALITY_FALLBACK_SOURCES: readonly ["fallback:recipe-coverage", "fallback:recipe-json", "fallback:report", "fallback:missing"];
 export interface RecipeQualityCompactProjection {
     verdict: 'PASS' | 'WARN' | 'FAIL';
     reasons: string[];
@@ -89,6 +95,7 @@ export interface RecipeQualitySignal {
     source: 'recipe-quality' | 'human-grade' | 'recipe-coverage' | 'recipe-json' | 'report' | 'missing';
     reasoning: string;
 }
+export declare function isRecipeQualityArtifact(value: unknown): value is RecipeQualityArtifact;
 export type { EvidenceManifestEntry, EvidenceManifestStandalone, LiveRecipeContext, LiveRecipeSelectionReason, LiveRecipeSource, RecipeRunArtifactGroup, RecipeRunArtifactGroupKind, RecipeRunArtifactGroupStatus, } from './runs.js';
 export { hasLiveRecipeEvidence, LIVE_RECIPE_EVIDENCE_FILES, LIVE_RECIPE_EVIDENCE_PURPOSES, } from './runs.js';
 //# sourceMappingURL=recipes.d.ts.map

package/dist/contracts/recipes.d.ts.map

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

package/dist/contracts/recipes.js

@@ -3,5 +3,145 @@ export const RECIPE_STRATEGY_LABELS = {
     targeted: { label: 'Targeted evidence', tagline: 'smoke + screenshots for changed UI' },
     smoke: { label: 'Smoke only', tagline: 'backend regression test, no UI evidence' },
 };
+export const RECIPE_QUALITY_ARTIFACT_VERSION = 1;
+// Runtime enum tuples are the source of truth for JSON validation and derived
+// TypeScript unions; type-only unions disappear after compile.
+export const RECIPE_QUALITY_VERDICTS = ['pass', 'warn', 'fail'];
+export const RECIPE_QUALITY_DIMENSION_STATUSES = [
+    'pass',
+    'warn',
+    'fail',
+    'not_applicable',
+];
+export const RECIPE_QUALITY_PROOF_MODES = [
+    'logs',
+    'state',
+    'trace',
+    'screenshot',
+    'mixed',
+    'unknown',
+];
+export const RECIPE_QUALITY_ARTIFACT_SOURCES = [
+    'worker',
+    'gateway',
+    'fallback:recipe-coverage',
+    'fallback:recipe-json',
+    'fallback:report',
+    'fallback:missing',
+];
+export const RECIPE_QUALITY_FALLBACK_SOURCES = [
+    'fallback:recipe-coverage',
+    'fallback:recipe-json',
+    'fallback:report',
+    'fallback:missing',
+];
+const RECIPE_QUALITY_FLOW_TYPES = [
+    'fix-bug',
+    'review-pr',
+    'dev',
+    'pr-complete',
+    'merge-main',
+];
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
+}
+function isRecipeQualityFinding(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const finding = value;
+    if (typeof finding.code !== 'string' || typeof finding.message !== 'string')
+        return false;
+    if (finding.dimension != null && typeof finding.dimension !== 'string')
+        return false;
+    if (finding.evidence != null && !isStringArray(finding.evidence))
+        return false;
+    return true;
+}
+function isRecipeQualityDimensions(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    return Object.values(value).every((dimension) => {
+        if (!dimension || typeof dimension !== 'object' || Array.isArray(dimension))
+            return false;
+        const result = dimension;
+        return (RECIPE_QUALITY_DIMENSION_STATUSES.includes(result.status) &&
+            typeof result.reason === 'string' &&
+            isStringArray(result.evidence));
+    });
+}
+function isRecipeQualityTrainingFields(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const fields = value;
+    if (fields.farm != null && typeof fields.farm !== 'string')
+        return false;
+    if (fields.project != null && typeof fields.project !== 'string')
+        return false;
+    if (fields.flow_type != null &&
+        !RECIPE_QUALITY_FLOW_TYPES.includes(String(fields.flow_type)))
+        return false;
+    if (fields.task_type != null && typeof fields.task_type !== 'string')
+        return false;
+    if (fields.claim_is_visual != null && typeof fields.claim_is_visual !== 'boolean')
+        return false;
+    if (fields.proof_mode != null &&
+        !RECIPE_QUALITY_PROOF_MODES.includes(String(fields.proof_mode)))
+        return false;
+    if (fields.anti_patterns != null && !isStringArray(fields.anti_patterns))
+        return false;
+    if (fields.good_patterns != null && !isStringArray(fields.good_patterns))
+        return false;
+    return true;
+}
+function isRecipeQualityMeta(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const meta = value;
+    if (!RECIPE_QUALITY_ARTIFACT_SOURCES.includes(meta.producer))
+        return false;
+    if (typeof meta.fallback_used !== 'boolean')
+        return false;
+    if (typeof meta.legacy_task !== 'boolean')
+        return false;
+    if (typeof meta.artifact_required !== 'boolean')
+        return false;
+    if (!isStringArray(meta.source_signals))
+        return false;
+    if (meta.fallback_source != null &&
+        !RECIPE_QUALITY_FALLBACK_SOURCES.includes(meta.fallback_source))
+        return false;
+    return true;
+}
+export function isRecipeQualityArtifact(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const artifact = value;
+    if (artifact.version !== RECIPE_QUALITY_ARTIFACT_VERSION)
+        return false;
+    if (!RECIPE_QUALITY_VERDICTS.includes(artifact.verdict))
+        return false;
+    if (!artifact.compact || typeof artifact.compact !== 'object' || Array.isArray(artifact.compact))
+        return false;
+    const compact = artifact.compact;
+    if (!['PASS', 'WARN', 'FAIL'].includes(String(compact.verdict)))
+        return false;
+    if (!isStringArray(compact.reasons) || !isStringArray(compact.better_version_guidance))
+        return false;
+    if (!isRecipeQualityDimensions(artifact.dimensions))
+        return false;
+    if (!Array.isArray(artifact.structural_findings) ||
+        !artifact.structural_findings.every(isRecipeQualityFinding))
+        return false;
+    if (!Array.isArray(artifact.contextual_findings) ||
+        !artifact.contextual_findings.every(isRecipeQualityFinding))
+        return false;
+    if (!isStringArray(artifact.suggested_recipe_delta))
+        return false;
+    if (!isRecipeQualityTrainingFields(artifact.training_fields))
+        return false;
+    if (!isRecipeQualityMeta(artifact.meta))
+        return false;
+    return true;
+}
 export { hasLiveRecipeEvidence, LIVE_RECIPE_EVIDENCE_FILES, LIVE_RECIPE_EVIDENCE_PURPOSES, } from './runs.js';
 //# sourceMappingURL=recipes.js.map

package/dist/contracts/recipes.js.map

@@ -1 +1 @@
-{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../src/contracts/recipes.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,sBAAsB,GAG/B;IACF,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,mCAAmC,EAAE;IAC7E,QAAQ,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,oCAAoC,EAAE;IACvF,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,yCAAyC,EAAE;CACnF,CAAC;AAmHF,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,WAAW,CAAC"}
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../src/contracts/recipes.ts"],"names":[],"mappings":"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"}

package/dist/contracts/roadmap.d.ts

@@ -11,12 +11,14 @@ export interface RoadmapSource {
 export interface RoadmapPromotionEntry {
     backlogItemId?: string;
     specPath?: string;
+    project?: string;
     createdAt: string;
 }
 export interface RoadmapItem {
     id: string;
     kind: 'roadmap-item';
     project: string;
+    targetProjects?: string[];
     title: string;
     stage: RoadmapItemStage;
     tags?: string[];
@@ -27,12 +29,15 @@ export interface RoadmapItem {
     updatedAt: string;
     /** Repo-relative markdown file path under .roadmap. */
     filePath: string;
+    /** Latest repo-relative refinement prompt path generated for this item, when present. */
+    refinementPromptPath?: string;
     /** SHA-256 of the current markdown file, used for edit conflict checks. */
     fileHash: string;
 }
 export interface RoadmapItemSaveInput {
     id?: string;
     project?: string;
+    targetProjects?: string[];
     title: string;
     stage?: RoadmapItemStage;
     tags?: string[];

package/dist/contracts/roadmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../src/contracts/roadmap.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,6EAOtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB,oDAAqD,CAAC;AACvF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../src/contracts/roadmap.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,6EAOtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB,oDAAqD,CAAC;AACvF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export * from './agents/roles.js';
+export * from './checklist-target.js';
 export * from './contracts/index.js';
 export * from './integrations/github-ref.js';
 export * from './pairing/index.js';
 export * from './recipe/index.js';
 export * from './recipes/step-io.js';
+export * from './roadmap/promotion-drafts.js';
 export * from './rpc/index.js';
 export * from './runs/evidence-summary.js';
 export * from './runs/family-iteration-ledger.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}

package/dist/index.js

@@ -1,9 +1,11 @@
 export * from './agents/roles.js';
+export * from './checklist-target.js';
 export * from './contracts/index.js';
 export * from './integrations/github-ref.js';
 export * from './pairing/index.js';
 export * from './recipe/index.js';
 export * from './recipes/step-io.js';
+export * from './roadmap/promotion-drafts.js';
 export * from './rpc/index.js';
 export * from './runs/evidence-summary.js';
 export * from './runs/family-iteration-ledger.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}

package/dist/node/capture-helper-path.d.ts

@@ -1,3 +1,10 @@
+/** Where a resolved capture-helper binary came from, for provenance reporting. */
+export type CaptureHelperSource = 'env:CAPTURE_HELPER_PATH' | 'env:SITEED_CAPTURE_HELPER_BIN' | 'npm-global' | 'npm-root' | 'PATH' | 'fallback';
+export interface CaptureHelperPathInfo {
+    path: string;
+    source: CaptureHelperSource;
+}
 export declare function captureHelperPath(): string;
+export declare function captureHelperPathInfo(): CaptureHelperPathInfo;
 export declare function resolveNativeCaptureHelperPath(): string | null;
 //# sourceMappingURL=capture-helper-path.d.ts.map

package/dist/node/capture-helper-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture-helper-path.d.ts","sourceRoot":"","sources":["../../src/node/capture-helper-path.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,8BAA8B,IAAI,MAAM,GAAG,IAAI,CAoB9D"}
+{"version":3,"file":"capture-helper-path.d.ts","sourceRoot":"","sources":["../../src/node/capture-helper-path.ts"],"names":[],"mappings":"AAIA,kFAAkF;AAClF,MAAM,MAAM,mBAAmB,GAC3B,yBAAyB,GACzB,+BAA+B,GAC/B,YAAY,GACZ,UAAU,GACV,MAAM,GACN,UAAU,CAAC;AAEf,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,qBAAqB,IAAI,qBAAqB,CAM7D;AAED,wBAAgB,8BAA8B,IAAI,MAAM,GAAG,IAAI,CAE9D"}

package/dist/node/capture-helper-path.js

@@ -2,24 +2,41 @@ import { spawnSync } from 'node:child_process';
 import { accessSync, constants, existsSync, realpathSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 export function captureHelperPath() {
-    return resolveNativeCaptureHelperPath() ?? commandPath('capture-helper') ?? 'capture-helper';
+    return captureHelperPathInfo().path;
+}
+export function captureHelperPathInfo() {
+    const native = resolveNativeCaptureHelperPathInfo();
+    if (native)
+        return native;
+    const onPath = commandPath('capture-helper');
+    if (onPath)
+        return { path: onPath, source: 'PATH' };
+    return { path: 'capture-helper', source: 'fallback' };
 }
 export function resolveNativeCaptureHelperPath() {
+    return resolveNativeCaptureHelperPathInfo()?.path ?? null;
+}
+function resolveNativeCaptureHelperPathInfo() {
     const candidates = [
-        process.env.CAPTURE_HELPER_PATH,
-        process.env.SITEED_CAPTURE_HELPER_BIN,
-        process.env.HOME
-            ? join(process.env.HOME, '.npm-global/lib/node_modules/@siteed/capture-helper/native/capture-helper')
-            : undefined,
-        npmGlobalNativePath(),
-        commandPath('capture-helper'),
-    ].filter((candidate) => Boolean(candidate));
-    for (const candidate of candidates) {
-        const native = nativePathForWrapper(candidate);
+        { path: process.env.CAPTURE_HELPER_PATH, source: 'env:CAPTURE_HELPER_PATH' },
+        { path: process.env.SITEED_CAPTURE_HELPER_BIN, source: 'env:SITEED_CAPTURE_HELPER_BIN' },
+        {
+            path: process.env.HOME
+                ? join(process.env.HOME, '.npm-global/lib/node_modules/@siteed/capture-helper/native/capture-helper')
+                : undefined,
+            source: 'npm-global',
+        },
+        { path: npmGlobalNativePath(), source: 'npm-root' },
+        { path: commandPath('capture-helper'), source: 'PATH' },
+    ];
+    for (const { path, source } of candidates) {
+        if (!path)
+            continue;
+        const native = nativePathForWrapper(path);
         if (native && isExecutable(native))
-            return native;
-        if (!isWrapperShim(candidate) && isExecutable(candidate))
-            return candidate;
+            return { path: native, source };
+        if (!isWrapperShim(path) && isExecutable(path))
+            return { path, source };
     }
     return null;
 }