@xelth/eck-snapshot 4.0.0 → 4.2.0

package/src/services/gptService.js

@@ -1,302 +0,0 @@
-import { execa } from 'execa';
-import fs from 'fs/promises';
-import path from 'path';
-import pRetry from 'p-retry';
-import ora from 'ora';
-import { loadProjectEckManifest } from '../utils/fileUtils.js';
-import { initiateLogin } from './authService.js';
-import which from 'which';
-
-const SYSTEM_PROMPT = 'You are a Coder agent. Apply code changes per JSON spec. Respond only in JSON: {success: bool, changes: array, errors: array, post_steps: object}';
-
-class AuthError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = 'AuthError';
-  }
-}
-
-/**
- * Checks if the codex CLI tool is available in the system's PATH.
- * Throws an error if not found.
- */
-async function ensureCodexCliExists() {
-  try {
-    await which('codex');
-  } catch (error) {
-    throw new Error('The `codex` CLI tool is not installed or not in your PATH. Please install it from https://github.com/openai/codex to use this command.');
-  }
-}
-
-/**
- * Delegates an apply_code_changes payload to the codex CLI with auto-login.
- * @param {string|object} payload - JSON string or object payload to forward to the agent.
- * @param {{ verbose?: boolean, model?: string, reasoning?: string }} [options]
- * @returns {Promise<object>}
- */
-export async function ask(payload, options = {}) {
-  const { verbose = false, model = 'gpt-5-codex', reasoning = 'high' } = options;
-  await ensureCodexCliExists();
-
-  const run = async () => {
-    const spinner = verbose ? null : ora('Sending payload to Codex agent...').start();
-    try {
-      const payloadObject = await parsePayload(payload);
-      const manifest = await loadProjectEckManifest(process.cwd());
-      const userPrompt = buildUserPrompt(payloadObject, manifest);
-      const promptInput = `${SYSTEM_PROMPT}\n\n${userPrompt}`;
-
-      const args = [
-        'exec',
-        // Use full-auto mode to prevent interactive prompts from the agent,
-        // as this service is designed for non-interactive delegation.
-        '--full-auto',
-        '--model', model,
-        '-c', `model_reasoning_effort=${reasoning}`
-      ];
-
-      debug(verbose, `Executing: codex ${args.join(' ')} <stdin>`);
-
-      const cliResult = await execa('codex', args, {
-        cwd: process.cwd(),
-        timeout: 300000, // 5-minute timeout
-        input: promptInput // Stream large prompts via stdin to avoid argv limits
-      });
-
-      const output = cliResult?.stdout?.trim();
-      if (!output) {
-        throw new Error('codex CLI returned empty response');
-      }
-
-      const parsed = extractFinalJson(output);
-      if (parsed) {
-        if (parsed.post_steps || parsed.post_execution_steps) {
-          const postSteps = parsed.post_steps || parsed.post_execution_steps;
-          await handlePostExecutionSteps(postSteps, payloadObject);
-          parsed.mcp_feedback = postSteps?.mcp_feedback || null;
-        }
-        spinner?.succeed('Codex agent completed the task.');
-        return parsed;
-      }
-
-      // If parsing fails, surface the raw response text for upstream handling.
-      spinner?.succeed('Codex agent completed the task.');
-      return { success: true, changes: [], errors: [], response_text: output };
-
-    } catch (error) {
-        spinner?.fail('Codex execution failed.');
-        handleCliError(error); // This will throw a specific error type
-    }
-  };
-
-  return pRetry(run, {
-    retries: 1, // Only retry once after a successful login
-    minTimeout: 0,
-    onFailedAttempt: async (error) => {
-      if (error.name === 'AuthError') {
-        await initiateLogin();
-      } else {
-        throw error; // Don't retry for other errors, fail immediately
-      }
-    }
-  });
-}
-
-
-async function parsePayload(payload) {
-  if (typeof payload === 'string') {
-    try {
-      return JSON.parse(payload);
-    } catch (error) {
-      throw new Error(`Failed to parse payload JSON: ${error.message}`);
-    }
-  }
-  if (typeof payload === 'object' && payload !== null) {
-    return payload;
-  }
-  throw new Error('Invalid payload type. Expected JSON string or object.');
-}
-
-function buildUserPrompt(payloadObject, manifest) {
-  const payloadString = JSON.stringify(payloadObject);
-  if (!manifest) {
-    return payloadString;
-  }
-
-  const sections = [];
-  if (manifest.context) {
-    sections.push('## .eck Context\n' + manifest.context);
-  }
-  if (manifest.operations) {
-    sections.push('## .eck Operations\n' + manifest.operations);
-  }
-  if (manifest.journal) {
-    sections.push('## .eck Journal\n' + manifest.journal);
-  }
-  if (manifest.environment && Object.keys(manifest.environment).length > 0) {
-    sections.push('## .eck Environment\n' + JSON.stringify(manifest.environment, null, 2));
-  }
-
-  if (sections.length === 0) {
-    return payloadString;
-  }
-
-  return `${payloadString}\n\n# Project Context\n${sections.join('\n\n')}`;
-}
-
-function debug(verbose, message) {
-  if (verbose) {
-    console.log(`[ask-gpt] ${message}`);
-  }
-}
-
-function extractFinalJson(text) {
-  const trimmed = text?.trim();
-  if (!trimmed) {
-    return null;
-  }
-
-  try {
-    return JSON.parse(trimmed);
-  } catch (error) {
-    // Continue with fallback parsing when logs precede the JSON payload.
-  }
-
-  const fencedMatch = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
-  if (fencedMatch && fencedMatch[1]) {
-    const fencedContent = fencedMatch[1].trim();
-    try {
-      return JSON.parse(fencedContent);
-    } catch (error) {
-      // Ignore and fall through to final brace search.
-    }
-  }
-
-  const lastBraceIndex = trimmed.lastIndexOf('{');
-  if (lastBraceIndex === -1) {
-    return null;
-  }
-
-  const jsonCandidate = trimmed.slice(lastBraceIndex);
-  try {
-    return JSON.parse(jsonCandidate);
-  } catch (error) {
-    return null;
-  }
-}
-
-function handleCliError(error) {
-  const combined = `${error?.message || ''} ${error?.stderr || ''} ${error?.stdout || ''}`.toLowerCase();
-  // Check for text that `codex` outputs when auth is missing.
-  if (combined.includes('authentication is required') || combined.includes('please run `codex login`')) {
-    const authError = new Error('Codex authentication is required. Attempting to log in.');
-    authError.name = 'AuthError';
-    throw authError;
-  }
-
-  throw new Error(`codex CLI failed: ${error.stderr || error.message}`);
-}
-
-async function handlePostExecutionSteps(postSteps, payloadObject) {
-  if (!postSteps || typeof postSteps !== 'object') {
-    return;
-  }
-
-  if (postSteps.journal_entry) {
-    await applyJournalEntry(postSteps.journal_entry, payloadObject);
-  }
-
-  if (postSteps.mcp_feedback) {
-    logMcpFeedback(postSteps.mcp_feedback);
-  }
-}
-
-async function applyJournalEntry(entry, payloadObject) {
-  const journalEntry = normalizeJournalEntry(entry);
-  const journalPath = path.join(process.cwd(), '.eck', 'JOURNAL.md');
-
-  await fs.mkdir(path.dirname(journalPath), { recursive: true });
-
-  let existing = '';
-  try {
-    existing = await fs.readFile(journalPath, 'utf-8');
-  } catch (error) {
-    if (error.code !== 'ENOENT') {
-      throw new Error(`Failed to read JOURNAL.md: ${error.message}`);
-    }
-  }
-
-  const taskId = payloadObject?.task_id || payloadObject?.payload?.task_id || journalEntry.task_id || 'ask-gpt';
-  const isoDate = new Date().toISOString();
-
-  const frontmatter = [
-    '---',
-    `task_id: ${taskId}`,
-    `date: ${isoDate}`,
-    `type: ${journalEntry.type}`,
-    `scope: ${journalEntry.scope}`,
-    '---',
-    ''
-  ].join('\n');
-
-  const summary = journalEntry.summary ? `## ${journalEntry.summary}\n` : '';
-  const details = journalEntry.details ? `${journalEntry.details}\n` : '';
-
-  const entryBlock = `${frontmatter}${summary ? `${summary}\n` : ''}${details}\n`;
-
-  const existingTrimmed = existing ? existing.replace(/^\n+/, '') : '';
-  const newContent = `${entryBlock}${existingTrimmed}`.replace(/\n{3,}/g, '\n\n');
-
-  await fs.writeFile(journalPath, newContent.trimEnd() + '\n');
-
-  await stageJournal(journalPath);
-  await commitJournal(journalEntry);
-}
-
-function normalizeJournalEntry(entry) {
-  return {
-    type: entry.type || 'chore',
-    scope: entry.scope || 'journal',
-    summary: entry.summary || 'Update journal entry',
-    details: entry.details || ''
-  };
-}
-
-async function stageJournal(journalPath) {
-  const relativePath = path.relative(process.cwd(), journalPath);
-  try {
-    await execa('git', ['add', relativePath], { cwd: process.cwd() });
-  } catch (error) {
-    throw new Error(`Failed to stage journal entry: ${error.message}`);
-  }
-}
-
-async function commitJournal(entry) {
-  const scopePart = entry.scope ? `(${entry.scope})` : '';
-  const summary = (entry.summary || 'Update journal entry').replace(/\s+/g, ' ').trim();
-  const commitMessage = `${entry.type}${scopePart}: ${summary}`;
-
-  try {
-    await execa('git', ['commit', '-m', commitMessage], { cwd: process.cwd() });
-  } catch (error) {
-    const text = `${error?.stderr || ''} ${error?.stdout || ''}`.toLowerCase();
-    if (text.includes('nothing to commit')) {
-      console.warn('Journal entry already committed or no changes to commit.');
-      return;
-    }
-    throw new Error(`Failed to commit journal entry: ${error.message}`);
-  }
-}
-
-function logMcpFeedback(feedback) {
-  if (!feedback) {
-    return;
-  }
-
-  const errors = Array.isArray(feedback.errors) ? feedback.errors : [];
-  if (!feedback.success || errors.length > 0) {
-    console.warn('MCP feedback indicates issues:', errors.length > 0 ? errors : feedback);
-  } else {
-    console.log('MCP feedback:', feedback);
-  }
-}

package/src/services/gptService.test.js

@@ -1,120 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-
-// Mock execa and which
-vi.mock('execa', () => ({ execa: vi.fn() }));
-vi.mock('which', () => ({ default: vi.fn() }));
-
-// Mock fs/promises for journal entries
-const mkdirMock = vi.fn();
-const readFileMock = vi.fn();
-const writeFileMock = vi.fn();
-const loadProjectEckManifestMock = vi.fn();
-vi.mock('fs/promises', () => ({
-  mkdir: mkdirMock,
-  readFile: readFileMock,
-  writeFile: writeFileMock
-}));
-vi.mock('../utils/fileUtils.js', () => ({
-  loadProjectEckManifest: loadProjectEckManifestMock
-}));
-
-// Mock p-retry to control retry behavior in tests
-vi.mock('p-retry', async (importOriginal) => {
-  const actual = await importOriginal();
-  return {
-    ...actual,
-    default: vi.fn(async (fn, options) => {
-      try {
-        return await fn();
-      } catch (error) {
-        if (options.onFailedAttempt) {
-          await options.onFailedAttempt(error);
-          // In a real scenario, p-retry would re-run fn. For testing, we simulate one retry.
-          if (error.name === 'AuthError') {
-             return await fn();
-          }
-        }
-        throw error;
-      }
-    })
-  };
-});
-
-// Mock the authService
-vi.mock('./authService.js', () => ({
-  initiateLogin: vi.fn()
-}));
-
-describe('gptService with codex CLI', () => {
-  let ask;
-  let execaMock;
-  let whichMock;
-  let initiateLoginMock;
-
-  beforeEach(async () => {
-    vi.clearAllMocks();
-
-    ({ execa: execaMock } = await import('execa'));
-    const which = (await import('which')).default;
-    whichMock = which;
-    ({ initiateLogin: initiateLoginMock } = await import('./authService.js'));
-    ({ ask } = await import('./gptService.js'));
-
-    whichMock.mockResolvedValue('/usr/bin/codex');
-    loadProjectEckManifestMock.mockResolvedValue(null);
-  });
-
-  it('should call codex CLI with correct arguments and parse final JSON from noisy output', async () => {
-    const codexLogs = '[2025-10-06 20:04:22] OpenAI Codex v0.42.0\nSome setup log...\n\n{"success": true, "changes": ["change1"], "errors": []}';
-    execaMock.mockResolvedValue({ stdout: codexLogs });
-
-    const payload = { objective: 'Test' };
-    const result = await ask(payload);
-
-    expect(result).toEqual({ success: true, changes: ['change1'], errors: [] });
-    expect(execaMock).toHaveBeenCalledWith('codex', expect.arrayContaining(['exec', '--full-auto', '--model']), expect.any(Object));
-    const [, , options] = execaMock.mock.calls[0];
-    expect(options.input).toContain(JSON.stringify(payload));
-  });
-
-  it('should trigger login flow on authentication error and retry', async () => {
-    const authError = new Error('Authentication is required. Please run `codex login`.');
-    authError.name = 'AuthError'; // Custom error name to trigger retry
-    authError.stderr = 'Authentication is required. Please run `codex login`.';
-
-    const successResponse = {
-      id: 'task2',
-      msg: {
-        type: 'task_complete',
-        last_agent_message: '{"success": true}'
-      }
-    };
-
-    // First call fails, second call (retry) succeeds
-    execaMock
-      .mockRejectedValueOnce(authError)
-      .mockResolvedValueOnce({ stdout: JSON.stringify(successResponse) });
-
-    initiateLoginMock.mockResolvedValue();
-
-    const result = await ask({ objective: 'Retry test' });
-
-    expect(result).toEqual({ success: true });
-    expect(initiateLoginMock).toHaveBeenCalledTimes(1);
-    expect(execaMock).toHaveBeenCalledTimes(2); // Initial call + retry
-  });
-
-  it('should throw if codex CLI is not found', async () => {
-    whichMock.mockRejectedValue(new Error('not found'));
-    await expect(ask({})).rejects.toThrow('The `codex` CLI tool is not installed');
-  });
-
-  it('should throw non-auth errors immediately without retry', async () => {
-    const otherError = new Error('Some other CLI error');
-    otherError.stderr = 'Something else went wrong';
-    execaMock.mockRejectedValueOnce(otherError);
-
-    await expect(ask({})).rejects.toThrow('codex CLI failed: Something else went wrong');
-    expect(initiateLoginMock).not.toHaveBeenCalled();
-  });
-});

package/src/templates/vectorMode.md

@@ -1,22 +0,0 @@
-# AI Instructions
-
-## 1. How to Read This Snapshot
-
-This document is a context-aware snapshot of the **{{repoName}}** software repository, generated by the `eck-snapshot` tool on **{{timestamp}}**. The content has been filtered based on vector similarity to your query: "{{userQuery}}"
-
-* **Source of Truth:** Treat this snapshot as the relevant source code for your specific task.
-* **Structure:** The file contains the full content of each relevant file, demarcated by `--- File: /path/to/file ---` headers.
-
----
-
-## 2. Your Core Operational Workflow
-
-You are the Project Manager and Solution Architect AI. Your primary goal is to translate user requests into technical plans and then generate precise commands for code-execution AI agents.
-
-### PROJECT OVERVIEW
-- **Project:** {{repoName}}
-- **User Query:** "{{userQuery}}"
-
-{{multiAgentSection}}
-
----