free-claude-code 6.2.66__tar.gz → 6.2.67__tar.gz

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/.github/ISSUE_TEMPLATE/bug-report.yml

@@ -7,7 +7,7 @@ body:
     id: fcc-version
     attributes:
       label: FCC version
-      description: Run `fcc-server --version` and include one version in `number.number.number` format. If FCC did not install, enter `None`.
+      description: Run `fcc-server --version` and include one version exactly as printed, including any development suffix. If FCC did not install, enter `None`.
       placeholder: "The version is 1.22.333, or None"
     validations:
       required: true

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/.github/actions/ci-environment/action.yml

@@ -44,6 +44,13 @@ outputs:
 runs:
   using: composite
   steps:
+    - name: Fetch canonical release tags
+      shell: bash
+      env:
+        CI_SERVER: ${{ github.server_url }}
+        CI_REPOSITORY: ${{ github.repository }}
+      run: git fetch --prune --no-tags "$CI_SERVER/$CI_REPOSITORY.git" '+refs/tags/*:refs/tags/*'
+
     - name: Prepare cache identity
       id: identity
       shell: bash

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/.github/workflows/post-merge.yml

@@ -7,6 +7,11 @@ env:
 
 on:
   workflow_dispatch:
+    inputs:
+      release_commit:
+        description: Full main commit SHA to retry (defaults to this workflow commit)
+        required: false
+        type: string
   push:
     branches: [main]
 
@@ -37,7 +42,7 @@ jobs:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
         with:
           ref: ${{ github.sha }}
-          fetch-depth: 1
+          fetch-depth: 0
 
       - name: Set up CI environment
         id: environment
@@ -81,21 +86,13 @@ jobs:
     timeout-minutes: 15
     environment: pypi
     permissions:
-      contents: read
+      contents: write
       id-token: write
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
         with:
           ref: ${{ github.sha }}
-          fetch-depth: 2
-
-      - name: Fetch previous revision
-        env:
-          BEFORE_SHA: ${{ github.event.before }}
-        run: |
-          if [ -n "$BEFORE_SHA" ]; then
-            git fetch --no-tags --depth=1 origin "$BEFORE_SHA"
-          fi
+          fetch-depth: 0
 
       - name: Set up CI environment
         uses: ./.github/actions/ci-environment
@@ -105,38 +102,11 @@ jobs:
           lookup-only: "true"
           sync-dependencies: "false"
 
-      - name: Detect release
-        id: release
+      - name: Publish release
         env:
-          BEFORE_SHA: ${{ github.event.before }}
-          HEAD_SHA: ${{ github.sha }}
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_REPOSITORY: ${{ github.repository }}
+          RELEASE_COMMIT: ${{ inputs.release_commit || github.sha }}
         run: |
-          uv run --no-project --python "$(cat .python-version)" python - <<'PY'
-          import os
-          import subprocess
-          import tomllib
-          from pathlib import Path
-
-          head = os.environ["HEAD_SHA"]
-          before = os.environ.get("BEFORE_SHA") or f"{head}^"
-          def version(revision):
-              result = subprocess.run(
-                  ["git", "show", f"{revision}:pyproject.toml"],
-                  check=True, capture_output=True, text=True,
-              )
-              return tomllib.loads(result.stdout)["project"]["version"]
-          current, previous = version(head), version(before)
-          with Path(os.environ["GITHUB_OUTPUT"]).open("a", encoding="utf-8") as output:
-              output.write(f"changed={str(current != previous).lower()}\n")
-          print(f"Release version: {previous} -> {current}")
-          PY
-
-      - name: Build and validate release
-        if: steps.release.outputs.changed == 'true'
-        run: |
-          uv build --no-sources --out-dir "$RUNNER_TEMP/fcc-release"
-          uv run --no-project --python "$(cat .python-version)" python scripts/validate_release.py "$RUNNER_TEMP/fcc-release"
-
-      - name: Publish release
-        if: steps.release.outputs.changed == 'true'
-        run: uv publish --trusted-publishing always "$RUNNER_TEMP/fcc-release/"*
+          uv run --no-project --python "$(cat .python-version)" python -m scripts.publish_release \
+            --repository "$RELEASE_REPOSITORY" --commit "$RELEASE_COMMIT"

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/.github/workflows/tests.yml

@@ -21,37 +21,6 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  version-policy:
-    name: Version policy
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
-        with:
-          ref: ${{ github.event.pull_request.head.sha }}
-          repository: ${{ github.event.pull_request.head.repo.full_name }}
-          fetch-depth: 0
-
-      - name: Fetch target revision
-        env:
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-          BASE_REPOSITORY: ${{ github.event.pull_request.base.repo.full_name }}
-        run: git fetch --no-tags "https://github.com/$BASE_REPOSITORY.git" "$BASE_SHA"
-
-      - name: Set up CI environment
-        uses: ./.github/actions/ci-environment
-        with:
-          uv-version: ${{ env.CI_UV_VERSION }}
-          runner-label: ubuntu-latest
-
-      - name: Check version policy
-        env:
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
-        run: uv run --locked --group dev python scripts/check_version_policy.py --base "$BASE_SHA" --head "$HEAD_SHA"
-
   no-suppressions-or-legacy-annotations:
     name: Ban suppressions and legacy annotations
     runs-on: ubuntu-latest
@@ -63,7 +32,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
           repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
-          fetch-depth: 1
+          fetch-depth: 0
 
       - name: "Fail on type ignores and legacy future annotations"
         run: |
@@ -94,7 +63,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
           repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
-          fetch-depth: 1
+          fetch-depth: 0
 
       - name: Set up CI environment
         uses: ./.github/actions/ci-environment
@@ -126,7 +95,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
           repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
-          fetch-depth: 1
+          fetch-depth: 0
 
       - name: Set up CI environment
         uses: ./.github/actions/ci-environment
@@ -159,7 +128,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
           repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
-          fetch-depth: 1
+          fetch-depth: 0
 
       - name: Set up CI environment
         uses: ./.github/actions/ci-environment

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/.github/workflows/validate-bug-report-version.yml

@@ -29,8 +29,8 @@ jobs:
               issue_number,
             });
             const fieldPattern = "^### FCC version\\r?\\n+\\s*([^\\r\\n]+)";
-            const versionPattern = "(?:^|[^0-9A-Za-z_.])v?([0-9]+\\.[0-9]+\\.[0-9]+)(?![0-9A-Za-z_+-]|\\.[0-9A-Za-z_])";
-            const projectVersionPattern = "^\\s*version\\s*=\\s*([\"'])([0-9]+\\.[0-9]+\\.[0-9]+)\\1\\s*(?:#.*)?$";
+            const releaseVersionPattern = "^v((?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*))$";
+            const versionPattern = "(?:^|[^0-9A-Za-z_.])v?([0-9]+\\.[0-9]+\\.[0-9]+(?:\\.dev[0-9]+(?:\\+g[0-9a-f]+(?:\\.d[0-9]{8})?)?|\\+d[0-9]{8})?)(?![0-9A-Za-z_+-]|\\.[0-9A-Za-z_])";
             const match = (issue.body || "").match(new RegExp(fieldPattern, "m"));
             const fieldValue = match?.[1]?.trim() || "";
             const versionMatches = [...fieldValue.matchAll(new RegExp(versionPattern, "g"))];
@@ -70,22 +70,6 @@ jobs:
               return false;
             };
 
-            const projectVersionFromToml = (pyproject) => {
-              let inProjectSection = false;
-              for (const line of pyproject.split(/\r?\n/)) {
-                const stripped = line.trim();
-                if (stripped === "[project]") {
-                  inProjectSection = true;
-                  continue;
-                }
-                if (inProjectSection && stripped.startsWith("[")) return undefined;
-                if (!inProjectSection) continue;
-                const projectVersion = line.match(new RegExp(projectVersionPattern));
-                if (projectVersion !== null) return projectVersion[2];
-              }
-              return undefined;
-            };
-
             if (!valid) {
               await deleteManagedComment(outdatedComment);
               if (!labels.has(labelName)) {
@@ -98,7 +82,7 @@ jobs:
                       ...repo,
                       name: labelName,
                       color: "d4c5f9",
-                      description: "FCC version must contain number.number.number or be None",
+                      description: "FCC version must contain one installed version or be None",
                     });
                   } catch (createError) {
                     if (createError.status !== 422) throw createError;
@@ -114,7 +98,7 @@ jobs:
                 await github.rest.issues.createComment({
                   ...repo,
                   issue_number,
-                  body: `${invalidMarker}\nPlease edit **FCC version** so it contains one \`number.number.number\` value, such as \`1.22.333\`, or is exactly \`None\`. Run \`fcc-server --version\` to find the installed version.`,
+                  body: `${invalidMarker}\nPlease edit **FCC version** so it contains one version copied from \`fcc-server --version\`, including any development suffix, or is exactly \`None\`.`,
                 });
               }
               return;
@@ -129,29 +113,23 @@ jobs:
             }
             await deleteManagedComment(invalidComment);
 
-            if (reportedVersion === undefined) {
+            // Checkout versions identify development source, not published releases.
+            if (reportedVersion === undefined || reportedVersion.includes(".dev") || reportedVersion.includes("+")) {
               await deleteManagedComment(outdatedComment);
               return;
             }
 
-            const defaultBranch = context.payload.repository.default_branch;
-            const { data: versionFile } = await github.rest.repos.getContent({
-              ...repo,
-              path: "pyproject.toml",
-              ref: defaultBranch,
-            });
-            if (
-              Array.isArray(versionFile)
-              || versionFile.type !== "file"
-              || versionFile.encoding !== "base64"
-              || !versionFile.content
-            ) {
-              throw new Error(`Could not read pyproject.toml from ${defaultBranch}`);
+            let release;
+            try {
+              ({ data: release } = await github.rest.repos.getLatestRelease(repo));
+            } catch (error) {
+              if (error.status !== 404) throw error;
+              await deleteManagedComment(outdatedComment);
+              return;
             }
-            const pyproject = Buffer.from(versionFile.content, "base64").toString("utf8");
-            const latestVersion = projectVersionFromToml(pyproject);
-            if (latestVersion === undefined) {
-              throw new Error(`Could not read the project version from ${defaultBranch}`);
+            const latestVersion = release.tag_name.match(new RegExp(releaseVersionPattern))?.[1];
+            if (!latestVersion || release.draft || release.prerelease) {
+              throw new Error("Latest release must have a stable vMAJOR.MINOR.PATCH tag");
             }
 
             if (!isOlderVersion(reportedVersion, latestVersion)) {
@@ -159,7 +137,7 @@ jobs:
               return;
             }
 
-            const body = `${outdatedMarker}\nThis report uses FCC \`${reportedVersion}\`, while the current version on \`${defaultBranch}\` is \`${latestVersion}\`. Please [update FCC](${context.payload.repository.html_url}#install), restart FCC, and check whether the issue still occurs. The update may already contain the fix.`;
+            const body = `${outdatedMarker}\nThis report uses FCC \`${reportedVersion}\`, while the latest published version is \`${latestVersion}\`. Please [update FCC](${context.payload.repository.html_url}#update), restart FCC, and check whether the issue still occurs. The update may already contain the fix.`;
             if (outdatedComment === undefined) {
               await github.rest.issues.createComment({
                 ...repo,

free_claude_code-6.2.67/.github/workflows/version-policy.yml

@@ -0,0 +1,51 @@
+name: Release intent
+
+env:
+  CI_UV_VERSION: "0.12.13"
+  UV_MALWARE_CHECK: "1"
+  UV_PREVIEW_FEATURES: "malware-check"
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, edited, ready_for_review]
+
+concurrency:
+  group: release-intent-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  version-policy:
+    name: Version policy
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+      pull-requests: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          fetch-depth: 0
+
+      - name: Read current pull request
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR_REPOSITORY: ${{ github.repository }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          BASE_REPOSITORY_URL: ${{ github.server_url }}/${{ github.repository }}.git
+        run: |
+          gh api "repos/$PR_REPOSITORY/pulls/$PR_NUMBER" > "$RUNNER_TEMP/release-pr.json"
+          base=$(jq -r .base.sha "$RUNNER_TEMP/release-pr.json")
+          git fetch --no-tags "$BASE_REPOSITORY_URL" "$base"
+
+      - name: Set up CI environment
+        uses: ./.github/actions/ci-environment
+        with:
+          uv-version: ${{ env.CI_UV_VERSION }}
+          runner-label: ubuntu-latest
+
+      - name: Check version policy
+        env:
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: uv run --locked python scripts/check_version_policy.py --head "$HEAD_SHA" --pr-json "$RUNNER_TEMP/release-pr.json"

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/CONTRIBUTING.md

@@ -9,6 +9,12 @@ Thanks for helping improve Free Claude Code. Keep changes focused, test the beha
 - For bugs, include every model mapping, the active model when the failure occurred, the complete error, and reproducible steps.
 - Add focused tests for behavior changes and relevant edge cases.
 
+## Pull Request Titles
+
+Changes to `assets/`, `scripts/`, `src/`, `.python-version`, `pyproject.toml`, or `uv.lock` require a title starting with `patch: `, `minor: `, or `major: ` followed by a description. Use exactly one space after the colon.
+
+PRs without changes to those paths must not use a release prefix. Do not edit version numbers. Publishing calculates the version after merge, creates its Git tag, and publishes to PyPI and GitHub Releases.
+
 ## Development Setup
 
 Install [uv](https://docs.astral.sh/uv/) and Python 3.14, then run directly from the checkout:
@@ -54,7 +60,3 @@ GitHub CI runs Ruff in check-only mode and also bans `# type: ignore`, `# ty: ig
 - Keep shared Anthropic protocol behavior under `src/free_claude_code/core/anthropic/` rather than importing utilities from another provider.
 - Keep provider-specific configuration in the provider that owns it.
 - Remove dead compatibility code when completing migrations unless preserving a published interface is explicitly required.
-
-## Versioning
-
-Changes to runtime code, packaging, dependencies, or install/CI scripts require a semantic version bump in `pyproject.toml` and a matching `uv lock` update in the same commit. Documentation, tests, smoke coverage, and repository configuration do not require a version bump by themselves.

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: free-claude-code
-Version: 6.2.66
+Version: 6.2.67
 Summary: Local proxy connecting coding agents to OpenAI-compatible AI providers
 License-Expression: AGPL-3.0-only
 License-File: LICENSE

{free_claude_code-6.2.66 → free_claude_code-6.2.67}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs>=0.5.0"]
 build-backend = "hatchling.build"
 
 [project]
 name = "free-claude-code"
-version = "6.2.66"
+dynamic = ["version"]
 description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
 readme = "README.md"
 license = "AGPL-3.0-only"
@@ -63,6 +63,9 @@ voice_local = [
     "librosa>=1.0.0",
 ]
 
+[tool.hatch.version]
+source = "vcs"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/free_claude_code"]
 
@@ -72,6 +75,7 @@ packages = ["src/free_claude_code"]
 
 [tool.uv]
 required-version = ">=0.12.13"
+cache-keys = [{ file = "pyproject.toml" }, { git = { commit = true, tags = true } }]
 
 [tool.uv.sources]
 torch = { index = "pytorch-cu130" }

free_claude_code-6.2.67/scripts/check_version_policy.py

@@ -0,0 +1,127 @@
+"""Validate release intent against changed files and calculate one version bump."""
+
+import argparse
+import json
+import re
+import subprocess
+import tomllib
+from pathlib import Path
+
+RELEASE_FILES = {".python-version", "pyproject.toml", "uv.lock"}
+RELEASE_DIRS = ("assets/", "scripts/", "src/")
+VERSION = re.compile(r"(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)")
+PREFIX = re.compile(r"(patch|minor|major): \S[^\r\n]*")
+RESERVED = re.compile(r"\s*(patch|minor|major)\s*[:\uff1a]", re.IGNORECASE)
+
+
+def git(*args: str) -> str:
+    return subprocess.run(
+        ["git", *args], check=True, capture_output=True, text=True, encoding="utf-8"
+    ).stdout.rstrip("\r\n")
+
+
+def changed_paths(base: str, head: str) -> list[str]:
+    return list(
+        filter(
+            None,
+            git("diff", "--no-renames", "--name-only", "-z", base, head).split("\0"),
+        )
+    )
+
+
+def release_paths(paths: list[str]) -> list[str]:
+    return [
+        path for path in paths if path in RELEASE_FILES or path.startswith(RELEASE_DIRS)
+    ]
+
+
+def release_kind(title: str, paths: list[str]) -> str | None:
+    match = PREFIX.fullmatch(title)
+    released = release_paths(paths)
+    if not match and RESERVED.match(title):
+        raise ValueError(
+            "Use exactly patch: , minor: , or major: followed by a description"
+        )
+    if released and not match:
+        raise ValueError("Release changes require a patch: , minor: , or major: title")
+    if not released and match:
+        raise ValueError("A non-release PR must not use a release prefix")
+    return match[1] if match else None
+
+
+def next_version(previous: str, kind: str) -> str:
+    match = VERSION.fullmatch(previous)
+    if not match:
+        raise ValueError(f"Invalid release version: {previous}")
+    major, minor, patch = map(int, match.groups())
+    if kind == "major":
+        return f"{major + 1}.0.0"
+    if kind == "minor":
+        return f"{major}.{minor + 1}.0"
+    if kind == "patch":
+        return f"{major}.{minor}.{patch + 1}"
+    raise ValueError(f"Invalid release kind: {kind}")
+
+
+def check_packaging(head: str) -> None:
+    project = tomllib.loads(git("show", f"{head}:pyproject.toml"))["project"]
+    if (
+        project["name"] != "free-claude-code"
+        or "version" in project
+        or "version" not in project.get("dynamic", [])
+    ):
+        raise ValueError("FCC must declare a dynamic version without project.version")
+    lock = tomllib.loads(git("show", f"{head}:uv.lock"))
+    roots = [
+        p
+        for p in lock["package"]
+        if p["name"] == "free-claude-code" and p.get("source") == {"editable": "."}
+    ]
+    if len(roots) != 1 or "version" in roots[0]:
+        raise ValueError("uv.lock must have one editable FCC package without a version")
+
+
+def check(base: str, head: str, title: str) -> None:
+    base = git("rev-parse", "--verify", "--end-of-options", f"{base}^{{commit}}")
+    head = git("rev-parse", "--verify", "--end-of-options", f"{head}^{{commit}}")
+    paths = changed_paths(git("merge-base", base, head), head)
+    print("Release changes: " + (", ".join(release_paths(paths)) or "none"))
+    kind = release_kind(title, paths)
+    check_packaging(head)
+    print(f"Version policy passed: {kind or 'no release'}")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--base")
+    parser.add_argument("--head", required=True)
+    parser.add_argument("--title")
+    parser.add_argument("--pr-json", type=Path)
+    args = parser.parse_args()
+    try:
+        if args.pr_json:
+            pr = json.loads(args.pr_json.read_text(encoding="utf-8"))
+            if pr["head"]["sha"] != git(
+                "rev-parse", "--verify", "--end-of-options", f"{args.head}^{{commit}}"
+            ):
+                raise ValueError("PR head changed; use the current policy run")
+            base, title = pr["base"]["sha"], pr["title"]
+        else:
+            base, title = args.base, args.title
+        if not base or title is None:
+            raise ValueError("Provide --pr-json or both --base and --title")
+        check(base, args.head, title)
+    except (
+        ValueError,
+        KeyError,
+        TypeError,
+        OSError,
+        subprocess.CalledProcessError,
+    ) as error:
+        print(f"Version policy failed: {error}")
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())