@sallmarta/eye-hate-agent 1.0.6 → 1.0.7

package/README.md

@@ -35,6 +35,7 @@ Once initialized, EHA projects a series of interactive workflows directly into y
 | **`/eha-refresh`** | The main workhorse for repos with **any existing documentation**. Updates active SDD docs, migrates legacy docs, converts non-SDD docs, and creates missing SDD files — all by cross-referencing the actual codebase alongside existing material. Auto-detects the appropriate Taxonomy Tier for migration scenarios. Prompts the user to resolve any drift between codebase and docs. |
 | **`/sdd-discuss`** | Collaborative brainstorming. Interviews you about edge cases, API shapes, data models, and constraints, then drafts spec snippets ready for injection into project docs. No code output. |
 | **`/sdd-execute`** | Spec-Driven code generation via strict TDD. Reads specs → generates tests → generates code → validates against architecture. Refuses to code features not in the spec. |
+| **`/eha-help`** | **EHA Help & Tutorial.** Interactive guide providing descriptions of EHA's 4-layer taxonomy, active workflows, and specialist skills. |
 
 > **Looking for parity audits?** Use the `parity-audit` skill directly:
 > `@agent use parity-audit on this repository`

package/bin/eha.js

@@ -25,33 +25,34 @@ async function promptAgentChoice(currentAgent) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const runtimes = listSupportedRuntimes();
-    const defaultIndex = currentAgent
-      ? runtimes.findIndex(r => r.id === currentAgent) + 1
-      : 1;
+    const defaultIndex = 1;
 
     console.log('');
     console.log('Which agent?');
     for (let i = 0; i < runtimes.length; i++) {
       console.log(`  ${i + 1}. ${runtimes[i].name}`);
     }
+    console.log(`  ${runtimes.length + 1}. All Agents`);
 
+    const maxChoice = runtimes.length + 1;
     const answer = await rl.question(
-      `Choose [1-${runtimes.length}] (default: ${defaultIndex}): `,
+      `Choose [1-${maxChoice}] (default: ${defaultIndex}): `,
     );
     const trimmed = answer.trim();
 
-    // Accept number or name
     if (!trimmed) return runtimes[defaultIndex - 1].id;
 
     const num = parseInt(trimmed, 10);
     if (num >= 1 && num <= runtimes.length) return runtimes[num - 1].id;
+    if (num === maxChoice) return 'all';
 
-    // Fallback: try to match by name (backward compat)
     const normalized = trimmed.toLowerCase();
+    if (normalized === 'all') return 'all';
+
     const match = runtimes.find(r => r.id === normalized);
     if (match) return match.id;
 
-    return trimmed.toLowerCase(); // Let it fall through
+    return trimmed.toLowerCase();
   } finally {
     rl.close();
   }
@@ -76,11 +77,11 @@ function resolveRootDir() {
   } catch {
     console.error(
       chalk.red('No project root found.') +
-        ' Run ' +
-        chalk.cyan('npm init -y') +
-        ' or ' +
-        chalk.cyan('git init') +
-        ' first.',
+      ' Run ' +
+      chalk.cyan('npm init -y') +
+      ' or ' +
+      chalk.cyan('git init') +
+      ' first.',
     );
     process.exit(1);
   }
@@ -96,15 +97,13 @@ function printInitSummary(result) {
   }
   console.log('');
 
-  if (result.agentId === 'claude') {
-    console.log('Open Claude in this project and run ' + chalk.cyan('/eha-bootstrap') + ' to get started.');
-  } else if (result.agentId === 'copilot') {
-    console.log(
-      'Open GitHub Copilot agent mode and attach ' +
-        chalk.cyan('#eha-bootstrap.prompt.md') +
-        ' to get started.',
-    );
-  }
+  const agentNames = {
+    claude: 'Claude',
+    copilot: 'GitHub Copilot',
+    antigravity: 'Antigravity',
+  };
+  const name = agentNames[result.agentId] || result.agentId;
+  console.log(`Open ${name} in this project and run ${chalk.cyan('/eha-help')} to get started!`);
   console.log('');
 }
 
@@ -158,12 +157,44 @@ async function runInitWizard(agentIdArg) {
   }
 
   const normalized = String(agentId).trim().toLowerCase();
+
+  if (normalized === 'all') {
+    const installedAgents = config.agents || (config.agent ? [config.agent] : []);
+    if (isInteractive && installedAgents.length > 0) {
+      const listStr = installedAgents.map(a => chalk.cyan(a)).join(', ');
+      const confirm = await promptConfirm(
+        `EHA is set up for: ${listStr}. Overwrite / setup all agents?`,
+        true,
+      );
+      if (!confirm) {
+        console.log('Skipped.');
+        return;
+      }
+    }
+
+    console.log(chalk.blue('\nInitializing EHA for all agents...'));
+    let fileCount = 0;
+    for (const id of SUPPORTED_AGENT_IDS) {
+      const result = initProject({ rootDir, agentId: id });
+      fileCount += result.fileCount;
+    }
+
+    console.log('');
+    console.log(chalk.green('✓ EHA is ready for all agents.'));
+    console.log(`  Agents : ${SUPPORTED_AGENT_IDS.map(a => chalk.cyan(a)).join(', ')}`);
+    console.log(`  Files  : ${fileCount} file(s) generated`);
+    console.log('');
+    console.log('Open Agents in this project and run ' + chalk.cyan('/eha-help') + ' to get started or run ' + chalk.cyan('eha doctor') + ' to see all files.');
+    console.log('');
+    return;
+  }
+
   if (!SUPPORTED_AGENT_IDS.includes(normalized)) {
     const runtimes = listSupportedRuntimes();
     const list = runtimes.map((r, i) => `${i + 1}. ${r.name}`).join(', ');
     console.error(
       chalk.red(`Unsupported agent: ${agentIdArg || agentId}.`) +
-        ` Choose one of: ${list}.`,
+      ` Choose one of: ${list}, or ${runtimes.length + 1}. All Agents.`,
     );
     process.exit(1);
   }

package/docs/templates/reusable-prompts/00-eha-help.md

@@ -0,0 +1,56 @@
+---
+description: "EHA workflow - help"
+---
+
+# EHA Help & Tutorial
+
+This is your interactive guide to using Eye Hate Agent (EHA).
+
+## 1. Overview
+Eye Hate Agent (EHA) standardizes human-agent collaboration through a unified Spec-Driven Development (SDD) contract, structured workflows, and specialist skills.
+
+## 2. The 4-Layer Taxonomy
+All project documentation is structured under a predictable 4-layer taxonomy:
+- `docs/project-docs/foundation/` — PRD, Phases, Status, Changelog
+- `docs/project-docs/operations/` — CI/CD, Deployment, Runbooks
+- `docs/project-docs/development/` — Testing, Database, Architecture, API-Contract, UI-UX
+- `docs/project-docs/technical-guidelines/` — Stable project/language/linting guidelines
+
+## 3. Interactive Workflow Commands
+Trigger these commands inside your chat window to coordinate development:
+
+| Trigger Command | Purpose | When to Use |
+| :--- | :--- | :--- |
+| `/eha-bootstrap` | Initializes a brand-new documentation set | Run only in **empty repositories** with zero docs. |
+| `/eha-refresh` | Synchronizes and migrates project documentation | Run in **active projects** to sync code with docs. |
+| `/sdd-discuss` | Brainstorm specifications and API contracts | Run **before coding** to align specs. |
+| `/sdd-execute` | Spec-driven code generation via TDD | Run **during implementation** to write tests/code. |
+
+## 4. Specialist Skills
+Invoke skills directly in your prompts (e.g. `use eha-api-design`):
+- `eha-system-analysis` — Inspect architecture and codebase logic
+- `eha-api-design` — Plan or refactor REST/GraphQL/gRPC APIs
+- `eha-db-schema-design` — Design schemas and migrations
+- `eha-ui-ux-design` / `eha-wireframing` — UI/UX wireframes and styling systems
+- `eha-code-audit` — Multi-layered verification and codebase scanning
+- `eha-parity-audit` — Automated drift analysis
+- `eha-security-audit` — Dependency scanning and threat modeling
+- `eha-system-tester` — Rigorous testing plans and case design
+- `eha-devops-ci-cd` — Build pipeline configurations
+- `eha-observability` — Logs, metrics, trace instrumentation, and error handling
+- `eha-refactor` — Technical debt cleanup and optimization
+
+## 5. Quick Start Instructions
+If starting a new feature:
+1. Run `/sdd-discuss` to brainstorm specs.
+2. Update project docs to reflect the spec.
+3. Run `/sdd-execute` to execute code via TDD.
+4. Maintain `changelog.md` and `status.md`.
+
+---
+
+## 6. Strict Output Contract (Token Economy)
+When the user triggers this command, you **MUST** adhere to the following rules to conserve maximum tokens:
+1. **Ultra-Concision:** Respond immediately with extremely short, direct answers. Do not write introductory filler (no "Sure, let's look at...", "Here is...", or greetings).
+2. **Minimal Text:** Keep all explanations under 5 words per item. Rely strictly on the tables and bullet lists above.
+3. **Redirection:** Conclude the output in exactly one short question: "Which workflow would you like to run next?"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sallmarta/eye-hate-agent",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Template-and-engine toolkit for AI-agent-assisted project workflows.",
   "directories": {
     "doc": "docs"

package/src/engine/workflow-registry.js

@@ -1,6 +1,12 @@
 const path = require('node:path');
 
 const WORKFLOW_DEFINITIONS = {
+  help: {
+    id: 'help',
+    commandName: 'help',
+    description: 'Get help and tutorial on EHA workflows and philosophy',
+    repoRelativePath: path.join('docs', 'templates', 'reusable-prompts', '00-eha-help.md'),
+  },
   bootstrap: {
     id: 'bootstrap',
     commandName: 'bootstrap',