abvx-set 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.
Files changed (18) hide show
  1. abvx_set-0.2.3/LICENSE +21 -0
  2. abvx_set-0.2.3/PKG-INFO +125 -0
  3. abvx_set-0.2.3/README.md +112 -0
  4. abvx_set-0.2.3/abvx_set.egg-info/PKG-INFO +125 -0
  5. abvx_set-0.2.3/abvx_set.egg-info/SOURCES.txt +16 -0
  6. abvx_set-0.2.3/abvx_set.egg-info/dependency_links.txt +1 -0
  7. abvx_set-0.2.3/abvx_set.egg-info/entry_points.txt +3 -0
  8. abvx_set-0.2.3/abvx_set.egg-info/top_level.txt +1 -0
  9. abvx_set-0.2.3/pyproject.toml +25 -0
  10. abvx_set-0.2.3/scripts/__init__.py +2 -0
  11. abvx_set-0.2.3/scripts/plan_config_apply.py +848 -0
  12. abvx_set-0.2.3/scripts/resolve_inputs.py +90 -0
  13. abvx_set-0.2.3/scripts/validate_registry.py +155 -0
  14. abvx_set-0.2.3/scripts/write_summary.py +161 -0
  15. abvx_set-0.2.3/setup.cfg +4 -0
  16. abvx_set-0.2.3/tests/test_contract_snapshots.py +90 -0
  17. abvx_set-0.2.3/tests/test_plan_config_apply.py +28 -0
  18. abvx_set-0.2.3/tests/test_validate_registry.py +64 -0
abvx_set-0.2.3/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Anton Biletskiy-Volokh
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
abvx_set-0.2.3/PKG-INFO ADDED
@@ -0,0 +1,125 @@
1
+ Metadata-Version: 2.4
2
+ Name: abvx-set
3
+ Version: 0.2.3
4
+ Summary: SET workflow action helpers and registry tooling
5
+ Author: ABVX
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/markoblogo/SET
8
+ Project-URL: Issues, https://github.com/markoblogo/SET/issues
9
+ Requires-Python: >=3.10
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Dynamic: license-file
13
+
14
+ <p align="center">
15
+ <img src="logo_SET.png" alt="SET logo" width="220">
16
+ </p>
17
+
18
+ # SET
19
+
20
+ [![Release](https://img.shields.io/github/v/release/markoblogo/SET?label=release)](https://github.com/markoblogo/SET/releases)
21
+ [![Workflow](https://img.shields.io/github/actions/workflow/status/markoblogo/SET/set.yml?label=workflow)](https://github.com/markoblogo/SET/actions/workflows/set.yml)
22
+ [![License](https://img.shields.io/github/license/markoblogo/SET)](https://github.com/markoblogo/SET/blob/main/LICENSE)
23
+
24
+ Thin orchestration repo for the ABVX stack to keep AI-facing repo artifacts in sync.
25
+
26
+ `SET` is not a replacement for Copilot/Cursor/Continue. It is a workflow control plane: it orchestrates existing tools, makes run plans explicit, and keeps outputs predictable for CI and agents.
27
+
28
+ ## Quick start (30 seconds)
29
+
30
+ Use this in any repo to baseline `AGENTS.md` and checks via `agentsgen`:
31
+
32
+ ```yaml
33
+ - uses: markoblogo/SET@v0.1.0
34
+ with:
35
+ workflow_preset: repo-docs
36
+ path: "."
37
+ ```
38
+
39
+ If you're not ready to wire `.github/workflows/set.yml` manually, run `plan-config` locally first:
40
+
41
+ ```bash
42
+ python3 scripts/plan_config_apply.py markoblogo/<owner/repo> --format json
43
+ ```
44
+
45
+ This is a read-only plan showing the exact workflow file that would be generated.
46
+
47
+ ## Who this is for
48
+
49
+ - Solo devs: one-command AI-ready repo baseline (`agentsgen`, checks, repomap, optional proofs).
50
+ - Team maintainers: one central registry for many repos with CI-drift visibility.
51
+ - Tool builders: stable registry and planner artifacts for control-plane integrations.
52
+
53
+ ## What SET Does
54
+
55
+ - `agentsgen` handles repo documentation, map generation, checks, and related contracts.
56
+ - `SET` chooses how and when `agentsgen` and other tools run.
57
+ - `ID` and other optional integrations are executed via explicit, validated repo config.
58
+ - `lab.abvx` is the public catalog and read-only control-plane surface.
59
+
60
+ ```mermaid
61
+ flowchart LR
62
+ SET["SET Action"]
63
+ agentsgen["agentsgen"] -->|generates docs| artifacts["AGENTS.md / llms.txt / docs/ai"]
64
+ SET --> agentsgen
65
+ ID["ID"]
66
+ ID -->|hooks / context| SET
67
+ SET --> lab["lab.abvx"]
68
+ registry["Registry"] --> SET
69
+ ```
70
+
71
+ ### Core roles
72
+
73
+ - `repo-docs` preset: `init + pack + check`
74
+ - `site-ai` preset: `repo-docs + site pack + analyze + meta`
75
+ - `minimal` preset: bootstrap only
76
+
77
+ ## Repo config contract
78
+
79
+ `SET` owns the first centralized contract and registry baseline for repo-level orchestration.
80
+
81
+ - Contract docs: `docs/repo-config.md`
82
+ - Schema: `schema/repo-config.v1.json`
83
+ - Registry: `registry/repos/*.json`
84
+ - Validation: `python3 scripts/validate_registry.py`
85
+
86
+ The contract includes:
87
+ - tooling intent (`tools.agentsgen`, `tools.id`, `tools.git_tweet`)
88
+ - presets and overrides (`workflow_preset` inputs)
89
+ - repomap policy (`compact_budget`, `top_ranked_files`, `focus`, `changed`)
90
+ - proof-loop contract metadata
91
+ - optional `site` baseline for catalog-facing pages
92
+
93
+ There is an additional runtime artifact, `agents.knowledge.json`, that is generated by `agentsgen` and consumed by AI tooling. It is intentionally separate from control-plane registry data.
94
+
95
+ ## Config apply planning (`scripts/plan_config_apply.py`)
96
+
97
+ Current behavior is intentionally planning-only:
98
+ - shows one-file proposed workflow diff as structured output
99
+ - exports review artifacts (`plan.json`, `workflow.set.yml`, `pr-body.md`, etc.)
100
+ - performs repo drift check with `--repo-root` (`matches`, `drift`, `missing`)
101
+ - never writes target repos (review-first only)
102
+
103
+ Useful commands:
104
+
105
+ ```bash
106
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx
107
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --dry-run --format json
108
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --export-dir ./.set-plan
109
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --repo-root /path/to/lab
110
+ ```
111
+
112
+ ## Getting started docs
113
+
114
+ - `docs/repo-config.md`
115
+ - `docs/config-apply-planning.md`
116
+ - `docs/llmo-capability-map.md`
117
+ - `docs/v0.1-scope.md`
118
+ - `CONTRIBUTING.md`
119
+
120
+ ## Links
121
+
122
+ - SET repo: https://github.com/markoblogo/SET
123
+ - Lab catalog: https://github.com/markoblogo/lab.abvx
124
+ - ID protocol: https://github.com/markoblogo/ID
125
+ - agentsgen: https://github.com/markoblogo/AGENTS.md_generator
abvx_set-0.2.3/README.md ADDED
@@ -0,0 +1,112 @@
1
+ <p align="center">
2
+ <img src="logo_SET.png" alt="SET logo" width="220">
3
+ </p>
4
+
5
+ # SET
6
+
7
+ [![Release](https://img.shields.io/github/v/release/markoblogo/SET?label=release)](https://github.com/markoblogo/SET/releases)
8
+ [![Workflow](https://img.shields.io/github/actions/workflow/status/markoblogo/SET/set.yml?label=workflow)](https://github.com/markoblogo/SET/actions/workflows/set.yml)
9
+ [![License](https://img.shields.io/github/license/markoblogo/SET)](https://github.com/markoblogo/SET/blob/main/LICENSE)
10
+
11
+ Thin orchestration repo for the ABVX stack to keep AI-facing repo artifacts in sync.
12
+
13
+ `SET` is not a replacement for Copilot/Cursor/Continue. It is a workflow control plane: it orchestrates existing tools, makes run plans explicit, and keeps outputs predictable for CI and agents.
14
+
15
+ ## Quick start (30 seconds)
16
+
17
+ Use this in any repo to baseline `AGENTS.md` and checks via `agentsgen`:
18
+
19
+ ```yaml
20
+ - uses: markoblogo/SET@v0.1.0
21
+ with:
22
+ workflow_preset: repo-docs
23
+ path: "."
24
+ ```
25
+
26
+ If you're not ready to wire `.github/workflows/set.yml` manually, run `plan-config` locally first:
27
+
28
+ ```bash
29
+ python3 scripts/plan_config_apply.py markoblogo/<owner/repo> --format json
30
+ ```
31
+
32
+ This is a read-only plan showing the exact workflow file that would be generated.
33
+
34
+ ## Who this is for
35
+
36
+ - Solo devs: one-command AI-ready repo baseline (`agentsgen`, checks, repomap, optional proofs).
37
+ - Team maintainers: one central registry for many repos with CI-drift visibility.
38
+ - Tool builders: stable registry and planner artifacts for control-plane integrations.
39
+
40
+ ## What SET Does
41
+
42
+ - `agentsgen` handles repo documentation, map generation, checks, and related contracts.
43
+ - `SET` chooses how and when `agentsgen` and other tools run.
44
+ - `ID` and other optional integrations are executed via explicit, validated repo config.
45
+ - `lab.abvx` is the public catalog and read-only control-plane surface.
46
+
47
+ ```mermaid
48
+ flowchart LR
49
+ SET["SET Action"]
50
+ agentsgen["agentsgen"] -->|generates docs| artifacts["AGENTS.md / llms.txt / docs/ai"]
51
+ SET --> agentsgen
52
+ ID["ID"]
53
+ ID -->|hooks / context| SET
54
+ SET --> lab["lab.abvx"]
55
+ registry["Registry"] --> SET
56
+ ```
57
+
58
+ ### Core roles
59
+
60
+ - `repo-docs` preset: `init + pack + check`
61
+ - `site-ai` preset: `repo-docs + site pack + analyze + meta`
62
+ - `minimal` preset: bootstrap only
63
+
64
+ ## Repo config contract
65
+
66
+ `SET` owns the first centralized contract and registry baseline for repo-level orchestration.
67
+
68
+ - Contract docs: `docs/repo-config.md`
69
+ - Schema: `schema/repo-config.v1.json`
70
+ - Registry: `registry/repos/*.json`
71
+ - Validation: `python3 scripts/validate_registry.py`
72
+
73
+ The contract includes:
74
+ - tooling intent (`tools.agentsgen`, `tools.id`, `tools.git_tweet`)
75
+ - presets and overrides (`workflow_preset` inputs)
76
+ - repomap policy (`compact_budget`, `top_ranked_files`, `focus`, `changed`)
77
+ - proof-loop contract metadata
78
+ - optional `site` baseline for catalog-facing pages
79
+
80
+ There is an additional runtime artifact, `agents.knowledge.json`, that is generated by `agentsgen` and consumed by AI tooling. It is intentionally separate from control-plane registry data.
81
+
82
+ ## Config apply planning (`scripts/plan_config_apply.py`)
83
+
84
+ Current behavior is intentionally planning-only:
85
+ - shows one-file proposed workflow diff as structured output
86
+ - exports review artifacts (`plan.json`, `workflow.set.yml`, `pr-body.md`, etc.)
87
+ - performs repo drift check with `--repo-root` (`matches`, `drift`, `missing`)
88
+ - never writes target repos (review-first only)
89
+
90
+ Useful commands:
91
+
92
+ ```bash
93
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx
94
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --dry-run --format json
95
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --export-dir ./.set-plan
96
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --repo-root /path/to/lab
97
+ ```
98
+
99
+ ## Getting started docs
100
+
101
+ - `docs/repo-config.md`
102
+ - `docs/config-apply-planning.md`
103
+ - `docs/llmo-capability-map.md`
104
+ - `docs/v0.1-scope.md`
105
+ - `CONTRIBUTING.md`
106
+
107
+ ## Links
108
+
109
+ - SET repo: https://github.com/markoblogo/SET
110
+ - Lab catalog: https://github.com/markoblogo/lab.abvx
111
+ - ID protocol: https://github.com/markoblogo/ID
112
+ - agentsgen: https://github.com/markoblogo/AGENTS.md_generator
abvx_set-0.2.3/abvx_set.egg-info/PKG-INFO ADDED
@@ -0,0 +1,125 @@
1
+ Metadata-Version: 2.4
2
+ Name: abvx-set
3
+ Version: 0.2.3
4
+ Summary: SET workflow action helpers and registry tooling
5
+ Author: ABVX
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/markoblogo/SET
8
+ Project-URL: Issues, https://github.com/markoblogo/SET/issues
9
+ Requires-Python: >=3.10
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Dynamic: license-file
13
+
14
+ <p align="center">
15
+ <img src="logo_SET.png" alt="SET logo" width="220">
16
+ </p>
17
+
18
+ # SET
19
+
20
+ [![Release](https://img.shields.io/github/v/release/markoblogo/SET?label=release)](https://github.com/markoblogo/SET/releases)
21
+ [![Workflow](https://img.shields.io/github/actions/workflow/status/markoblogo/SET/set.yml?label=workflow)](https://github.com/markoblogo/SET/actions/workflows/set.yml)
22
+ [![License](https://img.shields.io/github/license/markoblogo/SET)](https://github.com/markoblogo/SET/blob/main/LICENSE)
23
+
24
+ Thin orchestration repo for the ABVX stack to keep AI-facing repo artifacts in sync.
25
+
26
+ `SET` is not a replacement for Copilot/Cursor/Continue. It is a workflow control plane: it orchestrates existing tools, makes run plans explicit, and keeps outputs predictable for CI and agents.
27
+
28
+ ## Quick start (30 seconds)
29
+
30
+ Use this in any repo to baseline `AGENTS.md` and checks via `agentsgen`:
31
+
32
+ ```yaml
33
+ - uses: markoblogo/SET@v0.1.0
34
+ with:
35
+ workflow_preset: repo-docs
36
+ path: "."
37
+ ```
38
+
39
+ If you're not ready to wire `.github/workflows/set.yml` manually, run `plan-config` locally first:
40
+
41
+ ```bash
42
+ python3 scripts/plan_config_apply.py markoblogo/<owner/repo> --format json
43
+ ```
44
+
45
+ This is a read-only plan showing the exact workflow file that would be generated.
46
+
47
+ ## Who this is for
48
+
49
+ - Solo devs: one-command AI-ready repo baseline (`agentsgen`, checks, repomap, optional proofs).
50
+ - Team maintainers: one central registry for many repos with CI-drift visibility.
51
+ - Tool builders: stable registry and planner artifacts for control-plane integrations.
52
+
53
+ ## What SET Does
54
+
55
+ - `agentsgen` handles repo documentation, map generation, checks, and related contracts.
56
+ - `SET` chooses how and when `agentsgen` and other tools run.
57
+ - `ID` and other optional integrations are executed via explicit, validated repo config.
58
+ - `lab.abvx` is the public catalog and read-only control-plane surface.
59
+
60
+ ```mermaid
61
+ flowchart LR
62
+ SET["SET Action"]
63
+ agentsgen["agentsgen"] -->|generates docs| artifacts["AGENTS.md / llms.txt / docs/ai"]
64
+ SET --> agentsgen
65
+ ID["ID"]
66
+ ID -->|hooks / context| SET
67
+ SET --> lab["lab.abvx"]
68
+ registry["Registry"] --> SET
69
+ ```
70
+
71
+ ### Core roles
72
+
73
+ - `repo-docs` preset: `init + pack + check`
74
+ - `site-ai` preset: `repo-docs + site pack + analyze + meta`
75
+ - `minimal` preset: bootstrap only
76
+
77
+ ## Repo config contract
78
+
79
+ `SET` owns the first centralized contract and registry baseline for repo-level orchestration.
80
+
81
+ - Contract docs: `docs/repo-config.md`
82
+ - Schema: `schema/repo-config.v1.json`
83
+ - Registry: `registry/repos/*.json`
84
+ - Validation: `python3 scripts/validate_registry.py`
85
+
86
+ The contract includes:
87
+ - tooling intent (`tools.agentsgen`, `tools.id`, `tools.git_tweet`)
88
+ - presets and overrides (`workflow_preset` inputs)
89
+ - repomap policy (`compact_budget`, `top_ranked_files`, `focus`, `changed`)
90
+ - proof-loop contract metadata
91
+ - optional `site` baseline for catalog-facing pages
92
+
93
+ There is an additional runtime artifact, `agents.knowledge.json`, that is generated by `agentsgen` and consumed by AI tooling. It is intentionally separate from control-plane registry data.
94
+
95
+ ## Config apply planning (`scripts/plan_config_apply.py`)
96
+
97
+ Current behavior is intentionally planning-only:
98
+ - shows one-file proposed workflow diff as structured output
99
+ - exports review artifacts (`plan.json`, `workflow.set.yml`, `pr-body.md`, etc.)
100
+ - performs repo drift check with `--repo-root` (`matches`, `drift`, `missing`)
101
+ - never writes target repos (review-first only)
102
+
103
+ Useful commands:
104
+
105
+ ```bash
106
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx
107
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --dry-run --format json
108
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --export-dir ./.set-plan
109
+ python3 scripts/plan_config_apply.py markoblogo/lab.abvx --repo-root /path/to/lab
110
+ ```
111
+
112
+ ## Getting started docs
113
+
114
+ - `docs/repo-config.md`
115
+ - `docs/config-apply-planning.md`
116
+ - `docs/llmo-capability-map.md`
117
+ - `docs/v0.1-scope.md`
118
+ - `CONTRIBUTING.md`
119
+
120
+ ## Links
121
+
122
+ - SET repo: https://github.com/markoblogo/SET
123
+ - Lab catalog: https://github.com/markoblogo/lab.abvx
124
+ - ID protocol: https://github.com/markoblogo/ID
125
+ - agentsgen: https://github.com/markoblogo/AGENTS.md_generator
abvx_set-0.2.3/abvx_set.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,16 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ abvx_set.egg-info/PKG-INFO
5
+ abvx_set.egg-info/SOURCES.txt
6
+ abvx_set.egg-info/dependency_links.txt
7
+ abvx_set.egg-info/entry_points.txt
8
+ abvx_set.egg-info/top_level.txt
9
+ scripts/__init__.py
10
+ scripts/plan_config_apply.py
11
+ scripts/resolve_inputs.py
12
+ scripts/validate_registry.py
13
+ scripts/write_summary.py
14
+ tests/test_contract_snapshots.py
15
+ tests/test_plan_config_apply.py
16
+ tests/test_validate_registry.py
abvx_set-0.2.3/abvx_set.egg-info/entry_points.txt ADDED
@@ -0,0 +1,3 @@
1
+ [console_scripts]
2
+ set-plan-config-apply = scripts.plan_config_apply:main
3
+ set-validate-registry = scripts.validate_registry:main
abvx_set-0.2.3/abvx_set.egg-info/top_level.txt ADDED
@@ -0,0 +1 @@
1
+ scripts
abvx_set-0.2.3/pyproject.toml ADDED
@@ -0,0 +1,25 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "abvx-set"
7
+ version = "0.2.3"
8
+ description = "SET workflow action helpers and registry tooling"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = "MIT"
12
+ license-files = ["LICENSE"]
13
+ authors = [{ name = "ABVX" }]
14
+ dependencies = []
15
+
16
+ [project.urls]
17
+ Homepage = "https://github.com/markoblogo/SET"
18
+ Issues = "https://github.com/markoblogo/SET/issues"
19
+
20
+ [tool.setuptools]
21
+ packages = ["scripts"]
22
+
23
+ [project.scripts]
24
+ set-validate-registry = "scripts.validate_registry:main"
25
+ set-plan-config-apply = "scripts.plan_config_apply:main"
abvx_set-0.2.3/scripts/__init__.py ADDED
@@ -0,0 +1,2 @@
1
+ """SET script package."""
2
+