From 3f226666cd5d88c137370f770f818937edadbab2 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 14 Jan 2026 19:42:39 +0000 Subject: [PATCH 1/4] Add version and changelog update policy Add a new policy that triggers when files in src/ are modified, requiring evaluation of whether version bumps and changelog entries are needed. The policy enforces explicit action - either updating pyproject.toml and CHANGELOG.md, or justifying why no update is needed. --- .deepwork.policy.yml | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/.deepwork.policy.yml b/.deepwork.policy.yml index b5a41768..f2721da3 100644 --- a/.deepwork.policy.yml +++ b/.deepwork.policy.yml @@ -40,4 +40,32 @@ 3. Run `deepwork install --platform claude` to sync changes 4. Verify the changes propagated correctly - See CLAUDE.md section "CRITICAL: Editing Standard Jobs" for details. \ No newline at end of file + See CLAUDE.md section "CRITICAL: Editing Standard Jobs" for details. + +- name: "Version and Changelog Update" + trigger: "src/**/*" + safety: + - "pyproject.toml" + - "CHANGELOG.md" + instructions: | + Source code in src/ has been modified. **You MUST evaluate whether version and changelog updates are needed.** + + **Evaluate the changes:** + 1. Is this a bug fix, new feature, breaking change, or internal refactor? + 2. Does this change affect the public API or user-facing behavior? + 3. Would users need to know about this change when upgrading? + + **If version update is needed:** + 1. Update the `version` field in `pyproject.toml` following semantic versioning: + - PATCH (0.1.x): Bug fixes, minor internal changes + - MINOR (0.x.0): New features, non-breaking changes + - MAJOR (x.0.0): Breaking changes + 2. Add an entry to `CHANGELOG.md` under an appropriate version header: + - Use categories: Added, Changed, Fixed, Removed, Deprecated, Security + - Include a clear, user-facing description of what changed + - Follow the Keep a Changelog format + + **If NO version update is needed** (e.g., tests only, comments, internal refactoring with no behavior change): + - Explicitly state why no version bump is required + + **This policy requires explicit action** - either update both files or justify why no update is needed. \ No newline at end of file From df1f4711e7d72db4268779d714fdd8cea319307e Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Jan 2026 18:33:04 +0000 Subject: [PATCH 2/4] Bump version to 0.1.1 Update version for new features including learn step, policy enhancements, CLA reorganization, and improved hook handling. --- CHANGELOG.md | 20 ++++++++++++++++++++ pyproject.toml | 2 +- 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6d2dc474..b2aa2b19 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,8 +5,28 @@ All notable changes to DeepWork will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [0.1.1] - 2026-01-15 + +### Added +- New `learn` step in deepwork_jobs for analyzing existing workflows +- Version and changelog update policy to enforce version tracking on src changes +- Supplemental file references support in job definitions +- Policy schema enhancements with new validation options + +### Changed +- Reorganized CLA files into versioned directory structure +- Improved policy evaluation hooks with better change detection +- Renamed `capture_work_tree.sh` to `capture_prompt_work_tree.sh` for clarity +- Updated deepwork_jobs step instructions for better guidance + +### Removed +- Deprecated `refine` step (replaced by `learn`) +- Removed `get_changed_files.sh` hook (functionality moved to policy evaluator) +- Removed CLA_SETUP.md (setup instructions moved to main docs) + ## [0.1.0] - Initial Release Initial version. +[0.1.1]: https://github.com/anthropics/deepwork/releases/tag/v0.1.1 [0.1.0]: https://github.com/anthropics/deepwork/releases/tag/v0.1.0 diff --git a/pyproject.toml b/pyproject.toml index a3f8cc1d..8cfb3019 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "deepwork" -version = "0.1.0" +version = "0.1.1" description = "Framework for enabling AI agents to perform complex, multi-step work tasks" readme = "README.md" requires-python = ">=3.11" From fcf77ebd4d6be03e4a4f9b70584de332fda1e3b2 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Jan 2026 18:35:36 +0000 Subject: [PATCH 3/4] Update changelog with comprehensive 0.1.1 changes Include all changes from commits since 0.1.0 tag with PR references: - compare_to policy option for flexible change detection - learn command replacing refine - supplementary markdown file support - browser automation capability consideration - platform-specific reload instructions - CLA reorganization and fixes - README PyPI install instructions --- CHANGELOG.md | 41 +++++++++++++++++++++++++++++++---------- 1 file changed, 31 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b2aa2b19..64ab9c28 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,21 +8,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [0.1.1] - 2026-01-15 ### Added -- New `learn` step in deepwork_jobs for analyzing existing workflows +- `compare_to` option in policy system for flexible change detection (#34) + - `base` (default): Compare to merge-base with default branch + - `default_tip`: Two-dot diff against default branch tip + - `prompt`: Compare to state captured at prompt submission +- New `learn` command replacing `refine` for conversation-driven job improvement (#27) + - Analyzes conversations where DeepWork jobs were run + - Classifies learnings as generalizable (→ instructions) or bespoke (→ AGENTS.md) + - Creates learning_summary.md documenting all changes +- "Think deeply" prompt in learn step for enhanced reasoning (#33) +- Supplementary markdown file support for job steps (#19) + - Steps can now reference additional .md files in the steps/ directory +- Browser automation capability consideration in job definition (#32) + - Prompts users to confirm browser automation tools + - Recommends Claude in Chrome for Claude Code users +- Platform-specific reload instructions in adapters (#31) + - Claude Code: "Type 'exit' then run 'claude --resume'" + - Gemini CLI: "Run '/memory refresh'" - Version and changelog update policy to enforce version tracking on src changes -- Supplemental file references support in job definitions -- Policy schema enhancements with new validation options +- Added claude and copilot to CLA allowlist (#26) ### Changed -- Reorganized CLA files into versioned directory structure -- Improved policy evaluation hooks with better change detection -- Renamed `capture_work_tree.sh` to `capture_prompt_work_tree.sh` for clarity -- Updated deepwork_jobs step instructions for better guidance +- Reorganized CLA files into `CLA/version_1/` directory structure (#24) +- CLA signatures now stored on `IMPT_cla_signatures` branch (#24) +- Simplified CLA signing instructions to only mention comment mechanism (#25) +- Moved git diff logic into evaluate_policies.py for per-policy handling (#34) +- Renamed `capture_work_tree.sh` to `capture_prompt_work_tree.sh` (#34) +- Updated README with PyPI install instructions using pipx, uv, and pip (#22) +- Updated deepwork_jobs job version to 0.2.0 + +### Fixed +- CLA Assistant "Not Found" error by removing unnecessary remote parameters (#29) ### Removed -- Deprecated `refine` step (replaced by `learn`) -- Removed `get_changed_files.sh` hook (functionality moved to policy evaluator) -- Removed CLA_SETUP.md (setup instructions moved to main docs) +- `refine` step (replaced by `learn` command) (#27) +- `get_changed_files.sh` hook (logic moved to Python policy evaluator) (#34) +- `CLA_SETUP.md` (setup instructions consolidated) (#24) ## [0.1.0] - Initial Release From 30aee0aba11cddd7630bce6e7521400c6705fbce Mon Sep 17 00:00:00 2001 From: Noah Horton Date: Thu, 15 Jan 2026 11:38:11 -0700 Subject: [PATCH 4/4] Revise CHANGELOG with recent updates and fixes Updated changelog with changes to CLA files, job steps, and versioning policy. --- CHANGELOG.md | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 64ab9c28..b68f0d43 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,32 +18,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Creates learning_summary.md documenting all changes - "Think deeply" prompt in learn step for enhanced reasoning (#33) - Supplementary markdown file support for job steps (#19) - - Steps can now reference additional .md files in the steps/ directory - Browser automation capability consideration in job definition (#32) - - Prompts users to confirm browser automation tools - - Recommends Claude in Chrome for Claude Code users - Platform-specific reload instructions in adapters (#31) - - Claude Code: "Type 'exit' then run 'claude --resume'" - - Gemini CLI: "Run '/memory refresh'" - Version and changelog update policy to enforce version tracking on src changes - Added claude and copilot to CLA allowlist (#26) ### Changed -- Reorganized CLA files into `CLA/version_1/` directory structure (#24) -- CLA signatures now stored on `IMPT_cla_signatures` branch (#24) -- Simplified CLA signing instructions to only mention comment mechanism (#25) - Moved git diff logic into evaluate_policies.py for per-policy handling (#34) - Renamed `capture_work_tree.sh` to `capture_prompt_work_tree.sh` (#34) - Updated README with PyPI install instructions using pipx, uv, and pip (#22) - Updated deepwork_jobs job version to 0.2.0 -### Fixed -- CLA Assistant "Not Found" error by removing unnecessary remote parameters (#29) - ### Removed - `refine` step (replaced by `learn` command) (#27) - `get_changed_files.sh` hook (logic moved to Python policy evaluator) (#34) -- `CLA_SETUP.md` (setup instructions consolidated) (#24) ## [0.1.0] - Initial Release