@dzhechkov/p-replicator 1.5.6 → 1.5.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/p-replicator",
-  "version": "1.5.6",
+  "version": "1.5.7",
   "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/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 |