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

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

@@ -40,7 +40,7 @@ Campfire 当前不负责 Agent 调度、实时消息推送或替代 Jira/Notion
   Schema + 命名 + 生命周期 + 计划/审批/执行 + 链接 + 归档 + 审计
 ```
 
-Domain 由声明而不是目录名称决定；`任务/`、`记录/` 可按需要成为 Domain，但 task、record 类型不强制绑定同名目录。真正的系统保留目录由 CLI 管理，不能伪装为 Domain。
+Domain 由声明而不是目录名称决定；`任务/`、`记录/`、`assets/` 等普通目录可按需要成为 Domain，但文档类型不强制绑定同名目录。以下划线开头的 `_xxx/` 统一表示治理基础设施，不能声明为 Space 或 Domain；MOC 保留领域导航，Base 使用 `_治理视图/`；不再生成 `_generated/` 关系页。归档是 `document_status=archived`，不对应特殊物理目录。
 
 Task Channel 借鉴 Go 的原则：**Do not communicate by sharing memory; instead, share memory by communicating.** 多个参与者不依赖各自会话中的隐式记忆，而是通过明确的任务状态与事件共享上下文。它是持久异步 Channel，不承诺实时唤醒；外部 Agent 运行时可在其上增加通知和调度。
 
@@ -108,7 +108,7 @@ Campfire 不是“Markdown 版 kubectl”，而是面向人机协作场景组合
 命令副作用按下列边界分类：
 
 - **必须纳入当前事务**：不执行就会让当前意图产生破损状态的变更，例如结构迁移时的 Domain 声明、Project 归属和可移植 Manifest 对齐。
-- **必须显式返回**：可从原始事实重建的派生结果，例如 MOC、关系页、索引和治理报告；这些作为 `follow_up` 由 Skill 显式执行。
+- **必须显式返回**：可从原始事实重建的派生结果，例如 MOC 和治理报告；这些作为 `follow_up` 由 Skill 显式执行。
 - **禁止捎带**：与当前意图无关的全 Workspace 格式化、归档、结构重构或其他写操作。
 
 “一次改多个文件”不等于不原子；“一次只改一个字段”也不自动等于边界正确。评审新命令时必须逐项回答：
@@ -124,7 +124,7 @@ Campfire 不是“Markdown 版 kubectl”，而是面向人机协作场景组合
 命令设计遵循以下约束：
 
 1. **对象域优先**：公共入口采用 `campfire <object-domain> <verb>`，例如 `document apply`、`maintenance check`；动词在所属业务对象内保持单义，不为同一行为保留多个别名。
-2. **意图原子、派生显式**：`document apply` 创建或更新文档，并在显式类型变化时将类型、文件名前缀和确定性引用作为同一变更提交；`document move` 原子完成单文档跨 Domain 移动、目标 Profile 对齐和确定性引用修复。命令只在 MOC、关系页或索引可能变化时返回零或一个可直接执行的最小 scope `maintenance sync`。
+2. **意图原子、派生显式**：`document apply` 创建或更新文档，并在显式类型变化时将类型、文件名前缀和确定性引用作为同一变更提交；`document move` 原子完成单文档跨 Domain 移动、目标 Profile 对齐和确定性引用修复。命令只在 MOC 等可见派生内容可能变化时返回零或一个可直接执行的最小 scope `maintenance sync`。
 3. **契约声明式，变更显式**：Profile 是字段、类型、枚举、顺序和条件必填的 SSOT。Agent 提交业务值，CLI 解析有效 Profile 并拒绝猜测；已有文档只修改明确给出的字段或正文操作。
 4. **写入先证明安全**：写命令默认预览，显式确认后才提交；提交时在锁内复核快照或期望哈希，多文件变更作为一个 ChangeSet 执行，失败回滚，避免静默覆盖和部分写入。
 5. **人类与 Agent 共用一个契约**：命令和结果只有一套语义。JSON 状态、issues、missing fields 与 follow-up 供 Agent 稳定消费，`tree` 和分层 `-h` 供人类与 Agent 渐进发现，不维护第二套参数目录。
@@ -165,13 +165,13 @@ SQLite 中的 Workspace 与 Project 注册数据是结构化事实，文档索
 
 ### 文档查询投影
 
-文档索引保存列表查询需要的结构化字段、内容哈希、源文件 stat，以及显式 Frontmatter 关联、WikiLink、Markdown Link、Embed 形成的确定关系。它不复制正文，不保存相似度建议，也不把文件 mtime 解释为任务时间。
+文档索引保存列表查询需要的结构化字段、内容哈希、源文件 stat，以及Frontmatter `related_docs` 形成的确定关系，不解析正文 WikiLink、Markdown Link 或 Embed。它不复制正文，不保存相似度建议，也不把文件 mtime 解释为任务时间。
 
 每次 `document list` 或 `document inspect` 先对账文件清单、size、mtime、有效配置哈希和 Space/Domain 拓扑哈希。stat 只用于筛选变化候选，内容哈希才表示内容版本；新增、修改和删除会在查询前自动 reconcile。候选快照在内存中完成后，通过单个 SQLite 事务替换文档、关系和 generation，中断不能暴露半套新索引。
 
 `document list` 只做结构化精确枚举与 AND 筛选；未来正文关键词、模糊匹配、相关性排序或混合检索使用独立 `document search`。`document inspect.relations` 只返回可证明的 declared、outgoing、incoming 和 unresolved；相似文档属于未来独立 suggestions，不能混入确定关系。
 
-索引新鲜度是 CLI 内部读取保障，不生成让 Agent 手工执行的 index follow-up。MOC、关系页等 Workspace 内可见生成物仍由成功写命令按需返回 scoped `maintenance sync`。
+索引新鲜度是 CLI 内部读取保障，不生成让 Agent 手工执行的 index follow-up。MOC 等 Workspace 内可见生成物仍由成功写命令按需返回 scoped `maintenance sync`。
 
 ### 设备本地与跨设备边界
 
@@ -237,7 +237,7 @@ Human / Browser  ──> HTTP Adapter ──┘                           │
 1. 人类和 Agent 使用同一套 CLI 契约，不维护两套规则。
 2. 写操作默认先计划、再确认、再执行；执行前复核并发变更。
 3. 规则集中在配置契约和规则引擎，Skill、模板、CLI 不复制枚举定义。
-4. MOC、Base、关系和报告能生成就不手工维护。
+4. MOC、Base 和报告能生成就不手工维护；文档关系通过 CLI 查询，不再复制为关系页。
 5. 有歧义的分类和结构重构进入待确认，不由 Agent 擅自决定。
 6. Markdown 内容可脱离 Campfire 阅读和迁移；文档查询投影在 SQLite 丢失后可以重建，Decision 与未完成批次等工作流状态不作此承诺。
 7. 只有一个用户级 SQLite；所有 Workspace 业务表必须携带 `workspace_id`，Repository 查询不得越界。

{campfire_cli-0.1.22 → campfire_cli-0.1.24}/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.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: campfire-cli
-Version: 0.1.22
+Version: 0.1.24
 Summary: Local-first shared context and governance CLI for humans and agents
 License-Expression: MIT
 License-File: LICENSE
@@ -27,6 +27,12 @@ Description-Content-Type: text/markdown
 
 ## 安装
 
+### v0.1.24 变更说明
+
+`maintenance sync` 不再生成 `_generated/相关文档-*.md`，并移除 MOC 自动区域中的关系页入口；MOC 的文档导航、分组和模板入口保持不变。`related_docs` 仍为可选字段，Agent 通过 `document list` 定位文档、通过 `document inspect` 查询出向、入向及失效关联，查询不要求先同步 MOC。
+
+同步不会删除或改写历史关系页，也不会修改人工正文链接。历史清理须先核实来源和人工内容，再确认具体范围；不能按 `_generated` 或 `generated` 目录名递归删除。Base 同步策略和领域模型不在本次变更范围内。
+
 标准安装（已发布至 PyPI，无需源码仓库）：
 
 ```bash
@@ -99,7 +105,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.24}/README.md

@@ -11,6 +11,12 @@
 
 ## 安装
 
+### v0.1.24 变更说明
+
+`maintenance sync` 不再生成 `_generated/相关文档-*.md`，并移除 MOC 自动区域中的关系页入口；MOC 的文档导航、分组和模板入口保持不变。`related_docs` 仍为可选字段，Agent 通过 `document list` 定位文档、通过 `document inspect` 查询出向、入向及失效关联，查询不要求先同步 MOC。
+
+同步不会删除或改写历史关系页，也不会修改人工正文链接。历史清理须先核实来源和人工内容，再确认具体范围；不能按 `_generated` 或 `generated` 目录名递归删除。Base 同步策略和领域模型不在本次变更范围内。
+
 标准安装（已发布至 PyPI，无需源码仓库）：
 
 ```bash
@@ -83,7 +89,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.24}/SPEC.md

@@ -116,7 +116,7 @@ Campfire 使用语义化版本：
 
 ## Workspace 索引
 
-- Markdown Frontmatter 的 `related_docs` 是文档关系唯一 SSOT，采用 `[[Workspace相对路径.md]]`。不解析、索引或自动改写正文链接；历史正文保留，SQLite 和可见关系页均可从该字段重建。
+- Markdown Frontmatter 的 `related_docs` 是文档关系唯一 SSOT，采用 `[[Workspace相对路径.md]]`。不解析、索引或自动改写正文链接；历史正文保留，SQLite 关系投影可从该字段重建；不再生成 Markdown 关系页，Agent 通过 document inspect 查询关系。
 - 改名、移动与类型联动改名只定向更新 `related_docs` 引用方；预览输出 `expected_plan`，确认复核整个变更集摘要和文件哈希。文件提交后的索引失败必须报告已写入事实，并使索引可在下次查询恢复。
 
 - SQLite `spaces`、`domains`、`documents` 只允许作为可重建本机投影，不得反向覆盖 Markdown SSOT。

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

@@ -1,6 +1,6 @@
 [project]
 name = "campfire-cli"
-version = "0.1.22"
+version = "0.1.24"
 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.24}/src/campfire_cli/__init__.py

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

campfire_cli-0.1.24/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.24}/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.24}/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.24}/src/campfire_cli/app/document/service/index/document_index_service.py

@@ -123,35 +123,6 @@ class DocumentIndexService:
             "in_degree": len(incoming),
         }
 
-    def relation_views(self, sources: list[Path]) -> dict[Path, list[dict[str, Any]]]:
-        self.reconcile()
-        records = {r.path: r for r in self._repository.load_documents() if r.queryable}
-        results = {path: [] for path in sources}
-        by_name = {p.relative_to(self._settings.vault_root).as_posix(): p for p in sources}
-        for edge in self._repository.load_edges():
-            if edge.resolution != "resolved":
-                continue
-            for source, target, kind in (
-                (edge.source_path, edge.target_path, "direct-link"),
-                (edge.target_path, edge.source_path, "backlink"),
-            ):
-                if source not in by_name or target not in records:
-                    continue
-                record = records[target]
-                results[by_name[source]].append(
-                    {
-                        "target": target.removesuffix(".md"),
-                        "target_name": record.name or Path(target).stem,
-                        "target_domain": record.domain_id or "",
-                        "type": kind,
-                        "score": 1.0,
-                        "reasons": ["related_docs 显式关联"],
-                    }
-                )
-        for items in results.values():
-            items.sort(key=lambda item: (item["type"], item["target"]))
-        return results
-
     def referencing(self, relative_path: str) -> list[str]:
         self.reconcile()
         return sorted(

{campfire_cli-0.1.22 → campfire_cli-0.1.24}/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.24}/src/campfire_cli/app/maintenance/SPEC.md

@@ -8,7 +8,7 @@ Domain MOC 只列出该 Domain `_模板/` 中实际存在的模板；根目录 `
 
 受管范围由当前 Workspace 中实际存在的 `_空间.md` 动态发现，不使用固定 Space 白名单；`scope_roots` 只补充 `_待用户确认/` 等非 Space 系统范围。声明文件由 Workspace App 校验，不计入普通文档问题。
 
-`check --scope` 的 status 表示当前筛选结果，`workspace_status` 表示全 Workspace 状态。`sync --scope` 只发现并扫描 scope 内的 Domain 和文档，一次刷新 MOC、关系页并触发文档索引 reconcile；只受当前范围的结构问题阻塞。`document list/inspect` 不以 Maintenance 为前置步骤。单篇内容创建、补全和修改属于 Document App，批量迁移属于 Workspace Restructure。
+`check --scope` 的 status 表示当前筛选结果，`workspace_status` 表示全 Workspace 状态。`sync --scope` 只发现并扫描 scope 内的 Domain 和文档，刷新 MOC 并触发文档索引 reconcile；只受当前范围的结构问题阻塞。`document list/inspect` 不以 Maintenance 为前置步骤。单篇内容创建、补全和修改属于 Document App，批量迁移属于 Workspace Restructure。
 
 ```text
 maintenance/
@@ -20,4 +20,4 @@ maintenance/
 归档仅是 Document Profile 中的 `document_status` 值，通过 `document apply` 修改；Maintenance 不提供归档命令。
 
 scoped sync 在全局拓扑中检查目标身份是否重复，再按稳定 Domain id 和当前 scope 更新结构投影；合法外部改名不依赖先 check。文档索引先独立提交完整 generation，再在文件变更事务内提交领域索引；领域索引提交失败回滚其事务并补偿生成文件，不在领域提交之后追加可能失败的文档索引提交。两个投影可分别重建，不宣称文件系统与 SQLite 共享事务。可捕获失败返回阶段与实际写入状态，补偿失败须停止并核对文件，不盲目重放。
-关系页只消费 Document Index 的 `related_docs` 正向和反向投影；不另行解析正文链接、不计算标签或文本相似度。正文不再作为关系 SSOT，旧正文不自动迁移。
+Maintenance 不再生成关系页，也不读取关系展示投影；MOC 保留导航、文档分组与模板入口，移除自动关系入口。related_docs 与正反向查询仍由 Document App 管理。sync 不删除或改写历史关系页及自定义文件；历史清理须独立盘点和确认，不按目录名递归删除，不改写人工正文链接。

{campfire_cli-0.1.22 → campfire_cli-0.1.24}/src/campfire_cli/app/maintenance/service/maintenance_protocol.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
-from pathlib import Path
-from typing import Any, Protocol
+from typing import Protocol
 
 from campfire_cli.app.document.schema import DocumentIndexResult
 from campfire_cli.app.maintenance.schema.maintenance_schema import (
@@ -15,8 +14,6 @@ from campfire_cli.app.maintenance.schema.maintenance_schema import (
 class DocumentIndexMaintainerProtocol(Protocol):
     """Expose only the index maintenance operations needed by Maintenance."""
 
-    def relation_views(self, sources: list[Path]) -> dict[Path, list[dict[str, Any]]]: ...
-
     def rebuild(self) -> DocumentIndexResult: ...
 
     def reconcile(self) -> DocumentIndexResult: ...

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

@@ -226,22 +226,8 @@ class MaintenanceService:
         templates_by_domain = {
             domain.id: governance_sync.direct_templates(domain) for domain in domains
         }
-        project_domain_ids = {
-            domain.id for domain in domains if domain.governance == "project-docs"
-        }
-        domain_by_note = {
-            note: domain_id
-            for domain_id, notes in notes_by_domain.items()
-            for note in notes
-            if domain_id not in project_domain_ids
-        }
-        all_notes = sorted(
-            domain_by_note,
-            key=lambda path: str(path.relative_to(self._settings.vault_root)).casefold(),
-        )
         try:
             indexed_document_count = self._document_index.reconcile().document_count
-            all_relations = self._document_index.relation_views(all_notes)
         except AppError as exc:
             return self._sync_failure(exc, "document-index", scope)
         for domain in sorted(domains, key=lambda item: item.id):
@@ -256,21 +242,8 @@ class MaintenanceService:
                     marker_name,
                 )
             else:
-                relation_page = None
-                if notes:
-                    relations = {note: all_relations[note] for note in notes}
-                    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 ""
-                    )
-                    generated_snapshot[
-                        relation_page.relative_to(self._settings.vault_root).as_posix()
-                    ] = file_sha256(relation_page) if relation_page.is_file() else None
-                    if existing != relation_content:
-                        changes.append((relation_page, relation_content))
                 generated = governance_sync.generate_domain_content(
-                    domain, domains, notes, templates_by_domain[domain.id], relation_page
+                    domain, domains, notes, templates_by_domain[domain.id]
                 )
             moc = domain.path / f"{domain.moc}.md"
             if not moc.is_file():

{campfire_cli-0.1.22 → campfire_cli-0.1.24}/src/campfire_cli/app/maintenance/service/moc_service.py

@@ -1,12 +1,12 @@
 """
 SPEC:
   name: moc_service
-  purpose: 幂等生成领域 MOC 自动区域、相关文档页面、索引缓存和治理报告
+  purpose: 幂等生成领域 MOC 自动区域
   default_env_file: none
   env_override: none
   idempotent: true
   behavior:
-    - 从领域声明、文档属性及受管关系索引生成派生内容
+    - 从领域声明和文档属性生成目录内容
     - 内容未变化时不重写文件
     - 支持 dry-run 和 JSON 输出
   safety:
@@ -19,7 +19,6 @@ SPEC:
 from __future__ import annotations
 
 import os
-import re
 from pathlib import Path
 from typing import Any
 
@@ -31,15 +30,6 @@ START_MARKER = "<!-- AUTO-GENERATED:DOMAIN-INDEX:START -->"
 END_MARKER = "<!-- AUTO-GENERATED:DOMAIN-INDEX:END -->"
 
 
-def note_title(path: Path) -> str:
-    return title_from_text(path.read_text(encoding="utf-8"), path.stem)
-
-
-def title_from_text(text: str, fallback: str) -> str:
-    match = re.search(r"^#\s+(.+)$", text, re.MULTILINE)
-    return match.group(1).strip() if match else fallback
-
-
 def direct_notes(domain: Domain, marker_name: str) -> list[Path]:
     excluded = {marker_name, f"{domain.moc}.md"}
     return sorted(
@@ -78,24 +68,11 @@ def replace_generated_region(original: str, generated: str) -> str:
     return original[:start] + "\n\n" + generated.rstrip() + "\n\n" + original[end:]
 
 
-def write_if_changed(
-    path: Path, content: str, dry_run: bool, changes: list[str], vault_root: Path
-) -> None:
-    previous = path.read_text(encoding="utf-8") if path.exists() else None
-    if previous == content:
-        return
-    changes.append(str(path.relative_to(vault_root)))
-    if not dry_run:
-        path.parent.mkdir(parents=True, exist_ok=True)
-        path.write_text(content, encoding="utf-8")
-
-
 def generate_domain_content(
     domain: Domain,
     domains: list[Domain],
     notes: list[Path],
     templates: list[Path],
-    relation_page: Path | None,
 ) -> str:
     children = sorted(
         [item for item in domains if item.parent_domain == domain.id],
@@ -109,8 +86,6 @@ def generate_domain_content(
     lines.extend(["", "## 本领域文档", ""])
     lines.extend([f"- [[{note.stem}]]" for note in notes] or ["- 暂无"])
     append_template_section(lines, domain, templates)
-    lines.extend(["", "## 自动关系", ""])
-    lines.append(f"- [[{relation_page.stem}|相关文档计算结果]]" if relation_page else "- 暂无")
     return "\n".join(lines)
 
 
@@ -168,27 +143,3 @@ def generate_project_domain_content(
     append_template_section(lines, domain, templates)
     lines.append("")
     return "\n".join(lines).rstrip()
-
-
-def relation_markdown(
-    domain: Domain, notes: list[Path], relations: dict[Path, list[dict[str, Any]]]
-) -> str:
-    lines = [
-        f"# {domain.name}相关文档",
-        "",
-        "> 本页由 `campfire maintenance sync` 自动生成，请勿手工编辑。",
-        "",
-    ]
-    for note in notes:
-        lines.extend([f"## [[{note.stem}]]", ""])
-        items = relations.get(note, [])
-        if not items:
-            lines.extend(["- 暂无 related_docs 关联", ""])
-            continue
-        for item in items:
-            reason = "、".join(item["reasons"]) or "related_docs 显式关联"
-            lines.append(
-                f"- [[{item['target']}|{item['target_name']}]]：`{item['type']}`；依据：{reason}"
-            )
-        lines.append("")
-    return "\n".join(lines).rstrip() + "\n"

{campfire_cli-0.1.22 → campfire_cli-0.1.24}/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.24}/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.24}/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.22 → campfire_cli-0.1.24}/src/campfire_cli/common/agent_hints.py

@@ -50,7 +50,7 @@ HINT_BODY = """## Campfire 文档治理
 11. 设置 `document_status=archived` 前必须获得用户针对该文档的明确同意；
    `--confirm` 只确认 CLI 写入，不代表归档授权。
 
-`.campfire.yaml`、声明 Frontmatter、自动生成区域、Base、关系页和 SQLite
+`.campfire.yaml`、声明 Frontmatter、自动生成区域、Base 和 SQLite
 是 CLI 管理资源。Agent 可以读取，但只能通过 Campfire 语义命令写入；缺少
 对应命令时停止并报告能力缺口，不直接编辑。声明文件标记外正文不受此限制。
 `_空间.md` 与 `_领域.md` 的人工正文维护局部业务规则；通用结构事实和索引

campfire_cli-0.1.24/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.24}/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