@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 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.1.9 makes `autocoding init` verify the bounded managed installation after every install or upgrade:
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
- When a direct task materially changes scope after writing, reclassify with
92
- `--continue-direct` and repeat every current task `--planned-path`. Undeclared
93
- dirty paths, another writer, or mandatory isolation still selects a worktree. If
94
- the new plan requires review lifecycle, reuse `--continue-direct` on `task-start`.
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.9","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.1.9"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"f3a0adc06bba44ea81e1b10c6e353f53ece555c55f9e2990276f4c12a483f318","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"06284b059b247000d9d0f5cc973199df99451c5c7100382ce31893578c3a2e87","executable":false,"scope":"shared","version":"4.1.9"},{"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.1.9"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"1180d44ddbe455e4d38626c9ce5b1fdb6612ba0869a4cb688ee9b7a851b3bf0d","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"8a87ef56d909cb88a31e0dcd9fe6d26ba017128fe3665c2a90b4b2cead3fc944","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"e3fa266a7bac4d0094d541028f5a2438fd3f44b29c85cd828f8dbd236d2fa0ce","executable":false,"scope":"shared","version":"4.1.9"},{"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.1.9"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"56f58bffe1c59b55a1ffdcff781dbad01f675a7b248a7ace8eec06bc7d6b4901","executable":false,"scope":"shared","version":"4.1.9"},{"path":".agents/skills/auto-coding-skill/scripts/core.py","source":"skill/scripts/core.py","ownership":"exact","sha256":"56019d529e82767f6dce8505945c55fc2253b596200b0e915fc89787a3bc4837","executable":true,"scope":"shared","version":"4.1.9"},{"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.1.9"},{"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.1.9"},{"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.1.9"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"e3fa266a7bac4d0094d541028f5a2438fd3f44b29c85cd828f8dbd236d2fa0ce","executable":false,"scope":"project","version":"4.1.9"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md#managed-workflow","ownership":"managed-workflow","sha256":"d84bd6220d637f8e91ed77fb244fec45747b64cb12910a280b9984db1ac11fb7","executable":false,"scope":"project","version":"4.1.9"},{"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.1.9"},{"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.1.9"},{"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.1.9"},{"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.1.9"},{"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.1.9"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.1.9"}],"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"]}
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 in Git local
75
- state. Ordinary work creates no taskbook, closure, evidence JSONL, active-task,
76
- or design artifact. Terminal ledger reconciliation validates and commits once.
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,8 +1,8 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "managed_versions": {
4
- "agents": "4.1.9",
5
- "engineering": "4.1.9"
4
+ "agents": "4.2.0",
5
+ "engineering": "4.2.0"
6
6
  },
7
7
  "known_official_agents_sha256": [
8
8
  "ebaaadab60327b3a4852948443d7191a4d48cb00bf4910038ab78c9149089373"
@@ -1,15 +1,13 @@
1
1
  ---
2
2
  workflow:
3
- skill_version: "4.1.9"
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.9 -->
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