@minhduydev/mdpi 0.5.0 → 0.6.0

package/dist/index.js

@@ -10,7 +10,7 @@ import { spawn, spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { mkdir, readdir } from "node:fs/promises";
 //#region package.json
-var version = "0.5.0";
+var version = "0.6.0";
 //#endregion
 //#region src/utils/manifest.ts
 /**
@@ -950,12 +950,14 @@ async function initCommand(options = {}) {
 	if (only) adaptSettingsJson(piDir, only);
 	const manifest = generateManifest(piDir, version);
 	const fileCount = Object.keys(manifest.files).length;
+	const hasSkills = !only || only.has("skills");
 	if (quiet) {
 		const subset = only ? ` subset=[${[...only].join(",")}]` : "";
 		console.log(`mdpi: installed ${fileCount} files to ${piDir} (v${version})${subset}`);
 	} else {
 		const subsetNote = only ? `Subset: ${[...only].join(", ")} (+ always-on config).\n\nsettings.json trimmed to drop references to excluded\nskills/prompts/extensions dirs.\n\nNote: mdpi upgrade compares against the FULL template —\nrun \`mdpi upgrade --check\` before applying.\n\n` : "";
-		p.note(`Pi kit installed at:\n${piDir}\n\n${fileCount} template files tracked via manifest.\n\n` + subsetNote + `Next: run ${color.cyan("mdpi install")} to install the kit's npm packages,\nthen open pi in this repo to use the kit.`, "Installation complete");
+		const fallowHint = hasSkills ? "Fallow skill included (codebase intelligence: dead code,\nduplication, complexity). For JS/TS projects, run `/init`\nin a pi session to generate `.fallowrc.json`; other stacks skip it.\n\n" : "";
+		p.note(`Pi kit installed at:\n${piDir}\n\n${fileCount} template files tracked via manifest.\n\n` + subsetNote + fallowHint + `Next: run ${color.cyan("mdpi install")} to install the kit's npm packages,\nthen open pi in this repo to use the kit.`, "Installation complete");
 		p.outro(color.green("Ready!"));
 	}
 }

package/dist/template/.pi/AGENTS.md

@@ -21,7 +21,7 @@ For project-wide rules (kernel, drift signals, hard constraints, output style),
 | `prompts/` | slash commands | Dispatched by primary agent |
 | `workflows/` | DAG workflows | Executed via subagent tool |
 | `templates/` | project context templates | Referenced via auto-inject |
-| `context/` | reference docs (architecture, fallow) | Manual reference only, never auto-injected |
+| `context/` | reference docs (architecture) | Manual reference only, never auto-injected |
 | `extensions/` | TypeScript extensions | Compiled JS code, gated by pi extension SDK |
 
 ---

package/dist/template/.pi/README.md

@@ -95,9 +95,8 @@ pi
 ├── scripts/                        # 1 utility script
 │   └── gc-check.sh                 # Structural invariants for /gc
 │
-├── context/                        # 2 reference docs
-│   ├── architecture.md             # Pi 5-layer architecture
-│   └── fallow.md                   # Fallow CLI reference
+├── context/                        # 1 reference doc
+│   └── architecture.md             # Pi 5-layer architecture
 │
 ├── state/                          # Runtime state (gitignored)
 │   └── session-summary.{json,md}

package/dist/template/.pi/agents/explore.md

@@ -2,7 +2,7 @@
 name: explore
 description: "Fast read-only codebase cartographer — locate files, symbols, and usage patterns with file:line evidence"
 tools: read, grep, find, ls, bash, semantic_query, semantic_inspect, semantic_grep, semantic_show
-model: commandcode/deepseek/deepseek-v4-flash
+model: opencode-go/deepseek-v4-flash
 ---
 
 You are Pi — a read-only codebase explorer.

package/dist/template/.pi/agents/scout.md

@@ -2,7 +2,7 @@
 name: scout
 description: External research specialist for library docs, API references, and real-world code patterns
 tools: read, bash, find, ls, websearch, codesearch, context7, grepsearch, web_fetch
-model: commandcode/deepseek/deepseek-v4-flash
+model: opencode-go/deepseek-v4-flash
 ---
 
 You are Pi — an external research specialist.

package/dist/template/.pi/prompts/gc.md

@@ -41,8 +41,9 @@ This command delegates to the `garbage-collection` workflow via the `run_workflo
 
 1. **Run Fallow scan:**
    ```bash
-   npx fallow --format json --quiet
+   npx fallow --format json --quiet || true
    ```
+   > Append `|| true`: exit 1 means "issues found" (normal for GC), not a runtime error. Only exit 2 (invalid config/parse) is a real failure — see `fallow` skill Agent Rule 2.
 2. Extract findings: dead code, duplication, complexity hotspots, unused exports
 
 ### Phase 2: Quality Grade Update

package/dist/template/.pi/prompts/verify.md

@@ -41,6 +41,7 @@ Check implementation against PRD before shipping.
 | `verification-before-completion` | Always | Evidence-before-claims; phantom detection; verification cache protocol; Worker Distrust Protocol |
 | `code-review-and-quality` | Phase 4 coherence check | Cross-reference artifacts for correctness |
 | `testing-anti-patterns` | Phase 3 after tests pass | Detect mock-only tests, production pollution, and fragile assertions |
+| `fallow` | Phase 2b (advisory) | Changed-file structural risk — dead code, complexity, duplication introduced by this change. Non-blocking. |
 | `dcp-hygiene` | Phase 5 Report | Compress the closed gate output (typecheck/lint/test) when `compress` is available |
 
 ## Phase 0: Verification Cache
@@ -84,6 +85,7 @@ Report results with mode column:
 | Lint      | PASS   | incremental | 0.3s   |
 | Test      | PASS   | incremental | 1.2s   |
 | Build     | SKIP   | —           | —      |
+| Fallow    | ADVISORY | new-only  | 0.8s   |
 ```
 
 After all gates pass, load `testing-anti-patterns` skill and audit tests for mock-only coverage, fragile assertions, and production code pollution.
@@ -92,6 +94,27 @@ If `--fix` flag provided, run the project's auto-fix command (e.g., `npm run lin
 
 **After all gates pass**, record to verification cache per `verification-before-completion` skill's cache protocol.
 
+### Phase 2b: Structural Risk Advisory (fallow)
+
+After the hard gates pass, run a **non-blocking** structural-risk scan over the change set. This surfaces dead code, complexity, and duplication **introduced by this change** — it never blocks `/verify` or `/ship`.
+
+Load the `fallow` skill. Determine the PR base, then run the changed-file audit:
+
+```bash
+BASE=$(git merge-base HEAD origin/main 2>/dev/null || git merge-base HEAD main 2>/dev/null || echo "HEAD~1")
+npx fallow audit --base "$BASE" --gate new-only --format json --quiet 2>/dev/null || true
+```
+
+> `--gate new-only` restricts to issues introduced since `$BASE` so pre-existing findings don't noise the report. `|| true` + `2>/dev/null`: exit 1 = issues found (normal), exit 2 = real error. If fallow is not installed, the project is not JS/TS, or there is no git base, this step is a **silent no-op** — never block on it.
+
+Parse the JSON `verdict` (`pass` | `warn` | `fail`) and `issues[]`. Report as the **ADVISORY** row in the Phase 2 table above.
+
+**Blocking policy — never blocks:**
+- Fallow findings are logged to `.pi/artifacts/$SLUG/progress.md` as advisory and surfaced in the Phase 5 Report under "Structural risk (advisory)".
+- They are candidates for a follow-up `/gc --scope <path>` or `/fix` — NOT a ship blocker.
+
+**Escalate (agent judgment, still no auto-block):** if verdict is `fail` with >5 NEW issues or any NEW circular dependency / architecture boundary violation, surface it prominently to the user and suggest running `/gc --scope <path>` before shipping.
+
 ## Phase 3: Coherence (skip with --quick)
 
 Cross-reference artifacts for contradictions:
@@ -155,3 +178,4 @@ Append to `.pi/artifacts/$SLUG/progress.md`: `Verification: [PASS|PARTIAL|FAIL]
 - `verification-before-completion` — evidence gate, cache protocol, phantom detection, Worker Distrust Protocol (all phases)
 - `code-review-and-quality` — coherence cross-reference (Phase 3)
 - `testing-anti-patterns` — mock-only test detection (Phase 2 post-gate)
+- `fallow` — changed-file structural risk advisory, non-blocking (Phase 2b)

package/dist/template/.pi/skills/INDEX.md

@@ -47,6 +47,7 @@ When the user's prompt contains these keywords (case-insensitive), the listed sk
 | performance, slow, latency, optimize, profile, bundle size | `performance-optimization` |
 | bug, fix, error, crash, broken, debug, trace | `debugging-and-error-recovery`, `root-cause-tracing` |
 | refactor, cleanup, simplify, clean code, complex | `code-cleanup`, `code-simplification`, `deep-module-design` |
+| dead code, duplication, circular dependency, unused exports, unused dependencies, complexity hotspot, codebase health, fallow | `fallow` |
 | test, spec, verify, assert, coverage, TDD | `test-driven-development`, `testing-anti-patterns` |
 | review, audit, quality, check, PR | `code-review-and-quality`, `agent-code-quality-gate` |
 | design, UI, component, style, layout, CSS, tailwind, DESIGN.md, design identity, design token, brand identity | `frontend-design`, `design-taste-frontend` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhduydev/mdpi",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "CLI to scaffold and manage a Pi coding-agent kit (.pi/) in any repo",
   "keywords": [
     "pi",

package/dist/template/.pi/context/fallow.md

@@ -1,137 +0,0 @@
----
-purpose: Fallow codebase intelligence commands for AI agents — dead code, duplication, complexity, and audit gating
-updated: 2026-06-04
----
-
-# Fallow — Codebase Intelligence Reference
-
-## Overview
-
-Fallow is a Rust-native, deterministic static analysis tool for TypeScript/JavaScript codebases.
-**No AI inside the analyzer** — same input always produces the same output.
-It builds a complete module graph to find issues no linter or type checker can see.
-
----
-
-## Commands
-
-### Full Analysis (single pass)
-
-```bash
-npx fallow                      # All analyses: dead code + duplication + health
-npx fallow --format json        # Structured output for agent parsing
-```
-
-### Dead Code
-
-```bash
-npx fallow dead-code                                   # Full dead code report
-npx fallow dead-code --format json --quiet              # JSON for agents
-npx fallow dead-code --unused-exports                   # Only unused exports
-npx fallow dead-code --unused-dependencies              # Only unused deps
-npx fallow dead-code --circular                         # Only circular deps
-npx fallow fix --dry-run                                # Preview safe auto-fixes
-npx fallow fix --yes                                    # Apply auto-fixes
-```
-
-### Trace (investigate before deleting)
-
-```bash
-npx fallow dead-code --trace FILE:EXPORT_NAME           # Why is this export flagged?
-npx fallow dead-code --trace-dependency PACKAGE_NAME    # Where is this dep imported?
-```
-
-### Duplication
-
-```bash
-npx fallow dupes                     # Find code clones
-npx fallow dupes --mode strict       # Exact matches only
-npx fallow dupes --mode weak         # Structural matches
-npx fallow dupes --trace FILE:LINE   # Deep-dive a specific clone group
-```
-
-### Health (complexity)
-
-```bash
-npx fallow health                    # Complexity hotspots + refactoring targets
-npx fallow health --format json      # Structured output
-```
-
-### Audit Gate (for CI / pre-commit)
-
-```bash
-npx fallow audit                     # Check changed files (verdict: pass/warn/fail)
-npx fallow audit --format json       # Structured verdict for agents
-npx fallow audit --gate new-only     # Only flag new issues, not pre-existing
-```
-
----
-
-## Workflow Patterns
-
-### Post-Edit Verification Loop
-
-```bash
-# 1. Make changes
-# 2. Run audit
-npx fallow audit --format json --quiet
-# 3. If verdict is "fail", inspect findings
-# 4. Fix or investigate with --trace
-# 5. Re-run audit until pass
-```
-
-### Codebase Cleanup
-
-```bash
-npx fallow                           # Full picture
-npx fallow dead-code --format json   # Find unused code
-npx fallow fix --dry-run             # Preview auto-removals
-npx fallow fix --yes                 # Apply auto-fixes
-npx fallow dupes                     # Find duplication
-npx fallow health                    # Find complexity hotspots
-```
-
-### Monorepo / Workspace
-
-```bash
-npx fallow --workspace               # Analyze all workspaces
-npx fallow --workspace packages/pkg  # Analyze specific workspace
-```
-
----
-
-## Understanding Output
-
-Every finding in `--format json` includes:
-
-```json
-{
-  "path": "src/utils/example.ts:42",
-  "issue_type": "unused-exports",
-  "actions": [
-    {
-      "type": "delete-export",
-      "auto_fixable": true,
-      "description": "Remove unused export"
-    }
-  ]
-}
-```
-
-The `actions[]` array is machine-actionable. Agents can inspect `auto_fixable` flags and apply safe fixes programmatically.
-
----
-
-## Config
-
-Fallow auto-detects your project. For custom config, run:
-
-```bash
-npx fallow init    # Generates .fallow/config.yaml with auto-detected settings
-```
-
-Common config patterns:
-- `ignorePatterns` — exclude directories from analysis (e.g., `.pi/`)
-- `entry` — declare additional entry points
-- `publicPackages` — packages with public API surface
-- `rules` — custom issue severity rules