aios-core 4.2.14 → 4.3.0

package/.aios-core/core/config/schemas/project-config.schema.json

@@ -5,25 +5,339 @@
   "description": "Team-shared project settings stored in .aios-core/project-config.yaml",
   "type": "object",
   "properties": {
-    "project_name": {
-      "type": "string",
-      "description": "Project name"
+    "project": {
+      "type": "object",
+      "description": "Project metadata",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["EXISTING_AIOS", "NEW_PROJECT", "BROWNFIELD"],
+          "description": "Project installation type"
+        },
+        "installed_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 installation timestamp"
+        },
+        "version": {
+          "type": "string",
+          "description": "Project config version"
+        }
+      },
+      "required": ["type"],
+      "additionalProperties": false
     },
-    "project_type": {
-      "type": "string",
-      "enum": ["fullstack", "api", "frontend", "library", "cli"],
-      "description": "Project type"
+    "documentation_paths": {
+      "type": "object",
+      "description": "Paths to documentation artifacts",
+      "properties": {
+        "qa_dir": { "type": "string" },
+        "prd_file": { "type": "string" },
+        "prd_version": { "type": "string" },
+        "prd_sharded": { "type": "boolean" },
+        "prd_sharded_location": { "type": "string" },
+        "architecture_file": { "type": "string" },
+        "architecture_version": { "type": "string" },
+        "architecture_sharded": { "type": "boolean" },
+        "architecture_sharded_location": { "type": "string" },
+        "stories_dir": { "type": "string" },
+        "dev_debug_log": { "type": "string" },
+        "slash_prefix": { "type": "string", "description": "Prefix for slash commands in IDEs" },
+        "custom_technical_documents": {
+          "oneOf": [
+            { "type": "array", "items": { "type": "string" } },
+            { "type": "null" }
+          ]
+        },
+        "dev_load_always_files": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Files loaded on every dev agent activation"
+        },
+        "dev_load_always_files_fallback": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Fallback files for i18n variants"
+        }
+      },
+      "additionalProperties": false
     },
-    "environments": {
+    "github_integration": {
       "type": "object",
-      "description": "Environment-specific configurations",
-      "additionalProperties": {
-        "type": "object"
-      }
+      "description": "GitHub integration settings",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "cli_required": { "type": "boolean" },
+        "features": {
+          "type": "object",
+          "properties": {
+            "pr_creation": { "type": "boolean" },
+            "issue_management": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        },
+        "pr": {
+          "type": "object",
+          "properties": {
+            "title_format": { "type": "string" },
+            "include_story_id": { "type": "boolean" },
+            "conventional_commits": {
+              "type": "object",
+              "properties": {
+                "enabled": { "type": "boolean" },
+                "branch_type_map": {
+                  "type": "object",
+                  "additionalProperties": { "type": "string" }
+                },
+                "default_type": { "type": "string" }
+              },
+              "additionalProperties": false
+            },
+            "auto_assign_reviewers": { "type": "boolean" },
+            "draft_by_default": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        },
+        "semantic_release": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
     },
-    "deploy_target": {
-      "type": "string",
-      "description": "Deployment target platform"
+    "coderabbit_integration": {
+      "type": "object",
+      "description": "CodeRabbit automated review integration",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "self_healing": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "type": { "type": "string", "enum": ["light", "full"] },
+            "max_iterations": { "type": "integer", "minimum": 1 },
+            "timeout_minutes": { "type": "integer", "minimum": 1 }
+          },
+          "additionalProperties": false
+        },
+        "severity_handling": {
+          "type": "object",
+          "properties": {
+            "CRITICAL": { "type": "string", "enum": ["auto_fix", "document_as_debt", "ignore"] },
+            "HIGH": { "type": "string", "enum": ["auto_fix", "document_as_debt", "ignore"] },
+            "MEDIUM": { "type": "string", "enum": ["auto_fix", "document_as_debt", "ignore"] },
+            "LOW": { "type": "string", "enum": ["auto_fix", "document_as_debt", "ignore"] }
+          },
+          "additionalProperties": false
+        },
+        "graceful_degradation": {
+          "type": "object",
+          "properties": {
+            "skip_if_not_installed": { "type": "boolean" },
+            "fallback_message": { "type": "string" }
+          },
+          "additionalProperties": false
+        },
+        "report_location": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "squads": {
+      "type": "object",
+      "description": "Squad system configuration",
+      "properties": {
+        "template_location": { "type": "string" },
+        "auto_load": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "logging": {
+      "type": "object",
+      "description": "Logging, status, and agent identity configuration",
+      "properties": {
+        "decision_logging": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "async": { "type": "boolean" },
+            "location": { "type": "string" },
+            "index_file": { "type": "string" },
+            "format": { "type": "string" },
+            "performance": {
+              "type": "object",
+              "properties": {
+                "max_overhead": { "type": "integer", "minimum": 0 }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "project_status": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "auto_load_on_agent_activation": { "type": "boolean" },
+            "show_in_greeting": { "type": "boolean" },
+            "cache_time_seconds": { "type": "integer", "minimum": 0 },
+            "components": {
+              "type": "object",
+              "properties": {
+                "git_branch": { "type": "boolean" },
+                "git_status": { "type": "boolean" },
+                "recent_work": { "type": "boolean" },
+                "current_epic": { "type": "boolean" },
+                "current_story": { "type": "boolean" }
+              },
+              "additionalProperties": false
+            },
+            "status_file": { "type": "string" },
+            "max_modified_files": { "type": "integer", "minimum": 1 },
+            "max_recent_commits": { "type": "integer", "minimum": 1 }
+          },
+          "additionalProperties": false
+        },
+        "agent_identity": {
+          "type": "object",
+          "properties": {
+            "greeting": {
+              "type": "object",
+              "properties": {
+                "context_detection": { "type": "boolean" },
+                "session_detection": { "type": "string" },
+                "workflow_detection": { "type": "string" },
+                "performance": {
+                  "type": "object",
+                  "properties": {
+                    "git_check_cache": { "type": "boolean" },
+                    "git_check_ttl": { "type": "integer", "minimum": 0 }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "story_backlog": {
+      "type": "object",
+      "description": "Story backlog settings",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "location": { "type": "string" },
+        "prioritization": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "pv_mind_context": {
+      "type": "object",
+      "description": "PV Mind context configuration",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "location": { "type": "string" },
+        "features": {
+          "type": "object",
+          "properties": {
+            "persona_voice": { "type": "boolean" },
+            "technical_depth": { "type": "string" },
+            "communication_style": { "type": "string" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "auto_claude": {
+      "type": "object",
+      "description": "Auto-Claude autonomous execution settings",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "version": { "type": "string" },
+        "migrated_at": { "type": "string", "format": "date-time" },
+        "worktree": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "auto_create": { "type": "string" },
+            "auto_cleanup": { "type": "string" },
+            "max_worktrees": { "type": "integer", "minimum": 1 },
+            "stale_days": { "type": "integer", "minimum": 1 },
+            "branch_prefix": { "type": "string" }
+          },
+          "additionalProperties": false
+        },
+        "spec_pipeline": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean" } },
+          "additionalProperties": false
+        },
+        "execution": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean" } },
+          "additionalProperties": false
+        },
+        "qa": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean" } },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "boundary": {
+      "type": "object",
+      "description": "Framework boundary protection configuration",
+      "properties": {
+        "frameworkProtection": {
+          "type": "boolean",
+          "description": "Enable/disable deny rules for framework protection",
+          "default": true
+        },
+        "protected": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns of protected framework paths"
+        },
+        "exceptions": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns excluded from protection"
+        }
+      },
+      "required": ["frameworkProtection"],
+      "additionalProperties": false
+    },
+    "template_overrides": {
+      "type": "object",
+      "description": "Template customization overrides (from L1 defaults)",
+      "properties": {
+        "story": {
+          "type": "object",
+          "properties": {
+            "sections_order": {
+              "oneOf": [
+                { "type": "array", "items": { "type": "string" } },
+                { "type": "null" }
+              ],
+              "description": "Custom section order for story templates. null = use template default."
+            },
+            "optional_sections": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Section IDs that can be skipped in story templates"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
     }
   },
   "additionalProperties": true

package/.aios-core/core/config/template-overrides.js

@@ -0,0 +1,84 @@
+'use strict';
+
+/**
+ * Template Overrides — Consumer Helper
+ *
+ * Reads template_overrides from an already-resolved config (output of resolveConfig()).
+ * Does NOT call resolveConfig() itself — the caller passes in the merged config.
+ *
+ * @module template-overrides
+ * @see ADR-PRO-002 — Configuration Hierarchy
+ */
+
+/** Known story template section IDs (from story-tmpl.yaml) */
+const KNOWN_STORY_SECTIONS = [
+  'community-origin',
+  'status',
+  'executor-assignment',
+  'story',
+  'acceptance-criteria',
+  'coderabbit-integration',
+  'tasks-subtasks',
+  'dev-notes',
+  'change-log',
+  'dev-agent-record',
+  'qa-results',
+];
+
+/**
+ * Extract and normalize template overrides from resolved config.
+ *
+ * @param {object} resolvedConfig - Merged config from resolveConfig()
+ * @returns {{ story: { sections_order: string[]|null, optional_sections: string[] } }}
+ */
+function getTemplateOverrides(resolvedConfig) {
+  const overrides = resolvedConfig?.template_overrides ?? {};
+  const story = overrides.story ?? {};
+
+  const sectionsOrder = Array.isArray(story.sections_order)
+    ? story.sections_order
+    : null;
+
+  const optionalSections = Array.isArray(story.optional_sections)
+    ? story.optional_sections
+    : [];
+
+  // Validate section IDs
+  const allSections = [
+    ...(sectionsOrder ?? []),
+    ...optionalSections,
+  ];
+
+  const unknown = allSections.filter((id) => !KNOWN_STORY_SECTIONS.includes(id));
+  if (unknown.length > 0) {
+    throw new Error(
+      `Unknown story section ID(s) in template_overrides: ${unknown.join(', ')}. ` +
+      `Valid IDs: ${KNOWN_STORY_SECTIONS.join(', ')}`
+    );
+  }
+
+  return {
+    story: {
+      sections_order: sectionsOrder,
+      optional_sections: optionalSections,
+    },
+  };
+}
+
+/**
+ * Check whether a section is optional in the current config.
+ *
+ * @param {object} resolvedConfig - Merged config from resolveConfig()
+ * @param {string} sectionId - Story template section ID
+ * @returns {boolean}
+ */
+function isSectionOptional(resolvedConfig, sectionId) {
+  const { story } = getTemplateOverrides(resolvedConfig);
+  return story.optional_sections.includes(sectionId);
+}
+
+module.exports = {
+  KNOWN_STORY_SECTIONS,
+  getTemplateOverrides,
+  isSectionOptional,
+};

package/.aios-core/core/docs/troubleshooting-guide.md

@@ -103,7 +103,7 @@ This guide helps diagnose and resolve common issues when using the Synkra AIOS m
 3. Check working directory:
    ```bash
    pwd
-   # Should be in @synkra/aios-core root
+   # Should be in aios-core root
    ```
 
 ## Template Processing Problems

package/.aios-core/core/doctor/checks/agent-memory.js

@@ -0,0 +1,63 @@
+/**
+ * Doctor Check: Agent Memory
+ *
+ * Validates MEMORY.md files exist for all 10 agents in development/agents/.
+ *
+ * @module aios-core/doctor/checks/agent-memory
+ * @story INS-4.1
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const name = 'agent-memory';
+
+const EXPECTED_AGENTS = [
+  'dev',
+  'qa',
+  'architect',
+  'pm',
+  'po',
+  'sm',
+  'analyst',
+  'data-engineer',
+  'ux',
+  'devops',
+];
+
+async function run(context) {
+  const agentsDir = path.join(context.projectRoot, '.aios-core', 'development', 'agents');
+
+  if (!fs.existsSync(agentsDir)) {
+    return {
+      check: name,
+      status: 'FAIL',
+      message: 'Agents directory not found',
+      fixCommand: 'aios doctor --fix',
+    };
+  }
+
+  const missing = EXPECTED_AGENTS.filter(
+    (agent) => !fs.existsSync(path.join(agentsDir, agent, 'MEMORY.md')),
+  );
+
+  if (missing.length === 0) {
+    return {
+      check: name,
+      status: 'PASS',
+      message: `${EXPECTED_AGENTS.length}/${EXPECTED_AGENTS.length} MEMORY.md files present`,
+      fixCommand: null,
+    };
+  }
+
+  const present = EXPECTED_AGENTS.length - missing.length;
+
+  return {
+    check: name,
+    status: 'WARN',
+    message: `${present}/${EXPECTED_AGENTS.length} MEMORY.md files present (missing: ${missing.join(', ')})`,
+    fixCommand: 'aios doctor --fix',
+  };
+}
+
+module.exports = { name, run, EXPECTED_AGENTS };

package/.aios-core/core/doctor/checks/claude-md.js

@@ -0,0 +1,56 @@
+/**
+ * Doctor Check: CLAUDE.md
+ *
+ * Validates .claude/CLAUDE.md exists and has required section headings.
+ *
+ * @module aios-core/doctor/checks/claude-md
+ * @story INS-4.1
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const name = 'claude-md';
+
+const REQUIRED_SECTIONS = [
+  'Constitution',
+  'Framework vs Project Boundary',
+  'Sistema de Agentes',
+];
+
+async function run(context) {
+  const claudeMdPath = path.join(context.projectRoot, '.claude', 'CLAUDE.md');
+
+  if (!fs.existsSync(claudeMdPath)) {
+    return {
+      check: name,
+      status: 'FAIL',
+      message: 'CLAUDE.md not found',
+      fixCommand: 'aios doctor --fix',
+    };
+  }
+
+  const content = fs.readFileSync(claudeMdPath, 'utf8');
+
+  const missingSections = REQUIRED_SECTIONS.filter(
+    (section) => !content.includes(section),
+  );
+
+  if (missingSections.length === 0) {
+    return {
+      check: name,
+      status: 'PASS',
+      message: 'All required sections present',
+      fixCommand: null,
+    };
+  }
+
+  return {
+    check: name,
+    status: 'WARN',
+    message: `Missing sections: ${missingSections.join(', ')}`,
+    fixCommand: 'aios doctor --fix',
+  };
+}
+
+module.exports = { name, run };

package/.aios-core/core/doctor/checks/code-intel.js

@@ -0,0 +1,57 @@
+/**
+ * Doctor Check: Code Intelligence
+ *
+ * Reads code-intel provider status. Returns INFO (not FAIL) if not configured.
+ *
+ * @module aios-core/doctor/checks/code-intel
+ * @story INS-4.1
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const name = 'code-intel';
+
+async function run(context) {
+  const codeIntelDir = path.join(context.projectRoot, '.aios-core', 'core', 'code-intel');
+
+  if (!fs.existsSync(codeIntelDir)) {
+    return {
+      check: name,
+      status: 'INFO',
+      message: 'Code-intel module not found (optional)',
+      fixCommand: null,
+    };
+  }
+
+  const configPath = path.join(context.projectRoot, '.aios-core', 'core-config.yaml');
+  if (!fs.existsSync(configPath)) {
+    return {
+      check: name,
+      status: 'INFO',
+      message: 'Provider not configured (graceful fallback active)',
+      fixCommand: null,
+    };
+  }
+
+  const content = fs.readFileSync(configPath, 'utf8');
+  const hasCodeIntel = content.includes('codeIntel:') || content.includes('code_intel:');
+
+  if (hasCodeIntel) {
+    return {
+      check: name,
+      status: 'PASS',
+      message: 'Code-intel provider configured',
+      fixCommand: null,
+    };
+  }
+
+  return {
+    check: name,
+    status: 'INFO',
+    message: 'Provider not configured (graceful fallback active)',
+    fixCommand: null,
+  };
+}
+
+module.exports = { name, run };