echelon-dev 1.0.0

package/lib/session-recorder.js

@@ -0,0 +1,284 @@
+/**
+ * Session Recorder - Captures EVERYTHING from AI pair programming sessions
+ *
+ * Saves full prompts, responses, code changes (git diffs), timing data,
+ * tools used, and workspace state for future model training.
+ *
+ * Output: ~/.echelon/sessions/{timestamp}-{task-slug}.json
+ *
+ * ZERO EXTERNAL DEPENDENCIES
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const SESSIONS_DIR = path.join(os.homedir(), '.echelon', 'sessions');
+
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+function slugify(text) {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '')
+    .slice(0, 60);
+}
+
+function safeExec(command, cwd) {
+  try {
+    return execSync(command, { cwd, encoding: 'utf8', timeout: 10000 }).trim();
+  } catch (e) {
+    return null;
+  }
+}
+
+function getGitState(workspace) {
+  const isGit = fs.existsSync(path.join(workspace, '.git'));
+  if (!isGit) return null;
+
+  return {
+    branch: safeExec('git rev-parse --abbrev-ref HEAD', workspace),
+    commit: safeExec('git rev-parse --short HEAD', workspace),
+    dirty: safeExec('git status --porcelain', workspace) || '',
+    diff: safeExec('git diff', workspace) || '',
+    stagedDiff: safeExec('git diff --cached', workspace) || ''
+  };
+}
+
+function getFilesSnapshot(workspace) {
+  // Quick snapshot of file modification times for key files
+  try {
+    const output = safeExec(
+      'find . -maxdepth 4 -type f \\( -name "*.js" -o -name "*.ts" -o -name "*.tsx" -o -name "*.jsx" -o -name "*.java" -o -name "*.py" -o -name "*.go" -o -name "*.rs" -o -name "*.json" -o -name "*.yaml" -o -name "*.yml" \\) -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/target/*" -not -path "*/dist/*" -not -path "*/build/*" -printf "%T@ %p\\n" 2>/dev/null | sort -rn | head -50',
+      workspace
+    );
+    // Fallback for macOS (no -printf)
+    if (!output) {
+      const macOutput = safeExec(
+        'find . -maxdepth 4 -type f \\( -name "*.js" -o -name "*.ts" -o -name "*.tsx" -o -name "*.jsx" -o -name "*.java" -o -name "*.py" -o -name "*.go" \\) -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/target/*" | head -50',
+        workspace
+      );
+      return macOutput ? macOutput.split('\n').filter(Boolean) : [];
+    }
+    return output ? output.split('\n').filter(Boolean) : [];
+  } catch (e) {
+    return [];
+  }
+}
+
+class SessionRecorder {
+  constructor(options = {}) {
+    this.sessionId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    this.task = options.task || '';
+    this.workspace = options.workspace || process.cwd();
+    this.agents = options.agents || [];
+    this.aiProvider = options.aiProvider || 'unknown';
+    this.startedAt = new Date().toISOString();
+    this.steps = [];
+    this.metadata = {};
+
+    // Capture initial state
+    this.initialGitState = getGitState(this.workspace);
+    this.initialFiles = getFilesSnapshot(this.workspace);
+
+    ensureDir(SESSIONS_DIR);
+  }
+
+  /**
+   * Record a step starting
+   */
+  startStep(stepKey, agentId, instruction) {
+    const step = {
+      stepKey,
+      agentId,
+      agentName: agentId,
+      instruction,
+      prompt: null,       // Full prompt sent to AI (set later)
+      response: null,     // Full AI response (set later)
+      startedAt: new Date().toISOString(),
+      completedAt: null,
+      durationMs: null,
+      gitDiffBefore: safeExec('git diff', this.workspace) || '',
+      gitDiffAfter: null,
+      error: null
+    };
+    this.steps.push(step);
+    return this.steps.length - 1;
+  }
+
+  /**
+   * Record the full prompt sent to AI
+   */
+  setStepPrompt(stepIndex, prompt) {
+    if (this.steps[stepIndex]) {
+      this.steps[stepIndex].prompt = prompt;
+    }
+  }
+
+  /**
+   * Record the full AI response
+   */
+  completeStep(stepIndex, response, error) {
+    const step = this.steps[stepIndex];
+    if (!step) return;
+
+    step.response = response;
+    step.completedAt = new Date().toISOString();
+    step.durationMs = new Date(step.completedAt) - new Date(step.startedAt);
+    step.gitDiffAfter = safeExec('git diff', this.workspace) || '';
+    step.error = error || null;
+
+    // Compute what changed in this step
+    if (step.gitDiffBefore !== step.gitDiffAfter) {
+      step.codeChanged = true;
+      step.diffDelta = step.gitDiffAfter.length - step.gitDiffBefore.length;
+    } else {
+      step.codeChanged = false;
+      step.diffDelta = 0;
+    }
+  }
+
+  /**
+   * Add arbitrary metadata
+   */
+  addMetadata(key, value) {
+    this.metadata[key] = value;
+  }
+
+  /**
+   * Finalize and save the session recording
+   */
+  save() {
+    const finalGitState = getGitState(this.workspace);
+    const completedAt = new Date().toISOString();
+    const totalDurationMs = new Date(completedAt) - new Date(this.startedAt);
+
+    const record = {
+      // Session identity
+      sessionId: this.sessionId,
+      version: '1.0.0',
+
+      // What happened
+      task: this.task,
+      workspace: this.workspace,
+      agents: this.agents,
+      aiProvider: this.aiProvider,
+
+      // Timing
+      startedAt: this.startedAt,
+      completedAt,
+      totalDurationMs,
+
+      // Steps (the meat — prompts, responses, diffs)
+      steps: this.steps,
+      totalSteps: this.steps.length,
+      completedSteps: this.steps.filter(s => s.completedAt && !s.error).length,
+      failedSteps: this.steps.filter(s => s.error).length,
+
+      // Git state
+      git: {
+        initial: this.initialGitState,
+        final: finalGitState,
+        totalDiff: finalGitState
+          ? safeExec('git diff ' + (this.initialGitState?.commit || 'HEAD'), this.workspace)
+          : null
+      },
+
+      // Environment
+      environment: {
+        platform: os.platform(),
+        arch: os.arch(),
+        nodeVersion: process.version,
+        hostname: os.hostname()
+      },
+
+      // Extra metadata
+      metadata: this.metadata
+    };
+
+    // Write to file
+    const slug = slugify(this.task);
+    const filename = `${this.sessionId}-${slug}.json`;
+    const filepath = path.join(SESSIONS_DIR, filename);
+
+    fs.writeFileSync(filepath, JSON.stringify(record, null, 2), 'utf8');
+
+    // Also write a lightweight index entry
+    this._updateIndex(filepath, record);
+
+    return filepath;
+  }
+
+  /**
+   * Maintain a lightweight session index for quick lookups
+   */
+  _updateIndex(filepath, record) {
+    const indexPath = path.join(SESSIONS_DIR, 'index.jsonl');
+    const entry = {
+      sessionId: record.sessionId,
+      task: record.task,
+      workspace: record.workspace,
+      agents: record.agents,
+      startedAt: record.startedAt,
+      totalDurationMs: record.totalDurationMs,
+      totalSteps: record.totalSteps,
+      completedSteps: record.completedSteps,
+      file: path.basename(filepath)
+    };
+
+    try {
+      fs.appendFileSync(indexPath, JSON.stringify(entry) + '\n', 'utf8');
+    } catch (e) {
+      // Non-critical — index is a convenience
+    }
+  }
+}
+
+/**
+ * List recent sessions
+ */
+function listSessions(limit = 20) {
+  const indexPath = path.join(SESSIONS_DIR, 'index.jsonl');
+  if (!fs.existsSync(indexPath)) return [];
+
+  try {
+    const lines = fs.readFileSync(indexPath, 'utf8')
+      .split('\n')
+      .filter(Boolean)
+      .map(line => JSON.parse(line));
+
+    return lines.slice(-limit).reverse();
+  } catch (e) {
+    return [];
+  }
+}
+
+/**
+ * Load a full session recording
+ */
+function loadSession(sessionId) {
+  ensureDir(SESSIONS_DIR);
+
+  try {
+    const files = fs.readdirSync(SESSIONS_DIR).filter(f => f.startsWith(sessionId));
+    if (files.length === 0) return null;
+
+    const filepath = path.join(SESSIONS_DIR, files[0]);
+    return JSON.parse(fs.readFileSync(filepath, 'utf8'));
+  } catch (e) {
+    return null;
+  }
+}
+
+module.exports = {
+  SessionRecorder,
+  listSessions,
+  loadSession,
+  SESSIONS_DIR
+};

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "echelon-dev",
+  "version": "1.0.0",
+  "description": "Multi-agent pair programming with Knoxis, Solan, and Astrahelm - your AI dev team on qig.ai",
+  "bin": {
+    "echelon-dev": "./bin/echelon-dev.js"
+  },
+  "keywords": ["echelon", "pair-programming", "claude", "qig", "multi-agent", "knoxis", "solan", "astrahelm"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "lib/"
+  ]
+}