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