campfire-cli 0.2.5__tar.gz → 0.2.8__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 (276) hide show
  1. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/.github/workflows/release.yml +17 -1
  2. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/ARCHITECTURE.md +3 -1
  3. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/CHANGELOG.md +25 -0
  4. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/PKG-INFO +23 -3
  5. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/README.md +22 -2
  6. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/SPEC.md +7 -4
  7. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/pyproject.toml +1 -1
  8. campfire_cli-0.2.8/scripts/package_upgrade_verify.py +130 -0
  9. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/scripts/quality_check.py +1 -1
  10. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/__init__.py +1 -1
  11. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/SPEC.md +2 -1
  12. campfire_cli-0.2.8/src/campfire_cli/app/agent_resources/SPEC.md +9 -0
  13. {campfire_cli-0.2.5/src/campfire_cli/app/skill → campfire_cli-0.2.8/src/campfire_cli/app/agent_resources}/cli/skill_cli.py +4 -1
  14. campfire_cli-0.2.8/src/campfire_cli/app/agent_resources/repository/agent_resource_repository.py +51 -0
  15. campfire_cli-0.2.8/src/campfire_cli/app/agent_resources/schema/agent_resource_schema.py +98 -0
  16. campfire_cli-0.2.8/src/campfire_cli/app/agent_resources/service/agent_resource_service.py +404 -0
  17. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/SPEC.md +4 -2
  18. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/cli/document_cli.py +12 -0
  19. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/repository/document_index_repository.py +11 -2
  20. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/schema/document_schema.py +4 -1
  21. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/document_scanner.py +1 -3
  22. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/document_service.py +2 -0
  23. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/index/document_index_builder.py +1 -0
  24. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/index/document_index_protocol.py +1 -1
  25. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/index/document_index_service.py +5 -1
  26. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/mutation/document_apply_service.py +27 -1
  27. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/service/maintenance_service.py +4 -1
  28. campfire_cli-0.2.8/src/campfire_cli/app/system/SPEC.md +10 -0
  29. campfire_cli-0.2.8/src/campfire_cli/app/system/cli/system_cli.py +79 -0
  30. campfire_cli-0.2.8/src/campfire_cli/app/system/service/system_service.py +210 -0
  31. campfire_cli-0.2.8/src/campfire_cli/app/system/service/upgrade_service.py +96 -0
  32. campfire_cli-0.2.8/src/campfire_cli/app/video/schema/__init__.py +0 -0
  33. campfire_cli-0.2.8/src/campfire_cli/app/video/service/__init__.py +0 -0
  34. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/git_cli.py +0 -2
  35. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/workspace_cli.py +5 -1
  36. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/repository/restructure_repository.py +1 -0
  37. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/git_sync_service.py +28 -8
  38. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/SPEC.md +1 -1
  39. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/cli_output.py +18 -10
  40. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/database/models.py +1 -0
  41. campfire_cli-0.2.8/src/campfire_cli/common/database/session.py +186 -0
  42. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/filesystem/locking.py +16 -3
  43. campfire_cli-0.2.8/src/campfire_cli/common/filesystem/resource_files.py +82 -0
  44. campfire_cli-0.2.8/src/campfire_cli/common/media/__init__.py +0 -0
  45. campfire_cli-0.2.8/src/campfire_cli/common/package_update_worker.py +151 -0
  46. campfire_cli-0.2.8/src/campfire_cli/common/package_updater.py +230 -0
  47. campfire_cli-0.2.8/src/campfire_cli/common/package_version.py +39 -0
  48. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/config/settings.py +44 -0
  49. campfire_cli-0.2.8/src/campfire_cli/container.py +154 -0
  50. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/main.py +15 -76
  51. campfire_cli-0.2.8/src/campfire_cli/resources/agent_hint.md +11 -0
  52. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/defaults/config.yml +7 -0
  53. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-conversation-router/SKILL.md +1 -0
  54. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-document-capture/SKILL.md +1 -1
  55. campfire_cli-0.2.8/src/campfire_cli/resources/skills/campfire-task-mainline/SKILL.md +61 -0
  56. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/SKILL.md +8 -2
  57. campfire_cli-0.2.8/src/campfire_cli/resources/skills/campfire-workspace-maintenance/references/resource-upgrade.md +10 -0
  58. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/conftest.py +1 -2
  59. campfire_cli-0.2.8/tests/integration/test_agent_resources.py +142 -0
  60. campfire_cli-0.2.8/tests/integration/test_cache_rebuild.py +100 -0
  61. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_git_sync.py +15 -1
  62. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_json_discovery.py +2 -1
  63. campfire_cli-0.2.8/tests/integration/test_upgrade.py +172 -0
  64. campfire_cli-0.2.8/tests/integration/test_usability.py +263 -0
  65. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_workspace_templates.py +3 -1
  66. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_agent_hints.py +12 -5
  67. campfire_cli-0.2.8/tests/unit/test_package_update_worker.py +56 -0
  68. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_package_version.py +0 -38
  69. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_workspace_manifest.py +1 -1
  70. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/uv.lock +1 -1
  71. campfire_cli-0.2.5/src/campfire_cli/app/skill/SPEC.md +0 -3
  72. campfire_cli-0.2.5/src/campfire_cli/app/skill/repository/skill_repository.py +0 -33
  73. campfire_cli-0.2.5/src/campfire_cli/app/skill/schema/skill_schema.py +0 -18
  74. campfire_cli-0.2.5/src/campfire_cli/app/skill/service/skill_service.py +0 -150
  75. campfire_cli-0.2.5/src/campfire_cli/common/agent_hints.py +0 -123
  76. campfire_cli-0.2.5/src/campfire_cli/common/database/session.py +0 -30
  77. campfire_cli-0.2.5/src/campfire_cli/common/package_version.py +0 -127
  78. campfire_cli-0.2.5/src/campfire_cli/container.py +0 -313
  79. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  80. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  81. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  82. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/.github/workflows/ci.yml +0 -0
  83. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/.gitignore +0 -0
  84. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/.python-version +0 -0
  85. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/AGENTS.md +0 -0
  86. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/COMMAND.md +0 -0
  87. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/CONTRIBUTING.md +0 -0
  88. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/DECISIONS.md +0 -0
  89. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/LICENSE +0 -0
  90. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/SECURITY.md +0 -0
  91. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/alembic/SPEC.md +0 -0
  92. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/alembic/env.py +0 -0
  93. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/alembic/script.py.mako +0 -0
  94. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/alembic/versions/001_initial_schema.py +0 -0
  95. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/alembic.ini +0 -0
  96. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/docs/git-sync.md +0 -0
  97. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/docs/quickstart.md +0 -0
  98. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/docs/safety.md +0 -0
  99. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/scripts/SPEC.md +0 -0
  100. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/scripts/pypi_verify.py +0 -0
  101. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/scripts/release_check.py +0 -0
  102. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/__init__.py +0 -0
  103. {campfire_cli-0.2.5/src/campfire_cli/app/skill → campfire_cli-0.2.8/src/campfire_cli/app/agent_resources}/__init__.py +0 -0
  104. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/base/SPEC.md +0 -0
  105. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/base/__init__.py +0 -0
  106. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/base/cli/base_cli.py +0 -0
  107. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/base/repository/base_repository.py +0 -0
  108. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/base/schema/base_schema.py +0 -0
  109. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/base/schema/operation_schema.py +0 -0
  110. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/base/service/base_service.py +0 -0
  111. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/__init__.py +0 -0
  112. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/cli/__init__.py +0 -0
  113. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/cli/profile_cli.py +0 -0
  114. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/cli/type_cli.py +0 -0
  115. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/repository/__init__.py +0 -0
  116. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/repository/document_profile_repository.py +0 -0
  117. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/repository/document_type_repository.py +0 -0
  118. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/schema/__init__.py +0 -0
  119. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/__init__.py +0 -0
  120. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/index/__init__.py +0 -0
  121. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/mutation/__init__.py +0 -0
  122. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/mutation/document_move_service.py +0 -0
  123. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/mutation/document_relocation.py +0 -0
  124. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/mutation/frontmatter_apply.py +0 -0
  125. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/__init__.py +0 -0
  126. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/document_patch_values.py +0 -0
  127. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/document_profile_service.py +0 -0
  128. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/document_rule_service.py +0 -0
  129. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/document_type_service.py +0 -0
  130. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/frontmatter_formatter.py +0 -0
  131. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/frontmatter_plan.py +0 -0
  132. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/kanban_service.py +0 -0
  133. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/profile_candidates.py +0 -0
  134. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/profile_registry.py +0 -0
  135. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/document/service/rules/type_plan.py +0 -0
  136. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/SPEC.md +0 -0
  137. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/__init__.py +0 -0
  138. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/cli/maintenance_cli.py +0 -0
  139. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/repository/maintenance_repository.py +0 -0
  140. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/schema/maintenance_schema.py +0 -0
  141. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/service/maintenance_protocol.py +0 -0
  142. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/maintenance/service/moc_service.py +0 -0
  143. {campfire_cli-0.2.5/src/campfire_cli/app/video → campfire_cli-0.2.8/src/campfire_cli/app/system}/__init__.py +0 -0
  144. {campfire_cli-0.2.5/src/campfire_cli/app/video → campfire_cli-0.2.8/src/campfire_cli/app/system}/cli/__init__.py +0 -0
  145. {campfire_cli-0.2.5/src/campfire_cli/app/video/schema → campfire_cli-0.2.8/src/campfire_cli/app/system/service}/__init__.py +0 -0
  146. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/video/SPEC.md +0 -0
  147. {campfire_cli-0.2.5/src/campfire_cli/app/video/service → campfire_cli-0.2.8/src/campfire_cli/app/video}/__init__.py +0 -0
  148. {campfire_cli-0.2.5/src/campfire_cli/common/media → campfire_cli-0.2.8/src/campfire_cli/app/video/cli}/__init__.py +0 -0
  149. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/video/cli/video_cli.py +0 -0
  150. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/video/schema/video_schema.py +0 -0
  151. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/video/service/video_protocol.py +0 -0
  152. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/video/service/video_service.py +0 -0
  153. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/SPEC.md +0 -0
  154. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/__init__.py +0 -0
  155. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/__init__.py +0 -0
  156. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/config_cli.py +0 -0
  157. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/domain_cli.py +0 -0
  158. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/project_cli.py +0 -0
  159. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/restructure_cli.py +0 -0
  160. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/cli/space_cli.py +0 -0
  161. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/repository/__init__.py +0 -0
  162. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/repository/manifest_repository.py +0 -0
  163. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/repository/workspace_repository.py +0 -0
  164. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/schema/__init__.py +0 -0
  165. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/schema/adoption_schema.py +0 -0
  166. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/schema/restructure_schema.py +0 -0
  167. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/schema/workspace_schema.py +0 -0
  168. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/__init__.py +0 -0
  169. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/adoption_service.py +0 -0
  170. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/config_service.py +0 -0
  171. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/domain_restructure_service.py +0 -0
  172. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/project_service.py +0 -0
  173. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/restructure_protocol.py +0 -0
  174. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/restructure_service.py +0 -0
  175. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/restructure_verifier.py +0 -0
  176. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/structure_service.py +0 -0
  177. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/workspace_protocol.py +0 -0
  178. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/app/workspace/service/workspace_service.py +0 -0
  179. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/__init__.py +0 -0
  180. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/database/__init__.py +0 -0
  181. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/documents/__init__.py +0 -0
  182. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/documents/document_types.py +0 -0
  183. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/documents/domain_context.py +0 -0
  184. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/documents/frontmatter_format.py +0 -0
  185. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/documents/frontmatter_schema.py +0 -0
  186. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/documents/markdown.py +0 -0
  187. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/documents/related_docs.py +0 -0
  188. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/exceptions/__init__.py +0 -0
  189. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/exceptions/base.py +0 -0
  190. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/filesystem/__init__.py +0 -0
  191. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/filesystem/atomic.py +0 -0
  192. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/filesystem/change_set.py +0 -0
  193. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/filesystem/cwd.py +0 -0
  194. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/filesystem/plan.py +0 -0
  195. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/git.py +0 -0
  196. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/governance/__init__.py +0 -0
  197. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/governance/issues.py +0 -0
  198. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/governance/locking.py +0 -0
  199. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/governance/snapshots.py +0 -0
  200. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/hashing.py +0 -0
  201. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/media/media_backend.py +0 -0
  202. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/media/media_worker.py +0 -0
  203. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/media/model_download.py +0 -0
  204. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/media/video_runtime.py +0 -0
  205. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/reports/__init__.py +0 -0
  206. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/reports/json_report.py +0 -0
  207. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/common/reports/markdown_report.py +0 -0
  208. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/config/SPEC.md +0 -0
  209. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/config/defaults.py +0 -0
  210. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/__init__.py +0 -0
  211. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/bases/SPEC.md +0 -0
  212. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  213. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  214. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  215. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  216. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/bases//346/226/207/346/241/243/345/267/245/344/275/234/345/217/260.base" +0 -0
  217. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/defaults/__init__.py +0 -0
  218. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/SPEC.md +0 -0
  219. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/TEMPLATE.md +0 -0
  220. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-context-bootstrap/SKILL.md +0 -0
  221. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-context-bootstrap/agents/openai.yaml +0 -0
  222. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-conversation-router/agents/openai.yaml +0 -0
  223. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-conversation-router/references/inbox-handoff.md +0 -0
  224. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-conversation-router/references/learning-intake.md +0 -0
  225. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-conversation-router/references/task-intake.md +0 -0
  226. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  227. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  228. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  229. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  230. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  231. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-inbox-triage/SKILL.md +0 -0
  232. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-kanban-board/SKILL.md +0 -0
  233. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-task-management/SKILL.md +0 -0
  234. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-video-capture/SKILL.md +0 -0
  235. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/SKILL.md +0 -0
  236. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/agents/openai.yaml +0 -0
  237. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-workspace-adoption/SKILL.md +0 -0
  238. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/references/git-sync-scheduling.md +0 -0
  239. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-workspace-onboarding/SKILL.md +0 -0
  240. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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" +0 -0
  241. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-workspace-restructure/SKILL.md +0 -0
  242. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/skills/campfire-workspace-restructure/references/restructure-spec.md +0 -0
  243. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277/README.md" +0 -0
  244. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  245. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/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
  246. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/SPEC.md +0 -0
  247. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_cli.py +0 -0
  248. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_domain_rename_sync.py +0 -0
  249. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_profile_resolution.py +0 -0
  250. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_project_repositories.py +0 -0
  251. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_quickstart.py +0 -0
  252. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_rebuildable_storage.py +0 -0
  253. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_relation_pages_cli.py +0 -0
  254. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_setup_diagnostics.py +0 -0
  255. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/integration/test_skill_examples.py +0 -0
  256. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/perf/test_read_counts.py +0 -0
  257. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/perf/test_resolve_subprocess_count.py +0 -0
  258. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_atomic_write.py +0 -0
  259. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_base_service.py +0 -0
  260. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_config.py +0 -0
  261. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_document_apply.py +0 -0
  262. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_document_index.py +0 -0
  263. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_document_scanner.py +0 -0
  264. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_domain_context.py +0 -0
  265. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_domain_paths.py +0 -0
  266. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_file_change_executor.py +0 -0
  267. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_frontmatter.py +0 -0
  268. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_generated_regions.py +0 -0
  269. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_kanban_service.py +0 -0
  270. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_operation_schema.py +0 -0
  271. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_pypi_verify.py +0 -0
  272. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_related_docs.py +0 -0
  273. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_release_check.py +0 -0
  274. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_repository_boundaries.py +0 -0
  275. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_video.py +0 -0
  276. {campfire_cli-0.2.5 → campfire_cli-0.2.8}/tests/unit/test_video_runtime.py +0 -0
@@ -6,6 +6,22 @@ on:
6
6
  tags: ["v*"]
7
7
 
8
8
  jobs:
9
+ upgrade:
10
+ strategy:
11
+ fail-fast: false
12
+ matrix:
13
+ os: [ubuntu-latest, macos-latest, windows-latest]
14
+ manager: [uv-tool, pipx]
15
+ runs-on: ${{ matrix.os }}
16
+ env:
17
+ PYTHONUTF8: "1"
18
+ steps:
19
+ - uses: actions/checkout@v5
20
+ with:
21
+ fetch-depth: 0
22
+ - uses: astral-sh/setup-uv@v10.1.0
23
+ - run: uv sync --frozen
24
+ - run: uv run --with pipx python scripts/package_upgrade_verify.py --manager ${{ matrix.manager }}
9
25
  video:
10
26
  strategy:
11
27
  fail-fast: false
@@ -52,7 +68,7 @@ jobs:
52
68
 
53
69
  publish:
54
70
  if: github.event_name == 'push'
55
- needs: [quality, video]
71
+ needs: [quality, video, upgrade]
56
72
  runs-on: ubuntu-latest
57
73
  permissions:
58
74
  id-token: write
@@ -46,6 +46,8 @@ Task Channel 是未来演进设想,借鉴 Go 的原则:**Do not communicate
46
46
 
47
47
  ## 4. 系统架构
48
48
 
49
+ `app/system` 编排本机接入、包更新与资源核验,`app/agent_resources` 管理全局 Skill 与 Hint。资源登记是本机所有权记录,不是历史内容数据库;Hint 块外正文与用户新增附属文件属于用户。`common` 提供安装渠道识别、隔离进程、文件锁和字节写入机制,不解释资源覆盖策略。后台升级必须由新版核验安装版本和逐 Workspace 结果,启动不能作为完成证据。
50
+
49
51
  本地视频能力由 `app/video` 承担素材准备与交付校验,`common/media` 提供模型下载、媒体探测与语音转写机制;可选原生处理依赖在独立子进程中延迟加载。`AppContainer.deliver_video` 组合文档治理检查与视频交付,不让 Video Service 调用 Document Service。文档结构仍由 `document apply` 创建,正文复用文件变更集及乐观锁;没有新的数据库、独立下载服务或模型调度器。语义整理留给宿主 Agent 与内置 Skill,结构检查不等于语义保真验收。
50
52
 
51
53
  ```text
@@ -119,7 +121,7 @@ Python 依赖由 `pyproject.toml` 的 `video` extra 声明,初始化从包元
119
121
 
120
122
  待人确认以全局系统受管区 `_待用户确认/` 的 `human-request` 文档为事实来源;它不属于任何 Space、Domain 或 Project。`human_decision_status` 只表达待人处理状态,用户结论随后写回正式文档。不存在独立的 Decision SQLite 状态机或 `_协作/` 投影。
121
123
 
122
- `app/` 按可独立理解的业务能力组织,CLI 只做参数和输出适配,Service 承担业务流程,Repository 负责外部读写。跨 App 的用例编排由组合根 `AppContainer` 承担,`setup` 与 `upgrade` 是当前实例。`common/` 只放跨业务复用、无独立业务流程的原子能力;不能为了“复用”把业务编排下沉到 common。
124
+ `app/` 按可独立理解的业务能力组织,CLI 只做参数和输出适配,Service 承担业务流程,Repository 负责外部读写。系统用例由 `app/system` 编排,`setup` 与 `upgrade` 是当前实例;组合根 `AppContainer` 只装配并持有依赖。`common/` 只放跨业务复用、无独立业务流程的原子能力;不能为了“复用”把业务编排下沉到 common。
123
125
 
124
126
  配置采用两层模型:包内 `resources/defaults/config.yml` 保存完整默认契约,用户级 `~/.campfire/config.yml` 只保存覆盖项。Mapping 递归合并,scalar 和 list 整体替换;配置不按 Workspace 复制,运行状态不写回 YAML。
125
127
 
@@ -1,7 +1,32 @@
1
1
  # 版本记录
2
2
 
3
+ ## 0.2.8 — 2026-11-17
4
+
5
+ - 新增 document list 可重复 --tags 精确 AND 查询与 apply --name 同次补结构和修复重名。
6
+ - 新增可选全局主线任务 Skill,主线仅由标签识别;精简 Hint 并修正 Codex/Claude Code 指令入口与加载提示。
7
+ - 统一 blocked 的 stderr/退出码 3,区分锁占用与内容变化,增强 Git 预览失败时的接入诊断。
8
+ - 不兼容 SQLite 派生缓存在独占保护下删除重建,不备份、不迁移;保留文件事实与本机绑定,旧计划审批失效。
9
+ - 按用户指定采用 0.2.x 补丁版本,新增能力及退出契约变化为版本规则的显式例外。
10
+
11
+ - 后台升级状态文件在 Windows 短暂共享冲突时有限重试原子替换;永久错误仍失败并保留旧快照。
12
+
13
+ ## 0.2.7 — 未发布
14
+
15
+ - 发布标签已保留;正式 Windows 门禁发现后台升级状态文件替换竞态,PyPI 上传未执行。修复纳入 0.2.8,不重写标签。
16
+
17
+ ## 0.2.6 — 2026-10-12
18
+
19
+ - 系统命令与跨模块编排迁入 System,Skill 与 Hint 收敛为 Agent Resources;全局资源不再依赖空 Workspace 配置。
20
+ - 增加 --version/-V、公开离线 upgrade --skip-package 与 agent upgrade-status,包和资源阶段分别持久化,启动只报告 planned。
21
+ - 通过安装登记识别 uv tool/pipx,隔离 worker 等待宿主退出并使用参数数组更新;新版身份和版本验证通过后才对齐资源。
22
+ - 旧托管资源可直接接管;登记文件随包清理,用户新增文件保留。Hint 拒绝异常标记,块外原始字节与 CRLF 保留,附属文件按字节分发。
23
+ - 部分资源失败、Workspace 不可访问与配置失败不再汇总为 ok;blocked 输出 stderr 单行 JSON 并退出 3。版本 JSON 新增 package 字段,依赖完整对象相等的调用方须更新。
24
+ - 本轮按已确认清单采用 0.2.6,新增公共能力作为次版本规则的明确例外;不转换旧配置,不覆盖 Workspace 模板,不启用定时任务。
25
+
3
26
  ## 0.2.5 — 2026-10-10
4
27
 
28
+ [PyPI 安装包](https://pypi.org/project/campfire-cli/0.2.5/) · [GitHub Release](https://github.com/Kepler452Byte/campfire-cli/releases/tag/v0.2.5) · [三平台发布与公开安装验证](https://github.com/Kepler452Byte/campfire-cli/actions/runs/38041662695)
29
+
5
30
  - Bootstrap 增加 Tickwork 本机定时任务入口,缺少 CLI 或 Skill 时提供安装与接入指引;具体任务管理仍由 Tickwork Skill 负责。
6
31
  - 修复文件改名暂存后 Git 重命名识别导致的同步快照误变化,不修改用户 Git 配置,仍保留实际并发变化检查。
7
32
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: campfire-cli
3
- Version: 0.2.5
3
+ Version: 0.2.8
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
@@ -84,7 +84,11 @@ uv tool install campfire-cli
84
84
  campfire version
85
85
  ```
86
86
 
87
- 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后按当前模型初始化 SQLite、对齐全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
87
+ 升级:`campfire upgrade` 检测 PyPI 新版本,核对 uv tool 或 pipx 安装登记,在独立进程中等待当前进程退出后更新包。启动返回 `planned` 与 `operation_id`,使用 `campfire agent upgrade-status <operation_id>` 核验完成情况。新版先验证产品身份和版本,再初始化 SQLite、对齐全局 Skill、Hint 与逐 Workspace Base。安装器或版本核验失败时跳过资源更新。
88
+
89
+ `campfire upgrade --skip-package` 是完全离线的资源对齐入口,不查询 PyPI。editable、未知渠道、离线与已是最新均在 `package.action` 中明确报告,资源结果独立返回。失败返回 `blocked`、stderr 单行 JSON 与退出码 3,保留已完成操作与逐 Workspace 结果。`version`、`--version` 和 `-V` 返回相同安装版本及 `package` 身份,不创建本机状态。
90
+
91
+ 托管 Skill 与 Hint 块按包内容恢复。首次升级按原受管名单和本产品标记接管旧资源;登记保存于 `<CAMPFIRE_HOME>/agent-resources.json`,后续只清理登记过且包内已删除的文件。用户新增附属文件、其他产品资源与 Hint 块外字节保留。异常标记、未知同名资源、软链接与并发变化会阻止写入。多目标和目标变更保留已登记位置的对齐;`setup --verbose` 可查看逐文件操作。
88
92
 
89
93
  开发机安装(跟随本地源码):
90
94
 
@@ -111,7 +115,7 @@ campfire maintenance sync --dry-run
111
115
 
112
116
  不指定 `--path` 运行 `campfire setup` 是降级执行而不是报错:仍会同步全局 Skill 与提示词路标,输出接入引导,并显式列出被跳过的 Manifest 相关步骤。
113
117
 
114
- `setup` 会向 `~/.claude/CLAUDE.md`、`~/.agents/AGENTS.md` 注入幂等的 campfire 路标块,保留标记外内容;`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标。`setup` 与 `skill sync` 会把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`,可通过 `CAMPFIRE_SKILL_TARGETS` 覆盖。单独执行 `skill sync` 不更新提示词路标。
118
+ `setup` 会向 `~/.claude/CLAUDE.md`、`~/.codex/AGENTS.md` 注入幂等的 campfire 路标块,保留标记外内容;`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标。`setup` 与 `skill sync` 会把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`,可通过 `CAMPFIRE_SKILL_TARGETS` 覆盖。单独执行 `skill sync` 不更新提示词路标。Codex 的指令目录跟随 `CODEX_HOME`,Claude Code 的指令和默认 Skill 目录跟随 `CLAUDE_CONFIG_DIR`。非空 `AGENTS.override.md` 优先于同目录 `AGENTS.md`;自定义 Hint 目标须自行接入客户端。对齐结果中的 `loading_verified=false` 表示只完成文件写入,需在新会话核验实际加载;Claude Code 可用 `/memory` 辅助核对。
115
119
 
116
120
  ## 核心概念
117
121
 
@@ -276,3 +280,19 @@ campfire --workspace personal workspace git sync --expected-plan <preview-digest
276
280
  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
281
 
278
282
  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).
283
+
284
+
285
+ ### v0.2.8 查询与维护
286
+
287
+ ```bash
288
+ campfire document list --type task --tags 主线 --tags 公司任务
289
+ campfire document apply --path "mywork/领域/wyx.md" --type record --name "补充记录" --set 'description=补齐结构并区分重名'
290
+ ```
291
+
292
+ `--tags` 可重复,全部精确匹配,筛选在计数与 limit 前完成。`apply --name` 用于补齐结构时同次选择标题,确认时携带预览的 expected_hash 与 expected_plan;普通改标题用 rename。
293
+
294
+ 可选全局 `campfire-task-mainline` 通过 task 的主线标签发现持续工作,不限定季度、文件名或存放目录;用户位置与已有 Workspace 规则优先。全局 Hint 只提供入口,操作细节在对应 Skill。
295
+
296
+ 所有 blocked 结果统一 stderr 单行 JSON/退出码 3;正常预览及 needs-input/needs-review 保持 stdout/0,使用者仍要核对业务结果。治理写入在同一 Workspace 内串行;workspace-locked 与内容变化分别诊断。Git 预览不联网,remote_checked=false,ahead/behind 来自本机远端跟踪记录;缺少 upstream 时保留已知分支/远端并给出指引。
297
+
298
+ SQLite 不兼容缓存自动删除重建,无备份或历史迁移链;数据库被使用时拒绝替换。Markdown、Manifest 与 local.yaml 不变,旧计划审批失效。新数据库连接使用共享锁,重建使用独占锁,以协调共用数据库的 Workspace。
@@ -59,7 +59,11 @@ uv tool install campfire-cli
59
59
  campfire version
60
60
  ```
61
61
 
62
- 升级:`campfire upgrade` 是一条幂等命令——检测 PyPI 新版本并按安装方式(uv tool / pipx)更新包本身(更新器在独立进程中等待当前进程退出后执行,完成后自动用新版代码对齐治理资源),随后按当前模型初始化 SQLite、对齐全局 Skill、Base 与提示词路标。离线、已是最新、editable 源码安装或无法识别安装方式时跳过包更新仅对齐资源。
62
+ 升级:`campfire upgrade` 检测 PyPI 新版本,核对 uv tool 或 pipx 安装登记,在独立进程中等待当前进程退出后更新包。启动返回 `planned` 与 `operation_id`,使用 `campfire agent upgrade-status <operation_id>` 核验完成情况。新版先验证产品身份和版本,再初始化 SQLite、对齐全局 Skill、Hint 与逐 Workspace Base。安装器或版本核验失败时跳过资源更新。
63
+
64
+ `campfire upgrade --skip-package` 是完全离线的资源对齐入口,不查询 PyPI。editable、未知渠道、离线与已是最新均在 `package.action` 中明确报告,资源结果独立返回。失败返回 `blocked`、stderr 单行 JSON 与退出码 3,保留已完成操作与逐 Workspace 结果。`version`、`--version` 和 `-V` 返回相同安装版本及 `package` 身份,不创建本机状态。
65
+
66
+ 托管 Skill 与 Hint 块按包内容恢复。首次升级按原受管名单和本产品标记接管旧资源;登记保存于 `<CAMPFIRE_HOME>/agent-resources.json`,后续只清理登记过且包内已删除的文件。用户新增附属文件、其他产品资源与 Hint 块外字节保留。异常标记、未知同名资源、软链接与并发变化会阻止写入。多目标和目标变更保留已登记位置的对齐;`setup --verbose` 可查看逐文件操作。
63
67
 
64
68
  开发机安装(跟随本地源码):
65
69
 
@@ -86,7 +90,7 @@ campfire maintenance sync --dry-run
86
90
 
87
91
  不指定 `--path` 运行 `campfire setup` 是降级执行而不是报错:仍会同步全局 Skill 与提示词路标,输出接入引导,并显式列出被跳过的 Manifest 相关步骤。
88
92
 
89
- `setup` 会向 `~/.claude/CLAUDE.md`、`~/.agents/AGENTS.md` 注入幂等的 campfire 路标块,保留标记外内容;`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标。`setup` 与 `skill sync` 会把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`,可通过 `CAMPFIRE_SKILL_TARGETS` 覆盖。单独执行 `skill sync` 不更新提示词路标。
93
+ `setup` 会向 `~/.claude/CLAUDE.md`、`~/.codex/AGENTS.md` 注入幂等的 campfire 路标块,保留标记外内容;`CAMPFIRE_AGENT_HINT_PATH` 可覆盖目标。`setup` 与 `skill sync` 会把托管 Skill 同步到 `~/.claude/skills`、`~/.agents/skills`,可通过 `CAMPFIRE_SKILL_TARGETS` 覆盖。单独执行 `skill sync` 不更新提示词路标。Codex 的指令目录跟随 `CODEX_HOME`,Claude Code 的指令和默认 Skill 目录跟随 `CLAUDE_CONFIG_DIR`。非空 `AGENTS.override.md` 优先于同目录 `AGENTS.md`;自定义 Hint 目标须自行接入客户端。对齐结果中的 `loading_verified=false` 表示只完成文件写入,需在新会话核验实际加载;Claude Code 可用 `/memory` 辅助核对。
90
94
 
91
95
  ## 核心概念
92
96
 
@@ -251,3 +255,19 @@ campfire --workspace personal workspace git sync --expected-plan <preview-digest
251
255
  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
256
 
253
257
  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).
258
+
259
+
260
+ ### v0.2.8 查询与维护
261
+
262
+ ```bash
263
+ campfire document list --type task --tags 主线 --tags 公司任务
264
+ campfire document apply --path "mywork/领域/wyx.md" --type record --name "补充记录" --set 'description=补齐结构并区分重名'
265
+ ```
266
+
267
+ `--tags` 可重复,全部精确匹配,筛选在计数与 limit 前完成。`apply --name` 用于补齐结构时同次选择标题,确认时携带预览的 expected_hash 与 expected_plan;普通改标题用 rename。
268
+
269
+ 可选全局 `campfire-task-mainline` 通过 task 的主线标签发现持续工作,不限定季度、文件名或存放目录;用户位置与已有 Workspace 规则优先。全局 Hint 只提供入口,操作细节在对应 Skill。
270
+
271
+ 所有 blocked 结果统一 stderr 单行 JSON/退出码 3;正常预览及 needs-input/needs-review 保持 stdout/0,使用者仍要核对业务结果。治理写入在同一 Workspace 内串行;workspace-locked 与内容变化分别诊断。Git 预览不联网,remote_checked=false,ahead/behind 来自本机远端跟踪记录;缺少 upstream 时保留已知分支/远端并给出指引。
272
+
273
+ SQLite 不兼容缓存自动删除重建,无备份或历史迁移链;数据库被使用时拒绝替换。Markdown、Manifest 与 local.yaml 不变,旧计划审批失效。新数据库连接使用共享锁,重建使用独占锁,以协调共用数据库的 Workspace。
@@ -7,7 +7,7 @@
7
7
  ```text
8
8
  CLI delivery adapter
9
9
  ↓
10
- AppContainer 组合根,承担跨 App 编排
10
+ AppContainer 组合根,装配 System 与业务服务
11
11
  ↓
12
12
  Document / Workspace Restructure / Maintenance Service
13
13
  ↓
@@ -19,7 +19,7 @@ SQLite / Filesystem Implementation
19
19
  - `app/` 放业务模块与 CLI 适配器。
20
20
  - `common/` 放两个 App 共同使用的文档治理原子能力和技术机制。
21
21
  - `config/` 放随 Workspace 或运行环境变化的配置。
22
- - 跨 App 的用例编排放 `AppContainer` 组合根,`setup` 与 `upgrade` 是当前实例;CLI 不编排跨服务流程,单个 App Service 不直接调用其他 App 的 Service。
22
+ - 系统用例的跨模块编排放 `app/system`;`AppContainer` 只装配并持有依赖。System 消费业务模块的公开能力,不复制业务规则;CLI 不编排跨服务流程。
23
23
  - 纯技术机制放 `common/`,例如网络查询、版本比较与进程编排;不得包含治理业务语义,也不得反向依赖 `app/`。
24
24
  - `resources/defaults/config.yml` 是产品默认规则的唯一 SSOT;Service 不得重复声明可演进的目录、类型、状态、归档或 Issue 规则。
25
25
  - CLI 通过用户级 registry 管理多个 Workspace,不依赖任何 Workspace 内的工具目录。
@@ -43,6 +43,7 @@ SQLite / Filesystem Implementation
43
43
 
44
44
  - 所有公共命令成功时 stdout 只输出一个 indent JSON 对象,包括 `--help`、无参数帮助、`version` 与 `tree`;错误只输出一个单行 JSON 对象到 stderr,退出码非 0。帮助使用参数结构,命令树使用层级结构,不返回 ANSI 文本。第三方日志须捕获,不混入命令输出;不提供第二套文本模式或 shell 补全脚本输出入口。
45
45
  - `status` 字段是 Agent 依赖的公共契约,只允许复用既有词汇,不得发明近义词。命令级词汇:ok、error、blocked、needs-input、needs-review、dry-run、synced、planned、ready、applied、moved、renamed、issues-found、formatted、archived、up-to-date。文档、领域与 Decision 各有自己的字段词汇表。需要新状态先在本节登记。
46
+ - `blocked` 统一以退出码 3 输出单行 JSON 到 stderr;`error` 按异常类别使用既有非零退出码(通用 1、配置/输入 2、治理 3)。正常预览、`needs-input` 和 `needs-review` 是成功返回的业务结果,stdout/0,调用方仍须读取 issues、skipped 和 write_performed,不把进程成功等同于完成写入。部分写入后阻塞保留已写入事实并非零退出。
46
47
  - 可恢复的输入错误必须包含稳定 `code`、对应字段和机器可读的期望类型;当正确序列化方式不直观时,同时返回示例值或修复提示。自然语言 message 与示例可以演进,不作为调用方分支判断依据。
47
48
  - 前置条件缺失时优先降级执行:能完成的部分照常完成,输出 `needs-input` 并以 `skipped` 字段显式列出被跳过的步骤,而非整体报错退出。
48
49
 
@@ -51,7 +52,7 @@ SQLite / Filesystem Implementation
51
52
  - `campfire upgrade` 是唯一的幂等升级入口:先更新 Python 包本身,再对齐本机治理资源,覆盖当前表结构初始化、全局 Skill、Base 与提示词路标;不维护历史迁移链或旧格式转换。
52
53
  - 包自更新按检测到的安装方式在独立进程中执行,当前支持 uv tool 与 pipx。更新脚本必须等待当前进程退出后再运行,因为 Windows 会锁定运行中的解释器与可执行文件,包管理器无法原地替换;成功后由新版代码完成资源对齐。
53
54
  - editable 源码安装、离线、无法识别安装方式时跳过包更新仅对齐资源,结果中以 `action` 与 `hint` 显式说明原因。
54
- - 自更新链使用的内部参数必须 `hidden=True`,`--skip-package` 是当前实例,不进入公共 CLI 契约。
55
+ - `--skip-package` 是公开的离线资源对齐入口,不发起版本网络查询。自更新链使用的其他内部参数必须 `hidden=True`。
55
56
  - 外部网络查询尽力而为,例如 PyPI 版本检测;失败或超时静默降级,不得让命令失败或明显变慢。
56
57
 
57
58
  ## 开发纪律
@@ -144,7 +145,7 @@ Campfire 使用语义化版本:
144
145
 
145
146
  - `.campfire.yaml` 与 `local.yaml` 各有唯一事实,不双向复制 remote、分支、名称和文档领域。项目查询按稳定 id 合并两者,元数据写入 Vault 文件,路径绑定写入本机文件。
146
147
  - 只支持当前文件结构,无 schema_version 分支或旧格式读取。已有用户由 Agent 在备份后一次性整理文件;转换逻辑不进入产品。
147
- - 停止正在执行的操作后,可删除 campfire.db 及其 WAL/SHM,再由正常查询、setup 或 rebuild 从文件恢复派生状态;重新生成的计划重新确认,旧审批不沿用。
148
+ - SQLite 表结构不满足当前模型时自动关闭本次连接、取得跨 Workspace 的数据库独占锁并删除 campfire.db 及其 WAL/SHM,按当前模型创建,索引由正常查询/setup 重建。不保留旧库、备份、恢复文件或历史迁移链;活动连接占用时返回 database-busy,不删除。Markdown、Manifest、local.yaml 保留,重新生成的计划重新确认,旧审批不沿用。
148
149
  - SQLite 不承载唯一的文件回滚材料;结构变更继续通过文件变更集执行与补偿,不承诺断电原子性,恢复未完成时停止清理并核对文件。
149
150
 
150
151
  ## 领域与 Vault 同步
@@ -152,3 +153,5 @@ Campfire 使用语义化版本:
152
153
  - 所有领域共用父子结构、检查与 MOC 规则,Domain 不保存 governance;domain_type 仅作分类,Project 关联仅作项目归属与代码定位。
153
154
  - Vault Git 同步是独立可选命令,不接入 setup、upgrade 或单篇文档写入;remote、分支和凭据使用现有 Git upstream。预览只读,确认后获取、提交、合并、推送;失败不误报同步成功,不改写历史,不自动解决业务冲突。
154
155
  - v0.2.2 按用户指定版本发布,新增能力及删除 Domain 字段/参数明确记为本次版本例外与破坏性变化,不修改既有标签。
156
+
157
+ - 本轮按用户指定采用 0.2.x 补丁版本承载新增能力和退出状态契约变化,作为通常版本递增规则的显式例外。v0.2.7 标签因 Windows 门禁失败保留,修复后递增至 v0.2.8,不移动或覆盖既有标签。
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "campfire-cli"
3
- version = "0.2.5"
3
+ version = "0.2.8"
4
4
  description = "Local-first shared context and governance CLI for humans and agents"
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -0,0 +1,130 @@
1
+ """
2
+ SPEC:
3
+ name: package_upgrade_verify
4
+ purpose: 隔离验证真实 uv tool 或 pipx 的旧版到当前版后台升级
5
+ idempotent: true
6
+ side_effects:
7
+ - 在临时目录安装旧版本并更新到当前源码,不修改用户安装
8
+ """
9
+
10
+ from __future__ import annotations
11
+
12
+ import argparse
13
+ import io
14
+ import json
15
+ import os
16
+ import shutil
17
+ import subprocess
18
+ import sys
19
+ import tarfile
20
+ import tempfile
21
+ import time
22
+ import tomllib
23
+ from pathlib import Path
24
+
25
+ ROOT = Path(__file__).resolve().parents[1]
26
+
27
+
28
+ def archive(ref: str, target: Path) -> None:
29
+ data = subprocess.run(["git", "archive", ref], cwd=ROOT, check=True, capture_output=True).stdout
30
+ target.mkdir(parents=True)
31
+ with tarfile.open(fileobj=io.BytesIO(data)) as content:
32
+ content.extractall(target, filter="data")
33
+
34
+
35
+ def verify(manager: str, baseline: str = "v0.2.5") -> dict:
36
+ with tempfile.TemporaryDirectory(prefix="campfire upgrade ") as raw:
37
+ root = Path(raw).resolve()
38
+ source = root / "source with spaces"
39
+ candidate = root / "candidate"
40
+ archive(baseline, source)
41
+ archive("HEAD", candidate)
42
+ old_version = tomllib.loads((source / "pyproject.toml").read_text())["project"]["version"]
43
+ new_version = tomllib.loads((candidate / "pyproject.toml").read_text())["project"][
44
+ "version"
45
+ ]
46
+ environment = {
47
+ **os.environ,
48
+ "UV_TOOL_DIR": str(root / "uv tools"),
49
+ "UV_TOOL_BIN_DIR": str(root / "uv bin"),
50
+ "PIPX_HOME": str(root / "pipx home"),
51
+ "PIPX_BIN_DIR": str(root / "pipx bin"),
52
+ "CAMPFIRE_HOME": str(root / "state"),
53
+ "CAMPFIRE_SKILL_TARGETS": str(root / "skills"),
54
+ "CAMPFIRE_AGENT_HINT_PATH": str(root / "hint.md"),
55
+ "PYTHONIOENCODING": "utf-8",
56
+ }
57
+ environment.pop("PYTHONPATH", None)
58
+ executable = shutil.which("uv" if manager == "uv-tool" else "pipx")
59
+ if not executable:
60
+ raise RuntimeError(f"Missing installer: {manager}")
61
+ command = (
62
+ [executable, "tool", "install", "--python", sys.executable, str(source)]
63
+ if manager == "uv-tool"
64
+ else [executable, "install", "--python", sys.executable, str(source)]
65
+ )
66
+ subprocess.run(command, env=environment, check=True, timeout=240)
67
+ prefix = (
68
+ root / "uv tools" / "campfire-cli"
69
+ if manager == "uv-tool"
70
+ else root / "pipx home" / "venvs" / "campfire-cli"
71
+ )
72
+ python = prefix / ("Scripts/python.exe" if os.name == "nt" else "bin/python")
73
+ shutil.rmtree(source)
74
+ shutil.copytree(candidate, source)
75
+ host = (
76
+ "import sys,json,os\nfrom pathlib import Path\n"
77
+ f"sys.path.insert(0,{str(candidate / 'src')!r})\n"
78
+ "from campfire_cli.common.package_updater import PackageUpdater,plan_digest\n"
79
+ "updater=PackageUpdater('campfire-cli','campfire',Path(os.environ['CAMPFIRE_HOME']))\n"
80
+ "plan=updater.plan()\n"
81
+ f"assert plan['manager']=={manager!r} and plan['supported'],plan\n"
82
+ f"assert plan['current_version']=={old_version!r},plan\n"
83
+ f"plan['target_version']={new_version!r}\n"
84
+ "print(json.dumps(updater.start(plan,plan_digest(plan))))\n"
85
+ )
86
+ started = subprocess.run(
87
+ [str(python), "-c", host],
88
+ env=environment,
89
+ check=False,
90
+ capture_output=True,
91
+ text=True,
92
+ encoding="utf-8",
93
+ timeout=30,
94
+ )
95
+ if started.returncode:
96
+ raise RuntimeError(started.stderr or started.stdout)
97
+ operation = json.loads(started.stdout)
98
+ result_path = root / "state" / "upgrades" / operation["operation_id"] / "result.json"
99
+ deadline = time.monotonic() + 240
100
+ result = {"state": "pending"}
101
+ while time.monotonic() < deadline:
102
+ try:
103
+ result = json.loads(result_path.read_bytes())
104
+ except (PermissionError, FileNotFoundError):
105
+ time.sleep(0.2)
106
+ continue
107
+ if result["state"] in {"completed", "failed"}:
108
+ break
109
+ time.sleep(0.2)
110
+ if result["state"] != "completed":
111
+ raise RuntimeError(Path(operation["log_path"]).read_text(encoding="utf-8"))
112
+ assert result["installed_version"] == new_version, result
113
+ assert result["package_stage"] == result["resource_stage"] == "completed", result
114
+ return {
115
+ "manager": manager,
116
+ "from_version": old_version,
117
+ "version": new_version,
118
+ "state": result["state"],
119
+ "package_stage": result["package_stage"],
120
+ "resource_stage": result["resource_stage"],
121
+ "spaces_in_paths": True,
122
+ }
123
+
124
+
125
+ if __name__ == "__main__":
126
+ parser = argparse.ArgumentParser()
127
+ parser.add_argument("--manager", required=True, choices=["uv-tool", "pipx"])
128
+ parser.add_argument("--baseline", default="v0.2.5")
129
+ arguments = parser.parse_args()
130
+ print(json.dumps(verify(arguments.manager, arguments.baseline), ensure_ascii=False, indent=2))
@@ -38,7 +38,7 @@ def check_tag(version: str) -> None:
38
38
 
39
39
  def smoke_test_wheel(version: str, artifact_dir: Path | None = None) -> None:
40
40
  with tempfile.TemporaryDirectory(prefix="campfire-quality-") as raw_directory:
41
- directory = Path(raw_directory)
41
+ directory = Path(raw_directory).resolve()
42
42
  dist = artifact_dir or directory / "dist"
43
43
  if artifact_dir is not None and dist.exists() and any(dist.iterdir()):
44
44
  raise SystemExit(f"artifact directory must be empty: {dist}")
@@ -1,3 +1,3 @@
1
1
  """Campfire CLI package."""
2
2
 
3
- __version__ = "0.2.5"
3
+ __version__ = "0.2.8"
@@ -7,6 +7,7 @@
7
7
  - `document/`:文档自身、文档规则以及面向用户和 Agent 的文档命令。
8
8
  - `maintenance/`:新增与变更文档的持续维护和派生视图同步。
9
9
  - `workspace/`:注册、初始化、解析和选择多个 Workspace,并通过扁平的 Restructure Service 执行一次性、大规模、批次化结构重构。
10
- - `skill/`:Campfire SOP Skill 的发现、加载、校验和同步。
10
+ - `agent_resources/`:Campfire SOP Skill 的发现、加载、校验、路径匹配与全局资源同步。
11
+ - `system/`:版本、命令发现、本机初始化与升级的跨模块编排。
11
12
  - `base/`:Obsidian Base 标准治理视图。
12
13
  - `video/`:实验性的本地视频素材准备、草稿校验与图文交付。
@@ -0,0 +1,9 @@
1
+ # Agent Resources SPEC
2
+
3
+ 本模块发现、读取、匹配、校验并同步包内 SSOT Skill 与 Hint。Service 决定托管范围、旧资源接管与同步动作;Repository 提供包资源、登记和目标文件的字节读写与锁,不解释所有权规则。
4
+
5
+ - 全局资源使用 AgentResourceSettings,不依赖 Workspace 或数据库。
6
+ - 托管内容按包恢复,登记只保存产品身份、目标和文件类型,不保存历史内容哈希。
7
+ - 首次接管仅限配置受管名单与带本产品标记的 Hint;未知文件保留,登记过且从包删除的文件可清理。
8
+ - Hint 标记重复、残缺或倒序时拒绝写入;块外原始字节不变。所有附属文件按字节分发。
9
+ - 同步内部先预检,在锁内复核整个计划与逐文件快照;部分失败返回已完成操作,不报告成功。
@@ -37,4 +37,7 @@ def check(ctx: typer.Context) -> None:
37
37
  @skill_cli.command("sync")
38
38
  def sync(ctx: typer.Context, dry_run: bool = typer.Option(False, "--dry-run")) -> None:
39
39
  """将托管 Skill 从包内 SSOT 确定性同步到全局 Agent 目录。"""
40
- emit(ctx.obj.skill.sync(dry_run))
40
+ result = ctx.obj.skill.sync(dry_run)
41
+ emit(result, err=result.status == "blocked")
42
+ if result.status == "blocked":
43
+ raise typer.Exit(3)
@@ -0,0 +1,51 @@
1
+ from __future__ import annotations
2
+
3
+ from contextlib import AbstractContextManager
4
+ from importlib.resources import files
5
+ from pathlib import Path
6
+
7
+ from campfire_cli.common.filesystem.resource_files import (
8
+ atomic_write,
9
+ read_bytes,
10
+ safe_path,
11
+ write_lock,
12
+ )
13
+
14
+
15
+ class AgentResourceRepository:
16
+ def __init__(self, state_root: Path):
17
+ self.state_root = state_root
18
+ self.registry_path = state_root / "agent-resources.json"
19
+
20
+ def source_root(self) -> Path:
21
+ return Path(str(files("campfire_cli.resources") / "skills"))
22
+
23
+ def assets(self, names: list[str]) -> dict[str, bytes]:
24
+ root = self.source_root()
25
+ return {
26
+ path.relative_to(root).as_posix(): path.read_bytes()
27
+ for name in names
28
+ for path in sorted((root / name).rglob("*"))
29
+ if path.is_file()
30
+ }
31
+
32
+ def hint(self) -> bytes:
33
+ return (files("campfire_cli.resources") / "agent_hint.md").read_bytes().rstrip(b"\r\n")
34
+
35
+ def read(self, path: Path) -> str:
36
+ return path.read_text(encoding="utf-8")
37
+
38
+ def read_bytes(self, path: Path) -> bytes | None:
39
+ return read_bytes(path)
40
+
41
+ def write(self, path: Path, content: bytes) -> None:
42
+ atomic_write(path, content)
43
+
44
+ def remove(self, path: Path) -> None:
45
+ safe_path(path).unlink(missing_ok=True)
46
+
47
+ def resolve(self, path: Path) -> Path:
48
+ return safe_path(path)
49
+
50
+ def lock(self, targets: list[Path]) -> AbstractContextManager[None]:
51
+ return write_lock(self.state_root, targets)
@@ -0,0 +1,98 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from dataclasses import asdict, dataclass
5
+ from hashlib import sha256
6
+ from pathlib import Path
7
+
8
+ from pydantic import BaseModel, Field
9
+
10
+ from campfire_cli.common.exceptions import GovernanceBlockedError
11
+
12
+
13
+ class SkillInfo(BaseModel):
14
+ name: str
15
+ description: str = ""
16
+ path: str
17
+ status: str = "unknown"
18
+
19
+
20
+ class SkillResult(BaseModel):
21
+ status: str
22
+ skills: list[SkillInfo] = Field(default_factory=list)
23
+ operations: list[dict[str, str]] = Field(default_factory=list)
24
+ issues: list[dict[str, str]] = Field(default_factory=list)
25
+ content: str | None = None
26
+ adopted: list[dict[str, str]] = Field(default_factory=list)
27
+ completed_operations: list[dict[str, str]] = Field(default_factory=list)
28
+ preserved_files: list[str] = Field(default_factory=list)
29
+
30
+
31
+ def resource_digest(content: bytes | None) -> str:
32
+ return sha256(content).hexdigest() if content is not None else "missing"
33
+
34
+
35
+ @dataclass(frozen=True)
36
+ class OwnedFile:
37
+ path: str
38
+ kind: str
39
+
40
+
41
+ @dataclass
42
+ class Registry:
43
+ distribution: str
44
+ skills: list[str]
45
+ hints: list[str]
46
+ files: list[OwnedFile]
47
+
48
+ @classmethod
49
+ def load(cls, raw: bytes, distribution: str) -> Registry:
50
+ try:
51
+ data = json.loads(raw)
52
+ if not isinstance(data, dict) or data.get("distribution") != distribution:
53
+ raise ValueError("identity")
54
+ skills, hints, files = data["skills"], data["hints"], data["files"]
55
+ if not all(isinstance(items, list) for items in (skills, hints, files)):
56
+ raise ValueError("lists")
57
+ if not all(isinstance(item, str) for item in [*skills, *hints]):
58
+ raise ValueError("paths")
59
+ if not all(Path(item).is_absolute() for item in [*skills, *hints]):
60
+ raise ValueError("absolute paths")
61
+ owned: list[OwnedFile] = []
62
+ for item in files:
63
+ if not isinstance(item, dict) or not all(
64
+ isinstance(item.get(key), str) for key in ("path", "kind")
65
+ ):
66
+ raise ValueError("files")
67
+ if item["kind"] not in {"skill", "hint"}:
68
+ raise ValueError("kind")
69
+ owned.append(OwnedFile(item["path"], item["kind"]))
70
+ if len({item.path for item in owned}) != len(owned):
71
+ raise ValueError("duplicate paths")
72
+ return cls(distribution, skills, hints, owned)
73
+ except (ValueError, KeyError, TypeError) as exc:
74
+ raise GovernanceBlockedError(
75
+ "Resource registry is invalid; preserve it and repair explicitly",
76
+ code="invalid-registry",
77
+ ) from exc
78
+
79
+ def encode(self) -> bytes:
80
+ return (
81
+ json.dumps(asdict(self), sort_keys=True, ensure_ascii=False, indent=2) + "\n"
82
+ ).encode()
83
+
84
+
85
+ @dataclass(frozen=True)
86
+ class Change:
87
+ path: Path
88
+ before: str
89
+ content: bytes | None
90
+ action: str
91
+
92
+ def describe(self) -> dict[str, str]:
93
+ return {
94
+ "path": str(self.path),
95
+ "action": self.action,
96
+ "expected_hash": self.before,
97
+ "new_hash": resource_digest(self.content),
98
+ }