@elvis1513/auto-coding-skill 4.2.5 → 4.2.6

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.2.5 keeps JSX self-closing and closing-tag slashes out of regex state.
12
+ Version 4.2.6 makes the managed structure/optimization description defer to
13
+ preserved project frontmatter instead of restating template defaults. Version
14
+ 4.2.5 keeps JSX self-closing and closing-tag slashes out of regex state.
13
15
  Version 4.2.4 fixes TypeScript function-body detection after an explicit return
14
16
  type. Version 4.2.3 restores an explicit opt-in strict size-warning policy without
15
17
  changing the default, makes semicolon-terminated Java/Kotlin imports visible to
@@ -291,6 +293,15 @@ model overrides, complete project `risk.rules`, supported project/access/
291
293
  concurrency/route/structure values, and an existing project-owned structure
292
294
  standard byte-for-byte. Removed content is archived outside active docs.
293
295
 
296
+ ## What changed in 4.2.6
297
+
298
+ - Made the managed `structure` / `optimization` description configuration-neutral:
299
+ the preserved project frontmatter is authoritative for enforcement and debt
300
+ completion policy.
301
+ - Added a 4.2.5-to-4.2.6 initialization regression that preserves strict
302
+ `blocking + baseline-aware` project settings and proves repeated init remains
303
+ byte-idempotent.
304
+
294
305
  ## What changed in 4.2.5
295
306
 
296
307
  - Prevented standalone JSX `/>` and closing-tag `</...>` slashes from starting a
@@ -1 +1 @@
1
- {"schema_version":1,"skill_version":"4.2.5","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.5"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"d68c472fab6aef7679330798d753b3c495515545522b6f0a54cabccc0f523c39","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"f4c5a340bf3387700385959848dbfa2cc4d90d1312f330d11b0cedc307426eb5","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json","source":"skill/data/contracts/orchestration-v1.schema.json","ownership":"exact","sha256":"0e8d5ebb06b47414be1218a1fc93cdbba94a7300fc7ba1c0e12d9c1ca60aeb43","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"2e312960a4778de96753590dbf6b910f505280fb418d86fc3e1d0b64b4ba1367","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"3f1aa5c89af4faa8738a3b348b3c977e4a5ce9084a0f526b8741d415c8518034","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"cfff9ef1e2575dfcd9701565240e9c59399ce67feb7a3c0902aee6dea25649b0","executable":false,"scope":"shared","version":"4.2.5"},{"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.5"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"7888829396f649e5eab4a81ede25be4e272e5947eb891f98f662286b53724076","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/scripts/core.py","source":"skill/scripts/core.py","ownership":"exact","sha256":"640c37e8b274d90d6b7765d4243e054360d5a5a85b3150fbfe6449527c1cd28f","executable":true,"scope":"shared","version":"4.2.5"},{"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.5"},{"path":".agents/skills/auto-coding-skill/scripts/install_integrity.py","source":"skill/scripts/install_integrity.py","ownership":"exact","sha256":"a9ca7bd67893bbd2d7b35ece30a40457f0cbcb9ae01580cfc5daca2cd96fd676","executable":false,"scope":"shared","version":"4.2.5"},{"path":".agents/skills/auto-coding-skill/scripts/scaffold_templates.py","source":"skill/scripts/scaffold_templates.py","ownership":"exact","sha256":"6f0ee92eff2d5db9627a64b332738c9c917a93cc559d5bbacf771c5966215821","executable":false,"scope":"shared","version":"4.2.5"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"cfff9ef1e2575dfcd9701565240e9c59399ce67feb7a3c0902aee6dea25649b0","executable":false,"scope":"project","version":"4.2.5"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md#managed-workflow","ownership":"managed-workflow","sha256":"7b88b6a5283fc2f5755933e182e0e80a1d72e13be13d16b417a75503ee1a9720","executable":false,"scope":"project","version":"4.2.5"},{"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.5"},{"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.5"},{"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.5"},{"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.5"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.2.5"}],"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/structure-standard.md","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.6","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.6"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"d68c472fab6aef7679330798d753b3c495515545522b6f0a54cabccc0f523c39","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"f4c5a340bf3387700385959848dbfa2cc4d90d1312f330d11b0cedc307426eb5","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json","source":"skill/data/contracts/orchestration-v1.schema.json","ownership":"exact","sha256":"0e8d5ebb06b47414be1218a1fc93cdbba94a7300fc7ba1c0e12d9c1ca60aeb43","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"82cc736ab7ee0decd781eeb7788cc2d25e040fc2fe9a13c55c3a63f3ba881942","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"1cf2d07cdcfc39b62182e2959565a042d1e1bb77580c0167643ee280a7aa9367","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"8516550c3f2c39d4cbc8713caa64c2232e3eebba3b4bf3de946984c738d0f91b","executable":false,"scope":"shared","version":"4.2.6"},{"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.6"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"48891548a624fc859f42e32b58f4acfd3ce36b07b68947ad74ccf3137815ebe5","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/scripts/core.py","source":"skill/scripts/core.py","ownership":"exact","sha256":"640c37e8b274d90d6b7765d4243e054360d5a5a85b3150fbfe6449527c1cd28f","executable":true,"scope":"shared","version":"4.2.6"},{"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.6"},{"path":".agents/skills/auto-coding-skill/scripts/install_integrity.py","source":"skill/scripts/install_integrity.py","ownership":"exact","sha256":"a9ca7bd67893bbd2d7b35ece30a40457f0cbcb9ae01580cfc5daca2cd96fd676","executable":false,"scope":"shared","version":"4.2.6"},{"path":".agents/skills/auto-coding-skill/scripts/scaffold_templates.py","source":"skill/scripts/scaffold_templates.py","ownership":"exact","sha256":"6f0ee92eff2d5db9627a64b332738c9c917a93cc559d5bbacf771c5966215821","executable":false,"scope":"shared","version":"4.2.6"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"8516550c3f2c39d4cbc8713caa64c2232e3eebba3b4bf3de946984c738d0f91b","executable":false,"scope":"project","version":"4.2.6"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md#managed-workflow","ownership":"managed-workflow","sha256":"ab40691526ced8a4b2e438b0d0f8b43d6ecf8d14e650580dc93f9548041d76f5","executable":false,"scope":"project","version":"4.2.6"},{"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.6"},{"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.6"},{"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.6"},{"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.6"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.2.6"}],"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/structure-standard.md","docs/architecture/adr/[0-9]*.md","docs/design/*.md","docs/interfaces/*.md","docs/deployment/deploy-records/*.md","docs/reviews/*.md"]}
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "managed_versions": {
4
- "agents": "4.2.5",
5
- "engineering": "4.2.5"
4
+ "agents": "4.2.6",
5
+ "engineering": "4.2.6"
6
6
  },
7
7
  "known_official_agents_sha256": [
8
8
  "ebaaadab60327b3a4852948443d7191a4d48cb00bf4910038ab78c9149089373"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  workflow:
3
- skill_version: "4.2.5"
3
+ skill_version: "4.2.6"
4
4
  mode: "dev"
5
5
  profile: "auto"
6
6
  completion: "push"
@@ -83,7 +83,7 @@ docs:
83
83
  api_change_log: "docs/interfaces/api-change-log.md"
84
84
  ---
85
85
  # Engineering Configuration and Project Facts
86
- <!-- auto-coding-skill:managed-workflow:start version=4.2.5 -->
86
+ <!-- auto-coding-skill:managed-workflow:start version=4.2.6 -->
87
87
  Root `AGENTS.md` is the single shared behavioral protocol. The installed
88
88
  `SKILL.md` contains invocation guidance. This file is the exact-schema source for
89
89
  project workflow configuration and access values that neither file can infer.
@@ -97,7 +97,7 @@ The frontmatter contract is:
97
97
  bound a slower command; commands inherit PATH and declare intentional activation.
98
98
  - `risk`: project-specific signals that increase design/review depth but never
99
99
  expand the automatic local gate.
100
- - `structure` and `optimization`: advisory architecture and no-new-debt policy.
100
+ - `structure` and `optimization`: project-selected enforcement and completion policy; frontmatter values are authoritative.
101
101
  - `docs`: locations inside the managed documentation directory framework.
102
102
  Run `python3 docs/tools/autopipeline/ap.py doctor` after changing frontmatter; it
103
103
  also performs the bounded local managed-install integrity check.
@@ -1,4 +1,4 @@
1
- <!-- auto-coding-skill:managed-agents:start version=4.2.5 -->
1
+ <!-- auto-coding-skill:managed-agents:start version=4.2.6 -->
2
2
  # Shared Engineering Protocol
3
3
 
4
4
  This file is fully managed by `auto-coding-skill`. Keep project-specific facts,
@@ -85,7 +85,7 @@ _FINAL_GATE_CACHE_ALGORITHM = "final-gate-v1"
85
85
  _WORKFLOW_MIGRATION_POLICY = Path("data/policies/workflow-migrations-v1.json")
86
86
  _FALLBACK_WORKFLOW_MIGRATION_POLICY = {
87
87
  "schema_version": 1,
88
- "managed_versions": {"agents": "4.2.5", "engineering": "4.2.5"},
88
+ "managed_versions": {"agents": "4.2.6", "engineering": "4.2.6"},
89
89
  "known_official_engineering_body_sha256": [
90
90
  "d1306cc626e8baf8c83c953b760fd771066de2bf125168eca3a7b7d6ff2b87a2",
91
91
  "305931c6edef770033a4f1970b00e5fb1c1728351856a173dbfa497daf563021",
@@ -1148,8 +1148,8 @@ def _migrate_fast_development_defaults(cfg: dict, repo: Path) -> list[str]:
1148
1148
  if _text(workflow_cfg.get("completion")).lower() != "push":
1149
1149
  workflow_cfg["completion"] = "push"
1150
1150
  changed.append("workflow.completion")
1151
- if _text(workflow_cfg.get("skill_version")) != "4.2.5":
1152
- workflow_cfg["skill_version"] = "4.2.5"
1151
+ if _text(workflow_cfg.get("skill_version")) != "4.2.6":
1152
+ workflow_cfg["skill_version"] = "4.2.6"
1153
1153
  changed.append("workflow.skill_version")
1154
1154
 
1155
1155
  commands_cfg = cfg.setdefault("commands", {})
@@ -1462,16 +1462,16 @@ def cmd_upgrade(args: argparse.Namespace) -> None:
1462
1462
  if current_agents:
1463
1463
  archive_dir = repo / "docs" / "archive" / "workflow"
1464
1464
  archive_header = (
1465
- "# Archived AGENTS.md before auto-coding-skill 4.2.5\n\n"
1465
+ "# Archived AGENTS.md before auto-coding-skill 4.2.6\n\n"
1466
1466
  "This file is historical and non-authoritative. The root AGENTS.md is fully managed.\n"
1467
1467
  "Move any still-current project facts into docs/ENGINEERING.md or docs/project/,\n"
1468
1468
  "without copying workflow rules back into the root AGENTS.md.\n\n---\n\n"
1469
1469
  )
1470
1470
  archive_content = archive_header + current_agents
1471
- archive = archive_dir / "AGENTS.pre-4.2.5.md"
1471
+ archive = archive_dir / "AGENTS.pre-4.2.6.md"
1472
1472
  if archive.exists() and archive.read_text(encoding="utf-8") != archive_content:
1473
1473
  digest = hashlib.sha256(current_agents.encode("utf-8")).hexdigest()[:12]
1474
- archive = archive_dir / f"AGENTS.pre-4.2.5-{digest}.md"
1474
+ archive = archive_dir / f"AGENTS.pre-4.2.6-{digest}.md"
1475
1475
  if not archive.exists():
1476
1476
  add_action("policy", archive, "archive", "historical and non-authoritative")
1477
1477
  if write:
@@ -314,7 +314,7 @@ function testInitFullyConvergesExistingProject() {
314
314
  }
315
315
  assert(exists(path.join(repo, ".agents", "agents", "custom.toml")), "project-owned custom agents must survive init");
316
316
  assert(!exists(path.join(repo, ".agents", "skills", "auto-coding-skill", "obsolete.txt")), "extra Skill files must be removed");
317
- assert(exists(path.join(repo, ".agents", "archive", "auto-coding-skill", "4.2.5", "docs", "legacy", "old-taskbook.md")), "removed docs must be archived outside active docs");
317
+ assert(exists(path.join(repo, ".agents", "archive", "auto-coding-skill", "4.2.6", "docs", "legacy", "old-taskbook.md")), "removed docs must be archived outside active docs");
318
318
  assert(fs.readFileSync(structureStandard, "utf8") === customStructureStandard, "init must preserve a project-owned structure standard");
319
319
  assert(fs.readFileSync(path.join(repo, "docs", "architecture", "adr", "0042-project-choice.md"), "utf8").includes("Keep me"), "numbered ADR artifacts must survive init");
320
320
  assert(fs.readFileSync(path.join(repo, "docs", "architecture", "system-context.md"), "utf8").includes("Keep me"), "architecture artifacts must survive init");
@@ -373,6 +373,43 @@ function testStructureBlockWarningsDefaultsPreserveAndConverge() {
373
373
  );
374
374
  }
375
375
 
376
+ function testManagedPolicySummaryPreservesProjectConfiguration() {
377
+ const repo = tmpdir("managed-policy-summary");
378
+ run("node", [cli, "init"], { cwd: repo });
379
+ const engineering = path.join(repo, "docs", "ENGINEERING.md");
380
+ const current = fs.readFileSync(engineering, "utf8");
381
+ const neutralSummary = "- `structure` and `optimization`: project-selected enforcement and completion policy; frontmatter values are authoritative.";
382
+ const legacySummary = "- `structure` and `optimization`: advisory architecture and no-new-debt policy.";
383
+ const customized = current
384
+ .replace(/^ skill_version:.*$/m, " skill_version: 4.2.5")
385
+ .replace("managed-workflow:start version=4.2.6", "managed-workflow:start version=4.2.5")
386
+ .replace(neutralSummary, legacySummary)
387
+ .replace(/^ enforcement:.*$/m, " enforcement: blocking")
388
+ .replace(" block_warnings: false", " block_warnings: true")
389
+ .replace(" block: false", " block: true")
390
+ .replace(/^ completion_policy:.*$/m, " completion_policy: baseline-aware")
391
+ .replace(" require_baseline_for_global_review: false", " require_baseline_for_global_review: true")
392
+ .replace(" report_accepted_debt_as_findings: false", " report_accepted_debt_as_findings: true");
393
+ assert(customized !== current && customized.includes(legacySummary), "fixture must represent the 4.2.5 managed summary");
394
+ writeFile(engineering, customized);
395
+ const beforeUpgrade = readEngineeringConfig(engineering);
396
+ assert(beforeUpgrade.workflow?.skill_version === "4.2.5", "fixture must identify the previous workflow version");
397
+ assert(beforeUpgrade.structure?.enforcement === "blocking", "fixture must enable blocking structure enforcement");
398
+ assert(beforeUpgrade.optimization?.completion_policy === "baseline-aware", "fixture must enable baseline-aware completion");
399
+
400
+ run("node", [cli, "init"], { cwd: repo });
401
+ const upgraded = fs.readFileSync(engineering, "utf8");
402
+ const afterUpgrade = readEngineeringConfig(engineering);
403
+ assert(afterUpgrade.workflow?.skill_version === "4.2.6", "init must upgrade the workflow version");
404
+ assert(canonicalJson(afterUpgrade.structure) === canonicalJson(beforeUpgrade.structure), "init must preserve the complete project structure policy");
405
+ assert(canonicalJson(afterUpgrade.optimization) === canonicalJson(beforeUpgrade.optimization), "init must preserve the complete project optimization policy");
406
+ assert(upgraded.includes(neutralSummary), "upgraded managed text must defer to frontmatter policy");
407
+ assert(!upgraded.includes(legacySummary), "upgraded managed text must remove the hard-coded default policy description");
408
+
409
+ run("node", [cli, "init"], { cwd: repo });
410
+ assert(fs.readFileSync(engineering, "utf8") === upgraded, "repeated init must be byte-idempotent after the policy-summary upgrade");
411
+ }
412
+
376
413
  function testInitRejectsMissingPythonRuntimeBeforeWrites() {
377
414
  if (process.platform === "win32") return;
378
415
  const repo = tmpdir("missing-python-runtime");
@@ -979,7 +1016,7 @@ function testManagedEngineeringInitIsAuthoritativeAndIdempotent() {
979
1016
 
980
1017
  const engineering = path.join(repo, "docs", "ENGINEERING.md");
981
1018
  const initial = fs.readFileSync(engineering, "utf8");
982
- const startPattern = /<!-- auto-coding-skill:managed-workflow:start version=4\.2\.5 -->/;
1019
+ const startPattern = /<!-- auto-coding-skill:managed-workflow:start version=4\.2\.6 -->/;
983
1020
  const endMarker = "<!-- auto-coding-skill:managed-workflow:end -->";
984
1021
  assert(startPattern.test(initial), "new projects should include a versioned managed workflow marker");
985
1022
  assert(initial.includes(endMarker), "new projects should include the managed workflow end marker");
@@ -993,21 +1030,21 @@ function testManagedEngineeringInitIsAuthoritativeAndIdempotent() {
993
1030
  const dryRun = run("node", [cli, "sync", "--projects", repo, "--dry-run", "--json"]);
994
1031
  const dryResult = JSON.parse(dryRun.stdout).results[0];
995
1032
  assert(dryResult.managedWorkflow.state === "stale", `dry-run should expose stale workflow state: ${dryRun.stdout}`);
996
- assert(dryResult.managedWorkflow.version === "4.2.5", "dry-run should expose the target workflow version");
1033
+ assert(dryResult.managedWorkflow.version === "4.2.6", "dry-run should expose the target workflow version");
997
1034
  assert(dryResult.actions.some(item => item.action === "would-update" && item.path === "docs/ENGINEERING.md"), "dry-run should plan the managed body update");
998
1035
  assert(fs.readFileSync(engineering, "utf8") === customized, "dry-run must not write ENGINEERING.md");
999
1036
 
1000
1037
  run("node", [cli, "init"], { cwd: repo });
1001
1038
  const updated = fs.readFileSync(engineering, "utf8");
1002
1039
  assert(!updated.includes("project note before") && !updated.includes("project note after"), "init must remove text outside the canonical ENGINEERING body");
1003
- assert(updated.includes("version=4.2.5"), "init should install the current managed workflow version");
1040
+ assert(updated.includes("version=4.2.6"), "init should install the current managed workflow version");
1004
1041
  assert(updated.includes("The frontmatter contract is:"), "init should refresh stale managed workflow content");
1005
1042
 
1006
1043
  fillRequiredAccess(repo);
1007
1044
  const status = run("node", [cli, "status", "--projects", repo, "--json"]);
1008
1045
  const statusResult = JSON.parse(status.stdout).results[0];
1009
1046
  assert(statusResult.managedWorkflow.state === "current", `status should expose current managed workflow state: ${status.stdout}`);
1010
- assert(statusResult.managedWorkflow.version === "4.2.5", "status should expose the installed managed workflow version");
1047
+ assert(statusResult.managedWorkflow.version === "4.2.6", "status should expose the installed managed workflow version");
1011
1048
 
1012
1049
  const beforeSecondInit = fs.readFileSync(engineering, "utf8");
1013
1050
  run("node", [cli, "init"], { cwd: repo });
@@ -1034,7 +1071,7 @@ function testLegacyEngineeringMigrationPreservesExistingBody() {
1034
1071
  assert(dryResult.actions.find(item => item.path === "docs/ENGINEERING.md")?.detail.includes("preserved-custom"), "custom legacy action should be labeled preserved-custom");
1035
1072
  run("node", [cli, "sync", "--projects", repo]);
1036
1073
  const migrated = fs.readFileSync(engineering, "utf8");
1037
- assert(migrated.includes("version=4.2.5"), "legacy migration should insert the current managed workflow");
1074
+ assert(migrated.includes("version=4.2.6"), "legacy migration should insert the current managed workflow");
1038
1075
  assert(migrated.includes(legacyNote), "legacy migration must preserve the complete existing body");
1039
1076
  const stable = fs.readFileSync(engineering, "utf8");
1040
1077
  run("node", [cli, "sync", "--projects", repo]);
@@ -1134,7 +1171,7 @@ function testManagedAgentsMigrationReplacesWholeFileAndArchivesPreviousRules() {
1134
1171
  run("node", [cli, "sync", "--projects", repo]);
1135
1172
  const agents = path.join(repo, "AGENTS.md");
1136
1173
  const initial = fs.readFileSync(agents, "utf8");
1137
- assert(initial.includes("managed-agents:start version=4.2.5"), "new projects should receive the versioned root AGENTS block");
1174
+ assert(initial.includes("managed-agents:start version=4.2.6"), "new projects should receive the versioned root AGENTS block");
1138
1175
 
1139
1176
  const custom = [
1140
1177
  "# Project rules",
@@ -1153,12 +1190,12 @@ function testManagedAgentsMigrationReplacesWholeFileAndArchivesPreviousRules() {
1153
1190
 
1154
1191
  run("node", [cli, "sync", "--projects", repo]);
1155
1192
  const migrated = fs.readFileSync(agents, "utf8");
1156
- assert(migrated.includes("managed-agents:start version=4.2.5"), "AGENTS migration should install the current managed block");
1193
+ assert(migrated.includes("managed-agents:start version=4.2.6"), "AGENTS migration should install the current managed block");
1157
1194
  assert(!migrated.includes("Preserve this repository-specific rule exactly."), "root AGENTS must contain no project-specific tail");
1158
1195
  assert(!migrated.includes("must execute `commands.gate_full`"), "known official conflicting rule should be removed");
1159
1196
  const canonical = fs.readFileSync(path.join(repoRoot, "cli", "assets", "skill", "data", "templates", "bridges", "AGENTS.md"), "utf8");
1160
1197
  assert(migrated === canonical, "root AGENTS must be byte-identical to the packaged canonical file");
1161
- const archive = path.join(repo, "docs", "archive", "workflow", "AGENTS.pre-4.2.5.md");
1198
+ const archive = path.join(repo, "docs", "archive", "workflow", "AGENTS.pre-4.2.6.md");
1162
1199
  assert(fs.readFileSync(archive, "utf8").includes("Preserve this repository-specific rule exactly."), "previous AGENTS content must be archived once");
1163
1200
  const stable = fs.readFileSync(agents);
1164
1201
  run("node", [cli, "sync", "--projects", repo]);
@@ -1215,7 +1252,7 @@ function testEngineeringFrameworkRejectsAnyNonCanonicalWorkflowText() {
1215
1252
 
1216
1253
  run("node", [cli, "init"], { cwd: repo });
1217
1254
  assert(!fs.readFileSync(engineering, "utf8").includes("backend owns APIs"), "init must restore the canonical ENGINEERING body");
1218
- const archived = path.join(repo, ".agents", "archive", "auto-coding-skill", "4.2.5", "docs", "ENGINEERING.md");
1255
+ const archived = path.join(repo, ".agents", "archive", "auto-coding-skill", "4.2.6", "docs", "ENGINEERING.md");
1219
1256
  assert(fs.readFileSync(archived, "utf8").includes("backend owns APIs"), "removed project text should remain in non-authoritative history");
1220
1257
  }
1221
1258
 
@@ -1227,12 +1264,12 @@ function testManagedInstallIntegrityIsBoundedAndRepairable() {
1227
1264
 
1228
1265
  const manifestPath = path.join(repo, ".agents", "managed-install.json");
1229
1266
  const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
1230
- assert(manifest.schema_version === 1 && manifest.skill_version === "4.2.5", "installed manifest must identify the release");
1267
+ assert(manifest.schema_version === 1 && manifest.skill_version === "4.2.6", "installed manifest must identify the release");
1231
1268
  assert(manifest.entries.length > 0, "installed manifest must list managed files");
1232
1269
  for (const entry of manifest.entries) {
1233
1270
  assert(typeof entry.path === "string" && !path.isAbsolute(entry.path) && !entry.path.includes(".."), "manifest paths must be safe relative paths");
1234
1271
  assert(/^[0-9a-f]{64}$/.test(entry.sha256), `${entry.path}: manifest hash must be sha256`);
1235
- assert(entry.version === "4.2.5" && typeof entry.executable === "boolean", `${entry.path}: version/executable metadata missing`);
1272
+ assert(entry.version === "4.2.6" && typeof entry.executable === "boolean", `${entry.path}: version/executable metadata missing`);
1236
1273
  }
1237
1274
  assert(!manifest.managed_namespaces.some(item => item.path === ".agents" || item.path === "docs"), "manifest must not mirror entire project-owned trees");
1238
1275
 
@@ -1302,14 +1339,14 @@ function testManagedInstallIntegrityIsBoundedAndRepairable() {
1302
1339
  }
1303
1340
 
1304
1341
  function testReleaseVersionMarkersStayInSync() {
1305
- const expected = "4.2.5";
1342
+ const expected = "4.2.6";
1306
1343
  const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, "package.json"), "utf8"));
1307
1344
  const lock = JSON.parse(fs.readFileSync(path.join(repoRoot, "package-lock.json"), "utf8"));
1308
1345
  const policy = JSON.parse(fs.readFileSync(
1309
1346
  path.join(repoRoot, "src", "auto-coding-skill", "data", "policies", "workflow-migrations-v1.json"),
1310
1347
  "utf8",
1311
1348
  ));
1312
- assert(pkg.version === expected, "package version must match the 4.2.5 release");
1349
+ assert(pkg.version === expected, "package version must match the 4.2.6 release");
1313
1350
  assert(lock.version === expected && lock.packages[""].version === expected, "package-lock versions must match");
1314
1351
  assert(policy.managed_versions.engineering === expected && policy.managed_versions.agents === expected, "managed workflow versions must match");
1315
1352
  const manifest = JSON.parse(fs.readFileSync(path.join(repoRoot, "cli", "assets", "managed-install.json"), "utf8"));
@@ -1345,10 +1382,13 @@ function testProtocolResponsibilitiesStaySeparated() {
1345
1382
  assert(agents.includes("## Minimum mechanism budget") && agents.includes("## Bounded real validation"), "AGENTS must remain the behavioral protocol");
1346
1383
  assert(skill.includes("## Select the minimum mechanism set") && !skill.includes("## Authority"), "SKILL must remain invocation guidance");
1347
1384
  assert(engineering.includes("The frontmatter contract is:") && !engineering.includes("## Git and parallel work"), "ENGINEERING must remain project configuration/facts");
1385
+ assert(engineering.includes("frontmatter values are authoritative"), "ENGINEERING policy summary must defer to project frontmatter");
1386
+ assert(!engineering.includes("advisory architecture and no-new-debt policy"), "ENGINEERING policy summary must not hard-code template defaults");
1348
1387
  }
1349
1388
 
1350
1389
  testInitFullyConvergesExistingProject();
1351
1390
  testStructureBlockWarningsDefaultsPreserveAndConverge();
1391
+ testManagedPolicySummaryPreservesProjectConfiguration();
1352
1392
  testInitRejectsMissingPythonRuntimeBeforeWrites();
1353
1393
  testDestVariants();
1354
1394
  testLauncherFallsBackToGlobalRuntime();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@elvis1513/auto-coding-skill",
3
- "version": "4.2.5",
3
+ "version": "4.2.6",
4
4
  "description": "CLI installer for a delivery-first .agents workflow with adaptive Git isolation, routed changed-scope validation, risk-based review, push completion, and safe cleanup.",
5
5
  "type": "module",
6
6
  "bin": {