aios-core 4.2.13 → 4.2.14

package/.aios-core/core/code-intel/helpers/dev-helper.js

@@ -0,0 +1,206 @@
+'use strict';
+
+const { getEnricher, getClient, isCodeIntelAvailable } = require('../index');
+
+// Risk level thresholds based on blast radius (reference count)
+const RISK_THRESHOLDS = {
+  LOW_MAX: 4,       // 0-4 refs = LOW
+  MEDIUM_MAX: 15,   // 5-15 refs = MEDIUM
+                     // >15 refs = HIGH
+};
+
+// Minimum references to suggest REUSE (>threshold = REUSE, <=threshold = ADAPT)
+const REUSE_MIN_REFS = 2;
+
+/**
+ * DevHelper — Code intelligence helper for @dev agent tasks.
+ *
+ * All functions return null gracefully when no provider is available.
+ * Never throws — safe to call unconditionally in task workflows.
+ */
+
+/**
+ * Check for duplicates and similar code before writing a new file or function.
+ * Used by IDS Gate G4 in dev-develop-story and build-autonomous tasks.
+ *
+ * @param {string} fileName - Name of the file/function to be created
+ * @param {string} description - Description of what it does
+ * @returns {Promise<{duplicates: Object, references: Array, suggestion: string}|null>}
+ */
+async function checkBeforeWriting(fileName, description) {
+  if (!isCodeIntelAvailable()) {
+    return null;
+  }
+
+  try {
+    const enricher = getEnricher();
+    const dupes = await enricher.detectDuplicates(description, { path: '.' });
+
+    // Also search for the fileName as a symbol reference
+    const client = getClient();
+    const nameRefs = await client.findReferences(fileName);
+
+    const hasMatches = (dupes && dupes.matches && dupes.matches.length > 0) ||
+      (nameRefs && nameRefs.length > 0);
+
+    if (!hasMatches) {
+      return null;
+    }
+
+    return {
+      duplicates: dupes,
+      references: nameRefs || [],
+      suggestion: _formatSuggestion(dupes, nameRefs),
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Suggest reuse of an existing symbol instead of creating a new one.
+ * Searches for definitions and references to determine REUSE vs ADAPT.
+ *
+ * @param {string} symbol - Symbol name to search for
+ * @returns {Promise<{file: string, line: number, references: number, suggestion: string}|null>}
+ */
+async function suggestReuse(symbol) {
+  if (!isCodeIntelAvailable()) {
+    return null;
+  }
+
+  try {
+    const client = getClient();
+    const [definition, refs] = await Promise.all([
+      client.findDefinition(symbol),
+      client.findReferences(symbol),
+    ]);
+
+    if (!definition && (!refs || refs.length === 0)) {
+      return null;
+    }
+
+    const refCount = refs ? refs.length : 0;
+    // REUSE if widely used, ADAPT if exists but lightly used
+    const suggestion = refCount > REUSE_MIN_REFS ? 'REUSE' : 'ADAPT';
+
+    return {
+      file: definition ? definition.file : (refs[0] ? refs[0].file : null),
+      line: definition ? definition.line : (refs[0] ? refs[0].line : null),
+      references: refCount,
+      suggestion,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Get naming conventions and patterns for a given path.
+ * Used to ensure new code follows existing project conventions.
+ *
+ * @param {string} targetPath - Path to analyze conventions for
+ * @returns {Promise<{patterns: Array, stats: Object}|null>}
+ */
+async function getConventionsForPath(targetPath) {
+  if (!isCodeIntelAvailable()) {
+    return null;
+  }
+
+  try {
+    const enricher = getEnricher();
+    return await enricher.getConventions(targetPath);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Assess refactoring impact with blast radius and risk level.
+ * Used by dev-suggest-refactoring to show impact before changes.
+ *
+ * @param {string[]} files - Files to assess impact for
+ * @returns {Promise<{blastRadius: number, riskLevel: string, references: Array, complexity: Object}|null>}
+ */
+async function assessRefactoringImpact(files) {
+  if (!isCodeIntelAvailable()) {
+    return null;
+  }
+
+  try {
+    const enricher = getEnricher();
+    const impact = await enricher.assessImpact(files);
+
+    if (!impact) {
+      return null;
+    }
+
+    return {
+      blastRadius: impact.blastRadius,
+      riskLevel: _calculateRiskLevel(impact.blastRadius),
+      references: impact.references,
+      complexity: impact.complexity,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Format a Code Intelligence Suggestion message from duplicate detection results.
+ * @param {Object|null} dupes - Result from detectDuplicates
+ * @param {Array|null} nameRefs - Result from findReferences
+ * @returns {string} Formatted suggestion message
+ * @private
+ */
+function _formatSuggestion(dupes, nameRefs) {
+  const parts = [];
+
+  if (dupes && dupes.matches && dupes.matches.length > 0) {
+    parts.push(`Found ${dupes.matches.length} similar match(es) in codebase`);
+    const firstMatch = dupes.matches[0];
+    if (firstMatch.file) {
+      parts.push(`Closest: ${firstMatch.file}${firstMatch.line ? ':' + firstMatch.line : ''}`);
+    }
+  }
+
+  if (nameRefs && nameRefs.length > 0) {
+    parts.push(`Symbol already referenced in ${nameRefs.length} location(s)`);
+    const firstRef = nameRefs[0];
+    if (firstRef.file) {
+      parts.push(`First ref: ${firstRef.file}${firstRef.line ? ':' + firstRef.line : ''}`);
+    }
+  }
+
+  parts.push('Consider REUSE or ADAPT before creating new code (IDS Article IV-A)');
+
+  return parts.join('. ') + '.';
+}
+
+/**
+ * Calculate risk level from blast radius count.
+ * @param {number} blastRadius - Number of references affected
+ * @returns {string} 'LOW' | 'MEDIUM' | 'HIGH'
+ * @private
+ */
+function _calculateRiskLevel(blastRadius) {
+  if (blastRadius <= RISK_THRESHOLDS.LOW_MAX) {
+    return 'LOW';
+  }
+  if (blastRadius <= RISK_THRESHOLDS.MEDIUM_MAX) {
+    return 'MEDIUM';
+  }
+  return 'HIGH';
+}
+
+module.exports = {
+  checkBeforeWriting,
+  suggestReuse,
+  getConventionsForPath,
+  assessRefactoringImpact,
+  // Exposed for testing
+  _formatSuggestion,
+  _calculateRiskLevel,
+  RISK_THRESHOLDS,
+  REUSE_MIN_REFS,
+};

package/.aios-core/core/registry/registry-schema.json

@@ -1,166 +1,166 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://aios.dev/schemas/service-registry.json",
-  "title": "AIOS Service Registry Schema",
-  "description": "Schema for the AIOS service registry containing workers, tasks, templates, and scripts",
-  "type": "object",
-  "required": ["version", "generated", "totalWorkers", "categories", "workers"],
-  "properties": {
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Semantic version of the registry"
-    },
-    "generated": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp when registry was generated"
-    },
-    "totalWorkers": {
-      "type": "integer",
-      "minimum": 97,
-      "description": "Total count of workers in registry"
-    },
-    "categories": {
-      "type": "object",
-      "description": "Category summary with counts and subcategories",
-      "additionalProperties": {
-        "type": "object",
-        "required": ["count"],
-        "properties": {
-          "count": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Number of workers in this category"
-          },
-          "subcategories": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "List of subcategories within this category"
-          },
-          "description": {
-            "type": "string",
-            "description": "Human-readable description of the category"
-          }
-        }
-      }
-    },
-    "workers": {
-      "type": "array",
-      "minItems": 97,
-      "items": { "$ref": "#/definitions/worker" },
-      "description": "Array of all registered workers"
-    }
-  },
-  "definitions": {
-    "worker": {
-      "type": "object",
-      "required": ["id", "name", "description", "category", "path", "taskFormat"],
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^[a-z0-9-]+$",
-          "description": "Unique kebab-case identifier"
-        },
-        "name": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Human-readable display name"
-        },
-        "description": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Brief description of worker purpose"
-        },
-        "category": {
-          "type": "string",
-          "enum": ["task", "template", "script", "checklist", "workflow", "data", "util"],
-          "description": "Primary category of the worker"
-        },
-        "subcategory": {
-          "type": "string",
-          "description": "Subcategory for finer classification"
-        },
-        "inputs": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "List of input parameters with types"
-        },
-        "outputs": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "List of output parameters with types"
-        },
-        "tags": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Searchable tags for discovery"
-        },
-        "path": {
-          "type": "string",
-          "pattern": "^\\.aios-core/",
-          "description": "Relative path from project root"
-        },
-        "taskFormat": {
-          "type": "string",
-          "enum": ["TASK-FORMAT-V1", "TASK-FORMAT-V2", "SCRIPT", "TEMPLATE", "CHECKLIST", "WORKFLOW"],
-          "description": "Format specification the worker follows"
-        },
-        "executorTypes": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "enum": ["Worker", "Agent", "Script", "Task", "CLI", "API"]
-          },
-          "description": "Types of executors that can run this worker"
-        },
-        "performance": {
-          "type": "object",
-          "properties": {
-            "avgDuration": {
-              "type": "string",
-              "pattern": "^\\d+(\\.\\d+)?(ms|s|m)$",
-              "description": "Average execution duration"
-            },
-            "cacheable": {
-              "type": "boolean",
-              "description": "Whether results can be cached"
-            },
-            "parallelizable": {
-              "type": "boolean",
-              "description": "Whether worker can run in parallel"
-            }
-          }
-        },
-        "dependencies": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "IDs of other workers this depends on"
-        },
-        "agents": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Agent IDs that primarily use this worker"
-        },
-        "metadata": {
-          "type": "object",
-          "properties": {
-            "source": {
-              "type": "string",
-              "description": "Module this worker originated from"
-            },
-            "addedVersion": {
-              "type": "string",
-              "description": "Version when worker was added"
-            },
-            "lastModified": {
-              "type": "string",
-              "format": "date-time",
-              "description": "Last modification timestamp"
-            }
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://aios.dev/schemas/service-registry.json",
+  "title": "AIOS Service Registry Schema",
+  "description": "Schema for the AIOS service registry containing workers, tasks, templates, and scripts",
+  "type": "object",
+  "required": ["version", "generated", "totalWorkers", "categories", "workers"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the registry"
+    },
+    "generated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when registry was generated"
+    },
+    "totalWorkers": {
+      "type": "integer",
+      "minimum": 97,
+      "description": "Total count of workers in registry"
+    },
+    "categories": {
+      "type": "object",
+      "description": "Category summary with counts and subcategories",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["count"],
+        "properties": {
+          "count": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Number of workers in this category"
+          },
+          "subcategories": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "List of subcategories within this category"
+          },
+          "description": {
+            "type": "string",
+            "description": "Human-readable description of the category"
+          }
+        }
+      }
+    },
+    "workers": {
+      "type": "array",
+      "minItems": 97,
+      "items": { "$ref": "#/definitions/worker" },
+      "description": "Array of all registered workers"
+    }
+  },
+  "definitions": {
+    "worker": {
+      "type": "object",
+      "required": ["id", "name", "description", "category", "path", "taskFormat"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$",
+          "description": "Unique kebab-case identifier"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Human-readable display name"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Brief description of worker purpose"
+        },
+        "category": {
+          "type": "string",
+          "enum": ["task", "template", "script", "checklist", "workflow", "data", "util"],
+          "description": "Primary category of the worker"
+        },
+        "subcategory": {
+          "type": "string",
+          "description": "Subcategory for finer classification"
+        },
+        "inputs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of input parameters with types"
+        },
+        "outputs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of output parameters with types"
+        },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Searchable tags for discovery"
+        },
+        "path": {
+          "type": "string",
+          "pattern": "^\\.aios-core/",
+          "description": "Relative path from project root"
+        },
+        "taskFormat": {
+          "type": "string",
+          "enum": ["TASK-FORMAT-V1", "TASK-FORMAT-V2", "SCRIPT", "TEMPLATE", "CHECKLIST", "WORKFLOW"],
+          "description": "Format specification the worker follows"
+        },
+        "executorTypes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["Worker", "Agent", "Script", "Task", "CLI", "API"]
+          },
+          "description": "Types of executors that can run this worker"
+        },
+        "performance": {
+          "type": "object",
+          "properties": {
+            "avgDuration": {
+              "type": "string",
+              "pattern": "^\\d+(\\.\\d+)?(ms|s|m)$",
+              "description": "Average execution duration"
+            },
+            "cacheable": {
+              "type": "boolean",
+              "description": "Whether results can be cached"
+            },
+            "parallelizable": {
+              "type": "boolean",
+              "description": "Whether worker can run in parallel"
+            }
+          }
+        },
+        "dependencies": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "IDs of other workers this depends on"
+        },
+        "agents": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Agent IDs that primarily use this worker"
+        },
+        "metadata": {
+          "type": "object",
+          "properties": {
+            "source": {
+              "type": "string",
+              "description": "Module this worker originated from"
+            },
+            "addedVersion": {
+              "type": "string",
+              "description": "Version when worker was added"
+            },
+            "lastModified": {
+              "type": "string",
+              "format": "date-time",
+              "description": "Last modification timestamp"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/.aios-core/core/synapse/diagnostics/collectors/hook-collector.js

@@ -72,7 +72,7 @@ function collectHookStatus(projectRoot) {
   }
 
   // Check 2: Hook file exists
-  const hookPath = path.join(projectRoot, '.claude', 'hooks', 'synapse-engine.js');
+  const hookPath = path.join(projectRoot, '.claude', 'hooks', 'synapse-engine.cjs');
   const hookExists = fs.existsSync(hookPath);
 
   if (hookExists) {
@@ -82,7 +82,7 @@ function collectHookStatus(projectRoot) {
       checks.push({
         name: 'Hook file exists',
         status: 'PASS',
-        detail: `.claude/hooks/synapse-engine.js (${lineCount} lines, ${stat.size} bytes)`,
+        detail: `.claude/hooks/synapse-engine.cjs (${lineCount} lines, ${stat.size} bytes)`,
       });
     } catch (error) {
       checks.push({
@@ -95,7 +95,7 @@ function collectHookStatus(projectRoot) {
     checks.push({
       name: 'Hook file exists',
       status: 'FAIL',
-      detail: '.claude/hooks/synapse-engine.js not found',
+      detail: '.claude/hooks/synapse-engine.cjs not found',
     });
   }
 

package/.aios-core/data/entity-registry.yaml

@@ -5997,6 +5997,33 @@ entities:
       checksum: sha256:310884d94b81be976a346987822306a16a73ba812c08c3b805f4a03216ffef38
       lastVerified: '2026-02-15T19:28:17.743Z'
   modules:
+    dev-helper:
+      path: .aios-core/core/code-intel/helpers/dev-helper.js
+      type: module
+      purpose: Code intelligence helper for @dev agent tasks - IDS G4 automation, duplicate detection, conventions, blast radius
+      keywords:
+        - code-intel
+        - dev-helper
+        - ids-g4
+        - duplicate-detection
+        - blast-radius
+        - conventions
+        - reuse
+      usedBy:
+        - dev-develop-story
+        - create-service
+        - dev-suggest-refactoring
+        - build-autonomous
+      dependencies:
+        - code-intel
+      adaptability:
+        score: 0.7
+        constraints:
+          - Requires code-intel module (NOG-1)
+        extensionPoints:
+          - Additional helper functions for other agents
+      checksum: ''
+      lastVerified: '2026-02-16T00:00:00.000Z'
     registry-syncer:
       path: .aios-core/core/code-intel/registry-syncer.js
       type: module