dev-sessions 0.1.0

package/dist/transcript/claude-parser.js

@@ -0,0 +1,203 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeWorkspacePath = sanitizeWorkspacePath;
+exports.getClaudeTranscriptPath = getClaudeTranscriptPath;
+exports.readClaudeTranscript = readClaudeTranscript;
+exports.extractTextBlocks = extractTextBlocks;
+exports.getAssistantTextBlocks = getAssistantTextBlocks;
+exports.countAssistantMessages = countAssistantMessages;
+exports.countSystemEntries = countSystemEntries;
+exports.inferTranscriptStatus = inferTranscriptStatus;
+exports.hasAssistantResponseAfterLatestUser = hasAssistantResponseAfterLatestUser;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const WAITING_TOOL_NAMES = new Set([
+    'askuserquestion',
+    'ask_user',
+    'ask_human',
+    'request_user_input',
+    'requestuserinput'
+]);
+function sanitizeWorkspacePath(workspacePath) {
+    // Claude normalizes project directory names by replacing non-alphanumeric characters with "-".
+    return node_path_1.default.resolve(workspacePath).replace(/[^a-zA-Z0-9]/g, '-');
+}
+function getClaudeTranscriptPath(workspacePath, internalId, homeDir = node_os_1.default.homedir()) {
+    const sanitizedWorkspacePath = sanitizeWorkspacePath(workspacePath);
+    return node_path_1.default.join(homeDir, '.claude', 'projects', sanitizedWorkspacePath, `${internalId}.jsonl`);
+}
+async function readClaudeTranscript(filePath) {
+    try {
+        const raw = await (0, promises_1.readFile)(filePath, 'utf8');
+        const lines = raw.split('\n');
+        const entries = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0) {
+                continue;
+            }
+            try {
+                const parsed = JSON.parse(trimmed);
+                entries.push(parsed);
+            }
+            catch {
+                // Ignore malformed lines to keep parsing resilient.
+            }
+        }
+        return entries;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+function extractTextBlocks(content) {
+    if (typeof content === 'string') {
+        return content.length > 0 ? [content] : [];
+    }
+    if (Array.isArray(content)) {
+        const textBlocks = [];
+        for (const item of content) {
+            textBlocks.push(...extractTextBlocks(item));
+        }
+        return textBlocks;
+    }
+    if (!content || typeof content !== 'object') {
+        return [];
+    }
+    const record = content;
+    const blockType = typeof record.type === 'string' ? record.type.toLowerCase() : undefined;
+    if (typeof record.text === 'string' &&
+        record.text.length > 0 &&
+        (blockType === undefined || blockType === 'text')) {
+        return [record.text];
+    }
+    if (record.content !== undefined) {
+        return extractTextBlocks(record.content);
+    }
+    return [];
+}
+function isHumanMessage(entry) {
+    const normalizedType = entry.type?.toLowerCase();
+    return normalizedType === 'human' || normalizedType === 'user';
+}
+function isAssistantMessage(entry) {
+    return entry.type?.toLowerCase() === 'assistant';
+}
+function isWaitingToolName(value) {
+    return typeof value === 'string' && WAITING_TOOL_NAMES.has(value.toLowerCase());
+}
+function containsAskUserToolCall(value) {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return value.some((item) => containsAskUserToolCall(item));
+    }
+    if (typeof value !== 'object') {
+        return false;
+    }
+    const record = value;
+    const blockType = typeof record.type === 'string' ? record.type.toLowerCase() : '';
+    const functionValue = record.function && typeof record.function === 'object'
+        ? record.function
+        : undefined;
+    const hasKnownToolName = isWaitingToolName(record.name) ||
+        isWaitingToolName(record.tool) ||
+        isWaitingToolName(record.tool_name) ||
+        isWaitingToolName(functionValue?.name);
+    const hasToolShape = blockType.includes('tool') ||
+        blockType === 'function_call' ||
+        record.input !== undefined ||
+        record.arguments !== undefined ||
+        record.tool !== undefined ||
+        record.tool_name !== undefined ||
+        functionValue !== undefined;
+    if (hasKnownToolName && hasToolShape) {
+        return true;
+    }
+    return Object.values(record).some((item) => containsAskUserToolCall(item));
+}
+function getAssistantTextBlocks(entries) {
+    const assistantBlocks = [];
+    for (const entry of entries) {
+        if (!isAssistantMessage(entry)) {
+            continue;
+        }
+        assistantBlocks.push(...extractTextBlocks(entry.message?.content));
+    }
+    return assistantBlocks;
+}
+function countAssistantMessages(entries) {
+    return entries.reduce((count, entry) => count + (isAssistantMessage(entry) ? 1 : 0), 0);
+}
+function countSystemEntries(entries) {
+    return entries.reduce((count, entry) => count + (entry.type === 'system' ? 1 : 0), 0);
+}
+function findLastIndex(entries, predicate) {
+    for (let index = entries.length - 1; index >= 0; index -= 1) {
+        if (predicate(entries[index])) {
+            return index;
+        }
+    }
+    return -1;
+}
+function inferTranscriptStatus(entries) {
+    if (entries.length === 0) {
+        return 'idle';
+    }
+    let lastHumanIndex = -1;
+    let lastAskUserIndex = -1;
+    entries.forEach((entry, index) => {
+        if (isHumanMessage(entry)) {
+            lastHumanIndex = index;
+        }
+        if (isAssistantMessage(entry) && containsAskUserToolCall(entry)) {
+            lastAskUserIndex = index;
+        }
+    });
+    if (lastAskUserIndex > lastHumanIndex) {
+        return 'waiting_for_input';
+    }
+    const lastEntry = entries[entries.length - 1];
+    // A 'system' entry reliably marks the end of a complete turn in Claude Code transcripts.
+    if (lastEntry.type === 'system') {
+        return 'idle';
+    }
+    if (isAssistantMessage(lastEntry)) {
+        return 'idle';
+    }
+    if (isHumanMessage(lastEntry)) {
+        return 'working';
+    }
+    // For other entry types (progress, file-history-snapshot), fall back to index comparison.
+    // During tool execution, a 'progress' entry may follow an assistant tool_use entry,
+    // but the subsequent tool_result (type=user) hasn't arrived yet — treat as 'working'
+    // unless a system entry closed the turn.
+    const lastAssistantIndex = findLastIndex(entries, (entry) => isAssistantMessage(entry));
+    const lastSystemIndex = findLastIndex(entries, (entry) => entry.type === 'system');
+    // If the last system entry is after the last assistant, the turn is definitely complete.
+    if (lastSystemIndex > lastAssistantIndex && lastAssistantIndex > lastHumanIndex) {
+        return 'idle';
+    }
+    // If there's a progress entry between assistant and the next user entry, Claude may be
+    // executing a tool — prefer 'working' unless the system entry confirms idle.
+    if (lastAssistantIndex > lastHumanIndex && lastSystemIndex < lastAssistantIndex) {
+        return 'working';
+    }
+    return lastAssistantIndex > lastHumanIndex ? 'idle' : 'working';
+}
+function hasAssistantResponseAfterLatestUser(entries) {
+    const lastHumanIndex = findLastIndex(entries, (entry) => isHumanMessage(entry));
+    if (lastHumanIndex < 0) {
+        return entries.some((entry) => isAssistantMessage(entry));
+    }
+    return entries.slice(lastHumanIndex + 1).some((entry) => isAssistantMessage(entry));
+}
+//# sourceMappingURL=claude-parser.js.map

package/dist/transcript/claude-parser.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+export type SessionMode = 'yolo' | 'native' | 'docker';
+export type SessionStatus = 'active' | 'inactive';
+export type AgentTurnStatus = 'idle' | 'working' | 'waiting_for_input';
+export type SessionCli = 'claude' | 'codex';
+export type CodexTurnStatus = 'completed' | 'failed' | 'interrupted';
+export interface StoredSession {
+    championId: string;
+    internalId: string;
+    cli: SessionCli;
+    mode: SessionMode;
+    path: string;
+    description?: string;
+    status: SessionStatus;
+    appServerPid?: number;
+    appServerPort?: number;
+    model?: string;
+    codexTurnInProgress?: boolean;
+    codexLastCompletedAt?: string;
+    lastTurnStatus?: CodexTurnStatus;
+    lastTurnError?: string;
+    lastAssistantMessages?: string[];
+    createdAt: string;
+    lastUsed: string;
+}
+export interface WaitResult {
+    completed: boolean;
+    timedOut: boolean;
+    elapsedMs: number;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "dev-sessions",
+  "version": "0.1.0",
+  "description": "CLI tool to spawn and manage coding agent sessions",
+  "license": "MIT",
+  "bin": {
+    "dev-sessions": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skill/SKILL.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:all": "vitest run",
+    "test:integration": "vitest run tests/integration/",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "express": "^5.2.1",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.8.2",
+    "vitest": "^3.2.4"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: dev-sessions
+description: Spawn, manage, and communicate with other coding agent sessions for parallel work delegation. Use when tasks can be parallelized or when handing off work.
+allowed-tools: Bash(dev-sessions:*)
+---
+
+# dev-sessions: Parallel Agent Delegation
+
+Use `dev-sessions` to offload work to other coding-agent sessions while you continue orchestrating, reviewing, and integrating.
+
+## Quick Reference
+
+```bash
+# Create sessions
+dev-sessions create --description "backend API hardening"
+dev-sessions create --path /path/to/repo --mode native -q
+
+# Send work
+dev-sessions send fizz-top "Implement task from TODO.md"
+dev-sessions send fizz-top --file BRIEF.md
+
+# Monitor and collect
+dev-sessions status fizz-top
+dev-sessions wait fizz-top --timeout 600 --interval 3
+dev-sessions last-message fizz-top --count 2
+dev-sessions list
+
+# Cleanup
+dev-sessions kill fizz-top
+
+# Install this skill
+dev-sessions install-skill --global
+dev-sessions install-skill --local --claude
+dev-sessions install-skill --global --codex
+```
+
+## Delegate vs Do It Yourself
+
+Delegate when:
+- The task can run in parallel with your current work.
+- The scope is large enough to benefit from independent execution.
+- A different expertise area is needed (for example frontend vs backend).
+- Your own context window is getting long and you want to isolate sub-work.
+
+Do it yourself when:
+- The task is trivial or faster to complete directly.
+- The task depends heavily on your current conversation context.
+- The change is a quick fix where delegation overhead would dominate.
+
+## Writing Strong Task Briefs
+
+Include:
+- Context: repo path, subsystem, and what the delegate is expected to own.
+- Constraints: coding standards, forbidden changes, environment limitations.
+- Acceptance criteria: exact behavior or checks that define done.
+- File pointers: specific files to read first.
+- Why: the intent behind the task so the delegate can make good tradeoffs.
+
+Brief template:
+
+```text
+Repo: /abs/path/to/repo
+Goal: <what to implement>
+Why: <business/technical reason>
+Read first:
+- src/moduleA.ts
+- tests/moduleA.test.ts
+Constraints:
+- Do not modify generated files
+- Preserve existing CLI behavior
+Acceptance criteria:
+- All related tests pass
+- New behavior verified in <specific test>
+```
+
+## Delegation Patterns
+
+### Fire-and-Forget (Handoff)
+
+Use when user will check output later.
+
+```bash
+sid=$(dev-sessions create -q --description "handoff")
+dev-sessions send "$sid" --file HANDOFF.md
+# Done for now; no immediate follow-up needed.
+```
+
+### Synchronous Delegation
+
+Use when you need result before continuing.
+
+```bash
+sid=$(dev-sessions create -q --description "implement parser fix")
+dev-sessions send "$sid" "Fix parser bug in src/parser.ts and add tests."
+dev-sessions wait "$sid"
+dev-sessions last-message "$sid"
+```
+
+### Fan-Out
+
+Use when independent tasks can run in parallel.
+
+```bash
+s1=$(dev-sessions create -q --description "frontend")
+s2=$(dev-sessions create -q --description "backend")
+dev-sessions send "$s1" --file FRONTEND_BRIEF.md
+dev-sessions send "$s2" --file BACKEND_BRIEF.md
+dev-sessions wait "$s1"
+dev-sessions wait "$s2"
+dev-sessions last-message "$s1"
+dev-sessions last-message "$s2"
+```
+
+### Iterative Delegation
+
+Use when delegate output informs the next prompt.
+
+```bash
+sid=$(dev-sessions create -q --description "iterative refactor")
+dev-sessions send "$sid" "Step 1: propose refactor plan for src/cache.ts."
+dev-sessions wait "$sid"
+dev-sessions last-message "$sid"
+dev-sessions send "$sid" "Step 2: implement approved plan and add tests."
+dev-sessions wait "$sid"
+dev-sessions last-message "$sid"
+```
+
+## Polling Best Practices
+
+- Prefer `dev-sessions wait <id>` instead of manual polling loops.
+- If polling manually:
+  - Check `dev-sessions status <id>` first.
+  - Read output with `dev-sessions last-message <id>` only when status is `idle`.
+- For complex tasks, wait 30-60 seconds between status checks.
+
+## Anti-Patterns
+
+- Delegating tasks that are quicker to do directly.
+- Sending vague briefs without file references or acceptance criteria.
+- Polling every few seconds for long-running work (wastes tokens).
+- Reading `last-message` repeatedly without checking status first.