ac-framework 1.3.0 → 1.4.0

package/framework/{AGENTS.md → .opencode/command/agents.md}

@@ -1,44 +1,3 @@
-# 🤖 AGENTS.md - AI Work Framework
-
-```
-╔══════════════════════════════════════════════════════════════════════════════════════════╗
-║                                                                                          ║
-║    █████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗                                  ║
-║   ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝                                  ║
-║   ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   ███████╗                                  ║
-║   ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║                                  ║
-║   ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ███████║                                  ║
-║   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝                                  ║
-║                                                                                          ║
-║                    Intelligent Software Development Framework                            ║
-║                                                                                          ║
-╚══════════════════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## 📋 Index
-
-1. [Framework Philosophy](#-framework-philosophy)
-2. [Available Skills](#-available-skills)
-3. [Workflow: New Project](#-workflow-new-project)
-4. [Workflow: Existing Project](#-workflow-existing-project)
-5. [Workflow: Changes/Iterations](#-workflow-changesiterations)
-6. [Validation Checklist](#-validation-checklist)
-7. [Directory Structure](#-directory-structure)
-
----
-
-## 🎯 Framework Philosophy
-
-This framework is designed to ensure all AI-developed projects follow:
-
-- ✅ **Best coding practices** from the start
-- ✅ **Maintainable** and scalable architecture
-- ✅ **Complete and up-to-date** documentation
-- ✅ **Clear specifications** through OpenSpec
-- ✅ **Systematic debugging** of problems
-- ✅ **Automated change history**
 
 > **Fundamental Principle**: *"Quality over speed. Documentation before code. Planning before execution."*
 
@@ -338,127 +297,4 @@ Before considering any task as **completed**, verify:
 ║    └─ □ Change archived with openspec-archive-change                              ║
 ║    └─ □ Delta specs synchronized (if applicable)                                  ║
 ║                                                                                    ║
-╚═══════════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## 📁 Directory Structure
-
-```
-project/
-│
-├── 📂 .agents/                    # AI-generated documentation
-│   ├── security-guidelines.md     # Security practices
-│   ├── maintainability-rules.md   # Maintainability rules
-│   ├── architecture-decisions.md  # Architecture decisions
-│   ├── project-index.md           # Complete project index
-│   ├── exploration-report.md      # Exploration reports
-│   ├── brainstorming-session.md   # Brainstorming sessions
-│   ├── debug-report.md            # Debugging reports
-│   └── agent-<domain>.md          # Per-domain guides (e.g., agent-ui.md)
-│
-├── 📂 .claude/                    # Project-specific skills
-│   └── skills/
-│       └── project-index-<domain>/
-│           └── SKILL.md           # Domain-specific skills
-│
-├── 📂 .openspec/                  # Formal specifications (OpenSpec)
-│   ├── specs/                     # Main specifications
-│   │   └── <capability>/
-│   │       └── spec.md
-│   └── changes/                   # Active changes
-│       ├── <change-name>/
-│       │   ├── proposal.md        # Why and what changes
-│       │   ├── design.md          # How to build it
-│       │   ├── tasks.md           # Implementation checklist
-│       │   └── specs/             # Delta specs
-│       │       └── <capability>/
-│       │           └── spec.md
-│       └── archive/               # Completed changes
-│           └── YYYY-MM-DD-<name>/
-│
-├── 📂 changelogs/                 # Change history
-│   └── by-ai/                     # AI-generated changelogs
-│       └── YYYY-MM-DD-feature.md
-│
-└── [project source code]
-```
-
----
-
-## 🎓 Quick Usage
-
-### To start a new project:
-```
-1. Execute: secure-coding-cybersecurity
-2. Execute: code-maintainability
-3. Execute: brainstorming
-4. Execute: openspec-new-change (or openspec-ff-change for quick mode)
-5. Execute: openspec-continue-change (create specs, design, tasks)
-6. Execute: openspec-apply-change
-7. Execute: systematic-debugging
-8. Execute: openspec-verify-change
-9. Execute: changelog-generator
-10. Execute: openspec-archive-change
-```
-
-### To modify an existing project:
-```
-1. Check if documentation exists (.agents/, openspec/)
-   └─ If NOT exists → Execute: project-index
-   
-2. Execute: openspec-explore
-3. Execute: brainstorming
-4. Execute: openspec-new-change (create change)
-5. Execute: openspec-continue-change (complete artifacts)
-6. Execute: openspec-apply-change (implement)
-7. Execute: systematic-debugging (validate)
-8. Execute: openspec-verify-change (verify against specs)
-9. Execute: changelog-generator
-10. Execute: openspec-archive-change
-```
-
-### Quick OpenSpec commands:
-```
-/opsx:explore        - Explore before implementing
-/opsx:new <name>     - Create new change step by step
-/opsx:ff <name>      - Fast-forward (create all quickly)
-/opsx:continue       - Continue existing change
-/opsx:apply          - Implement tasks
-/opsx:verify         - Verify implementation
-/opsx:archive        - Archive completed change
-/opsx:onboard        - OpenSpec tutorial
-```
-
----
-
-## 📌 Important Notes
-
-> **⚠️ NEVER skip workflow steps.** Each skill exists to ensure quality.
-
-> **📝 Documentation = Code.** If not documented in OpenSpec, it's not done.
-
-> **🔒 Security first.** Always execute secure-coding-cybersecurity before any implementation.
-
-> **🧠 Brainstorming is mandatory.** Never implement without questioning the approach first.
-
-> **✅ Validation before commit.** Always execute systematic-debugging and openspec-verify before finishing.
-
-> **📦 One change = One feature.** Don't mix multiple features in a single change.
-
-> **🔄 Sync specs.** After archiving, synchronize delta specs to main specs.
-
----
-
-```
-╔═══════════════════════════════════════════════════════════════════════════════════╗
-║                                                                                    ║
-║           "Well-specified code is well-implemented code"                           ║
-║                                                                                    ║
-║                         Framework AGENTS.md v2.0                                   ║
-║                                                                                    ║
-║              22 Skills Available | OpenSpec Workflow Integrated                    ║
-║                                                                                    ║
-╚═══════════════════════════════════════════════════════════════════════════════════╝
-```
+╚═══════════════════════════════════════════════════════════════════════════════════╝

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ac-framework",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Agentic Coding Framework - Multi-assistant configuration system with OpenSpec workflows",
   "main": "src/index.js",
   "exports": {

package/src/ui/banner.js

@@ -2,68 +2,171 @@ import gradient from 'gradient-string';
 import chalk from 'chalk';
 import { sleep } from '../utils/helpers.js';
 
-const acGradient = gradient(['#6C5CE7', '#A29BFE', '#00CEC9', '#0984E3', '#6C5CE7']);
-const dimGradient = gradient(['#2D3436', '#636E72', '#2D3436']);
-const glowGradient = gradient(['#0984E3', '#00CEC9', '#55EFC4', '#00CEC9', '#0984E3']);
-
-const LOGO = [
-  '     ██████╗  ██████╗         ███████╗██████╗  █████╗ ███╗   ███╗███████╗',
-  '    ██╔══██╗██╔════╝         ██╔════╝██╔══██╗██╔══██╗████╗ ████║██╔════╝',
-  '    ███████║██║              █████╗  ██████╔╝███████║██╔████╔██║█████╗  ',
-  '    ██╔══██║██║              ██╔══╝  ██╔══██╗██╔══██║██║╚██╔╝██║██╔══╝  ',
-  '    ██║  ██║╚██████╗         ██║     ██║  ██║██║  ██║██║ ╚═╝ ██║███████╗',
-  '    ╚═╝  ╚═╝ ╚═════╝         ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝',
+// ── Emerald Color Palette ─────────────────────────────────────────
+const emeraldGradient = gradient(['#1B5E20', '#2ECC71', '#50C878', '#00FF7F', '#50C878', '#2ECC71', '#1B5E20']);
+const dimEmerald = gradient(['#0D2B0D', '#1B3A1B', '#2D4A2D', '#1B3A1B', '#0D2B0D']);
+const brightEmerald = gradient(['#00FF7F', '#55FFB2', '#AAFFDD', '#55FFB2', '#00FF7F']);
+const glowGradient = gradient(['#1B5E20', '#2ECC71', '#50C878', '#2ECC71', '#1B5E20']);
+
+// ── Emerald Gem ASCII Art ─────────────────────────────────────────
+// Faceted gem with "AC" in crown and code/symbols in body
+const EMERALD_GEM = [
+  '                        ╱╲',
+  '                       ╱  ╲',
+  '                      ╱    ╲',
+  '                     ╱  AC  ╲',
+  '                    ╱════════╲',
+  '                   ╱ {=>}  ◈  ╲',
+  '                  ╱  async  AI  ╲',
+  '                 ╱  ◇  /**/  ⊹   ╲',
+  '                ╱   import {} ◈    ╲',
+  '               ╱══════════════════╲',
+  '                ╲   ⊹  () => {}  ╱',
+  '                 ╲  ◈  const   ╱',
+  '                  ╲   ✦  AI  ╱',
+  '                   ╲  ◇ {} ╱',
+  '                    ╲    ╱',
+  '                     ╲  ╱',
+  '                      ╲╱',
 ];
 
+// Sparkle row indices where sparkles can appear (around the gem perimeter)
+const SPARKLE_ROWS = [0, 1, 2, 4, 9, 14, 15, 16];
+
+const SPARKLE_CHARS = ['✦', '✧', '⊹', '✶', '⋆'];
+
 export async function showBanner() {
   console.clear();
   console.log();
 
-  // Phase 1: Glitch-in effect — show random noise then resolve to the logo
-  const maxWidth = Math.max(...LOGO.map((l) => l.length));
-  const glitchChars = '█▓▒░╗╔╝╚═║╬╣╠╩╦';
-  const glitchSteps = 6;
+  const gemHeight = EMERALD_GEM.length;
+  const particleChars = '░▒▓█◈◇⊹';
 
-  for (let step = 0; step < glitchSteps; step++) {
-    const ratio = step / (glitchSteps - 1); // 0 → 1
+  // ── Phase 1: Particle Build-up ──────────────────────────────────
+  // Green particles progressively form the emerald silhouette
+  const buildSteps = 6;
+
+  for (let step = 0; step < buildSteps; step++) {
+    const ratio = step / (buildSteps - 1); // 0 → 1
     const output = [];
-    for (const line of LOGO) {
+
+    for (const line of EMERALD_GEM) {
       let result = '';
       for (let i = 0; i < line.length; i++) {
         if (line[i] === ' ') {
-          result += ' ';
+          // In early frames, occasionally show a stray particle near non-space chars
+          if (ratio < 0.6 && Math.random() < 0.03 && i > 0 && line[i - 1] !== ' ') {
+            result += particleChars[Math.floor(Math.random() * 3)]; // ░▒▓ only
+          } else {
+            result += ' ';
+          }
         } else if (Math.random() < ratio) {
-          result += line[i];
+          result += line[i]; // Reveal actual character
         } else {
-          result += glitchChars[Math.floor(Math.random() * glitchChars.length)];
+          result += particleChars[Math.floor(Math.random() * particleChars.length)];
         }
       }
       output.push(result);
     }
 
     if (step > 0) {
-      process.stdout.write(`\x1B[${LOGO.length}A`);
+      process.stdout.write(`\x1B[${gemHeight}A`);
     }
     for (const line of output) {
-      const colored = step < glitchSteps - 1
-        ? dimGradient(line)
-        : acGradient(line);
+      const colored = step < buildSteps - 1
+        ? dimEmerald(line)
+        : emeraldGradient(line);
       console.log(colored);
     }
-    await sleep(step < glitchSteps - 1 ? 80 : 0);
+    await sleep(step < buildSteps - 1 ? 100 : 0);
+  }
+
+  // ── Phase 2: Full Reveal with AC highlight ──────────────────────
+  // Brief pause then re-render with "AC" in bright white/green
+  await sleep(150);
+  process.stdout.write(`\x1B[${gemHeight}A`);
+
+  for (let i = 0; i < EMERALD_GEM.length; i++) {
+    const line = EMERALD_GEM[i];
+    // Highlight "AC" in the crown (line index 3)
+    if (i === 3) {
+      const acIdx = line.indexOf('AC');
+      const before = line.slice(0, acIdx);
+      const ac = line.slice(acIdx, acIdx + 2);
+      const after = line.slice(acIdx + 2);
+      process.stdout.write(
+        `\x1B[2K${emeraldGradient(before)}${chalk.hex('#FFFFFF').bold(ac)}${emeraldGradient(after)}\n`
+      );
+    } else {
+      process.stdout.write(`\x1B[2K${emeraldGradient(line)}\n`);
+    }
+  }
+  await sleep(200);
+
+  // ── Phase 3: Pulsing Glow Loop ──────────────────────────────────
+  // Alternate bright/dim with sparkles around perimeter
+  const pulseCycles = 3;
+
+  for (let cycle = 0; cycle < pulseCycles; cycle++) {
+    // Bright phase with sparkles
+    process.stdout.write(`\x1B[${gemHeight}A`);
+
+    for (let i = 0; i < EMERALD_GEM.length; i++) {
+      const line = EMERALD_GEM[i];
+      let rendered;
+
+      if (i === 3) {
+        const acIdx = line.indexOf('AC');
+        const before = line.slice(0, acIdx);
+        const ac = line.slice(acIdx, acIdx + 2);
+        const after = line.slice(acIdx + 2);
+        rendered = brightEmerald(before) + chalk.hex('#FFFFFF').bold(ac) + brightEmerald(after);
+      } else {
+        rendered = brightEmerald(line);
+      }
+
+      // Add sparkle after the line on perimeter rows
+      let sparkle = '';
+      if (SPARKLE_ROWS.includes(i) && Math.random() < 0.6) {
+        const sp = SPARKLE_CHARS[Math.floor(Math.random() * SPARKLE_CHARS.length)];
+        const pad = Math.floor(Math.random() * 3) + 1;
+        sparkle = ' '.repeat(pad) + chalk.hex('#AAFFDD')(sp);
+      }
+
+      process.stdout.write(`\x1B[2K${rendered}${sparkle}\n`);
+    }
+    await sleep(250);
+
+    // Dim phase
+    process.stdout.write(`\x1B[${gemHeight}A`);
+    for (let i = 0; i < EMERALD_GEM.length; i++) {
+      const line = EMERALD_GEM[i];
+      let rendered;
+      if (i === 3) {
+        const acIdx = line.indexOf('AC');
+        const before = line.slice(0, acIdx);
+        const ac = line.slice(acIdx, acIdx + 2);
+        const after = line.slice(acIdx + 2);
+        rendered = emeraldGradient(before) + chalk.hex('#A8E6CF').bold(ac) + emeraldGradient(after);
+      } else {
+        rendered = emeraldGradient(line);
+      }
+      process.stdout.write(`\x1B[2K${rendered}\n`);
+    }
+    await sleep(250);
   }
 
   console.log();
 
-  // Phase 2: Animated separator with scanning effect
+  // ── Phase 4: Animated separator (preserved) ─────────────────────
   const sepWidth = 68;
   const sepChars = '─';
   for (let i = 0; i <= sepWidth; i++) {
     const line =
-      chalk.hex('#2D3436')('  ') +
+      chalk.hex('#1B5E20')('  ') +
       glowGradient(sepChars.repeat(i)) +
-      chalk.hex('#00CEC9')('●') +
-      chalk.hex('#2D3436')(sepChars.repeat(Math.max(0, sepWidth - i)));
+      chalk.hex('#2ECC71')('●') +
+      chalk.hex('#1B5E20')(sepChars.repeat(Math.max(0, sepWidth - i)));
     process.stdout.write(`\x1B[2K\r${line}`);
     await sleep(6);
   }
@@ -71,28 +174,28 @@ export async function showBanner() {
 
   console.log();
 
-  // Phase 3: Typewriter tagline with cursor blink
+  // ── Phase 5: Typewriter tagline (preserved) ─────────────────────
   const tagline = '  Agentic Coding Framework — Multi-assistant configuration system';
   const cursor = '▌';
   for (let i = 0; i <= tagline.length; i++) {
     const text = tagline.slice(0, i);
-    process.stdout.write(`\x1B[2K\r${chalk.hex('#DFE6E9')(text)}${chalk.hex('#00CEC9')(cursor)}`);
+    process.stdout.write(`\x1B[2K\r${chalk.hex('#DFE6E9')(text)}${chalk.hex('#2ECC71')(cursor)}`);
     await sleep(i % 4 === 0 ? 18 : 10);
   }
   // Blink cursor 3 times then remove
   for (let b = 0; b < 3; b++) {
-    process.stdout.write(`\x1B[2K\r${chalk.hex('#DFE6E9')(tagline)}${chalk.hex('#00CEC9')(cursor)}`);
+    process.stdout.write(`\x1B[2K\r${chalk.hex('#DFE6E9')(tagline)}${chalk.hex('#2ECC71')(cursor)}`);
     await sleep(120);
     process.stdout.write(`\x1B[2K\r${chalk.hex('#DFE6E9')(tagline)} `);
     await sleep(120);
   }
   process.stdout.write(`\x1B[2K\r${chalk.hex('#DFE6E9')(tagline)}  \n`);
 
-  // Phase 4: Info badges
+  // ── Phase 6: Info badges (preserved) ────────────────────────────
   console.log();
-  const version = chalk.hex('#2D3436').bgHex('#00CEC9').bold(' v1.x ');
-  const badge = chalk.hex('#2D3436').bgHex('#6C5CE7').bold(' CLI ');
-  const badge2 = chalk.hex('#2D3436').bgHex('#FDCB6E').bold(' 23 Assistants ');
+  const version = chalk.hex('#1B5E20').bgHex('#00FF7F').bold(' v1.x ');
+  const badge = chalk.hex('#FFFFFF').bgHex('#2ECC71').bold(' CLI ');
+  const badge2 = chalk.hex('#1B5E20').bgHex('#A8E6CF').bold(' 23 Assistants ');
   console.log(`  ${version} ${badge} ${badge2}`);
 
   console.log();