@ccmsg/cli 0.9.1 → 0.11.0

package/src/daemon/supervise.ts

@@ -8,8 +8,8 @@ import {
   type Child,
   configHome,
   harnessFor,
+  reload,
   prepareFor,
-  registered,
   rowFor,
   type SpawnInstance,
   spawnInstance,
@@ -118,7 +118,30 @@ export class Supervisor {
     this.#startTimeoutMs = options.startTimeoutMs ?? START_TIMEOUT_MS;
     this.#stopTimeoutMs = options.stopTimeoutMs ?? STOP_TIMEOUT_MS;
     this.#log = options.log ?? ((line) => process.stderr.write(`${JSON.stringify(line)}\n`));
-    for (const target of registered(this.#env)) this.#units.set(target.dir, new Supervised(target));
+  }
+
+  /** Read the edited files, check them, write down what held, and look after
+   * what it names (§8.2).
+   *
+   * This is the one thing that writes the applied settings: the children read
+   * them and write nothing, so nothing races over the file and there is one
+   * answer to "what is running". A config that does not check out leaves the
+   * applied one standing and is written to this supervisor's log — the
+   * children of a host are not something a typo in one file should take down.
+   *
+   * In `run` rather than in the constructor because the files are TypeScript
+   * and reading one is an import: a caller holding a supervisor that has not
+   * run yet is holding one that has not read the files yet, which is the same
+   * moment it was already true that nothing had been started. */
+  async #adopt(): Promise<void> {
+    const settled = await reload(this.#env);
+    for (const problem of settled.problems) {
+      this.#log({ event: "config refused", file: problem.file, problem: problem.msg });
+    }
+    for (const one of settled.satisfied.instances) {
+      const target = targetFor(this.#env, one.dir, one.name, one.id);
+      this.#units.set(target.dir, new Supervised(target));
+    }
   }
 
   /** The config homes this supervisor is looking after right now. */
@@ -138,6 +161,7 @@ export class Supervisor {
   }
 
   async #serve(): Promise<void> {
+    await this.#adopt();
     await this.#listen();
     for (const unit of this.#units.values()) this.#keep(unit);
     // What ends the run is being asked to, not the children ending: a
@@ -307,7 +331,7 @@ export class Supervisor {
    * behind it is the state `add` exists to leave behind only when there is no
    * supervisor to tell. */
   async addOne(dir: string): Promise<StatusRow> {
-    const home = configHome(dir, harnessFor(this.#env, dir));
+    const home = configHome(dir, await harnessFor(this.#env, dir));
     if (this.#units.has(home)) {
       throw new CommandError("file_exists", `${home} は既に見ています`);
     }

package/src/instance/ccmsg-config.d.ts

@@ -0,0 +1,112 @@
+/** 設定ファイル (`config_v2.ts` / `instances/instance-<id>.ts`) が書ける値の型。
+ *
+ * ccmsg がこのファイルを config home に `ccmsg-config_v2.d.ts` として写すので、
+ * 設定ファイルからは `import type { Instance } from "../ccmsg-config_v2"` の形で
+ * 参照できる。型だけを持ち、他の何も import しないので、tsconfig の無い場所でも解決する。 */
+
+/** ある config home が動かすもの。 */
+export type Harness = "claude" | "codex";
+
+/** mesh の 1 行。endpoint は公開 base URL で、末尾の `/` まで含める。 */
+export interface Endpoint {
+  id: string;
+  endpoint: string;
+}
+
+/** どこで待ち受け、誰からを受けるか。 */
+export interface Entry {
+  host: string;
+  /** 0 はカーネルに空きポートを選ばせる。 */
+  port: number;
+  source_ips: string[];
+  /** `X-Forwarded-For` を信じる送り元 (CIDR)。 */
+  trusted_proxies: string[];
+}
+
+/** 起動レシピが読む値 1 つ。 */
+export interface LauncherParam {
+  name: string;
+  default: string;
+}
+
+export interface LauncherTemplate {
+  name: string;
+  command: string;
+  params?: LauncherParam[];
+  shell?: "bash" | "zsh";
+}
+
+export interface Launcher {
+  root_dirs: string[];
+  /** 並び順のまま答える。先頭が既定のレシピ。 */
+  templates: LauncherTemplate[];
+  depth?: number;
+  timeout_secs?: number;
+  clean_env?: string[];
+  keep_env?: string[];
+}
+
+export interface Upstream {
+  gateway_url?: string;
+  gateway_webhook_source?: string;
+  gateway_webhook_token_file?: string;
+  /** 末尾に `/` を付けない base URL。 */
+  terminal_gateway?: string;
+  launcher?: Launcher;
+  /** batch を訳すプログラム。絶対パス。 */
+  translate_helper?: string;
+  sandbox_origin?: string;
+}
+
+/** 名前の付いた dump の選択。`types` は型名・その prefix・`-` 付きの除外・
+ * 他の preset を差し込む `@name`。 */
+export interface DumpPreset {
+  name: string;
+  description?: string;
+  opts: { types: string[] };
+}
+
+export interface Dump {
+  presets: DumpPreset[];
+}
+
+/** 1 instance 分の設定。`config_v2.ts` が返すのも、`instances/instance-<id>.ts` が
+ * `dir` を足して返すのも、これ。 */
+export interface Config {
+  harness: Harness;
+  /** mesh の全 instance (自分も含む)。`endpoints.json` が正で、読むのは自由だが
+   * 違う物を返したら config error。自分がどれかは自分の id の行。 */
+  endpoints: Endpoint[];
+  /** 無ければ unix socket だけで serve する。 */
+  entry?: Entry;
+  upstream: Upstream;
+  direct_delivery: boolean;
+  fork_origin: boolean;
+  dump: Dump;
+}
+
+/** instance の設定。`dir` (= config home の絶対パス) が instance を決める。 */
+export interface InstanceConfig extends Config {
+  dir: string;
+  /** 人向けのラベル。書かなければ id。ファイル名は id なので、変えても何も動かない。 */
+  name?: string;
+}
+
+/** `config_v2.ts` が default export する関数。
+ *
+ * `builtin` は組み込みの既定値で、凍らせてあるので書き換えられない。
+ * `config` はそのコピーなので、好きに書き換えて返す。 */
+export type Defaults = (ctx: {
+  readonly builtin: Readonly<Config>;
+  config: Config;
+}) => Config | Promise<Config>;
+
+/** `instances/instance-<id>.ts` が default export する関数。
+ *
+ * `default` は `config_v2.ts` が返した値 (凍結済み)、`config` はそのコピーに
+ * `dir` の場所を空で足した物。 */
+export type Instance = (ctx: {
+  readonly builtin: Readonly<Config>;
+  readonly default: Readonly<Config>;
+  config: InstanceConfig;
+}) => InstanceConfig | Promise<InstanceConfig>;