@planu/cli 0.91.0 → 0.92.0

package/dist/storage/spec-lock-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-lock-store.d.ts","sourceRoot":"","sources":["../../src/storage/spec-lock-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAclD,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEjD;AAMD;;;GAGG;AACH,wBAAsB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAY3F;AAED,mEAAmE;AACnE,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjG;AAED,wEAAwE;AACxE,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAanF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA6B9E;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMpF"}

package/dist/storage/spec-lock-store.js

@@ -0,0 +1,99 @@
+// storage/spec-lock-store.ts — Persists spec locks (SPEC-301)
+// Layout: data/projects/{hash}/locks/{specId}.json
+import { readFile, readdir, unlink } from 'node:fs/promises';
+import { writeJson, projectDataDir, hashProjectPath } from './base-store.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function locksDir(projectId) {
+    return `${projectDataDir(projectId)}/locks`;
+}
+function lockFile(projectId, specId) {
+    return `${locksDir(projectId)}/${specId}.json`;
+}
+/** Returns true when the lock's expiration time is in the past. */
+export function isExpired(lock) {
+    return new Date(lock.expiresAt).getTime() <= Date.now();
+}
+// ---------------------------------------------------------------------------
+// Store functions
+// ---------------------------------------------------------------------------
+/**
+ * Read a lock from disk. Returns null if the file does not exist.
+ * Does NOT filter out expired locks — callers must check isExpired().
+ */
+export async function getLock(projectPath, specId) {
+    const projectId = hashProjectPath(projectPath);
+    const filePath = lockFile(projectId, specId);
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return null;
+        }
+        throw err;
+    }
+}
+/** Write a lock to disk, creating parent directories as needed. */
+export async function saveLock(projectPath, specId, lock) {
+    const projectId = hashProjectPath(projectPath);
+    await writeJson(lockFile(projectId, specId), lock);
+}
+/** Remove a lock file. Silently succeeds if the file does not exist. */
+export async function deleteLock(projectPath, specId) {
+    const projectId = hashProjectPath(projectPath);
+    const filePath = lockFile(projectId, specId);
+    try {
+        await unlink(filePath);
+    }
+    catch (err) {
+        /* v8 ignore start */
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return;
+        }
+        throw err;
+        /* v8 ignore stop */
+    }
+}
+/**
+ * Return all active (non-expired) locks for a project.
+ * Reads all .json files from the locks/ directory and filters out expired ones.
+ */
+export async function listActiveLocks(projectPath) {
+    const projectId = hashProjectPath(projectPath);
+    const dir = locksDir(projectId);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return [];
+        }
+        /* v8 ignore next */
+        throw err;
+    }
+    const jsonFiles = entries.filter((e) => e.endsWith('.json'));
+    const locks = [];
+    await Promise.all(jsonFiles.map(async (file) => {
+        const specId = file.replace(/\.json$/, '');
+        const lock = await getLock(projectPath, specId);
+        if (lock !== null && !isExpired(lock)) {
+            locks.push(lock);
+        }
+    }));
+    return locks;
+}
+/**
+ * Returns true when a non-expired lock exists for the given spec.
+ */
+export async function isLocked(projectPath, specId) {
+    const lock = await getLock(projectPath, specId);
+    if (lock === null) {
+        return false;
+    }
+    return !isExpired(lock);
+}
+//# sourceMappingURL=spec-lock-store.js.map

package/dist/storage/spec-lock-store.js.map

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

package/dist/tools/ai-ecosystem-status.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { ToolResult } from '../types/index.js';
+export declare const AiEcosystemStatusSchema: {
+    readonly projectPath: z.ZodString;
+    readonly projectId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleAiEcosystemStatus(input: {
+    projectPath: string;
+    projectId?: string;
+}): Promise<ToolResult>;
+export declare function registerAiEcosystemStatusTool(server: McpServer): void;
+//# sourceMappingURL=ai-ecosystem-status.d.ts.map

package/dist/tools/ai-ecosystem-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-ecosystem-status.d.ts","sourceRoot":"","sources":["../../src/tools/ai-ecosystem-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AASpD,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AAwMX,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBtB;AAMD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAerE"}

package/dist/tools/ai-ecosystem-status.js

@@ -0,0 +1,219 @@
+import { z } from 'zod';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { detectAiTools } from '../engine/ai-integration/detector.js';
+import { safeTracked } from './safe-handler.js';
+// ---------------------------------------------------------------------------
+// Zod schema
+// ---------------------------------------------------------------------------
+export const AiEcosystemStatusSchema = {
+    projectPath: z.string().describe('Absolute path to the project root'),
+    projectId: z.string().optional().describe('Project ID for Planu context'),
+};
+// ---------------------------------------------------------------------------
+// Health scoring
+// ---------------------------------------------------------------------------
+const HOME = homedir();
+function hasPlanusddSection(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf8');
+        return content.includes('planu-sdd');
+    }
+    catch {
+        /* v8 ignore next */
+        return false;
+    }
+}
+function scoreClaudeCode(projectPath) {
+    const configured = [];
+    const missing = [];
+    if (existsSync(join(projectPath, 'CLAUDE.md'))) {
+        configured.push('CLAUDE.md');
+    }
+    else {
+        missing.push('CLAUDE.md');
+    }
+    if (existsSync(join(projectPath, '.claude', 'hooks'))) {
+        configured.push('hooks');
+    }
+    else {
+        missing.push('hooks');
+    }
+    if (existsSync(join(projectPath, '.claude', 'skills'))) {
+        configured.push('skills');
+    }
+    else {
+        missing.push('skills');
+    }
+    const total = configured.length + missing.length;
+    const score = total > 0 ? Math.round((configured.length / total) * 100) : 0;
+    const suggestions = missing.map((m) => `Add ${m} to improve Claude Code integration`);
+    return { tool: 'claude-code', score, configured, missing, suggestions };
+}
+function scoreCodexCli(projectPath) {
+    const configured = [];
+    const missing = [];
+    if (existsSync(join(projectPath, 'AGENTS.md'))) {
+        configured.push('AGENTS.md');
+    }
+    else {
+        missing.push('AGENTS.md');
+    }
+    const codexConfig = join(HOME, '.codex', 'config.toml');
+    if (existsSync(codexConfig)) {
+        configured.push('.codex/config.toml');
+    }
+    else {
+        missing.push('.codex/config.toml');
+    }
+    const total = configured.length + missing.length;
+    const score = total > 0 ? Math.round((configured.length / total) * 100) : 0;
+    return { tool: 'codex-cli', score, configured, missing, suggestions: [] };
+}
+function scoreGeminiCli(projectPath) {
+    const configured = [];
+    const missing = [];
+    if (existsSync(join(projectPath, 'GEMINI.md'))) {
+        configured.push('GEMINI.md');
+    }
+    else {
+        missing.push('GEMINI.md');
+    }
+    const geminiSettings = join(HOME, '.gemini', 'settings.json');
+    if (existsSync(geminiSettings)) {
+        configured.push('.gemini/settings.json');
+    }
+    else {
+        missing.push('.gemini/settings.json');
+    }
+    const total = configured.length + missing.length;
+    const score = total > 0 ? Math.round((configured.length / total) * 100) : 0;
+    return { tool: 'gemini-cli', score, configured, missing, suggestions: [] };
+}
+function scoreCursor(projectPath) {
+    const configured = [];
+    const missing = [];
+    const suggestions = [];
+    const rulesPath = join(projectPath, '.cursorrules');
+    if (existsSync(rulesPath)) {
+        configured.push('.cursorrules');
+        if (hasPlanusddSection(rulesPath)) {
+            configured.push('planu-sdd section');
+        }
+        else {
+            missing.push('planu-sdd section');
+            suggestions.push('Run sync_ai_configs to inject Planu SDD section into .cursorrules');
+        }
+    }
+    else {
+        missing.push('.cursorrules');
+        suggestions.push('Run sync_ai_configs to generate .cursorrules');
+    }
+    const total = configured.length + missing.length;
+    const score = total > 0 ? Math.round((configured.length / total) * 100) : 0;
+    return { tool: 'cursor', score, configured, missing, suggestions };
+}
+function scoreWindsurf(projectPath) {
+    const configured = [];
+    const missing = [];
+    const suggestions = [];
+    const rulesPath = join(projectPath, '.windsurfrules');
+    if (existsSync(rulesPath)) {
+        configured.push('.windsurfrules');
+        if (hasPlanusddSection(rulesPath)) {
+            configured.push('planu-sdd section');
+        }
+        else {
+            missing.push('planu-sdd section');
+            suggestions.push('Run sync_ai_configs to inject Planu SDD section into .windsurfrules');
+        }
+    }
+    else {
+        missing.push('.windsurfrules');
+        suggestions.push('Run sync_ai_configs to generate .windsurfrules');
+    }
+    const total = configured.length + missing.length;
+    const score = total > 0 ? Math.round((configured.length / total) * 100) : 0;
+    return { tool: 'windsurf', score, configured, missing, suggestions };
+}
+function scoreGeneric(tool) {
+    return {
+        tool,
+        score: 50,
+        configured: ['detected'],
+        missing: ['planu-integration'],
+        suggestions: ['No deep Planu integration available for this tool yet'],
+    };
+}
+const SCORERS = {
+    'claude-code': scoreClaudeCode,
+    'codex-cli': scoreCodexCli,
+    'gemini-cli': scoreGeminiCli,
+    cursor: scoreCursor,
+    windsurf: scoreWindsurf,
+};
+function scoreHealth(tool, projectPath) {
+    const scorer = SCORERS[tool];
+    return scorer !== undefined ? scorer(projectPath) : scoreGeneric(tool);
+}
+// ---------------------------------------------------------------------------
+// Formatter
+// ---------------------------------------------------------------------------
+function formatHealth(health) {
+    const lines = [];
+    lines.push('# AI Ecosystem Health Report');
+    lines.push('');
+    lines.push(`**Overall Score**: ${health.overallScore}/100`);
+    lines.push(`**Scanned At**: ${health.scannedAt}`);
+    lines.push('');
+    lines.push('| Tool | Score | Configured | Missing |');
+    lines.push('|------|-------|-----------|---------|');
+    for (const t of health.tools) {
+        const configuredStr = t.configured.length > 0 ? t.configured.join(', ') : '—';
+        const missingStr = t.missing.length > 0 ? t.missing.join(', ') : '—';
+        lines.push(`| ${t.tool} | ${t.score}/100 | ${configuredStr} | ${missingStr} |`);
+    }
+    const allSuggestions = health.tools.flatMap((t) => t.suggestions);
+    if (allSuggestions.length > 0) {
+        lines.push('');
+        lines.push('## Suggestions');
+        lines.push('');
+        for (const s of allSuggestions) {
+            lines.push(`- ${s}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export function handleAiEcosystemStatus(input) {
+    const scan = detectAiTools(input.projectPath);
+    const detectedTools = scan.tools.filter((t) => t.detected);
+    const toolHealths = detectedTools.map((t) => scoreHealth(t.name, input.projectPath));
+    const overallScore = toolHealths.length > 0
+        ? Math.round(toolHealths.reduce((sum, t) => sum + t.score, 0) / toolHealths.length)
+        : 0;
+    const health = {
+        tools: toolHealths,
+        overallScore,
+        scannedAt: scan.scannedAt,
+    };
+    return Promise.resolve({ content: [{ type: 'text', text: formatHealth(health) }] });
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerAiEcosystemStatusTool(server) {
+    server.registerTool('ecosystem_status', {
+        description: 'Scan the AI tool ecosystem of a project and return a health report showing which AI tools are detected and how well they are configured for Planu SDD workflow.',
+        inputSchema: AiEcosystemStatusSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            title: 'AI Ecosystem Status',
+        },
+    }, safeTracked('ecosystem_status', async (args) => handleAiEcosystemStatus(args)));
+}
+//# sourceMappingURL=ai-ecosystem-status.js.map

package/dist/tools/ai-ecosystem-status.js.map

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

package/dist/tools/api-spec-generator-handler.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateSpecFromApiInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateSpecFromApi(args: GenerateSpecFromApiInput): Promise<ToolResult>;
+//# sourceMappingURL=api-spec-generator-handler.d.ts.map

package/dist/tools/api-spec-generator-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-spec-generator-handler.d.ts","sourceRoot":"","sources":["../../src/tools/api-spec-generator-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,wBAAwB,EAExB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAuI3B,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,UAAU,CAAC,CA+FrB"}

package/dist/tools/api-spec-generator-handler.js

@@ -0,0 +1,193 @@
+// tools/api-spec-generator-handler.ts — generate_spec_from_api tool handler (SPEC-286)
+import { readFile } from 'node:fs/promises';
+import { parseOpenApi } from '../engine/api-spec-generator/openapi-parser.js';
+import { parseGraphQL } from '../engine/api-spec-generator/graphql-parser.js';
+import { buildACs, formatACsAsMarkdown } from '../engine/api-spec-generator/ac-builder.js';
+import { handleCreateSpec } from './create-spec.js';
+// ---------------------------------------------------------------------------
+// Contract detection
+// ---------------------------------------------------------------------------
+function detectContractType(content) {
+    const trimmed = content.trim();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        return 'openapi';
+    }
+    // GraphQL SDL typically has type/schema/query keywords
+    if (/\btype\s+\w+\s*\{/.test(trimmed) || /\bschema\s*\{/.test(trimmed)) {
+        return 'graphql';
+    }
+    // Fallback: attempt JSON parse
+    try {
+        JSON.parse(trimmed);
+        return 'openapi';
+    }
+    catch {
+        return 'graphql';
+    }
+}
+function groupByEndpoint(contract) {
+    return contract.operations.map((op) => ({
+        title: op.title,
+        operations: [op],
+        tags: op.tags,
+    }));
+}
+function groupByResource(contract) {
+    const groups = new Map();
+    for (const op of contract.operations) {
+        const existing = groups.get(op.resourceGroup) ?? [];
+        existing.push(op);
+        groups.set(op.resourceGroup, existing);
+    }
+    return Array.from(groups.entries()).map(([resource, ops]) => ({
+        title: `${resource} CRUD`,
+        operations: ops,
+        tags: [...new Set(ops.flatMap((o) => o.tags))],
+    }));
+}
+function groupByOperation(contract) {
+    // For GraphQL: by-operation is the same as by-endpoint (one spec per operation)
+    // For REST in this mode: group by endpoint as well
+    return groupByEndpoint(contract);
+}
+function groupOperations(contract, mode) {
+    if (mode === 'by-resource') {
+        return groupByResource(contract);
+    }
+    if (mode === 'by-operation') {
+        return groupByOperation(contract);
+    }
+    return groupByEndpoint(contract);
+}
+// ---------------------------------------------------------------------------
+// Spec description builder
+// ---------------------------------------------------------------------------
+function buildSpecDescription(group, contract, extraMeta) {
+    const lines = [];
+    lines.push(`# ${group.title}`, '');
+    lines.push(`**Source**: ${contract.source.toUpperCase()} — ${contract.title} v${contract.version}`, '');
+    if (contract.description.length > 0) {
+        lines.push(contract.description, '');
+    }
+    for (const op of group.operations) {
+        const opLabel = op.method !== undefined
+            ? `${op.method} ${op.path ?? ''}`
+            : `${op.operationType ?? 'operation'}: ${op.externalId}`;
+        lines.push(`## Operation: ${opLabel}`, '');
+        if (op.description.length > 0) {
+            lines.push(op.description, '');
+        }
+        if (op.fields.length > 0) {
+            lines.push('### Fields');
+            for (const f of op.fields) {
+                const req = f.required ? ' *(required)*' : '';
+                const fmt = f.format !== undefined ? ` [format: ${f.format}]` : '';
+                lines.push(`- \`${f.name}\`: ${f.type}${fmt}${req}`);
+            }
+            lines.push('');
+        }
+        const acs = buildACs(op);
+        if (acs.length > 0) {
+            lines.push('### Acceptance Criteria');
+            lines.push(formatACsAsMarkdown(acs));
+            lines.push('');
+        }
+    }
+    // Append extra metadata
+    for (const [k, v] of Object.entries(extraMeta)) {
+        lines.push(`**${k}**: ${v}`);
+    }
+    return lines.join('\n').trim();
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export async function handleGenerateSpecFromApi(args) {
+    // Load content
+    let rawContent;
+    if (args.content !== undefined && args.content.trim().length > 0) {
+        rawContent = args.content;
+    }
+    else if (args.filePath !== undefined && args.filePath.trim().length > 0) {
+        try {
+            rawContent = await readFile(args.filePath, 'utf-8');
+        }
+        catch {
+            return {
+                content: [{ type: 'text', text: `Error: could not read file at ${args.filePath}` }],
+                isError: true,
+            };
+        }
+    }
+    else {
+        return {
+            content: [{ type: 'text', text: 'Error: provide either content or filePath' }],
+            isError: true,
+        };
+    }
+    // Parse contract
+    let contract;
+    const detectedType = detectContractType(rawContent);
+    try {
+        contract = detectedType === 'openapi' ? parseOpenApi(rawContent) : parseGraphQL(rawContent);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: `Error parsing API contract: ${msg}` }],
+            isError: true,
+        };
+    }
+    if (contract.operations.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No operations found in the provided API contract' }],
+            isError: true,
+        };
+    }
+    const groups = groupOperations(contract, args.mode);
+    const extraTags = args.extraTags ?? [];
+    const baseTags = [contract.source, 'api', 'reverse-engineering'];
+    const createdSpecIds = [];
+    const errors = [];
+    for (const group of groups) {
+        const tags = [...new Set([...baseTags, ...group.tags, ...extraTags])];
+        const description = buildSpecDescription(group, contract, {
+            externalId: group.operations.map((o) => o.externalId).join(', '),
+            source: contract.source,
+        });
+        const result = await handleCreateSpec({
+            projectPath: args.projectPath,
+            title: group.title,
+            description,
+            type: 'feature',
+            scope: 'feature',
+            target: 'backend',
+            tags,
+        });
+        if (result.isError === true) {
+            const errText = result.content[0]?.type === 'text' ? result.content[0].text : 'unknown error';
+            errors.push(`Failed to create spec for "${group.title}": ${errText}`);
+            continue;
+        }
+        // Extract the spec ID from the result text
+        const text = result.content[0]?.type === 'text' ? result.content[0].text : '';
+        const specIdMatch = /\*\*SPEC-(\d+)\*\*/.exec(text);
+        if (specIdMatch !== null) {
+            createdSpecIds.push(`SPEC-${specIdMatch[1] ?? '?'}`);
+        }
+    }
+    const summary = [
+        `Generated ${String(createdSpecIds.length)} spec(s) from ${String(contract.operations.length)} endpoints (${contract.source.toUpperCase()}: ${contract.title})`,
+        '',
+        `Mode: ${args.mode}`,
+        `Specs created: ${createdSpecIds.length > 0 ? createdSpecIds.join(', ') : 'none'}`,
+    ];
+    if (errors.length > 0) {
+        summary.push('', 'Errors:', ...errors.map((e) => `- ${e}`));
+    }
+    return {
+        content: [{ type: 'text', text: summary.join('\n') }],
+        isError: false,
+    };
+}
+//# sourceMappingURL=api-spec-generator-handler.js.map

package/dist/tools/api-spec-generator-handler.js.map

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

package/dist/tools/approval-handler.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult, ConfigureApprovalPolicyInput, ApproveSpecInput, RequestChangesInput, ApprovalStatusInput } from '../types/index.js';
+export declare function handleConfigureApprovalPolicy(args: ConfigureApprovalPolicyInput): Promise<ToolResult>;
+export declare function handleApproveSpec(args: ApproveSpecInput): Promise<ToolResult>;
+export declare function handleRequestChanges(args: RequestChangesInput): Promise<ToolResult>;
+export declare function handleApprovalStatus(args: ApprovalStatusInput): Promise<ToolResult>;
+//# sourceMappingURL=approval-handler.d.ts.map

package/dist/tools/approval-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-handler.d.ts","sourceRoot":"","sources":["../../src/tools/approval-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,4BAA4B,EAC5B,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAoB3B,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,UAAU,CAAC,CAyBrB;AAMD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsDnF;AAMD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0DzF;AAMD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsDzF"}