mvc-kit 2.13.1 → 2.13.2

package/agent-config/claude-code/agents/mvc-kit-architect.md

@@ -6,14 +6,14 @@ tools: Read, Grep, Glob, Bash
 memory: project
 color: blue
 skills:
-  - mvc-kit-guide
+  - mvc-kit
 ---
 
 You are an architecture planning agent for applications built with **mvc-kit**, a TypeScript-first reactive state management library for React. You help developers plan features by deciding which classes to create, designing state shapes, and selecting sharing patterns.
 
 ## Documentation
 
-The mvc-kit framework reference skill is preloaded into this agent's context. For deeper reference, read the supporting files in the mvc-kit skill directory (search for `.claude/skills/mvc-kit/` or `node_modules/mvc-kit/agent-config/claude-code/skills/guide/`):
+The mvc-kit framework reference skill is preloaded into this agent's context. For deeper reference, read the supporting files in the mvc-kit skill directory (search for `.claude/skills/mvc-kit/` or `node_modules/mvc-kit/agent-config/claude-code/skills/mvc-kit/`):
 
 - `api-reference.md` — Full API reference for all classes and hooks
 - `patterns.md` — Prescribed patterns with code examples

package/agent-config/claude-code/skills/{guide → mvc-kit}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: mvc-kit-guide
+name: mvc-kit
 description: "mvc-kit framework reference — class roles, architecture rules, React hooks, and decision framework. Use when working with mvc-kit imports or planning mvc-kit features."
 user-invocable: false
 ---

package/agent-config/lib/install-claude.mjs

@@ -1,37 +1,36 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, copyFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
+import { cpSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { join, dirname, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const SKILLS_DIR = join(__dirname, '..', 'claude-code', 'skills');
-const AGENTS_DIR = join(__dirname, '..', 'claude-code', 'agents');
-
-const AUTO_HEADER = '<!-- Auto-generated by mvc-kit. Updated on npm install/update. Do not edit. -->';
-
-function stripFrontmatter(content) {
-  const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
-  return match ? match[1].trim() : content.trim();
-}
-
-/** Insert auto-generated header after YAML frontmatter (preserves parsing). */
-function addHeader(content) {
-  const match = content.match(/^(---\n[\s\S]*?\n---\n)([\s\S]*)$/);
-  if (match) {
-    return match[1] + '\n' + AUTO_HEADER + '\n\n' + match[2].trim() + '\n';
-  }
-  return AUTO_HEADER + '\n\n' + content;
-}
-
-function ensureDir(dir) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
+const SOURCE_DIR = join(__dirname, '..', 'claude-code');
+
+const SKILL_NAMES = ['mvc-kit', 'mvc-kit-review', 'mvc-kit-scaffold'];
+const AGENT_FILES = ['mvc-kit-architect.md'];
+
+function listFilesRecursive(dir) {
+  const out = [];
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) {
+      for (const nested of listFilesRecursive(full)) {
+        out.push(join(entry, nested));
+      }
+    } else {
+      out.push(entry);
+    }
   }
+  return out;
 }
 
 /**
  * Install Claude Code integration files into a project's .claude/ directory.
  *
+ * Source directories under `agent-config/claude-code/` are copied verbatim —
+ * no frontmatter rewriting, no header injection. Source files are authored
+ * in their final installed form.
+ *
  * Creates:
  *   .claude/skills/mvc-kit/            — Framework reference skill + supporting docs
  *   .claude/skills/mvc-kit-review/     — Code review skill + checklist
@@ -39,109 +38,33 @@ function ensureDir(dir) {
  *   .claude/agents/mvc-kit-architect.md — Architecture planning agent
  *
  * @param {string} projectRoot — Absolute path to the consuming project's root
- * @returns {{ files: string[] }} — List of created/updated file paths (relative to projectRoot)
+ * @returns {{ files: string[] }} — List of installed file paths (relative to projectRoot)
  */
 export function installClaude(projectRoot) {
   const claudeDir = join(projectRoot, '.claude');
-  const guideDir = join(claudeDir, 'skills', 'mvc-kit');
-  const reviewDir = join(claudeDir, 'skills', 'mvc-kit-review');
-  const scaffoldDir = join(claudeDir, 'skills', 'mvc-kit-scaffold');
-  const templatesDir = join(scaffoldDir, 'templates');
-  const agentsDir = join(claudeDir, 'agents');
+  const skillsDest = join(claudeDir, 'skills');
+  const agentsDest = join(claudeDir, 'agents');
 
-  ensureDir(guideDir);
-  ensureDir(reviewDir);
-  ensureDir(scaffoldDir);
-  ensureDir(templatesDir);
-  ensureDir(agentsDir);
+  mkdirSync(skillsDest, { recursive: true });
+  mkdirSync(agentsDest, { recursive: true });
 
   const files = [];
 
-  // ─── 1. Guide skill — framework reference (model-invocable, auto-loaded) ───
-
-  const guideSkill = readFileSync(join(SKILLS_DIR, 'guide', 'SKILL.md'), 'utf-8');
-  const guideBody = stripFrontmatter(guideSkill)
-    // Remove the "Supporting Files" section — replaced with colocated file references below
-    .replace(/\n## Supporting Files[\s\S]*$/, '');
-
-  const GUIDE_FRONTMATTER = `---
-name: mvc-kit
-description: "mvc-kit framework reference — class roles, architecture rules, React hooks, and decision framework. Loaded on-demand when working with mvc-kit code."
-user-invocable: false
----`;
-
-  const skillContent = GUIDE_FRONTMATTER + '\n\n' + AUTO_HEADER + '\n\n' + guideBody + `
-
-## Supporting Files
-
-- [api-reference.md](api-reference.md) — Full API reference for all classes and hooks
-- [patterns.md](patterns.md) — Prescribed patterns with code examples
-- [anti-patterns.md](anti-patterns.md) — Anti-patterns to reject with fixes
-- [recipes.md](recipes.md) — Composition recipes for real-world features
-- [testing.md](testing.md) — Testing patterns (teardownAll, async assertions, memoization verification)
-
-### Per-Class Documentation (in \`node_modules/mvc-kit/src/\`)
-
-For deep dives on any specific class or hook, search for the \`.md\` file by name:
-
-- **Core:** \`ViewModel.md\`, \`Model.md\`, \`Collection.md\`, \`PersistentCollection.md\`, \`Resource.md\`, \`Service.md\`, \`EventBus.md\`, \`Channel.md\`, \`Controller.md\`, \`Trackable.md\`, \`singleton.md\`
-- **Helpers:** \`Sorting.md\`, \`Pagination.md\`, \`Selection.md\`, \`Feed.md\`, \`Pending.md\`, \`produceDraft.md\`
-- **React hooks:** \`react/use-local.md\`, \`react/use-instance.md\`, \`react/use-singleton.md\`, \`react/use-model.md\`, \`react/use-event-bus.md\`, \`react/use-teardown.md\`
-- **Components:** \`react/components/DataTable.md\`, \`react/components/CardList.md\`, \`react/components/InfiniteScroll.md\`
-`;
-
-  writeFileSync(join(guideDir, 'SKILL.md'), skillContent, 'utf-8');
-  files.push('.claude/skills/mvc-kit/SKILL.md');
-
-  // Copy supporting files alongside SKILL.md
-  const guideSupportFiles = ['api-reference.md', 'patterns.md', 'anti-patterns.md', 'recipes.md', 'testing.md'];
-  for (const file of guideSupportFiles) {
-    const src = join(SKILLS_DIR, 'guide', file);
-    if (existsSync(src)) {
-      copyFileSync(src, join(guideDir, file));
-      files.push(`.claude/skills/mvc-kit/${file}`);
+  for (const skill of SKILL_NAMES) {
+    const src = join(SOURCE_DIR, 'skills', skill);
+    const dest = join(skillsDest, skill);
+    cpSync(src, dest, { recursive: true, force: true });
+    for (const rel of listFilesRecursive(src)) {
+      files.push(`.claude/skills/${skill}/${rel}`);
     }
   }
 
-  // ─── 2. Review skill — code review with checklist ──────────────────────────
-
-  const reviewSkill = readFileSync(join(SKILLS_DIR, 'review', 'SKILL.md'), 'utf-8');
-  writeFileSync(join(reviewDir, 'SKILL.md'), addHeader(reviewSkill), 'utf-8');
-  files.push('.claude/skills/mvc-kit-review/SKILL.md');
-
-  copyFileSync(
-    join(SKILLS_DIR, 'review', 'checklist.md'),
-    join(reviewDir, 'checklist.md'),
-  );
-  files.push('.claude/skills/mvc-kit-review/checklist.md');
-
-  // ─── 3. Scaffold skill — code generation with templates ────────────────────
-
-  const scaffoldSkill = readFileSync(join(SKILLS_DIR, 'scaffold', 'SKILL.md'), 'utf-8');
-  writeFileSync(join(scaffoldDir, 'SKILL.md'), addHeader(scaffoldSkill), 'utf-8');
-  files.push('.claude/skills/mvc-kit-scaffold/SKILL.md');
-
-  const templatesSrc = join(SKILLS_DIR, 'scaffold', 'templates');
-  if (existsSync(templatesSrc)) {
-    for (const file of readdirSync(templatesSrc)) {
-      if (file.endsWith('.md')) {
-        copyFileSync(join(templatesSrc, file), join(templatesDir, file));
-        files.push(`.claude/skills/mvc-kit-scaffold/templates/${file}`);
-      }
-    }
+  for (const agent of AGENT_FILES) {
+    const src = join(SOURCE_DIR, 'agents', agent);
+    const dest = join(agentsDest, agent);
+    cpSync(src, dest, { force: true });
+    files.push(`.claude/agents/${agent}`);
   }
 
-  // ─── 4. Architect agent ────────────────────────────────────────────────────
-
-  let architectAgent = readFileSync(join(AGENTS_DIR, 'mvc-kit-architect.md'), 'utf-8');
-  // The source agent preloads "mvc-kit-guide" (the source skill name).
-  // In the installed context the guide skill is named "mvc-kit", so fix the reference.
-  architectAgent = architectAgent.replace(
-    /^(\s*- )mvc-kit-guide$/m,
-    '$1mvc-kit',
-  );
-  writeFileSync(join(agentsDir, 'mvc-kit-architect.md'), addHeader(architectAgent), 'utf-8');
-  files.push('.claude/agents/mvc-kit-architect.md');
-
   return { files };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mvc-kit",
-  "version": "2.13.1",
+  "version": "2.13.2",
   "description": "Zero-magic, class-based reactive ViewModel library",
   "type": "module",
   "main": "./dist/mvc-kit.cjs",