@unerr-ai/unerr 0.1.0 → 0.1.2

package/dist/ignore.js

@@ -0,0 +1,111 @@
+/**
+ * Shared ignore-file loader for CLI commands.
+ * Supports .gitignore + .unerrignore with gitignore syntax.
+ *
+ * Standard ignore patterns for indexing. The CLI adds `.unerr`
+ * (local config dir) to the standard set.
+ */
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Directories always excluded — standard ignore patterns
+ * plus `.unerr` (CLI local config directory).
+ */
+const ALWAYS_IGNORE = [
+    // Version control
+    ".git",
+    ".svn",
+    ".hg",
+    // JavaScript / TypeScript
+    "node_modules",
+    ".next",
+    ".turbo",
+    ".yarn",
+    ".pnp",
+    // Python
+    "__pycache__",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".tox",
+    ".venv",
+    "venv",
+    ".eggs",
+    // Rust
+    "target",
+    // Java / Kotlin / Scala
+    ".gradle",
+    ".mvn",
+    // C# / .NET
+    "bin",
+    "obj",
+    ".nuget",
+    // Ruby
+    ".bundle",
+    // Generic build / tooling
+    "dist",
+    "build",
+    "out",
+    "vendor",
+    ".cache",
+    "coverage",
+    ".idea",
+    ".vscode",
+    // CI / DevOps
+    ".github",
+    ".circleci",
+    ".devcontainer",
+    // Test infrastructure
+    "__tests__",
+    "__mocks__",
+    "__snapshots__",
+    "__fixtures__",
+    "test-d",
+    // Developer tooling configs
+    ".storybook",
+    ".husky",
+    ".changeset",
+    ".nx",
+    ".parcel-cache",
+    ".swc",
+    ".esbuild",
+    ".docusaurus",
+    // CLI-specific
+    ".unerr",
+];
+/**
+ * Glob patterns that require the `ignore` package for matching.
+ * Standard ignore patterns.
+ */
+const ALWAYS_IGNORE_GLOBS = [
+    "*.egg-info/",
+    "*.test-d.ts",
+    "*.bench.js",
+    "*.bench.ts",
+    "*.min.js",
+    "*.min.css",
+    "*.d.ts.map",
+    "*.js.map",
+];
+/**
+ * Create an ignore filter for a project root.
+ * @returns An ignore instance with .ignores(relativePath) method.
+ */
+export async function createIgnoreFilter(cwd) {
+    const ignoreMod = await import("ignore");
+    const ignore = ignoreMod.default ?? ignoreMod;
+    const ig = ignore();
+    ig.add(ALWAYS_IGNORE.map((d) => `${d}/`));
+    ig.add(ALWAYS_IGNORE_GLOBS);
+    // .gitignore
+    const gitignorePath = path.join(cwd, ".gitignore");
+    if (fs.existsSync(gitignorePath)) {
+        ig.add(fs.readFileSync(gitignorePath, "utf-8"));
+    }
+    // .unerrignore
+    const unerrignorePath = path.join(cwd, ".unerrignore");
+    if (fs.existsSync(unerrignorePath)) {
+        ig.add(fs.readFileSync(unerrignorePath, "utf-8"));
+    }
+    return ig;
+}

package/dist/intelligence/approach-suggester.js

@@ -0,0 +1,61 @@
+/**
+ * Approach Suggestion Engine — suggests safer modification patterns for high-risk entities.
+ *
+ * S.4: When entity risk exceeds threshold, proactively suggests alternative approaches
+ * that are less likely to break downstream callers.
+ */
+const FAN_IN_HIGH = 30;
+const FAN_IN_CRITICAL = 50;
+/**
+ * Generate approach suggestions for an entity based on its risk profile.
+ */
+export function suggestApproach(entityKey, entityName, riskLevel, fanIn, kind) {
+    if (fanIn < FAN_IN_HIGH && riskLevel === "normal")
+        return null;
+    if (fanIn >= FAN_IN_CRITICAL) {
+        return {
+            entityKey,
+            entityName,
+            riskLevel,
+            fanIn,
+            suggestion: `${fanIn} callers depend on ${entityName}. Prefer overload/adapter pattern over signature change.`,
+            pattern: "overload-adapter",
+            rationale: `Modifying this entity directly affects ${fanIn} callers. Adding an overload preserves backward compatibility while extending functionality.`,
+        };
+    }
+    if (fanIn >= FAN_IN_HIGH) {
+        return {
+            entityKey,
+            entityName,
+            riskLevel,
+            fanIn,
+            suggestion: `${entityName} has ${fanIn} callers. Consider feature flag or interface extraction.`,
+            pattern: "feature-flag",
+            rationale: "High fan-in means changes have wide blast radius. Feature flags allow gradual rollout.",
+        };
+    }
+    if (riskLevel === "critical" || riskLevel === "high") {
+        return {
+            entityKey,
+            entityName,
+            riskLevel,
+            fanIn,
+            suggestion: `${entityName} is ${riskLevel}-risk. Add tests before modifying.`,
+            pattern: "test-first",
+            rationale: "Entities with elevated risk should have comprehensive test coverage before modification.",
+        };
+    }
+    return null;
+}
+/**
+ * Generate suggestions for all high-risk entities in a file.
+ */
+export function suggestApproachesForFile(entities) {
+    const suggestions = [];
+    for (const entity of entities) {
+        const suggestion = suggestApproach(entity.key, entity.name, entity.risk_level ?? "normal", entity.fan_in ?? 0, entity.kind);
+        if (suggestion)
+            suggestions.push(suggestion);
+    }
+    return suggestions;
+}