@planu/cli 0.63.7 → 0.64.1

package/dist/engine/elicitation/builder.js

@@ -0,0 +1,115 @@
+/**
+ * Fluent builder for constructing MCP elicitation requests.
+ *
+ * @example
+ * ```ts
+ * const request = new ElicitationBuilder('Confirm deployment')
+ *   .addText('name', 'Service name', { required: true })
+ *   .addEnum('env', 'Target environment', ['staging', 'production'])
+ *   .addBoolean('notify', 'Notify on Slack?')
+ *   .build();
+ * ```
+ */
+export class ElicitationBuilder {
+    title;
+    fields = [];
+    description;
+    constructor(title) {
+        this.title = title;
+    }
+    /** Set an optional description displayed below the title. */
+    withDescription(description) {
+        this.description = description;
+        return this;
+    }
+    /** Add a free-text input field. */
+    addText(key, label, options = {}) {
+        const field = {
+            type: 'text',
+            key,
+            label,
+            ...(options.required !== undefined && { required: options.required }),
+            ...(options.maxLength !== undefined && { maxLength: options.maxLength }),
+            ...(options.placeholder !== undefined && { placeholder: options.placeholder }),
+            ...(options.defaultValue !== undefined && { defaultValue: options.defaultValue }),
+        };
+        this.fields.push(field);
+        return this;
+    }
+    /** Add a numeric input field with optional min/max bounds. */
+    addNumber(key, label, options = {}) {
+        const field = {
+            type: 'number',
+            key,
+            label,
+            ...(options.required !== undefined && { required: options.required }),
+            ...(options.min !== undefined && { min: options.min }),
+            ...(options.max !== undefined && { max: options.max }),
+            ...(options.defaultValue !== undefined && { defaultValue: options.defaultValue }),
+        };
+        this.fields.push(field);
+        return this;
+    }
+    /** Add a boolean toggle / checkbox field. */
+    addBoolean(key, label, options = {}) {
+        const field = {
+            type: 'boolean',
+            key,
+            label,
+            ...(options.required !== undefined && { required: options.required }),
+            ...(options.defaultValue !== undefined && { defaultValue: options.defaultValue }),
+        };
+        this.fields.push(field);
+        return this;
+    }
+    /** Add a single-select enum field constrained to the given options list. */
+    addEnum(key, label, options, fieldOptions = {}) {
+        if (options.length === 0) {
+            throw new Error(`ElicitationBuilder.addEnum: field "${key}" must have at least one option`);
+        }
+        const field = {
+            type: 'enum',
+            key,
+            label,
+            options,
+            ...(fieldOptions.required !== undefined && { required: fieldOptions.required }),
+            ...(fieldOptions.defaultValue !== undefined && { defaultValue: fieldOptions.defaultValue }),
+        };
+        this.fields.push(field);
+        return this;
+    }
+    /** Add a multi-select field allowing zero or more items from the options list. */
+    addMultiSelect(key, label, options, fieldOptions = {}) {
+        if (options.length === 0) {
+            throw new Error(`ElicitationBuilder.addMultiSelect: field "${key}" must have at least one option`);
+        }
+        const field = {
+            type: 'multi-select',
+            key,
+            label,
+            options,
+            ...(fieldOptions.required !== undefined && { required: fieldOptions.required }),
+            ...(fieldOptions.defaultValue !== undefined && { defaultValue: fieldOptions.defaultValue }),
+        };
+        this.fields.push(field);
+        return this;
+    }
+    /**
+     * Build the final ElicitationRequest.
+     * @throws {Error} when no fields have been added.
+     */
+    build() {
+        if (this.fields.length === 0) {
+            throw new Error('ElicitationBuilder.build: at least one field is required');
+        }
+        const request = {
+            title: this.title,
+            fields: [...this.fields],
+        };
+        if (this.description !== undefined) {
+            request.description = this.description;
+        }
+        return request;
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/engine/elicitation/builder.js.map

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

package/dist/engine/elicitation/fallback.d.ts

@@ -0,0 +1,20 @@
+import type { ElicitationRequest } from '../../types/elicitation.js';
+/**
+ * Generate a text-based fallback prompt for clients that do not support
+ * the MCP elicitation protocol.
+ *
+ * The output is a human-readable string describing all form fields so that
+ * the user can provide answers as free text.
+ */
+export declare function generateFallbackPrompt(request: ElicitationRequest): string;
+/**
+ * Check whether the given MCP server capabilities object declares support for
+ * elicitation. Pass the `capabilities` object from your McpServer instance.
+ *
+ * @example
+ * ```ts
+ * const capable = supportsElicitation(server.getClientCapabilities());
+ * ```
+ */
+export declare function supportsElicitation(capabilities: Record<string, unknown> | null | undefined): boolean;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/engine/elicitation/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/engine/elicitation/fallback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAwCvF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAgB1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACvD,OAAO,CAMT"}

package/dist/engine/elicitation/fallback.js

@@ -0,0 +1,72 @@
+function renderFieldPrompt(field) {
+    const requiredMark = field.required ? ' (required)' : ' (optional)';
+    switch (field.type) {
+        case 'text': {
+            const maxNote = field.maxLength ? ` — max ${field.maxLength} chars` : '';
+            const defaultNote = field.defaultValue ? ` [default: ${String(field.defaultValue)}]` : '';
+            return `• ${field.label}${requiredMark}${maxNote}${defaultNote}`;
+        }
+        case 'number': {
+            const rangeNote = field.min !== undefined || field.max !== undefined
+                ? ` — range: ${field.min ?? '∞'} to ${field.max ?? '∞'}`
+                : '';
+            const defaultNote = field.defaultValue !== undefined ? ` [default: ${String(field.defaultValue)}]` : '';
+            return `• ${field.label}${requiredMark}${rangeNote}${defaultNote} (number)`;
+        }
+        case 'boolean': {
+            const defaultNote = field.defaultValue !== undefined ? ` [default: ${String(field.defaultValue)}]` : '';
+            return `• ${field.label}${requiredMark}${defaultNote} (yes/no)`;
+        }
+        case 'enum': {
+            const optionsList = field.options.map((o) => `"${o}"`).join(', ');
+            const defaultNote = field.defaultValue ? ` [default: ${String(field.defaultValue)}]` : '';
+            return `• ${field.label}${requiredMark}${defaultNote}\n  Options: ${optionsList}`;
+        }
+        case 'multi-select': {
+            const optionsList = field.options.map((o) => `"${o}"`).join(', ');
+            const defaultNote = field.defaultValue && Array.isArray(field.defaultValue) && field.defaultValue.length > 0
+                ? ` [default: ${field.defaultValue.join(', ')}]`
+                : '';
+            return `• ${field.label}${requiredMark}${defaultNote}\n  Options (select one or more): ${optionsList}`;
+        }
+    }
+}
+/**
+ * Generate a text-based fallback prompt for clients that do not support
+ * the MCP elicitation protocol.
+ *
+ * The output is a human-readable string describing all form fields so that
+ * the user can provide answers as free text.
+ */
+export function generateFallbackPrompt(request) {
+    const lines = [];
+    lines.push(`## ${request.title}`);
+    if (request.description) {
+        lines.push('');
+        lines.push(request.description);
+    }
+    lines.push('');
+    lines.push('Your client does not support interactive forms. Please answer the following questions:');
+    lines.push('');
+    for (const field of request.fields) {
+        lines.push(renderFieldPrompt(field));
+    }
+    return lines.join('\n');
+}
+/**
+ * Check whether the given MCP server capabilities object declares support for
+ * elicitation. Pass the `capabilities` object from your McpServer instance.
+ *
+ * @example
+ * ```ts
+ * const capable = supportsElicitation(server.getClientCapabilities());
+ * ```
+ */
+export function supportsElicitation(capabilities) {
+    if (!capabilities) {
+        return false;
+    }
+    // MCP 2025-06: elicitation support is declared under capabilities.elicitation
+    return typeof capabilities.elicitation === 'object' && capabilities.elicitation !== null;
+}
+//# sourceMappingURL=fallback.js.map

package/dist/engine/elicitation/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../../src/engine/elicitation/fallback.ts"],"names":[],"mappings":"AAGA,SAAS,iBAAiB,CAAC,KAAuB;IAChD,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;IACpE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,OAAO,KAAK,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,OAAO,GAAG,WAAW,EAAE,CAAC;QACnE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,SAAS,GACb,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;gBAChD,CAAC,CAAC,aAAa,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,WAAW,GACf,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,OAAO,KAAK,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,WAAW,CAAC;QAC9E,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,WAAW,GACf,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,OAAO,KAAK,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,WAAW,WAAW,CAAC;QAClE,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClE,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,OAAO,KAAK,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,WAAW,gBAAgB,WAAW,EAAE,CAAC;QACpF,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClE,MAAM,WAAW,GACf,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBACtF,CAAC,CAAC,cAAc,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAChD,CAAC,CAAC,EAAE,CAAC;YACT,OAAO,KAAK,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,WAAW,qCAAqC,WAAW,EAAE,CAAC;QACzG,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA2B;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAClC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,wFAAwF,CACzF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAwD;IAExD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,8EAA8E;IAC9E,OAAO,OAAO,YAAY,CAAC,WAAW,KAAK,QAAQ,IAAI,YAAY,CAAC,WAAW,KAAK,IAAI,CAAC;AAC3F,CAAC"}

package/dist/engine/elicitation/index.d.ts

@@ -0,0 +1,4 @@
+export * from './builder.js';
+export * from './response-parser.js';
+export * from './fallback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/elicitation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/elicitation/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/engine/elicitation/index.js

@@ -0,0 +1,5 @@
+// engine/elicitation — barrel export
+export * from './builder.js';
+export * from './response-parser.js';
+export * from './fallback.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/elicitation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/elicitation/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/engine/elicitation/response-parser.d.ts

@@ -0,0 +1,9 @@
+import type { ElicitationRequest, ElicitationParseResult } from '../../types/elicitation.js';
+/**
+ * Parse and validate a raw client response against an elicitation request schema.
+ *
+ * Returns a typed result indicating whether all fields are valid and providing
+ * coerced values or per-field error messages.
+ */
+export declare function parseElicitationResponse(request: ElicitationRequest, raw: Record<string, unknown>): ElicitationParseResult;
+//# sourceMappingURL=response-parser.d.ts.map

package/dist/engine/elicitation/response-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/elicitation/response-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAwKpC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,sBAAsB,CAmBxB"}

package/dist/engine/elicitation/response-parser.js

@@ -0,0 +1,163 @@
+function validateTextField(field, raw) {
+    if (raw === undefined || raw === null || raw === '') {
+        if (field.required) {
+            return `"${field.label}" is required`;
+        }
+        return undefined;
+    }
+    if (typeof raw !== 'string') {
+        return `"${field.label}" must be a string`;
+    }
+    if (field.maxLength !== undefined && raw.length > field.maxLength) {
+        return `"${field.label}" must not exceed ${field.maxLength} characters`;
+    }
+    return undefined;
+}
+function validateNumberField(field, raw) {
+    if (raw === undefined || raw === null || raw === '') {
+        if (field.required) {
+            return `"${field.label}" is required`;
+        }
+        return undefined;
+    }
+    const num = typeof raw === 'string' ? Number(raw) : raw;
+    if (typeof num !== 'number' || isNaN(num)) {
+        return `"${field.label}" must be a number`;
+    }
+    if (field.min !== undefined && num < field.min) {
+        return `"${field.label}" must be at least ${field.min}`;
+    }
+    if (field.max !== undefined && num > field.max) {
+        return `"${field.label}" must be at most ${field.max}`;
+    }
+    return undefined;
+}
+function validateBooleanField(field, raw) {
+    if (raw === undefined || raw === null) {
+        if (field.required) {
+            return `"${field.label}" is required`;
+        }
+        return undefined;
+    }
+    if (typeof raw !== 'boolean' && raw !== 'true' && raw !== 'false') {
+        return `"${field.label}" must be a boolean`;
+    }
+    return undefined;
+}
+function validateEnumField(field, raw) {
+    if (raw === undefined || raw === null || raw === '') {
+        if (field.required) {
+            return `"${field.label}" is required`;
+        }
+        return undefined;
+    }
+    if (typeof raw !== 'string') {
+        return `"${field.label}" must be a string`;
+    }
+    if (!field.options.includes(raw)) {
+        return `"${field.label}" must be one of: ${field.options.join(', ')}`;
+    }
+    return undefined;
+}
+function validateMultiSelectField(field, raw) {
+    if (raw === undefined || raw === null) {
+        if (field.required) {
+            return `"${field.label}" is required`;
+        }
+        return undefined;
+    }
+    const arr = Array.isArray(raw) ? raw : [raw];
+    const invalid = arr.filter((v) => !field.options.includes(String(v)));
+    if (invalid.length > 0) {
+        return `"${field.label}" contains invalid options: ${invalid.join(', ')}`;
+    }
+    return undefined;
+}
+function validateField(field, raw) {
+    switch (field.type) {
+        case 'text':
+            return validateTextField(field, raw);
+        case 'number':
+            return validateNumberField(field, raw);
+        case 'boolean':
+            return validateBooleanField(field, raw);
+        case 'enum':
+            return validateEnumField(field, raw);
+        case 'multi-select':
+            return validateMultiSelectField(field, raw);
+    }
+}
+function coerceToString(raw) {
+    if (typeof raw === 'string') {
+        return raw;
+    }
+    if (typeof raw === 'number' || typeof raw === 'boolean') {
+        return String(raw);
+    }
+    return undefined;
+}
+function coerceToNumber(raw) {
+    const n = typeof raw === 'string' ? Number(raw) : raw;
+    return typeof n === 'number' && !isNaN(n) ? n : undefined;
+}
+function coerceToBoolean(raw) {
+    if (typeof raw === 'boolean') {
+        return raw;
+    }
+    if (raw === 'true') {
+        return true;
+    }
+    if (raw === 'false') {
+        return false;
+    }
+    return undefined;
+}
+function coerceToStringArray(raw) {
+    if (Array.isArray(raw)) {
+        return raw;
+    }
+    const str = coerceToString(raw);
+    return str !== undefined ? [str] : undefined;
+}
+function coerceValue(field, raw) {
+    if (raw === undefined || raw === null) {
+        return undefined;
+    }
+    switch (field.type) {
+        case 'text':
+        case 'enum':
+            return coerceToString(raw);
+        case 'number':
+            return coerceToNumber(raw);
+        case 'boolean':
+            return coerceToBoolean(raw);
+        case 'multi-select':
+            return coerceToStringArray(raw);
+    }
+}
+/**
+ * Parse and validate a raw client response against an elicitation request schema.
+ *
+ * Returns a typed result indicating whether all fields are valid and providing
+ * coerced values or per-field error messages.
+ */
+export function parseElicitationResponse(request, raw) {
+    const errors = {};
+    const values = {};
+    for (const field of request.fields) {
+        const rawValue = raw[field.key];
+        const error = validateField(field, rawValue);
+        if (error) {
+            errors[field.key] = error;
+        }
+        else {
+            const coerced = coerceValue(field, rawValue);
+            if (coerced !== undefined) {
+                values[field.key] = coerced;
+            }
+        }
+    }
+    const valid = Object.keys(errors).length === 0;
+    return valid ? { valid: true, values, errors } : { valid: false, errors };
+}
+//# sourceMappingURL=response-parser.js.map

package/dist/engine/elicitation/response-parser.js.map

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

package/dist/engine/event-schema-validator/version-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../../src/engine/event-schema-validator/version-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,aAAa,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5D,YAAY,CAYd;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAc3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAChF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}
+{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../../src/engine/event-schema-validator/version-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,aAAa,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5D,YAAY,CAYd;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAe3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAChF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}

package/dist/engine/event-schema-validator/version-utils.js

@@ -23,6 +23,7 @@ export function generateDualVersionStrategy(_oldVersion, newVersion, changeDescr
  */
 export function bumpVersion(current, kind) {
     const parts = current.split('.').map(Number);
+    /* v8 ignore next 3 */
     const major = parts[0] ?? 0;
     const minor = parts[1] ?? 0;
     const patch = parts[2] ?? 0;

package/dist/engine/event-schema-validator/version-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-utils.js","sourceRoot":"","sources":["../../../src/engine/event-schema-validator/version-utils.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAIlG;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAmB,EACnB,UAAkB,EAClB,iBAAyB,EACzB,aAAwB,EACxB,aAA6D;IAE7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEnE,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,UAAU;QACtB,iBAAiB;QACjB,aAAa;QACb,aAAa;QACb,iBAAiB,EAAE,OAAO,CAAC,WAAW,EAAE;KACzC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAsB;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE5B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACnC,KAAK,aAAa;YAChB,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiF;IAEjF,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;QACF,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ;QACR,oBAAoB,EAAE,IAAI;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"version-utils.js","sourceRoot":"","sources":["../../../src/engine/event-schema-validator/version-utils.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAIlG;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAmB,EACnB,UAAkB,EAClB,iBAAyB,EACzB,aAAwB,EACxB,aAA6D;IAE7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEnE,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,UAAU;QACtB,iBAAiB;QACjB,aAAa;QACb,aAAa;QACb,iBAAiB,EAAE,OAAO,CAAC,WAAW,EAAE;KACzC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAsB;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,sBAAsB;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE5B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACnC,KAAK,aAAa;YAChB,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiF;IAEjF,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;QACF,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ;QACR,oBAAoB,EAAE,IAAI;KAC3B,CAAC;AACJ,CAAC"}

package/dist/engine/federation/cross-repo-resolver.d.ts

@@ -0,0 +1,21 @@
+import type { FederationLink, CrossRepoDepEntry, CrossRepoDepReport } from '../../types/index.js';
+/**
+ * Check whether a linked repo directory exists locally.
+ * Accepts absolute paths and relative paths (resolved from cwd).
+ */
+export declare function isRepoAccessible(linkedRepo: string): boolean;
+/**
+ * Check whether a spec file exists within the linked repo.
+ * Delegates to findSpecPath from drift-checker for unified path resolution logic.
+ */
+export declare function isSpecFoundInRepo(linkedRepo: string, linkedSpecId: string): boolean;
+/**
+ * Resolve a single federation link into a CrossRepoDepEntry.
+ */
+export declare function resolveLink(link: FederationLink): CrossRepoDepEntry;
+/**
+ * Resolve all federation links for a project and return a full report.
+ * Updates link statuses as a side-effect (fire-and-forget for each link).
+ */
+export declare function resolveProjectLinks(projectId: string): Promise<CrossRepoDepReport>;
+//# sourceMappingURL=cross-repo-resolver.d.ts.map

package/dist/engine/federation/cross-repo-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-repo-resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/federation/cross-repo-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQlG;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAKnF;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAcnE;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqBxF"}

package/dist/engine/federation/cross-repo-resolver.js

@@ -0,0 +1,75 @@
+// engine/federation/cross-repo-resolver.ts — Resolve cross-repo spec references (SPEC-160)
+// Works with local paths only — no network calls.
+import { existsSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { getProjectLinks, markLinkChecked } from './federation-store.js';
+import { findSpecPath } from './drift-checker.js';
+// ---------------------------------------------------------------------------
+// Repo accessibility
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a linked repo directory exists locally.
+ * Accepts absolute paths and relative paths (resolved from cwd).
+ */
+export function isRepoAccessible(linkedRepo) {
+    const repoPath = isAbsolute(linkedRepo) ? linkedRepo : resolve(process.cwd(), linkedRepo);
+    return existsSync(repoPath);
+}
+/**
+ * Check whether a spec file exists within the linked repo.
+ * Delegates to findSpecPath from drift-checker for unified path resolution logic.
+ */
+export function isSpecFoundInRepo(linkedRepo, linkedSpecId) {
+    if (!isRepoAccessible(linkedRepo)) {
+        return false;
+    }
+    return findSpecPath(linkedRepo, linkedSpecId) !== undefined;
+}
+// ---------------------------------------------------------------------------
+// Entry resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a single federation link into a CrossRepoDepEntry.
+ */
+export function resolveLink(link) {
+    const repoAccessible = isRepoAccessible(link.linkedRepo);
+    const specFound = repoAccessible && isSpecFoundInRepo(link.linkedRepo, link.linkedSpecId);
+    let notes;
+    if (!repoAccessible) {
+        notes = `Repo not found at path: ${link.linkedRepo}`;
+    }
+    else if (!specFound) {
+        notes = `Spec ${link.linkedSpecId} not found in ${link.linkedRepo}/planu/specs/`;
+    }
+    else {
+        notes = 'OK';
+    }
+    return { link, repoAccessible, specFound, notes };
+}
+// ---------------------------------------------------------------------------
+// Full report
+// ---------------------------------------------------------------------------
+/**
+ * Resolve all federation links for a project and return a full report.
+ * Updates link statuses as a side-effect (fire-and-forget for each link).
+ */
+export async function resolveProjectLinks(projectId) {
+    const links = await getProjectLinks(projectId);
+    const entries = links.map(resolveLink);
+    // Update statuses asynchronously (non-blocking)
+    for (const entry of entries) {
+        const status = entry.specFound ? 'active' : entry.repoAccessible ? 'unknown' : 'broken';
+        markLinkChecked(entry.link.id, status).catch(() => {
+            // Fire-and-forget — resolution continues even if status update fails
+        });
+    }
+    const brokenLinks = entries.filter((e) => !e.repoAccessible || !e.specFound).length;
+    return {
+        projectId,
+        generatedAt: new Date().toISOString(),
+        totalLinks: entries.length,
+        brokenLinks,
+        entries,
+    };
+}
+//# sourceMappingURL=cross-repo-resolver.js.map

package/dist/engine/federation/cross-repo-resolver.js.map

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

package/dist/engine/federation/drift-checker.d.ts

@@ -0,0 +1,19 @@
+import type { FederationLink, FederationDriftEntry, FederationDriftReport } from '../../types/index.js';
+/**
+ * Find the spec.md path in a linked repo for the given specId.
+ * Returns undefined when not found.
+ * Shared with cross-repo-resolver to avoid duplicating filesystem traversal logic.
+ */
+export declare function findSpecPath(linkedRepo: string, linkedSpecId: string): string | undefined;
+/**
+ * Check drift for a single federation link.
+ * Drift is signaled when the linked spec exists locally but its mtime is more
+ * recent than the link's lastCheckedAt timestamp (i.e., it changed after we
+ * last verified the link).
+ */
+export declare function checkLinkDrift(link: FederationLink): FederationDriftEntry;
+/**
+ * Check all federation links for a project and return a drift report.
+ */
+export declare function checkProjectFederationDrift(projectId: string): Promise<FederationDriftReport>;
+//# sourceMappingURL=drift-checker.d.ts.map

package/dist/engine/federation/drift-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/federation/drift-checker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAO9B;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA4BzF;AAiBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,oBAAoB,CAyCzE;AAMD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAYhC"}