rb-keys 0.2.3__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.
- rb_keys-0.2.3/.agents/antagor/.gitignore +3 -0
- rb_keys-0.2.3/.agents/antagor/antagor.toml +47 -0
- rb_keys-0.2.3/.agents/antagor/state/.residents +1 -0
- rb_keys-0.2.3/.agents/antagor/state/.tasks +1 -0
- rb_keys-0.2.3/.agents/antagor/state/architect_floor.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/architect_labels +1 -0
- rb_keys-0.2.3/.agents/antagor/state/architect_name +1 -0
- rb_keys-0.2.3/.agents/antagor/state/architect_pane +1 -0
- rb_keys-0.2.3/.agents/antagor/state/architect_session +1 -0
- rb_keys-0.2.3/.agents/antagor/state/connector.json +13 -0
- rb_keys-0.2.3/.agents/antagor/state/connector.lock +0 -0
- rb_keys-0.2.3/.agents/antagor/state/connector_push.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/connector_push.lock +0 -0
- rb_keys-0.2.3/.agents/antagor/state/connector_sync.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/daemon.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/daemon.log +0 -0
- rb_keys-0.2.3/.agents/antagor/state/delivery/queue.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/delivery/queue.lock +0 -0
- rb_keys-0.2.3/.agents/antagor/state/green_checks.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/journal.jsonl +94 -0
- rb_keys-0.2.3/.agents/antagor/state/mode.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/notify.lock +0 -0
- rb_keys-0.2.3/.agents/antagor/state/notify_position +1 -0
- rb_keys-0.2.3/.agents/antagor/state/plane_cache.json +1 -0
- rb_keys-0.2.3/.agents/antagor/state/publishing.lock +0 -0
- rb_keys-0.2.3/.agents/antagor/state/tabs_sweep.json +1 -0
- rb_keys-0.2.3/.claude/settings.local.json +123 -0
- rb_keys-0.2.3/.copier-answers.yml +23 -0
- rb_keys-0.2.3/.gitignore +18 -0
- rb_keys-0.2.3/.gitleaks.toml +12 -0
- rb_keys-0.2.3/AGENTS.md +34 -0
- rb_keys-0.2.3/CHANGELOG.md +37 -0
- rb_keys-0.2.3/CLAUDE.md +3 -0
- rb_keys-0.2.3/CODING_STANDARDS.md +90 -0
- rb_keys-0.2.3/CONTEXT.md +21 -0
- rb_keys-0.2.3/PKG-INFO +95 -0
- rb_keys-0.2.3/README.md +79 -0
- rb_keys-0.2.3/docs/adr/README.md +17 -0
- rb_keys-0.2.3/pyproject.toml +146 -0
- rb_keys-0.2.3/scripts/check_command_docstrings.py +150 -0
- rb_keys-0.2.3/scripts/deploy.sh +5 -0
- rb_keys-0.2.3/scripts/detach.py +234 -0
- rb_keys-0.2.3/scripts/run_detached.sh +6 -0
- rb_keys-0.2.3/scripts/runs_status.sh +4 -0
- rb_keys-0.2.3/src/rb_keys/__init__.py +9 -0
- rb_keys-0.2.3/src/rb_keys/_distribution.py +24 -0
- rb_keys-0.2.3/src/rb_keys/cli.py +71 -0
- rb_keys-0.2.3/src/rb_keys/commands/__init__.py +1 -0
- rb_keys-0.2.3/src/rb_keys/commands/auth.py +66 -0
- rb_keys-0.2.3/src/rb_keys/commands/config.py +87 -0
- rb_keys-0.2.3/src/rb_keys/commands/describe.py +34 -0
- rb_keys-0.2.3/src/rb_keys/commands/doctor.py +43 -0
- rb_keys-0.2.3/src/rb_keys/commands/init.py +48 -0
- rb_keys-0.2.3/src/rb_keys/commands/keys.py +124 -0
- rb_keys-0.2.3/src/rb_keys/commands/project.py +55 -0
- rb_keys-0.2.3/src/rb_keys/commands/skill.py +138 -0
- rb_keys-0.2.3/src/rb_keys/commands/status.py +35 -0
- rb_keys-0.2.3/src/rb_keys/core/__init__.py +1 -0
- rb_keys-0.2.3/src/rb_keys/core/data_files.py +20 -0
- rb_keys-0.2.3/src/rb_keys/core/deps.py +165 -0
- rb_keys-0.2.3/src/rb_keys/core/errors.py +215 -0
- rb_keys-0.2.3/src/rb_keys/core/models.py +25 -0
- rb_keys-0.2.3/src/rb_keys/core/normalize.py +117 -0
- rb_keys-0.2.3/src/rb_keys/core/opencli.py +285 -0
- rb_keys-0.2.3/src/rb_keys/core/services.py +82 -0
- rb_keys-0.2.3/src/rb_keys/core/skills.py +64 -0
- rb_keys-0.2.3/src/rb_keys/core/version.py +89 -0
- rb_keys-0.2.3/src/rb_keys/data/SKILL.md +64 -0
- rb_keys-0.2.3/src/rb_keys/data/__init__.py +1 -0
- rb_keys-0.2.3/src/rb_keys/output/__init__.py +279 -0
- rb_keys-0.2.3/src/rb_keys/output/human.py +34 -0
- rb_keys-0.2.3/src/rb_keys/output/json.py +11 -0
- rb_keys-0.2.3/tests/__init__.py +1 -0
- rb_keys-0.2.3/tests/conftest.py +29 -0
- rb_keys-0.2.3/tests/contracts/fixtures.yaml +11 -0
- rb_keys-0.2.3/tests/contracts/schema.json +89 -0
- rb_keys-0.2.3/tests/contracts/tools-catalog/keys.yaml +20 -0
- rb_keys-0.2.3/tests/data/contracts/windmill-serp.yaml +106 -0
- rb_keys-0.2.3/tests/data/opencli.schema.json +350 -0
- rb_keys-0.2.3/tests/help_allowlist.txt +3 -0
- rb_keys-0.2.3/tests/snapshots/describe.json +1044 -0
- rb_keys-0.2.3/tests/snapshots/help/auth-status.txt +26 -0
- rb_keys-0.2.3/tests/snapshots/help/auth.txt +13 -0
- rb_keys-0.2.3/tests/snapshots/help/config-get.txt +16 -0
- rb_keys-0.2.3/tests/snapshots/help/config-list.txt +13 -0
- rb_keys-0.2.3/tests/snapshots/help/config-set.txt +17 -0
- rb_keys-0.2.3/tests/snapshots/help/config.txt +14 -0
- rb_keys-0.2.3/tests/snapshots/help/describe.txt +18 -0
- rb_keys-0.2.3/tests/snapshots/help/doctor.txt +17 -0
- rb_keys-0.2.3/tests/snapshots/help/domain.txt +25 -0
- rb_keys-0.2.3/tests/snapshots/help/init.txt +16 -0
- rb_keys-0.2.3/tests/snapshots/help/query.txt +26 -0
- rb_keys-0.2.3/tests/snapshots/help/skill-install.txt +18 -0
- rb_keys-0.2.3/tests/snapshots/help/skill-list.txt +13 -0
- rb_keys-0.2.3/tests/snapshots/help/skill.txt +13 -0
- rb_keys-0.2.3/tests/snapshots/help/status.txt +14 -0
- rb_keys-0.2.3/tests/snapshots/help/url.txt +28 -0
- rb_keys-0.2.3/tests/test_cli.py +320 -0
- rb_keys-0.2.3/tests/test_contract_runner.py +257 -0
- rb_keys-0.2.3/tests/test_contracts.py +389 -0
- rb_keys-0.2.3/tests/test_deps.py +150 -0
- rb_keys-0.2.3/tests/test_describe.py +181 -0
- rb_keys-0.2.3/tests/test_detach.py +161 -0
- rb_keys-0.2.3/tests/test_docs_install.py +45 -0
- rb_keys-0.2.3/tests/test_help.py +495 -0
- rb_keys-0.2.3/tests/test_keys_cli.py +153 -0
- rb_keys-0.2.3/tests/test_normalize.py +70 -0
- rb_keys-0.2.3/tests/test_project.py +155 -0
- rb_keys-0.2.3/tests/test_scripts.py +82 -0
- rb_keys-0.2.3/tests/test_services.py +50 -0
- rb_keys-0.2.3/tests/test_skills.py +179 -0
- rb_keys-0.2.3/uv.lock +744 -0
- rb_keys-0.2.3/vectors/keys-v1.yaml +70 -0
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
schema = 1
|
|
2
|
+
worktree_root = "~/.antagor/worktrees"
|
|
3
|
+
mode = "fast"
|
|
4
|
+
prefix = "KEYS"
|
|
5
|
+
name = "keys"
|
|
6
|
+
worker = "pi"
|
|
7
|
+
checks = ["python3 scripts/check_command_docstrings.py"]
|
|
8
|
+
heavy = ["gate check"]
|
|
9
|
+
|
|
10
|
+
# the workserver, 48 cores (the Human 28.10: at least four tasks at once); heavy checks queue on the machine
|
|
11
|
+
parallel = 4
|
|
12
|
+
|
|
13
|
+
[review]
|
|
14
|
+
worker = "pi-glm" # another model than the author (the Human, 6.11)
|
|
15
|
+
required_types = ["feature", "bugfix"] # chore and docs: the short path without review
|
|
16
|
+
|
|
17
|
+
[publish]
|
|
18
|
+
versioning = "semver"
|
|
19
|
+
changelog = "CHANGELOG.md"
|
|
20
|
+
deploy_command = "sh scripts/deploy.sh"
|
|
21
|
+
gate = "local"
|
|
22
|
+
gate_command = 'gate check'
|
|
23
|
+
env = { UV_PYTHON = "3.14" }
|
|
24
|
+
|
|
25
|
+
[connector]
|
|
26
|
+
webhook_secret = "PLANE_WEBHOOK_SECRET_TOOLS"
|
|
27
|
+
kind = "plane"
|
|
28
|
+
base_url = "https://homeserver.tailee01ab.ts.net:8443"
|
|
29
|
+
workspace = "tools"
|
|
30
|
+
project_id = "d099147f-9b47-4109-be4e-41b09ba2aa48"
|
|
31
|
+
humans = ["r.bolandau@gmail.com"]
|
|
32
|
+
|
|
33
|
+
[connector.states]
|
|
34
|
+
ideas = "Backlog"
|
|
35
|
+
queue = "Todo"
|
|
36
|
+
in_progress = "In Progress"
|
|
37
|
+
in_review = "In Review"
|
|
38
|
+
publish = "Publishing"
|
|
39
|
+
done = "Done"
|
|
40
|
+
cancelled = "Cancelled"
|
|
41
|
+
|
|
42
|
+
[daemon]
|
|
43
|
+
enabled = true
|
|
44
|
+
|
|
45
|
+
[workers.pi-glm] # the reviewer: kind pi, model from [model_policy.pi-glm]
|
|
46
|
+
kind = "pi"
|
|
47
|
+
args = []
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
state files use «resident» (10.10.2026)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
state files use «task» (09.10.2026)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"hand_fix": {"enabled": true, "max_files": 2, "max_lines": 10, "paths": ["*.md", "*.toml", "*.yaml", "*.yml", ".gitea/", ".github/"]}, "slow_run_minutes": 15, "floor": [], "order": {}, "effort_order": ["low", "medium", "high", "xhigh", "max"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
w26:t1
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
keys
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
w26:p1
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"session": "acc40fa2-8373-4628-8faa-028989d2da3e", "kind": null, "args": []}
|
|
File without changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"pid": null, "pending": false, "last": 1793031211.437669}
|
|
File without changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"last": 1794989952.56229, "failures": 0}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"enabled": true}
|
|
File without changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"seq": 4, "items": [], "targets": {}}
|
|
File without changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"1659723c690b12cf75489aac03a80b48": {"cmd": "the project's CI (https://homeserver.tailee01ab.ts.net:3000/api/v1/repos/bolandeu/keys/commits/11b29192bda5806d829626dec84ac09fa958fc5f/status)", "tree": "9dd8be3febf0361eaf8a087fa0d50d0b"}, "6ab9b0432c36f77a5eecf6f5da17dedf": {"cmd": "the project's CI (https://homeserver.tailee01ab.ts.net:3000/api/v1/repos/bolandeu/keys/commits/663e39f4b83a87ede755f5cc07a4417b512c487e/status)", "tree": "592a8b890deba23024a78694e44319be"}}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
{"ts": "2026-10-22T11:20:30+00:00", "event": "architect.registered", "name": "keys", "pane": "w26:p1"}
|
|
2
|
+
{"ts": "2026-10-22T11:42:37+00:00", "event": "mode.changed", "from": "default", "to": "fast", "actor": "human"}
|
|
3
|
+
{"ts": "2026-10-22T11:42:37+00:00", "event": "notify.sent", "seqs": [1], "lines": 1}
|
|
4
|
+
{"ts": "2026-10-22T11:42:37+00:00", "event": "delivery.queued", "task": "", "kind": "pane", "target": "w26:p1", "mode": "text"}
|
|
5
|
+
{"ts": "2026-10-22T11:42:37+00:00", "event": "delivery.sent", "count": 1, "kind": "pane", "target": "w26:p1", "task": "", "architect": true}
|
|
6
|
+
{"ts": "2026-10-22T11:42:37+00:00", "event": "notify.human_decision", "task": "", "decision": "mode.changed", "line": "[antagor] Человек: режим default -> fast"}
|
|
7
|
+
{"ts": "2026-10-22T11:42:37+00:00", "event": "daemon.enabled_changed", "from": false, "to": true, "actor": "human"}
|
|
8
|
+
{"ts": "2026-10-22T11:42:37+00:00", "event": "daemon.started", "via": "launchd"}
|
|
9
|
+
{"ts": "2026-10-22T11:43:29+00:00", "event": "mode.free_approval", "action": "publish", "tasks": [], "actor": "architect"}
|
|
10
|
+
{"ts": "2026-10-22T11:43:29+00:00", "event": "publish.started", "tasks": [], "pre": "11b29192bda5806d829626dec84ac09fa958fc5f", "actor": "architect", "main": true}
|
|
11
|
+
{"ts": "2026-10-22T11:43:29+00:00", "event": "publish.remote_gate_accepted", "actor": "human", "settings": {"remote": "origin", "branch": "antagor/publish-{commit}", "status_url": "https://homeserver.tailee01ab.ts.net:3000/api/v1/repos/bolandeu/keys/commits/{commit}/status"}, "via": "any_repo"}
|
|
12
|
+
{"ts": "2026-10-22T11:44:00+00:00", "event": "publish.remote_gate", "commit": "11b29192bda5806d829626dec84ac09fa958fc5f", "state": "success", "waited_s": 30, "url": "https://homeserver.tailee01ab.ts.net:3000/api/v1/repos/bolandeu/keys/commits/11b29192bda5806d829626dec84ac09fa958fc5f/status"}
|
|
13
|
+
{"ts": "2026-10-22T11:44:01+00:00", "event": "publish.gated", "tasks": []}
|
|
14
|
+
{"ts": "2026-10-22T11:44:01+00:00", "event": "publish.promoted", "commit": "5ed4ca48f59eb9523d956cce3d6ec540ecee9dba"}
|
|
15
|
+
{"ts": "2026-10-22T11:44:02+00:00", "event": "publish.deployed", "version": "v0.2.0"}
|
|
16
|
+
{"ts": "2026-10-22T11:44:02+00:00", "event": "publish.finished", "version": "v0.2.0", "tasks": []}
|
|
17
|
+
{"ts": "2026-10-22T11:44:02+00:00", "event": "notify.sent", "seqs": [15], "lines": 1}
|
|
18
|
+
{"ts": "2026-10-22T11:44:02+00:00", "event": "delivery.queued", "task": "", "kind": "pane", "target": "w26:p1", "mode": "text"}
|
|
19
|
+
{"ts": "2026-10-22T11:44:39+00:00", "event": "delivery.sent", "count": 1, "kind": "pane", "target": "w26:p1", "task": "", "architect": true}
|
|
20
|
+
{"ts": "2026-10-22T18:17:28+00:00", "event": "daemon.reexec", "reason": "code changed", "antagor": "main@34cb253"}
|
|
21
|
+
{"ts": "2026-10-22T19:09:10+00:00", "event": "machine.slept", "from": "2026-10-22T18:18:44+00:00", "to": "2026-10-22T19:09:10+00:00", "minutes": 50.4}
|
|
22
|
+
{"ts": "2026-10-22T19:59:11+00:00", "event": "machine.slept", "from": "2026-10-22T19:10:30+00:00", "to": "2026-10-22T19:59:11+00:00", "minutes": 48.7}
|
|
23
|
+
{"ts": "2026-10-22T20:19:22+00:00", "event": "machine.slept", "from": "2026-10-22T20:00:29+00:00", "to": "2026-10-22T20:19:22+00:00", "minutes": 18.9}
|
|
24
|
+
{"ts": "2026-10-22T21:19:39+00:00", "event": "machine.slept", "from": "2026-10-22T20:20:39+00:00", "to": "2026-10-22T21:19:39+00:00", "minutes": 59.0}
|
|
25
|
+
{"ts": "2026-10-22T21:53:39+00:00", "event": "machine.slept", "from": "2026-10-22T21:20:56+00:00", "to": "2026-10-22T21:53:39+00:00", "minutes": 32.7}
|
|
26
|
+
{"ts": "2026-10-22T22:43:41+00:00", "event": "machine.slept", "from": "2026-10-22T21:54:55+00:00", "to": "2026-10-22T22:43:41+00:00", "minutes": 48.8}
|
|
27
|
+
{"ts": "2026-10-22T23:32:01+00:00", "event": "machine.slept", "from": "2026-10-22T22:44:58+00:00", "to": "2026-10-22T23:32:01+00:00", "minutes": 47.1}
|
|
28
|
+
{"ts": "2026-10-23T00:22:34+00:00", "event": "machine.slept", "from": "2026-10-22T23:33:19+00:00", "to": "2026-10-23T00:22:34+00:00", "minutes": 49.2}
|
|
29
|
+
{"ts": "2026-10-23T01:09:11+00:00", "event": "machine.slept", "from": "2026-10-23T00:23:51+00:00", "to": "2026-10-23T01:09:11+00:00", "minutes": 45.3}
|
|
30
|
+
{"ts": "2026-10-23T01:51:46+00:00", "event": "machine.slept", "from": "2026-10-23T01:10:30+00:00", "to": "2026-10-23T01:51:46+00:00", "minutes": 41.3}
|
|
31
|
+
{"ts": "2026-10-23T02:23:41+00:00", "event": "machine.slept", "from": "2026-10-23T01:53:03+00:00", "to": "2026-10-23T02:23:41+00:00", "minutes": 30.6}
|
|
32
|
+
{"ts": "2026-10-23T03:10:02+00:00", "event": "machine.slept", "from": "2026-10-23T02:25:00+00:00", "to": "2026-10-23T03:10:02+00:00", "minutes": 45.0}
|
|
33
|
+
{"ts": "2026-10-23T03:42:02+00:00", "event": "machine.slept", "from": "2026-10-23T03:11:18+00:00", "to": "2026-10-23T03:42:02+00:00", "minutes": 30.7}
|
|
34
|
+
{"ts": "2026-10-23T04:03:07+00:00", "event": "machine.slept", "from": "2026-10-23T03:43:19+00:00", "to": "2026-10-23T04:03:07+00:00", "minutes": 19.8}
|
|
35
|
+
{"ts": "2026-10-23T04:12:55+00:00", "event": "machine.slept", "from": "2026-10-23T04:04:25+00:00", "to": "2026-10-23T04:12:55+00:00", "minutes": 8.5}
|
|
36
|
+
{"ts": "2026-10-23T04:30:44+00:00", "event": "machine.slept", "from": "2026-10-23T04:14:13+00:00", "to": "2026-10-23T04:30:44+00:00", "minutes": 16.5}
|
|
37
|
+
{"ts": "2026-10-23T05:12:01+00:00", "event": "machine.slept", "from": "2026-10-23T04:55:53+00:00", "to": "2026-10-23T05:12:01+00:00", "minutes": 16.1}
|
|
38
|
+
{"ts": "2026-10-23T06:02:53+00:00", "event": "machine.slept", "from": "2026-10-23T05:13:19+00:00", "to": "2026-10-23T06:02:53+00:00", "minutes": 49.6}
|
|
39
|
+
{"ts": "2026-10-23T06:46:13+00:00", "event": "machine.slept", "from": "2026-10-23T06:04:11+00:00", "to": "2026-10-23T06:46:13+00:00", "minutes": 42.0}
|
|
40
|
+
{"ts": "2026-10-23T07:12:55+00:00", "event": "machine.slept", "from": "2026-10-23T06:47:30+00:00", "to": "2026-10-23T07:12:55+00:00", "minutes": 25.4}
|
|
41
|
+
{"ts": "2026-10-23T07:57:39+00:00", "event": "machine.slept", "from": "2026-10-23T07:14:11+00:00", "to": "2026-10-23T07:57:39+00:00", "minutes": 43.5}
|
|
42
|
+
{"ts": "2026-10-23T08:16:48+00:00", "event": "machine.slept", "from": "2026-10-23T08:00:12+00:00", "to": "2026-10-23T08:16:48+00:00", "minutes": 16.6}
|
|
43
|
+
{"ts": "2026-10-23T08:36:47+00:00", "event": "machine.slept", "from": "2026-10-23T08:19:22+00:00", "to": "2026-10-23T08:36:47+00:00", "minutes": 17.4}
|
|
44
|
+
{"ts": "2026-10-23T08:54:50+00:00", "event": "machine.slept", "from": "2026-10-23T08:38:04+00:00", "to": "2026-10-23T08:54:50+00:00", "minutes": 16.8}
|
|
45
|
+
{"ts": "2026-10-23T09:14:47+00:00", "event": "machine.slept", "from": "2026-10-23T08:56:08+00:00", "to": "2026-10-23T09:14:47+00:00", "minutes": 18.7}
|
|
46
|
+
{"ts": "2026-10-23T09:59:52+00:00", "event": "machine.slept", "from": "2026-10-23T09:16:05+00:00", "to": "2026-10-23T09:59:52+00:00", "minutes": 43.8}
|
|
47
|
+
{"ts": "2026-10-23T10:23:25+00:00", "event": "machine.slept", "from": "2026-10-23T10:01:09+00:00", "to": "2026-10-23T10:23:25+00:00", "minutes": 22.3}
|
|
48
|
+
{"ts": "2026-10-23T11:00:59+00:00", "event": "machine.slept", "from": "2026-10-23T10:24:41+00:00", "to": "2026-10-23T11:00:59+00:00", "minutes": 36.3}
|
|
49
|
+
{"ts": "2026-10-23T11:19:42+00:00", "event": "machine.slept", "from": "2026-10-23T11:02:16+00:00", "to": "2026-10-23T11:19:42+00:00", "minutes": 17.4}
|
|
50
|
+
{"ts": "2026-10-23T11:37:37+00:00", "event": "machine.slept", "from": "2026-10-23T11:20:59+00:00", "to": "2026-10-23T11:37:37+00:00", "minutes": 16.6}
|
|
51
|
+
{"ts": "2026-10-23T12:19:07+00:00", "event": "machine.slept", "from": "2026-10-23T11:38:54+00:00", "to": "2026-10-23T12:19:07+00:00", "minutes": 40.2}
|
|
52
|
+
{"ts": "2026-10-23T12:54:05+00:00", "event": "machine.slept", "from": "2026-10-23T12:20:24+00:00", "to": "2026-10-23T12:54:05+00:00", "minutes": 33.7}
|
|
53
|
+
{"ts": "2026-10-23T13:19:06+00:00", "event": "machine.slept", "from": "2026-10-23T12:56:38+00:00", "to": "2026-10-23T13:19:06+00:00", "minutes": 22.5}
|
|
54
|
+
{"ts": "2026-10-23T13:37:20+00:00", "event": "machine.slept", "from": "2026-10-23T13:21:40+00:00", "to": "2026-10-23T13:37:20+00:00", "minutes": 15.7}
|
|
55
|
+
{"ts": "2026-10-23T13:56:48+00:00", "event": "machine.slept", "from": "2026-10-23T13:39:54+00:00", "to": "2026-10-23T13:56:48+00:00", "minutes": 16.9}
|
|
56
|
+
{"ts": "2026-10-23T14:03:36+00:00", "event": "machine.slept", "from": "2026-10-23T13:58:05+00:00", "to": "2026-10-23T14:03:36+00:00", "minutes": 5.5}
|
|
57
|
+
{"ts": "2026-10-23T14:22:53+00:00", "event": "machine.slept", "from": "2026-10-23T14:06:10+00:00", "to": "2026-10-23T14:22:53+00:00", "minutes": 16.7}
|
|
58
|
+
{"ts": "2026-10-23T14:40:35+00:00", "event": "machine.slept", "from": "2026-10-23T14:25:26+00:00", "to": "2026-10-23T14:40:35+00:00", "minutes": 15.1}
|
|
59
|
+
{"ts": "2026-10-23T14:49:27+00:00", "event": "machine.slept", "from": "2026-10-23T14:41:52+00:00", "to": "2026-10-23T14:49:27+00:00", "minutes": 7.6}
|
|
60
|
+
{"ts": "2026-10-23T14:49:57+00:00", "event": "connector.unhealthy", "lines": ["plane: синхронизировано 519 с назад", "plane: сбои подряд: 1, последняя ошибка Plane is unreachable: <urlopen error timed out>"]}
|
|
61
|
+
{"ts": "2026-10-23T14:49:57+00:00", "event": "notify.sent", "seqs": [59], "lines": 1}
|
|
62
|
+
{"ts": "2026-10-23T14:49:57+00:00", "event": "delivery.queued", "task": "", "kind": "pane", "target": "w26:p1", "mode": "text"}
|
|
63
|
+
{"ts": "2026-10-23T14:49:57+00:00", "event": "delivery.sent", "count": 1, "kind": "pane", "target": "w26:p1", "task": "", "architect": true}
|
|
64
|
+
{"ts": "2026-10-23T14:49:57+00:00", "event": "connector.sync_failed", "error": "Plane is unreachable: <urlopen error timed out>", "failures": 1}
|
|
65
|
+
{"ts": "2026-10-23T14:50:36+00:00", "event": "connector.healthy", "lines": ["plane: синхронизировано 0 с назад"]}
|
|
66
|
+
{"ts": "2026-10-23T14:50:36+00:00", "event": "notify.sent", "seqs": [64], "lines": 1}
|
|
67
|
+
{"ts": "2026-10-23T14:50:36+00:00", "event": "delivery.queued", "task": "", "kind": "pane", "target": "w26:p1", "mode": "text"}
|
|
68
|
+
{"ts": "2026-10-23T14:50:36+00:00", "event": "delivery.sent", "count": 1, "kind": "pane", "target": "w26:p1", "task": "", "architect": true}
|
|
69
|
+
{"ts": "2026-10-23T15:00:19+00:00", "event": "daemon.stopped", "reason": "architect_closed", "pid": 6062}
|
|
70
|
+
{"ts": "2026-10-26T16:13:27+00:00", "event": "mode.free_approval", "action": "publish", "tasks": [], "actor": "architect"}
|
|
71
|
+
{"ts": "2026-10-26T16:13:27+00:00", "event": "publish.started", "tasks": [], "pre": "663e39f4b83a87ede755f5cc07a4417b512c487e", "actor": "architect", "main": true}
|
|
72
|
+
{"ts": "2026-10-26T16:13:28+00:00", "event": "publish.remote_gate", "commit": "663e39f4b83a87ede755f5cc07a4417b512c487e", "state": "success", "waited_s": 0, "url": "https://homeserver.tailee01ab.ts.net:3000/api/v1/repos/bolandeu/keys/commits/663e39f4b83a87ede755f5cc07a4417b512c487e/status"}
|
|
73
|
+
{"ts": "2026-10-26T16:13:29+00:00", "event": "publish.gated", "tasks": []}
|
|
74
|
+
{"ts": "2026-10-26T16:13:30+00:00", "event": "publish.promoted", "commit": "ed0fa3464a99350bbbd7dc3f3634e914034b7faf"}
|
|
75
|
+
{"ts": "2026-10-26T16:13:30+00:00", "event": "publish.deployed", "version": "v0.2.1"}
|
|
76
|
+
{"ts": "2026-10-26T16:13:30+00:00", "event": "publish.finished", "version": "v0.2.1", "tasks": []}
|
|
77
|
+
{"ts": "2026-10-26T16:13:30+00:00", "event": "notify.skipped", "reason": "pane closed", "seqs": [75]}
|
|
78
|
+
{"ts": "2026-10-27T05:02:02+00:00", "event": "connector.unhealthy", "lines": ["plane: синхронизировано 46111 с назад", "plane: сбои подряд: 1, последняя ошибка Plane is unreachable: <urlopen error [Errno 51] Network is unreachable>"]}
|
|
79
|
+
{"ts": "2026-10-27T05:02:03+00:00", "event": "notify.skipped", "reason": "pane closed", "seqs": [77]}
|
|
80
|
+
{"ts": "2026-10-27T05:02:03+00:00", "event": "connector.sync_failed", "error": "Plane is unreachable: <urlopen error [Errno 51] Network is unreachable>", "failures": 1}
|
|
81
|
+
{"ts": "2026-10-27T05:03:31+00:00", "event": "connector.sync_failed", "error": "Plane is unreachable: <urlopen error timed out>", "failures": 2}
|
|
82
|
+
{"ts": "2026-10-27T05:04:19+00:00", "event": "connector.sync_failed", "error": "Plane is unreachable: <urlopen error [SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1082)>", "failures": 3}
|
|
83
|
+
{"ts": "2026-10-27T05:05:28+00:00", "event": "connector.sync_failed", "error": "Plane is unreachable: <urlopen error [SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1082)>", "failures": 4}
|
|
84
|
+
{"ts": "2026-10-27T05:06:36+00:00", "event": "connector.sync_failed", "error": "Plane is unreachable: <urlopen error [SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1082)>", "failures": 5}
|
|
85
|
+
{"ts": "2026-10-27T05:07:48+00:00", "event": "connector.sync_failed", "error": "Plane is unreachable: <urlopen error [SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1082)>", "failures": 6}
|
|
86
|
+
{"ts": "2026-10-27T05:08:58+00:00", "event": "connector.healthy", "lines": ["plane: синхронизировано 0 с назад"]}
|
|
87
|
+
{"ts": "2026-10-27T05:08:58+00:00", "event": "notify.skipped", "reason": "pane closed", "seqs": [85]}
|
|
88
|
+
{"ts": "2026-10-27T05:12:09+00:00", "event": "daemon.stopped", "reason": "no_architect", "pid": 1167}
|
|
89
|
+
{"ts": "2026-10-28T10:54:23+00:00", "event": "daemon.stopped", "pid": null, "unit_removed": false, "still_running": false}
|
|
90
|
+
{"ts": "2026-11-06T19:28:31+00:00", "event": "daemon.stopped", "reason": "no_architect", "pid": 1415}
|
|
91
|
+
{"ts": "2026-11-17T16:48:19+00:00", "event": "daemon.stopped", "pid": null, "unit_removed": false, "still_running": false}
|
|
92
|
+
{"ts": "2026-11-17T16:48:22+00:00", "event": "daemon.started", "via": "launchd"}
|
|
93
|
+
{"ts": "2026-11-17T16:58:37+00:00", "event": "daemon.stopped", "reason": "no_architect", "pid": 31184}
|
|
94
|
+
{"ts": "2026-11-18T08:20:19+00:00", "event": "daemon.stopped", "reason": "no_architect", "pid": 1395}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"mode": "fast"}
|
|
File without changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
94
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"https://homeserver.tailee01ab.ts.net:8443|93c50d52-b018-4278-9539-15a0393ce645|states": {"at": 1792668030.99348, "value": {"Backlog": "61d6ce84-d319-4e16-9679-0bc4394111ad", "Todo": "333184ec-a638-4da2-9c21-25811fa26cf6", "In Progress": "db62066c-95b6-4eb5-84af-a7edba809bbb", "Done": "223c31c0-2e5d-4a22-9ea6-f374a55db432", "Cancelled": "b5f8a41a-90b8-4806-aaaa-acf1c210bdaa"}}, "https://homeserver.tailee01ab.ts.net:8443|93c50d52-b018-4278-9539-15a0393ce645|members": {"at": 1792668031.357353, "value": {"9163bb43-bd16-4a5b-aad2-c77aa645fa7a": "antagor@homeserver.local", "5d7d3c34-f092-4a1a-ab76-83d459e2e055": "r.bolandau@gmail.com"}}, "https://homeserver.tailee01ab.ts.net:8443|d099147f-9b47-4109-be4e-41b09ba2aa48|states": {"at": 1792669354.8911822, "value": {"Backlog": "cdffc66d-ffa3-411b-bc3e-de8bcbf773eb", "Todo": "e28ea74f-f680-4f20-9368-84b5e7637518", "In Progress": "fb6bcfbd-15ab-45bd-bd0b-bb632f808737", "Done": "33a2d20f-a03b-43a7-a72d-d75e474bdb42", "Cancelled": "6c63d14c-8fca-48ca-be01-3a7e33477387"}}, "https://homeserver.tailee01ab.ts.net:8443|d099147f-9b47-4109-be4e-41b09ba2aa48|members": {"at": 1792669377.492494, "value": {"9163bb43-bd16-4a5b-aad2-c77aa645fa7a": "antagor@homeserver.local", "33b1ce81-2dbc-47c5-b43d-847001a8b82d": "bot_user_48f648c7-f1a0-4365-a69c-e4209768884e@homeserver.tailee01ab.ts.net", "5d7d3c34-f092-4a1a-ab76-83d459e2e055": "r.bolandau@gmail.com"}}}
|
|
File without changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"ts": 1793184863.0048199, "doubtful": []}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
{
|
|
2
|
+
"model": "opus",
|
|
3
|
+
"effortLevel": "xhigh",
|
|
4
|
+
"env": {
|
|
5
|
+
"ANTAGOR_ROLE": "architect"
|
|
6
|
+
},
|
|
7
|
+
"permissions": {
|
|
8
|
+
"allow": [
|
|
9
|
+
"Bash(antagor status:*)",
|
|
10
|
+
"Bash(antagor next:*)",
|
|
11
|
+
"Bash(antagor board:*)",
|
|
12
|
+
"Bash(antagor task-create:*)",
|
|
13
|
+
"Bash(antagor task-update:*)",
|
|
14
|
+
"Bash(antagor models:*)",
|
|
15
|
+
"Bash(antagor run:*)",
|
|
16
|
+
"Bash(antagor accept:*)",
|
|
17
|
+
"Bash(antagor review-reject:*)",
|
|
18
|
+
"Bash(antagor review-queue:*)",
|
|
19
|
+
"Bash(antagor unblock:*)",
|
|
20
|
+
"Bash(antagor inbox:*)",
|
|
21
|
+
"Bash(antagor epic:*)",
|
|
22
|
+
"Bash(antagor idea:*)",
|
|
23
|
+
"Bash(antagor spec-check:*)",
|
|
24
|
+
"Bash(antagor validate:*)",
|
|
25
|
+
"Bash(antagor recover:*)",
|
|
26
|
+
"Bash(antagor gc:*)",
|
|
27
|
+
"Bash(antagor handoff:*)",
|
|
28
|
+
"Bash(antagor memory-check:*)",
|
|
29
|
+
"Bash(antagor journal:*)",
|
|
30
|
+
"Bash(antagor events:*)",
|
|
31
|
+
"Bash(antagor metrics:*)",
|
|
32
|
+
"Bash(antagor tools list:*)",
|
|
33
|
+
"Bash(antagor mode)",
|
|
34
|
+
"Bash(antagor architect:*)",
|
|
35
|
+
"Bash(antagor notify:*)",
|
|
36
|
+
"Bash(antagor autocommit:*)",
|
|
37
|
+
"Bash(herdr agent start:*)",
|
|
38
|
+
"Bash(herdr agent prompt:*)",
|
|
39
|
+
"Bash(herdr agent get:*)",
|
|
40
|
+
"Bash(herdr agent read:*)",
|
|
41
|
+
"Bash(herdr agent list:*)",
|
|
42
|
+
"Bash(herdr agent wait:*)",
|
|
43
|
+
"Bash(herdr tab create:*)",
|
|
44
|
+
"Bash(herdr tab list:*)",
|
|
45
|
+
"Bash(herdr pane get:*)",
|
|
46
|
+
"Bash(herdr pane read:*)",
|
|
47
|
+
"Bash(herdr pane list:*)",
|
|
48
|
+
"Bash(herdr workspace list:*)",
|
|
49
|
+
"Bash(git status:*)",
|
|
50
|
+
"Bash(git diff:*)",
|
|
51
|
+
"Bash(git log:*)",
|
|
52
|
+
"Bash(git show:*)",
|
|
53
|
+
"Bash(git add:*)",
|
|
54
|
+
"Bash(git commit:*)",
|
|
55
|
+
"Bash(git merge:*)",
|
|
56
|
+
"Bash(git branch:*)",
|
|
57
|
+
"Bash(git worktree:*)",
|
|
58
|
+
"Bash(uv run pytest:*)",
|
|
59
|
+
"Bash(uv run antagor:*)",
|
|
60
|
+
"Bash(antagor publish:*)"
|
|
61
|
+
],
|
|
62
|
+
"ask": [
|
|
63
|
+
"Bash(git push:*)",
|
|
64
|
+
"Bash(herdr tab close:*)",
|
|
65
|
+
"Bash(herdr agent send-keys:*)"
|
|
66
|
+
],
|
|
67
|
+
"deny": [
|
|
68
|
+
"Bash(antagor auth:*)",
|
|
69
|
+
"Bash(antagor secret:*)",
|
|
70
|
+
"Bash(antagor mode set:*)",
|
|
71
|
+
"Bash(antagor adopt:*)",
|
|
72
|
+
"Bash(git push --force:*)",
|
|
73
|
+
"Bash(git push -f:*)",
|
|
74
|
+
"Bash(git commit --amend:*)",
|
|
75
|
+
"Bash(git reset --hard:*)",
|
|
76
|
+
"Bash(herdr server stop:*)"
|
|
77
|
+
],
|
|
78
|
+
"defaultMode": "auto"
|
|
79
|
+
},
|
|
80
|
+
"hooks": {
|
|
81
|
+
"SessionStart": [
|
|
82
|
+
{
|
|
83
|
+
"hooks": [
|
|
84
|
+
{
|
|
85
|
+
"type": "command",
|
|
86
|
+
"command": "antagor architect report-model"
|
|
87
|
+
}
|
|
88
|
+
]
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"hooks": [
|
|
92
|
+
{
|
|
93
|
+
"type": "command",
|
|
94
|
+
"command": "antagor -C \"$CLAUDE_PROJECT_DIR\" news --hook 2>/dev/null || true",
|
|
95
|
+
"timeout": 10
|
|
96
|
+
}
|
|
97
|
+
]
|
|
98
|
+
}
|
|
99
|
+
],
|
|
100
|
+
"PostModelSwitch": [
|
|
101
|
+
{
|
|
102
|
+
"hooks": [
|
|
103
|
+
{
|
|
104
|
+
"type": "command",
|
|
105
|
+
"command": "antagor architect report-model"
|
|
106
|
+
}
|
|
107
|
+
]
|
|
108
|
+
}
|
|
109
|
+
],
|
|
110
|
+
"PreToolUse": [
|
|
111
|
+
{
|
|
112
|
+
"matcher": "Bash",
|
|
113
|
+
"hooks": [
|
|
114
|
+
{
|
|
115
|
+
"type": "command",
|
|
116
|
+
"command": "test -e \"$CLAUDE_PROJECT_DIR/.agents/antagor/state/audit_open\" && antagor -C \"$CLAUDE_PROJECT_DIR\" architect bash-hook 2>/dev/null || true",
|
|
117
|
+
"timeout": 10
|
|
118
|
+
}
|
|
119
|
+
]
|
|
120
|
+
}
|
|
121
|
+
]
|
|
122
|
+
}
|
|
123
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
|
|
2
|
+
_commit: v1.27.3
|
|
3
|
+
_src_path: https://homeserver.tailee01ab.ts.net:3000/bolandeu/cli-generator.git
|
|
4
|
+
antagor_name: keys
|
|
5
|
+
antagor_prefix: KEYS
|
|
6
|
+
author_name: Roman Bolandau
|
|
7
|
+
cli_name: keys
|
|
8
|
+
description: Shared normalization keys (query, domain, URL) for linking records across
|
|
9
|
+
tools
|
|
10
|
+
dist_name: rb-keys
|
|
11
|
+
dist_name_legacy: ''
|
|
12
|
+
include_auth: false
|
|
13
|
+
include_contracts: true
|
|
14
|
+
include_db: false
|
|
15
|
+
include_describe: true
|
|
16
|
+
include_project: true
|
|
17
|
+
include_providers: false
|
|
18
|
+
include_skill: true
|
|
19
|
+
install_homeserver_users: rbtools
|
|
20
|
+
install_mac: true
|
|
21
|
+
package_name: rb_keys
|
|
22
|
+
project_name: rb-keys
|
|
23
|
+
repository_url: https://homeserver.tailee01ab.ts.net:3000/bolandeu/keys
|
rb_keys-0.2.3/.gitignore
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
__pycache__/
|
|
2
|
+
*.py[cod]
|
|
3
|
+
.venv/
|
|
4
|
+
.pytest_cache/
|
|
5
|
+
.ruff_cache/
|
|
6
|
+
dist/
|
|
7
|
+
*.egg-info/
|
|
8
|
+
.python-version
|
|
9
|
+
.coverage
|
|
10
|
+
htmlcov/
|
|
11
|
+
# mutmut's working copy and results (uv run --group mutation mutmut run)
|
|
12
|
+
mutants/
|
|
13
|
+
# Local env files hold keys: keys never go into the repo (the gate's secret scan)
|
|
14
|
+
.env
|
|
15
|
+
.env.*
|
|
16
|
+
# The root lines Antagor adds
|
|
17
|
+
.DS_Store
|
|
18
|
+
Thumbs.db
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Secret scan config, read by `gitleaks` from the repo root (release gate, the Standard, Credentials).
|
|
2
|
+
# The default rules stay on. The allowlist holds only fake test values, one exact string each:
|
|
3
|
+
# never a path, a rule id or a broad pattern. A real key is a leak — revoke it, never list it here.
|
|
4
|
+
[extend]
|
|
5
|
+
useDefault = true
|
|
6
|
+
|
|
7
|
+
[[allowlists]]
|
|
8
|
+
description = "fake test values (tests/test_auth.py; templates up to v1.20.1 committed them without gitleaks:allow)"
|
|
9
|
+
regexes = [
|
|
10
|
+
'''^good-secret-123$''',
|
|
11
|
+
'''^bad-secret-456$''',
|
|
12
|
+
]
|
rb_keys-0.2.3/AGENTS.md
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# AGENTS.md
|
|
2
|
+
|
|
3
|
+
Pointers for agents. Antagor shows the changing state (statuses, branches, tasks): `antagor board`.
|
|
4
|
+
|
|
5
|
+
- What the project is, and the domain glossary: `CONTEXT.md`. Take terms only from there.
|
|
6
|
+
- Decisions and why: `docs/adr/` (format: `docs/adr/README.md`).
|
|
7
|
+
- Code rules for review: `CODING_STANDARDS.md`.
|
|
8
|
+
- Antagor keeps the tasks and epics: `.agents/antagor/`.
|
|
9
|
+
- How to write to the Human and to agents (ASD-STE100): the skill `antagor-method`, section «How to write to the Human and to agents».
|
|
10
|
+
- The package Standard: https://homeserver.tailee01ab.ts.net:3000/bolandeu/cli-generator/src/branch/main/skills/cli-builder/reference/standard.md (sections by name, for example «Install»).
|
|
11
|
+
- The gate before a commit: `gate check`, on this machine — the command is `[publish] gate_command` in `.agents/antagor/antagor.toml` (Standard, CI). It is the only gate: no workflow runs it.
|
|
12
|
+
|
|
13
|
+
## Keys contract (vectors)
|
|
14
|
+
|
|
15
|
+
This package is the one normalization every tool (and `directus`) links records by
|
|
16
|
+
(`~/Work/dev/docs/contracts/tools.md`, "Нормализация общих ключей").
|
|
17
|
+
|
|
18
|
+
- **The contract is `vectors/keys-v<N>.yaml`** (input → key or error), public for consumers:
|
|
19
|
+
they run it against their own code; `tests/test_normalize.py` runs the latest file in the gate
|
|
20
|
+
and requires `KEYS_VERSION == N`.
|
|
21
|
+
- **A new case goes into the vectors first** (red), then the code.
|
|
22
|
+
- **A changed rule is a new version, never an edit of a released one:** `keys-v2.yaml` +
|
|
23
|
+
`KEYS_VERSION = 2` + a breaking release, with a plan for recomputing stored keys
|
|
24
|
+
(consumers' `<tool>_v2_*` views). `keys-v1.yaml` stays as it is.
|
|
25
|
+
- `norm_url`/`norm_domain` are a thin layer over `w3lib.url.canonicalize_url` (the only runtime
|
|
26
|
+
dependency of the library — chosen by dev over url-normalize and courlan); don't reimplement
|
|
27
|
+
what it already does.
|
|
28
|
+
- `norm_phrase` is an alias of `norm_query` for the transition from the template's name.
|
|
29
|
+
- The template's placeholder `run` command was removed on purpose (the commands are
|
|
30
|
+
`query|domain|url`); if a `copier update` brings `commands/run.py` back, delete it again.
|
|
31
|
+
|
|
32
|
+
## Architect only
|
|
33
|
+
|
|
34
|
+
A worker does not need this section: Antagor cuts it from the worker's brief.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project are documented here. Versions follow
|
|
4
|
+
[SemVer](https://semver.org/) (while at `0.x`, a minor bump may break).
|
|
5
|
+
|
|
6
|
+
The changelog is written by `antagor publish`; don't edit it by hand.
|
|
7
|
+
|
|
8
|
+
## v0.2.1 — 2026-10-26
|
|
9
|
+
|
|
10
|
+
### Main
|
|
11
|
+
|
|
12
|
+
- Merge pull request #1: template v1.27.3 (Renovate)
|
|
13
|
+
- chore(template): Update dependency https://homeserver.tailee01ab.ts.net:3000/bolandeu/cli-generator.git to v1.27.3
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
## v0.2.0 — 2026-10-22
|
|
17
|
+
|
|
18
|
+
### Main
|
|
19
|
+
|
|
20
|
+
- antagor init: project keys (KEYS)
|
|
21
|
+
- antagor init: project keys (KEYS)
|
|
22
|
+
- Template v1.27.1: Gitea CI, Antagor files, rb.install; drop towncrier, githooks, release.py, .github
|
|
23
|
+
- chore: point copier at Gitea
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
## [0.1.1] - 2026-10-21
|
|
27
|
+
|
|
28
|
+
### Added
|
|
29
|
+
|
|
30
|
+
- `keys query|domain|url` take many values in one call: several arguments and/or `--input FILE` (`-` = stdin); `--json` returns `count` and `results`.
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
## [0.1.0] - 2026-10-02
|
|
34
|
+
|
|
35
|
+
### Added
|
|
36
|
+
|
|
37
|
+
- rb-keys v1: the shared keys library (`norm_query`, `norm_domain`, `norm_url`, `norm_phrase` as an alias of `norm_query`, `KEYS_VERSION = 1`) on top of `w3lib.url.canonicalize_url`, the contract `vectors/keys-v1.yaml`, and `keys query|domain|url VALUE [--json]` for consumers not written in Python. The template's placeholder `run` command is removed.
|
rb_keys-0.2.3/CLAUDE.md
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# Правила кода
|
|
2
|
+
|
|
3
|
+
Читает ревьюер, а не исполнитель. Механическое правило (запрещённый API, форма импорта, место файла) —
|
|
4
|
+
это проверка в линтере или `checks`, а не строка здесь. Здесь только то, что требует суждения.
|
|
5
|
+
|
|
6
|
+
## Гейт и тесты
|
|
7
|
+
|
|
8
|
+
- **Гейт проходит перед каждым коммитом.** Гейт — `gate check`, он идёт на этой машине: команда — `[publish] gate_command` в `.agents/antagor/antagor.toml`, её и запускают перед коммитом.
|
|
9
|
+
pytest (порог покрытия, контракт `--help` и снапшоты, форма `auth status`), контракты потребителей
|
|
10
|
+
(`tests/contracts/`), список изменённых существующих тестов, сборка wheel и `keys --version` из неё,
|
|
11
|
+
обязательные правила Стандарта. Упавший шаг чинят, а не пропускают. CI гоняет ровно это.
|
|
12
|
+
- **TDD.** Каждое изменение поведения идёт с тестом, который без него падает; красный прогон — в отчёте
|
|
13
|
+
исполнителя.
|
|
14
|
+
- **Тест не подгоняют под код.** Существующий тест меняется, только когда изменилось требование. Шаг гейта
|
|
15
|
+
`existing tests` перечисляет тесты прошлого релиза, которые изменены или удалены; каждый идёт в отчёт с причиной.
|
|
16
|
+
- **Планку ставят другие.** Приёмку пишет dev с пользователем, контракты (`--json`, exit-коды, представления `v1`) —
|
|
17
|
+
потребитель: `tests/contracts/<consumer>/<tool>.yaml` (Стандарт cli-generator, раздел «Consumer contracts»). Свои — unit-тесты и офлайн-данные для `run`-кейсов потребителей (`tests/contracts/fixtures.yaml`).
|
|
18
|
+
Контракт потребителя не правят, чтобы пройти.
|
|
19
|
+
- **Мутационное тестирование — время от времени и перед крупным релизом** (не в гейте):
|
|
20
|
+
`uv run --group mutation mutmut run`, затем `mutmut results`. Выживший мутант — строка, которую ни один тест
|
|
21
|
+
по-настоящему не проверяет.
|
|
22
|
+
- **Долгая команда — только отвязанной.** Гейт, долгий запуск `keys`:
|
|
23
|
+
`scripts/run_detached.sh <label> <command...>`, затем `scripts/runs_status.sh <label>`. В своей оболочке агента
|
|
24
|
+
она умирает вместе с ходом (прерывание — например, входящее сообщение herdr), и работу делают заново.
|
|
25
|
+
|
|
26
|
+
## Устройство (не нарушать)
|
|
27
|
+
|
|
28
|
+
- **Команда тонкая.** `commands/` — только разбор аргументов; вся логика — в `core/`.
|
|
29
|
+
- **Секреты — только переменные окружения**, никогда в аргументах,
|
|
30
|
+
в репозитории или в файле проекта.
|
|
31
|
+
- **Вывод — через `output/`.** Каждая команда умеет human и `--json` (`output.emit_success` / `output.guard`),
|
|
32
|
+
`print()` ruff не пропускает (T20). stdout — только данные; ошибки, `--verbose` и `logging` — в stderr. Группа команд —
|
|
33
|
+
`output.group("...")`, не `typer.Typer(...)`: так `keys <group>` без подкоманды печатает help.
|
|
34
|
+
- **Ошибки — `CliError` со стабильным `code`** и фиксированной таблицей exit-кодов (`core/errors.py`), не голые
|
|
35
|
+
исключения.
|
|
36
|
+
- **Необратимое действие снаружи — с `--dry-run`** (`output.is_dry_run`) и за `output.require_confirmation`.
|
|
37
|
+
Команды только над локальными файлами проекта (`init`, `config set`) этого не требуют.
|
|
38
|
+
|
|
39
|
+
## Контракт `--help`
|
|
40
|
+
|
|
41
|
+
- **Докстринг команды — её API.** Агенты узнают команды из голого `keys` / `--help`. Изменилось
|
|
42
|
+
поведение команды — меняется её докстринг в том же коммите: строка-резюме, необязательный абзац и строка
|
|
43
|
+
`Example: {cli} <command> ...` (`output.guard` подставляет `keys`); у каждого `typer.Option`/`Argument`
|
|
44
|
+
есть `help=`.
|
|
45
|
+
- **Дифф снапшотов — видимое изменение.** После правки: `uv run pytest --snapshot-update` и прочитать дифф
|
|
46
|
+
`tests/snapshots/help/` и `tests/snapshots/describe.json` (`describe --json` — машинный контракт для каталога
|
|
47
|
+
инструментов и платформы).
|
|
48
|
+
- **`src/rb_keys/data/SKILL.md` не перечисляет команды**, только соглашения. Его меняют, только когда
|
|
49
|
+
меняется соглашение (новый exit-код, новое правило про ключи).
|
|
50
|
+
|
|
51
|
+
## Версии и релизы
|
|
52
|
+
|
|
53
|
+
- **Версия — git-тег.** В `pyproject.toml` нет `version =` (uv-dynamic-versioning читает последний тег `vX.Y.Z`);
|
|
54
|
+
строку версии нигде не зашивают.
|
|
55
|
+
- **Релиз — только через Antagor.** Руками не пушат, не ставят теги и не правят `CHANGELOG.md`;
|
|
56
|
+
force-push и `commit --amend` — никогда.
|
|
57
|
+
- **Заметное изменение выходит релизом.** Серверы, другие инструменты и Mac ставят только по тегам, не с `main`.
|
|
58
|
+
Не оставлять влитое без релиза, не назвав причину. Проект может требовать версию через `[cli] min_version`
|
|
59
|
+
в своём конфиге — нужное ему изменение сначала выходит релизом.
|
|
60
|
+
- **SemVer — обещание о поверхности CLI.** Убрать/переименовать/изменить команду, флаг, форму `--json`, exit-код
|
|
61
|
+
или код ошибки — ломающее изменение: major, а на `0.x` — minor. Новая возможность при прежнем поведении —
|
|
62
|
+
minor (на `0.x` — patch); исправление — patch. Сначала deprecate (предупреждение), убирать — в следующем
|
|
63
|
+
ломающем релизе.
|
|
64
|
+
- **Зависимость от другого нашего инструмента** — совместимый диапазон в `dependencies` (`>=0.2,<0.3`) и
|
|
65
|
+
источник — только реестр Gitea: `[tool.uv.sources] <name> = { index = "gitea" }` (индекс `gitea` с
|
|
66
|
+
`explicit = true` уже в `pyproject.toml`); никогда git-тег, `branch = "main"` и закоммиченный `path =`.
|
|
67
|
+
Подъём — новый релиз зависимости, `uv lock --upgrade-package <name>`, полный гейт, один коммит.
|
|
68
|
+
|
|
69
|
+
## Внутри системы tools
|
|
70
|
+
|
|
71
|
+
Инструмент — один сервис из многих: инфраструктура (sysadmin) разворачивает его, держит ключи (Doppler)
|
|
72
|
+
и бэкапит данные (S3).
|
|
73
|
+
|
|
74
|
+
- **Вопросы и отчёты — Человеку напрямую**: вопрос, варианты, рекомендация. Пока ждёшь ответа, делай то,
|
|
75
|
+
что от него не зависит.
|
|
76
|
+
- **Отчёт о релизе** (рядом с тегом): красный прогон новых тестов; каждый изменённый существующий тест с причиной;
|
|
77
|
+
новая или переименованная переменная окружения или ключ; новая локальная база или новый путь к данным; новая или
|
|
78
|
+
убранная зависимость от другого инструмента; обновлённый токен, записанный локально; ломающий релиз. Перед
|
|
79
|
+
ломающим изменением назвать потребителей.
|
|
80
|
+
- **В прод агент не ходит.** Ничего не запускать против него: ни `db push` (даже `--dry-run`), ни
|
|
81
|
+
чтение через `*_PROD_DATABASE_URL`, ни ssh на сервер. Нужна проверка в проде — дать Человеку точную
|
|
82
|
+
команду. Локальная одноразовая база (`scripts/pg_test.sh`) — своя.
|
|
83
|
+
- **Ничего вне этого репозитория.** Не давать указаний другим агентам и ничего не менять вне него.
|
|
84
|
+
Ошибка или просьба к другому инструменту — Человеку; к инфраструктуре —
|
|
85
|
+
Человеку, для sysadmin.
|
|
86
|
+
- **Серверы Linux без экрана.** Сначала переменные окружения, keychain необязателен (без keychain при заданной
|
|
87
|
+
переменной — не ошибка); существующие имена переменных переиспользовать; без TTY никаких вопросов; без путей
|
|
88
|
+
только для Mac.
|
|
89
|
+
- **Локальные данные** — в `platformdirs.user_data_dir("<tool>")`, никогда в репозитории; всё состояние — в файле
|
|
90
|
+
базы, миграции запускает сам инструмент; инструмент сам не выгружает и не синхронизирует данные.
|