bantou 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,61 @@
-# Temporary Holding Version
+# bantou-server
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**雛形のみ（業務ロジック未実装）。** 起動・設定読込・workspace 準備・終了処理だけを持つ常駐プロセス。
+
+## 役割
+
+- linux / mac で動く npm package（`bantou`）。`npx` で起動する。
+- bantou-desktop（`../desktop/`、mac / windows のネイティブアプリ）からの指示を受ける。
+- 担当は 2 つ。remote session の起動（`src/session.ts`）と、remote cap（オーケストレーター）の起動（`src/cap.ts`）。
+- desktop が指示を出す側。server は受ける側で、自律的に方針を決めない。
+
+## 起動方法
+
+```
+npx bantou --config <path>
+```
+
+- `--config` 省略時は `~/.config/bantou-server/config.json`。
+- それ以外の引数は exit 2。実行時エラーは exit 1。
+- SIGTERM / SIGINT で後始末して exit 0。
+
+開発時は `server/` で実行する。
+
+```
+npm install
+npm run typecheck
+npm run build
+npm test
+npm run dev -- --config <path>
+```
+
+dev / test は `node --import tsx` を使う。Node >=22 のみで動き、bun を要しない。
+
+## config.json
+
+```json
+{ "workspace": "/path/to/workspace" }
+```
+
+- `workspace`（必須）: workspace フォルダの絶対パス。
+
+## workspace レイアウト
+
+```
+<workspace>/
+  repos/    repo の展開先
+```
+
+起動時に `<workspace>/` と `<workspace>/repos/` が無ければ作る。
+
+## 未決定事項
+
+- desktop と server の通信方式
+- remote session と remote cap の起動手順の詳細
+- 配置先ホスト
+
+## 関連資料
+
+- [`../docs/protocol.md`](../docs/protocol.md)
+- [`../docs/guardrail.md`](../docs/guardrail.md)
+- [`../desktop/README.md`](../desktop/README.md)

package/dist/cap.js

@@ -0,0 +1,7 @@
+/**
+ * remote cap（オーケストレーター）の起動を担う予定のモジュール。
+ * 業務ロジックは未実装。
+ */
+export async function startCap(_spec) {
+    throw new Error("未実装");
+}

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { runDaemon } from "./daemon.js";
+const DEFAULT_CONFIG = join(homedir(), ".config", "bantou-server", "config.json");
+/** 引数を解釈する。不正な引数は null を返す。 */
+function parseArgs(argv) {
+    let config = DEFAULT_CONFIG;
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === "--config" && i + 1 < argv.length) {
+            config = argv[++i];
+        }
+        else {
+            return null;
+        }
+    }
+    return { config };
+}
+const args = parseArgs(process.argv.slice(2));
+if (!args) {
+    console.error("usage: bantou-server [--config <path>]");
+    process.exit(2);
+}
+runDaemon(args.config).catch((e) => {
+    console.error(`bantou-server: ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+});

package/dist/config.js

@@ -0,0 +1,23 @@
+import { readFile } from "node:fs/promises";
+/** config.json を読み込んで検証する。 */
+export async function loadConfig(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (e) {
+        throw new Error(`config を読めない: ${path} (${e.message})`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`config が JSON として不正: ${path} (${e.message})`);
+    }
+    const ws = data?.workspace;
+    if (typeof ws !== "string" || ws.length === 0) {
+        throw new Error(`config の workspace は必須の文字列: ${path}`);
+    }
+    return { workspace: ws };
+}

package/dist/daemon.js

@@ -0,0 +1,23 @@
+import { loadConfig } from "./config.js";
+import { prepareWorkspace } from "./workspace.js";
+const log = (msg) => {
+    console.log(`${new Date().toISOString()} bantou-server: ${msg}`);
+};
+/** 起動して常駐する。SIGTERM / SIGINT で後始末して exit 0。 */
+export async function runDaemon(configPath) {
+    log("起動");
+    const config = await loadConfig(configPath);
+    log(`設定読込: ${configPath} (workspace=${config.workspace})`);
+    const repos = await prepareWorkspace(config.workspace);
+    log(`workspace 準備完了: ${repos}`);
+    const keepAlive = setInterval(() => { }, 1 << 30);
+    const shutdown = (signal) => {
+        log(`${signal} 受信、終了処理`);
+        clearInterval(keepAlive);
+        log("終了");
+        process.exit(0);
+    };
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    log("常駐開始");
+}

package/dist/session.js

@@ -0,0 +1,7 @@
+/**
+ * remote session の起動を担う予定のモジュール。
+ * 業務ロジックは未実装。
+ */
+export async function startSession(_spec) {
+    throw new Error("未実装");
+}

package/dist/workspace.js

@@ -0,0 +1,8 @@
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+/** `<workspace>/` と `<workspace>/repos/` を無ければ作る。repos のパスを返す。 */
+export async function prepareWorkspace(workspace) {
+    const repos = join(workspace, "repos");
+    await mkdir(repos, { recursive: true });
+    return repos;
+}

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "bantou",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Remote session and remote cap launcher server for bantou-desktop",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unagents/bantou.git",
+    "directory": "server"
+  },
+  "type": "module",
+  "bin": {
+    "bantou": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "node --import tsx src/cli.ts",
+    "test": "node --import tsx --test test/*.test.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}