@neurcode-ai/cli 0.9.64 → 0.9.65

package/dist/workspace/federated-context.js

@@ -0,0 +1,347 @@
+"use strict";
+/**
+ * Federated Context Builder
+ *
+ * Answers the question: "When a developer changes files in repo-A, what is the
+ * complete blast radius across ALL repos in the workspace?"
+ *
+ * This is the enterprise multi-repo answer that single-repo context engines cannot
+ * provide. The federated context:
+ *
+ *   1. Builds the PRIMARY context from the repo where changes are occurring
+ *      (full depth — constraints, advisory, uncertainty)
+ *
+ *   2. Resolves SECONDARY context for every repo transitively affected
+ *      via cross-repo edges (lighter weight — impacted files + why)
+ *
+ *   3. Returns BLIND SPOTS — coupling that cannot be detected structurally
+ *      (config coupling, runtime service discovery, infra-level routing)
+ *
+ * The output is deterministic: same changed files + same workspace topology
+ * + same cross-repo graph → identical FederatedContextPackage.
+ *
+ * Design constraint: this layer is ADDITIVE. It never replaces the primary
+ * single-repo context engine. It extends it with cross-repo intelligence.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFederatedContext = buildFederatedContext;
+exports.formatFederatedContextSummary = formatFederatedContextSummary;
+const cross_repo_graph_1 = require("./cross-repo-graph");
+/** Hard ceilings for cross-repo expansion — deterministic caps, never silent. */
+const MAX_FEDERATED_DOWNSTREAM_REPOS = 24;
+const MAX_FEDERATED_UPSTREAM_REPOS = 24;
+const MAX_FEDERATED_TOTAL_EDGES = 400;
+/**
+ * Build the federated context package for a multi-repo workspace.
+ *
+ * This is the core function that answers: "What is the blast radius
+ * of this change across the entire service mesh?"
+ */
+function buildFederatedContext(input) {
+    const { workspaceName, repos, primaryRepoName, changedFiles, brainMaps = {}, } = input;
+    const truncationReasons = [];
+    const changedFilesSorted = [...changedFiles].sort((a, b) => a.localeCompare(b));
+    // Step 1: Build the cross-repo graph (or use pre-built)
+    const crossRepoGraph = (0, cross_repo_graph_1.buildCrossRepoGraph)({ repos, brainMaps });
+    // Step 2: Find all edges FROM changed files in the primary repo
+    //         These edges tell us: "this file couples to another repo"
+    const allEdgesFromChanges = [];
+    for (const changedFile of changedFilesSorted) {
+        const edges = (0, cross_repo_graph_1.getEdgesForFile)(crossRepoGraph, primaryRepoName, changedFile);
+        allEdgesFromChanges.push(...edges);
+    }
+    // Step 3: Identify all edges pointing TO the primary repo's changed files
+    //         These tell us: "another repo imports THIS file we just changed"
+    const inboundEdgesFromChanges = [];
+    for (const changedFile of changedFilesSorted) {
+        const edges = (0, cross_repo_graph_1.getEdgesPointingToFile)(crossRepoGraph, primaryRepoName, changedFile);
+        inboundEdgesFromChanges.push(...edges);
+    }
+    const combinedEdges = [...allEdgesFromChanges, ...inboundEdgesFromChanges];
+    if (combinedEdges.length > MAX_FEDERATED_TOTAL_EDGES) {
+        truncationReasons.push(`total cross-repo edges capped at ${MAX_FEDERATED_TOTAL_EDGES} (had ${combinedEdges.length})`);
+    }
+    // Step 4: Resolve downstream repos — repos that DEPEND ON the primary repo
+    //         When the primary repo's API/contract changes, these are at risk
+    const downstreamRepoNames = (0, cross_repo_graph_1.getDownstreamRepos)(crossRepoGraph, primaryRepoName);
+    const affectedDownstreamRepos = downstreamRepoNames
+        .map((repoName) => {
+        const repoConfig = repos.find((r) => r.name === repoName);
+        if (!repoConfig)
+            return null;
+        const relevantEdges = inboundEdgesFromChanges
+            .filter((e) => e.fromRepo === repoName)
+            .sort((a, b) => confidenceRank(b.confidence) - confidenceRank(a.confidence));
+        // Find file-level affected files in this downstream repo
+        const affectedFiles = resolveAffectedFilesInRepo(repoConfig, relevantEdges, brainMaps[repoName] ?? null);
+        const riskLevel = deriveRiskLevel(relevantEdges);
+        const requiresCoordinatedDeploy = relevantEdges.some((e) => e.confidence === 'high' &&
+            ['shared-contract', 'grpc-client', 'openapi-client'].includes(e.via));
+        return {
+            repoName,
+            repoRoot: repoConfig.rootPath,
+            affectedFiles,
+            couplingEdges: relevantEdges,
+            riskLevel,
+            requiresCoordinatedDeploy,
+        };
+    })
+        .filter((r) => r !== null);
+    // Step 5: Resolve upstream repos — repos that the primary repo calls
+    //         When changed files touch those call sites, upstream context matters
+    const upstreamRepoNames = (0, cross_repo_graph_1.getUpstreamRepos)(crossRepoGraph, primaryRepoName);
+    const relevantUpstreamRepos = upstreamRepoNames
+        .filter((repoName) => !repoName.startsWith('external:'))
+        .map((repoName) => {
+        const repoConfig = repos.find((r) => r.name === repoName);
+        if (!repoConfig)
+            return null;
+        const relevantEdges = allEdgesFromChanges
+            .filter((e) => e.toRepo === repoName)
+            .sort((a, b) => confidenceRank(b.confidence) - confidenceRank(a.confidence));
+        if (relevantEdges.length === 0)
+            return null; // upstream but no edge from changed files
+        const affectedFiles = resolveAffectedFilesInRepo(repoConfig, relevantEdges, brainMaps[repoName] ?? null);
+        const riskLevel = deriveRiskLevel(relevantEdges);
+        const requiresCoordinatedDeploy = relevantEdges.some((e) => e.confidence === 'high' &&
+            ['shared-contract', 'grpc-client', 'openapi-client'].includes(e.via));
+        return {
+            repoName,
+            repoRoot: repoConfig.rootPath,
+            affectedFiles,
+            couplingEdges: relevantEdges,
+            riskLevel,
+            requiresCoordinatedDeploy,
+        };
+    })
+        .filter((r) => r !== null);
+    // Step 6: Compute federated blindspots
+    const federatedBlindSpots = computeFederatedBlindSpots(repos, primaryRepoName, changedFilesSorted, crossRepoGraph);
+    let downstreamExport = affectedDownstreamRepos;
+    if (downstreamExport.length > MAX_FEDERATED_DOWNSTREAM_REPOS) {
+        truncationReasons.push(`downstream repos capped at ${MAX_FEDERATED_DOWNSTREAM_REPOS} (had ${downstreamExport.length})`);
+        downstreamExport = downstreamExport
+            .slice()
+            .sort((a, b) => a.repoName.localeCompare(b.repoName))
+            .slice(0, MAX_FEDERATED_DOWNSTREAM_REPOS);
+    }
+    let upstreamExport = relevantUpstreamRepos;
+    if (upstreamExport.length > MAX_FEDERATED_UPSTREAM_REPOS) {
+        truncationReasons.push(`upstream repos capped at ${MAX_FEDERATED_UPSTREAM_REPOS} (had ${upstreamExport.length})`);
+        upstreamExport = upstreamExport
+            .slice()
+            .sort((a, b) => a.repoName.localeCompare(b.repoName))
+            .slice(0, MAX_FEDERATED_UPSTREAM_REPOS);
+    }
+    const edgeTotal = Math.min(combinedEdges.length, MAX_FEDERATED_TOTAL_EDGES);
+    const coordinatedExport = [
+        ...downstreamExport.filter((r) => r.requiresCoordinatedDeploy).map((r) => r.repoName),
+        ...upstreamExport.filter((r) => r.requiresCoordinatedDeploy).map((r) => r.repoName),
+    ];
+    const summary = {
+        totalCrossRepoEdgesFromChangedFiles: edgeTotal,
+        downstreamRepoCount: downstreamExport.length,
+        upstreamRepoCount: upstreamExport.length,
+        highConfidenceEdgeCount: combinedEdges
+            .filter((e) => e.confidence === 'high')
+            .slice(0, MAX_FEDERATED_TOTAL_EDGES)
+            .length,
+        requiresCoordinatedDeploy: coordinatedExport.length > 0,
+        coordinatedDeployRepos: [...new Set(coordinatedExport)].sort(),
+    };
+    const federationBoundary = {
+        maxCrossRepoDepth: 1,
+        maxDownstreamReposIncluded: MAX_FEDERATED_DOWNSTREAM_REPOS,
+        maxUpstreamReposIncluded: MAX_FEDERATED_UPSTREAM_REPOS,
+        maxTotalEdges: MAX_FEDERATED_TOTAL_EDGES,
+        traversalOrdering: 'deterministic-alpha',
+        truncated: truncationReasons.length > 0,
+        truncationReasons,
+    };
+    return {
+        generatedAt: new Date().toISOString(),
+        workspaceName,
+        primaryRepo: primaryRepoName,
+        changedFiles: changedFilesSorted,
+        crossRepoGraph,
+        affectedDownstreamRepos: downstreamExport,
+        relevantUpstreamRepos: upstreamExport,
+        federatedBlindSpots,
+        summary,
+        federationBoundary,
+    };
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function confidenceRank(c) {
+    return c === 'high' ? 3 : c === 'medium' ? 2 : 1;
+}
+function deriveRiskLevel(edges) {
+    if (edges.some((e) => e.confidence === 'high'))
+        return 'high';
+    if (edges.some((e) => e.confidence === 'medium'))
+        return 'medium';
+    return 'low';
+}
+/**
+ * Given edges pointing to/from a repo and its brain map,
+ * identify specific files in that repo that are likely affected.
+ */
+function resolveAffectedFilesInRepo(repoConfig, edges, brainMap) {
+    const result = [];
+    const seen = new Set();
+    for (const edge of edges) {
+        // If the edge pins a specific file in this repo, include it
+        if (edge.toFile && !seen.has(edge.toFile)) {
+            seen.add(edge.toFile);
+            result.push({
+                file: edge.toFile,
+                reason: edge.impactSummary,
+            });
+        }
+        // For shared-contract edges, find the defining file in brain map
+        if (edge.via === 'shared-contract' && brainMap) {
+            const contractKeyword = edge.evidence[0]
+                ?.match(/['"]([^'"]+)['"]/)?.[1]
+                ?.split('/')
+                .pop()
+                ?.replace(/-/g, '') ?? '';
+            if (contractKeyword) {
+                for (const filePath of Object.keys(brainMap.files)) {
+                    const norm = filePath.toLowerCase().replace(/[-./]/g, '');
+                    if (norm.includes(contractKeyword.toLowerCase()) && !seen.has(filePath)) {
+                        seen.add(filePath);
+                        result.push({
+                            file: filePath,
+                            reason: `Shared contract type definition affected by upstream change`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Compute structural blindspots in federated context.
+ *
+ * These are coupling patterns that exist at infrastructure/config level
+ * and cannot be detected by scanning source code.
+ */
+function computeFederatedBlindSpots(repos, primaryRepoName, changedFiles, graph) {
+    const spots = [];
+    const allRepoNames = repos.filter((r) => r.name !== primaryRepoName).map((r) => r.name);
+    // Blindspot 1: Infrastructure-level service routing
+    // API gateways, service meshes (Istio/Envoy), and load balancers route
+    // traffic based on config files that are not in source code
+    const hasApiRouteChanges = changedFiles.some((f) => /route|controller|handler|endpoint/i.test(f));
+    if (hasApiRouteChanges) {
+        spots.push({
+            description: 'API route changes may affect service mesh routing rules (Istio VirtualServices, ' +
+                'Kong routes, nginx upstreams) that are defined in infrastructure repos not scanned here.',
+            potentialRepos: allRepoNames,
+            structuralGap: 'infra-routing-config',
+        });
+    }
+    // Blindspot 2: Runtime service discovery
+    // Services registered in consul/etcd/k8s service registry are resolved at runtime.
+    // Code scanning cannot see this registration.
+    const detectedEnvServiceUrls = graph.edges.filter((e) => e.fromRepo === primaryRepoName && e.via === 'env-service-url');
+    if (detectedEnvServiceUrls.length > 0) {
+        spots.push({
+            description: 'Service URLs resolved via environment variables at runtime — the actual target ' +
+                'service depends on deployment configuration (Kubernetes ConfigMaps, Vault, ' +
+                'cloud parameter stores) not visible to static analysis.',
+            potentialRepos: allRepoNames,
+            structuralGap: 'runtime-service-discovery',
+        });
+    }
+    // Blindspot 3: Sidecar proxy / service mesh config
+    const hasAuthChanges = changedFiles.some((f) => /auth|jwt|token|session|rbac|permission/i.test(f));
+    if (hasAuthChanges) {
+        spots.push({
+            description: 'Authentication changes may affect sidecar proxy config (Envoy JWT filters, ' +
+                'Istio AuthorizationPolicies) applied at the mesh level across ALL services ' +
+                'without code-level imports.',
+            potentialRepos: allRepoNames,
+            structuralGap: 'sidecar-proxy-config',
+        });
+    }
+    // Blindspot 4: Feature flag routing
+    // Feature flags can route traffic to different service versions at runtime
+    const hasFeatureFlagChanges = changedFiles.some((f) => /feature|flag|experiment|variant|rollout|toggle/i.test(f));
+    if (hasFeatureFlagChanges) {
+        spots.push({
+            description: 'Feature flag changes may affect runtime traffic routing across services ' +
+                '(LaunchDarkly, Unleash, custom flag evaluators). The set of affected services ' +
+                'depends on flag evaluation trees not visible in source code.',
+            potentialRepos: allRepoNames,
+            structuralGap: 'feature-flag-routing',
+        });
+    }
+    // Blindspot 5: Shared DB state (services sharing a database)
+    const hasDbChanges = changedFiles.some((f) => /migration|schema|entity|model|repository|prisma/i.test(f));
+    if (hasDbChanges) {
+        const dbEdgeRepos = graph.edges
+            .filter((e) => e.fromRepo === primaryRepoName && e.via === 'db-shared-schema')
+            .map((e) => e.toRepo);
+        spots.push({
+            description: 'Database schema/migration changes may affect other services that share the ' +
+                'same database. Without explicit db-shared-schema edges detected in code, ' +
+                'the full set of affected services cannot be determined statically.',
+            potentialRepos: dbEdgeRepos.length > 0 ? dbEdgeRepos : allRepoNames,
+            structuralGap: 'db-shared-state',
+        });
+    }
+    // Blindspot 6: Compiled proto drift
+    const hasProtoChanges = changedFiles.some((f) => /\.proto$|proto\//i.test(f));
+    if (hasProtoChanges) {
+        spots.push({
+            description: 'Proto schema changes require regenerating clients in ALL consuming services. ' +
+                'Services that import generated stubs from a registry (npm, artifact store) ' +
+                'may not have a code-level import that traces back to this proto file.',
+            potentialRepos: allRepoNames,
+            structuralGap: 'compiled-proto-drift',
+        });
+    }
+    return spots;
+}
+// ── Formatting Helpers (for CLI / dashboard rendering) ────────────────────────
+function formatFederatedContextSummary(pkg) {
+    const lines = [];
+    lines.push(`Federated Context: ${pkg.workspaceName}`);
+    lines.push(`Primary repo: ${pkg.primaryRepo}`);
+    lines.push(`Changed files: ${pkg.changedFiles.length}`);
+    lines.push('');
+    if (pkg.summary.requiresCoordinatedDeploy) {
+        lines.push(`⚠️  Coordinated deploy required: ${pkg.summary.coordinatedDeployRepos.join(', ')}`);
+        lines.push('');
+    }
+    if (pkg.affectedDownstreamRepos.length > 0) {
+        lines.push(`Downstream repos affected (${pkg.affectedDownstreamRepos.length}):`);
+        for (const repo of pkg.affectedDownstreamRepos) {
+            const risk = repo.riskLevel === 'high' ? '🔴' : repo.riskLevel === 'medium' ? '🟡' : '🟢';
+            const coordFlag = repo.requiresCoordinatedDeploy ? ' [coordinated-deploy]' : '';
+            lines.push(`  ${risk} ${repo.repoName}${coordFlag}`);
+            for (const edge of repo.couplingEdges.slice(0, 2)) {
+                lines.push(`     via ${edge.via} (${edge.confidence}) — ${edge.impactSummary}`);
+            }
+        }
+        lines.push('');
+    }
+    if (pkg.relevantUpstreamRepos.length > 0) {
+        lines.push(`Upstream repos in scope (${pkg.relevantUpstreamRepos.length}):`);
+        for (const repo of pkg.relevantUpstreamRepos) {
+            const risk = repo.riskLevel === 'high' ? '🔴' : repo.riskLevel === 'medium' ? '🟡' : '🟢';
+            lines.push(`  ${risk} ${repo.repoName}`);
+        }
+        lines.push('');
+    }
+    if (pkg.federatedBlindSpots.length > 0) {
+        lines.push(`Structural blindspots (${pkg.federatedBlindSpots.length}):`);
+        for (const spot of pkg.federatedBlindSpots) {
+            lines.push(`  ⚡ [${spot.structuralGap}] ${spot.description.slice(0, 120)}...`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=federated-context.js.map

package/dist/workspace/federated-context.js.map

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

package/dist/workspace/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Neurcode Workspace Intelligence Layer
+ *
+ * Provides cross-repo context building for multi-service architectures.
+ *
+ * Architecture overview:
+ *
+ *   WorkspaceDefinition (workspace-runtime.ts)
+ *     └─ repos: WorkspaceRepository[]      ← topology declaration
+ *
+ *   CrossRepoGraph (cross-repo-graph.ts)
+ *     └─ edges: CrossRepoEdge[]            ← detected coupling (code-level)
+ *        via: http-client | grpc-client | event-publish | event-subscribe
+ *             | shared-contract | env-service-url | openapi-client | db-shared-schema
+ *        confidence: high | medium | low
+ *
+ *   FederatedContextPackage (federated-context.ts)
+ *     └─ affectedDownstreamRepos[]         ← repos that call the changed files
+ *     └─ relevantUpstreamRepos[]           ← repos being called by changed code
+ *     └─ federatedBlindSpots[]             ← coupling invisible to code scanning
+ *     └─ summary.requiresCoordinatedDeploy ← true = must deploy together
+ *
+ * Usage:
+ *   import { buildFederatedContext } from '@neurcode-ai/cli/workspace';
+ *
+ *   const context = buildFederatedContext({
+ *     workspaceName: 'platform',
+ *     repos: workspaceDefinition.repositories,
+ *     primaryRepoName: 'auth-service',
+ *     changedFiles: ['src/auth/jwt.service.ts'],
+ *     brainMaps: { 'auth-service': authBrain, 'billing-service': billingBrain },
+ *   });
+ *
+ *   console.log(formatFederatedContextSummary(context));
+ */
+export { buildCrossRepoGraph, getDownstreamRepos, getEdgesForFile, getEdgesPointingToFile, getUpstreamRepos, type CrossRepoBuildOptions, type CrossRepoEdge, type CrossRepoEdgeConfidence, type CrossRepoEdgeVia, type CrossRepoGraph, } from './cross-repo-graph';
+export { buildFederatedContext, formatFederatedContextSummary, type AffectedRepoContext, type FederatedBlindSpot, type FederatedContextBuildInput, type FederatedContextPackage, type FederatedExpansionBoundary, } from './federated-context';
+//# sourceMappingURL=index.d.ts.map

package/dist/workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC"}

package/dist/workspace/index.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Neurcode Workspace Intelligence Layer
+ *
+ * Provides cross-repo context building for multi-service architectures.
+ *
+ * Architecture overview:
+ *
+ *   WorkspaceDefinition (workspace-runtime.ts)
+ *     └─ repos: WorkspaceRepository[]      ← topology declaration
+ *
+ *   CrossRepoGraph (cross-repo-graph.ts)
+ *     └─ edges: CrossRepoEdge[]            ← detected coupling (code-level)
+ *        via: http-client | grpc-client | event-publish | event-subscribe
+ *             | shared-contract | env-service-url | openapi-client | db-shared-schema
+ *        confidence: high | medium | low
+ *
+ *   FederatedContextPackage (federated-context.ts)
+ *     └─ affectedDownstreamRepos[]         ← repos that call the changed files
+ *     └─ relevantUpstreamRepos[]           ← repos being called by changed code
+ *     └─ federatedBlindSpots[]             ← coupling invisible to code scanning
+ *     └─ summary.requiresCoordinatedDeploy ← true = must deploy together
+ *
+ * Usage:
+ *   import { buildFederatedContext } from '@neurcode-ai/cli/workspace';
+ *
+ *   const context = buildFederatedContext({
+ *     workspaceName: 'platform',
+ *     repos: workspaceDefinition.repositories,
+ *     primaryRepoName: 'auth-service',
+ *     changedFiles: ['src/auth/jwt.service.ts'],
+ *     brainMaps: { 'auth-service': authBrain, 'billing-service': billingBrain },
+ *   });
+ *
+ *   console.log(formatFederatedContextSummary(context));
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatFederatedContextSummary = exports.buildFederatedContext = exports.getUpstreamRepos = exports.getEdgesPointingToFile = exports.getEdgesForFile = exports.getDownstreamRepos = exports.buildCrossRepoGraph = void 0;
+var cross_repo_graph_1 = require("./cross-repo-graph");
+Object.defineProperty(exports, "buildCrossRepoGraph", { enumerable: true, get: function () { return cross_repo_graph_1.buildCrossRepoGraph; } });
+Object.defineProperty(exports, "getDownstreamRepos", { enumerable: true, get: function () { return cross_repo_graph_1.getDownstreamRepos; } });
+Object.defineProperty(exports, "getEdgesForFile", { enumerable: true, get: function () { return cross_repo_graph_1.getEdgesForFile; } });
+Object.defineProperty(exports, "getEdgesPointingToFile", { enumerable: true, get: function () { return cross_repo_graph_1.getEdgesPointingToFile; } });
+Object.defineProperty(exports, "getUpstreamRepos", { enumerable: true, get: function () { return cross_repo_graph_1.getUpstreamRepos; } });
+var federated_context_1 = require("./federated-context");
+Object.defineProperty(exports, "buildFederatedContext", { enumerable: true, get: function () { return federated_context_1.buildFederatedContext; } });
+Object.defineProperty(exports, "formatFederatedContextSummary", { enumerable: true, get: function () { return federated_context_1.formatFederatedContextSummary; } });
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,uDAW4B;AAV1B,uHAAA,mBAAmB,OAAA;AACnB,sHAAA,kBAAkB,OAAA;AAClB,mHAAA,eAAe,OAAA;AACf,0HAAA,sBAAsB,OAAA;AACtB,oHAAA,gBAAgB,OAAA;AAQlB,yDAQ6B;AAP3B,0HAAA,qBAAqB,OAAA;AACrB,kIAAA,6BAA6B,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neurcode-ai/cli",
-  "version": "0.9.64",
+  "version": "0.9.65",
   "description": "Neurcode CLI - AI code governance and diff analysis",
   "bin": {
     "neurcode": "dist/index.js"
@@ -11,12 +11,6 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "rm -rf dist && tsc && chmod +x dist/index.js",
-    "dev": "tsc --watch",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "cli",
     "code-governance",
@@ -56,7 +50,8 @@
     "open": "^10.1.0",
     "ts-morph": "^24.0.0",
     "uuid": "^9.0.1",
-    "zod": "^4.3.5"
+    "zod": "^4.3.5",
+    "@neurcode-ai/telemetry": "0.1.0"
   },
   "publishConfig": {
     "access": "public"
@@ -67,5 +62,10 @@
     "@types/node": "^20.10.0",
     "@types/uuid": "^9.0.8",
     "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
   }
-}
+}