xithead 1.4.0 → 1.5.1
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.
- package/README.md +108 -72
- package/app/api/config/route.ts +22 -0
- package/app/api/export/route.ts +83 -0
- package/app/api/models/route.ts +12 -0
- package/app/api/stats/route.ts +46 -0
- package/app/dashboard/page.tsx +445 -0
- package/app/globals.css +35 -0
- package/app/installation/page.tsx +293 -0
- package/app/layout.tsx +35 -0
- package/app/master-design-system.css +2076 -0
- package/app/master-design-system.source.css +8 -0
- package/app/page.tsx +187 -0
- package/app/rechtliches/agb/page.tsx +165 -0
- package/app/rechtliches/datenschutz/page.tsx +128 -0
- package/app/rechtliches/impressum/page.tsx +122 -0
- package/app/rechtliches/widerruf/page.tsx +185 -0
- package/bin/xithead.js +264 -0
- package/components/layout/AppShell.tsx +25 -0
- package/components/layout/Footer.tsx +120 -0
- package/components/layout/Header.tsx +145 -0
- package/components/marketing/LegalHighlights.tsx +45 -0
- package/components/marketing/LegalPageShell.tsx +49 -0
- package/components/marketing/LegalPanel.tsx +41 -0
- package/components/marketing/index.ts +3 -0
- package/design-system/README.md +80 -0
- package/design-system/base.css +127 -0
- package/design-system/components.css +1943 -0
- package/design-system/fonts.css +17 -0
- package/design-system/tailwind-preset.js +95 -0
- package/design-system/tokens.css +48 -0
- package/design-system/utilities.css +53 -0
- package/lib/config/index.ts +12 -0
- package/lib/hooks/index.ts +4 -0
- package/lib/hooks/use-mounted.ts +13 -0
- package/lib/hooks/use-session.ts +34 -0
- package/lib/hooks/use-settings.ts +49 -0
- package/lib/utils/index.ts +1 -0
- package/lib/utils/settings.ts +162 -0
- package/lib/utils/utils.ts +6 -0
- package/middleware.ts +26 -0
- package/next-env.d.ts +7 -0
- package/next.config.ts +12 -0
- package/package.json +77 -36
- package/postcss.config.mjs +7 -0
- package/public/apple-touch-icon.png +0 -0
- package/public/logo-transparent.png +0 -0
- package/public/xithead.ps1 +937 -0
- package/scripts/README.md +77 -0
- package/scripts/audit_wheel_glibc_symbols.py +217 -0
- package/scripts/build-master-design-system.cjs +33 -0
- package/scripts/build_rust_extension.sh +58 -0
- package/scripts/changelog-gen.py +203 -0
- package/scripts/eval_output_shaper.py +235 -0
- package/scripts/export_kompress_v2_onnx.py +267 -0
- package/scripts/fixtures/anthropic_replay_body.json +133 -0
- package/scripts/fixtures/codex_response_create_frame.json +52 -0
- package/scripts/install-git-hooks.sh +104 -0
- package/scripts/install.ps1 +1809 -0
- package/scripts/install.sh +1673 -0
- package/scripts/pr-governance.py +297 -0
- package/scripts/record_fixtures.py +59 -0
- package/scripts/refresh_model_limits.sh +48 -0
- package/scripts/replay_codex_ws_load.py +445 -0
- package/scripts/repro_codex_replay.py +699 -0
- package/scripts/smoke_issue_327.py +233 -0
- package/scripts/sync-plugin-versions.py +116 -0
- package/scripts/tests/test_changelog_gen.py +302 -0
- package/scripts/tests/test_pr_governance.py +163 -0
- package/scripts/tests/test_pr_health_labels.py +94 -0
- package/scripts/tests/test_pr_health_workflow.py +14 -0
- package/scripts/tests/test_sync_plugin_versions.py +131 -0
- package/scripts/tests/test_version_sync.py +291 -0
- package/scripts/validate-workflows.sh +39 -0
- package/scripts/verify-versions.py +106 -0
- package/scripts/version-sync.py +207 -0
- package/tailwind.config.js +31 -0
- package/tailwind.master.config.cjs +47 -0
- package/tsconfig.json +84 -0
- package/types/api.ts +12 -0
- package/types/config.ts +9 -0
- package/types/index.ts +2 -0
- package/npm/bin/xithead.js +0 -366
- package/npm/index.d.ts +0 -57
- package/npm/index.js +0 -139
- package/npm/package.json +0 -54
- package/npm/postinstall.js +0 -43
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
"""Tests for pr-governance.py."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import importlib.util
|
|
6
|
+
import sys
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def _load_module():
|
|
11
|
+
script = Path(__file__).parent.parent / "pr-governance.py"
|
|
12
|
+
spec = importlib.util.spec_from_file_location("pr_governance", script)
|
|
13
|
+
assert spec is not None
|
|
14
|
+
assert spec.loader is not None
|
|
15
|
+
module = importlib.util.module_from_spec(spec)
|
|
16
|
+
sys.modules[spec.name] = module
|
|
17
|
+
spec.loader.exec_module(module)
|
|
18
|
+
return module
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def _event(body: str, *, draft: bool = False, login: str = "octocat") -> dict[str, object]:
|
|
22
|
+
return {
|
|
23
|
+
"pull_request": {
|
|
24
|
+
"number": 42,
|
|
25
|
+
"draft": draft,
|
|
26
|
+
"body": body,
|
|
27
|
+
"user": {"login": login},
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
VALID_BODY = """## Description
|
|
33
|
+
|
|
34
|
+
Add a required PR-governance gate for template validation and review readiness.
|
|
35
|
+
|
|
36
|
+
Closes #123
|
|
37
|
+
|
|
38
|
+
## Type of Change
|
|
39
|
+
|
|
40
|
+
- [x] New feature (non-breaking change that adds functionality)
|
|
41
|
+
- [ ] Documentation update
|
|
42
|
+
|
|
43
|
+
## Changes Made
|
|
44
|
+
|
|
45
|
+
- Added a workflow-backed PR template validator.
|
|
46
|
+
- Added local commit message linting in the commit-msg hook.
|
|
47
|
+
|
|
48
|
+
## Testing
|
|
49
|
+
|
|
50
|
+
- [x] Unit tests pass (`pytest`)
|
|
51
|
+
- [x] Manual testing performed
|
|
52
|
+
|
|
53
|
+
### Test Output
|
|
54
|
+
|
|
55
|
+
```text
|
|
56
|
+
pytest scripts/tests/test_pr_governance.py -q
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Real Behavior Proof
|
|
60
|
+
|
|
61
|
+
- Environment: Ubuntu runner, Python 3.12
|
|
62
|
+
- Exact command / steps: Open a PR, remove the ready checkbox, re-run the workflow.
|
|
63
|
+
- Observed result: The governance check fails and the PR gets a needs-author-action label.
|
|
64
|
+
- Not tested: Automatic Copilot review rulesets in repository settings.
|
|
65
|
+
|
|
66
|
+
## Review Readiness
|
|
67
|
+
|
|
68
|
+
- [x] I have performed a self-review
|
|
69
|
+
- [x] This PR is ready for human review
|
|
70
|
+
|
|
71
|
+
## Additional Notes
|
|
72
|
+
|
|
73
|
+
- Maintainers can optionally enable Copilot code review from repository rulesets.
|
|
74
|
+
"""
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
def test_validate_pull_request_marks_ready_pr_valid() -> None:
|
|
78
|
+
module = _load_module()
|
|
79
|
+
|
|
80
|
+
report = module.validate_pull_request(_event(VALID_BODY))
|
|
81
|
+
|
|
82
|
+
assert report.valid is True
|
|
83
|
+
assert report.ready_for_review is True
|
|
84
|
+
assert report.needs_author_action is False
|
|
85
|
+
assert report.problems == []
|
|
86
|
+
assert report.labels_to_add == [module.READY_LABEL]
|
|
87
|
+
assert module.AUTHOR_ACTION_LABEL in report.labels_to_remove
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
def test_validate_pull_request_allows_draft_without_ready_checkboxes() -> None:
|
|
91
|
+
module = _load_module()
|
|
92
|
+
body = VALID_BODY.replace(
|
|
93
|
+
"- [x] I have performed a self-review", "- [ ] I have performed a self-review"
|
|
94
|
+
)
|
|
95
|
+
body = body.replace(
|
|
96
|
+
"- [x] This PR is ready for human review",
|
|
97
|
+
"- [ ] This PR is ready for human review",
|
|
98
|
+
)
|
|
99
|
+
|
|
100
|
+
report = module.validate_pull_request(_event(body, draft=True))
|
|
101
|
+
|
|
102
|
+
assert report.valid is True
|
|
103
|
+
assert report.ready_for_review is False
|
|
104
|
+
assert report.needs_author_action is False
|
|
105
|
+
assert report.labels_to_add == []
|
|
106
|
+
assert module.READY_LABEL in report.labels_to_remove
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
def test_validate_pull_request_fails_on_missing_required_content() -> None:
|
|
110
|
+
module = _load_module()
|
|
111
|
+
body = """## Description
|
|
112
|
+
|
|
113
|
+
Fixes #123
|
|
114
|
+
|
|
115
|
+
## Type of Change
|
|
116
|
+
|
|
117
|
+
- [ ] New feature (non-breaking change that adds functionality)
|
|
118
|
+
|
|
119
|
+
## Changes Made
|
|
120
|
+
|
|
121
|
+
- Change 1
|
|
122
|
+
|
|
123
|
+
## Testing
|
|
124
|
+
|
|
125
|
+
### Test Output
|
|
126
|
+
|
|
127
|
+
```text
|
|
128
|
+
# Paste relevant command output or artifact links here
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## Real Behavior Proof
|
|
132
|
+
|
|
133
|
+
- Environment:
|
|
134
|
+
- Exact command / steps:
|
|
135
|
+
- Observed result:
|
|
136
|
+
- Not tested:
|
|
137
|
+
|
|
138
|
+
## Review Readiness
|
|
139
|
+
|
|
140
|
+
- [ ] I have performed a self-review
|
|
141
|
+
- [ ] This PR is ready for human review
|
|
142
|
+
"""
|
|
143
|
+
|
|
144
|
+
report = module.validate_pull_request(_event(body))
|
|
145
|
+
|
|
146
|
+
assert report.valid is False
|
|
147
|
+
assert report.needs_author_action is True
|
|
148
|
+
assert module.AUTHOR_ACTION_LABEL in report.labels_to_add
|
|
149
|
+
assert any("Description" in problem for problem in report.problems)
|
|
150
|
+
assert any("Type of Change" in problem for problem in report.problems)
|
|
151
|
+
assert any("Test Output" in problem for problem in report.problems)
|
|
152
|
+
assert any("Real Behavior Proof" in problem for problem in report.problems)
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
def test_validate_pull_request_skips_bot_authored_prs() -> None:
|
|
156
|
+
module = _load_module()
|
|
157
|
+
|
|
158
|
+
report = module.validate_pull_request(_event("", login="dependabot[bot]"))
|
|
159
|
+
|
|
160
|
+
assert report.valid is True
|
|
161
|
+
assert report.is_bot_pr is True
|
|
162
|
+
assert report.needs_author_action is False
|
|
163
|
+
assert report.labels_to_add == []
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
"""Tests for pr-health-labels.py."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import importlib.util
|
|
6
|
+
import sys
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def _load_module():
|
|
11
|
+
script = Path(__file__).parents[2] / ".github" / "scripts" / "pr-health-labels.py"
|
|
12
|
+
spec = importlib.util.spec_from_file_location("pr_health_labels", script)
|
|
13
|
+
assert spec is not None
|
|
14
|
+
assert spec.loader is not None
|
|
15
|
+
module = importlib.util.module_from_spec(spec)
|
|
16
|
+
sys.modules[spec.name] = module
|
|
17
|
+
spec.loader.exec_module(module)
|
|
18
|
+
return module
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def test_check_state_ignores_historical_failures_when_latest_attempt_passed() -> None:
|
|
22
|
+
module = _load_module()
|
|
23
|
+
payload = {
|
|
24
|
+
"statusCheckRollup": [
|
|
25
|
+
{
|
|
26
|
+
"__typename": "CheckRun",
|
|
27
|
+
"workflowName": "PR Governance",
|
|
28
|
+
"name": "template",
|
|
29
|
+
"conclusion": "FAILURE",
|
|
30
|
+
"startedAt": "2026-06-14T13:38:35Z",
|
|
31
|
+
"completedAt": "2026-06-14T13:38:46Z",
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
"__typename": "CheckRun",
|
|
35
|
+
"workflowName": "PR Governance",
|
|
36
|
+
"name": "template",
|
|
37
|
+
"conclusion": "SUCCESS",
|
|
38
|
+
"startedAt": "2026-06-14T13:43:26Z",
|
|
39
|
+
"completedAt": "2026-06-14T13:43:35Z",
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"__typename": "CheckRun",
|
|
43
|
+
"workflowName": "PR Governance",
|
|
44
|
+
"name": "label",
|
|
45
|
+
"conclusion": "CANCELLED",
|
|
46
|
+
"startedAt": "2026-06-14T13:43:18Z",
|
|
47
|
+
"completedAt": "2026-06-14T13:43:24Z",
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"__typename": "CheckRun",
|
|
51
|
+
"workflowName": "PR Governance",
|
|
52
|
+
"name": "label",
|
|
53
|
+
"conclusion": "SUCCESS",
|
|
54
|
+
"startedAt": "2026-06-14T13:43:26Z",
|
|
55
|
+
"completedAt": "2026-06-14T13:43:35Z",
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
"__typename": "CheckRun",
|
|
59
|
+
"workflowName": "",
|
|
60
|
+
"name": "GitGuardian Security Checks",
|
|
61
|
+
"conclusion": "SUCCESS",
|
|
62
|
+
"startedAt": "2026-06-14T13:38:32Z",
|
|
63
|
+
"completedAt": "2026-06-14T13:39:04Z",
|
|
64
|
+
},
|
|
65
|
+
]
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
assert module.check_state(payload) == "passing"
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def test_check_state_fails_when_latest_attempt_failed() -> None:
|
|
72
|
+
module = _load_module()
|
|
73
|
+
payload = {
|
|
74
|
+
"statusCheckRollup": [
|
|
75
|
+
{
|
|
76
|
+
"__typename": "CheckRun",
|
|
77
|
+
"workflowName": "PR Governance",
|
|
78
|
+
"name": "template",
|
|
79
|
+
"conclusion": "SUCCESS",
|
|
80
|
+
"startedAt": "2026-06-14T13:38:35Z",
|
|
81
|
+
"completedAt": "2026-06-14T13:38:46Z",
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"__typename": "CheckRun",
|
|
85
|
+
"workflowName": "PR Governance",
|
|
86
|
+
"name": "template",
|
|
87
|
+
"conclusion": "FAILURE",
|
|
88
|
+
"startedAt": "2026-06-14T13:43:26Z",
|
|
89
|
+
"completedAt": "2026-06-14T13:43:35Z",
|
|
90
|
+
},
|
|
91
|
+
]
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
assert module.check_state(payload) == "failing"
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
"""Tests for the PR governance workflow contract."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
def test_incomplete_pr_template_is_reported_without_failing_job() -> None:
|
|
9
|
+
workflow = Path(".github/workflows/pr-health.yml").read_text(encoding="utf-8")
|
|
10
|
+
|
|
11
|
+
assert "Report incomplete PR body" in workflow
|
|
12
|
+
assert "PR template validation found missing fields" in workflow
|
|
13
|
+
assert "Fail when the PR body is incomplete" not in workflow
|
|
14
|
+
assert 'echo "PR template validation failed' not in workflow
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
"""Tests for sync-plugin-versions.py."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import importlib.util
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def _load_module():
|
|
10
|
+
script = Path(__file__).parent.parent / "sync-plugin-versions.py"
|
|
11
|
+
spec = importlib.util.spec_from_file_location("sync_plugin_versions", script)
|
|
12
|
+
assert spec is not None
|
|
13
|
+
assert spec.loader is not None
|
|
14
|
+
module = importlib.util.module_from_spec(spec)
|
|
15
|
+
spec.loader.exec_module(module)
|
|
16
|
+
return module
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def test_compute_repo_semver_uses_release_helpers(monkeypatch) -> None:
|
|
20
|
+
module = _load_module()
|
|
21
|
+
calls: dict[str, object] = {}
|
|
22
|
+
|
|
23
|
+
monkeypatch.setattr(module, "list_release_tags", lambda root: ["v0.9.0"])
|
|
24
|
+
monkeypatch.setattr(module, "find_latest_release_tag", lambda tags: "v0.9.0")
|
|
25
|
+
monkeypatch.setattr(module, "list_release_commits", lambda root, tag: ["feat: add init"])
|
|
26
|
+
monkeypatch.setattr(module, "determine_bump_level", lambda commits: "minor")
|
|
27
|
+
monkeypatch.setattr(module, "get_canonical_version", lambda root: "0.5.25")
|
|
28
|
+
|
|
29
|
+
def fake_compute_release_version(*, canonical_version: str, level: str, tags: list[str]):
|
|
30
|
+
calls["canonical_version"] = canonical_version
|
|
31
|
+
calls["level"] = level
|
|
32
|
+
calls["tags"] = tags
|
|
33
|
+
return type("Info", (), {"npm_version": "0.10.0"})()
|
|
34
|
+
|
|
35
|
+
monkeypatch.setattr(module, "compute_release_version", fake_compute_release_version)
|
|
36
|
+
|
|
37
|
+
assert module.compute_repo_semver(Path("repo")) == "0.10.0"
|
|
38
|
+
assert calls == {
|
|
39
|
+
"canonical_version": "0.5.25",
|
|
40
|
+
"level": "minor",
|
|
41
|
+
"tags": ["v0.9.0"],
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
def test_main_runs_plugin_only_version_sync(monkeypatch) -> None:
|
|
46
|
+
"""Locks the sync-execution path. ``_should_sync`` is forced True so
|
|
47
|
+
we don't depend on the test machine's git branch context."""
|
|
48
|
+
module = _load_module()
|
|
49
|
+
commands: list[list[str]] = []
|
|
50
|
+
|
|
51
|
+
monkeypatch.setattr(module, "compute_repo_semver", lambda root: "0.10.0")
|
|
52
|
+
monkeypatch.setattr(module, "_should_sync", lambda root: True)
|
|
53
|
+
monkeypatch.setattr(
|
|
54
|
+
module.subprocess,
|
|
55
|
+
"run",
|
|
56
|
+
lambda command, cwd, check: commands.append(command),
|
|
57
|
+
)
|
|
58
|
+
|
|
59
|
+
module.main()
|
|
60
|
+
|
|
61
|
+
assert commands == [
|
|
62
|
+
[
|
|
63
|
+
module.sys.executable,
|
|
64
|
+
str(module.ROOT / "scripts" / "version-sync.py"),
|
|
65
|
+
"--root",
|
|
66
|
+
str(module.ROOT),
|
|
67
|
+
"--version",
|
|
68
|
+
"0.10.0",
|
|
69
|
+
"--plugin-manifests-only",
|
|
70
|
+
]
|
|
71
|
+
]
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
def test_main_is_noop_on_feature_branch(monkeypatch, capsys) -> None:
|
|
75
|
+
"""Locks the branch-aware contract: when ``_should_sync`` returns
|
|
76
|
+
False (feature branch, no HEADROOM_SYNC_VERSIONS opt-in), main()
|
|
77
|
+
prints a skip line and returns without invoking the version-sync
|
|
78
|
+
subprocess. Pre-this-fix the hook bumped manifests on every commit
|
|
79
|
+
regardless of branch — leaking version-bump noise into every PR."""
|
|
80
|
+
module = _load_module()
|
|
81
|
+
commands: list[list[str]] = []
|
|
82
|
+
|
|
83
|
+
monkeypatch.setattr(module, "_should_sync", lambda root: False)
|
|
84
|
+
monkeypatch.setattr(module, "_current_branch", lambda root: "feature/foo")
|
|
85
|
+
monkeypatch.setattr(
|
|
86
|
+
module.subprocess,
|
|
87
|
+
"run",
|
|
88
|
+
lambda *args, **kwargs: commands.append(args),
|
|
89
|
+
)
|
|
90
|
+
|
|
91
|
+
module.main()
|
|
92
|
+
|
|
93
|
+
assert commands == [], "Subprocess must not run when _should_sync returns False"
|
|
94
|
+
captured = capsys.readouterr()
|
|
95
|
+
assert "skipping on branch 'feature/foo'" in captured.out
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
def test_should_sync_honours_env_override(monkeypatch) -> None:
|
|
99
|
+
"""``HEADROOM_SYNC_VERSIONS=1`` forces a sync even on feature
|
|
100
|
+
branches — the release workflow uses this opt-in so the canonical
|
|
101
|
+
manifest sync still happens at publish time."""
|
|
102
|
+
module = _load_module()
|
|
103
|
+
monkeypatch.setenv("HEADROOM_SYNC_VERSIONS", "1")
|
|
104
|
+
# Even on a "feature" branch, env override wins.
|
|
105
|
+
monkeypatch.setattr(module, "_current_branch", lambda root: "feature/foo")
|
|
106
|
+
assert module._should_sync(Path("ignored")) is True
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
def test_should_sync_main_branch_runs(monkeypatch) -> None:
|
|
110
|
+
"""On ``main``, sync runs without needing the env var."""
|
|
111
|
+
module = _load_module()
|
|
112
|
+
monkeypatch.delenv("HEADROOM_SYNC_VERSIONS", raising=False)
|
|
113
|
+
monkeypatch.setattr(module, "_current_branch", lambda root: "main")
|
|
114
|
+
assert module._should_sync(Path("ignored")) is True
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
def test_should_sync_feature_branch_is_skip(monkeypatch) -> None:
|
|
118
|
+
"""On any non-main branch without the env var, sync is a no-op."""
|
|
119
|
+
module = _load_module()
|
|
120
|
+
monkeypatch.delenv("HEADROOM_SYNC_VERSIONS", raising=False)
|
|
121
|
+
monkeypatch.setattr(module, "_current_branch", lambda root: "fix/some-bug")
|
|
122
|
+
assert module._should_sync(Path("ignored")) is False
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def test_should_sync_returns_false_when_git_unavailable(monkeypatch) -> None:
|
|
126
|
+
"""Defensive: if ``_current_branch`` returns None (git not on
|
|
127
|
+
PATH, detached HEAD, etc.) the safe default is no-op."""
|
|
128
|
+
module = _load_module()
|
|
129
|
+
monkeypatch.delenv("HEADROOM_SYNC_VERSIONS", raising=False)
|
|
130
|
+
monkeypatch.setattr(module, "_current_branch", lambda root: None)
|
|
131
|
+
assert module._should_sync(Path("ignored")) is False
|
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
"""Tests for version-sync.py."""
|
|
2
|
+
|
|
3
|
+
import json
|
|
4
|
+
import subprocess
|
|
5
|
+
import sys
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
|
|
8
|
+
import pytest
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
@pytest.fixture
|
|
12
|
+
def temp_project(tmp_path: Path) -> dict[str, Path]:
|
|
13
|
+
"""Create a temporary project with all versioned files."""
|
|
14
|
+
# Create directory structure
|
|
15
|
+
root = tmp_path / "project"
|
|
16
|
+
headroom = root / "headroom"
|
|
17
|
+
headroom.mkdir(parents=True)
|
|
18
|
+
repo_claude_plugin = root / ".claude-plugin"
|
|
19
|
+
repo_claude_plugin.mkdir(parents=True)
|
|
20
|
+
repo_github_plugin = root / ".github" / "plugin"
|
|
21
|
+
repo_github_plugin.mkdir(parents=True)
|
|
22
|
+
plugins = root / "plugins"
|
|
23
|
+
openclaw = plugins / "openclaw"
|
|
24
|
+
openclaw.mkdir(parents=True)
|
|
25
|
+
agent_hooks_claude = plugins / "headroom-agent-hooks" / ".claude-plugin"
|
|
26
|
+
agent_hooks_claude.mkdir(parents=True)
|
|
27
|
+
agent_hooks_github = plugins / "headroom-agent-hooks" / ".github" / "plugin"
|
|
28
|
+
agent_hooks_github.mkdir(parents=True)
|
|
29
|
+
sdk = root / "sdk"
|
|
30
|
+
typescript = sdk / "typescript"
|
|
31
|
+
typescript.mkdir(parents=True)
|
|
32
|
+
|
|
33
|
+
# pyproject.toml
|
|
34
|
+
pyproject = root / "pyproject.toml"
|
|
35
|
+
pyproject.write_text('[project]\nversion = "0.5.25"\n')
|
|
36
|
+
|
|
37
|
+
# headroom/_version.py is runtime-derived and must not be rewritten by version-sync.
|
|
38
|
+
version_py = headroom / "_version.py"
|
|
39
|
+
version_py.write_text('"""Package version metadata."""\n\n__version__ = "0.5.25"\n')
|
|
40
|
+
|
|
41
|
+
# plugins/openclaw/package.json
|
|
42
|
+
openclaw_pkg = openclaw / "package.json"
|
|
43
|
+
openclaw_pkg.write_text(json.dumps({"name": "test", "version": "0.5.25"}))
|
|
44
|
+
|
|
45
|
+
repo_claude_marketplace = repo_claude_plugin / "marketplace.json"
|
|
46
|
+
repo_claude_marketplace.write_text(
|
|
47
|
+
json.dumps(
|
|
48
|
+
{
|
|
49
|
+
"metadata": {"name": "claude-marketplace", "version": "0.1.0"},
|
|
50
|
+
"plugins": [{"name": "headroom-agent-hooks", "version": "0.1.0"}],
|
|
51
|
+
}
|
|
52
|
+
)
|
|
53
|
+
)
|
|
54
|
+
|
|
55
|
+
repo_github_marketplace = repo_github_plugin / "marketplace.json"
|
|
56
|
+
repo_github_marketplace.write_text(
|
|
57
|
+
json.dumps(
|
|
58
|
+
{
|
|
59
|
+
"metadata": {"name": "copilot-marketplace", "version": "0.1.0"},
|
|
60
|
+
"plugins": [{"name": "headroom-agent-hooks", "version": "0.1.0"}],
|
|
61
|
+
}
|
|
62
|
+
)
|
|
63
|
+
)
|
|
64
|
+
|
|
65
|
+
claude_plugin = agent_hooks_claude / "plugin.json"
|
|
66
|
+
claude_plugin.write_text(json.dumps({"name": "headroom-agent-hooks", "version": "0.1.0"}))
|
|
67
|
+
|
|
68
|
+
github_plugin = agent_hooks_github / "plugin.json"
|
|
69
|
+
github_plugin.write_text(json.dumps({"name": "headroom-agent-hooks", "version": "0.1.0"}))
|
|
70
|
+
|
|
71
|
+
# sdk/typescript/package.json
|
|
72
|
+
typescript_pkg = typescript / "package.json"
|
|
73
|
+
typescript_pkg.write_text(json.dumps({"name": "test", "version": "0.5.25"}))
|
|
74
|
+
|
|
75
|
+
return {
|
|
76
|
+
"root": root,
|
|
77
|
+
"pyproject": pyproject,
|
|
78
|
+
"version_py": version_py,
|
|
79
|
+
"openclaw_pkg": openclaw_pkg,
|
|
80
|
+
"repo_claude_marketplace": repo_claude_marketplace,
|
|
81
|
+
"repo_github_marketplace": repo_github_marketplace,
|
|
82
|
+
"claude_plugin": claude_plugin,
|
|
83
|
+
"github_plugin": github_plugin,
|
|
84
|
+
"typescript_pkg": typescript_pkg,
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
def test_version_sync_explicit_version(temp_project: dict[str, Path]) -> None:
|
|
89
|
+
"""Test --version flag updates all files."""
|
|
90
|
+
root = temp_project["root"]
|
|
91
|
+
script = Path(__file__).parent.parent / "version-sync.py"
|
|
92
|
+
|
|
93
|
+
result = subprocess.run(
|
|
94
|
+
[sys.executable, str(script), "--root", str(root), "--version", "0.7.0"],
|
|
95
|
+
capture_output=True,
|
|
96
|
+
text=True,
|
|
97
|
+
)
|
|
98
|
+
|
|
99
|
+
assert result.returncode == 0, f"Script failed: {result.stderr}"
|
|
100
|
+
|
|
101
|
+
# Verify pyproject.toml
|
|
102
|
+
pyproject_content = temp_project["pyproject"].read_text()
|
|
103
|
+
assert 'version = "0.7.0"' in pyproject_content
|
|
104
|
+
|
|
105
|
+
# Verify headroom/_version.py is not a synced manifest.
|
|
106
|
+
version_py_content = temp_project["version_py"].read_text()
|
|
107
|
+
assert '__version__ = "0.5.25"' in version_py_content
|
|
108
|
+
|
|
109
|
+
# Verify plugins/openclaw/package.json
|
|
110
|
+
openclaw_pkg = json.loads(temp_project["openclaw_pkg"].read_text())
|
|
111
|
+
assert openclaw_pkg["version"] == "0.7.0"
|
|
112
|
+
|
|
113
|
+
# Verify sdk/typescript/package.json
|
|
114
|
+
typescript_pkg = json.loads(temp_project["typescript_pkg"].read_text())
|
|
115
|
+
assert typescript_pkg["version"] == "0.7.0"
|
|
116
|
+
|
|
117
|
+
repo_claude_marketplace = json.loads(temp_project["repo_claude_marketplace"].read_text())
|
|
118
|
+
assert repo_claude_marketplace["metadata"]["version"] == "0.7.0"
|
|
119
|
+
assert repo_claude_marketplace["plugins"][0]["version"] == "0.7.0"
|
|
120
|
+
|
|
121
|
+
repo_github_marketplace = json.loads(temp_project["repo_github_marketplace"].read_text())
|
|
122
|
+
assert repo_github_marketplace["metadata"]["version"] == "0.7.0"
|
|
123
|
+
assert repo_github_marketplace["plugins"][0]["version"] == "0.7.0"
|
|
124
|
+
|
|
125
|
+
claude_plugin = json.loads(temp_project["claude_plugin"].read_text())
|
|
126
|
+
assert claude_plugin["version"] == "0.7.0"
|
|
127
|
+
|
|
128
|
+
github_plugin = json.loads(temp_project["github_plugin"].read_text())
|
|
129
|
+
assert github_plugin["version"] == "0.7.0"
|
|
130
|
+
|
|
131
|
+
# Verify .releaseetadata was created
|
|
132
|
+
release_metadata = root / ".releaseetadata"
|
|
133
|
+
assert release_metadata.exists()
|
|
134
|
+
metadata = json.loads(release_metadata.read_text())
|
|
135
|
+
assert metadata["version"] == "0.7.0"
|
|
136
|
+
assert metadata["packages"]["pypi"] == "0.7.0"
|
|
137
|
+
assert metadata["packages"]["npm-sdk"] == "0.7.0"
|
|
138
|
+
assert metadata["packages"]["npm-openclaw"] == "0.7.0"
|
|
139
|
+
assert metadata["packages"]["agent-hooks-plugin"] == "0.7.0"
|
|
140
|
+
|
|
141
|
+
|
|
142
|
+
def test_bump_patch(temp_project: dict[str, Path]) -> None:
|
|
143
|
+
"""Test --bump patch bumps 0.5.25 to 0.5.26."""
|
|
144
|
+
root = temp_project["root"]
|
|
145
|
+
script = Path(__file__).parent.parent / "version-sync.py"
|
|
146
|
+
|
|
147
|
+
result = subprocess.run(
|
|
148
|
+
[sys.executable, str(script), "--root", str(root), "--bump", "patch"],
|
|
149
|
+
capture_output=True,
|
|
150
|
+
text=True,
|
|
151
|
+
)
|
|
152
|
+
|
|
153
|
+
assert result.returncode == 0, f"Script failed: {result.stderr}"
|
|
154
|
+
|
|
155
|
+
# Verify all files updated to 0.5.26
|
|
156
|
+
pyproject_content = temp_project["pyproject"].read_text()
|
|
157
|
+
assert 'version = "0.5.26"' in pyproject_content
|
|
158
|
+
|
|
159
|
+
version_py_content = temp_project["version_py"].read_text()
|
|
160
|
+
assert '__version__ = "0.5.25"' in version_py_content
|
|
161
|
+
|
|
162
|
+
openclaw_pkg = json.loads(temp_project["openclaw_pkg"].read_text())
|
|
163
|
+
assert openclaw_pkg["version"] == "0.5.26"
|
|
164
|
+
|
|
165
|
+
typescript_pkg = json.loads(temp_project["typescript_pkg"].read_text())
|
|
166
|
+
assert typescript_pkg["version"] == "0.5.26"
|
|
167
|
+
|
|
168
|
+
claude_plugin = json.loads(temp_project["claude_plugin"].read_text())
|
|
169
|
+
assert claude_plugin["version"] == "0.5.26"
|
|
170
|
+
|
|
171
|
+
|
|
172
|
+
def test_bump_minor(temp_project: dict[str, Path]) -> None:
|
|
173
|
+
"""Test --bump minor bumps 0.5.25 to 0.6.0."""
|
|
174
|
+
root = temp_project["root"]
|
|
175
|
+
script = Path(__file__).parent.parent / "version-sync.py"
|
|
176
|
+
|
|
177
|
+
result = subprocess.run(
|
|
178
|
+
[sys.executable, str(script), "--root", str(root), "--bump", "minor"],
|
|
179
|
+
capture_output=True,
|
|
180
|
+
text=True,
|
|
181
|
+
)
|
|
182
|
+
|
|
183
|
+
assert result.returncode == 0, f"Script failed: {result.stderr}"
|
|
184
|
+
|
|
185
|
+
# Verify all files updated to 0.6.0
|
|
186
|
+
pyproject_content = temp_project["pyproject"].read_text()
|
|
187
|
+
assert 'version = "0.6.0"' in pyproject_content
|
|
188
|
+
|
|
189
|
+
version_py_content = temp_project["version_py"].read_text()
|
|
190
|
+
assert '__version__ = "0.5.25"' in version_py_content
|
|
191
|
+
|
|
192
|
+
openclaw_pkg = json.loads(temp_project["openclaw_pkg"].read_text())
|
|
193
|
+
assert openclaw_pkg["version"] == "0.6.0"
|
|
194
|
+
|
|
195
|
+
typescript_pkg = json.loads(temp_project["typescript_pkg"].read_text())
|
|
196
|
+
assert typescript_pkg["version"] == "0.6.0"
|
|
197
|
+
|
|
198
|
+
github_plugin = json.loads(temp_project["github_plugin"].read_text())
|
|
199
|
+
assert github_plugin["version"] == "0.6.0"
|
|
200
|
+
|
|
201
|
+
|
|
202
|
+
def test_bump_major(temp_project: dict[str, Path]) -> None:
|
|
203
|
+
"""Test --bump major bumps 0.5.25 to 1.0.0."""
|
|
204
|
+
root = temp_project["root"]
|
|
205
|
+
script = Path(__file__).parent.parent / "version-sync.py"
|
|
206
|
+
|
|
207
|
+
result = subprocess.run(
|
|
208
|
+
[sys.executable, str(script), "--root", str(root), "--bump", "major"],
|
|
209
|
+
capture_output=True,
|
|
210
|
+
text=True,
|
|
211
|
+
)
|
|
212
|
+
|
|
213
|
+
assert result.returncode == 0, f"Script failed: {result.stderr}"
|
|
214
|
+
|
|
215
|
+
# Verify all files updated to 1.0.0
|
|
216
|
+
pyproject_content = temp_project["pyproject"].read_text()
|
|
217
|
+
assert 'version = "1.0.0"' in pyproject_content
|
|
218
|
+
|
|
219
|
+
version_py_content = temp_project["version_py"].read_text()
|
|
220
|
+
assert '__version__ = "0.5.25"' in version_py_content
|
|
221
|
+
|
|
222
|
+
openclaw_pkg = json.loads(temp_project["openclaw_pkg"].read_text())
|
|
223
|
+
assert openclaw_pkg["version"] == "1.0.0"
|
|
224
|
+
|
|
225
|
+
typescript_pkg = json.loads(temp_project["typescript_pkg"].read_text())
|
|
226
|
+
assert typescript_pkg["version"] == "1.0.0"
|
|
227
|
+
|
|
228
|
+
repo_claude_marketplace = json.loads(temp_project["repo_claude_marketplace"].read_text())
|
|
229
|
+
assert repo_claude_marketplace["metadata"]["version"] == "1.0.0"
|
|
230
|
+
|
|
231
|
+
|
|
232
|
+
def test_release_metadata_written(temp_project: dict[str, Path]) -> None:
|
|
233
|
+
"""Test .releaseetadata is written correctly."""
|
|
234
|
+
root = temp_project["root"]
|
|
235
|
+
script = Path(__file__).parent.parent / "version-sync.py"
|
|
236
|
+
|
|
237
|
+
result = subprocess.run(
|
|
238
|
+
[sys.executable, str(script), "--root", str(root), "--version", "0.6.0"],
|
|
239
|
+
capture_output=True,
|
|
240
|
+
text=True,
|
|
241
|
+
)
|
|
242
|
+
|
|
243
|
+
assert result.returncode == 0, f"Script failed: {result.stderr}"
|
|
244
|
+
|
|
245
|
+
release_metadata = root / ".releaseetadata"
|
|
246
|
+
assert release_metadata.exists()
|
|
247
|
+
|
|
248
|
+
metadata = json.loads(release_metadata.read_text())
|
|
249
|
+
assert metadata == {
|
|
250
|
+
"version": "0.6.0",
|
|
251
|
+
"packages": {
|
|
252
|
+
"pypi": "0.6.0",
|
|
253
|
+
"npm-sdk": "0.6.0",
|
|
254
|
+
"npm-openclaw": "0.6.0",
|
|
255
|
+
"agent-hooks-plugin": "0.6.0",
|
|
256
|
+
},
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
|
|
260
|
+
def test_plugin_manifests_only_leaves_package_versions_unchanged(
|
|
261
|
+
temp_project: dict[str, Path],
|
|
262
|
+
) -> None:
|
|
263
|
+
"""Test plugin-only sync leaves canonical package versions alone."""
|
|
264
|
+
root = temp_project["root"]
|
|
265
|
+
script = Path(__file__).parent.parent / "version-sync.py"
|
|
266
|
+
|
|
267
|
+
result = subprocess.run(
|
|
268
|
+
[
|
|
269
|
+
sys.executable,
|
|
270
|
+
str(script),
|
|
271
|
+
"--root",
|
|
272
|
+
str(root),
|
|
273
|
+
"--version",
|
|
274
|
+
"0.8.0",
|
|
275
|
+
"--plugin-manifests-only",
|
|
276
|
+
],
|
|
277
|
+
capture_output=True,
|
|
278
|
+
text=True,
|
|
279
|
+
)
|
|
280
|
+
|
|
281
|
+
assert result.returncode == 0, f"Script failed: {result.stderr}"
|
|
282
|
+
assert 'version = "0.5.25"' in temp_project["pyproject"].read_text()
|
|
283
|
+
assert '__version__ = "0.5.25"' in temp_project["version_py"].read_text()
|
|
284
|
+
assert json.loads(temp_project["openclaw_pkg"].read_text())["version"] == "0.5.25"
|
|
285
|
+
assert json.loads(temp_project["typescript_pkg"].read_text())["version"] == "0.5.25"
|
|
286
|
+
assert json.loads(temp_project["claude_plugin"].read_text())["version"] == "0.8.0"
|
|
287
|
+
assert (
|
|
288
|
+
json.loads(temp_project["repo_github_marketplace"].read_text())["metadata"]["version"]
|
|
289
|
+
== "0.8.0"
|
|
290
|
+
)
|
|
291
|
+
assert not (root / ".releaseetadata").exists()
|