@weiping/wingline-core 0.1.1 → 0.2.0

package/dist/commands/templates.js

@@ -0,0 +1,120 @@
+const CHECKER_LAUNCH = 'codex --model gpt-6-astra -c model_reasoning_effort="high"';
+export const TEAM_TEMPLATES = {
+    duo: {
+        id: 'duo',
+        label: '双人协作',
+        summary: 'builder 负责实现，checker 负责独立审查',
+        lead: 'builder',
+        posts: [
+            { id: 'builder', role: 'builder', agent: 'claude', model: 'opus', brief: 'briefs/builder.md' },
+            { id: 'checker', role: 'checker', agent: 'codex', launch: CHECKER_LAUNCH, brief: 'briefs/checker.md' },
+        ],
+        links: { builder: { reviewed_by: ['checker'] } },
+    },
+    solo: {
+        id: 'solo',
+        label: '单人',
+        summary: '单岗位 builder 独立完成实现与自检',
+        lead: 'builder',
+        posts: [
+            { id: 'builder', role: 'builder', agent: 'claude', model: 'opus', brief: 'briefs/builder.md' },
+        ],
+        links: {},
+    },
+    trio: {
+        id: 'trio',
+        label: '三人流水线',
+        summary: 'planner 规划拆解，移交 builder 实现，checker 负责审查',
+        lead: 'planner',
+        posts: [
+            { id: 'planner', role: 'planner', agent: 'claude', model: 'opus', brief: 'briefs/planner.md' },
+            { id: 'builder', role: 'builder', agent: 'claude', model: 'opus', brief: 'briefs/builder.md' },
+            { id: 'checker', role: 'checker', agent: 'codex', launch: CHECKER_LAUNCH, brief: 'briefs/checker.md' },
+        ],
+        links: {
+            planner: { hands_to: ['builder'] },
+            builder: { reviewed_by: ['checker'] },
+        },
+    },
+};
+export const ROLE_BRIEFS = {
+    builder: (team, _post) => [
+        `你是 ${team} 团队的实现岗，负责把需求落成代码。`,
+        '',
+        '- 先读懂需求和现有代码，再说明方案，再实现。',
+        '- 优先写测试，再写实现；每次改动保持测试通过。',
+        `- 完成一个可审查的改动后，用 \`wl send checker@${team} "<摘要和文件列表>"\` 请审查岗审查。`,
+        '- 收到审查意见后，逐条回应：修改，或说明为什么不改。',
+        '- 需求不清时向牵头岗或用户确认，不要自行扩大范围。',
+    ].join('\n'),
+    checker: (team, _post) => [
+        `你是 ${team} 团队的审查岗，负责独立审查改动。`,
+        '',
+        '- 收到审查请求后，先看改动本身和相关测试，再给意见。',
+        '- 重点看：正确性、边界情况、测试是否真的覆盖了行为、是否引入不必要的复杂度。',
+        `- 意见分级：必须修改 / 建议修改 / 仅供参考；用 \`wl send builder@${team} "<意见>"\` 回复。`,
+        '- 你可以运行测试和只读命令，但不要直接改实现岗的代码；需要改动时把建议发给对方。',
+        '- 没有问题时明确回复"通过"，并说明你检查了什么。',
+    ].join('\n'),
+    planner: (team, _post) => [
+        `你是 ${team} 团队的规划岗，负责拆解需求与验收标准。`,
+        '',
+        '- 先读懂需求与现有代码结构，给出清晰的分步方案与边界条件。',
+        '- 将拆解好的子任务与验收标准写清楚，避免模糊描述。',
+        `- 方案就绪后，用 \`wl send builder@${team} "<方案与任务说明>"\` 移交实现岗。`,
+        '- 实现或审查过程中遇到范围变更时，及时更新方案并同步相关岗位。',
+        '- 拿不准的产品或架构取舍先向用户确认，不要替用户拍板。',
+    ].join('\n'),
+};
+export function renderTeamYaml(t, a) {
+    const repo = a.repo.startsWith('path:') ? a.repo : `path:${a.repo}`;
+    const lines = [
+        'version: 1',
+        `name: ${a.name}`,
+        `repo: ${JSON.stringify(repo)}`,
+        'norms: NORMS.md',
+        `lead: ${t.lead}`,
+        'posts:',
+    ];
+    for (const p of t.posts) {
+        lines.push(`  - id: ${p.id}`, `    agent: ${p.agent}`);
+        if (p.model)
+            lines.push(`    model: ${p.model}`);
+        if (p.launch)
+            lines.push(`    launch: '${p.launch}'`);
+        lines.push('    worktree: current', `    brief: [${p.brief}]`);
+    }
+    const linkEntries = Object.entries(t.links);
+    if (linkEntries.length > 0) {
+        lines.push('links:');
+        for (const [post, rels] of linkEntries) {
+            lines.push(`  ${post}:`);
+            for (const [rel, targets] of Object.entries(rels)) {
+                lines.push(`    ${rel}: [${targets.join(', ')}]`);
+            }
+        }
+    }
+    return `${lines.join('\n')}\n`;
+}
+export function renderNorms(a) {
+    const lead = a.posts[0] ?? 'builder';
+    const peer = a.posts[1] ?? lead;
+    return [
+        `# ${a.team} 团队规范`,
+        '',
+        `在岗角色：${a.posts.join('、')}。`,
+        '',
+        '1. 改动前先用一两句话说明你打算怎么做，再动手。',
+        '2. 改完先自己跑测试，确认通过再汇报。',
+        `3. 需要其他岗位审查或回答时，用 \`wl send <地址> "<消息>"\` 联系，地址形如 \`${peer}@${a.team}\`。`,
+        '4. 消息写清楚：改了什么、在哪个文件、希望对方做什么。',
+        '5. 不修改其他岗位正在改的文件；拿不准时先问。',
+        '6. 小步提交，提交信息说明为什么改。',
+        `7. 遇到无法判断的事（需求不清、权限、破坏性操作），停下来问牵头岗 \`${lead}@${a.team}\`，不要猜。`,
+        '8. 收到消息后尽快回复；暂时无法处理时说明原因。',
+        '',
+    ].join('\n');
+}
+export function renderBrief(role, a) {
+    return `# ${a.post} 岗位说明\n\n${ROLE_BRIEFS[role](a.team, a.post)}\n`;
+}

package/dist/index.d.ts

@@ -9,18 +9,22 @@ export * from './orca/types.js';
 export * from './spec/hash.js';
 export * from './spec/load.js';
 export * from './spec/draft.js';
+export * from './spec/doc.js';
 export * from './spec/edit.js';
 export * from './spec/plan-change.js';
+export * from './spec/facade.js';
 export * from './commands/spec.js';
 export * from './commands/about.js';
 export * from './registry/registry.js';
 export * from './brief/render.js';
 export * from './audit.js';
+export * from './audit-table.js';
 export * from './commands/deps.js';
 export * from './commands/locate.js';
 export * from './commands/up.js';
 export * from './commands/restore/index.js';
 export * from './commands/autostart/index.js';
+export * from './commands/autostart/sys.js';
 export * from './commands/version-range.js';
 export * from './commands/ps.js';
 export * from './commands/send.js';
@@ -48,9 +52,12 @@ export * from './commands/task/escalate.js';
 export { HEARTBEAT_STALE_MS, HEARTBEAT_TAKEOVER_MS, dispatcherHealth, dispatcherLaunchCommand, dispatcherUp, dispatcherDown, type DispatcherHealth, type UpArgs as DispatcherUpArgs, } from './commands/dispatcher/lifecycle.js';
 export * from './commands/dispatcher/loop.js';
 export * from './commands/dispatcher/attention.js';
+export * from './commands/dispatcher/signal-summary.js';
 export * from './commands/dispatcher/controls.js';
 export * from './commands/dispatcher/inbox.js';
 export * from './commands/dispatcher/outlets.js';
 export * from './commands/dispatcher/signals.js';
 export * from './commands/dispatcher/advance.js';
 export * from './commands/dispatcher/orca-sync.js';
+export * from './commands/templates.js';
+export * from './commands/init.js';

package/dist/index.js

@@ -9,18 +9,22 @@ export * from './orca/types.js';
 export * from './spec/hash.js';
 export * from './spec/load.js';
 export * from './spec/draft.js';
+export * from './spec/doc.js';
 export * from './spec/edit.js';
 export * from './spec/plan-change.js';
+export * from './spec/facade.js';
 export * from './commands/spec.js';
 export * from './commands/about.js';
 export * from './registry/registry.js';
 export * from './brief/render.js';
 export * from './audit.js';
+export * from './audit-table.js';
 export * from './commands/deps.js';
 export * from './commands/locate.js';
 export * from './commands/up.js';
 export * from './commands/restore/index.js';
 export * from './commands/autostart/index.js';
+export * from './commands/autostart/sys.js';
 export * from './commands/version-range.js';
 export * from './commands/ps.js';
 export * from './commands/send.js';
@@ -48,9 +52,12 @@ export * from './commands/task/escalate.js';
 export { HEARTBEAT_STALE_MS, HEARTBEAT_TAKEOVER_MS, dispatcherHealth, dispatcherLaunchCommand, dispatcherUp, dispatcherDown, } from './commands/dispatcher/lifecycle.js';
 export * from './commands/dispatcher/loop.js';
 export * from './commands/dispatcher/attention.js';
+export * from './commands/dispatcher/signal-summary.js';
 export * from './commands/dispatcher/controls.js';
 export * from './commands/dispatcher/inbox.js';
 export * from './commands/dispatcher/outlets.js';
 export * from './commands/dispatcher/signals.js';
 export * from './commands/dispatcher/advance.js';
 export * from './commands/dispatcher/orca-sync.js';
+export * from './commands/templates.js';
+export * from './commands/init.js';

package/dist/orca/client.js

@@ -29,6 +29,8 @@ function tabTitles(node, found = new Map()) {
 }
 const retryArgs = (a) => (a.retryRequest ? ['--retry-request', a.retryRequest] : []);
 const replayedOf = (r) => r.mutation?.replayed ?? false;
+/** run-list 每页 10 条；翻够这么多页还没完，就当找不全（`wl up` 会按这个提示走 --adopt-run）。 */
+const RUN_LIST_MAX_PAGES = 50;
 const toTask = (t) => ({
     id: t.id,
     status: t.status,
@@ -39,27 +41,35 @@ const toTask = (t) => ({
     dispatchId: t.dispatch_id ?? null,
     result: t.result ?? null,
 });
+// Orca 1.4.251 起 run-* 的简版回执只剩 { runId, objective }（没有 coordinator_handle），
+// --full 才给完整记录；下面这几个调用都要 --full，否则协调者句柄读不出来。
 function runMethods(runner) {
     return {
         async runCreate(a) {
-            const r = await runner.json(['orchestration', 'run-create', '--objective', a.objective, '--from', a.from, ...retryArgs(a)]);
+            const r = await runner.json(['orchestration', 'run-create', '--full', '--objective', a.objective, '--from', a.from, ...retryArgs(a)]);
             return { id: r.run.id, coordinatorHandle: r.run.coordinator_handle, replayed: replayedOf(r) };
         },
         async runUse(a) {
-            const r = await runner.json(['orchestration', 'run-use', '--id', a.id, '--from', a.from]);
+            const r = await runner.json(['orchestration', 'run-use', '--full', '--id', a.id, '--from', a.from]);
             return { coordinatorHandle: r.run.coordinator_handle };
         },
         async runShow(a) {
-            const r = await runner.json(['orchestration', 'run-show', '--id', a.id]);
+            const r = await runner.json(['orchestration', 'run-show', '--full', '--id', a.id]);
             return { coordinatorHandle: r.run.coordinator_handle };
         },
         async runList() {
-            const r = await runner.json(['orchestration', 'run-list']);
-            // 还有下一页就不能当成"找全了"：按 objective 找回 Run 会漏掉后面的候选
-            if (r.nextCursor ?? r.page?.nextCursor) {
-                throw new WinglineError('orca', 'run_list_truncated', 'run-list 结果不止一页，无法确认没有其他候选 Run', { hint: '用 wl up --adopt-run <id> 指定要找回的 Run' });
+            const runs = [];
+            let cursor;
+            for (let page = 0; page < RUN_LIST_MAX_PAGES; page++) {
+                const r = await runner.json(['orchestration', 'run-list', '--full', ...(cursor ? ['--cursor', cursor] : [])]);
+                runs.push(...r.runs.map((x) => ({ id: x.id, objective: x.objective, coordinatorHandle: x.coordinator_handle, createdAt: x.created_at })));
+                // 还有下一页就得接着翻：按 objective 找回 Run 会漏掉后面的候选
+                const next = r.nextCursor ?? r.page?.nextCursor ?? undefined;
+                if (!next || next === cursor)
+                    return runs;
+                cursor = next;
             }
-            return r.runs.map((x) => ({ id: x.id, objective: x.objective, coordinatorHandle: x.coordinator_handle, createdAt: x.created_at }));
+            throw new WinglineError('orca', 'run_list_truncated', 'run-list 分页超过上限，无法确认没有其他候选 Run', { hint: '用 wl up --adopt-run <id> 指定要找回的 Run' });
         },
         async requestShow(a) {
             const r = await runner.json(['orchestration', 'request-show', '--request', a.request]);
@@ -166,10 +176,14 @@ function inboxMethods(runner) {
             };
         },
         async reply(a) {
+            // Orca 1.4.251 起回执是 { messageId }；旧版是 { message: { id } }。两种都认。
             const r = await runner.json([
                 'orchestration', 'reply', '--id', a.id, '--body', a.body, '--run', a.run, '--from', a.from,
             ]);
-            return { messageId: r.message.id, duplicate: r.duplicate ?? false };
+            const messageId = r.message?.id ?? r.messageId;
+            if (!messageId)
+                throw new WinglineError('orca', 'reply_shape_unknown', 'Orca 的回复回执里没有 messageId');
+            return { messageId, duplicate: r.duplicate ?? false };
         },
         async workerList(a) {
             const r = await runner.json(['orchestration', 'worker-list', '--run', a.run]);
@@ -243,6 +257,10 @@ function terminalMethods(runner) {
             const r = await runner.json(['terminal', 'close', '--terminal', a.handle]);
             return { ptyKilled: r.close.ptyKilled };
         },
+        async terminalSwitch(a) {
+            const r = await runner.json(['terminal', 'switch', '--terminal', a.handle]);
+            return { navigated: r.focus.navigated };
+        },
     };
 }
 /**

package/dist/orca/types.d.ts

@@ -113,6 +113,12 @@ export interface OrcaClient {
     terminalClose(a: {
         handle: string;
     }): Promise<CloseResult>;
+    /** 把 Orca 窗口切到某个终端标签页（UI 导航，不改变终端本身）。 */
+    terminalSwitch(a: {
+        handle: string;
+    }): Promise<{
+        navigated: boolean;
+    }>;
     runCreate(a: {
         objective: string;
         from: string;

package/dist/registry/registry.d.ts

@@ -172,6 +172,13 @@ export declare class Registry {
     /** 换 id 与参数；给了 expectedOld 时是比较后交换：旧 id 已被别的进程换掉则不动，返回 false。 */
     reissueIntent(id: string, retryRequest: string, args: unknown, expectedOld?: string): boolean;
     dropRequest(id: string): void;
+    /**
+     * 岗位生命周期结束（down --close / 终端已消失）时，把该岗位未完成的请求行结为 done。
+     * 不结账的话，下次 up 的 nextRequestId 会沿用在 Orca 侧早已完成的旧行（本地还是 uncertain），
+     * beginRequest 与 Orca 的完成记录互相矛盾，up 卡死在 request_already_done。
+     * 返回结账的行数。
+     */
+    finalizePostRequests(team: string, post: string): number;
     listOpenRequests(prefix: string): Array<{
         id: string;
         state: RequestState;

package/dist/registry/registry.js

@@ -264,6 +264,18 @@ export class Registry {
     dropRequest(id) {
         this.db.prepare('DELETE FROM requests WHERE id = ?').run(id);
     }
+    /**
+     * 岗位生命周期结束（down --close / 终端已消失）时，把该岗位未完成的请求行结为 done。
+     * 不结账的话，下次 up 的 nextRequestId 会沿用在 Orca 侧早已完成的旧行（本地还是 uncertain），
+     * beginRequest 与 Orca 的完成记录互相矛盾，up 卡死在 request_already_done。
+     * 返回结账的行数。
+     */
+    finalizePostRequests(team, post) {
+        const open = this.listOpenRequests(`${team}:${post}:`);
+        for (const r of open)
+            this.finishRequest(r.id, 'done', { closed: true });
+        return open.length;
+    }
     listOpenRequests(prefix) {
         const rows = this.db
             .prepare("SELECT id, state, updated_at, args FROM requests WHERE state IN ('pending','uncertain') AND substr(id, 1, ?) = ? ORDER BY id")

package/dist/server/api-read.js

@@ -1,3 +1,4 @@
+import fs from 'node:fs';
 import { checkParam } from './http.js';
 import { WinglineError } from '../errors.js';
 import { ps } from '../commands/ps.js';
@@ -9,45 +10,60 @@ import { listStale } from '../commands/task/query.js';
 import { readTimeline } from '../commands/log.js';
 import { postAddress } from '../commands/deps.js';
 import { plainText } from '../view/plain-text.js';
-async function teamSummary(ctx, name) {
-    const posts = await ps(ctx.deps, { team: name });
-    const disp = dispatcherHealth(ctx.deps, name).state;
-    const att = await attention(ctx.deps, name);
-    return {
-        name,
-        postsCount: posts.length,
-        dispatcher: disp,
-        attentionCount: pendingCount(att),
-    };
+import { draftPathOf } from '../spec/draft.js';
+/** 总览摘要：未启动团队（runId === null）不碰 Orca——ps() 的 preflight 会抛错，直接给注册表口径（spec 3.3.4）。 */
+async function teamSummary(ctx, row) {
+    const base = { name: row.name, status: row.status, hasDraft: fs.existsSync(draftPathOf(row.specPath)) };
+    const dispatcher = dispatcherHealth(ctx.deps, row.name).state;
+    if (row.runId === null) {
+        return { ...base, postsCount: ctx.deps.registry.listPosts(row.name).length, dispatcher, attentionCount: 0 };
+    }
+    const posts = await ps(ctx.deps, { team: row.name });
+    const att = await attention(ctx.deps, row.name);
+    return { ...base, postsCount: posts.length, dispatcher, attentionCount: pendingCount(att) };
+}
+/** 未启动 / Orca 不可达时的离线岗位：全部字段来自注册表，handle 一律为 null（spec 3.3.4）。 */
+function offlinePosts(posts) {
+    return posts.map((p) => ({
+        address: p.address, agent: p.agent, status: 'offline', handle: null, worktree: p.worktree, isLead: p.isLead, sessionId: p.sessionId,
+    }));
 }
 function registerTeamRoutes(r) {
     // GET /api/teams
     r.get('/api/teams', async (ctx) => {
-        const teams = ctx.deps.registry.listTeams().map((t) => t.name);
-        const result = await Promise.all(teams.map((name) => teamSummary(ctx, name)));
-        return { teams: result };
+        const rows = ctx.deps.registry.listTeams();
+        return { teams: await Promise.all(rows.map((row) => teamSummary(ctx, row))) };
     });
     // GET /api/teams/:team
     r.get('/api/teams/:team', async (ctx) => {
         const team = ctx.params.team;
         checkParam('team', team);
-        const posts = await ps(ctx.deps, { team });
-        const disp = await dispatcherStatus(ctx.deps, team);
-        const runId = ctx.deps.registry.getTeam(team)?.runId ?? null;
-        // 移除 sessionMarker，只留 sessionId
-        const cleanPosts = posts.map((p) => {
-            const row = ctx.deps.registry.getPost(p.address);
+        const { registry } = ctx.deps;
+        const row = registry.getTeam(team);
+        if (!row)
+            throw new WinglineError('input', 'team_unknown', `没有团队 ${team}`, { hint: '先执行 wl up <team.yaml>' });
+        const base = { team, runId: row.runId, status: row.status, specPath: row.specPath, hasDraft: fs.existsSync(draftPathOf(row.specPath)) };
+        // 从未启动：不调 ps()/dispatcherStatus()，Orca 一次都不碰（spec 3.3.4）
+        if (row.runId === null) {
             return {
-                ...p,
-                sessionId: row?.sessionId ?? null,
+                ...base, neverStarted: true,
+                dispatcher: { health: { state: 'never' }, frozen: 0, hushed: 0, attentionItems: 0 },
+                posts: offlinePosts(registry.listPosts(team)),
             };
-        });
-        return {
-            team,
-            runId,
-            dispatcher: disp,
-            posts: cleanPosts,
-        };
+        }
+        let posts;
+        let orcaUnavailable;
+        try {
+            posts = (await ps(ctx.deps, { team })).map((p) => ({ ...p, sessionId: registry.getPost(p.address)?.sessionId ?? null }));
+        }
+        catch (err) {
+            // Orca 不可达：降级为离线岗位列表并附原因，其余照常返回
+            if (!(err instanceof WinglineError) || err.kind !== 'orca')
+                throw err;
+            orcaUnavailable = err.message;
+            posts = offlinePosts(registry.listPosts(team));
+        }
+        return { ...base, ...(orcaUnavailable !== undefined ? { orcaUnavailable } : {}), dispatcher: await dispatcherStatus(ctx.deps, team), posts };
     });
     // GET /api/teams/:team/attention
     r.get('/api/teams/:team/attention', async (ctx) => {

package/dist/server/api-spec.js

@@ -12,14 +12,45 @@ function assertFields(body, allowed) {
             throw new WinglineError('input', 'unknown_field', `未知字段 ${k}`);
     }
 }
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** set 的三种形态：{ path, value }（op 缺省）、{ op: 'add_post', post }、{ op: 'remove_post', index }。 */
 function parseSet(raw) {
     if (raw === undefined)
         return undefined;
-    const s = raw;
-    const ok = s && typeof s === 'object' && Array.isArray(s.path) && s.path.length > 0 && s.path.every((p) => typeof p === 'string' || Number.isInteger(p));
-    if (!ok || !('value' in s))
-        throw new WinglineError('input', 'invalid_param', '参数 set 不合法');
-    return { path: s.path, value: s.value };
+    const bad = new WinglineError('input', 'invalid_param', '参数 set 不合法');
+    if (!isObj(raw))
+        throw bad;
+    if (raw.op === 'add_post') {
+        const p = raw.post;
+        if (!isObj(p) || typeof p.id !== 'string' || !p.id || typeof p.agent !== 'string' || !p.agent)
+            throw bad;
+        if (p.brief !== undefined && (!Array.isArray(p.brief) || !p.brief.every((b) => typeof b === 'string')))
+            throw bad;
+        for (const k of ['model', 'launch', 'worktree']) {
+            if (p[k] !== undefined && typeof p[k] !== 'string')
+                throw bad;
+        }
+        return { op: 'add_post', post: p };
+    }
+    if (raw.op === 'remove_post') {
+        if (!Number.isInteger(raw.index) || raw.index < 0)
+            throw bad;
+        return { op: 'remove_post', index: raw.index };
+    }
+    if (raw.op !== undefined && raw.op !== 'set')
+        throw bad;
+    const ok = Array.isArray(raw.path) && raw.path.length > 0 && raw.path.every((p) => typeof p === 'string' || Number.isInteger(p));
+    if (!ok || !('value' in raw))
+        throw bad;
+    return { path: raw.path, value: raw.value };
+}
+function parseFiles(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (!isObj(raw) || !Object.values(raw).every((v) => typeof v === 'string')) {
+        throw new WinglineError('input', 'invalid_param', '参数 files 不合法');
+    }
+    return raw;
 }
 /** 编辑器与“关于”页的只读 / 校验接口。validate 虽是 POST，但不写文件、不进审计。 */
 export function registerSpecRoutes(r, o) {
@@ -29,9 +60,14 @@ export function registerSpecRoutes(r, o) {
     });
     r.post('/api/teams/:team/spec/validate', async (ctx) => {
         checkParam('team', ctx.params.team);
-        assertFields(ctx.body, ['yaml', 'set']);
+        assertFields(ctx.body, ['yaml', 'set', 'files']);
         checkParam('yaml', ctx.body.yaml);
-        return validateSpecEdit(ctx.deps, { team: ctx.params.team, yaml: ctx.body.yaml, set: parseSet(ctx.body.set) });
+        return validateSpecEdit(ctx.deps, {
+            team: ctx.params.team,
+            yaml: ctx.body.yaml,
+            set: parseSet(ctx.body.set),
+            files: parseFiles(ctx.body.files),
+        });
     });
     r.get('/api/about', async (ctx) => about(ctx.deps, { version: o.version, consoleFile: readConsoleFile(ctx.deps.home) }));
 }

package/dist/server/api-write.d.ts

@@ -1,12 +1,42 @@
 import type { HandlerContext, Router } from './http.js';
+import { type CommandDeps } from '../commands/deps.js';
 import { type AuditTable } from '../audit.js';
 import { send } from '../commands/send.js';
 import { createTask } from '../commands/task/create.js';
 import { escalateTask, recoverTask, resolveGate } from '../commands/task/escalate.js';
 import { reassignTask } from '../commands/task/claim.js';
+import { type DoneResult } from '../commands/task/done.js';
+import type { Delivery } from '../commands/task/dispatch.js';
 import { freezePostCmd, hushCmd, unfreezePostCmd, unhushCmd } from '../commands/dispatcher/controls.js';
 import { dispatcherReply } from '../commands/dispatcher/inbox.js';
 import { discardDraftCmd, saveSpecCmd } from '../commands/spec.js';
+import { type UpResult } from '../commands/up.js';
+import type { DownResult } from '../commands/down.js';
+import type { RestoreResult } from '../commands/restore/index.js';
+import { initTeamCmd } from '../commands/init.js';
+/** 控制台口径的参数：带 team 名（审计表靠它取团队），开关在路由层已归一成 boolean。 */
+export interface ConsoleUpArgs {
+    team: string;
+    draft?: boolean;
+    newRun?: boolean;
+    adoptRun?: string;
+}
+/** 控制台 / 插件的调度员启动参数；node/script 供插件 worker 等非 wingline 宿主覆盖 self 命令。 */
+export interface ConsoleDispatcherUpArgs {
+    team: string;
+    node?: string;
+    script?: string;
+}
+export interface ConsoleDownArgs {
+    team: string;
+    close?: boolean;
+}
+export interface ConsoleRestoreArgs {
+    team: string;
+    dryRun?: boolean;
+    noTasks?: boolean;
+    sessions?: Record<string, string>;
+}
 export interface WriteCommands {
     send: typeof send;
     createTask: typeof createTask;
@@ -14,6 +44,31 @@ export interface WriteCommands {
     reassignTask: typeof reassignTask;
     recoverTask: typeof recoverTask;
     resolveGate: typeof resolveGate;
+    claimTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<void>;
+    releaseTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<void>;
+    planTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+        text: string;
+    }) => Promise<void>;
+    startTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<{
+        delivery: Delivery;
+        reason?: string;
+        already?: true;
+    }>;
+    doneTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<DoneResult>;
     freezePostCmd: typeof freezePostCmd;
     unfreezePostCmd: typeof unfreezePostCmd;
     hushCmd: typeof hushCmd;
@@ -21,6 +76,35 @@ export interface WriteCommands {
     dispatcherReply: typeof dispatcherReply;
     saveSpecCmd: typeof saveSpecCmd;
     discardDraftCmd: typeof discardDraftCmd;
+    up: (deps: CommandDeps, a: ConsoleUpArgs) => Promise<UpResult>;
+    down: (deps: CommandDeps, a: ConsoleDownArgs) => Promise<DownResult>;
+    restore: (deps: CommandDeps, a: ConsoleRestoreArgs) => Promise<RestoreResult>;
+    dispatcherUp: (deps: CommandDeps, a: ConsoleDispatcherUpArgs) => Promise<{
+        address: string;
+        outcome: 'already_running' | 'started';
+        handle?: string;
+    }>;
+    dispatcherDown: (deps: CommandDeps, a: {
+        team: string;
+        close?: boolean;
+    }) => Promise<{
+        address: string;
+        outcome: 'noop' | 'closed' | 'already_gone';
+    }>;
+    initTeamCmd: typeof initTeamCmd;
+    autostartInstall: (deps: CommandDeps, a: {
+        waitOrca?: string;
+    }) => Promise<{
+        platform: string;
+        file: string;
+        command: string[];
+        logPath: string;
+        waitOrca: string;
+    }>;
+    autostartUninstall: (deps: CommandDeps) => Promise<{
+        file: string;
+        removed: boolean;
+    }>;
 }
 export interface WriteRouteSpec {
     pattern: string;
@@ -30,7 +114,7 @@ export interface WriteRouteSpec {
 }
 export declare const WRITE_ROUTES: WriteRouteSpec[];
 export declare const CONSOLE_AUDIT: AuditTable<WriteCommands>;
-/** 控制台用 `console:`，TUI 用 `tui:`；两者共用同一张审计表，执行者都是 human。 */
-export declare function auditedWriteCommands(prefix: 'console:' | 'tui:'): WriteCommands;
+/** 控制台用 `console:`，TUI 用 `tui:`，Orca 插件用 `plugin:`；三者共用同一张审计表，执行者都是 human。 */
+export declare function auditedWriteCommands(prefix: 'console:' | 'tui:' | 'plugin:'): WriteCommands;
 export declare const consoleCommands: () => WriteCommands;
 export declare function registerWriteRoutes(r: Router, cmds: WriteCommands): void;