@agntk/agent-harness 0.1.1

package/dist/versioning-Z3XNE2Q2.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+
+import {
+  log
+} from "./chunk-BSKDOFRT.js";
+import "./chunk-ZZJOFKAT.js";
+
+// src/runtime/versioning.ts
+import { existsSync, writeFileSync } from "fs";
+import { join, relative } from "path";
+import { execSync } from "child_process";
+var HARNESS_GIT_AUTHOR_NAME = "agent-harness";
+var HARNESS_GIT_AUTHOR_EMAIL = "versioning@agent-harness.local";
+function gitExec(harnessDir, args) {
+  try {
+    const result = execSync(
+      `git -c user.name="${HARNESS_GIT_AUTHOR_NAME}" -c user.email="${HARNESS_GIT_AUTHOR_EMAIL}" ${args}`,
+      {
+        cwd: harnessDir,
+        encoding: "utf-8",
+        timeout: 1e4,
+        stdio: ["pipe", "pipe", "pipe"]
+      }
+    );
+    return result.trim();
+  } catch {
+    return null;
+  }
+}
+function isGitRepo(harnessDir) {
+  return gitExec(harnessDir, "rev-parse --is-inside-work-tree") === "true";
+}
+function initVersioning(harnessDir) {
+  if (isGitRepo(harnessDir)) return true;
+  const result = gitExec(harnessDir, "init");
+  if (result === null) {
+    log.warn("Failed to initialize git repository for versioning");
+    return false;
+  }
+  const gitignorePath = join(harnessDir, ".gitignore");
+  if (!existsSync(gitignorePath)) {
+    const gitignoreContent = [
+      "# Agent harness versioning",
+      "memory/sessions/",
+      "memory/metrics.json",
+      "memory/health.json",
+      "memory/costs.json",
+      "memory/rate-limits.json",
+      "memory/emotional-history.jsonl",
+      "memory/locks/",
+      ".installed/",
+      "archive/",
+      "node_modules/"
+    ].join("\n") + "\n";
+    writeFileSync(gitignorePath, gitignoreContent, "utf-8");
+  }
+  gitExec(harnessDir, "add -A");
+  gitExec(harnessDir, 'commit -m "Initial harness version" --allow-empty');
+  return true;
+}
+function snapshot(harnessDir, message, options) {
+  if (!isGitRepo(harnessDir)) {
+    if (!initVersioning(harnessDir)) {
+      return { success: false, hash: "", files: [], error: "Failed to initialize git repository" };
+    }
+  }
+  const dirsToTrack = [
+    "rules",
+    "instincts",
+    "skills",
+    "playbooks",
+    "workflows",
+    "tools",
+    "agents",
+    "memory/journal",
+    "memory/state.md",
+    "memory/scratch.md",
+    "memory/state-ownership.json",
+    "memory/emotional-state.json",
+    "CORE.md",
+    "SYSTEM.md",
+    "config.yaml"
+  ];
+  const stagedFiles = [];
+  for (const dir of dirsToTrack) {
+    const fullPath = join(harnessDir, dir);
+    if (existsSync(fullPath)) {
+      gitExec(harnessDir, `add "${dir}"`);
+      stagedFiles.push(dir);
+    }
+  }
+  const status = gitExec(harnessDir, "diff --cached --name-only");
+  if (!status || status.length === 0) {
+    return { success: true, hash: getHeadHash(harnessDir) ?? "", files: [], error: "No changes to commit" };
+  }
+  const changedFiles = status.split("\n").filter(Boolean);
+  const commitResult = gitExec(harnessDir, `commit -m "${escapeMessage(message)}"`);
+  if (commitResult === null) {
+    return { success: false, hash: "", files: changedFiles, error: "Git commit failed" };
+  }
+  const hash = getHeadHash(harnessDir) ?? "";
+  if (options?.tag) {
+    gitExec(harnessDir, `tag "${escapeMessage(options.tag)}"`);
+  }
+  return { success: true, hash, files: changedFiles };
+}
+function getVersionLog(harnessDir, options) {
+  if (!isGitRepo(harnessDir)) {
+    return { entries: [], currentHash: "" };
+  }
+  const limit = options?.limit ?? 50;
+  const fileFilter = options?.file ? ` -- "${options.file}"` : "";
+  const format = "%H|%h|%s|%aI|%an";
+  const logOutput = gitExec(harnessDir, `log --format="${format}" -n ${limit}${fileFilter}`);
+  if (!logOutput) {
+    return { entries: [], currentHash: getHeadHash(harnessDir) ?? "" };
+  }
+  const entries = [];
+  for (const line of logOutput.split("\n")) {
+    if (!line.trim()) continue;
+    const parts = line.split("|");
+    if (parts.length < 5) continue;
+    const fullHash = parts[0];
+    const hash = parts[1];
+    const filesOutput = gitExec(harnessDir, `diff-tree --no-commit-id --name-only -r ${fullHash}`);
+    const filesChanged = filesOutput ? filesOutput.split("\n").filter(Boolean) : [];
+    const tagOutput = gitExec(harnessDir, `tag --points-at ${fullHash}`);
+    const tag = tagOutput && tagOutput.length > 0 ? tagOutput.split("\n")[0] : void 0;
+    entries.push({
+      hash,
+      fullHash,
+      message: parts[2],
+      timestamp: parts[3],
+      author: parts.slice(4).join("|"),
+      filesChanged,
+      tag
+    });
+  }
+  const currentHash = getHeadHash(harnessDir) ?? "";
+  const currentTag = entries.length > 0 && entries[0].tag ? entries[0].tag : void 0;
+  return { entries, currentHash, currentTag };
+}
+function getVersionDiff(harnessDir, from, to) {
+  if (!isGitRepo(harnessDir)) {
+    return { from, to: to ?? "HEAD", entries: [], summary: "Not a git repository" };
+  }
+  const target = to ?? "HEAD";
+  const diffOutput = gitExec(harnessDir, `diff --numstat ${from} ${target}`);
+  const nameOutput = gitExec(harnessDir, `diff --name-status ${from} ${target}`);
+  const entries = [];
+  if (nameOutput) {
+    const nameLines = nameOutput.split("\n").filter(Boolean);
+    const statLines = (diffOutput ?? "").split("\n").filter(Boolean);
+    for (let i = 0; i < nameLines.length; i++) {
+      const nameParts = nameLines[i].split("	");
+      const statusChar = nameParts[0];
+      const file = nameParts[nameParts.length - 1];
+      let status = "modified";
+      if (statusChar === "A") status = "added";
+      else if (statusChar === "D") status = "deleted";
+      else if (statusChar.startsWith("R")) status = "renamed";
+      const entry = { file, status };
+      if (i < statLines.length) {
+        const statParts = statLines[i].split("	");
+        if (statParts.length >= 2) {
+          const adds = parseInt(statParts[0], 10);
+          const dels = parseInt(statParts[1], 10);
+          if (!isNaN(adds)) entry.additions = adds;
+          if (!isNaN(dels)) entry.deletions = dels;
+        }
+      }
+      entries.push(entry);
+    }
+  }
+  const added = entries.filter((e) => e.status === "added").length;
+  const modified = entries.filter((e) => e.status === "modified").length;
+  const deleted = entries.filter((e) => e.status === "deleted").length;
+  const summary = `${entries.length} file(s) changed: ${added} added, ${modified} modified, ${deleted} deleted`;
+  return { from, to: target, entries, summary };
+}
+function rollback(harnessDir, targetHash) {
+  if (!isGitRepo(harnessDir)) {
+    return { success: false, targetHash, restoredFiles: [], error: "Not a git repository" };
+  }
+  const resolvedHash = gitExec(harnessDir, `rev-parse --verify ${targetHash}`);
+  if (!resolvedHash) {
+    return { success: false, targetHash, restoredFiles: [], error: `Invalid version: ${targetHash}` };
+  }
+  const diff = getVersionDiff(harnessDir, "HEAD", resolvedHash);
+  const restoredFiles = diff.entries.map((e) => e.file);
+  const restoreResult = gitExec(harnessDir, `checkout ${resolvedHash} -- .`);
+  if (restoreResult === null) {
+    return { success: false, targetHash: resolvedHash, restoredFiles: [], error: "Failed to restore files" };
+  }
+  gitExec(harnessDir, "add -A");
+  const shortHash = resolvedHash.slice(0, 7);
+  const commitResult = gitExec(harnessDir, `commit -m "Rollback to ${shortHash}" --allow-empty`);
+  if (commitResult === null) {
+    return { success: false, targetHash: resolvedHash, restoredFiles, error: "Failed to commit rollback" };
+  }
+  return { success: true, targetHash: resolvedHash, restoredFiles };
+}
+function listTags(harnessDir) {
+  if (!isGitRepo(harnessDir)) return [];
+  const output = gitExec(harnessDir, "tag -l");
+  if (!output) return [];
+  const tags = [];
+  for (const tag of output.split("\n").filter(Boolean)) {
+    const hash = gitExec(harnessDir, `rev-parse ${tag}`);
+    const message = gitExec(harnessDir, `log -1 --format=%s ${tag}`);
+    tags.push({
+      tag,
+      hash: hash ? hash.slice(0, 7) : "",
+      message: message ?? ""
+    });
+  }
+  return tags;
+}
+function tagVersion(harnessDir, tag, message) {
+  if (!isGitRepo(harnessDir)) return false;
+  if (message) {
+    return gitExec(harnessDir, `tag -a "${escapeMessage(tag)}" -m "${escapeMessage(message)}"`) !== null;
+  }
+  return gitExec(harnessDir, `tag "${escapeMessage(tag)}"`) !== null;
+}
+function getPendingChanges(harnessDir) {
+  if (!isGitRepo(harnessDir)) return [];
+  const output = gitExec(harnessDir, "status --porcelain");
+  if (!output) return [];
+  const entries = [];
+  for (const line of output.split("\n").filter(Boolean)) {
+    const statusChar = line.substring(0, 2).trim();
+    const file = line.substring(3);
+    let status = "modified";
+    if (statusChar === "??" || statusChar === "A") status = "added";
+    else if (statusChar === "D") status = "deleted";
+    else if (statusChar.startsWith("R")) status = "renamed";
+    entries.push({ file, status });
+  }
+  return entries;
+}
+function getFileHistory(harnessDir, filePath, options) {
+  const relPath = relative(harnessDir, join(harnessDir, filePath));
+  const log2 = getVersionLog(harnessDir, { limit: options?.limit ?? 20, file: relPath });
+  return log2.entries;
+}
+function getFileAtVersion(harnessDir, filePath, hash) {
+  if (!isGitRepo(harnessDir)) return null;
+  const relPath = relative(harnessDir, join(harnessDir, filePath));
+  return gitExec(harnessDir, `show ${hash}:"${relPath}"`);
+}
+function getHeadHash(harnessDir) {
+  return gitExec(harnessDir, "rev-parse HEAD");
+}
+function escapeMessage(msg) {
+  return msg.replace(/"/g, '\\"').replace(/\n/g, " ");
+}
+export {
+  getFileAtVersion,
+  getFileHistory,
+  getPendingChanges,
+  getVersionDiff,
+  getVersionLog,
+  initVersioning,
+  isGitRepo,
+  listTags,
+  rollback,
+  snapshot,
+  tagVersion
+};
+//# sourceMappingURL=versioning-Z3XNE2Q2.js.map

package/dist/versioning-Z3XNE2Q2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/versioning.ts"],"sourcesContent":["import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport { join, relative } from 'path';\nimport { execSync } from 'child_process';\nimport { log } from '../core/logger.js';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface VersionEntry {\n  /** Git commit hash (short) */\n  hash: string;\n  /** Full commit hash */\n  fullHash: string;\n  /** Commit message */\n  message: string;\n  /** Timestamp (ISO string) */\n  timestamp: string;\n  /** Files changed in this version */\n  filesChanged: string[];\n  /** Author name */\n  author: string;\n  /** Tag if one was applied */\n  tag?: string;\n}\n\nexport interface VersionLog {\n  /** Ordered list of versions (newest first) */\n  entries: VersionEntry[];\n  /** Current HEAD hash */\n  currentHash: string;\n  /** Current tag if any */\n  currentTag?: string;\n}\n\nexport interface RollbackResult {\n  success: boolean;\n  /** Hash we rolled back to */\n  targetHash: string;\n  /** Files that were restored */\n  restoredFiles: string[];\n  /** Error message if failed */\n  error?: string;\n}\n\nexport interface SnapshotResult {\n  success: boolean;\n  /** New commit hash */\n  hash: string;\n  /** Files included in snapshot */\n  files: string[];\n  /** Error if failed */\n  error?: string;\n}\n\nexport interface DiffEntry {\n  file: string;\n  status: 'added' | 'modified' | 'deleted' | 'renamed';\n  /** Lines added */\n  additions?: number;\n  /** Lines deleted */\n  deletions?: number;\n}\n\nexport interface VersionDiff {\n  from: string;\n  to: string;\n  entries: DiffEntry[];\n  summary: string;\n}\n\n// ─── Git Helpers ─────────────────────────────────────────────────────────────\n\n/**\n * Identity used for internal harness versioning commits. This keeps harness\n * snapshots functional on machines (and CI runners) where the user has no\n * global `user.name` / `user.email` configured. Harness versioning is an\n * internal bookkeeping feature; the commits never leave the user's disk,\n * so a synthetic identity is appropriate and doesn't pollute user git history.\n */\nconst HARNESS_GIT_AUTHOR_NAME = 'agent-harness';\nconst HARNESS_GIT_AUTHOR_EMAIL = 'versioning@agent-harness.local';\n\n/**\n * Execute a git command in the harness directory.\n * Returns stdout as a string, or null if the command failed.\n *\n * All invocations automatically inject a synthetic author identity so commits\n * succeed on machines without global git user config (e.g. CI runners, Docker\n * containers, fresh VMs).\n */\nfunction gitExec(harnessDir: string, args: string): string | null {\n  try {\n    const result = execSync(\n      `git -c user.name=\"${HARNESS_GIT_AUTHOR_NAME}\" -c user.email=\"${HARNESS_GIT_AUTHOR_EMAIL}\" ${args}`,\n      {\n        cwd: harnessDir,\n        encoding: 'utf-8',\n        timeout: 10000,\n        stdio: ['pipe', 'pipe', 'pipe'],\n      },\n    );\n    return result.trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Check if the harness directory is a git repository.\n */\nexport function isGitRepo(harnessDir: string): boolean {\n  return gitExec(harnessDir, 'rev-parse --is-inside-work-tree') === 'true';\n}\n\n/**\n * Initialize a git repository in the harness directory.\n * If already initialized, this is a no-op.\n */\nexport function initVersioning(harnessDir: string): boolean {\n  if (isGitRepo(harnessDir)) return true;\n\n  const result = gitExec(harnessDir, 'init');\n  if (result === null) {\n    log.warn('Failed to initialize git repository for versioning');\n    return false;\n  }\n\n  // Create .gitignore for non-versioned files\n  const gitignorePath = join(harnessDir, '.gitignore');\n  if (!existsSync(gitignorePath)) {\n    const gitignoreContent = [\n      '# Agent harness versioning',\n      'memory/sessions/',\n      'memory/metrics.json',\n      'memory/health.json',\n      'memory/costs.json',\n      'memory/rate-limits.json',\n      'memory/emotional-history.jsonl',\n      'memory/locks/',\n      '.installed/',\n      'archive/',\n      'node_modules/',\n    ].join('\\n') + '\\n';\n    writeFileSync(gitignorePath, gitignoreContent, 'utf-8');\n  }\n\n  // Initial commit\n  gitExec(harnessDir, 'add -A');\n  gitExec(harnessDir, 'commit -m \"Initial harness version\" --allow-empty');\n\n  return true;\n}\n\n// ─── Snapshot (Commit) ──────────────────────────────────────────────────────\n\n/**\n * Take a versioned snapshot of the current harness state.\n * Stages all changes and creates a git commit.\n *\n * @param harnessDir - Harness directory path\n * @param message - Commit message describing the change\n * @param options.tag - Optional tag to apply to this version\n */\nexport function snapshot(\n  harnessDir: string,\n  message: string,\n  options?: { tag?: string },\n): SnapshotResult {\n  if (!isGitRepo(harnessDir)) {\n    if (!initVersioning(harnessDir)) {\n      return { success: false, hash: '', files: [], error: 'Failed to initialize git repository' };\n    }\n  }\n\n  // Stage all tracked primitive directories\n  const dirsToTrack = [\n    'rules', 'instincts', 'skills', 'playbooks', 'workflows',\n    'tools', 'agents', 'memory/journal', 'memory/state.md',\n    'memory/scratch.md', 'memory/state-ownership.json',\n    'memory/emotional-state.json',\n    'CORE.md', 'SYSTEM.md', 'config.yaml',\n  ];\n\n  const stagedFiles: string[] = [];\n  for (const dir of dirsToTrack) {\n    const fullPath = join(harnessDir, dir);\n    if (existsSync(fullPath)) {\n      gitExec(harnessDir, `add \"${dir}\"`);\n      stagedFiles.push(dir);\n    }\n  }\n\n  // Check if there are staged changes\n  const status = gitExec(harnessDir, 'diff --cached --name-only');\n  if (!status || status.length === 0) {\n    return { success: true, hash: getHeadHash(harnessDir) ?? '', files: [], error: 'No changes to commit' };\n  }\n\n  const changedFiles = status.split('\\n').filter(Boolean);\n\n  // Commit\n  const commitResult = gitExec(harnessDir, `commit -m \"${escapeMessage(message)}\"`);\n  if (commitResult === null) {\n    return { success: false, hash: '', files: changedFiles, error: 'Git commit failed' };\n  }\n\n  const hash = getHeadHash(harnessDir) ?? '';\n\n  // Tag if requested\n  if (options?.tag) {\n    gitExec(harnessDir, `tag \"${escapeMessage(options.tag)}\"`);\n  }\n\n  return { success: true, hash, files: changedFiles };\n}\n\n// ─── Version Log ────────────────────────────────────────────────────────────\n\n/**\n * Get the version history of the harness.\n *\n * @param harnessDir - Harness directory path\n * @param options.limit - Maximum entries to return (default: 50)\n * @param options.file - Filter to a specific file path\n */\nexport function getVersionLog(\n  harnessDir: string,\n  options?: { limit?: number; file?: string },\n): VersionLog {\n  if (!isGitRepo(harnessDir)) {\n    return { entries: [], currentHash: '' };\n  }\n\n  const limit = options?.limit ?? 50;\n  const fileFilter = options?.file ? ` -- \"${options.file}\"` : '';\n  const format = '%H|%h|%s|%aI|%an';\n\n  const logOutput = gitExec(harnessDir, `log --format=\"${format}\" -n ${limit}${fileFilter}`);\n  if (!logOutput) {\n    return { entries: [], currentHash: getHeadHash(harnessDir) ?? '' };\n  }\n\n  const entries: VersionEntry[] = [];\n\n  for (const line of logOutput.split('\\n')) {\n    if (!line.trim()) continue;\n    const parts = line.split('|');\n    if (parts.length < 5) continue;\n\n    const fullHash = parts[0];\n    const hash = parts[1];\n\n    // Get files changed in this commit\n    const filesOutput = gitExec(harnessDir, `diff-tree --no-commit-id --name-only -r ${fullHash}`);\n    const filesChanged = filesOutput ? filesOutput.split('\\n').filter(Boolean) : [];\n\n    // Check for tags\n    const tagOutput = gitExec(harnessDir, `tag --points-at ${fullHash}`);\n    const tag = tagOutput && tagOutput.length > 0 ? tagOutput.split('\\n')[0] : undefined;\n\n    entries.push({\n      hash,\n      fullHash,\n      message: parts[2],\n      timestamp: parts[3],\n      author: parts.slice(4).join('|'),\n      filesChanged,\n      tag,\n    });\n  }\n\n  const currentHash = getHeadHash(harnessDir) ?? '';\n  const currentTag = entries.length > 0 && entries[0].tag ? entries[0].tag : undefined;\n\n  return { entries, currentHash, currentTag };\n}\n\n// ─── Diff ───────────────────────────────────────────────────────────────────\n\n/**\n * Get the diff between two versions (or between a version and HEAD).\n */\nexport function getVersionDiff(\n  harnessDir: string,\n  from: string,\n  to?: string,\n): VersionDiff {\n  if (!isGitRepo(harnessDir)) {\n    return { from, to: to ?? 'HEAD', entries: [], summary: 'Not a git repository' };\n  }\n\n  const target = to ?? 'HEAD';\n  const diffOutput = gitExec(harnessDir, `diff --numstat ${from} ${target}`);\n  const nameOutput = gitExec(harnessDir, `diff --name-status ${from} ${target}`);\n\n  const entries: DiffEntry[] = [];\n\n  if (nameOutput) {\n    const nameLines = nameOutput.split('\\n').filter(Boolean);\n    const statLines = (diffOutput ?? '').split('\\n').filter(Boolean);\n\n    for (let i = 0; i < nameLines.length; i++) {\n      const nameParts = nameLines[i].split('\\t');\n      const statusChar = nameParts[0];\n      const file = nameParts[nameParts.length - 1];\n\n      let status: DiffEntry['status'] = 'modified';\n      if (statusChar === 'A') status = 'added';\n      else if (statusChar === 'D') status = 'deleted';\n      else if (statusChar.startsWith('R')) status = 'renamed';\n\n      const entry: DiffEntry = { file, status };\n\n      // Parse numstat for additions/deletions\n      if (i < statLines.length) {\n        const statParts = statLines[i].split('\\t');\n        if (statParts.length >= 2) {\n          const adds = parseInt(statParts[0], 10);\n          const dels = parseInt(statParts[1], 10);\n          if (!isNaN(adds)) entry.additions = adds;\n          if (!isNaN(dels)) entry.deletions = dels;\n        }\n      }\n\n      entries.push(entry);\n    }\n  }\n\n  const added = entries.filter((e) => e.status === 'added').length;\n  const modified = entries.filter((e) => e.status === 'modified').length;\n  const deleted = entries.filter((e) => e.status === 'deleted').length;\n  const summary = `${entries.length} file(s) changed: ${added} added, ${modified} modified, ${deleted} deleted`;\n\n  return { from, to: target, entries, summary };\n}\n\n// ─── Rollback ───────────────────────────────────────────────────────────────\n\n/**\n * Roll back the harness to a previous version.\n *\n * Creates a new commit that restores files to the state at `targetHash`,\n * preserving full history (no destructive rewrite).\n *\n * @param harnessDir - Harness directory path\n * @param targetHash - Commit hash or tag to roll back to\n */\nexport function rollback(\n  harnessDir: string,\n  targetHash: string,\n): RollbackResult {\n  if (!isGitRepo(harnessDir)) {\n    return { success: false, targetHash, restoredFiles: [], error: 'Not a git repository' };\n  }\n\n  // Verify the target exists\n  const resolvedHash = gitExec(harnessDir, `rev-parse --verify ${targetHash}`);\n  if (!resolvedHash) {\n    return { success: false, targetHash, restoredFiles: [], error: `Invalid version: ${targetHash}` };\n  }\n\n  // Get files that will change\n  const diff = getVersionDiff(harnessDir, 'HEAD', resolvedHash);\n  const restoredFiles = diff.entries.map((e) => e.file);\n\n  // Restore all tracked files from the target commit\n  const restoreResult = gitExec(harnessDir, `checkout ${resolvedHash} -- .`);\n  if (restoreResult === null) {\n    return { success: false, targetHash: resolvedHash, restoredFiles: [], error: 'Failed to restore files' };\n  }\n\n  // Stage and commit the rollback\n  gitExec(harnessDir, 'add -A');\n  const shortHash = resolvedHash.slice(0, 7);\n  const commitResult = gitExec(harnessDir, `commit -m \"Rollback to ${shortHash}\" --allow-empty`);\n  if (commitResult === null) {\n    return { success: false, targetHash: resolvedHash, restoredFiles, error: 'Failed to commit rollback' };\n  }\n\n  return { success: true, targetHash: resolvedHash, restoredFiles };\n}\n\n// ─── Tag Management ─────────────────────────────────────────────────────────\n\n/**\n * List all version tags.\n */\nexport function listTags(harnessDir: string): Array<{ tag: string; hash: string; message: string }> {\n  if (!isGitRepo(harnessDir)) return [];\n\n  const output = gitExec(harnessDir, 'tag -l');\n  if (!output) return [];\n\n  const tags: Array<{ tag: string; hash: string; message: string }> = [];\n\n  for (const tag of output.split('\\n').filter(Boolean)) {\n    const hash = gitExec(harnessDir, `rev-parse ${tag}`);\n    const message = gitExec(harnessDir, `log -1 --format=%s ${tag}`);\n    tags.push({\n      tag,\n      hash: hash ? hash.slice(0, 7) : '',\n      message: message ?? '',\n    });\n  }\n\n  return tags;\n}\n\n/**\n * Tag the current version.\n */\nexport function tagVersion(harnessDir: string, tag: string, message?: string): boolean {\n  if (!isGitRepo(harnessDir)) return false;\n\n  if (message) {\n    return gitExec(harnessDir, `tag -a \"${escapeMessage(tag)}\" -m \"${escapeMessage(message)}\"`) !== null;\n  }\n  return gitExec(harnessDir, `tag \"${escapeMessage(tag)}\"`) !== null;\n}\n\n// ─── Pending Changes ────────────────────────────────────────────────────────\n\n/**\n * Get uncommitted changes in the harness.\n */\nexport function getPendingChanges(harnessDir: string): DiffEntry[] {\n  if (!isGitRepo(harnessDir)) return [];\n\n  const output = gitExec(harnessDir, 'status --porcelain');\n  if (!output) return [];\n\n  const entries: DiffEntry[] = [];\n\n  for (const line of output.split('\\n').filter(Boolean)) {\n    const statusChar = line.substring(0, 2).trim();\n    const file = line.substring(3);\n\n    let status: DiffEntry['status'] = 'modified';\n    if (statusChar === '??' || statusChar === 'A') status = 'added';\n    else if (statusChar === 'D') status = 'deleted';\n    else if (statusChar.startsWith('R')) status = 'renamed';\n\n    entries.push({ file, status });\n  }\n\n  return entries;\n}\n\n// ─── File History ───────────────────────────────────────────────────────────\n\n/**\n * Get the version history for a specific file.\n */\nexport function getFileHistory(\n  harnessDir: string,\n  filePath: string,\n  options?: { limit?: number },\n): VersionEntry[] {\n  const relPath = relative(harnessDir, join(harnessDir, filePath));\n  const log = getVersionLog(harnessDir, { limit: options?.limit ?? 20, file: relPath });\n  return log.entries;\n}\n\n/**\n * Get the content of a file at a specific version.\n */\nexport function getFileAtVersion(\n  harnessDir: string,\n  filePath: string,\n  hash: string,\n): string | null {\n  if (!isGitRepo(harnessDir)) return null;\n\n  const relPath = relative(harnessDir, join(harnessDir, filePath));\n  return gitExec(harnessDir, `show ${hash}:\"${relPath}\"`);\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nfunction getHeadHash(harnessDir: string): string | null {\n  return gitExec(harnessDir, 'rev-parse HEAD');\n}\n\nfunction escapeMessage(msg: string): string {\n  return msg.replace(/\"/g, '\\\\\"').replace(/\\n/g, ' ');\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,YAA0B,qBAAgC;AACnE,SAAS,MAAM,gBAAgB;AAC/B,SAAS,gBAAgB;AA4EzB,IAAM,0BAA0B;AAChC,IAAM,2BAA2B;AAUjC,SAAS,QAAQ,YAAoB,MAA6B;AAChE,MAAI;AACF,UAAM,SAAS;AAAA,MACb,qBAAqB,uBAAuB,oBAAoB,wBAAwB,KAAK,IAAI;AAAA,MACjG;AAAA,QACE,KAAK;AAAA,QACL,UAAU;AAAA,QACV,SAAS;AAAA,QACT,OAAO,CAAC,QAAQ,QAAQ,MAAM;AAAA,MAChC;AAAA,IACF;AACA,WAAO,OAAO,KAAK;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,UAAU,YAA6B;AACrD,SAAO,QAAQ,YAAY,iCAAiC,MAAM;AACpE;AAMO,SAAS,eAAe,YAA6B;AAC1D,MAAI,UAAU,UAAU,EAAG,QAAO;AAElC,QAAM,SAAS,QAAQ,YAAY,MAAM;AACzC,MAAI,WAAW,MAAM;AACnB,QAAI,KAAK,oDAAoD;AAC7D,WAAO;AAAA,EACT;AAGA,QAAM,gBAAgB,KAAK,YAAY,YAAY;AACnD,MAAI,CAAC,WAAW,aAAa,GAAG;AAC9B,UAAM,mBAAmB;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI,IAAI;AACf,kBAAc,eAAe,kBAAkB,OAAO;AAAA,EACxD;AAGA,UAAQ,YAAY,QAAQ;AAC5B,UAAQ,YAAY,mDAAmD;AAEvE,SAAO;AACT;AAYO,SAAS,SACd,YACA,SACA,SACgB;AAChB,MAAI,CAAC,UAAU,UAAU,GAAG;AAC1B,QAAI,CAAC,eAAe,UAAU,GAAG;AAC/B,aAAO,EAAE,SAAS,OAAO,MAAM,IAAI,OAAO,CAAC,GAAG,OAAO,sCAAsC;AAAA,IAC7F;AAAA,EACF;AAGA,QAAM,cAAc;AAAA,IAClB;AAAA,IAAS;AAAA,IAAa;AAAA,IAAU;AAAA,IAAa;AAAA,IAC7C;AAAA,IAAS;AAAA,IAAU;AAAA,IAAkB;AAAA,IACrC;AAAA,IAAqB;AAAA,IACrB;AAAA,IACA;AAAA,IAAW;AAAA,IAAa;AAAA,EAC1B;AAEA,QAAM,cAAwB,CAAC;AAC/B,aAAW,OAAO,aAAa;AAC7B,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,QAAI,WAAW,QAAQ,GAAG;AACxB,cAAQ,YAAY,QAAQ,GAAG,GAAG;AAClC,kBAAY,KAAK,GAAG;AAAA,IACtB;AAAA,EACF;AAGA,QAAM,SAAS,QAAQ,YAAY,2BAA2B;AAC9D,MAAI,CAAC,UAAU,OAAO,WAAW,GAAG;AAClC,WAAO,EAAE,SAAS,MAAM,MAAM,YAAY,UAAU,KAAK,IAAI,OAAO,CAAC,GAAG,OAAO,uBAAuB;AAAA,EACxG;AAEA,QAAM,eAAe,OAAO,MAAM,IAAI,EAAE,OAAO,OAAO;AAGtD,QAAM,eAAe,QAAQ,YAAY,cAAc,cAAc,OAAO,CAAC,GAAG;AAChF,MAAI,iBAAiB,MAAM;AACzB,WAAO,EAAE,SAAS,OAAO,MAAM,IAAI,OAAO,cAAc,OAAO,oBAAoB;AAAA,EACrF;AAEA,QAAM,OAAO,YAAY,UAAU,KAAK;AAGxC,MAAI,SAAS,KAAK;AAChB,YAAQ,YAAY,QAAQ,cAAc,QAAQ,GAAG,CAAC,GAAG;AAAA,EAC3D;AAEA,SAAO,EAAE,SAAS,MAAM,MAAM,OAAO,aAAa;AACpD;AAWO,SAAS,cACd,YACA,SACY;AACZ,MAAI,CAAC,UAAU,UAAU,GAAG;AAC1B,WAAO,EAAE,SAAS,CAAC,GAAG,aAAa,GAAG;AAAA,EACxC;AAEA,QAAM,QAAQ,SAAS,SAAS;AAChC,QAAM,aAAa,SAAS,OAAO,QAAQ,QAAQ,IAAI,MAAM;AAC7D,QAAM,SAAS;AAEf,QAAM,YAAY,QAAQ,YAAY,iBAAiB,MAAM,QAAQ,KAAK,GAAG,UAAU,EAAE;AACzF,MAAI,CAAC,WAAW;AACd,WAAO,EAAE,SAAS,CAAC,GAAG,aAAa,YAAY,UAAU,KAAK,GAAG;AAAA,EACnE;AAEA,QAAM,UAA0B,CAAC;AAEjC,aAAW,QAAQ,UAAU,MAAM,IAAI,GAAG;AACxC,QAAI,CAAC,KAAK,KAAK,EAAG;AAClB,UAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,QAAI,MAAM,SAAS,EAAG;AAEtB,UAAM,WAAW,MAAM,CAAC;AACxB,UAAM,OAAO,MAAM,CAAC;AAGpB,UAAM,cAAc,QAAQ,YAAY,2CAA2C,QAAQ,EAAE;AAC7F,UAAM,eAAe,cAAc,YAAY,MAAM,IAAI,EAAE,OAAO,OAAO,IAAI,CAAC;AAG9E,UAAM,YAAY,QAAQ,YAAY,mBAAmB,QAAQ,EAAE;AACnE,UAAM,MAAM,aAAa,UAAU,SAAS,IAAI,UAAU,MAAM,IAAI,EAAE,CAAC,IAAI;AAE3E,YAAQ,KAAK;AAAA,MACX;AAAA,MACA;AAAA,MACA,SAAS,MAAM,CAAC;AAAA,MAChB,WAAW,MAAM,CAAC;AAAA,MAClB,QAAQ,MAAM,MAAM,CAAC,EAAE,KAAK,GAAG;AAAA,MAC/B;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,cAAc,YAAY,UAAU,KAAK;AAC/C,QAAM,aAAa,QAAQ,SAAS,KAAK,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,EAAE,MAAM;AAE3E,SAAO,EAAE,SAAS,aAAa,WAAW;AAC5C;AAOO,SAAS,eACd,YACA,MACA,IACa;AACb,MAAI,CAAC,UAAU,UAAU,GAAG;AAC1B,WAAO,EAAE,MAAM,IAAI,MAAM,QAAQ,SAAS,CAAC,GAAG,SAAS,uBAAuB;AAAA,EAChF;AAEA,QAAM,SAAS,MAAM;AACrB,QAAM,aAAa,QAAQ,YAAY,kBAAkB,IAAI,IAAI,MAAM,EAAE;AACzE,QAAM,aAAa,QAAQ,YAAY,sBAAsB,IAAI,IAAI,MAAM,EAAE;AAE7E,QAAM,UAAuB,CAAC;AAE9B,MAAI,YAAY;AACd,UAAM,YAAY,WAAW,MAAM,IAAI,EAAE,OAAO,OAAO;AACvD,UAAM,aAAa,cAAc,IAAI,MAAM,IAAI,EAAE,OAAO,OAAO;AAE/D,aAAS,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;AACzC,YAAM,YAAY,UAAU,CAAC,EAAE,MAAM,GAAI;AACzC,YAAM,aAAa,UAAU,CAAC;AAC9B,YAAM,OAAO,UAAU,UAAU,SAAS,CAAC;AAE3C,UAAI,SAA8B;AAClC,UAAI,eAAe,IAAK,UAAS;AAAA,eACxB,eAAe,IAAK,UAAS;AAAA,eAC7B,WAAW,WAAW,GAAG,EAAG,UAAS;AAE9C,YAAM,QAAmB,EAAE,MAAM,OAAO;AAGxC,UAAI,IAAI,UAAU,QAAQ;AACxB,cAAM,YAAY,UAAU,CAAC,EAAE,MAAM,GAAI;AACzC,YAAI,UAAU,UAAU,GAAG;AACzB,gBAAM,OAAO,SAAS,UAAU,CAAC,GAAG,EAAE;AACtC,gBAAM,OAAO,SAAS,UAAU,CAAC,GAAG,EAAE;AACtC,cAAI,CAAC,MAAM,IAAI,EAAG,OAAM,YAAY;AACpC,cAAI,CAAC,MAAM,IAAI,EAAG,OAAM,YAAY;AAAA,QACtC;AAAA,MACF;AAEA,cAAQ,KAAK,KAAK;AAAA,IACpB;AAAA,EACF;AAEA,QAAM,QAAQ,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,OAAO,EAAE;AAC1D,QAAM,WAAW,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,UAAU,EAAE;AAChE,QAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,SAAS,EAAE;AAC9D,QAAM,UAAU,GAAG,QAAQ,MAAM,qBAAqB,KAAK,WAAW,QAAQ,cAAc,OAAO;AAEnG,SAAO,EAAE,MAAM,IAAI,QAAQ,SAAS,QAAQ;AAC9C;AAaO,SAAS,SACd,YACA,YACgB;AAChB,MAAI,CAAC,UAAU,UAAU,GAAG;AAC1B,WAAO,EAAE,SAAS,OAAO,YAAY,eAAe,CAAC,GAAG,OAAO,uBAAuB;AAAA,EACxF;AAGA,QAAM,eAAe,QAAQ,YAAY,sBAAsB,UAAU,EAAE;AAC3E,MAAI,CAAC,cAAc;AACjB,WAAO,EAAE,SAAS,OAAO,YAAY,eAAe,CAAC,GAAG,OAAO,oBAAoB,UAAU,GAAG;AAAA,EAClG;AAGA,QAAM,OAAO,eAAe,YAAY,QAAQ,YAAY;AAC5D,QAAM,gBAAgB,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,IAAI;AAGpD,QAAM,gBAAgB,QAAQ,YAAY,YAAY,YAAY,OAAO;AACzE,MAAI,kBAAkB,MAAM;AAC1B,WAAO,EAAE,SAAS,OAAO,YAAY,cAAc,eAAe,CAAC,GAAG,OAAO,0BAA0B;AAAA,EACzG;AAGA,UAAQ,YAAY,QAAQ;AAC5B,QAAM,YAAY,aAAa,MAAM,GAAG,CAAC;AACzC,QAAM,eAAe,QAAQ,YAAY,0BAA0B,SAAS,iBAAiB;AAC7F,MAAI,iBAAiB,MAAM;AACzB,WAAO,EAAE,SAAS,OAAO,YAAY,cAAc,eAAe,OAAO,4BAA4B;AAAA,EACvG;AAEA,SAAO,EAAE,SAAS,MAAM,YAAY,cAAc,cAAc;AAClE;AAOO,SAAS,SAAS,YAA2E;AAClG,MAAI,CAAC,UAAU,UAAU,EAAG,QAAO,CAAC;AAEpC,QAAM,SAAS,QAAQ,YAAY,QAAQ;AAC3C,MAAI,CAAC,OAAQ,QAAO,CAAC;AAErB,QAAM,OAA8D,CAAC;AAErE,aAAW,OAAO,OAAO,MAAM,IAAI,EAAE,OAAO,OAAO,GAAG;AACpD,UAAM,OAAO,QAAQ,YAAY,aAAa,GAAG,EAAE;AACnD,UAAM,UAAU,QAAQ,YAAY,sBAAsB,GAAG,EAAE;AAC/D,SAAK,KAAK;AAAA,MACR;AAAA,MACA,MAAM,OAAO,KAAK,MAAM,GAAG,CAAC,IAAI;AAAA,MAChC,SAAS,WAAW;AAAA,IACtB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAKO,SAAS,WAAW,YAAoB,KAAa,SAA2B;AACrF,MAAI,CAAC,UAAU,UAAU,EAAG,QAAO;AAEnC,MAAI,SAAS;AACX,WAAO,QAAQ,YAAY,WAAW,cAAc,GAAG,CAAC,SAAS,cAAc,OAAO,CAAC,GAAG,MAAM;AAAA,EAClG;AACA,SAAO,QAAQ,YAAY,QAAQ,cAAc,GAAG,CAAC,GAAG,MAAM;AAChE;AAOO,SAAS,kBAAkB,YAAiC;AACjE,MAAI,CAAC,UAAU,UAAU,EAAG,QAAO,CAAC;AAEpC,QAAM,SAAS,QAAQ,YAAY,oBAAoB;AACvD,MAAI,CAAC,OAAQ,QAAO,CAAC;AAErB,QAAM,UAAuB,CAAC;AAE9B,aAAW,QAAQ,OAAO,MAAM,IAAI,EAAE,OAAO,OAAO,GAAG;AACrD,UAAM,aAAa,KAAK,UAAU,GAAG,CAAC,EAAE,KAAK;AAC7C,UAAM,OAAO,KAAK,UAAU,CAAC;AAE7B,QAAI,SAA8B;AAClC,QAAI,eAAe,QAAQ,eAAe,IAAK,UAAS;AAAA,aAC/C,eAAe,IAAK,UAAS;AAAA,aAC7B,WAAW,WAAW,GAAG,EAAG,UAAS;AAE9C,YAAQ,KAAK,EAAE,MAAM,OAAO,CAAC;AAAA,EAC/B;AAEA,SAAO;AACT;AAOO,SAAS,eACd,YACA,UACA,SACgB;AAChB,QAAM,UAAU,SAAS,YAAY,KAAK,YAAY,QAAQ,CAAC;AAC/D,QAAMA,OAAM,cAAc,YAAY,EAAE,OAAO,SAAS,SAAS,IAAI,MAAM,QAAQ,CAAC;AACpF,SAAOA,KAAI;AACb;AAKO,SAAS,iBACd,YACA,UACA,MACe;AACf,MAAI,CAAC,UAAU,UAAU,EAAG,QAAO;AAEnC,QAAM,UAAU,SAAS,YAAY,KAAK,YAAY,QAAQ,CAAC;AAC/D,SAAO,QAAQ,YAAY,QAAQ,IAAI,KAAK,OAAO,GAAG;AACxD;AAIA,SAAS,YAAY,YAAmC;AACtD,SAAO,QAAQ,YAAY,gBAAgB;AAC7C;AAEA,SAAS,cAAc,KAAqB;AAC1C,SAAO,IAAI,QAAQ,MAAM,KAAK,EAAE,QAAQ,OAAO,GAAG;AACpD;","names":["log"]}

package/dist/watcher-ISJC7YKL.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+
+import {
+  writeIndexFile
+} from "./chunk-4FDUOGSZ.js";
+import {
+  autoProcessFile
+} from "./chunk-M7NXUK55.js";
+import "./chunk-UPLBF4RZ.js";
+import {
+  log
+} from "./chunk-BSKDOFRT.js";
+import {
+  CORE_PRIMITIVE_DIRS
+} from "./chunk-4CWAGBNS.js";
+import "./chunk-ZZJOFKAT.js";
+
+// src/runtime/watcher.ts
+import { watch } from "chokidar";
+import { relative } from "path";
+function createWatcher(options) {
+  const { harnessDir, extraDirs, onChange, onIndexRebuild, onError, watchConfig, onConfigChange, autoProcess, onAutoProcess } = options;
+  const watchedDirs = [...CORE_PRIMITIVE_DIRS];
+  if (extraDirs) {
+    for (const dir of extraDirs) {
+      if (!watchedDirs.includes(dir)) watchedDirs.push(dir);
+    }
+  }
+  const patterns = watchedDirs.map((dir) => `${harnessDir}/${dir}/**/*.md`);
+  if (watchConfig) {
+    patterns.push(`${harnessDir}/config.yaml`);
+  }
+  const watcher = watch(patterns, {
+    ignoreInitial: true,
+    awaitWriteFinish: {
+      stabilityThreshold: 500,
+      pollInterval: 100
+    }
+  });
+  const handleChange = (filePath, event) => {
+    if (filePath.includes("_index.md")) return;
+    if (filePath.endsWith("config.yaml")) {
+      log.info("Config file changed");
+      try {
+        onConfigChange?.();
+      } catch (e) {
+        log.warn(`onConfigChange callback failed: ${e instanceof Error ? e.message : String(e)}`);
+      }
+      return;
+    }
+    const rel = relative(harnessDir, filePath);
+    const dir = rel.split("/")[0];
+    if (autoProcess && event !== "unlink" && filePath.endsWith(".md") && watchedDirs.includes(dir)) {
+      try {
+        const processResult = autoProcessFile(filePath, { harnessDir });
+        if (processResult.modified) {
+          log.info(`Auto-processed ${rel}: ${processResult.fixes.join(", ")}`);
+        }
+        try {
+          onAutoProcess?.(processResult);
+        } catch (e) {
+          log.warn(`onAutoProcess callback failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+      } catch (err) {
+        log.warn(`Auto-process failed for ${rel}: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+    if (watchedDirs.includes(dir)) {
+      try {
+        writeIndexFile(harnessDir, dir);
+        try {
+          onIndexRebuild?.(dir);
+        } catch (e) {
+          log.warn(`onIndexRebuild callback failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        log.warn(`Failed to rebuild index for ${dir}: ${error.message}`);
+        try {
+          onError?.(error);
+        } catch (e) {
+          log.warn(`Watcher onError callback failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+      }
+    }
+    try {
+      onChange?.(filePath, event);
+    } catch (e) {
+      log.warn(`onChange callback failed: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  };
+  watcher.on("add", (path) => handleChange(path, "add"));
+  watcher.on("change", (path) => handleChange(path, "change"));
+  watcher.on("unlink", (path) => handleChange(path, "unlink"));
+  watcher.on("error", (err) => {
+    const error = err instanceof Error ? err : new Error(String(err));
+    log.warn(`File watcher error: ${error.message}`);
+    try {
+      onError?.(error);
+    } catch (e) {
+      log.warn(`Watcher onError callback failed: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  });
+  return watcher;
+}
+export {
+  createWatcher
+};
+//# sourceMappingURL=watcher-ISJC7YKL.js.map

package/dist/watcher-ISJC7YKL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { relative } from 'path';\nimport { writeIndexFile } from './indexer.js';\nimport { log } from '../core/logger.js';\nimport { CORE_PRIMITIVE_DIRS } from '../core/types.js';\nimport { autoProcessFile, type AutoProcessResult } from './auto-processor.js';\n\nexport interface WatcherOptions {\n  harnessDir: string;\n  extraDirs?: string[];\n  onChange?: (path: string, event: string) => void;\n  onIndexRebuild?: (directory: string) => void;\n  onError?: (error: Error) => void;\n  /** Also watch config.yaml for changes */\n  watchConfig?: boolean;\n  onConfigChange?: () => void;\n  /** Enable auto-processing of primitives on save (default: false) */\n  autoProcess?: boolean;\n  /** Called after auto-processing a file */\n  onAutoProcess?: (result: AutoProcessResult) => void;\n}\n\nexport function createWatcher(options: WatcherOptions): FSWatcher {\n  const { harnessDir, extraDirs, onChange, onIndexRebuild, onError, watchConfig, onConfigChange, autoProcess, onAutoProcess } = options;\n\n  const watchedDirs: string[] = [...CORE_PRIMITIVE_DIRS];\n  if (extraDirs) {\n    for (const dir of extraDirs) {\n      if (!watchedDirs.includes(dir)) watchedDirs.push(dir);\n    }\n  }\n\n  const patterns: string[] = watchedDirs.map((dir) => `${harnessDir}/${dir}/**/*.md`);\n\n  // Optionally watch config.yaml for live reload\n  if (watchConfig) {\n    patterns.push(`${harnessDir}/config.yaml`);\n  }\n\n  const watcher = watch(patterns, {\n    ignoreInitial: true,\n    awaitWriteFinish: {\n      stabilityThreshold: 500,\n      pollInterval: 100,\n    },\n  });\n\n  const handleChange = (filePath: string, event: string) => {\n    // Skip index files\n    if (filePath.includes('_index.md')) return;\n\n    // Config change handler\n    if (filePath.endsWith('config.yaml')) {\n      log.info('Config file changed');\n      try { onConfigChange?.(); } catch (e) {\n        log.warn(`onConfigChange callback failed: ${e instanceof Error ? e.message : String(e)}`);\n      }\n      return;\n    }\n\n    const rel = relative(harnessDir, filePath);\n    const dir = rel.split('/')[0];\n\n    // Auto-process primitives on add/change (before index rebuild so index sees fixes)\n    if (autoProcess && event !== 'unlink' && filePath.endsWith('.md') && watchedDirs.includes(dir)) {\n      try {\n        const processResult = autoProcessFile(filePath, { harnessDir });\n        if (processResult.modified) {\n          log.info(`Auto-processed ${rel}: ${processResult.fixes.join(', ')}`);\n        }\n        try { onAutoProcess?.(processResult); } catch (e) {\n          log.warn(`onAutoProcess callback failed: ${e instanceof Error ? e.message : String(e)}`);\n        }\n      } catch (err) {\n        log.warn(`Auto-process failed for ${rel}: ${err instanceof Error ? err.message : String(err)}`);\n      }\n    }\n\n    if (watchedDirs.includes(dir)) {\n      // Rebuild index for this directory — wrapped for resilience\n      try {\n        writeIndexFile(harnessDir, dir);\n        try { onIndexRebuild?.(dir); } catch (e) {\n          log.warn(`onIndexRebuild callback failed: ${e instanceof Error ? e.message : String(e)}`);\n        }\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        log.warn(`Failed to rebuild index for ${dir}: ${error.message}`);\n        try { onError?.(error); } catch (e) {\n          log.warn(`Watcher onError callback failed: ${e instanceof Error ? e.message : String(e)}`);\n        }\n      }\n    }\n\n    try { onChange?.(filePath, event); } catch (e) {\n      log.warn(`onChange callback failed: ${e instanceof Error ? e.message : String(e)}`);\n    }\n  };\n\n  watcher.on('add', (path) => handleChange(path, 'add'));\n  watcher.on('change', (path) => handleChange(path, 'change'));\n  watcher.on('unlink', (path) => handleChange(path, 'unlink'));\n\n  // Handle file system errors gracefully\n  watcher.on('error', (err) => {\n    const error = err instanceof Error ? err : new Error(String(err));\n    log.warn(`File watcher error: ${error.message}`);\n    try { onError?.(error); } catch (e) {\n      log.warn(`Watcher onError callback failed: ${e instanceof Error ? e.message : String(e)}`);\n    }\n  });\n\n  return watcher;\n}\n"],"mappings":"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","names":[]}

package/dist/web-server-DD7ZOP46.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+import {
+  createWebApp,
+  startWebServer
+} from "./chunk-RY3ZFII7.js";
+import "./chunk-A7BJPQQ6.js";
+import "./chunk-6EMOEYGU.js";
+import "./chunk-GNUSHD2Y.js";
+import "./chunk-5H34JPMB.js";
+import "./chunk-MPZ3BPUI.js";
+import "./chunk-UWQTZMNI.js";
+import "./chunk-UDZIS2AQ.js";
+import "./chunk-DTTXPHFW.js";
+import "./chunk-Z2PUCXTZ.js";
+import "./chunk-TAT6JU3X.js";
+import "./chunk-JKMGYWXB.js";
+import "./chunk-UPLBF4RZ.js";
+import "./chunk-BSKDOFRT.js";
+import "./chunk-IZ6UZ3ZL.js";
+import "./chunk-CHJ5GNZC.js";
+import "./chunk-4CWAGBNS.js";
+import "./chunk-ZZJOFKAT.js";
+export {
+  createWebApp,
+  startWebServer
+};
+//# sourceMappingURL=web-server-DD7ZOP46.js.map

package/dist/web-server-DD7ZOP46.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@agntk/agent-harness",
+  "version": "0.1.1",
+  "description": "A file-first agent operating system. Build AI agents by editing markdown files, not writing code.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Phoenixrr2113/agent-harness.git"
+  },
+  "homepage": "https://github.com/Phoenixrr2113/agent-harness#readme",
+  "bugs": {
+    "url": "https://github.com/Phoenixrr2113/agent-harness/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "harness": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "files": [
+    "dist",
+    "defaults",
+    "templates",
+    "sources.yaml",
+    "NOTICE"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "harness",
+    "autonomous",
+    "llm",
+    "openrouter",
+    "framework"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.66",
+    "@ai-sdk/mcp": "^1.0.32",
+    "@ai-sdk/openai": "^3.0.50",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@openrouter/ai-sdk-provider": "^2.3.3",
+    "ai": "^6.0.146",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "dotenv": "^17.4.1",
+    "gray-matter": "^4.0.3",
+    "node-cron": "^4.2.1",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@types/node-cron": "^3.0.11",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}