@tyhld/conductor 0.10.0 → 0.11.0

package/dist/build-runner.js

@@ -0,0 +1,463 @@
+/**
+ * 司令塔の常駐（試作完走 便⑥・えふさん確定 2026-09-05）。
+ *
+ * 【やること】「この内容で試作する →」を押されたら、人を止めずに最後まで運ぶ。
+ *   ① 探す   … 承認済みでまだ始まっていない設計書を60秒ごとに見る
+ *   ② 計画   … 会議に便の一覧を起草させる（返らなければ設計書から機械的に組む）
+ *   ③ 積む   … 便を【1本ずつ】管制へ積む（★同時1本。前が終わるまで次を積まない）
+ *   ④ 待つ   … 終わったか・詰まったかを管制から読む
+ *   ⑤ 書く   … 進み具合を試作データの口へ書く（★お客さまの画面はそれを読むだけ）
+ *   ⑥ 直す   … 詰まったら同じ便を積み直す（最大3回）。超えたら人へ回して止まる
+ *   ⑦ 締める … 公開の便の報告から URL を、受け入れテストの便から通った数を取り出す
+ *
+ * 【★同時1本】
+ *   1つの試作が終わるまで次の試作を取らない。★複数を並べると、職人（1現場に1人）の
+ *   取り合いになり、どちらも進まないのに画面上は2つとも「作っています」になる。
+ *
+ * 【★落ちても続きから】
+ *   何本目まで進んだかは【中央に書いてある物】が正（口②）。この常駐が手元に持つのは
+ *   「いまどの試作の何本目を待っているか」だけ（★鍵も本文も持たない小さな覚え書き）。
+ *   覚え書きが消えても、積みっぱなしの便を二重に積まないよう、積む前に必ず管制へ確かめる。
+ *
+ * 判断（便の並べ方・積み直し・URL の取り出し）は src/build-plan.ts、
+ * 外との話は src/build-central.ts と src/build-roundtable.ts にある。
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { BUILD_PLAN_KIND, BUILD_PROGRESS_KIND, BUILD_STAGES, applyResult, blockedReasonFor, decideStep, emptyProgress, fallbackPlan, nextDelivery, normalizePlan, parsePlanJson, } from './build-plan.js';
+import { buildCraftsmanPrompt } from './build-prompt.js';
+import { draftPlanByRoundtable } from './build-roundtable.js';
+/** 既定の現場名（★試作の現場は1つ。増やすときは env で渡す）。 */
+export const DEFAULT_BUILD_SITE = 'ai-kana-proto';
+/** 口①を見にいく間隔・秒（★60秒。耳の合図が来れば待たずに1周する）。 */
+export const DEFAULT_BUILD_INTERVAL_SEC = 60;
+/** 合図の受け口の名前（★現場名とぶつからないよう頭に `_` を付ける）。 */
+export const BUILD_NUDGE_NAME = '_build-runner';
+// ───────────────────────────────────────────────────────────────────────────
+// 設定（★足りなければ、何が足りないかを言って止まる）
+// ───────────────────────────────────────────────────────────────────────────
+/** 司令塔が要る環境変数と、その説明（★人が読む）。 */
+export const REQUIRED_ENV = [
+    { name: 'CONDUCTOR_URL', note: '管制のアドレス' },
+    { name: 'CONDUCTOR_TOKEN', note: '管制の合言葉' },
+    { name: 'PROTO_API_BASE', note: '試作の口のアドレス（例 https://ai-kana.ty-hld.com）' },
+    { name: 'CONDUCTOR_PROTO_APP_KEY', note: '試作の口の合言葉（★司令塔専用）' },
+    { name: 'ROUNDTABLE_BASE_URL', note: '会議のアドレス' },
+    { name: 'ROUNDTABLE_APP_KEY', note: '会議の合言葉' },
+];
+/**
+ * 環境変数から設定を組み立てる。
+ *
+ * ★足りない物は【全部まとめて】言う。1つずつ言うと、人は入れ直しを何度も繰り返す。
+ * ★値そのものは絶対に出さない（名前だけ）。
+ */
+export function loadBuildRunnerConfig(env = process.env) {
+    const missing = REQUIRED_ENV.filter(({ name }) => (env[name] ?? '').trim() === '');
+    if (missing.length > 0) {
+        throw new Error('司令塔を動かすには、次の設定が要ります（~/.conductor.env に人が入れてください）:\n' +
+            missing.map((m) => `  ・${m.name} … ${m.note}`).join('\n'));
+    }
+    const site = (env.CONDUCTOR_BUILD_SITE ?? '').trim() || DEFAULT_BUILD_SITE;
+    const home = env.HOME ?? os.homedir();
+    let intervalSec = DEFAULT_BUILD_INTERVAL_SEC;
+    const raw = (env.CONDUCTOR_BUILD_INTERVAL_SEC ?? '').trim();
+    if (raw !== '') {
+        const parsed = Number(raw);
+        if (!Number.isFinite(parsed) || parsed <= 0) {
+            throw new Error(`CONDUCTOR_BUILD_INTERVAL_SEC は正の数で指定してください（指定値: "${raw}"）`);
+        }
+        intervalSec = parsed;
+    }
+    return {
+        url: (env.CONDUCTOR_URL ?? '').trim().replace(/\/+$/, ''),
+        token: (env.CONDUCTOR_TOKEN ?? '').trim(),
+        machine: (env.CONDUCTOR_MACHINE ?? '').trim() || os.hostname(),
+        site,
+        projectDir: (env.CONDUCTOR_BUILD_DIR ?? '').trim() || path.join(home, 'projects', site),
+        protoApiBase: (env.PROTO_API_BASE ?? '').trim().replace(/\/+$/, ''),
+        protoAppKey: (env.CONDUCTOR_PROTO_APP_KEY ?? '').trim(),
+        roundtableBaseUrl: (env.ROUNDTABLE_BASE_URL ?? '').trim().replace(/\/+$/, ''),
+        roundtableAppKey: (env.ROUNDTABLE_APP_KEY ?? '').trim(),
+        intervalSec,
+    };
+}
+/**
+ * 「積んだかどうか分からない」状態で待つ時間（ms）。
+ *
+ * ★管制が配達中の便を孤児として見せ始めるのは3分後（中央の復元しきい値）。
+ *   それより長く待てば、便が本当に積まれていたなら必ず気づける。
+ */
+export const PENDING_GRACE_MS = 5 * 60 * 1000;
+/** 覚え書きの置き場（★再起動で消えない場所。合図の置き場とは別）。 */
+export function resolveMemoPath(env = process.env) {
+    const explicit = (env.CONDUCTOR_BUILD_STATE ?? '').trim();
+    if (explicit !== '')
+        return explicit;
+    const state = (env.XDG_STATE_HOME ?? '').trim();
+    const home = env.HOME ?? os.homedir();
+    const dir = state !== '' ? path.join(state, 'conductor') : path.join(home, '.local', 'state', 'conductor');
+    return path.join(dir, 'build-runner.json');
+}
+/** ファイルで覚える（★読めない・書けないときは「覚えていない」として振る舞う）。 */
+export function createMemoStore(file = resolveMemoPath()) {
+    return {
+        read() {
+            try {
+                if (!existsSync(file))
+                    return null;
+                const parsed = JSON.parse(readFileSync(file, 'utf8'));
+                if (typeof parsed?.projectId !== 'string' || parsed.projectId === '')
+                    return null;
+                return {
+                    projectId: parsed.projectId,
+                    tenantId: typeof parsed.tenantId === 'string' ? parsed.tenantId : '',
+                    specId: typeof parsed.specId === 'string' ? parsed.specId : '',
+                    spec: parsed.spec && typeof parsed.spec === 'object' ? parsed.spec : {},
+                    acceptanceCriteria: Array.isArray(parsed.acceptanceCriteria)
+                        ? parsed.acceptanceCriteria.filter((x) => typeof x === 'string')
+                        : [],
+                    no: typeof parsed.no === 'number' ? parsed.no : 0,
+                    attempt: typeof parsed.attempt === 'number' ? parsed.attempt : 0,
+                    commandId: typeof parsed.commandId === 'string' ? parsed.commandId : '',
+                    pendingSince: typeof parsed.pendingSince === 'number' ? parsed.pendingSince : 0,
+                };
+            }
+            catch {
+                return null;
+            }
+        },
+        write(memo) {
+            try {
+                mkdirSync(path.dirname(file), { recursive: true });
+                writeFileSync(file, `${JSON.stringify(memo, null, 2)}\n`, { mode: 0o600 });
+            }
+            catch {
+                /* 覚えられなくても止まらない。次の回に中央から拾い直す。 */
+            }
+        },
+        clear() {
+            try {
+                rmSync(file, { force: true });
+            }
+            catch {
+                /* 残っても次の回に中央が「終わっている」と言う */
+            }
+        },
+    };
+}
+// ───────────────────────────────────────────────────────────────────────────
+// 人が読む記録（★型番・鍵を出さない）
+// ───────────────────────────────────────────────────────────────────────────
+/**
+ * 記録の1行から、人に意味の無い文字列を伏せる。
+ *
+ * ★型番（projectId などの UUID）と、鍵に見える長い文字列を出さない。
+ *   ★この記録は journalctl に残り、人がそのままサポートへ送る。そこに鍵が写ってはいけない。
+ */
+export function redact(line) {
+    return line
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, '（型番）')
+        .replace(/\b[A-Za-z0-9_-]{32,}\b/g, '（伏せ字）');
+}
+/** 画面（journalctl）へ1行。 */
+export function consoleJournal(line) {
+    console.log(`[build] ${new Date().toLocaleTimeString()} ${redact(line)}`);
+}
+// ───────────────────────────────────────────────────────────────────────────
+// 中央から読んだ物の受け取り方（★形が違っても落とさない）
+// ───────────────────────────────────────────────────────────────────────────
+function isStage(v) {
+    return typeof v === 'string' && BUILD_STAGES.includes(v);
+}
+/** 口②が返した計画を読む。 */
+export function readPlanFromCentral(raw) {
+    const list = raw?.deliveries;
+    if (!Array.isArray(list))
+        return [];
+    const out = [];
+    for (const item of list) {
+        const d = (item ?? {});
+        const no = typeof d.no === 'number' && d.no > 0 ? Math.floor(d.no) : 0;
+        if (no === 0 || !isStage(d.stage))
+            continue;
+        out.push({ no, title: typeof d.title === 'string' ? d.title : '', stage: d.stage });
+    }
+    return out;
+}
+/** 口②が返した進み具合を読む。 */
+export function readProgressFromCentral(raw) {
+    const o = (raw ?? {});
+    const base = emptyProgress();
+    const num = (v) => (typeof v === 'number' && Number.isFinite(v) && v > 0 ? Math.floor(v) : 0);
+    const state = o.state;
+    return {
+        current: num(o.current),
+        state: state === 'done' || state === 'blocked' || state === 'waiting' ? state : 'working',
+        done: Array.isArray(o.done) ? o.done.map(num).filter((n) => n > 0) : base.done,
+        doneCount: num(o.doneCount) || (Array.isArray(o.done) ? o.done.length : 0),
+        results: Array.isArray(o.results)
+            ? o.results
+                .map((r) => (r ?? {}))
+                .filter((r) => num(r.no) > 0)
+                .map((r) => ({
+                no: num(r.no),
+                outcome: typeof r.outcome === 'string' ? r.outcome : '',
+                report: typeof r.report === 'string' ? r.report : '',
+            }))
+            : base.results,
+        url: typeof o.url === 'string' ? o.url : '',
+        passed: num(o.passed),
+        blockedReason: typeof o.blockedReason === 'string' ? o.blockedReason : '',
+    };
+}
+/** 「もう職人の手が離れた」状態（★これ以上待っても変わらない）。 */
+const TERMINAL_FAILURES = new Set(['timeout', 'failed', 'stalled', 'dismissed', 'cancelled']);
+export function createBuildRunner(args) {
+    const { cfg, ports, memo } = args;
+    const journal = args.journal ?? consoleJournal;
+    const now = args.now ?? (() => Date.now());
+    const draft = args.draft ??
+        ((item) => draftPlanByRoundtable({ baseUrl: cfg.roundtableBaseUrl, appKey: cfg.roundtableAppKey }, {
+            tenantId: item.tenantId,
+            title: '試作の便の一覧',
+            spec: item.spec,
+            acceptanceCriteria: item.acceptanceCriteria,
+        }));
+    /** 進み具合を中央へ書く（★書けなければ次の回にやり直す）。 */
+    async function writeProgress(projectId, progress) {
+        const ok = await ports.writeBuildRecord(projectId, { kind: BUILD_PROGRESS_KIND, ...progress });
+        if (!ok)
+            journal('進み具合を書けませんでした。次の確認でやり直します');
+    }
+    /**
+     * 便の一覧を作る。
+     * ★会議が返さなければ設計書から機械的に組む（会議が落ちていても人を待たせない）。
+     */
+    async function makePlan(item) {
+        const res = await draft(item);
+        if (res.ok) {
+            const parsed = parsePlanJson(res.content);
+            if (parsed.length > 0)
+                return normalizePlan(parsed);
+            journal('会議の答えを便の一覧として読めませんでした。設計書から組み立てます');
+        }
+        else {
+            journal(`会議で決められませんでした（${res.message}）。設計書から組み立てます`);
+        }
+        return fallbackPlan(item.spec);
+    }
+    /** 積んだ便が終わったかを読む（★まだなら null）。 */
+    async function collectOutcome(commandId) {
+        const dones = await ports.listDone();
+        const hit = dones.find((d) => d.id === commandId);
+        if (hit) {
+            // ★読んだら印を付ける（同じ便を二度数えない）。
+            await ports.markOrchestrated(commandId);
+            return { outcome: hit.outcome, report: hit.report };
+        }
+        const status = await ports.commandStatus(commandId);
+        if (status === null)
+            return null; // 中央に聞けなかった＝未知。次の回にやり直す。
+        if (status === 'done') {
+            // ★終わってはいるが、完了の一覧から読めなかった（既に印が付いている等）。
+            //   ここで積み直すと、もう入っている変更をもう一度やらせることになる。
+            //   ★「終わった。ただし報告は受け取れなかった」として先へ進む。
+            journal('前の便は終わっていましたが、報告を受け取れませんでした');
+            return { outcome: 'pushed', report: '' };
+        }
+        if (TERMINAL_FAILURES.has(status)) {
+            journal('前の便は途中で終わってしまいました');
+            return { outcome: 'blocked', report: '' };
+        }
+        return null; // queued / sent / perm_wait … まだ進んでいる。
+    }
+    /** 便を1本積む。★積めたら覚え書きを更新する。 */
+    async function enqueue(m, deliveries, target, spec, progress, attempt, retryOf) {
+        // ★二重に積まない。覚え書きが消えた後の再起動でも、ここで必ず気づく。
+        if (await ports.hasInFlight()) {
+            journal('前の便がまだ動いています。終わるまで待ちます');
+            return false;
+        }
+        const body = buildCraftsmanPrompt({
+            site: cfg.site,
+            projectDir: cfg.projectDir,
+            delivery: target,
+            total: deliveries.length,
+            spec,
+            previous: progress.results,
+            deliveries,
+            protoApiBase: cfg.protoApiBase,
+            ...(retryOf !== '' ? { retryOf } : {}),
+        });
+        // ★積む【前】に「いま積もうとしている」を残す。積んだ直後に落ちても、
+        //   次の起動で「積んだかもしれない」と分かる＝いきなり二度目を積まない。
+        memo.write({ ...m, no: target.no, attempt, commandId: '', pendingSince: now() });
+        const id = await ports.enqueue(body);
+        if (id === null) {
+            journal('便を積めませんでした。次の確認でやり直します');
+            // ★積めなかったことは確かなので、印は消してよい（次の回にすぐやり直す）。
+            memo.write({ ...m, no: target.no, attempt: attempt - 1, commandId: '', pendingSince: 0 });
+            return false;
+        }
+        memo.write({ ...m, no: target.no, attempt, commandId: id, pendingSince: 0 });
+        journal(attempt > 1
+            ? `${target.no}本目「${target.title}」をもう一度お願いしました（${attempt}回目）`
+            : `${target.no}本目「${target.title}」をお願いしました`);
+        return true;
+    }
+    /** 進行中の試作を1歩進める。 */
+    async function advance(m) {
+        const build = await ports.getBuild(m.projectId);
+        if (build === null) {
+            // ★口②が 404＝計画がまだ書けていない。覚え書きだけ残っている状態。
+            journal('進み具合を読めませんでした。次の確認でやり直します');
+            return;
+        }
+        const deliveries = readPlanFromCentral(build.plan);
+        let progress = readProgressFromCentral(build.progress);
+        if (deliveries.length === 0) {
+            journal('便の一覧が読めませんでした。担当者が確認します');
+            progress.state = 'blocked';
+            progress.blockedReason = 'うまく段取りを作れませんでした。担当者が確認します。';
+            await writeProgress(m.projectId, progress);
+            memo.clear();
+            return;
+        }
+        if (progress.state === 'done' || progress.state === 'blocked') {
+            memo.clear(); // ★もう終わっている。次の試作へ。
+            return;
+        }
+        // ── 積んだかどうか分からない便を片付ける（★積む直前に落ちた形）──
+        //   管制に在るかもしれないので、勝手に積み直さない。
+        if (m.commandId === '' && m.no > 0 && m.pendingSince > 0) {
+            const orphanDone = (await ports.listDone())[0];
+            if (orphanDone !== undefined) {
+                // ★この現場へ便を積むのは司令塔だけ。終わっている便＝いま待っていた便。
+                journal('積んだ便が終わっていました。結末を引き取ります');
+                memo.write({ ...m, commandId: orphanDone.id, pendingSince: 0 });
+                m = { ...m, commandId: orphanDone.id, pendingSince: 0 };
+            }
+            else if (await ports.hasInFlight()) {
+                journal('積んだ便が動いていました。終わるまで待ちます');
+                return;
+            }
+            else if (now() - m.pendingSince < PENDING_GRACE_MS) {
+                journal('前の便が積まれたかどうかを確かめています');
+                return;
+            }
+            else {
+                // ★十分待っても管制に現れない＝積まれていなかった。同じ便をもう一度積む。
+                m = { ...m, pendingSince: 0, attempt: Math.max(0, m.attempt - 1) };
+                memo.write(m);
+            }
+        }
+        // ── 積んだ便の結末を受け取る ──
+        if (m.commandId !== '') {
+            const step = await collectOutcome(m.commandId);
+            if (step === null)
+                return; // まだ動いている。
+            const delivery = deliveries.find((d) => d.no === m.no);
+            if (delivery === undefined) {
+                // 計画が書き換わった等。覚え書きを捨てて、次の便から組み直す。
+                memo.write({ ...m, no: 0, attempt: 0, commandId: '', pendingSince: 0 });
+                return;
+            }
+            const decision = decideStep(step.outcome, m.attempt);
+            if (decision === 'success') {
+                progress = applyResult(progress, delivery, step.outcome ?? 'pushed', step.report);
+                const next = nextDelivery(deliveries, progress);
+                progress.current = next?.no ?? delivery.no;
+                progress.state = next === null ? 'done' : 'working';
+                await writeProgress(m.projectId, progress);
+                journal(`${delivery.no}本目「${delivery.title}」が終わりました（${progress.doneCount}/${deliveries.length}）`);
+                if (delivery.stage === 'release' && progress.url !== '')
+                    journal('触れる場所が用意できました');
+                if (next === null) {
+                    journal('この試作はぜんぶ終わりました');
+                    memo.clear();
+                    return;
+                }
+                memo.write({ ...m, no: 0, attempt: 0, commandId: '', pendingSince: 0 });
+                m = { ...m, no: 0, attempt: 0, commandId: '', pendingSince: 0 };
+            }
+            else if (decision === 'retry') {
+                const attempt = m.attempt + 1;
+                progress.current = delivery.no;
+                progress.state = 'working';
+                await writeProgress(m.projectId, progress);
+                await enqueue(m, deliveries, delivery, m.spec, progress, attempt, step.report);
+                return;
+            }
+            else {
+                progress.state = 'blocked';
+                progress.blockedReason = blockedReasonFor(delivery, step.report);
+                progress.current = delivery.no;
+                await writeProgress(m.projectId, progress);
+                journal(`${delivery.no}本目を${m.attempt}回試しても進めませんでした。担当者へお知らせします`);
+                memo.clear();
+                return;
+            }
+        }
+        // ── 次の便を積む ──
+        const target = nextDelivery(deliveries, progress);
+        if (target === null) {
+            progress.state = 'done';
+            await writeProgress(m.projectId, progress);
+            journal('この試作はぜんぶ終わりました');
+            memo.clear();
+            return;
+        }
+        progress.current = target.no;
+        progress.state = 'working';
+        await writeProgress(m.projectId, progress);
+        // ★同じ便へ戻ってきたときは、試した回数を引き継ぐ（積み直しの数え直しをさせない）。
+        const attempt = target.no === m.no ? m.attempt + 1 : 1;
+        await enqueue(m, deliveries, target, m.spec, progress, attempt, '');
+    }
+    /** まだ始まっていない試作を1つ拾って始める。 */
+    async function start() {
+        const items = await ports.listSpecs(1);
+        if (items.length === 0)
+            return;
+        const item = items[0];
+        journal('新しい試作の設計書を受け取りました。段取りを組みます');
+        const deliveries = await makePlan(item);
+        // ★計画を書いた時点で、この試作は口①から外れる（＝二度始めない）。
+        const ok = await ports.writeBuildRecord(item.projectId, {
+            kind: BUILD_PLAN_KIND,
+            deliveries,
+        });
+        if (!ok) {
+            journal('段取りを書けませんでした。次の確認でやり直します');
+            return;
+        }
+        const progress = { ...emptyProgress(), current: deliveries[0]?.no ?? 0 };
+        await writeProgress(item.projectId, progress);
+        const m = {
+            projectId: item.projectId,
+            tenantId: item.tenantId,
+            specId: item.specId,
+            spec: item.spec,
+            acceptanceCriteria: item.acceptanceCriteria,
+            no: 0,
+            attempt: 0,
+            commandId: '',
+            pendingSince: 0,
+        };
+        memo.write(m);
+        journal(`${deliveries.length}本の作業に分けました。順番に進めます`);
+        // そのまま1本目を積む（★次の確認を60秒待たせない）。
+        await enqueue(m, deliveries, deliveries[0], item.spec, progress, 1, '');
+    }
+    return {
+        async tick() {
+            const m = memo.read();
+            if (m !== null) {
+                await advance(m);
+                return;
+            }
+            await start();
+        },
+    };
+}

package/dist/cli.js

@@ -19,6 +19,8 @@ import { registerNudgeTarget, unregisterNudgeTarget, watchNudges, } from './nudg
 import { startEar } from './ear.js';
 import { loadEarConfig } from './ear-routing.js';
 import { ensureEnvFilePermissions } from './env-file-perm.js';
+import { createCentralPorts } from './build-central.js';
+import { BUILD_NUDGE_NAME, REQUIRED_ENV, createBuildRunner, createMemoStore, loadBuildRunnerConfig, } from './build-runner.js';
 /** git コマンドを安全に実行し、失敗したら null を返す（git でない/未インストール等）。 */
 function git(args) {
     try {
@@ -278,6 +280,51 @@ function runEarCommand() {
     process.on('SIGINT', stop);
     process.on('SIGTERM', stop);
 }
+/**
+ * `conductor build-runner`: この機に1本だけ動かす「司令塔」（試作完走 便⑥）。
+ *   承認された設計書を拾い、便に分け、1本ずつ管制へ積み、終わるまで見届ける。
+ *   ★職人にも tmux にも触らない（積むのは管制まで。配るのは各現場の relay の仕事）。
+ */
+function runBuildRunnerCommand() {
+    let cfg;
+    try {
+        cfg = loadBuildRunnerConfig();
+    }
+    catch (err) {
+        // ★足りない設定は「何が足りないか」をそのまま出して止まる（黙って動かないのが一番困る）。
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    console.log(`[build] 開始: machine=${cfg.machine} 現場=${cfg.site} 間隔=${cfg.intervalSec}s`);
+    console.log('[build] 停止するには Ctrl+C を押してください。');
+    const runner = createBuildRunner({
+        cfg,
+        ports: createCentralPorts(cfg, { log: (m) => console.log(`[build] ${m}`) }),
+        memo: createMemoStore(),
+    });
+    // ★回し方は relay と同じ道具を使う（多重起動しない・1回の失敗で止まらない）。
+    const loop = createRelayRunner({
+        tick: () => runner.tick(),
+        nextDelayMs: () => cfg.intervalSec * 1000,
+        onError: (err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.log(`[build] 見回りで例外: ${msg}（次の回にやり直します）`);
+        },
+    });
+    void loop.run();
+    // ★耳からの合図が届いたら、60秒を待たずに1周する（届かなくても60秒で回る）。
+    const watcher = watchNudges(BUILD_NUDGE_NAME, () => {
+        console.log('[build] 合図 → 確認を前倒しします');
+        void loop.run();
+    });
+    const stop = () => {
+        loop.stop();
+        watcher.stop();
+        console.log('\n[build] 停止しました。');
+        process.exit(0);
+    };
+    process.on('SIGINT', stop);
+    process.on('SIGTERM', stop);
+}
 /** package.json の version を返す（読めなければ 'unknown'）。dist/cli.js からは ../package.json。 */
 function readVersion() {
     try {
@@ -321,6 +368,7 @@ function printUsage() {
         '使い方:',
         '  conductor start [-s <site>] [-t <idle|working>] [-a <lastAction>]  現場ごとの常駐（heartbeat＋relay）',
         '  conductor ear                                                     この機に1本の「耳」（合図の受け取り役）',
+        '  conductor build-runner                                            この機に1本の「司令塔」（試作の段取り役）',
         '  conductor setup <現場名> [フォルダ] [--profile <default|proto>]     采配くんをこのPCに設置する（初回の1回だけ）',
         '',
         '設置の型（--profile。既定は default＝今までどおり）:',
@@ -348,6 +396,18 @@ function printUsage() {
         '  ★耳が動いていなくても、各relayは上記の間隔のポーリングでこれまでどおり完全に動きます。',
         '  CONDUCTOR_NUDGE_DIR      耳→relay の合図ファイル置き場（既定: $XDG_RUNTIME_DIR/conductor）',
         '',
+        '司令塔（試作完走 便⑥ / この機に1本だけ動かす常駐。systemd の conductor-build-runner.service 推奨）:',
+        '  conductor build-runner は、承認された設計書を60秒ごとに探し、便に分けて管制へ1本ずつ積み、',
+        '  終わるまで見届けます（★同時1本。職人にも tmux にも触りません）。',
+        '  必要な設定（★人が ~/.conductor.env に入れます・値は持ちません）:',
+        // ★一覧はここに書かない。要る設定の正本は src/build-runner.ts の REQUIRED_ENV。
+        //   写すと「案内には載っているのに起動時に別の名前を見る」が起きる。
+        ...REQUIRED_ENV.map((e) => `    ${e.name.padEnd(24)}${e.note}`),
+        '  任意:',
+        '    CONDUCTOR_BUILD_SITE      便を積む現場名（既定: ai-kana-proto）',
+        '    CONDUCTOR_BUILD_DIR       職人の作業フォルダ（既定: ~/projects/<現場名>）',
+        '    CONDUCTOR_BUILD_INTERVAL_SEC  見回りの間隔・秒（既定: 60）',
+        '',
         '例:',
         '  CONDUCTOR_URL=https://<your-conductor-host> \\',
         '    CONDUCTOR_TOKEN=*** conductor start',
@@ -370,6 +430,11 @@ async function main() {
             ensureEnvFilePermissions();
             runEarCommand();
             break;
+        case 'build-runner':
+            // 司令塔も同じ接続設定（~/.conductor.env）を読む常駐なので、同じ揃えをかける。
+            ensureEnvFilePermissions();
+            runBuildRunnerCommand();
+            break;
         case 'setup':
             // ★引数はそのまま setup.sh へ渡す（judgement は全部インストーラ側）。
             runSetupCommand(process.argv.slice(3));

package/dist/proto-profile.js

@@ -178,6 +178,13 @@ export const PROTO_ALLOWED = [
         domains: ['api.vercel.com', 'vercel.com'],
     },
 ];
+/**
+ * 試作の現場の .env に置いてよい項目の名前（★これで全部）。
+ *
+ * ★職人へ渡す指示文（src/build-prompt.ts）もここから引く。名前を2か所に書くと、
+ *   片方を直したときに「指示文だけ古い鍵名を読ませる」ことになる。
+ */
+export const PROTO_ENV_KEYS = ['PROTO_API_BASE', 'PROTO_APP_KEY'];
 /** 試作の現場に置く .env の見本。★本番の鍵の名前を1つも書かない。 */
 export const PROTO_ENV_EXAMPLE = [
     '# 試作（proto）の現場の環境変数の見本です。',
@@ -185,11 +192,11 @@ export const PROTO_ENV_EXAMPLE = [
     '# ★ここに書いてよいのは、試作の口につなぐための2つだけです。',
     '#   本番のデータベース・送信・課金の鍵は、試作の現場には置きません（置かないから漏れません）。',
     '#',
-    '# 使い方: このファイルを .env という名前でコピーし、PROTO_APP_KEY に合言葉を入れてください。',
+    `# 使い方: このファイルを .env という名前でコピーし、${PROTO_ENV_KEYS[1]} に合言葉を入れてください。`,
     '#         合言葉は人が入れます（AI は .env を書けません）。',
     '',
-    `PROTO_API_BASE=${PROTO_ENDPOINT.replace(/\/$/, '')}`,
-    'PROTO_APP_KEY=',
+    `${PROTO_ENV_KEYS[0]}=${PROTO_ENDPOINT.replace(/\/$/, '')}`,
+    `${PROTO_ENV_KEYS[1]}=`,
     '',
 ].join('\n');
 /** 重複を作らず、書いた順を保つ。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {

package/sales-template/setup.sh

@@ -851,7 +851,8 @@ step "⑥ systemd 常駐サービスの設定"
 #   耳を台帳へ載せるのは systemd/ear-install.sh で、下の cleanup_stale_units 呼び出しより
 #   後に実行される。この順序は test/setup-ear-order.test.ts が固定している。
 CURRENT_MACHINE_UNITS=(
-  conductor-ear.service   # ADR-066 の耳（このPCに1本・現役）。掃除してはいけない。
+  conductor-ear.service            # ADR-066 の耳（このPCに1本・現役）。掃除してはいけない。
+  conductor-build-runner.service   # 試作完走 便⑥ の司令塔（このPCに1本・現役）。同上。
 )
 
 cleanup_stale_units() {