mustflow 2.31.0 → 2.37.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 (45) hide show
  1. package/dist/cli/commands/api/actions.js +55 -0
  2. package/dist/cli/commands/api/report-runner.js +62 -0
  3. package/dist/cli/commands/api/serve.js +149 -0
  4. package/dist/cli/commands/api/workspace-recommendations.js +13 -0
  5. package/dist/cli/commands/api.js +15 -275
  6. package/dist/cli/lib/local-index/search-read-model.js +44 -7
  7. package/dist/cli/lib/validation/frontmatter.js +75 -0
  8. package/dist/cli/lib/validation/index.js +4 -86
  9. package/dist/cli/lib/validation/safe-read.js +13 -0
  10. package/dist/core/active-run-locks.js +110 -10
  11. package/dist/core/run-performance-history.js +14 -1
  12. package/dist/core/validation-ratchet.js +1 -1
  13. package/package.json +1 -1
  14. package/templates/default/i18n.toml +63 -21
  15. package/templates/default/locales/en/.mustflow/docs/agent-workflow.md +15 -7
  16. package/templates/default/locales/en/.mustflow/skills/INDEX.md +21 -8
  17. package/templates/default/locales/en/.mustflow/skills/adapter-boundary/SKILL.md +9 -2
  18. package/templates/default/locales/en/.mustflow/skills/ai-generated-code-hardening/SKILL.md +249 -0
  19. package/templates/default/locales/en/.mustflow/skills/api-contract-change/SKILL.md +16 -11
  20. package/templates/default/locales/en/.mustflow/skills/auth-permission-change/SKILL.md +11 -4
  21. package/templates/default/locales/en/.mustflow/skills/backend-reliability-change/SKILL.md +289 -0
  22. package/templates/default/locales/en/.mustflow/skills/css-code-change/SKILL.md +24 -14
  23. package/templates/default/locales/en/.mustflow/skills/dependency-upgrade-review/SKILL.md +18 -7
  24. package/templates/default/locales/en/.mustflow/skills/frontend-render-stability/SKILL.md +144 -0
  25. package/templates/default/locales/en/.mustflow/skills/go-code-change/SKILL.md +70 -18
  26. package/templates/default/locales/en/.mustflow/skills/heuristic-candidate-selection/SKILL.md +165 -0
  27. package/templates/default/locales/en/.mustflow/skills/html-code-change/SKILL.md +20 -13
  28. package/templates/default/locales/en/.mustflow/skills/http-delivery-streaming/SKILL.md +205 -0
  29. package/templates/default/locales/en/.mustflow/skills/performance-budget-check/SKILL.md +9 -7
  30. package/templates/default/locales/en/.mustflow/skills/proactive-risk-surfacing/SKILL.md +198 -0
  31. package/templates/default/locales/en/.mustflow/skills/python-code-change/SKILL.md +27 -11
  32. package/templates/default/locales/en/.mustflow/skills/routes.toml +43 -1
  33. package/templates/default/locales/en/.mustflow/skills/rust-code-change/SKILL.md +41 -17
  34. package/templates/default/locales/en/.mustflow/skills/security-privacy-review/SKILL.md +4 -1
  35. package/templates/default/locales/en/.mustflow/skills/security-regression-tests/SKILL.md +5 -2
  36. package/templates/default/locales/en/.mustflow/skills/service-boundary-architecture/SKILL.md +167 -0
  37. package/templates/default/locales/en/.mustflow/skills/tailwind-code-change/SKILL.md +37 -23
  38. package/templates/default/locales/en/.mustflow/skills/tauri-code-change/SKILL.md +27 -10
  39. package/templates/default/locales/en/.mustflow/skills/typescript-code-change/SKILL.md +22 -4
  40. package/templates/default/locales/en/.mustflow/skills/unocss-code-change/SKILL.md +34 -15
  41. package/templates/default/locales/en/.mustflow/skills/version-freshness-check/SKILL.md +29 -5
  42. package/templates/default/locales/en/AGENTS.md +3 -2
  43. package/templates/default/locales/ko/.mustflow/docs/agent-workflow.md +13 -8
  44. package/templates/default/locales/ko/AGENTS.md +2 -2
  45. package/templates/default/manifest.toml +44 -1
@@ -2,7 +2,7 @@
2
2
  mustflow_doc: agents.root
3
3
  locale: en
4
4
  canonical: true
5
- revision: 14
5
+ revision: 15
6
6
  lifecycle: user-editable
7
7
  authority: binding
8
8
  ---
@@ -44,7 +44,8 @@ mustflow-managed details are under `.mustflow/`.
44
44
  - Do not directly start development servers, watchers, browser interfaces, interactive prompts,
45
45
  or background processes.
46
46
  - Do not start autonomous loops, worker processes, persona systems, or long-running harness
47
- processes unless this repository explicitly configures them.
47
+ processes unless this repository explicitly configures their lifecycle, safety, and approval
48
+ boundaries.
48
49
  - Follow `[budget]`, `[approval]`, and `[isolation]` in `.mustflow/config/mustflow.toml` when a
49
50
  task may run for a long time or affect sensitive state.
50
51
  - Use `mf doctor` or `mf doctor --json` for a read-only health check before broad changes.
@@ -2,7 +2,7 @@
2
2
  mustflow_doc: docs.agent-workflow
3
3
  locale: ko
4
4
  canonical: false
5
- revision: 27
5
+ revision: 28
6
6
  lifecycle: mustflow-owned
7
7
  authority: workflow-policy
8
8
  ---
@@ -20,7 +20,7 @@ authority: workflow-policy
20
20
  - 작업 시작 전 확인해야 할 문서 흐름
21
21
  - 상위 작업 공간과 하위 저장소 규칙 간 우선순위
22
22
  - 반복 입력의 안정성 유지 정책
23
- - 장기 작업에서 실행 하네스(실행 환경)가 따라야 작업 계약 경계
23
+ - 기본 작업 흐름과 선택형 런타임, 조정, 작업 항목 표면의 경계
24
24
  - 계층형 압축 기억 정책과 요약 기억의 권위 한계
25
25
  - 명령 인텐트 상태별 실행 정책
26
26
  - 장기 실행 프로세스 방지 정책
@@ -217,15 +217,20 @@ mustflow 지침은 다음 지점에서 다시 확인합니다.
217
217
 
218
218
  프로젝트 내에 숨겨진 내부 추론, 비밀정보, 전체 대화 전문, 전체 터미널 출력, 원본 이벤트 로그, 원본 명령 로그를 저장하지 않습니다. 향후 호스트가 요약을 만들더라도 요약은 출처가 있어야 하며, 현재 파일과 현재 사용자 지시보다 낮은 권위를 가집니다.
219
219
 
220
- ## 실행 하네스 계약 경계
220
+ ## 실행 하네스와 런타임 표면
221
221
 
222
- mustflow는 자율 에이전트 실행 환경이 아닙니다. mustflow는 여러 에이전트 실행 하네스가 저장소에 들어왔을 때 읽고 따를 수 있는 저장소 내부 작업 계약층입니다.
222
+ mustflow는 저장소 안의 작업 흐름 파일과 명령 실행 경계에서 시작하지만, 선택형 런타임,
223
+ 조정, 작업 항목, 어댑터, 하네스 표면으로 확장될 수 있습니다. 새 표면은 문서 문구,
224
+ 생성 상태, 추측 명령에 몰래 섞는 대신 명시적이고, 경계가 있고, 검토 가능해야 합니다.
223
225
 
224
- - 사고 계약: `AGENTS.md`, 이 문서, 스킬 문서는 모델이 따라야 할 작업 절차를 설명합니다.
225
- - 실행 계약: `.mustflow/config/commands.toml`과 `mf run`은 안전한 명령 실행 경계를 정합니다.
226
- - 세션 계약: 실행 기록, 제한된 체크포인트, 작은 인계 문서는 복구와 검토 근거를 남깁니다.
226
+ - 사고 표면: `AGENTS.md`, 이 문서, 스킬 문서는 모델이 따라야 할 작업 절차를 설명합니다.
227
+ - 실행 표면: `.mustflow/config/commands.toml`과 `mf run`은 안전한 명령 실행 경계를 정합니다.
228
+ - 세션 표면: 실행 기록, 제한된 체크포인트, 작은 인계 문서, 향후 작업 항목 기록은 복구와 검토 근거를 남깁니다.
229
+ - 런타임 표면: 작업자 폴더, 페르소나 시스템, 다중 실행 조정, 서비스 프로세스,
230
+ 자율 반복 실행기는 생명주기, 보존, 격리, 승인, 검증 규칙을 선언해야 합니다.
227
231
 
228
- 저장소가 명시적으로 선택 기능을 추가하지 않았다면 `workers/`, `personas/`, 여러 에이전트 조정 폴더, 원시 이벤트 로그, 자율 반복 실행기를 만들지 않습니다.
232
+ 런타임이나 조정 표면을 암묵적 관습으로 운용하지 않습니다. 저장소가 해당 기능을 지원하기로
233
+ 선택하면 명시적 설정, 명령 계약, 테스트, 문서를 통해 추가하거나 켭니다.
229
234
 
230
235
  ## 장기 작업 단계
231
236
 
@@ -2,7 +2,7 @@
2
2
  mustflow_doc: agents.root
3
3
  locale: ko
4
4
  canonical: false
5
- revision: 21
5
+ revision: 22
6
6
  lifecycle: user-editable
7
7
  authority: binding
8
8
  ---
@@ -38,7 +38,7 @@ mustflow가 관리하는 세부 문서와 설정은 `.mustflow/` 폴더 아래
38
38
  - `mf run` 명령 인텐트는 순차적으로 실행합니다. 설정된 인텐트가 아직 실행 중이면 다른 `mf run`을 시작하지 말고, 특히 인텐트가 `dist/`처럼 비어 있지 않은 `writes`를 선언한 경우 반드시 완료될 때까지 기다립니다.
39
39
  - 위험을 최소화하는 가장 좁은 검증 명령 인텐트를 선택합니다. 명령 계약에 관련 테스트나 빠른 검사가 있으면 넓은 전체 테스트보다 우선하며, 더 좁은 검증 인텐트가 없으면 느린 전체 테스트를 조용히 기본값으로 삼지 말고 누락 사실을 보고합니다.
40
40
  - 개발 서버, 감시 모드, 브라우저, 대화형 명령, 백그라운드 프로세스는 직접 실행하지 않습니다.
41
- - 이 저장소가 명시적으로 설정하지 않았다면 자율 반복 실행기, 다중 작업자 조정, 페르소나 시스템, 장기 실행 하네스(실행 환경)는 시작하지 않습니다.
41
+ - 이 저장소가 생명주기, 안전 경계, 승인 경계를 명시적으로 설정하지 않았다면 자율 반복 실행기, 다중 작업자 조정, 페르소나 시스템, 장기 실행 하네스(실행 환경)는 시작하지 않습니다.
42
42
  - 작업이 장시간 실행되거나 민감한 상태에 영향을 줄 수 있다면 `.mustflow/config/mustflow.toml`의 `[budget]`, `[approval]`, `[isolation]` 정책을 따릅니다.
43
43
  - 수정 전 현재 mustflow 루트 상태와 다음 단계를 빠르게 확인하려면 `mf doctor` 또는 `mf doctor --json`을 사용합니다. 이 명령은 파일을 쓰지 않는 진단용 명령입니다.
44
44
  - `mf context --json`은 읽기 전용 컨텍스트 확인 용도로 사용할 수 있으나, 실제 작업 규칙이나 명령 계약을 대체하지 않습니다.
@@ -1,6 +1,6 @@
1
1
  id = "default"
2
2
  name = "default"
3
- version = "2.31.0"
3
+ version = "2.37.1"
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"
@@ -13,12 +13,17 @@ creates = [
13
13
  ".mustflow/skills/routes.toml",
14
14
  ".mustflow/skills/adapter-boundary/SKILL.md",
15
15
  ".mustflow/skills/api-contract-change/SKILL.md",
16
+ ".mustflow/skills/backend-reliability-change/SKILL.md",
17
+ ".mustflow/skills/http-delivery-streaming/SKILL.md",
16
18
  ".mustflow/skills/artifact-integrity-check/SKILL.md",
17
19
  ".mustflow/skills/architecture-deepening-review/SKILL.md",
20
+ ".mustflow/skills/service-boundary-architecture/SKILL.md",
18
21
  ".mustflow/skills/auth-permission-change/SKILL.md",
19
22
  ".mustflow/skills/behavior-preserving-refactor/SKILL.md",
20
23
  ".mustflow/skills/code-review/SKILL.md",
24
+ ".mustflow/skills/ai-generated-code-hardening/SKILL.md",
21
25
  ".mustflow/skills/codebase-orientation/SKILL.md",
26
+ ".mustflow/skills/heuristic-candidate-selection/SKILL.md",
22
27
  ".mustflow/skills/clarifying-question-gate/SKILL.md",
23
28
  ".mustflow/skills/completion-evidence-gate/SKILL.md",
24
29
  ".mustflow/skills/evidence-stall-breaker/SKILL.md",
@@ -75,6 +80,7 @@ creates = [
75
80
  ".mustflow/skills/external-skill-intake/SKILL.md",
76
81
  ".mustflow/skills/github-contribution-quality-gate/SKILL.md",
77
82
  ".mustflow/skills/file-path-cross-platform-change/SKILL.md",
83
+ ".mustflow/skills/frontend-render-stability/SKILL.md",
78
84
  ".mustflow/skills/idea-triage/SKILL.md",
79
85
  ".mustflow/skills/facade-pattern/SKILL.md",
80
86
  ".mustflow/skills/instruction-conflict-scope-check/SKILL.md",
@@ -88,6 +94,7 @@ creates = [
88
94
  ".mustflow/skills/process-execution-safety/SKILL.md",
89
95
  ".mustflow/skills/public-json-contract-change/SKILL.md",
90
96
  ".mustflow/skills/provenance-license-gate/SKILL.md",
97
+ ".mustflow/skills/proactive-risk-surfacing/SKILL.md",
91
98
  ".mustflow/skills/repo-improvement-loop/SKILL.md",
92
99
  ".mustflow/skills/restricted-handoff-resume/SKILL.md",
93
100
  ".mustflow/skills/structure-discovery-gate/SKILL.md",
@@ -140,10 +147,14 @@ available = ["minimal", "patterns", "oss", "team", "product", "library"]
140
147
  minimal = [
141
148
  "adapter-boundary",
142
149
  "api-contract-change",
150
+ "backend-reliability-change",
151
+ "http-delivery-streaming",
143
152
  "auth-permission-change",
144
153
  "behavior-preserving-refactor",
145
154
  "code-review",
155
+ "ai-generated-code-hardening",
146
156
  "codebase-orientation",
157
+ "heuristic-candidate-selection",
147
158
  "clarifying-question-gate",
148
159
  "completion-evidence-gate",
149
160
  "evidence-stall-breaker",
@@ -189,6 +200,7 @@ minimal = [
189
200
  "instruction-conflict-scope-check",
190
201
  "pattern-scout",
191
202
  "provenance-license-gate",
203
+ "proactive-risk-surfacing",
192
204
  "requirement-regression-guard",
193
205
  "restricted-handoff-resume",
194
206
  "repro-first-debug",
@@ -205,11 +217,16 @@ minimal = [
205
217
  patterns = [
206
218
  "adapter-boundary",
207
219
  "architecture-deepening-review",
220
+ "service-boundary-architecture",
208
221
  "api-contract-change",
222
+ "backend-reliability-change",
223
+ "http-delivery-streaming",
209
224
  "auth-permission-change",
210
225
  "behavior-preserving-refactor",
211
226
  "code-review",
227
+ "ai-generated-code-hardening",
212
228
  "codebase-orientation",
229
+ "heuristic-candidate-selection",
213
230
  "clarifying-question-gate",
214
231
  "completion-evidence-gate",
215
232
  "evidence-stall-breaker",
@@ -261,6 +278,7 @@ patterns = [
261
278
  "pattern-scout",
262
279
  "pure-core-imperative-shell",
263
280
  "provenance-license-gate",
281
+ "proactive-risk-surfacing",
264
282
  "repo-improvement-loop",
265
283
  "restricted-handoff-resume",
266
284
  "result-option",
@@ -281,12 +299,17 @@ patterns = [
281
299
  oss = [
282
300
  "adapter-boundary",
283
301
  "api-contract-change",
302
+ "backend-reliability-change",
303
+ "http-delivery-streaming",
284
304
  "artifact-integrity-check",
285
305
  "architecture-deepening-review",
306
+ "service-boundary-architecture",
286
307
  "auth-permission-change",
287
308
  "behavior-preserving-refactor",
288
309
  "code-review",
310
+ "ai-generated-code-hardening",
289
311
  "codebase-orientation",
312
+ "heuristic-candidate-selection",
290
313
  "clarifying-question-gate",
291
314
  "completion-evidence-gate",
292
315
  "evidence-stall-breaker",
@@ -348,6 +371,7 @@ oss = [
348
371
  "provenance-license-gate",
349
372
  "public-json-contract-change",
350
373
  "pure-core-imperative-shell",
374
+ "proactive-risk-surfacing",
351
375
  "readme-authoring",
352
376
  "release-notes-authoring",
353
377
  "release-publish-change",
@@ -374,11 +398,16 @@ oss = [
374
398
  team = [
375
399
  "adapter-boundary",
376
400
  "architecture-deepening-review",
401
+ "service-boundary-architecture",
377
402
  "api-contract-change",
403
+ "backend-reliability-change",
404
+ "http-delivery-streaming",
378
405
  "auth-permission-change",
379
406
  "behavior-preserving-refactor",
380
407
  "code-review",
408
+ "ai-generated-code-hardening",
381
409
  "codebase-orientation",
410
+ "heuristic-candidate-selection",
382
411
  "clarifying-question-gate",
383
412
  "completion-evidence-gate",
384
413
  "evidence-stall-breaker",
@@ -434,6 +463,7 @@ team = [
434
463
  "process-execution-safety",
435
464
  "pure-core-imperative-shell",
436
465
  "provenance-license-gate",
466
+ "proactive-risk-surfacing",
437
467
  "result-option",
438
468
  "requirement-regression-guard",
439
469
  "restricted-handoff-resume",
@@ -453,10 +483,15 @@ team = [
453
483
  product = [
454
484
  "adapter-boundary",
455
485
  "api-contract-change",
486
+ "backend-reliability-change",
487
+ "http-delivery-streaming",
488
+ "service-boundary-architecture",
456
489
  "auth-permission-change",
457
490
  "behavior-preserving-refactor",
458
491
  "code-review",
492
+ "ai-generated-code-hardening",
459
493
  "codebase-orientation",
494
+ "heuristic-candidate-selection",
460
495
  "clarifying-question-gate",
461
496
  "completion-evidence-gate",
462
497
  "evidence-stall-breaker",
@@ -503,6 +538,7 @@ product = [
503
538
  "github-contribution-quality-gate",
504
539
  "failure-triage",
505
540
  "file-path-cross-platform-change",
541
+ "frontend-render-stability",
506
542
  "idea-triage",
507
543
  "instruction-conflict-scope-check",
508
544
  "llm-service-ux-review",
@@ -511,6 +547,7 @@ product = [
511
547
  "performance-budget-check",
512
548
  "pure-core-imperative-shell",
513
549
  "provenance-license-gate",
550
+ "proactive-risk-surfacing",
514
551
  "result-option",
515
552
  "requirement-regression-guard",
516
553
  "restricted-handoff-resume",
@@ -534,12 +571,17 @@ product = [
534
571
  library = [
535
572
  "adapter-boundary",
536
573
  "api-contract-change",
574
+ "backend-reliability-change",
575
+ "http-delivery-streaming",
537
576
  "artifact-integrity-check",
538
577
  "architecture-deepening-review",
578
+ "service-boundary-architecture",
539
579
  "auth-permission-change",
540
580
  "behavior-preserving-refactor",
541
581
  "code-review",
582
+ "ai-generated-code-hardening",
542
583
  "codebase-orientation",
584
+ "heuristic-candidate-selection",
543
585
  "clarifying-question-gate",
544
586
  "completion-evidence-gate",
545
587
  "evidence-stall-breaker",
@@ -600,6 +642,7 @@ library = [
600
642
  "provenance-license-gate",
601
643
  "public-json-contract-change",
602
644
  "pure-core-imperative-shell",
645
+ "proactive-risk-surfacing",
603
646
  "readme-authoring",
604
647
  "release-notes-authoring",
605
648
  "release-publish-change",