mindforge-cc 11.7.1 → 11.8.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 (91) hide show
  1. package/.agent/mindforge/wf-accessibility-audit.md +31 -0
  2. package/.agent/mindforge/wf-ai-model-eval.md +31 -0
  3. package/.agent/mindforge/wf-api-contract-test.md +31 -0
  4. package/.agent/mindforge/wf-api-migration.md +31 -0
  5. package/.agent/mindforge/wf-architecture-modernization.md +32 -0
  6. package/.agent/mindforge/wf-catalog.md +25 -3
  7. package/.agent/mindforge/wf-code-explainer.md +31 -0
  8. package/.agent/mindforge/wf-competitive-teardown.md +31 -0
  9. package/.agent/mindforge/wf-cost-analysis.md +31 -0
  10. package/.agent/mindforge/wf-data-pipeline-validate.md +31 -0
  11. package/.agent/mindforge/wf-database-migration.md +31 -0
  12. package/.agent/mindforge/wf-debug-detective.md +32 -0
  13. package/.agent/mindforge/wf-dependency-health.md +31 -0
  14. package/.agent/mindforge/wf-design-system-audit.md +31 -0
  15. package/.agent/mindforge/wf-documentation-gen.md +31 -0
  16. package/.agent/mindforge/wf-multi-repo-sync.md +31 -0
  17. package/.agent/mindforge/wf-mutation-testing.md +31 -0
  18. package/.agent/mindforge/wf-security-hardening.md +32 -0
  19. package/.agent/mindforge/wf-security-threat-model.md +31 -0
  20. package/.agent/mindforge/wf-test-coverage-gap.md +31 -0
  21. package/.agent/mindforge/wf-ux-heuristic-audit.md +31 -0
  22. package/.agent/mindforge/wf-writer-reviewer.md +30 -0
  23. package/.claude/commands/mindforge/wf-accessibility-audit.md +31 -0
  24. package/.claude/commands/mindforge/wf-ai-model-eval.md +31 -0
  25. package/.claude/commands/mindforge/wf-api-contract-test.md +31 -0
  26. package/.claude/commands/mindforge/wf-api-migration.md +31 -0
  27. package/.claude/commands/mindforge/wf-architecture-modernization.md +32 -0
  28. package/.claude/commands/mindforge/wf-catalog.md +25 -3
  29. package/.claude/commands/mindforge/wf-code-explainer.md +31 -0
  30. package/.claude/commands/mindforge/wf-competitive-teardown.md +31 -0
  31. package/.claude/commands/mindforge/wf-cost-analysis.md +31 -0
  32. package/.claude/commands/mindforge/wf-data-pipeline-validate.md +31 -0
  33. package/.claude/commands/mindforge/wf-database-migration.md +31 -0
  34. package/.claude/commands/mindforge/wf-debug-detective.md +32 -0
  35. package/.claude/commands/mindforge/wf-dependency-health.md +31 -0
  36. package/.claude/commands/mindforge/wf-design-system-audit.md +31 -0
  37. package/.claude/commands/mindforge/wf-documentation-gen.md +31 -0
  38. package/.claude/commands/mindforge/wf-multi-repo-sync.md +31 -0
  39. package/.claude/commands/mindforge/wf-mutation-testing.md +31 -0
  40. package/.claude/commands/mindforge/wf-security-hardening.md +32 -0
  41. package/.claude/commands/mindforge/wf-security-threat-model.md +31 -0
  42. package/.claude/commands/mindforge/wf-test-coverage-gap.md +31 -0
  43. package/.claude/commands/mindforge/wf-ux-heuristic-audit.md +31 -0
  44. package/.claude/commands/mindforge/wf-writer-reviewer.md +30 -0
  45. package/.mindforge/config.json +2 -2
  46. package/.mindforge/dynamic-workflows/REGISTRY.md +57 -60
  47. package/.mindforge/dynamic-workflows/index.json +730 -59
  48. package/.mindforge/dynamic-workflows/scripts/accessibility-audit.js +119 -0
  49. package/.mindforge/dynamic-workflows/scripts/ai-model-eval.js +82 -0
  50. package/.mindforge/dynamic-workflows/scripts/api-contract-test.js +114 -0
  51. package/.mindforge/dynamic-workflows/scripts/api-migration.js +156 -0
  52. package/.mindforge/dynamic-workflows/scripts/architecture-modernization.js +111 -0
  53. package/.mindforge/dynamic-workflows/scripts/code-explainer.js +138 -0
  54. package/.mindforge/dynamic-workflows/scripts/competitive-teardown.js +142 -0
  55. package/.mindforge/dynamic-workflows/scripts/cost-analysis.js +107 -0
  56. package/.mindforge/dynamic-workflows/scripts/data-pipeline-validate.js +69 -0
  57. package/.mindforge/dynamic-workflows/scripts/database-migration.js +113 -0
  58. package/.mindforge/dynamic-workflows/scripts/debug-detective.js +124 -0
  59. package/.mindforge/dynamic-workflows/scripts/dependency-health.js +110 -0
  60. package/.mindforge/dynamic-workflows/scripts/design-system-audit.js +115 -0
  61. package/.mindforge/dynamic-workflows/scripts/documentation-gen.js +91 -0
  62. package/.mindforge/dynamic-workflows/scripts/multi-repo-sync.js +63 -0
  63. package/.mindforge/dynamic-workflows/scripts/mutation-testing.js +148 -0
  64. package/.mindforge/dynamic-workflows/scripts/security-hardening.js +154 -0
  65. package/.mindforge/dynamic-workflows/scripts/security-threat-model.js +159 -0
  66. package/.mindforge/dynamic-workflows/scripts/test-coverage-gap.js +95 -0
  67. package/.mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js +122 -0
  68. package/.mindforge/dynamic-workflows/scripts/writer-reviewer.js +85 -0
  69. package/.mindforge/memory/sync-manifest.json +1 -1
  70. package/CHANGELOG.md +43 -0
  71. package/MINDFORGE.md +2 -2
  72. package/README.md +42 -5
  73. package/RELEASENOTES.md +36 -0
  74. package/SECURITY.md +9 -0
  75. package/bin/autonomous/auto-runner.js +8 -2
  76. package/bin/autonomous/dependency-dag.js +1 -1
  77. package/bin/browser/session-manager.js +3 -1
  78. package/bin/governance/ztai-manager.js +6 -0
  79. package/bin/memory/eis-client.js +6 -2
  80. package/bin/spawn-agent.js +10 -7
  81. package/bin/sre/sli-verifier.js +9 -1
  82. package/bin/workflows/workflow-runner.js +18 -2
  83. package/docs/commands-reference.md +40 -14
  84. package/docs/getting-started.md +13 -1
  85. package/docs/sdk-reference.md +13 -1
  86. package/docs/troubleshooting.md +9 -0
  87. package/docs/user-guide.md +20 -1
  88. package/package.json +1 -1
  89. package/.agent/mindforge/wf-deep-research.md +0 -32
  90. package/.claude/commands/mindforge/wf-deep-research.md +0 -32
  91. package/.mindforge/dynamic-workflows/scripts/deep-research.js +0 -151
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Asset inventory → STRIDE threat enumeration → parallel mitigations → CVSS-style score matrix"
3
+ ---
4
+ # /mindforge:wf-security-threat-model
5
+
6
+ Runs the **Security Threat Model** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-security-threat-model <system or codebase to threat model>`
10
+
11
+ ## What it does
12
+ - **Assets**: Inventory system assets, data flows, and trust boundaries
13
+ - **STRIDE**: 6 parallel STRIDE threat agents — one per threat category
14
+ - **Mitigate**: Parallel mitigation agent per identified threat
15
+ - **Score**: CVSS-style risk score matrix with remediation priority
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/security-threat-model.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info security-threat-model
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Parallel per-module coverage analysis → gap map → prioritized test-writing plan"
3
+ ---
4
+ # /mindforge:wf-test-coverage-gap
5
+
6
+ Runs the **Test Coverage Gap** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-test-coverage-gap <target or question>`
10
+
11
+ ## What it does
12
+ - **Discover**: Map modules and identify testable units
13
+ - **Analyze**: Parallel coverage analysis per module
14
+ - **GapMap**: Synthesize gaps by severity and risk
15
+ - **Plan**: Prioritized test-writing plan with concrete test cases
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/test-coverage-gap.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info test-coverage-gap
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "10 Nielsen heuristics parallel audit → severity ranking → fix brief"
3
+ ---
4
+ # /mindforge:wf-ux-heuristic-audit
5
+
6
+ Runs the **UX Heuristic Audit** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-ux-heuristic-audit <UI codebase or app description>`
10
+
11
+ ## What it does
12
+ - **Scope**: Define target UI and identify key user flows to audit
13
+ - **Audit**: 10 parallel heuristic evaluators — one per Nielsen heuristic
14
+ - **Rank**: Severity ranking of all violations by impact on user experience
15
+ - **Brief**: Prioritized fix brief with specific design recommendations
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info ux-heuristic-audit
31
+ ```
@@ -0,0 +1,30 @@
1
+ ---
2
+ description: "Anthropic Writer/Reviewer pattern: implement in Context A → fresh Context B reviews the diff"
3
+ ---
4
+ # /mindforge:wf-writer-reviewer
5
+
6
+ Runs the **Writer Reviewer** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-writer-reviewer <implementation task description>`
10
+
11
+ ## What it does
12
+ - **Implement**: Writer agent implements the requested change
13
+ - **Review**: Fresh reviewer agent inspects only the diff without implementation context
14
+ - **Verdict**: Accept / request-changes verdict with specific actionable feedback
15
+
16
+ ## Running
17
+
18
+ Invoke via Claude Code's Workflow tool:
19
+
20
+ ```
21
+ Workflow({
22
+ scriptPath: ".mindforge/dynamic-workflows/scripts/writer-reviewer.js",
23
+ args: "<your input>"
24
+ })
25
+ ```
26
+
27
+ Or discover via CLI:
28
+ ```bash
29
+ node bin/mindforge-cli.js workflow info writer-reviewer
30
+ ```
@@ -1,11 +1,11 @@
1
1
  {
2
- "version": "11.7.1",
2
+ "version": "11.8.1",
3
3
  "environment": "development",
4
4
  "governance": {
5
5
  "drift_threshold": 0.75,
6
6
  "critical_drift_threshold": 0.5,
7
7
  "res_threshold": 0.8,
8
- "active_did": "did:mindforge:2a10db1a-ceef-4c2c-8fc1-bdc981d39b2f"
8
+ "active_did": "did:mindforge:2666a4d8-1d9c-4736-b157-c75564ff9ef8"
9
9
  },
10
10
  "revops": {
11
11
  "market_registry": {
@@ -1,65 +1,62 @@
1
1
  # MindForge Dynamic Workflow Registry
2
2
 
3
- Dynamic workflows are multi-agent JS orchestration scripts that run via Claude Code's `Workflow` tool. They use `parallel()`, `pipeline()`, `phase()`, and `agent()` primitives to fan out work across multiple concurrent subagents and synthesize results.
3
+ 32 pre-built multi-agent workflows across 5 tiers. Each runs via Claude Code's `Workflow` tool using `parallel()`, `pipeline()`, `phase()`, and `agent()` primitives to fan out work across concurrent subagents and synthesize results.
4
4
 
5
5
  **Trigger:** Use `/mindforge:wf-catalog` to browse interactively, or invoke any `/mindforge:wf-<name>` command directly.
6
6
 
7
- **Discovery:** `node bin/mindforge-cli.js workflow list`
8
-
9
- ---
10
-
11
- ## Research Tier — Fan-out search, adversarial verification, cited output
12
-
13
- | Name | Command | Description | Phases |
14
- |------|---------|-------------|--------|
15
- | `deep-research` | `/mindforge:wf-deep-research` | Fan-out web research with adversarial claim verification and cited synthesis | Scope Search → Fetch → Verify → Synthesize |
16
- | `competitive-analysis` | `/mindforge:wf-competitive-analysis` | Multi-angle competitive research producing a SWOT and positioning summary | Scope → Research → SWOT → Position |
17
- | `tech-evaluation` | `/mindforge:wf-tech-evaluation` | Scored technology evaluation across DX, performance, security, ecosystem, community | Scope → Evaluate → Score → Recommend |
18
-
19
- ## Dev Tier Coding-assistant power workflows
20
-
21
- | Name | Command | Description | Phases |
22
- |------|---------|-------------|--------|
23
- | `code-audit` | `/mindforge:wf-code-audit` | Parallel security + quality + performance audit with adversarial finding verification | Scope Audit Verify → Report |
24
- | `feature-planner` | `/mindforge:wf-feature-planner` | Sequential pipeline: brief PRD → architecture → user stories | Brief PRD Arch → Stories |
25
- | `pr-review` | `/mindforge:wf-pr-review` | 4-dimensional parallel PR review: correctness, security, performance, style → verdict | Scope Review → Consensus → Verdict |
26
- | `tdd-sprint` | `/mindforge:wf-tdd-sprint` | Strict Red-Green-Refactor TDD loop with spec-first discipline | Spec Red Green → Refactor |
27
- | `refactor-plan` | `/mindforge:wf-refactor-plan` | Debt scan risk-sorted sequence safe refactor implementation plan | Scan Prioritize → Sequence → Plan |
28
-
29
- ## Ops Tier Infrastructure and release workflows
30
-
31
- | Name | Command | Description | Phases |
32
- |------|---------|-------------|--------|
33
- | `incident-response` | `/mindforge:wf-incident-response` | Parallel investigation: logs/metrics/traces/code → mitigation → RCA → postmortem | Alert → Investigate → Mitigate → RCA |
34
- | `release-prep` | `/mindforge:wf-release-prep` | Automated release pipeline: tests → changelog → version bump → PR → announcement | Check → Changelog → Bump → PR |
35
-
36
- ## Intelligence Tier Deep analysis and optimization
37
-
38
- | Name | Command | Description | Phases |
39
- |------|---------|-------------|--------|
40
- | `onboard-codebase` | `/mindforge:wf-onboard-codebase` | Map structure domain analysis architecture guided tour and onboarding docs | Map Domain → Arch → Tour |
41
- | `perf-optimize` | `/mindforge:wf-perf-optimize` | Profileparallel bottleneck hunt (DB/network/CPU/memory) prioritized fix plan | Profile Identify → Plan → Benchmark |
42
-
43
- ---
44
-
45
- ## Schema
46
-
47
- Each workflow script at `.mindforge/dynamic-workflows/scripts/<name>.js` exports:
48
-
49
- ```javascript
50
- export const meta = {
51
- name: '<name>', // matches filename (without .js)
52
- description: '<string>', // shown in this catalog
53
- whenToUse: '<string>', // trigger conditions
54
- phases: [{ title, detail }],
55
- }
56
- ```
57
-
58
- Scripts use the Claude Code `Workflow` tool primitives: `agent()`, `parallel()`, `pipeline()`, `phase()`, `log()`, `args`, `budget`.
59
-
60
- ## Adding a workflow
61
-
62
- 1. Write `.mindforge/dynamic-workflows/scripts/<name>.js` with a valid `meta` export
63
- 2. Add an entry to `index.json`
64
- 3. Add paired command files to `.agent/mindforge/wf-<name>.md` and `.claude/commands/mindforge/wf-<name>.md`
65
- 4. Run `npm test` — `tests/workflow-registry.test.js` validates all three steps
7
+ ## Research tier — Fan-out search, adversarial verification, cited synthesis
8
+
9
+ | Workflow | Command | Description | Best for |
10
+ |----------|---------|-------------|----------|
11
+ | competitive-analysis | /mindforge:wf-competitive-analysis | SWOT and positioning from 5 research angles | Evaluating products/companies against competitors |
12
+ | tech-evaluation | /mindforge:wf-tech-evaluation | Scored technology evaluation across 5 dimensions | Choosing frameworks, libraries, or platforms |
13
+ | ai-model-eval | /mindforge:wf-ai-model-eval | 4-parallel model benchmark → scoring matrix | Choosing between AI models or providers |
14
+ | ux-heuristic-audit | /mindforge:wf-ux-heuristic-audit | 10 Nielsen heuristics parallel audit → fix brief | UI usability review |
15
+ | competitive-teardown | /mindforge:wf-competitive-teardown | 5 competitor angles positioning report | Deep competitive intelligence |
16
+
17
+ ## Dev tier — Coding-assistant power workflows
18
+
19
+ | Workflow | Command | Description | Best for |
20
+ |----------|---------|-------------|----------|
21
+ | code-audit | /mindforge:wf-code-audit | Parallel security + quality + performance audit | Pre-release or pre-pentest code review |
22
+ | feature-planner | /mindforge:wf-feature-planner | Brief → PRD → architecture → user stories | Starting a new feature |
23
+ | pr-review | /mindforge:wf-pr-review | 4-dimensional parallel PR review verdict | Thorough pull request review |
24
+ | tdd-sprint | /mindforge:wf-tdd-sprint | Strict Red-Green-Refactor TDD loop | Implementing with test-driven development |
25
+ | refactor-plan | /mindforge:wf-refactor-plan | Debt scan risk-sorted safe refactor plan | Planning safe refactoring |
26
+ | test-coverage-gap | /mindforge:wf-test-coverage-gap | Per-module coverage analysis test-writing plan | Finding and fixing test gaps |
27
+ | api-contract-test | /mindforge:wf-api-contract-test | Writer/Reviewer spec vs implviolation report | API contract validation |
28
+ | debug-detective | /mindforge:wf-debug-detective | 4-hypothesis parallel investigation → scientific RCA | Hard-to-reproduce bugs |
29
+ | writer-reviewer | /mindforge:wf-writer-reviewer | Implement fresh context review → verdict | Unbiased code review |
30
+ | mutation-testing | /mindforge:wf-mutation-testing | Mutant generator → parallel kill-test → score | Test suite effectiveness |
31
+ | code-explainer | /mindforge:wf-code-explainer | Structure → domain → architecture → narrative tour | Onboarding to unfamiliar codebases |
32
+ | design-system-audit | /mindforge:wf-design-system-audit | 5-dimension parallel audit → consistency score | Design system health checks |
33
+
34
+ ## Ops tier Infrastructure and release workflows
35
+
36
+ | Workflow | Command | Description | Best for |
37
+ |----------|---------|-------------|----------|
38
+ | incident-response | /mindforge:wf-incident-response | Parallel investigation → mitigation → RCA → postmortem | Production incidents |
39
+ | release-prep | /mindforge:wf-release-prep | Tests → changelog → version bump → PR | Preparing a production release |
40
+ | dependency-health | /mindforge:wf-dependency-health | CVE + license + staleness auditrisk matrix | Pre-release dependency review |
41
+ | database-migration | /mindforge:wf-database-migration | Schema diff risk scriptsrunbook | Database schema migrations |
42
+ | multi-repo-sync | /mindforge:wf-multi-repo-sync | Per-repo audit → divergence map → sync plan | Multi-repo consistency |
43
+ | cost-analysis | /mindforge:wf-cost-analysis | Infra/API/query/bundle cost agents → ROI plan | Cloud and API cost reduction |
44
+
45
+ ## Intelligence tier — Deep analysis and optimization
46
+
47
+ | Workflow | Command | Description | Best for |
48
+ |----------|---------|-------------|----------|
49
+ | onboard-codebase | /mindforge:wf-onboard-codebase | Map → domain → architecture → guided tour | New team member onboarding |
50
+ | perf-optimize | /mindforge:wf-perf-optimize | Profile → bottleneck hunt → prioritized fix plan | Performance bottleneck investigation |
51
+ | architecture-modernization | /mindforge:wf-architecture-modernization | Legacy map → 3 designs → migration roadmap | Monolith-to-services, major rewrites |
52
+ | documentation-gen | /mindforge:wf-documentation-gen | Parallel doc gen normalize → publish-ready | Generating or refreshing docs |
53
+ | api-migration | /mindforge:wf-api-migration | Breaking change detection → guide → compat matrix | API versioning and migration |
54
+ | data-pipeline-validate | /mindforge:wf-data-pipeline-validate | Stage-by-stage validation → quality gates | Data pipeline correctness checks |
55
+
56
+ ## Beast tier — Compound workflows (5 phases, 8+ agents, adversarial verification)
57
+
58
+ | Workflow | Command | Description | Best for |
59
+ |----------|---------|-------------|----------|
60
+ | security-hardening | /mindforge:wf-security-hardening | 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap | Pre-launch security hardening |
61
+ | accessibility-audit | /mindforge:wf-accessibility-audit | WCAG 2.2 per-criterion → 3-vote verify → remediation spec | WCAG 2.2 compliance |
62
+ | security-threat-model | /mindforge:wf-security-threat-model | Asset inventory STRIDE x 6 → mitigations → CVSS matrix | Architecture threat modeling |