aios-core 4.2.3 → 4.2.4

package/.aios-core/product/templates/ide-rules/gemini-rules.md

@@ -1,233 +1,87 @@
-# Synkra AIOS Development Rules for Gemini CLI
-
-You are working with Synkra AIOS, an AI-Orchestrated System for Full Stack Development.
-
-## Core Framework Understanding
-
-Synkra AIOS is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
-
-## Agent System
-
-### Agent Activation
-- Agents are activated with @agent-name syntax: @dev, @qa, @architect, @pm, @po, @sm, @analyst
-- The master agent is activated with @aios-master
-- Agent commands use the * prefix: *help, *create-story, *task, *exit
-
-### Agent Context
-When an agent is active:
-- Follow that agent's specific persona and expertise
-- Use the agent's designated workflow patterns
-- Maintain the agent's perspective throughout the interaction
-
-### Available Agents
-
-| Agent | Persona | Primary Role |
-|-------|---------|--------------|
-| @dev | Dex | Code implementation |
-| @qa | Quinn | Testing and quality |
-| @architect | Aria | System architecture |
-| @pm | Morgan | Product management |
-| @po | Pax | Product ownership |
-| @sm | River | Scrum master |
-| @analyst | Alex | Research and analysis |
-| @data-engineer | Dara | Database design |
-| @ux-design-expert | Uma | UX/UI design |
-| @devops | Gage | CI/CD and deployment |
-
-## Development Methodology
-
-### Story-Driven Development
-1. **Work from stories** - All development starts with a story in `docs/stories/`
-2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
-3. **Track changes** - Maintain the File List section in the story
-4. **Follow criteria** - Implement exactly what the acceptance criteria specify
-
-### Code Standards
-- Write clean, self-documenting code
-- Follow existing patterns in the codebase
-- Include comprehensive error handling
-- Add unit tests for all new functionality
-- Use TypeScript/JavaScript best practices
-
-### Testing Requirements
-- Run all tests before marking tasks complete
-- Ensure linting passes: `npm run lint`
-- Verify type checking: `npm run typecheck`
-- Add tests for new features
-- Test edge cases and error scenarios
-
-## AIOS Framework Structure
-
-```
-aios-core/
-├── .aios-core/
-│   ├── core/           # Framework core modules
-│   ├── development/
-│   │   ├── agents/     # Agent definitions
-│   │   ├── tasks/      # Executable tasks
-│   │   ├── workflows/  # Workflow definitions
-│   │   └── templates/  # Document templates
-│   └── infrastructure/ # Integrations and adapters
-├── docs/
-│   ├── stories/        # Development stories
-│   ├── prd/            # Product requirements
-│   └── architecture/   # Architecture docs
-└── src/                # Source code
-```
-
-## Gemini CLI Specific Configuration
-
-### Skills Integration
-AIOS agents are installed as Gemini CLI skills in `.gemini/rules/AIOS/agents/`.
-Skills use the same format as Claude Code - they are fully compatible.
-
-To activate an agent skill:
-```
-@dev help me implement this feature
-@architect design the system architecture
-```
-
-### Hooks Configuration
-AIOS can integrate with Gemini CLI hooks for enhanced context injection.
-
-Configure in `.gemini/settings.json`:
-```json
-{
-  "hooks": {
-    "BeforeAgent": [{
-      "matcher": "*",
-      "hooks": [{
-        "name": "aios-context",
-        "type": "command",
-        "command": "node .aios-core/hooks/gemini/before-agent.js"
-      }]
-    }]
-  }
-}
-```
-
-### Gemini CLI Lifecycle Events
-Hooks can intercept these events:
-- `SessionStart` - Load AIOS context
-- `BeforeAgent` - Inject gotchas and patterns
-- `BeforeTool` - Security validation
-- `AfterTool` - Audit logging
-- `SessionEnd` - Persist state
-
-### Extensions
-AIOS can be packaged as a Gemini CLI extension for easy installation:
-```bash
-gemini extensions install github.com/synkra/aios-gemini-extension
-```
-
-## Workflow Execution
-
-### Task Execution Pattern
-1. Read the complete task/workflow definition
-2. Understand all elicitation points
-3. Execute steps sequentially
-4. Handle errors gracefully
-5. Provide clear feedback
-
-### Interactive Workflows
-- Workflows with `elicit: true` require user input
-- Present options clearly
-- Validate user responses
-- Provide helpful defaults
-
-## Best Practices
-
-### When implementing features:
-- Check existing patterns first
-- Reuse components and utilities
-- Follow naming conventions
-- Keep functions focused and testable
-- Document complex logic
-
-### When working with agents:
-- Respect agent boundaries
-- Use appropriate agent for each task
-- Follow agent communication patterns
-- Maintain agent context
-
-### When handling errors:
-```javascript
-try {
-  // Operation
-} catch (error) {
-  console.error(`Error in ${operation}:`, error);
-  throw new Error(`Failed to ${operation}: ${error.message}`);
-}
-```
-
-## Git & GitHub Integration
-
-### Commit Conventions
-- Use conventional commits: `feat:`, `fix:`, `docs:`, `chore:`, etc.
-- Reference story ID: `feat: implement feature [Story 2.1]`
-- Keep commits atomic and focused
-
-### Push Authority
-**Only @devops agent can push to remote.** Other agents should prepare changes and hand off to @devops.
-
-## Gemini CLI Commands
-
-### AIOS Agent Commands
-- `*help` - Show available commands
-- `*create-story` - Create new story
-- `*task {name}` - Execute specific task
-- `*workflow {name}` - Run workflow
-- `*exit` - Exit agent mode
-
-### Useful Gemini CLI Commands
-- `/settings` - Configure Gemini CLI
-- `/hooks panel` - View active hooks
-- `/extensions list` - List installed extensions
-- `/rewind` - Revert to previous state
-
-## Model Selection
-
-Gemini CLI supports multiple models:
-- **Gemini 3 Flash** - Fast, cost-effective for simple tasks
-- **Gemini 3 Pro** - High quality for complex reasoning
-
-Enable preview features in `/settings` to access latest models.
-
-## Development Commands
-
-```bash
-npm run dev       # Start development
-npm test          # Run tests
-npm run lint      # Check code style
-npm run typecheck # Verify types
-npm run build     # Build project
-```
-
-## Debugging
-
-### Enable Debug Mode
-```bash
-export AIOS_DEBUG=true
-```
-
-### View Agent Logs
-```bash
-tail -f .aios/logs/agent.log
-```
-
-## Performance Optimization
-
-- Use parallel tool execution when possible
-- Leverage Gemini's JSON output mode for structured responses
-- Cache frequently accessed data during sessions
-- Use `--output-format json` for programmatic integration
-
-## Error Recovery
-
-- Use `/rewind` to revert mistakes
-- Always provide recovery suggestions for failures
-- Include error context in messages
-- Document any manual fixes required
-
----
-*Synkra AIOS Gemini CLI Configuration v1.0*
+# Gemini Rules - Synkra AIOS
+
+Este arquivo define as instrucoes do projeto para Gemini CLI neste repositorio.
+
+<!-- AIOS-MANAGED-START: core -->
+## Core Rules
+
+1. Siga a Constitution em `.aios-core/constitution.md`
+2. Priorize `CLI First -> Observability Second -> UI Third`
+3. Trabalhe por stories em `docs/stories/`
+4. Nao invente requisitos fora dos artefatos existentes
+<!-- AIOS-MANAGED-END: core -->
+
+<!-- AIOS-MANAGED-START: quality -->
+## Quality Gates
+
+- Rode `npm run lint`
+- Rode `npm run typecheck`
+- Rode `npm test`
+- Atualize checklist e file list da story antes de concluir
+<!-- AIOS-MANAGED-END: quality -->
+
+<!-- AIOS-MANAGED-START: codebase -->
+## Project Map
+
+- Core framework: `.aios-core/`
+- CLI entrypoints: `bin/`
+- Shared packages: `packages/`
+- Tests: `tests/`
+- Docs: `docs/`
+<!-- AIOS-MANAGED-END: codebase -->
+
+<!-- AIOS-MANAGED-START: gemini-integration -->
+## Gemini Integration
+
+Fonte de verdade de agentes:
+- Canonico: `.aios-core/development/agents/*.md`
+- Espelhado para Gemini: `.gemini/rules/AIOS/agents/*.md`
+
+Hooks e settings:
+- Hooks locais: `.gemini/hooks/`
+- Settings locais: `.gemini/settings.json`
+
+Sempre que houver drift, execute:
+- `npm run sync:ide:gemini`
+- `npm run validate:gemini-sync`
+- `npm run validate:gemini-integration`
+<!-- AIOS-MANAGED-END: gemini-integration -->
+
+<!-- AIOS-MANAGED-START: parity -->
+## Multi-IDE Parity
+
+Para garantir paridade entre Claude Code, Codex e Gemini:
+- `npm run validate:parity`
+- `npm run validate:paths`
+<!-- AIOS-MANAGED-END: parity -->
+
+<!-- AIOS-MANAGED-START: activation -->
+## Agent Activation
+
+Preferencia de ativacao:
+1. Use agentes em `.gemini/rules/AIOS/agents/`
+2. Se necessario, use fonte canonica em `.aios-core/development/agents/`
+
+Ao ativar agente:
+- carregar definicao completa do agente
+- renderizar greeting via `node .aios-core/development/scripts/generate-greeting.js <agent-id>`
+- manter persona ativa ate `*exit`
+
+Atalhos recomendados no Gemini:
+- `/aios-menu` para listar agentes
+- `/aios-<agent-id>` (ex.: `/aios-dev`, `/aios-architect`)
+- `/aios-agent <agent-id>` para launcher generico
+<!-- AIOS-MANAGED-END: activation -->
+
+<!-- AIOS-MANAGED-START: commands -->
+## Common Commands
+
+- `npm run sync:ide`
+- `npm run sync:ide:check`
+- `npm run sync:ide:gemini`
+- `npm run validate:gemini-sync`
+- `npm run validate:gemini-integration`
+- `npm run validate:parity`
+- `npm run validate:structure`
+- `npm run validate:agents`
+<!-- AIOS-MANAGED-END: commands -->

package/.aios-core/product/templates/statusline/statusline-script.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+
+/**
+ * AIOS Unified Statusline v3 for Claude Code
+ *
+ * Displays: Session | Model | Context Bar | Time | Agent | Squad | Project:Branch | Git | Messages | Alert
+ *
+ * Installed automatically by `npx aios-core install` when no existing statusline is detected.
+ * Source: .aios-core/product/templates/statusline/
+ */
+
+const fs = require('fs');
+const { execSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+let input = '';
+process.stdin.on('data', (chunk) => { input += chunk; });
+
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    console.log(buildStatusLine(data));
+  } catch (error) {
+    console.log(`err: ${error.message}`);
+  }
+});
+
+function buildStatusLine(data) {
+  const reset = '\x1b[0m';
+  const bold = '\x1b[1m';
+  const dim = '\x1b[2m';
+  const red = '\x1b[31m';
+  const green = '\x1b[32m';
+  const yellow = '\x1b[33m';
+  const blue = '\x1b[34m';
+  const magenta = '\x1b[35m';
+  const cyan = '\x1b[36m';
+  const white = '\x1b[37m';
+  const orange = '\x1b[38;5;208m';
+  const boldBlue = `${bold}${blue}`;
+  const boldRed = `${bold}${red}`;
+
+  const parts = [];
+
+  // 1. Session ID (first 8 chars)
+  const sessionId = data.session_id || '';
+  if (sessionId) parts.push(`${dim}${sessionId.substring(0, 8)}${reset}`);
+
+  // 2. Model
+  const modelId = data.model?.id || '';
+  const modelName = formatModel(modelId);
+  if (modelName) parts.push(`${boldBlue}${modelName}${reset}`);
+
+  // 3. Context — progress bar + % + total (in/out)
+  const usedPct = data.context_window?.used_percentage ?? null;
+  const totalIn = data.context_window?.total_input_tokens ?? 0;
+  const totalOut = data.context_window?.total_output_tokens ?? 0;
+  if (usedPct !== null) {
+    const bar = progressBar(usedPct, 10);
+    const pctColor = usedPct > 80 ? red : usedPct > 60 ? yellow : green;
+    const totalTokens = totalIn + totalOut;
+    const inStr = fmtTokens(totalIn);
+    const outStr = fmtTokens(totalOut);
+    parts.push(`${bar} ${pctColor}${Math.round(usedPct)}%${reset} ${white}${fmtTokens(totalTokens)}${reset} ${dim}(\u2b07${inStr}/\u2b06${outStr})${reset}`);
+  }
+
+  // 4. Time
+  const totalDuration = data.cost?.total_duration_ms ?? 0;
+  if (totalDuration > 0) {
+    const min = Math.floor(totalDuration / 60000);
+    const sec = Math.floor((totalDuration % 60000) / 1000);
+    parts.push(`${cyan}\u23f1 ${min}m${String(sec).padStart(2, '0')}s${reset}`);
+  }
+
+  // 5 & 6. Agent & Squad (from session cache + API fallback)
+  const cache = readSessionCache();
+  const activeAgent = cache.agent || data.agent?.name || '';
+  const activeSquad = cache.squad || '';
+  if (activeAgent) parts.push(`${cyan}\ud83e\udd16 ${activeAgent}${reset}`);
+  if (activeSquad) parts.push(`${orange}\ud83c\udfaf ${activeSquad}${reset}`);
+
+  // 7. Project:Branch
+  const gitInfo = getGitInfo();
+  if (gitInfo.project) {
+    parts.push(`${yellow}${gitInfo.project}${reset}:${magenta}${gitInfo.branch}${reset}`);
+  }
+
+  // 8. Git changes
+  const linesAdded = data.cost?.total_lines_added ?? 0;
+  const linesRemoved = data.cost?.total_lines_removed ?? 0;
+  const filesChanged = gitInfo.filesChanged;
+  if (linesAdded > 0 || linesRemoved > 0 || filesChanged > 0) {
+    const fc = filesChanged > 0 ? `${filesChanged}f ` : '';
+    parts.push(`\ud83d\udcdd ${white}${fc}${reset}${green}+${linesAdded}${reset} ${red}-${linesRemoved}${reset}`);
+  }
+
+  // 9. Message count (from transcript JSONL)
+  const msgCount = countMessages(data.transcript_path);
+  if (msgCount > 0) {
+    parts.push(`${white}\ud83d\udd22 ${msgCount}${reset}`);
+  }
+
+  // 10. Alert >200k
+  if (data.exceeds_200k_tokens) {
+    parts.push(`${boldRed}\u26a0 >200k!${reset}`);
+  }
+
+  return parts.join(' | ');
+}
+
+// --- Helpers ---
+
+function formatModel(id) {
+  if (!id) return '';
+  if (id.includes('opus')) return 'Opus 4.6';
+  if (id.includes('sonnet')) return 'Sonnet 4.5';
+  if (id.includes('haiku')) return 'Haiku 4.5';
+  return id.split('-').slice(0, 2).join(' ');
+}
+
+function progressBar(pct, width) {
+  const filled = Math.round((pct / 100) * width);
+  const empty = width - filled;
+  const filledColor = pct > 80 ? '\x1b[31m' : pct > 60 ? '\x1b[33m' : '\x1b[32m';
+  return `${filledColor}${'\u2588'.repeat(filled)}${'\u2591'.repeat(empty)}\x1b[0m`;
+}
+
+function fmtTokens(n) {
+  if (n >= 1000000) return `${(n / 1000000).toFixed(1)}M`;
+  if (n >= 1000) return `${Math.round(n / 1000)}k`;
+  return String(n);
+}
+
+function readSessionCache() {
+  try {
+    const cacheDir = path.join(os.homedir(), '.claude', 'session-cache');
+    const cwd = process.cwd();
+    const hash = simpleHash(cwd);
+    const cachePath = path.join(cacheDir, `${hash}.json`);
+    if (fs.existsSync(cachePath)) {
+      const cache = JSON.parse(fs.readFileSync(cachePath, 'utf8'));
+      return { agent: cache.agent || '', squad: cache.squad || '' };
+    }
+  } catch {}
+  return { agent: '', squad: '' };
+}
+
+function simpleHash(str) {
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = ((hash << 5) - hash) + char;
+    hash |= 0;
+  }
+  return Math.abs(hash).toString(16);
+}
+
+function getGitInfo() {
+  const result = { project: '', branch: '', filesChanged: 0 };
+  try {
+    const toplevel = execSync('git rev-parse --show-toplevel 2>/dev/null', { encoding: 'utf8', timeout: 3000 }).trim();
+    result.project = path.basename(toplevel);
+    result.branch = execSync('git rev-parse --abbrev-ref HEAD 2>/dev/null', { encoding: 'utf8', timeout: 3000 }).trim();
+    const status = execSync('git status --porcelain 2>/dev/null', { encoding: 'utf8', timeout: 3000 }).trim();
+    if (status) {
+      result.filesChanged = status.split('\n').filter(l => l.trim()).length;
+    }
+  } catch {}
+  return result;
+}
+
+function countMessages(transcriptPath) {
+  if (!transcriptPath) return 0;
+  try {
+    const content = fs.readFileSync(transcriptPath, 'utf8');
+    let count = 0;
+    for (const line of content.split('\n')) {
+      if (!line.trim()) continue;
+      try {
+        const entry = JSON.parse(line);
+        if (entry.type === 'user' || entry.type === 'human') count++;
+      } catch {}
+    }
+    return count;
+  } catch {}
+  return 0;
+}

package/.aios-core/product/templates/statusline/track-agent.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# AIOS Agent/Squad Tracker for Claude Code Statusline
+# Called via Claude Code UserPromptSubmit hook
+#
+# Detects @agent, /squad:command, /ns:agents:name activations
+# Writes to ~/.claude/session-cache/ for statusline-script.js to read
+#
+# Installed automatically by `npx aios-core install`
+# Source: .aios-core/product/templates/statusline/
+
+INPUT=$(cat)
+
+node -e "
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let prompt = '';
+try {
+  const j = JSON.parse(process.argv[1]);
+  prompt = j.prompt || j.message || '';
+} catch {}
+if (!prompt) process.exit(0);
+
+function simpleHash(str) {
+  let h = 0;
+  for (let i = 0; i < str.length; i++) {
+    h = ((h << 5) - h) + str.charCodeAt(i);
+    h |= 0;
+  }
+  return Math.abs(h).toString(16);
+}
+
+const cacheDir = path.join(os.homedir(), '.claude', 'session-cache');
+try { fs.mkdirSync(cacheDir, { recursive: true }); } catch {}
+
+const hash = simpleHash(process.cwd());
+const cacheFile = path.join(cacheDir, hash + '.json');
+
+let agent = '', squad = '';
+try {
+  const c = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+  agent = c.agent || '';
+  squad = c.squad || '';
+} catch {}
+
+let changed = false;
+
+if (/^\*exit\b/.test(prompt)) {
+  agent = ''; squad = '';
+  changed = true;
+}
+
+const agentMatch = prompt.match(/@([a-zA-Z_-]+)/);
+if (agentMatch) { agent = agentMatch[1]; changed = true; }
+
+const nsMatch = prompt.match(/\/[a-zA-Z_-]+:agents:([a-zA-Z_-]+)/);
+if (nsMatch) { agent = nsMatch[1]; changed = true; }
+
+const squadMatch = prompt.match(/\/([a-zA-Z_-]+):[a-zA-Z_-]+/);
+if (squadMatch && !/:agents:/.test(squadMatch[0])) { squad = squadMatch[1]; changed = true; }
+
+if (changed) {
+  fs.writeFileSync(cacheFile, JSON.stringify({ agent, squad, updated: new Date().toISOString() }));
+}
+" "$INPUT"
+
+exit 0