@agntk/agent-harness 0.1.1

package/dist/scaffold-A3VRRCBV.js

@@ -0,0 +1,347 @@
+#!/usr/bin/env node
+
+import {
+  writeDefaultConfig
+} from "./chunk-CHJ5GNZC.js";
+import "./chunk-4CWAGBNS.js";
+import "./chunk-ZZJOFKAT.js";
+
+// src/cli/scaffold.ts
+import { mkdirSync, writeFileSync, readFileSync, readdirSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+var DIRECTORIES = [
+  "rules",
+  "instincts",
+  "skills",
+  "playbooks",
+  "workflows",
+  "tools",
+  "agents",
+  "intake",
+  "memory/sessions",
+  "memory/journal"
+];
+function getPackageRoot() {
+  let dir = dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 5; i++) {
+    if (existsSync(join(dir, "package.json"))) return dir;
+    dir = dirname(dir);
+  }
+  return dirname(dirname(fileURLToPath(import.meta.url)));
+}
+function applyTemplate(content, vars) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const defaultPurpose = `I am ${vars.agentName}, an autonomous AI agent. My purpose is to help my creator build, think, and ship.`;
+  const purpose = vars.purpose ? `I am ${vars.agentName}. ${vars.purpose}` : defaultPurpose;
+  return content.replace(/\{\{AGENT_NAME\}\}/g, vars.agentName).replace(/\{\{PURPOSE\}\}/g, purpose).replace(/\{\{DATE\}\}/g, date);
+}
+function copyDefaults(targetDir, vars) {
+  const defaultsDir = join(getPackageRoot(), "defaults");
+  if (!existsSync(defaultsDir)) return;
+  const primitiveDirs = ["rules", "instincts", "skills", "playbooks", "agents", "tools", "workflows"];
+  for (const dir of primitiveDirs) {
+    const srcDir = join(defaultsDir, dir);
+    if (!existsSync(srcDir)) continue;
+    const files = readdirSync(srcDir).filter((f) => f.endsWith(".md"));
+    for (const file of files) {
+      const content = readFileSync(join(srcDir, file), "utf-8");
+      writeFileSync(join(targetDir, dir, file), applyTemplate(content, vars), "utf-8");
+    }
+  }
+}
+function loadTemplate(templateName, fileName, vars) {
+  const templatePath = join(getPackageRoot(), "templates", templateName, fileName);
+  if (!existsSync(templatePath)) return null;
+  return applyTemplate(readFileSync(templatePath, "utf-8"), vars);
+}
+function scaffoldHarness(targetDir, agentName, options) {
+  if (existsSync(targetDir)) {
+    throw new Error(`Directory already exists: ${targetDir}`);
+  }
+  const template = options?.template ?? "base";
+  const vars = { agentName, purpose: options?.purpose };
+  mkdirSync(targetDir, { recursive: true });
+  for (const dir of DIRECTORIES) {
+    mkdirSync(join(targetDir, dir), { recursive: true });
+  }
+  if (options?.coreContent) {
+    writeFileSync(join(targetDir, "CORE.md"), options.coreContent);
+  } else {
+    const templateContent = loadTemplate(template, "CORE.md", vars);
+    writeFileSync(
+      join(targetDir, "CORE.md"),
+      templateContent ?? applyTemplate(`# {{AGENT_NAME}}
+
+## Purpose
+{{PURPOSE}}
+
+## Values
+- **Honesty**: I tell the truth, even when it's uncomfortable.
+- **Action**: I bias toward doing, not discussing.
+- **Autonomy**: I act independently within my boundaries.
+- **Growth**: I learn from every interaction.
+- **Protection**: I guard my creator's time, money, and reputation.
+
+## Ethics
+- I never deceive my creator or others.
+- I never take irreversible actions without confirmation.
+- I never expose secrets, credentials, or private information.
+- I escalate when uncertain rather than guessing.
+`, vars)
+    );
+  }
+  const systemContent = loadTemplate(template, "SYSTEM.md", vars);
+  writeFileSync(
+    join(targetDir, "SYSTEM.md"),
+    systemContent ?? `# System
+
+You are ${vars.agentName}. This file defines how you boot and operate.
+
+## Boot Sequence
+1. Load CORE.md \u2014 your identity (never changes)
+2. Load state.md \u2014 where you left off
+3. Load memory/scratch.md \u2014 current working memory
+4. Load indexes \u2014 scan all primitive directories
+5. Load relevant files based on current task
+
+## File Ownership
+| Owner | Files | Can Modify |
+|-------|-------|------------|
+| Human | CORE.md, rules/*, config.yaml | Only human edits |
+| Agent | instincts/*, memory/sessions/*, state.md (goals) | During/after interactions |
+| Infrastructure | */_index.md, memory/journal/* | Auto-scripts only |
+
+## Context Loading Strategy
+- L0 (~5 tokens): One-line summary \u2014 decides relevance
+- L1 (~50-100 tokens): Paragraph \u2014 enough to work with
+- L2 (full body): Complete content \u2014 loaded only when actively needed
+- Always load CORE + state + scratch first
+- Load primitives at the appropriate level based on token budget
+`
+  );
+  const configContent = loadTemplate(template, "config.yaml", vars);
+  writeFileSync(join(targetDir, "config.yaml"), configContent ?? writeDefaultConfig(targetDir, agentName));
+  writeFileSync(
+    join(targetDir, "state.md"),
+    `# Agent State
+
+## Mode
+idle
+
+## Goals
+
+## Active Workflows
+
+## Last Interaction
+${(/* @__PURE__ */ new Date()).toISOString()}
+
+## Unfinished Business
+`
+  );
+  writeFileSync(join(targetDir, "memory", "scratch.md"), "");
+  copyDefaults(targetDir, vars);
+  writeFileSync(
+    join(targetDir, "README.md"),
+    `# ${agentName}
+
+You just created an agent. The agent IS this folder \u2014 every file is part
+of its identity, behavior, knowledge, and memory.
+
+## Try these in order
+
+\`\`\`bash
+harness run "What can you do?"            # see what's loaded
+harness run "Help me decide between two options: A or B"
+harness run "Plan a weekend project for me"   # watch it qualify before answering
+\`\`\`
+
+Use it for a few days with varied prompts. Then:
+
+\`\`\`bash
+harness journal              # synthesize today's sessions and find patterns
+harness learn --install      # promote learned patterns into instincts
+\`\`\`
+
+The agent gets measurably better the more you use it. Every interaction
+is journaled, patterns become instincts, and instincts change behavior
+on the next run. **No retraining, no fine-tuning, no code.** You're
+editing markdown.
+
+## What's in this folder
+
+| File / dir | Owner | What it is |
+|---|---|---|
+| \`CORE.md\`        | human | Identity. Who is this agent? Frozen. |
+| \`SYSTEM.md\`      | human | Boot instructions. How does it operate? |
+| \`config.yaml\`    | human | Model, runtime, MCP servers, budgets |
+| \`state.md\`       | mixed | Live state: mode, goals, last interaction |
+| \`rules/\`         | human | Hard boundaries the agent must respect |
+| \`skills/\`        | mixed | Capabilities + how to think about using them |
+| \`playbooks/\`     | mixed | Adaptive guidance for outcomes |
+| \`instincts/\`     | agent | Reflexive behaviors learned from sessions |
+| \`workflows/\`     | infra | Cron-driven automations |
+| \`tools/\`         | extern | HTTP/API tool definitions |
+| \`agents/\`        | extern | Sub-agent roster |
+| \`memory/sessions/\` | agent | Auto-captured interaction records |
+| \`memory/journal/\`  | infra | Daily synthesized reflections |
+
+Open any file and edit it. Save. Run \`harness run "..."\` again and the
+agent reads your change. That's the loop.
+
+## Going further
+
+\`\`\`bash
+harness doctor          # check scaffold health
+harness graph           # see how primitives reference each other
+harness info            # what's loaded in the context budget right now
+harness mcp discover    # find MCP tools already installed on your machine
+harness mcp search <q>  # browse the MCP registry for new tools
+harness install <url>   # install a skill, agent, or rule from a URL
+\`\`\`
+
+Tools come from MCP servers \u2014 install one with \`harness mcp install\`.
+
+## When something feels off
+
+- \`harness validate\` \u2014 check the harness structure for errors
+- \`harness doctor\` \u2014 same, but auto-fix what it can
+- \`harness contradictions\` \u2014 check rules and instincts for conflicts
+- \`harness dead-primitives\` \u2014 find files you haven't used in a while
+
+The agent journal in \`memory/journal/\` is the most interesting place
+to look \u2014 it's where the agent reflects on what you've been doing
+together. Read it once a week.
+`
+  );
+  writeFileSync(
+    join(targetDir, ".gitignore"),
+    `memory/scratch.md
+memory/context.jsonl
+memory/context.md
+memory/sessions/*
+memory/journal/*
+!memory/sessions/.gitkeep
+!memory/journal/.gitkeep
+.env
+`
+  );
+  writeFileSync(join(targetDir, "memory", "sessions", ".gitkeep"), "");
+  writeFileSync(join(targetDir, "memory", "journal", ".gitkeep"), "");
+}
+function generateSystemMd(harnessDir, agentName) {
+  const primitiveDirs = ["rules", "instincts", "skills", "playbooks", "workflows", "tools", "agents"];
+  const sections = [];
+  sections.push(`# System
+`);
+  sections.push(`You are ${agentName}. This file defines how you boot and operate.
+`);
+  sections.push(`## Boot Sequence
+1. Load CORE.md \u2014 your identity (never changes)
+2. Load state.md \u2014 where you left off
+3. Load memory/scratch.md \u2014 current working memory
+4. Load indexes \u2014 scan all primitive directories
+5. Load relevant files based on current task
+`);
+  sections.push(`## Directory Structure
+`);
+  for (const dir of primitiveDirs) {
+    const dirPath = join(harnessDir, dir);
+    if (!existsSync(dirPath)) continue;
+    const files = readdirSync(dirPath).filter((f) => f.endsWith(".md") && !f.startsWith("_"));
+    if (files.length === 0) {
+      sections.push(`- \`${dir}/\` \u2014 (empty)`);
+    } else {
+      sections.push(`- \`${dir}/\` \u2014 ${files.length} file(s): ${files.map((f) => f.replace(".md", "")).join(", ")}`);
+    }
+  }
+  const sessionsDir = join(harnessDir, "memory", "sessions");
+  const journalDir = join(harnessDir, "memory", "journal");
+  const sessionCount = existsSync(sessionsDir) ? readdirSync(sessionsDir).filter((f) => f.endsWith(".md")).length : 0;
+  const journalCount = existsSync(journalDir) ? readdirSync(journalDir).filter((f) => f.endsWith(".md")).length : 0;
+  sections.push(`- \`memory/sessions/\` \u2014 ${sessionCount} session(s)`);
+  sections.push(`- \`memory/journal/\` \u2014 ${journalCount} entry/entries`);
+  sections.push("");
+  sections.push(`## File Ownership
+| Owner | Files | Can Modify |
+|-------|-------|------------|
+| Human | CORE.md, rules/*, config.yaml | Only human edits |
+| Agent | instincts/*, memory/sessions/*, state.md (goals) | During/after interactions |
+| Infrastructure | */_index.md, memory/journal/* | Auto-scripts only |
+`);
+  sections.push(`## Context Loading Strategy
+- L0 (~5 tokens): One-line summary \u2014 decides relevance
+- L1 (~50-100 tokens): Paragraph \u2014 enough to work with
+- L2 (full body): Complete content \u2014 loaded only when actively needed
+- Always load CORE + state + scratch first
+- Load primitives at the appropriate level based on token budget
+`);
+  return sections.join("\n");
+}
+async function generateCoreMd(agentName, purpose, options) {
+  try {
+    const { generate, getModel } = await import("./provider-SXPQZ74H.js");
+    const { HarnessConfigSchema } = await import("./types-EW7AIB3R.js");
+    const config = HarnessConfigSchema.parse({
+      agent: { name: agentName, version: "0.1.0" },
+      model: {
+        provider: options.provider ?? "openrouter",
+        id: options.modelId ?? "anthropic/claude-sonnet-4"
+      }
+    });
+    const model = getModel(config, options.apiKey);
+    const result = await generate({
+      model,
+      system: `You are a technical writer creating an identity document for an AI agent.
+The document defines who the agent is, what it does, its values, and its ethical boundaries.
+Write in first person from the agent's perspective. Be specific and practical, not generic.
+Output ONLY the markdown content, no code fences.`,
+      prompt: `Create a CORE.md identity document for an AI agent with:
+- Name: ${agentName}
+- Purpose: ${purpose}
+
+The document should have these sections:
+# ${agentName}
+
+## Purpose
+(Detailed purpose based on the description \u2014 be specific to what this agent does)
+
+## Values
+(5-7 values tailored to this agent's purpose \u2014 not generic platitudes)
+
+## Ethics
+(4-6 ethical boundaries specific to this agent's domain)
+
+## Capabilities
+(3-5 key capabilities this agent should have based on its purpose)
+
+## Boundaries
+(3-5 things this agent should NOT do or areas where it should escalate)`,
+      maxOutputTokens: 2e3,
+      maxRetries: 1,
+      timeoutMs: 3e4
+    });
+    return result.text.trim();
+  } catch (err) {
+    if (err instanceof Error) throw err;
+    throw new Error(String(err));
+  }
+}
+function listTemplates() {
+  const templatesDir = join(getPackageRoot(), "templates");
+  if (!existsSync(templatesDir)) return [];
+  return readdirSync(templatesDir).filter((f) => {
+    try {
+      return readdirSync(join(templatesDir, f)).length > 0;
+    } catch {
+      return false;
+    }
+  });
+}
+export {
+  generateCoreMd,
+  generateSystemMd,
+  listTemplates,
+  scaffoldHarness
+};
+//# sourceMappingURL=scaffold-A3VRRCBV.js.map

package/dist/scaffold-A3VRRCBV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/scaffold.ts"],"sourcesContent":["import { mkdirSync, writeFileSync, readFileSync, readdirSync, existsSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { fileURLToPath } from 'url';\nimport { writeDefaultConfig } from '../core/config.js';\n\nconst DIRECTORIES = [\n  'rules',\n  'instincts',\n  'skills',\n  'playbooks',\n  'workflows',\n  'tools',\n  'agents',\n  'intake',\n  'memory/sessions',\n  'memory/journal',\n];\n\n/**\n * Resolve the package root directory by walking up from import.meta.url\n * until we find package.json. Works in both dev (src/) and prod (dist/).\n */\nfunction getPackageRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url));\n  for (let i = 0; i < 5; i++) {\n    if (existsSync(join(dir, 'package.json'))) return dir;\n    dir = dirname(dir);\n  }\n  // Fallback: assume 2 levels up from source\n  return dirname(dirname(fileURLToPath(import.meta.url)));\n}\n\ninterface TemplateVars {\n  agentName: string;\n  purpose?: string;\n}\n\n/**\n * Apply template variables to a string.\n */\nfunction applyTemplate(content: string, vars: TemplateVars): string {\n  const date = new Date().toISOString().split('T')[0];\n  const defaultPurpose = `I am ${vars.agentName}, an autonomous AI agent. My purpose is to help my creator build, think, and ship.`;\n  const purpose = vars.purpose\n    ? `I am ${vars.agentName}. ${vars.purpose}`\n    : defaultPurpose;\n  return content\n    .replace(/\\{\\{AGENT_NAME\\}\\}/g, vars.agentName)\n    .replace(/\\{\\{PURPOSE\\}\\}/g, purpose)\n    .replace(/\\{\\{DATE\\}\\}/g, date);\n}\n\n/**\n * Copy default primitives from defaults/ directory into the target harness.\n */\nfunction copyDefaults(targetDir: string, vars: TemplateVars): void {\n  const defaultsDir = join(getPackageRoot(), 'defaults');\n  if (!existsSync(defaultsDir)) return;\n\n  const primitiveDirs = ['rules', 'instincts', 'skills', 'playbooks', 'agents', 'tools', 'workflows'];\n  for (const dir of primitiveDirs) {\n    const srcDir = join(defaultsDir, dir);\n    if (!existsSync(srcDir)) continue;\n    const files = readdirSync(srcDir).filter((f) => f.endsWith('.md'));\n    for (const file of files) {\n      const content = readFileSync(join(srcDir, file), 'utf-8');\n      writeFileSync(join(targetDir, dir, file), applyTemplate(content, vars), 'utf-8');\n    }\n  }\n}\n\n/**\n * Load a template file and apply substitutions. Returns null if not found.\n */\nfunction loadTemplate(templateName: string, fileName: string, vars: TemplateVars): string | null {\n  const templatePath = join(getPackageRoot(), 'templates', templateName, fileName);\n  if (!existsSync(templatePath)) return null;\n  return applyTemplate(readFileSync(templatePath, 'utf-8'), vars);\n}\n\nexport interface ScaffoldOptions {\n  template?: string;\n  /** Custom CORE.md content — overrides template */\n  coreContent?: string;\n  /** Agent purpose description (stored as comment in CORE.md when no LLM generation) */\n  purpose?: string;\n}\n\nexport function scaffoldHarness(targetDir: string, agentName: string, options?: ScaffoldOptions): void {\n  if (existsSync(targetDir)) {\n    throw new Error(`Directory already exists: ${targetDir}`);\n  }\n\n  const template = options?.template ?? 'base';\n  const vars: TemplateVars = { agentName, purpose: options?.purpose };\n\n  // Create directory structure\n  mkdirSync(targetDir, { recursive: true });\n  for (const dir of DIRECTORIES) {\n    mkdirSync(join(targetDir, dir), { recursive: true });\n  }\n\n  // --- CORE.md (custom > template > inline fallback) ---\n  if (options?.coreContent) {\n    writeFileSync(join(targetDir, 'CORE.md'), options.coreContent);\n  } else {\n    const templateContent = loadTemplate(template, 'CORE.md', vars);\n    writeFileSync(\n      join(targetDir, 'CORE.md'),\n      templateContent ?? applyTemplate(`# {{AGENT_NAME}}\n\n## Purpose\n{{PURPOSE}}\n\n## Values\n- **Honesty**: I tell the truth, even when it's uncomfortable.\n- **Action**: I bias toward doing, not discussing.\n- **Autonomy**: I act independently within my boundaries.\n- **Growth**: I learn from every interaction.\n- **Protection**: I guard my creator's time, money, and reputation.\n\n## Ethics\n- I never deceive my creator or others.\n- I never take irreversible actions without confirmation.\n- I never expose secrets, credentials, or private information.\n- I escalate when uncertain rather than guessing.\n`, vars)\n    );\n  }\n\n  // --- SYSTEM.md (from template, or inline fallback) ---\n  const systemContent = loadTemplate(template, 'SYSTEM.md', vars);\n  writeFileSync(\n    join(targetDir, 'SYSTEM.md'),\n    systemContent ?? `# System\n\nYou are ${vars.agentName}. This file defines how you boot and operate.\n\n## Boot Sequence\n1. Load CORE.md — your identity (never changes)\n2. Load state.md — where you left off\n3. Load memory/scratch.md — current working memory\n4. Load indexes — scan all primitive directories\n5. Load relevant files based on current task\n\n## File Ownership\n| Owner | Files | Can Modify |\n|-------|-------|------------|\n| Human | CORE.md, rules/*, config.yaml | Only human edits |\n| Agent | instincts/*, memory/sessions/*, state.md (goals) | During/after interactions |\n| Infrastructure | */_index.md, memory/journal/* | Auto-scripts only |\n\n## Context Loading Strategy\n- L0 (~5 tokens): One-line summary — decides relevance\n- L1 (~50-100 tokens): Paragraph — enough to work with\n- L2 (full body): Complete content — loaded only when actively needed\n- Always load CORE + state + scratch first\n- Load primitives at the appropriate level based on token budget\n`\n  );\n\n  // --- config.yaml (from template, or use writeDefaultConfig) ---\n  const configContent = loadTemplate(template, 'config.yaml', vars);\n  writeFileSync(join(targetDir, 'config.yaml'), configContent ?? writeDefaultConfig(targetDir, agentName));\n\n  // --- state.md ---\n  writeFileSync(\n    join(targetDir, 'state.md'),\n    `# Agent State\n\n## Mode\nidle\n\n## Goals\n\n## Active Workflows\n\n## Last Interaction\n${new Date().toISOString()}\n\n## Unfinished Business\n`\n  );\n\n  // --- memory/scratch.md ---\n  writeFileSync(join(targetDir, 'memory', 'scratch.md'), '');\n\n  // --- Copy default primitives from defaults/ directory ---\n  copyDefaults(targetDir, vars);\n\n  // --- README.md (the in-scaffold quickstart, the FIRST thing a non-coder reads) ---\n  writeFileSync(\n    join(targetDir, 'README.md'),\n    `# ${agentName}\n\nYou just created an agent. The agent IS this folder — every file is part\nof its identity, behavior, knowledge, and memory.\n\n## Try these in order\n\n\\`\\`\\`bash\nharness run \"What can you do?\"            # see what's loaded\nharness run \"Help me decide between two options: A or B\"\nharness run \"Plan a weekend project for me\"   # watch it qualify before answering\n\\`\\`\\`\n\nUse it for a few days with varied prompts. Then:\n\n\\`\\`\\`bash\nharness journal              # synthesize today's sessions and find patterns\nharness learn --install      # promote learned patterns into instincts\n\\`\\`\\`\n\nThe agent gets measurably better the more you use it. Every interaction\nis journaled, patterns become instincts, and instincts change behavior\non the next run. **No retraining, no fine-tuning, no code.** You're\nediting markdown.\n\n## What's in this folder\n\n| File / dir | Owner | What it is |\n|---|---|---|\n| \\`CORE.md\\`        | human | Identity. Who is this agent? Frozen. |\n| \\`SYSTEM.md\\`      | human | Boot instructions. How does it operate? |\n| \\`config.yaml\\`    | human | Model, runtime, MCP servers, budgets |\n| \\`state.md\\`       | mixed | Live state: mode, goals, last interaction |\n| \\`rules/\\`         | human | Hard boundaries the agent must respect |\n| \\`skills/\\`        | mixed | Capabilities + how to think about using them |\n| \\`playbooks/\\`     | mixed | Adaptive guidance for outcomes |\n| \\`instincts/\\`     | agent | Reflexive behaviors learned from sessions |\n| \\`workflows/\\`     | infra | Cron-driven automations |\n| \\`tools/\\`         | extern | HTTP/API tool definitions |\n| \\`agents/\\`        | extern | Sub-agent roster |\n| \\`memory/sessions/\\` | agent | Auto-captured interaction records |\n| \\`memory/journal/\\`  | infra | Daily synthesized reflections |\n\nOpen any file and edit it. Save. Run \\`harness run \"...\"\\` again and the\nagent reads your change. That's the loop.\n\n## Going further\n\n\\`\\`\\`bash\nharness doctor          # check scaffold health\nharness graph           # see how primitives reference each other\nharness info            # what's loaded in the context budget right now\nharness mcp discover    # find MCP tools already installed on your machine\nharness mcp search <q>  # browse the MCP registry for new tools\nharness install <url>   # install a skill, agent, or rule from a URL\n\\`\\`\\`\n\nTools come from MCP servers — install one with \\`harness mcp install\\`.\n\n## When something feels off\n\n- \\`harness validate\\` — check the harness structure for errors\n- \\`harness doctor\\` — same, but auto-fix what it can\n- \\`harness contradictions\\` — check rules and instincts for conflicts\n- \\`harness dead-primitives\\` — find files you haven't used in a while\n\nThe agent journal in \\`memory/journal/\\` is the most interesting place\nto look — it's where the agent reflects on what you've been doing\ntogether. Read it once a week.\n`,\n  );\n\n  // --- .gitignore ---\n  writeFileSync(\n    join(targetDir, '.gitignore'),\n    `memory/scratch.md\nmemory/context.jsonl\nmemory/context.md\nmemory/sessions/*\nmemory/journal/*\n!memory/sessions/.gitkeep\n!memory/journal/.gitkeep\n.env\n`\n  );\n\n  // Create .gitkeep files\n  writeFileSync(join(targetDir, 'memory', 'sessions', '.gitkeep'), '');\n  writeFileSync(join(targetDir, 'memory', 'journal', '.gitkeep'), '');\n}\n\n/**\n * Generate SYSTEM.md content from the actual directory structure of a harness.\n * Scans for primitives and reflects the real structure.\n */\nexport function generateSystemMd(harnessDir: string, agentName: string): string {\n  const primitiveDirs = ['rules', 'instincts', 'skills', 'playbooks', 'workflows', 'tools', 'agents'];\n  const sections: string[] = [];\n\n  sections.push(`# System\\n`);\n  sections.push(`You are ${agentName}. This file defines how you boot and operate.\\n`);\n\n  // Boot sequence\n  sections.push(`## Boot Sequence\n1. Load CORE.md — your identity (never changes)\n2. Load state.md — where you left off\n3. Load memory/scratch.md — current working memory\n4. Load indexes — scan all primitive directories\n5. Load relevant files based on current task\\n`);\n\n  // Directory structure\n  sections.push(`## Directory Structure\\n`);\n\n  for (const dir of primitiveDirs) {\n    const dirPath = join(harnessDir, dir);\n    if (!existsSync(dirPath)) continue;\n\n    const files = readdirSync(dirPath).filter((f) => f.endsWith('.md') && !f.startsWith('_'));\n    if (files.length === 0) {\n      sections.push(`- \\`${dir}/\\` — (empty)`);\n    } else {\n      sections.push(`- \\`${dir}/\\` — ${files.length} file(s): ${files.map((f) => f.replace('.md', '')).join(', ')}`);\n    }\n  }\n\n  // Memory\n  const sessionsDir = join(harnessDir, 'memory', 'sessions');\n  const journalDir = join(harnessDir, 'memory', 'journal');\n  const sessionCount = existsSync(sessionsDir)\n    ? readdirSync(sessionsDir).filter((f) => f.endsWith('.md')).length\n    : 0;\n  const journalCount = existsSync(journalDir)\n    ? readdirSync(journalDir).filter((f) => f.endsWith('.md')).length\n    : 0;\n\n  sections.push(`- \\`memory/sessions/\\` — ${sessionCount} session(s)`);\n  sections.push(`- \\`memory/journal/\\` — ${journalCount} entry/entries`);\n  sections.push('');\n\n  // File ownership\n  sections.push(`## File Ownership\n| Owner | Files | Can Modify |\n|-------|-------|------------|\n| Human | CORE.md, rules/*, config.yaml | Only human edits |\n| Agent | instincts/*, memory/sessions/*, state.md (goals) | During/after interactions |\n| Infrastructure | */_index.md, memory/journal/* | Auto-scripts only |\\n`);\n\n  // Context loading strategy\n  sections.push(`## Context Loading Strategy\n- L0 (~5 tokens): One-line summary — decides relevance\n- L1 (~50-100 tokens): Paragraph — enough to work with\n- L2 (full body): Complete content — loaded only when actively needed\n- Always load CORE + state + scratch first\n- Load primitives at the appropriate level based on token budget\n`);\n\n  return sections.join('\\n');\n}\n\n/**\n * Generate a rich CORE.md using an LLM, given an agent name and purpose description.\n * Returns the generated markdown content, or throws on failure.\n */\nexport async function generateCoreMd(\n  agentName: string,\n  purpose: string,\n  options: { provider?: string; modelId?: string; apiKey?: string },\n): Promise<string> {\n  try {\n    const { generate, getModel } = await import('../llm/provider.js');\n    const { HarnessConfigSchema } = await import('../core/types.js');\n\n    const config = HarnessConfigSchema.parse({\n      agent: { name: agentName, version: '0.1.0' },\n      model: {\n        provider: options.provider ?? 'openrouter',\n        id: options.modelId ?? 'anthropic/claude-sonnet-4',\n      },\n    });\n\n    const model = getModel(config, options.apiKey);\n    const result = await generate({\n      model,\n      system: `You are a technical writer creating an identity document for an AI agent.\nThe document defines who the agent is, what it does, its values, and its ethical boundaries.\nWrite in first person from the agent's perspective. Be specific and practical, not generic.\nOutput ONLY the markdown content, no code fences.`,\n      prompt: `Create a CORE.md identity document for an AI agent with:\n- Name: ${agentName}\n- Purpose: ${purpose}\n\nThe document should have these sections:\n# ${agentName}\n\n## Purpose\n(Detailed purpose based on the description — be specific to what this agent does)\n\n## Values\n(5-7 values tailored to this agent's purpose — not generic platitudes)\n\n## Ethics\n(4-6 ethical boundaries specific to this agent's domain)\n\n## Capabilities\n(3-5 key capabilities this agent should have based on its purpose)\n\n## Boundaries\n(3-5 things this agent should NOT do or areas where it should escalate)`,\n      maxOutputTokens: 2000,\n      maxRetries: 1,\n      timeoutMs: 30000,\n    });\n\n    return result.text.trim();\n  } catch (err: unknown) {\n    if (err instanceof Error) throw err;\n    throw new Error(String(err));\n  }\n}\n\n/**\n * List available templates.\n */\nexport function listTemplates(): string[] {\n  const templatesDir = join(getPackageRoot(), 'templates');\n  if (!existsSync(templatesDir)) return [];\n  return readdirSync(templatesDir).filter((f) => {\n    try {\n      return readdirSync(join(templatesDir, f)).length > 0;\n    } catch {\n      return false;\n    }\n  });\n}\n"],"mappings":"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","names":[]}