@elvis1513/auto-coding-skill 4.1.7 → 4.1.9

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,9 +9,11 @@ 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.7 makes the Python runtime check, release verification, and tag
13
- publication environment reproducible while removing the unnecessary `requests`
14
- dependency. Version 4.1.4
12
+ Version 4.1.9 makes `autocoding init` verify the bounded managed installation after every install or upgrade:
13
+ it replaces every managed constraint, migrates only schema-approved project
14
+ configuration, and converges `docs/` to one canonical directory framework. Version 4.1.7 made
15
+ the Python runtime check, release verification, and tag publication environment
16
+ reproducible while removing the unnecessary `requests` dependency. Version 4.1.4
15
17
  made direct continuation provably pre-write, closed self-review and
16
18
  risk-classification gaps, validated Agent contracts, and made tag publication
17
19
  idempotent. Version 4.1.3 closed classification bypasses. Version 4.1.2 made mechanisms required,
@@ -28,7 +30,6 @@ affected-scope checks are enabled only when concurrency or risk justifies them.
28
30
  npm install -g @elvis1513/auto-coding-skill
29
31
  python3 -m pip install PyYAML==6.0.3
30
32
  autocoding init
31
- autocoding sync --projects .
32
33
  ```
33
34
 
34
35
  The project install contains:
@@ -41,15 +42,17 @@ docs/tools/autopipeline/ap.py
41
42
  AGENTS.md (fully managed canonical repository contract)
42
43
  ```
43
44
 
44
- Ordinary projects no longer receive taskbook or closure logs. Existing optional
45
- documents are preserved during upgrades but are not required or updated by the
46
- normal workflow.
45
+ `autocoding init` also installs the exact shared documentation tree under
46
+ `docs/{architecture,bugs,deployment,design,interfaces,project,reviews,testing}`.
47
+ Managed templates are replaced; mutable project docs and valid architecture, ADR,
48
+ interface, DD, review, or deploy-record documents are preserved; unrelated
49
+ directories are archived under `.agents/archive/`. Re-running init is the complete upgrade operation;
50
+ `sync` and project-local `upgrade` are compatibility commands, not required steps.
47
51
 
48
52
  Fill the project/Jenkins/GitLab/Nexus URL, username, and password fields under
49
53
  `access.*`, then configure one real fast validation command and run:
50
54
 
51
55
  ```bash
52
- python3 docs/tools/autopipeline/ap.py upgrade --write
53
56
  python3 docs/tools/autopipeline/ap.py doctor
54
57
  ```
55
58
 
@@ -194,24 +197,43 @@ integration, push, and cleanup. Push ends the coding task; later CI/acceptance i
194
197
  not polled automatically. An explicitly requested failure diagnosis may continue
195
198
  in the same conversation/task without an artificial second ledger lifecycle.
196
199
 
197
- ## Upgrade and multi-project sync
200
+ ## Upgrade projects
198
201
 
199
- Finish every registered task using its currently installed runtime before syncing
200
- a different Skill version. Batch sync fails before any writes when it finds an
201
- active manifest, regardless of schema version.
202
+ Finish every registered task using its currently installed runtime before changing
203
+ the Skill version. Then run `autocoding init` from each project root. It is safe to
204
+ rerun and needs no force flag.
202
205
 
203
206
  ```bash
207
+ cd /path/a && autocoding init
208
+ cd /path/b && autocoding init
204
209
  autocoding status --projects /path/a,/path/b
205
- autocoding sync --projects /path/a,/path/b --dry-run
206
- autocoding sync --projects /path/a,/path/b
207
210
  ```
208
211
 
209
- Sync replaces the managed Skill directory, so missing files are restored and
210
- obsolete managed files are removed. It preserves project frontmatter, access
211
- values, custom role agents, explicit model overrides, optional documents, and
212
- project-specific facts outside the managed ENGINEERING block. Root `AGENTS.md` is
213
- replaced as a whole; its previous content is archived under
214
- `docs/archive/workflow/` as historical, non-authoritative context.
212
+ Init replaces the managed Skill, root `AGENTS.md`, managed agents, ENGINEERING
213
+ schema/body, runtime launcher, and documentation framework. It preserves explicit
214
+ model overrides and current values at supported project/access/concurrency/route
215
+ fields. Removed content is archived outside active docs.
216
+
217
+ ## What changed in 4.1.9
218
+
219
+ - Added a packaged managed-install manifest with path, version, content hash, and
220
+ executable-bit expectations for release-owned files.
221
+ - Made `autocoding init` verify the written Skill, managed agents, root protocol,
222
+ launcher, managed ENGINEERING region, and canonical templates before success.
223
+ - Made `doctor` recheck the local manifest and `status` compare it with the current
224
+ release while excluding project facts, durable records, custom agents, and archives.
225
+
226
+ ## What changed in 4.1.8
227
+
228
+ - Made `autocoding init` perform a complete project install or upgrade without a
229
+ separate sync/upgrade chain or `--force`.
230
+ - Rebuilt ENGINEERING from the current schema, preserving only supported project
231
+ values and removing unknown legacy fields and competing workflow text.
232
+ - Made the generated docs directory topology and managed templates identical
233
+ across projects while preserving mutable project docs and valid durable records;
234
+ obsolete paths are archived under `.agents/archive/` before removal.
235
+ - Made root AGENTS, managed agents, the Skill copy, and the project launcher fully
236
+ converge during init.
215
237
 
216
238
  ## What changed in 4.1.7
217
239
 
@@ -0,0 +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"]}
@@ -7,8 +7,9 @@ description: Optional delivery-first engineering workflow for repository changes
7
7
 
8
8
  ## Use the two authorities
9
9
 
10
- Read root `AGENTS.md` for the shared behavioral protocol and
11
- `docs/ENGINEERING.md` for project facts, access, risk, validation, and budgets.
10
+ Read root `AGENTS.md` for the shared behavioral protocol,
11
+ `docs/ENGINEERING.md` for access/risk/validation configuration, and
12
+ `docs/project/` for durable project facts.
12
13
  Do not reconstruct or duplicate those rules from historical task documents.
13
14
 
14
15
  Normal delivery is:
@@ -76,11 +77,14 @@ or design artifact. Terminal ledger reconciliation validates and commits once.
76
77
 
77
78
  ```bash
78
79
  autocoding init
79
- autocoding sync --projects .
80
- python3 docs/tools/autopipeline/ap.py upgrade --dry-run
81
- python3 docs/tools/autopipeline/ap.py upgrade --write
82
80
  python3 docs/tools/autopipeline/ap.py doctor
83
81
  ```
84
82
 
85
- Finish registered tasks before changing versions. Sync replaces root `AGENTS.md`,
86
- archives it, preserves project facts/access, and converges all managed assets.
83
+ Finish registered tasks before changing versions. `autocoding init` is idempotent
84
+ and performs the complete install/upgrade: it replaces every managed constraint,
85
+ preserves only schema-supported project values, installs the canonical docs
86
+ directory framework and managed templates, and archives obsolete content outside
87
+ active `docs/` while preserving valid architecture, ADR, interface, DD, review,
88
+ and deploy-record artifacts in their designated directories. It then verifies the
89
+ packaged managed-install manifest; `doctor` cheaply rechecks the same declared
90
+ paths without treating project-owned files or archives as a release mirror.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "managed_versions": {
4
- "agents": "4.1.7",
5
- "engineering": "4.1.7"
4
+ "agents": "4.1.9",
5
+ "engineering": "4.1.9"
6
6
  },
7
7
  "known_official_agents_sha256": [
8
8
  "ebaaadab60327b3a4852948443d7191a4d48cb00bf4910038ab78c9149089373"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  workflow:
3
- skill_version: "4.1.7"
3
+ skill_version: "4.1.9"
4
4
  mode: "dev"
5
5
  profile: "auto"
6
6
  completion: "push"
@@ -75,6 +75,7 @@ structure:
75
75
  layer_rules:
76
76
  enabled: true
77
77
  block: false
78
+ rules: []
78
79
 
79
80
  optimization:
80
81
  completion_policy: "no-new-debt"
@@ -84,8 +85,6 @@ optimization:
84
85
  docs:
85
86
  framework: "engineering-centered"
86
87
  design_dir: "docs/design"
87
- health_baseline: "docs/reviews/project-health-baseline.md"
88
- optimization_backlog: "docs/reviews/optimization-backlog.md"
89
88
  structure_standard: "docs/architecture/structure-standard.md"
90
89
  api_docs_required: false
91
90
  api_doc: "docs/interfaces/api.md"
@@ -94,11 +93,11 @@ docs:
94
93
 
95
94
  # Engineering Configuration and Project Facts
96
95
 
97
- <!-- auto-coding-skill:managed-workflow:start version=4.1.7 -->
96
+ <!-- auto-coding-skill:managed-workflow:start version=4.1.9 -->
98
97
 
99
98
  Root `AGENTS.md` is the single shared behavioral protocol. The installed
100
- `SKILL.md` contains invocation guidance. This file is the single source for the
101
- project-specific configuration and facts that neither file can infer.
99
+ `SKILL.md` contains invocation guidance. This file is the exact-schema source for
100
+ project workflow configuration and access values that neither file can infer.
102
101
 
103
102
  The frontmatter contract is:
104
103
 
@@ -112,25 +111,17 @@ The frontmatter contract is:
112
111
  - `risk`: project-specific signals that increase design/review depth but never
113
112
  expand the automatic local gate.
114
113
  - `structure` and `optimization`: advisory architecture and no-new-debt policy.
115
- - `docs`: locations of optional durable project artifacts.
114
+ - `docs`: locations inside the managed documentation directory framework.
116
115
 
117
- Run `python3 docs/tools/autopipeline/ap.py doctor` after changing frontmatter.
116
+ Run `python3 docs/tools/autopipeline/ap.py doctor` after changing frontmatter; it
117
+ also performs the bounded local managed-install integrity check.
118
118
  Do not put competing delivery flows, agent roles, lifecycle rules, gate semantics,
119
119
  or completion rules outside this managed block.
120
120
 
121
121
  <!-- auto-coding-skill:managed-workflow:end -->
122
122
 
123
- # Project Facts
123
+ # Project Facts Location
124
124
 
125
- Keep only current, project-specific facts here. Put larger material under
126
- `docs/project/` and link it from the relevant section.
127
-
128
- ## Product and domain boundaries
129
-
130
- ## Repository and ownership map
131
-
132
- ## Runtime and deployment topology
133
-
134
- ## External-system and real-device safety
135
-
136
- ## Interface and decision links
125
+ Keep durable project facts in the installed `docs/project/` files. Do not append
126
+ workflow rules or additional sections here; initialization owns this document's
127
+ schema and body.
@@ -1,4 +1,4 @@
1
- <!-- auto-coding-skill:managed-agents:start version=4.1.7 -->
1
+ <!-- auto-coding-skill:managed-agents:start version=4.1.9 -->
2
2
  # Shared Engineering Protocol
3
3
 
4
4
  This file is fully managed by `auto-coding-skill`. Keep project-specific facts,
@@ -11,7 +11,8 @@ Use this order when sources disagree:
11
11
  1. The current user request.
12
12
  2. Code, tests, schemas, migrations, and runtime configuration for behavior that
13
13
  exists now.
14
- 3. `docs/ENGINEERING.md` for project facts and workflow configuration.
14
+ 3. `docs/ENGINEERING.md` for workflow configuration and access values, then the
15
+ managed `docs/project/` files for durable project facts.
15
16
  4. Current interface documentation for intended contracts.
16
17
  5. Accepted DD/ADR for lasting decisions.
17
18
  6. Taskbooks, closures, reviews, and deployment records as history only.
@@ -110,10 +111,15 @@ failure may continue in the same conversation/task without a second lifecycle.
110
111
  ## Documentation and access
111
112
 
112
113
  - This AGENTS file is the single behavioral protocol. The installed `SKILL.md`
113
- contains invocation guidance. `docs/ENGINEERING.md` is the single project
114
- configuration and facts source. Do not repeat the protocol elsewhere.
115
- - Put larger product, repository, and runtime facts under `docs/project/` and link
116
- them from ENGINEERING.
114
+ contains invocation guidance. `docs/ENGINEERING.md` is the exact project
115
+ configuration source; `docs/project/` owns durable facts. Do not repeat the
116
+ protocol elsewhere.
117
+ - `autocoding init` owns the active `docs/` directory topology and managed
118
+ templates. Put durable facts into the installed project files. Architecture,
119
+ ADR, interface, DD, review, and deploy-record artifacts may use their designated
120
+ directories; unrelated directories are archived outside active docs on upgrade.
121
+ - The managed-install manifest owns only its declared files and exact namespaces.
122
+ Never treat the whole `.agents` or `docs` tree as a release-package mirror.
117
123
  - Ordinary work creates no taskbook, closure Markdown, evidence JSONL, active-task
118
124
  document, or design file. Machine coordination/evidence stays in Git
119
125
  common/local state and cannot change the reviewed diff.