campfire-cli 0.2.8__tar.gz → 0.3.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.8 → campfire_cli-0.3.1}/.github/workflows/release.yml +30 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/ARCHITECTURE.md +19 -2
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/CHANGELOG.md +13 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/PKG-INFO +38 -3
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/README.md +35 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/SPEC.md +9 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/pyproject.toml +3 -2
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/__init__.py +1 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/SPEC.md +1 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/SPEC.md +1 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/SPEC.md +20 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/adapter/launchd_scheduler.py +114 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/adapter/systemd_scheduler.py +140 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/adapter/windows_scheduler.py +171 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/cli/job_cli.py +180 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/interface/scheduler.py +37 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/repository/job_repository.py +73 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/repository/run_repository.py +228 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/schema/job_schema.py +102 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/schema/retention_schema.py +68 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/service/job_service.py +472 -0
- campfire_cli-0.3.1/src/campfire_cli/app/job/service/runner.py +134 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/system/SPEC.md +1 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/system/service/upgrade_service.py +5 -2
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/schema/workspace_schema.py +1 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/cli_output.py +17 -4
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/database/__init__.py +2 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/database/session.py +22 -74
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/exceptions/__init__.py +2 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/exceptions/base.py +21 -0
- campfire_cli-0.3.1/src/campfire_cli/common/filesystem/process_lock.py +84 -0
- campfire_cli-0.3.1/src/campfire_cli/common/process.py +37 -0
- campfire_cli-0.3.1/src/campfire_cli/common/time_display.py +23 -0
- campfire_cli-0.3.1/src/campfire_cli/common/windows_job.py +95 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/config/SPEC.md +2 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/container.py +39 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/main.py +6 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/agent_hint.md +1 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/defaults/config.yml +12 -1
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-context-bootstrap/SKILL.md +3 -5
- campfire_cli-0.3.1/src/campfire_cli/resources/skills/campfire-job-management/SKILL.md +80 -0
- campfire_cli-0.3.1/src/campfire_cli/resources/skills/campfire-job-management/references/agent-execution.md +23 -0
- campfire_cli-0.3.1/src/campfire_cli/resources/skills/campfire-job-management/references/platform-notes.md +11 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/SKILL.md +2 -2
- campfire_cli-0.3.1/src/campfire_cli/resources/skills/campfire-workspace-maintenance/references/git-sync-scheduling.md +19 -0
- campfire_cli-0.3.1/tests/integration/test_job_native.py +172 -0
- campfire_cli-0.3.1/tests/integration/test_jobs.py +377 -0
- campfire_cli-0.3.1/tests/unit/test_job_native_formats.py +71 -0
- campfire_cli-0.3.1/tests/unit/test_job_retention.py +44 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/uv.lock +17 -5
- campfire_cli-0.2.8/src/campfire_cli/resources/skills/campfire-workspace-maintenance/references/git-sync-scheduling.md +0 -42
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/.github/workflows/ci.yml +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/.gitignore +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/.python-version +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/AGENTS.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/COMMAND.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/CONTRIBUTING.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/DECISIONS.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/LICENSE +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/SECURITY.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/alembic/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/alembic/env.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/alembic/script.py.mako +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/alembic/versions/001_initial_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/alembic.ini +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/docs/git-sync.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/docs/quickstart.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/docs/safety.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/scripts/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/scripts/package_upgrade_verify.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/scripts/pypi_verify.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/scripts/quality_check.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/scripts/release_check.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/agent_resources/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/agent_resources/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/agent_resources/cli/skill_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/agent_resources/repository/agent_resource_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/agent_resources/schema/agent_resource_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/agent_resources/service/agent_resource_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/base/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/base/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/base/cli/base_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/base/repository/base_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/base/schema/base_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/base/schema/operation_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/base/service/base_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/cli/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/cli/document_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/cli/profile_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/cli/type_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/repository/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/repository/document_index_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/repository/document_profile_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/repository/document_type_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/schema/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/schema/document_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/document_scanner.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/document_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/index/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/index/document_index_builder.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/index/document_index_protocol.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/index/document_index_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/mutation/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/mutation/document_apply_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/mutation/document_move_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/mutation/document_relocation.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/mutation/frontmatter_apply.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/document_patch_values.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/document_profile_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/document_rule_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/document_type_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/frontmatter_formatter.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/frontmatter_plan.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/kanban_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/profile_candidates.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/profile_registry.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/document/service/rules/type_plan.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/cli/maintenance_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/repository/maintenance_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/schema/maintenance_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/service/maintenance_protocol.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/service/maintenance_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/maintenance/service/moc_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/system/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/system/cli/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/system/cli/system_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/system/service/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/system/service/system_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/cli/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/cli/video_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/schema/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/schema/video_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/service/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/service/video_protocol.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/video/service/video_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/config_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/domain_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/git_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/project_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/restructure_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/space_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/cli/workspace_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/repository/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/repository/manifest_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/repository/restructure_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/repository/workspace_repository.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/schema/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/schema/adoption_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/schema/restructure_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/adoption_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/config_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/domain_restructure_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/git_sync_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/project_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/restructure_protocol.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/restructure_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/restructure_verifier.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/structure_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/workspace_protocol.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/app/workspace/service/workspace_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/database/models.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/documents/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/documents/document_types.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/documents/domain_context.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/documents/frontmatter_format.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/documents/frontmatter_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/documents/markdown.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/documents/related_docs.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/filesystem/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/filesystem/atomic.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/filesystem/change_set.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/filesystem/cwd.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/filesystem/locking.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/filesystem/plan.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/filesystem/resource_files.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/git.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/governance/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/governance/issues.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/governance/locking.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/governance/snapshots.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/hashing.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/media/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/media/media_backend.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/media/media_worker.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/media/model_download.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/media/video_runtime.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/package_update_worker.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/package_updater.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/package_version.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/reports/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/reports/json_report.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/common/reports/markdown_report.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/config/defaults.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/config/settings.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/bases/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/defaults/__init__.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/TEMPLATE.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-context-bootstrap/agents/openai.yaml +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-conversation-router/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-conversation-router/agents/openai.yaml +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-conversation-router/references/inbox-handoff.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-conversation-router/references/learning-intake.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-conversation-router/references/task-intake.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-document-capture/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-inbox-triage/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-kanban-board/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-task-mainline/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-task-management/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-video-capture/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-weekly-report-writing/agents/openai.yaml +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-workspace-adoption/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/references/resource-upgrade.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-workspace-onboarding/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.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" +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-workspace-restructure/SKILL.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/skills/campfire-workspace-restructure/references/restructure-spec.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/src/campfire_cli/resources/workspace/_/346/250/241/346/235/277/README.md" +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.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.8 → campfire_cli-0.3.1}/tests/SPEC.md +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/conftest.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_agent_resources.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_cache_rebuild.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_domain_rename_sync.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_git_sync.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_json_discovery.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_profile_resolution.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_project_repositories.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_quickstart.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_rebuildable_storage.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_relation_pages_cli.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_setup_diagnostics.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_skill_examples.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_upgrade.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_usability.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/integration/test_workspace_templates.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/perf/test_read_counts.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/perf/test_resolve_subprocess_count.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_agent_hints.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_atomic_write.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_base_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_config.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_document_apply.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_document_index.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_document_scanner.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_domain_context.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_domain_paths.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_file_change_executor.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_frontmatter.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_generated_regions.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_kanban_service.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_operation_schema.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_package_update_worker.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_package_version.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_pypi_verify.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_related_docs.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_release_check.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_repository_boundaries.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_video.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_video_runtime.py +0 -0
- {campfire_cli-0.2.8 → campfire_cli-0.3.1}/tests/unit/test_workspace_manifest.py +0 -0
|
@@ -6,6 +6,35 @@ on:
|
|
|
6
6
|
tags: ["v*"]
|
|
7
7
|
|
|
8
8
|
jobs:
|
|
9
|
+
native:
|
|
10
|
+
strategy:
|
|
11
|
+
fail-fast: false
|
|
12
|
+
matrix:
|
|
13
|
+
os: [ubuntu-latest, macos-latest, windows-latest]
|
|
14
|
+
runs-on: ${{ matrix.os }}
|
|
15
|
+
timeout-minutes: 15
|
|
16
|
+
env:
|
|
17
|
+
PYTHONUTF8: "1"
|
|
18
|
+
RUN_NATIVE_TEST: "1"
|
|
19
|
+
NATIVE_EVIDENCE_DIR: native-evidence
|
|
20
|
+
steps:
|
|
21
|
+
- uses: actions/checkout@v5
|
|
22
|
+
- uses: astral-sh/setup-uv@v10.1.0
|
|
23
|
+
- run: uv sync --frozen
|
|
24
|
+
- name: Start Linux test user manager
|
|
25
|
+
if: runner.os == 'Linux'
|
|
26
|
+
shell: bash
|
|
27
|
+
run: |
|
|
28
|
+
sudo systemctl start user@$(id -u).service
|
|
29
|
+
echo "XDG_RUNTIME_DIR=/run/user/$(id -u)" >> "$GITHUB_ENV"
|
|
30
|
+
echo "DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$(id -u)/bus" >> "$GITHUB_ENV"
|
|
31
|
+
- name: Verify native lifecycle and actual timer execution
|
|
32
|
+
run: uv run pytest -q tests/integration/test_job_native.py
|
|
33
|
+
- uses: actions/upload-artifact@v4
|
|
34
|
+
if: always()
|
|
35
|
+
with:
|
|
36
|
+
name: native-${{ runner.os }}
|
|
37
|
+
path: native-evidence/
|
|
9
38
|
upgrade:
|
|
10
39
|
strategy:
|
|
11
40
|
fail-fast: false
|
|
@@ -68,7 +97,7 @@ jobs:
|
|
|
68
97
|
|
|
69
98
|
publish:
|
|
70
99
|
if: github.event_name == 'push'
|
|
71
|
-
needs: [quality, video, upgrade]
|
|
100
|
+
needs: [quality, video, upgrade, native]
|
|
72
101
|
runs-on: ubuntu-latest
|
|
73
102
|
permissions:
|
|
74
103
|
id-token: write
|
|
@@ -8,7 +8,7 @@ Campfire 是一个面向工作与学习场景的、本地优先的人机协作 C
|
|
|
8
8
|
|
|
9
9
|
Campfire 不把聊天记录当作长期事实来源,也不绑定 Obsidian、某一种 Agent 或某一个 Workspace。Obsidian Vault 是当前首个 Markdown 存储适配器,而不是产品边界。
|
|
10
10
|
|
|
11
|
-
Campfire
|
|
11
|
+
Campfire 支持通过本机原生调度定时启动普通命令、Codex 或 Claude Code,围绕 Vault 中的上下文执行已授权工作。它不管理 Agent 会话编排、实时消息推送或替代 Jira/Notion。
|
|
12
12
|
|
|
13
13
|
## 2. 核心业务对象
|
|
14
14
|
|
|
@@ -210,7 +210,7 @@ Campfire 不把“调用方能够猜对未声明契约”作为可靠性前提
|
|
|
210
210
|
| 文档查询索引 | Workspace Markdown、结构声明与有效治理契约 | `~/.campfire/campfire.db` 中按 `workspace_id` 隔离的可重建投影 |
|
|
211
211
|
| 结构重构批次和维护运行状态 | `~/.campfire/campfire.db` | Markdown 投影、报告与有限变更日志;可丢弃并重新生成,新计划重新审批 |
|
|
212
212
|
|
|
213
|
-
Vault 根目录 `.campfire.yaml` 和本机 `~/.campfire/local.yaml` 保存注册事实;
|
|
213
|
+
Vault 根目录 `.campfire.yaml` 和本机 `~/.campfire/local.yaml` 保存注册事实;campfire.db 全部可重建,不是知识内容或注册数据的 SSOT;jobs/runs.db 是可清理但不可从文件重建的运行历史。工具状态不写入 Workspace,因而一个 Campfire 安装可以管理多个 Workspace。
|
|
214
214
|
|
|
215
215
|
### 文档查询投影
|
|
216
216
|
|
|
@@ -288,3 +288,20 @@ Adoption 是首次接管边界,不属于日常 Maintenance。`workspace domain
|
|
|
288
288
|
本机配置按 Workspace id 分节,repository_bindings 按 Project id 和 repository id 保存路径;remote 和分支只在 Vault 根目录 `.campfire.yaml`。SQLite 无注册事实、无历史迁移链,只从当前文件生成投影;停止运行中的操作后可整库删除重建。
|
|
289
289
|
|
|
290
290
|
领域分类与 Project 归属不决定治理方式。所有领域共用结构、检查与 MOC 生成;Project 只关联仓库便携信息与本机位置,Domain 不保存 governance 字段。
|
|
291
|
+
|
|
292
|
+
## 本机执行与环境记录(v0.3.0)
|
|
293
|
+
|
|
294
|
+
```text
|
|
295
|
+
campfire job -> JobService -> jobs.yaml(本机执行定义)
|
|
296
|
+
-> 原生调度器(实际启停与触发)
|
|
297
|
+
-> Runner -> jobs/runs.db(历史与日志)
|
|
298
|
+
|
|
|
299
|
+
+-> 普通命令 / Codex / Claude Code
|
|
300
|
+
|
|
301
|
+
Agent + 可选 Job Skill -> 查询该 Workspace 的本机 Job
|
|
302
|
+
-> Vault/_定时任务/记录-<主机名>.md
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
local.yaml 保存稳定环境 id 与原有本机绑定,Job 不依赖已注册 Workspace。显式 workspace_id 绑定的任务在同 Workspace 执行层互斥,治理写锁仅覆盖真正的写操作;父 Runner 不占用整轮治理写锁。配置预览确认、原生部署补偿、运行中维护拒绝与升级协调见 app/job/SPEC.md。
|
|
306
|
+
|
|
307
|
+
环境文档只记录用途、时间规则、状态、最近结果与核验时间,不复制本机启动配置或日志,不反向部署。_定时任务 是系统受管范围,不属于 Space/Domain,首次记录时创建;无额外总览、远程控制或跨设备状态保证。原生用户会话、休眠和关机的限制按平台处理,不补跑或自动重试。
|
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# 版本记录
|
|
2
2
|
|
|
3
|
+
## 0.3.1 — 2026-11-17
|
|
4
|
+
|
|
5
|
+
- 定时任务环境记录改用可读主机名作文件名,环境 id 保留在正文核对;主机改名复用受管 apply --name,同名异环境停止核实。
|
|
6
|
+
- 父 Job 调用子 CLI 的集成测试给予合理启动时间,避免 Windows 冷启动触发与测试目的无关的 5 秒超时;产品超时行为不变。
|
|
7
|
+
|
|
8
|
+
## 0.3.0 — 2026-11-17
|
|
9
|
+
|
|
10
|
+
- 合并 Tickwork 的本机手动命令、三平台原生定时、进程树超时与运行日志,公开入口为 campfire job。
|
|
11
|
+
- Job 定义和稳定环境身份保存在本机 YAML,运行历史独立 SQLite,文档索引仍可整库删除重建。
|
|
12
|
+
- 增加显式 Workspace 绑定与执行互斥、计划复核、活动运行期间的维护和升级保护。
|
|
13
|
+
- 新增可选 campfire-job-management Skill,支持定时启动 Codex/Claude Code,并在 Vault _定时任务/ 中一环境一篇记录;不依赖 Tickwork、不迁移旧任务。
|
|
14
|
+
- 更新 Typer 参数接口与依赖范围,修复新版依赖安装后 JSON 帮助失效。
|
|
15
|
+
|
|
3
16
|
## 0.2.8 — 2026-11-17
|
|
4
17
|
|
|
5
18
|
- 新增 document list 可重复 --tags 精确 AND 查询与 apply --name 同次补结构和修复重名。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: campfire-cli
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.3.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
|
|
@@ -15,7 +15,8 @@ Requires-Dist: pydantic-settings>=2.2
|
|
|
15
15
|
Requires-Dist: pydantic>=2.7
|
|
16
16
|
Requires-Dist: pyyaml>=6.0
|
|
17
17
|
Requires-Dist: sqlalchemy>=2.0
|
|
18
|
-
Requires-Dist: typer
|
|
18
|
+
Requires-Dist: typer<0.30,>=0.29
|
|
19
|
+
Requires-Dist: tzdata>=2025.1
|
|
19
20
|
Provides-Extra: video
|
|
20
21
|
Requires-Dist: av<19,>=14; extra == 'video'
|
|
21
22
|
Requires-Dist: faster-whisper<2,>=1.1; extra == 'video'
|
|
@@ -28,7 +29,7 @@ Description-Content-Type: text/markdown
|
|
|
28
29
|
`campfire` 是面向工作与学习场景的本地优先人机协作 CLI。它让人类和多个 Agent 围绕同一份持久共享上下文协作:把口头要求、临时笔记、任务进度、项目资料和长期知识沉淀进可检索、可交接、可审计的 Workspace。
|
|
29
30
|
|
|
30
31
|
- **人类和 Agent 同一条链路**:同一套 CLI 契约 + 全局 Agent Skill,没有两套规则。
|
|
31
|
-
- **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;`.campfire.yaml` 保存便携项目事实,`~/.campfire/local.yaml` 保存本机注册与绑定;SQLite
|
|
32
|
+
- **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;`.campfire.yaml` 保存便携项目事实,`~/.campfire/local.yaml` 保存本机注册与绑定;campfire.db 是可重建索引;本机 Job 定义另存 YAML,历史与日志在独立 SQLite 中。
|
|
32
33
|
- **写操作默认预览**:先计划、再确认、执行前在治理锁内复核内容哈希,检测到输入变化时拒绝覆盖;不承诺外部编辑器遵守锁或跨介质崩溃原子性。
|
|
33
34
|
- **本地优先**:不绑定云服务、不内置账号;Obsidian 是推荐阅读工具而非强依赖;CLI 可独立治理 Markdown Workspace。
|
|
34
35
|
|
|
@@ -43,6 +44,40 @@ Description-Content-Type: text/markdown
|
|
|
43
44
|
|
|
44
45
|
推荐搭配 Obsidian:内置 Bases 展示表格,大纲提供章节导航;Kanban 用于看板,Obsidian Git 用于版本历史。它们不是普通文档查询和治理的前提。Templater、TOC 不作为依赖。插件配置教程等待维护者提供博客链接,不在 CLI 输出或仓库重复编写,也不自动修改插件设置。
|
|
45
46
|
|
|
47
|
+
## 本机命令与定时执行(v0.3.0)
|
|
48
|
+
|
|
49
|
+
安装使用 `uv tool install campfire-cli`,升级使用 `campfire upgrade`。Tickwork 的执行能力已并入 `campfire job`,支持普通脚本、Campfire、`codex exec` 和 `claude -p`,不要求另装 Tickwork。
|
|
50
|
+
|
|
51
|
+
```text
|
|
52
|
+
~/.campfire/
|
|
53
|
+
+-- local.yaml Workspace 本机绑定与稳定环境 id
|
|
54
|
+
+-- jobs.yaml 执行定义:argv、cwd、时间规则、超时
|
|
55
|
+
+-- campfire.db 可删除重建的文档索引
|
|
56
|
+
+-- jobs/runs.db 可清理的执行历史与日志
|
|
57
|
+
|
|
58
|
+
Vault/_定时任务/
|
|
59
|
+
+-- 记录-<主机名>.md Agent 根据 Skill 维护;一环境一篇
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
使用 `campfire job create --help` 查看 JSON 输入。manual 不部署定时器;interval(整分钟 60..86400 秒)、daily 和 weekly 使用设备本地时区及原生系统调度。新建暂停,更新保留启停状态;运行中拒绝修改和删除。同 Job 及显式绑定同 Workspace 的自动执行互斥,不持有整轮治理写锁。
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
campfire job create --file /absolute/job.json
|
|
66
|
+
campfire job create --file /absolute/job.json --expected-plan <创建预览摘要> --confirm
|
|
67
|
+
campfire job run example
|
|
68
|
+
campfire job run example --expected-plan <运行预览摘要> --confirm
|
|
69
|
+
campfire --workspace demo job list
|
|
70
|
+
campfire job history --job example
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
定时 Job 在获启用授权后,使用 `job resume <id>` 预览、带回该次摘要确认。`job doctor` 诊断本机调度条件,`result`/`logs` 查看实际运行;失败也返回本次查询入口。进程退出成功仍需核验业务产物。清理和 compact 独立预览,不改变定义或启用状态。
|
|
74
|
+
|
|
75
|
+
可选全局 `campfire-job-management` Skill 负责配置、测试、启用及环境文档维护,具体 Agent 启动方式按需读取其 references。任务约定明确允许动作、完成依据和结果位置,每次可从 Vault 最新进展恢复;不强制季度或业务文档目录。Agent 的登录与工具权限由客户端负责,不默认绕过权限。
|
|
76
|
+
|
|
77
|
+
Linux 需要可用的 systemd 用户 manager,macOS 需要已登录 GUI 会话,Windows 当前用户 Task Scheduler 需要登录会话及同安装环境 pythonw。命令使用绝对路径和 argv,stdin 关闭;不提高权限、不唤醒、不自动补跑或重试。升级不启用 Job,活动运行会阻止替换安装环境;重装到其他位置需显式 update 后核验原生入口。
|
|
78
|
+
|
|
79
|
+
环境文档只是截至核验时间的可读记录,不反向部署、不包含本机命令路径或凭据;CLI 查询、Runner 和升级不自动写它。删 campfire.db 不影响 Job、原生定时器或运行日志;删 runs.db 会失去历史,且活动运行时拒绝替换。旧 Tickwork 任务由 Agent 记录要求、暂停等待并移除,再通过普通 Job 命令新建,不导入或兼容旧数据库。
|
|
80
|
+
|
|
46
81
|
## 本地视频文字整理(v0.2.0)
|
|
47
82
|
|
|
48
83
|
本版统一公共 CLI 输出:成功在 stdout 返回一个 JSON 对象,错误在 stderr 返回一个 JSON 对象并以非零状态退出。`--help` 返回结构化参数,`tree` 返回层级命令树,`version` 返回 `{"status":"ok","version":"0.2.0"}`。旧脚本若将版本输出当纯字符串读取,须改读 `version` 字段;不再提供文本帮助或 shell 补全脚本输出。
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
`campfire` 是面向工作与学习场景的本地优先人机协作 CLI。它让人类和多个 Agent 围绕同一份持久共享上下文协作:把口头要求、临时笔记、任务进度、项目资料和长期知识沉淀进可检索、可交接、可审计的 Workspace。
|
|
4
4
|
|
|
5
5
|
- **人类和 Agent 同一条链路**:同一套 CLI 契约 + 全局 Agent Skill,没有两套规则。
|
|
6
|
-
- **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;`.campfire.yaml` 保存便携项目事实,`~/.campfire/local.yaml` 保存本机注册与绑定;SQLite
|
|
6
|
+
- **Markdown 是事实源**:正文永远可脱离 campfire 阅读和迁移;`.campfire.yaml` 保存便携项目事实,`~/.campfire/local.yaml` 保存本机注册与绑定;campfire.db 是可重建索引;本机 Job 定义另存 YAML,历史与日志在独立 SQLite 中。
|
|
7
7
|
- **写操作默认预览**:先计划、再确认、执行前在治理锁内复核内容哈希,检测到输入变化时拒绝覆盖;不承诺外部编辑器遵守锁或跨介质崩溃原子性。
|
|
8
8
|
- **本地优先**:不绑定云服务、不内置账号;Obsidian 是推荐阅读工具而非强依赖;CLI 可独立治理 Markdown Workspace。
|
|
9
9
|
|
|
@@ -18,6 +18,40 @@
|
|
|
18
18
|
|
|
19
19
|
推荐搭配 Obsidian:内置 Bases 展示表格,大纲提供章节导航;Kanban 用于看板,Obsidian Git 用于版本历史。它们不是普通文档查询和治理的前提。Templater、TOC 不作为依赖。插件配置教程等待维护者提供博客链接,不在 CLI 输出或仓库重复编写,也不自动修改插件设置。
|
|
20
20
|
|
|
21
|
+
## 本机命令与定时执行(v0.3.0)
|
|
22
|
+
|
|
23
|
+
安装使用 `uv tool install campfire-cli`,升级使用 `campfire upgrade`。Tickwork 的执行能力已并入 `campfire job`,支持普通脚本、Campfire、`codex exec` 和 `claude -p`,不要求另装 Tickwork。
|
|
24
|
+
|
|
25
|
+
```text
|
|
26
|
+
~/.campfire/
|
|
27
|
+
+-- local.yaml Workspace 本机绑定与稳定环境 id
|
|
28
|
+
+-- jobs.yaml 执行定义:argv、cwd、时间规则、超时
|
|
29
|
+
+-- campfire.db 可删除重建的文档索引
|
|
30
|
+
+-- jobs/runs.db 可清理的执行历史与日志
|
|
31
|
+
|
|
32
|
+
Vault/_定时任务/
|
|
33
|
+
+-- 记录-<主机名>.md Agent 根据 Skill 维护;一环境一篇
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
使用 `campfire job create --help` 查看 JSON 输入。manual 不部署定时器;interval(整分钟 60..86400 秒)、daily 和 weekly 使用设备本地时区及原生系统调度。新建暂停,更新保留启停状态;运行中拒绝修改和删除。同 Job 及显式绑定同 Workspace 的自动执行互斥,不持有整轮治理写锁。
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
campfire job create --file /absolute/job.json
|
|
40
|
+
campfire job create --file /absolute/job.json --expected-plan <创建预览摘要> --confirm
|
|
41
|
+
campfire job run example
|
|
42
|
+
campfire job run example --expected-plan <运行预览摘要> --confirm
|
|
43
|
+
campfire --workspace demo job list
|
|
44
|
+
campfire job history --job example
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
定时 Job 在获启用授权后,使用 `job resume <id>` 预览、带回该次摘要确认。`job doctor` 诊断本机调度条件,`result`/`logs` 查看实际运行;失败也返回本次查询入口。进程退出成功仍需核验业务产物。清理和 compact 独立预览,不改变定义或启用状态。
|
|
48
|
+
|
|
49
|
+
可选全局 `campfire-job-management` Skill 负责配置、测试、启用及环境文档维护,具体 Agent 启动方式按需读取其 references。任务约定明确允许动作、完成依据和结果位置,每次可从 Vault 最新进展恢复;不强制季度或业务文档目录。Agent 的登录与工具权限由客户端负责,不默认绕过权限。
|
|
50
|
+
|
|
51
|
+
Linux 需要可用的 systemd 用户 manager,macOS 需要已登录 GUI 会话,Windows 当前用户 Task Scheduler 需要登录会话及同安装环境 pythonw。命令使用绝对路径和 argv,stdin 关闭;不提高权限、不唤醒、不自动补跑或重试。升级不启用 Job,活动运行会阻止替换安装环境;重装到其他位置需显式 update 后核验原生入口。
|
|
52
|
+
|
|
53
|
+
环境文档只是截至核验时间的可读记录,不反向部署、不包含本机命令路径或凭据;CLI 查询、Runner 和升级不自动写它。删 campfire.db 不影响 Job、原生定时器或运行日志;删 runs.db 会失去历史,且活动运行时拒绝替换。旧 Tickwork 任务由 Agent 记录要求、暂停等待并移除,再通过普通 Job 命令新建,不导入或兼容旧数据库。
|
|
54
|
+
|
|
21
55
|
## 本地视频文字整理(v0.2.0)
|
|
22
56
|
|
|
23
57
|
本版统一公共 CLI 输出:成功在 stdout 返回一个 JSON 对象,错误在 stderr 返回一个 JSON 对象并以非零状态退出。`--help` 返回结构化参数,`tree` 返回层级命令树,`version` 返回 `{"status":"ok","version":"0.2.0"}`。旧脚本若将版本输出当纯字符串读取,须改读 `version` 字段;不再提供文本帮助或 shell 补全脚本输出。
|
|
@@ -121,7 +121,7 @@ Campfire 使用语义化版本:
|
|
|
121
121
|
- Markdown Frontmatter 的 `related_docs` 是文档关系唯一 SSOT,采用 `[[Workspace相对路径.md]]`。不解析、索引或自动改写正文链接;历史正文保留,SQLite 关系投影可从该字段重建;不再生成 Markdown 关系页,Agent 通过 document inspect 查询关系。
|
|
122
122
|
- 改名、移动与类型联动改名只定向更新 `related_docs` 引用方;预览输出 `expected_plan`,确认复核整个变更集摘要和文件哈希。文件提交后的索引失败必须报告已写入事实,并使索引可在下次查询恢复。
|
|
123
123
|
|
|
124
|
-
-
|
|
124
|
+
- campfire.db 全部表只允许作为可重建本机投影,不得反向覆盖 Markdown SSOT;Job 运行日志独立存储在 jobs/runs.db,删除后不恢复历史。
|
|
125
125
|
- Document App 拥有文档记录、确定关系、集合查询和单篇关系查询;Repository 只持久化投影,不解释 Profile、Domain 或链接语义。
|
|
126
126
|
- 文档索引保存 schema version、parser version、有效配置 hash、拓扑 hash 和 generation;Domain 声明、Project 文档根映射等任一解释输入变化都必须自动完整重建。
|
|
127
127
|
- `document list` 与 `document inspect` 查询前必须轻量 reconcile。文件 stat 只筛选变化候选,content hash 表示内容版本;调用方不需要先运行 Maintenance。
|
|
@@ -155,3 +155,11 @@ Campfire 使用语义化版本:
|
|
|
155
155
|
- v0.2.2 按用户指定版本发布,新增能力及删除 Domain 字段/参数明确记为本次版本例外与破坏性变化,不修改既有标签。
|
|
156
156
|
|
|
157
157
|
- 本轮按用户指定采用 0.2.x 补丁版本承载新增能力和退出状态契约变化,作为通常版本递增规则的显式例外。v0.2.7 标签因 Windows 门禁失败保留,修复后递增至 v0.2.8,不移动或覆盖既有标签。
|
|
158
|
+
|
|
159
|
+
## 本机 Job
|
|
160
|
+
|
|
161
|
+
- v0.3.0 将 Tickwork 核心并入 app/job,通过 campfire job 管理本机手动与原生定时命令,可启动 Codex、Claude Code 等外部 CLI;不引入常驻调度器或 Agent 会话编排。
|
|
162
|
+
- jobs.yaml 保存唯一任务定义,local.yaml 保存稳定环境 id,jobs/runs.db 保存运行历史;删 campfire.db 不影响这些数据与原生部署。
|
|
163
|
+
- Job 配置和执行确认采用当前计划摘要,同 Job 与同 Workspace 执行互斥,运行中拒绝修改、删除、compact 和升级替换环境;不持有整轮治理写锁。
|
|
164
|
+
- Vault 的 _定时任务/ 一环境一篇 record,由 Skill 查询后维护,属于可读记录而非执行配置;无 Domain、无额外总览,不写本机路径、凭据或原始日志。
|
|
165
|
+
- 统一到当前 Typer 0.29 参数描述接口与 JSON 帮助,依赖限制在已验证的次版本范围,不保留旧参数接口兼容分支。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "campfire-cli"
|
|
3
|
-
version = "0.
|
|
3
|
+
version = "0.3.1"
|
|
4
4
|
description = "Local-first shared context and governance CLI for humans and agents"
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
license = "MIT"
|
|
@@ -12,7 +12,8 @@ dependencies = [
|
|
|
12
12
|
"pydantic-settings>=2.2",
|
|
13
13
|
"pyyaml>=6.0",
|
|
14
14
|
"sqlalchemy>=2.0",
|
|
15
|
-
"typer>=0.
|
|
15
|
+
"typer>=0.29,<0.30",
|
|
16
|
+
"tzdata>=2025.1",
|
|
16
17
|
]
|
|
17
18
|
|
|
18
19
|
[project.urls]
|
|
@@ -36,6 +36,7 @@ document/
|
|
|
36
36
|
- `inspect`:向 Agent 返回单篇文档的 Domain、类型、有效 Profile、具体问题,以及 outgoing、incoming、unresolved 及入度、出度。
|
|
37
37
|
- `apply`:根据目标路径和类型解析 Profile,不存在时生成文档并在 Frontmatter 后写入唯一的 `<!-- CAMPFIRE:BODY -->` 正文锚点,已有 Frontmatter 时只应用显式补丁,无 Frontmatter 时保留正文并补齐完整契约;先完整渲染并校验,追加 `--confirm` 后原子写入。存量文档不因缺少锚点而迁移。
|
|
38
38
|
- `template`:只继承 base Profile,集中存放在 Workspace 根目录 `_模板/`,属于无 Domain 的系统受管范围;已有 Domain `_模板/` 仍可用。只校验模板目录和字段,不绑定目标类型、不校验正文结构,不维护继承关系。
|
|
39
|
+
- `_定时任务/` 是无 Domain 的系统受管 scope,环境记录复用 record/base Profile、正常 apply 和索引;不新增 Job 文档类型或反向配置协议。
|
|
39
40
|
- `move`:在任意已声明 Domain 之间移动一篇文档,按目标 Profile 对齐可确定的 `domain`/`project` 归属,并只更新 `related_docs` 的精确路径引用。目标 Profile 缺少业务字段时返回 `needs-input`,不猜测。
|
|
40
41
|
- `rename`:保持一篇文档的物理目录与 Domain 归属不变,根据逻辑标题重算类型前缀文件名,并在同一变更集中更新 `name` 与可确定引用。目标存在时阻止,不覆盖或自动编号。
|
|
41
42
|
- `scanner`:统一解释受管根、忽略目录和豁免文件;Document 与 Maintenance 共用。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Job SPEC
|
|
2
|
+
|
|
3
|
+
Job 是设备本地的命令执行与原生调度能力,独立于 Workspace 装配。CLI 只适配参数与 JSON;JobService 负责用例、身份与时间;Repository 只持久化调用者提供的数据;消费方 Scheduler Protocol 由三平台 adapter 实现。
|
|
4
|
+
|
|
5
|
+
```text
|
|
6
|
+
job CLI -> JobService -> JobRepository -> jobs.yaml
|
|
7
|
+
-> Scheduler -> systemd / launchd / Task Scheduler
|
|
8
|
+
-> Runner -> RunRepository -> jobs/runs.db
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
- jobs.yaml 是唯一执行定义,local.yaml 保存稳定环境 id;runs.db 是可清理且丢失后不可恢复的历史,和可删除重建的 campfire.db 分离。无旧格式兼容或迁移链,替换日志库拒绝活动 Run 和连接。
|
|
12
|
+
- manual 不部署、不要求调度器;interval/daily/weekly 使用本地时区与原生会话规则。新建暂停,更新保留状态;无常驻服务、补跑、自动重试或唤醒。
|
|
13
|
+
- 写入默认 planned,确认带本次 expected_plan;锁内复核定义和实际原生状态。手动 run 也复核执行摘要。scheduled 入口读取当前定义和启用状态,不复用旧计划;内部标记不构成权限边界。
|
|
14
|
+
- 同 Job 和显式绑定同 Workspace 的 Run 使用独立 OS 锁,不覆盖治理写锁;父进程不持有整轮治理写锁或 SQLite 写事务。运行中拒绝修改、删除、compact 和安装环境替换,不强杀来维护。
|
|
15
|
+
- workspace_id 显式选择稳定注册,workspace_root 由 CLI 用例解析并保存本机绑定快照;运行前绑定不符则停止,更新重新预览。普通 Job 不猜默认 Workspace。
|
|
16
|
+
- 部署只管理带产品/home/id 所有权的条目,runner 携带准确 home 和安装环境;Windows 使用 pythonw 及无控制台子进程。不得提升权限或保存系统密码。
|
|
17
|
+
- 子进程 stdin 关闭、输出单独流式记录,上限来自默认配置并明确 truncated。超时终止进程树,进程退出与业务产物分开验收。
|
|
18
|
+
- 升级由 System 在 Job 空闲门禁内启动,已有异步升级状态阻止新 Run,避免检查与启动之间竞争;不会开启或恢复 Job。
|
|
19
|
+
- Job 变更后的文档维护由可选 Skill 承担:查询成功后更新 Vault `_定时任务/` 下当前环境的一篇 record。文件名使用可读主机名,正文环境 id 核对身份;主机改名由 Skill 定位同 id 原文档后走受管 apply --name,同名异环境停止核实。只记录显式绑定该 Workspace 的任务,不写完整命令、路径、凭据或原始日志;文档不反向部署。
|
|
20
|
+
- 环境目录属于系统受管 scope,不声明 Domain;首次写入才创建,无额外总览、MOC 或新文档类型。查询、Runner 和升级不自动写此文档,失败分别报告。
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import os
|
|
2
|
+
import plistlib
|
|
3
|
+
import subprocess
|
|
4
|
+
import sys
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
from typing import Any
|
|
7
|
+
|
|
8
|
+
from campfire_cli.app.job.interface.scheduler import marker, namespace, runner_argv
|
|
9
|
+
from campfire_cli.app.job.schema.job_schema import DAYS, Job
|
|
10
|
+
from campfire_cli.common.exceptions import JobError
|
|
11
|
+
from campfire_cli.common.process import command
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
class LaunchdScheduler:
|
|
15
|
+
domain: str
|
|
16
|
+
|
|
17
|
+
def __init__(self, home: Path) -> None:
|
|
18
|
+
self.home = home
|
|
19
|
+
self.prefix = namespace(home)
|
|
20
|
+
self.directory = Path.home() / "Library/LaunchAgents"
|
|
21
|
+
if sys.platform == "win32":
|
|
22
|
+
raise JobError("unsupported-platform", "launchd requires macOS")
|
|
23
|
+
self.domain = f"gui/{os.getuid()}"
|
|
24
|
+
|
|
25
|
+
def label(self, job_id: str) -> str:
|
|
26
|
+
return f"io.campfire.{self.prefix}.{job_id}"
|
|
27
|
+
|
|
28
|
+
def path(self, job_id: str) -> Path:
|
|
29
|
+
return self.directory / (self.label(job_id) + ".plist")
|
|
30
|
+
|
|
31
|
+
def owned(self, job_id: str) -> dict[str, Any] | None:
|
|
32
|
+
path = self.path(job_id)
|
|
33
|
+
if not path.exists():
|
|
34
|
+
return None
|
|
35
|
+
with path.open("rb") as handle:
|
|
36
|
+
data: dict[str, Any] = plistlib.load(handle)
|
|
37
|
+
if data.get("CampfireOwner") != marker(self.home, job_id):
|
|
38
|
+
raise JobError("foreign-job", f"Refusing to modify unowned plist {path}")
|
|
39
|
+
return data
|
|
40
|
+
|
|
41
|
+
def loaded(self, job_id: str) -> bool:
|
|
42
|
+
result = subprocess.run(
|
|
43
|
+
["launchctl", "print", f"{self.domain}/{self.label(job_id)}"],
|
|
44
|
+
capture_output=True,
|
|
45
|
+
text=True,
|
|
46
|
+
timeout=30,
|
|
47
|
+
)
|
|
48
|
+
if result.returncode == 0:
|
|
49
|
+
return True
|
|
50
|
+
if result.returncode == 113:
|
|
51
|
+
return False
|
|
52
|
+
raise JobError("scheduler-failed", result.stderr.strip())
|
|
53
|
+
|
|
54
|
+
def state(self, job_id: str) -> dict[str, Any]:
|
|
55
|
+
owned = self.owned(job_id)
|
|
56
|
+
loaded = self.loaded(job_id)
|
|
57
|
+
if loaded and owned is None:
|
|
58
|
+
raise JobError("foreign-job", "Loaded launchd job has no owned plist")
|
|
59
|
+
# Bootstrapped jobs in the GUI domain are authoritative, not a YAML enabled flag.
|
|
60
|
+
return {
|
|
61
|
+
"deployed": self.path(job_id).exists() or loaded,
|
|
62
|
+
"enabled": loaded,
|
|
63
|
+
"active": loaded,
|
|
64
|
+
"runner_current": owned.get("ProgramArguments") == runner_argv(self.home, job_id)
|
|
65
|
+
if owned
|
|
66
|
+
else None,
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
def deploy(self, task: Job, enabled: bool) -> None:
|
|
70
|
+
self.state(task.id)
|
|
71
|
+
if self.loaded(task.id):
|
|
72
|
+
command(["launchctl", "bootout", f"{self.domain}/{self.label(task.id)}"])
|
|
73
|
+
data: dict[str, Any] = {
|
|
74
|
+
"Label": self.label(task.id),
|
|
75
|
+
"CampfireOwner": marker(self.home, task.id),
|
|
76
|
+
"ProgramArguments": runner_argv(self.home, task.id),
|
|
77
|
+
"ProcessType": "Background",
|
|
78
|
+
"RunAtLoad": False,
|
|
79
|
+
"Disabled": not enabled,
|
|
80
|
+
}
|
|
81
|
+
schedule = task.schedule
|
|
82
|
+
if schedule["kind"] == "interval":
|
|
83
|
+
data["StartInterval"] = schedule["seconds"]
|
|
84
|
+
else:
|
|
85
|
+
hour, minute = map(int, schedule["time"].split(":"))
|
|
86
|
+
calendar = {"Hour": hour, "Minute": minute}
|
|
87
|
+
if schedule["kind"] == "weekly":
|
|
88
|
+
calendar["Weekday"] = (DAYS.index(schedule["day"]) + 1) % 7
|
|
89
|
+
data["StartCalendarInterval"] = calendar
|
|
90
|
+
self.directory.mkdir(parents=True, exist_ok=True)
|
|
91
|
+
with self.path(task.id).open("wb") as handle:
|
|
92
|
+
plistlib.dump(data, handle)
|
|
93
|
+
target = f"{self.domain}/{self.label(task.id)}"
|
|
94
|
+
command(["launchctl", "enable" if enabled else "disable", target])
|
|
95
|
+
if enabled:
|
|
96
|
+
command(["launchctl", "bootstrap", self.domain, str(self.path(task.id))])
|
|
97
|
+
|
|
98
|
+
def remove(self, job_id: str) -> None:
|
|
99
|
+
self.state(job_id)
|
|
100
|
+
if self.loaded(job_id):
|
|
101
|
+
command(["launchctl", "bootout", f"{self.domain}/{self.label(job_id)}"])
|
|
102
|
+
command(["launchctl", "enable", f"{self.domain}/{self.label(job_id)}"])
|
|
103
|
+
self.path(job_id).unlink(missing_ok=True)
|
|
104
|
+
|
|
105
|
+
def doctor(self) -> dict[str, Any]:
|
|
106
|
+
command(["launchctl", "print", self.domain])
|
|
107
|
+
return {
|
|
108
|
+
"platform": "macos",
|
|
109
|
+
"scheduler": "launchd-user",
|
|
110
|
+
"available": True,
|
|
111
|
+
"session_requirement": "Logged-in GUI user session required.",
|
|
112
|
+
"native_logs": "launchctl print gui/<uid>/<label>; inspect launchd logs",
|
|
113
|
+
"sleep_behavior": "launchd may coalesce missed events on wake; no catch-up.",
|
|
114
|
+
}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import os
|
|
2
|
+
import subprocess
|
|
3
|
+
import sys
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
from typing import Any
|
|
6
|
+
|
|
7
|
+
from campfire_cli.app.job.interface.scheduler import marker, namespace, runner_argv
|
|
8
|
+
from campfire_cli.app.job.schema.job_schema import Job
|
|
9
|
+
from campfire_cli.common.exceptions import JobError
|
|
10
|
+
from campfire_cli.common.process import command
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
def quote(value: str) -> str:
|
|
14
|
+
return (
|
|
15
|
+
'"'
|
|
16
|
+
+ value.replace("\\", "\\\\")
|
|
17
|
+
.replace('"', '\\"')
|
|
18
|
+
.replace("%", "%%")
|
|
19
|
+
.replace("$", "$$")
|
|
20
|
+
.replace("\n", "\\n")
|
|
21
|
+
+ '"'
|
|
22
|
+
)
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
class SystemdScheduler:
|
|
26
|
+
def __init__(self, home: Path) -> None:
|
|
27
|
+
self.home = home
|
|
28
|
+
self.prefix = namespace(home)
|
|
29
|
+
self.directory = (
|
|
30
|
+
Path(os.getenv("XDG_CONFIG_HOME", str(Path.home() / ".config"))) / "systemd/user"
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
def name(self, job_id: str) -> str:
|
|
34
|
+
return f"{self.prefix}-{job_id}"
|
|
35
|
+
|
|
36
|
+
def paths(self, job_id: str) -> tuple[Path, Path]:
|
|
37
|
+
return (
|
|
38
|
+
self.directory / f"{self.name(job_id)}.service",
|
|
39
|
+
self.directory / f"{self.name(job_id)}.timer",
|
|
40
|
+
)
|
|
41
|
+
|
|
42
|
+
def owned(self, job_id: str) -> None:
|
|
43
|
+
expected = "# " + marker(self.home, job_id)
|
|
44
|
+
for path in self.paths(job_id):
|
|
45
|
+
if path.exists() and not path.read_text(encoding="utf-8").startswith(expected + "\n"):
|
|
46
|
+
raise JobError("foreign-job", f"Refusing to modify unowned unit {path}")
|
|
47
|
+
|
|
48
|
+
def state(self, job_id: str) -> dict[str, Any]:
|
|
49
|
+
self.owned(job_id)
|
|
50
|
+
name = self.name(job_id) + ".timer"
|
|
51
|
+
output = command(
|
|
52
|
+
[
|
|
53
|
+
"systemctl",
|
|
54
|
+
"--user",
|
|
55
|
+
"show",
|
|
56
|
+
name,
|
|
57
|
+
"--property=FragmentPath,LoadState,ActiveState,UnitFileState,NextElapseUSecRealtime,NextElapseUSecMonotonic",
|
|
58
|
+
]
|
|
59
|
+
)
|
|
60
|
+
properties = dict(line.split("=", 1) for line in output.splitlines() if "=" in line)
|
|
61
|
+
fragment = properties.get("FragmentPath")
|
|
62
|
+
if fragment and not Path(fragment).read_text(encoding="utf-8").startswith(
|
|
63
|
+
"# " + marker(self.home, job_id) + "\n"
|
|
64
|
+
):
|
|
65
|
+
raise JobError("foreign-job", "Loaded timer does not have matching Campfire ownership")
|
|
66
|
+
exists = properties.get("LoadState") != "not-found"
|
|
67
|
+
active = properties.get("ActiveState") == "active"
|
|
68
|
+
enabled = properties.get("UnitFileState") == "enabled"
|
|
69
|
+
service, _ = self.paths(job_id)
|
|
70
|
+
expected = "ExecStart=" + " ".join(quote(arg) for arg in runner_argv(self.home, job_id))
|
|
71
|
+
return {
|
|
72
|
+
"deployed": exists,
|
|
73
|
+
"enabled": active or enabled,
|
|
74
|
+
"active": active,
|
|
75
|
+
"persistent": enabled,
|
|
76
|
+
"runner_current": (
|
|
77
|
+
service.is_file() and expected in service.read_text(encoding="utf-8").splitlines()
|
|
78
|
+
)
|
|
79
|
+
if exists
|
|
80
|
+
else None,
|
|
81
|
+
"details": properties,
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
def deploy(self, task: Job, enabled: bool) -> None:
|
|
85
|
+
self.owned(task.id)
|
|
86
|
+
service, timer = self.paths(task.id)
|
|
87
|
+
self.directory.mkdir(parents=True, exist_ok=True)
|
|
88
|
+
header = "# " + marker(self.home, task.id) + "\n"
|
|
89
|
+
service.write_text(
|
|
90
|
+
header
|
|
91
|
+
+ "[Unit]\nDescription=Campfire managed command\n[Service]\nType=oneshot\nExecStart="
|
|
92
|
+
+ " ".join(quote(arg) for arg in runner_argv(self.home, task.id))
|
|
93
|
+
+ f"\nTimeoutStartSec={task.timeout + 60}\nKillMode=control-group\n",
|
|
94
|
+
encoding="utf-8",
|
|
95
|
+
)
|
|
96
|
+
schedule = task.schedule
|
|
97
|
+
if schedule["kind"] == "interval":
|
|
98
|
+
rule = f"OnActiveSec={schedule['seconds']}s\nOnUnitActiveSec={schedule['seconds']}s"
|
|
99
|
+
else:
|
|
100
|
+
day = "" if schedule["kind"] == "daily" else str(schedule["day"]).title() + " "
|
|
101
|
+
rule = f"OnCalendar={day}*-*-* {schedule['time']}:00"
|
|
102
|
+
timer.write_text(
|
|
103
|
+
header
|
|
104
|
+
+ f"[Unit]\nDescription=Campfire managed timer\n[Timer]\n{rule}\n"
|
|
105
|
+
+ f"AccuracySec=1s\nPersistent=false\nUnit={service.name}\n"
|
|
106
|
+
+ "[Install]\nWantedBy=timers.target\n",
|
|
107
|
+
encoding="utf-8",
|
|
108
|
+
)
|
|
109
|
+
command(["systemctl", "--user", "daemon-reload"])
|
|
110
|
+
command(["systemctl", "--user", "enable" if enabled else "disable", timer.name])
|
|
111
|
+
command(["systemctl", "--user", "restart" if enabled else "stop", timer.name])
|
|
112
|
+
|
|
113
|
+
def remove(self, job_id: str) -> None:
|
|
114
|
+
self.owned(job_id)
|
|
115
|
+
_, timer = self.paths(job_id)
|
|
116
|
+
state = self.state(job_id)
|
|
117
|
+
if state["deployed"]:
|
|
118
|
+
command(["systemctl", "--user", "disable", "--now", timer.name])
|
|
119
|
+
for path in self.paths(job_id):
|
|
120
|
+
path.unlink(missing_ok=True)
|
|
121
|
+
command(["systemctl", "--user", "daemon-reload"])
|
|
122
|
+
# The service is not stopped: deleting a definition never kills an active run.
|
|
123
|
+
|
|
124
|
+
def doctor(self) -> dict[str, Any]:
|
|
125
|
+
if sys.platform == "win32":
|
|
126
|
+
raise JobError("unsupported-platform", "systemd requires Linux")
|
|
127
|
+
command(["systemctl", "--user", "show-environment"])
|
|
128
|
+
result = subprocess.run(
|
|
129
|
+
["loginctl", "show-user", str(os.getuid()), "--property=Linger", "--value"],
|
|
130
|
+
capture_output=True,
|
|
131
|
+
text=True,
|
|
132
|
+
)
|
|
133
|
+
return {
|
|
134
|
+
"platform": "linux",
|
|
135
|
+
"scheduler": "systemd-user",
|
|
136
|
+
"available": True,
|
|
137
|
+
"linger": result.stdout.strip() or "unknown",
|
|
138
|
+
"session_requirement": "User manager must be running; lingering is not enabled here.",
|
|
139
|
+
"native_logs": "journalctl --user -u <unit>.service",
|
|
140
|
+
}
|