campfire-cli 0.1.16__tar.gz → 0.1.18__tar.gz

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/.github/workflows/release.yml

@@ -55,12 +55,9 @@ jobs:
     needs: publish
     runs-on: ubuntu-latest
     steps:
+      - uses: actions/checkout@v5
       - uses: astral-sh/setup-uv@v10.1.0
       - name: Install published package from PyPI
         shell: bash
         run: |
-          version="${GITHUB_REF_NAME#v}"
-          verify_dir="$RUNNER_TEMP/campfire-pypi-verify"
-          uv venv "$verify_dir"
-          uv pip install --python "$verify_dir/bin/python" --index-url https://pypi.org/simple "campfire-cli==$version"
-          test "$("$verify_dir/bin/campfire" version)" = "$version"
+          python scripts/pypi_verify.py "${GITHUB_REF_NAME#v}"

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: campfire-cli
-Version: 0.1.16
+Version: 0.1.18
 Summary: Local-first shared context and governance CLI for humans and agents
 License-Expression: MIT
 License-File: LICENSE
@@ -61,7 +61,7 @@ campfire maintenance sync --dry-run
 
 不指定 `--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。
+`setup` 会向 `~/.claude/CLAUDE.md`、`~/.agents/AGENTS.md` 注入幂等的 campfire 路标块，保留标记外内容；`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标。`setup` 与 `skill sync` 会把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`，可通过 `CAMPFIRE_SKILL_TARGETS` 覆盖。单独执行 `skill sync` 不更新提示词路标。
 
 ## 核心概念
 
@@ -85,7 +85,7 @@ Workspace ── Space ── Domain 树 ── 文档
 
 ```bash
 campfire tree                                    # 完整命令树
-campfire workspace resolve                       # Agent 冷启动第一步：解析当前 Workspace
+campfire workspace resolve                       # Workspace 不明确时解析
 campfire workspace list / show / export / import # 注册库管理与备份
 campfire workspace project resolve               # 当前目录属于哪个已注册项目
 
@@ -94,7 +94,7 @@ campfire maintenance sync [--dry-run] [--scope]  # 刷新 MOC 与相关文档页
 
 campfire document inspect / check / format       # 单篇文档查看、校验、格式化
 campfire document list                           # 精确枚举和筛选受管文档
-campfire document apply / move                   # 创建更新、类型转换、跨 Domain 移动
+campfire document apply / move / rename          # 结构写入、跨 Domain 移动、原地改名
 campfire document profile list / show / resolve  # Frontmatter Profile 规则
 campfire document type list                      # 文档类型与前缀
 campfire base list / show / check / sync          # Obsidian Base 治理视图
@@ -146,7 +146,9 @@ campfire workspace restructure verify --batch move-001
 
 ## Agent 协作
 
-全局 Skill（`campfire skill list` 查看托管清单，`campfire skill sync` 手动同步）定义了 Agent 的标准工作流：已给出唯一文件路径的正文读取或小改直接使用文件工具；新建文档、修改 Frontmatter/类型/归属或执行结构治理时才加载 bootstrap，并使用 `document apply/move` 等原子命令。`document apply --path` 创建或唯一更新时可省略 `.md`，创建时也可省略类型前缀。Frontmatter 契约已知时直接 apply；现有文档的字段类型或合法值未知时只执行一次 `document inspect` 后 apply。批量结构调整用 `workspace restructure`；归档在用户明确同意后通过 `document apply --set document_status=archived` 执行。关键歧义进入 `human-request`，不由 Agent 擅自决定。
+全局 Skill 定义 Agent 的文档工作流：已知路径的人工正文直接 Edit；新建文档先 apply 创建结构，再按返回的 `target` 补正文。只在治理上下文缺失时加载 bootstrap；字段契约未知时，新建查一次目标 Profile，更新查一次 inspect。已明确的信息不重复查询，用户已有授权不重复询问。文档相对路径以 Workspace 根目录为基准，不随 cwd 改变；创建时可省略类型前缀与 `.md`。改标题用 rename，跨 Domain 移动用 move，完成后仅执行实际 follow_up。归档仍需用户对具体文档明确同意，关键歧义不得自行猜测。
+
+仓库 Skill 编写规范见 `src/campfire_cli/resources/skills/SPEC.md`。本地与 CI 共用 `uv run python scripts/quality_check.py`；发布前使用 `--release` 增加构建、wheel 隔离安装与冒烟验证。测试日志包含最慢 10 项耗时。Release 的公共 PyPI 安装验证最多等待 3 分钟、间隔 15 秒重试，不重试上传；安装后版本不符直接失败。
 
 ## 许可
 

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/README.md

@@ -45,7 +45,7 @@ campfire maintenance sync --dry-run
 
 不指定 `--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。
+`setup` 会向 `~/.claude/CLAUDE.md`、`~/.agents/AGENTS.md` 注入幂等的 campfire 路标块，保留标记外内容；`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标。`setup` 与 `skill sync` 会把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`，可通过 `CAMPFIRE_SKILL_TARGETS` 覆盖。单独执行 `skill sync` 不更新提示词路标。
 
 ## 核心概念
 
@@ -69,7 +69,7 @@ Workspace ── Space ── Domain 树 ── 文档
 
 ```bash
 campfire tree                                    # 完整命令树
-campfire workspace resolve                       # Agent 冷启动第一步：解析当前 Workspace
+campfire workspace resolve                       # Workspace 不明确时解析
 campfire workspace list / show / export / import # 注册库管理与备份
 campfire workspace project resolve               # 当前目录属于哪个已注册项目
 
@@ -78,7 +78,7 @@ campfire maintenance sync [--dry-run] [--scope]  # 刷新 MOC 与相关文档页
 
 campfire document inspect / check / format       # 单篇文档查看、校验、格式化
 campfire document list                           # 精确枚举和筛选受管文档
-campfire document apply / move                   # 创建更新、类型转换、跨 Domain 移动
+campfire document apply / move / rename          # 结构写入、跨 Domain 移动、原地改名
 campfire document profile list / show / resolve  # Frontmatter Profile 规则
 campfire document type list                      # 文档类型与前缀
 campfire base list / show / check / sync          # Obsidian Base 治理视图
@@ -130,7 +130,9 @@ campfire workspace restructure verify --batch move-001
 
 ## Agent 协作
 
-全局 Skill（`campfire skill list` 查看托管清单，`campfire skill sync` 手动同步）定义了 Agent 的标准工作流：已给出唯一文件路径的正文读取或小改直接使用文件工具；新建文档、修改 Frontmatter/类型/归属或执行结构治理时才加载 bootstrap，并使用 `document apply/move` 等原子命令。`document apply --path` 创建或唯一更新时可省略 `.md`，创建时也可省略类型前缀。Frontmatter 契约已知时直接 apply；现有文档的字段类型或合法值未知时只执行一次 `document inspect` 后 apply。批量结构调整用 `workspace restructure`；归档在用户明确同意后通过 `document apply --set document_status=archived` 执行。关键歧义进入 `human-request`，不由 Agent 擅自决定。
+全局 Skill 定义 Agent 的文档工作流：已知路径的人工正文直接 Edit；新建文档先 apply 创建结构，再按返回的 `target` 补正文。只在治理上下文缺失时加载 bootstrap；字段契约未知时，新建查一次目标 Profile，更新查一次 inspect。已明确的信息不重复查询，用户已有授权不重复询问。文档相对路径以 Workspace 根目录为基准，不随 cwd 改变；创建时可省略类型前缀与 `.md`。改标题用 rename，跨 Domain 移动用 move，完成后仅执行实际 follow_up。归档仍需用户对具体文档明确同意，关键歧义不得自行猜测。
+
+仓库 Skill 编写规范见 `src/campfire_cli/resources/skills/SPEC.md`。本地与 CI 共用 `uv run python scripts/quality_check.py`；发布前使用 `--release` 增加构建、wheel 隔离安装与冒烟验证。测试日志包含最慢 10 项耗时。Release 的公共 PyPI 安装验证最多等待 3 分钟、间隔 15 秒重试，不重试上传；安装后版本不符直接失败。
 
 ## 许可
 

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/SPEC.md

@@ -31,6 +31,7 @@ SQLite / Filesystem Implementation
 - Frontmatter Profile 只允许一层 `base` 配置继承；Profile Loader 编译完整规则，Validator 与 Formatter 共用同一个 EffectiveProfile。
 - 公共接口不得依赖调用方猜测未声明契约。参数类型与复杂输入格式必须能从当前命令帮助获得；错误必须同时提供稳定机器字段和可操作的修复信息，但不得为此复制 Profile 枚举或新增平行命令。
 - `tree` 只用于未知能力发现，不是 Agent 执行已知文档操作的固定前置步骤；Skill 必须把已知正文编辑、契约已知的 Frontmatter 写入和契约未知的 `inspect → apply` 分流清楚。
+- Skill 的最短路径不得省略写入门禁；门禁表达必要前提，不强制重复查询或审批。编写与验收要求统一维护在 `src/campfire_cli/resources/skills/SPEC.md`，运行步骤放对应 Skill。
 - 命令不得读取“最近一次操作”等隐式 Session 状态推导对象或作用域；跨命令后续动作只使用当前结果显式返回的结构化 `follow_up`。
 - 所有写入默认预检，语义计划默认未审批。
 - 写入用例必须在治理锁内复核生成计划时的内容哈希，发现外部变化时拒绝覆盖。
@@ -41,7 +42,7 @@ SQLite / Filesystem Implementation
 ## CLI 输出契约
 
 - 正常输出 indent JSON；错误输出单行 JSON 并写 stderr，退出码非 0。
-- `status` 字段是 Agent 依赖的公共契约，只允许复用既有词汇，不得发明近义词。命令级词汇：ok、error、blocked、needs-input、needs-review、dry-run、synced、planned、ready、applied、issues-found、formatted、archived、up-to-date。文档、领域与 Decision 各有自己的字段词汇表。需要新状态先在本节登记。
+- `status` 字段是 Agent 依赖的公共契约，只允许复用既有词汇，不得发明近义词。命令级词汇：ok、error、blocked、needs-input、needs-review、dry-run、synced、planned、ready、applied、moved、renamed、issues-found、formatted、archived、up-to-date。文档、领域与 Decision 各有自己的字段词汇表。需要新状态先在本节登记。
 - 可恢复的输入错误必须包含稳定 `code`、对应字段和机器可读的期望类型；当正确序列化方式不直观时，同时返回示例值或修复提示。自然语言 message 与示例可以演进，不作为调用方分支判断依据。
 - 前置条件缺失时优先降级执行：能完成的部分照常完成，输出 `needs-input` 并以 `skipped` 字段显式列出被跳过的步骤，而非整体报错退出。
 

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/pyproject.toml

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

campfire_cli-0.1.18/scripts/pypi_verify.py

@@ -0,0 +1,67 @@
+"""SPEC:
+name: pypi_verify
+purpose: 有限等待公共 PyPI 安装可用，并验证已发布版本
+idempotent: true
+side_effects:
+  - 在临时虚拟环境安装已发布的包，不构建或上传产物
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import subprocess
+import tempfile
+import time
+from pathlib import Path
+
+
+def verify(version: str, environment: Path) -> None:
+    """Retry installation for at most three minutes; never retry a version mismatch."""
+    subprocess.run(["uv", "venv", str(environment)], check=True)
+    bin_dir = environment / ("Scripts" if os.name == "nt" else "bin")
+    python = bin_dir / ("python.exe" if os.name == "nt" else "python")
+    campfire = bin_dir / ("campfire.exe" if os.name == "nt" else "campfire")
+    command = [
+        "uv",
+        "pip",
+        "install",
+        "--python",
+        str(python),
+        "--refresh",
+        "--index-url",
+        "https://pypi.org/simple",
+        f"campfire-cli=={version}",
+    ]
+    deadline = time.monotonic() + 180
+    while True:
+        try:
+            subprocess.run(command, check=True, timeout=max(0.001, deadline - time.monotonic()))
+            break
+        except (subprocess.CalledProcessError, subprocess.TimeoutExpired):
+            remaining = deadline - time.monotonic()
+            if remaining <= 15:
+                raise
+            print("PyPI installation unavailable; retrying in 15 seconds", flush=True)
+            time.sleep(15)
+    installed = subprocess.run(
+        [str(campfire), "version"],
+        check=True,
+        capture_output=True,
+        text=True,
+        timeout=30,
+    ).stdout.strip()
+    if installed != version:
+        raise SystemExit(f"installed version {installed} does not match {version}")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("version")
+    args = parser.parse_args()
+    with tempfile.TemporaryDirectory(prefix="campfire-pypi-") as directory:
+        verify(args.version, Path(directory) / "venv")
+
+
+if __name__ == "__main__":
+    main()

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/scripts/quality_check.py

@@ -103,7 +103,7 @@ def main() -> None:
     if arguments.artifact_dir is not None and not arguments.release:
         parser.error("--artifact-dir 只能与 --release 一起使用")
     run("uv", "run", "ruff", "check", "src", "tests", "scripts")
-    run("uv", "run", "pytest", "-q")
+    run("uv", "run", "pytest", "-q", "--durations=10")
     if arguments.release:
         version = project_version()
         check_tag(version)

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/src/campfire_cli/__init__.py

@@ -1,3 +1,3 @@
 """Campfire CLI package."""
 
-__version__ = "0.1.16"
+__version__ = "0.1.18"

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/src/campfire_cli/app/base/schema/operation_schema.py

@@ -1,4 +1,5 @@
 from collections.abc import Iterable
+from os import PathLike
 from pathlib import PurePosixPath
 from typing import Literal
 
@@ -13,10 +14,13 @@ class CommandFollowUp(BaseModel):
     scope: str
 
 
-def maintenance_sync_follow_up(workspace: str, scopes: Iterable[str]) -> list[CommandFollowUp]:
+def maintenance_sync_follow_up(
+    workspace: str, scopes: Iterable[str | PathLike[str]]
+) -> list[CommandFollowUp]:
     """Build one sync follow-up at the smallest scope containing all changes."""
 
-    paths = [PurePosixPath(scope.strip("/")) for scope in dict.fromkeys(scopes) if scope]
+    normalized = (str(scope).replace("\\", "/").strip("/") for scope in scopes if scope)
+    paths = [PurePosixPath(scope) for scope in dict.fromkeys(normalized)]
     if not paths:
         return []
     common = list(paths[0].parts)

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/src/campfire_cli/app/document/SPEC.md

@@ -46,7 +46,8 @@ document/
 - `inspect`：向 Agent 返回单篇文档的 Domain、类型、有效 Profile、具体问题，以及 declared、outgoing、incoming、unresolved 四类确定关系。
 - `apply`：根据目标路径和类型解析 Profile，不存在时生成文档，已有 Frontmatter 时只应用显式补丁，无 Frontmatter 时保留正文并补齐完整契约；先完整渲染并校验，追加 `--confirm` 后原子写入。
 - `template`：只继承 base Profile，必须位于所属 Domain 的 `_模板/`；Domain 归属由物理路径解析，不在 Frontmatter 复制模板作用域或继承关系。
-- `move`：在任意已声明 Domain 之间移动或改名一篇文档，按目标 Profile 对齐可确定的 `domain`/`project` 归属，并更新可确定解析的 Wiki、Markdown 和路径引用。目标 Profile 缺少业务字段时返回 `needs-input`，不猜测。
+- `move`：在任意已声明 Domain 之间移动一篇文档，按目标 Profile 对齐可确定的 `domain`/`project` 归属，并更新可确定解析的 Wiki、Markdown 和路径引用。目标 Profile 缺少业务字段时返回 `needs-input`，不猜测。
+- `rename`：保持一篇文档的物理目录与 Domain 归属不变，根据逻辑标题重算类型前缀文件名，并在同一变更集中更新 `name` 与可确定引用。目标存在时阻止，不覆盖或自动编号。
 - `scanner`：统一解释受管根、忽略目录和豁免文件；Document 与 Maintenance 共用。
 
 Document Service 可以被 Workspace Restructure 编排，但不得反向依赖 Maintenance。批量计划文件、运行记录、MOC、Base、归档和重构批次不属于 Document App。
@@ -67,6 +68,8 @@ Document 写入接口不得要求 Agent 猜测 Frontmatter 输入契约：
 - Document App 解析一次目标 EffectiveProfile，并由 apply 与 move 共用的值解码器转换补丁：enum、string 和 date 保留原始字符串，boolean 只接受明确的 `true` 或 `false`，list 只接受严格 JSON 数组。
 - Profile 与 Rule Service 继续拥有字段类型、合法值和业务校验，不保存命令行字符串。命令帮助负责 Shell 展示方式，并为列表值给出 `--set 'tags=["tag1","tag2"]'` 形式的最小例子。
 - 输入错误统一返回稳定错误码、字段、实际值、期望类型和可直接照抄的参数示例；apply 与 move 不得分别构造两套解码或诊断。
+- apply 在 Profile 已明确时并列收集可确定的禁用字段、缺失字段与类型错误；无效赋值不再重复报同字段缺失。有错误不写入且 follow-up 为空；只有缺失输入时返回 needs-input，含其他问题时返回 blocked 并保留 missing_fields。
+- 文档相对路径始终以 Workspace 根解析，不受 cwd 影响；apply 的 domain-missing 返回实际解析路径和带 Workspace 的领域发现入口，不默认枚举全量候选。
 - 不因输入格式不直观而增加 `--tags`、`--sources` 等字段专用参数，也不把逗号字符串静默猜成列表。
 - 现有文档的有效 Profile 已由 `document inspect` 返回。Skill 只在字段契约未知时安排一次 `inspect → apply`；契约已知的补丁直接 apply，正文小改不进入本接口。
 

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/src/campfire_cli/app/document/cli/document_cli.py

@@ -21,6 +21,7 @@ SET_OPTION_HELP = (
     "值类型由有效 Profile 决定；列表使用严格 JSON，例如 "
     '--set \'tags=["tag1","tag2"]\'。'
 )
+PATH_OPTION_HELP = "Workspace 根目录相对路径（不是 cwd 相对路径），或 Workspace 内绝对路径"
 
 
 def service(ctx: typer.Context) -> DocumentService:
@@ -31,19 +32,25 @@ def service(ctx: typer.Context) -> DocumentService:
 
 
 @document_cli.command("check")
-def check(ctx: typer.Context, path: str = typer.Option(..., "--path")) -> None:
+def check(
+    ctx: typer.Context, path: str = typer.Option(..., "--path", help=PATH_OPTION_HELP)
+) -> None:
     """检查一篇 Markdown 文档是否符合当前类型与 Profile 契约。"""
     emit(invoke(lambda: service(ctx).check(path)))
 
 
 @document_cli.command("kanban-check")
-def kanban_check(ctx: typer.Context, path: str = typer.Option(..., "--path")) -> None:
+def kanban_check(
+    ctx: typer.Context, path: str = typer.Option(..., "--path", help=PATH_OPTION_HELP)
+) -> None:
     """检查文档是否满足 Obsidian Kanban 插件的渲染契约。"""
     emit(invoke(lambda: service(ctx).kanban_check(path)))
 
 
 @document_cli.command("inspect")
-def inspect(ctx: typer.Context, path: str = typer.Option(..., "--path")) -> None:
+def inspect(
+    ctx: typer.Context, path: str = typer.Option(..., "--path", help=PATH_OPTION_HELP)
+) -> None:
     """返回单篇文档的 Profile、领域、确定关系和问题上下文。
 
     示例：campfire document inspect --path "mywork/项目/记录-进展.md"
@@ -62,22 +69,24 @@ def list_documents(
     limit: int | None = typer.Option(None, "--limit", min=1),
 ) -> None:
     """按 Project、Domain、类型与状态列出受管内容文档。"""
-    emit(invoke(
-        lambda: service(ctx).list(
-            project=project,
-            domain=domain,
-            document_type=document_type,
-            document_status=document_status,
-            task_status=task_status,
-            limit=limit,
+    emit(
+        invoke(
+            lambda: service(ctx).list(
+                project=project,
+                domain=domain,
+                document_type=document_type,
+                document_status=document_status,
+                task_status=task_status,
+                limit=limit,
+            )
         )
-    ))
+    )
 
 
 @document_cli.command("format")
 def format_document(
     ctx: typer.Context,
-    path: str = typer.Option(..., "--path", help="现有 Markdown 文档路径"),
+    path: str = typer.Option(..., "--path", help=PATH_OPTION_HELP),
     confirm: bool = typer.Option(False, "--confirm"),
 ) -> None:
     """预览或执行一篇文档的 Frontmatter 字段排序。"""
@@ -112,7 +121,7 @@ def apply_document(
     path: str = typer.Option(
         ...,
         "--path",
-        help="目标 Markdown 路径；创建或唯一更新时可省略 .md，类型前缀可省略",
+        help=PATH_OPTION_HELP + "；创建或唯一更新时可省略 .md，创建时可省略类型前缀",
     ),
     document_type: str | None = typer.Option(None, "--type"),
     set_values: list[str] | None = typer.Option(None, "--set", help=SET_OPTION_HELP),
@@ -128,23 +137,25 @@ def apply_document(
     已有文档的 --type 发生变化时，同一原子操作同步文件名和引用。
     """
     values = invoke(lambda: parse_values(set_values or []))
-    emit(invoke(
-        lambda: service(ctx).apply(
-            DocumentApplyRequest(
-                path=path,
-                document_type=document_type,
-                values=values,
-                expected_hash=expected_hash,
-                confirm=confirm,
+    emit(
+        invoke(
+            lambda: service(ctx).apply(
+                DocumentApplyRequest(
+                    path=path,
+                    document_type=document_type,
+                    values=values,
+                    expected_hash=expected_hash,
+                    confirm=confirm,
+                )
             )
         )
-    ))
+    )
 
 
 @document_cli.command("move")
 def move_document(
     ctx: typer.Context,
-    source: str = typer.Option(..., "--path", help="源文档的 Workspace 相对路径"),
+    source: str = typer.Option(..., "--path", help=PATH_OPTION_HELP),
     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", help=SET_OPTION_HELP),
@@ -154,14 +165,37 @@ def move_document(
 ) -> None:
     """预览或移动一篇文档，并按目标 Domain 契约更新归属与引用。"""
     values = invoke(lambda: parse_values(set_values or []))
-    emit(invoke(
-        lambda: service(ctx).move(
-            source,
-            target_domain,
-            name=name,
-            values=values,
-            unset_fields=tuple(unset_fields or []),
-            expected_hash=expected_hash,
-            confirm=confirm,
+    emit(
+        invoke(
+            lambda: service(ctx).move(
+                source,
+                target_domain,
+                name=name,
+                values=values,
+                unset_fields=tuple(unset_fields or []),
+                expected_hash=expected_hash,
+                confirm=confirm,
+            )
+        )
+    )
+
+
+@document_cli.command("rename")
+def rename_document(
+    ctx: typer.Context,
+    source: str = typer.Option(..., "--path", help=PATH_OPTION_HELP),
+    name: str = typer.Option(..., "--name", help="新标题；不含类型前缀和 .md 后缀"),
+    expected_hash: str | None = typer.Option(None, "--expected-hash"),
+    confirm: bool = typer.Option(False, "--confirm"),
+) -> None:
+    """预览或原地改名一篇文档，并同步标题、文件名与受管引用。"""
+    emit(
+        invoke(
+            lambda: service(ctx).rename(
+                source,
+                name,
+                expected_hash=expected_hash,
+                confirm=confirm,
+            )
         )
-    ))
+    )

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/src/campfire_cli/app/document/schema/document_schema.py

@@ -34,7 +34,7 @@ class DocumentApplyResult(BaseModel):
 
 
 class DocumentMoveResult(BaseModel):
-    status: Literal["ready", "needs-input", "blocked", "moved"]
+    status: Literal["ready", "needs-input", "blocked", "moved", "renamed", "up-to-date"]
     workspace_id: str
     source: str
     target: str

{campfire_cli-0.1.16 → campfire_cli-0.1.18}/src/campfire_cli/app/document/service/document_apply_service.py

@@ -97,9 +97,13 @@ class DocumentApplyService:
             else source
         )
         target_name = target.relative_to(self._settings.vault_root).as_posix()
-        context = None if is_system_scope_path(
-            self._settings.vault_root, target, self._settings.document_types
-        ) else self._domain_context(target)
+        context = (
+            None
+            if is_system_scope_path(
+                self._settings.vault_root, target, self._settings.document_types
+            )
+            else self._domain_context(target)
+        )
         relative_target = target.relative_to(self._settings.vault_root).as_posix()
         if document_type == "human-request" and not relative_target.startswith(
             f"{self._settings.governance['human_request_root']}/"
@@ -131,40 +135,22 @@ class DocumentApplyService:
                 frontmatter.pop(field, None)
         actual_hash = file_sha256(source) if exists else "missing"
         unknown = sorted(set(request.values) - set(profile.allowed))
-        if unknown:
-            return self._result(
-                request,
-                target_name,
-                action,
-                profile.name,
-                actual_hash,
-                "blocked",
-                [
-                    {
-                        "code": "frontmatter-field-not-allowed",
-                        "path": request.path,
-                        "field": key,
-                    }
-                    for key in unknown
-                ],
-            )
-
+        candidates = workspace_candidate_sets(self._settings.vault_root)
         values, input_issues = decode_patch_values(
             profile,
-            request.values,
+            {key: value for key, value in request.values.items() if key in profile.allowed},
             request.path,
-            workspace_candidate_sets(self._settings.vault_root),
+            candidates,
         )
-        if input_issues:
-            return self._result(
-                request,
-                target_name,
-                action,
-                profile.name,
-                actual_hash,
-                "blocked",
-                input_issues,
-            )
+        input_issues[:0] = [
+            {
+                "code": "frontmatter-field-not-allowed",
+                "path": request.path,
+                "field": key,
+                "allowed": list(profile.allowed),
+            }
+            for key in unknown
+        ]
         # Field semantics are fully declared by the selected Profile; no type-specific injection.
         frontmatter.update(values)
         frontmatter["type"] = document_type
@@ -195,12 +181,22 @@ class DocumentApplyService:
         else:
             rendered = render_document(frontmatter, next_body, list(profile.field_order))
         issues = self._rules.check_content(self._settings.vault_root, target, rendered, profile)
+        # Rejected assignments already have a precise diagnostic; their fallback values
+        # must not produce contradictory missing-field or value errors.
+        invalid_fields = {item["field"] for item in input_issues}
+        issues = input_issues + [item for item in issues if item.get("field") not in invalid_fields]
         if target != source and target.exists():
             issues.insert(0, {"code": "target-exists", "path": target_name})
-        enrich_profile_issues(issues, profile, workspace_candidate_sets(self._settings.vault_root))
+        enrich_profile_issues(issues, profile, candidates)
         missing_codes = {"frontmatter-field-missing", "frontmatter-field-empty"}
         missing = [item for item in issues if item["code"] in missing_codes]
-        status = "needs-input" if missing else "blocked" if issues else "planned"
+        status = (
+            "blocked"
+            if any(item["code"] not in missing_codes for item in issues)
+            else "needs-input"
+            if missing
+            else "planned"
+        )
         result = self._result(
             request,
             target_name,
@@ -354,4 +350,17 @@ class DocumentApplyService:
                 self._settings.governance.get("domain_marker", "_领域.md"),
             )
         except DomainContextError as exc:
-            raise exc
+            if exc.code == "domain-missing":
+                exc.details.update(
+                    resolved_path=str(path),
+                    path_base="workspace",
+                    workspace_root=str(self._settings.vault_root),
+                    hint=(
+                        "相对路径以 Workspace 根目录为基准，而不是 cwd；请先选择已声明的 Domain。"
+                    ),
+                    next_action={
+                        "command": "workspace domain list",
+                        "arguments": {"workspace": self._settings.workspace_id},
+                    },
+                )
+            raise