@sallmarta/eye-hate-agent 1.0.0

package/src/engine/runtime-adapters.js

@@ -0,0 +1,106 @@
+const path = require('node:path');
+
+function renderClaudeCommand(workflow, sourcePaths) {
+  return `---
+description: "Run the EHA ${workflow.id} workflow"
+---
+
+Read \`${sourcePaths.contractPath}\` first.
+
+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/\`.
+`;
+}
+
+function renderCopilotInstructions(workflows, bundledSources) {
+  const workflowTable = workflows
+    .map(
+      (workflow) =>
+        `- \`${workflow.commandName}\` -> \`${bundledSources.workflowPaths[workflow.repoRelativePath]}\`${workflow.capabilityNote ? ` (${workflow.capabilityNote})` : ''}`,
+    )
+    .join('\n');
+
+  return `---
+description: "Generated EHA workflow routing for GitHub Copilot"
+applyTo: "**"
+---
+
+# EHA Engine Workflows
+
+When a user asks to run an EHA workflow, prefer the canonical reusable prompt file listed below and preserve its output contract.
+
+${workflowTable}
+
+## Runtime support
+
+- 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
+`;
+}
+
+const RUNTIME_ADAPTERS = {
+  claude: {
+    id: 'claude',
+    name: 'Claude',
+    supportTier: 'full',
+    description: 'Repo-local Claude command projection under .claude/commands/eha/',
+    generateFiles(rootDir, workflows, bundledSources) {
+      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],
+          }),
+        });
+      }
+
+      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',
+      });
+
+      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),
+        },
+      ];
+    },
+  },
+};
+
+function getRuntimeAdapter(runtimeId) {
+  const adapter = RUNTIME_ADAPTERS[String(runtimeId).trim().toLowerCase()];
+  if (!adapter) {
+    throw new Error(`Unsupported runtime: ${runtimeId}`);
+  }
+  return adapter;
+}
+
+function listSupportedRuntimes() {
+  return Object.values(RUNTIME_ADAPTERS).map((runtime) => ({
+    id: runtime.id,
+    supportTier: runtime.supportTier,
+    description: runtime.description,
+  }));
+}
+
+module.exports = {
+  getRuntimeAdapter,
+  listSupportedRuntimes,
+};

package/src/engine/state.js

@@ -0,0 +1,109 @@
+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'];
+
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function readJsonIfExists(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+
+function writeJson(filePath, value) {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+
+function writeText(filePath, value) {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, value);
+}
+
+function fileExists(rootDir, relativePath) {
+  return fs.existsSync(path.join(rootDir, relativePath));
+}
+
+function getPackageRoot() {
+  return path.resolve(__dirname, '..', '..');
+}
+
+function getBundledAssetPath(repoRelativePath) {
+  return path.join(getPackageRoot(), repoRelativePath);
+}
+
+function findRepoRoot(startDir = process.cwd()) {
+  let currentDir = path.resolve(startDir);
+  const initialDir = currentDir;
+
+  while (true) {
+    if (ROOT_MARKERS.some((markerPath) => fileExists(currentDir, markerPath))) {
+      return currentDir;
+    }
+
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      throw new Error(
+        `Could not find a project root from ${initialDir}. Expected one of: ${ROOT_MARKERS.join(', ')}.`,
+      );
+    }
+
+    currentDir = parentDir;
+  }
+}
+
+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'),
+  };
+}
+
+function removeFileIfExists(filePath) {
+  if (fs.existsSync(filePath)) {
+    fs.unlinkSync(filePath);
+  }
+}
+
+function removeEmptyParents(startPath, stopPath) {
+  let currentPath = path.resolve(startPath);
+  const normalizedStop = path.resolve(stopPath);
+
+  while (currentPath.startsWith(normalizedStop) && currentPath !== normalizedStop) {
+    if (!fs.existsSync(currentPath)) {
+      currentPath = path.dirname(currentPath);
+      continue;
+    }
+
+    if (fs.readdirSync(currentPath).length > 0) {
+      break;
+    }
+
+    fs.rmdirSync(currentPath);
+    currentPath = path.dirname(currentPath);
+  }
+}
+
+module.exports = {
+  ensureDir,
+  findRepoRoot,
+  getBundledAssetPath,
+  getEnginePaths,
+  getPackageRoot,
+  readJsonIfExists,
+  removeEmptyParents,
+  removeFileIfExists,
+  writeJson,
+  writeText,
+};

package/src/engine/workflow-registry.js

@@ -0,0 +1,75 @@
+const path = require('node:path');
+
+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'),
+  },
+  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'),
+  },
+  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'),
+  },
+  discuss: {
+    id: 'discuss',
+    commandName: 'discuss',
+    description: 'Prepare the spec-discussion workflow',
+    repoRelativePath: path.join('docs', 'vibes', '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.',
+  },
+};
+
+const WORKFLOW_ALIASES = {
+  init: 'bootstrap',
+};
+
+function normalizeWorkflowId(input) {
+  if (!input) {
+    throw new Error('Workflow id is required');
+  }
+
+  const key = String(input).trim().toLowerCase();
+  return WORKFLOW_ALIASES[key] || key;
+}
+
+function getWorkflow(workflowId) {
+  const normalizedId = normalizeWorkflowId(workflowId);
+  const workflow = WORKFLOW_DEFINITIONS[normalizedId];
+
+  if (!workflow) {
+    throw new Error(`Unknown workflow: ${workflowId}`);
+  }
+
+  return { ...workflow };
+}
+
+function listWorkflows() {
+  return Object.values(WORKFLOW_DEFINITIONS).map((workflow) => ({ ...workflow }));
+}
+
+module.exports = {
+  getWorkflow,
+  listWorkflows,
+  normalizeWorkflowId,
+};