@amrishkhan05/frankly 0.1.0

package/dist/core/config.d.ts

@@ -0,0 +1,393 @@
+/**
+ * Configuration types and loader for Frankly
+ */
+import { z } from "zod";
+export type FranklyTrigger = "manual" | "checkpoint" | "continuous" | "ci" | "off";
+export type FranklyAction = "observe" | "advise" | "correct" | "enforce";
+export type FranklyIntensity = "lite" | "full" | "ultra" | "off";
+export type FranklyPersonality = "conservative" | "senior" | "witty";
+declare const ConfigSchema: z.ZodObject<{
+    trigger: z.ZodDefault<z.ZodEnum<["manual", "checkpoint", "continuous", "ci", "off"]>>;
+    action: z.ZodDefault<z.ZodEnum<["observe", "advise", "correct", "enforce"]>>;
+    intensity: z.ZodDefault<z.ZodEnum<["lite", "full", "ultra", "off"]>>;
+    personality: z.ZodDefault<z.ZodEnum<["conservative", "senior", "witty"]>>;
+    maxCorrectionPasses: z.ZodDefault<z.ZodNumber>;
+    analysis: z.ZodDefault<z.ZodObject<{
+        minimumSufficientChange: z.ZodDefault<z.ZodBoolean>;
+        taskAlignment: z.ZodDefault<z.ZodBoolean>;
+        reuseFirst: z.ZodDefault<z.ZodBoolean>;
+        scopeDrift: z.ZodDefault<z.ZodBoolean>;
+        refactorContamination: z.ZodDefault<z.ZodBoolean>;
+        unnecessaryAbstractions: z.ZodDefault<z.ZodBoolean>;
+        unnecessaryDependencies: z.ZodDefault<z.ZodBoolean>;
+        duplication: z.ZodDefault<z.ZodBoolean>;
+        blastRadius: z.ZodDefault<z.ZodBoolean>;
+        changeSurface: z.ZodDefault<z.ZodBoolean>;
+        changeNecessity: z.ZodDefault<z.ZodBoolean>;
+        reviewBurden: z.ZodDefault<z.ZodBoolean>;
+        contractChanges: z.ZodDefault<z.ZodBoolean>;
+        behavioralChanges: z.ZodDefault<z.ZodBoolean>;
+        testImpact: z.ZodDefault<z.ZodBoolean>;
+        missingRegressionTests: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        minimumSufficientChange: boolean;
+        taskAlignment: boolean;
+        reuseFirst: boolean;
+        scopeDrift: boolean;
+        refactorContamination: boolean;
+        unnecessaryAbstractions: boolean;
+        unnecessaryDependencies: boolean;
+        duplication: boolean;
+        blastRadius: boolean;
+        changeSurface: boolean;
+        changeNecessity: boolean;
+        reviewBurden: boolean;
+        contractChanges: boolean;
+        behavioralChanges: boolean;
+        testImpact: boolean;
+        missingRegressionTests: boolean;
+    }, {
+        minimumSufficientChange?: boolean | undefined;
+        taskAlignment?: boolean | undefined;
+        reuseFirst?: boolean | undefined;
+        scopeDrift?: boolean | undefined;
+        refactorContamination?: boolean | undefined;
+        unnecessaryAbstractions?: boolean | undefined;
+        unnecessaryDependencies?: boolean | undefined;
+        duplication?: boolean | undefined;
+        blastRadius?: boolean | undefined;
+        changeSurface?: boolean | undefined;
+        changeNecessity?: boolean | undefined;
+        reviewBurden?: boolean | undefined;
+        contractChanges?: boolean | undefined;
+        behavioralChanges?: boolean | undefined;
+        testImpact?: boolean | undefined;
+        missingRegressionTests?: boolean | undefined;
+    }>>;
+    restraint: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        yagni: z.ZodDefault<z.ZodBoolean>;
+        reuseExistingCodeFirst: z.ZodDefault<z.ZodBoolean>;
+        stdlibFirst: z.ZodDefault<z.ZodBoolean>;
+        platformNativeFirst: z.ZodDefault<z.ZodBoolean>;
+        installedDependenciesFirst: z.ZodDefault<z.ZodBoolean>;
+        avoidNewDependencies: z.ZodDefault<z.ZodBoolean>;
+        avoidPrematureAbstraction: z.ZodDefault<z.ZodBoolean>;
+        avoidUnnecessaryGeneralization: z.ZodDefault<z.ZodBoolean>;
+        avoidUnrelatedRefactors: z.ZodDefault<z.ZodBoolean>;
+        preferLocalChange: z.ZodDefault<z.ZodBoolean>;
+        preferSmallestSafeDiff: z.ZodDefault<z.ZodBoolean>;
+        preserveSafetyGuardrails: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        yagni: boolean;
+        reuseExistingCodeFirst: boolean;
+        stdlibFirst: boolean;
+        platformNativeFirst: boolean;
+        installedDependenciesFirst: boolean;
+        avoidNewDependencies: boolean;
+        avoidPrematureAbstraction: boolean;
+        avoidUnnecessaryGeneralization: boolean;
+        avoidUnrelatedRefactors: boolean;
+        preferLocalChange: boolean;
+        preferSmallestSafeDiff: boolean;
+        preserveSafetyGuardrails: boolean;
+    }, {
+        enabled?: boolean | undefined;
+        yagni?: boolean | undefined;
+        reuseExistingCodeFirst?: boolean | undefined;
+        stdlibFirst?: boolean | undefined;
+        platformNativeFirst?: boolean | undefined;
+        installedDependenciesFirst?: boolean | undefined;
+        avoidNewDependencies?: boolean | undefined;
+        avoidPrematureAbstraction?: boolean | undefined;
+        avoidUnnecessaryGeneralization?: boolean | undefined;
+        avoidUnrelatedRefactors?: boolean | undefined;
+        preferLocalChange?: boolean | undefined;
+        preferSmallestSafeDiff?: boolean | undefined;
+        preserveSafetyGuardrails?: boolean | undefined;
+    }>>;
+    tests: z.ZodDefault<z.ZodObject<{
+        predictAffected: z.ZodDefault<z.ZodBoolean>;
+        distinguishPredictedAndExecuted: z.ZodDefault<z.ZodBoolean>;
+        detectMissingRegressionCoverage: z.ZodDefault<z.ZodBoolean>;
+        riskBasedExecution: z.ZodDefault<z.ZodBoolean>;
+        adapters: z.ZodDefault<z.ZodObject<{
+            jest: z.ZodDefault<z.ZodBoolean>;
+            vitest: z.ZodDefault<z.ZodBoolean>;
+            nx: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            jest: boolean;
+            vitest: boolean;
+            nx: boolean;
+        }, {
+            jest?: boolean | undefined;
+            vitest?: boolean | undefined;
+            nx?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        predictAffected: boolean;
+        distinguishPredictedAndExecuted: boolean;
+        detectMissingRegressionCoverage: boolean;
+        riskBasedExecution: boolean;
+        adapters: {
+            jest: boolean;
+            vitest: boolean;
+            nx: boolean;
+        };
+    }, {
+        predictAffected?: boolean | undefined;
+        distinguishPredictedAndExecuted?: boolean | undefined;
+        detectMissingRegressionCoverage?: boolean | undefined;
+        riskBasedExecution?: boolean | undefined;
+        adapters?: {
+            jest?: boolean | undefined;
+            vitest?: boolean | undefined;
+            nx?: boolean | undefined;
+        } | undefined;
+    }>>;
+    correction: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        preserveRequestedBehavior: z.ZodDefault<z.ZodBoolean>;
+        preserveSecurity: z.ZodDefault<z.ZodBoolean>;
+        preserveValidation: z.ZodDefault<z.ZodBoolean>;
+        preserveAccessibility: z.ZodDefault<z.ZodBoolean>;
+        preserveDataIntegrity: z.ZodDefault<z.ZodBoolean>;
+        preserveErrorHandling: z.ZodDefault<z.ZodBoolean>;
+        preserveRegressionCoverage: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        preserveRequestedBehavior: boolean;
+        preserveSecurity: boolean;
+        preserveValidation: boolean;
+        preserveAccessibility: boolean;
+        preserveDataIntegrity: boolean;
+        preserveErrorHandling: boolean;
+        preserveRegressionCoverage: boolean;
+    }, {
+        enabled?: boolean | undefined;
+        preserveRequestedBehavior?: boolean | undefined;
+        preserveSecurity?: boolean | undefined;
+        preserveValidation?: boolean | undefined;
+        preserveAccessibility?: boolean | undefined;
+        preserveDataIntegrity?: boolean | undefined;
+        preserveErrorHandling?: boolean | undefined;
+        preserveRegressionCoverage?: boolean | undefined;
+    }>>;
+    report: z.ZodDefault<z.ZodObject<{
+        redInkReview: z.ZodDefault<z.ZodBoolean>;
+        showEvidence: z.ZodDefault<z.ZodBoolean>;
+        showConfidence: z.ZodDefault<z.ZodBoolean>;
+        showLowConfidenceFindings: z.ZodDefault<z.ZodBoolean>;
+        showPersonalityLine: z.ZodDefault<z.ZodBoolean>;
+        progressiveDisclosure: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        redInkReview: boolean;
+        showEvidence: boolean;
+        showConfidence: boolean;
+        showLowConfidenceFindings: boolean;
+        showPersonalityLine: boolean;
+        progressiveDisclosure: boolean;
+    }, {
+        redInkReview?: boolean | undefined;
+        showEvidence?: boolean | undefined;
+        showConfidence?: boolean | undefined;
+        showLowConfidenceFindings?: boolean | undefined;
+        showPersonalityLine?: boolean | undefined;
+        progressiveDisclosure?: boolean | undefined;
+    }>>;
+    privacy: z.ZodDefault<z.ZodObject<{
+        localOnly: z.ZodDefault<z.ZodBoolean>;
+        telemetry: z.ZodDefault<z.ZodBoolean>;
+        externalLLMCalls: z.ZodDefault<z.ZodBoolean>;
+        embeddings: z.ZodDefault<z.ZodBoolean>;
+        remoteCodeUpload: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        localOnly: boolean;
+        telemetry: boolean;
+        externalLLMCalls: boolean;
+        embeddings: boolean;
+        remoteCodeUpload: boolean;
+    }, {
+        localOnly?: boolean | undefined;
+        telemetry?: boolean | undefined;
+        externalLLMCalls?: boolean | undefined;
+        embeddings?: boolean | undefined;
+        remoteCodeUpload?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    trigger: "manual" | "checkpoint" | "continuous" | "ci" | "off";
+    action: "observe" | "advise" | "correct" | "enforce";
+    intensity: "off" | "lite" | "full" | "ultra";
+    personality: "conservative" | "senior" | "witty";
+    maxCorrectionPasses: number;
+    analysis: {
+        minimumSufficientChange: boolean;
+        taskAlignment: boolean;
+        reuseFirst: boolean;
+        scopeDrift: boolean;
+        refactorContamination: boolean;
+        unnecessaryAbstractions: boolean;
+        unnecessaryDependencies: boolean;
+        duplication: boolean;
+        blastRadius: boolean;
+        changeSurface: boolean;
+        changeNecessity: boolean;
+        reviewBurden: boolean;
+        contractChanges: boolean;
+        behavioralChanges: boolean;
+        testImpact: boolean;
+        missingRegressionTests: boolean;
+    };
+    restraint: {
+        enabled: boolean;
+        yagni: boolean;
+        reuseExistingCodeFirst: boolean;
+        stdlibFirst: boolean;
+        platformNativeFirst: boolean;
+        installedDependenciesFirst: boolean;
+        avoidNewDependencies: boolean;
+        avoidPrematureAbstraction: boolean;
+        avoidUnnecessaryGeneralization: boolean;
+        avoidUnrelatedRefactors: boolean;
+        preferLocalChange: boolean;
+        preferSmallestSafeDiff: boolean;
+        preserveSafetyGuardrails: boolean;
+    };
+    tests: {
+        predictAffected: boolean;
+        distinguishPredictedAndExecuted: boolean;
+        detectMissingRegressionCoverage: boolean;
+        riskBasedExecution: boolean;
+        adapters: {
+            jest: boolean;
+            vitest: boolean;
+            nx: boolean;
+        };
+    };
+    correction: {
+        enabled: boolean;
+        preserveRequestedBehavior: boolean;
+        preserveSecurity: boolean;
+        preserveValidation: boolean;
+        preserveAccessibility: boolean;
+        preserveDataIntegrity: boolean;
+        preserveErrorHandling: boolean;
+        preserveRegressionCoverage: boolean;
+    };
+    report: {
+        redInkReview: boolean;
+        showEvidence: boolean;
+        showConfidence: boolean;
+        showLowConfidenceFindings: boolean;
+        showPersonalityLine: boolean;
+        progressiveDisclosure: boolean;
+    };
+    privacy: {
+        localOnly: boolean;
+        telemetry: boolean;
+        externalLLMCalls: boolean;
+        embeddings: boolean;
+        remoteCodeUpload: boolean;
+    };
+}, {
+    trigger?: "manual" | "checkpoint" | "continuous" | "ci" | "off" | undefined;
+    action?: "observe" | "advise" | "correct" | "enforce" | undefined;
+    intensity?: "off" | "lite" | "full" | "ultra" | undefined;
+    personality?: "conservative" | "senior" | "witty" | undefined;
+    maxCorrectionPasses?: number | undefined;
+    analysis?: {
+        minimumSufficientChange?: boolean | undefined;
+        taskAlignment?: boolean | undefined;
+        reuseFirst?: boolean | undefined;
+        scopeDrift?: boolean | undefined;
+        refactorContamination?: boolean | undefined;
+        unnecessaryAbstractions?: boolean | undefined;
+        unnecessaryDependencies?: boolean | undefined;
+        duplication?: boolean | undefined;
+        blastRadius?: boolean | undefined;
+        changeSurface?: boolean | undefined;
+        changeNecessity?: boolean | undefined;
+        reviewBurden?: boolean | undefined;
+        contractChanges?: boolean | undefined;
+        behavioralChanges?: boolean | undefined;
+        testImpact?: boolean | undefined;
+        missingRegressionTests?: boolean | undefined;
+    } | undefined;
+    restraint?: {
+        enabled?: boolean | undefined;
+        yagni?: boolean | undefined;
+        reuseExistingCodeFirst?: boolean | undefined;
+        stdlibFirst?: boolean | undefined;
+        platformNativeFirst?: boolean | undefined;
+        installedDependenciesFirst?: boolean | undefined;
+        avoidNewDependencies?: boolean | undefined;
+        avoidPrematureAbstraction?: boolean | undefined;
+        avoidUnnecessaryGeneralization?: boolean | undefined;
+        avoidUnrelatedRefactors?: boolean | undefined;
+        preferLocalChange?: boolean | undefined;
+        preferSmallestSafeDiff?: boolean | undefined;
+        preserveSafetyGuardrails?: boolean | undefined;
+    } | undefined;
+    tests?: {
+        predictAffected?: boolean | undefined;
+        distinguishPredictedAndExecuted?: boolean | undefined;
+        detectMissingRegressionCoverage?: boolean | undefined;
+        riskBasedExecution?: boolean | undefined;
+        adapters?: {
+            jest?: boolean | undefined;
+            vitest?: boolean | undefined;
+            nx?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    correction?: {
+        enabled?: boolean | undefined;
+        preserveRequestedBehavior?: boolean | undefined;
+        preserveSecurity?: boolean | undefined;
+        preserveValidation?: boolean | undefined;
+        preserveAccessibility?: boolean | undefined;
+        preserveDataIntegrity?: boolean | undefined;
+        preserveErrorHandling?: boolean | undefined;
+        preserveRegressionCoverage?: boolean | undefined;
+    } | undefined;
+    report?: {
+        redInkReview?: boolean | undefined;
+        showEvidence?: boolean | undefined;
+        showConfidence?: boolean | undefined;
+        showLowConfidenceFindings?: boolean | undefined;
+        showPersonalityLine?: boolean | undefined;
+        progressiveDisclosure?: boolean | undefined;
+    } | undefined;
+    privacy?: {
+        localOnly?: boolean | undefined;
+        telemetry?: boolean | undefined;
+        externalLLMCalls?: boolean | undefined;
+        embeddings?: boolean | undefined;
+        remoteCodeUpload?: boolean | undefined;
+    } | undefined;
+}>;
+export type FranklyConfig = z.infer<typeof ConfigSchema>;
+export declare function loadConfig(raw: unknown): FranklyConfig;
+export declare function getDefaultConfig(): FranklyConfig;
+export declare function loadRepositoryConfig(root: string): FranklyConfig;
+export declare const INTENSITY_DESCRIPTIONS: {
+    lite: string;
+    full: string;
+    ultra: string;
+    off: string;
+};
+export declare const TRIGGER_DESCRIPTIONS: {
+    manual: string;
+    checkpoint: string;
+    continuous: string;
+    ci: string;
+    off: string;
+};
+export declare const ACTION_DESCRIPTIONS: {
+    observe: string;
+    advise: string;
+    correct: string;
+    enforce: string;
+};
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,IAAI,GAAG,KAAK,CAAC;AACnF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+FhB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEzD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAEtD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAMhE;AAED,eAAO,MAAM,sBAAsB;;;;;CAKlC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;CAMhC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;CAK/B,CAAC"}

package/dist/core/config.js

@@ -0,0 +1,130 @@
+/**
+ * Configuration types and loader for Frankly
+ */
+import { z } from "zod";
+import * as fs from "node:fs";
+import * as path from "node:path";
+const ConfigSchema = z.object({
+    trigger: z.enum(["manual", "checkpoint", "continuous", "ci", "off"]).default("checkpoint"),
+    action: z.enum(["observe", "advise", "correct", "enforce"]).default("correct"),
+    intensity: z.enum(["lite", "full", "ultra", "off"]).default("full"),
+    personality: z.enum(["conservative", "senior", "witty"]).default("senior"),
+    maxCorrectionPasses: z.number().int().min(0).max(5).default(1),
+    analysis: z
+        .object({
+        minimumSufficientChange: z.boolean().default(true),
+        taskAlignment: z.boolean().default(true),
+        reuseFirst: z.boolean().default(true),
+        scopeDrift: z.boolean().default(true),
+        refactorContamination: z.boolean().default(true),
+        unnecessaryAbstractions: z.boolean().default(true),
+        unnecessaryDependencies: z.boolean().default(true),
+        duplication: z.boolean().default(true),
+        blastRadius: z.boolean().default(true),
+        changeSurface: z.boolean().default(true),
+        changeNecessity: z.boolean().default(true),
+        reviewBurden: z.boolean().default(true),
+        contractChanges: z.boolean().default(true),
+        behavioralChanges: z.boolean().default(true),
+        testImpact: z.boolean().default(true),
+        missingRegressionTests: z.boolean().default(true),
+    })
+        .default({}),
+    restraint: z
+        .object({
+        enabled: z.boolean().default(true),
+        yagni: z.boolean().default(true),
+        reuseExistingCodeFirst: z.boolean().default(true),
+        stdlibFirst: z.boolean().default(true),
+        platformNativeFirst: z.boolean().default(true),
+        installedDependenciesFirst: z.boolean().default(true),
+        avoidNewDependencies: z.boolean().default(true),
+        avoidPrematureAbstraction: z.boolean().default(true),
+        avoidUnnecessaryGeneralization: z.boolean().default(true),
+        avoidUnrelatedRefactors: z.boolean().default(true),
+        preferLocalChange: z.boolean().default(true),
+        preferSmallestSafeDiff: z.boolean().default(true),
+        preserveSafetyGuardrails: z.boolean().default(true),
+    })
+        .default({}),
+    tests: z
+        .object({
+        predictAffected: z.boolean().default(true),
+        distinguishPredictedAndExecuted: z.boolean().default(true),
+        detectMissingRegressionCoverage: z.boolean().default(true),
+        riskBasedExecution: z.boolean().default(true),
+        adapters: z
+            .object({
+            jest: z.boolean().default(true),
+            vitest: z.boolean().default(true),
+            nx: z.boolean().default(true),
+        })
+            .default({}),
+    })
+        .default({}),
+    correction: z
+        .object({
+        enabled: z.boolean().default(true),
+        preserveRequestedBehavior: z.boolean().default(true),
+        preserveSecurity: z.boolean().default(true),
+        preserveValidation: z.boolean().default(true),
+        preserveAccessibility: z.boolean().default(true),
+        preserveDataIntegrity: z.boolean().default(true),
+        preserveErrorHandling: z.boolean().default(true),
+        preserveRegressionCoverage: z.boolean().default(true),
+    })
+        .default({}),
+    report: z
+        .object({
+        redInkReview: z.boolean().default(true),
+        showEvidence: z.boolean().default(true),
+        showConfidence: z.boolean().default(true),
+        showLowConfidenceFindings: z.boolean().default(false),
+        showPersonalityLine: z.boolean().default(true),
+        progressiveDisclosure: z.boolean().default(true),
+    })
+        .default({}),
+    privacy: z
+        .object({
+        localOnly: z.boolean().default(true),
+        telemetry: z.boolean().default(false),
+        externalLLMCalls: z.boolean().default(false),
+        embeddings: z.boolean().default(false),
+        remoteCodeUpload: z.boolean().default(false),
+    })
+        .default({}),
+});
+export function loadConfig(raw) {
+    return ConfigSchema.parse(raw);
+}
+export function getDefaultConfig() {
+    return ConfigSchema.parse({});
+}
+export function loadRepositoryConfig(root) {
+    const configPath = path.join(root, "frankly.config.json");
+    if (!fs.existsSync(configPath))
+        return getDefaultConfig();
+    const raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    delete raw.$schema;
+    return loadConfig(raw);
+}
+export const INTENSITY_DESCRIPTIONS = {
+    lite: "Only obvious issues: unrelated changes, duplicate code, unnecessary dependency, obvious scope drift",
+    full: "Complete analysis: YAGNI, reuse, abstraction, scope, blast radius, tests, contracts, minimization",
+    ultra: "Aggressively challenge: premature generalization, new helpers, abstraction, unnecessary defensive complexity, dependency additions, avoidable files/symbols, unrelated refactoring",
+    off: "No analysis",
+};
+export const TRIGGER_DESCRIPTIONS = {
+    manual: "Only run when explicitly requested",
+    checkpoint: "Run automatically at meaningful task completion points",
+    continuous: "Run on meaningful debounced edit batches",
+    ci: "Run on committed diff / CI / PR context",
+    off: "Disable Frankly",
+};
+export const ACTION_DESCRIPTIONS = {
+    observe: "Analyze only. Never instruct the agent to change the patch.",
+    advise: "Return recommendations to the coding agent.",
+    correct: "Give the coding agent exactly one automatic correction/simplification opportunity.",
+    enforce: "Block completion when configured policies fail.",
+};
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/engine.d.ts

@@ -0,0 +1,20 @@
+import type { FranklyConfig } from "./config.js";
+import type { AnalysisResult, ExecutedTest, TaskPlan } from "./models.js";
+import { Repository } from "../git/repository.js";
+import { ProjectDetector } from "../project/detector.js";
+import { SymbolExtractor } from "../graph/symbols.js";
+export interface AnalysisEngine {
+    analyze(task: string, configOverrides?: Partial<FranklyConfig>, executedTests?: ExecutedTest[]): Promise<AnalysisResult>;
+    plan(task: string): Promise<TaskPlan>;
+}
+export declare class FranklyAnalysisEngine implements AnalysisEngine {
+    private readonly repository;
+    private readonly projectDetector;
+    private readonly symbolExtractor;
+    private readonly config;
+    constructor(repository: Repository, projectDetector: ProjectDetector, symbolExtractor: SymbolExtractor, config: FranklyConfig);
+    plan(task: string): Promise<TaskPlan>;
+    analyze(task: string, configOverrides?: Partial<FranklyConfig>, executedTests?: ExecutedTest[]): Promise<AnalysisResult>;
+}
+export declare function createAnalysisEngine(repositoryPath: string): Promise<FranklyAnalysisEngine>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/core/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAA8B,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EAAkB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKtD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACzH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvC;AAED,qBAAa,qBAAsB,YAAW,cAAc;IAExD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,eAAe,EAChC,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,aAAa;IAGlC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0BrC,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,EACxC,aAAa,GAAE,YAAY,EAAO,GACjC,OAAO,CAAC,cAAc,CAAC;CA+E3B;AAED,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAOjG"}