tryassay 0.1.0

package/dist/lib/remediator.js

@@ -0,0 +1,209 @@
+import { getClient, MODEL } from './anthropic.js';
+import { readFileContent } from './codebase-indexer.js';
+const VALID_ACTIONS = ['add', 'modify', 'remove', 'configure'];
+const VALID_EFFORTS = ['trivial', 'small', 'medium', 'large'];
+const REMEDIATION_SYSTEM = `You are a senior software engineer generating code-level fix tasks for a codebase that does not fully implement its specification.
+
+For each failed or partially-implemented claim, produce a remediation task with:
+- claimId: the original claim ID
+- title: one-line fix description (imperative, e.g. "Add AES-256 encryption for data at rest")
+- description: detailed guidance (2-4 sentences)
+- action: one of "add" (new code/file), "modify" (change existing), "remove" (delete dead/wrong code), "configure" (env/config change)
+- targetFiles: array of file paths to change or create
+- estimatedEffort: "trivial" (< 10 lines), "small" (10-50 lines), "medium" (50-200 lines), "large" (> 200 lines)
+- codeGuidance: specific code-level instructions (mention functions, modules, patterns to use)
+
+OUTPUT FORMAT:
+Return a JSON array of task objects:
+[
+  {
+    "claimId": "CLAIM-001",
+    "title": "Add rate limiting middleware",
+    "description": "The API lacks rate limiting. Add express-rate-limit middleware to all public endpoints.",
+    "action": "add",
+    "targetFiles": ["src/middleware/rate-limit.ts", "src/app.ts"],
+    "estimatedEffort": "small",
+    "codeGuidance": "Create rate-limit.ts exporting a configurable middleware using express-rate-limit. Apply it in app.ts before route handlers. Use 100 req/15min for authenticated, 20 req/15min for unauthenticated."
+  }
+]
+
+Rules:
+- Be specific about files, functions, and patterns
+- targetFiles should reference actual files from the codebase when modifying, or proposed new paths when adding
+- codeGuidance should be actionable enough for a developer to implement without guessing
+- For PARTIAL verdicts, focus on what's missing rather than what exists
+- For FAIL verdicts, provide the full implementation approach
+
+Return ONLY the JSON array. No markdown fences, no commentary.`;
+function parseRemediationResponse(rawText) {
+    let jsonText = rawText.trim();
+    // Remove code fences
+    if (jsonText.startsWith('```')) {
+        const firstNewline = jsonText.indexOf('\n');
+        if (firstNewline !== -1) {
+            jsonText = jsonText.slice(firstNewline + 1);
+        }
+    }
+    const lastFence = jsonText.lastIndexOf('```');
+    if (lastFence !== -1) {
+        jsonText = jsonText.slice(0, lastFence);
+    }
+    jsonText = jsonText.trim();
+    // Handle truncation
+    if (!jsonText.endsWith(']')) {
+        const lastBrace = jsonText.lastIndexOf('}');
+        if (lastBrace !== -1) {
+            jsonText = jsonText.slice(0, lastBrace + 1) + ']';
+        }
+    }
+    const parsed = JSON.parse(jsonText);
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed;
+}
+const BATCH_SIZE = 15;
+export async function generateRemediationTasks(failedVerifications, partialVerifications, claims, index, onProgress) {
+    const client = getClient();
+    const claimMap = new Map(claims.map((c) => [c.id, c]));
+    const tasks = [];
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let taskCounter = 0;
+    const treeStr = index.fileTree.slice(0, 2000).join('\n');
+    // Process FAIL claims first, then PARTIAL
+    const groups = [
+        {
+            label: 'FAIL',
+            verifications: failedVerifications,
+            emphasis: 'These claims are NOT implemented. Provide full implementation guidance.',
+        },
+        {
+            label: 'PARTIAL',
+            verifications: partialVerifications,
+            emphasis: 'These claims are PARTIALLY implemented. Focus on what is MISSING, not what exists.',
+        },
+    ];
+    for (const group of groups) {
+        if (group.verifications.length === 0)
+            continue;
+        for (let i = 0; i < group.verifications.length; i += BATCH_SIZE) {
+            const batch = group.verifications.slice(i, i + BATCH_SIZE);
+            const batchNum = Math.floor(i / BATCH_SIZE) + 1;
+            const totalBatches = Math.ceil(group.verifications.length / BATCH_SIZE);
+            onProgress?.(`${group.label} batch ${batchNum}/${totalBatches}: reading evidence files for ${batch.length} claims...`);
+            // Collect all evidence files from this batch
+            const uniqueFiles = new Set();
+            for (const v of batch) {
+                for (const e of v.evidence) {
+                    uniqueFiles.add(e.file);
+                }
+            }
+            // Read file contents
+            const fileContents = new Map();
+            for (const filePath of uniqueFiles) {
+                const content = await readFileContent(index.rootPath, filePath);
+                if (content) {
+                    fileContents.set(filePath, content);
+                }
+            }
+            // Build context
+            let evidenceContext = '';
+            for (const [path, content] of fileContents) {
+                const truncated = content.length > 10_000
+                    ? content.slice(0, 10_000) + '\n[... truncated]'
+                    : content;
+                evidenceContext += `\n--- FILE: ${path} ---\n${truncated}\n`;
+            }
+            if (evidenceContext.length > 100_000) {
+                evidenceContext = evidenceContext.slice(0, 100_000) + '\n[... context truncated]';
+            }
+            // Build claim+verification list
+            const claimList = batch
+                .map((v) => {
+                const claim = claimMap.get(v.claimId);
+                return [
+                    `${v.claimId} [${claim?.severity || 'medium'}, ${claim?.category || 'functionality'}]:`,
+                    `  Claim: ${v.claim}`,
+                    `  Verdict: ${v.verdict}`,
+                    `  Reasoning: ${v.reasoning}`,
+                ].join('\n');
+            })
+                .join('\n\n');
+            onProgress?.(`${group.label} batch ${batchNum}/${totalBatches}: generating remediation tasks...`);
+            const response = await client.messages.create({
+                model: MODEL,
+                max_tokens: 8_000,
+                system: REMEDIATION_SYSTEM,
+                messages: [
+                    {
+                        role: 'user',
+                        content: [
+                            group.emphasis,
+                            '',
+                            'Claims requiring remediation:',
+                            claimList,
+                            '',
+                            'Codebase file tree:',
+                            treeStr,
+                            '',
+                            'Relevant source files:',
+                            evidenceContext,
+                        ].join('\n'),
+                    },
+                ],
+            });
+            totalInputTokens += response.usage.input_tokens;
+            totalOutputTokens += response.usage.output_tokens;
+            const responseText = response.content
+                .filter((b) => b.type === 'text')
+                .map((b) => b.text)
+                .join('');
+            try {
+                const rawTasks = parseRemediationResponse(responseText);
+                for (const raw of rawTasks) {
+                    if (!raw.claimId || !raw.title)
+                        continue;
+                    const claim = claimMap.get(raw.claimId);
+                    const verification = batch.find((v) => v.claimId === raw.claimId);
+                    if (!verification)
+                        continue;
+                    taskCounter++;
+                    const id = `REM-${String(taskCounter).padStart(3, '0')}`;
+                    tasks.push({
+                        id,
+                        claimId: raw.claimId,
+                        verdict: verification.verdict,
+                        severity: (claim?.severity || 'medium'),
+                        category: (claim?.category || 'functionality'),
+                        title: raw.title,
+                        description: raw.description || '',
+                        action: VALID_ACTIONS.includes(raw.action)
+                            ? raw.action
+                            : 'modify',
+                        targetFiles: Array.isArray(raw.targetFiles) ? raw.targetFiles : [],
+                        estimatedEffort: VALID_EFFORTS.includes(raw.estimatedEffort)
+                            ? raw.estimatedEffort
+                            : 'medium',
+                        codeGuidance: raw.codeGuidance || '',
+                    });
+                }
+            }
+            catch {
+                onProgress?.(`Warning: Failed to parse remediation response for ${group.label} batch ${batchNum}`);
+            }
+        }
+    }
+    // Sort: critical first, then high, medium, low
+    const severityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+    tasks.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+    // Re-number after sorting
+    for (let i = 0; i < tasks.length; i++) {
+        tasks[i].id = `REM-${String(i + 1).padStart(3, '0')}`;
+    }
+    return {
+        tasks,
+        inputTokens: totalInputTokens,
+        outputTokens: totalOutputTokens,
+    };
+}
+//# sourceMappingURL=remediator.js.map

package/dist/lib/remediator.js.map

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

package/dist/lib/report-generator.d.ts

@@ -0,0 +1,8 @@
+import type { ExtractionResult, VerificationReport } from '../types.js';
+interface ReportInput {
+    extraction: ExtractionResult;
+    verification: VerificationReport;
+    projectName?: string;
+}
+export declare function generateGapReport(input: ReportInput): string;
+export {};

package/dist/lib/report-generator.js

@@ -0,0 +1,190 @@
+export function generateGapReport(input) {
+    const { extraction, verification, projectName } = input;
+    const { verdicts, verifications } = verification;
+    const total = verifications.length;
+    const assessed = total - verdicts.na;
+    const complianceScore = assessed > 0
+        ? ((verdicts.pass + verdicts.partial * 0.5) / assessed) * 100
+        : 0;
+    const claimMap = new Map(extraction.claims.map((c) => [c.id, c]));
+    const now = new Date().toISOString().split('T')[0];
+    const lines = [];
+    // --- Executive Summary ---
+    lines.push(`# Assay Gap Report — ${projectName || 'Audit Results'}`);
+    lines.push('');
+    lines.push(`*Generated: ${now}*`);
+    lines.push(`*Iteration: ${extraction.iteration}*`);
+    lines.push(`*Codebase: ${verification.codebasePath}*`);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    lines.push('## Executive Summary');
+    lines.push('');
+    lines.push(`Assay extracted **${extraction.totalClaims} claims** from the ${extraction.documentType} document and verified each against the codebase.`);
+    lines.push('');
+    lines.push(`| Metric | Value |`);
+    lines.push(`|--------|-------|`);
+    lines.push(`| Total claims | ${total} |`);
+    lines.push(`| PASS | ${verdicts.pass} |`);
+    lines.push(`| PARTIAL | ${verdicts.partial} |`);
+    lines.push(`| FAIL | ${verdicts.fail} |`);
+    lines.push(`| N/A | ${verdicts.na} |`);
+    lines.push(`| **Compliance score** | **${complianceScore.toFixed(1)}%** |`);
+    lines.push('');
+    // Risk summary
+    const criticalFails = getVerificationsByVerdictAndSeverity(verifications, claimMap, 'FAIL', 'critical');
+    const highFails = getVerificationsByVerdictAndSeverity(verifications, claimMap, 'FAIL', 'high');
+    if (criticalFails.length > 0 || highFails.length > 0) {
+        lines.push(`**Risk Assessment:** ${criticalFails.length} critical and ${highFails.length} high-severity failures require immediate attention.`);
+    }
+    else if (verdicts.fail > 0) {
+        lines.push(`**Risk Assessment:** ${verdicts.fail} failures found, none at critical severity.`);
+    }
+    else {
+        lines.push(`**Risk Assessment:** No failures found. Claims are well-supported by codebase.`);
+    }
+    lines.push('');
+    // --- Methodology ---
+    lines.push('---');
+    lines.push('');
+    lines.push('## Methodology');
+    lines.push('');
+    lines.push('This report was generated using the LUCID methodology (Leveraging Unverified Claims Into Deliverables):');
+    lines.push('');
+    lines.push('1. **Extract** — Every declarative claim was identified from the document');
+    lines.push('2. **Classify** — Claims were categorized by type and severity');
+    lines.push('3. **Verify** — Each testable claim was evaluated against the actual codebase');
+    lines.push('4. **Report** — Results compiled with evidence and fix recommendations');
+    lines.push('');
+    lines.push('**Verdicts:**');
+    lines.push('- **PASS** — Code fully implements the claim');
+    lines.push('- **PARTIAL** — Code partially implements the claim');
+    lines.push('- **FAIL** — Code does not implement the claim or contradicts it');
+    lines.push('- **N/A** — Claim cannot be verified from code alone');
+    lines.push('');
+    // --- Priority Matrix ---
+    lines.push('---');
+    lines.push('');
+    lines.push('## Priority Matrix');
+    lines.push('');
+    lines.push('| Severity | FAIL | PARTIAL | PASS | N/A |');
+    lines.push('|----------|------|---------|------|-----|');
+    for (const severity of ['critical', 'high', 'medium', 'low']) {
+        const counts = {
+            FAIL: getVerificationsByVerdictAndSeverity(verifications, claimMap, 'FAIL', severity).length,
+            PARTIAL: getVerificationsByVerdictAndSeverity(verifications, claimMap, 'PARTIAL', severity).length,
+            PASS: getVerificationsByVerdictAndSeverity(verifications, claimMap, 'PASS', severity).length,
+            'N/A': getVerificationsByVerdictAndSeverity(verifications, claimMap, 'N/A', severity).length,
+        };
+        lines.push(`| ${severity} | ${counts.FAIL} | ${counts.PARTIAL} | ${counts.PASS} | ${counts['N/A']} |`);
+    }
+    lines.push('');
+    // --- Detailed Findings ---
+    lines.push('---');
+    lines.push('');
+    lines.push('## Detailed Findings');
+    lines.push('');
+    // Group by section
+    const sections = new Map();
+    for (const v of verifications) {
+        const claim = claimMap.get(v.claimId);
+        const section = claim?.section || 'Unknown';
+        if (!sections.has(section))
+            sections.set(section, []);
+        sections.get(section).push(v);
+    }
+    for (const [section, sectionVerifications] of sections) {
+        lines.push(`### ${section}`);
+        lines.push('');
+        // Sort: FAIL first, then PARTIAL, then PASS, then N/A
+        const verdictOrder = { FAIL: 0, PARTIAL: 1, PASS: 2, 'N/A': 3 };
+        sectionVerifications.sort((a, b) => (verdictOrder[a.verdict] ?? 4) - (verdictOrder[b.verdict] ?? 4));
+        for (const v of sectionVerifications) {
+            const claim = claimMap.get(v.claimId);
+            const icon = verdictIcon(v.verdict);
+            lines.push(`${icon} **${v.claimId}** [${claim?.severity || 'medium'}] — ${v.claim || claim?.text || ''}`);
+            if (v.reasoning) {
+                lines.push(`> ${v.reasoning}`);
+            }
+            if (v.evidence.length > 0) {
+                for (const e of v.evidence) {
+                    const loc = e.lineNumber ? `${e.file}:${e.lineNumber}` : e.file;
+                    lines.push(`> \`${loc}\`: \`${e.snippet.trim().slice(0, 120)}\``);
+                }
+            }
+            lines.push('');
+        }
+    }
+    // --- Fix Recommendations ---
+    const fails = verifications.filter((v) => v.verdict === 'FAIL');
+    const partials = verifications.filter((v) => v.verdict === 'PARTIAL');
+    if (fails.length > 0 || partials.length > 0) {
+        lines.push('---');
+        lines.push('');
+        lines.push('## Fix Recommendations');
+        lines.push('');
+        if (criticalFails.length > 0) {
+            lines.push('### Immediate (Critical)');
+            lines.push('');
+            for (const v of criticalFails) {
+                lines.push(`- [ ] **${v.claimId}**: ${v.claim}`);
+            }
+            lines.push('');
+        }
+        if (highFails.length > 0) {
+            lines.push('### High Priority');
+            lines.push('');
+            for (const v of highFails) {
+                lines.push(`- [ ] **${v.claimId}**: ${v.claim}`);
+            }
+            lines.push('');
+        }
+        const mediumFails = getVerificationsByVerdictAndSeverity(verifications, claimMap, 'FAIL', 'medium');
+        if (mediumFails.length > 0) {
+            lines.push('### Medium Priority');
+            lines.push('');
+            for (const v of mediumFails) {
+                lines.push(`- [ ] **${v.claimId}**: ${v.claim}`);
+            }
+            lines.push('');
+        }
+        if (partials.length > 0) {
+            lines.push('### Partial Implementations (Quick Wins)');
+            lines.push('');
+            for (const v of partials) {
+                lines.push(`- [ ] **${v.claimId}**: ${v.claim}`);
+            }
+            lines.push('');
+        }
+    }
+    // --- Footer ---
+    lines.push('---');
+    lines.push('');
+    lines.push(`*Report generated by Assay v0.1.0 — powered by the LUCID methodology (Leveraging Unverified Claims Into Deliverables)*`);
+    lines.push(`*https://tryassay.ai*`);
+    lines.push('');
+    return lines.join('\n');
+}
+function verdictIcon(verdict) {
+    switch (verdict) {
+        case 'PASS':
+            return '[PASS]';
+        case 'PARTIAL':
+            return '[PARTIAL]';
+        case 'FAIL':
+            return '[FAIL]';
+        case 'N/A':
+            return '[N/A]';
+        default:
+            return `[${verdict}]`;
+    }
+}
+function getVerificationsByVerdictAndSeverity(verifications, claimMap, verdict, severity) {
+    return verifications.filter((v) => {
+        if (v.verdict !== verdict)
+            return false;
+        const claim = claimMap.get(v.claimId);
+        return claim?.severity === severity;
+    });
+}
+//# sourceMappingURL=report-generator.js.map

package/dist/lib/report-generator.js.map

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

package/dist/lib/requirements-generator.d.ts

@@ -0,0 +1,14 @@
+import type { CodebaseIndex } from './codebase-indexer.js';
+import type { RouteInventoryItem, RouteRequirement } from '../types.js';
+/**
+ * Generate a structured requirement for a single route.
+ *
+ * Reads the route's component file, follows 1 level of imports to gather
+ * related code (hooks, utilities), and sends all context to Claude to
+ * produce a RouteRequirement with behaviors and scaffolding flags.
+ */
+export declare function generateRequirement(route: RouteInventoryItem, index: CodebaseIndex, onProgress?: (msg: string) => void): Promise<{
+    requirement: RouteRequirement;
+    inputTokens: number;
+    outputTokens: number;
+}>;