@amrishkhan05/frankly 0.1.0

package/dist/project/detector.js

@@ -0,0 +1,214 @@
+/**
+ * Project detection and analysis
+ * Identifies TypeScript/JavaScript projects, workspaces, and configuration
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { ProjectError } from "../core/errors.js";
+export class ProjectDetector {
+    constructor(rootPath) {
+        this.cache = new Map();
+        this.rootPath = rootPath;
+    }
+    /**
+     * Detect project configuration
+     */
+    async detectProject() {
+        const cacheKey = "project";
+        if (this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey);
+        }
+        const packageJson = this.readPackageJson(this.rootPath);
+        if (!packageJson) {
+            throw new ProjectError("No package.json found", { path: this.rootPath });
+        }
+        const project = {
+            root: this.rootPath,
+            type: this.detectLanguageType(),
+            packageManager: this.detectPackageManager(),
+            isWorkspace: this.isWorkspace(packageJson),
+            hasTsConfig: this.hasTsConfig(this.rootPath),
+            testRunner: this.detectTestRunner(packageJson),
+        };
+        if (project.isWorkspace) {
+            project.workspaceRoot = this.rootPath;
+            project.packages = this.detectWorkspacePackages(packageJson);
+        }
+        this.cache.set(cacheKey, project);
+        return project;
+    }
+    /**
+     * Detect language type from tsconfig or file extensions
+     */
+    detectLanguageType() {
+        if (this.hasTsConfig(this.rootPath)) {
+            return "typescript";
+        }
+        // Check for .ts files
+        return this.hasTypeScriptFiles(this.rootPath) ? "typescript" : "javascript";
+    }
+    /**
+     * Check if tsconfig.json exists
+     */
+    hasTsConfig(dir) {
+        return fs.existsSync(path.join(dir, "tsconfig.json"));
+    }
+    /**
+     * Check for TypeScript files
+     */
+    hasTypeScriptFiles(dir, depth = 2) {
+        if (depth <= 0)
+            return false;
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith(".") || entry.name === "node_modules")
+                    continue;
+                if (entry.isFile() && entry.name.endsWith(".ts"))
+                    return true;
+                if (entry.isDirectory() && this.hasTypeScriptFiles(path.join(dir, entry.name), depth - 1)) {
+                    return true;
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return false;
+    }
+    /**
+     * Detect package manager from lock files
+     */
+    detectPackageManager() {
+        if (fs.existsSync(path.join(this.rootPath, "pnpm-lock.yaml")))
+            return "pnpm";
+        if (fs.existsSync(path.join(this.rootPath, "yarn.lock")))
+            return "yarn";
+        return "npm";
+    }
+    /**
+     * Check if project is a workspace
+     */
+    isWorkspace(packageJson) {
+        return (Array.isArray(packageJson.workspaces) || typeof packageJson.workspaces === "object");
+    }
+    /**
+     * Detect workspace packages
+     */
+    detectWorkspacePackages(packageJson) {
+        const workspaces = packageJson.workspaces;
+        if (!workspaces)
+            return [];
+        let patterns = [];
+        if (Array.isArray(workspaces)) {
+            patterns = workspaces;
+        }
+        else if (typeof workspaces === "object" && workspaces !== null) {
+            const w = workspaces;
+            if (Array.isArray(w.packages)) {
+                patterns = w.packages;
+            }
+        }
+        // Resolve glob patterns to actual packages
+        const packages = [];
+        for (const pattern of patterns) {
+            const resolved = this.resolveGlobPattern(pattern);
+            packages.push(...resolved);
+        }
+        return packages;
+    }
+    /**
+     * Resolve glob pattern to actual directories
+     */
+    resolveGlobPattern(pattern) {
+        const result = [];
+        if (!pattern.includes("*")) {
+            const fullPath = path.join(this.rootPath, pattern);
+            if (fs.existsSync(fullPath)) {
+                result.push(pattern);
+            }
+            return result;
+        }
+        // Simple glob resolution
+        const parts = pattern.split("/");
+        const basePart = parts[0];
+        if (basePart.includes("*")) {
+            const basePattern = basePart.replace("*", "");
+            try {
+                const entries = fs.readdirSync(this.rootPath);
+                for (const entry of entries) {
+                    if (entry.startsWith(basePattern)) {
+                        const fullPath = path.join(this.rootPath, entry);
+                        if (fs.statSync(fullPath).isDirectory()) {
+                            result.push(entry);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return result;
+    }
+    /**
+     * Detect test runner from package.json
+     */
+    detectTestRunner(packageJson) {
+        const deps = {
+            ...(packageJson.dependencies || {}),
+            ...(packageJson.devDependencies || {}),
+        };
+        if ("nx" in deps)
+            return "nx";
+        if ("vitest" in deps)
+            return "vitest";
+        if ("jest" in deps)
+            return "jest";
+        return undefined;
+    }
+    /**
+     * Read package.json from directory
+     */
+    readPackageJson(dir) {
+        const packageJsonPath = path.join(dir, "package.json");
+        try {
+            const content = fs.readFileSync(packageJsonPath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Find package.json for a given file path
+     */
+    findPackageJsonForFile(filePath) {
+        let dir = path.dirname(filePath);
+        while (dir !== path.dirname(dir)) {
+            const packageJsonPath = path.join(dir, "package.json");
+            if (fs.existsSync(packageJsonPath)) {
+                return packageJsonPath;
+            }
+            dir = path.dirname(dir);
+        }
+        return null;
+    }
+    /**
+     * Read tsconfig.json
+     */
+    readTsConfig(dir = this.rootPath) {
+        const tsConfigPath = path.join(dir, "tsconfig.json");
+        try {
+            const content = fs.readFileSync(tsConfigPath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+export async function createProjectDetector(rootPath) {
+    return new ProjectDetector(rootPath);
+}
+//# sourceMappingURL=detector.js.map

package/dist/project/detector.js.map

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

package/dist/report/json.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Report formatting
+ * Outputs analysis results in various formats
+ */
+import type { AnalysisResult } from "../core/models.js";
+export declare class ReportFormatter {
+    /**
+     * Format as JSON
+     */
+    formatAsJson(result: AnalysisResult): string;
+    /**
+     * Format as compact terminal output
+     */
+    formatAsTerminal(result: AnalysisResult): string;
+    /**
+     * Format as markdown
+     */
+    formatAsMarkdown(result: AnalysisResult): string;
+    /**
+     * Format as summary
+     */
+    formatAsSummary(result: AnalysisResult): string;
+    formatAsCi(result: AnalysisResult): string;
+}
+export declare function createReportFormatter(): ReportFormatter;
+//# sourceMappingURL=json.d.ts.map

package/dist/report/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/report/json.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,mBAAmB,CAAC;AAE/E,qBAAa,eAAe;IACxB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAI5C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAiEhD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAqDhD;;OAEG;IACL,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAgB/C,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAY3C;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/report/json.js

@@ -0,0 +1,148 @@
+/**
+ * Report formatting
+ * Outputs analysis results in various formats
+ */
+export class ReportFormatter {
+    /**
+     * Format as JSON
+     */
+    formatAsJson(result) {
+        return JSON.stringify(result, null, 2);
+    }
+    /**
+     * Format as compact terminal output
+     */
+    formatAsTerminal(result) {
+        const lines = [];
+        lines.push("FRANKLY · RED INK REVIEW\n");
+        // Task
+        lines.push(`Task\n${result.task}\n`);
+        // Verdict
+        const review = result.review;
+        lines.push(`CHANGE VERDICT\n${review.verdict}\n`);
+        // Metrics
+        lines.push(`TASK ALIGNMENT\n${review.taskAlignment}\n`);
+        lines.push(`CHANGE NECESSITY\n${review.changeNecessity}/100\n`);
+        lines.push(`CHANGE SURFACE\n${review.changeSurface}\n`);
+        lines.push(`SCOPE DRIFT\n${Math.round(review.scopeDrift * 100)}%\n`);
+        lines.push(`MINIMUM PATCH\n${result.files.length} file(s), ${result.symbols.length} changed symbol(s)\n`);
+        // Red marks
+        if (review.findings.length > 0) {
+            lines.push("RED MARKS\n");
+            for (const finding of review.findings) {
+                const icon = finding.severity === "error" ? "✗" : "⚠";
+                lines.push(`${icon} ${finding.title}`);
+            }
+            lines.push("");
+        }
+        // Blast radius
+        lines.push("BLAST RADIUS\n");
+        lines.push(`Direct callers       ${review.blastRadius.directCallers}`);
+        lines.push(`Transitive callers   ${review.blastRadius.transitiveCallers}`);
+        lines.push(`Packages             ${review.blastRadius.affectedPackages}\n`);
+        // Test impact
+        lines.push("TEST IMPACT\n");
+        lines.push(`Likely affected      ${review.testImpact.likelyAffected}`);
+        lines.push(`Possibly affected    ${review.testImpact.possiblyAffected}`);
+        lines.push(`Executed             ${review.testImpact.executed}`);
+        lines.push(`Passed               ${review.testImpact.passed}\n`);
+        for (const test of review.testImpact.predicted.slice(0, 10)) {
+            lines.push(`  ${test.status.padEnd(19)} ${test.path}`);
+        }
+        if (review.testImpact.predicted.length)
+            lines.push("");
+        if (review.contractChanges.length) {
+            lines.push("CONTRACT CHANGES\n");
+            for (const contract of review.contractChanges.slice(0, 10))
+                lines.push(`⚠ ${contract.type} ${contract.location}`);
+            lines.push("");
+        }
+        // Recommendation
+        lines.push("RECOMMENDATION\n");
+        lines.push(review.recommendation);
+        if (review.correction)
+            lines.push(`\nCORRECTION PASS (1/1)\n${review.correction.instruction}`);
+        if (review.personality) {
+            lines.push(`\nFrank: "${review.personality}"`);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Format as markdown
+     */
+    formatAsMarkdown(result) {
+        const lines = [];
+        lines.push("# Frankly · Red Ink Review\n");
+        // Task
+        lines.push(`## Task\n${result.task}\n`);
+        // Verdict
+        const review = result.review;
+        lines.push(`## Change Verdict\n**${review.verdict}**\n`);
+        // Metrics
+        lines.push("## Analysis\n");
+        lines.push(`- **Task Alignment**: ${review.taskAlignment}`);
+        lines.push(`- **Change Necessity**: ${review.changeNecessity}/100`);
+        lines.push(`- **Change Surface**: ${review.changeSurface}`);
+        lines.push(`- **Scope Drift**: ${Math.round(review.scopeDrift * 100)}%\n`);
+        lines.push(`- **Behavioral Changes**: ${review.behavioralChanges.join(", ") || "none detected"}`);
+        // Findings
+        if (review.findings.length > 0) {
+            lines.push("## Findings\n");
+            for (const finding of review.findings) {
+                lines.push(`- **${finding.title}** (${finding.severity})\n  ${finding.description}`);
+            }
+            lines.push("");
+        }
+        // Impact
+        lines.push("## Impact\n");
+        lines.push("### Blast Radius");
+        lines.push(`- Direct callers: ${review.blastRadius.directCallers}`);
+        lines.push(`- Transitive callers: ${review.blastRadius.transitiveCallers}`);
+        lines.push(`- Affected packages: ${review.blastRadius.affectedPackages}\n`);
+        lines.push("### Test Impact");
+        lines.push(`- Likely affected: ${review.testImpact.likelyAffected}`);
+        lines.push(`- Possibly affected: ${review.testImpact.possiblyAffected}`);
+        lines.push(`- Executed: ${review.testImpact.executed}`);
+        lines.push(`- Passed: ${review.testImpact.passed}\n`);
+        // Recommendation
+        lines.push("## Recommendation\n");
+        lines.push(review.recommendation);
+        if (review.correction)
+            lines.push(`\n## Correction Pass\n\n${review.correction.instruction}`);
+        return lines.join("\n");
+    }
+    /**
+     * Format as summary
+     */
+    formatAsSummary(result) {
+        const review = result.review;
+        return `
+FRANKLY ANALYSIS
+
+Verdict: ${review.verdict}
+Files changed: ${result.files.length}
+Symbols changed: ${result.symbols.length}
+Findings: ${review.findings.length}
+Task alignment: ${review.taskAlignment}
+Change necessity: ${review.changeNecessity}/100
+
+${review.recommendation}
+    `.trim();
+    }
+    formatAsCi(result) {
+        return JSON.stringify({
+            schemaVersion: result.schemaVersion,
+            verdict: result.review.verdict,
+            necessityScore: result.review.changeNecessity,
+            scopeDrift: result.review.scopeDrift,
+            findings: result.review.findings.map(({ id, severity, confidence, title, affectedSymbols }) => ({ id, severity, confidence, title, affectedSymbols })),
+            predictedTests: result.review.testImpact.predicted,
+            executedTests: result.review.testImpact.executedResults,
+            contracts: result.review.contractChanges,
+        });
+    }
+}
+export function createReportFormatter() {
+    return new ReportFormatter();
+}
+//# sourceMappingURL=json.js.map

package/dist/report/json.js.map

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

package/dist/review/red-ink-review.d.ts

@@ -0,0 +1,26 @@
+import type { ChangedFile, ExecutedTest, RedInkReview } from "../core/models.js";
+import type { ClassifiedChange } from "../analysis/change-classifier.js";
+import type { RepositoryIntelligence } from "../analysis/repository-intelligence.js";
+import type { FranklyAction, FranklyIntensity, FranklyPersonality } from "../core/config.js";
+export interface ReviewInput {
+    task: string;
+    files: ChangedFile[];
+    classifications: ClassifiedChange[];
+    scopeDrift: number;
+    fileCount: number;
+    symbolCount: number;
+    intelligence: RepositoryIntelligence;
+    executedTests: ExecutedTest[];
+    personality: FranklyPersonality;
+    action: FranklyAction;
+    intensity: FranklyIntensity;
+    disabled: boolean;
+    maxCorrectionPasses: number;
+}
+export declare class RedInkReviewBuilder {
+    build(input: ReviewInput): RedInkReview;
+    private classificationFindings;
+    private verdict;
+}
+export declare function createRedInkReviewBuilder(): RedInkReviewBuilder;
+//# sourceMappingURL=red-ink-review.d.ts.map

package/dist/review/red-ink-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"red-ink-review.d.ts","sourceRoot":"","sources":["../../src/review/red-ink-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE7F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,eAAe,EAAE,gBAAgB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,sBAAsB,CAAC;IACrC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,WAAW,EAAE,kBAAkB,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,mBAAmB;IAC9B,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY;IA6CvC,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,OAAO;CAOhB;AAwBD,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D"}

package/dist/review/red-ink-review.js

@@ -0,0 +1,103 @@
+export class RedInkReviewBuilder {
+    build(input) {
+        const confidence = input.intensity === "lite" ? ["high"] : input.intensity === "ultra" ? ["high", "medium", "low"] : ["high", "medium"];
+        const findings = input.disabled ? [] : [...this.classificationFindings(input.classifications), ...input.intelligence.findings].filter((item) => confidence.includes(item.confidence));
+        const hasUntestedImpact = !input.disabled && input.intelligence.predictedTests.length > 0 && input.executedTests.length === 0;
+        const baseVerdict = this.verdict(findings, input.disabled ? 0 : input.scopeDrift, hasUntestedImpact);
+        const verdict = input.action === "enforce" && baseVerdict !== "CLEAN" ? "BLOCK" : baseVerdict;
+        const justified = input.classifications.filter((item) => ["REQUIRED", "SUPPORTING", "TEST", "GENERATED"].includes(item.classification)).length;
+        const necessity = input.disabled ? 100 : input.classifications.length
+            ? Math.max(0, Math.round((justified / input.classifications.length) * 100 - findings.filter((item) => item.confidence !== "low").length * 5))
+            : 100;
+        const passed = input.executedTests.filter((test) => test.status === "PASSED").length;
+        const correction = input.action === "correct" && input.maxCorrectionPasses > 0 && verdict !== "CLEAN" ? input.intelligence.correction : undefined;
+        return {
+            task: input.task,
+            verdict,
+            taskAlignment: necessity >= 80 ? "high" : necessity >= 50 ? "medium" : "low",
+            changeNecessity: necessity,
+            changeSurface: surface(input.files, input.symbolCount, input.intelligence),
+            scopeDrift: input.disabled ? 0 : input.scopeDrift,
+            findings,
+            blastRadius: {
+                directCallers: input.intelligence.directCallers.length,
+                transitiveCallers: input.intelligence.transitiveCallers.length,
+                affectedPackages: input.intelligence.packages.length,
+                callers: [...input.intelligence.directCallers, ...input.intelligence.transitiveCallers],
+                packages: input.intelligence.packages,
+            },
+            testImpact: {
+                likelyAffected: input.intelligence.predictedTests.filter((test) => test.status === "LIKELY_AFFECTED").length,
+                possiblyAffected: input.intelligence.predictedTests.filter((test) => test.status === "POSSIBLY_AFFECTED").length,
+                executed: input.executedTests.length,
+                passed,
+                predicted: input.intelligence.predictedTests,
+                executedResults: input.executedTests,
+            },
+            contractChanges: input.intelligence.contracts,
+            behavioralChanges: input.intelligence.behavioralChanges,
+            reuseCandidates: input.intelligence.reuseCandidates,
+            correction,
+            recommendation: recommendation(verdict, findings, Boolean(correction)),
+            personality: personalityLine(input.personality, verdict),
+        };
+    }
+    classificationFindings(classifications) {
+        return classifications.flatMap((item, index) => {
+            if (!["SUSPICIOUS", "UNEXPLAINED", "REFACTOR", "INCIDENTAL"].includes(item.classification))
+                return [];
+            const target = "path" in item.symbol ? item.symbol.path : item.symbol.id;
+            return [{
+                    id: `classification-${index + 1}`,
+                    severity: item.classification === "UNEXPLAINED" ? "error" : "warning",
+                    confidence: item.confidence,
+                    title: item.classification === "REFACTOR" ? "Refactor contamination" : `${item.classification[0]}${item.classification.slice(1).toLowerCase()} change`,
+                    description: item.justification,
+                    affectedSymbols: [target],
+                    evidence: item.evidence,
+                    recommendation: "Remove the change or provide repository evidence that the task requires it.",
+                    autoCorrectible: true,
+                }];
+        });
+    }
+    verdict(findings, drift, untested) {
+        if (findings.some((item) => item.title === "Refactor contamination"))
+            return "SPLIT";
+        if (findings.some((item) => item.severity === "error") || drift > 0.3 || findings.length > 3)
+            return "SIMPLIFY";
+        if (untested || findings.some((item) => item.title === "Missing regression coverage"))
+            return "VERIFY";
+        if (findings.length)
+            return "REVIEW";
+        return "CLEAN";
+    }
+}
+function surface(files, symbols, intelligence) {
+    const score = files.filter((file) => !/(?:-lock\.json|pnpm-lock\.yaml|yarn\.lock)$/.test(file.path)).length
+        + Math.ceil(symbols / 3)
+        + intelligence.contracts.length * 2
+        + Math.max(0, intelligence.packages.length - 1) * 3;
+    return score <= 4 ? "LOW" : score <= 12 ? "MEDIUM" : "HIGH";
+}
+function recommendation(verdict, findings, correction) {
+    if (verdict === "CLEAN")
+        return "Patch appears appropriately scoped; no red marks found.";
+    if (correction)
+        return "Give the coding agent the single correction pass below, then run verify_change.";
+    if (verdict === "VERIFY")
+        return "Run the predicted related tests and record their actual results.";
+    if (verdict === "SPLIT")
+        return "Move unrelated refactoring into a separate patch.";
+    return `Review ${findings.length} evidence-backed finding(s) before approval.`;
+}
+function personalityLine(personality, verdict) {
+    if (personality === "conservative")
+        return verdict === "CLEAN" ? "The patch appears proportionate." : "These changes may be broader than required.";
+    if (personality === "witty")
+        return verdict === "CLEAN" ? "Nothing to circle in red." : "The diff brought guests the task did not invite.";
+    return verdict === "CLEAN" ? "Every changed line has a plausible reason." : "This task does not yet justify this patch.";
+}
+export function createRedInkReviewBuilder() {
+    return new RedInkReviewBuilder();
+}
+//# sourceMappingURL=red-ink-review.js.map

package/dist/review/red-ink-review.js.map

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

package/fixtures/retry-429/README.md

@@ -0,0 +1,8 @@
+# Retry HTTP 429 fixture
+
+This fixture represents an overly broad AI-generated candidate patch for the task
+"Retry HTTP 429 responses." The baseline already has a retry policy; the candidate
+replaces it with a single-use abstraction and adds an unrelated file.
+
+`npm run demo` copies `baseline/` into a temporary Git repository, commits it, then
+overlays `candidate/` before running Frankly's analysis.

package/fixtures/retry-429/baseline/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "retry-demo",
+  "type": "module"
+}

package/fixtures/retry-429/baseline/src/client.test.ts

@@ -0,0 +1,8 @@
+import { describe, expect, it } from "vitest";
+import { request } from "./client.js";
+
+describe("request", () => {
+    it("retries server errors", () => {
+        expect(request(500)).toBe(true);
+    });
+});

package/fixtures/retry-429/baseline/src/client.ts

@@ -0,0 +1,3 @@
+import { shouldRetry } from "./retry-policy.js";
+
+export const request = (status: number) => shouldRetry(status);

package/fixtures/retry-429/baseline/src/retry-policy.ts

@@ -0,0 +1 @@
+export const shouldRetry = (status: number) => status >= 500;

package/fixtures/retry-429/baseline/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext"
+  },
+  "include": ["src"]
+}

package/fixtures/retry-429/candidate/src/client.ts

@@ -0,0 +1,5 @@
+import { DefaultRetryStrategy } from "./retry-strategy.js";
+
+const retry = new DefaultRetryStrategy();
+
+export const request = (status: number) => retry.retry(status);

package/fixtures/retry-429/candidate/src/retry-strategy.ts

@@ -0,0 +1,9 @@
+export interface RetryStrategy {
+    retry(status: number): boolean;
+}
+
+export class DefaultRetryStrategy implements RetryStrategy {
+    retry(status: number): boolean {
+        return status === 429 || status >= 500;
+    }
+}

package/fixtures/retry-429/candidate/src/unrelated-format.ts

@@ -0,0 +1 @@
+export const unchangedBehavior = true;

package/hooks/copilot-activate.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/** @format */
+
+process.stdout.write(
+  JSON.stringify({
+    additionalContext:
+      "Frankly is active. Use plan_change before uncertain work; use analyze_change at completion; apply at most one minimize_change correction; then use verify_change with actual test results.",
+  }),
+);

package/hooks/copilot-hooks.json

@@ -0,0 +1,13 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "bash": "node \"${PLUGIN_ROOT}/hooks/copilot-activate.js\"",
+        "powershell": "node \"${PLUGIN_ROOT}\\hooks\\copilot-activate.js\"",
+        "timeoutSec": 5
+      }
+    ]
+  }
+}