aios-core 4.2.14 → 4.3.0

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(', '));
+}