campfire-cli 0.2.5__tar.gz → 0.2.6__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 (270) hide show
  1. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/.github/workflows/release.yml +17 -1
  2. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/ARCHITECTURE.md +3 -1
  3. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/CHANGELOG.md +11 -0
  4. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/PKG-INFO +6 -2
  5. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/README.md +5 -1
  6. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/SPEC.md +3 -3
  7. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/pyproject.toml +1 -1
  8. campfire_cli-0.2.6/scripts/package_upgrade_verify.py +125 -0
  9. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/scripts/quality_check.py +1 -1
  10. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/__init__.py +1 -1
  11. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/SPEC.md +2 -1
  12. campfire_cli-0.2.6/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.6/src/campfire_cli/app/agent_resources}/cli/skill_cli.py +4 -1
  14. campfire_cli-0.2.6/src/campfire_cli/app/agent_resources/repository/agent_resource_repository.py +51 -0
  15. campfire_cli-0.2.6/src/campfire_cli/app/agent_resources/schema/agent_resource_schema.py +98 -0
  16. campfire_cli-0.2.6/src/campfire_cli/app/agent_resources/service/agent_resource_service.py +380 -0
  17. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/document_scanner.py +1 -3
  18. campfire_cli-0.2.6/src/campfire_cli/app/system/SPEC.md +10 -0
  19. campfire_cli-0.2.6/src/campfire_cli/app/system/cli/system_cli.py +86 -0
  20. campfire_cli-0.2.6/src/campfire_cli/app/system/service/system_service.py +210 -0
  21. campfire_cli-0.2.6/src/campfire_cli/app/system/service/upgrade_service.py +96 -0
  22. campfire_cli-0.2.6/src/campfire_cli/app/video/schema/__init__.py +0 -0
  23. campfire_cli-0.2.6/src/campfire_cli/app/video/service/__init__.py +0 -0
  24. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/workspace_cli.py +5 -1
  25. campfire_cli-0.2.6/src/campfire_cli/common/filesystem/resource_files.py +82 -0
  26. campfire_cli-0.2.6/src/campfire_cli/common/media/__init__.py +0 -0
  27. campfire_cli-0.2.6/src/campfire_cli/common/package_update_worker.py +139 -0
  28. campfire_cli-0.2.6/src/campfire_cli/common/package_updater.py +230 -0
  29. campfire_cli-0.2.6/src/campfire_cli/common/package_version.py +39 -0
  30. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/config/settings.py +30 -0
  31. campfire_cli-0.2.6/src/campfire_cli/container.py +154 -0
  32. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/main.py +15 -71
  33. campfire_cli-0.2.5/src/campfire_cli/common/agent_hints.py → campfire_cli-0.2.6/src/campfire_cli/resources/agent_hint.md +7 -48
  34. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/SKILL.md +4 -0
  35. campfire_cli-0.2.6/src/campfire_cli/resources/skills/campfire-workspace-maintenance/references/resource-upgrade.md +10 -0
  36. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/conftest.py +1 -2
  37. campfire_cli-0.2.6/tests/integration/test_agent_resources.py +142 -0
  38. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_json_discovery.py +2 -1
  39. campfire_cli-0.2.6/tests/integration/test_upgrade.py +172 -0
  40. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_workspace_templates.py +3 -1
  41. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_agent_hints.py +12 -5
  42. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_package_version.py +0 -38
  43. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_workspace_manifest.py +1 -1
  44. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/uv.lock +1 -1
  45. campfire_cli-0.2.5/src/campfire_cli/app/skill/SPEC.md +0 -3
  46. campfire_cli-0.2.5/src/campfire_cli/app/skill/repository/skill_repository.py +0 -33
  47. campfire_cli-0.2.5/src/campfire_cli/app/skill/schema/skill_schema.py +0 -18
  48. campfire_cli-0.2.5/src/campfire_cli/app/skill/service/skill_service.py +0 -150
  49. campfire_cli-0.2.5/src/campfire_cli/common/package_version.py +0 -127
  50. campfire_cli-0.2.5/src/campfire_cli/container.py +0 -313
  51. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  52. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  53. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  54. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/.github/workflows/ci.yml +0 -0
  55. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/.gitignore +0 -0
  56. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/.python-version +0 -0
  57. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/AGENTS.md +0 -0
  58. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/COMMAND.md +0 -0
  59. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/CONTRIBUTING.md +0 -0
  60. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/DECISIONS.md +0 -0
  61. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/LICENSE +0 -0
  62. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/SECURITY.md +0 -0
  63. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/alembic/SPEC.md +0 -0
  64. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/alembic/env.py +0 -0
  65. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/alembic/script.py.mako +0 -0
  66. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/alembic/versions/001_initial_schema.py +0 -0
  67. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/alembic.ini +0 -0
  68. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/docs/git-sync.md +0 -0
  69. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/docs/quickstart.md +0 -0
  70. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/docs/safety.md +0 -0
  71. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/scripts/SPEC.md +0 -0
  72. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/scripts/pypi_verify.py +0 -0
  73. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/scripts/release_check.py +0 -0
  74. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/__init__.py +0 -0
  75. {campfire_cli-0.2.5/src/campfire_cli/app/skill → campfire_cli-0.2.6/src/campfire_cli/app/agent_resources}/__init__.py +0 -0
  76. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/base/SPEC.md +0 -0
  77. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/base/__init__.py +0 -0
  78. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/base/cli/base_cli.py +0 -0
  79. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/base/repository/base_repository.py +0 -0
  80. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/base/schema/base_schema.py +0 -0
  81. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/base/schema/operation_schema.py +0 -0
  82. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/base/service/base_service.py +0 -0
  83. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/SPEC.md +0 -0
  84. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/__init__.py +0 -0
  85. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/cli/__init__.py +0 -0
  86. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/cli/document_cli.py +0 -0
  87. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/cli/profile_cli.py +0 -0
  88. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/cli/type_cli.py +0 -0
  89. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/repository/__init__.py +0 -0
  90. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/repository/document_index_repository.py +0 -0
  91. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/repository/document_profile_repository.py +0 -0
  92. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/repository/document_type_repository.py +0 -0
  93. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/schema/__init__.py +0 -0
  94. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/schema/document_schema.py +0 -0
  95. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/__init__.py +0 -0
  96. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/document_service.py +0 -0
  97. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/index/__init__.py +0 -0
  98. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/index/document_index_builder.py +0 -0
  99. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/index/document_index_protocol.py +0 -0
  100. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/index/document_index_service.py +0 -0
  101. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/mutation/__init__.py +0 -0
  102. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/mutation/document_apply_service.py +0 -0
  103. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/mutation/document_move_service.py +0 -0
  104. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/mutation/document_relocation.py +0 -0
  105. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/mutation/frontmatter_apply.py +0 -0
  106. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/__init__.py +0 -0
  107. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/document_patch_values.py +0 -0
  108. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/document_profile_service.py +0 -0
  109. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/document_rule_service.py +0 -0
  110. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/document_type_service.py +0 -0
  111. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/frontmatter_formatter.py +0 -0
  112. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/frontmatter_plan.py +0 -0
  113. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/kanban_service.py +0 -0
  114. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/profile_candidates.py +0 -0
  115. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/profile_registry.py +0 -0
  116. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/document/service/rules/type_plan.py +0 -0
  117. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/SPEC.md +0 -0
  118. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/__init__.py +0 -0
  119. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/cli/maintenance_cli.py +0 -0
  120. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/repository/maintenance_repository.py +0 -0
  121. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/schema/maintenance_schema.py +0 -0
  122. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/service/maintenance_protocol.py +0 -0
  123. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/service/maintenance_service.py +0 -0
  124. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/maintenance/service/moc_service.py +0 -0
  125. {campfire_cli-0.2.5/src/campfire_cli/app/video → campfire_cli-0.2.6/src/campfire_cli/app/system}/__init__.py +0 -0
  126. {campfire_cli-0.2.5/src/campfire_cli/app/video → campfire_cli-0.2.6/src/campfire_cli/app/system}/cli/__init__.py +0 -0
  127. {campfire_cli-0.2.5/src/campfire_cli/app/video/schema → campfire_cli-0.2.6/src/campfire_cli/app/system/service}/__init__.py +0 -0
  128. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/video/SPEC.md +0 -0
  129. {campfire_cli-0.2.5/src/campfire_cli/app/video/service → campfire_cli-0.2.6/src/campfire_cli/app/video}/__init__.py +0 -0
  130. {campfire_cli-0.2.5/src/campfire_cli/common/media → campfire_cli-0.2.6/src/campfire_cli/app/video/cli}/__init__.py +0 -0
  131. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/video/cli/video_cli.py +0 -0
  132. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/video/schema/video_schema.py +0 -0
  133. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/video/service/video_protocol.py +0 -0
  134. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/video/service/video_service.py +0 -0
  135. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/SPEC.md +0 -0
  136. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/__init__.py +0 -0
  137. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/__init__.py +0 -0
  138. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/config_cli.py +0 -0
  139. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/domain_cli.py +0 -0
  140. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/git_cli.py +0 -0
  141. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/project_cli.py +0 -0
  142. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/restructure_cli.py +0 -0
  143. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/cli/space_cli.py +0 -0
  144. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/repository/__init__.py +0 -0
  145. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/repository/manifest_repository.py +0 -0
  146. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/repository/restructure_repository.py +0 -0
  147. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/repository/workspace_repository.py +0 -0
  148. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/schema/__init__.py +0 -0
  149. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/schema/adoption_schema.py +0 -0
  150. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/schema/restructure_schema.py +0 -0
  151. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/schema/workspace_schema.py +0 -0
  152. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/__init__.py +0 -0
  153. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/adoption_service.py +0 -0
  154. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/config_service.py +0 -0
  155. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/domain_restructure_service.py +0 -0
  156. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/git_sync_service.py +0 -0
  157. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/project_service.py +0 -0
  158. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/restructure_protocol.py +0 -0
  159. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/restructure_service.py +0 -0
  160. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/restructure_verifier.py +0 -0
  161. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/structure_service.py +0 -0
  162. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/workspace_protocol.py +0 -0
  163. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/app/workspace/service/workspace_service.py +0 -0
  164. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/SPEC.md +0 -0
  165. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/__init__.py +0 -0
  166. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/cli_output.py +0 -0
  167. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/database/__init__.py +0 -0
  168. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/database/models.py +0 -0
  169. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/database/session.py +0 -0
  170. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/documents/__init__.py +0 -0
  171. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/documents/document_types.py +0 -0
  172. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/documents/domain_context.py +0 -0
  173. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/documents/frontmatter_format.py +0 -0
  174. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/documents/frontmatter_schema.py +0 -0
  175. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/documents/markdown.py +0 -0
  176. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/documents/related_docs.py +0 -0
  177. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/exceptions/__init__.py +0 -0
  178. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/exceptions/base.py +0 -0
  179. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/filesystem/__init__.py +0 -0
  180. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/filesystem/atomic.py +0 -0
  181. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/filesystem/change_set.py +0 -0
  182. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/filesystem/cwd.py +0 -0
  183. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/filesystem/locking.py +0 -0
  184. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/filesystem/plan.py +0 -0
  185. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/git.py +0 -0
  186. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/governance/__init__.py +0 -0
  187. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/governance/issues.py +0 -0
  188. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/governance/locking.py +0 -0
  189. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/governance/snapshots.py +0 -0
  190. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/hashing.py +0 -0
  191. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/media/media_backend.py +0 -0
  192. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/media/media_worker.py +0 -0
  193. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/media/model_download.py +0 -0
  194. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/media/video_runtime.py +0 -0
  195. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/reports/__init__.py +0 -0
  196. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/reports/json_report.py +0 -0
  197. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/common/reports/markdown_report.py +0 -0
  198. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/config/SPEC.md +0 -0
  199. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/config/defaults.py +0 -0
  200. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/__init__.py +0 -0
  201. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/bases/SPEC.md +0 -0
  202. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  203. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  204. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  205. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  206. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/bases//346/226/207/346/241/243/345/267/245/344/275/234/345/217/260.base" +0 -0
  207. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/defaults/__init__.py +0 -0
  208. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/defaults/config.yml +0 -0
  209. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/SPEC.md +0 -0
  210. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/TEMPLATE.md +0 -0
  211. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-context-bootstrap/SKILL.md +0 -0
  212. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-context-bootstrap/agents/openai.yaml +0 -0
  213. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-conversation-router/SKILL.md +0 -0
  214. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-conversation-router/agents/openai.yaml +0 -0
  215. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-conversation-router/references/inbox-handoff.md +0 -0
  216. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-conversation-router/references/learning-intake.md +0 -0
  217. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-conversation-router/references/task-intake.md +0 -0
  218. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-document-capture/SKILL.md +0 -0
  219. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  220. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  221. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  222. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  223. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  224. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-inbox-triage/SKILL.md +0 -0
  225. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-kanban-board/SKILL.md +0 -0
  226. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-task-management/SKILL.md +0 -0
  227. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-video-capture/SKILL.md +0 -0
  228. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/SKILL.md +0 -0
  229. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/agents/openai.yaml +0 -0
  230. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-workspace-adoption/SKILL.md +0 -0
  231. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/references/git-sync-scheduling.md +0 -0
  232. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-workspace-onboarding/SKILL.md +0 -0
  233. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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
  234. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-workspace-restructure/SKILL.md +0 -0
  235. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/skills/campfire-workspace-restructure/references/restructure-spec.md +0 -0
  236. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277/README.md" +0 -0
  237. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277//346/250/241/346/235/277-/344/273/273/345/212/241.md" +0 -0
  238. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277//346/250/241/346/235/277-/347/211/210/346/234/254/345/217/221/345/270/203/346/270/205/345/215/225.md" +0 -0
  239. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/SPEC.md +0 -0
  240. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_cli.py +0 -0
  241. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_domain_rename_sync.py +0 -0
  242. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_git_sync.py +0 -0
  243. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_profile_resolution.py +0 -0
  244. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_project_repositories.py +0 -0
  245. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_quickstart.py +0 -0
  246. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_rebuildable_storage.py +0 -0
  247. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_relation_pages_cli.py +0 -0
  248. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_setup_diagnostics.py +0 -0
  249. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/integration/test_skill_examples.py +0 -0
  250. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/perf/test_read_counts.py +0 -0
  251. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/perf/test_resolve_subprocess_count.py +0 -0
  252. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_atomic_write.py +0 -0
  253. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_base_service.py +0 -0
  254. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_config.py +0 -0
  255. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_document_apply.py +0 -0
  256. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_document_index.py +0 -0
  257. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_document_scanner.py +0 -0
  258. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_domain_context.py +0 -0
  259. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_domain_paths.py +0 -0
  260. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_file_change_executor.py +0 -0
  261. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_frontmatter.py +0 -0
  262. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_generated_regions.py +0 -0
  263. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_kanban_service.py +0 -0
  264. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_operation_schema.py +0 -0
  265. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_pypi_verify.py +0 -0
  266. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_related_docs.py +0 -0
  267. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_release_check.py +0 -0
  268. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_repository_boundaries.py +0 -0
  269. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/tests/unit/test_video.py +0 -0
  270. {campfire_cli-0.2.5 → campfire_cli-0.2.6}/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,18 @@
1
1
  # 版本记录
2
2
 
3
+ ## 0.2.6 — 2026-10-12
4
+
5
+ - 系统命令与跨模块编排迁入 System,Skill 与 Hint 收敛为 Agent Resources;全局资源不再依赖空 Workspace 配置。
6
+ - 增加 --version/-V、公开离线 upgrade --skip-package 与 agent upgrade-status,包和资源阶段分别持久化,启动只报告 planned。
7
+ - 通过安装登记识别 uv tool/pipx,隔离 worker 等待宿主退出并使用参数数组更新;新版身份和版本验证通过后才对齐资源。
8
+ - 旧托管资源可直接接管;登记文件随包清理,用户新增文件保留。Hint 拒绝异常标记,块外原始字节与 CRLF 保留,附属文件按字节分发。
9
+ - 部分资源失败、Workspace 不可访问与配置失败不再汇总为 ok;blocked 输出 stderr 单行 JSON 并退出 3。版本 JSON 新增 package 字段,依赖完整对象相等的调用方须更新。
10
+ - 本轮按已确认清单采用 0.2.6,新增公共能力作为次版本规则的明确例外;不转换旧配置,不覆盖 Workspace 模板,不启用定时任务。
11
+
3
12
  ## 0.2.5 — 2026-10-10
4
13
 
14
+ [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)
15
+
5
16
  - Bootstrap 增加 Tickwork 本机定时任务入口,缺少 CLI 或 Skill 时提供安装与接入指引;具体任务管理仍由 Tickwork Skill 负责。
6
17
  - 修复文件改名暂存后 Git 重命名识别导致的同步快照误变化,不修改用户 Git 配置,仍保留实际并发变化检查。
7
18
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: campfire-cli
3
- Version: 0.2.5
3
+ Version: 0.2.6
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
 
@@ -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
 
@@ -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 内的工具目录。
@@ -51,7 +51,7 @@ SQLite / Filesystem Implementation
51
51
  - `campfire upgrade` 是唯一的幂等升级入口:先更新 Python 包本身,再对齐本机治理资源,覆盖当前表结构初始化、全局 Skill、Base 与提示词路标;不维护历史迁移链或旧格式转换。
52
52
  - 包自更新按检测到的安装方式在独立进程中执行,当前支持 uv tool 与 pipx。更新脚本必须等待当前进程退出后再运行,因为 Windows 会锁定运行中的解释器与可执行文件,包管理器无法原地替换;成功后由新版代码完成资源对齐。
53
53
  - editable 源码安装、离线、无法识别安装方式时跳过包更新仅对齐资源,结果中以 `action` 与 `hint` 显式说明原因。
54
- - 自更新链使用的内部参数必须 `hidden=True`,`--skip-package` 是当前实例,不进入公共 CLI 契约。
54
+ - `--skip-package` 是公开的离线资源对齐入口,不发起版本网络查询。自更新链使用的其他内部参数必须 `hidden=True`。
55
55
  - 外部网络查询尽力而为,例如 PyPI 版本检测;失败或超时静默降级,不得让命令失败或明显变慢。
56
56
 
57
57
  ## 开发纪律
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "campfire-cli"
3
- version = "0.2.5"
3
+ version = "0.2.6"
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,125 @@
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
+ while time.monotonic() < deadline:
101
+ result = json.loads(result_path.read_bytes())
102
+ if result["state"] in {"completed", "failed"}:
103
+ break
104
+ time.sleep(0.2)
105
+ if result["state"] != "completed":
106
+ raise RuntimeError(Path(operation["log_path"]).read_text(encoding="utf-8"))
107
+ assert result["installed_version"] == new_version, result
108
+ assert result["package_stage"] == result["resource_stage"] == "completed", result
109
+ return {
110
+ "manager": manager,
111
+ "from_version": old_version,
112
+ "version": new_version,
113
+ "state": result["state"],
114
+ "package_stage": result["package_stage"],
115
+ "resource_stage": result["resource_stage"],
116
+ "spaces_in_paths": True,
117
+ }
118
+
119
+
120
+ if __name__ == "__main__":
121
+ parser = argparse.ArgumentParser()
122
+ parser.add_argument("--manager", required=True, choices=["uv-tool", "pipx"])
123
+ parser.add_argument("--baseline", default="v0.2.5")
124
+ arguments = parser.parse_args()
125
+ 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.6"
@@ -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
+ }