jfl 0.4.4 → 0.6.0

package/dist/lib/agent-generator.js

@@ -5,8 +5,15 @@
  *
  * @purpose Generate service agent definitions for GTM integration
  */
-import { writeFileSync, mkdirSync, existsSync, readFileSync } from "fs";
+import { writeFileSync, mkdirSync, existsSync, readFileSync, readdirSync, unlinkSync } from "fs";
 import { join } from "path";
+const ACRONYMS = new Set(["api", "ui", "cli", "db", "ml", "ai", "ci", "cd", "io", "id", "url", "uri", "sdk", "rl", "mcp", "gtm", "crm", "cms", "cdn", "dns", "tcp", "udp", "ssh", "tls", "ssl", "jwt", "aws", "gcp"]);
+function titleCase(str) {
+    return str
+        .split("-")
+        .map(w => ACRONYMS.has(w.toLowerCase()) ? w.toUpperCase() : w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
 /**
  * Map service type to agent color
  */
@@ -97,7 +104,7 @@ No other services registered yet. When services are onboarded, you'll be able to
         const peerTable = peers
             .map((p) => {
             const whenToUse = getWhenToUseForType(p.type);
-            return `| @peer-service-${p.name} | ${p.type} | ${whenToUse} |`;
+            return `| @${p.name} | ${p.type} | ${whenToUse} |`;
         })
             .join("\n");
         return `## Peer Services Available
@@ -112,15 +119,15 @@ ${peerTable}
 
 **Direct @-mention (preferred):**
 \`\`\`
-@peer-service-formation can you generate a landing page?
-@peer-service-context-hub what changed system-wide in last 24h?
+@formation can you generate a landing page?
+@context-hub what changed system-wide in last 24h?
 \`\`\`
 
 **MCP fallback (if agent spawning unavailable):**
 \`\`\`
-service_peer_call("peer-service-formation", "generate", {...})
+service_peer_call("formation", "generate", {...})
 service_peer_list()  # List all peers
-service_peer_status("peer-service-formation")  # Check status
+service_peer_status("formation")  # Check status
 \`\`\`
 
 ### When to Collaborate vs Handle Alone
@@ -166,7 +173,7 @@ function getWhenToUseForType(type) {
  * Generate agent definition content
  */
 export function generateAgentDefinition(metadata, servicePath, gtmPath) {
-    const name = `service-${metadata.name}`;
+    const name = metadata.name;
     const color = getAgentColor(metadata.type);
     const capabilities = generateCapabilities(metadata, servicePath);
     const safetyGates = generateSafetyGates(metadata);
@@ -196,20 +203,23 @@ export function writeAgentDefinition(agentDef, gtmPath) {
         mkdirSync(agentsDir, { recursive: true });
     }
     const agentFile = join(agentsDir, `${agentDef.name}.md`);
+    const label = titleCase(agentDef.name);
     const content = `---
 name: ${agentDef.name}
+label: ${label}
 version: 1.0.0
 color: ${agentDef.color}
+type: service
 description: ${agentDef.description}
 ---
 
-# Service Agent: ${agentDef.name}
+# ${label}
 
 **Working Directory:** \`${agentDef.workingDirectory}\`
 
 ## Your Role
 
-You are the service agent for **${agentDef.name}**. You manage this service's codebase, operations, and integration with the GTM ecosystem.
+You are the service agent for **${label}**. You manage this service's codebase, operations, and integration with the GTM ecosystem.
 
 ## Knowledge Base
 
@@ -283,7 +293,7 @@ You can be invoked via:
 
 When spawned, the GTM agent may provide context from GTM knowledge docs. Use this to align with overall strategy.
 
-${generatePeerServicesSection(agentDef.name.replace("service-", ""), gtmPath)}
+${generatePeerServicesSection(agentDef.name, gtmPath)}
 
 ## Example Requests
 
@@ -328,4 +338,48 @@ cat .jfl/journal/*.jsonl | tail -5
     writeFileSync(agentFile, content);
     return agentFile;
 }
+/**
+ * Migrate old-style agent files (service-*.md, peer-service-*.md) to clean names.
+ * Renames files and updates frontmatter in place.
+ */
+export function migrateAgentFiles(agentsDir) {
+    const result = { renamed: [] };
+    if (!existsSync(agentsDir))
+        return result;
+    const files = readdirSync(agentsDir).filter((f) => f.endsWith(".md"));
+    for (const file of files) {
+        let newName = null;
+        if (file.startsWith("service-")) {
+            newName = file.replace(/^service-/, "");
+        }
+        else if (file.startsWith("peer-service-")) {
+            newName = file.replace(/^peer-service-/, "");
+        }
+        if (!newName || newName === file)
+            continue;
+        const oldPath = join(agentsDir, file);
+        const newPath = join(agentsDir, newName);
+        if (existsSync(newPath))
+            continue;
+        let content = readFileSync(oldPath, "utf-8");
+        const oldId = file.replace(/\.md$/, "");
+        const newId = newName.replace(/\.md$/, "");
+        const label = titleCase(newId);
+        content = content.replace(`name: ${oldId}`, `name: ${newId}`);
+        if (!content.includes("label:")) {
+            content = content.replace(`name: ${newId}`, `name: ${newId}\nlabel: ${label}`);
+        }
+        if (!content.includes("type: service") && !content.includes("type: peer-service")) {
+            const type = oldId.startsWith("peer-service-") ? "peer-service" : "service";
+            content = content.replace(`name: ${newId}`, `name: ${newId}\ntype: ${type}`);
+        }
+        content = content.replace(new RegExp(`@${oldId}\\b`, "g"), `@${newId}`);
+        content = content.replace(new RegExp(`# Service Agent: ${oldId}`, "g"), `# ${label}`);
+        content = content.replace(new RegExp(`# Peer Service: ${oldId}`, "g"), `# ${label}`);
+        writeFileSync(newPath, content);
+        unlinkSync(oldPath);
+        result.renamed.push({ from: file, to: newName });
+    }
+    return result;
+}
 //# sourceMappingURL=agent-generator.js.map

package/dist/lib/agent-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-generator.js","sourceRoot":"","sources":["../../src/lib/agent-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-generator.js","sourceRoot":"","sources":["../../src/lib/agent-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAChG,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;AAErN,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClG,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAYD;;GAEG;AACH,SAAS,aAAa,CAAC,IAA6B;IAClD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,OAAO,CAAA,CAAC,wBAAwB;QACzC,KAAK,gBAAgB;YACnB,OAAO,QAAQ,CAAA,CAAC,sBAAsB;QACxC,KAAK,WAAW;YACd,OAAO,MAAM,CAAA,CAAC,wBAAwB;QACxC,KAAK,KAAK;YACR,OAAO,OAAO,CAAA,CAAC,iBAAiB;QAClC;YACE,OAAO,OAAO,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,QAAyB,EACzB,WAAmB;IAEnB,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,sBAAsB;IACtB,IAAI,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;IAC1E,IAAI,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;IACtD,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IACzC,IAAI,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAA;IAE7D,6BAA6B;IAC7B,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;QAC7C,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAA;QAC1C,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;QACzC,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAA;QAC/D,IAAI,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;QAC9C,IAAI,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAA;QAClD,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,QAAyB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,iDAAiD;IACjD,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAA;IAC3D,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAA;IAErG,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;IAC7E,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAA;IAClE,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAAC,kBAA0B,EAAE,OAAe;IAC9E,kDAAkD;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;IAEvD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO;;;4DAGiD,CAAA;IAC1D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;QAClE,MAAM,kBAAkB,GAAG,SAAS,CAAC,mBAAmB,IAAI,EAAE,CAAA;QAE9D,6BAA6B;QAC7B,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CACrC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CACnE,CAAA;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;;iGAEoF,CAAA;QAC7F,CAAC;QAED,+BAA+B;QAC/B,MAAM,SAAS,GAAG,KAAK;aACpB,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;YACd,MAAM,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YAC7C,OAAO,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,SAAS,IAAI,CAAA;QACpD,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAA;QAEb,OAAO;;;;;;EAMT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA2BmB,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;;4DAEiD,CAAA;IAC1D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK;YACR,OAAO,oBAAoB,CAAA;QAC7B,KAAK,KAAK;YACR,OAAO,mBAAmB,CAAA;QAC5B,KAAK,QAAQ;YACX,OAAO,iBAAiB,CAAA;QAC1B,KAAK,gBAAgB;YACnB,OAAO,uBAAuB,CAAA;QAChC,KAAK,WAAW;YACd,OAAO,eAAe,CAAA;QACxB,KAAK,KAAK;YACR,OAAO,gBAAgB,CAAA;QACzB;YACE,OAAO,eAAe,CAAA;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAyB,EACzB,WAAmB,EACnB,OAAe;IAEf,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC1B,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAChE,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAEjD,MAAM,aAAa,GAAG;QACpB,0CAA0C;QAC1C,kCAAkC;QAClC,uCAAuC;QACvC,gCAAgC;KACjC,CAAA;IAED,OAAO;QACL,IAAI;QACJ,KAAK;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,YAAY;QACZ,WAAW;QACX,gBAAgB,EAAE,WAAW;QAC7B,aAAa;KACd,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAyB,EACzB,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAEjD,0BAA0B;IAC1B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAA;IAExD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEtC,MAAM,OAAO,GAAG;QACV,QAAQ,CAAC,IAAI;SACZ,KAAK;;SAEL,QAAQ,CAAC,KAAK;;eAER,QAAQ,CAAC,WAAW;;;IAG/B,KAAK;;2BAEkB,QAAQ,CAAC,gBAAgB;;;;kCAIlB,KAAK;;;;;;EAMrC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;0BAEtC,QAAQ,CAAC,gBAAgB;;;;;;EAMjD,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAIzD,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;gBAoB5C,QAAQ,CAAC,IAAI;;;;;;;;;;;;;SAapB,QAAQ,CAAC,gBAAgB;wDACsB,QAAQ,CAAC,IAAI;;;;;;;;;SAS5D,QAAQ,CAAC,gBAAgB;;;;;;;;gCAQF,QAAQ,CAAC,IAAI;6BAChB,QAAQ,CAAC,IAAI;;;;EAIxC,2BAA2B,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCpD,CAAA;IAEC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAEjC,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,MAAM,GAAqD,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IAEhF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,MAAM,CAAA;IAEzC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAE7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,GAAkB,IAAI,CAAA;QAEjC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;QACzC,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;QAC9C,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI;YAAE,SAAQ;QAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAExC,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,SAAQ;QAEjC,IAAI,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE5C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAE9B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,KAAK,EAAE,EAAE,SAAS,KAAK,EAAE,CAAC,CAAA;QAE7D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,KAAK,EAAE,EAAE,SAAS,KAAK,YAAY,KAAK,EAAE,CAAC,CAAA;QAChF,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAA;YAC3E,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,KAAK,EAAE,EAAE,SAAS,KAAK,WAAW,IAAI,EAAE,CAAC,CAAA;QAC9E,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC,CAAA;QACvE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,oBAAoB,KAAK,EAAE,EAAE,GAAG,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC,CAAA;QACrF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,mBAAmB,KAAK,EAAE,EAAE,GAAG,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC,CAAA;QAEpF,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC/B,UAAU,CAAC,OAAO,CAAC,CAAA;QAEnB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IAClD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/lib/agent-session.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Agent Session
+ *
+ * Session lifecycle management following Karpathy's autoresearch loop:
+ * branch → change → eval → keep|revert → repeat
+ *
+ * Git as state machine: keep = advance branch, discard = git reset --hard HEAD~1
+ * results.tsv is NOT committed (append-only local log)
+ *
+ * @purpose Manage scoped agent session lifecycle with git-based state tracking
+ */
+import type { AgentConfig } from "./agent-config.js";
+import { type EvalSnapshot } from "./eval-snapshot.js";
+import type { RLState, RLAction } from "./training-buffer.js";
+export interface ExperimentEntry {
+    round: number;
+    task: string;
+    metricBefore: number;
+    metricAfter: number;
+    delta: number;
+    kept: boolean;
+    files: string[];
+    timestamp: string;
+}
+/**
+ * Build experiment history markdown for the agent to read.
+ * This is the KEY missing piece — agents need memory of past experiments.
+ *
+ * Following Karpathy's autoresearch pattern: agent sees program.md with
+ * instructions + history of past experiments so it knows what to try next.
+ */
+export declare function buildExperimentHistory(session: AgentSession, transitions: Transition[], currentMetric: number): string;
+/**
+ * Write experiment history to the worktree as EXPERIMENTS.md.
+ * Claude Code will read this file to understand what has been tried.
+ */
+export declare function writeExperimentHistory(session: AgentSession, transitions: Transition[], currentMetric: number): void;
+/**
+ * Read experiment history from the worktree.
+ * Returns empty string if file doesn't exist.
+ */
+export declare function readExperimentHistory(session: AgentSession): string;
+export interface AgentSession {
+    id: string;
+    agentName: string;
+    config: AgentConfig;
+    projectRoot: string;
+    evalRoot: string;
+    worktreePath: string;
+    branch: string;
+    baseBranch: string;
+    evalSnapshot: EvalSnapshot;
+    baselineMetric: number;
+    startedAt: string;
+    resultsPath: string;
+    round: number;
+    status: "active" | "completed" | "failed";
+}
+export interface RoundResult {
+    round: number;
+    task: string;
+    hypothesis: string;
+    metricBefore: number;
+    metricAfter: number;
+    delta: number;
+    kept: boolean;
+    duration_ms: number;
+    error?: string;
+}
+export interface Transition {
+    agent: string;
+    session_id: string;
+    state_hash: string;
+    state: RLState;
+    action_diff: string;
+    action: RLAction;
+    hypothesis: string;
+    reward: number;
+    timestamp: string;
+}
+export interface SessionSummary {
+    session_id: string;
+    agentName: string;
+    rounds: number;
+    baseline: number;
+    finalMetric: number;
+    totalDelta: number;
+    bestDelta: number;
+    improvedRounds: number;
+    transitions: Transition[];
+    prUrl?: string;
+    branchUrl?: string;
+}
+export declare function startSession(config: AgentConfig, projectRoot: string, baseBranch?: string): AgentSession;
+export declare function runBaseline(session: AgentSession): Promise<number>;
+export declare function runRound(session: AgentSession, round: number, task: string, hypothesis: string, previousTransitions?: Transition[]): Promise<{
+    result: RoundResult;
+    transition: Transition;
+}>;
+export declare function endSession(session: AgentSession, transitions: Transition[]): Promise<SessionSummary>;
+export declare function loadSessionState(projectRoot: string, sessionId: string): AgentSession | null;
+export declare function saveSessionState(session: AgentSession): void;
+export declare function listActiveSessions(projectRoot: string): string[];
+//# sourceMappingURL=agent-session.d.ts.map

package/dist/lib/agent-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../src/lib/agent-session.ts"],"names":[],"mappings":"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"}