campfire-cli 0.2.0a2__tar.gz → 0.2.2__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 (273) hide show
  1. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/ARCHITECTURE.md +12 -8
  2. campfire_cli-0.2.2/CHANGELOG.md +59 -0
  3. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/PKG-INFO +87 -18
  4. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/README.md +86 -15
  5. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/SPEC.md +16 -3
  6. campfire_cli-0.2.2/docs/git-sync.md +65 -0
  7. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/docs/quickstart.md +2 -2
  8. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/docs/safety.md +3 -3
  9. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/pyproject.toml +2 -3
  10. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/__init__.py +1 -1
  11. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/cli/profile_cli.py +2 -2
  12. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/cli/type_cli.py +2 -2
  13. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/schema/document_schema.py +1 -0
  14. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/index/document_index_service.py +6 -0
  15. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/maintenance/SPEC.md +3 -1
  16. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/maintenance/schema/maintenance_schema.py +12 -2
  17. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/maintenance/service/maintenance_service.py +33 -20
  18. campfire_cli-0.2.2/src/campfire_cli/app/maintenance/service/moc_service.py +96 -0
  19. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/cli/video_cli.py +15 -25
  20. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/schema/video_schema.py +16 -18
  21. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/service/video_service.py +104 -125
  22. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/SPEC.md +18 -4
  23. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/cli/domain_cli.py +0 -8
  24. campfire_cli-0.2.2/src/campfire_cli/app/workspace/cli/git_cli.py +31 -0
  25. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/cli/project_cli.py +96 -26
  26. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/cli/workspace_cli.py +12 -6
  27. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/repository/manifest_repository.py +4 -1
  28. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/repository/restructure_repository.py +1 -0
  29. campfire_cli-0.2.2/src/campfire_cli/app/workspace/repository/workspace_repository.py +141 -0
  30. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/schema/workspace_schema.py +59 -21
  31. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/adoption_service.py +5 -24
  32. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/domain_restructure_service.py +6 -33
  33. campfire_cli-0.2.2/src/campfire_cli/app/workspace/service/git_sync_service.py +214 -0
  34. campfire_cli-0.2.2/src/campfire_cli/app/workspace/service/project_service.py +543 -0
  35. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/structure_service.py +2 -29
  36. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/workspace_protocol.py +0 -2
  37. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/workspace_service.py +47 -39
  38. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/agent_hints.py +14 -2
  39. campfire_cli-0.2.2/src/campfire_cli/common/database/__init__.py +7 -0
  40. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/database/models.py +0 -22
  41. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/documents/frontmatter_schema.py +2 -3
  42. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/documents/related_docs.py +1 -0
  43. campfire_cli-0.2.2/src/campfire_cli/common/git.py +43 -0
  44. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/governance/issues.py +4 -2
  45. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/media/media_worker.py +0 -49
  46. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/reports/markdown_report.py +4 -0
  47. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/config/SPEC.md +1 -1
  48. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/container.py +24 -10
  49. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/main.py +23 -1
  50. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/defaults/config.yml +7 -31
  51. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/SPEC.md +1 -0
  52. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-context-bootstrap/SKILL.md +3 -3
  53. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-document-capture/SKILL.md +14 -2
  54. campfire_cli-0.2.2/src/campfire_cli/resources/skills/campfire-video-capture/SKILL.md +72 -0
  55. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-workspace-adoption/SKILL.md +2 -2
  56. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/SKILL.md +12 -1
  57. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-workspace-onboarding/SKILL.md +14 -9
  58. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  59. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/conftest.py +3 -3
  60. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_cli.py +2 -2
  61. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_domain_rename_sync.py +7 -11
  62. campfire_cli-0.2.2/tests/integration/test_git_sync.py +247 -0
  63. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_json_discovery.py +3 -6
  64. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_profile_resolution.py +0 -2
  65. campfire_cli-0.2.2/tests/integration/test_project_repositories.py +342 -0
  66. campfire_cli-0.2.2/tests/integration/test_rebuildable_storage.py +242 -0
  67. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_relation_pages_cli.py +0 -2
  68. campfire_cli-0.2.2/tests/integration/test_setup_diagnostics.py +143 -0
  69. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_skill_examples.py +0 -2
  70. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/perf/test_read_counts.py +1 -1
  71. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/perf/test_resolve_subprocess_count.py +5 -4
  72. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_document_apply.py +4 -4
  73. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_document_index.py +5 -5
  74. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_domain_paths.py +0 -4
  75. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_generated_regions.py +21 -9
  76. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_video.py +131 -56
  77. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_workspace_manifest.py +1 -3
  78. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/uv.lock +2 -166
  79. campfire_cli-0.2.0a2/CHANGELOG.md +0 -33
  80. campfire_cli-0.2.0a2/src/campfire_cli/alembic/__init__.py +0 -1
  81. campfire_cli-0.2.0a2/src/campfire_cli/alembic/env.py +0 -37
  82. campfire_cli-0.2.0a2/src/campfire_cli/alembic/script.py.mako +0 -22
  83. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/001_initial_schema.py +0 -81
  84. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/002_workspace_project_registry.py +0 -47
  85. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/003_unified_workspace_state.py +0 -113
  86. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/004_restructure_workspace_domain.py +0 -23
  87. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/005_decision_channel.py +0 -71
  88. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/006_workspace_topology_index.py +0 -61
  89. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/007_workspace_adoption.py +0 -38
  90. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/008_remove_adoption_batches.py +0 -16
  91. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/009_document_query_index.py +0 -84
  92. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/010_project_domain_identity.py +0 -39
  93. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/011_document_state_model.py +0 -39
  94. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/012_remove_decision_channel.py +0 -17
  95. campfire_cli-0.2.0a2/src/campfire_cli/alembic/versions/__init__.py +0 -1
  96. campfire_cli-0.2.0a2/src/campfire_cli/app/maintenance/service/moc_service.py +0 -145
  97. campfire_cli-0.2.0a2/src/campfire_cli/app/workspace/repository/workspace_repository.py +0 -157
  98. campfire_cli-0.2.0a2/src/campfire_cli/app/workspace/service/project_service.py +0 -437
  99. campfire_cli-0.2.0a2/src/campfire_cli/common/database/__init__.py +0 -4
  100. campfire_cli-0.2.0a2/src/campfire_cli/common/database/migrations.py +0 -18
  101. campfire_cli-0.2.0a2/src/campfire_cli/resources/skills/campfire-video-capture/SKILL.md +0 -79
  102. campfire_cli-0.2.0a2/tests/unit/test_migrations.py +0 -51
  103. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  104. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  105. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  106. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/.github/workflows/ci.yml +0 -0
  107. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/.github/workflows/release.yml +0 -0
  108. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/.gitignore +0 -0
  109. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/.python-version +0 -0
  110. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/AGENTS.md +0 -0
  111. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/COMMAND.md +0 -0
  112. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/CONTRIBUTING.md +0 -0
  113. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/DECISIONS.md +0 -0
  114. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/LICENSE +0 -0
  115. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/SECURITY.md +0 -0
  116. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/alembic/SPEC.md +0 -0
  117. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/alembic/env.py +0 -0
  118. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/alembic/script.py.mako +0 -0
  119. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/alembic/versions/001_initial_schema.py +0 -0
  120. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/alembic.ini +0 -0
  121. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/scripts/SPEC.md +0 -0
  122. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/scripts/pypi_verify.py +0 -0
  123. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/scripts/quality_check.py +0 -0
  124. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/scripts/release_check.py +0 -0
  125. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/SPEC.md +0 -0
  126. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/__init__.py +0 -0
  127. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/base/SPEC.md +0 -0
  128. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/base/__init__.py +0 -0
  129. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/base/cli/base_cli.py +0 -0
  130. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/base/repository/base_repository.py +0 -0
  131. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/base/schema/base_schema.py +0 -0
  132. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/base/schema/operation_schema.py +0 -0
  133. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/base/service/base_service.py +0 -0
  134. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/SPEC.md +0 -0
  135. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/__init__.py +0 -0
  136. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/cli/__init__.py +0 -0
  137. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/cli/document_cli.py +0 -0
  138. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/repository/__init__.py +0 -0
  139. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/repository/document_index_repository.py +0 -0
  140. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/repository/document_profile_repository.py +0 -0
  141. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/repository/document_type_repository.py +0 -0
  142. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/schema/__init__.py +0 -0
  143. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/__init__.py +0 -0
  144. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/document_scanner.py +0 -0
  145. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/document_service.py +0 -0
  146. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/index/__init__.py +0 -0
  147. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/index/document_index_builder.py +0 -0
  148. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/index/document_index_protocol.py +0 -0
  149. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/mutation/__init__.py +0 -0
  150. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/mutation/document_apply_service.py +0 -0
  151. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/mutation/document_move_service.py +0 -0
  152. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/mutation/document_relocation.py +0 -0
  153. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/mutation/frontmatter_apply.py +0 -0
  154. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/__init__.py +0 -0
  155. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/document_patch_values.py +0 -0
  156. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/document_profile_service.py +0 -0
  157. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/document_rule_service.py +0 -0
  158. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/document_type_service.py +0 -0
  159. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/frontmatter_formatter.py +0 -0
  160. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/frontmatter_plan.py +0 -0
  161. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/kanban_service.py +0 -0
  162. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/profile_candidates.py +0 -0
  163. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/profile_registry.py +0 -0
  164. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/document/service/rules/type_plan.py +0 -0
  165. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/maintenance/__init__.py +0 -0
  166. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/maintenance/cli/maintenance_cli.py +0 -0
  167. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/maintenance/repository/maintenance_repository.py +0 -0
  168. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/maintenance/service/maintenance_protocol.py +0 -0
  169. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/skill/SPEC.md +0 -0
  170. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/skill/__init__.py +0 -0
  171. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/skill/cli/skill_cli.py +0 -0
  172. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/skill/repository/skill_repository.py +0 -0
  173. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/skill/schema/skill_schema.py +0 -0
  174. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/skill/service/skill_service.py +0 -0
  175. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/SPEC.md +0 -0
  176. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/__init__.py +0 -0
  177. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/cli/__init__.py +0 -0
  178. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/schema/__init__.py +0 -0
  179. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/service/__init__.py +0 -0
  180. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/video/service/video_protocol.py +0 -0
  181. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/__init__.py +0 -0
  182. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/cli/__init__.py +0 -0
  183. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/cli/config_cli.py +0 -0
  184. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/cli/restructure_cli.py +0 -0
  185. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/cli/space_cli.py +0 -0
  186. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/repository/__init__.py +0 -0
  187. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/schema/__init__.py +0 -0
  188. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/schema/adoption_schema.py +0 -0
  189. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/schema/restructure_schema.py +0 -0
  190. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/__init__.py +0 -0
  191. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/config_service.py +0 -0
  192. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/restructure_protocol.py +0 -0
  193. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/restructure_service.py +0 -0
  194. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/app/workspace/service/restructure_verifier.py +0 -0
  195. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/SPEC.md +0 -0
  196. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/__init__.py +0 -0
  197. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/cli_output.py +0 -0
  198. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/database/session.py +0 -0
  199. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/documents/__init__.py +0 -0
  200. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/documents/document_types.py +0 -0
  201. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/documents/domain_context.py +0 -0
  202. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/documents/frontmatter_format.py +0 -0
  203. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/documents/markdown.py +0 -0
  204. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/exceptions/__init__.py +0 -0
  205. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/exceptions/base.py +0 -0
  206. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/filesystem/__init__.py +0 -0
  207. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/filesystem/atomic.py +0 -0
  208. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/filesystem/change_set.py +0 -0
  209. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/filesystem/cwd.py +0 -0
  210. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/filesystem/locking.py +0 -0
  211. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/filesystem/plan.py +0 -0
  212. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/governance/__init__.py +0 -0
  213. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/governance/locking.py +0 -0
  214. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/governance/snapshots.py +0 -0
  215. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/hashing.py +0 -0
  216. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/media/__init__.py +0 -0
  217. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/media/media_backend.py +0 -0
  218. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/media/model_download.py +0 -0
  219. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/media/video_runtime.py +0 -0
  220. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/package_version.py +0 -0
  221. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/reports/__init__.py +0 -0
  222. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/common/reports/json_report.py +0 -0
  223. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/config/defaults.py +0 -0
  224. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/config/settings.py +0 -0
  225. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/__init__.py +0 -0
  226. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/bases/SPEC.md +0 -0
  227. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  228. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  229. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  230. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  231. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/bases//346/226/207/346/241/243/345/267/245/344/275/234/345/217/260.base" +0 -0
  232. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/defaults/__init__.py +0 -0
  233. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/TEMPLATE.md +0 -0
  234. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-context-bootstrap/agents/openai.yaml +0 -0
  235. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-conversation-router/SKILL.md +0 -0
  236. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-conversation-router/agents/openai.yaml +0 -0
  237. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-conversation-router/references/inbox-handoff.md +0 -0
  238. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-conversation-router/references/learning-intake.md +0 -0
  239. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-conversation-router/references/task-intake.md +0 -0
  240. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  241. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  242. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  243. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  244. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  245. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-inbox-triage/SKILL.md +0 -0
  246. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-kanban-board/SKILL.md +0 -0
  247. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-task-management/SKILL.md +0 -0
  248. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/SKILL.md +0 -0
  249. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/agents/openai.yaml +0 -0
  250. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-workspace-restructure/SKILL.md +0 -0
  251. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/skills/campfire-workspace-restructure/references/restructure-spec.md +0 -0
  252. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277/README.md" +0 -0
  253. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  254. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/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
  255. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/SPEC.md +0 -0
  256. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_quickstart.py +0 -0
  257. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/integration/test_workspace_templates.py +0 -0
  258. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_agent_hints.py +0 -0
  259. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_atomic_write.py +0 -0
  260. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_base_service.py +0 -0
  261. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_config.py +0 -0
  262. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_document_scanner.py +0 -0
  263. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_domain_context.py +0 -0
  264. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_file_change_executor.py +0 -0
  265. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_frontmatter.py +0 -0
  266. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_kanban_service.py +0 -0
  267. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_operation_schema.py +0 -0
  268. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_package_version.py +0 -0
  269. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_pypi_verify.py +0 -0
  270. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_related_docs.py +0 -0
  271. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_release_check.py +0 -0
  272. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_repository_boundaries.py +0 -0
  273. {campfire_cli-0.2.0a2 → campfire_cli-0.2.2}/tests/unit/test_video_runtime.py +0 -0
@@ -46,7 +46,7 @@ Task Channel 是未来演进设想,借鉴 Go 的原则:**Do not communicate
46
46
 
47
47
  ## 4. 系统架构
48
48
 
49
- 本地视频能力由 `app/video` 承担素材准备与交付校验,`common/media` 提供模型下载、媒体解码与抽帧机制;可选原生处理依赖在独立子进程中延迟加载。`AppContainer.deliver_video` 组合文档治理检查与视频交付,不让 Video Service 调用 Document Service。文档结构仍由 `document apply` 创建,正文和二进制图片复用文件变更集及乐观锁;没有新的数据库、独立下载服务或模型调度器。语义整理留给宿主 Agent 与内置 Skill,结构检查不等于语义保真验收。
49
+ 本地视频能力由 `app/video` 承担素材准备与交付校验,`common/media` 提供模型下载、媒体探测与语音转写机制;可选原生处理依赖在独立子进程中延迟加载。`AppContainer.deliver_video` 组合文档治理检查与视频交付,不让 Video Service 调用 Document Service。文档结构仍由 `document apply` 创建,正文复用文件变更集及乐观锁;没有新的数据库、独立下载服务或模型调度器。语义整理留给宿主 Agent 与内置 Skill,结构检查不等于语义保真验收。
50
50
 
51
51
  ```text
52
52
  人类 / Codex / Claude Code / 其他 Agent
@@ -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
  ```
@@ -102,11 +102,11 @@ video setup:统一初始化预览,不联网、不落盘
102
102
  |
103
103
  v
104
104
  离线媒体子进程(复用已就绪环境)
105
- +-- PyAV + Pillow:解码与截图
105
+ +-- PyAV:媒体探测与音频解码
106
106
  +-- faster-whisper + CTranslate2:CPU int8 转写
107
107
  |
108
108
  v
109
- 素材包 -> Agent 核验与整理 -> 文档 + assets
109
+ 文字素材 -> Agent 校订 / 按用途成文 -> Markdown 正文
110
110
  ```
111
111
 
112
112
  `CAMPFIRE_HOME` 默认是各平台用户目录下的 `.campfire`,统一相对布局而非绝对路径;显式 `--model` 可覆盖模型位置。模型权重是用户级本地资源,Python 依赖属于 Campfire 安装环境,两者都不随 Vault 同步。公开模型下载不需要 Hugging Face Token,转写不调用云端模型;Agent 整理内容仍使用宿主自身的模型服务,不能把整条链路称为完全离线。
@@ -203,12 +203,12 @@ 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
- SQLite 中的 Workspace 与 Project 注册数据是结构化事实,文档索引可以从 Markdown 重建;SQLite 不是知识内容的 SSOT。工具状态不写入 Workspace,因而一个 Campfire 安装可以管理多个 Workspace。
211
+ Vault 根目录 `.campfire.yaml` 和本机 `~/.campfire/local.yaml` 保存注册事实;SQLite 全部可重建,不是知识内容或注册数据的 SSOT。工具状态不写入 Workspace,因而一个 Campfire 安装可以管理多个 Workspace。
212
212
 
213
213
  ### 文档查询投影
214
214
 
@@ -264,7 +264,7 @@ Adoption 是首次接管边界,不属于日常 Maintenance。`workspace domain
264
264
 
265
265
  ## 6. 可选阅读环境与未来交付
266
266
 
267
- 当前公共入口是 CLI,没有已交付的 Web 工作台或独立 Decision HTTP 状态机。Obsidian 是推荐阅读工具,不是 CLI 的强依赖;Bases、大纲和可选 Kanban 负责相应展示,普通 Markdown 和文档查询不依赖这些组件。Obsidian Git 可辅助版本历史,CLI 不另建备份系统。
267
+ 当前公共入口是 CLI,没有已交付的 Web 工作台或独立 Decision HTTP 状态机。Obsidian 是推荐阅读工具,不是 CLI 的强依赖;Bases、大纲和可选 Kanban 负责相应展示,普通 Markdown 和文档查询不依赖这些组件。Vault 可选用 `workspace git sync` 获取、提交、合并与推送,系统调度器按用户授权定时调用;不依赖 Obsidian Git,不内置备份平台或常驻服务。
268
268
 
269
269
  如未来增加其他交付适配器,必须复用 Application Service,不复制治理规则;这不是当前版本的交付承诺。插件配置教程由维护者后续博客说明,不在 CLI 内实现安装器或配置管理。
270
270
 
@@ -282,3 +282,7 @@ 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 无注册事实、无历史迁移链,只从当前文件生成投影;停止运行中的操作后可整库删除重建。
287
+
288
+ 领域分类与 Project 归属不决定治理方式。所有领域共用结构、检查与 MOC 生成;Project 只关联仓库便携信息与本机位置,Domain 不保存 governance 字段。
@@ -0,0 +1,59 @@
1
+ # 版本记录
2
+
3
+ ## 0.2.2 — 发布候选
4
+
5
+ - 新增可选 workspace git sync:默认预览,确认后 fetch、提交、合并与 push;失败保留本地提交,冲突停止并报告,定时运行交给系统调度。
6
+ - 所有领域共用父子结构、检查和 MOC 文档列表规则;删除 Domain governance 字段、--governance 参数、项目专用 MOC 生成器及 moc.project_groups 配置。
7
+ - Project 关联只负责归属与仓库定位;全局 governance 系统目录设置保留。已有 Vault 由 Agent 备份整理领域声明并重建 SQLite,不包含格式兼容或迁移链。
8
+ - 按用户要求保持补丁版本编号,本次包含新增能力与明确的配置/参数破坏性变化。尚未发布。
9
+
10
+ ## 0.2.1 — 2026-10-10
11
+
12
+ - Project 支持多个稳定 id 的仓库,逐仓库绑定、更新、解绑、移除、识别及漂移检查;单仓库与多仓库统一接口,不保留旧参数或 Project 顶层仓库字段。
13
+ - 本机注册与路径绑定独立保存于 ~/.campfire/local.yaml,项目便携信息读取 Vault 根目录 .campfire.yaml。SQLite 全部是可重建投影;删除历史迁移链、Alembic 依赖、旧格式转换与注册格式版本字段。已有用户由 Agent 备份并整理持久文件后删除旧数据库重建,不支持旧状态自动升级。
14
+ - setup 默认输出资源摘要,--verbose 保留逐文件明细;健康与未绑定状态、下一步指引更明确。
15
+ - 索引结果区分当前总量、本次处理量、内容变化与快照可用性;修复 check/rebuild 重建后统计仍为零的输出。
16
+ - 补齐失效 related_docs、待确认目录缺失的定位与修复说明;明确治理检查不覆盖正文链接。
17
+ - capture 合并写作依据并增加五条正文原则;Agent Hint 与相关 Skill 提供未知文档类型的发现入口,不固定重复查询。
18
+ - 文档删除继续使用用户授权的文件工具,不新增 document delete。
19
+ - 0.2.1 版本号按本轮用户明确决定采用,作为新增能力通常使用次版本规则的例外。
20
+
21
+ ## 0.2.0 — 2026-10-09
22
+
23
+ - 视频文字流程支持校订转写稿和按用途整理成文,保留来源、时间定位与取舍说明。
24
+ - 草稿版本 2 分别校验校订稿顺序覆盖及文章来源映射;同源不同目标可交付,已有正文与并发输入变化拒绝覆盖。
25
+ - 移除 video frames、自动截图与图片附件交付、Pillow 直接依赖及图像配置。旧配置忽略并报告;Alpha 素材只读使用文字部分,旧草稿须按版本 2 重写。历史文档、附件、模型及素材不清理。
26
+ - 内置 Skill、命令帮助及说明同步为纯文字流程。正式版验收范围为 Codex,Claude Code 宿主未验证。
27
+
28
+
29
+ 只记录有提交或发布证据的变化,不补写无法核实的历史。未发布条目不代表已可从 PyPI 安装。
30
+
31
+ ## 0.2.0a2 - 2026-10-05(Alpha 预发布)
32
+
33
+ `0.2.0a1` 仅保留为未公开的本地候选标签;首次公开 Alpha 使用 `0.2.0a2`,包含最终素材目录约定。
34
+
35
+ - 首个视频能力实验预发布,不承诺高可用性,须显式指定版本安装。
36
+ - 公共输出统一为 JSON;`--help`、`version`、`tree` 不再输出文本,旧版本读取脚本需改读 JSON 字段;移除文本 shell 补全入口。
37
+
38
+ - 新增可选本地视频素材、时间戳转写、候选截图与指定时间补帧能力。
39
+ - 中间素材默认保存到 `<CAMPFIRE_HOME>/materials/<视频SHA-256>/`,支持 `--output` 覆盖;原视频不复制,交付后的图文不依赖素材目录。
40
+ - `video setup` 一次确认安装视频依赖、准备默认模型并验证加载;`prepare` 仅处理视频。模型统一存放于 Campfire 用户目录,已有资源复用,支持显式本地路径。
41
+ - 新增视频整理 Skill、草稿覆盖校验和受管空正文图文交付,不自动覆盖人工内容。
42
+ - 本轮不包含视频 URL 解析或下载;Codex 已用真实本地视频完成图文链路,Claude Code 实际验收延期。
43
+
44
+ ## 0.1.25 - 2026-10-03
45
+
46
+ - 整理公开文档与 Agent 提示词,修正旧关系页、Profile 和模板说明。
47
+ - 增加隔离上手、安全恢复与卸载指引、贡献及反馈入口。
48
+ - Obsidian 仅为推荐搭配,插件配置教程不在 CLI 重复维护。
49
+ - 补充包链接和示例验证,不改变领域或文档字段模型。
50
+ - 启用 GitHub 私密安全报告入口;独立用户试用尚未完成。
51
+
52
+ ## 0.1.24 - 2026-10-03
53
+
54
+ - 停止生成 `_generated/相关文档-*.md`,同步时移除 MOC 自动区域的对应入口。
55
+ - 保留 related_docs、关联查询、索引对账及 MOC 其他导航功能。
56
+ - 同步不删除旧生成页或修改人工正文;历史清理需要独立确认。
57
+ - 新增 CLI 进程端到端与回归测试,删除专用关系页展示接口和无调用方辅助函数。
58
+
59
+ [已发布安装包](https://pypi.org/project/campfire-cli/0.1.24/)。仓库重建前的标签和 Actions 记录不再保留。
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: campfire-cli
3
- Version: 0.2.0a2
3
+ Version: 0.2.2
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
@@ -22,7 +21,6 @@ Requires-Dist: av<19,>=14; extra == 'video'
22
21
  Requires-Dist: faster-whisper<2,>=1.1; extra == 'video'
23
22
  Requires-Dist: huggingface-hub<2,>=0.24; extra == 'video'
24
23
  Requires-Dist: markdown-it-py>=3; extra == 'video'
25
- Requires-Dist: pillow>=11; extra == 'video'
26
24
  Description-Content-Type: text/markdown
27
25
 
28
26
  # Campfire
@@ -30,7 +28,7 @@ Description-Content-Type: text/markdown
30
28
  `campfire` 是面向工作与学习场景的本地优先人机协作 CLI。它让人类和多个 Agent 围绕同一份持久共享上下文协作:把口头要求、临时笔记、任务进度、项目资料和长期知识沉淀进可检索、可交接、可审计的 Workspace。
31
29
 
32
30
  - **人类和 Agent 同一条链路**:同一套 CLI 契约 + 全局 Agent Skill,没有两套规则。
33
- - **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;SQLite 保存可重建索引,也保存本机注册与运行状态,不能整体当作缓存删除。
31
+ - **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;`.campfire.yaml` 保存便携项目事实,`~/.campfire/local.yaml` 保存本机注册与绑定;SQLite 全部是可重建状态。
34
32
  - **写操作默认预览**:先计划、再确认、执行前在治理锁内复核内容哈希,检测到输入变化时拒绝覆盖;不承诺外部编辑器遵守锁或跨介质崩溃原子性。
35
33
  - **本地优先**:不绑定云服务、不内置账号;Obsidian 是推荐阅读工具而非强依赖;CLI 可独立治理 Markdown Workspace。
36
34
 
@@ -45,13 +43,11 @@ Description-Content-Type: text/markdown
45
43
 
46
44
  推荐搭配 Obsidian:内置 Bases 展示表格,大纲提供章节导航;Kanban 用于看板,Obsidian Git 用于版本历史。它们不是普通文档查询和治理的前提。Templater、TOC 不作为依赖。插件配置教程等待维护者提供博客链接,不在 CLI 输出或仓库重复编写,也不自动修改插件设置。
47
45
 
48
- ## 本地视频图文(v0.2.0a2 Alpha 实验能力)
46
+ ## 本地视频文字整理(v0.2.0)
49
47
 
50
- 本版统一公共 CLI 输出:成功在 stdout 返回一个 JSON 对象,错误在 stderr 返回一个 JSON 对象并以非零状态退出。`--help` 返回结构化参数,`tree` 返回层级命令树,`version` 返回 `{"status":"ok","version":"0.2.0a2"}`。旧脚本若将版本输出当纯字符串读取,须改读 `version` 字段;不再提供文本帮助或 shell 补全脚本输出。
48
+ 本版统一公共 CLI 输出:成功在 stdout 返回一个 JSON 对象,错误在 stderr 返回一个 JSON 对象并以非零状态退出。`--help` 返回结构化参数,`tree` 返回层级命令树,`version` 返回 `{"status":"ok","version":"0.2.0"}`。旧脚本若将版本输出当纯字符串读取,须改读 `version` 字段;不再提供文本帮助或 shell 补全脚本输出。
51
49
 
52
- 试用预发布版:`uv tool install "campfire-cli==0.2.0a2"`;已有 uv tool 安装可用 `uv tool upgrade "campfire-cli==0.2.0a2"`。Alpha 不是正式稳定版本,不建议替换重要工作环境;先在独立测试目录验收。
53
-
54
- 本功能按实验性质逐步推进,不承诺高可用性、所有媒体兼容性或自动整理结果的准确性;生成内容须经人工或 Agent 核验。实验阶段仍保留只读来源、写入预览和冲突保护。
50
+ 安装正式版:`uv tool install "campfire-cli==0.2.0"`;已有安装使用 `campfire upgrade`。生成内容仍须实际核对,CLI 结构检查不能证明语义保真。
55
51
 
56
52
  本轮只接受本地单视频,不解析抖音、B站或其他 URL。核心 CLI 不依赖视频运行库;首次使用执行 `campfire video setup`,统一预览缺失依赖与默认模型下载,带回 `--expected-plan <摘要> --confirm` 后一次完成安装和模型加载验证。无需 Workspace 或输入视频。视频由 PyAV 解码,无需额外安装 FFmpeg 命令;语音由 faster-whisper 在 CPU 本地转写。PyAV 暂限 `<19`,避免其删除的 `metadata_errors` 参数与当前转写库冲突。
57
53
 
@@ -61,17 +57,23 @@ Description-Content-Type: text/markdown
61
57
 
62
58
  可用 `--model <本地模型目录>` 覆盖默认位置;显式路径缺失或不完整时只报错,不下载或覆盖。已有默认目录不完整时也拒绝覆盖。也可用 `--transcript` 提供时间戳 JSON 数组,格式见命令帮助,此时不需要模型。模型权重目录须含非空的 `model.bin`、`config.json`、`tokenizer.json`;配置与权重能否实际加载仍由转写引擎校验。
63
59
 
64
- 内置 `campfire-video-capture` Skill 引导 Agent 阅读全部转写、查看候选截图、用 `video frames` 补帧并整理草稿。`video inspect` 校验结构和引用,不能证明内容保真;`video deliver` 向已通过治理检查且正文为空的文档交付正文及图片。沿用 `document apply` 创建结构,不覆盖已有人工内容,不自动处理重复来源。
60
+ 内置 `campfire-video-capture` Skill 引导 Agent 阅读全部转写,再按意图生成校订转写稿或用途文章。校订稿保持顺序和有意义细节;文章可重组内容,保留来源映射并说明取舍。术语、数字和画面依赖内容明确标记待核实或回看。无需截图或视觉能力;可选截图建议仅说明用途及参考时段。
61
+
62
+ `video inspect` 校验素材与草稿,不证明内容质量;`video deliver` 向受管空正文交付文字,沿用 `document apply` 创建结构,不覆盖已有人工正文。同源不同目标可分别交付,Agent 仅在用户明确要求时创建第二份。草稿 schema_version=2,包含 output_kind(transcript/article)、title、source_sha256、purpose、sections(title/body/segment_ids)、可选 omissions(segment_ids/reason)与 limitations。ID 为 segments 的零基下标。校订稿须顺序覆盖一次全部片段;文章允许重排,未采用片段需说明取舍。格式与示例见内置 Skill 和 deliver 命令帮助。
63
+
64
+ 默认限制为 4 GiB、2 小时、单次处理 3 小时,配置在内置 config.yml 的 video 分区。支持本地 MP4/MOV、Matroska/WebM、AVI、MPEG-TS,具体解码依赖 PyAV。素材默认保存到 `<CAMPFIRE_HOME>/materials/<视频SHA-256>/`,`--output` 可指定 Workspace 外新目录;已有目录不覆盖。素材保留用于核验,不自动过期。原视频只读且不复制,Vault 仅接收正文,交付后可独立阅读。
65
+
66
+ ### 从 Alpha 升级
65
67
 
66
- 默认限制为 4 GiB、2 小时、240 张截图、单次处理 3 小时,默认每 30 秒候选抽帧,超长素材按帧数上限增大间隔;配置在内置 `config.yml` 的 `video` 分区。只支持本地 MP4/MOV、Matroska/WebM、AVI、MPEG-TS 容器,具体解码依赖所装 PyAV。截图稀疏采样加精确像素去重,不保证捕获短暂画面,必须按内容补帧。
68
+ 0.2.0 移除 `video frames`、自动抽帧和截图附件交付;移除 Pillow 直接依赖。旧 max_frames/frame_interval/max_dimension/max_pixels 配置忽略并在视频结果中报告。旧素材仅只读读取文字部分,不校验或复制旧截图;新转写用 `--output <新目录>`,不覆盖旧目录。旧图文草稿拒绝并提示重写为版本 2,删除 frame_ids/visual_reviewed 字段并选择产物用途。旧文档、附件、模型和素材保留。显式 transcript 输入与模型复用继续支持。
67
69
 
68
- `prepare` 可省略 `--output`,素材默认保存到 `<CAMPFIRE_HOME>/materials/<视频SHA-256>/`,预览返回实际目录;显式指定时仍须为 Workspace 外的新目录。同一视频已有素材时拒绝覆盖,可复用素材或指定其他目录重新处理。素材目录包含转写与候选图片,保留用于核验,不自动过期;用户确认后可删除指定素材目录。原视频只读且不复制,Vault 仅接收选定图片与正文,交付后不依赖素材目录。模型权重及媒体内容各自的许可由使用者核对;PyAV/FFmpeg 许可随安装构建而异,本项目不捆绑模型或独立 FFmpeg 可执行文件。
70
+ 模型权重与媒体许可由使用者核对,PyAV/FFmpeg 许可随安装构建而异,本项目不捆绑模型或独立 FFmpeg 可执行文件。
69
71
 
70
72
  ## 安装
71
73
 
72
74
  ### 升级注意事项
73
75
 
74
- `maintenance sync` 不再生成 `_generated/相关文档-*.md`,并移除 MOC 自动区域中的关系页入口;MOC 的文档导航、分组和模板入口保持不变。`related_docs` 仍为可选字段,Agent 通过 `document list` 定位文档、通过 `document inspect` 查询出向、入向及失效关联,查询不要求先同步 MOC。
76
+ `maintenance sync` 不再生成 `_generated/相关文档-*.md`,并移除 MOC 自动区域中的关系页入口;MOC 保留统一的文档导航、列表和模板入口。`related_docs` 仍为可选字段,Agent 通过 `document list` 定位文档、通过 `document inspect` 查询出向、入向及失效关联,查询不要求先同步 MOC。
75
77
 
76
78
  同步不会删除或改写历史关系页,也不会修改人工正文链接。历史清理须先核实来源和人工内容,再确认具体范围;不能按 `_generated` 或 `generated` 目录名递归删除。Base 同步策略和领域模型不在本次变更范围内。
77
79
 
@@ -82,7 +84,7 @@ uv tool install campfire-cli
82
84
  campfire version
83
85
  ```
84
86
 
85
- 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后对齐 SQLite Schema、全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
87
+ 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后按当前模型初始化 SQLite、对齐全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
86
88
 
87
89
  开发机安装(跟随本地源码):
88
90
 
@@ -121,7 +123,7 @@ Workspace ── Space ── Domain 树 ── 文档
121
123
 
122
124
  | 对象 | 说明 | 事实源 |
123
125
  |------|------|--------|
124
- | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/campfire.db`(注册)+ `.campfire.yaml`(便携 Manifest) |
126
+ | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/local.yaml`(本机接入)+ Vault 根目录 `.campfire.yaml`(便携配置) |
125
127
  | Space / Domain | 顶级容器 / 可嵌套内容边界,声明式 + 自动 MOC | Vault 内 `_空间.md`、`_领域.md` |
126
128
  | Document | 知识、计划、问题、决策、记录等持久内容 | Markdown 正文 + Frontmatter |
127
129
  | Human request | Agent 需要人类回答的待确认事项 | `_待用户确认/` 中的 `human-request` 文档 |
@@ -159,12 +161,63 @@ campfire base list / show / check / sync # Obsidian Base `_治理视图
159
161
  ```bash
160
162
  campfire workspace space create --id research --name "研究" --path myresearch --type research
161
163
  campfire workspace domain create --id wiki --name "Wiki" --path "mywork/项目/wiki" \
162
- --type knowledge-domain --governance knowledge-base --confirm
164
+ --type knowledge-domain --confirm
163
165
  campfire --workspace personal workspace project adopt --id example \
164
- --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"}]'
165
168
  campfire workspace rebuild --confirm # 索引损坏时从 SSOT 完整恢复
166
169
  ```
167
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
+
168
221
  ## 存量接管与结构重构
169
222
 
170
223
  `workspace domain adopt` 用一条命令接管一个已有文件夹。Vault 外来源经临时暂存和哈希校验复制到目标 Domain,原目录始终保留;Vault 内来源原地声明或移动到明确目标。命令一次建立一个粗粒度 Domain,语义细分交给后续 Restructure。
@@ -172,7 +225,7 @@ campfire workspace rebuild --confirm # 索引损坏时从 SSOT 完
172
225
  ```bash
173
226
  campfire workspace domain adopt --source /path/to/folder --target-path "mynote/新领域" \
174
227
  --id knowledge-new --name "新领域" \
175
- --type knowledge-domain --governance knowledge-docs
228
+ --type knowledge-domain
176
229
  # 审查同一份结构化计划后,对相同命令追加 --confirm
177
230
  ```
178
231
 
@@ -190,6 +243,8 @@ campfire workspace restructure verify --batch move-001
190
243
  ## 治理模型
191
244
 
192
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 则按既有契约定向更新受管引用。
193
248
  - **校验分工**:`maintenance check` 汇总 Space/Domain 结构与正式文档问题,并刷新可重建索引;`workspace space/domain check` 提供结构声明的专项诊断。`maintenance sync` 只因结构、MOC、路径或并发安全问题阻塞,单篇文档问题不阻止其他领域刷新。
194
249
  - **Frontmatter Profile**:声明式一层继承(`base` 或 `base → task/human-request/board`),`document profile show` 展示编译后的完整规则;Formatter 只按有效 Profile 排序并保留值,不允许字段由 Validator 报告、不自动删除。
195
250
  - **并发与提交安全**:写入前在治理锁内复核内容哈希,外部变化返回 `concurrent-change` / `source-hash-changed`,拒绝覆盖;多文件写入和路径移动经同一 ChangeSet 提交,可捕获失败尝试补偿;若报告恢复失败,停止重试并核对实际文件。
@@ -207,3 +262,17 @@ campfire workspace restructure verify --batch move-001
207
262
  ## 许可
208
263
 
209
264
  MIT。
265
+
266
+ ## Optional Vault Git synchronization
267
+
268
+ Git is optional: setup, upgrade and document operations never enable synchronization.
269
+ Every Domain uses the same hierarchy and MOC rules; Project bindings only identify related repositories.
270
+
271
+ ```bash
272
+ campfire --workspace personal workspace git sync
273
+ campfire --workspace personal workspace git sync --expected-plan <preview-digest> --confirm
274
+ ```
275
+
276
+ The command fetches, commits all eligible Vault additions, edits and deletions, merges the upstream and pushes. It respects `.gitignore` (already tracked files remain tracked), refuses manually staged changes and unfinished Git operations, and preserves local commits on failure. A conflict stops synchronization without choosing either version. Only `remote_synced: true` means the push completed. Preview uses cached remote tracking information; it does not fetch.
277
+
278
+ The Vault must be the Git worktree root with an existing commit, current branch and remote upstream. Configure Git identity and authentication using Git itself; Campfire does not duplicate credentials or remotes in YAML. Project source repositories are outside this command's scope. [Server scheduling and upgrade notes](docs/git-sync.md).
@@ -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
 
@@ -18,13 +18,11 @@
18
18
 
19
19
  推荐搭配 Obsidian:内置 Bases 展示表格,大纲提供章节导航;Kanban 用于看板,Obsidian Git 用于版本历史。它们不是普通文档查询和治理的前提。Templater、TOC 不作为依赖。插件配置教程等待维护者提供博客链接,不在 CLI 输出或仓库重复编写,也不自动修改插件设置。
20
20
 
21
- ## 本地视频图文(v0.2.0a2 Alpha 实验能力)
21
+ ## 本地视频文字整理(v0.2.0)
22
22
 
23
- 本版统一公共 CLI 输出:成功在 stdout 返回一个 JSON 对象,错误在 stderr 返回一个 JSON 对象并以非零状态退出。`--help` 返回结构化参数,`tree` 返回层级命令树,`version` 返回 `{"status":"ok","version":"0.2.0a2"}`。旧脚本若将版本输出当纯字符串读取,须改读 `version` 字段;不再提供文本帮助或 shell 补全脚本输出。
23
+ 本版统一公共 CLI 输出:成功在 stdout 返回一个 JSON 对象,错误在 stderr 返回一个 JSON 对象并以非零状态退出。`--help` 返回结构化参数,`tree` 返回层级命令树,`version` 返回 `{"status":"ok","version":"0.2.0"}`。旧脚本若将版本输出当纯字符串读取,须改读 `version` 字段;不再提供文本帮助或 shell 补全脚本输出。
24
24
 
25
- 试用预发布版:`uv tool install "campfire-cli==0.2.0a2"`;已有 uv tool 安装可用 `uv tool upgrade "campfire-cli==0.2.0a2"`。Alpha 不是正式稳定版本,不建议替换重要工作环境;先在独立测试目录验收。
26
-
27
- 本功能按实验性质逐步推进,不承诺高可用性、所有媒体兼容性或自动整理结果的准确性;生成内容须经人工或 Agent 核验。实验阶段仍保留只读来源、写入预览和冲突保护。
25
+ 安装正式版:`uv tool install "campfire-cli==0.2.0"`;已有安装使用 `campfire upgrade`。生成内容仍须实际核对,CLI 结构检查不能证明语义保真。
28
26
 
29
27
  本轮只接受本地单视频,不解析抖音、B站或其他 URL。核心 CLI 不依赖视频运行库;首次使用执行 `campfire video setup`,统一预览缺失依赖与默认模型下载,带回 `--expected-plan <摘要> --confirm` 后一次完成安装和模型加载验证。无需 Workspace 或输入视频。视频由 PyAV 解码,无需额外安装 FFmpeg 命令;语音由 faster-whisper 在 CPU 本地转写。PyAV 暂限 `<19`,避免其删除的 `metadata_errors` 参数与当前转写库冲突。
30
28
 
@@ -34,17 +32,23 @@
34
32
 
35
33
  可用 `--model <本地模型目录>` 覆盖默认位置;显式路径缺失或不完整时只报错,不下载或覆盖。已有默认目录不完整时也拒绝覆盖。也可用 `--transcript` 提供时间戳 JSON 数组,格式见命令帮助,此时不需要模型。模型权重目录须含非空的 `model.bin`、`config.json`、`tokenizer.json`;配置与权重能否实际加载仍由转写引擎校验。
36
34
 
37
- 内置 `campfire-video-capture` Skill 引导 Agent 阅读全部转写、查看候选截图、用 `video frames` 补帧并整理草稿。`video inspect` 校验结构和引用,不能证明内容保真;`video deliver` 向已通过治理检查且正文为空的文档交付正文及图片。沿用 `document apply` 创建结构,不覆盖已有人工内容,不自动处理重复来源。
35
+ 内置 `campfire-video-capture` Skill 引导 Agent 阅读全部转写,再按意图生成校订转写稿或用途文章。校订稿保持顺序和有意义细节;文章可重组内容,保留来源映射并说明取舍。术语、数字和画面依赖内容明确标记待核实或回看。无需截图或视觉能力;可选截图建议仅说明用途及参考时段。
36
+
37
+ `video inspect` 校验素材与草稿,不证明内容质量;`video deliver` 向受管空正文交付文字,沿用 `document apply` 创建结构,不覆盖已有人工正文。同源不同目标可分别交付,Agent 仅在用户明确要求时创建第二份。草稿 schema_version=2,包含 output_kind(transcript/article)、title、source_sha256、purpose、sections(title/body/segment_ids)、可选 omissions(segment_ids/reason)与 limitations。ID 为 segments 的零基下标。校订稿须顺序覆盖一次全部片段;文章允许重排,未采用片段需说明取舍。格式与示例见内置 Skill 和 deliver 命令帮助。
38
+
39
+ 默认限制为 4 GiB、2 小时、单次处理 3 小时,配置在内置 config.yml 的 video 分区。支持本地 MP4/MOV、Matroska/WebM、AVI、MPEG-TS,具体解码依赖 PyAV。素材默认保存到 `<CAMPFIRE_HOME>/materials/<视频SHA-256>/`,`--output` 可指定 Workspace 外新目录;已有目录不覆盖。素材保留用于核验,不自动过期。原视频只读且不复制,Vault 仅接收正文,交付后可独立阅读。
40
+
41
+ ### 从 Alpha 升级
38
42
 
39
- 默认限制为 4 GiB、2 小时、240 张截图、单次处理 3 小时,默认每 30 秒候选抽帧,超长素材按帧数上限增大间隔;配置在内置 `config.yml` 的 `video` 分区。只支持本地 MP4/MOV、Matroska/WebM、AVI、MPEG-TS 容器,具体解码依赖所装 PyAV。截图稀疏采样加精确像素去重,不保证捕获短暂画面,必须按内容补帧。
43
+ 0.2.0 移除 `video frames`、自动抽帧和截图附件交付;移除 Pillow 直接依赖。旧 max_frames/frame_interval/max_dimension/max_pixels 配置忽略并在视频结果中报告。旧素材仅只读读取文字部分,不校验或复制旧截图;新转写用 `--output <新目录>`,不覆盖旧目录。旧图文草稿拒绝并提示重写为版本 2,删除 frame_ids/visual_reviewed 字段并选择产物用途。旧文档、附件、模型和素材保留。显式 transcript 输入与模型复用继续支持。
40
44
 
41
- `prepare` 可省略 `--output`,素材默认保存到 `<CAMPFIRE_HOME>/materials/<视频SHA-256>/`,预览返回实际目录;显式指定时仍须为 Workspace 外的新目录。同一视频已有素材时拒绝覆盖,可复用素材或指定其他目录重新处理。素材目录包含转写与候选图片,保留用于核验,不自动过期;用户确认后可删除指定素材目录。原视频只读且不复制,Vault 仅接收选定图片与正文,交付后不依赖素材目录。模型权重及媒体内容各自的许可由使用者核对;PyAV/FFmpeg 许可随安装构建而异,本项目不捆绑模型或独立 FFmpeg 可执行文件。
45
+ 模型权重与媒体许可由使用者核对,PyAV/FFmpeg 许可随安装构建而异,本项目不捆绑模型或独立 FFmpeg 可执行文件。
42
46
 
43
47
  ## 安装
44
48
 
45
49
  ### 升级注意事项
46
50
 
47
- `maintenance sync` 不再生成 `_generated/相关文档-*.md`,并移除 MOC 自动区域中的关系页入口;MOC 的文档导航、分组和模板入口保持不变。`related_docs` 仍为可选字段,Agent 通过 `document list` 定位文档、通过 `document inspect` 查询出向、入向及失效关联,查询不要求先同步 MOC。
51
+ `maintenance sync` 不再生成 `_generated/相关文档-*.md`,并移除 MOC 自动区域中的关系页入口;MOC 保留统一的文档导航、列表和模板入口。`related_docs` 仍为可选字段,Agent 通过 `document list` 定位文档、通过 `document inspect` 查询出向、入向及失效关联,查询不要求先同步 MOC。
48
52
 
49
53
  同步不会删除或改写历史关系页,也不会修改人工正文链接。历史清理须先核实来源和人工内容,再确认具体范围;不能按 `_generated` 或 `generated` 目录名递归删除。Base 同步策略和领域模型不在本次变更范围内。
50
54
 
@@ -55,7 +59,7 @@ uv tool install campfire-cli
55
59
  campfire version
56
60
  ```
57
61
 
58
- 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后对齐 SQLite Schema、全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
62
+ 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后按当前模型初始化 SQLite、对齐全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
59
63
 
60
64
  开发机安装(跟随本地源码):
61
65
 
@@ -94,7 +98,7 @@ Workspace ── Space ── Domain 树 ── 文档
94
98
 
95
99
  | 对象 | 说明 | 事实源 |
96
100
  |------|------|--------|
97
- | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/campfire.db`(注册)+ `.campfire.yaml`(便携 Manifest) |
101
+ | Workspace | 人与 Agent 共享的上下文边界,可对应一个 Vault | `~/.campfire/local.yaml`(本机接入)+ Vault 根目录 `.campfire.yaml`(便携配置) |
98
102
  | Space / Domain | 顶级容器 / 可嵌套内容边界,声明式 + 自动 MOC | Vault 内 `_空间.md`、`_领域.md` |
99
103
  | Document | 知识、计划、问题、决策、记录等持久内容 | Markdown 正文 + Frontmatter |
100
104
  | Human request | Agent 需要人类回答的待确认事项 | `_待用户确认/` 中的 `human-request` 文档 |
@@ -132,12 +136,63 @@ campfire base list / show / check / sync # Obsidian Base `_治理视图
132
136
  ```bash
133
137
  campfire workspace space create --id research --name "研究" --path myresearch --type research
134
138
  campfire workspace domain create --id wiki --name "Wiki" --path "mywork/项目/wiki" \
135
- --type knowledge-domain --governance knowledge-base --confirm
139
+ --type knowledge-domain --confirm
136
140
  campfire --workspace personal workspace project adopt --id example \
137
- --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"}]'
138
143
  campfire workspace rebuild --confirm # 索引损坏时从 SSOT 完整恢复
139
144
  ```
140
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
+
141
196
  ## 存量接管与结构重构
142
197
 
143
198
  `workspace domain adopt` 用一条命令接管一个已有文件夹。Vault 外来源经临时暂存和哈希校验复制到目标 Domain,原目录始终保留;Vault 内来源原地声明或移动到明确目标。命令一次建立一个粗粒度 Domain,语义细分交给后续 Restructure。
@@ -145,7 +200,7 @@ campfire workspace rebuild --confirm # 索引损坏时从 SSOT 完
145
200
  ```bash
146
201
  campfire workspace domain adopt --source /path/to/folder --target-path "mynote/新领域" \
147
202
  --id knowledge-new --name "新领域" \
148
- --type knowledge-domain --governance knowledge-docs
203
+ --type knowledge-domain
149
204
  # 审查同一份结构化计划后,对相同命令追加 --confirm
150
205
  ```
151
206
 
@@ -163,6 +218,8 @@ campfire workspace restructure verify --batch move-001
163
218
  ## 治理模型
164
219
 
165
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 则按既有契约定向更新受管引用。
166
223
  - **校验分工**:`maintenance check` 汇总 Space/Domain 结构与正式文档问题,并刷新可重建索引;`workspace space/domain check` 提供结构声明的专项诊断。`maintenance sync` 只因结构、MOC、路径或并发安全问题阻塞,单篇文档问题不阻止其他领域刷新。
167
224
  - **Frontmatter Profile**:声明式一层继承(`base` 或 `base → task/human-request/board`),`document profile show` 展示编译后的完整规则;Formatter 只按有效 Profile 排序并保留值,不允许字段由 Validator 报告、不自动删除。
168
225
  - **并发与提交安全**:写入前在治理锁内复核内容哈希,外部变化返回 `concurrent-change` / `source-hash-changed`,拒绝覆盖;多文件写入和路径移动经同一 ChangeSet 提交,可捕获失败尝试补偿;若报告恢复失败,停止重试并核对实际文件。
@@ -180,3 +237,17 @@ campfire workspace restructure verify --batch move-001
180
237
  ## 许可
181
238
 
182
239
  MIT。
240
+
241
+ ## Optional Vault Git synchronization
242
+
243
+ Git is optional: setup, upgrade and document operations never enable synchronization.
244
+ Every Domain uses the same hierarchy and MOC rules; Project bindings only identify related repositories.
245
+
246
+ ```bash
247
+ campfire --workspace personal workspace git sync
248
+ campfire --workspace personal workspace git sync --expected-plan <preview-digest> --confirm
249
+ ```
250
+
251
+ The command fetches, commits all eligible Vault additions, edits and deletions, merges the upstream and pushes. It respects `.gitignore` (already tracked files remain tracked), refuses manually staged changes and unfinished Git operations, and preserves local commits on failure. A conflict stops synchronization without choosing either version. Only `remote_synced: true` means the push completed. Preview uses cached remote tracking information; it does not fetch.
252
+
253
+ The Vault must be the Git worktree root with an existing commit, current branch and remote upstream. Configure Git identity and authentication using Git itself; Campfire does not duplicate credentials or remotes in YAML. Project source repositories are outside this command's scope. [Server scheduling and upgrade notes](docs/git-sync.md).
@@ -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,16 @@ 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 不承载唯一的文件回滚材料;结构变更继续通过文件变更集执行与补偿,不承诺断电原子性,恢复未完成时停止清理并核对文件。
149
+
150
+ ## 领域与 Vault 同步
151
+
152
+ - 所有领域共用父子结构、检查与 MOC 规则,Domain 不保存 governance;domain_type 仅作分类,Project 关联仅作项目归属与代码定位。
153
+ - Vault Git 同步是独立可选命令,不接入 setup、upgrade 或单篇文档写入;remote、分支和凭据使用现有 Git upstream。预览只读,确认后获取、提交、合并、推送;失败不误报同步成功,不改写历史,不自动解决业务冲突。
154
+ - v0.2.2 按用户指定版本发布,新增能力及删除 Domain 字段/参数明确记为本次版本例外与破坏性变化,不修改既有标签。