@dzhechkov/p-replicator 1.5.6 → 1.5.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/p-replicator",
-  "version": "1.5.6",
+  "version": "1.5.8",
   "description": "P-Replicator — Claude Code toolkit for AI-assisted product development (Vibe Coding). Full /replicate pipeline, 10 modular skills (194K+ chars), /harvest knowledge extraction, swarm agents, quality gates, security patterns, cross-project learning.",
   "main": "src/cli.js",
   "bin": {
@@ -11,14 +11,6 @@
     "src/",
     "templates/"
   ],
-  "scripts": {
-    "test": "node --test tests/unit/utils.test.js tests/e2e/lifecycle.test.js tests/snapshot/templates.test.js",
-    "test:unit": "node --test tests/unit/utils.test.js",
-    "test:e2e": "node --test tests/e2e/lifecycle.test.js",
-    "test:snapshot": "node --test tests/snapshot/templates.test.js",
-    "test:doctor": "node bin/cli.js doctor",
-    "snapshot:baseline": "node tests/snapshot/update-baseline.js"
-  },
   "keywords": [
     "claude",
     "claude-code",
@@ -71,5 +63,13 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "test": "node --test tests/unit/utils.test.js tests/e2e/lifecycle.test.js tests/snapshot/templates.test.js",
+    "test:unit": "node --test tests/unit/utils.test.js",
+    "test:e2e": "node --test tests/e2e/lifecycle.test.js",
+    "test:snapshot": "node --test tests/snapshot/templates.test.js",
+    "test:doctor": "node bin/cli.js doctor",
+    "snapshot:baseline": "node tests/snapshot/update-baseline.js"
   }
-}
+}

package/src/cli.js

@@ -110,8 +110,14 @@ function parseArgs(argv) {
         command = 'version';
         break;
       default:
-        if (!arg.startsWith('-') && command === null) {
+        if (arg.startsWith('-')) {
+          error(`Unknown option: ${arg}`);
+          process.exit(1);
+        } else if (command === null) {
           command = arg;
+        } else {
+          error(`Unexpected argument: ${arg}`);
+          process.exit(1);
         }
         break;
     }

package/src/commands/init.js

@@ -85,7 +85,10 @@ function installComponent(key, comp, templatesDir, targetDir, options) {
     return [comp.src];
   }
 
-  return getRelativePaths(dest).map((rel) => path.join(comp.src, rel));
+  // Track files from the TEMPLATE source, never a scan of the destination — matches
+  // update.js's invariant (line ~112). Walking dest would adopt user-created files
+  // into the manifest, and a later `remove` would then delete them (user data loss).
+  return getRelativePaths(src).map((rel) => path.join(comp.src, rel));
 }
 
 // ---------------------------------------------------------------------------

package/templates/.claude/agents/replicate-coordinator.md

@@ -54,33 +54,35 @@ When skills reference `/mnt/skills/user/` paths, map them:
 | `[project-name]-cc-toolkit/` | project root (in-place) |
 | `[project-name].zip` | N/A (no packaging) |
 
-## What /replicate Generates
+## What /replicate Generates (post v1.4)
 
-After full pipeline execution, these files are created/modified:
+The workflow toolkit (all 11 commands, all 5 base rules, all 4 pipeline agents,
+the 10 skills, and `.claude/settings.json` + hook scripts) is **pre-shipped by
+`npx @dzhechkov/p-replicator init` — do NOT overwrite or regenerate it.** See
+`.claude/rules/replicate-pipeline.md` → "What Gets Generated vs Pre-shipped"
+for the authoritative contract that `verify` checks.
 
-### Generated Commands
-- `.claude/commands/start.md` — project bootstrap
-- `.claude/commands/feature.md` — 4-phase feature lifecycle
-- `.claude/commands/plan.md` — implementation planning
-- `.claude/commands/myinsights.md` — insights capture
-- `.claude/commands/deploy.md` — deployment workflow
-- `.claude/commands/test.md` — test generation (if applicable)
+Phase 3 generates ONLY project-specific artifacts derived from the SPARC docs:
 
 ### Generated Agents
-- `.claude/agents/planner.md` — from Pseudocode.md
-- `.claude/agents/code-reviewer.md` — from Refinement.md
-- `.claude/agents/architect.md` — from Architecture.md + Solution_Strategy.md
+- `.claude/agents/planner.md` — algorithm templates from Pseudocode.md
+- `.claude/agents/code-reviewer.md` — edge cases from Refinement.md
+- `.claude/agents/architect.md` — system design from Architecture.md + Solution_Strategy.md
 
 ### Generated Rules
-- `.claude/rules/git-workflow.md` — semantic commit conventions
-- `.claude/rules/insights-capture.md` — insight capture protocol
-- `.claude/rules/feature-lifecycle.md` — feature development protocol
-- `.claude/rules/security.md` — from Specification.md NFRs
-- `.claude/rules/coding-style.md` — from Architecture.md tech stack
-- `.claude/rules/secrets-management.md` — IF external APIs
-
-### Generated/Modified Config
-- `.claude/settings.json` — hooks (insights auto-commit on Stop)
+- `.claude/rules/security.md` — NFRs from Specification.md
+- `.claude/rules/coding-style.md` — tech-stack conventions from Architecture.md
+- `.claude/rules/secrets-management.md` — IF external APIs detected
+- `.claude/rules/testing.md` — test strategy from Refinement.md
+
+### Generated Skills (project-specific)
+- `.claude/skills/project-context/` — domain knowledge
+- `.claude/skills/coding-standards/` — tech-specific patterns
+- `.claude/skills/security-patterns/` — IF external APIs
+
+### Generated State + Conditional Config
+- `.claude/feature-roadmap.json` — feature list from PRD MVP scope
+- `.claude/commands/feature-ent.md` — IF DDD/ADR/C4 docs detected
 - `.mcp.json` — IF external integrations
 
 ### Generated Documentation

package/templates/.claude/commands/replicate.md

@@ -394,7 +394,7 @@ git commit -m "chore: initial project setup from SPARC documentation"
 │   ├── test-scenarios.md         # BDD scenarios
 │   └── features/                 # For future features
 ├── .claude/
-│   ├── commands/                 # /start, /feature, /plan, /test, /deploy, /myinsights
+│   ├── commands/                 # /start, /feature, /plan, /go, /run, /deploy, /myinsights
 │   ├── agents/                   # planner, code-reviewer, architect
 │   ├── skills/                   # 8 shared + project-specific skills
 │   ├── rules/                    # git-workflow, security, coding-style, ...
@@ -410,7 +410,9 @@ git commit -m "chore: initial project setup from SPARC documentation"
 - /start         — bootstrap project from docs
 - /feature [name] — full feature lifecycle
 - /plan [feature] — plan implementation
-- /test [scope]   — run/generate tests
+- /go [feature]   — smart pipeline router (auto-dispatch)
+- /run [mode]     — autonomous build loop
+- /next           — pick the next feature from roadmap
 - /deploy [env]   — deploy to environment
 - /myinsights     — capture development insights
 ═══════════════════════════════════════════════════════════════

package/templates/.claude/rules/replicate-pipeline.md

@@ -11,6 +11,22 @@ Product Discovery     Planning   Validation  Toolkit    Finalize
 
 Never skip Phase 2 (Validation). Toolkit (Phase 3) MUST be built on validated documentation.
 
+### Optional: UI replication (post-pipeline)
+
+When the goal includes rebuilding a target's **frontend** (not just the business/toolkit), the
+`clone-website` skill — [`@dzhechkov/skills-website-cloner`](https://www.npmjs.com/package/@dzhechkov/skills-website-cloner),
+the implementation counterpart to `reverse-engineering-unicorn` — produces a pixel-perfect
+Next.js clone of a live site.
+
+| Skill | Required | Purpose | Fallback |
+|-------|----------|---------|----------|
+| `clone-website` | OPTIONAL (external) | Reverse-engineer a live site → running Next.js/shadcn clone | use `frontend-design` to build a fresh UI, or skip |
+
+**Reference, not vendored** (per ADR-0001). It is NOT one of the pre-shipped p-replicator skills
+and has hard runtime prerequisites (a browser-MCP + a Next.js/shadcn/Tailwind scaffold). Install
+separately: `npx @dzhechkov/skills-website-cloner init` or `dz init --select clone-website`. If
+absent or its prerequisites are unmet, skip the UI-clone step and log a warning.
+
 ## Skill Loading Protocol
 
 When executing skills during the pipeline:

package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/03-generate-p0.md

@@ -33,6 +33,21 @@ From the Instrument Map this module uses:
 > AI systems routinely compress 211-line templates to 60 lines — this is a CRITICAL defect.
 > Validate: generated file line count must be >= 80% of template line count.
 
+> **CLAUDE CODE PRE-SHIPPED SKIP-LIST (post v1.4):** When this skill runs inside a
+> p-replicator project, several "P0 mandatory" items below are **already pre-shipped
+> by `npx @dzhechkov/p-replicator init`** and are protected by the do-not-overwrite
+> gate in `.claude/rules/replicate-pipeline.md` ("What Gets Generated vs Pre-shipped").
+> For these items, **VERIFY they exist — do NOT regenerate or overwrite them:**
+> - Commands: `start.md` (Item 4), `myinsights.md` (Item 5), `feature.md` (Item 6)
+> - Rules: `git-workflow.md` (Item 7), `insights-capture.md` (Item 8), `feature-lifecycle.md` (Item 9)
+> - Config: `.claude/settings.json` + `.claude/hooks/` scripts (Item 10)
+>
+> Treat their "Generate `.claude/...`" instructions as "confirm present; enhance content
+> only if explicitly requested". Generate fresh ONLY the project-specific items that are
+> NOT in the pre-shipped contract (CLAUDE.md, security.md, coding-style.md, and the
+> conditional P0 items). When running this skill standalone (no p-replicator init), generate
+> everything as written.
+
 ### P0 Mandatory Items (always generated)
 
 The following 16 items are generated for every project, regardless of pipeline

package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/04-generate-p1.md

@@ -25,6 +25,26 @@ engine and conditionally included based on project characteristics and document
 > AI systems routinely compress 211-line templates to 60 lines — this is a CRITICAL defect.
 > Validate: generated file line count must be >= 80% of template line count.
 
+> **CLAUDE CODE PRE-SHIPPED SKIP-LIST (post v1.4):** When this skill runs inside a
+> p-replicator project, several P1 items below are **already pre-shipped by
+> `npx @dzhechkov/p-replicator init`** and are protected by the do-not-overwrite gate
+> in `.claude/rules/replicate-pipeline.md` ("What Gets Generated vs Pre-shipped").
+> For these items, **VERIFY they exist — do NOT regenerate or overwrite them:**
+> - Commands: `plan.md`, `deploy.md`, `next.md`, `go.md`, `run.md`, `docs.md`
+> - Config merge: `.claude/settings.json` (already shipped; only add a new hook entry
+>   if a generated hook genuinely requires one, otherwise leave untouched)
+>
+> Note: `test.md` is **NOT** pre-shipped and is **NOT** part of the p-replicator command
+> set — do not advertise it in any generated CLAUDE.md/README command list. Generate
+> `test.md` only when this skill runs standalone (outside a p-replicator project) and the
+> project actually needs a test command.
+>
+> Generate fresh the genuinely project-specific P1 items: the `planner`/`code-reviewer`/
+> `architect` agents, `project-context`/`coding-standards`/`testing-patterns` skills,
+> `testing.md` rule, `feature-roadmap.json`, and (IF DDD docs) `feature-ent.md` +
+> enterprise lifecycle artifacts. When running standalone (no p-replicator init),
+> generate everything as written.
+
 ### Step 1: Filter P1 Candidates
 
 Select all instruments assigned tier P1 from the Instrument Map (score >= 12 after tier boosts).

package/templates/.claude/skills/cc-toolkit-generator-enhanced/modules/README.md

@@ -3,6 +3,17 @@
 Modular phase architecture for the toolkit generator.
 Each module is self-contained with: INPUT → PROCESS → OUTPUT → QUALITY GATE.
 
+> **Claude Code pre-shipped skip-list (post v1.4):** When these modules run inside a
+> p-replicator project, several items listed below as "generated" are actually
+> **pre-shipped by `npx @dzhechkov/p-replicator init`** and are protected by the
+> do-not-overwrite gate in `.claude/rules/replicate-pipeline.md`. Modules 03 and 04
+> carry an explicit skip-list note: those items must be **verified present, not
+> regenerated** (commands `start`/`myinsights`/`feature`/`plan`/`deploy`/`next`/`go`/
+> `run`/`docs`, base rules `git-workflow`/`insights-capture`/`feature-lifecycle`, and
+> `.claude/settings.json` + hooks). `test.md` is neither pre-shipped nor part of the
+> p-replicator command set. When run standalone (no p-replicator init), generate
+> everything as written.
+
 ## Phase Modules (Core Pipeline)
 
 | # | Module | File | Size | Purpose |

package/templates/.claude/skills/goap-research-ed25519/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: goap-research-ed25519
 description: Advanced GOAP research system with Ed25519 cryptographic verification for anti-hallucination protection. Combines Goal-Oriented Action Planning with cryptographic signatures to ensure source authenticity, claim verification, and citation chain integrity. Use for high-stakes research requiring verifiable facts, competitive intelligence, legal/medical research, or any context where hallucination prevention is critical. Triggers on "verified research", "trusted sources only", "anti-hallucination", "signed sources", "cryptographic verification".
+trust_tier: 1
+trust_tier_label: "Structured"
+trust_tier_path: "Run /bto-test to promote to Tier 2"
 ---
 
 # GOAP Research Skill with Ed25519 Verification

package/templates/.claude/skills/problem-solver-enhanced/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: problem-solver-enhanced
 description: Elite problem-solving system combining first principles thinking, game theory, root cause analysis, systematic frameworks AND TRIZ inventive principles for solving complex challenges. Use when facing complex challenges with unclear solutions, strategic decisions with multiple stakeholders, problems requiring breakthrough (not incremental) solutions, trade-offs that seem impossible to resolve, competitive scenarios requiring game-theoretic analysis, system design problems, or any situation requiring both analytical rigor and inventive thinking beyond surface-level solutions.
+trust_tier: 1
+trust_tier_label: "Structured"
+trust_tier_path: "Run /bto-test to promote to Tier 2"
 ---
 
 # Elite Problem Solver (Enhanced with TRIZ)

package/templates/.claude/skills/reverse-engineering-unicorn/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: reverse-engineering-unicorn
 description: Reverse engineer any company into a launch playbook with clickable CJM prototype. Triggers on "проанализируй компанию", "reverse engineer", "разбери бизнес-модель", "playbook запуска".
+trust_tier: 1
+trust_tier_label: "Structured"
+trust_tier_path: "Run /bto-test to promote to Tier 2"
 ---
 
 # Reverse Engineering Unicorn v2