optave-codegraph 3.13.0

package/dist/infrastructure/config.d.ts

@@ -0,0 +1,281 @@
+import type { CodegraphConfig } from '../types.js';
+export type { CodegraphConfig } from '../types.js';
+export declare const CONFIG_FILES: readonly string[];
+export declare const DEFAULTS: {
+    include: string[];
+    exclude: string[];
+    ignoreDirs: string[];
+    extensions: string[];
+    aliases: Record<string, string>;
+    build: {
+        incremental: true;
+        dbPath: string;
+        driftThreshold: number;
+        smallFilesThreshold: number;
+        typescriptResolver: true;
+        engine: "auto" | "native" | "wasm";
+        fastSkipDiag: false;
+    };
+    query: {
+        defaultDepth: number;
+        defaultLimit: number;
+        excludeTests: false;
+    };
+    embeddings: {
+        model: string | null;
+        llmProvider: string | null;
+    };
+    llm: {
+        provider: string | null;
+        model: string | null;
+        baseUrl: string | null;
+        apiKey: string | null;
+        apiKeyCommand: string | null;
+    };
+    search: {
+        defaultMinScore: number;
+        rrfK: number;
+        topK: number;
+        similarityWarnThreshold: number;
+    };
+    ci: {
+        failOnCycles: false;
+        impactThreshold: number | null;
+    };
+    manifesto: {
+        rules: {
+            cognitive: {
+                warn: number;
+            };
+            cyclomatic: {
+                warn: number;
+            };
+            maxNesting: {
+                warn: number;
+            };
+            maintainabilityIndex: {
+                warn: number;
+                fail: number | null;
+            };
+            importCount: {
+                warn: number | null;
+                fail: number | null;
+            };
+            exportCount: {
+                warn: number | null;
+                fail: number | null;
+            };
+            lineCount: {
+                warn: number | null;
+                fail: number | null;
+            };
+            fanIn: {
+                warn: number | null;
+                fail: number | null;
+            };
+            fanOut: {
+                warn: number | null;
+                fail: number | null;
+            };
+            noCycles: {
+                warn: number | null;
+                fail: number | null;
+            };
+            boundaries: {
+                warn: number | null;
+                fail: number | null;
+            };
+        };
+        boundaries: unknown;
+    };
+    check: {
+        cycles: true;
+        blastRadius: number | null;
+        signatures: true;
+        boundaries: true;
+        depth: number;
+    };
+    coChange: {
+        since: string;
+        minSupport: number;
+        minJaccard: number;
+        maxFilesPerCommit: number;
+    };
+    analysis: {
+        impactDepth: number;
+        fnImpactDepth: number;
+        auditDepth: number;
+        sequenceDepth: number;
+        falsePositiveCallers: number;
+        briefCallerDepth: number;
+        briefImporterDepth: number;
+        briefHighRiskCallers: number;
+        briefMediumRiskCallers: number;
+        typePropagationDepth: number;
+        /**
+         * Confidence score assigned to a return type inferred from `return new Constructor()`
+         * when no explicit TypeScript annotation is present.
+         * Mirrors `INFERRED_RETURN_TYPE_CONFIDENCE` in `src/extractors/javascript.ts`.
+         * @reserved — not yet wired; see TODO above.
+         */
+        typeInferenceConfidence: number;
+        /**
+         * Maximum fixed-point iterations for the Phase 8.3 points-to solver.
+         * @reserved — currently not wired to either the WASM solver
+         * (`MAX_SOLVER_ITERATIONS` in `points-to.ts`) or the native Rust solver
+         * (`MAX_SOLVER_ITERATIONS` in `stages/build_edges.rs`), both of which use the
+         * same hardcoded value of 50.  See the TODO comment above.
+         */
+        pointsToMaxIterations: number;
+    };
+    community: {
+        resolution: number;
+        maxLevels: number;
+        maxLocalPasses: number;
+        refinementTheta: number;
+    };
+    structure: {
+        cohesionThreshold: number;
+    };
+    risk: {
+        weights: {
+            fanIn: number;
+            complexity: number;
+            churn: number;
+            role: number;
+            mi: number;
+        };
+        roleWeights: Record<string, number>;
+        defaultRoleWeight: number;
+    };
+    display: {
+        maxColWidth: number;
+        excerptLines: number;
+        summaryMaxChars: number;
+        jsdocEndScanLines: number;
+        jsdocOpenScanLines: number;
+        signatureGatherLines: number;
+    };
+    mcp: {
+        defaults: {
+            list_functions: number;
+            query: number;
+            where: number;
+            node_roles: number;
+            export_graph: number;
+            fn_impact: number;
+            context: number;
+            explain: number;
+            file_deps: number;
+            file_exports: number;
+            diff_impact: number;
+            impact_analysis: number;
+            semantic_search: number;
+            execution_flow: number;
+            hotspots: number;
+            co_changes: number;
+            complexity: number;
+            manifesto: number;
+            communities: number;
+            structure: number;
+            triage: number;
+            ast_query: number;
+            implementations: number;
+            interfaces: number;
+        };
+        disabledTools: string[];
+    };
+};
+/**
+ * Set the per-run user-config override from CLI flags.
+ * Called by the CLI preAction hook before any command executes.
+ * - false  → --no-user-config
+ * - string → --user-config <path>
+ * - true   → --user-config (bare, use default global file)
+ * - undefined → clear override, revert to consent-based resolution
+ */
+export declare function setUserConfigOverride(v: string | boolean | undefined): void;
+/**
+ * Return the canonical path where a new global config file should be written.
+ *
+ * Uses the same priority logic as resolveUserConfigPath() but always returns a
+ * path — it does not check whether the file exists. Used by `--init` to know
+ * where to scaffold the file.
+ *
+ * Priority:
+ * 1. CODEGRAPH_USER_CONFIG env var (used as-is)
+ * 2. $XDG_CONFIG_HOME/codegraph/config.json
+ *    %APPDATA%\codegraph\config.json  (Windows)
+ *    fallback: ~/.config/codegraph/config.json
+ */
+export declare function getDefaultUserConfigPath(): string;
+/**
+ * Resolve the absolute path to the user-level global config file.
+ *
+ * Priority:
+ * 1. CODEGRAPH_USER_CONFIG env var (location override only — not forced-on)
+ * 2. $XDG_CONFIG_HOME/codegraph/config.json  (Unix/macOS)
+ *    %APPDATA%\codegraph\config.json          (Windows)
+ *    fallback: ~/.config/codegraph/config.json
+ * 3. ~/.codegraph/config.json  (legacy, next to registry.json)
+ *
+ * Returns the path of the first existing file, or null if none exist.
+ */
+export declare function resolveUserConfigPath(): string | null;
+export declare function getLastAppliedGlobalPath(): string | null;
+export declare function getLastAppliedGlobalConfig(): Record<string, unknown> | null;
+/**
+ * Compute a short stable hash of the build-relevant config subset.
+ * Used by the pipeline to detect config changes that require a full rebuild.
+ */
+export declare function computeConfigHash(config: CodegraphConfig): string;
+/**
+ * When called from the build command, check whether we should prompt the user
+ * for global-config consent and, if so, prompt and persist the answer.
+ *
+ * Only fires when ALL of:
+ *   - A global config file exists
+ *   - The repo is undecided (no recorded consent)
+ *   - Not matched by appliesTo globs
+ *   - process.stdin.isTTY && process.stdout.isTTY
+ *   - CI env is not set
+ *   - No per-run --user-config / --no-user-config flag is active
+ */
+export declare function promptForConsentIfNeeded(rootDir: string, registryPath?: string): Promise<void>;
+/** Options for loadConfig. */
+export interface LoadConfigOpts {
+    /** Per-run user-config override (from CLI flags or programmatic call). */
+    userConfig?: string | boolean;
+    /** Registry path override (mainly for tests). */
+    registryPath?: string;
+}
+/**
+ * Load project configuration from a .codegraphrc.json or similar file.
+ * Returns merged config with defaults: defaults → global (if applied) → project → env → secrets.
+ * Results are cached per cwd + applied global path.
+ */
+export declare function loadConfig(cwd?: string, opts?: LoadConfigOpts): CodegraphConfig;
+/**
+ * Clear the config cache. Intended for long-running processes that need to
+ * pick up on-disk config changes, and for test isolation when tests share
+ * the same cwd.
+ */
+export declare function clearConfigCache(): void;
+/**
+ * Load config and return it together with per-key provenance information.
+ * Used by `codegraph config --explain`.
+ *
+ * Calls loadConfig first so _lastAppliedGlobalConfig is populated, then uses
+ * that cached data for the global-layer provenance — avoiding a second disk
+ * read and eliminating the TOCTOU window between the two reads.
+ */
+export declare function loadConfigWithProvenance(cwd?: string, opts?: LoadConfigOpts): import('../types.js').ConfigWithProvenance;
+export declare function applyEnvOverrides(config: CodegraphConfig): CodegraphConfig;
+export declare function resolveSecrets(config: CodegraphConfig): CodegraphConfig;
+interface WorkspaceEntry {
+    dir: string;
+    entry: string | null;
+}
+export declare function detectWorkspaces(rootDir: string): Map<string, WorkspaceEntry>;
+export declare function mergeConfig(defaults: Record<string, unknown>, overrides: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=config.d.ts.map

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

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