@planu/cli 1.1.2 → 1.3.0

package/dist/engine/sweep-issue-generator.d.ts

@@ -0,0 +1,14 @@
+import type { CreateSweepIssueResult, SweepStatusResult } from '../types/index.js';
+/**
+ * Build the GitHub issue body for Sweep AI.
+ */
+export declare function buildSweepIssueBody(specId: string, specSlug: string, title: string, description: string, criteria: string[], affectedFiles: string[]): string;
+/**
+ * Generate and optionally create a GitHub issue for Sweep AI.
+ */
+export declare function createSweepIssue(specId: string, projectPath: string, githubRepo: string, dryRun: boolean): Promise<CreateSweepIssueResult>;
+/**
+ * Check whether gh CLI is installed and if the sweep label exists on the repo.
+ */
+export declare function checkSweepStatus(githubRepo: string | undefined): SweepStatusResult;
+//# sourceMappingURL=sweep-issue-generator.d.ts.map

package/dist/engine/sweep-issue-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep-issue-generator.d.ts","sourceRoot":"","sources":["../../src/engine/sweep-issue-generator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwCnF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,sBAAsB,CAAC,CA4DjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAuBlF"}

package/dist/engine/sweep-issue-generator.js

@@ -0,0 +1,140 @@
+// engine/sweep-issue-generator.ts — Pure functions for SPEC-379 Sweep AI Integration
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { parseFrontmatter } from './frontmatter-parser.js';
+import { extractSection, extractListItems } from './validator/extractors.js';
+const SPECS_DIR = 'planu/specs';
+/**
+ * Find the spec directory for a given specId inside projectPath/planu/specs.
+ * Returns null if not found.
+ */
+async function findSpecDir(specId, projectPath) {
+    const specsRoot = join(projectPath, SPECS_DIR);
+    let entries;
+    try {
+        entries = await readdir(specsRoot);
+    }
+    catch {
+        return null;
+    }
+    const prefix = specId.toUpperCase() + '-';
+    const dir = entries.find((e) => e.toUpperCase().startsWith(prefix));
+    if (!dir) {
+        return null;
+    }
+    return join(specsRoot, dir);
+}
+/**
+ * Read a list of affected files from technical.md.
+ * Returns empty array when technical.md is missing or has no list items.
+ */
+async function readAffectedFilesForSweep(specDir) {
+    const techPath = join(specDir, 'technical.md');
+    let raw;
+    try {
+        raw = await readFile(techPath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const section = extractSection(raw, 'affected files', 'archivos afectados');
+    return section ? extractListItems(section) : extractListItems(raw);
+}
+/**
+ * Build the GitHub issue body for Sweep AI.
+ */
+export function buildSweepIssueBody(specId, specSlug, title, description, criteria, affectedFiles) {
+    const criteriaLines = criteria.length > 0
+        ? criteria.map((c) => `- [ ] ${c}`).join('\n')
+        : '- [ ] See spec.md for acceptance criteria';
+    const filesSection = affectedFiles.length > 0
+        ? ['## Affected Files', '', ...affectedFiles.map((f) => `- \`${f}\``), ''].join('\n')
+        : '';
+    return [
+        `## Spec: ${title}`,
+        ``,
+        description || `Implementation of ${specId}.`,
+        ``,
+        `## Acceptance Criteria`,
+        criteriaLines,
+        ``,
+        filesSection,
+        `---`,
+        `Spec: ${specId} | [View in Planu](planu/specs/${specSlug}/spec.md)`,
+    ]
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+/**
+ * Generate and optionally create a GitHub issue for Sweep AI.
+ */
+export async function createSweepIssue(specId, projectPath, githubRepo, dryRun) {
+    const specDir = await findSpecDir(specId, projectPath);
+    if (!specDir) {
+        throw new Error(`Spec directory for ${specId} not found in ${join(projectPath, SPECS_DIR)}. ` +
+            `Ensure the spec exists and follows the SPEC-NNN-slug naming convention.`);
+    }
+    const specMdPath = join(specDir, 'spec.md');
+    let specContent;
+    try {
+        specContent = await readFile(specMdPath, 'utf-8');
+    }
+    catch {
+        throw new Error(`spec.md not found in ${specDir}.`);
+    }
+    const { metadata, body } = parseFrontmatter(specContent);
+    const title = typeof metadata.title === 'string' ? metadata.title : specId;
+    const description = typeof metadata.description === 'string' ? metadata.description : '';
+    const acSection = extractSection(body, 'acceptance criteria', 'criterios de aceptaci');
+    const criteria = acSection ? extractListItems(acSection) : [];
+    const affectedFiles = await readAffectedFilesForSweep(specDir);
+    // Extract the folder name (slug) from the specDir path for the footer link
+    const specSlug = specDir.split('/').pop() ?? specId;
+    const issueBody = buildSweepIssueBody(specId, specSlug, title, description, criteria, affectedFiles);
+    const issueTitle = `feat(${specId}): ${title}`;
+    if (dryRun) {
+        return { body: issueBody, dryRun: true, issueTitle };
+    }
+    // Create the actual GitHub issue using gh CLI
+    const escapedBody = issueBody.replace(/"/g, '\\"').replace(/`/g, '\\`');
+    const cmd = `gh issue create --repo "${githubRepo}" --title "${issueTitle}" --label sweep --body "${escapedBody}"`;
+    let issueUrl;
+    try {
+        issueUrl = execSync(cmd, { encoding: 'utf-8' }).trim();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to create GitHub issue: ${msg}. ` +
+            `Ensure gh is installed, authenticated, and the 'sweep' label exists on the repo.`, { cause: err });
+    }
+    return { issueUrl, body: issueBody, dryRun: false, issueTitle };
+}
+/**
+ * Check whether gh CLI is installed and if the sweep label exists on the repo.
+ */
+export function checkSweepStatus(githubRepo) {
+    try {
+        const out = execSync('which gh', { encoding: 'utf-8' }).trim();
+        if (out.length === 0) {
+            return { ghInstalled: false, sweepLabelExists: false, githubRepo };
+        }
+    }
+    catch {
+        return { ghInstalled: false, sweepLabelExists: false, githubRepo };
+    }
+    if (!githubRepo) {
+        return { ghInstalled: true, sweepLabelExists: false, githubRepo };
+    }
+    let sweepLabelExists;
+    try {
+        const labels = execSync(`gh label list --repo "${githubRepo}"`, { encoding: 'utf-8' });
+        sweepLabelExists = labels.toLowerCase().includes('sweep');
+    }
+    catch {
+        sweepLabelExists = false;
+    }
+    return { ghInstalled: true, sweepLabelExists, githubRepo };
+}
+//# sourceMappingURL=sweep-issue-generator.js.map

package/dist/engine/sweep-issue-generator.js.map

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

package/dist/engine/tech-debt-manager.d.ts

@@ -0,0 +1,12 @@
+import type { TechDebtEntry, TechDebtConfig, TechDebtForecast, TechDebtMetrics } from '../types/index.js';
+/** Generate a simple UUID-like ID for a tech debt item. */
+export declare function generateDebtId(): string;
+/** Compute summary metrics from a list of tech debt items. */
+export declare function computeTechDebtMetrics(items: TechDebtEntry[]): TechDebtMetrics;
+/** Forecast tech debt growth given current items and config. */
+export declare function forecastTechDebt(items: TechDebtEntry[], config: TechDebtConfig): TechDebtForecast;
+/** Generate a simple HTML report of tech debt. */
+export declare function generateTechDebtReport(items: TechDebtEntry[], config: TechDebtConfig): string;
+/** Filter tech debt items by status and/or severity and/or category. */
+export declare function filterDebtItems(items: TechDebtEntry[], status?: string, severity?: string, category?: string): TechDebtEntry[];
+//# sourceMappingURL=tech-debt-manager.d.ts.map

package/dist/engine/tech-debt-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-debt-manager.d.ts","sourceRoot":"","sources":["../../src/engine/tech-debt-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAM3B,2DAA2D;AAC3D,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAMD,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,eAAe,CAoB9E;AA6BD,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,gBAAgB,CA4BjG;AAMD,kDAAkD;AAClD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAyD7F;AAMD,wEAAwE;AACxE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EAAE,EACtB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,EAAE,CAYjB"}

package/dist/engine/tech-debt-manager.js

@@ -0,0 +1,152 @@
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+/** Generate a simple UUID-like ID for a tech debt item. */
+export function generateDebtId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).slice(2, 8);
+    return `debt-${timestamp}-${random}`;
+}
+// ---------------------------------------------------------------------------
+// Metrics
+// ---------------------------------------------------------------------------
+/** Compute summary metrics from a list of tech debt items. */
+export function computeTechDebtMetrics(items) {
+    const open = items.filter((i) => i.status === 'open');
+    const resolved = items.filter((i) => i.status === 'resolved');
+    const bySeverity = {};
+    const byCategory = {};
+    for (const item of open) {
+        bySeverity[item.severity] = (bySeverity[item.severity] ?? 0) + 1;
+        byCategory[item.category] = (byCategory[item.category] ?? 0) + 1;
+    }
+    return {
+        totalItems: items.length,
+        openItems: open.length,
+        resolvedItems: resolved.length,
+        totalOpenHours: open.reduce((acc, i) => acc + i.estimatedHours, 0),
+        bySeverity,
+        byCategory,
+    };
+}
+// ---------------------------------------------------------------------------
+// Forecast
+// ---------------------------------------------------------------------------
+/** Calculate weekly accumulation rate from historical items. */
+function weeklyRate(items) {
+    if (items.length === 0) {
+        return 0;
+    }
+    const sorted = [...items].sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    /* v8 ignore next 2 */
+    if (!first || !last) {
+        return 0;
+    }
+    const spanMs = new Date(last.createdAt).getTime() - new Date(first.createdAt).getTime();
+    const spanWeeks = Math.max(spanMs / (1000 * 60 * 60 * 24 * 7), 1);
+    return items.length / spanWeeks;
+}
+/** Forecast tech debt growth given current items and config. */
+export function forecastTechDebt(items, config) {
+    const open = items.filter((i) => i.status === 'open');
+    const currentOpenHours = open.reduce((acc, i) => acc + i.estimatedHours, 0);
+    const avgHoursPerItem = open.length > 0 ? currentOpenHours / open.length : 4;
+    const weeklyAccumulationRate = weeklyRate(items);
+    const weeklyHoursRate = weeklyAccumulationRate * avgHoursPerItem;
+    const projectedHoursIn4Weeks = currentOpenHours + weeklyHoursRate * 4;
+    const maxHours = config.maxHours ?? null;
+    let weeksUntilBudgetExceeded = null;
+    if (maxHours !== null && weeklyHoursRate > 0) {
+        const remainingCapacity = maxHours - currentOpenHours;
+        if (remainingCapacity <= 0) {
+            weeksUntilBudgetExceeded = 0;
+        }
+        else {
+            weeksUntilBudgetExceeded = Math.ceil(remainingCapacity / weeklyHoursRate);
+        }
+    }
+    return {
+        currentOpenHours,
+        weeklyAccumulationRate,
+        weeksUntilBudgetExceeded,
+        projectedHoursIn4Weeks,
+        budgetMaxHours: maxHours,
+    };
+}
+// ---------------------------------------------------------------------------
+// HTML report
+// ---------------------------------------------------------------------------
+/** Generate a simple HTML report of tech debt. */
+export function generateTechDebtReport(items, config) {
+    const metrics = computeTechDebtMetrics(items);
+    const forecast = forecastTechDebt(items, config);
+    const open = items.filter((i) => i.status === 'open');
+    const severityBadge = (s) => {
+        const colors = {
+            critical: '#dc2626',
+            high: '#ea580c',
+            medium: '#d97706',
+            low: '#16a34a',
+        };
+        const color = colors[s] ?? '#6b7280';
+        return `<span style="background:${color};color:#fff;padding:2px 6px;border-radius:4px;font-size:12px">${s}</span>`;
+    };
+    const rows = open
+        .map((i) => `
+    <tr>
+      <td>${i.id}</td>
+      <td>${i.description}</td>
+      <td>${severityBadge(i.severity)}</td>
+      <td>${i.category}</td>
+      <td>${String(i.estimatedHours)}h</td>
+      <td>${i.specId ?? '-'}</td>
+      <td>${i.createdAt.slice(0, 10)}</td>
+    </tr>`)
+        .join('');
+    return `<!DOCTYPE html>
+<html>
+<head><title>Tech Debt Report</title>
+<style>body{font-family:sans-serif;padding:20px}table{border-collapse:collapse;width:100%}
+th,td{border:1px solid #ddd;padding:8px;text-align:left}th{background:#f3f4f6}</style>
+</head>
+<body>
+<h1>Tech Debt Report</h1>
+<section>
+  <h2>Summary</h2>
+  <p>Open items: <strong>${String(metrics.openItems)}</strong> |
+     Total open hours: <strong>${String(metrics.totalOpenHours)}h</strong> |
+     Resolved: <strong>${String(metrics.resolvedItems)}</strong></p>
+  <p>Weekly accumulation rate: <strong>${forecast.weeklyAccumulationRate.toFixed(1)} items/week</strong></p>
+  ${forecast.weeksUntilBudgetExceeded !== null ? `<p>Budget exceeded in: <strong>${String(forecast.weeksUntilBudgetExceeded)} weeks</strong></p>` : ''}
+  ${forecast.budgetMaxHours !== null ? `<p>Budget max hours: <strong>${String(forecast.budgetMaxHours)}h</strong></p>` : ''}
+</section>
+<section>
+  <h2>Open Debt Items</h2>
+  <table>
+    <tr><th>ID</th><th>Description</th><th>Severity</th><th>Category</th><th>Est. Hours</th><th>Spec</th><th>Created</th></tr>
+    ${rows || '<tr><td colspan="7">No open debt items.</td></tr>'}
+  </table>
+</section>
+</body>
+</html>`;
+}
+// ---------------------------------------------------------------------------
+// Filter helpers
+// ---------------------------------------------------------------------------
+/** Filter tech debt items by status and/or severity and/or category. */
+export function filterDebtItems(items, status, severity, category) {
+    let result = items;
+    if (status && status !== 'all') {
+        result = result.filter((i) => i.status === status);
+    }
+    if (severity) {
+        result = result.filter((i) => i.severity === severity);
+    }
+    if (category) {
+        result = result.filter((i) => i.category === category);
+    }
+    return result;
+}
+//# sourceMappingURL=tech-debt-manager.js.map

package/dist/engine/tech-debt-manager.js.map

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

package/dist/engine/validation-loop.d.ts

@@ -0,0 +1,4 @@
+import type { Spec, SpecHealthScore, ValidationLoopResult } from '../types/index.js';
+export declare function computeSpecHealth(projectPath: string, spec: Spec | undefined): Promise<SpecHealthScore>;
+export declare function buildValidationPlan(specIds: string[], maxIterations: number, testCommand: string, autoFix: boolean): ValidationLoopResult;
+//# sourceMappingURL=validation-loop.d.ts.map

package/dist/engine/validation-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-loop.d.ts","sourceRoot":"","sources":["../../src/engine/validation-loop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,IAAI,EACJ,eAAe,EACf,oBAAoB,EAErB,MAAM,mBAAmB,CAAC;AAyB3B,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,IAAI,GAAG,SAAS,GACrB,OAAO,CAAC,eAAe,CAAC,CAqF1B;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,oBAAoB,CA6BtB"}

package/dist/engine/validation-loop.js

@@ -0,0 +1,133 @@
+// engine/validation-loop.ts — SPEC-369: Test Automation Loop
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+const POINTS_SPEC_COMPLETE = 20;
+const POINTS_TESTS_EXIST = 20;
+const POINTS_TESTS_PASS = 20;
+const POINTS_COVERAGE_OK = 20;
+const POINTS_NO_DRIFT = 20;
+/**
+ * Check if a tests/ directory contains files mentioning the given spec or its tools.
+ */
+async function findTestsForSpec(projectPath, specId) {
+    const testsDir = join(projectPath, 'tests');
+    try {
+        const files = await readdir(testsDir, { recursive: true });
+        const specLower = specId.toLowerCase();
+        return files.some((f) => {
+            const name = typeof f === 'string' ? f : '';
+            return name.toLowerCase().includes(specLower);
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export async function computeSpecHealth(projectPath, spec) {
+    const specId = spec?.id ?? 'unknown';
+    const breakdown = {
+        specComplete: 0,
+        testsExist: 0,
+        testsPass: 0,
+        coverageOk: 0,
+        noDrift: 0,
+    };
+    const details = {};
+    if (!spec) {
+        return { specId, total: 0, breakdown, details: { error: `Spec ${specId} not found` } };
+    }
+    // specComplete: has title + description + non-empty acceptanceCriteria
+    const specData = spec;
+    const hasTitle = typeof spec.title === 'string' && spec.title.trim().length > 0;
+    const hasDescription = typeof specData.description === 'string' && specData.description.trim().length > 0;
+    const hasCriteria = Array.isArray(specData.acceptanceCriteria) &&
+        specData.acceptanceCriteria.length > 0;
+    if (hasTitle && hasDescription && hasCriteria) {
+        breakdown.specComplete = POINTS_SPEC_COMPLETE;
+        details.specComplete = 'OK — title, description, and criteria present';
+    }
+    else {
+        const missing = [];
+        if (!hasTitle) {
+            missing.push('title');
+        }
+        if (!hasDescription) {
+            missing.push('description');
+        }
+        if (!hasCriteria) {
+            missing.push('acceptanceCriteria');
+        }
+        details.specComplete = `Missing: ${missing.join(', ')}`;
+    }
+    // testsExist: check tests/ dir for files mentioning specId
+    const testsFound = await findTestsForSpec(projectPath, specId);
+    if (testsFound) {
+        breakdown.testsExist = POINTS_TESTS_EXIST;
+        details.testsExist = `OK — test file found referencing ${specId}`;
+    }
+    else {
+        details.testsExist = `No test file found for ${specId}`;
+    }
+    // testsPass: 20 if last_validation was successful (not computable in real-time)
+    const lastValidation = specData.lastValidation;
+    if (lastValidation?.passed === true) {
+        breakdown.testsPass = POINTS_TESTS_PASS;
+        details.testsPass = 'OK — last validation passed';
+    }
+    else {
+        details.testsPass = 'No passing validation recorded';
+    }
+    // coverageOk: 20 if spec is done
+    if (spec.status === 'done') {
+        breakdown.coverageOk = POINTS_COVERAGE_OK;
+        details.coverageOk = 'OK — spec is done';
+    }
+    else {
+        details.coverageOk = `Spec status is '${spec.status}', not done`;
+    }
+    // noDrift: 20 if status is done or implementing (no drift registered)
+    const safeDrift = specData.driftScore;
+    const hasDrift = typeof safeDrift === 'number' && safeDrift > 0;
+    if (!hasDrift && (spec.status === 'done' || spec.status === 'implementing')) {
+        breakdown.noDrift = POINTS_NO_DRIFT;
+        details.noDrift = 'OK — no drift detected';
+    }
+    else {
+        details.noDrift = hasDrift ? `Drift score: ${safeDrift}` : `Status: ${spec.status}`;
+    }
+    const total = breakdown.specComplete +
+        breakdown.testsExist +
+        breakdown.testsPass +
+        breakdown.coverageOk +
+        breakdown.noDrift;
+    return { specId, total, breakdown, details };
+}
+export function buildValidationPlan(specIds, maxIterations, testCommand, autoFix) {
+    const plan = specIds.map((specId) => ({
+        specId,
+        steps: [
+            `Run: planu validate --specId ${specId}`,
+            `Run: ${testCommand} -- ${specId}`,
+            autoFix
+                ? `If failing: apply suggested fixes from validate output`
+                : `Review failures manually`,
+            `Re-run validate to confirm`,
+        ],
+        expectedOutcome: 'All acceptance criteria verified, tests green',
+    }));
+    const summary = [
+        `Validation loop plan for ${specIds.length} spec(s), max ${maxIterations} iteration(s).`,
+        `Test command: ${testCommand}`,
+        `Auto-fix: ${autoFix ? 'enabled' : 'disabled'}`,
+        ``,
+        `NOTE: Planu cannot execute shell commands directly. `,
+        `Copy the steps below and run them in your terminal.`,
+    ].join('\n');
+    return {
+        iterations: maxIterations,
+        finalStatus: 'partial',
+        summary,
+        plan,
+    };
+}
+//# sourceMappingURL=validation-loop.js.map

package/dist/engine/validation-loop.js.map

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

package/dist/engine/webhook-server.d.ts

@@ -0,0 +1,19 @@
+import { type IncomingMessage, type ServerResponse, type Server } from 'node:http';
+import type { RouteHandler } from '../types/index.js';
+/** Simple HTTP router for webhook endpoints */
+export declare class WebhookRouter {
+    private readonly routes;
+    add(method: string, path: string | RegExp, handler: RouteHandler): void;
+    handle(req: IncomingMessage, res: ServerResponse): Promise<void>;
+}
+/** Verify Bearer token from Authorization header */
+export declare function verifyBearerToken(req: IncomingMessage, secret: string): boolean;
+export declare function getActiveServer(): Server | null;
+export declare function setActiveServer(server: Server | null): void;
+/** Start the HTTP server on the given port with the provided router */
+export declare function startWebhookServer(port: number, router: WebhookRouter): Promise<Server>;
+/** Stop the active server */
+export declare function stopWebhookServer(): Promise<void>;
+/** Generate OpenAPI 3.0 YAML documentation for the webhook server */
+export declare function generateWebhookOpenApiYaml(port: number): string;
+//# sourceMappingURL=webhook-server.d.ts.map

package/dist/engine/webhook-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-server.d.ts","sourceRoot":"","sources":["../../src/engine/webhook-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAS,MAAM,mBAAmB,CAAC;AAE7D,+CAA+C;AAC/C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAKjE,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BvE;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAO/E;AAKD,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,uEAAuE;AACvE,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB7F;AAED,6BAA6B;AAC7B,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,qEAAqE;AACrE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+E/D"}