@10et/cli 1.0.0

package/dist/lib/agent-generator.js

@@ -0,0 +1,400 @@
+/**
+ * Agent Generator
+ *
+ * Generates service agent definitions in GTM .claude/agents/ directory
+ *
+ * @purpose Generate service agent definitions for GTM integration
+ */
+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
+ */
+function getAgentColor(type) {
+    switch (type) {
+        case "web":
+        case "api":
+        case "worker":
+            return "green"; // Implementation agents
+        case "agent":
+            return "purple"; // Autonomous agents
+        case "infrastructure":
+            return "purple"; // Coordination agents
+        case "container":
+            return "blue"; // Strategic/data agents
+        case "cli":
+            return "green"; // Implementation
+        default:
+            return "green";
+    }
+}
+/**
+ * Generate capabilities based on service type
+ */
+function generateCapabilities(metadata, servicePath) {
+    const caps = [];
+    // Common capabilities
+    caps.push("Read and understand service architecture from knowledge/ docs");
+    caps.push("Update service status in .jfl/status.json");
+    caps.push("Emit events to GTM event bus");
+    caps.push("Write journal entries for significant operations");
+    // Type-specific capabilities
+    if (metadata.type === "web" || metadata.type === "api") {
+        caps.push("Start, stop, restart the service");
+        caps.push("Check service health and logs");
+        caps.push("Deploy updates to production");
+        caps.push("Run tests and validate changes");
+    }
+    if (metadata.type === "container") {
+        caps.push("Manage Docker containers (start, stop, logs, exec)");
+        caps.push("Inspect container health and resource usage");
+        caps.push("Update container configuration");
+    }
+    if (metadata.type === "infrastructure") {
+        caps.push("Monitor service status across GTM");
+        caps.push("Perform health checks and diagnostics");
+        caps.push("Execute cleanup and maintenance operations");
+    }
+    if (metadata.type === "agent") {
+        caps.push("Run autonomous eval loops (context → plan → execute → eval)");
+        caps.push("Load and query project context from Context Hub");
+        caps.push("Run eval scripts and measure metric deltas");
+        caps.push("Make focused code changes within scope constraints");
+        caps.push("Record training tuples for policy head");
+    }
+    return caps;
+}
+/**
+ * Generate safety gates for operations that require approval
+ */
+function generateSafetyGates(metadata) {
+    const gates = [];
+    // Destructive operations always require approval
+    gates.push("Deploy to production - requires user approval");
+    gates.push("Destructive operations (force push, delete data, etc.) - requires explicit confirmation");
+    if (metadata.type === "container") {
+        gates.push("Container restart - confirm first unless health check failing");
+    }
+    if (metadata.type === "infrastructure") {
+        gates.push("Cleanup operations - verify scope before execution");
+    }
+    if (metadata.type === "agent") {
+        gates.push("Changes outside files_in_scope - requires explicit approval");
+        gates.push("Cost exceeding budget - pause and report");
+    }
+    return gates;
+}
+/**
+ * Generate peer services section for service CLAUDE.md
+ */
+function generatePeerServicesSection(currentServiceName, gtmPath) {
+    // Try to load registered services from GTM config
+    const gtmConfigPath = join(gtmPath, ".jfl/config.json");
+    if (!existsSync(gtmConfigPath)) {
+        return `## Peer Services Available
+
+You can collaborate with other services in this GTM workspace.
+Run \`jfl services sync-agents\` to discover peer services.`;
+    }
+    try {
+        const gtmConfig = JSON.parse(readFileSync(gtmConfigPath, "utf-8"));
+        const registeredServices = gtmConfig.registered_services || [];
+        // Filter out current service
+        const peers = registeredServices.filter((s) => s.name !== currentServiceName && s.status === "active");
+        if (peers.length === 0) {
+            return `## Peer Services Available
+
+No other services registered yet. When services are onboarded, you'll be able to @ mention them.`;
+        }
+        // Generate peer services table
+        const peerTable = peers
+            .map((p) => {
+            const whenToUse = getWhenToUseForType(p.type);
+            return `| @${p.name} | ${p.type} | ${whenToUse} |`;
+        })
+            .join("\n");
+        return `## Peer Services Available
+
+You can collaborate with other services in this GTM workspace:
+
+| Peer Service | Type | When to Use |
+|--------------|------|-------------|
+${peerTable}
+
+### How to Collaborate
+
+**Direct @-mention (preferred):**
+\`\`\`
+@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("formation", "generate", {...})
+service_peer_list()  # List all peers
+service_peer_status("formation")  # Check status
+\`\`\`
+
+### When to Collaborate vs Handle Alone
+
+**Collaborate when:**
+- Task outside your service's core responsibility
+- Need data/context from another service
+- Coordinating multi-service operation
+
+**Handle alone when:**
+- Task within your service's domain
+- Operation is service-local
+- You have all needed context`;
+    }
+    catch {
+        return `## Peer Services Available
+
+Run \`jfl services sync-agents\` to discover peer services.`;
+    }
+}
+/**
+ * Get "When to Use" guidance for a service type
+ */
+function getWhenToUseForType(type) {
+    switch (type) {
+        case "api":
+            return "API data/endpoints";
+        case "web":
+            return "Frontend/UI tasks";
+        case "worker":
+            return "Background jobs";
+        case "infrastructure":
+            return "System health/metrics";
+        case "container":
+            return "Container ops";
+        case "cli":
+            return "CLI automation";
+        case "agent":
+            return "Autonomous tasks/eval loops";
+        default:
+            return "Service tasks";
+    }
+}
+/**
+ * Generate agent definition content
+ */
+export function generateAgentDefinition(metadata, servicePath, gtmPath) {
+    const name = metadata.name;
+    const color = getAgentColor(metadata.type);
+    const capabilities = generateCapabilities(metadata, servicePath);
+    const safetyGates = generateSafetyGates(metadata);
+    const knowledgeDocs = [
+        "SERVICE_SPEC.md - What this service does",
+        "ARCHITECTURE.md - How it's built",
+        "DEPLOYMENT.md - How to deploy/restart",
+        "RUNBOOK.md - Common operations",
+    ];
+    return {
+        name,
+        color,
+        description: metadata.description,
+        capabilities,
+        safetyGates,
+        workingDirectory: servicePath,
+        knowledgeDocs,
+    };
+}
+/**
+ * Write agent definition to GTM repo
+ */
+export function writeAgentDefinition(agentDef, gtmPath) {
+    const agentsDir = join(gtmPath, ".claude/agents");
+    // Ensure directory exists
+    if (!existsSync(agentsDir)) {
+        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}
+---
+
+# ${label}
+
+**Working Directory:** \`${agentDef.workingDirectory}\`
+
+## Your Role
+
+You are the service agent for **${label}**. You manage this service's codebase, operations, and integration with the GTM ecosystem.
+
+## Knowledge Base
+
+Before handling requests, read your knowledge docs to understand the service:
+
+${agentDef.knowledgeDocs.map((doc) => `- **${doc}**`).join("\n")}
+
+These are located in: \`${agentDef.workingDirectory}/knowledge/\`
+
+## Capabilities
+
+You can:
+
+${agentDef.capabilities.map((cap) => `- ${cap}`).join("\n")}
+
+## Safety Gates (Require User Approval)
+
+${agentDef.safetyGates.map((gate) => `- ${gate}`).join("\n")}
+
+## Workflow
+
+When you receive a request:
+
+1. **Read knowledge docs** to understand context
+2. **Check current status** (\`.jfl/status.json\`)
+3. **Perform the operation**
+4. **Update status** with changes
+5. **Emit event** to GTM event bus
+6. **Write journal entry** if significant
+7. **Respond** with what you did
+
+## Status Updates
+
+Update \`.jfl/status.json\` after operations:
+
+\`\`\`json
+{
+  "service": "${agentDef.name}",
+  "status": "running|stopped|error",
+  "last_updated": "ISO timestamp",
+  "recent_changes": ["array", "of", "changes"],
+  "health": "healthy|degraded|error"
+}
+\`\`\`
+
+## Event Emission
+
+Emit events to GTM event bus for coordination:
+
+\`\`\`bash
+cat >> ${agentDef.workingDirectory}/.jfl/service-events.jsonl << EOF
+{"ts":"$(date -u +%Y-%m-%dT%H:%M:%S.000Z)","service":"${agentDef.name}","type":"update|deploy|restart|error","message":"...", "session":"..."}
+EOF
+\`\`\`
+
+## Journal Entries
+
+Write journal entries for significant operations:
+
+\`\`\`bash
+cat >> ${agentDef.workingDirectory}/.jfl/journal/\${SESSION}.jsonl << EOF
+{"v":1,"ts":"...","session":"...","type":"feature|fix|deployment","title":"...","summary":"...","detail":"..."}
+EOF
+\`\`\`
+
+## Communication with GTM
+
+You can be invoked via:
+- **@-mention**: User says \`@${agentDef.name} <request>\` in GTM Claude session
+- **/skill**: User runs \`/${agentDef.name} <subcommand>\` skill
+
+When spawned, the GTM agent may provide context from GTM knowledge docs. Use this to align with overall strategy.
+
+${generatePeerServicesSection(agentDef.name, gtmPath)}
+
+## Example Requests
+
+**"What's your current status?"**
+\`\`\`bash
+cat .jfl/status.json
+\`\`\`
+
+**"Show me recent changes"**
+\`\`\`bash
+git log --oneline -10
+cat .jfl/journal/*.jsonl | tail -5
+\`\`\`
+
+**"Restart the service"**
+1. Check if safe to restart
+2. Run stop command
+3. Run start command
+4. Verify health
+5. Update status
+6. Emit event
+7. Respond with outcome
+
+**"Deploy to production"**
+1. Ask user for confirmation (safety gate!)
+2. Run tests if available
+3. Run deploy command
+4. Monitor deployment
+5. Update status
+6. Emit event
+7. Write journal entry
+8. Respond with outcome
+
+## Remember
+
+- **Read knowledge docs first** - Don't guess, understand the service
+- **Safety gates matter** - Get approval for risky operations
+- **Status transparency** - Always update status.json
+- **Emit events** - Let GTM know what you're doing
+- **Journal significant work** - Help future sessions understand what happened
+`;
+    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

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

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

@@ -0,0 +1,67 @@
+/**
+ * Agent Guards
+ *
+ * Pre-flight checks that run before an agent session starts.
+ * Implements the TOCTOU guard pattern used elsewhere (hub-health.ts, planning-loop.ts)
+ * but scoped to the agent runner lifecycle.
+ *
+ * Guards are composable: each returns a GuardResult, and runGuards() aggregates them.
+ * Non-critical guards warn but don't block; critical guards abort the session.
+ *
+ * @purpose Pre-flight guard checks for scoped agent runner sessions
+ * @invariant HubRequiredForScheduling (SystemSpec.tla)
+ */
+import type { AgentConfig } from "./agent-config.js";
+export interface GuardResult {
+    /** Guard name for logging */
+    name: string;
+    /** Whether the guard passed */
+    passed: boolean;
+    /** Whether this guard is critical (blocks session) or advisory (warns only) */
+    critical: boolean;
+    /** Human-readable reason if guard failed */
+    reason?: string;
+}
+export interface GuardSummary {
+    /** Whether all critical guards passed — safe to proceed */
+    proceed: boolean;
+    /** Individual guard results */
+    results: GuardResult[];
+    /** Failed critical guards */
+    blockers: GuardResult[];
+    /** Failed non-critical guards (warnings) */
+    warnings: GuardResult[];
+}
+/**
+ * Guard: Hub must be reachable before starting an agent session.
+ * Critical: false — agents can run without hub, but results won't be tracked.
+ *
+ * Re-implements the TOCTOU pattern from hub-health.ts for the agent runner path.
+ */
+export declare function guardHub(projectRoot: string): Promise<GuardResult>;
+/**
+ * Guard: No concurrent session for the same agent.
+ * Critical: true — running two sessions on the same agent causes git conflicts.
+ */
+export declare function guardNoConcurrentSession(projectRoot: string, agentName: string): GuardResult;
+/**
+ * Guard: Eval script and data files must exist.
+ * Critical: true — agent can't measure improvement without eval.
+ */
+export declare function guardEvalReady(projectRoot: string, config: AgentConfig): GuardResult;
+/**
+ * Guard: No stale worktree for this agent.
+ * Critical: true — stale worktrees cause git worktree add to fail.
+ */
+export declare function guardWorktreeClean(projectRoot: string, agentName: string): GuardResult;
+/**
+ * Guard: Git repo must be in a clean state for the base branch.
+ * Critical: false — uncommitted changes are stashed by agent-session.
+ */
+export declare function guardGitClean(projectRoot: string): GuardResult;
+/**
+ * Run all guards for an agent session.
+ * Returns a summary with proceed/blockers/warnings.
+ */
+export declare function runGuards(projectRoot: string, agentName: string, config: AgentConfig): Promise<GuardSummary>;
+//# sourceMappingURL=agent-guards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guards.d.ts","sourceRoot":"","sources":["../../src/lib/agent-guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAMpD,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAA;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAA;IAChB,+BAA+B;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,6BAA6B;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,4CAA4C;IAC5C,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB;AAMD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BxE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,WAAW,CA2Cb;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,WAAW,CAuBb;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,WAAW,CA6Db;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAmB9D;AAMD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAuBvB"}