@minimalcorp/tsunagi 0.1.42 → 0.1.44

package/LICENSE

@@ -0,0 +1,126 @@
+# PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms, as well
+as the following copyright notice:
+
+> Copyright 2026 minimalcorp
+
+## Changes and New Works License
+
+The licensor grants you the copyright licenses in
+[Copyright License](#copyright-license) for changes and
+new works based on the software subject to this license.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncompete
+
+Any purpose is a permitted purpose, except for providing to others
+any product that competes with the software.
+
+If you use this software to market a product as a substitute for
+the functionality or value of the software, it competes with the
+software.  A product may use this software for testing, staging,
+or deploying the product, without necessarily competing with the
+software, even if the product provides some of the same features
+as the software.
+
+## Competition Conditions
+
+If you use the software to provide a product that competes with
+the software, that use is not allowed under the licenses granted
+by these terms.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -0,0 +1,154 @@
+# Tsunagi Monorepo
+
+**Tsunagi (繋ぎ)** — 複数 GitHub 組織のプロジェクトをローカルで統合管理し、
+Claude AI による AI 駆動開発を可視化・制御する Web UI ツール。
+
+このリポジトリは npm workspaces ベースの monorepo です。
+
+## パッケージ
+
+| パッケージ                           | 場所         | npm 公開 | 説明                                                             |
+| ------------------------------------ | ------------ | -------- | ---------------------------------------------------------------- |
+| [`@minimalcorp/tsunagi`](./apps/web) | `apps/web/`  | ✅       | Tsunagi 本体 (Next.js + Fastify + Prisma)                        |
+| [`tsunagi-docs`](./apps/docs)        | `apps/docs/` | ❌       | ユーザー向けドキュメントサイト (Nextra, GitHub Pages にデプロイ) |
+
+## クイックスタート（エンドユーザー向け）
+
+Tsunagi を使いたいだけの場合は、npm から直接起動できます:
+
+```bash
+npx @minimalcorp/tsunagi
+```
+
+詳細は [apps/web/README.md](./apps/web/README.md) または
+[ドキュメントサイト](https://minimalcorp.github.io/tsunagi/) を参照してください。
+
+## 開発セットアップ
+
+```bash
+# リポジトリをクローン
+git clone https://github.com/minimalcorp/tsunagi.git
+cd tsunagi
+
+# 依存関係インストール（全ワークスペース）
+npm install
+
+# Tsunagi 本体を開発モードで起動
+npm run dev
+
+# ドキュメントサイトを開発モードで起動
+npm run docs:dev
+```
+
+## よく使うコマンド（ルートから実行）
+
+| コマンド               | 説明                                       |
+| ---------------------- | ------------------------------------------ |
+| `npm run dev`          | web + docs を並列起動（Ctrl+C で両方停止） |
+| `npm run web:dev`      | Tsunagi 本体のみ開発モードで起動           |
+| `npm run docs:dev`     | ドキュメントサイトのみ開発モードで起動     |
+| `npm run build`        | 全ワークスペースをビルド                   |
+| `npm run lint`         | 全ワークスペースで ESLint を実行           |
+| `npm run type-check`   | 全ワークスペースで TypeScript 型チェック   |
+| `npm run format`       | Prettier で全ファイルをフォーマット        |
+| `npm run format:check` | Prettier でフォーマット差分チェック        |
+
+## リリース
+
+GitHub Actions の `Release` workflow を手動実行することで、`@minimalcorp/tsunagi`
+の npm 公開、および docs の GitHub Pages デプロイを統合的に行えます:
+
+1. GitHub の Actions タブから `Release` workflow を選択
+2. 以下を入力して Run:
+   - **target**: `all` / `tsunagi` / `docs` のいずれか
+   - **version**: `patch` / `minor` / `major` (tsunagi にのみ適用)
+
+詳細は [.github/workflows/release.yml](./.github/workflows/release.yml) を参照。
+
+### 初回実行前の必須セットアップ
+
+初めて `Release` workflow を実行する前に、以下を手動で設定しておく必要があります。
+
+1. **npm Organization 準備**
+   - npmjs.com で `@minimalcorp` organization を作成（未作成の場合）
+   - `@minimalcorp/tsunagi` パッケージ名が未取得であることを確認
+
+2. **npm Trusted Publisher を事前登録** (npm 側)
+   - 本 workflow は **npm Trusted Publishing (OIDC)** を使用するため `NPM_TOKEN` は不要
+   - npmjs.com で Trusted Publisher を追加: organization=`minimalcorp`, repository=`tsunagi`, workflow=`release.yml`, environment=`production-release`
+   - パッケージがまだ存在しない段階でも "Pending Trusted Publisher" として事前登録可能
+
+3. **GitHub Pages を Actions ソースに設定**
+   - Settings → Pages → Source: `GitHub Actions` を選択（`Deploy from a branch` ではない）
+
+4. **`production-release` Environment の作成と承認者設定**（必須）
+   - Settings → Environments → `New environment` → 名前を `production-release` として作成
+   - **Required reviewers** を有効化し、リリース承認権限を持つメンバー（自分自身でも可）を追加
+   - Release workflow の `approve` job はこの Environment 配下で実行されるため、
+     workflow 実行時に GitHub UI で明示的な承認操作が必要になる
+   - `publish-tsunagi` / `deploy-docs` 両方がこの approval を通過した後でのみ実行される
+   - 承認画面で main の最新状態（他 PR の merge 状況等）を目視確認してから承認する
+     ことで、意図しない内容のリリースを防ぐ
+
+5. **`main` ブランチ保護の bypass 設定**（保護ルールを設定している場合）
+   - `Release` workflow は `npm version` で bump した commit と tag を `main` に直接 push する
+   - main に `Require a pull request before merging` 等の保護ルールがある場合、push がブロックされる
+   - `github-actions[bot]` は user role を持たないため、Bypass list に**明示的に**以下のいずれかを設定する必要がある:
+     - 独立した **Deploy key** を発行し Bypass に追加（推奨）
+     - 管理者ユーザーの **PAT** を `PAT_TOKEN` secret として登録し、workflow の `checkout` で使用
+     - 管理者ユーザー自身を Bypass に追加（workflow を本人が起動する運用）
+   - 保護ルールを main に設定していない場合は不要
+
+これらを設定せずに workflow を実行すると、途中で失敗してバージョン番号だけが bump された中途半端な状態になる可能性があるので、**必ず事前に設定してください**。
+
+### リリース中の concurrent push について
+
+Release workflow には以下の保護機構が組み込まれています:
+
+- **同時実行の排他制御**: `concurrency: release` group により、2つ目の Release workflow は1つ目の完了を待機します
+- **Push retry with rebase**: workflow の checkout から push までの間に別の PR が main に merge された場合でも、自動で rebase してから retry します（最大3回）。rebase により merge 済みの内容を取り込んだ上で version bump commit を再適用するため、npm publish は最新の main 状態で行われます
+- **Environment 承認ゲート**: 人間が承認するタイミングで main の状態を目視確認できるため、意図しない内容のリリースを事前に察知できます
+
+## リポジトリ構成
+
+```
+tsunagi/
+├── apps/
+│   ├── web/                  # @minimalcorp/tsunagi (Tsunagi 本体)
+│   └── docs/                 # tsunagi-docs (Nextra ドキュメントサイト)
+├── .github/workflows/
+│   ├── ci.yml                # PR CI (format / lint / type-check / build)
+│   ├── release.yml           # 統合リリース (npm publish + Pages deploy)
+│   └── cla.yml               # CLA Assistant bot
+├── .husky/                   # Git hooks
+├── package.json              # monorepo root (workspaces)
+├── .prettierrc.json          # monorepo 共通 Prettier 設定
+├── LICENSE                   # PolyForm Shield 1.0.0
+├── CLA.md                    # Contributor License Agreement
+├── CONTRIBUTING.md           # コントリビューションガイド
+└── CLAUDE.md                 # Claude AI 向け作業ルール
+```
+
+## 対応 OS
+
+- macOS
+- Linux
+- Windows は**非サポート**（WSL2 経由で動作する可能性はありますが保証されません）
+
+## 必須ランタイム
+
+- **Node.js ≥ 20**
+- **Git ≥ 2.42**（空リポジトリを扱うため `git worktree add --orphan` を使用）
+- **Claude Code CLI**（`claude` コマンドが PATH 上に必要）
+
+## ライセンス
+
+本リポジトリは [PolyForm Shield License 1.0.0](./LICENSE) のもとで公開されています。
+これは source-available ライセンスであり、**競合製品化は禁止**されていますが、
+個人利用・社内利用・通常の商用利用は自由です。詳細は [LICENSE](./LICENSE) を
+参照してください。
+
+## コントリビューション
+
+Pull Request を送信する際は [CONTRIBUTING.md](./CONTRIBUTING.md) を参照し、
+CLA Assistant bot の指示に従って [CLA](./CLA.md) への同意をお願いします。

package/dist/auto-migrate.js

@@ -3,7 +3,11 @@ import { promisify } from 'node:util';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
 const execAsync = promisify(exec);
+// bundle.mjs が dist/ にコピーする。npx は npm workspace 内だと cwd を workspace
+// ルートに変えるため、cwd 依存にせず --config で明示する(相対パスは config 基準で解決される)。
+const PRISMA_CONFIG = path.join(path.dirname(fileURLToPath(import.meta.url)), 'prisma.config.ts');
 function getTsunagiDataDir() {
     return process.env.TSUNAGI_DATA_DIR || path.join(os.homedir(), '.tsunagi');
 }
@@ -13,7 +17,7 @@ function getStateDir() {
 async function autoMigrate() {
     try {
         await fs.mkdir(getStateDir(), { recursive: true });
-        const { stdout } = await execAsync('npx prisma migrate deploy');
+        const { stdout } = await execAsync(`npx prisma migrate deploy --config ${JSON.stringify(PRISMA_CONFIG)}`);
         // Extract "N migration(s) applied." line from prisma output
         const match = stdout.match(/(\d+)\s+migrations?\s+applied/i);
         if (match) {

package/dist/cli.js

@@ -4,6 +4,7 @@ import * as fs from 'node:fs';
 import * as http from 'node:http';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import openBrowser from 'open';
 import { cleanupPluginState, ensureCleanPluginState } from './plugin-lifecycle.js';
 import { acquireSingleInstanceLock } from './single-instance-lock.js';
 /**
@@ -21,8 +22,13 @@ import { acquireSingleInstanceLock } from './single-instance-lock.js';
  *   <pkg>/.next/standalone/apps/web/server.js    ← Next.js standalone entry (bundled from apps/web/.next/standalone)
  *   <pkg>/.next/standalone/apps/web/.next/static/
  *   <pkg>/.next/standalone/node_modules/
- *   <pkg>/prisma/schema.prisma
- *   <pkg>/prisma.config.ts
+ *   <pkg>/dist/prisma/schema.prisma              ← bundled from apps/server/prisma
+ *   <pkg>/dist/prisma/migrations/**
+ *   <pkg>/dist/prisma.config.ts                  ← passed via --config by dist/auto-migrate.js
+ *   <pkg>/dist/scripts/monaco-editor.sh          ← $EDITOR for Ctrl+G (resolved by dist/server/routes/terminal.js)
+ *   <pkg>/dist/docs/                             ← bundled from apps/docs/out (served on DOCS_PORT)
+ *   <pkg>/dist/whisper-server/                   ← bundled from apps/whisper-server
+ *   <pkg>/dist/llm-server/                       ← bundled from apps/llm-server
  *   <pkg>/tsunagi-marketplace/plugins/tsunagi-plugin/.claude-plugin/plugin.json
  */
 // ---------------------------------------------------------------------------
@@ -58,7 +64,7 @@ const PACKAGE_ROOT = path.resolve(DIST_DIR, '..');
 const AUTO_MIGRATE_JS = path.join(DIST_DIR, 'auto-migrate.js');
 const FASTIFY_ENTRY_JS = path.join(DIST_DIR, 'server', 'index.js');
 const NEXT_STANDALONE_ENTRY = path.join(PACKAGE_ROOT, '.next', 'standalone', 'apps', 'web', 'server.js');
-const DOCS_DIR = path.join(PACKAGE_ROOT, 'docs');
+const DOCS_DIR = path.join(DIST_DIR, 'docs');
 const DOCS_PORT = 2793;
 const isDebug = !!process.env.TSUNAGI_DEBUG;
 const isDocker = fs.existsSync('/.dockerenv');
@@ -257,8 +263,9 @@ Promise.all([pollHealth(Number(PORT)), pollHealth(Number(NEXT_PORT))]).then(() =
     console.log(TSUNAGI_AA);
     const url = `http://localhost:${PORT}`;
     if (!isDocker) {
-        const cmd = process.platform === 'darwin' ? 'open' : 'xdg-open';
-        spawn(cmd, [url], { stdio: 'ignore', detached: true }).unref();
+        // macOS / Linux / WSL（Windows 側ブラウザ）の差異は open パッケージが吸収する。
+        // ブラウザを開けなくてもサーバーは継続する（URL は下で案内する）
+        openBrowser(url).catch(() => { });
     }
     console.log(`Open ${url}`);
     if (docsServer) {

package/dist/server/lib/llm-process.js

@@ -28,15 +28,16 @@ const EXPECTED_MODEL_BYTES = 17_200_000_000;
 const STARTUP_TIMEOUT_MS = 90_000;
 // クラッシュ時にエラーメッセージへ含めるstderrの上限文字数。
 const STDERR_TAIL_MAX_CHARS = 4000;
-// このファイルは apps/server/src/lib (dev) または apps/cli/dist/server/lib
-// (npm配布物) のいずれかにいる。どちらの場合も3階層上に llm-server が
-// 兄弟ディレクトリとして存在するようレイアウトを揃えている
-// (apps/server/dist/lib → apps/server → apps → apps/llm-server,
-//  apps/cli/dist/server/lib → apps/cli/dist → apps/cli → apps/cli/llm-server)。
+// このファイルの位置から llm-server を探す:
+//   npm配布物: apps/cli/dist/server/lib → 2階層上 → apps/cli/dist/llm-server
+//   dev/build: apps/server/{src,dist}/lib → 3階層上 → apps/llm-server
 export function findLlmServerDir() {
     const here = path.dirname(fileURLToPath(import.meta.url));
-    const candidate = path.join(here, '..', '..', '..', 'llm-server');
-    return fs.existsSync(path.join(candidate, 'run.sh')) ? candidate : null;
+    const candidates = [
+        path.join(here, '..', '..', 'llm-server'),
+        path.join(here, '..', '..', '..', 'llm-server'),
+    ];
+    return candidates.find((c) => fs.existsSync(path.join(c, 'run.sh'))) ?? null;
 }
 function venvPython() {
     return path.join(VENV_DIR, 'bin', 'python3');

package/dist/server/lib/whisper-process.js

@@ -22,15 +22,16 @@ const EXPECTED_MODEL_BYTES = 1_614_000_000;
 const STARTUP_TIMEOUT_MS = 60_000;
 // クラッシュ時にエラーメッセージへ含めるstderrの上限文字数。
 const STDERR_TAIL_MAX_CHARS = 4000;
-// このファイルは apps/server/src/lib (dev) または apps/cli/dist/server/lib
-// (npm配布物) のいずれかにいる。どちらの場合も3階層上に whisper-server が
-// 兄弟ディレクトリとして存在するようレイアウトを揃えている
-// (apps/server/dist/lib → apps/server → apps → apps/whisper-server,
-//  apps/cli/dist/server/lib → apps/cli/dist → apps/cli → apps/cli/whisper-server)。
+// このファイルの位置から whisper-server を探す:
+//   npm配布物: apps/cli/dist/server/lib → 2階層上 → apps/cli/dist/whisper-server
+//   dev/build: apps/server/{src,dist}/lib → 3階層上 → apps/whisper-server
 export function findWhisperServerDir() {
     const here = path.dirname(fileURLToPath(import.meta.url));
-    const candidate = path.join(here, '..', '..', '..', 'whisper-server');
-    return fs.existsSync(path.join(candidate, 'run.sh')) ? candidate : null;
+    const candidates = [
+        path.join(here, '..', '..', 'whisper-server'),
+        path.join(here, '..', '..', '..', 'whisper-server'),
+    ];
+    return candidates.find((c) => fs.existsSync(path.join(c, 'run.sh'))) ?? null;
 }
 function venvPython() {
     return path.join(VENV_DIR, 'bin', 'python3');

package/dist/server/routes/terminal.js

@@ -1,6 +1,7 @@
 import * as fs from 'fs/promises';
 import * as os from 'os';
 import * as path from 'path';
+import { fileURLToPath } from 'url';
 import { ptyManager } from '../pty-manager.js';
 import { prisma } from '../lib/db.js';
 import { getWorktreePath } from '../lib/worktree-manager.js';
@@ -9,8 +10,11 @@ import { ensureClaudeOnboardingCompleted, removeLocalModelFromUserSettings, } fr
 import { LOCAL_LLM_UNSET_ENV_KEYS, LOCAL_MODEL_ALIAS, buildLocalLlmEnv, } from '../lib/local-llm-env.js';
 import { ensureActiveLoaded, getLocalLlmSettings } from '../lib/local-llm.js';
 import { LOCAL_LLM_PROXY_URL, buildClaudeCommand, isLocalLlmMode } from '../lib/claude-command.js';
-// サーバーはプロジェクトルートから起動されるため process.cwd() でルートを取得
-const TSUNAGI_EDITOR_PATH = path.resolve(process.cwd(), 'scripts/monaco-editor.sh');
+// このファイル基準で解決する(cwd 非依存):
+//   dev:        apps/server/src/routes      → apps/server/scripts
+//   build:      apps/server/dist/routes     → apps/server/scripts
+//   npm bundle: <pkg>/dist/server/routes    → <pkg>/dist/scripts
+const TSUNAGI_EDITOR_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../scripts/monaco-editor.sh');
 // Fastify(API) の公開ポート。index.ts と同じ既定値・同じ環境変数(TSUNAGI_SERVER_PORT)を見る。
 // monaco-editor.sh など PTY 内のプロセスが API を叩く際の同一ホスト向けベース URL に使う。
 const SERVER_PORT = Number(process.env.TSUNAGI_SERVER_PORT) || 2791;