@tyhld/conductor 0.9.0 → 0.11.0

package/dist/build-prompt.js

@@ -0,0 +1,144 @@
+/**
+ * 職人へ渡す指示文の【型】（試作完走 便⑥・えふさん確定 2026-09-05）。
+ *
+ * 【★この1本が正本】
+ *   司令塔が積む便の本文は、必ずここで組む。★他所で文字列を継ぎ足さない
+ *   （2か所で組むと、片方だけ「URL を書いてください」を落として release 便が
+ *    静かに URL 無しで終わる——そして誰も気づけない）。
+ *
+ * 【★ここに書かないもの】
+ *   報告の書き方（REPORT_START／DONE／conductor_complete）は relay が送信のときに
+ *   必ず足す（src/relay.ts の buildSendText）。★ここで重ねて書かない。
+ *
+ * 【★試作の現場は本番の鍵を持たない（便⑧の型と対になる）】
+ *   データの読み書きは試作の口（/api/proto/records）だけ。DDL も本番の鍵も渡さない。
+ *   ＝人に確認を求める操作が、そもそも指示文の中に出てこない。
+ */
+import { asList, } from './build-plan.js';
+// ★試作の現場に置いてよい鍵の名前は、便⑧の正本（試作の型）が持つ。ここでは写さず引く。
+import { PROTO_ENV_KEYS } from './proto-profile.js';
+/** 段階ごとに、設計書のどの項目を渡すか（★全部渡すと読み飛ばされる）。 */
+const FIELDS_BY_STAGE = {
+    design: ['goal', 'users', 'jobs_to_be_done', 'prototype_scope', 'out_of_scope', 'assumptions'],
+    data: ['entities', 'data_model', 'storage', 'permissions'],
+    screens: ['screens', 'user_flows', 'responsive_requirements'],
+    features: ['prototype_scope', 'user_flows', 'integrations', 'auth', 'permissions'],
+    testing: ['acceptance_criteria', 'test_scenarios'],
+    release: ['deployment_target', 'security_constraints', 'acceptance_criteria'],
+};
+/** 設計書の項目の言い換え（★お客さまが読むわけではないが、職人にも日本語で渡す）。 */
+const FIELD_LABELS = {
+    goal: '目的',
+    users: '使う人',
+    jobs_to_be_done: '出来るようになること',
+    prototype_scope: '最初に作る機能',
+    out_of_scope: '今回は作らないこと',
+    acceptance_criteria: '完成条件',
+    screens: '画面の一覧',
+    user_flows: '使う人の動きの順番',
+    entities: '扱うものの種類',
+    data_model: 'それぞれが持つ項目',
+    permissions: 'だれが何をしてよいか',
+    integrations: 'つなぐ外のサービス',
+    auth: 'ログインの仕方',
+    storage: '写真やファイルの置き場',
+    responsive_requirements: 'スマホとPCのどちらで使うか',
+    security_constraints: '守ること',
+    test_scenarios: '動きを確かめる筋道',
+    deployment_target: 'どこに置いて動かすか',
+    assumptions: '仮に置いたこと',
+};
+/** release 便が報告に必ず書く行の頭（★司令塔がここから URL を読む）。 */
+export const URL_LINE_PREFIX = 'URL:';
+/** testing 便が報告に必ず書く行の頭（★司令塔がここから通った数を読む）。 */
+export const ACCEPTANCE_LINE_PREFIX = 'ACCEPTANCE:';
+/** 設計書の該当部分を1つの塊に整える。 */
+function specSection(spec, stage) {
+    const lines = [];
+    for (const field of FIELDS_BY_STAGE[stage]) {
+        const items = asList(spec[field]);
+        if (items.length === 0)
+            continue;
+        lines.push(`・${FIELD_LABELS[field] ?? field}: ${items.join(' / ')}`);
+    }
+    return lines.length > 0 ? lines.join('\n') : '（設計書に該当する記載がありません。分かる範囲で進めてください）';
+}
+/** 前の便までの要点（★全文は渡さない。長いと今回やることが埋もれる）。 */
+function previousSection(previous, deliveries, max = 5) {
+    const titles = new Map(deliveries.map((d) => [d.no, d.title]));
+    const rows = [...previous].sort((a, b) => b.no - a.no).slice(0, max).reverse();
+    if (rows.length === 0)
+        return '（この試作の最初の便です）';
+    return rows
+        .map((r) => `・${r.no}便「${titles.get(r.no) ?? ''}」: ${summarize(r.report)}`)
+        .join('\n');
+}
+/** 報告から要点だけ（★先頭の数行で足りる）。 */
+function summarize(report, max = 200) {
+    const s = report.replace(/\s+/g, ' ').trim();
+    if (s === '')
+        return '報告なし';
+    return s.length > max ? `${s.slice(0, max)}…` : s;
+}
+/** 段階ごとに1行だけ足す約束（★release と testing は必ず読み取れる形で書かせる）。 */
+function stageRule(stage) {
+    if (stage === 'release') {
+        return (`★この便は【公開】です。本番へ反映したあと、報告の中に必ず1行\n` +
+            `    ${URL_LINE_PREFIX} https://…（実際に触れるアドレス）\n` +
+            `  を書いてください（この1行から、お客さまの画面の「触ってみる」が作られます）。\n` +
+            `  ★公開先（Vercel の試作プロジェクト）がまだ用意されていないときは、無理に作らず\n` +
+            `  「公開先が用意されていません」と報告し、outcome=blocked で終えてください。`);
+    }
+    if (stage === 'testing') {
+        return (`★この便は【受け入れテスト】です。設計書の完成条件を1つずつ確かめ、報告の中に必ず1行\n` +
+            `    ${ACCEPTANCE_LINE_PREFIX} 通った数/総数（例 ${ACCEPTANCE_LINE_PREFIX} 4/5）\n` +
+            `  を書いてください。通らなかった条件は、その理由を1行ずつ書いてください。`);
+    }
+    return '';
+}
+/**
+ * 便1本ぶんの指示文を組む。
+ *
+ * ★組み立ての順は「今回やること → 決まりごと → 設計書 → 前の便 → 締め方」。
+ *   職人が最初に読む数行で「何をするのか」が分かるようにする。
+ */
+export function buildCraftsmanPrompt(input) {
+    const { delivery, site, projectDir, total, protoApiBase } = input;
+    const rule = stageRule(delivery.stage);
+    return [
+        `【試作 ${delivery.no}/${total}】${delivery.title}`,
+        '',
+        // ★積み直しのときだけ足す1段（1回目は行ごと出ない）。
+        ...(input.retryOf
+            ? [`★この便は積み直しです。前回はここで止まりました: ${summarize(input.retryOf, 500)}`, '']
+            : []),
+        '■ 冒頭にやること',
+        `git status && git log --oneline -3 && git stash list && git branch --show-current`,
+        `→ 最新の main から新しいブランチを切る。cd は1回だけ（${projectDir}）。`,
+        `★作業対象は ${projectDir} のみ。ほかのフォルダを変更しない。`,
+        '',
+        '■ 今回やること',
+        delivery.title,
+        ...(rule !== '' ? [rule] : []),
+        '',
+        '■ この現場の決まり（★守る）',
+        `・データの読み書きは【試作の口だけ】を使う: ${protoApiBase.replace(/\/+$/, '')}/api/proto/records`,
+        `  （アドレスと合言葉は .env の ${PROTO_ENV_KEYS.join(' / ')} を読む。値をコードに書かない）`,
+        '・★この現場は本番のデータベースの鍵も、表を作り替える手立て（DDL）も持たない。',
+        '  表を作る・移行する・本番の鍵を触る操作は【しない】（必要になったら、その旨を報告して止まる）。',
+        '・秘密（.env の中身）を画面にも報告にも出さない。',
+        '',
+        '■ 締め方',
+        '・テストが緑になってから push → プルリクエストを作成 → `gh pr merge <番号> --admin --merge --delete-branch`。',
+        '・報告は簡潔に（変更したファイル・要点・確かめた結果）。専門用語はできるだけ避ける。',
+        '・途中で人の判断が要るところに当たったら、無理に進めず outcome=blocked で終え、理由を1行で書く。',
+        '',
+        '■ 設計書（この便に関わる部分）',
+        specSection(input.spec, delivery.stage),
+        '',
+        '■ 前の便までの要点',
+        previousSection(input.previous, input.deliveries),
+        '',
+        `（現場: ${site}）`,
+    ].join('\n');
+}

package/dist/build-roundtable.js

@@ -0,0 +1,190 @@
+/** 押さえ（円）。★確定した費用ではない（便④と同じ 30 円）。 */
+const RESERVE_JPY = 30;
+/** 会議1件で使えるトークンの上限（★累計の歯止め）。 */
+const TOKEN_LIMIT = 200_000;
+/** 周の数の上限（★この使い方では周は増えないが、中央の見回りのために届かない数を渡す）。 */
+const MAX_ROUNDS = 99;
+/** 議長（★1社だけに書かせる。並べて人に選ばせる画面を作らない）。 */
+const CHAIR = 'anthropic';
+const CHAIR_MODEL = 'anthropic-strong';
+const TIMEOUT_MS = 120_000;
+/**
+ * 合格条件（★「便の一覧として使える形か」だけを見る）。
+ *
+ * ★設計書の合格条件（19項目）とは別物。ここで見るのは並べ方の作法。
+ */
+export function buildPlanCriteria() {
+    return [
+        '便の一覧が JSON（deliveries の配列）で書かれている',
+        '1便ずつに、お客さまがそのまま読める題名（title）が付いている',
+        '題名に専門用語（ブランチ・マイグレーション・デプロイ等）が入っていない',
+        '1便が30〜60分で終わる粒になっている',
+        'それぞれの便に段階（stage）が design / data / screens / features / testing / release のどれかで付いている',
+        '最後の2便が、受け入れテスト（testing）と公開（release）になっている',
+    ];
+}
+/** 会議への頼み方（★system と user の型。ここが正本）。 */
+export function buildPlanPrompt(args) {
+    const system = [
+        'あなたは、非エンジニアのお客さま向けに試作（プロトタイプ）を作る段取りを組む担当です。',
+        '設計書を読み、AI の職人が1本ずつ受け取って進められる「便」の一覧を作ってください。',
+        '',
+        '守ること:',
+        '・出力は JSON だけ。説明文を付けない。形は {"deliveries":[{"no":1,"title":"…","stage":"design"}]}',
+        '・title は、お客さまがそのまま読む1行。専門用語（ブランチ・マイグレーション・デプロイ・CI 等）を使わない。',
+        '・stage は design / data / screens / features / testing / release のどれか。',
+        '・1便は30〜60分で終わる粒にする。',
+        '・並べる順は、そのまま作る順。前の便で出来た物の上に次を積む。',
+        '・★最後の2便は必ず、受け入れテスト（testing）→ 公開（release）にする。',
+        '・全部で20本を超えない。',
+    ].join('\n');
+    const user = [
+        '次の設計書から、便の一覧を作ってください。',
+        '',
+        '【設計書】',
+        JSON.stringify(args.spec, null, 2),
+        '',
+        '【完成条件】',
+        args.acceptanceCriteria.map((c, i) => `${i + 1}. ${c}`).join('\n') || '（記載なし）',
+    ].join('\n');
+    return { system, user };
+}
+function str(v) {
+    return typeof v === 'string' ? v.trim() : '';
+}
+/** 会議の口を1回叩く（★どんな失敗でも投げない）。 */
+async function call(cfg, path, body, deps) {
+    const f = deps.fetch ?? ((u, i) => fetch(u, i));
+    const url = `${cfg.baseUrl.replace(/\/+$/, '')}/v1/ai-roundtable/roundtables${path}`;
+    try {
+        const res = await f(url, {
+            method: 'POST',
+            headers: { 'X-App-Key': cfg.appKey, 'Content-Type': 'application/json' },
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+        let data = null;
+        try {
+            const parsed = await res.json();
+            data = parsed && typeof parsed === 'object' ? parsed : null;
+        }
+        catch {
+            data = null;
+        }
+        return {
+            ok: res.ok,
+            status: res.status,
+            data,
+            error: str(data?.error) || 'error',
+            reason: str(data?.reason) || `http_${res.status}`,
+            message: str(data?.message),
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            status: 0,
+            data: null,
+            error: 'unavailable',
+            reason: 'central_unreachable',
+            message: `会議に繋がりませんでした（${err instanceof Error ? err.message : String(err)}）`,
+        };
+    }
+}
+/**
+ * 会議に便の一覧を起草させる（★1回の呼び出しで、作る〜書かせるまで）。
+ *
+ * ★人待ち（awaiting_human）で断られたら、再開してもう一度だけ頼む（便④と同じ）。
+ */
+export async function draftPlanByRoundtable(cfg, args, deps = {}) {
+    if (cfg.baseUrl.trim() === '' || cfg.appKey.trim() === '') {
+        return { ok: false, message: '会議の設定がありません。', reason: 'not_configured' };
+    }
+    const created = await call(cfg, '', {
+        title: args.title,
+        topic: '試作の便の一覧を決める',
+        tenant_id: args.tenantId,
+        max_rounds: MAX_ROUNDS,
+        token_limit: TOKEN_LIMIT,
+    }, deps);
+    if (!created.ok) {
+        return { ok: false, message: created.message || '会議を始められませんでした。', reason: `${created.error}/${created.reason}` };
+    }
+    const roundtableId = str(created.data?.roundtable?.id);
+    if (!roundtableId) {
+        return { ok: false, message: '会議を始められませんでした。', reason: 'roundtable_id_missing' };
+    }
+    // ★合格条件は作った直後に1回だけ（2回目は中央が 409 で断る＝それは失敗ではない）。
+    const criteria = await call(cfg, `/${roundtableId}/criteria`, { criteria: buildPlanCriteria() }, deps);
+    if (!criteria.ok && criteria.reason !== 'criteria_already_confirmed') {
+        return {
+            ok: false,
+            message: criteria.message || '合格条件を決められませんでした。',
+            reason: `${criteria.error}/${criteria.reason}`,
+        };
+    }
+    const prompt = buildPlanPrompt({ spec: args.spec, acceptanceCriteria: args.acceptanceCriteria });
+    const first = await runRound(cfg, roundtableId, prompt, deps);
+    if (first.ok || !first.reason.includes('awaiting_human'))
+        return first;
+    // ★前の下書きで止まったままだった。再開して、もう一度だけ頼む。
+    const resumed = await call(cfg, `/${roundtableId}/human-actions`, { operation_id: randomId(), action: 'resume', target_kind: 'draft' }, deps);
+    if (!resumed.ok && resumed.reason !== 'operation_already_accepted') {
+        return {
+            ok: false,
+            message: resumed.message || '会議を再開できませんでした。',
+            reason: `${resumed.error}/${resumed.reason}`,
+        };
+    }
+    return runRound(cfg, roundtableId, prompt, deps);
+}
+/** 周を1つ進めて、議長が書いた文を取り出す。 */
+async function runRound(cfg, roundtableId, prompt, deps) {
+    const res = await call(cfg, `/${roundtableId}/rounds`, {
+        // ★第0周（合格条件の段）。この使い方では審査の周を1度も回さない。
+        round_no: 0,
+        step_kind: 'criteria_draft',
+        output_kind: 'draft',
+        system: prompt.system,
+        user: prompt.user,
+        reserve_jpy: RESERVE_JPY,
+        models: { [CHAIR]: CHAIR_MODEL },
+    }, deps);
+    if (!res.ok) {
+        return { ok: false, message: res.message || '書けませんでした。', reason: `${res.error}/${res.reason}` };
+    }
+    // ★鍵がまだ無い（設定待ち）。中央は 200 で印を付けて返す。
+    if (str(res.data?.reason) === 'byok_not_ready') {
+        return { ok: false, message: str(res.data?.message) || 'AI の接続がまだ済んでいません。', reason: 'byok_not_ready' };
+    }
+    const content = readDraftContent(res.data?.results);
+    if (!content)
+        return { ok: false, message: 'うまく書けませんでした。', reason: 'empty_draft' };
+    return { ok: true, content };
+}
+/**
+ * 中央が返した結果から、議長が書いた文を取り出す。
+ * ★書くのは1社なので社では選ばない（成功した最初の1つを取る）。
+ */
+export function readDraftContent(results) {
+    if (!Array.isArray(results))
+        return '';
+    for (const row of results) {
+        const o = (row ?? {});
+        if (o.ok === false)
+            continue;
+        const result = (o.result ?? {});
+        if (result.outcome !== 'succeeded')
+            continue;
+        const content = str(result.content);
+        if (content)
+            return content;
+    }
+    return '';
+}
+/** 操作の重複を防ぐ id（★中央が同じ操作を2回受けないための印）。 */
+function randomId() {
+    return typeof globalThis.crypto?.randomUUID === 'function'
+        ? globalThis.crypto.randomUUID()
+        : `op-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}