aios-core 4.2.15 → 4.4.0

package/.aios-core/development/agents/ux-design-expert.md

@@ -23,15 +23,22 @@ activation-instructions:
   - STEP 2: Adopt the hybrid persona (Sally + Brad Frost)
 
   - STEP 3: |
-      Activate using .aios-core/development/scripts/unified-activation-pipeline.js
-      The UnifiedActivationPipeline.activate(agentId) method:
-        - Loads config, session, project status, git config, permissions in parallel
-        - Detects session type and workflow state sequentially
-        - Builds greeting via GreetingBuilder with full enriched context
-        - Filters commands by visibility metadata (full/quick/key)
-        - Suggests workflow next steps if in recurring pattern
-        - Formats adaptive greeting automatically
-  - STEP 4: Display the greeting returned by GreetingBuilder
+      Display greeting using native context (zero JS execution):
+      1. Show: "{icon} {persona_profile.communication.greeting_levels.archetypal}" + permission badge from current permission mode (e.g., [⚠️ Ask], [🟢 Auto], [🔍 Explore])
+      2. Show: "**Role:** {persona.role}"
+         - Append: "Story: {active story from docs/stories/}" if detected + "Branch: `{branch from gitStatus}`" if not main/master
+      3. Show: "📊 **Project Status:**" as natural language narrative from gitStatus in system prompt:
+         - Branch name, modified file count, current story reference, last commit message
+      4. Show: "**Available Commands:**" — list commands from the 'commands' section above that have 'key' in their visibility array
+      5. Show: "Type `*guide` for comprehensive usage instructions."
+      5.5. Check `.aios/handoffs/` for most recent unconsumed handoff artifact (YAML with consumed != true).
+           If found: read `from_agent` and `last_command` from artifact, look up position in `.aios-core/data/workflow-chains.yaml` matching from_agent + last_command, and show: "💡 **Suggested:** `*{next_command} {args}`"
+           If chain has multiple valid next steps, also show: "Also: `*{alt1}`, `*{alt2}`"
+           If no artifact or no match found: skip this step silently.
+           After STEP 4 displays successfully, mark artifact as consumed: true.
+      6. Show: "{persona_profile.communication.signature_closing}"
+      # FALLBACK: If native greeting fails, run: node .aios-core/development/scripts/unified-activation-pipeline.js ux-design-expert
+  - STEP 4: Greeting already rendered inline in STEP 3 — proceed to STEP 5
   - STEP 5: HALT and await user input
   - IMPORTANT: Do NOT improvise or add explanatory text beyond what is specified in greeting_levels and Quick Commands section
   - DO NOT: Load any other agent files during activation

package/.aios-core/development/checklists/issue-triage-checklist.md

@@ -0,0 +1,35 @@
+# Issue Triage Checklist
+
+## Per-Issue Checklist
+
+For each issue being triaged, verify:
+
+### Classification
+- [ ] Issue has been read and understood
+- [ ] ONE `type:` label applied (bug/feature/enhancement/docs/test/chore)
+- [ ] ONE `priority:` label applied (P1/P2/P3/P4)
+- [ ] At least ONE `area:` label applied
+- [ ] `status: needs-triage` removed
+
+### Status Resolution
+- [ ] Status set to `status: confirmed` OR `status: needs-info`
+- [ ] If `status: needs-info` — comment posted asking for specific details
+- [ ] If duplicate — labeled `duplicate`, closed with reference to original issue
+
+### Community
+- [ ] Assessed for `community: good first issue` (clear scope, isolated, well-documented)
+- [ ] Assessed for `community: help wanted` (valid but team lacks bandwidth)
+
+### Quality
+- [ ] Issue has sufficient information to act on (or `status: needs-info` applied)
+- [ ] Related issues cross-referenced if applicable
+- [ ] No sensitive information in issue (API keys, credentials)
+
+## Session Checklist
+
+After completing a triage session:
+
+- [ ] All `status: needs-triage` issues reviewed
+- [ ] Triage report generated
+- [ ] Story GHIM-001 updated with triage count
+- [ ] High-priority issues (P1/P2) flagged for immediate attention

package/.aios-core/development/checklists/memory-audit-checklist.md

@@ -0,0 +1,53 @@
+# Memory Audit Checklist
+
+Periodic checklist for maintaining agent MEMORY.md hygiene across all 10 agents.
+
+**Frequency:** Once per sprint or after completing an epic.
+**Executor:** Any agent (`@po *execute-checklist memory-audit-checklist`)
+
+---
+
+## Steps
+
+### Step 1: Read All MEMORY.md Files
+- [ ] Read all 10 agent MEMORY.md files under `.aios-core/development/agents/*/MEMORY.md`
+- [ ] Confirm each file has the 3-section structure: `## Active Patterns`, `## Promotion Candidates`, `## Archived`
+
+### Step 2: Identify Cross-Agent Patterns
+- [ ] Cross-reference Active Patterns across all 10 files
+- [ ] Flag patterns that appear in **3+ agent MEMORY.md files** as promotion candidates
+- [ ] Document each candidate with: pattern text, which agents contain it, count
+
+### Step 3: Record Promotion Candidates
+- [ ] For each cross-agent pattern found in Step 2, add to `## Promotion Candidates` in the originating agent's MEMORY.md
+- [ ] Use format: `- **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD}`
+- [ ] If pattern already exists in Promotion Candidates, skip (no duplicates)
+
+### Step 4: Identify Stale Entries
+- [ ] Review Active Patterns for entries contradicted by current codebase
+- [ ] Review Active Patterns for entries superseded by newer patterns or code changes
+- [ ] Review Active Patterns for entries no longer relevant to current project state
+
+### Step 5: Archive Stale Entries
+- [ ] Move stale entries from `## Active Patterns` to `## Archived`
+- [ ] Use format: `- ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason}`
+- [ ] Valid reasons: "superseded by {X}", "contradicted by {Y}", "no longer relevant"
+
+### Step 6: Report Summary
+- [ ] Total active patterns across all agents
+- [ ] New promotion candidates identified this audit
+- [ ] Entries newly archived this audit
+- [ ] Recommended actions (e.g., "elevate pattern X to .claude/rules/")
+
+---
+
+## Expected Cross-Agent Patterns
+
+Common patterns that typically appear in multiple agents:
+
+| Pattern | Expected Agents | Action |
+|---------|----------------|--------|
+| "NEVER push — delegate to @devops" | dev, qa, analyst, sm, data-engineer, ux | Promote to `.claude/rules/` |
+| CommonJS module system | dev, analyst, sm, data-engineer, ux, architect | Already in CLAUDE.md |
+| Conventional commits format | dev, qa, devops, analyst, sm, data-engineer, ux | Already in CLAUDE.md |
+| kebab-case for files | dev, analyst, sm, data-engineer, ux | Already in CLAUDE.md |

package/.aios-core/development/scripts/issue-triage.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+
+/**
+ * Issue Triage Script
+ * Batch triage tool for @devops to manage GitHub issues.
+ *
+ * Usage:
+ *   node issue-triage.js --list                     # List untriaged issues
+ *   node issue-triage.js --apply 174 --type bug --priority P2 --area installer
+ *   node issue-triage.js --report                   # Generate triage summary
+ *
+ * Story: GHIM-001
+ */
+
+const { execSync } = require('child_process');
+
+const VALID_TYPES = ['bug', 'feature', 'enhancement', 'docs', 'test', 'chore'];
+const VALID_PRIORITIES = ['P1', 'P2', 'P3', 'P4'];
+const VALID_AREAS = ['core', 'installer', 'synapse', 'cli', 'pro', 'health-check', 'docs', 'devops', 'agents', 'workflows'];
+
+function gh(cmd) {
+  try {
+    return execSync(`gh ${cmd}`, { encoding: 'utf8', timeout: 60000 });
+  } catch (err) {
+    console.error(`gh command failed: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+function listUntriaged() {
+  const raw = gh('issue list --label "status: needs-triage" --json number,title,labels,createdAt,author --limit 100');
+  const issues = JSON.parse(raw);
+
+  if (issues.length === 0) {
+    console.log('No untriaged issues found.');
+    return;
+  }
+
+  console.log(`\n=== ${issues.length} Untriaged Issues ===\n`);
+  for (const issue of issues) {
+    const labels = issue.labels.map(l => l.name).join(', ');
+    const date = issue.createdAt.split('T')[0];
+    console.log(`  #${issue.number} [${date}] ${issue.title}`);
+    console.log(`    Author: ${issue.author.login} | Labels: ${labels}`);
+    console.log();
+  }
+}
+
+function applyLabels(number, type, priority, areas, extra) {
+  if (!VALID_TYPES.includes(type)) {
+    console.error(`Invalid type: ${type}. Valid: ${VALID_TYPES.join(', ')}`);
+    process.exit(1);
+  }
+  if (!VALID_PRIORITIES.includes(priority)) {
+    console.error(`Invalid priority: ${priority}. Valid: ${VALID_PRIORITIES.join(', ')}`);
+    process.exit(1);
+  }
+
+  const addLabels = [`type: ${type}`, `priority: ${priority}`, 'status: confirmed'];
+  for (const area of areas) {
+    if (!VALID_AREAS.includes(area)) {
+      console.error(`Invalid area: ${area}. Valid: ${VALID_AREAS.join(', ')}`);
+      process.exit(1);
+    }
+    addLabels.push(`area: ${area}`);
+  }
+  if (extra) {
+    addLabels.push(...extra);
+  }
+
+  const addStr = addLabels.map(l => `"${l}"`).join(',');
+  console.log(`Applying to #${number}: ${addLabels.join(', ')}`);
+  gh(`issue edit ${number} --add-label ${addStr} --remove-label "status: needs-triage"`);
+  console.log(`  Done.`);
+}
+
+function generateReport() {
+  const raw = gh('issue list --state open --json number,title,labels --limit 200');
+  const issues = JSON.parse(raw);
+
+  const stats = {
+    total: issues.length,
+    untriaged: 0,
+    byType: {},
+    byPriority: {},
+    byArea: {},
+    byStatus: {}
+  };
+
+  for (const issue of issues) {
+    const labels = issue.labels.map(l => l.name);
+
+    if (labels.includes('status: needs-triage')) stats.untriaged++;
+
+    for (const label of labels) {
+      if (label.startsWith('type: ')) {
+        const val = label.replace('type: ', '');
+        stats.byType[val] = (stats.byType[val] || 0) + 1;
+      }
+      if (label.startsWith('priority: ')) {
+        const val = label.replace('priority: ', '');
+        stats.byPriority[val] = (stats.byPriority[val] || 0) + 1;
+      }
+      if (label.startsWith('area: ')) {
+        const val = label.replace('area: ', '');
+        stats.byArea[val] = (stats.byArea[val] || 0) + 1;
+      }
+      if (label.startsWith('status: ')) {
+        const val = label.replace('status: ', '');
+        stats.byStatus[val] = (stats.byStatus[val] || 0) + 1;
+      }
+    }
+  }
+
+  console.log('\n=== Issue Triage Report ===\n');
+  console.log(`Total open issues: ${stats.total}`);
+  console.log(`Untriaged: ${stats.untriaged}`);
+  console.log(`\nBy Type:`);
+  for (const [k, v] of Object.entries(stats.byType).sort((a, b) => b[1] - a[1])) {
+    console.log(`  ${k}: ${v}`);
+  }
+  console.log(`\nBy Priority:`);
+  for (const [k, v] of Object.entries(stats.byPriority).sort()) {
+    console.log(`  ${k}: ${v}`);
+  }
+  console.log(`\nBy Area:`);
+  for (const [k, v] of Object.entries(stats.byArea).sort((a, b) => b[1] - a[1])) {
+    console.log(`  ${k}: ${v}`);
+  }
+  console.log(`\nBy Status:`);
+  for (const [k, v] of Object.entries(stats.byStatus).sort((a, b) => b[1] - a[1])) {
+    console.log(`  ${k}: ${v}`);
+  }
+}
+
+// CLI argument parsing
+const args = process.argv.slice(2);
+
+if (args.includes('--list')) {
+  listUntriaged();
+} else if (args.includes('--apply')) {
+  const idx = args.indexOf('--apply');
+  const number = parseInt(args[idx + 1]);
+  const typeIdx = args.indexOf('--type');
+  const prioIdx = args.indexOf('--priority');
+  const areaIdx = args.indexOf('--area');
+  const extraIdx = args.indexOf('--extra');
+
+  if (!number || typeIdx === -1 || prioIdx === -1 || areaIdx === -1) {
+    console.error('Usage: --apply <number> --type <type> --priority <P1-P4> --area <area> [--extra "label1,label2"]');
+    process.exit(1);
+  }
+
+  const type = args[typeIdx + 1];
+  const priority = args[prioIdx + 1];
+  const areas = args[areaIdx + 1].split(',');
+  const extra = extraIdx !== -1 ? args[extraIdx + 1].split(',') : [];
+
+  applyLabels(number, type, priority, areas, extra);
+} else if (args.includes('--report')) {
+  generateReport();
+} else {
+  console.log('Issue Triage Tool (GHIM-001)\n');
+  console.log('Usage:');
+  console.log('  --list                                    List untriaged issues');
+  console.log('  --apply <#> --type <t> --priority <P> --area <a>  Apply labels');
+  console.log('  --report                                  Generate triage summary');
+  console.log('\nTypes:', VALID_TYPES.join(', '));
+  console.log('Priorities:', VALID_PRIORITIES.join(', '));
+  console.log('Areas:', VALID_AREAS.join(', '));
+}