mustflow 2.115.4 → 2.115.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/package.json +1 -1
- package/templates/default/i18n.toml +52 -22
- package/templates/default/locales/en/.mustflow/docs/agent-workflow.md +13 -1
- package/templates/default/locales/en/.mustflow/skills/INDEX.md +16 -8
- package/templates/default/locales/en/.mustflow/skills/ada-code-change/SKILL.md +293 -0
- package/templates/default/locales/en/.mustflow/skills/astro-code-change/SKILL.md +10 -2
- package/templates/default/locales/en/.mustflow/skills/completion-evidence-gate/SKILL.md +14 -1
- package/templates/default/locales/en/.mustflow/skills/core-web-vitals-field-review/SKILL.md +2 -2
- package/templates/default/locales/en/.mustflow/skills/deno-code-change/SKILL.md +291 -0
- package/templates/default/locales/en/.mustflow/skills/dependency-upgrade-review/SKILL.md +12 -6
- package/templates/default/locales/en/.mustflow/skills/elysia-code-change/SKILL.md +3 -3
- package/templates/default/locales/en/.mustflow/skills/hono-code-change/SKILL.md +2 -2
- package/templates/default/locales/en/.mustflow/skills/instruction-conflict-scope-check/SKILL.md +23 -12
- package/templates/default/locales/en/.mustflow/skills/nestjs-code-change/SKILL.md +5 -7
- package/templates/default/locales/en/.mustflow/skills/node-code-change/SKILL.md +2 -2
- package/templates/default/locales/en/.mustflow/skills/pascal-code-change/SKILL.md +301 -0
- package/templates/default/locales/en/.mustflow/skills/php-code-change/SKILL.md +327 -0
- package/templates/default/locales/en/.mustflow/skills/python-code-change/SKILL.md +11 -7
- package/templates/default/locales/en/.mustflow/skills/release-publish-change/SKILL.md +13 -5
- package/templates/default/locales/en/.mustflow/skills/routes.toml +30 -0
- package/templates/default/locales/en/.mustflow/skills/skill-authoring/SKILL.md +35 -9
- package/templates/default/locales/en/.mustflow/skills/skill-refresh/SKILL.md +10 -1
- package/templates/default/locales/en/.mustflow/skills/source-freshness-check/SKILL.md +13 -6
- package/templates/default/locales/en/.mustflow/skills/svelte-code-change/SKILL.md +16 -5
- package/templates/default/locales/en/.mustflow/skills/tauri-code-change/SKILL.md +3 -2
- package/templates/default/locales/en/.mustflow/skills/threejs-code-change/SKILL.md +207 -0
- package/templates/default/locales/en/.mustflow/skills/typescript-code-change/SKILL.md +23 -16
- package/templates/default/locales/en/.mustflow/skills/version-freshness-check/SKILL.md +12 -6
- package/templates/default/locales/en/AGENTS.md +8 -1
- package/templates/default/manifest.toml +36 -1
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
---
|
|
2
|
+
mustflow_doc: skill.threejs-code-change
|
|
3
|
+
locale: en
|
|
4
|
+
canonical: true
|
|
5
|
+
revision: 1
|
|
6
|
+
lifecycle: mustflow-owned
|
|
7
|
+
authority: procedure
|
|
8
|
+
name: threejs-code-change
|
|
9
|
+
description: Apply this skill when Three.js renderers, scenes, cameras, meshes, materials, textures, shaders, glTF assets, animation, picking, WebGL, WebGPU, WebXR, resource disposal, or Three.js performance and tests are created, changed, reviewed, migrated, or upgraded.
|
|
10
|
+
metadata:
|
|
11
|
+
mustflow_schema: "1"
|
|
12
|
+
mustflow_kind: procedure
|
|
13
|
+
pack_id: mustflow.core
|
|
14
|
+
skill_id: mustflow.core.threejs-code-change
|
|
15
|
+
command_intents:
|
|
16
|
+
- changes_status
|
|
17
|
+
- changes_diff_summary
|
|
18
|
+
- lint
|
|
19
|
+
- build
|
|
20
|
+
- test_related
|
|
21
|
+
- test
|
|
22
|
+
- docs_validate_fast
|
|
23
|
+
- test_release
|
|
24
|
+
- mustflow_check
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
# Three.js Code Change
|
|
28
|
+
|
|
29
|
+
<!-- mustflow-section: purpose -->
|
|
30
|
+
## Purpose
|
|
31
|
+
|
|
32
|
+
Preserve renderer, scene, asset, interaction, GPU-resource, compatibility, and frame-budget
|
|
33
|
+
contracts while making focused Three.js changes. Treat a visible frame as weak evidence: draw-call
|
|
34
|
+
churn, shader recompilation, texture residency, hidden render passes, stale bounds, and leaked
|
|
35
|
+
listeners or GPU resources can remain broken after the scene appears correct.
|
|
36
|
+
|
|
37
|
+
<!-- mustflow-section: use-when -->
|
|
38
|
+
## Use When
|
|
39
|
+
|
|
40
|
+
- `WebGLRenderer`, `WebGPURenderer`, scenes, cameras, controls, lights, shadows, render targets,
|
|
41
|
+
post-processing, TSL, node materials, custom shaders, or animation loops change.
|
|
42
|
+
- Geometry, materials, textures, glTF/GLB, Draco, Meshopt, KTX2, instancing, skinning, animation,
|
|
43
|
+
disposal, context or device loss, or renderer migration changes.
|
|
44
|
+
- `Raycaster`, pointer interaction, GPU picking, BVH acceleration, layers, WebXR input, or dense-scene
|
|
45
|
+
interaction changes.
|
|
46
|
+
- Three.js package metadata, import boundaries, browser targets, tests, performance claims, or
|
|
47
|
+
migration documentation change.
|
|
48
|
+
|
|
49
|
+
<!-- mustflow-section: do-not-use-when -->
|
|
50
|
+
## Do Not Use When
|
|
51
|
+
|
|
52
|
+
- Babylon.js, PlayCanvas, a native engine, or raw WebGPU owns the rendering boundary.
|
|
53
|
+
- The task changes only a static model or texture without changing Three.js loading, rendering,
|
|
54
|
+
ownership, compatibility, or package behavior.
|
|
55
|
+
- The task asks only for the current Three.js release number; use source-freshness guidance unless
|
|
56
|
+
code or durable documentation changes too.
|
|
57
|
+
|
|
58
|
+
<!-- mustflow-section: required-inputs -->
|
|
59
|
+
## Required Inputs
|
|
60
|
+
|
|
61
|
+
- Installed and supported Three.js versions, import paths, addons, bundler, framework lifecycle,
|
|
62
|
+
browser and device targets, and configured verification intents.
|
|
63
|
+
- Renderer ledger: backend, asynchronous initialization, fallback, canvas owner, animation-loop
|
|
64
|
+
owner, resize and pixel-ratio policy, context/device-loss behavior, and render-target owners.
|
|
65
|
+
- Resource ledger: scene roots, geometries, materials, textures, skeletons, animation mixers,
|
|
66
|
+
controls, listeners, observers, workers, decoders, caches, and disposal owners.
|
|
67
|
+
- Performance evidence: CPU and GPU frame time, `renderer.info`, draw calls, triangles, texture and
|
|
68
|
+
geometry counts, shader compilation, upload time, overdraw, render-target sizes, and target-device
|
|
69
|
+
measurements.
|
|
70
|
+
- Interaction ledger: canvas bounds, pointer normalization, pickable set, domain mapping, layers,
|
|
71
|
+
bounds freshness, instance mapping, hover frequency, and accessibility fallback.
|
|
72
|
+
|
|
73
|
+
<!-- mustflow-section: preconditions -->
|
|
74
|
+
## Preconditions
|
|
75
|
+
|
|
76
|
+
- Read repository package and lock evidence before choosing current Three.js APIs or migration
|
|
77
|
+
advice. Refresh official docs, migration notes, package metadata, and browser platform sources
|
|
78
|
+
before embedding exact version, deprecation, removal, or support claims.
|
|
79
|
+
- Classify WebGL, WebGPU, TSL/node-material, and WebXR features independently. A stable Three.js
|
|
80
|
+
release does not make every renderer backend or browser platform universally available.
|
|
81
|
+
- Identify the framework component or route that owns mount, resize, animation, and cleanup before
|
|
82
|
+
editing renderer lifecycle.
|
|
83
|
+
|
|
84
|
+
<!-- mustflow-section: allowed-edits -->
|
|
85
|
+
## Allowed Edits
|
|
86
|
+
|
|
87
|
+
- Make focused Three.js source, tests, package metadata, docs, assets, and configuration changes
|
|
88
|
+
required by the task.
|
|
89
|
+
- Add instrumentation or regression tests for lifecycle, picking, fallback, resource ownership,
|
|
90
|
+
shader/material behavior, bounds, resize, and performance contracts.
|
|
91
|
+
- Preserve fallback and compatibility paths when supported browsers or devices still need them.
|
|
92
|
+
- Do not switch renderer backends, force WebGPU-only delivery, raise pixel ratio, add expensive
|
|
93
|
+
passes, replace picking strategies, or introduce compression/decoder infrastructure without
|
|
94
|
+
repository evidence and an explicit compatibility and rollout plan.
|
|
95
|
+
|
|
96
|
+
<!-- mustflow-section: procedure -->
|
|
97
|
+
## Procedure
|
|
98
|
+
|
|
99
|
+
1. **Classify package and renderer tracks.**
|
|
100
|
+
- Separate the repository-pinned release, a proposed target release, WebGLRenderer,
|
|
101
|
+
WebGPURenderer, TSL/node-material, addon, and browser-platform tracks.
|
|
102
|
+
- Verify migration notes across every crossed release. Do not treat a future migration heading,
|
|
103
|
+
prerelease tag, or dev-branch documentation as the current stable contract.
|
|
104
|
+
- Check import boundaries such as core, addons, `three/webgpu`, and `three/tsl` against the
|
|
105
|
+
installed version and bundler instead of copying current examples into older support ranges.
|
|
106
|
+
2. **Own renderer and frame lifecycle.**
|
|
107
|
+
- Make asynchronous renderer initialization, first render, animation loop, resize, pixel ratio,
|
|
108
|
+
visibility suspension, and teardown explicit and idempotent.
|
|
109
|
+
- Prefer `renderer.setAnimationLoop()` when renderer or XR lifecycle requires it. For on-demand
|
|
110
|
+
rendering, verify initialization and invalidate only from owned state changes.
|
|
111
|
+
- Update canvas size, camera projection, pixel ratio, composer and render-target sizes together.
|
|
112
|
+
Treat device pixel ratio as a GPU workload multiplier and cap or adapt it from measurements.
|
|
113
|
+
3. **Keep scene state and ownership separate.**
|
|
114
|
+
- Use the scene as a render tree, not the domain database. Maintain entity-to-object and
|
|
115
|
+
instance-to-entity mappings outside renderer internals.
|
|
116
|
+
- Record shared versus exclusive ownership before disposal. Removing an object from a scene does
|
|
117
|
+
not dispose geometry, material, texture, render target, skeleton, mixer, control, listener,
|
|
118
|
+
worker, decoder, or cache resources.
|
|
119
|
+
- Verify route changes, hot reload, asset swaps, and repeated mount/unmount cycles do not produce
|
|
120
|
+
stepwise growth in renderer counters or duplicate loops and listeners.
|
|
121
|
+
4. **Review geometry, bounds, culling, and instancing.**
|
|
122
|
+
- Reduce draw calls and state changes before chasing small JavaScript loop savings. Use merged
|
|
123
|
+
geometry, instancing, spatial chunks, LOD, and culling only when interaction, update, and
|
|
124
|
+
disposal semantics remain correct.
|
|
125
|
+
- After transform or attribute changes, update the required dirty flags and recompute stale
|
|
126
|
+
bounding volumes used by frustum culling or raycasting.
|
|
127
|
+
- Keep `InstancedMesh.instanceId` as a render index, not a domain identity. Define remapping,
|
|
128
|
+
deletion, visibility, hover, color, and bounds behavior explicitly.
|
|
129
|
+
5. **Review materials, textures, shaders, lights, and passes.**
|
|
130
|
+
- Separate color textures from numeric data maps and verify color-space, format, compression,
|
|
131
|
+
mipmap, filtering, anisotropy, and upload policy per texture class.
|
|
132
|
+
- Treat material define changes as shader-variant changes. Prefer uniforms for value changes,
|
|
133
|
+
preload critical shader variants, and measure compile and upload stalls.
|
|
134
|
+
- Count shadow maps, transparent overdraw, cameras, mirrors, post-processing passes, and render
|
|
135
|
+
targets as repeated scene work. Keep expensive effects bounded by a target-device budget.
|
|
136
|
+
- Verify custom GLSL, `onBeforeCompile`, post-processing, and render-target assumptions before a
|
|
137
|
+
WebGPU or TSL migration; changing the renderer constructor is not a complete migration.
|
|
138
|
+
6. **Review picking and interaction.**
|
|
139
|
+
- Convert pointer coordinates from `canvas.getBoundingClientRect()` into normalized device
|
|
140
|
+
coordinates. Do not normalize against the window unless the canvas contract is truly full-screen.
|
|
141
|
+
- Raycast a maintained pickable set or interaction proxies, not the whole scene on every pointer
|
|
142
|
+
move. Use layers deliberately and remember that parent-layer mismatch does not prune every
|
|
143
|
+
descendant traversal contract automatically.
|
|
144
|
+
- Map intersection objects to domain owners. Account for back-face rules, line/point thresholds,
|
|
145
|
+
transparent or discarded pixels, shader deformation, stale matrices and bounds, and instances.
|
|
146
|
+
- Use BVH or coarse colliders for dense static geometry when measured raycasting exceeds the
|
|
147
|
+
interaction budget. Use GPU ID picking only with an explicit readback and latency policy.
|
|
148
|
+
7. **Review WebGPU, WebXR, and recovery.**
|
|
149
|
+
- Feature-detect after the owning initialization point and retain a tested WebGL fallback unless
|
|
150
|
+
deployment evidence permits otherwise. Browser name alone does not prove adapter, feature,
|
|
151
|
+
limit, driver, policy, or secure-context support.
|
|
152
|
+
- Treat WebGL context loss and WebGPU device loss as lifecycle transitions with resource rebuild
|
|
153
|
+
or a deliberate user-visible fallback, not only console errors.
|
|
154
|
+
- For WebXR, separate target-ray, grip, hand, gaze, and near-touch interaction; keep session
|
|
155
|
+
request, permission failure, end, re-entry, camera, and frame-loop behavior explicit.
|
|
156
|
+
8. **Verify behavior and performance.**
|
|
157
|
+
- Test initial load, resize, background-tab return, route remount, asset replacement, fallback,
|
|
158
|
+
loss/recovery where supported, and representative pointer/XR interaction.
|
|
159
|
+
- Compare before/after CPU frame time, GPU frame time when measurable, draw calls, triangles,
|
|
160
|
+
texture and geometry counts, shader compilation, upload stalls, and render-target pixels on a
|
|
161
|
+
representative device. Do not call a change an optimization from source inspection alone.
|
|
162
|
+
|
|
163
|
+
<!-- mustflow-section: postconditions -->
|
|
164
|
+
## Postconditions
|
|
165
|
+
|
|
166
|
+
- Renderer, scene, frame loop, resources, interaction, and fallback each have an explicit owner.
|
|
167
|
+
- Release status, renderer backend, feature status, and browser support are not collapsed into one
|
|
168
|
+
generic "current Three.js" claim.
|
|
169
|
+
- Picking maps render intersections to domain semantics and has bounded per-event work.
|
|
170
|
+
- Performance claims include counters or traces and repeated lifecycle operations do not leak.
|
|
171
|
+
|
|
172
|
+
<!-- mustflow-section: verification -->
|
|
173
|
+
## Verification
|
|
174
|
+
|
|
175
|
+
Use configured oneshot intents that cover the changed scope:
|
|
176
|
+
|
|
177
|
+
- `changes_status`
|
|
178
|
+
- `changes_diff_summary`
|
|
179
|
+
- `lint`
|
|
180
|
+
- `build`
|
|
181
|
+
- `test_related`
|
|
182
|
+
- `test`
|
|
183
|
+
- `docs_validate_fast`
|
|
184
|
+
- `test_release`
|
|
185
|
+
- `mustflow_check`
|
|
186
|
+
|
|
187
|
+
<!-- mustflow-section: failure-handling -->
|
|
188
|
+
## Failure Handling
|
|
189
|
+
|
|
190
|
+
- If the installed Three.js track or browser target is unclear, preserve the existing API and
|
|
191
|
+
fallback and report the missing evidence.
|
|
192
|
+
- If GPU timing is unavailable, report CPU timing and renderer counters separately and do not infer
|
|
193
|
+
GPU improvement from them.
|
|
194
|
+
- If a renderer migration crosses unsupported shaders, passes, formats, or platform features, keep
|
|
195
|
+
the existing backend and report the smallest migration experiment instead of forcing parity.
|
|
196
|
+
- If verification needs an unconfigured server, browser harness, asset generator, or benchmark,
|
|
197
|
+
report the missing command intent rather than running it raw.
|
|
198
|
+
|
|
199
|
+
<!-- mustflow-section: output-format -->
|
|
200
|
+
## Output Format
|
|
201
|
+
|
|
202
|
+
- Three.js surface and version/backend tracks
|
|
203
|
+
- Renderer, scene, resource, and interaction owners
|
|
204
|
+
- Compatibility, fallback, migration, and recovery decisions
|
|
205
|
+
- Performance evidence before and after
|
|
206
|
+
- Changed files and command intents run
|
|
207
|
+
- Skipped checks and remaining rendering, lifecycle, picking, or device risk
|
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
mustflow_doc: skill.typescript-code-change
|
|
3
3
|
locale: en
|
|
4
4
|
canonical: true
|
|
5
|
-
revision:
|
|
5
|
+
revision: 8
|
|
6
6
|
lifecycle: mustflow-owned
|
|
7
7
|
authority: procedure
|
|
8
8
|
name: typescript-code-change
|
|
9
|
-
description: Apply this skill when TypeScript source, declarations, tsconfig, package exports, module resolution, project references, type-check performance, compiler-version behavior, TypeScript 6-to-7 migration surfaces, TypeScript 7
|
|
9
|
+
description: Apply this skill when TypeScript source, declarations, tsconfig, package exports, module resolution, project references, type-check performance, compiler-version behavior, TypeScript 6-to-7 migration surfaces, TypeScript 7 stable, development, API-compatibility, or native-preview tooling, runtime data validation, type safety, or TypeScript tests are created or changed.
|
|
10
10
|
metadata:
|
|
11
11
|
mustflow_schema: "1"
|
|
12
12
|
mustflow_kind: procedure
|
|
@@ -36,7 +36,7 @@ Preserve TypeScript's type, runtime validation, module, build, and public API bo
|
|
|
36
36
|
- `.ts`, `.tsx`, `.mts`, `.cts`, `*.d.ts`, `tsconfig*.json`, package entry metadata, exports, declarations, runtime validators, or TypeScript tests change.
|
|
37
37
|
- The task touches module resolution, ESM/CJS interop, public package API, path aliases, generated declarations, or strict type errors.
|
|
38
38
|
- The task touches project references, monorepo package boundaries, type-check speed, declaration emit speed, ambient type scope, large unions, generated types, or TypeScript build graph shape.
|
|
39
|
-
- The task touches TypeScript compiler major-version behavior, TypeScript 6 transition deprecations, TypeScript 7
|
|
39
|
+
- The task touches TypeScript compiler major-version behavior, TypeScript 6 transition deprecations, TypeScript 7 stable adoption, TypeScript development-build comparison, `@typescript/typescript6`, `tsc6`, `typescript`, `typescript@next`, `@typescript/native-preview`, `tsgo`, compiler API use, declaration emit comparison, or editor language-service behavior.
|
|
40
40
|
- The task touches external inputs such as JSON, HTTP responses, environment variables, config files, form data, URL params, local storage, message events, queue payloads, or user-provided objects.
|
|
41
41
|
- A framework component written in TypeScript changes its props, events, routes, loader data, or exported types.
|
|
42
42
|
|
|
@@ -54,7 +54,12 @@ Preserve TypeScript's type, runtime validation, module, build, and public API bo
|
|
|
54
54
|
- Existing source entrypoints, public exports, declaration files, validators, schemas, type tests, and nearby tests.
|
|
55
55
|
- The target runtime and module system: Node, browser, worker, Bun, edge, ESM, CJS, or mixed boundary.
|
|
56
56
|
- Workspace package dependency graph, `tsconfig` references graph, public package entrypoints, path alias policy, generated-type locations, and current import-boundary evidence when the repository is a monorepo or large TypeScript project.
|
|
57
|
-
- TypeScript compiler track and tooling entrypoint when relevant
|
|
57
|
+
- TypeScript compiler track and tooling entrypoint when relevant. In the registry snapshot checked
|
|
58
|
+
on 2026-07-11, TS7 stable used `typescript` and `tsc`, TS6 JavaScript API compatibility used
|
|
59
|
+
`@typescript/typescript6` and `tsc6`, development builds used `typescript@next`, native
|
|
60
|
+
preview used `@typescript/native-preview` and `tsgo`, and `typescript@rc` referred to
|
|
61
|
+
historical prerelease evidence. Refresh registry and official release evidence before reusing
|
|
62
|
+
that mapping, then include framework typecheck wrappers, editor settings, and compiler API consumers.
|
|
58
63
|
- Package API metadata when relevant: `type`, `main`, `module`, `browser`, `exports`, `types`, `typings`, `typesVersions`, `files`, `bin`, `sideEffects`, and documented import paths.
|
|
59
64
|
- Existing verification intents from the repository command contract.
|
|
60
65
|
|
|
@@ -74,7 +79,7 @@ Preserve TypeScript's type, runtime validation, module, build, and public API bo
|
|
|
74
79
|
- Keep public runtime exports and declaration exports aligned.
|
|
75
80
|
- Add focused tests or type tests only when they protect the changed contract.
|
|
76
81
|
- Use existing schema validators or narrowly scoped type guards and assertion functions for external input boundaries.
|
|
77
|
-
- Compare
|
|
82
|
+
- Compare TS7 stable `tsc`, TS6-compatible `tsc6`, and optional `typescript@next` or native-preview `tsgo` only as a bounded migration or diagnostics exercise when repository tooling explicitly supports those tracks.
|
|
78
83
|
- Do not weaken compiler, lint, module, package, or test boundaries to make the task appear complete.
|
|
79
84
|
|
|
80
85
|
<!-- mustflow-section: procedure -->
|
|
@@ -112,14 +117,16 @@ Preserve TypeScript's type, runtime validation, module, build, and public API bo
|
|
|
112
117
|
30. Inspect generated declarations when package surfaces change. Declaration files must not leak source-only aliases, private paths, workspace-only package names, unpublished internal paths, accidental public re-exports, stale `paths` aliases, or wrong ESM/CJS declaration shapes.
|
|
113
118
|
31. For TypeScript 6 migration work, treat deprecation warnings as future TypeScript 7 removal risk. `ignoreDeprecations` is a temporary compatibility valve, not proof that the project is ready for 7.0. Prefer removing deprecated options and updating resolver or module choices to match the project runtime.
|
|
114
119
|
32. Treat TypeScript 6 `--stableTypeOrdering` as a migration comparison tool for declaration and error-order differences, not as a permanent performance-neutral default. If it changes errors or declaration output, look for inference or declaration-stability issues instead of snapshotting noise.
|
|
115
|
-
33. For TypeScript 7 migration work, keep the
|
|
116
|
-
|
|
117
|
-
- TS7
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
120
|
+
33. For TypeScript 7 migration work, refresh official release and registry evidence, then keep the
|
|
121
|
+
tracks separate. The following mapping is a snapshot checked on 2026-07-11:
|
|
122
|
+
- TS7 stable compiler track: `typescript` and `tsc` for repository adoption and ordinary compiler verification.
|
|
123
|
+
- TS6 JavaScript API compatibility track: `@typescript/typescript6` and `tsc6` for compiler API, transformer, ESLint, framework wrapper, and peer-dependency compatibility until each owner supports the TS7 API surface.
|
|
124
|
+
- Development compiler track: `typescript@next` for explicitly requested next-minor or next-major testing, never as a stable replacement.
|
|
125
|
+
- Native-preview track: `@typescript/native-preview` and `tsgo` for explicitly requested comparison only.
|
|
126
|
+
- Historical prerelease track: use `typescript@rc` only to reproduce a named prerelease or when current official registry metadata assigns it to a new release candidate.
|
|
127
|
+
34. Keep compiler API consumers, language-service plugins, custom transformers, and framework typecheck wrappers on the TS6 API compatibility track until their owners explicitly support the TS7 API surface. Stable TS7 `tsc` output does not prove that JavaScript compiler API consumers can migrate.
|
|
128
|
+
35. When comparing TS7 stable `tsc`, TS6-compatible `tsc6`, `typescript@next`, or native-preview `tsgo`, classify differences before editing code: real type error, declaration emit order or printback noise, unsupported option, unsupported API, watch or incremental behavior gap, language-service gap, generated-output drift, or framework wrapper mismatch.
|
|
129
|
+
36. Do not treat faster development or native-preview results as sufficient verification. Keep the repository's adopted stable compiler, TS6 API compatibility check, or framework typecheck as the baseline until repository policy explicitly adopts a different track.
|
|
123
130
|
37. Choose the narrowest configured verification intents that cover typecheck, lint, tests, build output, declarations, package contract risk, downstream-style consumer risk, and type-check performance risk.
|
|
124
131
|
|
|
125
132
|
<!-- mustflow-section: assertion-policy -->
|
|
@@ -176,7 +183,7 @@ Reject or revise the patch when any of these appear without explicit evidence an
|
|
|
176
183
|
- `tsconfig` defaults, ambient `types`, import attributes, `import defer`, or explicit resource management syntax are adopted without runtime, bundler, compiler-track, and generated-output evidence.
|
|
177
184
|
- `skipLibCheck` or weakened strictness is used as release validation for a library/package.
|
|
178
185
|
- TypeScript 6-to-7 migration warnings are silenced instead of classified and either fixed or reported.
|
|
179
|
-
- TS7
|
|
186
|
+
- TS7 stable, development, or native-preview output differences are accepted as harmless without classification.
|
|
180
187
|
- Compiler API, transformer, language-service, or framework typecheck surfaces are moved off the TS6 API track without compatibility proof.
|
|
181
188
|
|
|
182
189
|
<!-- mustflow-section: postconditions -->
|
|
@@ -206,7 +213,7 @@ Use configured oneshot command intents when available:
|
|
|
206
213
|
|
|
207
214
|
If a package API changes, include the configured release or package-surface verification when available.
|
|
208
215
|
|
|
209
|
-
Report whether configured verification exists for declaration output, package artifact contents, downstream-style consumer fixtures, minimum supported TypeScript version,
|
|
216
|
+
Report whether configured verification exists for declaration output, package artifact contents, downstream-style consumer fixtures, minimum supported TypeScript version, adopted stable TypeScript version, TS6 API compatibility, optional `typescript@next` or native-preview comparison, ESM, CJS, and bundler-style resolution when those surfaces change.
|
|
210
217
|
|
|
211
218
|
<!-- mustflow-section: failure-handling -->
|
|
212
219
|
## Failure Handling
|
|
@@ -215,7 +222,7 @@ Report whether configured verification exists for declaration output, package ar
|
|
|
215
222
|
- If external input has no validation pattern, add a narrow validator/guard/assertion or report the missing boundary instead of casting.
|
|
216
223
|
- If module resolution is unclear, inspect the package and compiler configuration before changing imports.
|
|
217
224
|
- If generated declaration output cannot be inspected, report the package API risk and the missing verification intent.
|
|
218
|
-
- If TS7
|
|
225
|
+
- If TS7 stable, `typescript@next`, or native preview disagrees with the repository's adopted compiler, TS6 API compatibility, or framework baseline, keep the declared baseline as the compatibility path, classify the difference, and report whether it is a project bug, compiler bug, unsupported feature, or expected declaration/order drift.
|
|
219
226
|
- If a framework, plugin, transformer, or compiler API consumer depends on the JavaScript compiler implementation, do not move it off the TS6 API track unless the dependency explicitly supports that path.
|
|
220
227
|
- If verification commands are missing, report the missing intents instead of inventing package-manager commands.
|
|
221
228
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
mustflow_doc: skill.version-freshness-check
|
|
3
3
|
locale: en
|
|
4
4
|
canonical: true
|
|
5
|
-
revision:
|
|
5
|
+
revision: 11
|
|
6
6
|
lifecycle: mustflow-owned
|
|
7
7
|
authority: procedure
|
|
8
8
|
name: version-freshness-check
|
|
@@ -35,7 +35,7 @@ Prevent agents from writing stale external version references from memory, while
|
|
|
35
35
|
- Generated or edited files introduce explicit external version references, action refs, package ranges, runtime versions, framework majors, Docker image tags, toolchain versions, setup actions, scaffold commands, install commands, or migration examples.
|
|
36
36
|
- CI workflows, release workflows, Dockerfiles, package metadata, lockfiles, runtime files, framework configuration, README examples, docs, tests, fixtures, or templates mention external versions such as GitHub Actions refs, Node, Bun, Deno, Python, Rust, Tauri, Astro, Next, SvelteKit, Electron, Docker images, package managers, SDKs, plugins, or generators.
|
|
37
37
|
- Python wording mentions current/stable/support status, Python 3.14+ or 3.15+ syntax, standard-library APIs, runtime flags, changed default behavior, security defaults, or examples that depend on `requires-python`.
|
|
38
|
-
- TypeScript wording mentions current/stable/
|
|
38
|
+
- TypeScript wording mentions current/stable/development/prerelease/native-preview status for TypeScript 6, TypeScript 7, `@typescript/typescript6`, `tsc6`, `typescript`, `typescript@next`, `typescript@rc`, `@typescript/native-preview`, `tsgo`, compiler API compatibility, or migration readiness.
|
|
39
39
|
- Go wording mentions current/stable/support status, Go release numbers, `go.mod` language version behavior, `toolchain` behavior, standard-library APIs, `GOEXPERIMENT`, runtime defaults, container behavior, JSON experiments, third-party Go framework releases such as Gin, framework minimum-Go requirements, or examples that depend on a specific Go or framework version.
|
|
40
40
|
- Java wording mentions current/stable/GA/LTS/support status, Java or JDK release numbers, Oracle/OpenJDK/vendor support tracks, JEP status, preview or incubator APIs, JVM flags, GC behavior, virtual-thread behavior, `ScopedValue`, structured concurrency, final-field reflection restrictions, applet removal, HTTP/3, AOT cache, Compact Object Headers, JFR, JMH, container memory or CPU behavior, Maven or Gradle toolchains, bytecode target, or examples that depend on a specific Java version.
|
|
41
41
|
- Rust wording mentions current/stable/support status, Rust release numbers, `rust-version`, edition behavior, `rust-toolchain`, Cargo resolver or workspace behavior, standard-library APIs, compiler lints, target behavior, release profiles, or examples that depend on a specific Rust version.
|
|
@@ -98,8 +98,14 @@ Prevent agents from writing stale external version references from memory, while
|
|
|
98
98
|
13. For Python standard-library or runtime-behavior claims, refresh official Python documentation before writing durable wording. Check `requires-python`, CI/runtime matrices, and container images before using or recommending Python 3.14+ standard-library APIs or version-gated features such as template string literals, `annotationlib`, Python 3.14+ `map(strict=True)`, `functools.Placeholder`, `heapq` max-heap helpers, import-timing flag behavior, `finally` flow-control warnings, or changed security defaults.
|
|
99
99
|
14. For Python examples that use newer standard-library APIs, either keep the example behind an explicit runtime floor or provide a supported fallback. Do not call a Python 3.14-only API a general Python best practice when the repository declares lower support.
|
|
100
100
|
15. For Python 3.15+ claims, keep beta, release-candidate, and stable tracks separate. Refresh official docs before using explicit lazy imports, built-in `frozendict`, built-in `sentinel`, unpacking comprehensions, typed `TypedDict` extra items, startup configuration files, or changed encoding behavior in durable examples.
|
|
101
|
-
16. For TypeScript 6 and 7 claims, refresh official TypeScript sources before writing
|
|
102
|
-
|
|
101
|
+
16. For TypeScript 6 and 7 claims, refresh official TypeScript and registry sources before writing
|
|
102
|
+
durable wording. The snapshot checked on 2026-07-11 mapped TS7 stable to `typescript` and
|
|
103
|
+
`tsc`, TS6 JavaScript API compatibility to `@typescript/typescript6` and `tsc6`,
|
|
104
|
+
development builds to `typescript@next`, native preview to `@typescript/native-preview`
|
|
105
|
+
and `tsgo`, and historical prerelease evidence to `typescript@rc`. Reclassify every tag
|
|
106
|
+
from current evidence; do not call development, preview, or RC output "latest stable
|
|
107
|
+
TypeScript" merely because it is newer or separately installable.
|
|
108
|
+
17. For TypeScript examples, make the selected track explicit: TS7 stable compiler adoption, TS6 API compatibility, `typescript@next` development comparison, native-preview comparison, historical prerelease reproduction, editor preview, or framework-owned verification. If the project has compiler API consumers, transformers, framework wrappers, or declaration snapshots, classify the reference as migration-sensitive and keep API consumers on the TS6 API compatibility track until support is explicit. Check exact support before relying on `rootDir` defaults, ambient `types` defaults, import attributes, subpath imports, `import defer`, `using`, or `await using`.
|
|
103
109
|
18. For Go release, toolchain, standard-library, runtime, or experiment claims, refresh official Go release notes or package documentation before writing durable wording. Check the repository's `go` directive, `toolchain` directive, CI/runtime matrix, and container target before using or recommending version-gated features such as expression operands to `new`, range-over-function iterators, generic type aliases, reflect iterator methods, `errors.AsType`, `sync.WaitGroup.Go`, `testing/synctest`, `testing.B.Loop`, `T.ArtifactDir`, `B.ArtifactDir`, `F.ArtifactDir`, `testing/cryptotest.SetGlobalRandom`, `os.Root`, `os.OpenInRoot`, `omitzero`, `go.mod` `tool`, `ReverseProxy.Rewrite`, container-aware `GOMAXPROCS`, goroutine leak profiles, `encoding/json/v2`, or `GOEXPERIMENT` APIs.
|
|
104
110
|
19. For Go framework and dependency release claims, refresh the source that owns the artifact before writing durable wording. For Gin, prefer official Gin release notes, pkg.go.dev module metadata, and the upstream repository release or source files for claims about latest stable version, minimum Go version, HTTP/3 support, BSON support, binding behavior, router options, logger options, trusted proxy behavior, or `Context` APIs. Keep framework upgrade advice separate from repository adoption, because a framework minor can still require a Go toolchain, CI image, Docker base, middleware, route, or binding migration.
|
|
105
111
|
20. For Go examples that use newer standard-library APIs, framework APIs, or runtime defaults, either keep the example behind an explicit Go or framework version floor or provide a supported fallback. Do not call an experimental `GOEXPERIMENT` feature, a newer `go` directive behavior, or a newly added framework method a general Go best practice when the repository declares lower support.
|
|
@@ -123,7 +129,7 @@ Prevent agents from writing stale external version references from memory, while
|
|
|
123
129
|
- Major or migration-required changes are either explicitly approved, deferred with a recommendation, or left unchanged with the risk reported.
|
|
124
130
|
- Python standard-library examples and runtime-default claims match the declared Python support matrix or name the required runtime floor.
|
|
125
131
|
- Python template strings, annotation inspection, explicit lazy imports, immutable mappings, sentinels, and advanced `TypedDict` shape claims are either official-source checked or omitted.
|
|
126
|
-
- TypeScript
|
|
132
|
+
- TypeScript 7 stable compiler, TypeScript 6 JavaScript API compatibility, `typescript@next` development, native-preview, and RC prerelease tracks are not collapsed into one generic "latest TypeScript" claim.
|
|
127
133
|
- Go release, `go.mod` language version, standard-library API, framework dependency API such as Gin, runtime-default, and `GOEXPERIMENT` claims match the declared Go support matrix or name the required runtime or framework floor.
|
|
128
134
|
- Java release, JDK vendor, source or target release, bytecode target, JEP status, standard-library API, virtual-thread behavior, preview or incubator API, build-tool support, JVM flag, GC behavior, and container-runtime claims match the declared Java support matrix or name the required runtime, toolchain, and feature floor.
|
|
129
135
|
- Rust release, `rust-version`, edition, standard-library API, Cargo resolver, lint-default, target, and nightly/stable claims match the declared Rust support matrix or name the required API-specific runtime floor.
|
|
@@ -152,7 +158,7 @@ Choose the narrowest configured intent that proves the changed versioned surface
|
|
|
152
158
|
- If official sources conflict, prefer the source that owns the artifact being referenced and report the conflict.
|
|
153
159
|
- If a freshness check requires network, credentials, or a connector that is not available, report the boundary and avoid current-version claims.
|
|
154
160
|
- If a proposed major or migration-required version is better for greenfield work but risky for the existing project, present both choices and ask before changing the project.
|
|
155
|
-
- If TypeScript
|
|
161
|
+
- If TypeScript stable, development, native-preview, or RC freshness changes during the task, update wording to a dated or track-specific claim and keep repository adoption separate from comparison-only checks.
|
|
156
162
|
- If Go release, framework release, or experiment freshness changes during the task, update wording to a dated or track-specific claim and keep official release status, `go` directive adoption, framework adoption, CI support, and `GOEXPERIMENT` adoption separate.
|
|
157
163
|
- If Java release, JEP, JVM flag, GC, or toolchain freshness changes during the task, update wording to a dated or track-specific claim and keep latest GA, latest LTS, repository runtime, vendor support, preview or incubator status, product feature status, default-enabled behavior, build-tool support, and CI or container adoption separate.
|
|
158
164
|
- If Rust release or toolchain freshness changes during the task, update wording to a dated or track-specific claim and keep official release status, MSRV adoption, edition adoption, CI support, target support, and nightly or unstable features separate.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
mustflow_doc: agents.root
|
|
3
3
|
locale: en
|
|
4
4
|
canonical: true
|
|
5
|
-
revision:
|
|
5
|
+
revision: 23
|
|
6
6
|
lifecycle: user-editable
|
|
7
7
|
authority: binding
|
|
8
8
|
---
|
|
@@ -129,6 +129,13 @@ mustflow-managed details are under `.mustflow/`.
|
|
|
129
129
|
nested repository's local routing files.
|
|
130
130
|
- Shared workspace skills provide procedure guidance only. They do not override the nested
|
|
131
131
|
repository's `AGENTS.md`, command contract, edit scope, safety rules, or source of truth.
|
|
132
|
+
- Resolve every verification intent named by a shared workspace skill against the selected child
|
|
133
|
+
repository's own `.mustflow/config/commands.toml`. Do not run a parent-root intent merely to
|
|
134
|
+
satisfy a child task, and do not treat the parent intent as a skipped child check.
|
|
135
|
+
- Require parent-root verification only when the task edits parent-owned files, changes
|
|
136
|
+
parent-owned orchestration, or the child result explicitly depends on a parent-owned artifact or
|
|
137
|
+
contract. Unrelated parent worktree changes, locks, or manifest drift do not block a child-only
|
|
138
|
+
completion claim.
|
|
132
139
|
- If a nested repository lacks a local skill index or uses a different local agent convention,
|
|
133
140
|
do not treat that absence as meaning no applicable workspace-level skill exists; consult the
|
|
134
141
|
shared workspace registry while keeping child-repository authority local.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
id = "default"
|
|
2
2
|
name = "default"
|
|
3
|
-
version = "2.115.
|
|
3
|
+
version = "2.115.9"
|
|
4
4
|
description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
|
|
5
5
|
common_root = "common"
|
|
6
6
|
locales_root = "locales"
|
|
@@ -95,7 +95,10 @@ creates = [
|
|
|
95
95
|
".mustflow/skills/astro-code-change/SKILL.md",
|
|
96
96
|
".mustflow/skills/axum-code-change/SKILL.md",
|
|
97
97
|
".mustflow/skills/babylon-code-change/SKILL.md",
|
|
98
|
+
".mustflow/skills/threejs-code-change/SKILL.md",
|
|
98
99
|
".mustflow/skills/bun-code-change/SKILL.md",
|
|
100
|
+
".mustflow/skills/deno-code-change/SKILL.md",
|
|
101
|
+
".mustflow/skills/ada-code-change/SKILL.md",
|
|
99
102
|
".mustflow/skills/c-code-change/SKILL.md",
|
|
100
103
|
".mustflow/skills/css-code-change/SKILL.md",
|
|
101
104
|
".mustflow/skills/cpp-code-change/SKILL.md",
|
|
@@ -115,6 +118,8 @@ creates = [
|
|
|
115
118
|
".mustflow/skills/vue-code-change/SKILL.md",
|
|
116
119
|
".mustflow/skills/vite-code-change/SKILL.md",
|
|
117
120
|
".mustflow/skills/python-code-change/SKILL.md",
|
|
121
|
+
".mustflow/skills/php-code-change/SKILL.md",
|
|
122
|
+
".mustflow/skills/pascal-code-change/SKILL.md",
|
|
118
123
|
".mustflow/skills/powershell-code-change/SKILL.md",
|
|
119
124
|
".mustflow/skills/shell-code-change/SKILL.md",
|
|
120
125
|
".mustflow/skills/structured-config-change/SKILL.md",
|
|
@@ -332,7 +337,10 @@ minimal = [
|
|
|
332
337
|
"astro-code-change",
|
|
333
338
|
"axum-code-change",
|
|
334
339
|
"babylon-code-change",
|
|
340
|
+
"threejs-code-change",
|
|
335
341
|
"bun-code-change",
|
|
342
|
+
"deno-code-change",
|
|
343
|
+
"ada-code-change",
|
|
336
344
|
"c-code-change",
|
|
337
345
|
"css-code-change",
|
|
338
346
|
"cpp-code-change",
|
|
@@ -352,6 +360,8 @@ minimal = [
|
|
|
352
360
|
"vue-code-change",
|
|
353
361
|
"vite-code-change",
|
|
354
362
|
"python-code-change",
|
|
363
|
+
"php-code-change",
|
|
364
|
+
"pascal-code-change",
|
|
355
365
|
"powershell-code-change",
|
|
356
366
|
"shell-code-change",
|
|
357
367
|
"rust-code-change",
|
|
@@ -503,7 +513,10 @@ patterns = [
|
|
|
503
513
|
"astro-code-change",
|
|
504
514
|
"axum-code-change",
|
|
505
515
|
"babylon-code-change",
|
|
516
|
+
"threejs-code-change",
|
|
506
517
|
"bun-code-change",
|
|
518
|
+
"deno-code-change",
|
|
519
|
+
"ada-code-change",
|
|
507
520
|
"c-code-change",
|
|
508
521
|
"css-code-change",
|
|
509
522
|
"cpp-code-change",
|
|
@@ -523,6 +536,8 @@ patterns = [
|
|
|
523
536
|
"vue-code-change",
|
|
524
537
|
"vite-code-change",
|
|
525
538
|
"python-code-change",
|
|
539
|
+
"php-code-change",
|
|
540
|
+
"pascal-code-change",
|
|
526
541
|
"powershell-code-change",
|
|
527
542
|
"shell-code-change",
|
|
528
543
|
"rust-code-change",
|
|
@@ -685,7 +700,10 @@ oss = [
|
|
|
685
700
|
"astro-code-change",
|
|
686
701
|
"axum-code-change",
|
|
687
702
|
"babylon-code-change",
|
|
703
|
+
"threejs-code-change",
|
|
688
704
|
"bun-code-change",
|
|
705
|
+
"deno-code-change",
|
|
706
|
+
"ada-code-change",
|
|
689
707
|
"c-code-change",
|
|
690
708
|
"css-code-change",
|
|
691
709
|
"cpp-code-change",
|
|
@@ -705,6 +723,8 @@ oss = [
|
|
|
705
723
|
"vue-code-change",
|
|
706
724
|
"vite-code-change",
|
|
707
725
|
"python-code-change",
|
|
726
|
+
"php-code-change",
|
|
727
|
+
"pascal-code-change",
|
|
708
728
|
"powershell-code-change",
|
|
709
729
|
"shell-code-change",
|
|
710
730
|
"rust-code-change",
|
|
@@ -886,7 +906,10 @@ team = [
|
|
|
886
906
|
"astro-code-change",
|
|
887
907
|
"axum-code-change",
|
|
888
908
|
"babylon-code-change",
|
|
909
|
+
"threejs-code-change",
|
|
889
910
|
"bun-code-change",
|
|
911
|
+
"deno-code-change",
|
|
912
|
+
"ada-code-change",
|
|
890
913
|
"c-code-change",
|
|
891
914
|
"css-code-change",
|
|
892
915
|
"cpp-code-change",
|
|
@@ -906,6 +929,8 @@ team = [
|
|
|
906
929
|
"vue-code-change",
|
|
907
930
|
"vite-code-change",
|
|
908
931
|
"python-code-change",
|
|
932
|
+
"php-code-change",
|
|
933
|
+
"pascal-code-change",
|
|
909
934
|
"powershell-code-change",
|
|
910
935
|
"shell-code-change",
|
|
911
936
|
"rust-code-change",
|
|
@@ -1071,7 +1096,10 @@ product = [
|
|
|
1071
1096
|
"astro-code-change",
|
|
1072
1097
|
"axum-code-change",
|
|
1073
1098
|
"babylon-code-change",
|
|
1099
|
+
"threejs-code-change",
|
|
1074
1100
|
"bun-code-change",
|
|
1101
|
+
"deno-code-change",
|
|
1102
|
+
"ada-code-change",
|
|
1075
1103
|
"c-code-change",
|
|
1076
1104
|
"css-code-change",
|
|
1077
1105
|
"cpp-code-change",
|
|
@@ -1091,6 +1119,8 @@ product = [
|
|
|
1091
1119
|
"vue-code-change",
|
|
1092
1120
|
"vite-code-change",
|
|
1093
1121
|
"python-code-change",
|
|
1122
|
+
"php-code-change",
|
|
1123
|
+
"pascal-code-change",
|
|
1094
1124
|
"powershell-code-change",
|
|
1095
1125
|
"shell-code-change",
|
|
1096
1126
|
"rust-code-change",
|
|
@@ -1262,7 +1292,10 @@ library = [
|
|
|
1262
1292
|
"astro-code-change",
|
|
1263
1293
|
"axum-code-change",
|
|
1264
1294
|
"babylon-code-change",
|
|
1295
|
+
"threejs-code-change",
|
|
1265
1296
|
"bun-code-change",
|
|
1297
|
+
"deno-code-change",
|
|
1298
|
+
"ada-code-change",
|
|
1266
1299
|
"c-code-change",
|
|
1267
1300
|
"css-code-change",
|
|
1268
1301
|
"cpp-code-change",
|
|
@@ -1282,6 +1315,8 @@ library = [
|
|
|
1282
1315
|
"vue-code-change",
|
|
1283
1316
|
"vite-code-change",
|
|
1284
1317
|
"python-code-change",
|
|
1318
|
+
"php-code-change",
|
|
1319
|
+
"pascal-code-change",
|
|
1285
1320
|
"powershell-code-change",
|
|
1286
1321
|
"shell-code-change",
|
|
1287
1322
|
"rust-code-change",
|