@sallmarta/eye-hate-agent 1.0.1 → 1.0.3

package/bin/eha.js

@@ -1,163 +1,248 @@
 #!/usr/bin/env node
 
+'use strict';
+
 const { program } = require('commander');
 const chalk = require('chalk');
+const readline = require('node:readline/promises');
 const {
-  DEFAULT_RUNTIME_IDS,
+  SUPPORTED_AGENT_IDS,
   doctor,
   findRepoRoot,
-  getWorkflow,
-  installRuntimes,
+  initProject,
   listSupportedRuntimes,
-  prepareWorkflowRun,
-  uninstallRuntimes,
+  listWorkflows,
+  readConfig,
+  readProjectManifest,
+  removeProject,
 } = require('../src/engine');
 
-function formatRuntimeList(runtimes) {
-  return runtimes.map((runtime) => `${runtime.id} (${runtime.supportTier})`).join(', ');
+const pkg = require('../package.json');
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+async function promptAgentChoice(currentAgent) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const defaultLabel = currentAgent || SUPPORTED_AGENT_IDS[0];
+    const answer = await rl.question(
+      `Which agent? [${SUPPORTED_AGENT_IDS.join('/')}] (default: ${defaultLabel}): `,
+    );
+    const normalized = answer.trim().toLowerCase();
+    return normalized || defaultLabel;
+  } finally {
+    rl.close();
+  }
 }
 
-function printDoctorSummary(result) {
-  console.log(chalk.blue('EHA doctor'));
-  console.log(`Repo root: ${result.rootDir}`);
-  console.log(`Engine state: ${result.paths.stateDir}`);
-  console.log(`Install manifest: ${result.paths.manifestPath}`);
-  console.log(`Supported runtimes: ${formatRuntimeList(result.supportedRuntimes)}`);
-  console.log(`Generated outputs live inside repo: ${result.generatedOutputsInsideRepo ? 'yes' : 'no'}`);
-
-  if (result.installedRuntimes.length === 0) {
-    console.log(chalk.yellow('No runtimes are currently installed.'));
-    return;
+async function promptOverwriteOrDiscard(message) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question(`${message} [O]verwrite / [D]iscard (default: D): `);
+    return answer.trim().toLowerCase() === 'o';
+  } finally {
+    rl.close();
   }
+}
 
-  console.log(chalk.green('Installed runtimes:'));
-  for (const runtime of result.installedRuntimes) {
-    console.log(`- ${runtime.id}: ${runtime.fileCount} generated file(s), support tier ${runtime.supportTier}`);
+async function promptConfirm(message, defaultYes = false) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    const answer = await rl.question(`${message} ${hint}: `);
+    const normalized = answer.trim().toLowerCase();
+    if (!normalized) return defaultYes;
+    return normalized === 'y';
+  } finally {
+    rl.close();
   }
 }
 
-function printInstallSummary(action, result) {
-  console.log(chalk.blue(`EHA ${action}`));
-  console.log(`Repo root: ${result.rootDir}`);
-  console.log(`Runtimes: ${result.runtimes.join(', ')}`);
-  console.log(`Manifest: ${result.manifestPath}`);
-  for (const runtime of result.runtimeSummaries) {
-    console.log(`- ${runtime.id}: ${runtime.fileCount} file(s), support tier ${runtime.supportTier}`);
+function resolveRootDir() {
+  try {
+    return findRepoRoot(process.cwd());
+  } catch {
+    console.error(
+      chalk.red('No project root found.') +
+        ' Run ' +
+        chalk.cyan('npm init -y') +
+        ' or ' +
+        chalk.cyan('git init') +
+        ' first.',
+    );
+    process.exit(1);
   }
 }
 
-function printWorkflowSummary(result) {
-  console.log(chalk.blue(`EHA workflow: ${result.workflow.id}`));
-  console.log(`Source workflow: ${result.workflow.repoRelativePath}`);
-  console.log(`Prepared prompt: ${result.promptPath}`);
-  if (result.workflow.capabilityNote) {
-    console.log(chalk.yellow(`Note: ${result.workflow.capabilityNote}`));
+function printInitSummary(result) {
+  console.log('');
+  console.log(chalk.green('✓ EHA is ready.'));
+  console.log(`  Agent : ${chalk.cyan(result.agentId)}`);
+  console.log(`  Files : ${result.fileCount} file(s) generated`);
+  for (const f of result.files) {
+    console.log(`    ${chalk.gray(f)}`);
   }
-  if (result.contextText) {
-    console.log(chalk.gray(`Additional context captured in ${result.promptPath}`));
+  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.',
+    );
   }
+  console.log('');
 }
 
-function installWorkflowCommand(workflowId) {
-  const workflow = getWorkflow(workflowId);
-
-  program
-    .command(`${workflow.id} [context...]`)
-    .description(workflow.description)
-    .option('--print', 'Print the assembled prompt instead of the summary')
-    .action((contextParts, options) => {
-      const rootDir = findRepoRoot(process.cwd());
-      const contextText = (contextParts || []).join(' ').trim();
-      const result = prepareWorkflowRun({
-        rootDir,
-        workflowId: workflow.id,
-        contextText,
-      });
-
-      if (options.print) {
-        process.stdout.write(result.promptContent);
+function printDoctorSummary(result) {
+  console.log('');
+  console.log(chalk.blue('EHA doctor'));
+  console.log(`  Root   : ${result.rootDir}`);
+  console.log(`  Config : ${result.paths.configPath}`);
+  console.log(`  Agent  : ${result.agentId ? chalk.cyan(result.agentId) : chalk.yellow('not set — run eha init')}`);
+  console.log('');
+
+  if (!result.isInitialized) {
+    console.log(chalk.yellow('EHA is not initialized in this project. Run eha init to set it up.'));
+    console.log('');
+    return;
+  }
+
+  const allPresent = result.generatedFiles.every((f) => f.exists);
+  if (allPresent) {
+    console.log(chalk.green('All generated files are present:'));
+  } else {
+    console.log(chalk.yellow('Some generated files are missing (re-run eha init to restore):'));
+  }
+  for (const f of result.generatedFiles) {
+    const icon = f.exists ? chalk.green('✓') : chalk.red('✗');
+    console.log(`  ${icon} ${f.relativePath}`);
+  }
+  console.log('');
+}
+
+// ─── Wizard (shared by bare invocation and `eha init`) ────────────────────────
+
+async function runInitWizard(agentIdArg) {
+  const rootDir = resolveRootDir();
+  const config = readConfig(rootDir);
+
+  let agentId = agentIdArg ? String(agentIdArg).trim().toLowerCase() : null;
+
+  if (!agentId) {
+    if (config.agent) {
+      const manifest = readProjectManifest(rootDir);
+      if (manifest.packageVersion !== pkg.version && process.stdin.isTTY && process.stdout.isTTY) {
+        const regenerate = await promptConfirm(
+          `EHA files were generated by v${manifest.packageVersion ?? 'unknown'}, current is v${pkg.version}. Regenerate?`,
+          true,
+        );
+        if (!regenerate) {
+          console.log('Skipped.');
+          return;
+        }
+        const result = initProject({ rootDir, agentId: config.agent });
+        printInitSummary(result);
+        return;
+      }
+      if (process.stdin.isTTY && process.stdout.isTTY) {
+        const overwrite = await promptOverwriteOrDiscard(
+          `EHA already set up (agent: ${chalk.cyan(config.agent)}).`,
+        );
+        if (!overwrite) {
+          console.log('Discarded.');
+          return;
+        }
+      }
+    }
+
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+      agentId = await promptAgentChoice(config.agent);
+    } else {
+      agentId = config.agent || SUPPORTED_AGENT_IDS[0];
+    }
+  } else if (config.agent && config.agent !== agentId) {
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+      const overwrite = await promptOverwriteOrDiscard(
+        `EHA already set up (agent: ${chalk.cyan(config.agent)}). Switch to ${chalk.cyan(agentId)}?`,
+      );
+      if (!overwrite) {
+        console.log('Discarded.');
         return;
       }
+    }
+  }
+
+  if (!SUPPORTED_AGENT_IDS.includes(agentId)) {
+    console.error(
+      chalk.red(`Unsupported agent: ${agentId}.`) +
+        ` Choose one of: ${SUPPORTED_AGENT_IDS.join(', ')}.`,
+    );
+    process.exit(1);
+  }
 
-      printWorkflowSummary(result);
-    });
+  const result = initProject({ rootDir, agentId });
+  printInitSummary(result);
 }
 
-program
-  .name('eha')
-  .description('Eye Hate Agent (EHA) engine and installer')
-  .version('1.0.0');
+// ─── CLI definition ────────────────────────────────────────────────────────────
 
-program
-  .command('install [runtimes...]')
-  .description('Generate repo-local runtime surfaces for EHA')
-  .action((runtimes) => {
-    const rootDir = findRepoRoot(process.cwd());
-    const result = installRuntimes({
-      rootDir,
-      runtimes: runtimes && runtimes.length > 0 ? runtimes : DEFAULT_RUNTIME_IDS,
-    });
-    printInstallSummary('install', result);
-  });
+program.name('eha').description('Eye Hate Agent (EHA) — AI workflow toolkit').version(pkg.version);
 
-program
-  .command('uninstall [runtimes...]')
-  .description('Remove generated repo-local runtime surfaces for EHA')
-  .action((runtimes) => {
-    const rootDir = findRepoRoot(process.cwd());
-    const result = uninstallRuntimes({
-      rootDir,
-      runtimes: runtimes && runtimes.length > 0 ? runtimes : DEFAULT_RUNTIME_IDS,
-    });
-    printInstallSummary('uninstall', result);
-  });
+// Bare `eha` / `eyehateagent` with no subcommand runs the init wizard.
+program.action(async () => {
+  await runInitWizard(null);
+});
 
 program
-  .command('doctor')
-  .description('Inspect EHA engine state, supported runtimes, and installed outputs')
-  .action(() => {
-    const rootDir = findRepoRoot(process.cwd());
-    printDoctorSummary(doctor({ rootDir }));
+  .command('init [agent]')
+  .description(`Set up EHA in this project. Agent: ${SUPPORTED_AGENT_IDS.join(' | ')}`)
+  .action(async (agentArg) => {
+    await runInitWizard(agentArg || null);
   });
 
-installWorkflowCommand('bootstrap');
-installWorkflowCommand('refresh');
-installWorkflowCommand('parity');
-installWorkflowCommand('discuss');
-installWorkflowCommand('execute');
-installWorkflowCommand('verify');
-
 program
-  .command('init [context...]')
-  .description('Alias for bootstrap')
-  .option('--print', 'Print the assembled prompt instead of the summary')
-  .action((contextParts, options) => {
-    const rootDir = findRepoRoot(process.cwd());
-    const contextText = (contextParts || []).join(' ').trim();
-    const result = prepareWorkflowRun({
-      rootDir,
-      workflowId: 'bootstrap',
-      contextText,
-      invokedAs: 'init',
-    });
-
-    if (options.print) {
-      process.stdout.write(result.promptContent);
+  .command('remove')
+  .description('Remove EHA-generated files and config from this project')
+  .action(async () => {
+    const rootDir = resolveRootDir();
+    const config = readConfig(rootDir);
+
+    if (!config.agent) {
+      console.log(chalk.yellow('EHA is not initialized here. Nothing to remove.'));
       return;
     }
 
-    printWorkflowSummary(result);
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+      const confirmed = await promptConfirm(
+        `Remove EHA (agent: ${chalk.cyan(config.agent)}) from this project?`,
+      );
+      if (!confirmed) {
+        console.log('Aborted.');
+        return;
+      }
+    }
+
+    const result = removeProject({ rootDir });
+    console.log('');
+    console.log(chalk.green('✓ EHA removed.'));
+    for (const f of result.removedFiles) {
+      console.log(`  ${chalk.gray(f)}`);
+    }
+    console.log('');
   });
 
 program
-  .command('runtimes')
-  .description('List supported runtimes and support tiers')
+  .command('doctor')
+  .description('Show EHA status: config, agent, and generated files')
   .action(() => {
-    const runtimes = listSupportedRuntimes();
-    console.log(chalk.blue('Supported runtimes'));
-    for (const runtime of runtimes) {
-      console.log(`- ${runtime.id}: ${runtime.supportTier} - ${runtime.description}`);
-    }
+    const rootDir = resolveRootDir();
+    printDoctorSummary(doctor({ rootDir }));
   });
 
-program.parse(process.argv);
+program.parseAsync(process.argv).catch((error) => {
+  console.error(chalk.red(error.message));
+  process.exitCode = 1;
+});

package/docs/templates/project-docs-template/foundation/architecture.md

@@ -0,0 +1,79 @@
+# Architecture
+
+Last update: YYYY-MM-DD
+
+Status: [Proposed | Draft | Live | Deprecated | Archived]
+
+---
+
+## 1. Description
+Briefly describe the purpose of this document and what it contains.
+
+## 2. Important
+Notes of important findings or critical constraints. Can be empty.
+
+## 3. Table of Contents
+[Generate a hyperlinked table of contents here containing ALL headings in this file (1 through N). Use standard markdown links, e.g., - [1. Description](#1-description)]
+
+## 4. Scope
+The boundaries of what this document covers.
+
+## 5. Goals
+What we aim to achieve with this specific document.
+
+## 6. Non Goals
+What is explicitly excluded from the scope of this document.
+
+## 7. Tech Stack Overview
+| Area | Choice | Notes |
+| --- | --- | --- |
+| Application or service | TBD | |
+| Runtime or platform | TBD | |
+| Storage | TBD | |
+| External integrations | TBD | |
+
+## 8. Architecture Pattern
+Describe architecture design pattern, system topology, component boundaries, and foundational control flow.
+
+## 9. System Flow
+General overview of how the system work from start to end. Diagram or flowchart visual are preferred. Use mermaid.
+
+```mermaid
+graph TD
+    A[Start] --> B{Decision}
+    B -- Yes --> C[Result 1]
+    B -- No --> D[Result 2]
+```
+
+## 10. Data Flow
+General overview of inter-feature data flow, mapped against architectural patterns and system flow. Diagram or flowchart visual are preferred. Use mermaid.
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant System
+    User->>System: Data Request
+    System-->>User: Data Response
+```
+
+## 11. Tools Integration
+Such as hardware or software or external api and relevant tools. Can be empty.
+
+| Integration | Purpose | Kind | Notes |
+| --- | --- | --- | --- |
+| TBD | TBD | TBD | *Software/Hardware/APIs/Other* |
+
+## 12. Global Parameters and Constraints
+Detail the system's global restrictions, such as performance requirements, caching policies, and error-handling mechanisms (e.g., "Supports offline execution for core features" or "Memory footprint restricted to 50MB").
+
+## 13. Architecture Decision Records (ADRs)
+A collection of ADRs documenting the rationale behind technical decision (e.g., "Choosing React over Vue for state management flexibility" or "Adopting Domain-Driven Design to leverage bounded contexts").
+
+## 14. Success Metrics
+How we measure if the goals of this document are achieved.
+
+## 15. Related Documents
+[Link to related document](path) - Short brief note about why it's related (e.g., [Guidelines](path) - technical implementation rules).
+
+## 16. Open Questions
+Unresolved architectural questions or assumptions. Can be empty.

package/docs/templates/project-docs-template/foundation/changelog.md

@@ -0,0 +1,53 @@
+# System Name Changelog
+
+Last update: YYYY-MM-DD
+
+Status: [Proposed | Draft | Live | Deprecated | Archived]
+
+---
+
+## 1. Description
+Briefly describe the purpose of this document and what it contains.
+
+## 2. Important
+Notes of important findings or critical constraints. Can be empty.
+
+## 3. Table of Contents
+[Generate a hyperlinked table of contents here containing ALL headings in this file (1 through N). Use standard markdown links, e.g., - [1. Description](#1-description)]
+
+## 4. Scope
+The boundaries of what this document covers.
+
+## 5. Goals
+What we aim to achieve with this specific document.
+
+## 6. Non Goals
+What is explicitly excluded from the scope of this document.
+
+## 7. [Unreleased]
+### 7.1. Added
+TBD
+
+### 7.2. Changed
+TBD
+
+### 7.3. Deprecated
+TBD
+
+### 7.4. Removed
+TBD
+
+### 7.5. Fixed
+TBD
+
+### 7.6. Security
+TBD
+
+## 8. Success Metrics
+How we measure if the goals of this document are achieved.
+
+## 9. Related Documents
+[Link to related document](path) - Short brief note about why it's related.
+
+## 10. Open Questions
+Any unresolved questions or assumptions. Can be empty.

package/docs/templates/project-docs-template/foundation/feature-inventory.md

@@ -0,0 +1,46 @@
+# Feature Inventory
+
+Last update: YYYY-MM-DD
+
+Status: [Proposed | Draft | Live | Deprecated | Archived]
+
+---
+
+## 1. Description
+Briefly describe the purpose of this document and what it contains.
+
+## 2. Important
+Notes of important findings or critical constraints. Can be empty.
+
+## 3. Table of Contents
+[Generate a hyperlinked table of contents here containing ALL headings in this file (1 through N). Use standard markdown links, e.g., - [1. Description](#1-description)]
+
+## 4. Scope
+The boundaries of what this document covers.
+
+## 5. Goals
+What we aim to achieve with this specific document.
+
+## 6. Non Goals
+What is explicitly excluded from the scope of this document.
+
+## 7. Feature Summary
+High-level overview of the active feature set.
+
+## 8. Core Functions (Epic-level)
+Major active functional blocks mapping directly to code.
+
+## 9. Sub-Functions (Task-level)
+Granular interactions and capabilities currently live.
+
+## 10. Deprecated / Removed Features
+Historical record of retired capabilities.
+
+## 11. Success Metrics
+How we measure if the goals of this document are achieved.
+
+## 12. Related Documents
+[Link to related document](path) - Short brief note about why it's related.
+
+## 13. Open Questions
+Any unresolved questions or assumptions. Can be empty.

package/docs/templates/project-docs-template/foundation/phases.md

@@ -0,0 +1,60 @@
+# Phases
+
+Last update: YYYY-MM-DD
+
+Status: [Proposed | Draft | Live | Deprecated | Archived]
+
+---
+
+## 1. Description
+Briefly describe the purpose of this document and what it contains.
+
+## 2. Important
+Notes of important findings or critical constraints. Can be empty.
+
+## 3. Table of Contents
+[Generate a hyperlinked table of contents here containing ALL headings in this file (1 through N). Use standard markdown links, e.g., - [1. Description](#1-description)]
+
+## 4. Scope
+The boundaries of what this document covers.
+
+## 5. Goals
+What we aim to achieve with this specific document.
+
+## 6. Non Goals
+What is explicitly excluded from the scope of this document.
+
+## 7. Overall Project Timeline
+High-level estimate and major milestones. Visual timelines are preferred. Use mermaid.
+
+```mermaid
+gantt
+    title Project Timeline
+    dateFormat  YYYY-MM-DD
+    section Phase 1
+    Milestone 1 : 2024-01-01, 30d
+    section Phase 2
+    Milestone 2 : 2024-02-01, 30d
+```
+
+## 8. Phase Registry
+Links to individual markdown files in the `phases/` directory.
+
+## 9. Sprint Tracker
+### 9.1. Current Sprint (Date Range)
+TBD
+
+### 9.2. Active Tasks
+TBD
+
+### 9.3. Blockers
+TBD
+
+## 10. Success Metrics
+How we measure if the goals of this document are achieved.
+
+## 11. Related Documents
+[Link to related document](path) - Short brief note about why it's related.
+
+## 12. Open Questions
+Any unresolved questions or assumptions. Can be empty.

package/docs/templates/project-docs-template/foundation/prd.md

@@ -0,0 +1,69 @@
+# Product Requirements Document (PRD)
+
+Last update: YYYY-MM-DD
+
+Status: [Proposed | Draft | Live | Deprecated | Archived]
+
+---
+
+## 1. Description
+Summarize the product, system, or major epic requirement set at a high level.
+
+## 2. Important
+Notes of important findings or critical constraints. Can be empty.
+
+## 3. Table of Contents
+[Generate a hyperlinked table of contents here containing ALL headings in this file (1 through N). Use standard markdown links, e.g., - [1. Description](#1-description)]
+
+## 4. Scope
+The boundaries of what this document covers.
+
+## 5. Goals
+What we aim to achieve with this specific document.
+
+## 6. Non Goals
+What is explicitly excluded from the scope of this document.
+
+## 7. Vision Statement
+A single, powerful sentence defining the ultimate end-state of the project.
+
+## 8. Target Personas
+Specific user types (e.g., Admin, Guest) to give the team empathy.
+
+## 9. Core Business Value
+The primary ROI, problem being solved, or operational improvement. Why does this project matter now?
+
+## 10. User Journeys & App Flow
+Flowcharts mapping the user's path through the app. Use mermaid.
+
+```mermaid
+journey
+    title User Journey Example
+    section Login
+      Enter credentials: 5: User
+      Authenticate: 5: System
+```
+
+## 11. Feature Workflows
+Step-by-step logic flows for individual features. Use mermaid flowcharts to map complex feature logic.
+
+## 12. Functional Requirements
+Detailed list of functional capabilities.
+
+## 13. Non-Functional Requirements
+Reliability, performance, security, compliance, or UX expectations.
+
+## 14. Acceptance Criteria
+Specific criteria to verify the requirements are met.
+
+## 15. External Dependencies & Partners
+Third-party vendors and manual bottlenecks.
+
+## 16. Success Metrics
+How we measure if the goals of this document are achieved.
+
+## 17. Related Documents
+[Link to related document](path) - Short brief note about why it's related.
+
+## 18. Open Questions
+Any unresolved questions or assumptions. Can be empty.