@twin-build-orchestrate/cli 1.0.0-prerelease.1

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@twin-build-orchestrate/cli",
+  "version": "1.0.0-prerelease.1",
+  "description": "twin-build framework CLI (init / sync / doctor) + local orchestrator (dispatcher + agent worker)",
+  "license": "MIT",
+  "author": "Kei Yoshimoto",
+  "type": "module",
+  "bin": {
+    "twin-build-orchestrate": "dist/cli.js",
+    "twin-build": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "node-diff3": "^3.1.2",
+    "pino": "^10.3.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YoshimotoKei/twin-build-server.git",
+    "directory": "packages/orchestrate"
+  }
+}

package/scripts/orchestrator-status-line.mjs

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+// Claude Code statusLine 用: 稼働中の dispatcher 一覧を 1 行で出力する。
+//
+// 設計選択 (Stage 5 Theme 1 後継):
+// - cross-platform (Mac / Win / Linux 共通)。bash 不要。Node 20+ で動く。
+// - cwd 直下の `.orchestrator.pid` (legacy) と `.orchestrator-<short>.pid`
+//   (Stage 5 Theme 2 A 案) を全部 scan。
+// - 各 PID file の中身を kill(pid, 0) で alive 確認。
+// - 出力例:
+//     🟢 orchestrator: 21ffb8a1:11628
+//     🟢 orchestrator: 21ffb8a1:11628 87654321:22001  ← 複数並列
+//     ⚪ orchestrator: idle (not running)
+//     ⚠️ orchestrator: 21ffb8a1:11628 stale-pidfile (default:99999)
+//
+// 色の使い分け:
+//   🟢 = 正常稼働中
+//   ⚪ = 未起動 (エラーではない、意図的に止めている / まだ起動していない)
+//   ⚠️ = stale-pidfile (PID file は残ってるが process は死んでいる、要 cleanup)
+//
+// statusLine は Claude Code が prompt 表示前に毎回呼ぶため fast-path を維持
+// (PID file scan + kill(pid, 0) のみで I/O は数ファイル分)。
+
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+/**
+ * テスト時に TWIN_BUILD_EVENTS_DIR で上書き可能なイベントディレクトリパスを返す。
+ * 本番環境では ~/.twin-build/events/ を使用する。
+ */
+function eventsDir() {
+  return process.env.TWIN_BUILD_EVENTS_DIR ?? join(homedir(), ".twin-build", "events");
+}
+
+/** event type → 表示アイコンのマップ。未知 type は 📦 にフォールバック。 */
+const EVENT_TYPE_ICONS = {
+  pr_blocked: "⚠️",
+  agent_halt: "⚠️",
+  pr_review_required: "🔍",
+  chain_completed: "✅",
+  chain_completed_no_pr: "✅",
+  pr_merged: "✅",
+  gate_decided: "✅",
+};
+
+/**
+ * file-based completion event の未読 type 別アイコン+件数 (B 案、別 PR)。
+ * `~/.twin-build/events/` に dispatcher が emit した json file を type 別に集計。
+ *
+ * audience フィルタ (75de84bf): event payload の `audience` フィールドが `"ai"` の
+ * ものは statusLine から除外し、人間が ack すべきものだけ表示する。
+ * 後方互換: 古い event ファイル (audience フィールドなし) は "human" として扱う。
+ *
+ * 出力例: ` | 📬 ⚠️1 🔍1 ✅2`（重要度降順: ⚠️→🔍→✅→📦）
+ * 9 まで生数字、10+ は "9+" で省略。
+ */
+export function unreadEventsBadge() {
+  try {
+    const dir = eventsDir();
+    if (!existsSync(dir)) return "";
+    const files = readdirSync(dir).filter((n) => n.endsWith(".json"));
+    const counts = new Map();
+    for (const name of files) {
+      try {
+        const raw = readFileSync(join(dir, name), "utf8");
+        const evt = JSON.parse(raw);
+        // audience が "ai" でなければ表示対象 (default = human、後方互換)。
+        if (evt.audience === "ai") continue;
+        const icon = EVENT_TYPE_ICONS[evt.type] ?? "📦";
+        counts.set(icon, (counts.get(icon) ?? 0) + 1);
+      } catch {
+        // パース失敗時は安全側 = 📦 グループにカウント。
+        counts.set("📦", (counts.get("📦") ?? 0) + 1);
+      }
+    }
+    if (counts.size === 0) return "";
+    const ORDER = ["⚠️", "🔍", "✅", "📦"];
+    const parts = ORDER.flatMap((icon) => {
+      const n = counts.get(icon) ?? 0;
+      return n > 0 ? [`${icon}${n > 9 ? "9+" : n}`] : [];
+    });
+    if (parts.length === 0) return "";
+    return ` | 📬 ${parts.join(" ")}`;
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * Harness violation badge (型1/5/11 軽量 scanner の結果).
+ * Stop hook (`scripts/pattern-adoption-scan.ts`) が cwd 配下の changed .ts に対して
+ * scan した結果を `.claude/cache/pattern-adoption-summary.json` に書く。statusLine が
+ * それを読んで件数のみ表示する。block しないので Claude のコンテキストを汚染しない。
+ *
+ * **schemaVersion 2 (HarnessReport)**: bySeverity で 🔴/🟡/🟢 に分類して表示する。
+ * 旧 schema (count のみ) も後方互換で読み、count > 0 なら ⚠️ に fallback する。
+ */
+function patternAdoptionBadge() {
+  try {
+    const cacheFile = join(process.cwd(), ".claude", "cache", "pattern-adoption-summary.json");
+    if (!existsSync(cacheFile)) return "";
+    const data = JSON.parse(readFileSync(cacheFile, "utf-8"));
+    const count = Number(data.count ?? 0);
+    if (!Number.isFinite(count) || count <= 0) return "";
+    const sev = data.bySeverity;
+    if (sev && typeof sev === "object") {
+      const err = Number(sev.error ?? 0);
+      const warn = Number(sev.warning ?? 0);
+      const info = Number(sev.info ?? 0);
+      const parts = [];
+      if (err > 0) parts.push(`🔴 ${err > 9 ? "9+" : err}`);
+      if (warn > 0) parts.push(`🟡 ${warn > 9 ? "9+" : warn}`);
+      if (info > 0) parts.push(`🟢 ${info > 9 ? "9+" : info}`);
+      if (parts.length > 0) return ` | 📬 harness: ${parts.join(" ")}`;
+    }
+    // schemaVersion 1 fallback (count only)
+    const display = count > 9 ? "9+" : String(count);
+    return ` | ⚠️ pattern: ${display}`;
+  } catch {
+    return "";
+  }
+}
+
+function main() {
+  let entries;
+  try {
+    entries = readdirSync(process.cwd());
+  } catch {
+    // cwd が読めない (異常) — 出力ナシで終わる (statusLine は空文字を許容)
+    return "";
+  }
+
+  const pidFiles = entries.filter(
+    (n) => n === ".orchestrator.pid" || /^\.orchestrator-[0-9a-f]+\.pid$/.test(n),
+  );
+
+  if (pidFiles.length === 0) {
+    return "⚪ orchestrator: idle";
+  }
+
+  const alive = [];
+  const stale = [];
+  for (const file of pidFiles.sort()) {
+    const suffix = file === ".orchestrator.pid"
+      ? "default"
+      : file.replace(/^\.orchestrator-([0-9a-f]+)\.pid$/, "$1");
+    let pid;
+    try {
+      pid = parseInt(readFileSync(file, "utf-8").trim(), 10);
+    } catch {
+      stale.push(`${suffix}:?`);
+      continue;
+    }
+    if (!Number.isFinite(pid) || pid <= 0) {
+      stale.push(`${suffix}:?`);
+      continue;
+    }
+    try {
+      process.kill(pid, 0);
+      alive.push(`${suffix}:${pid}`);
+    } catch {
+      stale.push(`${suffix}:${pid}`);
+    }
+  }
+
+  if (alive.length === 0 && stale.length > 0) {
+    return `⚠️ orchestrator: stale-pidfile (${stale.join(" ")})`;
+  }
+  let line = `🟢 orchestrator: ${alive.join(" ")}`;
+  if (stale.length > 0) {
+    line += ` ⚠️ stale (${stale.join(" ")})`;
+  }
+  return line;
+}
+
+const out = main();
+const badge = unreadEventsBadge();
+const patternBadge = patternAdoptionBadge();
+if (out || badge || patternBadge) console.log(`${out}${badge}${patternBadge}`);

package/templates/CLAUDE.md

@@ -0,0 +1,43 @@
+# CLAUDE.md
+
+> Project instructions for Claude Code. Edited locally, kept in sync with
+> upstream `@twin-build-orchestrate/cli` via `npx twin-build sync`.
+
+## Project Summary
+
+<!-- Describe what this project does in 1-3 sentences. -->
+
+## Repository Layout
+
+<!-- Outline top-level directories and what lives where. -->
+
+## Tech Stack
+
+<!-- Languages, frameworks, infra worth flagging up front. -->
+
+## Phase Workflow
+
+This project follows the twin-build translation-chain process:
+
+- Phase 0–4: Non-technical requirements and design.
+- Phase 5–8: Technical design, implementation, verification, release.
+
+Use `/phase{0..8}` skills from inside Claude Code to advance phases.
+
+## Absolute Rules
+
+1. Do not skip phases.
+2. Each phase consumes only the prior phase's artefacts.
+3. Decisions are made by humans; AI surfaces options.
+4. Structural / design decisions must include reasoning.
+5. Do not impose "best practices" over user intent.
+
+## Local Conventions
+
+<!-- Project-specific testing, branching, naming rules. -->
+
+---
+
+_This template ships with @twin-build-orchestrate/cli. Run
+`npx twin-build sync` to pull upstream updates; conflicts are resolved
+via 3-way merge._