@planu/cli 1.1.2 → 1.3.0

package/dist/engine/parallel-safety-engine.js

@@ -0,0 +1,106 @@
+// Planu — parallel safety engine (SPEC-373)
+import { execSync } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+export function getRepoRoot(cwd) {
+    try {
+        return execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf8' }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function detectCurrentWorktreeId(cwd) {
+    const repoRoot = getRepoRoot(cwd);
+    if (!repoRoot) {
+        return null;
+    }
+    const normalCwd = cwd.replace(/\/$/, '');
+    const normalRoot = repoRoot.replace(/\/$/, '');
+    if (normalCwd === normalRoot) {
+        return null;
+    }
+    const match = /agent-([a-f0-9]+)$/.exec(normalCwd);
+    return match ? (match[1] ?? null) : null;
+}
+export function getActiveWorktreeIds(projectPath) {
+    const worktreesDir = join(projectPath, '.claude', 'worktrees');
+    if (!existsSync(worktreesDir)) {
+        return [];
+    }
+    try {
+        return readdirSync(worktreesDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory() && d.name.startsWith('agent-'))
+            .map((d) => d.name.replace('agent-', ''));
+    }
+    catch {
+        return [];
+    }
+}
+export function generateSafeAgentNames(numAgents, activeIds, currentId) {
+    const blocked = new Set([...activeIds, ...(currentId ? [currentId] : [])]);
+    const names = [];
+    let attempt = 0;
+    while (names.length < numAgents && attempt < 1000) {
+        const ts = Date.now().toString(16).slice(-6);
+        const rand = Math.floor(Math.random() * 0xffff)
+            .toString(16)
+            .padStart(4, '0');
+        const id = `${ts}${rand}`;
+        if (!blocked.has(id)) {
+            names.push(`safe-agent-${id}`);
+            blocked.add(id);
+        }
+        attempt++;
+    }
+    return names;
+}
+export function checkParallelSafety(cwd, projectPath, numAgents = 6) {
+    const currentWorktreeId = detectCurrentWorktreeId(cwd);
+    const isInsideWorktree = currentWorktreeId !== null;
+    const activeWorktreeIds = getActiveWorktreeIds(projectPath);
+    const safeAgentNames = generateSafeAgentNames(numAgents, activeWorktreeIds, currentWorktreeId);
+    let riskLevel = 'safe';
+    const recommendations = [];
+    if (isInsideWorktree) {
+        riskLevel = 'danger';
+        const prefix = currentWorktreeId ? currentWorktreeId.slice(0, 8) : '';
+        recommendations.push(`You are running inside worktree 'agent-${currentWorktreeId}'. Do NOT use isolation:worktree for subagents — use named branches instead.`, `Use the provided safeAgentNames as the 'name:' parameter for each Agent tool call to avoid collisions.`, `If you must use isolation:worktree, ensure each agent has a unique name that does NOT start with '${prefix}'.`);
+    }
+    else if (activeWorktreeIds.length > 0) {
+        riskLevel = 'warning';
+        recommendations.push(`${activeWorktreeIds.length} active worktrees detected. Use the provided safeAgentNames to avoid collisions.`);
+    }
+    else {
+        recommendations.push('Environment is safe for parallel agent execution with isolation:worktree.');
+    }
+    return {
+        isInsideWorktree,
+        currentWorktreeId,
+        activeWorktreeIds,
+        safeAgentNames,
+        riskLevel,
+        recommendations,
+    };
+}
+export const PARALLEL_WORKTREE_SAFETY_RULE = `# parallel-worktree-safety
+
+## Problem
+When Claude Code runs inside a worktree (.claude/worktrees/agent-XXXX) and launches subagents
+with \`isolation: "worktree"\`, a silent collision can occur if the new agent receives an ID whose
+prefix matches the parent session's worktree. The result: the agent writes into the parent
+session's worktree instead of a new one, and the work is lost when the worktree is cleaned up.
+
+## Solution
+Before launching parallel agents, call \`check_parallel_safety\` to:
+1. Detect if you're inside a worktree
+2. Get a list of safe agent names that won't collide
+3. Use those names as the \`name:\` parameter in Agent tool calls
+
+## Rules
+- NEVER use \`isolation: "worktree"\` when already inside a worktree
+- ALWAYS pass explicit \`name:\` to Agent tool calls when running parallel sessions
+- USE \`check_parallel_safety\` at session start if launching 3+ parallel agents
+- IF in a worktree, use manual branch strategy instead of isolation:worktree
+`;
+//# sourceMappingURL=parallel-safety-engine.js.map

package/dist/engine/parallel-safety-engine.js.map

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

package/dist/engine/pr-spec-validator.d.ts

@@ -0,0 +1,25 @@
+import type { CriterionComplianceResult, CriterionStatus, ReviewPrAgainstSpecResult, PrAgentStatusResult } from '../types/index.js';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+export declare function extractAcceptanceCriteria(specContent: string): string[];
+/** Resolve spec directory from specId and projectPath. */
+export declare function resolveSpecDir(specId: string, projectPath: string): Promise<string | null>;
+/** Read spec.md content for a given specId. */
+export declare function readSpecContent(specId: string, projectPath: string): Promise<string | null>;
+/** Run `gh pr diff` and return the diff text, or null on failure. */
+export declare function fetchPrDiff(prNumber: number, githubRepo: string): string | null;
+/** Check if a criterion is matched in the diff. */
+export declare function checkCriterion(criterion: string, diff: string): CriterionStatus;
+/** Build compliance results from criteria and diff. */
+export declare function buildComplianceResults(criteria: string[], diff: string): CriterionComplianceResult[];
+/** Calculate compliance score (0-100, rounded integer). */
+export declare function calcComplianceScore(results: CriterionComplianceResult[]): number;
+/** Build the human-readable summary string. */
+export declare function buildSummary(score: number, results: CriterionComplianceResult[], specId: string, prNumber: number): string;
+/** Run the full PR compliance check. */
+export declare function reviewPrAgainstSpec(specId: string, projectPath: string, prNumber: number, githubRepo: string): Promise<ReviewPrAgainstSpecResult | {
+    isError: true;
+    message: string;
+}>;
+/** Check gh CLI installation and PR agent configuration. */
+export declare function checkPrAgentStatus(projectPath: string): PrAgentStatusResult;
+//# sourceMappingURL=pr-spec-validator.d.ts.map

package/dist/engine/pr-spec-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-spec-validator.d.ts","sourceRoot":"","sources":["../../src/engine/pr-spec-validator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,yEAAyE;AACzE,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvE;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYhG;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUjG;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS/E;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAgB/E;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,GACX,yBAAyB,EAAE,CAK7B;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,MAAM,CAMhF;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,EAAE,EACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR;AAED,wCAAwC;AACxC,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBzE;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAwC3E"}

package/dist/engine/pr-spec-validator.js

@@ -0,0 +1,172 @@
+// Planu — PR Spec Validator (SPEC-380)
+// Pure functions for validating PR diffs against spec acceptance criteria.
+import { readFile } from 'node:fs/promises';
+import { execSync } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+export function extractAcceptanceCriteria(specContent) {
+    const lines = specContent.split('\n');
+    const criteria = [];
+    for (const line of lines) {
+        const match = /^\s*-\s*\[[ xX]?\]\s+(.+)$/.exec(line);
+        if (match?.[1]) {
+            criteria.push(match[1].trim());
+        }
+    }
+    return criteria;
+}
+/** Resolve spec directory from specId and projectPath. */
+export async function resolveSpecDir(specId, projectPath) {
+    const { readdir } = await import('node:fs/promises');
+    const specsBase = join(projectPath, 'planu', 'specs');
+    let entries;
+    try {
+        entries = await readdir(specsBase);
+    }
+    catch {
+        return null;
+    }
+    const upper = specId.toUpperCase();
+    const match = entries.find((e) => e.toUpperCase().startsWith(upper));
+    return match ? join(specsBase, match) : null;
+}
+/** Read spec.md content for a given specId. */
+export async function readSpecContent(specId, projectPath) {
+    const specDir = await resolveSpecDir(specId, projectPath);
+    if (!specDir) {
+        return null;
+    }
+    try {
+        return await readFile(join(specDir, 'spec.md'), 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Run `gh pr diff` and return the diff text, or null on failure. */
+export function fetchPrDiff(prNumber, githubRepo) {
+    try {
+        return execSync(`gh pr diff ${prNumber} --repo ${githubRepo}`, {
+            encoding: 'utf8',
+            timeout: 30000,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/** Check if a criterion is matched in the diff. */
+export function checkCriterion(criterion, diff) {
+    if (!diff.trim()) {
+        return 'unknown';
+    }
+    const words = criterion
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 3);
+    if (words.length === 0) {
+        return 'unknown';
+    }
+    const diffLower = diff.toLowerCase();
+    const anyMatch = words.some((w) => diffLower.includes(w));
+    return anyMatch ? 'matched' : 'unmatched';
+}
+/** Build compliance results from criteria and diff. */
+export function buildComplianceResults(criteria, diff) {
+    return criteria.map((criterion) => ({
+        criterion,
+        status: checkCriterion(criterion, diff),
+    }));
+}
+/** Calculate compliance score (0-100, rounded integer). */
+export function calcComplianceScore(results) {
+    if (results.length === 0) {
+        return 0;
+    }
+    const matched = results.filter((r) => r.status === 'matched').length;
+    return Math.round((matched / results.length) * 100);
+}
+/** Build the human-readable summary string. */
+export function buildSummary(score, results, specId, prNumber) {
+    const matched = results.filter((r) => r.status === 'matched').length;
+    const unmatched = results.filter((r) => r.status === 'unmatched').length;
+    const unknown = results.filter((r) => r.status === 'unknown').length;
+    const parts = [
+        `PR #${prNumber} vs ${specId}: ${score}% compliance`,
+        `${matched} matched, ${unmatched} unmatched, ${unknown} unknown out of ${results.length} criteria`,
+    ];
+    if (score === 100) {
+        parts.push('All acceptance criteria appear to be addressed in the diff.');
+    }
+    else if (score >= 70) {
+        parts.push('Most criteria are covered. Review unmatched items before merging.');
+    }
+    else {
+        parts.push('Several criteria are not clearly addressed. Manual review recommended.');
+    }
+    return parts.join('\n');
+}
+/** Run the full PR compliance check. */
+export async function reviewPrAgainstSpec(specId, projectPath, prNumber, githubRepo) {
+    const specContent = await readSpecContent(specId, projectPath);
+    if (!specContent) {
+        return { isError: true, message: `Spec ${specId} not found in ${projectPath}/planu/specs/` };
+    }
+    const diff = fetchPrDiff(prNumber, githubRepo);
+    if (diff === null) {
+        return {
+            isError: true,
+            message: `Failed to fetch PR diff. Ensure 'gh' CLI is installed and authenticated, and that repo '${githubRepo}' and PR #${prNumber} are valid.`,
+        };
+    }
+    const criteria = extractAcceptanceCriteria(specContent);
+    const results = buildComplianceResults(criteria, diff);
+    const complianceScore = calcComplianceScore(results);
+    const summary = buildSummary(complianceScore, results, specId, prNumber);
+    return { specId, prNumber, complianceScore, criteria: results, summary };
+}
+/** Check gh CLI installation and PR agent configuration. */
+export function checkPrAgentStatus(projectPath) {
+    let ghInstalled = false;
+    try {
+        execSync('which gh', { encoding: 'utf8', timeout: 5000 });
+        ghInstalled = true;
+    }
+    catch {
+        // gh not installed
+    }
+    const workflowsDir = join(projectPath, '.github', 'workflows');
+    let prAgentConfigured = false;
+    let configuredTool = null;
+    if (existsSync(workflowsDir)) {
+        try {
+            const files = readdirSync(workflowsDir);
+            for (const file of files) {
+                const filePath = join(workflowsDir, file);
+                try {
+                    const content = readFileSync(filePath, 'utf8');
+                    if (content.includes('qodo')) {
+                        prAgentConfigured = true;
+                        configuredTool = 'qodo';
+                        break;
+                    }
+                    if (content.includes('pr-agent')) {
+                        prAgentConfigured = true;
+                        configuredTool = 'pr-agent';
+                        break;
+                    }
+                }
+                catch {
+                    // skip unreadable file
+                }
+            }
+        }
+        catch {
+            // skip unreadable dir
+        }
+    }
+    return { ghInstalled, prAgentConfigured, configuredTool };
+}
+//# sourceMappingURL=pr-spec-validator.js.map

package/dist/engine/pr-spec-validator.js.map

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

package/dist/engine/schema-generator.d.ts

@@ -0,0 +1,6 @@
+import type { DetectedEntity, SchemaGenerationResult, SchemaLibrary, SchemaOutputFormat, ApiClientResult, ApiClientFramework, DetectedApiRoute } from '../types/index.js';
+export declare function detectEntities(text: string): DetectedEntity[];
+export declare function generateSchemas(specId: string, specText: string, library: SchemaLibrary, outputFormat: SchemaOutputFormat, outputPath?: string): SchemaGenerationResult;
+export declare function detectRoutes(text: string): DetectedApiRoute[];
+export declare function generateApiClient(specId: string, specText: string, framework: ApiClientFramework, outputPath?: string): ApiClientResult;
+//# sourceMappingURL=schema-generator.d.ts.map

package/dist/engine/schema-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator.d.ts","sourceRoot":"","sources":["../../src/engine/schema-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAGd,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAY3B,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAgB7D;AAgOD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,kBAAkB,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,sBAAsB,CAgCxB;AAQD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAgB7D;AA4DD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CAYjB"}

package/dist/engine/schema-generator.js

@@ -0,0 +1,321 @@
+// engine/schema-generator.ts — Validation Schema Generator (SPEC-365)
+// ---------------------------------------------------------------------------
+// Entity detection
+// ---------------------------------------------------------------------------
+const ENTITY_KEYWORDS = ['entity', 'model', 'schema', 'interface', 'type', 'object'];
+const ENTITY_NAME_RE = new RegExp(`(?:${ENTITY_KEYWORDS.join('|')})\\s+([A-Z][a-zA-Z0-9]+)`, 'gi');
+const FIELD_RE = /([a-z][a-zA-Z0-9]+)\s*(?::|is|as)\s*(string|number|boolean|date|uuid|email|url|int|float|array|object)\b/gi;
+const OPTIONAL_RE = /optional|nullable|\?/i;
+export function detectEntities(text) {
+    const entityNames = new Set();
+    let match;
+    ENTITY_NAME_RE.lastIndex = 0;
+    while ((match = ENTITY_NAME_RE.exec(text)) !== null) {
+        const name = match[1];
+        if (name !== undefined) {
+            entityNames.add(name);
+        }
+    }
+    return Array.from(entityNames).map((name) => ({
+        name,
+        fields: detectFields(text, name),
+    }));
+}
+function detectFields(text, _entityName) {
+    const fields = [];
+    const seen = new Set();
+    FIELD_RE.lastIndex = 0;
+    let m;
+    while ((m = FIELD_RE.exec(text)) !== null) {
+        const fieldName = m[1];
+        const rawType = m[2];
+        if (fieldName === undefined || rawType === undefined) {
+            continue;
+        }
+        if (seen.has(fieldName)) {
+            continue;
+        }
+        seen.add(fieldName);
+        const type = normalizeType(rawType);
+        const surrounding = text.substring(Math.max(0, m.index - 40), m.index + 40);
+        const optional = OPTIONAL_RE.test(surrounding);
+        const validations = buildValidations(rawType, fieldName);
+        fields.push({ name: fieldName, type, optional, validations });
+    }
+    return fields;
+}
+function normalizeType(raw) {
+    const r = raw.toLowerCase();
+    if (r === 'string' || r === 'email' || r === 'url' || r === 'uuid') {
+        return 'string';
+    }
+    if (r === 'number' || r === 'int' || r === 'float') {
+        return 'number';
+    }
+    if (r === 'boolean') {
+        return 'boolean';
+    }
+    if (r === 'date') {
+        return 'date';
+    }
+    return 'unknown';
+}
+function buildValidations(raw, fieldName) {
+    const validations = [];
+    const r = raw.toLowerCase();
+    if (r === 'uuid') {
+        validations.push('uuid');
+    }
+    if (r === 'email') {
+        validations.push('email');
+    }
+    if (r === 'url') {
+        validations.push('url');
+    }
+    if (fieldName.toLowerCase().includes('id')) {
+        validations.push('min(1)');
+    }
+    return validations;
+}
+// ---------------------------------------------------------------------------
+// Code generators
+// ---------------------------------------------------------------------------
+function zodTypeFor(field) {
+    if (field.type === 'unknown') {
+        return 'z.unknown() /* TODO: verify type */';
+    }
+    let base;
+    switch (field.type) {
+        case 'string':
+            base = 'z.string()';
+            if (field.validations.includes('uuid')) {
+                base += '.uuid()';
+            }
+            if (field.validations.includes('email')) {
+                base += '.email()';
+            }
+            if (field.validations.includes('url')) {
+                base += '.url()';
+            }
+            if (field.validations.includes('min(1)')) {
+                base += '.min(1)';
+            }
+            break;
+        case 'number':
+            base = 'z.number()';
+            break;
+        case 'boolean':
+            base = 'z.boolean()';
+            break;
+        case 'date':
+            base = 'z.string().datetime()';
+            break;
+        default:
+            base = 'z.unknown()';
+    }
+    if (field.optional) {
+        base += '.optional()';
+    }
+    return base;
+}
+function yupTypeFor(field) {
+    if (field.type === 'unknown') {
+        return 'yup.mixed() /* TODO: verify type */';
+    }
+    let base;
+    switch (field.type) {
+        case 'string':
+            base = 'yup.string()';
+            if (field.validations.includes('email')) {
+                base += '.email()';
+            }
+            if (field.validations.includes('url')) {
+                base += '.url()';
+            }
+            if (!field.optional) {
+                base += '.required()';
+            }
+            break;
+        case 'number':
+            base = field.optional ? 'yup.number()' : 'yup.number().required()';
+            break;
+        case 'boolean':
+            base = 'yup.boolean()';
+            break;
+        case 'date':
+            base = 'yup.date()';
+            break;
+        default:
+            base = 'yup.mixed()';
+    }
+    return base;
+}
+function valibotTypeFor(field) {
+    if (field.type === 'unknown') {
+        return 'v.unknown() /* TODO: verify type */';
+    }
+    let base;
+    switch (field.type) {
+        case 'string':
+            base = 'v.string()';
+            if (field.validations.includes('email')) {
+                base = 'v.pipe(v.string(), v.email())';
+            }
+            if (field.validations.includes('uuid')) {
+                base = 'v.pipe(v.string(), v.uuid())';
+            }
+            break;
+        case 'number':
+            base = 'v.number()';
+            break;
+        case 'boolean':
+            base = 'v.boolean()';
+            break;
+        case 'date':
+            base = 'v.date()';
+            break;
+        default:
+            base = 'v.unknown()';
+    }
+    if (field.optional) {
+        base = `v.optional(${base})`;
+    }
+    return base;
+}
+function generateZodSchema(entities, format) {
+    const importLine = format === 'typescript' ? "import { z } from 'zod';" : "const { z } = require('zod');";
+    const schemas = entities
+        .map((entity) => {
+        const fields = entity.fields.map((f) => `  ${f.name}: ${zodTypeFor(f)},`).join('\n');
+        return `export const ${entity.name}Schema = z.object({\n${fields}\n});`;
+    })
+        .join('\n\n');
+    return `${importLine}\n\n${schemas}\n`;
+}
+function generateYupSchema(entities, format) {
+    const importLine = format === 'typescript' ? "import * as yup from 'yup';" : "const yup = require('yup');";
+    const schemas = entities
+        .map((entity) => {
+        const fields = entity.fields.map((f) => `  ${f.name}: ${yupTypeFor(f)},`).join('\n');
+        return `export const ${entity.name}Schema = yup.object({\n${fields}\n});`;
+    })
+        .join('\n\n');
+    return `${importLine}\n\n${schemas}\n`;
+}
+function generateValibotSchema(entities, format) {
+    const importLine = format === 'typescript' ? "import * as v from 'valibot';" : "const v = require('valibot');";
+    const schemas = entities
+        .map((entity) => {
+        const fields = entity.fields.map((f) => `  ${f.name}: ${valibotTypeFor(f)},`).join('\n');
+        return `export const ${entity.name}Schema = v.object({\n${fields}\n});`;
+    })
+        .join('\n\n');
+    return `${importLine}\n\n${schemas}\n`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function generateSchemas(specId, specText, library, outputFormat, outputPath) {
+    const entities = detectEntities(specText);
+    const schemas = [];
+    const libs = library === 'all' ? ['zod', 'yup', 'valibot'] : [library];
+    for (const lib of libs) {
+        let code;
+        switch (lib) {
+            case 'zod':
+                code = generateZodSchema(entities, outputFormat);
+                break;
+            case 'yup':
+                code = generateYupSchema(entities, outputFormat);
+                break;
+            case 'valibot':
+                code = generateValibotSchema(entities, outputFormat);
+                break;
+        }
+        schemas.push({ library: lib, code, entities: entities.map((e) => e.name) });
+    }
+    return {
+        specId,
+        library,
+        outputFormat,
+        schemas,
+        entitiesDetected: entities.length,
+        ...(outputPath !== undefined ? { outputPath } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Route detection for API client
+// ---------------------------------------------------------------------------
+const ROUTE_RE = /\b(GET|POST|PUT|PATCH|DELETE)\s+(\/api\/[^\s,)]+)/gi;
+export function detectRoutes(text) {
+    const routes = [];
+    ROUTE_RE.lastIndex = 0;
+    let m;
+    while ((m = ROUTE_RE.exec(text)) !== null) {
+        const rawMethod = m[1];
+        const path = m[2];
+        if (rawMethod === undefined || path === undefined) {
+            continue;
+        }
+        const method = rawMethod.toUpperCase();
+        routes.push({ method, path, description: `${method} ${path}` });
+    }
+    return routes;
+}
+function routeToFunctionName(method, path) {
+    const segments = path.replace('/api/', '').replace(/[/:]/g, '_').replace(/_+$/, '');
+    return `${method.toLowerCase()}${segments
+        .split('_')
+        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+        .join('')}`;
+}
+function generateFetchClient(routes) {
+    const functions = routes
+        .map((r) => {
+        const fnName = routeToFunctionName(r.method, r.path);
+        const hasBody = ['POST', 'PUT', 'PATCH'].includes(r.method);
+        const bodyParam = hasBody ? 'body: unknown, ' : '';
+        const bodyOpts = hasBody
+            ? `\n    body: JSON.stringify(body),\n    headers: { 'Content-Type': 'application/json' },`
+            : '';
+        return (`export async function ${fnName}(${bodyParam}options?: RequestInit): Promise<Response> {\n` +
+            `  return fetch('${r.path}', { method: '${r.method}',${bodyOpts} ...options });\n` +
+            `}`);
+    })
+        .join('\n\n');
+    return `// Auto-generated fetch client\n\n${functions}\n`;
+}
+function generateTanstackClient(routes) {
+    const queries = routes
+        .map((r) => {
+        const fnName = routeToFunctionName(r.method, r.path);
+        const hasBody = ['POST', 'PUT', 'PATCH'].includes(r.method);
+        if (r.method === 'GET') {
+            return (`export function use${fnName.charAt(0).toUpperCase() + fnName.slice(1)}() {\n` +
+                `  return useQuery({ queryKey: ['${r.path}'], queryFn: () => fetch('${r.path}').then(r => r.json()) });\n` +
+                `}`);
+        }
+        const bodyParam = hasBody ? 'body: unknown' : '';
+        return (`export function use${fnName.charAt(0).toUpperCase() + fnName.slice(1)}() {\n` +
+            `  return useMutation({ mutationFn: (${bodyParam}) => fetch('${r.path}', {\n` +
+            `    method: '${r.method}',\n` +
+            `    body: JSON.stringify(body),\n` +
+            `    headers: { 'Content-Type': 'application/json' },\n` +
+            `  }).then(r => r.json()) });\n` +
+            `}`);
+    })
+        .join('\n\n');
+    return `// Auto-generated TanStack Query client\nimport { useQuery, useMutation } from '@tanstack/react-query';\n\n${queries}\n`;
+}
+export function generateApiClient(specId, specText, framework, outputPath) {
+    const routes = detectRoutes(specText);
+    const code = framework === 'fetch' ? generateFetchClient(routes) : generateTanstackClient(routes);
+    return {
+        specId,
+        framework,
+        code,
+        routesDetected: routes.length,
+        ...(outputPath !== undefined ? { outputPath } : {}),
+    };
+}
+//# sourceMappingURL=schema-generator.js.map