refactor: align package folder names with npm package names

Rename packages/ subdirectories to match their @united-workforce/* scope: cli-workflow → cli workflow-agent-builtin → agent-builtin workflow-agent-claude-code → agent-claude-code workflow-agent-hermes → agent-hermes workflow-dashboard → dashboard workflow-protocol → protocol workflow-util-agent → util-agent workflow-util → util Updated all tsconfig references, scripts, and active docs. Historical docs (docs/plans/, docs/superpowers/) left as-is. Closes #21
2026-06-02 23:45:45 +08:00
parent e4e4288d00
commit 5970456a54
266 changed files with 207 additions and 207 deletions
@@ -43,7 +43,7 @@ Export from `packages/workflow/src/index.ts`.
 **Objective:** CLI `cas get/put/list/rm` no longer needs threadId for storage location — CAS is global. But keep threadId in CLI for backward compat of planner/coder prompts (they pass threadId).

 **Files:**
- Modify: `packages/cli-workflow/src/cmd-cas.ts`
+- Modify: `packages/cli/src/cmd-cas.ts`

 **Changes:**
 - `resolveCasDir` → use `getGlobalCasDir(storageRoot)` instead of deriving from thread data path
@@ -73,7 +73,7 @@ export async function cmdCasGet(
 **Objective:** Since CAS is global, `thread rm` should NOT delete CAS entries. CAS cleanup is GC's job.

 **Files:**
- Modify: `packages/cli-workflow/src/cmd-thread.ts`
+- Modify: `packages/cli/src/cmd-thread.ts`
 - Check: remove any `rmdir` / `unlink` of `<threadId>.cas/` directory

 ### Task 1.4: Rename `createThreadCas` → `createCasStore`
@@ -90,7 +90,7 @@ export async function cmdCasGet(
 **Objective:** All CAS-related tests use global dir instead of thread-local.

 **Files:**
- Modify: `packages/cli-workflow/__tests__/commands.test.ts`
+- Modify: `packages/cli/__tests__/commands.test.ts`
 - Verify: `bun test` passes

 ### Task 1.6: Clean up old thread-local `.cas/` references
@@ -208,18 +208,18 @@ export async function garbageCollectCas(storageRoot: string): Promise<GcResult>
 ### Task 3.2: Add `uncaged-workflow gc` CLI command

 **Files:**
- Create: `packages/cli-workflow/src/cmd-gc.ts`
- Modify: `packages/cli-workflow/src/cli-dispatch.ts` — add `gc` subcommand
+- Create: `packages/cli/src/cmd-gc.ts`
+- Modify: `packages/cli/src/cli-dispatch.ts` — add `gc` subcommand

 ### Task 3.3: Run GC on `thread rm`

 **Files:**
- Modify: `packages/cli-workflow/src/cmd-thread.ts` — after deleting thread data, optionally run GC
+- Modify: `packages/cli/src/cmd-thread.ts` — after deleting thread data, optionally run GC

 ### Task 3.4: Tests for GC

 **Files:**
- Create: `packages/cli-workflow/__tests__/gc-cli.test.ts`
+- Create: `packages/cli/__tests__/gc-cli.test.ts`

 ---

@@ -253,10 +253,10 @@ Breaking change. Old `.data.jsonl` files become incompatible. No backward compat

 | Package | Changes |
 |---------|---------|
-| `workflow-protocol` | Replace `StartStep`, `RoleStep` types with `StartNode`, `StateNode`. Add `ContentMerkleNode` type. Expand `ExtractResult` to include `refs[]`. |
+| `protocol` | Replace `StartStep`, `RoleStep` types with `StartNode`, `StateNode`. Add `ContentMerkleNode` type. Expand `ExtractResult` to include `refs[]`. |
 | `workflow-cas` | Add `findReachableHashes(roots)` for GC mark phase |
 | `workflow-execute` | Rewrite engine to write CAS nodes + update `threads.json` instead of appending JSONL. Move completed threads to `history/`. Simplify `gc.ts`. Simplify `fork-thread.ts`. Expand extract phase to produce refs. |
 | `workflow-runtime` | `ThreadContext` built by walking chain from head. `start.prompt` resolved from CAS via StartNode.refs[0]. |
-| `cli-workflow` | `thread list/show/rm` read from `threads.json` + `history/`. SSE watches `threads.json`. |
-| `workflow-dashboard` | Watch `threads.json` instead of `.data.jsonl` |
+| `cli` | `thread list/show/rm` read from `threads.json` + `history/`. SSE watches `threads.json`. |
+| `dashboard` | Watch `threads.json` instead of `.data.jsonl` |
 | Templates & Agents | Update extract definitions to produce `refs[]`. Update `ctx.start.content` → CAS resolved. |
@@ -145,7 +145,7 @@ STATE_D1（父 developer state）

 ### Phase 1: Protocol + CAS 层

-1. `workflow-protocol/src/cas-types.ts` — `StartNodePayload` 加 `parentState: string | null`，`StateNodePayload` 加 `childThread: string | null`
+1. `protocol/src/cas-types.ts` — `StartNodePayload` 加 `parentState: string | null`，`StateNodePayload` 加 `childThread: string | null`
 2. `workflow-cas/src/nodes.ts` — `putStartNode` 接受可选 `parentStateHash`，放入 refs；`putStateNode` 接受可选 `childThreadHash`，放入 refs
 3. `workflow-cas/src/nodes.ts` — 解析逻辑兼容新字段（缺失时视为 null）

@@ -154,7 +154,7 @@ function getNodeStates(records: ThreadRecord[]): Map<string, "completed" | "acti
 ## 组件结构

 ```
-workflow-dashboard/src/
+dashboard/src/
  components/
    workflow-graph/
      types.ts           — NodeState 等前端类型
@@ -9,7 +9,7 @@

 | Package | 机制 | 能力 |
 |---------|------|------|
-| `workflow-agent-hermes` | spawn `hermes chat` | 完整工具链（文件、终端、浏览器…） |
+| `agent-hermes` | spawn `hermes chat` | 完整工具链（文件、终端、浏览器…） |
 | `workflow-agent-cursor` | spawn `cursor-agent` | IDE 级别代码编辑 |
 | `workflow-agent-llm` | 单轮 chat completion | 纯文本，无工具 |

@@ -77,7 +77,7 @@ AdapterFn 的终止条件是"拿到符合 schema 的 T"——和 `workflow-react

 ```typescript
 import { createLlmFn, createThreadReactor } from "@uncaged/workflow-reactor";
-import type { ThreadContext, LlmProvider } from "@uncaged/workflow-protocol";
+import type { ThreadContext, LlmProvider } from "@uncaged/protocol";
 import type { ToolDefinition } from "@uncaged/workflow-reactor";

 type ReactToolHandler = (name: string, args: string) => Promise<string>;
@@ -147,7 +147,7 @@ packages/workflow-agent-react/
 ```

 依赖：
- `@uncaged/workflow-protocol` — `ThreadContext`, `LlmProvider`
+- `@uncaged/protocol` — `ThreadContext`, `LlmProvider`
 - `@uncaged/workflow-reactor` — `createLlmFn`, `createThreadReactor`, types

 ## 影响范围
@@ -162,16 +162,16 @@ packages/workflow-agent-react/

 ### 需修改的包

-1. `workflow-protocol` — 删除 `AgentContext`/`AgentFn`/`AgentFnResult`/`AgentBinding`，新增 `AdapterFn`/`RoleFn`/`AdapterBinding`
+1. `protocol` — 删除 `AgentContext`/`AgentFn`/`AgentFnResult`/`AgentBinding`，新增 `AdapterFn`/`RoleFn`/`AdapterBinding`
 2. `workflow-runtime` — 更新 re-export
 3. `workflow-execute` — engine 调用 `adapter(prompt, schema)` 替代 `agent(ctx) + extract`
-4. `workflow-util-agent` — `buildAgentPrompt` → `buildThreadInput`，接收 `ThreadContext`
+4. `util-agent` — `buildAgentPrompt` → `buildThreadInput`，接收 `ThreadContext`
 5. 所有 bundle-entry — `agent:` → `adapter:`

 ### 不受影响

- `workflow-cas` / `workflow-register` / `workflow-reactor` / `workflow-dashboard`
- `workflow-agent-hermes` / `workflow-agent-cursor`（内部不改，外部用 `agentToAdapter` 包装）
+- `workflow-cas` / `workflow-register` / `workflow-reactor` / `dashboard`
+- `agent-hermes` / `workflow-agent-cursor`（内部不改，外部用 `agentToAdapter` 包装）

 ## Phases