@elvis1513/auto-coding-skill 4.1.9 → 4.2.0
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 +25 -5
- package/cli/assets/managed-install.json +1 -1
- package/cli/assets/skill/SKILL.md +11 -3
- package/cli/assets/skill/data/policies/workflow-migrations-v1.json +2 -2
- package/cli/assets/skill/data/templates/ENGINEERING.md +2 -20
- package/cli/assets/skill/data/templates/bridges/AGENTS.md +9 -1
- package/cli/assets/skill/scripts/ap.py +567 -54
- package/cli/tests/ap_concurrency_test.py +311 -6
- package/cli/tests/ap_profiles_test.py +3 -3
- package/cli/tests/index.test.js +17 -17
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,7 +9,9 @@ The Skill is a selectable guardrail, not a command sequence that must run for
|
|
|
9
9
|
every task. The model skips machinery whose expected benefit does not exceed its
|
|
10
10
|
cost; read-only work and obvious small clean-checkout changes normally stay direct.
|
|
11
11
|
|
|
12
|
-
Version 4.
|
|
12
|
+
Version 4.2.0 makes registered closure resilient to normal Git staging, reuses
|
|
13
|
+
an exact successful final gate, and lets an active task expand scope safely
|
|
14
|
+
before its first commit. Version 4.1.9 makes `autocoding init` verify the bounded managed installation after every install or upgrade:
|
|
13
15
|
it replaces every managed constraint, migrates only schema-approved project
|
|
14
16
|
configuration, and converges `docs/` to one canonical directory framework. Version 4.1.7 made
|
|
15
17
|
the Python runtime check, release verification, and tag publication environment
|
|
@@ -88,14 +90,16 @@ Clean serial work proceeds directly on the current branch with normal Git; it do
|
|
|
88
90
|
not create machine lifecycle state. Use `task-start` only when classification
|
|
89
91
|
requires isolation/review or the user explicitly requests lifecycle tracking:
|
|
90
92
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
93
|
+
If a registered task discovers another path before its first commit, expand it
|
|
94
|
+
with `task-scope-add` instead of finishing and restarting. Expansion is explicit,
|
|
95
|
+
lease/conflict checked, risk-monotonic, and invalidates old review/gate state.
|
|
96
|
+
Unregistered direct work should reclassify before writing outside its clean claim.
|
|
95
97
|
|
|
96
98
|
```bash
|
|
97
99
|
python3 docs/tools/autopipeline/ap.py task-start T0001 \
|
|
98
100
|
--owned-path backend/internal/orders --force-lifecycle
|
|
101
|
+
python3 docs/tools/autopipeline/ap.py task-scope-add T0001 \
|
|
102
|
+
--owned-path config/orders
|
|
99
103
|
python3 docs/tools/autopipeline/ap.py commit-push T0001 \
|
|
100
104
|
--msg "T0001: fix order retry"
|
|
101
105
|
```
|
|
@@ -175,6 +179,10 @@ closure gate is limited to one stable-diff run. Full regression, Docker, builds,
|
|
|
175
179
|
Jenkins, deployment, API verification, and target checks remain explicit
|
|
176
180
|
diagnostics outside normal closure.
|
|
177
181
|
|
|
182
|
+
Registered tasks call `commit-push` directly because it performs or strictly
|
|
183
|
+
reuses that final gate. Run `light-gate` manually only for unregistered normal Git
|
|
184
|
+
closure or when explicitly requesting a fresh diagnostic pass.
|
|
185
|
+
|
|
178
186
|
The recommended final closure defaults are 120 seconds per command and 180
|
|
179
187
|
seconds total. Projects may raise them for measured affected-scope checks or set
|
|
180
188
|
a smaller `timeout_seconds` on a route. A timeout calls for a narrower route and
|
|
@@ -214,6 +222,18 @@ schema/body, runtime launcher, and documentation framework. It preserves explici
|
|
|
214
222
|
model overrides and current values at supported project/access/concurrency/route
|
|
215
223
|
fields. Removed content is archived outside active docs.
|
|
216
224
|
|
|
225
|
+
## What changed in 4.2.0
|
|
226
|
+
|
|
227
|
+
- Made `commit-push` preserve already staged deletions and mixed index/worktree
|
|
228
|
+
state, and made ownership/validation see both ends of a rename.
|
|
229
|
+
- Added an exact per-worktree final-gate PASS receipt. Registered `commit-push`
|
|
230
|
+
reuses it only when content, index, base, scope, validation plan, command hashes,
|
|
231
|
+
and writer lease still match; staging or push retries no longer rerun a stable gate.
|
|
232
|
+
- Added `task-scope-add` for conflict-checked, monotonic scope expansion before the
|
|
233
|
+
first commit. Expansion raises risk when necessary and invalidates review/gate state.
|
|
234
|
+
- Clarified that registered tasks call `commit-push` directly; standalone
|
|
235
|
+
`light-gate` is for unregistered Git closure or an explicit fresh diagnostic.
|
|
236
|
+
|
|
217
237
|
## What changed in 4.1.9
|
|
218
238
|
|
|
219
239
|
- Added a packaged managed-install manifest with path, version, content hash, and
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"schema_version":1,"skill_version":"4.
|
|
1
|
+
{"schema_version":1,"skill_version":"4.2.0","manifest_path":".agents/managed-install.json","entries":[{"path":".agents/agents/browser-debugger.toml","source":"agents/browser-debugger.toml","ownership":"normalized-agent","sha256":"40727952944917eb0b573bb96dca2906c27bc794737f3b6b392b56df7b4208aa","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"f3a0adc06bba44ea81e1b10c6e353f53ece555c55f9e2990276f4c12a483f318","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"b5e61e74adc5f172a191d027195f921e994239904edf08773094234256bab410","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json","source":"skill/data/contracts/orchestration-v1.schema.json","ownership":"exact","sha256":"3a93c2bfbb236e5bc41b7ab75a67ff56e7ad3535adc229518b45c2f9fd8707e3","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"77a67bb33dd434f0830de00fa224581bad015ec39cd638b503f2665f22047bf6","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"931fe9e6d50ef07c85699549278548e80ba4d7e263cadea409f6b2458fde45ca","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"f8be6f091eb5cb4e69ebec669d3b1addfda400fe705d0b4fd8d163d020a7e6f8","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/templates/tools/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"5b88d0ffb7f590e4b84bff487ebbf7b06d9aac8a4f640141f3d38992c41aafeb","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/core.py","source":"skill/scripts/core.py","ownership":"exact","sha256":"56019d529e82767f6dce8505945c55fc2253b596200b0e915fc89787a3bc4837","executable":true,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/http_checks.py","source":"skill/scripts/http_checks.py","ownership":"exact","sha256":"5620e187a0129f135621425a84b3a4e8f31137263c7e549a36a801fc36ff54ea","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/install_integrity.py","source":"skill/scripts/install_integrity.py","ownership":"exact","sha256":"20b0424152d61b3c067feb9558dd2532ab3abb459fc71a4c7de915e95bd83696","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/scaffold_templates.py","source":"skill/scripts/scaffold_templates.py","ownership":"exact","sha256":"c825f15591b41403b7a97877c17f66cddcbbc5b029d143a7f1252e85388608e1","executable":false,"scope":"shared","version":"4.2.0"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"f8be6f091eb5cb4e69ebec669d3b1addfda400fe705d0b4fd8d163d020a7e6f8","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md#managed-workflow","ownership":"managed-workflow","sha256":"1f7b20eaba98d4fa7e5503e844831fbe36648cb54b4e89dfca1834b9d33df54e","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/architecture/adr/_TEMPLATE-ADR.md","source":"generated:scaffold_templates:docs/architecture/adr/_TEMPLATE-ADR.md","ownership":"exact","sha256":"88c89065ae0f8555412dbe096c05342152efc7becae8d8981e6442cdfee8e672","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/architecture/structure-standard.md","source":"generated:scaffold_templates:docs/architecture/structure-standard.md","ownership":"exact","sha256":"aa2e9bbf1baad0f3a3e0e97aaaefee7282740f09a976b1bb9be7fa0b529a549a","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md","source":"generated:scaffold_templates:docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md","ownership":"exact","sha256":"f2c17c0febc322b0ad50fb9d6f7e64e6c0cfb15c8a3e445a99da40f0a0dd1901","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/design/_TEMPLATE-DD.md","source":"generated:scaffold_templates:docs/design/_TEMPLATE-DD.md","ownership":"exact","sha256":"6ca022d127bfff68521f466b60bace4f1206baf0913daa855b9f751e74198db3","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/reviews/_TEMPLATE-REVIEW.md","source":"generated:scaffold_templates:docs/reviews/_TEMPLATE-REVIEW.md","ownership":"exact","sha256":"134f0d1bd3c7a317ef3cf4c2aea9f0539f3d53dccd5bcdabf6915b3629ef8802","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.2.0"}],"managed_namespaces":[{"path":".agents/skills/auto-coding-skill","scope":"shared"},{"path":"docs/tools/autopipeline","scope":"project"}],"preserved":[".agents/archive/**",".agents/agents/* (except paths listed in entries)","docs/project/**","docs/architecture/adr/[0-9]*.md","docs/design/*.md","docs/interfaces/*.md","docs/deployment/deploy-records/*.md","docs/reviews/*.md"]}
|
|
@@ -39,6 +39,8 @@ fingerprinted review, or when the user explicitly requests it:
|
|
|
39
39
|
```bash
|
|
40
40
|
python3 docs/tools/autopipeline/ap.py task-start T0001 \
|
|
41
41
|
--owned-path src [--isolated] [--review-required] [--continue-direct --direct-claim <ID>]
|
|
42
|
+
# Before the first commit, expand an active task instead of restarting it:
|
|
43
|
+
python3 docs/tools/autopipeline/ap.py task-scope-add T0001 --owned-path config/new-scope
|
|
42
44
|
# For review-required work, obtain the current fingerprint and approve it:
|
|
43
45
|
python3 docs/tools/autopipeline/ap.py task-status T0001 --json
|
|
44
46
|
python3 docs/tools/autopipeline/ap.py task-review T0001 \
|
|
@@ -54,11 +56,17 @@ with `agent-contract-check`; parallel fixers require reclassification with `--wr
|
|
|
54
56
|
|
|
55
57
|
## Close with the bounded routed gate
|
|
56
58
|
|
|
59
|
+
For unregistered clean serial work, run the final gate and then use normal Git:
|
|
60
|
+
|
|
57
61
|
```bash
|
|
58
62
|
python3 docs/tools/autopipeline/ap.py validation-map-check --path <PATH>
|
|
59
63
|
python3 docs/tools/autopipeline/ap.py light-gate --scope changed --explain
|
|
60
64
|
```
|
|
61
65
|
|
|
66
|
+
For a registered task, call only `commit-push`: it owns the final gate and reuses
|
|
67
|
+
an exact Git-local PASS only while content, base, scope, routes, commands, and
|
|
68
|
+
lease match. Matching manual passes are reusable; changed state is not.
|
|
69
|
+
|
|
62
70
|
Every changed code/config path must map to a real project command. The runtime
|
|
63
71
|
de-duplicates commands and enforces route, command, and total budgets. Defaults
|
|
64
72
|
are 120 seconds per command and 180 total; projects may raise them for a measured
|
|
@@ -71,9 +79,9 @@ diagnosis continues in the same task without inventing another lifecycle.
|
|
|
71
79
|
|
|
72
80
|
## Keep state and upgrades safe
|
|
73
81
|
|
|
74
|
-
Machine task state, leases, fingerprints, and gate evidence stay
|
|
75
|
-
|
|
76
|
-
|
|
82
|
+
Machine task state, leases, fingerprints, and gate evidence stay Git-local.
|
|
83
|
+
Ordinary work creates no taskbook, closure, evidence JSONL, active-task, or
|
|
84
|
+
design artifact. Terminal ledger reconciliation validates and commits once.
|
|
77
85
|
|
|
78
86
|
```bash
|
|
79
87
|
autocoding init
|
|
@@ -1,15 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
workflow:
|
|
3
|
-
skill_version: "4.
|
|
3
|
+
skill_version: "4.2.0"
|
|
4
4
|
mode: "dev"
|
|
5
5
|
profile: "auto"
|
|
6
6
|
completion: "push"
|
|
7
|
-
|
|
8
7
|
project:
|
|
9
8
|
name: ""
|
|
10
9
|
repo_root: "."
|
|
11
10
|
stack: "generic"
|
|
12
|
-
|
|
13
11
|
access:
|
|
14
12
|
project:
|
|
15
13
|
frontend:
|
|
@@ -38,7 +36,6 @@ access:
|
|
|
38
36
|
url: ""
|
|
39
37
|
username: ""
|
|
40
38
|
password: ""
|
|
41
|
-
|
|
42
39
|
concurrency:
|
|
43
40
|
isolation: "adaptive"
|
|
44
41
|
base_ref: ""
|
|
@@ -48,12 +45,10 @@ concurrency:
|
|
|
48
45
|
cleanup_merged: true
|
|
49
46
|
delete_remote_branch: true
|
|
50
47
|
disposable_ignored: []
|
|
51
|
-
|
|
52
48
|
commands:
|
|
53
49
|
# Optional convenience command. Define the project-native fast commands used
|
|
54
50
|
# by validation.routes; sync fills this only for package.json test:changed.
|
|
55
51
|
project_fast: ""
|
|
56
|
-
|
|
57
52
|
validation:
|
|
58
53
|
on_unmapped: "error"
|
|
59
54
|
# Recommended fast defaults. Raise only for a measured affected-scope check;
|
|
@@ -63,10 +58,8 @@ validation:
|
|
|
63
58
|
# Initialization must replace this with real path-to-command mappings. Empty
|
|
64
59
|
# routes intentionally fail closed for code/config changes.
|
|
65
60
|
routes: []
|
|
66
|
-
|
|
67
61
|
risk:
|
|
68
62
|
rules: []
|
|
69
|
-
|
|
70
63
|
structure:
|
|
71
64
|
enabled: true
|
|
72
65
|
enforcement: "advisory"
|
|
@@ -76,12 +69,10 @@ structure:
|
|
|
76
69
|
enabled: true
|
|
77
70
|
block: false
|
|
78
71
|
rules: []
|
|
79
|
-
|
|
80
72
|
optimization:
|
|
81
73
|
completion_policy: "no-new-debt"
|
|
82
74
|
require_baseline_for_global_review: false
|
|
83
75
|
report_accepted_debt_as_findings: false
|
|
84
|
-
|
|
85
76
|
docs:
|
|
86
77
|
framework: "engineering-centered"
|
|
87
78
|
design_dir: "docs/design"
|
|
@@ -90,17 +81,12 @@ docs:
|
|
|
90
81
|
api_doc: "docs/interfaces/api.md"
|
|
91
82
|
api_change_log: "docs/interfaces/api-change-log.md"
|
|
92
83
|
---
|
|
93
|
-
|
|
94
84
|
# Engineering Configuration and Project Facts
|
|
95
|
-
|
|
96
|
-
<!-- auto-coding-skill:managed-workflow:start version=4.1.9 -->
|
|
97
|
-
|
|
85
|
+
<!-- auto-coding-skill:managed-workflow:start version=4.2.0 -->
|
|
98
86
|
Root `AGENTS.md` is the single shared behavioral protocol. The installed
|
|
99
87
|
`SKILL.md` contains invocation guidance. This file is the exact-schema source for
|
|
100
88
|
project workflow configuration and access values that neither file can infer.
|
|
101
|
-
|
|
102
89
|
The frontmatter contract is:
|
|
103
|
-
|
|
104
90
|
- `workflow`: installed version and push-completion mode.
|
|
105
91
|
- `access`: required project, Jenkins, GitLab, and Nexus access values.
|
|
106
92
|
- `concurrency`: target branch and adaptive isolation settings.
|
|
@@ -112,16 +98,12 @@ The frontmatter contract is:
|
|
|
112
98
|
expand the automatic local gate.
|
|
113
99
|
- `structure` and `optimization`: advisory architecture and no-new-debt policy.
|
|
114
100
|
- `docs`: locations inside the managed documentation directory framework.
|
|
115
|
-
|
|
116
101
|
Run `python3 docs/tools/autopipeline/ap.py doctor` after changing frontmatter; it
|
|
117
102
|
also performs the bounded local managed-install integrity check.
|
|
118
103
|
Do not put competing delivery flows, agent roles, lifecycle rules, gate semantics,
|
|
119
104
|
or completion rules outside this managed block.
|
|
120
|
-
|
|
121
105
|
<!-- auto-coding-skill:managed-workflow:end -->
|
|
122
|
-
|
|
123
106
|
# Project Facts Location
|
|
124
|
-
|
|
125
107
|
Keep durable project facts in the installed `docs/project/` files. Do not append
|
|
126
108
|
workflow rules or additional sections here; initialization owns this document's
|
|
127
109
|
schema and body.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- auto-coding-skill:managed-agents:start version=4.
|
|
1
|
+
<!-- auto-coding-skill:managed-agents:start version=4.2.0 -->
|
|
2
2
|
# Shared Engineering Protocol
|
|
3
3
|
|
|
4
4
|
This file is fully managed by `auto-coding-skill`. Keep project-specific facts,
|
|
@@ -58,6 +58,10 @@ failure may continue in the same conversation/task without a second lifecycle.
|
|
|
58
58
|
requires a registered task branch/worktree.
|
|
59
59
|
- Every delegated fixer or parallel writer owns a task ID/worktree, writer lease,
|
|
60
60
|
non-overlapping `owned_paths`, and prerequisite commit SHAs.
|
|
61
|
+
- Before its first commit, an active task may add explicit paths with
|
|
62
|
+
`task-scope-add`; the command checks leases/conflicts, only raises risk, and
|
|
63
|
+
invalidates prior review and final-gate state. Never restart a no-diff task just
|
|
64
|
+
to enlarge its declared scope.
|
|
61
65
|
- Never let multiple writing agents share a checkout. Never restore, reset, stash,
|
|
62
66
|
clean, overwrite, or commit unknown changes.
|
|
63
67
|
- No diff means no commit, push, or temporary branch.
|
|
@@ -95,6 +99,10 @@ failure may continue in the same conversation/task without a second lifecycle.
|
|
|
95
99
|
validation.
|
|
96
100
|
- Focused tests may run and rerun during development. Run one final routed gate
|
|
97
101
|
after the diff is stable.
|
|
102
|
+
- For registered tasks, `commit-push` owns that final gate; do not run a separate
|
|
103
|
+
`light-gate` first. A strict Git-local PASS receipt may be reused only while the
|
|
104
|
+
content/index, base, scope, route/command plan, and writer lease still match.
|
|
105
|
+
Unregistered clean serial work runs `light-gate` before normal Git closure.
|
|
98
106
|
- The final gate defaults to 120 seconds per command and 180 seconds total. A
|
|
99
107
|
project may raise either budget for a measured affected-scope check, and may set
|
|
100
108
|
a smaller `timeout_seconds` on an individual route. A timeout should narrow the
|