campfire-cli 0.1.22__tar.gz → 0.1.23__tar.gz

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/ARCHITECTURE.md

@@ -40,7 +40,7 @@ Campfire 当前不负责 Agent 调度、实时消息推送或替代 Jira/Notion
   Schema + 命名 + 生命周期 + 计划/审批/执行 + 链接 + 归档 + 审计
 ```
 
-Domain 由声明而不是目录名称决定；`任务/`、`记录/` 可按需要成为 Domain，但 task、record 类型不强制绑定同名目录。真正的系统保留目录由 CLI 管理，不能伪装为 Domain。
+Domain 由声明而不是目录名称决定；`任务/`、`记录/`、`assets/` 等普通目录可按需要成为 Domain，但文档类型不强制绑定同名目录。以下划线开头的 `_xxx/` 统一表示治理基础设施，不能声明为 Space 或 Domain；CLI 派生目录使用 `_generated/`，Base 使用 `_治理视图/`。归档是 `document_status=archived`，不对应特殊物理目录。
 
 Task Channel 借鉴 Go 的原则：**Do not communicate by sharing memory; instead, share memory by communicating.** 多个参与者不依赖各自会话中的隐式记忆，而是通过明确的任务状态与事件共享上下文。它是持久异步 Channel，不承诺实时唤醒；外部 Agent 运行时可在其上增加通知和调度。
 

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/COMMAND.md

@@ -42,7 +42,7 @@ campfire base list / show / check / sync
 
 Space、Domain、Project 的 `create`/`adopt`，以及文档移动和重构写操作默认先预览；审查通过后才追加 `--confirm`。归档通过 `document apply --set document_status=archived` 修改，且必须先获得用户明确同意。已注册 Workspace 只通过根级 `campfire --workspace <id> ...` 选择；已声明 Space、Domain 和 Project 使用稳定 ID，CLI 自行推导路径和父子关系。路径参数只用于新位置、具体文件、外部输入和显式扫描范围。
 
-`任务/`、`记录/` 不是系统保留目录，可按组织需要使用 `workspace domain create` 新建或 `workspace domain adopt` 接管；文档类型不强制对应同名 Domain。`_总览`、`generated` 等系统目录仍不能声明为 Domain，错误结果返回命中的 `reserved_directory` 和修复提示。
+目录名以 `_` 开头时表示系统治理区域，不能声明为 Space 或 Domain；错误结果返回命中的 `reserved_directory` 和修复提示。其他目录名默认没有隐藏保留语义，`任务/`、`记录/`、`assets/`、`archive/`、`generated/` 均可按需 create/adopt 为 Domain。文档类型不强制对应同名 Domain，归档只通过 `document_status=archived` 表达；CLI 关系页写入 `_generated/`，Base 写入 `_治理视图/`。
 
 `document apply` 可新建、更新、为已有正文补齐 Frontmatter，或通过显式 `--type` 原子转换文档类型。新建文档在 Frontmatter 后包含唯一的 `<!-- CAMPFIRE:BODY -->`，调用方只在锚点后编辑正文；存量文档不强制迁移。创建或唯一更新时可省略 `.md`；创建和类型转换时还可省略类型前缀。CLI 在 `normalization` 中返回每项标准化，并在 `target` 中返回最终路径；调用方不手工同步类型、前缀与 Markdown 后缀。`document move` 可在任意已声明 Domain 之间移动单篇文档，并对齐目标 Profile 与可确定引用。目标 Profile 缺少语义字段时返回 `missing_fields`，调用方补齐明确业务值。只有实际写入成功的结果才可返回零或一个、且可直接执行的 scoped `maintenance sync` follow-up；Domain 内部路径会归一化为对应 Domain，预览、阻塞或无派生影响时返回空列表。具体参数以对应命令的 `-h` 为准。
 

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: campfire-cli
-Version: 0.1.22
+Version: 0.1.23
 Summary: Local-first shared context and governance CLI for humans and agents
 License-Expression: MIT
 License-File: LICENSE
@@ -99,7 +99,7 @@ campfire document list                           # 精确枚举和筛选受管
 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 治理视图
+campfire base list / show / check / sync          # Obsidian Base `_治理视图/`
 ```
 
 通用模板集中在 Workspace 根目录 `_模板/`，方便人类查看维护；模板使用 `template` 类型和基础属性。正文顶部说明适用类型和裁剪规则，Agent 按需参考，不强制套用；更新已有文档优先保留合理结构。局部模板只在用户或领域规则明确指定时使用，不逐层查找或自动覆盖。模板不替代 Profile，也不校验正文。

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/README.md

@@ -83,7 +83,7 @@ campfire document list                           # 精确枚举和筛选受管
 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 治理视图
+campfire base list / show / check / sync          # Obsidian Base `_治理视图/`
 ```
 
 通用模板集中在 Workspace 根目录 `_模板/`，方便人类查看维护；模板使用 `template` 类型和基础属性。正文顶部说明适用类型和裁剪规则，Agent 按需参考，不强制套用；更新已有文档优先保留合理结构。局部模板只在用户或领域规则明确指定时使用，不逐层查找或自动覆盖。模板不替代 Profile，也不校验正文。

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/pyproject.toml

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

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/__init__.py

@@ -1,3 +1,3 @@
 """Campfire CLI package."""
 
-__version__ = "0.1.22"
+__version__ = "0.1.23"

campfire_cli-0.1.23/src/campfire_cli/app/base/SPEC.md

@@ -0,0 +1,3 @@
+# Base App SPEC
+
+管理包内 SSOT Obsidian Base 与 Vault `_治理视图/` 的确定性同步。只管理配置声明的 Base，不修改 Markdown，不删除未知或孤立 Base。

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/app/base/service/base_service.py

@@ -127,7 +127,7 @@ class BaseService:
         return self._repository.source_root()
 
     def _target_root(self) -> Path:
-        return self._settings.vault_root / self._settings.bases.get("target", "治理视图")
+        return self._settings.vault_root / self._settings.bases.get("target", "_治理视图")
 
     def _managed_names(self) -> list[str]:
         return list(config_section("bases").get("managed_bases", []))

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/app/document/service/document_scanner.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from collections.abc import Iterable
-from pathlib import Path
+from pathlib import Path, PurePosixPath
 from typing import Any
 
 from campfire_cli.common.documents.document_types import safe_path
@@ -24,13 +24,25 @@ def is_system_scope_path(root: Path, path: Path, config: dict[str, Any]) -> bool
     )
 
 
+def ignored_directory(name: str, config: dict[str, Any]) -> bool:
+    """Return whether a directory is outside managed document scopes."""
+    managed_system_directories = {
+        part
+        for raw_root in config.get("scope_roots", [])
+        for part in PurePosixPath(raw_root).parts
+        if part.startswith("_")
+    }
+    return name.startswith(".") or (
+        name.startswith("_") and name not in managed_system_directories
+    )
+
+
 def iter_documents(
     root: Path,
     config: dict[str, Any],
     roots: Iterable[Path] | None = None,
 ) -> list[Path]:
     root = root.resolve()
-    ignored = set(config.get("ignored_directories", []))
     documents: set[Path] = set()
     space_marker = config.get("space_marker", "_空间.md")
     if roots is not None:
@@ -50,8 +62,10 @@ def iter_documents(
         if not scope.exists():
             continue
         for path in scope.rglob("*.md"):
-            relative = path.relative_to(root)
-            if exempt_document(path, config) or any(part in ignored for part in relative.parts):
+            scoped_parts = path.relative_to(scope).parts[:-1]
+            if exempt_document(path, config) or any(
+                ignored_directory(part, config) for part in scoped_parts
+            ):
                 continue
             if not path.is_file() or any(
                 part.is_symlink() for part in (path, *path.parents) if part != root

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/app/document/service/mutation/document_move_service.py

@@ -365,8 +365,4 @@ class DocumentMoveService:
 
     def _is_reserved_target(self, context: DomainContext, target: Path) -> bool:
         relative = target.parent.relative_to(context.root)
-        reserved = {
-            *self._settings.document_types.get("ignored_directories", []),
-            *self._settings.governance.get("project_reserved_directories", []),
-        }
-        return any(part in reserved or part.startswith(".") for part in relative.parts)
+        return any(part.startswith(("_", ".")) for part in relative.parts)

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/app/maintenance/service/maintenance_service.py

@@ -259,7 +259,7 @@ class MaintenanceService:
                 relation_page = None
                 if notes:
                     relations = {note: all_relations[note] for note in notes}
-                    relation_page = domain.path / "generated" / f"相关文档-{domain.name}.md"
+                    relation_page = domain.path / "_generated" / f"相关文档-{domain.name}.md"
                     relation_content = governance_sync.relation_markdown(domain, notes, relations)
                     existing = (
                         relation_page.read_text(encoding="utf-8") if relation_page.is_file() else ""

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/app/workspace/SPEC.md

@@ -10,7 +10,7 @@
 
 `workspace space/domain create` 只创建不存在的新目录；`space adopt` 原地纳管已有 Space，`domain adopt` 可原地声明或把一个 Vault 内外已有目录接管到明确目标。Domain 所属 Space 和最近父 Domain 从目标路径唯一推导；Project 从 Manifest 绑定的根 Domain id 与祖先拓扑推导，Domain 声明不保存 Project。外部来源始终保留。命令默认只输出计划，追加 `--confirm` 才写入。
 
-目录名称不决定文档类型或强制归属。`任务/`、`记录/` 可按组织需要创建或接管为 Domain，但不要求每个 Project 预建，也不强制 task、record 文档进入同名 Domain。系统保留目录不能声明为 Space/Domain；拒绝结果必须返回命中的目录名和修复提示。非保留目录直接包含文档或子 Domain 时必须有 `_领域.md`，否则报告 `undeclared-domain-directory`。
+目录名称不决定文档类型或强制归属。以下划线开头的 `_xxx/` 是系统治理目录，不能声明为 Space/Domain；拒绝结果必须返回命中的目录名和修复提示。其他名称没有隐藏保留名单，`任务/`、`记录/`、`assets/`、`archive/`、`generated/` 均可按组织需要创建或接管为 Domain。非系统目录直接包含文档或子 Domain 时必须有 `_领域.md`，否则报告 `undeclared-domain-directory`。归档只由文档状态表达，不要求物理 `archive/`。
 
 `workspace config check` 统一校验包内产品默认值和当前 Workspace 的有效治理契约，包括目录与 Space 冲突、文档类型前缀、Profile 引用和继承、归档策略以及托管资源列表。
 
@@ -20,7 +20,7 @@ Adoption、文档批量 Restructure 与 Domain Restructure 均使用共享 Chang
 
 `domain rename --name` 只改显示名称；`--folder-name` 只改原父级下目录名称，可显式同时提供。目录改名使用共享计划摘要，确认必须提供 `--expected-plan`，保护附件、声明和受管引用；Domain id、子领域身份与 Project 绑定不变。大小写不敏感文件系统的纯大小写改名明确阻止，提示先预览中间名迁移，不静默覆盖。不承诺断电原子性，回滚失败报告需要人工核对的路径。
 
-Space 是 Workspace 根下以 `_空间.md` 声明的顶级内容容器；Domain 位于 Space 内，以 `_领域.md` 声明并可任意嵌套。子 Domain 必须处于父 Domain 路径下、属于同一 Space 并继承 governance。`_收件箱`、`_待用户确认` 与 `治理视图` 是系统区域，不是 Space；其中 `_待用户确认/` 是受管文档范围，但没有虚构的 Domain 或 Project。Maintenance 只消费本模块发现的结构，不维护第二套领域规则。
+Space 是 Workspace 根下以 `_空间.md` 声明的顶级内容容器；Domain 位于 Space 内，以 `_领域.md` 声明并可任意嵌套。子 Domain 必须处于父 Domain 路径下、属于同一 Space 并继承 governance。`_收件箱`、`_待用户确认` 与 `_治理视图` 是系统区域，不是 Space；其中 `_待用户确认/` 是受管文档范围，但没有虚构的 Domain 或 Project。Maintenance 只消费本模块发现的结构，不维护第二套领域规则。
 
 Space 与 Domain 声明 Frontmatter 只由本模块解释、格式化和修改；Document App 对其返回 `not-applicable`。`workspace space/domain format` 只规范化 Frontmatter 并逐字节保留 Markdown 正文。声明文件中 `AUTO-GENERATED` 标记区域由 CLI 独占，标记外正文允许人和 Agent 编辑。`workspace space check --space <id>` 支持对单个 Space 做局部复检。
 

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/app/workspace/service/restructure_service.py

@@ -8,6 +8,7 @@ from uuid import uuid4
 import yaml
 
 from campfire_cli.app.base.schema.operation_schema import maintenance_sync_follow_up
+from campfire_cli.app.document.service.document_scanner import ignored_directory
 from campfire_cli.app.document.service.rules.document_rule_service import DocumentRuleService
 from campfire_cli.app.document.service.rules.profile_candidates import workspace_candidate_sets
 from campfire_cli.app.workspace.schema.restructure_schema import (
@@ -424,15 +425,14 @@ class RestructureService:
         )
 
     def _inventory_documents(self, root: Path) -> list[Path]:
-        ignored = set(self._settings.document_types.get("ignored_directories", []))
-        ignored.update({".git", ".obsidian", ".campfire"})
         exempt = set(self._settings.document_types.get("exempt_basenames", []))
         return sorted(
             path
             for path in root.rglob("*.md")
             if path.name not in exempt
             and not any(
-                part in ignored for part in path.relative_to(self._settings.vault_root).parts[:-1]
+                ignored_directory(part, self._settings.document_types)
+                for part in path.relative_to(root).parts[:-1]
             )
         )
 

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/app/workspace/service/structure_service.py

@@ -24,7 +24,6 @@ from campfire_cli.common.documents.domain_context import (
 from campfire_cli.common.documents.frontmatter_format import format_text
 from campfire_cli.common.exceptions import ConfigurationError
 from campfire_cli.common.filesystem import atomic_write, workspace_write_lock
-from campfire_cli.config.defaults import config_section
 
 SPACE_MARKER = "_空间.md"
 DOMAIN_MARKER = "_领域.md"
@@ -34,19 +33,15 @@ DECLARATION_MANAGED_COMMENT = (
 ID_RE = re.compile(r"[a-z0-9][a-z0-9-]{0,62}")
 
 
-def reserved_directories() -> set[str]:
-    return set(config_section("workspace")["reserved_directories"])
-
-
 def validate_domain_path_parts(parts: tuple[str, ...], path: str) -> None:
-    reserved = next((part for part in parts if part in reserved_directories()), None)
+    reserved = next((part for part in parts if part.startswith("_")), None)
     if reserved is not None:
         raise ConfigurationError(
             f"Domain 路径命中系统保留目录：{reserved}",
             code="reserved-directory",
             path=path,
             reserved_directory=reserved,
-            hint="该名称保留给系统区域或非 Domain 内容；请选择其他 Domain 路径。",
+            hint="下划线开头的目录用于系统治理；请选择不以 _ 开头的 Domain 路径。",
         )
     hidden = next((part for part in parts if part.startswith(".")), None)
     if hidden is not None:
@@ -198,7 +193,7 @@ class SpaceService:
         if (
             relative.is_absolute()
             or len(relative.parts) != 1
-            or relative.name in reserved_directories()
+            or relative.name.startswith(("_", "."))
         ):
             raise ConfigurationError("Space path 必须是 Workspace 根下的单层非保留目录")
         target = self.root / relative
@@ -283,7 +278,7 @@ class DomainService:
                 if not directory.is_dir() or directory == space_root:
                     continue
                 parts = directory.relative_to(space_root).parts
-                if any(part in reserved_directories() or part.startswith(".") for part in parts):
+                if any(part.startswith(("_", ".")) for part in parts):
                     continue
                 direct_notes = [
                     item for item in directory.glob("*.md") if item.name != DOMAIN_MARKER
@@ -302,7 +297,7 @@ class DomainService:
                     )
             for marker in sorted(space_root.rglob(DOMAIN_MARKER)):
                 if any(
-                    part in reserved_directories()
+                    part.startswith(("_", "."))
                     for part in marker.relative_to(space_root).parts[:-1]
                 ):
                     continue

campfire_cli-0.1.23/src/campfire_cli/resources/bases/SPEC.md

@@ -0,0 +1,3 @@
+# Base Resources SPEC
+
+本目录是标准 Obsidian Base 的唯一事实来源。Vault `_治理视图/` 中同名文件由 `campfire base sync` 生成；个性化视图应使用其他文件名。

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/resources/defaults/config.yml

@@ -1,12 +1,12 @@
-version: 1
+version: 2
 workspace:
-  version: 1
+  version: 2
   system_directories:
   - _收件箱/用户输入
   - _收件箱/待接管
   - _待用户确认
   - _模板
-  - 治理视图
+  - _治理视图
   spaces:
   - id: knowledge
     name: 知识
@@ -28,43 +28,19 @@ workspace:
     name: 创作
     path: myblog
     type: content
-  reserved_directories:
-  - _收件箱
-  - _待用户确认
-  - _协作
-  - 治理视图
-  - assets
-  - archive
-  - generated
-  - _总览
-  - _模板
-  - a_skill
 governance:
-  version: 1
+  version: 2
   inbox: _收件箱
   human_request_root: _待用户确认
   collaboration_root: _协作
   space_marker: _空间.md
   domain_marker: _领域.md
-  ignored_directories:
-  - assets
-  - archive
-  - generated
-  project_reserved_directories:
-  - archive
-  - _总览
-  - _模板
-  - a_skill
 document_types:
-  version: 2
+  version: 3
   space_marker: _空间.md
   scope_roots:
   - _待用户确认
   - _模板
-  ignored_directories:
-  - assets
-  - generated
-  - a_skill
   exempt_basenames:
   - _领域.md
   - _空间.md
@@ -287,8 +263,8 @@ skills:
   unknown_skill_policy: ignore
   orphaned_skill_policy: report
 bases:
-  version: 1
-  target: 治理视图
+  version: 2
+  target: _治理视图
   managed_bases:
   - 文档工作台.base
   - 任务工作台-项目.base

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/SKILL.md

@@ -42,7 +42,7 @@ description: "持续维护 Campfire Workspace 的结构与文档合规；适用
 
 1. 选择最窄的操作范围。诊断用对应 check；新建 Space/Domain 用 create，已有目录接管用 adopt；不要手写声明。
 2. 修改文档结构时只查询尚未知的 Profile；apply 负责结构，正文由 Edit 维护。新建后用返回的 target 在 `<!-- CAMPFIRE:BODY -->` 后补正文，不手工同步类型前缀。
-3. `任务/`、`记录/` 可按组织需要声明为 Domain，但文档类型不强制决定目录。新目录使用 create，已有目录使用 adopt；系统保留目录按错误结果中的命中名称和提示处理。
+3. `_xxx/` 统一表示系统治理目录，不能声明为 Domain；其他目录名没有隐藏保留语义。新 Domain 使用 create，已有内容目录使用 adopt，文档类型不强制决定目录；归档只更新 `document_status`，不创建或移动到 `archive/`。
 4. 只改标题用 rename，跨 Domain 用 move；确认带上预览返回的 `--expected-hash` 和 `--expected-plan`。批量语义迁移使用重构流程，不逐文件绕过计划。
 5. 声明顺序异常时使用诊断返回的 format 修复入口，不把 formatter 列为日常必经步骤。声明标记外的人工正文可直接编辑。
 6. sync 自身直接写入派生物；用户要求预览时才使用 --dry-run，不传不存在的 --confirm。使用实际 follow_up 的 scope 或用户明确的治理范围，不无条件扩大全库。

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/src/campfire_cli/resources/skills/campfire-workspace-onboarding/references//346/240/207/345/207/206/345/267/245/344/275/234/345/214/272/347/273/223/346/236/204.md

@@ -14,7 +14,7 @@
 │   ├── README.md
 │   ├── 模板-任务.md
 │   └── 模板-版本发布清单.md
-├── 治理视图/                 # CLI 管理的 Base
+├── _治理视图/                # CLI 管理的 Base
 ├── mynote/                   # 知识
 ├── mywork/                   # 工作
 ├── mylog/                    # 日志
@@ -34,7 +34,7 @@ campfire workspace create --id <workspace-id> --path <path>
 
 ## Base 演示
 
-创建后，`治理视图/` 由 `campfire base sync` 维护以下开箱即用的 Obsidian Base：
+创建后，`_治理视图/` 由 `campfire base sync` 维护以下开箱即用的 Obsidian Base：
 
 - `文档工作台.base`：按类型查看当前文档、草稿和当前计划。
 - `任务工作台-项目.base`：按 `related_project` 查看项目任务和阻塞任务。

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/tests/integration/test_cli.py

@@ -164,7 +164,7 @@ def test_first_time_workspace_create_and_existing_directory_setup(tmp_path: Path
     assert create_payload["resources"]["bases"]["status"] == "synced"
     assert create_payload["resources"]["skills"]["status"] == "synced"
     assert (created / ".campfire.yaml").is_file()
-    assert (created / "治理视图" / "文档工作台.base").is_file()
+    assert (created / "_治理视图" / "文档工作台.base").is_file()
     assert {
         "mynote",
         "mywork",

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/tests/integration/test_domain_rename_sync.py

@@ -55,6 +55,8 @@ def domain_tree(workspace: Path) -> AppContainer:
             handle.write("\n未提交的人工正文 [[mynote/金融/子领域/知识-说明.md]]\n")
     (workspace / "mynote/金融/附件.bin").write_bytes(b"\x00\xffasset")
     assert container.maintenance.sync(scope="mynote").status == "synced"
+    assert (workspace / "mynote/金融/子领域/_generated/相关文档-child.md").is_file()
+    assert not list((workspace / "mynote").rglob("generated"))
     return container
 
 

campfire_cli-0.1.23/tests/unit/test_document_scanner.py

@@ -0,0 +1,33 @@
+from pathlib import Path
+
+from campfire_cli.app.document.service.document_scanner import iter_documents
+from campfire_cli.config.defaults import config_section
+
+
+def test_scanner_only_skips_prefixed_directories_inside_a_scope(workspace: Path) -> None:
+    domain = workspace / "mywork/Example"
+    domain.mkdir()
+    ordinary = [domain / name / f"记录-{name}.md" for name in ("assets", "archive", "generated")]
+    for path in ordinary:
+        path.parent.mkdir()
+        path.write_text("普通内容。\n", encoding="utf-8")
+    system_note = domain / "_generated/相关文档-Example.md"
+    system_note.parent.mkdir()
+    system_note.write_text("派生内容。\n", encoding="utf-8")
+
+    scanned = iter_documents(workspace, config_section("document_types"), roots=[domain])
+
+    assert set(scanned) == set(ordinary)
+
+
+def test_scanner_allows_an_explicit_underscored_scope_root(workspace: Path) -> None:
+    request = workspace / "_待用户确认/请求-确认.md"
+    request.write_text("待确认。\n", encoding="utf-8")
+
+    scanned = iter_documents(
+        workspace,
+        config_section("document_types"),
+        roots=[workspace / "_待用户确认"],
+    )
+
+    assert scanned == [request]

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/tests/unit/test_domain_paths.py

@@ -45,7 +45,8 @@ def test_task_and_record_directories_can_be_domains(workspace: Path) -> None:
 
 
 @pytest.mark.parametrize(
-    "path, reserved", [("mywork/generated/子领域", "generated"), ("mywork/_总览", "_总览")]
+    "path, reserved",
+    [("mywork/_generated/子领域", "_generated"), ("mywork/_任意系统区", "_任意系统区")],
 )
 def test_reserved_domain_path_reports_the_matching_directory(
     workspace: Path, path: str, reserved: str
@@ -66,3 +67,19 @@ def test_reserved_domain_path_reports_the_matching_directory(
     assert payload["path"] == path
     assert payload["reserved_directory"] == reserved
     assert payload["hint"]
+
+
+@pytest.mark.parametrize("name", ["assets", "archive", "generated", "a_skill"])
+def test_plain_directory_names_can_be_domains(workspace: Path, name: str) -> None:
+    created = DomainService(workspace, campfire_home()).create(
+        domain_id=name.replace("_", "-"),
+        name=name,
+        path=f"mywork/{name}",
+        domain_type="work-domain",
+        governance="work-docs",
+        project_id=None,
+        confirm=True,
+    )
+
+    assert created.status == "created"
+    assert (workspace / f"mywork/{name}/_领域.md").is_file()

{campfire_cli-0.1.22 → campfire_cli-0.1.23}/uv.lock

@@ -36,7 +36,7 @@ wheels = [
 
 [[package]]
 name = "campfire-cli"
-version = "0.1.22"
+version = "0.1.23"
 source = { editable = "." }
 dependencies = [
     { name = "alembic" },

campfire_cli-0.1.22/src/campfire_cli/app/base/SPEC.md

@@ -1,3 +0,0 @@
-# Base App SPEC
-
-管理包内 SSOT Obsidian Base 与 Vault `治理视图/` 的确定性同步。只管理配置声明的 Base，不修改 Markdown，不删除未知或孤立 Base。

campfire_cli-0.1.22/src/campfire_cli/resources/bases/SPEC.md

@@ -1,3 +0,0 @@
-# Base Resources SPEC
-
-本目录是标准 Obsidian Base 的唯一事实来源。Vault `治理视图/` 中同名文件由 `campfire base sync` 生成；个性化视图应使用其他文件名。