vibe-coding-master 0.2.0 → 0.2.2

package/README.md

@@ -22,7 +22,6 @@ Each role runs as a real Claude Code process inside an embedded terminal. The GU
 - Permission mode selection before start, resume, or restart:
   - `default`
   - `bypassPermissions`
-  - `--dangerously-skip-permissions`
 - PM-mediated role messaging through VCM-dispatched route files.
 - Manual and automatic orchestration modes.
 - Two-stage VCM harness setup: deterministic fixed install plus AI-assisted bootstrap.
@@ -188,18 +187,20 @@ The left sidebar is intentionally compact and collapsible:
 
 - `Repository Path`: path input on one row; `Recent` and `Connect` on the next row.
 - `Repository`: connected path, branch, and working tree state. `Working tree: uncommitted changes` means `git status --porcelain` is not empty.
-- `Settings`: `Theme`, `Round alert`, `Try alert`, `Messages`, and `Events`.
+- `Settings`: `Theme`, `Flow pause alert`, `Try alert`, `Messages`, and `Events`.
 - `VCM Harness`: fixed-install status, bootstrap completion checks, and the bootstrap terminal when one is running.
 - `New Task`: one `task name` input.
 - `Tasks`: task list and task status.
 
 All sidebar sections are collapsed by default. When no task is selected, `Repository Path` opens by default.
 
+When VCM is connected to an active task, the bottom of the sidebar shows a task status dock. It stays outside the collapsible groups and shows the task title, task status, start time, total elapsed time, total flow-round count, and Claude Code active runtime. If a flow round is currently active or settling, the dock also shows that round's start time and Claude Code active runtime.
+
 ## Translation
 
 The task header has a global `Translate` button next to `Close Task`. It opens a translation panel beside the embedded terminal for the role consoles and keeps the same on/off setting while switching roles. The terminal and translation panel split the available width evenly.
 
-The task header does not include a manual `Refresh` button. Task status, role status, messages, orchestration state, and round completion state refresh automatically. The remaining `Refresh` button lives only in the sidebar `VCM Harness` section and is for rechecking harness files.
+The task header does not include a manual `Refresh` button. Task status, role status, messages, orchestration state, and flow pause state refresh automatically. The remaining `Refresh` button lives only in the sidebar `VCM Harness` section and is for rechecking harness files.
 
 Translation settings are local and stored in:
 
@@ -211,7 +212,7 @@ The same file stores recent repository paths. The translation API key is stored
 
 The sidebar `Settings` section also stores the UI theme preference in this file. The default is `system`, which follows the OS/browser color-scheme preference; users can cycle between `System`, `Light`, and `Dark`.
 
-The same sidebar also has a `Round alert` toggle. It is on by default and controls the in-app prompt plus a soft two-note completion chime that fires when VCM detects that the current full conversation round is complete. The `Try alert` button triggers the same local prompt and sound for testing.
+The same sidebar also has a `Flow pause alert` toggle. It is on by default and controls the local alert that fires when VCM detects that the current role flow has stopped advancing. Short flows use a weak reminder: the soft two-note chime plays 3 times, 1.4 seconds apart. Flows lasting 10 minutes or longer use a strong reminder: VCM shows an alert dialog and repeats the chime until the user confirms it. The `Try alert` button always triggers the strong reminder for testing.
 
 Translation behavior:
 
@@ -222,6 +223,8 @@ Translation behavior:
 - VCM tails those transcript files in the backend. Closing the translation panel does not stop capture; the tailer stops only when the role session is stopped/restarted or the task is closed.
 - Translation events are cached under the task runtime repo at `.ai/vcm/translation/<task>/<role>/<session-id>.jsonl` and delivered to the frontend through HTTP polling.
 - The polling cursor is the next expected seq: `after=18` acknowledges seq `1..17` and returns seq `18+`; there is no snapshot mismatch error.
+- The translation panel retains the most recent 500 entries per role session in frontend/backend memory. Older entries are pruned from the live panel state and event cache to keep long sessions responsive.
+- Failed output translations are tracked in a backend failure list. When failures exist, the panel shows `Ignore N` and `Retry N`; retry reuses the original entry id so the failed row is replaced by the normal translating/translated flow. If an old failed entry is pruned by the 500-entry cap, its failure-list item is removed too.
 - Assistant prose is shown as English source while translating, then replaced by the translated Chinese result.
 - Assistant prose renders Markdown in the panel, including headings, lists, code fences, tables, and links.
 - Tool calls and tool results are preserved as dim one-line rows such as `● Bash({"command":"npm test"})`.
@@ -245,10 +248,10 @@ CLAUDE.md
 .claude/agents/architect.md
 .claude/agents/coder.md
 .claude/agents/reviewer.md
-.claude/skills/vcm-route-message.md
-.claude/skills/vcm-final-acceptance.md
-.claude/skills/vcm-long-running-validation.md
-.claude/skills/vcm-harness-bootstrap.md
+.claude/skills/vcm-route-message/SKILL.md
+.claude/skills/vcm-final-acceptance/SKILL.md
+.claude/skills/vcm-long-running-validation/SKILL.md
+.claude/skills/vcm-harness-bootstrap/SKILL.md
 .ai/vcm-harness-manifest.json
 .ai/tools/generate-module-index
 .ai/tools/generate-public-surface
@@ -257,6 +260,9 @@ CLAUDE.md
 .github/pull_request_template.md
 ```
 
+Repo-local skills are installed as `.claude/skills/<skill-name>/SKILL.md` so
+Claude Code can register them.
+
 If a managed-block file already exists, VCM preserves user-authored content and only inserts or replaces the VCM block:
 
 ```md
@@ -366,13 +372,15 @@ VCM Harness injects Claude Code `UserPromptSubmit` and `Stop` hooks into `.claud
 
 The implementation keeps only the active manual/auto orchestration mode. It does not expose pause/resume, stage/approve/reject, or a separate agent-facing message CLI.
 
-## Round Completion Alerts
+## Flow Pause Alerts
 
-VCM detects conversation completion from hook-driven role activity state, not PTY silence or message history. `UserPromptSubmit` marks a role `running`, and `Stop` marks that role `idle` with a stop timestamp.
+VCM detects flow pauses from Claude Code hook events, not PTY silence, message history, or pending route files. `UserPromptSubmit` starts a new flow round when none is active, or continues the current round when it fires within the settle window.
 
-For role chains, VCM waits for the final role to reach hook `Stop`. For example, if PM sends work to Coder and Coder sends a result back to PM, the round is not complete when Coder finishes; it is complete only after PM reaches `Stop` for the final response. Pending route files block completion because more dispatch work is waiting; message history does not define completion.
+When a `Stop` hook fires, VCM marks the round as settling for 10 seconds. If another `UserPromptSubmit` fires inside that window, the same round continues and VCM increments the prompt-submit count. If no new prompt is accepted before the deadline, VCM marks the round as `paused`.
 
-When `Round alert` is enabled, the frontend polls the task round state, deduplicates each completion id, shows a small `Round complete` prompt, and plays the local completion chime.
+The normal path is timer-driven: `Stop` starts a backend settle timer, and `UserPromptSubmit` cancels it. Reading the round state also checks expired deadlines as a recovery fallback after process restarts, sleep, or missed timers.
+
+When `Flow pause alert` is enabled, the frontend polls the task round state and deduplicates each pause id. Flow duration is measured from the first `UserPromptSubmit` to the last `Stop`; the 10 second settle window is not counted. If the paused flow lasted less than 10 minutes, it plays the local chime 3 times at 1.4 second intervals. If the paused flow lasted 10 minutes or longer, it shows a modal `Flow paused` alert and repeats the local chime until the user clicks `Confirm`. A pause can mean normal completion, user decision needed, dispatch failure, or another workflow interruption; the point is to get the user to look with the right amount of urgency.
 
 ## Resume Behavior
 
@@ -389,6 +397,8 @@ Session buttons behave as follows:
 - `Restart`: stops the current process if needed, creates a new UUID, and starts a fresh Claude session.
 - `Stop`: stops the embedded terminal process and leaves the persisted Claude session id resumable.
 
+Embedded terminal output is still written to raw role log files under `.ai/vcm/handoffs/logs/`. When a browser reconnects to a running terminal, VCM replays only the tail of that log, capped at 2 MB, rather than streaming the entire historical log back into xterm. This keeps long sessions responsive while preserving full logs on disk until task cleanup.
+
 ## Local Project Files
 
 For a connected repository, VCM uses:

package/dist/backend/adapters/claude-adapter.js

@@ -25,9 +25,6 @@ export function createClaudeAdapter(runner) {
             if (permissionMode === "bypassPermissions") {
                 args.push("--permission-mode", "bypassPermissions");
             }
-            else if (permissionMode === "dangerously-skip-permissions") {
-                args.push("--dangerously-skip-permissions");
-            }
             return {
                 command,
                 args,

package/dist/backend/adapters/filesystem.js

@@ -20,6 +20,20 @@ export function createNodeFileSystemAdapter() {
         async readText(targetPath) {
             return fs.readFile(targetPath, "utf8");
         },
+        async readTextTail(targetPath, maxBytes) {
+            const handle = await fs.open(targetPath, "r");
+            try {
+                const stat = await handle.stat();
+                const length = Math.min(Math.max(0, Math.floor(maxBytes)), stat.size);
+                const position = stat.size - length;
+                const buffer = Buffer.alloc(length);
+                await handle.read(buffer, 0, length, position);
+                return buffer.toString("utf8");
+            }
+            finally {
+                await handle.close();
+            }
+        },
         async writeText(targetPath, content) {
             await fs.mkdir(path.dirname(targetPath), { recursive: true });
             await fs.writeFile(targetPath, content, "utf8");

package/dist/backend/api/round-routes.js

@@ -6,20 +6,11 @@ export function registerRoundRoutes(app, deps) {
         const config = await deps.projectService.loadConfig(project.repoRoot);
         const task = await deps.taskService.loadTask(project.repoRoot, request.params.taskSlug);
         const taskRepoRoot = getTaskRuntimeRepoRoot(task);
-        const sessions = await deps.sessionService.listRoleSessions(project.repoRoot, request.params.taskSlug);
-        const pendingRoutes = await deps.messageService.listPendingRouteFiles({
-            repoRoot: project.repoRoot,
-            taskRepoRoot,
+        return deps.roundService.getTaskRoundState({
             stateRepoRoot: taskRepoRoot,
             stateRoot: config.stateRoot,
-            handoffDir: task.handoffDir,
             taskSlug: request.params.taskSlug
         });
-        return deps.roundService.getTaskRoundState({
-            taskSlug: request.params.taskSlug,
-            sessions,
-            pendingRouteCount: pendingRoutes.length
-        });
     });
 }
 async function requireCurrentProject(projectService) {

package/dist/backend/api/translation-routes.js

@@ -64,6 +64,14 @@ export function registerTranslationRoutes(app, deps) {
         await requireCurrentProject(deps.projectService);
         return deps.translationService.retryTranslation(request.params.sessionId, request.params.translationId);
     });
+    app.post("/api/translation/sessions/:sessionId/failures/ignore", async (request) => {
+        await requireCurrentProject(deps.projectService);
+        return deps.translationService.ignoreTranslationFailures(request.params.sessionId);
+    });
+    app.post("/api/translation/sessions/:sessionId/failures/retry", async (request) => {
+        await requireCurrentProject(deps.projectService);
+        return deps.translationService.retryFailedTranslations(request.params.sessionId);
+    });
 }
 function parseRole(role) {
     if (!isRoleName(role)) {

package/dist/backend/runtime/node-pty-runtime.js

@@ -1,5 +1,6 @@
 import * as pty from "node-pty";
 import { VcmError } from "../errors.js";
+export const TERMINAL_REPLAY_TAIL_LIMIT_BYTES = 2 * 1024 * 1024;
 export function createNodePtyTerminalRuntime(deps) {
     const entries = new Map();
     const now = deps.now ?? (() => new Date().toISOString());
@@ -113,7 +114,7 @@ export function createNodePtyTerminalRuntime(deps) {
             const entry = getEntry(entries, sessionId);
             entry.listeners.add(listener);
             if (options.replay !== false) {
-                void deps.fs.readText(entry.input.logPath)
+                void readTerminalReplayText(deps.fs, entry.input.logPath)
                     .then((data) => {
                     if (!data || !entry.listeners.has(listener)) {
                         return;
@@ -138,6 +139,25 @@ export function createNodePtyTerminalRuntime(deps) {
         }
     };
 }
+async function readTerminalReplayText(fs, logPath) {
+    const data = fs.readTextTail
+        ? await fs.readTextTail(logPath, TERMINAL_REPLAY_TAIL_LIMIT_BYTES)
+        : tailTerminalReplay(await fs.readText(logPath));
+    return tailTerminalReplay(data);
+}
+export function tailTerminalReplay(data, limitBytes = TERMINAL_REPLAY_TAIL_LIMIT_BYTES) {
+    if (limitBytes <= 0 || Buffer.byteLength(data, "utf8") <= limitBytes) {
+        return data;
+    }
+    let start = Math.max(0, data.length - limitBytes);
+    let tail = data.slice(start);
+    while (Buffer.byteLength(tail, "utf8") > limitBytes && start < data.length) {
+        start += Math.max(1, Math.ceil((Buffer.byteLength(tail, "utf8") - limitBytes) / 4));
+        tail = data.slice(start);
+    }
+    const firstLineBreak = tail.indexOf("\n");
+    return firstLineBreak >= 0 ? tail.slice(firstLineBreak + 1) : tail;
+}
 export function buildPtyEnvironment(baseEnv, inputEnv = {}) {
     const env = {
         ...baseEnv,

package/dist/backend/server.js

@@ -83,8 +83,6 @@ export async function createServer(deps, options = {}) {
     registerRoundRoutes(app, {
         projectService: deps.projectService,
         taskService: deps.taskService,
-        sessionService: deps.sessionService,
-        messageService: deps.messageService,
         roundService: deps.roundService
     });
     registerTranslationRoutes(app, {
@@ -164,14 +162,8 @@ export function createDefaultServerDeps(options = {}) {
         sessionService,
         taskService
     });
-    const claudeHookService = createClaudeHookService({
-        projectService,
-        taskService,
-        sessionService,
-        messageService
-    });
+    const roundService = createRoundService({ fs });
     const transcripts = createClaudeTranscriptService();
-    const roundService = createRoundService();
     const translationService = createTranslationService({
         runtime,
         sessionRegistry: registry,
@@ -182,6 +174,14 @@ export function createDefaultServerDeps(options = {}) {
         appSettings,
         provider: createOpenAiCompatibleTranslationProvider()
     });
+    const claudeHookService = createClaudeHookService({
+        projectService,
+        taskService,
+        sessionService,
+        messageService,
+        roundService,
+        translationService
+    });
     return {
         appSettings,
         projectService,

package/dist/backend/services/app-settings-service.js

@@ -179,9 +179,12 @@ function normalizeSettingsFile(input) {
 }
 function normalizePreferences(input) {
     const candidate = isObject(input) ? input : {};
+    const rawFlowPauseAlerts = "flowPauseAlerts" in candidate
+        ? candidate.flowPauseAlerts
+        : candidate.roundCompletionAlerts;
     return {
         themeMode: normalizeThemeMode(candidate.themeMode),
-        roundCompletionAlerts: candidate.roundCompletionAlerts !== false
+        flowPauseAlerts: rawFlowPauseAlerts !== false
     };
 }
 function normalizeThemeMode(input) {

package/dist/backend/services/claude-hook-service.js

@@ -42,6 +42,24 @@ export function createClaudeHookService(deps) {
             transcriptPath: stringOrUndefined(input.event.transcript_path),
             cwd: stringOrUndefined(input.event.cwd)
         });
+        await deps.roundService.recordClaudeHookEvent({
+            stateRepoRoot: context.taskRepoRoot,
+            stateRoot: context.config.stateRoot,
+            taskSlug: input.taskSlug,
+            role: input.role,
+            eventName
+        });
+        if (session) {
+            await deps.translationService.recordConversationBoundary({
+                repoRoot: context.project.repoRoot,
+                taskRepoRoot: context.taskRepoRoot,
+                taskSlug: input.taskSlug,
+                role: input.role,
+                sessionId: session.id,
+                boundaryKind: "start",
+                occurredAt: session.lastPromptSubmittedAt ?? session.updatedAt
+            });
+        }
         const submitted = await deps.messageService.confirmPromptSubmitted({
             repoRoot: context.project.repoRoot,
             taskRepoRoot: context.taskRepoRoot,
@@ -76,6 +94,24 @@ export function createClaudeHookService(deps) {
             transcriptPath: stringOrUndefined(input.event.transcript_path),
             cwd: stringOrUndefined(input.event.cwd)
         });
+        await deps.roundService.recordClaudeHookEvent({
+            stateRepoRoot: context.taskRepoRoot,
+            stateRoot: context.config.stateRoot,
+            taskSlug: input.taskSlug,
+            role: input.role,
+            eventName
+        });
+        if (session) {
+            await deps.translationService.recordConversationBoundary({
+                repoRoot: context.project.repoRoot,
+                taskRepoRoot: context.taskRepoRoot,
+                taskSlug: input.taskSlug,
+                role: input.role,
+                sessionId: session.id,
+                boundaryKind: "end",
+                occurredAt: session.lastStopAt ?? session.updatedAt
+            });
+        }
         const dispatched = await deps.messageService.scanAndDispatchPendingRouteFiles({
             repoRoot: context.project.repoRoot,
             taskRepoRoot: context.taskRepoRoot,

package/dist/backend/services/harness-service.js

@@ -55,29 +55,33 @@ const HARNESS_FILES = [
     },
     {
         kind: "skill-vcm-route-message",
-        path: ".claude/skills/vcm-route-message.md",
+        path: ".claude/skills/vcm-route-message/SKILL.md",
         title: "VCM Route Message Skill",
+        frontmatter: renderSkillFrontmatter("vcm-route-message", "Use when a VCM role needs to hand off work, ask a question, report a result, report a blocker, or raise a finding to another VCM role."),
         ownership: "whole-file",
         renderRules: renderVcmRouteMessageSkillRules
     },
     {
         kind: "skill-vcm-final-acceptance",
-        path: ".claude/skills/vcm-final-acceptance.md",
+        path: ".claude/skills/vcm-final-acceptance/SKILL.md",
         title: "VCM Final Acceptance Skill",
+        frontmatter: renderSkillFrontmatter("vcm-final-acceptance", "Use when project-manager is ready to decide whether a VCM-managed task can be accepted, returned for follow-up, or blocked for a decision."),
         ownership: "whole-file",
         renderRules: renderVcmFinalAcceptanceSkillRules
     },
     {
         kind: "skill-vcm-harness-bootstrap",
-        path: ".claude/skills/vcm-harness-bootstrap.md",
+        path: ".claude/skills/vcm-harness-bootstrap/SKILL.md",
         title: "VCM Harness Bootstrap Skill",
+        frontmatter: renderSkillFrontmatter("vcm-harness-bootstrap", "Use when VCM needs AI-assisted project understanding to finish or refresh project-specific harness content."),
         ownership: "whole-file",
         renderRules: renderVcmHarnessBootstrapSkillRules
     },
     {
         kind: "skill-vcm-long-running-validation",
-        path: ".claude/skills/vcm-long-running-validation.md",
+        path: ".claude/skills/vcm-long-running-validation/SKILL.md",
         title: "VCM Long-Running Validation Skill",
+        frontmatter: renderSkillFrontmatter("vcm-long-running-validation", "Use for builds, browser checks, E2E tests, release suites, or any validation command that may take long enough for shell-completion callbacks to become unreliable."),
         ownership: "whole-file",
         renderRules: renderVcmLongRunningValidationSkillRules
     },
@@ -469,6 +473,9 @@ function isPlainObject(value) {
 function renderAgentFrontmatter(name, description) {
     return `---\nname: ${name}\ndescription: ${description}\ntools: Read, Grep, Glob, Bash, Edit, Write\n---`;
 }
+function renderSkillFrontmatter(name, description) {
+    return `---\nname: ${name}\ndescription: ${description}\n---`;
+}
 function resolveHarnessPath(repoRoot, relativePath) {
     return path.join(repoRoot, relativePath);
 }
@@ -512,7 +519,7 @@ async function checkFixedHarness(fs, repoRoot) {
     const requiredPaths = [
         "CLAUDE.md",
         ".ai/vcm-harness-manifest.json",
-        ".claude/skills/vcm-harness-bootstrap.md",
+        ".claude/skills/vcm-harness-bootstrap/SKILL.md",
         ".ai/tools/generate-module-index",
         ".ai/tools/generate-public-surface"
     ];
@@ -810,9 +817,6 @@ function buildClaudeStartCommand(command = "claude", permissionMode = "default",
     if (permissionMode === "bypassPermissions") {
         args.push("--permission-mode", "bypassPermissions");
     }
-    else if (permissionMode === "dangerously-skip-permissions") {
-        args.push("--dangerously-skip-permissions");
-    }
     return {
         command,
         args,