herdctl 0.0.1 → 0.0.2

package/dist/commands/init.js

@@ -0,0 +1,305 @@
+/**
+ * herdctl init - Initialize a new herdctl project
+ *
+ * Scaffolds a new project with:
+ * - herdctl.yaml configuration file
+ * - agents/ directory with example agent
+ * - .herdctl/ state directory
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { input, confirm, select } from "@inquirer/prompts";
+const TEMPLATES = {
+    simple: {
+        name: "simple",
+        description: "A basic fleet with one agent that runs on a schedule",
+        fleetConfig: `# herdctl fleet configuration
+#
+# This file defines your agent fleet.
+# Run \`herdctl start\` to start all agents.
+
+version: 1
+
+fleet:
+  name: {{FLEET_NAME}}
+  description: {{FLEET_DESCRIPTION}}
+
+defaults:
+  model: claude-sonnet-4-20250514
+  max_turns: 50
+  permission_mode: default
+
+agents:
+  - path: ./agents/example-agent.yaml
+`,
+        agentConfig: `# Example agent configuration
+#
+# This agent runs on a schedule and can be customized
+# to perform various tasks.
+
+name: example-agent
+description: An example agent
+
+# System prompt defines the agent's behavior
+system_prompt: |
+  You are a helpful assistant. When triggered,
+  analyze the task and provide a useful response.
+
+# Workspace - where the agent operates
+workspace:
+  path: ./workspace
+
+# Schedules - when the agent runs
+schedules:
+  heartbeat:
+    type: interval
+    interval: 5m
+    prompt: |
+      Report the current status and any pending tasks.
+      Keep your response brief.
+
+# Permissions - what the agent can do
+permissions:
+  allowed_tools:
+    - Read
+    - Glob
+    - Grep
+    - Edit
+    - Write
+`,
+        agentFilename: "example-agent.yaml",
+    },
+    quickstart: {
+        name: "quickstart",
+        description: "Minimal setup - a single agent that says hello",
+        fleetConfig: `# herdctl fleet configuration
+#
+# Minimal configuration to get started quickly.
+
+version: 1
+
+fleet:
+  name: {{FLEET_NAME}}
+
+agents:
+  - path: ./agents/hello-agent.yaml
+`,
+        agentConfig: `# Hello Agent
+#
+# A simple agent that demonstrates basic scheduling.
+
+name: hello-agent
+description: A simple agent that says hello
+
+schedules:
+  greet:
+    type: interval
+    interval: 30s
+    prompt: |
+      Say hello and report the current date and time.
+      Keep your response brief (1-2 sentences).
+`,
+        agentFilename: "hello-agent.yaml",
+    },
+    github: {
+        name: "github",
+        description: "Agent that processes GitHub issues with 'ready' label",
+        fleetConfig: `# herdctl fleet configuration
+#
+# Fleet configured to process GitHub issues.
+
+version: 1
+
+fleet:
+  name: {{FLEET_NAME}}
+  description: {{FLEET_DESCRIPTION}}
+
+defaults:
+  model: claude-sonnet-4-20250514
+  max_turns: 100
+  permission_mode: acceptEdits
+
+agents:
+  - path: ./agents/github-agent.yaml
+`,
+        agentConfig: `# GitHub Issue Agent
+#
+# Processes issues labeled 'ready' from a GitHub repository.
+# Set GITHUB_TOKEN environment variable for authentication.
+
+name: github-agent
+description: Processes GitHub issues
+
+system_prompt: |
+  You are a developer assistant. When given an issue to work on,
+  analyze the requirements and implement the requested changes.
+  Follow best practices and write clean, tested code.
+
+workspace:
+  path: ./workspace
+
+schedules:
+  process-issues:
+    type: interval
+    interval: 5m
+    work_source:
+      type: github_issues
+      repo: your-org/your-repo  # TODO: Update this
+      labels:
+        include: ["ready"]
+        exclude: ["blocked", "wip"]
+      claim_label: in-progress
+      complete_action: close
+
+permissions:
+  allowed_tools:
+    - Read
+    - Glob
+    - Grep
+    - Edit
+    - Write
+    - Bash(git *)
+    - Bash(npm *)
+    - Bash(pnpm *)
+`,
+        agentFilename: "github-agent.yaml",
+    },
+};
+const DEFAULT_TEMPLATE = "simple";
+export async function initCommand(options) {
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, "herdctl.yaml");
+    const agentsDir = path.join(cwd, "agents");
+    const stateDir = path.join(cwd, ".herdctl");
+    const gitignorePath = path.join(cwd, ".gitignore");
+    // Check if config already exists
+    if (fs.existsSync(configPath) && !options.force) {
+        console.error("Error: herdctl.yaml already exists. Use --force to overwrite.");
+        process.exit(1);
+    }
+    // Determine the template to use
+    let templateName = options.example || DEFAULT_TEMPLATE;
+    if (options.example && !TEMPLATES[options.example]) {
+        console.error(`Error: Unknown example template '${options.example}'.`);
+        console.error(`Available templates: ${Object.keys(TEMPLATES).join(", ")}`);
+        process.exit(1);
+    }
+    // Interactive mode if not --yes and missing required info
+    let fleetName = options.name;
+    let fleetDescription = "";
+    if (!options.yes) {
+        // Ask for fleet name if not provided
+        if (!fleetName) {
+            fleetName = await input({
+                message: "Fleet name:",
+                default: path.basename(cwd),
+                validate: (value) => {
+                    if (!value.trim())
+                        return "Fleet name is required";
+                    if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(value)) {
+                        return "Fleet name must start with a letter and contain only letters, numbers, hyphens, and underscores";
+                    }
+                    return true;
+                },
+            });
+        }
+        // Ask for description
+        fleetDescription = await input({
+            message: "Fleet description (optional):",
+            default: "",
+        });
+        // Ask for template if not specified
+        if (!options.example) {
+            templateName = await select({
+                message: "Choose a template:",
+                choices: Object.entries(TEMPLATES).map(([key, template]) => ({
+                    name: `${template.name} - ${template.description}`,
+                    value: key,
+                })),
+                default: DEFAULT_TEMPLATE,
+            });
+        }
+        // Confirm before proceeding
+        console.log("");
+        console.log("Will create:");
+        console.log(`  - herdctl.yaml (${templateName} template)`);
+        console.log(`  - agents/ directory with example agent`);
+        console.log(`  - .herdctl/ state directory`);
+        console.log("");
+        const proceed = await confirm({
+            message: "Proceed?",
+            default: true,
+        });
+        if (!proceed) {
+            console.log("Aborted.");
+            process.exit(0);
+        }
+    }
+    else {
+        // In --yes mode, use defaults
+        fleetName = fleetName || path.basename(cwd);
+    }
+    const template = TEMPLATES[templateName];
+    // Create agents directory
+    if (!fs.existsSync(agentsDir)) {
+        fs.mkdirSync(agentsDir, { recursive: true });
+    }
+    // Create .herdctl directory
+    if (!fs.existsSync(stateDir)) {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    // Generate fleet config from template
+    const fleetConfig = template.fleetConfig
+        .replace(/\{\{FLEET_NAME\}\}/g, fleetName)
+        .replace(/\{\{FLEET_DESCRIPTION\}\}/g, fleetDescription || `A herdctl fleet`);
+    // Write fleet config
+    fs.writeFileSync(configPath, fleetConfig, "utf-8");
+    // Write agent config
+    const agentPath = path.join(agentsDir, template.agentFilename);
+    if (!fs.existsSync(agentPath) || options.force) {
+        fs.writeFileSync(agentPath, template.agentConfig, "utf-8");
+    }
+    // Update .gitignore if it exists
+    if (fs.existsSync(gitignorePath)) {
+        const gitignoreContent = fs.readFileSync(gitignorePath, "utf-8");
+        const linesToAdd = [];
+        if (!gitignoreContent.includes(".herdctl/")) {
+            linesToAdd.push(".herdctl/");
+        }
+        if (linesToAdd.length > 0) {
+            const newContent = gitignoreContent.trimEnd() +
+                "\n\n# herdctl state directory\n" +
+                linesToAdd.join("\n") +
+                "\n";
+            fs.writeFileSync(gitignorePath, newContent, "utf-8");
+        }
+    }
+    // Print success message and next steps
+    console.log("");
+    console.log("✓ Initialized herdctl project");
+    console.log("");
+    console.log("Created:");
+    console.log(`  herdctl.yaml`);
+    console.log(`  agents/${template.agentFilename}`);
+    console.log(`  .herdctl/`);
+    console.log("");
+    console.log("Next steps:");
+    console.log("");
+    console.log("  1. Review and customize your configuration:");
+    console.log("     - herdctl.yaml (fleet settings)");
+    console.log(`     - agents/${template.agentFilename} (agent definition)`);
+    console.log("");
+    console.log("  2. Start your fleet:");
+    console.log("     $ herdctl start");
+    console.log("");
+    console.log("  3. Check status:");
+    console.log("     $ herdctl status");
+    console.log("");
+    if (templateName === "github") {
+        console.log("  Note: Update the 'repo' field in your agent config");
+        console.log("  and set the GITHUB_TOKEN environment variable.");
+        console.log("");
+    }
+    console.log("Documentation: https://herdctl.dev");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/job.d.ts

@@ -0,0 +1,19 @@
+/**
+ * herdctl job - Show job details and logs
+ *
+ * Commands:
+ * - herdctl job <id>          Show job details
+ * - herdctl job <id> --logs   Show job output
+ * - herdctl job <id> --json   JSON output
+ */
+export interface JobOptions {
+    logs?: boolean;
+    json?: boolean;
+    state?: string;
+    config?: string;
+}
+/**
+ * Show job details (herdctl job)
+ */
+export declare function jobCommand(jobId: string, options: JobOptions): Promise<void>;
+//# sourceMappingURL=job.d.ts.map

package/dist/commands/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/commands/job.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoSD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA2Of"}