Skip to content

release: prepare 2.0 (version, NEWS, plugin, version source, skill completeness) - #103

Merged
yannrichet merged 2 commits into
mainfrom
claude/version-1-3-opportunity-68uuh8
Nov 6, 2026
Merged

yannrichet merged 2 commits into
mainfrom
claude/version-1-3-opportunity-68uuh8

Conversation

@yannrichet

@yannrichet yannrichet commented Nov 6, 2026 •

Copy link
Copy Markdown
Member

Pull Request

Description

Prepares the 2.0 release, following the same procedure as the 1.2 preparation (2a4c58a). The release is numbered 2.0 rather than 1.3 because it contains backward-incompatible behavior changes (listed in NEWS.md, "Upgrading from 1.2"). This PR also fixes a traceability defect found along the way (manifest.json recorded fz_version: "1.0") and completes the agent skill.

The tag and the GitHub release are not created by this PR. The branch name still says 1-3 for historical reasons.

Related Issues

Relates to #101 (warning on default delimiters, handled in a dedicated PR)
Relates to #102 (release.yml build matrix, not addressed here, apart from the stamping step)

Type of Change

  • Bug fix (manifest.json / fz.config reported version 1.0)
  • Documentation update (NEWS, skill, scripts/README.md, CLAUDE.md)
  • Test addition/modification

Changes Made

  • Version: fz/__init__.py 1.2 → 2.0 (pyproject.toml reads it dynamically); README badge; plugin manifests .claude-plugin/plugin.json and marketplace.json 1.2.0 → 2.0.0.
  • NEWS.md: "Unreleased" becomes "Version 2.0 (2026-11-06)", headed by an explicit notice of the backward-incompatible behavior changes (the reason for the major version) and of the fixes (wrong sh:// results, injection). A new empty "Unreleased" section is opened. The date is to be adjusted to the actual tag date.
  • Single version source:
    • fz/manifest.py (fz_version, and the RO-Crate fz entity) and fz/config.py (get_summary()['version']) read fz/_version.py. No workflow ever stamped that file, so it held "1.0". Both now read fz.__version__.
    • tests/test_manifest.py checks fz_version == fz.__version__.
  • Stamping: release.yml runs scripts/stamp_version.py before building the wheels and the sdist. fz/_version.py is re-stamped. scripts/README.md described CI integrations that did not exist (ci.yml, stamp-version.yml); it is corrected, and so is CLAUDE.md.
  • Skill (skills/fz/), completeness review:
    • SKILL.md: install hint funz-fz>=2.0, with the release highlights and the cache invalidation.
    • reference.md, incorrect claim fixed: "a model without delim reads only $(x); ${name} is then NOT a variable" contradicted DEFAULT_VAR_DELIM = "(){}".
    • reference.md, additions: helpers exported in fz.__all__ that were undocumented (set_log_level, get_log_level, get_config, print_config, get_interpreter, install_model/uninstall_model/list_installed_models, install_algorithm/uninstall_algorithm, list_models, discover_funz_servers); the fz input / fz compile / fz output / fz list subcommands; model key aliases (var_prefix, formula_prefix, comment_line, ...).
    • tests/test_skill_static.py: two completeness tests. Every fz.__all__ name and every top-level fz subcommand must appear in the skill. Both tests fail on the previous skill (12 missing names, plus fz input) and pass after this PR.

Testing Performed

Automated Tests

  • Added tests for new functionality
  • Updated tests for modified functionality
  • All existing tests pass: see below

Local run of the first commit (Linux, Python 3.13, ci.yml --ignore list):

5 failed, 1059 passed, 86 skipped in 483.65s

The 5 failures are pre-existing and environmental: they fail identically on main (17f65e2) in the same container.

  • test_fzi_with_permission_denied, test_install_model_with_permission_error, test_fzc_with_readonly_output_directory: tests run as root (uid 0), so file permissions are not enforced.
  • test_evaluate_yq_scalar, test_evaluate_yq_prefix_detection_and_stripping: the installed yq is not the expected implementation (yq --version → 0.0.0).

After the rename to 2.0: test_skill_static, test_manifest, test_readme_structure, test_project_metadata and test_python_version_support pass (24 tests). fz --version → fz 2.0; fz.get_config().get_summary()['version'] → 2.0. CI on the first commit was fully green.

Manual Testing

  • Tested on Linux
  • Tested on macOS / Windows (left to CI)

Breaking Changes

This PR itself breaks nothing. The release it prepares does (listed in NEWS.md, "Upgrading from 1.2"), hence 2.0.

Additional Notes

Remaining before the tag:

  1. Adjust the date in NEWS.md if the tag is not created on 2026-11-06.
  2. fz/_version.py is stamped with the parent commit; release.yml re-stamps it at build time.
  3. Possible follow-up: the skill and the docs often say "fz ≥ 1.1" for older features; these statements stay true under 2.0.

Generated by Claude Code

🤖 Generated with Claude Code

https://claude.ai/code/session_01RjXvVRjM6aMvKvvSFoxpZ6

- Bump version to 1.3 (fz/__init__.py), README badge, Claude Code plugin
  manifests 1.2.0 -> 1.3.0 (plugin.json, marketplace.json).
- NEWS.md: "Unreleased" becomes "Version 1.3 (2026-11-06)", headed by a
  notice that the release contains backward-incompatible behavior changes
  and security/correctness fixes; a fresh empty "Unreleased" is opened.
- Single version source: manifest.json (fz_version, RO-Crate fz entity) and
  fz.config's summary read the never-stamped fz/_version.py and reported
  "1.0"; they now read fz.__version__. tests/test_manifest.py checks it.
- release.yml runs scripts/stamp_version.py before building the wheels and
  the sdist (no workflow ran it); fz/_version.py re-stamped; scripts/README.md
  and CLAUDE.md describe the actual behavior.
- Skill (skills/fz/): install hint >= 1.3 with the 1.3 highlights; fix the
  stale claim that a model without "delim" reads only $(x); document the
  configuration/installer/discovery helpers exported in fz.__all__, the
  fz input/compile/output/list subcommands and model key aliases.
- tests/test_skill_static.py: completeness checks (every fz.__all__ name and
  every top-level fz subcommand is mentioned in the skill).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RjXvVRjM6aMvKvvSFoxpZ6
The release contains backward-incompatible behavior changes (Python 3.8
dropped, cache key, default delimiters, timeouts, sh:// path resolution,
fz list JSON), so it takes a major version number.

- fz/__init__.py 2.0, README badge, plugin manifests 2.0.0.
- NEWS.md: "Version 2.0", header states the major bump.
- Skill: install hint funz-fz>=2.0, "fz >= 2.0" for default delimiters.
- fz/_version.py re-stamped; scripts/README.md example.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RjXvVRjM6aMvKvvSFoxpZ6
@yannrichet yannrichet changed the title release: prepare 1.3 (version, NEWS, plugin, version source, skill completeness) release: prepare 2.0 (version, NEWS, plugin, version source, skill completeness) Nov 6, 2026
@yannrichet
yannrichet merged commit ae57976 into main Nov 6, 2026
43 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants