@minimalcorp/tsunagi 0.1.41 → 0.1.43

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

@@ -21,8 +21,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 +63,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');

package/dist/server/lib/claude-command.d.ts

@@ -2,5 +2,7 @@ import type { TabMode } from '@minimalcorp/tsunagi-shared';
 /** ローカルLLMタブの Claude Code の接続先（tsunagi の中継口） */
 export declare const LOCAL_LLM_PROXY_URL: string;
 export declare function isLocalLlmMode(mode: TabMode | undefined): boolean;
+/** 起動スクリプトの type 引数。original: Anthropic、ollama / lm-studio: ローカルLLM */
+export type LaunchType = 'original' | 'ollama' | 'lm-studio';
 /** タブの mode に応じた claude の起動コマンド（既存セッションがあれば resume） */
 export declare function buildClaudeCommand(sessionId: string, mode: TabMode): Promise<string>;

package/dist/server/lib/claude-command.js

@@ -19,6 +19,10 @@ export function isLocalLlmMode(mode) {
 function shellQuote(value) {
     return `'${value.replace(/'/g, `'\\''`)}'`;
 }
+const LAUNCH_TYPE_PROVIDER = {
+    ollama: 'ollama',
+    'lm-studio': 'lmstudio',
+};
 /**
  * ローカルLLMタブの claude に付ける引数。
  * - モデルは Settings でだけ切り替える: /model の一覧を中継口の名前1件にし、PreModelSwitch フックで
@@ -28,10 +32,9 @@ function shellQuote(value) {
  *   毎回プロンプトに載る（prefill が遅くなり tool 選択の精度も落ちる）。そのため MCP を tsunagi の
  *   タスク管理と web_search だけに絞る
  */
-async function localLlmArgs() {
-    const { active, webSearch } = await getLocalLlmSettings();
+function localLlmArgs(provider, webSearch) {
     // ollama.com による WebSearch の代行は、使用中のモデルが Ollama のときだけ使える
-    const localWebSearch = webSearch === 'local' || active?.provider !== 'ollama';
+    const localWebSearch = webSearch === 'local' || provider !== 'ollama';
     const settings = {
         modelPicker: {
             options: [
@@ -80,27 +83,56 @@ async function localLlmArgs() {
     return args;
 }
 /**
- * ローカルLLMタブの claude を起動するスクリプトを書き出し、そのパスを返す。
+ * タスク進捗（プログレスバー）の元になる Task 系ツール。
+ * Claude Code は旧モデル以外ではこれらを既定で無効にしており、--allowedTools で明示すると有効になる
+ */
+const TASK_TOOLS = 'TaskCreate,TaskGet,TaskUpdate,TaskList';
+/**
+ * claude の起動スクリプトを書き出し、そのパスを返す。`sh <script> <type> <session-id>` で起動し、
+ * 既存セッションがあれば resume、なければ新規作成する。
  * 起動コマンドは PTY に1行で書き込むため、macOS の端末入力の1行上限（MAX_CANON = 1024 バイト）を
  * 超えると後ろが切り捨てられる。引数の JSON をコマンドに直接載せると上限を超え、
  * `|| claude ... --session-id` 側が途中で切れてタブと別のセッションIDで起動してしまう
- * （hooks がタブに紐づかず、--settings / --mcp-config も効かない）。そのため引数はスクリプトに閉じ込める
+ * （hooks がタブに紐づかず、--settings / --mcp-config も効かない）。そのため引数はスクリプトに閉じ込める。
+ * ローカルLLMの引数は Settings に依存するため起動のたびに書き直す
  */
-async function writeLocalLlmLauncher(args) {
-    const dir = path.join(getStateDir(), 'local-llm');
-    await mkdir(dir, { recursive: true });
-    const file = path.join(dir, 'claude.sh');
+async function writeLauncher() {
+    const { webSearch } = await getLocalLlmSettings();
+    const branches = Object.keys(LAUNCH_TYPE_PROVIDER)
+        .map((type) => `  ${type}) set -- ${localLlmArgs(LAUNCH_TYPE_PROVIDER[type], webSearch).join(' ')} ;;`)
+        .join('\n');
+    const script = `#!/bin/sh
+# usage: launch-claude.sh <original|ollama|lm-studio> <session-id>
+type=$1
+session_id=$2
+case "$type" in
+  original) set -- ;;
+${branches}
+  *) echo "launch-claude.sh: unknown type: $type" >&2; exit 2 ;;
+esac
+claude --dangerously-skip-permissions --allowedTools ${TASK_TOOLS} "$@" --resume "$session_id" 2>/dev/null ||
+  exec claude --dangerously-skip-permissions --allowedTools ${TASK_TOOLS} "$@" --session-id "$session_id"
+`;
+    const file = path.join(getStateDir(), 'launch-claude.sh');
+    await mkdir(path.dirname(file), { recursive: true });
     // 複数タブの同時起動で書きかけのファイルを読まないよう、書き終えてから置き換える
     const tmp = `${file}.${randomUUID()}.tmp`;
-    await writeFile(tmp, `#!/bin/sh\nexec claude ${args.join(' ')} "$@"\n`);
+    await writeFile(tmp, script);
     await rename(tmp, file);
     return file;
 }
+/** タブの mode から起動スクリプトの type を決める。ローカルLLMは Settings で選んだ使用中のモデルに従う */
+async function resolveLaunchType(mode) {
+    if (!isLocalLlmMode(mode))
+        return 'original';
+    const { active } = await getLocalLlmSettings();
+    if (!active) {
+        throw new Error('ローカルLLMのモデルが未設定です。Settings で使用するモデルを選んでください');
+    }
+    return active.provider === 'ollama' ? 'ollama' : 'lm-studio';
+}
 /** タブの mode に応じた claude の起動コマンド（既存セッションがあれば resume） */
 export async function buildClaudeCommand(sessionId, mode) {
-    const args = ['--dangerously-skip-permissions'];
-    const claude = isLocalLlmMode(mode)
-        ? `sh ${shellQuote(await writeLocalLlmLauncher([...args, ...(await localLlmArgs())]))}`
-        : `claude ${args.join(' ')}`;
-    return `${claude} --resume ${sessionId} 2>/dev/null || ${claude} --session-id ${sessionId}`;
+    const type = await resolveLaunchType(mode);
+    return `sh ${shellQuote(await writeLauncher())} ${type} ${sessionId}`;
 }

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/searxng.d.ts

@@ -9,6 +9,8 @@ export declare function parseSearxngSettings(body: unknown): {
 };
 /** searxng-run を探す（設定値 → PATH）。見つからなければ null */
 export declare function findSearxngBin(settings: SearxngSettings): string | null;
+/** docker コマンドを探す（PATH → Docker Desktop / Homebrew の既定の場所）。見つからなければ null */
+export declare function findDockerBin(): string | null;
 /** Ollama / LM Studio の有効状態に合わせて起動・停止する。失敗しても例外は投げない */
 export declare function syncSearxng(): Promise<void>;
 /** 手動での再起動（設定変更後やエラーからの復帰） */