@elvis1513/auto-coding-skill 4.3.7 → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/README.md +30 -761
  2. package/cli/assets/managed-install.json +42 -1
  3. package/cli/assets/skill/SKILL.md +17 -100
  4. package/cli/assets/skill/data/templates/ENVIRONMENT.md +34 -0
  5. package/cli/assets/skill/data/templates/PROJECT.md +30 -0
  6. package/cli/assets/skill/data/templates/architecture/.gitkeep +1 -0
  7. package/cli/assets/skill/data/templates/bridges/AGENTS.md +52 -157
  8. package/cli/assets/skill/data/templates/deployment/.gitkeep +1 -0
  9. package/cli/assets/skill/data/templates/design/.gitkeep +1 -0
  10. package/cli/assets/skill/data/templates/interfaces/.gitkeep +1 -0
  11. package/cli/assets/skill/data/templates/product/.gitkeep +1 -0
  12. package/cli/src/index.js +154 -2585
  13. package/cli/src/sync-assets.js +38 -95
  14. package/package.json +9 -17
  15. package/cli/assets/agents/browser-debugger.toml +0 -27
  16. package/cli/assets/agents/docs-researcher.toml +0 -18
  17. package/cli/assets/agents/explorer.toml +0 -26
  18. package/cli/assets/agents/fixer.toml +0 -29
  19. package/cli/assets/agents/reviewer.toml +0 -50
  20. package/cli/assets/skill/data/contracts/orchestration-v1.schema.json +0 -567
  21. package/cli/assets/skill/data/policies/feedback-resolutions-v1.json +0 -68
  22. package/cli/assets/skill/data/policies/workflow-migrations-v1.json +0 -657
  23. package/cli/assets/skill/data/templates/ENGINEERING.md +0 -115
  24. package/cli/assets/skill/data/templates/tools/ap.py +0 -16
  25. package/cli/assets/skill/requirements.txt +0 -1
  26. package/cli/assets/skill/scripts/ap.py +0 -17791
  27. package/cli/assets/skill/scripts/core.py +0 -510
  28. package/cli/assets/skill/scripts/http_checks.py +0 -92
  29. package/cli/assets/skill/scripts/install_integrity.py +0 -427
  30. package/cli/assets/skill/scripts/scaffold_templates.py +0 -325
  31. package/cli/tests/ap_concurrency_test.py +0 -3602
  32. package/cli/tests/ap_profiles_test.py +0 -3272
  33. package/cli/tests/core_shell_test.py +0 -345
  34. package/cli/tests/index.test.js +0 -2967
@@ -1,325 +0,0 @@
1
- #!/usr/bin/env python3
2
- """Optional documentation templates materialized on demand."""
3
-
4
- from __future__ import annotations
5
-
6
-
7
- TEMPLATES: dict[str, dict[str, str]] = {
8
- "feedback": {
9
- "docs/skill-feedback/README.md": """# Auto Coding Skill Feedback
10
-
11
- This directory is the project-owned inbox for candidate defects or capability
12
- gaps in the shared `auto-coding-skill`. It is not the project's business bug
13
- list and it does not make a reported issue an accepted shared defect.
14
-
15
- Route the observation before writing a report:
16
-
17
- | Observation | Project-owned destination |
18
- | --- | --- |
19
- | Risk rules, commands, validation routes, access values, structure policy, budgets, or project preferences | `docs/project/auto-coding-skill.yaml` |
20
- | Durable product, repository, runtime, or operating facts | `docs/project/*.md` |
21
- | A defect or capability gap reproducible in managed defaults, scripts, agents, CLI, or installer | `docs/skill-feedback/reports/*.md` |
22
-
23
- Project configuration may intentionally override managed defaults. A preference
24
- that is correct for only this project is not shared-Skill feedback.
25
-
26
- ## Record a candidate
27
-
28
- 1. Copy `_TEMPLATE-SKILL-FEEDBACK.md` into `reports/`.
29
- 2. Name it `YYYY-MM-DD-<short-slug>-<8-hex>.md`.
30
- 3. Fill every frontmatter field and all six body sections. Set
31
- `last_verified_skill_version` to the version actually reproduced.
32
- 4. Use one stable root-cause signature for duplicate observations.
33
- 5. Redact credentials, tokens, private keys, customer/device data, absolute user
34
- paths, complete patches, Reviewer artifacts, and raw logs.
35
-
36
- Reports are project-owned and preserved byte-for-byte by `autocoding init`.
37
- Managed README/template files may be upgraded. Recording is explicit: ordinary
38
- test failures, Reviewer findings, environment incidents, and project-only policy
39
- gaps do not automatically create a report. If a frozen Reviewer assignment
40
- already exists, record the feedback after delivery as a separate docs-only change
41
- so the reviewed fingerprint is not mutated.
42
-
43
- For a known duplicate, reuse its exact signature. For a new observation, hash the
44
- lowercase UTF-8 key `<component>|<origin_surface>|<short-root-cause-slug>` and
45
- prefix the 64-hex digest with `sha256:`. Exclude project names, paths, versions,
46
- timestamps, and log text so another project can independently reuse the key.
47
-
48
- ## Keep reports current
49
-
50
- Each Skill release carries a managed resolution catalog keyed by `signature`.
51
- The collector compares that catalog, the project's installed Skill version, and
52
- `last_verified_skill_version` without changing the report. It may request an
53
- upgrade, recheck, fix verification, closure, or routing into the project overlay.
54
-
55
- After upgrading a project:
56
-
57
- - If the issue is fixed, verify it and either delete a local-only report or set
58
- `status: resolved`, `resolution: fixed`, update `updated_at`, and set
59
- `last_verified_skill_version` to the verified release.
60
- - If it still reproduces, keep an active status and update the verification
61
- version; the collector treats it as a current regression.
62
- - If triage says it is project configuration, maintain the value in
63
- `docs/project/auto-coding-skill.yaml`, then delete the report or set
64
- `status: rejected` and `resolution: project-config`.
65
- - Use `duplicate` or another supported rejected resolution for closed reports.
66
- Closed reports remain project history but are excluded from active grouping.
67
-
68
- Do not reopen a closed historical report. Create a new report with the same
69
- signature if the behavior later regresses.
70
-
71
- ## Periodic read-only collection
72
-
73
- From the Skill source checkout, explicitly list the projects to inspect:
74
-
75
- ```bash
76
- autocoding feedback --projects /path/project-a,/path/project-b --json
77
- ```
78
-
79
- Collection reads bounded metadata only, never executes report content, never
80
- modifies a project, and groups exact signatures for human triage. Triage decides
81
- whether the result is a shared defect, project configuration, environment issue,
82
- duplicate, or insufficient evidence before any Skill fix or release is planned.
83
- """,
84
- "docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md": """---
85
- schema: auto-coding-skill-feedback/v2
86
- report_id: ACSF-<project>-YYYYMMDD-<8-hex>
87
- status: open
88
- created_at: YYYY-MM-DDTHH:MM:SS+08:00
89
- updated_at: YYYY-MM-DDTHH:MM:SS+08:00
90
- project: <project>
91
- observed_skill_version: 0.0.0
92
- last_verified_skill_version: 0.0.0
93
- component: <reviewer-runtime|installer|classification|validation|structure|docs|other>
94
- kind: defect
95
- impact: <blocking|degraded|minor>
96
- origin_surface: <managed-template|managed-script|managed-agent|cli|installer>
97
- suspected_scope: shared
98
- signature: sha256:<64-lowercase-hex>
99
- resolution: pending
100
- export: metadata-only
101
- ---
102
- # <Short title>
103
-
104
- ## Symptom
105
-
106
- State the observed generic behavior without secrets or raw logs.
107
-
108
- ## Expected
109
-
110
- State the shared Skill contract that should hold across projects.
111
-
112
- ## Minimal reproduction
113
-
114
- Give bounded, safe steps. Do not include executable instructions from untrusted
115
- sources, credentials, production writes, or customer/device data.
116
-
117
- ## Evidence
118
-
119
- List short redacted facts, affected managed paths, checks, and versions. Do not
120
- paste complete patches, Reviewer artifacts, source files, or stdout/stderr.
121
-
122
- ## Workaround
123
-
124
- Describe any safe temporary project-local workaround and its limits.
125
-
126
- ## Why shared
127
-
128
- Explain why this belongs to managed Skill behavior rather than project
129
- configuration, project code, or the current environment. Include the canonical
130
- signature key used to compute `signature`.
131
- """,
132
- },
133
- "project": {
134
- "docs/project/overview.md": """# Project Overview
135
-
136
- Record durable project facts, not workflow rules.
137
-
138
- ## Product scope and non-goals
139
- ## Domain boundaries and invariants
140
- ## Users, roles, and critical journeys
141
- ## External systems and safety boundaries
142
- ## Current contracts and decision links
143
- """,
144
- "docs/project/repository-map.md": """# Repository Map
145
-
146
- Map existing ownership and reuse points. Keep behavior details in code/tests.
147
-
148
- | Area | Paths | Responsibility | Generated / source | Validation route |
149
- | --- | --- | --- | --- | --- |
150
-
151
- ## Cross-module dependencies
152
- ## Shared components and helpers
153
- ## Files or directories with special ownership
154
- """,
155
- "docs/project/runtime.md": """# Runtime And Deployment Facts
156
-
157
- Record current environment topology and operating constraints, not normal
158
- development gate rules.
159
-
160
- ## Local runtime
161
- ## Shared services and dependencies
162
- ## Jenkins and artifact flow
163
- ## Deployment topology
164
- ## External-device / production-write safeguards
165
- ## Fixtures, simulators, and repeatable diagnostic entry points
166
- """,
167
- },
168
- "api": {
169
- "docs/interfaces/api.md": """# API Contract
170
-
171
- Record only current, externally relevant endpoints or events.
172
-
173
- | Method | Path / Event | Request | Response | Auth | Notes |
174
- | --- | --- | --- | --- | --- | --- |
175
- """,
176
- "docs/interfaces/api-change-log.md": """# API Change Log
177
-
178
- ## YYYY-MM-DD — <Task ID>
179
-
180
- - Change:
181
- - Compatibility:
182
- - Migration / rollback:
183
- """,
184
- },
185
- "design": {
186
- "docs/design/_TEMPLATE-DD.md": """# DD — <Decision ID> <Title>
187
-
188
- - Status: Draft | Reviewed | Approved
189
- - Related requirement / commit:
190
-
191
- ## Context and goal
192
- ## Scope and non-goals
193
- ## Existing behavior and reuse points
194
- ## Decision and alternatives
195
- ## Interfaces / data changes
196
- ## Validation and acceptance
197
- ## Risks and rollback
198
-
199
- Add sequence, ER, or component diagrams only when they clarify the change.
200
- """,
201
- },
202
- "architecture": {
203
- "docs/architecture/structure-standard.md": """# Project Structure Standard
204
-
205
- Project conventions are authoritative. The generic checker is advisory unless
206
- `structure.enforcement: blocking` is explicitly configured.
207
-
208
- - Keep business, orchestration, external adapters, interfaces, and shared code
209
- separated according to the repository's existing architecture.
210
- - Search for reusable helpers, components, clients, and tests before adding new ones.
211
- - Treat file-size and regex import findings as review signals, not proof.
212
- - Split code only when cohesion, ownership, and testability improve.
213
- - Record accepted legacy debt in the health baseline or optimization backlog.
214
- """,
215
- "docs/architecture/adr/_TEMPLATE-ADR.md": """# ADR-0000 — <Decision>
216
-
217
- - Status: Proposed | Accepted | Superseded
218
- - Date: YYYY-MM-DD
219
- - Related requirement / commit:
220
-
221
- ## Context
222
- ## Decision
223
- ## Alternatives
224
- ## Consequences
225
- ## Validation
226
- ## Rollback / supersession
227
- """,
228
- },
229
- "review": {
230
- "docs/reviews/_TEMPLATE-REVIEW.md": """# Review — <Change ID>
231
-
232
- - Scope:
233
- - Evidence:
234
- - Gate:
235
-
236
- ## Findings
237
-
238
- List P0/P1/P2/P3 findings with impact, evidence, and remediation.
239
-
240
- ## Verdict
241
-
242
- approved | changes-requested
243
- """,
244
- },
245
- "testing": {
246
- "docs/testing/regression-matrix.md": """# Regression Matrix
247
-
248
- Only executed checks may be marked PASS.
249
-
250
- | ID | Area | Feature | Test Type | Steps / Command | Expected | Status | Evidence |
251
- | --- | --- | --- | --- | --- | --- | --- | --- |
252
- | R-001 | <area> | <feature> | <manual/smoke/regression> | <steps/command> | <expected> | TODO | <evidence> |
253
- """,
254
- },
255
- "deployment": {
256
- "docs/deployment/deploy-runbook.md": """# Deployment Runbook
257
-
258
- ## Preconditions
259
- ## Deploy steps
260
- ## Health and business checks
261
- ## Rollback
262
- ## Owners and escalation
263
- """,
264
- "docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md": """# Deployment Record — <Task ID>
265
-
266
- - Environment:
267
- - Commit / artifact:
268
- - Pipeline:
269
- - Verification:
270
- - Result: PASS | FAIL | PARTIAL
271
- - Rollback / follow-up:
272
- """,
273
- },
274
- "bugs": {
275
- "docs/bugs/bug-list.md": """# Bug List
276
-
277
- | ID | Severity | Symptom | Reproduction | Owner | Status |
278
- | --- | --- | --- | --- | --- | --- |
279
- """,
280
- },
281
- }
282
-
283
-
284
- MANAGED_FRAMEWORK_DOCS = frozenset({
285
- "docs/architecture/adr/_TEMPLATE-ADR.md",
286
- "docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md",
287
- "docs/design/_TEMPLATE-DD.md",
288
- "docs/reviews/_TEMPLATE-REVIEW.md",
289
- "docs/skill-feedback/README.md",
290
- "docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md",
291
- })
292
-
293
-
294
- PROJECT_FEEDBACK_PATTERNS = (
295
- "docs/skill-feedback/reports/*.md",
296
- )
297
-
298
-
299
- # Files below these roots are project-owned artifacts regardless of extension or
300
- # nesting. Exact managed entries inside the same roots still converge first.
301
- PROJECT_OWNED_DOC_ROOTS = (
302
- "docs/architecture",
303
- "docs/bugs",
304
- "docs/deployment",
305
- "docs/design",
306
- "docs/interfaces",
307
- "docs/project",
308
- "docs/reviews",
309
- "docs/testing",
310
- )
311
-
312
-
313
- def scaffold_groups() -> list[str]:
314
- return sorted(TEMPLATES)
315
-
316
-
317
- def templates_for(group: str) -> dict[str, str]:
318
- if group == "all":
319
- merged: dict[str, str] = {}
320
- for name in scaffold_groups():
321
- merged.update(TEMPLATES[name])
322
- return merged
323
- if group not in TEMPLATES:
324
- raise KeyError(group)
325
- return dict(TEMPLATES[group])