campfire-cli 0.1.8__tar.gz → 0.1.9__tar.gz

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/ARCHITECTURE.md

@@ -97,7 +97,7 @@ Campfire 不是“Markdown 版 kubectl”，而是面向人机协作场景组合
 | --- | --- | --- |
 | 语义原子性 | 一条命令只表达一个可以用一句话说清的用户意图 | `document move` 表达“在已声明 Domain 之间正确移动一篇文档” |
 | 一致性原子性 | 为保持该意图不变量而必须一起变更的事实，属于同一个变更集；整体成功或恢复到执行前 | 移动文档时同步修复可确定解析的引用 |
-| 可组合原子性 | 不相关的派生治理不隐式执行；命令用结构化 `follow_up` 声明必要步骤，由 Skill 决定组合顺序 | `document apply` 只在必要时返回一个 scoped `maintenance sync` |
+| 可组合原子性 | 不相关的派生治理不隐式执行；只有实际写入成功的结果用结构化 `follow_up` 声明必要步骤，由 Skill 决定组合顺序 | `document apply` 预览时 `follow_up` 为空，写入后只在必要时返回一个 scoped `maintenance sync` |
 
 命令副作用按下列边界分类：
 
@@ -124,6 +124,7 @@ Campfire 不是“Markdown 版 kubectl”，而是面向人机协作场景组合
 5. **人类与 Agent 共用一个契约**：命令和结果只有一套语义。JSON 状态、issues、missing fields 与 follow-up 供 Agent 稳定消费，`tree` 和分层 `-h` 供人类与 Agent 渐进发现，不维护第二套参数目录。
 6. **语义与机制分层**：人类决定高风险取舍，Agent 理解正文和业务语义，Skill 规定加载时机、事实门禁与 SOP，CLI 只执行可确定验证的治理机制。歧义进入 Decision，不为“自动化成功”而猜测。
 7. **聚合入口是少数例外**：`setup` 和 `upgrade` 可以编排多个服务，因为它们表达完整安装生命周期；日常内容治理保持原子能力，避免重新出现 `maintenance run` 一类不可审查的聚合入口。
+8. **参数最小充分、黄金路径唯一**：调用方只提交 CLI 无法可靠推导的事实。已受管的 Workspace、Space、Domain 和 Project 优先使用稳定 id，路径只用于外部输入、未接管来源、显式物理位置或尚无稳定 id 的文档；同一事实不得同时要求 id、完整路径和父级关系。一个常规意图只保留一个公共入口，不用互斥模式参数、兼容别名或要求 Agent 手工拼装底层步骤来表达同一行为。
 
 横切关注点与业务 SOP 不使用同一种复用手段。哈希复核、写锁、原子替换和失败恢复由显式 ChangeSet Executor 复用；写命令返回的 `follow_up` 由 Skill 消费。不为了复用 Maintenance 而引入 AOP 切面、命令总线、全局钩子或隐式中间件。
 
@@ -163,7 +164,7 @@ Project 的逻辑身份可以跨设备保持一致，但 `local_path` 是机器
 
 可移植元数据由 Vault 根目录唯一的 `.campfire.yaml` 承载并随 Git 或文件同步；不得提交 `campfire.db` 来共享状态。Manifest 使用稳定的 `workspace.id`，保存 Workspace 名称、治理版本，以及 Project 的 id、名称、文档领域、Git remote、默认分支和状态，明确禁止 `local_path`。现有 `_空间.md` 与 `_领域.md` 继续分别承载 Space 和 Domain 事实，避免在 Manifest 重复维护。Decision 当前保持本地，不属于该 Manifest。
 
-新设备执行 `campfire setup --workspace <vault>`：读取 Manifest、注册本机路径、恢复 Project 逻辑元数据、同步类型/Profile/Skills/Bases 并执行健康检查。无法自动确定的项目源码路径显示为 `unbound_projects`，再用 `campfire workspace project bind` 完成本机绑定。整个流程可重复执行。
+新设备执行 `campfire setup --path <vault>`：读取 Manifest、注册本机路径、恢复 Project 逻辑元数据、同步类型/Profile/Skills/Bases 并执行健康检查。已注册 Workspace 只通过根级 `campfire --workspace <id> ...` 显式选择。无法自动确定的项目源码路径显示为 `unbound_projects`，再用 `campfire workspace project bind` 完成本机绑定。整个流程可重复执行。
 
 ### 领域结构重构
 
@@ -172,10 +173,10 @@ Domain 的机器身份、显示名称和物理位置是三个独立维度：
 ```text
 domain_id  稳定身份，普通重命名和移动不改变
 name       人类可读名称，通过 domain rename 修改
-path       Workspace 内物理位置，通过 domain move 或显式目录重命名修改
+path       Workspace 内物理位置，通过 domain move 修改
 ```
 
-`domain rename`、`domain move` 和高风险的 `domain rekey` 是领域级事务，不应拆成大量逐文件迁移。路径变化必须联动 `_领域.md`、Project `document_domain`、`.campfire.yaml` 和路径引用；`rekey` 必须联动直接子领域的 `parent_domain`。所有命令默认预览，显式 `--confirm` 后执行。
+`domain rename`、`domain move`、`domain merge`、`domain delete` 和高风险的 `domain rekey` 是领域级意图原子事务，不应拆成大量逐文件迁移。路径变化必须联动 `_领域.md`、Project `document_domain`、`.campfire.yaml` 和路径引用；`rekey` 必须联动直接子领域的 `parent_domain`。`merge` 把源 Domain 的受管内容迁入目标 Domain，并在不变量满足时移除源 Domain；`delete` 只删除没有内容、附件、子 Domain 或 Project 绑定的逻辑空 Domain。它们不是跨业务聚合入口，内部必须复用同一 ChangeSet、快照复核和失败恢复边界。所有命令默认预览，显式 `--confirm` 后执行。
 
 SQLite 中的 `spaces`、`domains` 与 `documents` 是本机查询投影，不是新的事实源。`setup`、`maintenance check` 和领域重构会自动从 `.campfire.yaml`、`_空间.md`、`_领域.md` 与内容文档刷新这些表；`workspace rebuild --confirm` 只提供低频的完整恢复入口。
 

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/COMMAND.md

@@ -3,7 +3,7 @@
 人类与 Agent 先用 `campfire tree` 发现命令，再用任意层级的 `-h` 渐进加载参数。
 
 ```bash
-campfire setup --workspace <vault-path> [--id <workspace-id>] --default
+campfire setup --path <vault-path> [--id <workspace-id>] --default
 campfire upgrade
 campfire skill sync
 campfire base sync
@@ -17,15 +17,18 @@ campfire workspace space check --space <space-id>
 campfire workspace config check
 campfire workspace domain list
 campfire workspace domain check
-campfire workspace domain adopt --source <folder> --target-path <path> --id <id> --name <name> --space <id> --type <type> --governance <policy> [--parent <id>] [--project <id>] [--confirm]
-campfire workspace domain rename --domain <id> --name <name> [--rename-directory|--target-path <path>] [--project-name <name>] [--confirm]
-campfire workspace domain move --domain <id> --target-path <path> [--parent-domain <id>] [--confirm]
+campfire workspace domain create --id <id> --name <name> --path <workspace-relative-path> --type <type> [--governance <policy>] [--project <id>] [--confirm]
+campfire workspace domain adopt --source <folder> --id <id> --name <name> --type <type> [--target-path <path>] [--governance <policy>] [--project <id>] [--confirm]
+campfire workspace domain rename --domain <id> --name <name> [--confirm]
+campfire workspace domain move --domain <id> --target <space-or-domain-id> [--confirm]
+campfire workspace domain merge --source <id> --target <id> [--confirm]
+campfire workspace domain delete --domain <id> [--confirm]
 campfire workspace domain rekey --domain <id> --new-id <id> [--confirm]
 campfire workspace restructure inventory --scope <path> --batch <id>
 campfire workspace restructure plan --batch <id>
 campfire workspace project resolve --path "$PWD"
 campfire document apply --path <workspace-relative-markdown> --type <type> --set <field=value> [--body-file <path>] [--confirm]
-campfire document move --from <source> --to <target> [--set <field=value>] [--unset <field>] [--expected-hash <sha256>] [--confirm]
+campfire document move --path <source> --domain <target-domain-id> [--name <filename>] [--set <field=value>] [--unset <field>] [--expected-hash <sha256>] [--confirm]
 campfire document inspect --path <file>
 campfire document type list
 campfire document profile list
@@ -41,4 +44,6 @@ campfire maintenance archive check [--scope <path>]
 campfire maintenance archive apply [--scope <path>] --confirm
 ```
 
-Space、Domain、Project 的 `create`/`adopt`，以及文档移动、重构、归档写操作默认先预览；审查通过后才追加 `--confirm`。`document apply` 可新建、更新或为已有正文补齐 Frontmatter；`document move` 可在任意已声明 Domain 之间移动单篇文档并对齐可确定的 `domain`/`project`。目标 Profile 缺少语义字段时返回 `missing_fields`，调用方用 `--set`/`--unset` 补齐。写命令只返回实际需要的一个 scoped `maintenance sync` follow-up，没有派生影响时返回空列表。具体参数以对应命令的 `-h` 为准。
+Space、Domain、Project 的 `create`/`adopt`，以及文档移动、重构、归档写操作默认先预览；审查通过后才追加 `--confirm`。已注册 Workspace 只通过根级 `campfire --workspace <id> ...` 选择；已声明 Space、Domain 和 Project 使用稳定 ID，CLI 自行推导路径和父子关系。路径参数只用于新位置、具体文件、外部输入和显式扫描范围。
+
+`document apply` 可新建、更新或为已有正文补齐 Frontmatter；`document move` 可在任意已声明 Domain 之间移动单篇文档并对齐可确定的 `domain`/`project`。目标 Profile 缺少语义字段时返回 `missing_fields`，调用方用 `--set`/`--unset` 补齐。只有实际写入成功的结果才可返回一个实际需要的 scoped `maintenance sync` follow-up；预览、阻塞或无派生影响时返回空列表。具体参数以对应命令的 `-h` 为准。

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: campfire-cli
-Version: 0.1.8
+Version: 0.1.9
 Summary: Local-first shared context and governance CLI for humans and agents
 License-Expression: MIT
 License-File: LICENSE
@@ -49,7 +49,7 @@ uv tool install --editable /path/to/campfire-cli
 
 ```bash
 # 1. 接入已有 Vault（目录已存在，含或不含 .campfire.yaml）
-campfire setup --workspace /path/to/vault --default
+campfire setup --path /path/to/vault --default
 
 # 2. 或者从零创建新 Workspace（初始化目录结构并注册）
 campfire workspace create --id personal --path /path/to/vault --default
@@ -59,7 +59,7 @@ campfire maintenance check --summary
 campfire maintenance sync --dry-run
 ```
 
-不指定 `--workspace` 运行 `campfire setup` 是降级执行而不是报错：仍会同步全局 Skill 与提示词路标，输出接入引导，并显式列出被跳过的 Manifest 相关步骤。
+不指定 `--path` 运行 `campfire setup` 是降级执行而不是报错：仍会同步全局 Skill 与提示词路标，输出接入引导，并显式列出被跳过的 Manifest 相关步骤。
 
 `setup` 与 `skill sync` 会向 `~/.claude/CLAUDE.md`、`~/.agents/AGENTS.md` 注入幂等的 campfire 路标块（带注释标记、不触碰块外内容；`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标），并把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`（`CAMPFIRE_SKILL_TARGETS` 可覆盖）。Agent 冷启动时由此知道本机装有 campfire。
 
@@ -79,7 +79,7 @@ Workspace ── Space ── Domain 树 ── 文档
 | Decision | 需要人类或高级 Agent 回答的持久判断 | 全局 SQLite，投影到 `_协作/decisions/` |
 | Generated View | MOC、相关文档页、Base、报告 | 派生数据，能生成就不手工维护 |
 
-设备边界：`.campfire.yaml` 只保存可跨设备同步的稳定身份与逻辑关联（Project id、Git remote、文档 Domain 等），禁止本机绝对路径；新设备执行 `campfire setup --workspace <vault>` 即可恢复。本机路径绑定、索引、Decision、锁与报告都在 `~/.campfire/`（可用 `CAMPFIRE_HOME` 覆盖），按 Workspace 隔离。
+设备边界：`.campfire.yaml` 只保存可跨设备同步的稳定身份与逻辑关联（Project id、Git remote、文档 Domain 等），禁止本机绝对路径；新设备执行 `campfire setup --path <vault>` 即可恢复。本机路径绑定、索引、Decision、锁与报告都在 `~/.campfire/`（可用 `CAMPFIRE_HOME` 覆盖），按 Workspace 隔离。
 
 ## 常用命令
 
@@ -106,9 +106,9 @@ campfire decision create / list / answer / close # 持久决策通道
 ```bash
 campfire workspace space create --id research --name "研究" --path myresearch --type research
 campfire workspace domain create --id wiki --name "Wiki" --path "mywork/项目/wiki" \
-  --space work --type knowledge-domain --governance project-docs --confirm
-campfire workspace project adopt --id example --workspace personal \
-  --name "Example" --document-domain "work/example" --local-path /path/to/repo
+  --type knowledge-domain --confirm
+campfire --workspace personal workspace project adopt --id example \
+  --name "Example" --domain project-example --local-path /path/to/repo
 campfire workspace rebuild --confirm             # 索引损坏时从 SSOT 完整恢复
 ```
 
@@ -118,12 +118,12 @@ campfire workspace rebuild --confirm             # 索引损坏时从 SSOT 完
 
 ```bash
 campfire workspace domain adopt --source /path/to/folder --target-path "mynote/新领域" \
-  --id knowledge-new --name "新领域" --space knowledge \
+  --id knowledge-new --name "新领域" \
   --type knowledge-domain --governance knowledge-docs
 # 审查同一份结构化计划后，对相同命令追加 --confirm
 ```
 
-单篇文档在已声明 Domain 之间移动使用 `document move`。批量文档或 Domain 结构重构先冻结范围，再传入 YAML/JSON 意图规格（含 Frontmatter 修改），逐项审查 `approved` 后执行：
+单篇文档在已声明 Domain 之间移动使用 `document move --path <source> --domain <target-domain-id> [--name <filename>]`。常见 Domain 调整直接使用 `domain move/merge/delete`；只有批量文档映射、领域拆分或 Frontmatter Patch 才进入持久批次：
 
 ```bash
 campfire workspace restructure inventory --scope work --batch move-001
@@ -132,14 +132,14 @@ campfire workspace restructure apply --batch move-001 --confirm
 campfire workspace restructure verify --batch move-001
 ```
 
-领域三个维度独立演进：`domain rename`（显示名）、`domain move`（物理路径）、`domain rekey`（稳定身份，高风险）。领域级命令联动 `_领域.md`、子领域、Project、`.campfire.yaml` 与路径引用。
+领域三个维度独立演进：`domain rename`（显示名）、`domain move --target <space-or-domain-id>`（物理位置）、`domain rekey`（稳定身份，高风险）。领域合并和逻辑空领域删除分别使用 `domain merge`、`domain delete`；领域级命令联动 `_领域.md`、子领域、Project、`.campfire.yaml` 与路径引用。
 
 ## 治理模型
 
 - **校验分工**：`maintenance check` 统一负责正式文档的 Schema 与枚举校验，并刷新可重建索引；结构声明由 `workspace space/domain check` 校验；`maintenance sync` 只因结构、MOC、路径或并发安全问题阻塞，单篇文档问题不阻止其他领域刷新。
 - **Frontmatter Profile**：声明式一层继承（`base` 或 `base → knowledge/project-doc/task`），`document profile show` 展示编译后的完整规则；Formatter 只按有效 Profile 排序并保留值，不允许字段由 Validator 报告、不自动删除。
 - **并发与提交安全**：写入前在治理锁内复核内容哈希，外部变化返回 `concurrent-change` / `source-hash-changed`，拒绝覆盖；多文件写入和路径移动经同一 ChangeSet 提交，失败恢复到执行前。
-- **按需后续治理**：写入命令只在派生内容可能变化时返回一个最小 scope 的 `maintenance sync`；Skill 消费该结果，没有 follow-up 就结束，不固定追加 dry-run 或全量 check。
+- **按需后续治理**：写入命令只在实际写入成功且派生内容可能变化时返回一个最小 scope 的 `maintenance sync`；预览和阻塞结果的 `follow_up` 为空。Skill 消费该结果，没有 follow-up 就结束，不固定追加 dry-run 或全量 check。
 - **配置两层模型**：产品默认契约在包内 `resources/defaults/config.yml`（SSOT），用户只在 `~/.campfire/config.yml` 写覆盖项；Mapping 递归合并，`campfire workspace config check` 验证有效配置。
 
 ## Agent 协作

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/README.md

@@ -33,7 +33,7 @@ uv tool install --editable /path/to/campfire-cli
 
 ```bash
 # 1. 接入已有 Vault（目录已存在，含或不含 .campfire.yaml）
-campfire setup --workspace /path/to/vault --default
+campfire setup --path /path/to/vault --default
 
 # 2. 或者从零创建新 Workspace（初始化目录结构并注册）
 campfire workspace create --id personal --path /path/to/vault --default
@@ -43,7 +43,7 @@ campfire maintenance check --summary
 campfire maintenance sync --dry-run
 ```
 
-不指定 `--workspace` 运行 `campfire setup` 是降级执行而不是报错：仍会同步全局 Skill 与提示词路标，输出接入引导，并显式列出被跳过的 Manifest 相关步骤。
+不指定 `--path` 运行 `campfire setup` 是降级执行而不是报错：仍会同步全局 Skill 与提示词路标，输出接入引导，并显式列出被跳过的 Manifest 相关步骤。
 
 `setup` 与 `skill sync` 会向 `~/.claude/CLAUDE.md`、`~/.agents/AGENTS.md` 注入幂等的 campfire 路标块（带注释标记、不触碰块外内容；`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标），并把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`（`CAMPFIRE_SKILL_TARGETS` 可覆盖）。Agent 冷启动时由此知道本机装有 campfire。
 
@@ -63,7 +63,7 @@ Workspace ── Space ── Domain 树 ── 文档
 | Decision | 需要人类或高级 Agent 回答的持久判断 | 全局 SQLite，投影到 `_协作/decisions/` |
 | Generated View | MOC、相关文档页、Base、报告 | 派生数据，能生成就不手工维护 |
 
-设备边界：`.campfire.yaml` 只保存可跨设备同步的稳定身份与逻辑关联（Project id、Git remote、文档 Domain 等），禁止本机绝对路径；新设备执行 `campfire setup --workspace <vault>` 即可恢复。本机路径绑定、索引、Decision、锁与报告都在 `~/.campfire/`（可用 `CAMPFIRE_HOME` 覆盖），按 Workspace 隔离。
+设备边界：`.campfire.yaml` 只保存可跨设备同步的稳定身份与逻辑关联（Project id、Git remote、文档 Domain 等），禁止本机绝对路径；新设备执行 `campfire setup --path <vault>` 即可恢复。本机路径绑定、索引、Decision、锁与报告都在 `~/.campfire/`（可用 `CAMPFIRE_HOME` 覆盖），按 Workspace 隔离。
 
 ## 常用命令
 
@@ -90,9 +90,9 @@ campfire decision create / list / answer / close # 持久决策通道
 ```bash
 campfire workspace space create --id research --name "研究" --path myresearch --type research
 campfire workspace domain create --id wiki --name "Wiki" --path "mywork/项目/wiki" \
-  --space work --type knowledge-domain --governance project-docs --confirm
-campfire workspace project adopt --id example --workspace personal \
-  --name "Example" --document-domain "work/example" --local-path /path/to/repo
+  --type knowledge-domain --confirm
+campfire --workspace personal workspace project adopt --id example \
+  --name "Example" --domain project-example --local-path /path/to/repo
 campfire workspace rebuild --confirm             # 索引损坏时从 SSOT 完整恢复
 ```
 
@@ -102,12 +102,12 @@ campfire workspace rebuild --confirm             # 索引损坏时从 SSOT 完
 
 ```bash
 campfire workspace domain adopt --source /path/to/folder --target-path "mynote/新领域" \
-  --id knowledge-new --name "新领域" --space knowledge \
+  --id knowledge-new --name "新领域" \
   --type knowledge-domain --governance knowledge-docs
 # 审查同一份结构化计划后，对相同命令追加 --confirm
 ```
 
-单篇文档在已声明 Domain 之间移动使用 `document move`。批量文档或 Domain 结构重构先冻结范围，再传入 YAML/JSON 意图规格（含 Frontmatter 修改），逐项审查 `approved` 后执行：
+单篇文档在已声明 Domain 之间移动使用 `document move --path <source> --domain <target-domain-id> [--name <filename>]`。常见 Domain 调整直接使用 `domain move/merge/delete`；只有批量文档映射、领域拆分或 Frontmatter Patch 才进入持久批次：
 
 ```bash
 campfire workspace restructure inventory --scope work --batch move-001
@@ -116,14 +116,14 @@ campfire workspace restructure apply --batch move-001 --confirm
 campfire workspace restructure verify --batch move-001
 ```
 
-领域三个维度独立演进：`domain rename`（显示名）、`domain move`（物理路径）、`domain rekey`（稳定身份，高风险）。领域级命令联动 `_领域.md`、子领域、Project、`.campfire.yaml` 与路径引用。
+领域三个维度独立演进：`domain rename`（显示名）、`domain move --target <space-or-domain-id>`（物理位置）、`domain rekey`（稳定身份，高风险）。领域合并和逻辑空领域删除分别使用 `domain merge`、`domain delete`；领域级命令联动 `_领域.md`、子领域、Project、`.campfire.yaml` 与路径引用。
 
 ## 治理模型
 
 - **校验分工**：`maintenance check` 统一负责正式文档的 Schema 与枚举校验，并刷新可重建索引；结构声明由 `workspace space/domain check` 校验；`maintenance sync` 只因结构、MOC、路径或并发安全问题阻塞，单篇文档问题不阻止其他领域刷新。
 - **Frontmatter Profile**：声明式一层继承（`base` 或 `base → knowledge/project-doc/task`），`document profile show` 展示编译后的完整规则；Formatter 只按有效 Profile 排序并保留值，不允许字段由 Validator 报告、不自动删除。
 - **并发与提交安全**：写入前在治理锁内复核内容哈希，外部变化返回 `concurrent-change` / `source-hash-changed`，拒绝覆盖；多文件写入和路径移动经同一 ChangeSet 提交，失败恢复到执行前。
-- **按需后续治理**：写入命令只在派生内容可能变化时返回一个最小 scope 的 `maintenance sync`；Skill 消费该结果，没有 follow-up 就结束，不固定追加 dry-run 或全量 check。
+- **按需后续治理**：写入命令只在实际写入成功且派生内容可能变化时返回一个最小 scope 的 `maintenance sync`；预览和阻塞结果的 `follow_up` 为空。Skill 消费该结果，没有 follow-up 就结束，不固定追加 dry-run 或全量 check。
 - **配置两层模型**：产品默认契约在包内 `resources/defaults/config.yml`（SSOT），用户只在 `~/.campfire/config.yml` 写覆盖项；Mapping 递归合并，`campfire workspace config check` 验证有效配置。
 
 ## Agent 协作

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/SPEC.md

@@ -96,16 +96,18 @@ Campfire 使用语义化版本：
 
 - `domain_id`、`name` 和 `path` 分别表示稳定身份、显示名称和物理位置，不得隐式绑定。
 - 普通 rename 和 move 不得改变 `domain_id`；只有显式 `domain rekey` 可以修改稳定身份。
-- 修改领域名称不得默认修改 Project 名称；必须由 `--project-name` 明确表达。
+- 修改领域名称不得修改 Project 名称；Project 展示名称只能由 `workspace project update --name` 显式修改。
 - 领域路径变化必须同步 Project `document_domain`、`.campfire.yaml` 和路径引用。
 - `rekey` 必须同步直接子领域的 `parent_domain`。
+- `move` 的目标必须使用 Space 或 Domain 稳定 id；`merge` 和 `delete` 不得退化为 Agent 手工移动、删除声明与清理索引。
+- 已受管对象使用稳定 id，路径参数只用于新位置、具体文件、外部输入与扫描范围；不得同时要求可推导的 id、路径和父级关系。
 - 领域级写入默认只预览，只有显式 `--confirm` 才执行。
 
 ## Workspace 索引
 
 - SQLite `spaces`、`domains`、`documents` 只允许作为可重建本机投影，不得反向覆盖 Markdown SSOT。
 - `setup` 与 `maintenance check` 必须自动刷新完整拓扑和文档索引。
-- 写命令只在派生状态可能变化时返回一个 scoped `maintenance sync` follow-up；
+- 写命令只在实际写入成功且派生状态可能变化时返回一个 scoped `maintenance sync` follow-up；预览和阻塞结果必须返回空列表；
   调用方只执行实际返回的 follow-up，不固定追加 check 或全量扫描。
 - `workspace rebuild` 默认只预览；`--confirm` 后从 Manifest 和 Markdown 完整替换派生索引。
 

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "campfire-cli"
-version = "0.1.8"
+version = "0.1.9"
 description = "Local-first shared context and governance CLI for humans and agents"
 readme = "README.md"
 license = "MIT"

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/src/campfire_cli/__init__.py

@@ -1,3 +1,3 @@
 """Campfire CLI package."""
 
-__version__ = "0.1.8"
+__version__ = "0.1.9"

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/src/campfire_cli/app/document/cli/document_cli.py

@@ -123,8 +123,9 @@ def apply_document(
 @document_cli.command("move")
 def move_document(
     ctx: typer.Context,
-    source: str = typer.Option(..., "--from"),
-    target: str = typer.Option(..., "--to"),
+    source: str = typer.Option(..., "--path", help="源文档的 Workspace 相对路径"),
+    target_domain: str = typer.Option(..., "--domain", help="目标 Domain 的稳定 id"),
+    name: str | None = typer.Option(None, "--name", help="可选的新文件名；省略时保持原文件名"),
     set_values: list[str] | None = typer.Option(None, "--set"),
     unset_fields: list[str] | None = typer.Option(None, "--unset"),
     expected_hash: str | None = typer.Option(None, "--expected-hash"),
@@ -134,7 +135,8 @@ def move_document(
     invoke(
         lambda: service(ctx).move(
             source,
-            target,
+            target_domain,
+            name=name,
             values=parse_values(set_values or []),
             unset_fields=tuple(unset_fields or []),
             expected_hash=expected_hash,

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/src/campfire_cli/app/document/service/document_apply_service.py

@@ -4,7 +4,10 @@ from datetime import date
 from pathlib import Path
 from typing import Any
 
-from campfire_cli.app.base.schema.operation_schema import maintenance_sync_follow_up
+from campfire_cli.app.base.schema.operation_schema import (
+    CommandFollowUp,
+    maintenance_sync_follow_up,
+)
 from campfire_cli.app.document.schema import (
     DocumentApplyRequest,
     DocumentApplyResult,
@@ -165,7 +168,13 @@ class DocumentApplyService:
                 expected={path: None if actual_hash == "missing" else actual_hash},
             )
         )
-        return result.model_copy(update={"status": "applied", "write_performed": True})
+        return result.model_copy(
+            update={
+                "status": "applied",
+                "write_performed": True,
+                "follow_up": self._follow_up(request, exists, parsed.has_frontmatter),
+            }
+        )
 
     def _creation_defaults(self, path: Path, document_type: str, today: str) -> dict[str, Any]:
         prefix = self._settings.document_types["types"][document_type]["prefix"]
@@ -223,11 +232,6 @@ class DocumentApplyService:
         issues: list[dict[str, Any]],
         missing_fields: list[str] | None = None,
     ) -> DocumentApplyResult:
-        scope = Path(request.path).parent.as_posix()
-        derived_fields = {"name", "type", "status", "lifecycle", "domain", "project", "related"}
-        needs_sync = not exists or not had_frontmatter
-        needs_sync = needs_sync or bool(set(request.values) & derived_fields)
-        needs_sync = needs_sync or request.body is not None
         return DocumentApplyResult(
             status=status,
             workspace_id=self._settings.workspace_id,
@@ -237,9 +241,23 @@ class DocumentApplyService:
             expected_hash=expected_hash,
             issues=issues,
             missing_fields=missing_fields or [],
-            follow_up=(
-                maintenance_sync_follow_up(self._settings.workspace_id, [scope])
-                if not issues and needs_sync
-                else []
-            ),
+        )
+
+    def _follow_up(
+        self,
+        request: DocumentApplyRequest,
+        exists: bool,
+        had_frontmatter: bool,
+    ) -> list[CommandFollowUp]:
+        derived_fields = {"name", "type", "status", "lifecycle", "domain", "project", "related"}
+        needs_sync = not exists or not had_frontmatter
+        needs_sync = needs_sync or bool(set(request.values) & derived_fields)
+        needs_sync = needs_sync or request.body is not None
+        return (
+            maintenance_sync_follow_up(
+                self._settings.workspace_id,
+                [Path(request.path).parent.as_posix()],
+            )
+            if needs_sync
+            else []
         )

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/src/campfire_cli/app/document/service/document_move_service.py

@@ -200,6 +200,14 @@ class DocumentMoveService:
                     frontmatter_changes[field] = after
 
         status = "needs-input" if missing_fields else "blocked" if issues else "ready"
+        follow_up = maintenance_sync_follow_up(
+            self._settings.workspace_id,
+            (
+                context.root.relative_to(self._settings.vault_root).as_posix()
+                for context in (source_domain, target_domain)
+                if context is not None
+            ),
+        )
         result = DocumentMoveResult(
             status=status,
             workspace_id=self._settings.workspace_id,
@@ -212,14 +220,6 @@ class DocumentMoveService:
             frontmatter_changes=frontmatter_changes,
             issues=issues,
             missing_fields=missing_fields,
-            follow_up=maintenance_sync_follow_up(
-                self._settings.workspace_id,
-                (
-                    context.root.relative_to(self._settings.vault_root).as_posix()
-                    for context in (source_domain, target_domain)
-                    if context is not None
-                ),
-            ),
         )
         if issues or not confirm:
             return result
@@ -240,6 +240,7 @@ class DocumentMoveService:
                 "status": "moved",
                 "write_performed": True,
                 "updated_references": updated_references,
+                "follow_up": follow_up,
             }
         )
 

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/src/campfire_cli/app/document/service/document_service.py

@@ -18,6 +18,7 @@ from campfire_cli.app.document.service.kanban_service import (
     renderability_result,
 )
 from campfire_cli.app.document.service.profile_registry import ProfileRegistry
+from campfire_cli.common.documents.domain_context import DomainContextError, resolve_domain_by_id
 from campfire_cli.common.documents.markdown import parse_document
 from campfire_cli.common.exceptions import ConfigurationError, GovernanceBlockedError
 from campfire_cli.common.filesystem import atomic_write, safe_path
@@ -137,13 +138,23 @@ class DocumentService:
     def move(
         self,
         source: str,
-        target: str,
+        target_domain: str,
         *,
+        name: str | None = None,
         values: dict[str, Any] | None = None,
         unset_fields: tuple[str, ...] = (),
         expected_hash: str | None = None,
         confirm: bool = False,
     ) -> DocumentMoveResult:
+        source_path = safe_path(self._settings.vault_root, source)
+        target_name = name or source_path.name
+        if Path(target_name).name != target_name or not target_name.endswith(".md"):
+            raise ConfigurationError("document move 的 --name 必须是 Markdown 文件名")
+        try:
+            domain = resolve_domain_by_id(self._settings.vault_root, target_domain)
+        except DomainContextError as exc:
+            raise ConfigurationError(f"目标 Domain 不存在或不唯一：{exc.detail}") from exc
+        target = (domain.root / target_name).relative_to(self._settings.vault_root).as_posix()
         return self._movement.move(
             source,
             target,

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/src/campfire_cli/app/maintenance/service/maintenance_service.py

@@ -159,7 +159,7 @@ class MaintenanceService:
                 if domain.path == scope_path or scope_path in domain.path.parents
             ]
             issues = [issue for issue in issues if self._path_matches_scope(issue["path"], scope)]
-            if not domains:
+            if not domains and not scope_path.exists():
                 return self._sync_blocked("scope-missing", scope, scope)
         if issues:
             return MaintenanceResult(

{campfire_cli-0.1.8 → campfire_cli-0.1.9}/src/campfire_cli/app/workspace/SPEC.md

@@ -2,17 +2,17 @@
 
 本模块管理 Workspace、Space、Domain、Project 注册表和 Workspace 初始化。Workspace id 与 Project id 是本机治理状态的稳定键；路径只是可变定位信息。用户级 `CAMPFIRE_HOME/campfire.db` 是唯一数据库，保存注册数据、文档索引和工作流状态；每个 Workspace 只保留配置与人类可审阅的运行产物，不再拥有独立数据库。所有工具状态均位于 `CAMPFIRE_HOME`，不得向目标 Workspace 创建工具状态目录。
 
-解析优先级为显式 `--workspace`、当前目录所属的已注册 Workspace、默认 Workspace。写操作仍由具体业务模块执行。
+解析优先级为根级显式 `--workspace <id>`、当前目录所属的已注册 Workspace、默认 Workspace。显式值只接受稳定 Workspace id，不接受路径；叶命令不得重复暴露 Workspace 选择器。写操作仍由具体业务模块执行。
 
-`campfire setup --workspace <path>` 根据 Manifest 接入已有 Workspace；缺少 Manifest 时必须提供 `--id` 以创建首份 Manifest。`workspace create` 要求目标路径不存在，并创建全局收件箱、带 `_空间.md` 的知识/工作 Space 和治理视图基础目录。两者写入全局 SQLite 注册表，不向 Workspace 写工具状态。
+`campfire setup --path <path>` 根据 Manifest 接入已有 Workspace；缺少 Manifest 时必须提供 `--id` 以创建首份 Manifest。`workspace create` 要求目标路径不存在，并创建全局收件箱、带 `_空间.md` 的知识/工作 Space 和治理视图基础目录。两者写入全局 SQLite 注册表，不向 Workspace 写工具状态。
 
-`workspace space/domain create` 只创建不存在的新目录；`space adopt` 原地纳管已有 Space，`domain adopt` 可原地声明或把一个 Vault 内外已有目录接管到明确目标。外部来源始终保留。命令默认只输出计划，追加 `--confirm` 才写入。
+`workspace space/domain create` 只创建不存在的新目录；`space adopt` 原地纳管已有 Space，`domain adopt` 可原地声明或把一个 Vault 内外已有目录接管到明确目标。Domain 所属 Space 和最近父 Domain 从目标路径唯一推导，嵌套 Domain 继承 governance/Project；外部来源始终保留。命令默认只输出计划，追加 `--confirm` 才写入。
 
 `workspace config check` 统一校验包内产品默认值和当前 Workspace 的有效治理契约，包括目录与 Space 冲突、文档类型前缀、Profile 引用和继承、归档策略以及托管资源列表。
 
-`workspace restructure` 负责一次性改变已有 Workspace 的批量文档结构：冻结范围、生成带内容哈希的审批计划、执行批量跨领域移动或改名、更新引用并验证迁移事实。Domain 自身的 rename/move/rekey 直接位于 `workspace domain`。单篇文档移动属于 `document move`。纯移动不得重写文档内容；`verify` 只验证本批次 source/target 结果。该能力属于 Workspace Service，不设独立 App，也不用于日常增量维护。
+`workspace restructure` 负责原子命令无法表达的批量文档映射、领域拆分和 Frontmatter Patch：冻结范围、生成带内容哈希的审批计划、更新引用并验证迁移事实。Domain 的 rename/move/merge/delete/rekey 直接位于 `workspace domain`；move 使用目标 Space/Domain id 推导路径，merge 一次完成内容迁移和源领域移除，delete 只删除逻辑空领域。单篇文档移动属于 `document move`，以目标 Domain id 代替目标路径。纯移动不得重写文档内容；`verify` 只验证本批次 source/target 结果。该能力属于 Workspace Service，不设独立 App，也不用于日常增量维护。
 
-Adoption、文档批量 Restructure 与 Domain Restructure 均使用共享 ChangeSet Executor 提交文件写入和路径移动，并在协调的 Repository 写入失败时补偿恢复。Workspace Service 不调用 Maintenance Service；成功结果只在必要时以轻量 `follow_up` 返回一个 scoped `maintenance sync`。
+Adoption、文档批量 Restructure 与 Domain Restructure 均使用共享 ChangeSet Executor 提交文件写入和路径移动，并在协调的 Repository 写入失败时补偿恢复。Workspace Service 不调用 Maintenance Service；实际写入成功的结果只在必要时以轻量 `follow_up` 返回一个 scoped `maintenance sync`，预览和阻塞结果不返回可执行后续。
 
 Space 是 Workspace 根下以 `_空间.md` 声明的顶级内容容器；Domain 位于 Space 内，以 `_领域.md` 声明并可任意嵌套。子 Domain 必须处于父 Domain 路径下、属于同一 Space 并继承 governance。`_收件箱` 与 `治理视图` 是系统区域，不是 Space。Maintenance 只消费本模块发现的结构，不维护第二套领域规则。
 
@@ -22,6 +22,6 @@ Project 是 Workspace 连接的外部工作资源，记录稳定 id、显示名
 
 `project resolve` 只按规范化后的本地 Git 根目录和 remote 识别已注册 Project，不凭目录名称猜测；零匹配和多匹配都返回可判断状态。`project check` 只报告源码路径、remote、默认分支和文档领域的漂移，不自动更新稳定身份或归属。
 
-`project create` 用于新 Project onboarding，默认只返回计划，追加 `--confirm` 后通过 Domain Service 创建工作 Space 内的项目根 Domain 并注册 Project。初始化不虚构业务子领域；已存在文档中心使用 `project adopt` 接入。
+`project create --path` 用于新 Project onboarding，默认只返回计划，追加 `--confirm` 后通过 Domain Service 创建工作 Space 内的项目根 Domain 并注册 Project。初始化不虚构业务子领域；已存在文档中心使用 `project adopt --domain <id>` 接入，更新只提交显式给出的字段。
 
 注册数据只通过 CLI 和 SQLite 维护。JSON 仅用于显式 export/import；import 默认只预检，必须使用 `--confirm` 才替换当前注册数据。不读取旧 JSON 注册表，不维护双事实源。

campfire_cli-0.1.9/src/campfire_cli/app/workspace/cli/config_cli.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+
+from campfire_cli.app.workspace.cli.workspace_cli import emit, invoke, resolution
+from campfire_cli.app.workspace.service.config_service import WorkspaceConfigService
+from campfire_cli.config.settings import WorkspaceSettings
+
+config_cli = typer.Typer(
+    help="检查 Workspace 治理配置契约",
+    context_settings={"help_option_names": ["-h", "--help"]},
+)
+
+
+def service(ctx: typer.Context) -> WorkspaceConfigService:
+    resolved = resolution(ctx)
+    settings = WorkspaceSettings.load(resolved.workspace_id, Path(resolved.workspace))
+    return WorkspaceConfigService(settings)
+
+
+@config_cli.command("check")
+def check(ctx: typer.Context) -> None:
+    emit(invoke(lambda: service(ctx).check()))