@made-by-moonlight/athene-core 0.9.1

package/dist/process-cache.js

@@ -0,0 +1,44 @@
+/**
+ * Process-scoped async memoization for expensive checks shared across plugins.
+ *
+ * Use cases: prerequisite checks (binary present, auth valid) that multiple
+ * plugins want to perform but only need to actually run once per CLI
+ * invocation. Cache key chooses the dedup boundary — plugins that share a
+ * key share the result.
+ *
+ * Both successes and failures are cached: if a check fails the user must fix
+ * the underlying issue and re-run, so re-checking within the same process is
+ * pointless and would muddy the error stream with duplicate messages.
+ *
+ * **Key namespacing convention:**
+ *
+ * The cache is shared across every caller in the process, so two plugins
+ * passing the same key are explicitly opting into shared state. That is the
+ * intended use for cross-cutting checks like the `gh` CLI auth status (used
+ * by both `tracker-github` and `scm-github`).
+ *
+ * For plugin-internal caching (where you do *not* want sharing), namespace
+ * the key with your plugin name to avoid silent collisions:
+ *   - shared cross-plugin check: `"gh-cli-auth"` (intentional sharing)
+ *   - plugin-internal check:     `"tracker-github:rate-limit-check"`
+ *
+ * If two plugins use the same key for semantically different work, callers
+ * will silently receive each other's resolved values — a debugging nightmare.
+ * When in doubt, namespace.
+ */
+const cache = new Map();
+function memoizeAsync(key, fn) {
+    let cached = cache.get(key);
+    if (!cached) {
+        cached = fn();
+        cache.set(key, cached);
+    }
+    return cached;
+}
+/** Test-only — clears the process cache. */
+function _clearProcessCacheForTests() {
+    cache.clear();
+}
+
+export { _clearProcessCacheForTests, memoizeAsync };
+//# sourceMappingURL=process-cache.js.map

package/dist/process-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-cache.js","sources":["../src/process-cache.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AAEH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B;AAE3C,SAAU,YAAY,CAAI,GAAW,EAAE,EAAoB,EAAA;IAC/D,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,GAAG,EAAE,EAAE;AACb,QAAA,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC;IACxB;AACA,IAAA,OAAO,MAAoB;AAC7B;AAEA;SACgB,0BAA0B,GAAA;IACxC,KAAK,CAAC,KAAK,EAAE;AACf;;;;"}

package/dist/project-resolver.d.ts

@@ -0,0 +1,5 @@
+import { type DegradedProjectEntry, type LoadedConfig, type ProjectConfig } from "./types.js";
+import { type GlobalConfig } from "./global-config.js";
+export declare function loadEffectiveProjectConfig(projectId: string, globalConfig: GlobalConfig, globalConfigPath?: string): ProjectConfig;
+export declare function iterateAllProjects(config: LoadedConfig): Iterable<ProjectConfig | DegradedProjectEntry>;
+//# sourceMappingURL=project-resolver.d.ts.map

package/dist/project-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.d.ts","sourceRoot":"","sources":["../src/project-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/E,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,MAAM,GACxB,aAAa,CASf;AAED,wBAAiB,kBAAkB,CACjC,MAAM,EAAE,YAAY,GACnB,QAAQ,CAAC,aAAa,GAAG,oBAAoB,CAAC,CAGhD"}

package/dist/project-resolver.js

@@ -0,0 +1,20 @@
+import { ProjectResolveError } from './types.js';
+import { resolveProjectIdentity } from './global-config.js';
+
+function loadEffectiveProjectConfig(projectId, globalConfig, globalConfigPath) {
+    const resolved = resolveProjectIdentity(projectId, globalConfig);
+    if (!resolved) {
+        throw new ProjectResolveError(projectId, `Unknown project: ${projectId}`);
+    }
+    if (typeof resolved.resolveError === "string" && resolved.resolveError.length > 0) {
+        throw new ProjectResolveError(projectId, resolved.resolveError, resolved.resolveErrorKind);
+    }
+    return resolved;
+}
+function* iterateAllProjects(config) {
+    yield* Object.values(config.projects);
+    yield* Object.values(config.degradedProjects);
+}
+
+export { iterateAllProjects, loadEffectiveProjectConfig };
+//# sourceMappingURL=project-resolver.js.map

package/dist/project-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.js","sources":["../src/project-resolver.ts"],"sourcesContent":[null],"names":[],"mappings":";;;SAQgB,0BAA0B,CACxC,SAAiB,EACjB,YAA0B,EAC1B,gBAAyB,EAAA;IAEzB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,EAAE,YAA8B,CAAC;IAClF,IAAI,CAAC,QAAQ,EAAE;QACb,MAAM,IAAI,mBAAmB,CAAC,SAAS,EAAE,CAAA,iBAAA,EAAoB,SAAS,CAAA,CAAE,CAAC;IAC3E;AACA,IAAA,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;AACjF,QAAA,MAAM,IAAI,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC;IAC5F;AACA,IAAA,OAAO,QAAQ;AACjB;AAEM,UAAW,kBAAkB,CACjC,MAAoB,EAAA;IAEpB,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;AAC/C;;;;"}

package/dist/prompt-builder.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Prompt Builder — composes layered prompts for agent sessions.
+ *
+ * Three layers:
+ *   1. BASE_AGENT_PROMPT — constant instructions about session lifecycle, git workflow, PR handling
+ *   2. Config-derived context — project name, repo, default branch, tracker info, reaction rules
+ *   3. User rules — inline agentRules and/or agentRulesFile content
+ *
+ * buildPrompt() returns the split between persistent system instructions and
+ * task-specific text so callers can route them to agents separately.
+ */
+import type { ProjectConfig, SessionId } from "./types.js";
+export declare const BASE_AGENT_PROMPT = "You are an AI coding agent managed by the Athene (ao).\n\n## Session Lifecycle\n- You are running inside a managed session. Focus on the assigned task.\n- When you finish your work, create a PR and push it. The orchestrator will handle CI monitoring and review routing.\n- If you're told to take over or continue work on an existing PR, run `athene session claim-pr <pr-number-or-url>` from inside this session before making changes.\n- If CI fails, the orchestrator will send you the failures \u2014 fix them and push again.\n- If reviewers request changes, the orchestrator will forward their comments \u2014 address each one, push fixes, and reply to the comments.\n\n## Reporting Progress to AO\nThe orchestrator infers your status from runtime signals, but explicit reports are always preferred \u2014 they are accurate and fresh. Run these commands from the session shell (AO_SESSION_ID is pre-set for you):\n\n- `athene acknowledge` \u2014 run once after reading the initial task so AO knows you picked it up.\n- `athene report working` \u2014 declare you are actively making progress (useful after pauses or long thinking blocks).\n- `athene report waiting` \u2014 you are blocked on something AO cannot unblock on its own (e.g. waiting for a human, external service).\n- `athene report needs-input` \u2014 you need a decision or info from the human before proceeding.\n- `athene report fixing-ci` \u2014 you are working specifically on making CI green again.\n- `athene report addressing-reviews` \u2014 you are working on reviewer-requested changes.\n- `athene report pr-created --pr-url <url>` / `draft-pr-created` / `ready-for-review` \u2014 declare PR workflow milestones as soon as you create or update the PR.\n- `athene report completed` \u2014 you finished non-coding research or analysis work that doesn't produce a PR.\n\nRules:\n- Do NOT self-report `done`, `terminated`, or terminal PR states like `merged`/`closed` \u2014 AO owns those transitions via SCM ground truth.\n- A fresh report is trusted over weak inference but runtime death, activity-based waiting_input, and SCM events (merged/closed PR, CI failure, reviews) still take precedence.\n- Use `--note \"<text>\"` to attach a short rationale when the state change is non-obvious.\n\n## Git Workflow\n- Always create a feature branch from the default branch (never commit directly to it).\n- Use conventional commit messages (feat:, fix:, chore:, etc.).\n- Push your branch and create a PR when the implementation is ready.\n- Keep PRs focused \u2014 one issue per PR.\n\n## PR Best Practices\n- Write a clear PR title and description explaining what changed and why.\n- Link the issue in the PR description so it auto-closes when merged.\n- If the repo has CI checks, make sure they pass before requesting review.\n- Respond to every review comment, even if just to acknowledge it.";
+/** Trimmed base prompt for projects without a configured repo/remote. */
+export declare const BASE_AGENT_PROMPT_NO_REPO = "You are an AI coding agent managed by the Athene (ao).\n\n## Session Lifecycle\n- You are running inside a managed session. Focus on the assigned task.\n- No remote repository is configured \u2014 work locally. PR, CI, and review features are unavailable.\n\n## Reporting Progress to AO\nExplicit reports help the orchestrator track your state accurately. Run these from the session shell (AO_SESSION_ID is pre-set):\n- `athene acknowledge` \u2014 run once after reading the initial task.\n- `athene report working` / `waiting` / `needs-input` \u2014 declare your current phase.\n- `athene report pr-created --pr-url <url>` or `draft-pr-created` / `ready-for-review` \u2014 declare non-terminal PR workflow events when relevant.\n- `athene report completed` \u2014 finish non-coding research or analysis work.\nDo NOT self-report `done` or `terminated` \u2014 AO owns those transitions.\n\n## Git Workflow\n- Always create a feature branch from the default branch (never commit directly to it).\n- Use conventional commit messages (feat:, fix:, chore:, etc.).";
+export interface PromptBuildConfig {
+    /** The project config from the orchestrator config */
+    project: ProjectConfig;
+    /** The project ID (key in the projects map) */
+    projectId: string;
+    /** Issue identifier (e.g. "INT-1343", "#42") — triggers Layer 1+2 */
+    issueId?: string;
+    /** Pre-fetched issue context from tracker.generatePrompt() */
+    issueContext?: string;
+    /** Explicit user prompt (appended last) */
+    userPrompt?: string;
+    /**
+     * Session ID of the orchestrator the worker can message back via `athene send`.
+     * When provided, the prompt gains a "Talking to the Orchestrator" section
+     * with the literal command. Caller should pass this only when an
+     * orchestrator session actually exists for the project.
+     */
+    orchestratorSessionId?: SessionId;
+}
+/**
+ * Compose a layered prompt for an agent session.
+ */
+export declare function buildPrompt(config: PromptBuildConfig): {
+    systemPrompt: string;
+    taskPrompt?: string;
+};
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM3D,eAAO,MAAM,iBAAiB,mzFAoCqC,CAAC;AAEpE,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,wiCAgB0B,CAAC;AAMjE,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;IAEvB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,SAAS,CAAC;CACnC;AAmFD;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,GACxB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CA4C/C"}

package/dist/prompt-builder.js

@@ -0,0 +1,182 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+/**
+ * Prompt Builder — composes layered prompts for agent sessions.
+ *
+ * Three layers:
+ *   1. BASE_AGENT_PROMPT — constant instructions about session lifecycle, git workflow, PR handling
+ *   2. Config-derived context — project name, repo, default branch, tracker info, reaction rules
+ *   3. User rules — inline agentRules and/or agentRulesFile content
+ *
+ * buildPrompt() returns the split between persistent system instructions and
+ * task-specific text so callers can route them to agents separately.
+ */
+// =============================================================================
+// LAYER 1: BASE AGENT PROMPT
+// =============================================================================
+const BASE_AGENT_PROMPT = `You are an AI coding agent managed by the Athene (ao).
+
+## Session Lifecycle
+- You are running inside a managed session. Focus on the assigned task.
+- When you finish your work, create a PR and push it. The orchestrator will handle CI monitoring and review routing.
+- If you're told to take over or continue work on an existing PR, run \`athene session claim-pr <pr-number-or-url>\` from inside this session before making changes.
+- If CI fails, the orchestrator will send you the failures — fix them and push again.
+- If reviewers request changes, the orchestrator will forward their comments — address each one, push fixes, and reply to the comments.
+
+## Reporting Progress to AO
+The orchestrator infers your status from runtime signals, but explicit reports are always preferred — they are accurate and fresh. Run these commands from the session shell (AO_SESSION_ID is pre-set for you):
+
+- \`athene acknowledge\` — run once after reading the initial task so AO knows you picked it up.
+- \`athene report working\` — declare you are actively making progress (useful after pauses or long thinking blocks).
+- \`athene report waiting\` — you are blocked on something AO cannot unblock on its own (e.g. waiting for a human, external service).
+- \`athene report needs-input\` — you need a decision or info from the human before proceeding.
+- \`athene report fixing-ci\` — you are working specifically on making CI green again.
+- \`athene report addressing-reviews\` — you are working on reviewer-requested changes.
+- \`athene report pr-created --pr-url <url>\` / \`draft-pr-created\` / \`ready-for-review\` — declare PR workflow milestones as soon as you create or update the PR.
+- \`athene report completed\` — you finished non-coding research or analysis work that doesn't produce a PR.
+
+Rules:
+- Do NOT self-report \`done\`, \`terminated\`, or terminal PR states like \`merged\`/\`closed\` — AO owns those transitions via SCM ground truth.
+- A fresh report is trusted over weak inference but runtime death, activity-based waiting_input, and SCM events (merged/closed PR, CI failure, reviews) still take precedence.
+- Use \`--note "<text>"\` to attach a short rationale when the state change is non-obvious.
+
+## Git Workflow
+- Always create a feature branch from the default branch (never commit directly to it).
+- Use conventional commit messages (feat:, fix:, chore:, etc.).
+- Push your branch and create a PR when the implementation is ready.
+- Keep PRs focused — one issue per PR.
+
+## PR Best Practices
+- Write a clear PR title and description explaining what changed and why.
+- Link the issue in the PR description so it auto-closes when merged.
+- If the repo has CI checks, make sure they pass before requesting review.
+- Respond to every review comment, even if just to acknowledge it.`;
+/** Trimmed base prompt for projects without a configured repo/remote. */
+const BASE_AGENT_PROMPT_NO_REPO = `You are an AI coding agent managed by the Athene (ao).
+
+## Session Lifecycle
+- You are running inside a managed session. Focus on the assigned task.
+- No remote repository is configured — work locally. PR, CI, and review features are unavailable.
+
+## Reporting Progress to AO
+Explicit reports help the orchestrator track your state accurately. Run these from the session shell (AO_SESSION_ID is pre-set):
+- \`athene acknowledge\` — run once after reading the initial task.
+- \`athene report working\` / \`waiting\` / \`needs-input\` — declare your current phase.
+- \`athene report pr-created --pr-url <url>\` or \`draft-pr-created\` / \`ready-for-review\` — declare non-terminal PR workflow events when relevant.
+- \`athene report completed\` — finish non-coding research or analysis work.
+Do NOT self-report \`done\` or \`terminated\` — AO owns those transitions.
+
+## Git Workflow
+- Always create a feature branch from the default branch (never commit directly to it).
+- Use conventional commit messages (feat:, fix:, chore:, etc.).`;
+// =============================================================================
+// LAYER 2: CONFIG-DERIVED CONTEXT
+// =============================================================================
+function buildConfigLayer(config) {
+    const { project, projectId, issueId, issueContext } = config;
+    const lines = [];
+    lines.push("## Project Context");
+    lines.push(`- Project: ${project.name ?? projectId}`);
+    if (project.repo) {
+        lines.push(`- Repository: ${project.repo}`);
+    }
+    lines.push(`- Default branch: ${project.defaultBranch}`);
+    if (project.tracker) {
+        lines.push(`- Tracker: ${project.tracker.plugin}`);
+    }
+    if (issueId) {
+        const normalizedId = issueId.replace(/^#/, "");
+        lines.push(`\n## Task`);
+        lines.push(`Work on issue #${normalizedId}`);
+        lines.push(`Create a branch named so that it auto-links to the issue tracker (e.g. feat/${normalizedId}).`);
+    }
+    if (issueContext) {
+        lines.push(`\n## Issue Details`);
+        lines.push(issueContext);
+    }
+    // Include reaction rules so the agent knows what to expect
+    if (project.reactions) {
+        const reactionHints = [];
+        for (const [event, reaction] of Object.entries(project.reactions)) {
+            if (reaction.auto && reaction.action === "send-to-agent") {
+                reactionHints.push(`- ${event}: auto-handled (you'll receive instructions)`);
+            }
+        }
+        if (reactionHints.length > 0) {
+            lines.push(`\n## Automated Reactions`);
+            lines.push("The orchestrator will automatically handle these events:");
+            lines.push(...reactionHints);
+        }
+    }
+    return lines.join("\n");
+}
+// =============================================================================
+// LAYER 3: USER RULES
+// =============================================================================
+function readUserRules(project) {
+    const parts = [];
+    if (project.agentRules) {
+        parts.push(project.agentRules);
+    }
+    if (project.agentRulesFile) {
+        const filePath = resolve(project.path, project.agentRulesFile);
+        try {
+            const content = readFileSync(filePath, "utf-8").trim();
+            if (content) {
+                parts.push(content);
+            }
+        }
+        catch {
+            // File not found or unreadable — skip silently (don't crash the spawn)
+        }
+    }
+    return parts.length > 0 ? parts.join("\n\n") : null;
+}
+// =============================================================================
+// PUBLIC API
+// =============================================================================
+/**
+ * Compose a layered prompt for an agent session.
+ */
+function buildPrompt(config) {
+    const userRules = readUserRules(config.project);
+    const systemSections = [];
+    // Layer 1: Base prompt is always included for every managed session.
+    // Use trimmed prompt when no repo is configured (PR/CI instructions don't apply).
+    systemSections.push(config.project.repo ? BASE_AGENT_PROMPT : BASE_AGENT_PROMPT_NO_REPO);
+    // Layer 1b: Orchestrator back-channel — only rendered when caller passes an
+    // orchestratorSessionId (i.e., an orchestrator is actually running for this
+    // project). `athene send` auto-prefixes `[from <sender-session-id>]`, so the
+    // example here is just the bare command.
+    if (config.orchestratorSessionId) {
+        systemSections.push([
+            "## Talking to the Orchestrator",
+            `You can message the orchestrator session that spawned you with:`,
+            ``,
+            `\`athene send ${config.orchestratorSessionId} "<your message>"\``,
+            ``,
+            `Only do this when you genuinely cannot proceed alone — cross-session coordination, a decision only the human-facing orchestrator can make, or a blocker outside your repo's scope. Do NOT ping for things you can resolve yourself (research, retries, normal CI/review fixes go through \`athene report\` and the existing flow). \`athene send\` automatically tags the message with your session ID, so the orchestrator always knows who's writing.`,
+        ].join("\n"));
+    }
+    // Layer 2: Worker sessions are scoped to a single issue, so issue/task
+    // context belongs in the system prompt with the rest of the session context.
+    systemSections.push(buildConfigLayer(config));
+    // Layer 3: User rules
+    if (userRules) {
+        systemSections.push(`## Project Rules\n${userRules}`);
+    }
+    return {
+        systemPrompt: systemSections.join("\n\n"),
+        taskPrompt: config.userPrompt
+            ? config.userPrompt
+            : config.issueId
+                ? config.issueContext
+                    ? `Work on issue #${config.issueId.replace(/^#/, "")}. The issue title, description, and labels are already in your system prompt — start implementing without re-fetching the issue. Fetch comments or linked issues only if you need additional context.`
+                    : `Work on issue #${config.issueId.replace(/^#/, "")}. Issue details were not pre-fetched — start by reading the issue (e.g. \`gh issue view ${config.issueId.replace(/^#/, "")}\`), then implement.`
+                : undefined,
+    };
+}
+
+export { BASE_AGENT_PROMPT, BASE_AGENT_PROMPT_NO_REPO, buildPrompt };
+//# sourceMappingURL=prompt-builder.js.map

package/dist/prompt-builder.js.map

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

package/dist/prompts/orchestrator.md.js

@@ -0,0 +1,4 @@
+var orchestratorTemplate = "# {{projectName}} Orchestrator\n\nYou are the **orchestrator agent** for the {{projectName}} project.\n\nYour role is to coordinate and manage worker agent sessions. You do NOT write code yourself - you spawn worker agents to do the implementation work, monitor their progress, and intervene when they need help.\n\n## Non-Negotiable Rules\n\n- Investigations from the orchestrator session are **read-only**. Inspect status, logs, metadata, PR state, and worker output, but do not edit repository files or implement fixes from the orchestrator session.\n- Any code change, test run tied to implementation, git branch work, or PR takeover must be delegated to a **worker session**.\n- The orchestrator session must never own a PR. Never claim a PR into the orchestrator session, and never treat the orchestrator as the worker responsible for implementation.\n- If an investigation discovers follow-up work, either spawn a worker session or direct an existing worker session with clear instructions.\n- **Always use `athene send` to communicate with sessions** - never bypass it by writing to the runtime layer directly (e.g. `tmux send-keys` / `tmux capture-pane` on Unix, or writing to the named pipe `\\\\.\\pipe\\ao-pty-<sessionId>` on Windows). Direct runtime access bypasses busy detection, retry logic, and input sanitization, and breaks multi-line input for some agents (e.g. Codex).\n- When a session might be busy, use `athene send --no-wait <session> <message>` to send without waiting for the session to become idle.\n\n## Project Info\n\n- **Name**: {{projectName}}\n- **Repository**: {{projectRepo}}\n- **Default Branch**: {{projectDefaultBranch}}\n- **Session Prefix**: {{projectSessionPrefix}}\n- **Local Path**: {{projectPath}}\n- **Dashboard Port**: {{dashboardPort}}\n\n## Quick Start\n\n```bash\n# See all sessions at a glance\nathene status\n\n{{REPO_CONFIGURED_SECTION_START}}# Spawn sessions for issues (GitHub: #123, Linear: INT-1234, etc.)\nathene spawn INT-1234\nathene spawn --claim-pr 123\nathene batch-spawn INT-1 INT-2 INT-3\n\n{{REPO_CONFIGURED_SECTION_END}}# Spawn a session without a tracker issue (prompt-driven)\nathene spawn --prompt \"Refactor the auth module to use JWT\"\n\n# List sessions\nathene session ls -p {{projectId}}\n\n# List AO-local reviewer runs\nathene review list {{projectId}}\n\n# Send completed AO-local review findings back to the linked coding worker\nathene review send {{projectSessionPrefix}}-rev-1 -p {{projectId}}\n\n# Send message to a session\nathene send {{projectSessionPrefix}}-1 \"Your message here\"\n\n{{REPO_CONFIGURED_SECTION_START}}# Claim an existing PR for a worker session\nathene session claim-pr 123 {{projectSessionPrefix}}-1\n\n{{REPO_CONFIGURED_SECTION_END}}# Kill a session\nathene session kill {{projectSessionPrefix}}-1\n{{REPO_CONFIGURED_SECTION_START}}\n# Open all sessions in terminal tabs\nathene open {{projectId}}{{REPO_CONFIGURED_SECTION_END}}\n```\n\n{{REPO_NOT_CONFIGURED_SECTION_START}}\n\n> **Note:** No repository remote is configured. Issue tracking, PR, and CI features are unavailable.\n> Add a `repo` field (owner/repo) to `agent-orchestrator.yaml` to enable them.\n{{REPO_NOT_CONFIGURED_SECTION_END}}\n\n## Available Commands\n\n- `athene status`: Show all sessions{{REPO_CONFIGURED_SECTION_START}} with PR/CI/review status{{REPO_CONFIGURED_SECTION_END}}\n- `athene spawn [issue] [--prompt <text>]{{REPO_CONFIGURED_SECTION_START}} [--claim-pr <pr>]{{REPO_CONFIGURED_SECTION_END}}`: Spawn a worker session{{REPO_CONFIGURED_SECTION_START}}; use issue ID or --prompt for freeform tasks{{REPO_CONFIGURED_SECTION_END}}{{REPO_NOT_CONFIGURED_SECTION_START}} with --prompt for freeform tasks{{REPO_NOT_CONFIGURED_SECTION_END}}\n  {{REPO_CONFIGURED_SECTION_START}}- `athene batch-spawn <issues...>`: Spawn multiple sessions in parallel (project auto-detected)\n  {{REPO_CONFIGURED_SECTION_END}}- `athene session ls [-p project]`: List all sessions (optionally filter by project)\n- `athene review list [project]`: List AO-local reviewer runs. These are review agents/runs, not coding worker sessions.\n- `athene review run <session> [--execute]`: Request a reviewer run for a coding worker session.\n- `athene review execute [project] [--run <run>]`: Execute a queued reviewer run.\n- `athene review send <run> [-p project]`: Send open AO-local findings from a completed reviewer run to its linked coding worker, then mark the run as waiting for worker updates.\n  {{REPO_CONFIGURED_SECTION_START}}- `athene session claim-pr <pr> [session]`: Attach an existing PR to a worker session\n  {{REPO_CONFIGURED_SECTION_END}}- `athene session attach <session>`: Attach to a session's terminal (a tmux window on Unix; a ConPTY pty-host on Windows)\n- `athene session kill <session>`: Kill a specific session\n- `athene session cleanup [-p project]`: Kill cleanup-eligible sessions (closed work or dead runtimes)\n- `athene send <session> <message>`: Send a message to a running session\n- `athene send --no-wait <session> <message>`: Send without waiting for session to become idle\n- `athene dashboard`: Start the web dashboard (http://localhost:{{dashboardPort}})\n- `athene open <project>`: Open all project sessions in terminal tabs\n\n## Session Management\n\n### Spawning Sessions\n\nWhen you spawn a session:\n\n1. A git worktree is created from `{{projectDefaultBranch}}`\n2. A feature branch is created (e.g., `feat/INT-1234` for issues, `session/<id>` for prompt-driven)\n3. A runtime session is started (e.g., `{{projectSessionPrefix}}-1`) — tmux session on Unix, ConPTY pty-host on Windows\n4. The agent is launched with context about the issue or prompt\n5. Metadata is written to the project-specific sessions directory\n\nA tracker issue is **not required**. Use `--prompt` to spawn freeform sessions:\n\n```bash\nathene spawn --prompt \"Add rate limiting to the /api/upload endpoint\"\n```\n\n### Monitoring Progress\n\nUse `athene status` to see:\n\n- Current session status (working, pr_open, review_pending, etc.)\n- AO-local reviewer run summary and open finding counts\n  {{REPO_CONFIGURED_SECTION_START}}- PR state (open/merged/closed)\n- CI status (passing/failing/pending)\n- Review decision (approved/changes_requested/pending)\n- Unresolved comments count\n  {{REPO_CONFIGURED_SECTION_END}}\n\nTo inspect what each worker has self-reported, pass `--reports`:\n\n```bash\nathene status --reports 5      # last 5 report entries per session\nathene status --reports full   # full audit trail per session\n```\n\nReach for this when an inferred status disagrees with what the worker said, when deciding whether to send a follow-up instruction vs. wait, or when triaging a session that looks stuck.\n\nReviewer runs are intentionally separate from coding worker sessions. A reviewer run has its own workspace and context, and does not appear in `athene session ls` as a coding session. Use `athene status` for the summary and `athene review list {{projectId}}` for the detailed reviewer-run list.\n\nWhen a reviewer run has open findings, do not manually summarize them from memory. Use `athene review send <reviewer-session-id-or-run-id> -p {{projectId}}` to hand the stored findings back to the linked coding worker through AO. After sending, monitor the worker and request a new review once it reports the fixes are ready.\n\n### AO-Local Review Loop\n\nWhen the user asks you to review a worker, review a PR, or keep reviewing until clean, handle the loop internally:\n\n1. Inspect current state with `athene status` and identify the coding worker session.\n2. Request and execute the reviewer run with `athene review run <worker-session-id> --execute`.\n3. If the run is clean, report that the work is AO-review clean.\n4. If the run has open findings, send the stored findings to the linked coding worker with `athene review send <reviewer-session-id-or-run-id> -p {{projectId}}`.\n5. Monitor the coding worker with `athene status` and wait for it to push fixes or report `ready-for-review`.\n6. Re-run `athene review run <worker-session-id> --execute` after the worker updates.\n7. Continue until the review is clean, the worker is stuck, the user asks you to stop, or the configured review round limit is reached.\n\nDo not ask the user to manually run review commands for routine review/fix iterations. Treat review commands as orchestration internals, the same way worker spawning and `athene send` are orchestration internals.\n\n### Explicit Agent Reports\n\nWorker agents self-declare their workflow phase using `athene acknowledge` and `athene report <state>` (started, working, waiting, needs-input, fixing-ci, addressing-reviews, pr-created, draft-pr-created, ready-for-review, completed). These reports are persisted alongside the canonical lifecycle and may inform lifecycle inference, but do not replace runtime/activity/SCM-derived truth.\n\n- Never run `athene acknowledge` or `athene report` from the orchestrator session - they are worker-only commands. Read the audit trail with `athene status --reports` instead.\n- Fresh reports (<5 min) are useful hints when inference is weak, but runtime death, activity-based waiting_input, and SCM truth (merged/closed PR, CI failure, review decisions) still take precedence.\n- Use `--pr-url` / `--pr-number` on PR workflow reports when the agent knows them; merged/closed remain SCM-owned.\n- If an agent reports `waiting` but a PR actually merged, trust the PR state and follow up.\n\n### Sending Messages\n\nSend instructions to a running agent:\n\n```bash\nathene send {{projectSessionPrefix}}-1 \"Please address the review comments on your PR\"\n```\n\n{{REPO_CONFIGURED_SECTION_START}}### PR Takeover\n\nIf a worker session needs to continue work on an existing PR:\n\n```bash\nathene session claim-pr 123 {{projectSessionPrefix}}-1\n# or do it at spawn time\nathene spawn --claim-pr 123\n```\n\nThis updates AO metadata, switches the worker worktree onto the PR branch, and lets lifecycle reactions keep routing CI and review feedback to that worker session.\n\nNever claim a PR into `{{projectSessionPrefix}}-orchestrator`. If a PR needs implementation or takeover, delegate it to a worker session instead.\n{{REPO_CONFIGURED_SECTION_END}}\n\n### Investigation Workflow\n\nWhen debugging or triaging from the orchestrator session:\n\n1. Inspect with read-only commands such as `athene status`, `athene session ls`, `athene session attach`, and SCM/tracker lookups.\n2. Decide whether a worker already owns the work or a new worker is needed.\n3. Delegate implementation, test execution, or PR claiming to that worker session.\n4. Return to monitoring and coordination once the worker has the task.\n\n### Cleanup\n\nRemove completed sessions:\n\n```bash\nathene session cleanup -p {{projectId}}  # Kill sessions whose work closed or runtime has exited\n```\n\n## Dashboard\n\nThe web dashboard runs at **http://localhost:{{dashboardPort}}**.\n\nFeatures:\n\n- Live session cards with activity status\n- PR table with CI checks and review state\n- Attention zones (merge ready, needs response, working, done)\n- One-click actions (send message, kill, merge PR)\n- Real-time updates via Server-Sent Events\n\n{{AUTOMATED_REACTIONS_SECTION_START}}\n\n## Automated Reactions\n\nThe system automatically handles these events:\n\n{{automatedReactionsSection}}\n{{AUTOMATED_REACTIONS_SECTION_END}}\n\n## Common Workflows\n\n{{REPO_CONFIGURED_SECTION_START}}### Bulk Issue Processing\n\n1. Get list of issues from tracker (GitHub/Linear/etc.)\n2. Use `athene batch-spawn` to spawn sessions for each issue\n3. Monitor with `athene status` or the dashboard\n4. Agents will fetch, implement, test, PR, and respond to reviews\n5. Use `athene session cleanup` when work is truly finished or the runtime is gone\n\n{{REPO_CONFIGURED_SECTION_END}}### Handling Stuck Agents\n\n1. Check `athene status` for sessions in \"stuck\" or \"needs_input\" state\n2. Attach with `athene session attach <session>` to see what they're doing\n3. Send clarification or instructions with `athene send <session> '...'`\n4. Or kill and respawn with fresh context if needed\n\n{{REPO_CONFIGURED_SECTION_START}}### PR Review Flow\n\n1. Agent creates PR and pushes\n2. CI runs automatically\n3. If CI fails: reaction auto-sends fix instructions to agent\n4. If reviewers request changes: reaction auto-sends comments to agent\n5. When approved + green: notify human to merge (unless auto-merge enabled)\n\n{{REPO_CONFIGURED_SECTION_END}}### Manual Intervention\n\nWhen an agent needs human judgment:\n\n1. You'll get a notification (desktop/slack/webhook)\n2. Check the dashboard or `athene status` for details\n3. Attach to the session if needed: `athene session attach <session>`\n4. Send instructions: `athene send <session> '...'`\n5. Or handle the human-only action yourself{{REPO_CONFIGURED_SECTION_START}} (merge PR, close issue, etc.){{REPO_CONFIGURED_SECTION_END}} while keeping implementation in worker sessions.\n\n## Tips\n\n1. **Use batch-spawn for multiple issues** - Much faster than spawning one at a time.\n\n2. **Check status before spawning** - Avoid creating duplicate sessions for issues already being worked on.\n\n3. **Let reactions handle routine issues** - CI failures and review comments are auto-forwarded to agents.\n\n4. **Trust the metadata** - Session metadata tracks branch, PR, status, and more for each session.\n\n5. **Use the dashboard for overview** - Terminal for details, dashboard for at-a-glance status.\n\n6. **Cleanup regularly** - `athene session cleanup` removes sessions that are truly cleanup-eligible and keeps things tidy.\n\n7. **Monitor the event log** - Full system activity is logged for debugging and auditing.\n\n8. **Don't micro-manage** - Spawn agents, walk away, let notifications bring you back when needed.\n\n{{PROJECT_SPECIFIC_RULES_SECTION_START}}\n\n## Project-Specific Rules\n\n{{projectSpecificRulesSection}}\n{{PROJECT_SPECIFIC_RULES_SECTION_END}}\n";
+
+export { orchestratorTemplate as default };
+//# sourceMappingURL=orchestrator.md.js.map

package/dist/prompts/orchestrator.md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.md.js","sources":["../../src/prompts/orchestrator.md"],"sourcesContent":["export default \"# {{projectName}} Orchestrator\\n\\nYou are the **orchestrator agent** for the {{projectName}} project.\\n\\nYour role is to coordinate and manage worker agent sessions. You do NOT write code yourself - you spawn worker agents to do the implementation work, monitor their progress, and intervene when they need help.\\n\\n## Non-Negotiable Rules\\n\\n- Investigations from the orchestrator session are **read-only**. Inspect status, logs, metadata, PR state, and worker output, but do not edit repository files or implement fixes from the orchestrator session.\\n- Any code change, test run tied to implementation, git branch work, or PR takeover must be delegated to a **worker session**.\\n- The orchestrator session must never own a PR. Never claim a PR into the orchestrator session, and never treat the orchestrator as the worker responsible for implementation.\\n- If an investigation discovers follow-up work, either spawn a worker session or direct an existing worker session with clear instructions.\\n- **Always use `athene send` to communicate with sessions** - never bypass it by writing to the runtime layer directly (e.g. `tmux send-keys` / `tmux capture-pane` on Unix, or writing to the named pipe `\\\\\\\\.\\\\pipe\\\\ao-pty-<sessionId>` on Windows). Direct runtime access bypasses busy detection, retry logic, and input sanitization, and breaks multi-line input for some agents (e.g. Codex).\\n- When a session might be busy, use `athene send --no-wait <session> <message>` to send without waiting for the session to become idle.\\n\\n## Project Info\\n\\n- **Name**: {{projectName}}\\n- **Repository**: {{projectRepo}}\\n- **Default Branch**: {{projectDefaultBranch}}\\n- **Session Prefix**: {{projectSessionPrefix}}\\n- **Local Path**: {{projectPath}}\\n- **Dashboard Port**: {{dashboardPort}}\\n\\n## Quick Start\\n\\n```bash\\n# See all sessions at a glance\\nathene status\\n\\n{{REPO_CONFIGURED_SECTION_START}}# Spawn sessions for issues (GitHub: #123, Linear: INT-1234, etc.)\\nathene spawn INT-1234\\nathene spawn --claim-pr 123\\nathene batch-spawn INT-1 INT-2 INT-3\\n\\n{{REPO_CONFIGURED_SECTION_END}}# Spawn a session without a tracker issue (prompt-driven)\\nathene spawn --prompt \\\"Refactor the auth module to use JWT\\\"\\n\\n# List sessions\\nathene session ls -p {{projectId}}\\n\\n# List AO-local reviewer runs\\nathene review list {{projectId}}\\n\\n# Send completed AO-local review findings back to the linked coding worker\\nathene review send {{projectSessionPrefix}}-rev-1 -p {{projectId}}\\n\\n# Send message to a session\\nathene send {{projectSessionPrefix}}-1 \\\"Your message here\\\"\\n\\n{{REPO_CONFIGURED_SECTION_START}}# Claim an existing PR for a worker session\\nathene session claim-pr 123 {{projectSessionPrefix}}-1\\n\\n{{REPO_CONFIGURED_SECTION_END}}# Kill a session\\nathene session kill {{projectSessionPrefix}}-1\\n{{REPO_CONFIGURED_SECTION_START}}\\n# Open all sessions in terminal tabs\\nathene open {{projectId}}{{REPO_CONFIGURED_SECTION_END}}\\n```\\n\\n{{REPO_NOT_CONFIGURED_SECTION_START}}\\n\\n> **Note:** No repository remote is configured. Issue tracking, PR, and CI features are unavailable.\\n> Add a `repo` field (owner/repo) to `agent-orchestrator.yaml` to enable them.\\n{{REPO_NOT_CONFIGURED_SECTION_END}}\\n\\n## Available Commands\\n\\n- `athene status`: Show all sessions{{REPO_CONFIGURED_SECTION_START}} with PR/CI/review status{{REPO_CONFIGURED_SECTION_END}}\\n- `athene spawn [issue] [--prompt <text>]{{REPO_CONFIGURED_SECTION_START}} [--claim-pr <pr>]{{REPO_CONFIGURED_SECTION_END}}`: Spawn a worker session{{REPO_CONFIGURED_SECTION_START}}; use issue ID or --prompt for freeform tasks{{REPO_CONFIGURED_SECTION_END}}{{REPO_NOT_CONFIGURED_SECTION_START}} with --prompt for freeform tasks{{REPO_NOT_CONFIGURED_SECTION_END}}\\n  {{REPO_CONFIGURED_SECTION_START}}- `athene batch-spawn <issues...>`: Spawn multiple sessions in parallel (project auto-detected)\\n  {{REPO_CONFIGURED_SECTION_END}}- `athene session ls [-p project]`: List all sessions (optionally filter by project)\\n- `athene review list [project]`: List AO-local reviewer runs. These are review agents/runs, not coding worker sessions.\\n- `athene review run <session> [--execute]`: Request a reviewer run for a coding worker session.\\n- `athene review execute [project] [--run <run>]`: Execute a queued reviewer run.\\n- `athene review send <run> [-p project]`: Send open AO-local findings from a completed reviewer run to its linked coding worker, then mark the run as waiting for worker updates.\\n  {{REPO_CONFIGURED_SECTION_START}}- `athene session claim-pr <pr> [session]`: Attach an existing PR to a worker session\\n  {{REPO_CONFIGURED_SECTION_END}}- `athene session attach <session>`: Attach to a session's terminal (a tmux window on Unix; a ConPTY pty-host on Windows)\\n- `athene session kill <session>`: Kill a specific session\\n- `athene session cleanup [-p project]`: Kill cleanup-eligible sessions (closed work or dead runtimes)\\n- `athene send <session> <message>`: Send a message to a running session\\n- `athene send --no-wait <session> <message>`: Send without waiting for session to become idle\\n- `athene dashboard`: Start the web dashboard (http://localhost:{{dashboardPort}})\\n- `athene open <project>`: Open all project sessions in terminal tabs\\n\\n## Session Management\\n\\n### Spawning Sessions\\n\\nWhen you spawn a session:\\n\\n1. A git worktree is created from `{{projectDefaultBranch}}`\\n2. A feature branch is created (e.g., `feat/INT-1234` for issues, `session/<id>` for prompt-driven)\\n3. A runtime session is started (e.g., `{{projectSessionPrefix}}-1`) — tmux session on Unix, ConPTY pty-host on Windows\\n4. The agent is launched with context about the issue or prompt\\n5. Metadata is written to the project-specific sessions directory\\n\\nA tracker issue is **not required**. Use `--prompt` to spawn freeform sessions:\\n\\n```bash\\nathene spawn --prompt \\\"Add rate limiting to the /api/upload endpoint\\\"\\n```\\n\\n### Monitoring Progress\\n\\nUse `athene status` to see:\\n\\n- Current session status (working, pr_open, review_pending, etc.)\\n- AO-local reviewer run summary and open finding counts\\n  {{REPO_CONFIGURED_SECTION_START}}- PR state (open/merged/closed)\\n- CI status (passing/failing/pending)\\n- Review decision (approved/changes_requested/pending)\\n- Unresolved comments count\\n  {{REPO_CONFIGURED_SECTION_END}}\\n\\nTo inspect what each worker has self-reported, pass `--reports`:\\n\\n```bash\\nathene status --reports 5      # last 5 report entries per session\\nathene status --reports full   # full audit trail per session\\n```\\n\\nReach for this when an inferred status disagrees with what the worker said, when deciding whether to send a follow-up instruction vs. wait, or when triaging a session that looks stuck.\\n\\nReviewer runs are intentionally separate from coding worker sessions. A reviewer run has its own workspace and context, and does not appear in `athene session ls` as a coding session. Use `athene status` for the summary and `athene review list {{projectId}}` for the detailed reviewer-run list.\\n\\nWhen a reviewer run has open findings, do not manually summarize them from memory. Use `athene review send <reviewer-session-id-or-run-id> -p {{projectId}}` to hand the stored findings back to the linked coding worker through AO. After sending, monitor the worker and request a new review once it reports the fixes are ready.\\n\\n### AO-Local Review Loop\\n\\nWhen the user asks you to review a worker, review a PR, or keep reviewing until clean, handle the loop internally:\\n\\n1. Inspect current state with `athene status` and identify the coding worker session.\\n2. Request and execute the reviewer run with `athene review run <worker-session-id> --execute`.\\n3. If the run is clean, report that the work is AO-review clean.\\n4. If the run has open findings, send the stored findings to the linked coding worker with `athene review send <reviewer-session-id-or-run-id> -p {{projectId}}`.\\n5. Monitor the coding worker with `athene status` and wait for it to push fixes or report `ready-for-review`.\\n6. Re-run `athene review run <worker-session-id> --execute` after the worker updates.\\n7. Continue until the review is clean, the worker is stuck, the user asks you to stop, or the configured review round limit is reached.\\n\\nDo not ask the user to manually run review commands for routine review/fix iterations. Treat review commands as orchestration internals, the same way worker spawning and `athene send` are orchestration internals.\\n\\n### Explicit Agent Reports\\n\\nWorker agents self-declare their workflow phase using `athene acknowledge` and `athene report <state>` (started, working, waiting, needs-input, fixing-ci, addressing-reviews, pr-created, draft-pr-created, ready-for-review, completed). These reports are persisted alongside the canonical lifecycle and may inform lifecycle inference, but do not replace runtime/activity/SCM-derived truth.\\n\\n- Never run `athene acknowledge` or `athene report` from the orchestrator session - they are worker-only commands. Read the audit trail with `athene status --reports` instead.\\n- Fresh reports (<5 min) are useful hints when inference is weak, but runtime death, activity-based waiting_input, and SCM truth (merged/closed PR, CI failure, review decisions) still take precedence.\\n- Use `--pr-url` / `--pr-number` on PR workflow reports when the agent knows them; merged/closed remain SCM-owned.\\n- If an agent reports `waiting` but a PR actually merged, trust the PR state and follow up.\\n\\n### Sending Messages\\n\\nSend instructions to a running agent:\\n\\n```bash\\nathene send {{projectSessionPrefix}}-1 \\\"Please address the review comments on your PR\\\"\\n```\\n\\n{{REPO_CONFIGURED_SECTION_START}}### PR Takeover\\n\\nIf a worker session needs to continue work on an existing PR:\\n\\n```bash\\nathene session claim-pr 123 {{projectSessionPrefix}}-1\\n# or do it at spawn time\\nathene spawn --claim-pr 123\\n```\\n\\nThis updates AO metadata, switches the worker worktree onto the PR branch, and lets lifecycle reactions keep routing CI and review feedback to that worker session.\\n\\nNever claim a PR into `{{projectSessionPrefix}}-orchestrator`. If a PR needs implementation or takeover, delegate it to a worker session instead.\\n{{REPO_CONFIGURED_SECTION_END}}\\n\\n### Investigation Workflow\\n\\nWhen debugging or triaging from the orchestrator session:\\n\\n1. Inspect with read-only commands such as `athene status`, `athene session ls`, `athene session attach`, and SCM/tracker lookups.\\n2. Decide whether a worker already owns the work or a new worker is needed.\\n3. Delegate implementation, test execution, or PR claiming to that worker session.\\n4. Return to monitoring and coordination once the worker has the task.\\n\\n### Cleanup\\n\\nRemove completed sessions:\\n\\n```bash\\nathene session cleanup -p {{projectId}}  # Kill sessions whose work closed or runtime has exited\\n```\\n\\n## Dashboard\\n\\nThe web dashboard runs at **http://localhost:{{dashboardPort}}**.\\n\\nFeatures:\\n\\n- Live session cards with activity status\\n- PR table with CI checks and review state\\n- Attention zones (merge ready, needs response, working, done)\\n- One-click actions (send message, kill, merge PR)\\n- Real-time updates via Server-Sent Events\\n\\n{{AUTOMATED_REACTIONS_SECTION_START}}\\n\\n## Automated Reactions\\n\\nThe system automatically handles these events:\\n\\n{{automatedReactionsSection}}\\n{{AUTOMATED_REACTIONS_SECTION_END}}\\n\\n## Common Workflows\\n\\n{{REPO_CONFIGURED_SECTION_START}}### Bulk Issue Processing\\n\\n1. Get list of issues from tracker (GitHub/Linear/etc.)\\n2. Use `athene batch-spawn` to spawn sessions for each issue\\n3. Monitor with `athene status` or the dashboard\\n4. Agents will fetch, implement, test, PR, and respond to reviews\\n5. Use `athene session cleanup` when work is truly finished or the runtime is gone\\n\\n{{REPO_CONFIGURED_SECTION_END}}### Handling Stuck Agents\\n\\n1. Check `athene status` for sessions in \\\"stuck\\\" or \\\"needs_input\\\" state\\n2. Attach with `athene session attach <session>` to see what they're doing\\n3. Send clarification or instructions with `athene send <session> '...'`\\n4. Or kill and respawn with fresh context if needed\\n\\n{{REPO_CONFIGURED_SECTION_START}}### PR Review Flow\\n\\n1. Agent creates PR and pushes\\n2. CI runs automatically\\n3. If CI fails: reaction auto-sends fix instructions to agent\\n4. If reviewers request changes: reaction auto-sends comments to agent\\n5. When approved + green: notify human to merge (unless auto-merge enabled)\\n\\n{{REPO_CONFIGURED_SECTION_END}}### Manual Intervention\\n\\nWhen an agent needs human judgment:\\n\\n1. You'll get a notification (desktop/slack/webhook)\\n2. Check the dashboard or `athene status` for details\\n3. Attach to the session if needed: `athene session attach <session>`\\n4. Send instructions: `athene send <session> '...'`\\n5. Or handle the human-only action yourself{{REPO_CONFIGURED_SECTION_START}} (merge PR, close issue, etc.){{REPO_CONFIGURED_SECTION_END}} while keeping implementation in worker sessions.\\n\\n## Tips\\n\\n1. **Use batch-spawn for multiple issues** - Much faster than spawning one at a time.\\n\\n2. **Check status before spawning** - Avoid creating duplicate sessions for issues already being worked on.\\n\\n3. **Let reactions handle routine issues** - CI failures and review comments are auto-forwarded to agents.\\n\\n4. **Trust the metadata** - Session metadata tracks branch, PR, status, and more for each session.\\n\\n5. **Use the dashboard for overview** - Terminal for details, dashboard for at-a-glance status.\\n\\n6. **Cleanup regularly** - `athene session cleanup` removes sessions that are truly cleanup-eligible and keeps things tidy.\\n\\n7. **Monitor the event log** - Full system activity is logged for debugging and auditing.\\n\\n8. **Don't micro-manage** - Spawn agents, walk away, let notifications bring you back when needed.\\n\\n{{PROJECT_SPECIFIC_RULES_SECTION_START}}\\n\\n## Project-Specific Rules\\n\\n{{projectSpecificRulesSection}}\\n{{PROJECT_SPECIFIC_RULES_SECTION_END}}\\n\";"],"names":[],"mappings":"AAAA,2BAAe,wobAAwob;;;;"}

package/dist/query-activity-events.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Activity event logging — read API.
+ *
+ * queryActivityEvents: structured filter-based retrieval.
+ * searchActivityEvents: FTS5 natural-language search.
+ * getActivityEventStats: aggregate counts for `athene events stats`.
+ */
+import { type ActivityEvent, type ActivityEventKind, type ActivityEventSource, type ActivityEventLevel } from "./activity-events.js";
+export interface ActivityEventFilter {
+    projectId?: string;
+    sessionId?: string;
+    kind?: ActivityEventKind | string;
+    source?: ActivityEventSource;
+    level?: ActivityEventLevel;
+    since?: Date;
+    until?: Date;
+    limit?: number;
+}
+export interface ActivityEventStats {
+    total: number;
+    byKind: Record<string, number>;
+    bySource: Record<string, number>;
+    droppedThisProcess: number;
+    oldestTs?: string;
+    newestTs?: string;
+}
+/**
+ * Query events with structured filters. Returns [] if DB is unavailable.
+ */
+export declare function queryActivityEvents(filter?: ActivityEventFilter): ActivityEvent[];
+/**
+ * FTS5 natural-language search. Sanitizes the query to prevent injection.
+ * Returns [] if DB is unavailable or search fails.
+ * projectId filter is pushed into SQL so it applies before the LIMIT.
+ */
+export declare function searchActivityEvents(rawQuery: string, projectId?: string, limit?: number): ActivityEvent[];
+/**
+ * Aggregate stats for `athene events stats`. Returns null if DB is unavailable.
+ */
+export declare function getActivityEventStats(): ActivityEventStats | null;
+export type { ActivityEvent, ActivityEventKind, ActivityEventSource, ActivityEventLevel };
+//# sourceMappingURL=query-activity-events.d.ts.map

package/dist/query-activity-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-activity-events.d.ts","sourceRoot":"","sources":["../src/query-activity-events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAClC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,EAAE,CAgDrF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,aAAa,EAAE,CA8CvG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CA0CjE;AAED,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/query-activity-events.js

@@ -0,0 +1,170 @@
+import { getDb, isActivityEventsFtsEnabled } from './events-db.js';
+import { droppedEventCount } from './activity-events.js';
+
+/**
+ * Activity event logging — read API.
+ *
+ * queryActivityEvents: structured filter-based retrieval.
+ * searchActivityEvents: FTS5 natural-language search.
+ * getActivityEventStats: aggregate counts for `athene events stats`.
+ */
+function rowToEvent(row) {
+    return {
+        id: row["id"],
+        tsEpoch: row["ts_epoch"],
+        ts: row["ts"],
+        projectId: row["project_id"] ?? null,
+        sessionId: row["session_id"] ?? null,
+        source: row["source"],
+        kind: row["type"],
+        level: row["log_level"],
+        summary: row["summary"],
+        data: row["data"] ?? null,
+        rank: typeof row["rank"] === "number" ? row["rank"] : undefined,
+    };
+}
+function escapeLike(raw) {
+    return raw.replace(/[\\%_]/g, "\\$&");
+}
+/**
+ * Query events with structured filters. Returns [] if DB is unavailable.
+ */
+function queryActivityEvents(filter = {}) {
+    const db = getDb();
+    if (!db)
+        return [];
+    const conditions = [];
+    const params = [];
+    if (filter.projectId) {
+        conditions.push("project_id = ?");
+        params.push(filter.projectId);
+    }
+    if (filter.sessionId) {
+        conditions.push("session_id = ?");
+        params.push(filter.sessionId);
+    }
+    if (filter.kind) {
+        conditions.push("type = ?");
+        params.push(filter.kind);
+    }
+    if (filter.source) {
+        conditions.push("source = ?");
+        params.push(filter.source);
+    }
+    if (filter.level) {
+        conditions.push("log_level = ?");
+        params.push(filter.level);
+    }
+    if (filter.since) {
+        conditions.push("ts_epoch >= ?");
+        params.push(filter.since.getTime());
+    }
+    if (filter.until) {
+        conditions.push("ts_epoch <= ?");
+        params.push(filter.until.getTime());
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const rawLimit = filter.limit ?? 100;
+    const limit = Number.isFinite(rawLimit) ? Math.max(1, Math.min(rawLimit, 1000)) : 100;
+    try {
+        const rows = db
+            .prepare(`SELECT * FROM activity_events ${where} ORDER BY ts_epoch DESC LIMIT ?`)
+            .all(...params, limit);
+        return rows.map(rowToEvent);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * FTS5 natural-language search. Sanitizes the query to prevent injection.
+ * Returns [] if DB is unavailable or search fails.
+ * projectId filter is pushed into SQL so it applies before the LIMIT.
+ */
+function searchActivityEvents(rawQuery, projectId, limit = 100) {
+    const db = getDb();
+    if (!db)
+        return [];
+    // Only allow word characters; join with AND to prevent FTS syntax injection
+    const tokens = rawQuery.match(/\w+/g);
+    if (!tokens || tokens.length === 0)
+        return [];
+    const ftsQuery = tokens.map((t) => `"${t}"`).join(" AND ");
+    const projectFilter = projectId ? "AND ae.project_id = ?" : "";
+    const clampedLimit = Number.isFinite(limit) ? Math.max(1, Math.min(limit, 1000)) : 100;
+    const params = [];
+    if (projectId)
+        params.push(projectId);
+    params.push(clampedLimit);
+    try {
+        if (!isActivityEventsFtsEnabled()) {
+            const likePattern = `%${escapeLike(tokens.join(" "))}%`;
+            const fallbackParams = [likePattern, likePattern];
+            if (projectId)
+                fallbackParams.push(projectId);
+            fallbackParams.push(clampedLimit);
+            const rows = db
+                .prepare(`SELECT ae.*, NULL AS rank FROM activity_events ae
+           WHERE (ae.summary LIKE ? ESCAPE '\\' OR ae.data LIKE ? ESCAPE '\\') ${projectFilter}
+           ORDER BY ae.ts_epoch DESC
+           LIMIT ?`)
+                .all(...fallbackParams);
+            return rows.map(rowToEvent);
+        }
+        params.unshift(ftsQuery);
+        const rows = db
+            .prepare(`SELECT ae.*, activity_events_fts.rank AS rank FROM activity_events ae
+         JOIN activity_events_fts ON activity_events_fts.rowid = ae.id
+         WHERE activity_events_fts MATCH ? ${projectFilter}
+         ORDER BY activity_events_fts.rank
+         LIMIT ?`)
+            .all(...params);
+        return rows.map(rowToEvent);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Aggregate stats for `athene events stats`. Returns null if DB is unavailable.
+ */
+function getActivityEventStats() {
+    const db = getDb();
+    if (!db)
+        return null;
+    try {
+        const totalRow = db.prepare("SELECT COUNT(*) as cnt FROM activity_events").all();
+        const total = totalRow[0]?.["cnt"] ?? 0;
+        const byKindRows = db
+            .prepare("SELECT type, COUNT(*) as cnt FROM activity_events GROUP BY type")
+            .all();
+        const byKind = {};
+        for (const row of byKindRows) {
+            byKind[row["type"]] = row["cnt"];
+        }
+        const bySourceRows = db
+            .prepare("SELECT source, COUNT(*) as cnt FROM activity_events GROUP BY source")
+            .all();
+        const bySource = {};
+        for (const row of bySourceRows) {
+            bySource[row["source"]] = row["cnt"];
+        }
+        const rangeRow = db
+            .prepare("SELECT MIN(ts) as oldest, MAX(ts) as newest FROM activity_events")
+            .all();
+        return {
+            total,
+            byKind,
+            bySource,
+            droppedThisProcess: droppedEventCount(),
+            oldestTs: rangeRow[0]?.["oldest"] ?? undefined,
+            newestTs: rangeRow[0]?.["newest"] ?? undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+
+export { getActivityEventStats, queryActivityEvents, searchActivityEvents };
+//# sourceMappingURL=query-activity-events.js.map

package/dist/query-activity-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-activity-events.js","sources":["../src/query-activity-events.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/recovery/actions.d.ts

@@ -0,0 +1,7 @@
+import type { OrchestratorConfig, PluginRegistry } from "../types.js";
+import type { RecoveryAssessment, RecoveryResult, RecoveryContext } from "./types.js";
+export declare function recoverSession(assessment: RecoveryAssessment, config: OrchestratorConfig, registry: PluginRegistry, context: RecoveryContext): Promise<RecoveryResult>;
+export declare function cleanupSession(assessment: RecoveryAssessment, config: OrchestratorConfig, registry: PluginRegistry, context: RecoveryContext): Promise<RecoveryResult>;
+export declare function escalateSession(assessment: RecoveryAssessment, config: OrchestratorConfig, _registry: PluginRegistry, context: RecoveryContext): Promise<RecoveryResult>;
+export declare function executeAction(assessment: RecoveryAssessment, config: OrchestratorConfig, registry: PluginRegistry, context: RecoveryContext): Promise<RecoveryResult>;
+//# sourceMappingURL=actions.d.ts.map