@tt-a1i/hive 0.6.0-alpha.8 → 1.1.2

package/dist/src/server/sqlite-schema-v13.js

@@ -2,4 +2,3 @@ import { applySchemaVersion12 } from './sqlite-schema-v12.js';
 export const applySchemaVersion13 = (db) => {
     applySchemaVersion12(db);
 };
-//# sourceMappingURL=sqlite-schema-v13.js.map

package/dist/src/server/sqlite-schema-v14.js

@@ -82,4 +82,3 @@ const backfillDispatchesFromMessages = (db) => {
     });
     backfill();
 };
-//# sourceMappingURL=sqlite-schema-v14.js.map

package/dist/src/server/sqlite-schema-v15.js

@@ -71,4 +71,3 @@ export const applySchemaVersion15 = (db) => {
     }
     createDispatchIndexes(db);
 };
-//# sourceMappingURL=sqlite-schema-v15.js.map

package/dist/src/server/sqlite-schema-v16.js

@@ -4,4 +4,3 @@ export const applySchemaVersion16 = (db) => {
         db.exec('ALTER TABLE agent_launch_configs ADD COLUMN preset_augmentation_disabled INTEGER NOT NULL DEFAULT 0');
     }
 };
-//# sourceMappingURL=sqlite-schema-v16.js.map

package/dist/src/server/sqlite-schema-v17.js

@@ -13,4 +13,3 @@ export const applySchemaVersion17 = (db) => {
         updatePreset.run(preset.yoloArgsTemplate?.length ? JSON.stringify(preset.yoloArgsTemplate) : null, now, preset.id);
     }
 };
-//# sourceMappingURL=sqlite-schema-v17.js.map

package/dist/src/server/sqlite-schema-v18.js

@@ -4,4 +4,3 @@ export const applySchemaVersion18 = (db) => {
         db.exec('ALTER TABLE agent_launch_configs ADD COLUMN interactive_command TEXT');
     }
 };
-//# sourceMappingURL=sqlite-schema-v18.js.map

package/dist/src/server/sqlite-schema-v5.js

@@ -59,4 +59,3 @@ export const applySchemaVersion5 = (db) => {
     DROP TABLE messages_legacy;
   `);
 };
-//# sourceMappingURL=sqlite-schema-v5.js.map

package/dist/src/server/sqlite-schema-v7.js

@@ -68,4 +68,3 @@ export const applySchemaVersion7 = (db) => {
      VALUES (?, ?, ?)
      ON CONFLICT(key) DO NOTHING`).run('active_workspace_id', null, now);
 };
-//# sourceMappingURL=sqlite-schema-v7.js.map

package/dist/src/server/sqlite-schema-v8.js

@@ -4,4 +4,3 @@ export const applySchemaVersion8 = (db) => {
         db.exec('ALTER TABLE agent_launch_configs ADD COLUMN command_preset_id TEXT');
     }
 };
-//# sourceMappingURL=sqlite-schema-v8.js.map

package/dist/src/server/sqlite-schema-v9.js

@@ -4,4 +4,3 @@ export const applySchemaVersion9 = (db) => {
      SET yolo_args_template = ?, updated_at = ?
      WHERE id = ? AND is_builtin = 1`).run(JSON.stringify(CLAUDE_DEFAULT_YOLO_ARGS), Date.now(), 'claude');
 };
-//# sourceMappingURL=sqlite-schema-v9.js.map

package/dist/src/server/sqlite-schema.js

@@ -204,4 +204,3 @@ export const initializeRuntimeDatabase = (db) => {
         db.prepare('INSERT INTO schema_version (version, applied_at) VALUES (?, ?)').run(18, Date.now());
     }
 };
-//# sourceMappingURL=sqlite-schema.js.map

package/dist/src/server/startup-command-parser.js

@@ -35,4 +35,3 @@ export const getStartupCommandExecutable = (startupCommand) => {
     const match = /^(['"]?)([^'"\s]+)\1/.exec(command);
     return match?.[2] ?? null;
 };
-//# sourceMappingURL=startup-command-parser.js.map

package/dist/src/server/system-message.js

@@ -1,2 +1 @@
 export const wrapSystemMessage = (content) => `[Hive 系统消息：${content}]`;
-//# sourceMappingURL=system-message.js.map

package/dist/src/server/tasks-file-watcher.js

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import chokidar from 'chokidar';
-import { ensureTasksFile, getTasksFilePath } from './tasks-file.js';
+import { ensureProtocolFile, ensureTasksFile, getTasksFilePath } from './tasks-file.js';
 const DEBOUNCE_MS = 100;
 export const createTasksFileWatcher = ({ onTasksUpdated, }) => {
     const watchers = new Map();
@@ -38,6 +38,7 @@ export const createTasksFileWatcher = ({ onTasksUpdated, }) => {
         start: async (workspaceId, workspacePath) => {
             await stop(workspaceId);
             ensureTasksFile(workspacePath);
+            ensureProtocolFile(workspacePath);
             const watcher = chokidar.watch(getTasksFilePath(workspacePath), {
                 ignoreInitial: true,
             });
@@ -57,4 +58,3 @@ export const createTasksFileWatcher = ({ onTasksUpdated, }) => {
         stop,
     };
 };
-//# sourceMappingURL=tasks-file-watcher.js.map

package/dist/src/server/tasks-file.d.ts

@@ -5,7 +5,17 @@ interface TasksFileService {
 export declare const HIVE_DIR_NAME = ".hive";
 export declare const TASKS_FILE_NAME = "tasks.md";
 export declare const TASKS_RELATIVE_PATH = ".hive/tasks.md";
+export declare const PROTOCOL_FILE_NAME = "PROTOCOL.md";
+export declare const PROTOCOL_RELATIVE_PATH = ".hive/PROTOCOL.md";
 export declare const getTasksFilePath: (workspacePath: string) => string;
+export declare const getProtocolFilePath: (workspacePath: string) => string;
 export declare const ensureTasksFile: (workspacePath: string) => string;
+/**
+ * Always overwrites `.hive/PROTOCOL.md` with the freshly-built protocol doc.
+ * The doc is marked auto-generated so user edits are not expected; rewriting
+ * on every workspace open means a Hive version bump that changes the rules
+ * propagates without manual intervention.
+ */
+export declare const ensureProtocolFile: (workspacePath: string) => string;
 export declare const createTasksFileService: () => TasksFileService;
 export type { TasksFileService };

package/dist/src/server/tasks-file.js

@@ -1,9 +1,13 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
+import { buildProtocolDoc } from './hive-team-guidance.js';
 export const HIVE_DIR_NAME = '.hive';
 export const TASKS_FILE_NAME = 'tasks.md';
 export const TASKS_RELATIVE_PATH = `${HIVE_DIR_NAME}/${TASKS_FILE_NAME}`;
+export const PROTOCOL_FILE_NAME = 'PROTOCOL.md';
+export const PROTOCOL_RELATIVE_PATH = `${HIVE_DIR_NAME}/${PROTOCOL_FILE_NAME}`;
 export const getTasksFilePath = (workspacePath) => join(workspacePath, HIVE_DIR_NAME, TASKS_FILE_NAME);
+export const getProtocolFilePath = (workspacePath) => join(workspacePath, HIVE_DIR_NAME, PROTOCOL_FILE_NAME);
 const getLegacyTasksFilePath = (workspacePath) => join(workspacePath, TASKS_FILE_NAME);
 const ensureTasksDir = (workspacePath) => {
     mkdirSync(dirname(getTasksFilePath(workspacePath)), { recursive: true });
@@ -19,6 +23,22 @@ export const ensureTasksFile = (workspacePath) => {
     writeFileSync(tasksFilePath, content, 'utf8');
     return content;
 };
+/**
+ * Always overwrites `.hive/PROTOCOL.md` with the freshly-built protocol doc.
+ * The doc is marked auto-generated so user edits are not expected; rewriting
+ * on every workspace open means a Hive version bump that changes the rules
+ * propagates without manual intervention.
+ */
+export const ensureProtocolFile = (workspacePath) => {
+    ensureTasksDir(workspacePath);
+    const protocolFilePath = getProtocolFilePath(workspacePath);
+    const desired = buildProtocolDoc();
+    const current = existsSync(protocolFilePath) ? readFileSync(protocolFilePath, 'utf8') : null;
+    if (current === desired)
+        return desired;
+    writeFileSync(protocolFilePath, desired, 'utf8');
+    return desired;
+};
 export const createTasksFileService = () => {
     return {
         readTasks(workspacePath) {
@@ -30,4 +50,3 @@ export const createTasksFileService = () => {
         },
     };
 };
-//# sourceMappingURL=tasks-file.js.map

package/dist/src/server/tasks-websocket-server.js

@@ -74,4 +74,3 @@ export const createTasksWebSocketServer = (server, store) => {
         },
     };
 };
-//# sourceMappingURL=tasks-websocket-server.js.map

package/dist/src/server/team-authz.js

@@ -30,4 +30,3 @@ export const requireCommandForRole = (agent, command) => {
         throw new ForbiddenError(`Role '${agent.role}' is not allowed to run team ${command}`);
     }
 };
-//# sourceMappingURL=team-authz.js.map

package/dist/src/server/team-list-enrichment.js

@@ -38,4 +38,3 @@ export const enrichTeamList = (workspaceId, store, workers) => workers.map((work
         next.commandPresetId = presetId;
     return next;
 });
-//# sourceMappingURL=team-list-enrichment.js.map

package/dist/src/server/team-list-serializer.js

@@ -7,4 +7,3 @@ export const serializeTeamListItem = ({ commandPresetId, id, lastPtyLine, name,
     last_pty_line: lastPtyLine ?? null,
     command_preset_id: commandPresetId ?? null,
 });
-//# sourceMappingURL=team-list-serializer.js.map

package/dist/src/server/team-operations.js

@@ -143,4 +143,3 @@ export const createTeamOperations = ({ agentRuntime, createDispatch, deleteDispa
         },
     };
 };
-//# sourceMappingURL=team-operations.js.map

package/dist/src/server/terminal-flow-control.js

@@ -114,4 +114,3 @@ export const createTerminalOutputFlow = (ws, { onBackpressureChange }) => {
         },
     };
 };
-//# sourceMappingURL=terminal-flow-control.js.map

package/dist/src/server/terminal-protocol.js

@@ -39,4 +39,3 @@ export const serializeTerminalExit = (code) => {
 export const serializeTerminalRestore = (snapshot) => {
     return JSON.stringify({ type: 'restore', snapshot });
 };
-//# sourceMappingURL=terminal-protocol.js.map

package/dist/src/server/terminal-state-mirror.js

@@ -65,4 +65,3 @@ export class TerminalStateMirror {
         }));
     }
 }
-//# sourceMappingURL=terminal-state-mirror.js.map

package/dist/src/server/terminal-stream-hub.js

@@ -176,4 +176,3 @@ export const createTerminalStreamHub = (store) => {
         },
     };
 };
-//# sourceMappingURL=terminal-stream-hub.js.map

package/dist/src/server/terminal-ws-server.js

@@ -87,4 +87,3 @@ export const createTerminalWebSocketServer = (server, store) => {
     });
     return { close: () => hub.close() };
 };
-//# sourceMappingURL=terminal-ws-server.js.map

package/dist/src/server/ui-auth-helpers.js

@@ -20,4 +20,3 @@ export const requireUiTokenFromRequest = (request, validateUiToken) => {
         throw new ForbiddenError('UI endpoint requires valid UI token');
     }
 };
-//# sourceMappingURL=ui-auth-helpers.js.map

package/dist/src/server/ui-auth.js

@@ -10,4 +10,3 @@ export const createUiAuth = () => {
         },
     };
 };
-//# sourceMappingURL=ui-auth.js.map

package/dist/src/server/version-service.js

@@ -67,4 +67,3 @@ export const createVersionService = (options = {}) => {
         },
     };
 };
-//# sourceMappingURL=version-service.js.map

package/dist/src/server/worker-output-tracker.js

@@ -48,4 +48,3 @@ export const createWorkerOutputTracker = (outputBus) => {
         },
     };
 };
-//# sourceMappingURL=worker-output-tracker.js.map

package/dist/src/server/workspace-path-validation.js

@@ -24,4 +24,3 @@ export const validateWorkspacePath = (path) => {
     }
     return resolved;
 };
-//# sourceMappingURL=workspace-path-validation.js.map

package/dist/src/server/workspace-shell-runtime.d.ts

@@ -0,0 +1,29 @@
+import type { WorkspaceSummary } from '../shared/types.js';
+import type { AgentManager } from './agent-manager.js';
+import type { LiveAgentRun } from './agent-runtime-types.js';
+export declare const getWorkspaceShellAgentId: (workspaceId: string) => string;
+export declare const isWorkspaceShellAgentId: (agentId: string) => boolean;
+export declare const resolveWorkspaceShellLaunch: (env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform) => {
+    args: string[];
+    command: string;
+};
+export declare const createWorkspaceShellRuntime: (agentManager: AgentManager | undefined) => {
+    close(): void;
+    closeRun(workspaceId: string, runId: string): boolean;
+    deleteWorkspace(workspaceId: string): void;
+    getLiveRun(runId: string): LiveAgentRun | undefined;
+    hasRun: (runId: string) => boolean;
+    listTerminalRuns(workspaceId: string): {
+        agent_id: string;
+        agent_name: string;
+        run_id: string;
+        status: import("./agent-manager.js").RunStatus;
+    }[];
+    pauseRun(runId: string): void;
+    resizeRun(runId: string, cols: number, rows: number): void;
+    resumeRun(runId: string): void;
+    start(workspace: WorkspaceSummary): Promise<LiveAgentRun>;
+    stopRun(runId: string): void;
+    writeInput(runId: string, text: string): void;
+};
+export type WorkspaceShellRuntime = ReturnType<typeof createWorkspaceShellRuntime>;

package/dist/src/server/workspace-shell-runtime.js

@@ -0,0 +1,179 @@
+import { basename } from 'node:path';
+const WORKSPACE_SHELL_SUFFIX = ':shell';
+export const getWorkspaceShellAgentId = (workspaceId) => `${workspaceId}${WORKSPACE_SHELL_SUFFIX}`;
+export const isWorkspaceShellAgentId = (agentId) => agentId.endsWith(WORKSPACE_SHELL_SUFFIX);
+const shouldUseLoginShell = (command) => {
+    const name = basename(command).toLowerCase();
+    return name === 'bash' || name === 'fish' || name === 'ksh' || name === 'zsh';
+};
+const getEnvValue = (env, key, platform) => {
+    if (platform !== 'win32')
+        return env[key];
+    const matched = Object.keys(env).find((item) => item.toLowerCase() === key.toLowerCase());
+    return matched ? env[matched] : undefined;
+};
+export const resolveWorkspaceShellLaunch = (env = process.env, platform = process.platform) => {
+    if (platform === 'win32')
+        return { command: getEnvValue(env, 'ComSpec', platform) ?? 'cmd.exe', args: [] };
+    const command = env.SHELL || '/bin/sh';
+    return { command, args: shouldUseLoginShell(command) ? ['-l'] : [] };
+};
+export const createWorkspaceShellRuntime = (agentManager) => {
+    const labelsByRunId = new Map();
+    const nextShellNumberByWorkspaceId = new Map();
+    const workspaceIdsByRunId = new Map();
+    const runIdsByWorkspaceId = new Map();
+    const startedAtByRunId = new Map();
+    const requireManager = () => {
+        if (!agentManager)
+            throw new Error('Agent manager is required for workspace shell terminals');
+        return agentManager;
+    };
+    const hasRun = (runId) => workspaceIdsByRunId.has(runId);
+    const toLiveRun = (runId) => {
+        try {
+            return {
+                ...requireManager().getRun(runId),
+                startedAt: startedAtByRunId.get(runId) ?? Date.now(),
+            };
+        }
+        catch (error) {
+            detachRun(runId);
+            throw error;
+        }
+    };
+    const detachRun = (runId) => {
+        const workspaceId = workspaceIdsByRunId.get(runId);
+        if (workspaceId) {
+            const retained = (runIdsByWorkspaceId.get(workspaceId) ?? []).filter((id) => id !== runId);
+            if (retained.length > 0)
+                runIdsByWorkspaceId.set(workspaceId, retained);
+            else
+                runIdsByWorkspaceId.delete(workspaceId);
+        }
+        labelsByRunId.delete(runId);
+        workspaceIdsByRunId.delete(runId);
+        startedAtByRunId.delete(runId);
+    };
+    const attachRun = (workspaceId, runId, label, startedAt) => {
+        labelsByRunId.set(runId, label);
+        workspaceIdsByRunId.set(runId, workspaceId);
+        startedAtByRunId.set(runId, startedAt);
+        runIdsByWorkspaceId.set(workspaceId, [...(runIdsByWorkspaceId.get(workspaceId) ?? []), runId]);
+    };
+    const nextLabel = (workspaceId) => {
+        const next = nextShellNumberByWorkspaceId.get(workspaceId) ?? 1;
+        nextShellNumberByWorkspaceId.set(workspaceId, next + 1);
+        return `Shell ${next}`;
+    };
+    const stopPtyRun = (runId) => {
+        requireManager().stopRun(runId);
+    };
+    const closeRun = (runId) => {
+        try {
+            stopPtyRun(runId);
+        }
+        catch {
+            // The shell may have already exited or been removed by the PTY manager.
+        }
+        try {
+            requireManager().removeRun(runId);
+        }
+        catch {
+            // The PTY manager may have already dropped the run.
+        }
+        detachRun(runId);
+    };
+    return {
+        close() {
+            for (const runId of Array.from(workspaceIdsByRunId.keys()))
+                closeRun(runId);
+            runIdsByWorkspaceId.clear();
+            workspaceIdsByRunId.clear();
+            startedAtByRunId.clear();
+            labelsByRunId.clear();
+            nextShellNumberByWorkspaceId.clear();
+        },
+        closeRun(workspaceId, runId) {
+            if (workspaceIdsByRunId.get(runId) !== workspaceId)
+                return false;
+            closeRun(runId);
+            return true;
+        },
+        deleteWorkspace(workspaceId) {
+            for (const runId of Array.from(runIdsByWorkspaceId.get(workspaceId) ?? [])) {
+                try {
+                    closeRun(runId);
+                }
+                catch {
+                    // Workspace deletion should not fail because the shell already exited.
+                }
+            }
+            runIdsByWorkspaceId.delete(workspaceId);
+            nextShellNumberByWorkspaceId.delete(workspaceId);
+        },
+        getLiveRun(runId) {
+            if (!hasRun(runId))
+                return undefined;
+            return toLiveRun(runId);
+        },
+        hasRun,
+        listTerminalRuns(workspaceId) {
+            return (runIdsByWorkspaceId.get(workspaceId) ?? []).flatMap((runId) => {
+                try {
+                    const run = toLiveRun(runId);
+                    return [
+                        {
+                            agent_id: getWorkspaceShellAgentId(workspaceId),
+                            agent_name: labelsByRunId.get(runId) ?? 'Shell',
+                            run_id: run.runId,
+                            status: run.status,
+                        },
+                    ];
+                }
+                catch {
+                    return [];
+                }
+            });
+        },
+        pauseRun(runId) {
+            if (hasRun(runId))
+                requireManager().pauseRun(runId);
+        },
+        resizeRun(runId, cols, rows) {
+            if (hasRun(runId))
+                requireManager().resizeRun(runId, cols, rows);
+        },
+        resumeRun(runId) {
+            if (hasRun(runId))
+                requireManager().resumeRun(runId);
+        },
+        async start(workspace) {
+            const startedAt = Date.now();
+            const launch = resolveWorkspaceShellLaunch();
+            const run = await requireManager().startAgent({
+                agentId: getWorkspaceShellAgentId(workspace.id),
+                args: launch.args,
+                command: launch.command,
+                cwd: workspace.path,
+                env: {
+                    COLORTERM: 'truecolor',
+                    FORCE_COLOR: '1',
+                    NO_COLOR: undefined,
+                    TERM: 'xterm-256color',
+                    TERM_PROGRAM: 'hive-shell',
+                },
+            });
+            attachRun(workspace.id, run.runId, nextLabel(workspace.id), startedAt);
+            return { ...run, startedAt };
+        },
+        stopRun(runId) {
+            if (hasRun(runId))
+                stopPtyRun(runId);
+        },
+        writeInput(runId, text) {
+            if (hasRun(runId))
+                requireManager().writeInput(runId, text);
+        },
+    };
+};

package/dist/src/server/workspace-store-contract.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=workspace-store-contract.js.map

package/dist/src/server/workspace-store-hydration.js

@@ -58,4 +58,3 @@ export const seedWorkspacesFromDb = (db, workspaces, messageKinds) => {
     }
     applyMessageKinds(workspaces, messageKinds);
 };
-//# sourceMappingURL=workspace-store-hydration.js.map

package/dist/src/server/workspace-store-mutations.js

@@ -46,4 +46,3 @@ export const markTaskReported = (workspaces, workspaceId, workerId) => {
     if (worker.status !== 'stopped')
         worker.status = getStatusFromPendingCount(worker.pendingTaskCount);
 };
-//# sourceMappingURL=workspace-store-mutations.js.map

package/dist/src/server/workspace-store-support.js

@@ -22,4 +22,3 @@ export const applyPendingTaskCount = (worker, type, preserveStoppedStatus) => {
         worker.status = getStatusFromPendingCount(worker.pendingTaskCount);
     }
 };
-//# sourceMappingURL=workspace-store-support.js.map

package/dist/src/server/workspace-store.js

@@ -116,4 +116,3 @@ export const createWorkspaceStore = (db, messageKinds) => {
         markTaskReported: (workspaceId, workerId) => markTaskReported(workspaces, workspaceId, workerId),
     };
 };
-//# sourceMappingURL=workspace-store.js.map

package/dist/src/shared/types.js

@@ -1,2 +1 @@
 export const agentStatuses = ['idle', 'working', 'stopped'];
-//# sourceMappingURL=types.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tt-a1i/hive",
-  "version": "0.6.0-alpha.8",
+  "version": "1.1.2",
   "description": "Browser-native hive-mind for CLI coding agents — Claude Code, Codex, Gemini, and OpenCode collaborate as real PTY processes via a team protocol.",
   "type": "module",
   "packageManager": "pnpm@10.30.3",