campfire-cli 0.2.0__tar.gz → 0.2.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (265) hide show
  1. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/ARCHITECTURE.md +5 -3
  2. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/CHANGELOG.md +11 -0
  3. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/PKG-INFO +58 -6
  4. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/README.md +57 -4
  5. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/SPEC.md +10 -3
  6. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/docs/safety.md +3 -3
  7. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/pyproject.toml +1 -2
  8. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/__init__.py +1 -1
  9. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/cli/profile_cli.py +2 -2
  10. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/cli/type_cli.py +2 -2
  11. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/schema/document_schema.py +1 -0
  12. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/index/document_index_service.py +6 -0
  13. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/schema/maintenance_schema.py +11 -1
  14. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/service/maintenance_service.py +30 -7
  15. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/SPEC.md +9 -3
  16. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/cli/project_cli.py +96 -26
  17. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/cli/workspace_cli.py +12 -6
  18. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/repository/manifest_repository.py +4 -1
  19. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/repository/restructure_repository.py +1 -0
  20. campfire_cli-0.2.1/src/campfire_cli/app/workspace/repository/workspace_repository.py +141 -0
  21. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/schema/workspace_schema.py +58 -20
  22. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/adoption_service.py +5 -13
  23. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/domain_restructure_service.py +6 -22
  24. campfire_cli-0.2.1/src/campfire_cli/app/workspace/service/project_service.py +545 -0
  25. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/workspace_protocol.py +0 -2
  26. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/workspace_service.py +47 -39
  27. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/agent_hints.py +5 -2
  28. campfire_cli-0.2.1/src/campfire_cli/common/database/__init__.py +7 -0
  29. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/database/models.py +0 -21
  30. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/documents/related_docs.py +1 -0
  31. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/governance/issues.py +4 -2
  32. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/reports/markdown_report.py +4 -0
  33. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/config/SPEC.md +1 -1
  34. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/container.py +24 -10
  35. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/main.py +21 -1
  36. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/defaults/config.yml +6 -0
  37. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/SPEC.md +1 -0
  38. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-context-bootstrap/SKILL.md +3 -3
  39. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-document-capture/SKILL.md +14 -2
  40. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/SKILL.md +4 -1
  41. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-workspace-onboarding/SKILL.md +14 -9
  42. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/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 +1 -1
  43. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/conftest.py +3 -3
  44. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_cli.py +1 -1
  45. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_domain_rename_sync.py +2 -2
  46. campfire_cli-0.2.1/tests/integration/test_project_repositories.py +342 -0
  47. campfire_cli-0.2.1/tests/integration/test_rebuildable_storage.py +242 -0
  48. campfire_cli-0.2.1/tests/integration/test_setup_diagnostics.py +143 -0
  49. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/perf/test_resolve_subprocess_count.py +3 -2
  50. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_document_apply.py +3 -3
  51. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_document_index.py +3 -3
  52. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_workspace_manifest.py +1 -3
  53. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/uv.lock +2 -93
  54. campfire_cli-0.2.0/src/campfire_cli/alembic/__init__.py +0 -1
  55. campfire_cli-0.2.0/src/campfire_cli/alembic/env.py +0 -37
  56. campfire_cli-0.2.0/src/campfire_cli/alembic/script.py.mako +0 -22
  57. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/001_initial_schema.py +0 -81
  58. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/002_workspace_project_registry.py +0 -47
  59. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/003_unified_workspace_state.py +0 -113
  60. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/004_restructure_workspace_domain.py +0 -23
  61. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/005_decision_channel.py +0 -71
  62. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/006_workspace_topology_index.py +0 -61
  63. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/007_workspace_adoption.py +0 -38
  64. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/008_remove_adoption_batches.py +0 -16
  65. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/009_document_query_index.py +0 -84
  66. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/010_project_domain_identity.py +0 -39
  67. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/011_document_state_model.py +0 -39
  68. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/012_remove_decision_channel.py +0 -17
  69. campfire_cli-0.2.0/src/campfire_cli/alembic/versions/__init__.py +0 -1
  70. campfire_cli-0.2.0/src/campfire_cli/app/workspace/repository/workspace_repository.py +0 -157
  71. campfire_cli-0.2.0/src/campfire_cli/app/workspace/service/project_service.py +0 -437
  72. campfire_cli-0.2.0/src/campfire_cli/common/database/__init__.py +0 -4
  73. campfire_cli-0.2.0/src/campfire_cli/common/database/migrations.py +0 -18
  74. campfire_cli-0.2.0/tests/unit/test_migrations.py +0 -51
  75. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  76. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  77. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  78. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/.github/workflows/ci.yml +0 -0
  79. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/.github/workflows/release.yml +0 -0
  80. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/.gitignore +0 -0
  81. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/.python-version +0 -0
  82. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/AGENTS.md +0 -0
  83. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/COMMAND.md +0 -0
  84. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/CONTRIBUTING.md +0 -0
  85. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/DECISIONS.md +0 -0
  86. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/LICENSE +0 -0
  87. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/SECURITY.md +0 -0
  88. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/alembic/SPEC.md +0 -0
  89. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/alembic/env.py +0 -0
  90. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/alembic/script.py.mako +0 -0
  91. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/alembic/versions/001_initial_schema.py +0 -0
  92. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/alembic.ini +0 -0
  93. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/docs/quickstart.md +0 -0
  94. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/scripts/SPEC.md +0 -0
  95. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/scripts/pypi_verify.py +0 -0
  96. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/scripts/quality_check.py +0 -0
  97. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/scripts/release_check.py +0 -0
  98. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/SPEC.md +0 -0
  99. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/__init__.py +0 -0
  100. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/base/SPEC.md +0 -0
  101. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/base/__init__.py +0 -0
  102. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/base/cli/base_cli.py +0 -0
  103. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/base/repository/base_repository.py +0 -0
  104. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/base/schema/base_schema.py +0 -0
  105. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/base/schema/operation_schema.py +0 -0
  106. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/base/service/base_service.py +0 -0
  107. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/SPEC.md +0 -0
  108. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/__init__.py +0 -0
  109. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/cli/__init__.py +0 -0
  110. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/cli/document_cli.py +0 -0
  111. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/repository/__init__.py +0 -0
  112. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/repository/document_index_repository.py +0 -0
  113. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/repository/document_profile_repository.py +0 -0
  114. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/repository/document_type_repository.py +0 -0
  115. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/schema/__init__.py +0 -0
  116. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/__init__.py +0 -0
  117. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/document_scanner.py +0 -0
  118. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/document_service.py +0 -0
  119. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/index/__init__.py +0 -0
  120. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/index/document_index_builder.py +0 -0
  121. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/index/document_index_protocol.py +0 -0
  122. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/mutation/__init__.py +0 -0
  123. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/mutation/document_apply_service.py +0 -0
  124. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/mutation/document_move_service.py +0 -0
  125. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/mutation/document_relocation.py +0 -0
  126. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/mutation/frontmatter_apply.py +0 -0
  127. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/__init__.py +0 -0
  128. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/document_patch_values.py +0 -0
  129. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/document_profile_service.py +0 -0
  130. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/document_rule_service.py +0 -0
  131. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/document_type_service.py +0 -0
  132. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/frontmatter_formatter.py +0 -0
  133. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/frontmatter_plan.py +0 -0
  134. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/kanban_service.py +0 -0
  135. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/profile_candidates.py +0 -0
  136. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/profile_registry.py +0 -0
  137. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/document/service/rules/type_plan.py +0 -0
  138. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/SPEC.md +0 -0
  139. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/__init__.py +0 -0
  140. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/cli/maintenance_cli.py +0 -0
  141. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/repository/maintenance_repository.py +0 -0
  142. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/service/maintenance_protocol.py +0 -0
  143. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/maintenance/service/moc_service.py +0 -0
  144. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/skill/SPEC.md +0 -0
  145. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/skill/__init__.py +0 -0
  146. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/skill/cli/skill_cli.py +0 -0
  147. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/skill/repository/skill_repository.py +0 -0
  148. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/skill/schema/skill_schema.py +0 -0
  149. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/skill/service/skill_service.py +0 -0
  150. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/SPEC.md +0 -0
  151. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/__init__.py +0 -0
  152. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/cli/__init__.py +0 -0
  153. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/cli/video_cli.py +0 -0
  154. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/schema/__init__.py +0 -0
  155. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/schema/video_schema.py +0 -0
  156. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/service/__init__.py +0 -0
  157. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/service/video_protocol.py +0 -0
  158. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/video/service/video_service.py +0 -0
  159. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/__init__.py +0 -0
  160. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/cli/__init__.py +0 -0
  161. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/cli/config_cli.py +0 -0
  162. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/cli/domain_cli.py +0 -0
  163. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/cli/restructure_cli.py +0 -0
  164. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/cli/space_cli.py +0 -0
  165. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/repository/__init__.py +0 -0
  166. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/schema/__init__.py +0 -0
  167. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/schema/adoption_schema.py +0 -0
  168. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/schema/restructure_schema.py +0 -0
  169. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/__init__.py +0 -0
  170. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/config_service.py +0 -0
  171. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/restructure_protocol.py +0 -0
  172. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/restructure_service.py +0 -0
  173. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/restructure_verifier.py +0 -0
  174. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/app/workspace/service/structure_service.py +0 -0
  175. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/SPEC.md +0 -0
  176. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/__init__.py +0 -0
  177. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/cli_output.py +0 -0
  178. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/database/session.py +0 -0
  179. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/documents/__init__.py +0 -0
  180. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/documents/document_types.py +0 -0
  181. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/documents/domain_context.py +0 -0
  182. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/documents/frontmatter_format.py +0 -0
  183. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/documents/frontmatter_schema.py +0 -0
  184. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/documents/markdown.py +0 -0
  185. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/exceptions/__init__.py +0 -0
  186. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/exceptions/base.py +0 -0
  187. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/filesystem/__init__.py +0 -0
  188. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/filesystem/atomic.py +0 -0
  189. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/filesystem/change_set.py +0 -0
  190. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/filesystem/cwd.py +0 -0
  191. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/filesystem/locking.py +0 -0
  192. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/filesystem/plan.py +0 -0
  193. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/governance/__init__.py +0 -0
  194. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/governance/locking.py +0 -0
  195. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/governance/snapshots.py +0 -0
  196. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/hashing.py +0 -0
  197. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/media/__init__.py +0 -0
  198. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/media/media_backend.py +0 -0
  199. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/media/media_worker.py +0 -0
  200. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/media/model_download.py +0 -0
  201. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/media/video_runtime.py +0 -0
  202. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/package_version.py +0 -0
  203. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/reports/__init__.py +0 -0
  204. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/common/reports/json_report.py +0 -0
  205. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/config/defaults.py +0 -0
  206. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/config/settings.py +0 -0
  207. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/__init__.py +0 -0
  208. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/bases/SPEC.md +0 -0
  209. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/bases//344/273/273/345/212/241/345/267/245/344/275/234/345/217/260-/344/270/252/344/272/272.base" +0 -0
  210. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/bases//344/273/273/345/212/241/345/267/245/344/275/234/345/217/260-/351/241/271/347/233/256.base" +0 -0
  211. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/bases//345/275/222/346/241/243/346/226/207/346/241/243/345/267/245/344/275/234/345/217/260.base" +0 -0
  212. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/bases//345/276/205/344/272/272/345/206/263/347/255/226/345/267/245/344/275/234/345/217/260.base" +0 -0
  213. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/bases//346/226/207/346/241/243/345/267/245/344/275/234/345/217/260.base" +0 -0
  214. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/defaults/__init__.py +0 -0
  215. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/TEMPLATE.md +0 -0
  216. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-context-bootstrap/agents/openai.yaml +0 -0
  217. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-conversation-router/SKILL.md +0 -0
  218. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-conversation-router/agents/openai.yaml +0 -0
  219. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-conversation-router/references/inbox-handoff.md +0 -0
  220. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-conversation-router/references/learning-intake.md +0 -0
  221. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-conversation-router/references/task-intake.md +0 -0
  222. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-document-capture/references//344/273/273/345/212/241/344/270/216/350/256/241/345/210/222/346/262/211/346/267/200.md" +0 -0
  223. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-document-capture/references//345/267/262/346/234/211/346/226/207/346/241/243/346/233/264/346/226/260.md" +0 -0
  224. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-document-capture/references//351/200/232/347/224/250/347/237/245/350/257/206/346/262/211/346/267/200.md" +0 -0
  225. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-document-capture/references//351/227/256/351/242/230/344/270/216/345/206/263/347/255/226/346/262/211/346/267/200.md" +0 -0
  226. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-document-capture/references//351/241/271/347/233/256/345/206/205/345/256/271/346/262/211/346/267/200.md" +0 -0
  227. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-inbox-triage/SKILL.md +0 -0
  228. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-kanban-board/SKILL.md +0 -0
  229. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-task-management/SKILL.md +0 -0
  230. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-video-capture/SKILL.md +0 -0
  231. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/SKILL.md +0 -0
  232. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/agents/openai.yaml +0 -0
  233. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-workspace-adoption/SKILL.md +0 -0
  234. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-workspace-restructure/SKILL.md +0 -0
  235. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/skills/campfire-workspace-restructure/references/restructure-spec.md +0 -0
  236. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277/README.md" +0 -0
  237. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277//346/250/241/346/235/277-/344/273/273/345/212/241.md" +0 -0
  238. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277//346/250/241/346/235/277-/347/211/210/346/234/254/345/217/221/345/270/203/346/270/205/345/215/225.md" +0 -0
  239. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/SPEC.md +0 -0
  240. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_json_discovery.py +0 -0
  241. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_profile_resolution.py +0 -0
  242. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_quickstart.py +0 -0
  243. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_relation_pages_cli.py +0 -0
  244. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_skill_examples.py +0 -0
  245. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/integration/test_workspace_templates.py +0 -0
  246. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/perf/test_read_counts.py +0 -0
  247. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_agent_hints.py +0 -0
  248. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_atomic_write.py +0 -0
  249. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_base_service.py +0 -0
  250. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_config.py +0 -0
  251. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_document_scanner.py +0 -0
  252. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_domain_context.py +0 -0
  253. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_domain_paths.py +0 -0
  254. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_file_change_executor.py +0 -0
  255. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_frontmatter.py +0 -0
  256. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_generated_regions.py +0 -0
  257. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_kanban_service.py +0 -0
  258. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_operation_schema.py +0 -0
  259. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_package_version.py +0 -0
  260. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_pypi_verify.py +0 -0
  261. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_related_docs.py +0 -0
  262. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_release_check.py +0 -0
  263. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_repository_boundaries.py +0 -0
  264. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_video.py +0 -0
  265. {campfire_cli-0.2.0 → campfire_cli-0.2.1}/tests/unit/test_video_runtime.py +0 -0
@@ -71,7 +71,7 @@ Task Channel 是未来演进设想,借鉴 Go 的原则:**Do not communicate
71
71
  ┌───────────┴───────────┐
72
72
  Markdown Workspace Adapter 用户级状态
73
73
  文档事实、任务、知识、项目 ~/.campfire/
74
- campfire.db + config.yml
74
+ local.yaml + campfire.db + config.yml
75
75
  batches/reports/locks
76
76
  models/faster-whisper-small
77
77
  ```
@@ -203,10 +203,10 @@ Campfire 不把“调用方能够猜对未声明契约”作为可靠性前提
203
203
  | Space、Domain 结构 | Workspace 中的 `_空间.md`、`_领域.md` | CLI 发现结果、MOC |
204
204
  | 治理规则 | 包内 `config.yml` + `~/.campfire/config.yml` 覆盖 | 校验结果与执行计划 |
205
205
  | Workspace、Project 可移植身份与 Project 根 Domain 绑定 | Vault 根 `.campfire.yaml` | Git 或文件同步 |
206
- | Workspace、Project 本机路径绑定 | `~/.campfire/campfire.db` | 本机 CLI 命令 |
206
+ | Workspace 接入、默认选择、仓库本机路径绑定 | `~/.campfire/local.yaml` | 本机 CLI 命令 |
207
207
  | Campfire Skills | Python 包内 `resources/skills/` | 全局 Agent Skill 目录 |
208
208
  | 文档查询索引 | Workspace Markdown、结构声明与有效治理契约 | `~/.campfire/campfire.db` 中按 `workspace_id` 隔离的可重建投影 |
209
- | 结构重构批次和维护运行状态 | `~/.campfire/campfire.db` | Markdown 投影、报告与有限变更日志;当前不能仅从 Workspace 重建 |
209
+ | 结构重构批次和维护运行状态 | `~/.campfire/campfire.db` | Markdown 投影、报告与有限变更日志;可丢弃并重新生成,新计划重新审批 |
210
210
 
211
211
  SQLite 中的 Workspace 与 Project 注册数据是结构化事实,文档索引可以从 Markdown 重建;SQLite 不是知识内容的 SSOT。工具状态不写入 Workspace,因而一个 Campfire 安装可以管理多个 Workspace。
212
212
 
@@ -282,3 +282,5 @@ Adoption 是首次接管边界,不属于日常 Maintenance。`workspace domain
282
282
  ## 8. 演进方向
283
283
 
284
284
  当前版本先稳定 Workspace 注册、存量结构重构、增量维护、归档、Skill 与治理视图。下一阶段围绕 Task Channel 补齐任务创建、进度事件、交接、待确认和验收协议,再连接工作日志、周报与绩效证据。只有出现真实用例时才新增模块,避免为未来能力预建空架构。
285
+
286
+ 本机配置按 Workspace id 分节,repository_bindings 按 Project id 和 repository id 保存路径;remote 和分支只在 Vault 根目录 `.campfire.yaml`。SQLite 无注册事实、无历史迁移链,只从当前文件生成投影;停止运行中的操作后可整库删除重建。
@@ -1,5 +1,16 @@
1
1
  # 版本记录
2
2
 
3
+ ## 0.2.1 — 发布候选
4
+
5
+ - Project 支持多个稳定 id 的仓库,逐仓库绑定、更新、解绑、移除、识别及漂移检查;单仓库与多仓库统一接口,不保留旧参数或 Project 顶层仓库字段。
6
+ - 本机注册与路径绑定独立保存于 ~/.campfire/local.yaml,项目便携信息读取 Vault 根目录 .campfire.yaml。SQLite 全部是可重建投影;删除历史迁移链、Alembic 依赖、旧格式转换与注册格式版本字段。已有用户由 Agent 备份并整理持久文件后删除旧数据库重建,不支持旧状态自动升级。
7
+ - setup 默认输出资源摘要,--verbose 保留逐文件明细;健康与未绑定状态、下一步指引更明确。
8
+ - 索引结果区分当前总量、本次处理量、内容变化与快照可用性;修复 check/rebuild 重建后统计仍为零的输出。
9
+ - 补齐失效 related_docs、待确认目录缺失的定位与修复说明;明确治理检查不覆盖正文链接。
10
+ - capture 合并写作依据并增加五条正文原则;Agent Hint 与相关 Skill 提供未知文档类型的发现入口,不固定重复查询。
11
+ - 文档删除继续使用用户授权的文件工具,不新增 document delete。
12
+ - 0.2.1 版本号按本轮用户明确决定采用,作为新增能力通常使用次版本规则的例外。尚未发布。
13
+
3
14
  ## 0.2.0 — 2026-10-09
4
15
 
5
16
  - 视频文字流程支持校订转写稿和按用途整理成文,保留来源、时间定位与取舍说明。
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: campfire-cli
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: Local-first shared context and governance CLI for humans and agents
5
5
  Project-URL: Repository, https://github.com/Kepler452Byte/campfire-cli
6
6
  Project-URL: Documentation, https://github.com/Kepler452Byte/campfire-cli#readme
@@ -9,7 +9,6 @@ Project-URL: Changelog, https://github.com/Kepler452Byte/campfire-cli/blob/main/
9
9
  License-Expression: MIT
10
10
  License-File: LICENSE
11
11
  Requires-Python: >=3.12
12
- Requires-Dist: alembic>=1.13
13
12
  Requires-Dist: packaging>=24
14
13
  Requires-Dist: psutil>=7.2.2
15
14
  Requires-Dist: pydantic-settings>=2.2
@@ -29,7 +28,7 @@ Description-Content-Type: text/markdown
29
28
  `campfire` 是面向工作与学习场景的本地优先人机协作 CLI。它让人类和多个 Agent 围绕同一份持久共享上下文协作:把口头要求、临时笔记、任务进度、项目资料和长期知识沉淀进可检索、可交接、可审计的 Workspace。
30
29
 
31
30
  - **人类和 Agent 同一条链路**:同一套 CLI 契约 + 全局 Agent Skill,没有两套规则。
32
- - **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;SQLite 保存可重建索引,也保存本机注册与运行状态,不能整体当作缓存删除。
31
+ - **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;`.campfire.yaml` 保存便携项目事实,`~/.campfire/local.yaml` 保存本机注册与绑定;SQLite 全部是可重建状态。
33
32
  - **写操作默认预览**:先计划、再确认、执行前在治理锁内复核内容哈希,检测到输入变化时拒绝覆盖;不承诺外部编辑器遵守锁或跨介质崩溃原子性。
34
33
  - **本地优先**:不绑定云服务、不内置账号;Obsidian 是推荐阅读工具而非强依赖;CLI 可独立治理 Markdown Workspace。
35
34
 
@@ -85,7 +84,7 @@ uv tool install campfire-cli
85
84
  campfire version
86
85
  ```
87
86
 
88
- 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后对齐 SQLite Schema、全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
87
+ 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后按当前模型初始化 SQLite、对齐全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
89
88
 
90
89
  开发机安装(跟随本地源码):
91
90
 
@@ -124,7 +123,7 @@ Workspace ── Space ── Domain 树 ── 文档
124
123
 
125
124
  | 对象 | 说明 | 事实源 |
126
125
  |------|------|--------|
127
- | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/campfire.db`(注册)+ `.campfire.yaml`(便携 Manifest) |
126
+ | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/local.yaml`(本机接入)+ Vault 根目录 `.campfire.yaml`(便携配置) |
128
127
  | Space / Domain | 顶级容器 / 可嵌套内容边界,声明式 + 自动 MOC | Vault 内 `_空间.md`、`_领域.md` |
129
128
  | Document | 知识、计划、问题、决策、记录等持久内容 | Markdown 正文 + Frontmatter |
130
129
  | Human request | Agent 需要人类回答的待确认事项 | `_待用户确认/` 中的 `human-request` 文档 |
@@ -164,10 +163,61 @@ campfire workspace space create --id research --name "研究" --path myresearch
164
163
  campfire workspace domain create --id wiki --name "Wiki" --path "mywork/项目/wiki" \
165
164
  --type knowledge-domain --governance knowledge-base --confirm
166
165
  campfire --workspace personal workspace project adopt --id example \
167
- --name "Example" --domain project-example --local-path /path/to/repo
166
+ --name "Example" --domain project-example \
167
+ --repositories '[{"id":"source","local_path":"/path/to/repo"}]'
168
168
  campfire workspace rebuild --confirm # 索引损坏时从 SSOT 完整恢复
169
169
  ```
170
170
 
171
+ ## Project 多仓库与新设备接入
172
+
173
+ 一个业务 Project 绑定一个文档根 Domain,可登记零个或多个仓库。仓库由 Project 内唯一的稳定 `id` 标识,`role` 只是描述;角色修改或列表重排不改变本机路径绑定。
174
+
175
+ ```bash
176
+ campfire workspace project create --id product --name "Product" --path mywork/Product \
177
+ --repositories '[{"id":"web","role":"frontend","git_remote_url":"https://example.org/web.git"},{"id":"api","role":"backend","git_remote_url":"https://example.org/api.git"}]'
178
+ # 审查后对同一条 create 命令追加 --confirm
179
+ campfire workspace project bind --id product --repository web --local-path /path/to/web
180
+ campfire workspace project bind --id product --repository api --local-path /path/to/api
181
+ campfire workspace project update --id product --repository api --role server
182
+ # 审查后,对相同 update 命令追加 --expected-hash <预览哈希> --confirm
183
+ ```
184
+
185
+ `create/adopt --repositories` 接受 JSON 数组,条目包含必填 `id` 以及可选 `git_remote_url`、`default_branch`、`role`、`local_path`。`update --repository` 新增或修改一个仓库,默认只预览;`--unbind` 清除本机路径,`--remove-repository` 移除注册项,两者均须预览哈希和确认,均不删除代码文件。角色可传空字符串清空。Project 名称、Domain 和状态使用不带 --repository 的 update 入口。
186
+
187
+ 单仓库和多仓库使用同一套接口:仓库字段只出现在 `repositories` 条目内,bind 始终必填 `--repository`。不提供 Project 顶层 remote、路径或分支字段,也不保留旧 create/adopt 的单仓库参数。零仓库允许只管理文档,需要代码仓库时通过 update 显式新增。
188
+
189
+ 本地 resolve 按最深绑定路径匹配并返回仓库 id,不执行 Git 子进程;相同深度多个绑定返回 ambiguous,包括同一 Project 内的多个仓库。共享 remote 允许登记,但远程匹配只返回候选,不自动认定归属。绑定路径可重叠,调用方需根据结果明确选择。check 逐仓库报告未绑定、路径缺失及 Git 信息漂移。
190
+
191
+ setup 默认输出资源操作摘要;逐文件路径与哈希使用 `setup --verbose`。健康问题返回 needs-review,健康检查通过但仓库未绑定时返回 needs-input;unbound_repositories 提供仓库身份和绑定参数,实际本机目录须用户提供。重复 setup 按仓库 id 保留已有绑定,不扫描或自动绑定猜测路径。
192
+
193
+ 0.2.1 只支持当前结构,不包含旧格式转换和数据库迁移链。已有用户先备份 Vault 的 `.campfire.yaml` 和本机状态,由本地 Agent 将项目整理为仓库列表,把 Vault 路径、默认选择及仓库本机路径记入 `~/.campfire/local.yaml`;确认保留身份与绑定后,停止 Campfire 进程并删除旧数据库,运行 setup 重新接入。新用户直接 setup。旧格式备份不直接导入,升级准备不删除 Markdown 或代码目录。
194
+
195
+ `~/.campfire/local.yaml` 按 Workspace id 保存设备配置,不重复保存 remote、分支和项目名称:
196
+
197
+ ```yaml
198
+ default_workspace: personal
199
+ workspaces:
200
+ personal:
201
+ path: /path/to/vault
202
+ repository_bindings:
203
+ campfire-cli:
204
+ source: /path/to/campfire-cli
205
+ ```
206
+
207
+ Vault 根目录 `.campfire.yaml` 保存稳定 Project/repository id、文档领域、remote、默认分支和 role,不保存本机路径。`project list/show/resolve/check` 按稳定 id 合并两份文件;元数据操作写 `.campfire.yaml`,路径绑定写 `local.yaml`。SQLite 删除后项目查询不依赖数据库,文档查询自动重建索引;先停止运行中的操作,再删除 `campfire.db`、`campfire.db-wal` 与 `campfire.db-shm`。报告和未执行计划可重新生成,重新生成的计划需要重新审批。
208
+
209
+ 本轮包含明确的接口变化:旧 create/adopt 单仓库参数移除;update 仓库字段须带 --repository;bind 须指定仓库 id;Project JSON 顶层仓库字段移除。旧调用方需按上述命令更新。降级需恢复升级前完整备份,不手工删除数据库或仓库列表。本轮版本号 0.2.1 按用户明确决定采用。
210
+
211
+ ## 索引统计与检查范围
212
+
213
+ `maintenance check` 和 `workspace rebuild --confirm` 完整重建索引;治理问题不等于索引不可用。`indexed_document_count` 是当前整个 Workspace 的索引总量;`index_processed_document_count` 是本次索引处理的文档数量,完整重建时包括内容未改变的文档;`index_content_changed_document_count` 是内容哈希发生变化或新增、删除的文档数量。`index_generation` 标识快照,`index_available` 为 true 表示本次确认可用,null 表示当前步骤未评估。`document_count` 仍表示本次治理扫描范围的数量。
214
+
215
+ `write_performed` 只表示 Markdown 文件变更,不包含 SQLite 或运行报告写入,范围由 write_performed_scope 明示。无文件变化与索引可用可以同时成立。scoped sync 的索引总量仍按 Workspace 统计,其文件维护范围由 scope 限定。
216
+
217
+ 关系检查仅覆盖 Frontmatter 的 `related_docs`,正文链接不参与索引、治理检查或自动改写。零治理问题不代表正文全部链接有效。用户要求删除具体文档时直接使用 rm 或文件工具;Campfire 不提供 document delete。查询会自动对账索引,MOC 按需 scoped sync,遗留引用另行核实和处理。
218
+
219
+ 类型未知时使用 `campfire --workspace <id> document type list` 查询当前有效类型、名称与前缀,再对选定类型查询 Profile;已知类型不重复列举,不猜测 type 或按目录名推断。
220
+
171
221
  ## 存量接管与结构重构
172
222
 
173
223
  `workspace domain adopt` 用一条命令接管一个已有文件夹。Vault 外来源经临时暂存和哈希校验复制到目标 Domain,原目录始终保留;Vault 内来源原地声明或移动到明确目标。命令一次建立一个粗粒度 Domain,语义细分交给后续 Restructure。
@@ -193,6 +243,8 @@ campfire workspace restructure verify --batch move-001
193
243
  ## 治理模型
194
244
 
195
245
  - **本地查询投影**:`document list` 按 Project、Domain、类型、`document_status` 和 `task_status` 精确筛选;`document inspect` 返回显式关联、出链、反向链接和失效/歧义引用。两者在查询前自动 reconcile,Agent 无需先运行 Maintenance。SQLite 不复制正文,正文仍由 Agent 按返回路径读取。
246
+
247
+ 外部编辑器或文件工具重命名文档、文件夹后,下一次 list/inspect/check 自动对账索引;related_docs 是 Markdown 中的事实,不凭路径变化猜测并改写。maintenance check 报告失效关系,Agent 核实目标后通过 document apply 修正。正文链接不在该检查范围;通过 CLI 的 rename/move 则按既有契约定向更新受管引用。
196
248
  - **校验分工**:`maintenance check` 汇总 Space/Domain 结构与正式文档问题,并刷新可重建索引;`workspace space/domain check` 提供结构声明的专项诊断。`maintenance sync` 只因结构、MOC、路径或并发安全问题阻塞,单篇文档问题不阻止其他领域刷新。
197
249
  - **Frontmatter Profile**:声明式一层继承(`base` 或 `base → task/human-request/board`),`document profile show` 展示编译后的完整规则;Formatter 只按有效 Profile 排序并保留值,不允许字段由 Validator 报告、不自动删除。
198
250
  - **并发与提交安全**:写入前在治理锁内复核内容哈希,外部变化返回 `concurrent-change` / `source-hash-changed`,拒绝覆盖;多文件写入和路径移动经同一 ChangeSet 提交,可捕获失败尝试补偿;若报告恢复失败,停止重试并核对实际文件。
@@ -3,7 +3,7 @@
3
3
  `campfire` 是面向工作与学习场景的本地优先人机协作 CLI。它让人类和多个 Agent 围绕同一份持久共享上下文协作:把口头要求、临时笔记、任务进度、项目资料和长期知识沉淀进可检索、可交接、可审计的 Workspace。
4
4
 
5
5
  - **人类和 Agent 同一条链路**:同一套 CLI 契约 + 全局 Agent Skill,没有两套规则。
6
- - **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;SQLite 保存可重建索引,也保存本机注册与运行状态,不能整体当作缓存删除。
6
+ - **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;`.campfire.yaml` 保存便携项目事实,`~/.campfire/local.yaml` 保存本机注册与绑定;SQLite 全部是可重建状态。
7
7
  - **写操作默认预览**:先计划、再确认、执行前在治理锁内复核内容哈希,检测到输入变化时拒绝覆盖;不承诺外部编辑器遵守锁或跨介质崩溃原子性。
8
8
  - **本地优先**:不绑定云服务、不内置账号;Obsidian 是推荐阅读工具而非强依赖;CLI 可独立治理 Markdown Workspace。
9
9
 
@@ -59,7 +59,7 @@ uv tool install campfire-cli
59
59
  campfire version
60
60
  ```
61
61
 
62
- 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后对齐 SQLite Schema、全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
62
+ 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后按当前模型初始化 SQLite、对齐全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
63
63
 
64
64
  开发机安装(跟随本地源码):
65
65
 
@@ -98,7 +98,7 @@ Workspace ── Space ── Domain 树 ── 文档
98
98
 
99
99
  | 对象 | 说明 | 事实源 |
100
100
  |------|------|--------|
101
- | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/campfire.db`(注册)+ `.campfire.yaml`(便携 Manifest) |
101
+ | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/local.yaml`(本机接入)+ Vault 根目录 `.campfire.yaml`(便携配置) |
102
102
  | Space / Domain | 顶级容器 / 可嵌套内容边界,声明式 + 自动 MOC | Vault 内 `_空间.md`、`_领域.md` |
103
103
  | Document | 知识、计划、问题、决策、记录等持久内容 | Markdown 正文 + Frontmatter |
104
104
  | Human request | Agent 需要人类回答的待确认事项 | `_待用户确认/` 中的 `human-request` 文档 |
@@ -138,10 +138,61 @@ campfire workspace space create --id research --name "研究" --path myresearch
138
138
  campfire workspace domain create --id wiki --name "Wiki" --path "mywork/项目/wiki" \
139
139
  --type knowledge-domain --governance knowledge-base --confirm
140
140
  campfire --workspace personal workspace project adopt --id example \
141
- --name "Example" --domain project-example --local-path /path/to/repo
141
+ --name "Example" --domain project-example \
142
+ --repositories '[{"id":"source","local_path":"/path/to/repo"}]'
142
143
  campfire workspace rebuild --confirm # 索引损坏时从 SSOT 完整恢复
143
144
  ```
144
145
 
146
+ ## Project 多仓库与新设备接入
147
+
148
+ 一个业务 Project 绑定一个文档根 Domain,可登记零个或多个仓库。仓库由 Project 内唯一的稳定 `id` 标识,`role` 只是描述;角色修改或列表重排不改变本机路径绑定。
149
+
150
+ ```bash
151
+ campfire workspace project create --id product --name "Product" --path mywork/Product \
152
+ --repositories '[{"id":"web","role":"frontend","git_remote_url":"https://example.org/web.git"},{"id":"api","role":"backend","git_remote_url":"https://example.org/api.git"}]'
153
+ # 审查后对同一条 create 命令追加 --confirm
154
+ campfire workspace project bind --id product --repository web --local-path /path/to/web
155
+ campfire workspace project bind --id product --repository api --local-path /path/to/api
156
+ campfire workspace project update --id product --repository api --role server
157
+ # 审查后,对相同 update 命令追加 --expected-hash <预览哈希> --confirm
158
+ ```
159
+
160
+ `create/adopt --repositories` 接受 JSON 数组,条目包含必填 `id` 以及可选 `git_remote_url`、`default_branch`、`role`、`local_path`。`update --repository` 新增或修改一个仓库,默认只预览;`--unbind` 清除本机路径,`--remove-repository` 移除注册项,两者均须预览哈希和确认,均不删除代码文件。角色可传空字符串清空。Project 名称、Domain 和状态使用不带 --repository 的 update 入口。
161
+
162
+ 单仓库和多仓库使用同一套接口:仓库字段只出现在 `repositories` 条目内,bind 始终必填 `--repository`。不提供 Project 顶层 remote、路径或分支字段,也不保留旧 create/adopt 的单仓库参数。零仓库允许只管理文档,需要代码仓库时通过 update 显式新增。
163
+
164
+ 本地 resolve 按最深绑定路径匹配并返回仓库 id,不执行 Git 子进程;相同深度多个绑定返回 ambiguous,包括同一 Project 内的多个仓库。共享 remote 允许登记,但远程匹配只返回候选,不自动认定归属。绑定路径可重叠,调用方需根据结果明确选择。check 逐仓库报告未绑定、路径缺失及 Git 信息漂移。
165
+
166
+ setup 默认输出资源操作摘要;逐文件路径与哈希使用 `setup --verbose`。健康问题返回 needs-review,健康检查通过但仓库未绑定时返回 needs-input;unbound_repositories 提供仓库身份和绑定参数,实际本机目录须用户提供。重复 setup 按仓库 id 保留已有绑定,不扫描或自动绑定猜测路径。
167
+
168
+ 0.2.1 只支持当前结构,不包含旧格式转换和数据库迁移链。已有用户先备份 Vault 的 `.campfire.yaml` 和本机状态,由本地 Agent 将项目整理为仓库列表,把 Vault 路径、默认选择及仓库本机路径记入 `~/.campfire/local.yaml`;确认保留身份与绑定后,停止 Campfire 进程并删除旧数据库,运行 setup 重新接入。新用户直接 setup。旧格式备份不直接导入,升级准备不删除 Markdown 或代码目录。
169
+
170
+ `~/.campfire/local.yaml` 按 Workspace id 保存设备配置,不重复保存 remote、分支和项目名称:
171
+
172
+ ```yaml
173
+ default_workspace: personal
174
+ workspaces:
175
+ personal:
176
+ path: /path/to/vault
177
+ repository_bindings:
178
+ campfire-cli:
179
+ source: /path/to/campfire-cli
180
+ ```
181
+
182
+ Vault 根目录 `.campfire.yaml` 保存稳定 Project/repository id、文档领域、remote、默认分支和 role,不保存本机路径。`project list/show/resolve/check` 按稳定 id 合并两份文件;元数据操作写 `.campfire.yaml`,路径绑定写 `local.yaml`。SQLite 删除后项目查询不依赖数据库,文档查询自动重建索引;先停止运行中的操作,再删除 `campfire.db`、`campfire.db-wal` 与 `campfire.db-shm`。报告和未执行计划可重新生成,重新生成的计划需要重新审批。
183
+
184
+ 本轮包含明确的接口变化:旧 create/adopt 单仓库参数移除;update 仓库字段须带 --repository;bind 须指定仓库 id;Project JSON 顶层仓库字段移除。旧调用方需按上述命令更新。降级需恢复升级前完整备份,不手工删除数据库或仓库列表。本轮版本号 0.2.1 按用户明确决定采用。
185
+
186
+ ## 索引统计与检查范围
187
+
188
+ `maintenance check` 和 `workspace rebuild --confirm` 完整重建索引;治理问题不等于索引不可用。`indexed_document_count` 是当前整个 Workspace 的索引总量;`index_processed_document_count` 是本次索引处理的文档数量,完整重建时包括内容未改变的文档;`index_content_changed_document_count` 是内容哈希发生变化或新增、删除的文档数量。`index_generation` 标识快照,`index_available` 为 true 表示本次确认可用,null 表示当前步骤未评估。`document_count` 仍表示本次治理扫描范围的数量。
189
+
190
+ `write_performed` 只表示 Markdown 文件变更,不包含 SQLite 或运行报告写入,范围由 write_performed_scope 明示。无文件变化与索引可用可以同时成立。scoped sync 的索引总量仍按 Workspace 统计,其文件维护范围由 scope 限定。
191
+
192
+ 关系检查仅覆盖 Frontmatter 的 `related_docs`,正文链接不参与索引、治理检查或自动改写。零治理问题不代表正文全部链接有效。用户要求删除具体文档时直接使用 rm 或文件工具;Campfire 不提供 document delete。查询会自动对账索引,MOC 按需 scoped sync,遗留引用另行核实和处理。
193
+
194
+ 类型未知时使用 `campfire --workspace <id> document type list` 查询当前有效类型、名称与前缀,再对选定类型查询 Profile;已知类型不重复列举,不猜测 type 或按目录名推断。
195
+
145
196
  ## 存量接管与结构重构
146
197
 
147
198
  `workspace domain adopt` 用一条命令接管一个已有文件夹。Vault 外来源经临时暂存和哈希校验复制到目标 Domain,原目录始终保留;Vault 内来源原地声明或移动到明确目标。命令一次建立一个粗粒度 Domain,语义细分交给后续 Restructure。
@@ -167,6 +218,8 @@ campfire workspace restructure verify --batch move-001
167
218
  ## 治理模型
168
219
 
169
220
  - **本地查询投影**:`document list` 按 Project、Domain、类型、`document_status` 和 `task_status` 精确筛选;`document inspect` 返回显式关联、出链、反向链接和失效/歧义引用。两者在查询前自动 reconcile,Agent 无需先运行 Maintenance。SQLite 不复制正文,正文仍由 Agent 按返回路径读取。
221
+
222
+ 外部编辑器或文件工具重命名文档、文件夹后,下一次 list/inspect/check 自动对账索引;related_docs 是 Markdown 中的事实,不凭路径变化猜测并改写。maintenance check 报告失效关系,Agent 核实目标后通过 document apply 修正。正文链接不在该检查范围;通过 CLI 的 rename/move 则按既有契约定向更新受管引用。
170
223
  - **校验分工**:`maintenance check` 汇总 Space/Domain 结构与正式文档问题,并刷新可重建索引;`workspace space/domain check` 提供结构声明的专项诊断。`maintenance sync` 只因结构、MOC、路径或并发安全问题阻塞,单篇文档问题不阻止其他领域刷新。
171
224
  - **Frontmatter Profile**:声明式一层继承(`base` 或 `base → task/human-request/board`),`document profile show` 展示编译后的完整规则;Formatter 只按有效 Profile 排序并保留值,不允许字段由 Validator 报告、不自动删除。
172
225
  - **并发与提交安全**:写入前在治理锁内复核内容哈希,外部变化返回 `concurrent-change` / `source-hash-changed`,拒绝覆盖;多文件写入和路径移动经同一 ChangeSet 提交,可捕获失败尝试补偿;若报告恢复失败,停止重试并核对实际文件。
@@ -23,7 +23,7 @@ SQLite / Filesystem Implementation
23
23
  - 纯技术机制放 `common/`,例如网络查询、版本比较与进程编排;不得包含治理业务语义,也不得反向依赖 `app/`。
24
24
  - `resources/defaults/config.yml` 是产品默认规则的唯一 SSOT;Service 不得重复声明可演进的目录、类型、状态、归档或 Issue 规则。
25
25
  - CLI 通过用户级 registry 管理多个 Workspace,不依赖任何 Workspace 内的工具目录。
26
- - Markdown 是内容事实来源;包内 `config.yml` 与可选的 `~/.campfire/config.yml` 覆盖共同形成有效治理契约;`~/.campfire/campfire.db` 是唯一数据库,保存 Workspace/Project 注册数据、按 Workspace 隔离的可重建索引和工作流状态。
26
+ - Markdown 是内容事实来源;包内 `config.yml` 与可选的 `~/.campfire/config.yml` 覆盖共同形成有效治理契约;Vault 根目录 `.campfire.yaml` 保存便携身份与仓库元数据;`~/.campfire/local.yaml` 按 Workspace id 保存 Vault 本机路径、默认选择和按 Project/repository id 关联的本机仓库路径;`~/.campfire/campfire.db` 只保存可重建投影、检查和未执行计划,不保存唯一事实。
27
27
  - YAML 只承载人类可维护的配置和可移植 Manifest;JSON 只用于报告、计划交换和有限的最近变更。
28
28
  - Workspace Restructure 与 Maintenance 不共享含义模糊的业务入口。
29
29
  - CLI 不直接实现业务规则;Service 不依赖 Typer。
@@ -48,7 +48,7 @@ SQLite / Filesystem Implementation
48
48
 
49
49
  ## 升级语义
50
50
 
51
- - `campfire upgrade` 是唯一的幂等升级入口:先更新 Python 包本身,再对齐本机治理资源,覆盖 Schema 迁移、全局 Skill、Base 与提示词路标。
51
+ - `campfire upgrade` 是唯一的幂等升级入口:先更新 Python 包本身,再对齐本机治理资源,覆盖当前表结构初始化、全局 Skill、Base 与提示词路标;不维护历史迁移链或旧格式转换。
52
52
  - 包自更新按检测到的安装方式在独立进程中执行,当前支持 uv tool 与 pipx。更新脚本必须等待当前进程退出后再运行,因为 Windows 会锁定运行中的解释器与可执行文件,包管理器无法原地替换;成功后由新版代码完成资源对齐。
53
53
  - editable 源码安装、离线、无法识别安装方式时跳过包更新仅对齐资源,结果中以 `action` 与 `hint` 显式说明原因。
54
54
  - 自更新链使用的内部参数必须 `hidden=True`,`--skip-package` 是当前实例,不进入公共 CLI 契约。
@@ -120,7 +120,7 @@ Campfire 使用语义化版本:
120
120
  - Markdown Frontmatter 的 `related_docs` 是文档关系唯一 SSOT,采用 `[[Workspace相对路径.md]]`。不解析、索引或自动改写正文链接;历史正文保留,SQLite 关系投影可从该字段重建;不再生成 Markdown 关系页,Agent 通过 document inspect 查询关系。
121
121
  - 改名、移动与类型联动改名只定向更新 `related_docs` 引用方;预览输出 `expected_plan`,确认复核整个变更集摘要和文件哈希。文件提交后的索引失败必须报告已写入事实,并使索引可在下次查询恢复。
122
122
 
123
- - SQLite `spaces`、`domains`、`documents` 只允许作为可重建本机投影,不得反向覆盖 Markdown SSOT。
123
+ - SQLite 全部表只允许作为可重建本机投影,不得反向覆盖 Markdown SSOT。
124
124
  - Document App 拥有文档记录、确定关系、集合查询和单篇关系查询;Repository 只持久化投影,不解释 Profile、Domain 或链接语义。
125
125
  - 文档索引保存 schema version、parser version、有效配置 hash、拓扑 hash 和 generation;Domain 声明、Project 文档根映射等任一解释输入变化都必须自动完整重建。
126
126
  - `document list` 与 `document inspect` 查询前必须轻量 reconcile。文件 stat 只筛选变化候选,content hash 表示内容版本;调用方不需要先运行 Maintenance。
@@ -139,3 +139,10 @@ Campfire 使用语义化版本:
139
139
  - 接管计划一次建立一个粗粒度 Domain;CLI 不得自行推断文档语义或子领域。
140
140
  - `workspace domain adopt` 默认只预览,显式 `--confirm` 后在一个 ChangeSet 中移动或复制内容并创建领域声明。
141
141
  - 提交成功前必须核对接管文件、哈希和领域声明;接管后的细分治理继续使用 Restructure。
142
+
143
+ ## 本机配置与重建
144
+
145
+ - `.campfire.yaml` 与 `local.yaml` 各有唯一事实,不双向复制 remote、分支、名称和文档领域。项目查询按稳定 id 合并两者,元数据写入 Vault 文件,路径绑定写入本机文件。
146
+ - 只支持当前文件结构,无 schema_version 分支或旧格式读取。已有用户由 Agent 在备份后一次性整理文件;转换逻辑不进入产品。
147
+ - 停止正在执行的操作后,可删除 campfire.db 及其 WAL/SHM,再由正常查询、setup 或 rebuild 从文件恢复派生状态;重新生成的计划重新确认,旧审批不沿用。
148
+ - SQLite 不承载唯一的文件回滚材料;结构变更继续通过文件变更集执行与补偿,不承诺断电原子性,恢复未完成时停止清理并核对文件。
@@ -11,7 +11,7 @@ Campfire 不提供独立备份系统。先明确写入边界,再使用已有 G
11
11
  | maintenance check / list / inspect | 本机索引和检查状态;不是完全无副作用的文件读取 |
12
12
  | maintenance sync | MOC 自动区域和本机投影,不写人工正文或历史关系页 |
13
13
  | base sync | `_治理视图` 中的内置 Base 定义,可能补回已删除的内置视图 |
14
- | upgrade | Python 包、数据库迁移、已注册 Workspace 的 Base、全局 Skill 和提示词 |
14
+ | upgrade | Python 包、当前派生数据库初始化、已注册 Workspace 的 Base、全局 Skill 和提示词 |
15
15
 
16
16
  默认本机状态在 `~/.campfire`;`CAMPFIRE_HOME` 可覆盖。提示词默认位于 `~/.claude/CLAUDE.md`、`~/.agents/AGENTS.md`,Skill 默认位于两者的 skills 目录。`CAMPFIRE_AGENT_HINT_PATH` 和 `CAMPFIRE_SKILL_TARGETS` 可覆盖,多个目标按操作系统路径分隔符分开。
17
17
 
@@ -30,9 +30,9 @@ Campfire 不提供独立备份系统。先明确写入边界,再使用已有 G
30
30
  ## 内容与本机状态分开恢复
31
31
 
32
32
  Markdown、`_空间.md`、`_领域.md` 和 `.campfire.yaml` 是可移植事实。新设备通过 setup 接入已有目录,再显式绑定无法恢复的源码本机路径。
33
- 文档/拓扑索引可以重建;同一 SQLite 中还有注册、路径绑定和运行记录,不能把整个 `campfire.db` 当作可随意删除的缓存。`workspace rebuild` 不是“恢复删除笔记”。
33
+ `~/.campfire/local.yaml` 保存 Vault 注册、默认选择和仓库本机绑定;remote 和项目元数据只保存在 Vault 根目录 `.campfire.yaml`。停止所有 Campfire 操作后可删除 `campfire.db`、`campfire.db-wal` 与 `campfire.db-shm`,通过查询或 setup 重建;未执行计划重新生成并重新审批。文件操作失败恢复未完成时先核对与恢复文件,不清理证据。`workspace rebuild` 不是“恢复删除笔记”。
34
34
 
35
- 需要备份本机状态时,先退出所有 Campfire 进程并暂停写入,再复制整个实际 CAMPFIRE_HOME 目录;不要在写入中只复制 SQLite 主文件而漏掉 WAL。恢复前保留当前状态,停止进程,使用一致快照恢复,并核对 CLI/数据库版本;不承诺跨版本直接降级。
35
+ 需要备份本机状态时,先退出所有 Campfire 进程并暂停写入,再复制整个实际 CAMPFIRE_HOME 目录;不要在写入中只复制 SQLite 主文件而漏掉 WAL。恢复前保留当前状态,停止进程,使用一致快照恢复,并核对 CLI 和当前配置结构;产品不读取旧格式或运行历史迁移。
36
36
 
37
37
  ## 卸载与停止治理
38
38
 
@@ -1,12 +1,11 @@
1
1
  [project]
2
2
  name = "campfire-cli"
3
- version = "0.2.0"
3
+ version = "0.2.1"
4
4
  description = "Local-first shared context and governance CLI for humans and agents"
5
5
  readme = "README.md"
6
6
  license = "MIT"
7
7
  requires-python = ">=3.12"
8
8
  dependencies = [
9
- "alembic>=1.13",
10
9
  "packaging>=24",
11
10
  "psutil>=7.2.2",
12
11
  "pydantic>=2.7",
@@ -1,3 +1,3 @@
1
1
  """Campfire CLI package."""
2
2
 
3
- __version__ = "0.2.0"
3
+ __version__ = "0.2.1"
@@ -10,7 +10,7 @@ from campfire_cli.app.document.repository.document_profile_repository import (
10
10
  from campfire_cli.app.document.service.rules.document_profile_service import (
11
11
  DocumentProfileService,
12
12
  )
13
- from campfire_cli.app.workspace.repository.workspace_repository import SqliteWorkspaceRepository
13
+ from campfire_cli.app.workspace.repository.workspace_repository import FilesystemWorkspaceRepository
14
14
  from campfire_cli.app.workspace.service.workspace_service import WorkspaceService
15
15
  from campfire_cli.common.cli_output import emit, invoke
16
16
  from campfire_cli.common.filesystem.cwd import safe_cwd
@@ -25,7 +25,7 @@ profile_cli = typer.Typer(
25
25
  def service(ctx: typer.Context) -> DocumentProfileService:
26
26
  selector = ctx.find_root().params.get("workspace")
27
27
  root = campfire_home()
28
- resolution = WorkspaceService(root, SqliteWorkspaceRepository(root)).resolve(
28
+ resolution = WorkspaceService(root, FilesystemWorkspaceRepository(root)).resolve(
29
29
  selector, safe_cwd()
30
30
  )
31
31
  settings = WorkspaceSettings.load(resolution.workspace_id, Path(resolution.workspace))
@@ -8,7 +8,7 @@ from campfire_cli.app.document.repository.document_type_repository import (
8
8
  DocumentTypeRepository,
9
9
  )
10
10
  from campfire_cli.app.document.service.rules.document_type_service import DocumentTypeService
11
- from campfire_cli.app.workspace.repository.workspace_repository import SqliteWorkspaceRepository
11
+ from campfire_cli.app.workspace.repository.workspace_repository import FilesystemWorkspaceRepository
12
12
  from campfire_cli.app.workspace.service.workspace_service import WorkspaceService
13
13
  from campfire_cli.common.cli_output import emit, invoke
14
14
  from campfire_cli.common.filesystem.cwd import safe_cwd
@@ -23,7 +23,7 @@ type_cli = typer.Typer(
23
23
  def service(ctx: typer.Context) -> DocumentTypeService:
24
24
  selector = ctx.find_root().params.get("workspace")
25
25
  root = campfire_home()
26
- resolution = WorkspaceService(root, SqliteWorkspaceRepository(root)).resolve(
26
+ resolution = WorkspaceService(root, FilesystemWorkspaceRepository(root)).resolve(
27
27
  selector, safe_cwd()
28
28
  )
29
29
  settings = WorkspaceSettings.load(resolution.workspace_id, Path(resolution.workspace))
@@ -101,6 +101,7 @@ class DocumentIndexResult(BaseModel):
101
101
  document_count: int
102
102
  edge_count: int
103
103
  changed_document_count: int
104
+ content_changed_document_count: int = 0
104
105
  full_rebuild: bool
105
106
 
106
107
 
@@ -243,6 +243,12 @@ class DocumentIndexService:
243
243
  document_count=document_count,
244
244
  edge_count=edge_count,
245
245
  changed_document_count=len(changed) + len(deleted),
246
+ content_changed_document_count=sum(
247
+ relative not in existing
248
+ or records[relative].content_hash != existing[relative].content_hash
249
+ for relative in changed
250
+ )
251
+ + len(deleted),
246
252
  full_rebuild=full,
247
253
  )
248
254
 
@@ -56,7 +56,17 @@ class MaintenanceResult(BaseModel):
56
56
  total_issue_count: int = 0
57
57
  issues: list[Issue] = Field(default_factory=list)
58
58
  changed_document_count: int = 0
59
- indexed_document_count: int = 0
59
+ indexed_document_count: int = Field(
60
+ default=0, description="Current Workspace index total, not this run's count"
61
+ )
62
+ index_available: bool | None = None
63
+ index_generation: int | None = None
64
+ index_processed_document_count: int = 0
65
+ index_content_changed_document_count: int = 0
66
+ index_full_rebuild: bool = False
67
+ write_performed_scope: str = "markdown-files"
68
+ checked_relations: str = "related_docs"
69
+ body_links_checked: bool = False
60
70
  generated_file_count: int = 0
61
71
  write_performed: bool = False
62
72
  blocked_phase: str | None = None
@@ -123,7 +123,13 @@ class MaintenanceService:
123
123
  if changed:
124
124
  return self._concurrent_result(changed)
125
125
  self._repository.replace_current_state(issues, spaces, domains)
126
- self._document_index.rebuild()
126
+ index = self._document_index.rebuild()
127
+ result.index_available = True
128
+ result.indexed_document_count = index.document_count
129
+ result.index_generation = index.generation
130
+ result.index_processed_document_count = index.changed_document_count
131
+ result.index_content_changed_document_count = index.content_changed_document_count
132
+ result.index_full_rebuild = index.full_rebuild
127
133
  self._repository.save_run(run)
128
134
  self._export_current_report(result, completed_at)
129
135
  selected = filter_issues(
@@ -141,6 +147,12 @@ class MaintenanceService:
141
147
  issue_count=len(selected_issues),
142
148
  total_issue_count=len(issues),
143
149
  issues=[] if summary else selected_issues,
150
+ index_available=True,
151
+ indexed_document_count=index.document_count,
152
+ index_generation=index.generation,
153
+ index_processed_document_count=index.changed_document_count,
154
+ index_content_changed_document_count=index.content_changed_document_count,
155
+ index_full_rebuild=index.full_rebuild,
144
156
  issue_counts=self._issue_counts(selected_issues),
145
157
  scope=scope,
146
158
  workspace_status=result.status,
@@ -195,10 +207,7 @@ class MaintenanceService:
195
207
  for issue in issues
196
208
  if scope == "."
197
209
  or self._path_matches_scope(issue["path"], scope)
198
- or (
199
- issue["code"] == "duplicate-domain-id"
200
- and issue.get("actual") in scoped_ids
201
- )
210
+ or (issue["code"] == "duplicate-domain-id" and issue.get("actual") in scoped_ids)
202
211
  ]
203
212
  if issues:
204
213
  return MaintenanceResult(
@@ -227,7 +236,8 @@ class MaintenanceService:
227
236
  domain.id: governance_sync.direct_templates(domain) for domain in domains
228
237
  }
229
238
  try:
230
- indexed_document_count = self._document_index.reconcile().document_count
239
+ index = self._document_index.reconcile()
240
+ indexed_document_count = index.document_count
231
241
  except AppError as exc:
232
242
  return self._sync_failure(exc, "document-index", scope)
233
243
  for domain in sorted(domains, key=lambda item: item.id):
@@ -314,6 +324,11 @@ class MaintenanceService:
314
324
  document_count=note_count,
315
325
  issue_count=0,
316
326
  indexed_document_count=indexed_document_count,
327
+ index_available=True,
328
+ index_generation=index.generation,
329
+ index_processed_document_count=index.changed_document_count,
330
+ index_content_changed_document_count=index.content_changed_document_count,
331
+ index_full_rebuild=index.full_rebuild,
317
332
  generated_file_count=len(changes),
318
333
  write_performed=bool(changes and not dry_run),
319
334
  operations=operations,
@@ -435,7 +450,15 @@ class MaintenanceService:
435
450
  return [Issue(code="inbox-missing", path=inbox.name)]
436
451
  requests = self._settings.vault_root / self._settings.governance["human_request_root"]
437
452
  if not requests.is_dir():
438
- return [Issue(code="human-request-root-missing", path=requests.name)]
453
+ return [
454
+ Issue(
455
+ code="human-request-root-missing",
456
+ path=requests.relative_to(self._settings.vault_root).as_posix(),
457
+ field="governance.human_request_root",
458
+ actual=str(requests),
459
+ detail=f"Expected configured directory: {requests}",
460
+ )
461
+ ]
439
462
  return []
440
463
 
441
464
  @staticmethod
@@ -1,10 +1,10 @@
1
1
  # Workspace App SPEC
2
2
 
3
- 本模块管理 Workspace、Space、Domain、Project 注册表和 Workspace 初始化。`.campfire.yaml` 保存可移植的 Workspace、Project 身份和 Project 到根 Domain 的稳定绑定;`CAMPFIRE_HOME/campfire.db` 保存本机路径及其查询投影,不得反向覆盖 Manifest。路径只是可变定位信息。每个 Workspace 只保留配置与人类可审阅的运行产物,不拥有独立数据库。所有工具状态均位于 `CAMPFIRE_HOME`,不得向目标 Workspace 创建工具状态目录。
3
+ 本模块管理 Workspace、Space、Domain、Project 注册表和 Workspace 初始化。`.campfire.yaml` 保存可移植的 Workspace、Project 身份和 Project 到根 Domain 的稳定绑定;`CAMPFIRE_HOME/local.yaml` 保存本机 Vault 路径、默认选择与仓库路径绑定;SQLite 只保存可重建投影,不得反向覆盖 `.campfire.yaml` 或 `local.yaml`。路径只是可变定位信息。每个 Workspace 只保留配置与人类可审阅的运行产物,不拥有独立数据库。所有工具状态均位于 `CAMPFIRE_HOME`,不得向目标 Workspace 创建工具状态目录。
4
4
 
5
5
  解析优先级为根级显式 `--workspace <id>`、当前目录所属的已注册 Workspace、默认 Workspace。显式值只接受稳定 Workspace id,不接受路径;叶命令不得重复暴露 Workspace 选择器。写操作仍由具体业务模块执行。
6
6
 
7
- `campfire setup --path <path>` 根据 Manifest 接入已有 Workspace;缺少 Manifest 时必须提供 `--id` 以创建首份 Manifest。`workspace create` 要求目标路径不存在,并创建全局收件箱、带 `_空间.md` 的知识/工作 Space 和治理视图基础目录。两者写入全局 SQLite 注册表,不向 Workspace 写工具状态。
7
+ `campfire setup --path <path>` 根据 Manifest 接入已有 Workspace;缺少 Manifest 时必须提供 `--id` 以创建首份 Manifest。`workspace create` 要求目标路径不存在,并创建全局收件箱、带 `_空间.md` 的知识/工作 Space 和治理视图基础目录。两者写入 `CAMPFIRE_HOME/local.yaml` 的本机注册,不向 Workspace 写工具状态。
8
8
 
9
9
  `workspace create` 从包内 `resources/workspace/` 一次性写入 `_模板/README.md`、任务与版本发布清单模板;日期取创建当天,模板内容仍属于 template,不生成实际任务或发布计划。落地后由用户维护,setup、upgrade 和资源同步均不补写或覆盖。模板不是持续托管的 Base/Skill,不增加同步命令、注册表或正文校验。
10
10
 
@@ -30,4 +30,10 @@ Project 是 Workspace 连接的外部工作资源,记录稳定 id、显示名
30
30
 
31
31
  `project create --path` 用于新 Project onboarding,默认只返回计划,追加 `--confirm` 后通过 Domain Service 创建工作 Space 内的项目根 Domain 并注册 Project。初始化不虚构业务子领域;已存在文档中心使用 `project adopt --domain <id>` 接入,更新只提交显式给出的字段。
32
32
 
33
- 注册数据只通过 CLI 和 SQLite 维护。JSON 仅用于显式 export/import;import 默认只预检,必须使用 `--confirm` 才替换当前注册数据。不读取旧 JSON 注册表,不维护双事实源。
33
+ 注册数据由 CLI 写入 `.campfire.yaml` 和 `local.yaml`,查询按稳定 id 合并两者;不在 SQLite 维护注册事实。JSON 仅用于显式 export/import;import 默认只预检,必须使用 `--confirm` 才替换当前注册数据。不读取旧 JSON 注册表,不维护双事实源。
34
+
35
+ ## 多仓库注册
36
+
37
+ Project 可有零到多个仓库,每个仓库使用 Project 内唯一的稳定 id;role、remote、默认分支是便携元数据,local_path 是设备绑定,不进入 Manifest。`.campfire.yaml`、`local.yaml` 和注册备份只支持当前结构,不带 schema_version、不读取旧单仓库字段;无格式转换和数据库迁移链。Project 没有顶层仓库字段。
38
+
39
+ create/adopt 的 repositories 是初始列表;update 按 repository id 新增、更新、解绑或移除一项,默认预览,confirm 必须复核 Project 与 Manifest 哈希,不删除源码文件。单仓库与多仓库共用仓库列表接口,bind 必须指定仓库 id,不隐式选取首项。共享 remote 与嵌套路径允许登记;resolve 保留最深本机路径规则,同深度多绑定返回 ambiguous,remote 仅是候选。setup 按稳定仓库 id 保留本机绑定并逐项报告未绑定入口,不猜测路径。