DeepSeek Harness: 依存関係駆動ロードとホットリロード

function buildDependencyGraph(plugins: Plugin[]) {
  const graph = new DAG()
  for (const plugin of plugins) {
    graph.addNode(plugin.name)
    for (const dep of plugin.inject) {
      graph.addEdge(dep, plugin.name)
    }
  }
  return graph
}

プラグイン宣言：
  core：    inject = []
  tools：   inject = ['core']
  llm：     inject = ['core']
  my-tool： inject = ['tools', 'llm']

依存グラフ：
  core → tools → my-tool
  core → llm   → my-tool

トポロジカルソート結果：[core, tools, llm, my-tool]

// プラグイン A：inject = ['tools'] — tools はまだ未登録
// → Fiber 状態：pending

// その後、tools プラグインがロードされサービスを登録
// → プラグイン A の Fiber は自動的に active に遷移し、apply を呼び出し

export function apply(ctx: Context) {
  if (someCondition) {
    ctx.provide('optional-service', impl)
    // optional-service に依存する保留中のプラグインが自動的にアクティブに
  }
}

[warn] plugin my-plugin has unsatisfied dependency：nonexistent-service
[warn] my-plugin will remain in pending state

pnpm dsh web --patch --watch

tools プラグイン HMR リロード → my-tool（tools に依存）もリロード

core リロード → tools リロード → my-tool リロード → ...（依存チェーン全体がリロード）

export function apply(ctx: Context) {
  const childCtx = ctx.extend({
    // サービスの上書きまたは追加
  })
  
  childCtx.plugin({
    name: 'child-plugin',
    apply(innerCtx) {
      // innerCtx は ctx のサービスを継承
    }
  })
}

親 ctx：{ tools, llm, sessions }
子 ctx：{ tools(上書き), cache(追加) }

子 ctx から見える：{ tools(上書き版), llm, sessions, cache }

// ❌ 深すぎる
ctx.extend().extend().extend().extend()

// ✅ 適度なネスト
const sessionCtx = ctx.extend({ session })

export function apply(ctx: Context) {
  ctx.on('config/updated', (newConfig) => {
    if (newConfig.debug !== ctx.config.debug) {
      ctx.logger.level = newConfig.debug ? 'debug' : 'info'
    }
  })
}

plugins:
  my-plugin：
    config：
      debug：true  # ユーザーが Web UI で変更、自動永続化

// ✅ 冪等：各 apply は同じツールを登録
export function apply(ctx: Context) {
  ctx.tools.register(fileCountTool)
}

// ❌ 非冪等：apply が副作用を蓄積
let counter = 0
export function apply(ctx: Context) {
  counter++  // リロード後にカウンターが増加
}

// ❌ グローバル状態：HMR リロード後も旧状態が残存
const globalCache = new Map()

// ✅ クロージャ状態：各 apply が新しい状態を作成
export function apply(ctx: Context) {
  const cache = new Map()
  ctx.effect(() => () => cache.clear())
}

export function apply(ctx: Context) {
  const ws = new WebSocket('ws://localhost:8080')
  
  // ✅ クリーンアップを登録
  ctx.effect(() => () => ws.close())
  
  // ❌ クリーンアップ忘れ → リロード後に旧接続がリーク
}

# 1. HMR 付き開発モードで起動
pnpm dsh web --patch --watch

# 2. コードを普通に書く、保存で自動リロード
# ターミナル出力：
# [hmr] file changed：src/index.ts
# [hmr] disposing my-plugin (old)
# [hmr] loading my-plugin (new)
# [my-plugin] plugin reloaded

# 3. リロードログを確認、クリーンアップエラーがないことを確認

// apply の冒頭にデバッグログを追加
export function apply(ctx: Context) {
  ctx.logger.info('apply called at', new Date().toISOString())
  // ...
}
// apply が予期せず複数回呼び出される場合、HMR カスケードリロードが発生している