@levironexe/architect 0.1.0

package/dist/planner/plan-generator.js

@@ -0,0 +1,275 @@
+const HIGH_LOC_THRESHOLD = 500;
+export function generateRefactorPlan(context) {
+    const { scan, primarySkill } = context;
+    const steps = [];
+    addStructureSteps(steps, scan);
+    addOversizedFileSteps(steps, scan);
+    addDuplicationSteps(steps, scan);
+    addDependencySteps(steps, scan);
+    addConcernSteps(steps, scan);
+    if (steps.length === 0) {
+        steps.push(createStep(steps, {
+            action: 'consolidate',
+            sourceFile: scan.files[0]?.relativePath ?? null,
+            targetFile: scan.files[0]?.relativePath ?? 'project root',
+            what: 'Keep the current structure and document the conventions that are already working.',
+            why: 'No critical structural issues were found, so a lightweight maintenance roadmap is safer than broad refactoring.',
+            importsToUpdate: [],
+            dependencyNotes: 'None; maintenance step does not require import changes.',
+            risk: 'low',
+            confidence: 'high'
+        }));
+    }
+    const phases = buildPhases(steps);
+    const issueCount = scan.issues?.length ?? 0;
+    return {
+        summary: buildSummary(scan, primarySkill, steps.length),
+        estimatedComplexity: estimateComplexity(scan, steps.length),
+        estimatedRisk: estimateRisk(scan),
+        phases,
+        validationFindings: [],
+        assumptions: buildAssumptions(scan, primarySkill),
+        source: {
+            targetDir: scan.summary.targetDir,
+            primarySkillId: primarySkill?.skill.id ?? null,
+            healthLabel: scan.health?.label ?? 'unavailable',
+            issueCount
+        }
+    };
+}
+function addStructureSteps(steps, scan) {
+    const missingEntries = scan.structureComparison?.entries.filter((entry) => entry.status === 'missing') ?? [];
+    for (const entry of missingEntries.slice(0, 4)) {
+        steps.push(createStep(steps, {
+            action: 'create_dir',
+            sourceFile: null,
+            targetFile: entry.path,
+            what: `Create ${entry.required ? 'required' : 'recommended'} architecture directory for ${trimTrailingPeriod(entry.purpose)}.`,
+            why: 'The detected architecture skill expects this structure and the scan found it missing.',
+            importsToUpdate: [],
+            dependencyNotes: 'None until code is moved into the new directory.',
+            risk: 'low',
+            confidence: 'high'
+        }));
+    }
+}
+function addOversizedFileSteps(steps, scan) {
+    const oversizedFiles = [...scan.files]
+        .filter((file) => file.isOversized || file.hasCriticalComplexity || file.loc >= HIGH_LOC_THRESHOLD)
+        .sort((a, b) => b.loc - a.loc);
+    for (const file of oversizedFiles.slice(0, 4)) {
+        const criticalFunction = file.functions.find((fn) => fn.isFlagged);
+        steps.push(createStep(steps, {
+            action: 'extract',
+            sourceFile: file.relativePath,
+            targetFile: suggestTargetForFile(scan, file.relativePath),
+            what: criticalFunction
+                ? `Extract ${criticalFunction.name} and related logic from ${file.relativePath}.`
+                : `Split high-volume responsibilities out of ${file.relativePath}.`,
+            why: `${file.relativePath} is a structural hotspot with ${file.loc} LOC${criticalFunction ? ` and critical function complexity ${criticalFunction.complexity}` : ''}.`,
+            lineRange: criticalFunction ? `${criticalFunction.startLine}-${criticalFunction.endLine}` : null,
+            importsToUpdate: dependentFiles(scan, file.relativePath),
+            dependencyNotes: dependencyNoteFor(scan, file.relativePath),
+            risk: file.loc >= HIGH_LOC_THRESHOLD ? 'high' : 'medium',
+            confidence: 'high'
+        }));
+    }
+}
+function addDuplicationSteps(steps, scan) {
+    for (const finding of scan.duplication.findings.slice(0, 3)) {
+        const first = finding.occurrences[0];
+        if (!first)
+            continue;
+        steps.push(createStep(steps, {
+            action: 'consolidate',
+            sourceFile: first.relativePath,
+            targetFile: 'src/shared',
+            what: `Consolidate duplicate block shared by ${finding.occurrences.map((item) => item.relativePath).join(', ')}.`,
+            why: `The scan found ${finding.duplicatedLines} duplicated lines that should move behind one reusable abstraction.`,
+            lineRange: `${first.startLine}-${first.endLine}`,
+            importsToUpdate: unique(finding.occurrences.map((item) => item.relativePath)),
+            dependencyNotes: 'Update each duplicate occurrence to import the shared abstraction after consolidation.',
+            risk: finding.occurrences.length > 2 ? 'medium' : 'low',
+            confidence: 'medium'
+        }));
+    }
+}
+function addDependencySteps(steps, scan) {
+    for (const hotspot of scan.dependencyGraph.hotspots.slice(0, 3)) {
+        steps.push(createStep(steps, {
+            action: 'extract',
+            sourceFile: hotspot.relativePath,
+            targetFile: suggestTargetForFile(scan, hotspot.relativePath),
+            what: `Extract stable contracts from dependency hotspot ${hotspot.relativePath}.`,
+            why: `${hotspot.relativePath} is imported by ${hotspot.dependentCount} files, so changes there have broad blast radius.`,
+            importsToUpdate: dependentFiles(scan, hotspot.relativePath),
+            dependencyNotes: dependencyNoteFor(scan, hotspot.relativePath),
+            risk: 'high',
+            confidence: 'high'
+        }));
+    }
+    for (const cycle of scan.dependencyGraph.circularDependencies.slice(0, 2)) {
+        const first = cycle.files[0] ?? null;
+        steps.push(createStep(steps, {
+            action: 'move',
+            sourceFile: first,
+            targetFile: 'src/shared',
+            what: `Break circular dependency ${cycle.files.join(' -> ')} by moving shared logic behind a lower-level module.`,
+            why: 'Circular dependencies make refactors fragile and can produce runtime initialization bugs.',
+            importsToUpdate: unique(cycle.files),
+            dependencyNotes: 'Update both sides of the cycle so higher-level modules depend on the extracted shared module.',
+            risk: 'high',
+            confidence: 'medium'
+        }));
+    }
+}
+function addConcernSteps(steps, scan) {
+    const misplaced = (scan.classifications ?? [])
+        .flatMap((classification) => classification.functions
+        .filter((fn) => fn.isMisplaced)
+        .map((fn) => ({
+        file: classification.file,
+        name: fn.name,
+        concern: fn.concern,
+        reason: fn.reason
+    })))
+        .slice(0, 4);
+    for (const item of misplaced) {
+        steps.push(createStep(steps, {
+            action: 'move',
+            sourceFile: item.file,
+            targetFile: concernTarget(item.concern),
+            what: `Move ${item.name} ${item.reason ? `(${item.reason})` : `to the ${item.concern} layer`}.`,
+            why: 'Concern classification flagged this function as misplaced relative to the detected architecture rules.',
+            importsToUpdate: dependentFiles(scan, item.file),
+            dependencyNotes: dependencyNoteFor(scan, item.file),
+            risk: 'medium',
+            confidence: 'medium'
+        }));
+    }
+}
+function createStep(steps, input) {
+    return {
+        stepNumber: steps.length + 1,
+        action: input.action,
+        sourceFile: input.sourceFile,
+        targetFile: input.targetFile,
+        what: input.what,
+        why: input.why,
+        lineRange: input.lineRange ?? null,
+        importsToUpdate: unique(input.importsToUpdate),
+        dependencyNotes: input.dependencyNotes,
+        risk: input.risk,
+        confidence: input.confidence ?? 'medium'
+    };
+}
+function buildPhases(steps) {
+    const foundation = steps.filter((step) => step.action === 'create_dir');
+    const foundationIds = new Set(foundation.map((step) => step.stepNumber));
+    const extraction = steps.filter((step) => !foundationIds.has(step.stepNumber) && (step.action === 'extract' || step.action === 'consolidate'));
+    const extractionIds = new Set(extraction.map((step) => step.stepNumber));
+    const dependency = steps.filter((step) => !foundationIds.has(step.stepNumber) && !extractionIds.has(step.stepNumber) && (step.action === 'move' || step.risk === 'high'));
+    const used = new Set([...foundation, ...extraction, ...dependency].map((step) => step.stepNumber));
+    const remaining = steps.filter((step) => !used.has(step.stepNumber));
+    const phases = [];
+    if (foundation.length > 0) {
+        phases.push({ name: 'Prepare target structure', description: 'Create missing architectural destinations before moving code.', steps: foundation });
+    }
+    if (extraction.length > 0) {
+        phases.push({ name: 'Reduce structural hotspots', description: 'Extract and consolidate the highest-impact files first.', steps: extraction });
+    }
+    if (dependency.length > 0) {
+        phases.push({ name: 'Stabilize dependencies', description: 'Handle dependency hotspots and cycles with explicit import updates.', steps: dependency });
+    }
+    if (remaining.length > 0 || phases.length === 0) {
+        phases.push({ name: 'Maintain architecture', description: 'Keep the project healthy with low-risk follow-up work.', steps: remaining.length > 0 ? remaining : steps });
+    }
+    return phases.map((phase) => ({
+        ...phase,
+        steps: uniqueByStepNumber(phase.steps).sort((a, b) => a.stepNumber - b.stepNumber)
+    })).filter((phase) => phase.steps.length > 0);
+}
+function buildSummary(scan, primarySkill, stepCount) {
+    const skillText = primarySkill ? ` toward ${primarySkill.skill.name}` : '';
+    return `Refactor ${scan.summary.totalFiles} analyzed file(s)${skillText} through ${stepCount} ordered step(s).`;
+}
+function buildAssumptions(scan, primarySkill) {
+    const assumptions = ['Plan is generated from the current scan result and does not modify source files.'];
+    if (primarySkill) {
+        assumptions.push(`Primary architecture skill is ${primarySkill.skill.name} with ${primarySkill.confidence} confidence.`);
+    }
+    else {
+        assumptions.push('No confident primary architecture skill was detected; stack-specific rules are not invented.');
+    }
+    if (scan.parseErrors.length > 0) {
+        assumptions.push(`${scan.parseErrors.length} file(s) could not be parsed, so dependency and duplication guidance may be partial.`);
+    }
+    return assumptions;
+}
+function estimateComplexity(scan, stepCount) {
+    if (stepCount >= 8 || scan.summary.flaggedFiles >= 3 || scan.summary.duplicateFindings >= 3)
+        return 'high';
+    if (stepCount >= 4 || scan.summary.flaggedFiles > 0 || scan.summary.duplicateFindings > 0)
+        return 'medium';
+    return 'low';
+}
+function estimateRisk(scan) {
+    if (scan.summary.circularDependencies > 0 || scan.summary.dependencyHotspots >= 2)
+        return 'high';
+    if (scan.summary.dependencyHotspots > 0 || scan.parseErrors.length > 0)
+        return 'medium';
+    return 'low';
+}
+function suggestTargetForFile(scan, relativePath) {
+    const required = scan.structureComparison?.entries.find((entry) => entry.status === 'missing' && entry.required);
+    if (required)
+        return required.path;
+    if (relativePath.includes('/'))
+        return relativePath.split('/').slice(0, -1).join('/');
+    return 'src';
+}
+function concernTarget(concern) {
+    const targets = {
+        routing: 'src/routes',
+        business_logic: 'src/services',
+        data_access: 'src/repositories',
+        validation: 'src/validation',
+        middleware: 'src/middleware',
+        ui_component: 'src/components',
+        utility: 'src/utils',
+        configuration: 'src/config'
+    };
+    return targets[concern] ?? 'src/shared';
+}
+function dependentFiles(scan, relativePath) {
+    return scan.dependencyGraph.nodes.find((node) => node.relativePath === relativePath)?.importedBy ?? [];
+}
+function dependencyNoteFor(scan, relativePath) {
+    const dependents = dependentFiles(scan, relativePath);
+    if (dependents.length === 0)
+        return 'No known import updates from the dependency graph.';
+    return `Update imports in ${dependents.join(', ')}.`;
+}
+function unique(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+function uniqueByStepNumber(steps) {
+    const seen = new Set();
+    return steps.filter((step) => {
+        if (seen.has(step.stepNumber))
+            return false;
+        seen.add(step.stepNumber);
+        return true;
+    });
+}
+function trimTrailingPeriod(value) {
+    return value.replace(/\.+$/, '');
+}
+export function primarySkillFrom(scan) {
+    return scan.matchedSkills?.find((match) => match.primary) ?? null;
+}
+export function issuesBySeverity(scan) {
+    const rank = { critical: 0, warning: 1, info: 2 };
+    return [...(scan.issues ?? [])].sort((a, b) => rank[a.severity] - rank[b.severity]);
+}
+//# sourceMappingURL=plan-generator.js.map

package/dist/planner/plan-generator.js.map

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

package/dist/planner/plan-prompt-builder.d.ts

@@ -0,0 +1,9 @@
+import type { ScanResult } from '../types/analysis.js';
+import type { AIAgentPrompt, RefactorPlan } from '../types/plan.js';
+import type { SkillMatch } from '../types/skill.js';
+export interface BuildPromptOptions {
+    budget?: number;
+}
+export declare function buildAIAgentPrompt(plan: RefactorPlan, scan: ScanResult, primarySkill: SkillMatch | null, options?: BuildPromptOptions): AIAgentPrompt;
+export declare function serializePrompt(prompt: AIAgentPrompt): string;
+export declare function estimateTokens(text: string): number;

package/dist/planner/plan-prompt-builder.js

@@ -0,0 +1,92 @@
+const DEFAULT_BUDGET = 4000;
+export function buildAIAgentPrompt(plan, scan, primarySkill, options = {}) {
+    const constraints = [
+        'Preserve existing behavior unless a step explicitly says otherwise.',
+        'Preserve and update tests with each refactor.',
+        'Update imports after moving or extracting code.',
+        'Avoid introducing new circular dependencies.',
+        'Do not delete source code until replacement behavior is covered.'
+    ];
+    const projectContext = [
+        `Target: ${scan.summary.targetDir}`,
+        `Files analyzed: ${scan.summary.totalFiles}`,
+        `Health: ${plan.source.healthLabel}`,
+        `Complexity: ${plan.estimatedComplexity}`,
+        `Risk: ${plan.estimatedRisk}`,
+        `Top issues: ${(scan.issues ?? []).slice(0, 5).map((issue) => `${issue.severity} ${issue.category}: ${issue.message}`).join('; ') || 'none'}`
+    ].join('\n');
+    const skillBlueprint = primarySkill ? renderSkillBlueprint(primarySkill) : 'No confident primary architecture skill was detected. Use the generic plan and do not invent stack-specific rules.';
+    const renderedPlan = plan.phases
+        .map((phase) => [
+        `## ${phase.name}`,
+        phase.description,
+        ...phase.steps.map((step) => `${step.stepNumber}. ${step.what} Target: ${step.targetFile}. Dependencies: ${step.dependencyNotes}`)
+    ].join('\n'))
+        .join('\n\n');
+    const prompt = {
+        projectContext,
+        skillBlueprint,
+        plan: renderedPlan,
+        constraints,
+        budgetStatus: 'within_budget'
+    };
+    return trimPrompt(prompt, options.budget ?? DEFAULT_BUDGET);
+}
+function renderSkillBlueprint(match) {
+    const { skill } = match;
+    const required = skill.structure.requiredDirs.map((entry) => `- ${entry.path}: ${entry.purpose}`).join('\n') || '- none';
+    const recommended = skill.structure.recommendedDirs.map((entry) => `- ${entry.path}: ${entry.purpose}`).join('\n') || '- none';
+    const separation = skill.separation.rules.map((rule) => `- ${rule.concern} belongs in ${rule.belongsIn}`).join('\n') || '- none';
+    const naming = Object.entries(skill.patterns.naming ?? {}).map(([key, value]) => `- ${key}: ${value}`).join('\n') || '- none';
+    const dataFlow = skill.patterns.dataFlow ? [`Direction: ${skill.patterns.dataFlow.direction}`, ...skill.patterns.dataFlow.rules.map((rule) => `- ${rule}`)].join('\n') : 'none';
+    const antiPatterns = skill.antiPatterns.map((item) => `- ${item.severity}: ${item.description}`).join('\n') || '- none';
+    return [
+        `Matched skill: ${skill.name} (${skill.id}) at ${match.confidence} confidence`,
+        'Target structure:',
+        required,
+        'Recommended structure:',
+        recommended,
+        'Separation rules:',
+        separation,
+        'Naming conventions:',
+        naming,
+        'Pattern expectations:',
+        dataFlow,
+        'Anti-patterns:',
+        antiPatterns
+    ].join('\n');
+}
+function trimPrompt(prompt, budget) {
+    const serialized = serializePrompt(prompt);
+    if (estimateTokens(serialized) <= budget)
+        return prompt;
+    const trimmedPlan = prompt.plan.split('\n').slice(0, 80).join('\n');
+    return {
+        ...prompt,
+        plan: `${trimmedPlan}\n\n[Trimmed to fit prompt budget; keep highest-priority steps above.]`,
+        budgetStatus: 'trimmed'
+    };
+}
+export function serializePrompt(prompt) {
+    return [
+        'You are implementing a refactoring plan generated by architect.',
+        '',
+        'PROJECT CONTEXT',
+        prompt.projectContext,
+        '',
+        'ARCHITECTURE BLUEPRINT',
+        prompt.skillBlueprint,
+        '',
+        'ORDERED PLAN',
+        prompt.plan,
+        '',
+        'SAFETY CONSTRAINTS',
+        ...prompt.constraints.map((constraint) => `- ${constraint}`),
+        '',
+        `Budget status: ${prompt.budgetStatus}`
+    ].join('\n');
+}
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=plan-prompt-builder.js.map

package/dist/planner/plan-prompt-builder.js.map

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

package/dist/planner/plan-response-parser.d.ts

@@ -0,0 +1,7 @@
+import type { RefactorPlan } from '../types/plan.js';
+export interface PlanParseResult {
+    ok: boolean;
+    plan: RefactorPlan | null;
+    error: string | null;
+}
+export declare function parseRefactorPlanResponse(response: string): PlanParseResult;

package/dist/planner/plan-response-parser.js

@@ -0,0 +1,21 @@
+export function parseRefactorPlanResponse(response) {
+    try {
+        const parsed = JSON.parse(extractJson(response));
+        if (!parsed || !Array.isArray(parsed.phases) || typeof parsed.summary !== 'string') {
+            return { ok: false, plan: null, error: 'Response did not contain a valid RefactorPlan shape.' };
+        }
+        return { ok: true, plan: parsed, error: null };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            plan: null,
+            error: error instanceof Error ? error.message : 'Failed to parse plan response.'
+        };
+    }
+}
+function extractJson(response) {
+    const fenced = response.match(/```(?:json)?\s*([\s\S]*?)```/);
+    return fenced?.[1]?.trim() ?? response.trim();
+}
+//# sourceMappingURL=plan-response-parser.js.map

package/dist/planner/plan-response-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-response-parser.js","sourceRoot":"","sources":["../../src/planner/plan-response-parser.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAiB,CAAC;QACjE,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,sDAAsD,EAAE,CAAC;QAClG,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gCAAgC;SACjF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9D,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC"}

package/dist/planner/plan-validator.d.ts

@@ -0,0 +1,3 @@
+import type { RefactorPlan, PlanValidationFinding } from '../types/plan.js';
+export declare function validateRefactorPlan(plan: RefactorPlan): RefactorPlan;
+export declare function collectValidationFindings(plan: RefactorPlan): PlanValidationFinding[];

package/dist/planner/plan-validator.js

@@ -0,0 +1,49 @@
+const SUPPORTED_ACTIONS = ['create_dir', 'extract', 'move', 'consolidate', 'delete', 'update_imports'];
+const SOURCE_REQUIRED_ACTIONS = ['extract', 'move', 'consolidate', 'delete'];
+export function validateRefactorPlan(plan) {
+    return {
+        ...plan,
+        validationFindings: [...plan.validationFindings, ...collectValidationFindings(plan)]
+    };
+}
+export function collectValidationFindings(plan) {
+    const findings = [];
+    const steps = plan.phases.flatMap((phase) => phase.steps);
+    if (plan.phases.length === 0) {
+        findings.push(error(null, 'Plan has no phases.', 'Generate at least one phase before rendering the plan.'));
+    }
+    if (steps.length === 0) {
+        findings.push(error(null, 'Plan has no actionable steps.', 'Generate at least one maintenance or refactoring step.'));
+    }
+    steps.forEach((step, index) => {
+        if (step.stepNumber !== index + 1) {
+            findings.push(error(step.stepNumber, `Expected step number ${index + 1} but found ${step.stepNumber}.`, 'Renumber plan steps sequentially across all phases.'));
+        }
+        if (!SUPPORTED_ACTIONS.includes(step.action)) {
+            findings.push(error(step.stepNumber, `Unsupported action: ${step.action}.`, `Use one of: ${SUPPORTED_ACTIONS.join(', ')}.`));
+        }
+        if (!step.targetFile.trim()) {
+            findings.push(error(step.stepNumber, 'Step is missing a target location.', 'Add the file or directory the step should create or change.'));
+        }
+        if (!step.what.trim() || !step.why.trim()) {
+            findings.push(error(step.stepNumber, 'Step is missing action detail or explanation.', 'Add both what to change and why it matters.'));
+        }
+        if (!Array.isArray(step.importsToUpdate)) {
+            findings.push(error(step.stepNumber, 'Step importsToUpdate must be a list.', 'Use an empty list when no imports are known.'));
+        }
+        if (SOURCE_REQUIRED_ACTIONS.includes(step.action) && !step.sourceFile) {
+            findings.push(warning(step.stepNumber, `Step ${step.action} has no source location.`, 'Add a source file or explain the source in the step text before execution.'));
+        }
+        if (step.risk === 'high' && step.importsToUpdate.length === 0 && step.dependencyNotes.toLowerCase().includes('no known') === false) {
+            findings.push(warning(step.stepNumber, 'High-risk step does not list imports to update.', 'Review dependency graph before executing this step.'));
+        }
+    });
+    return findings;
+}
+function error(stepNumber, message, suggestion) {
+    return { severity: 'error', stepNumber, message, suggestion };
+}
+function warning(stepNumber, message, suggestion) {
+    return { severity: 'warning', stepNumber, message, suggestion };
+}
+//# sourceMappingURL=plan-validator.js.map

package/dist/planner/plan-validator.js.map

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

package/dist/reporters/scan-json.d.ts

@@ -0,0 +1,13 @@
+import type { ScanResult } from '../types/analysis.js';
+import type { MachineReadableScanOutput, ScanDiagnostic, ScanWarning } from '../types/scan-output.js';
+export interface RenderScanJsonInput {
+    result: ScanResult | null;
+    targetDir: string;
+    verbose: boolean;
+    durationMs: number;
+    warnings: ScanWarning[];
+    diagnostics: ScanDiagnostic[];
+    status?: MachineReadableScanOutput['run']['status'];
+    error?: MachineReadableScanOutput['error'];
+}
+export declare function renderScanJson(input: RenderScanJsonInput): string;

package/dist/reporters/scan-json.js

@@ -0,0 +1,26 @@
+export function renderScanJson(input) {
+    const output = {
+        schemaVersion: '1.0',
+        command: {
+            name: 'scan',
+            targetDir: input.targetDir,
+            verbose: input.verbose
+        },
+        run: {
+            status: input.status ?? statusFor(input.result, input.warnings),
+            durationMs: input.durationMs,
+            outputMode: 'json'
+        },
+        result: input.result,
+        warnings: input.warnings,
+        diagnostics: input.diagnostics,
+        ...(input.error ? { error: input.error } : {})
+    };
+    return `${JSON.stringify(output, null, 2)}\n`;
+}
+function statusFor(result, warnings) {
+    if (!result)
+        return 'failed';
+    return warnings.some((warning) => warning.code === 'parse_error' || warning.code === 'partial_analysis') ? 'partial' : 'success';
+}
+//# sourceMappingURL=scan-json.js.map

package/dist/reporters/scan-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-json.js","sourceRoot":"","sources":["../../src/reporters/scan-json.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,MAAM,GAA8B;QACxC,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB;QACD,GAAG,EAAE;YACH,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;YAC/D,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,MAAM;SACnB;QACD,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;IAEF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,SAAS,SAAS,CAAC,MAAyB,EAAE,QAAuB;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACnI,CAAC"}

package/dist/reporters/terminal.d.ts

@@ -0,0 +1,6 @@
+import { type ScanResult } from '../types/analysis.js';
+export declare function renderDiscoveryReport(targetDirectory: string, files: string[]): void;
+export declare function renderScanReport(result: ScanResult, options?: {
+    color?: boolean;
+    verbose?: boolean;
+}): void;