@planu/cli 1.4.0 → 1.5.0

package/dist/engine/compliance-test-generator/test-formatter.js

@@ -0,0 +1,33 @@
+// engine/compliance-test-generator/test-formatter.ts — SPEC-390: Formats mapped tests to output formats
+export function formatAsJest(test) {
+    return (`describe('${test.control.id} — ${test.control.title}', () => {\n` +
+        `  it('should satisfy: ${test.criterion.slice(0, 80)}', async () => {\n` +
+        `    // Control: ${test.control.description}\n` +
+        `    // Rationale: ${test.rationale}\n` +
+        `    // TODO: implement assertion for this compliance requirement\n` +
+        `    expect(true).toBe(true); // placeholder\n` +
+        `  });\n` +
+        `});\n`);
+}
+export function formatAsGherkin(test) {
+    return (`Feature: ${test.control.id} — ${test.control.title}\n` +
+        `  Scenario: ${test.criterion.slice(0, 80)}\n` +
+        `    Given the system is running\n` +
+        `    When ${test.criterion.slice(0, 60).toLowerCase()}\n` +
+        `    Then the ${test.control.title.toLowerCase()} control is satisfied\n\n`);
+}
+export function formatAsMarkdown(test) {
+    return (`- [ ] **[${test.control.id}]** ${test.criterion}\n` +
+        `  - Control: ${test.control.title}\n` +
+        `  - Rationale: ${test.rationale}\n`);
+}
+export function formatTest(test, format) {
+    if (format === 'jest') {
+        return formatAsJest(test);
+    }
+    if (format === 'gherkin') {
+        return formatAsGherkin(test);
+    }
+    return formatAsMarkdown(test);
+}
+//# sourceMappingURL=test-formatter.js.map

package/dist/engine/compliance-test-generator/test-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-formatter.js","sourceRoot":"","sources":["../../../src/engine/compliance-test-generator/test-formatter.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAIxG,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO,CACL,aAAa,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,cAAc;QAClE,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB;QACxE,mBAAmB,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI;QAC/C,qBAAqB,IAAI,CAAC,SAAS,IAAI;QACvC,oEAAoE;QACpE,+CAA+C;QAC/C,SAAS;QACT,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,OAAO,CACL,YAAY,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QACvD,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI;QAC9C,mCAAmC;QACnC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI;QACzD,gBAAgB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,2BAA2B,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,OAAO,CACL,YAAY,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI,CAAC,SAAS,IAAI;QACpD,gBAAgB,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QACtC,kBAAkB,IAAI,CAAC,SAAS,IAAI,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,MAAwB;IACnE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/engine/cost-guardrails.d.ts

@@ -0,0 +1,11 @@
+import type { SpecBudget, SpecBudgetStatus } from '../types/cost-guardrails.js';
+/**
+ * Compute the current budget status for a spec.
+ * Recommends a model tier based on usage percentage to control costs.
+ */
+export declare function computeBudgetStatus(budget: SpecBudget): SpecBudgetStatus;
+/**
+ * Format a budget status into a human-readable summary message.
+ */
+export declare function formatBudgetMessage(status: SpecBudgetStatus): string;
+//# sourceMappingURL=cost-guardrails.d.ts.map

package/dist/engine/cost-guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-guardrails.d.ts","sourceRoot":"","sources":["../../src/engine/cost-guardrails.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGhF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAqBxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUpE"}

package/dist/engine/cost-guardrails.js

@@ -0,0 +1,39 @@
+// engine/cost-guardrails.ts — Cost Guardrails computation logic (SPEC-393)
+/**
+ * Compute the current budget status for a spec.
+ * Recommends a model tier based on usage percentage to control costs.
+ */
+export function computeBudgetStatus(budget) {
+    const remaining = budget.maxUsdCents - budget.usedUsdCents;
+    const usagePercent = budget.maxUsdCents > 0 ? Math.round((budget.usedUsdCents / budget.maxUsdCents) * 100) : 0;
+    const warningTriggered = usagePercent >= budget.warningThreshold;
+    const exhausted = budget.usedUsdCents >= budget.maxUsdCents;
+    // Auto-downgrade model based on remaining budget
+    const recommendedModel = exhausted || usagePercent >= 80 ? 'haiku' : usagePercent >= 60 ? 'sonnet' : 'opus';
+    return {
+        specId: budget.specId,
+        maxUsdCents: budget.maxUsdCents,
+        usedUsdCents: budget.usedUsdCents,
+        remainingUsdCents: Math.max(0, remaining),
+        usagePercent,
+        warningTriggered,
+        recommendedModel,
+        exhausted,
+    };
+}
+/**
+ * Format a budget status into a human-readable summary message.
+ */
+export function formatBudgetMessage(status) {
+    const dollars = (status.usedUsdCents / 100).toFixed(2);
+    const max = (status.maxUsdCents / 100).toFixed(2);
+    let msg = `Budget: $${dollars} / $${max} (${status.usagePercent}%)`;
+    if (status.exhausted) {
+        msg += ' EXHAUSTED — using haiku';
+    }
+    else if (status.warningTriggered) {
+        msg += ` Warning — downgraded to ${status.recommendedModel}`;
+    }
+    return msg;
+}
+//# sourceMappingURL=cost-guardrails.js.map

package/dist/engine/cost-guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-guardrails.js","sourceRoot":"","sources":["../../src/engine/cost-guardrails.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAK3E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;IAC3D,MAAM,YAAY,GAChB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,gBAAgB,GAAG,YAAY,IAAI,MAAM,CAAC,gBAAgB,CAAC;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,CAAC;IAE5D,iDAAiD;IACjD,MAAM,gBAAgB,GACpB,SAAS,IAAI,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAErF,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC;QACzC,YAAY;QACZ,gBAAgB;QAChB,gBAAgB;QAChB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAwB;IAC1D,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,GAAG,GAAG,YAAY,OAAO,OAAO,GAAG,KAAK,MAAM,CAAC,YAAY,IAAI,CAAC;IACpE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,GAAG,IAAI,0BAA0B,CAAC;IACpC,CAAC;SAAM,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACnC,GAAG,IAAI,4BAA4B,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/engine/dogfood-analyzer.d.ts

@@ -0,0 +1,6 @@
+import type { DogfoodReport } from '../types/dogfood.js';
+export declare const KEY_SDD_TOOLS: string[];
+export declare function getRecentCommitMessages(projectPath: string, sinceDays: number): string[];
+export declare function detectToolUsageFromMessages(messages: string[]): string[];
+export declare function buildDogfoodReport(usedTools: string[], period: string, messages: string[]): DogfoodReport;
+//# sourceMappingURL=dogfood-analyzer.d.ts.map

package/dist/engine/dogfood-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dogfood-analyzer.d.ts","sourceRoot":"","sources":["../../src/engine/dogfood-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE,eAAO,MAAM,aAAa,UAWzB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAYxF;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASxE;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,GACjB,aAAa,CAuBf"}

package/dist/engine/dogfood-analyzer.js

@@ -0,0 +1,59 @@
+// dogfood-analyzer.ts — Analyzes git history for Planu tool usage (SPEC-394)
+import { execSync } from 'node:child_process';
+export const KEY_SDD_TOOLS = [
+    'create_spec',
+    'validate',
+    'challenge_spec',
+    'check_readiness',
+    'update_status',
+    'estimate',
+    'suggest_criteria',
+    'inject_criteria',
+    'doc_compliance_report',
+    'generate_skill',
+];
+export function getRecentCommitMessages(projectPath, sinceDays) {
+    try {
+        const since = new Date(Date.now() - sinceDays * 86400000).toISOString().split('T')[0];
+        const output = execSync(`git log --since="${since}" --pretty=format:"%s %b" --no-merges`, {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        return output.split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+export function detectToolUsageFromMessages(messages) {
+    const used = new Set();
+    const combined = messages.join(' ').toLowerCase();
+    for (const tool of KEY_SDD_TOOLS) {
+        if (combined.includes(tool.replace(/_/g, '_')) || combined.includes(tool.replace(/_/g, '-'))) {
+            used.add(tool);
+        }
+    }
+    return [...used];
+}
+export function buildDogfoodReport(usedTools, period, messages) {
+    const missingTools = KEY_SDD_TOOLS.filter((t) => !usedTools.includes(t));
+    const dogfoodScore = Math.round((usedTools.length / KEY_SDD_TOOLS.length) * 100);
+    const combined = messages.join(' ').toLowerCase();
+    const metrics = {
+        specCreated: (combined.match(/create_spec|feat.*spec-\d+/g) ?? []).length,
+        specValidated: (combined.match(/validate|validation/g) ?? []).length,
+        specChallenged: (combined.match(/challenge_spec|challenge/g) ?? []).length,
+        readinessChecked: (combined.match(/check_readiness|readiness/g) ?? []).length,
+        statusUpdated: (combined.match(/update_status|status.*done|status.*impl/g) ?? []).length,
+        totalToolUses: usedTools.length,
+        coveragePercent: dogfoodScore,
+    };
+    const recommendation = dogfoodScore >= 80
+        ? 'Excellent dogfooding! Keep using Planu throughout development.'
+        : dogfoodScore >= 50
+            ? `Good progress. Missing: ${missingTools.slice(0, 3).join(', ')}`
+            : `Improve SDD adoption. Start with: ${missingTools.slice(0, 3).join(', ')}`;
+    return { period, metrics, usedTools, missingTools, recommendation, dogfoodScore };
+}
+//# sourceMappingURL=dogfood-analyzer.js.map

package/dist/engine/dogfood-analyzer.js.map

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

package/dist/engine/drift-watcher/criteria-checker.d.ts

@@ -0,0 +1,16 @@
+import type { DriftAlert } from '../../types/drift-watcher.js';
+/**
+ * Parse spec.md lines starting with "- [ ]" or "- [x]" as criteria.
+ * Returns the criterion text stripped of the checkbox prefix.
+ */
+export declare function extractCriteriaFromSpec(specPath: string): Promise<string[]>;
+/**
+ * Check if a file's content contains key terms from the criterion.
+ * Returns true if any key term is found in the file.
+ */
+export declare function checkCriterionInFile(criterion: string, filePath: string): Promise<boolean>;
+/**
+ * Build a DriftAlert for a criterion that may no longer be satisfied.
+ */
+export declare function buildDriftAlert(specId: string, criterion: string, filePath: string): DriftAlert;
+//# sourceMappingURL=criteria-checker.d.ts.map

package/dist/engine/drift-watcher/criteria-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/drift-watcher/criteria-checker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK/D;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBjF;AAYD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShG;AAiBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAU/F"}

package/dist/engine/drift-watcher/criteria-checker.js

@@ -0,0 +1,81 @@
+// engine/drift-watcher/criteria-checker.ts — SPEC-388: criterion checks on file change
+import { readFile } from 'node:fs/promises';
+const HIGH_SEVERITY_KEYWORDS = ['auth', 'security', 'permission', 'access', 'token', 'password'];
+const MEDIUM_SEVERITY_KEYWORDS = ['validate', 'error', 'fail', 'reject', 'limit', 'timeout'];
+/**
+ * Parse spec.md lines starting with "- [ ]" or "- [x]" as criteria.
+ * Returns the criterion text stripped of the checkbox prefix.
+ */
+export async function extractCriteriaFromSpec(specPath) {
+    try {
+        const content = await readFile(specPath, 'utf-8');
+        const lines = content.split('\n');
+        const criteria = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('- [ ]') || trimmed.startsWith('- [x]')) {
+                const text = trimmed.replace(/^- \[[ x]\]\s*/, '').trim();
+                if (text.length > 0) {
+                    criteria.push(text);
+                }
+            }
+        }
+        return criteria;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract key terms from a criterion (words >=4 chars, lowercased).
+ */
+function extractKeyTerms(criterion) {
+    return criterion
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length >= 4);
+}
+/**
+ * Check if a file's content contains key terms from the criterion.
+ * Returns true if any key term is found in the file.
+ */
+export async function checkCriterionInFile(criterion, filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const lower = content.toLowerCase();
+        const terms = extractKeyTerms(criterion);
+        return terms.some((term) => lower.includes(term));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Determine severity based on criterion keywords.
+ * auth/security keywords = high, validate/error = medium, otherwise low.
+ */
+function determineSeverity(criterion) {
+    const lower = criterion.toLowerCase();
+    if (HIGH_SEVERITY_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return 'high';
+    }
+    if (MEDIUM_SEVERITY_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return 'medium';
+    }
+    return 'low';
+}
+/**
+ * Build a DriftAlert for a criterion that may no longer be satisfied.
+ */
+export function buildDriftAlert(specId, criterion, filePath) {
+    const severity = determineSeverity(criterion);
+    return {
+        specId,
+        criterionText: criterion,
+        affectedFile: filePath,
+        detectedAt: new Date().toISOString(),
+        severity,
+        suggestedFix: `Review ${filePath} to ensure it still satisfies: "${criterion}"`,
+    };
+}
+//# sourceMappingURL=criteria-checker.js.map

package/dist/engine/drift-watcher/criteria-checker.js.map

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

package/dist/engine/drift-watcher/file-watcher.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Watch a directory recursively for file changes.
+ * Calls onChange with the relative filename whenever a file changes.
+ * Silently skips directories that don't exist or can't be watched.
+ * Closes the watcher when the provided AbortSignal is aborted.
+ */
+export declare function watchDirectory(dirPath: string, onChange: (filename: string) => void, signal: AbortSignal): void;
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/engine/drift-watcher/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/engine/drift-watcher/file-watcher.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACpC,MAAM,EAAE,WAAW,GAClB,IAAI,CAiBN"}

package/dist/engine/drift-watcher/file-watcher.js

@@ -0,0 +1,24 @@
+// engine/drift-watcher/file-watcher.ts — SPEC-388: FSEvents wrapper using node:fs watch
+import { watch } from 'node:fs';
+/**
+ * Watch a directory recursively for file changes.
+ * Calls onChange with the relative filename whenever a file changes.
+ * Silently skips directories that don't exist or can't be watched.
+ * Closes the watcher when the provided AbortSignal is aborted.
+ */
+export function watchDirectory(dirPath, onChange, signal) {
+    try {
+        const watcher = watch(dirPath, { recursive: true }, (_event, filename) => {
+            if (filename) {
+                onChange(filename);
+            }
+        });
+        signal.addEventListener('abort', () => {
+            watcher.close();
+        }, { once: true });
+    }
+    catch {
+        // Directory doesn't exist or not watchable — silently skip
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/engine/drift-watcher/file-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.js","sourceRoot":"","sources":["../../../src/engine/drift-watcher/file-watcher.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,QAAoC,EACpC,MAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YACvE,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC"}

package/dist/engine/drift-watcher/index.d.ts

@@ -0,0 +1,19 @@
+import type { DriftWatcherConfig, WatcherState } from '../../types/drift-watcher.js';
+/**
+ * Start watching a spec's associated paths for drift.
+ * Returns the initial WatcherState.
+ */
+export declare function startWatcher(config: DriftWatcherConfig): WatcherState;
+/**
+ * Stop a running watcher. Returns true if it was running, false if not found.
+ */
+export declare function stopWatcher(specId: string): boolean;
+/**
+ * Get the current state of a watcher. Returns null if not running.
+ */
+export declare function getWatcherState(specId: string): WatcherState | null;
+/**
+ * List all active watcher states.
+ */
+export declare function listActiveWatchers(): WatcherState[];
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/drift-watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/drift-watcher/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAgB,MAAM,8BAA8B,CAAC;AAuBnG;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA8BrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAEnD"}

package/dist/engine/drift-watcher/index.js

@@ -0,0 +1,70 @@
+import { watchDirectory } from './file-watcher.js';
+import { extractCriteriaFromSpec, buildDriftAlert } from './criteria-checker.js';
+// In-memory registry — does not persist across server restarts
+const activeWatchers = new Map();
+async function runCriteriaCheck(config, filename) {
+    const entry = activeWatchers.get(config.specId);
+    if (!entry) {
+        return;
+    }
+    const filePath = filename;
+    const criteria = await extractCriteriaFromSpec(config.specPath);
+    for (const criterion of criteria) {
+        const alert = buildDriftAlert(config.specId, criterion, filePath);
+        entry.state.alertCount++;
+        entry.state.lastAlert = alert;
+    }
+}
+/**
+ * Start watching a spec's associated paths for drift.
+ * Returns the initial WatcherState.
+ */
+export function startWatcher(config) {
+    const existing = activeWatchers.get(config.specId);
+    if (existing) {
+        return existing.state;
+    }
+    const controller = new AbortController();
+    const state = {
+        specId: config.specId,
+        projectPath: config.projectPath,
+        active: true,
+        startedAt: new Date().toISOString(),
+        alertCount: 0,
+    };
+    activeWatchers.set(config.specId, { state, controller });
+    for (const watchedPath of config.watchedPaths) {
+        watchDirectory(watchedPath, (filename) => {
+            runCriteriaCheck(config, filename).catch(() => {
+                // Silently ignore errors during criteria check
+            });
+        }, controller.signal);
+    }
+    return state;
+}
+/**
+ * Stop a running watcher. Returns true if it was running, false if not found.
+ */
+export function stopWatcher(specId) {
+    const entry = activeWatchers.get(specId);
+    if (!entry) {
+        return false;
+    }
+    entry.controller.abort();
+    entry.state.active = false;
+    activeWatchers.delete(specId);
+    return true;
+}
+/**
+ * Get the current state of a watcher. Returns null if not running.
+ */
+export function getWatcherState(specId) {
+    return activeWatchers.get(specId)?.state ?? null;
+}
+/**
+ * List all active watcher states.
+ */
+export function listActiveWatchers() {
+    return [...activeWatchers.values()].map((e) => e.state);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/drift-watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/drift-watcher/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEjF,+DAA+D;AAC/D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEvD,KAAK,UAAU,gBAAgB,CAAC,MAA0B,EAAE,QAAgB;IAC1E,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC1B,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEhE,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClE,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAiB;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,CAAC;KACd,CAAC;IAEF,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAEzD,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC9C,cAAc,CACZ,WAAW,EACX,CAAC,QAAQ,EAAE,EAAE;YACX,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC5C,+CAA+C;YACjD,CAAC,CAAC,CAAC;QACL,CAAC,EACD,UAAU,CAAC,MAAM,CAClB,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACzB,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;IAC3B,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/engine/mcp-gateway/gateway-registry.d.ts

@@ -0,0 +1,19 @@
+import type { DiscoveredGateway, GatewayRegistry } from '../../types/mcp-gateway.js';
+/**
+ * Run a full discovery pass:
+ * 1. Optionally scan default localhost ports.
+ * 2. Probe any explicitly provided URLs.
+ * 3. Persist every found gateway via mergeGateway (upsert).
+ *
+ * Returns all gateways found in this pass (may be empty).
+ */
+export declare function discoverGateways(urls: string[], includeLocalhost: boolean): Promise<DiscoveredGateway[]>;
+/**
+ * Load the full gateway registry and return it along with the active subset.
+ * Encapsulates storage access so tool handlers don't import storage directly.
+ */
+export declare function getGatewayStatus(): Promise<{
+    registry: GatewayRegistry;
+    active: DiscoveredGateway[];
+}>;
+//# sourceMappingURL=gateway-registry.d.ts.map

package/dist/engine/mcp-gateway/gateway-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-registry.d.ts","sourceRoot":"","sources":["../../../src/engine/mcp-gateway/gateway-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIrF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgB9B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B,CAAC,CAID"}

package/dist/engine/mcp-gateway/gateway-registry.js

@@ -0,0 +1,33 @@
+import { scanLocalhostPorts, scanUrls } from './gateway-scanner.js';
+import { mergeGateway, loadRegistry, listActive } from '../../storage/gateway-store.js';
+/**
+ * Run a full discovery pass:
+ * 1. Optionally scan default localhost ports.
+ * 2. Probe any explicitly provided URLs.
+ * 3. Persist every found gateway via mergeGateway (upsert).
+ *
+ * Returns all gateways found in this pass (may be empty).
+ */
+export async function discoverGateways(urls, includeLocalhost) {
+    const found = [];
+    if (includeLocalhost) {
+        found.push(...(await scanLocalhostPorts()));
+    }
+    if (urls.length > 0) {
+        found.push(...(await scanUrls(urls)));
+    }
+    for (const gw of found) {
+        await mergeGateway(gw);
+    }
+    return found;
+}
+/**
+ * Load the full gateway registry and return it along with the active subset.
+ * Encapsulates storage access so tool handlers don't import storage directly.
+ */
+export async function getGatewayStatus() {
+    const registry = await loadRegistry();
+    const active = listActive(registry);
+    return { registry, active };
+}
+//# sourceMappingURL=gateway-registry.js.map

package/dist/engine/mcp-gateway/gateway-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-registry.js","sourceRoot":"","sources":["../../../src/engine/mcp-gateway/gateway-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAExF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAc,EACd,gBAAyB;IAEzB,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IAIpC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/engine/mcp-gateway/gateway-scanner.d.ts

@@ -0,0 +1,17 @@
+import type { DiscoveredGateway } from '../../types/mcp-gateway.js';
+/**
+ * Probe a single base URL for a /.well-known/mcp manifest.
+ * Returns null when the endpoint is absent, non-OK, or times out.
+ */
+export declare function probeGatewayUrl(baseUrl: string): Promise<DiscoveredGateway | null>;
+/**
+ * Scan all default localhost ports in parallel.
+ * Returns only the gateways that responded successfully.
+ */
+export declare function scanLocalhostPorts(): Promise<DiscoveredGateway[]>;
+/**
+ * Scan a list of explicit URLs in parallel.
+ * Returns only the gateways that responded successfully.
+ */
+export declare function scanUrls(urls: string[]): Promise<DiscoveredGateway[]>;
+//# sourceMappingURL=gateway-scanner.d.ts.map

package/dist/engine/mcp-gateway/gateway-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-scanner.d.ts","sourceRoot":"","sources":["../../../src/engine/mcp-gateway/gateway-scanner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,4BAA4B,CAAC;AAQxF;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkCxF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAUvE;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAQ3E"}

package/dist/engine/mcp-gateway/gateway-scanner.js

@@ -0,0 +1,62 @@
+const WELL_KNOWN_PATH = '/.well-known/mcp';
+const DEFAULT_TIMEOUT_MS = 3000;
+/** Default localhost ports to scan for MCP servers. */
+const DEFAULT_LOCAL_PORTS = [3000, 3001, 8080, 8000, 9000];
+/**
+ * Probe a single base URL for a /.well-known/mcp manifest.
+ * Returns null when the endpoint is absent, non-OK, or times out.
+ */
+export async function probeGatewayUrl(baseUrl) {
+    try {
+        const url = `${baseUrl.replace(/\/$/, '')}${WELL_KNOWN_PATH}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => {
+            controller.abort();
+        }, DEFAULT_TIMEOUT_MS);
+        let res;
+        try {
+            res = await fetch(url, { signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!res.ok) {
+            return null;
+        }
+        const manifest = (await res.json());
+        const now = new Date().toISOString();
+        return {
+            url: baseUrl,
+            name: manifest.name ?? baseUrl,
+            discoveredAt: now,
+            lastSeenAt: now,
+            planuCompatible: manifest.planuCompatible ?? manifest.tools?.includes('create_spec') ?? false,
+            tools: manifest.tools ?? [],
+            status: 'active',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Scan all default localhost ports in parallel.
+ * Returns only the gateways that responded successfully.
+ */
+export async function scanLocalhostPorts() {
+    const results = await Promise.allSettled(DEFAULT_LOCAL_PORTS.map((port) => probeGatewayUrl(`http://localhost:${port}`)));
+    return results
+        .filter((r) => r.status === 'fulfilled' && r.value !== null)
+        .map((r) => r.value);
+}
+/**
+ * Scan a list of explicit URLs in parallel.
+ * Returns only the gateways that responded successfully.
+ */
+export async function scanUrls(urls) {
+    const results = await Promise.allSettled(urls.map(probeGatewayUrl));
+    return results
+        .filter((r) => r.status === 'fulfilled' && r.value !== null)
+        .map((r) => r.value);
+}
+//# sourceMappingURL=gateway-scanner.js.map

package/dist/engine/mcp-gateway/gateway-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-scanner.js","sourceRoot":"","sources":["../../../src/engine/mcp-gateway/gateway-scanner.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAC3C,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,uDAAuD;AACvD,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAEvB,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,OAAO;YACL,GAAG,EAAE,OAAO;YACZ,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,OAAO;YAC9B,YAAY,EAAE,GAAG;YACjB,UAAU,EAAE,GAAG;YACf,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK;YAC7F,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAC/E,CAAC;IACF,OAAO,OAAO;SACX,MAAM,CACL,CAAC,CAAC,EAAkD,EAAE,CACpD,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAC/C;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAc;IAC3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;IACpE,OAAO,OAAO;SACX,MAAM,CACL,CAAC,CAAC,EAAkD,EAAE,CACpD,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAC/C;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/engine/mcp-gateway/index.d.ts

@@ -0,0 +1,3 @@
+export { probeGatewayUrl, scanLocalhostPorts, scanUrls } from './gateway-scanner.js';
+export { discoverGateways, getGatewayStatus } from './gateway-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/mcp-gateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/mcp-gateway/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/engine/mcp-gateway/index.js

@@ -0,0 +1,4 @@
+// engine/mcp-gateway/index.ts — SPEC-392: Barrel export
+export { probeGatewayUrl, scanLocalhostPorts, scanUrls } from './gateway-scanner.js';
+export { discoverGateways, getGatewayStatus } from './gateway-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/mcp-gateway/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/mcp-gateway/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/engine/multi-repo/companion-spec-builder.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Builds a human-readable description for a companion spec created in a consumer project.
+ */
+export declare function buildCompanionSpecDescription(sourceSpecId: string, sourceProjectPath: string, _consumerProjectPath: string, affectedSymbols: string[], usageLocations: string[]): string;
+/**
+ * Builds a concise title for a companion spec referencing the source spec.
+ */
+export declare function buildCompanionSpecTitle(sourceSpecId: string, symbols: string[]): string;
+//# sourceMappingURL=companion-spec-builder.d.ts.map

package/dist/engine/multi-repo/companion-spec-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-spec-builder.d.ts","sourceRoot":"","sources":["../../../src/engine/multi-repo/companion-spec-builder.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EACzB,oBAAoB,EAAE,MAAM,EAC5B,eAAe,EAAE,MAAM,EAAE,EACzB,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAGvF"}