@dzhechkov/keysarium 1.5.32 → 1.5.34

package/src/commands/doctor.js

@@ -5,7 +5,7 @@ const path = require('path');
 const {
   green, red, yellow, cyan, bold, dim,
   info, success, warn, error: logError,
-  fileExists, readJSON, readManifest,
+  fileExists, readJSON, readManifest, getTemplateFileNames,
   MANIFEST_FILE,
 } = require('../utils');
 
@@ -60,7 +60,7 @@ function checkFilesExist(manifest, targetDir) {
     return {
       passed: false,
       detail: `${missing.length} file(s) missing: ${missing.slice(0, 5).join(', ')}${missing.length > 5 ? '...' : ''}`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing files.`,
+      fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore missing files.`,
     };
   });
 }
@@ -76,7 +76,7 @@ function checkClaudeMd(targetDir) {
       return {
         passed: false,
         detail: 'CLAUDE.md not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} or ${cyan('@dzhechkov/keysarium init --force')} to restore.`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} or ${cyan('npx @dzhechkov/keysarium init --force')} to restore.`,
       };
     }
 
@@ -117,7 +117,7 @@ function checkSkillsComplete(targetDir) {
       return {
         passed: false,
         detail: '.claude/skills/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore skills.`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore skills.`,
       };
     }
 
@@ -165,141 +165,100 @@ function checkSkillsComplete(targetDir) {
 }
 
 /**
- * Check 4: All 11 command .md files are present.
+ * Shared body for the "every shipped <thing>.md is installed" checks.
+ *
+ * The expected list is DERIVED from the package's own templates/ tree, never hardcoded —
+ * a command or rule added to templates/ is named-checked on the next run with no edit here.
+ * (Regression this guards: the lists used to be frozen at a legacy 11-command / 7-rule
+ * subset, so `doctor` reported "All 11 command files present" on a 19-command install and
+ * newer files like feature-adr.md / dream.md / reward-learning.md were never named.)
  */
-function checkCommandsPresent(targetDir) {
-  return check('Commands present', () => {
-    const commandsDir = path.join(targetDir, '.claude', 'commands');
-    const expectedCommands = [
-      'casarium.md',
-      'new-research.md',
-      'parallel-research.md',
-      'discovery.md',
-      'explore-case.md',
-      'research.md',
-      'cjm-prototype.md',
-      'solve.md',
-      'architecture-phase.md',
-      'presentation.md',
-      'harvest.md',
-    ];
-
-    if (!fileExists(commandsDir)) {
-      return {
-        passed: false,
-        detail: '.claude/commands/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore commands.`,
-      };
-    }
+function checkComponentFilesPresent(targetDir, opts) {
+  const { checkName, componentKey, dirParts, noun } = opts;
 
-    const missing = [];
-    for (const cmd of expectedCommands) {
-      if (!fileExists(path.join(commandsDir, cmd))) {
-        missing.push(cmd);
-      }
-    }
+  return check(checkName, () => {
+    const dir = path.join(targetDir, ...dirParts);
+    const relDir = dirParts.join('/') + '/';
+    const expected = getTemplateFileNames(componentKey);
 
-    if (missing.length === 0) {
+    if (expected.length === 0) {
       return {
-        passed: true,
-        detail: `All ${expectedCommands.length} command files present`,
+        passed: false,
+        detail: `Cannot read the shipped ${noun} list from the package templates/ tree`,
+        fix: 'Reinstall the package: the templates/ directory is missing or unreadable.',
       };
     }
 
-    return {
-      passed: false,
-      detail: `Missing ${missing.length} command(s): ${missing.join(', ')}`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing commands.`,
-    };
-  });
-}
-
-/**
- * Check 5: All 7 rule .md files are present.
- */
-function checkRulesPresent(targetDir) {
-  return check('Rules present', () => {
-    const rulesDir = path.join(targetDir, '.claude', 'rules');
-    const expectedRules = [
-      'agent-swarm.md',
-      'anti-patterns.md',
-      'checkpoint-protocol.md',
-      'domain-specific.md',
-      'file-conventions.md',
-      'modular-reuse.md',
-      'research-quality.md',
-    ];
-
-    if (!fileExists(rulesDir)) {
+    if (!fileExists(dir)) {
       return {
         passed: false,
-        detail: '.claude/rules/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore rules.`,
+        detail: `${relDir} directory not found`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore ${noun}s.`,
       };
     }
 
-    const missing = [];
-    for (const rule of expectedRules) {
-      if (!fileExists(path.join(rulesDir, rule))) {
-        missing.push(rule);
-      }
-    }
+    const missing = expected.filter((name) => !fileExists(path.join(dir, name)));
 
     if (missing.length === 0) {
       return {
         passed: true,
-        detail: `All ${expectedRules.length} rule files present`,
+        detail: `All ${expected.length} ${noun} files present`,
       };
     }
 
     return {
       passed: false,
-      detail: `Missing ${missing.length} rule(s): ${missing.join(', ')}`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing rules.`,
+      detail: `Missing ${missing.length}/${expected.length} ${noun}(s): ${missing.slice(0, 5).join(', ')}${missing.length > 5 ? '...' : ''}`,
+      fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore missing ${noun}s.`,
     };
   });
 }
 
 /**
- * Check 6: All 5 agent .md files are present.
+ * Check 4: every shipped command .md file is present.
  */
-function checkAgentsPresent(targetDir) {
-  return check('Agents present', () => {
-    const agentsDir = path.join(targetDir, '.claude', 'agents');
-
-    if (!fileExists(agentsDir)) {
-      return {
-        passed: false,
-        detail: '.claude/agents/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore agents.`,
-      };
-    }
-
-    let entries;
-    try {
-      entries = fs.readdirSync(agentsDir);
-    } catch {
-      return {
-        passed: false,
-        detail: 'Cannot read .claude/agents/ directory',
-        fix: 'Check directory permissions.',
-      };
-    }
+function checkCommandsPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Commands present',
+    componentKey: 'commands',
+    dirParts: ['.claude', 'commands'],
+    noun: 'command',
+  });
+}
 
-    const mdFiles = entries.filter((e) => e.endsWith('.md'));
+/**
+ * Check 5: every shipped rule .md file is present.
+ */
+function checkRulesPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Rules present',
+    componentKey: 'rules',
+    dirParts: ['.claude', 'rules'],
+    noun: 'rule',
+  });
+}
 
-    if (mdFiles.length >= 5) {
-      return {
-        passed: true,
-        detail: `${mdFiles.length} agent file(s) present`,
-      };
-    }
+/**
+ * Check 5b: every shipped governance shard is present.
+ */
+function checkShardsPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Shards present',
+    componentKey: 'shards',
+    dirParts: ['.claude', 'shards'],
+    noun: 'shard',
+  });
+}
 
-    return {
-      passed: false,
-      detail: `Only ${mdFiles.length}/5 agent files found`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing agent templates.`,
-    };
+/**
+ * Check 6: every shipped agent template .md file is present.
+ */
+function checkAgentsPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Agents present',
+    componentKey: 'agents',
+    dirParts: ['.claude', 'agents'],
+    noun: 'agent',
   });
 }
 
@@ -314,7 +273,7 @@ function checkSettingsValid(targetDir) {
       return {
         passed: false,
         detail: '.claude/settings.json not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore settings.`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore settings.`,
       };
     }
 
@@ -390,7 +349,7 @@ async function run(options) {
   // ── a) Check manifest exists ───────────────────────────────────────────
   if (!fileExists(manifestPath)) {
     logError('Keysarium is not installed in this directory.');
-    info(`Run ${cyan('@dzhechkov/keysarium init')} to install.`);
+    info(`Run ${cyan('npx @dzhechkov/keysarium init')} to install.`);
     process.exit(1);
   }
 
@@ -411,6 +370,7 @@ async function run(options) {
     checkSkillsComplete(targetDir),
     checkCommandsPresent(targetDir),
     checkRulesPresent(targetDir),
+    checkShardsPresent(targetDir),
     checkAgentsPresent(targetDir),
     checkSettingsValid(targetDir),
     checkResearchDir(targetDir),

package/src/commands/init.js

@@ -90,7 +90,7 @@ async function run(options) {
   if (fileExists(manifestPath)) {
     if (!force) {
       warn('Keysarium is already installed in this directory.');
-      info(`Run ${cyan('@dzhechkov/keysarium update')} to update, or use ${yellow('--force')} to overwrite.`);
+      info(`Run ${cyan('npx @dzhechkov/keysarium update')} to update, or use ${yellow('--force')} to overwrite.`);
       process.exit(1);
     }
     warn('Existing installation found — overwriting (--force).');

package/src/commands/list.js

@@ -65,7 +65,7 @@ async function run(options) {
   // ── a) Read manifest ───────────────────────────────────────────────────
   if (!fileExists(manifestPath)) {
     warn('Keysarium is not installed in this directory.');
-    info(`Run ${cyan('@dzhechkov/keysarium init')} to install.`);
+    info(`Run ${cyan('npx @dzhechkov/keysarium init')} to install.`);
     process.exit(1);
   }
 

package/src/commands/remove.js

@@ -187,7 +187,7 @@ async function run(options) {
     console.log(`  ${dim('-')} ${skippedCount} file(s) already missing (skipped)`);
   }
   console.log('');
-  info(`To reinstall, run: ${cyan('@dzhechkov/keysarium init')}`);
+  info(`To reinstall, run: ${cyan('npx @dzhechkov/keysarium init')}`);
   console.log('');
 
   process.exit(0);

package/src/commands/update.js

@@ -30,7 +30,7 @@ async function run(options) {
   // ── a) Read existing manifest ───────────────────────────────────────────
   if (!fileExists(manifestPath)) {
     logError('Keysarium is not installed in this directory.');
-    info(`Run ${cyan('@dzhechkov/keysarium init')} to install.`);
+    info(`Run ${cyan('npx @dzhechkov/keysarium init')} to install.`);
     process.exit(1);
   }
 

package/src/utils.js

@@ -250,19 +250,105 @@ function getTemplatesDir() {
 // Component definitions
 // ===========================================================================
 
-const COMPONENTS = {
-  skills:    { src: '.claude/skills',         label: 'Skills (8 skill packs)',            group: 'core' },
-  commands:  { src: '.claude/commands',        label: 'Commands (13 slash commands)',      group: 'core' },
-  rules:     { src: '.claude/rules',           label: 'Rules (10 auto-loaded rules)',     group: 'core' },
-  shards:    { src: '.claude/shards',          label: 'Shards (7 context shards)',        group: 'core' },
-  agents:    { src: '.claude/agents',          label: 'Agent templates (5 swarm configs)', group: 'core' },
-  hooks:     { src: '.claude/settings.json',   label: 'Hooks configuration',              group: 'core', isFile: true },
-  lib:       { src: 'lib',                     label: 'Library modules (4 modules)',       group: 'extended' },
-  docs:      { src: 'docs',                    label: 'Documentation (12 guides)',         group: 'docs' },
-  claude_md: { src: 'CLAUDE.md',               label: 'Master instructions',              group: 'core', isFile: true },
-  harvest:   { src: 'TOOLKIT_HARVEST.md',      label: 'Knowledge harvest tracker',        group: 'core', isFile: true },
+/**
+ * Count the units a component contributes, by inspecting the real templates/ tree.
+ *
+ * `countMode` decides what a "unit" is:
+ *   'dirs'  — immediate subdirectories (one skill pack = one directory)
+ *   'files' — every file, recursively (lib/, docs/ ship nested files)
+ *   'md'    — immediate *.md files (one command / rule / shard / agent = one file)
+ *
+ * Returns null when the count cannot be determined (missing dir, unreadable),
+ * so callers can degrade to a bare label instead of printing a wrong number.
+ */
+function countTemplateUnits(comp) {
+  if (comp.isFile) return null;
+
+  const srcPath = path.join(getTemplatesDir(), comp.src);
+
+  try {
+    if (!fs.statSync(srcPath).isDirectory()) return null;
+  } catch {
+    return null;
+  }
+
+  try {
+    if (comp.countMode === 'files') {
+      return getRelativePaths(srcPath).length;
+    }
+
+    const entries = fs.readdirSync(srcPath, { withFileTypes: true });
+
+    if (comp.countMode === 'dirs') {
+      return entries.filter((e) => e.isDirectory()).length;
+    }
+
+    // default: 'md'
+    return entries.filter((e) => e.isFile() && e.name.endsWith('.md')).length;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Component definitions.
+ *
+ * IMPORTANT: `label` is a COMPUTED getter — the parenthetical count is read from the
+ * shipped templates/ tree at access time, never hardcoded. Adding a command / rule /
+ * skill to templates/ changes what `init`, `init --dry-run` and `list` print, with no
+ * source edit. (Regression this guards: the labels used to be frozen strings reading
+ * "8 skill packs / 13 slash commands / 10 rules / 7 shards / 4 modules" long after the
+ * tree had grown past all five numbers.)
+ */
+const COMPONENT_SPECS = {
+  skills:    { src: '.claude/skills',        name: 'Skills',           unit: 'skill packs',    countMode: 'dirs',  group: 'core' },
+  commands:  { src: '.claude/commands',      name: 'Commands',         unit: 'slash commands', countMode: 'md',    group: 'core' },
+  rules:     { src: '.claude/rules',         name: 'Rules',            unit: 'auto-loaded rules', countMode: 'md', group: 'core' },
+  shards:    { src: '.claude/shards',        name: 'Shards',           unit: 'context shards', countMode: 'md',    group: 'core' },
+  agents:    { src: '.claude/agents',        name: 'Agent templates',  unit: 'swarm configs',  countMode: 'md',    group: 'core' },
+  hooks:     { src: '.claude/settings.json', name: 'Hooks configuration', group: 'core', isFile: true },
+  lib:       { src: 'lib',                   name: 'Library modules',  unit: 'modules',        countMode: 'files', group: 'extended' },
+  docs:      { src: 'docs',                  name: 'Documentation',    unit: 'guides',         countMode: 'files', group: 'docs' },
+  claude_md: { src: 'CLAUDE.md',             name: 'Master instructions', group: 'core', isFile: true },
+  harvest:   { src: 'TOOLKIT_HARVEST.md',    name: 'Knowledge harvest tracker', group: 'core', isFile: true },
 };
 
+/**
+ * The shipped `*.md` filenames for a directory component, read from templates/.
+ *
+ * This is the single source of truth for "what SHOULD be installed" — `doctor` derives its
+ * named checks from it, so a new command/rule/shard is named-checked the moment it lands in
+ * templates/, with no second list to keep in sync. Returns [] when templates/ is unreadable.
+ */
+function getTemplateFileNames(componentKey) {
+  const comp = COMPONENT_SPECS[componentKey];
+  if (!comp || comp.isFile) return [];
+
+  try {
+    return fs
+      .readdirSync(path.join(getTemplatesDir(), comp.src), { withFileTypes: true })
+      .filter((e) => e.isFile() && e.name.endsWith('.md'))
+      .map((e) => e.name)
+      .sort();
+  } catch {
+    return [];
+  }
+}
+
+const COMPONENTS = {};
+for (const [key, spec] of Object.entries(COMPONENT_SPECS)) {
+  const comp = Object.assign({}, spec);
+  Object.defineProperty(comp, 'label', {
+    enumerable: true,
+    get() {
+      const n = countTemplateUnits(this);
+      if (n === null || !this.unit) return this.name;
+      return `${this.name} (${n} ${this.unit})`;
+    },
+  });
+  COMPONENTS[key] = comp;
+}
+
 // ===========================================================================
 // Exports
 // ===========================================================================
@@ -306,4 +392,6 @@ module.exports = {
 
   // Components
   COMPONENTS,
+  countTemplateUnits,
+  getTemplateFileNames,
 };

package/templates/.claude/skills/edu-site-generator/SKILL.md

@@ -10,7 +10,7 @@ trust_tier: 1
 
 # edu-site-generator — Gamified Educational Site Generator
 
-<!-- Trust Tier: 1 — Structured | Path to Tier 2: run a BTO evaluation (separate package: npx @dzhechkov/skills-bto) -->
+<!-- Trust Tier: 1 — Structured | Path to Tier 2: run a BTO evaluation (see the skills-bto package) -->
 
 > Generate a complete gamified educational SPA from documentation/content, optimized for GitHub Pages deployment.
 
@@ -21,7 +21,7 @@ Trigger on:
 - "create learning site [topic]"
 - "build educational app [topic]"
 - "gamified site from documentation"
-- `/edu-site [topic or docs path]`
+- `/edu-site-generator [topic or docs path]`
 
 ## Overview
 

package/templates/.claude/skills/explore/SKILL.md

@@ -10,7 +10,7 @@ description: >
   provide solutions until task is fully explored.
 trust_tier: 1
 trust_tier_label: "Structured"
-trust_tier_path: "Run a BTO evaluation from the separate package @dzhechkov/skills-bto to promote to Tier 2"
+trust_tier_path: "Run a BTO evaluation (see the skills-bto package) to promote to Tier 2"
 ---
 
 # Explore: Adaptive Task Clarification

package/templates/.claude/skills/feature-adr/SKILL.md

@@ -11,7 +11,7 @@ description: >
   "implement feature", "/feature-adr".
 trust_tier: 0
 trust_tier_label: "Advisory"
-trust_tier_path: "Run a BTO evaluation from the separate package @dzhechkov/skills-bto to promote to Tier 1"
+trust_tier_path: "Run a BTO evaluation (see the skills-bto package) to promote to Tier 1"
 agentic_qe_version: "7.5.1"
 agentic_qe_source: "https://github.com/proffesor-for-testing/agentic-qe"
 agentic_qe_skills_core: 9

package/templates/.claude/skills/frontend-design/SKILL.md

@@ -4,7 +4,7 @@ description: Create distinctive, production-grade frontend interfaces with high
 license: Complete terms in LICENSE.txt
 trust_tier: 0
 trust_tier_label: "Advisory"
-trust_tier_path: "Add references/ directory and run a BTO evaluation from the separate package @dzhechkov/skills-bto to promote to Tier 1"
+trust_tier_path: "Add references/ directory and run a BTO evaluation (see the skills-bto package) to promote to Tier 1"
 ---
 
 This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.