@sallmarta/eye-hate-agent 1.0.2 → 1.0.3

package/src/engine/runtime-adapters.js

@@ -1,102 +1,315 @@
+'use strict';
+
+const fs = require('node:fs');
 const path = require('node:path');
 
-function renderClaudeCommand(workflow, sourcePaths) {
+const { getBundledAssetPath } = require('./state');
+
+// Compact EHA rules embedded in every generated command file so the agent
+// has all structural context without needing any external file reference.
+const EHA_COMPACT_RULES = `## EHA Project Doc Rules
+
+**4-Layer Taxonomy.** All project docs live under \`docs/project-docs/\`:
+- \`foundation/\` — prd, architecture, workflow, status, phases, changelog, feature-inventory
+- \`operations/\` — ci-cd, production-runbook, governance, compliance, observability, security
+- \`technical/\` — testing, api-contract, database, ui-ux, error-handling, internationalization
+- \`technical-guidelines/\` — domain-specific cross-cutting rules (API, database, logging, etc.)
+
+**Legacy/Reference Docs:** Treat folders named \`archive/\`, \`docs-legacy/\`, or \`reference/\` as secondary migration input only, never as authoritative active truth.
+
+**Mandatory core docs:** \`index.md\`, \`getting-started.md\`, \`foundation/prd.md\`, \`foundation/architecture.md\`, \`foundation/workflow.md\`, \`foundation/status.md\`, \`foundation/phases.md\`, \`operations/ci-cd.md\`, \`operations/production-runbook.md\`, \`technical/testing.md\`, \`technical/api-contract.md\`, \`technical/database.md\`, \`technical/ui-ux.md\`.
+
+**Authority order:** project docs → codebase → agent judgment. When docs conflict, the owning doc wins. When code and docs conflict and authority is unclear, surface the conflict and ask the user — do not guess.
+
+**Universal stable headings (every file):** Description, Important, Table of Contents, Scope, Goals, Non Goals.
+
+**Key ownership rules:**
+- Vision, personas, requirements → \`foundation/prd.md\`
+- Stack and architecture → \`foundation/architecture.md\`
+- Dev loop and PR process → \`foundation/workflow.md\`
+- Verification commands and quality gates → \`technical/testing.md\`
+- Execution plan and progress → \`foundation/status.md\`
+- Sprint tracking and backlogs → \`foundation/phases.md\`
+- Optional doc inventory → \`index.md\`
+- Domain-specific technical rules → \`technical-guidelines/\` (Create these only for durable cross-cutting rules; avoid placeholders).
+
+**SDD rule:** Specifications dictate implementation. Follow a strict 4-step workflow: 1. Update project docs first, 2. Generate tests based on the specs, 3. Generate code to pass the tests, 4. Logically map every code change back to a spec requirement. Refuse to write code for features not in the spec.
+
+**Flexible Baselines Principle:** Omit docs the repo doesn't need. Mark unknowns as \`TBD\` or \`Assumption\`. Mark inferred facts as \`Inferred from codebase\` until the user confirms them.`;
+
+function loadPromptContent(workflow) {
+  const promptPath = getBundledAssetPath(workflow.repoRelativePath);
+  const raw = fs.readFileSync(promptPath, 'utf8');
+  // Remove the "Read `docs/eyehateagent-contract.md` first." line — the
+  // compact rules block replaces that dependency.
+  return raw
+    .split('\n')
+    .filter((line) => !line.includes('docs/eyehateagent-contract.md'))
+    .join('\n')
+    .replace(/^\n+/, '');
+}
+
+function loadSkillContent(skill) {
+  const promptPath = getBundledAssetPath(skill.repoRelativePath);
+  const raw = fs.readFileSync(promptPath, 'utf8');
+  const parts = raw.split(/^---\r?\n/m);
+  let body = parts.length > 2 ? parts.slice(2).join('---\n') : raw;
+  return body
+    .split('\n')
+    .filter((line) => !line.includes('docs/eyehateagent-contract.md'))
+    .join('\n')
+    .replace(/^\n+/, '');
+}
+
+function loadRuleContent(agentId) {
+  const rulePath = getBundledAssetPath(path.join('docs', 'templates', 'rules', 'agent-rules.md'));
+  let content = fs.readFileSync(rulePath, 'utf8').replace(/^\n+/, '');
+  
+  if (agentId) {
+    const agentsToFilter = ['claude', 'antigravity', 'copilot'].filter(a => a !== agentId.toLowerCase());
+    for (const a of agentsToFilter) {
+      const regex = new RegExp(`^\\s*-\\s*\\*\\*${a}.*$\\n?`, 'gmi');
+      content = content.replace(regex, '');
+    }
+  }
+  
+  return content;
+}
+
+function buildClaudeCommandFile(workflow) {
+  const promptContent = loadPromptContent(workflow);
   return `---
-description: "Run the EHA ${workflow.id} workflow"
+description: "EHA ${workflow.id} — ${workflow.description}"
 ---
 
-Read \`${sourcePaths.contractPath}\` first.
+${EHA_COMPACT_RULES}
 
-Execute \`${sourcePaths.workflowPath}\`.
+---
 
-If the user provides additional context, apply it while preserving the workflow's output contract and the owning-doc rules in \`docs/project-docs/\`.
-`;
+${promptContent}`;
 }
 
-function renderCopilotInstructions(workflows, bundledSources) {
-  const workflowTable = workflows
-    .map(
-      (workflow) =>
-        `- \`${workflow.commandName}\` -> \`${bundledSources.workflowPaths[workflow.repoRelativePath]}\`${workflow.capabilityNote ? ` (${workflow.capabilityNote})` : ''}`,
-    )
-    .join('\n');
+function buildCopilotPromptFile(workflow) {
+  const promptContent = loadPromptContent(workflow);
+  return `---
+mode: agent
+description: "EHA ${workflow.id} — ${workflow.description}"
+---
+
+${EHA_COMPACT_RULES}
+
+---
+
+${promptContent}`;
+}
 
+function buildClaudeSkillFile(skill) {
   return `---
-description: "Generated EHA workflow routing for GitHub Copilot"
+description: "EHA skill — ${skill.commandName}"
+---
+
+${EHA_COMPACT_RULES}
+
+---
+
+${loadSkillContent(skill)}`;
+}
+
+function buildCopilotSkillFile(skill) {
+  return `---
+mode: agent
+description: "EHA skill — ${skill.commandName}"
+---
+
+${EHA_COMPACT_RULES}
+
+---
+
+${loadSkillContent(skill)}`;
+}
+
+function buildClaudeRuleFile() {
+  return `---
+description: "EHA agent rules"
+---
+
+${loadRuleContent('claude')}`;
+}
+
+function buildCopilotRuleFile() {
+  return `---
+description: "EHA agent rules"
 applyTo: "**"
 ---
 
-# EHA Engine Workflows
+${loadRuleContent('copilot')}`;
+}
+
+function buildAntigravityCommandFile(workflow) {
+  const promptContent = loadPromptContent(workflow);
+  return `---
+name: "eha-${workflow.commandName}"
+description: "EHA ${workflow.id} — ${workflow.description}"
+---
+
+${EHA_COMPACT_RULES}
+
+---
+
+${promptContent}`;
+}
+
+function buildAntigravitySkillFile(skill) {
+  return `---
+name: "eha-${skill.commandName}"
+description: "EHA skill — ${skill.commandName}"
+---
+
+${EHA_COMPACT_RULES}
+
+---
+
+${loadSkillContent(skill)}`;
+}
+
+function buildAntigravityRuleFile() {
+  return `---
+name: "eha-agent-rules"
+description: "EHA agent rules"
+---
+
+${loadRuleContent('antigravity')}`;
+}
+
+function buildCopilotInstructionsFile(workflows) {
+  const workflowTable = workflows
+    .map((w) => `- \`${w.commandName}\` → \`.github/prompts/eha-${w.commandName}.prompt.md\``)
+    .join('\n');
 
-When a user asks to run an EHA workflow, prefer the canonical reusable prompt file listed below and preserve its output contract.
+  return `---
+description: "EHA workflow routing for GitHub Copilot"
+applyTo: "**"
+---
 
-${workflowTable}
+# EHA Workflows
 
-## Runtime support
+When a user asks to run an EHA workflow, use the matching prompt file below.
 
-- GitHub Copilot support tier is **guided**
-- this install generates repo-local instructions, not slash commands
-- bundled contract path: \`${bundledSources.contractPath}\`
-- generated outputs stay inside the repository for transparency
-`;
+${workflowTable}`;
 }
 
 const RUNTIME_ADAPTERS = {
   claude: {
     id: 'claude',
     name: 'Claude',
-    supportTier: 'full',
-    description: 'Repo-local Claude command projection under .claude/commands/eha/',
-    generateFiles(rootDir, workflows, bundledSources) {
+    description: 'Generates .claude/commands/eha/ slash command files, .claude/skills/ and .claude/rules/',
+    generateFiles(rootDir, workflows, skills) {
       const files = [];
       for (const workflow of workflows) {
         files.push({
           relativePath: path.join('.claude', 'commands', 'eha', `eha-${workflow.commandName}.md`),
-          content: renderClaudeCommand(workflow, {
-            contractPath: bundledSources.contractPath,
-            workflowPath: bundledSources.workflowPaths[workflow.repoRelativePath],
-          }),
+          content: buildClaudeCommandFile(workflow),
         });
       }
-
       files.push({
         relativePath: path.join('.claude', 'commands', 'eha', 'README.md'),
-        content:
-          '# Generated EHA Claude commands\n\nThese files are generated by `eha install` from the canonical workflow registry.\n',
+        content: `# EHA Claude commands\n\nGenerated by \`eha init\`. Use \`/eha-bootstrap\`, \`/eha-refresh\`, \`/eha-parity\`, or \`/eha-discuss\` in Claude.\n`,
       });
-
+      
+      for (const skill of skills) {
+        files.push({
+          relativePath: path.join('.claude', 'skills', `eha-${skill.commandName}.md`),
+          content: buildClaudeSkillFile(skill),
+        });
+      }
+      
+      files.push({
+        relativePath: path.join('.claude', 'rules', 'eha-agent-rules.md'),
+        content: buildClaudeRuleFile(),
+      });
+      
       return files;
     },
   },
   copilot: {
     id: 'copilot',
     name: 'GitHub Copilot',
-    supportTier: 'guided',
-    description: 'Repo-local Copilot instruction projection under .github/instructions/',
-    generateFiles(rootDir, workflows, bundledSources) {
-      return [
-        {
-          relativePath: path.join('.github', 'instructions', 'eha-workflows.instructions.md'),
-          content: renderCopilotInstructions(workflows, bundledSources),
-        },
-      ];
+    description: 'Generates .github/prompts/ reusable prompt files, skills, and always-on instruction rules',
+    generateFiles(rootDir, workflows, skills) {
+      const files = [];
+      for (const workflow of workflows) {
+        files.push({
+          relativePath: path.join('.github', 'prompts', `eha-${workflow.commandName}.prompt.md`),
+          content: buildCopilotPromptFile(workflow),
+        });
+      }
+      files.push({
+        relativePath: path.join('.github', 'instructions', 'eha-workflows.instructions.md'),
+        content: buildCopilotInstructionsFile(workflows),
+      });
+      
+      for (const skill of skills) {
+        files.push({
+          relativePath: path.join('.github', 'prompts', 'skills', `eha-${skill.commandName}.prompt.md`),
+          content: buildCopilotSkillFile(skill),
+        });
+      }
+      
+      files.push({
+        relativePath: path.join('.github', 'instructions', 'eha-agent-rules.instructions.md'),
+        content: buildCopilotRuleFile(),
+      });
+      
+      return files;
+    },
+  },
+  antigravity: {
+    id: 'antigravity',
+    name: 'Antigravity',
+    description: 'Generates Antigravity-compatible skills in .agents/skills/',
+    generateFiles(rootDir, workflows, skills) {
+      const files = [];
+      for (const workflow of workflows) {
+        files.push({
+          relativePath: path.join('.agents', 'skills', `eha-${workflow.commandName}`, 'SKILL.md'),
+          content: buildAntigravityCommandFile(workflow),
+        });
+      }
+      files.push({
+        relativePath: path.join('.agents', 'commands', 'eha', 'README.md'),
+        content: `# EHA Antigravity commands\n\nGenerated by \`eha init\`. Call the generated skills directly.\n`,
+      });
+      
+      for (const skill of skills) {
+        files.push({
+          relativePath: path.join('.agents', 'skills', `eha-${skill.commandName}`, 'SKILL.md'),
+          content: buildAntigravitySkillFile(skill),
+        });
+      }
+      
+      files.push({
+        relativePath: path.join('.agents', 'skills', 'eha-agent-rules', 'SKILL.md'),
+        content: buildAntigravityRuleFile(),
+      });
+      
+      return files;
     },
   },
 };
 
-function getRuntimeAdapter(runtimeId) {
-  const adapter = RUNTIME_ADAPTERS[String(runtimeId).trim().toLowerCase()];
+function getRuntimeAdapter(agentId) {
+  const adapter = RUNTIME_ADAPTERS[String(agentId).trim().toLowerCase()];
   if (!adapter) {
-    throw new Error(`Unsupported runtime: ${runtimeId}`);
+    throw new Error(`Unsupported agent: ${agentId}. Choose one of: ${Object.keys(RUNTIME_ADAPTERS).join(', ')}.`);
   }
   return adapter;
 }
 
 function listSupportedRuntimes() {
-  return Object.values(RUNTIME_ADAPTERS).map((runtime) => ({
-    id: runtime.id,
-    supportTier: runtime.supportTier,
-    description: runtime.description,
+  return Object.values(RUNTIME_ADAPTERS).map((a) => ({
+    id: a.id,
+    name: a.name,
+    description: a.description,
   }));
 }
 

package/src/engine/skill-registry.js

@@ -0,0 +1,67 @@
+const path = require('node:path');
+
+const SKILL_DEFINITIONS = {
+  'system-analysis': {
+    id: 'system-analysis',
+    commandName: 'system-analysis',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'architecture', 'system-analysis', 'SKILL.md'),
+  },
+  'api-design': {
+    id: 'api-design',
+    commandName: 'api-design',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'architecture', 'api-design', 'SKILL.md'),
+  },
+  'db-schema-design': {
+    id: 'db-schema-design',
+    commandName: 'db-schema-design',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'architecture', 'db-schema-design', 'SKILL.md'),
+  },
+  'test-authoring': {
+    id: 'test-authoring',
+    commandName: 'test-authoring',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'engineering', 'test-authoring', 'SKILL.md'),
+  },
+  'ui-ux-implementation': {
+    id: 'ui-ux-implementation',
+    commandName: 'ui-ux-implementation',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'engineering', 'ui-ux-implementation', 'SKILL.md'),
+  },
+  'refactor-specialist': {
+    id: 'refactor-specialist',
+    commandName: 'refactor-specialist',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'engineering', 'refactor-specialist', 'SKILL.md'),
+  },
+  'security-audit': {
+    id: 'security-audit',
+    commandName: 'security-audit',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'auditing', 'security-audit', 'SKILL.md'),
+  },
+  'full-verification': {
+    id: 'full-verification',
+    commandName: 'full-verification',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'auditing', 'full-verification', 'SKILL.md'),
+  },
+  'parity': {
+    id: 'parity',
+    commandName: 'parity',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'auditing', 'parity', 'SKILL.md'),
+  },
+  'ci-cd-authoring': {
+    id: 'ci-cd-authoring',
+    commandName: 'ci-cd-authoring',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'operations', 'ci-cd-authoring', 'SKILL.md'),
+  },
+  'observability-setup': {
+    id: 'observability-setup',
+    commandName: 'observability-setup',
+    repoRelativePath: path.join('docs', 'templates', 'skills', 'operations', 'observability-setup', 'SKILL.md'),
+  },
+};
+
+function listSkills() {
+  return Object.values(SKILL_DEFINITIONS).map((skill) => ({ ...skill }));
+}
+
+module.exports = {
+  listSkills,
+};

package/src/engine/state.js

@@ -1,8 +1,11 @@
 const fs = require('node:fs');
 const path = require('node:path');
 
-const CONTRACT_PATH = path.join('docs', 'eyehateagent-contract.md');
-const ROOT_MARKERS = [CONTRACT_PATH, 'package.json', '.git'];
+const ROOT_MARKERS = ['package.json', '.git'];
+const DEFAULT_CONFIG = {
+  configVersion: 1,
+  agent: null,
+};
 
 function ensureDir(dirPath) {
   fs.mkdirSync(dirPath, { recursive: true });
@@ -62,14 +65,31 @@ function getEnginePaths(rootDir) {
   const ehaDir = path.join(rootDir, '.eha');
   return {
     ehaDir,
-    stateDir: path.join(ehaDir, 'state'),
-    generatedDir: path.join(ehaDir, 'generated'),
-    manifestPath: path.join(ehaDir, 'generated', 'install-manifest.json'),
-    lastRunPath: path.join(ehaDir, 'state', 'last-run.json'),
-    lastPromptPath: path.join(ehaDir, 'state', 'last-prompt.md'),
+    configPath: path.join(ehaDir, 'config.json'),
+    manifestPath: path.join(ehaDir, 'manifest.json'),
+  };
+}
+
+function normalizeConfig(config) {
+  const candidate = config && typeof config === 'object' ? config : {};
+  return {
+    configVersion: Number.isInteger(candidate.configVersion) ? candidate.configVersion : DEFAULT_CONFIG.configVersion,
+    agent: candidate.agent ? String(candidate.agent).trim().toLowerCase() : null,
   };
 }
 
+function readConfig(rootDir) {
+  const { configPath } = getEnginePaths(rootDir);
+  return normalizeConfig(readJsonIfExists(configPath) || DEFAULT_CONFIG);
+}
+
+function writeConfig(rootDir, value) {
+  const { configPath } = getEnginePaths(rootDir);
+  const normalizedConfig = normalizeConfig(value);
+  writeJson(configPath, normalizedConfig);
+  return normalizedConfig;
+}
+
 function removeFileIfExists(filePath) {
   if (fs.existsSync(filePath)) {
     fs.unlinkSync(filePath);
@@ -101,9 +121,11 @@ module.exports = {
   getBundledAssetPath,
   getEnginePaths,
   getPackageRoot,
+  readConfig,
   readJsonIfExists,
   removeEmptyParents,
   removeFileIfExists,
+  writeConfig,
   writeJson,
   writeText,
 };

package/src/engine/workflow-registry.js

@@ -4,45 +4,36 @@ const WORKFLOW_DEFINITIONS = {
   bootstrap: {
     id: 'bootstrap',
     commandName: 'bootstrap',
-    description: 'Prepare the bootstrap workflow for creating project docs',
-    repoRelativePath: path.join('docs', 'vibes', 'reusable-prompts', '00-project-docs-bootstrap.md'),
+    description: 'Generate the initial project documentation set',
+    repoRelativePath: path.join('docs', 'templates', 'reusable-prompts', '00-project-docs-bootstrap.md'),
   },
   refresh: {
     id: 'refresh',
     commandName: 'refresh',
-    description: 'Prepare the refresh workflow for owner-doc updates',
-    repoRelativePath: path.join('docs', 'vibes', 'reusable-prompts', '00-project-docs-refresh.md'),
+    description: 'Refresh project docs after a change in scope, stack, or behavior',
+    repoRelativePath: path.join('docs', 'templates', 'reusable-prompts', '00-project-docs-refresh.md'),
   },
   parity: {
     id: 'parity',
     commandName: 'parity',
-    description: 'Prepare the parity workflow for ownership and drift checks',
-    repoRelativePath: path.join('docs', 'vibes', 'reusable-prompts', '00-project-docs-parity.md'),
+    description: 'Audit for documentation drift and ownership mismatches',
+    repoRelativePath: path.join('docs', 'templates', 'reusable-prompts', '00-project-docs-parity.md'),
   },
   discuss: {
     id: 'discuss',
     commandName: 'discuss',
-    description: 'Prepare the spec-discussion workflow',
-    repoRelativePath: path.join('docs', 'vibes', 'reusable-prompts', '02-sdd-discuss.md'),
+    description: 'Brainstorm and finalize a feature spec before implementation',
+    repoRelativePath: path.join('docs', 'templates', 'reusable-prompts', '02-sdd-discuss.md'),
   },
-  execute: {
-    id: 'execute',
-    commandName: 'execute',
-    description: 'Prepare the spec-driven execution workflow',
-    repoRelativePath: path.join('docs', 'vibes', 'reusable-prompts', '01-sdd-execute.md'),
-  },
-  verify: {
-    id: 'verify',
-    commandName: 'verify',
-    description: 'Prepare the verification workflow',
-    repoRelativePath: path.join('docs', 'vibes', 'reusable-prompts', '00-project-docs-parity.md'),
-    capabilityNote: 'A dedicated verify workflow does not exist yet; verify currently routes to the parity workflow.',
+  'sdd-execute': {
+    id: 'sdd-execute',
+    commandName: 'sdd-execute',
+    description: 'Translate a project specification into tested, working code',
+    repoRelativePath: path.join('docs', 'templates', 'reusable-prompts', '01-sdd-execute.md'),
   },
 };
 
-const WORKFLOW_ALIASES = {
-  init: 'bootstrap',
-};
+const WORKFLOW_ALIASES = {};
 
 function normalizeWorkflowId(input) {
   if (!input) {

package/.claude/commands/eha/README.md

@@ -1,3 +0,0 @@
-# Generated EHA Claude commands
-
-These files are generated by `eha install` from the canonical workflow registry.

package/.claude/commands/eha/eha-bootstrap.md

@@ -1,9 +0,0 @@
----
-description: "Run the EHA bootstrap workflow"
----
-
-Read `docs/eyehateagent-contract.md` first.
-
-Execute `docs/vibes/reusable-prompts/00-project-docs-bootstrap.md`.
-
-If the user provides additional context, apply it while preserving the workflow's output contract and the owning-doc rules in `docs/project-docs/`.

package/.claude/commands/eha/eha-discuss.md

@@ -1,9 +0,0 @@
----
-description: "Run the EHA discuss workflow"
----
-
-Read `docs/eyehateagent-contract.md` first.
-
-Execute `docs/vibes/reusable-prompts/02-sdd-discuss.md`.
-
-If the user provides additional context, apply it while preserving the workflow's output contract and the owning-doc rules in `docs/project-docs/`.

package/.claude/commands/eha/eha-execute.md

@@ -1,9 +0,0 @@
----
-description: "Run the EHA execute workflow"
----
-
-Read `docs/eyehateagent-contract.md` first.
-
-Execute `docs/vibes/reusable-prompts/01-sdd-execute.md`.
-
-If the user provides additional context, apply it while preserving the workflow's output contract and the owning-doc rules in `docs/project-docs/`.

package/.claude/commands/eha/eha-parity.md

@@ -1,9 +0,0 @@
----
-description: "Run the EHA parity workflow"
----
-
-Read `docs/eyehateagent-contract.md` first.
-
-Execute `docs/vibes/reusable-prompts/00-project-docs-parity.md`.
-
-If the user provides additional context, apply it while preserving the workflow's output contract and the owning-doc rules in `docs/project-docs/`.

package/.claude/commands/eha/eha-refresh.md

@@ -1,9 +0,0 @@
----
-description: "Run the EHA refresh workflow"
----
-
-Read `docs/eyehateagent-contract.md` first.
-
-Execute `docs/vibes/reusable-prompts/00-project-docs-refresh.md`.
-
-If the user provides additional context, apply it while preserving the workflow's output contract and the owning-doc rules in `docs/project-docs/`.

package/.claude/commands/eha/eha-verify.md

@@ -1,9 +0,0 @@
----
-description: "Run the EHA verify workflow"
----
-
-Read `docs/eyehateagent-contract.md` first.
-
-Execute `docs/vibes/reusable-prompts/00-project-docs-parity.md`.
-
-If the user provides additional context, apply it while preserving the workflow's output contract and the owning-doc rules in `docs/project-docs/`.