@cuewright/skills 0.3.0 → 0.4.0

package/README.md

@@ -27,8 +27,8 @@ npx @cuewright/skills init [options]
 **What it does:**
 1. Clones the framework as a git submodule at `.claude/skills/_framework/`
 2. Creates skill symlinks at `.claude/skills/<name>/` for each skill in the manifest
-3. Scaffolds `cw-project/project-config.md` from the framework template
-4. Creates `cw-project/fragments/project/`
+3. Scaffolds `_cuewright/project-config.md` from the framework template
+4. Creates `_cuewright/fragments/project/`
 
 **Flags:**
 
@@ -81,7 +81,7 @@ npx @cuewright/skills doctor
 ```
 ✓ Framework installed at v0.14.33
 ✓ 25/25 skills wired
-✓ cw-project/project-config.md found
+✓ _cuewright/project-config.md found
 ✓ Target lit-browser found
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuewright/skills",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI installer for the Cuewright skills framework",
   "type": "module",
   "engines": {

package/src/commands/doctor.js

@@ -110,22 +110,22 @@ export async function doctor() {
     }
   }
 
-  // 5. cw-project/project-config.md exists
-  const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
+  // 5. _cuewright/project-config.md exists
+  const configPath = join(projectRoot, '.claude', 'skills', '_cuewright', 'project-config.md');
   if (!await exists(configPath)) {
     allPassed = false;
     checks.push(fail(
-      'cw-project/project-config.md not found',
+      '_cuewright/project-config.md not found',
       'Run `cuewright init` to scaffold it, or create it manually from _framework/targets/_template/project-config-template.md.'
     ));
   } else {
-    checks.push(pass('cw-project/project-config.md found'));
+    checks.push(pass('_cuewright/project-config.md found'));
 
     // 6. Target named in project-config exists
     const targetName = await extractTargetName(configPath);
     if (targetName) {
       const targetDir = join(frameworkDir, 'targets', targetName);
-      const projectTargetDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'targets', targetName);
+      const projectTargetDir = join(projectRoot, '.claude', 'skills', '_cuewright', 'targets', targetName);
 
       if (await exists(targetDir) || await exists(projectTargetDir)) {
         checks.push(pass(`Target ${targetName} found`));
@@ -134,20 +134,20 @@ export async function doctor() {
         const availableTargets = await listAvailableTargets(frameworkDir);
         checks.push(fail(
           `Target '${targetName}' not found`,
-          `Update cw-project/project-config.md with a valid target. Available: ${availableTargets.join(', ')}`
+          `Update _cuewright/project-config.md with a valid target. Available: ${availableTargets.join(', ')}`
         ));
       }
     } else {
-      checks.push(warn('Could not read target name from cw-project/project-config.md'));
+      checks.push(warn('Could not read target name from _cuewright/project-config.md'));
     }
   }
 
-  // 6b. cw-project/references/ exists
-  const referencesDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'references');
+  // 6b. _cuewright/references/ exists
+  const referencesDir = join(projectRoot, '.claude', 'skills', '_cuewright', 'references');
   if (!await exists(referencesDir)) {
-    checks.push(warn('cw-project/references/ not found — skill reference files have no home. Run `cuewright update` to scaffold it.'));
+    checks.push(warn('_cuewright/references/ not found — skill reference files have no home. Run `cuewright update` to scaffold it.'));
   } else {
-    checks.push(pass('cw-project/references/ found'));
+    checks.push(pass('_cuewright/references/ found'));
   }
 
   // 7. Baseline compatibility check (if baseline present)

package/src/commands/init.js

@@ -102,16 +102,16 @@ async function freshInstall(projectRoot, frameworkDir, skillsDir, options) {
   console.log(chalk.green(`\nDone.`));
   console.log(`  Framework:  v${version}`);
   console.log(`  Skills wired: ${wired.length}`);
-  console.log(`  Config:     .claude/skills/cw-project/project-config.md`);
+  console.log(`  Config:     .claude/skills/_cuewright/project-config.md`);
   console.log('');
   console.log('Next: edit project-config.md to set your target, then run /align-project-skills');
 }
 
 /**
- * Scaffold cw-project/project-config.md from the framework template if it does not yet exist.
+ * Scaffold _cuewright/project-config.md from the framework template if it does not yet exist.
  */
 async function scaffoldConfigIfMissing(projectRoot, frameworkDir) {
-  const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
+  const configPath = join(projectRoot, '.claude', 'skills', '_cuewright', 'project-config.md');
   const configExists = await exists(configPath);
 
   if (configExists) {
@@ -120,21 +120,20 @@ async function scaffoldConfigIfMissing(projectRoot, frameworkDir) {
   }
 
   const templatePath = join(frameworkDir, 'targets', '_template', 'project-config-template.md');
-  const fragmentsDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'fragments', 'project');
+  const fragmentsDir = join(projectRoot, '.claude', 'skills', '_cuewright', 'fragments', 'project');
 
-  await mkdir(join(projectRoot, '.claude', 'skills', 'cw-project'), { recursive: true });
+  await mkdir(join(projectRoot, '.claude', 'skills', '_cuewright'), { recursive: true });
   await mkdir(fragmentsDir, { recursive: true });
   await copyFile(templatePath, configPath);
 
-  console.log('  Scaffolded cw-project/project-config.md');
+  console.log('  Scaffolded _cuewright/project-config.md');
 }
 
 /**
- * Scaffold cw-project/references/ and cw-project/templates/ subdirectories if they don't exist.
- * These are the project customization roots under the cw- prefix model.
+ * Scaffold _cuewright/references/ and _cuewright/templates/ subdirectories if they don't exist.
  */
 async function scaffoldProjectDirectories(projectRoot) {
-  const projectDir = join(projectRoot, '.claude', 'skills', 'cw-project');
+  const projectDir = join(projectRoot, '.claude', 'skills', '_cuewright');
   await mkdir(join(projectDir, 'references'), { recursive: true });
   await mkdir(join(projectDir, 'templates', 'page'), { recursive: true });
   await mkdir(join(projectDir, 'templates', 'component'), { recursive: true });

package/src/commands/status.js

@@ -46,7 +46,7 @@ export async function status(options = {}) {
   }
 
   // Read project-config for target and governance
-  const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
+  const configPath = join(projectRoot, '.claude', 'skills', '_cuewright', 'project-config.md');
   const configExists = await exists(configPath);
   let targetName = null;
   let governanceRows = [];

package/src/commands/update.js

@@ -17,6 +17,7 @@ export async function update(options) {
   const dryRun = options.dryRun || false;
 
   await migrateArchToCwProject(skillsDir, { dryRun });
+  await migrateCwProjectToCuewright(skillsDir, { dryRun });
 
   // Framework must already be installed
   const manifestPath = join(frameworkDir, 'manifest.json');
@@ -105,9 +106,9 @@ export async function update(options) {
   // Always run legacy cleanup — catches dirs that survived the diff-based migration
   await runCleanup(skillsDir, [...newSkills], projectRoot, dryRun);
 
-  // Scaffold cw-project/references/ and cw-project/templates/ if missing
+  // Scaffold _cuewright/references/ and _cuewright/templates/ if missing
   if (!dryRun) {
-    const projectDir = join(projectRoot, '.claude', 'skills', 'cw-project');
+    const projectDir = join(projectRoot, '.claude', 'skills', '_cuewright');
     await mkdir(join(projectDir, 'references'), { recursive: true });
     await mkdir(join(projectDir, 'templates', 'page'), { recursive: true });
     await mkdir(join(projectDir, 'templates', 'component'), { recursive: true });
@@ -127,7 +128,7 @@ export async function update(options) {
 
   // Update version in project-config.md
   if (!dryRun) {
-    const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
+    const configPath = join(projectRoot, '.claude', 'skills', '_cuewright', 'project-config.md');
     await updateProjectConfigVersion(configPath, targetVersion);
   }
 
@@ -243,3 +244,17 @@ export async function migrateArchToCwProject(skillsDir, { dryRun = false } = {})
   }
   return false;
 }
+
+export async function migrateCwProjectToCuewright(skillsDir, { dryRun = false } = {}) {
+  const oldDir = join(skillsDir, 'cw-project');
+  const newDir = join(skillsDir, '_cuewright');
+  if (await exists(oldDir) && !await exists(newDir)) {
+    if (!dryRun) {
+      await rename(oldDir, newDir);
+    }
+    const verb = dryRun ? 'Would migrate' : 'Migrated';
+    console.log(`  ${verb} .claude/skills/cw-project/ \u2192 .claude/skills/_cuewright/`);
+    return true;
+  }
+  return false;
+}

package/src/utils/project-config.js

@@ -1,7 +1,7 @@
 import { readFile, writeFile, access } from 'fs/promises';
 
 /**
- * Update the Framework Version line in cw-project/project-config.md.
+ * Update the Framework Version line in _cuewright/project-config.md.
  * Looks for a markdown table row like: | Framework Version | v0.8.0 |
  * Updates the version value in place. No-ops if the file doesn't exist
  * or doesn't contain a recognizable version line.

package/src/utils/symlink.js

@@ -190,7 +190,7 @@ export async function cleanupLegacyDirectories(skillsDir, manifestSkillNames, pr
     const referenceFiles = entries.filter(e => e !== 'SKILL.md');
 
     if (referenceFiles.length > 0 && !dryRun) {
-      const refDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'references', cwName);
+      const refDir = join(projectRoot, '.claude', 'skills', '_cuewright', 'references', cwName);
       try {
         await mkdir(refDir, { recursive: true });
         for (const file of referenceFiles) {
@@ -223,7 +223,7 @@ export async function cleanupLegacyDirectories(skillsDir, manifestSkillNames, pr
   // Second pass: remove broken symlinks pointing into _framework/ with no manifest match.
   // These are retired framework skills whose target directory no longer exists.
   const { join: pathJoin } = await import('path');
-  const RESERVED = new Set(['_framework', '_baseline', 'arch', 'cw-project', 'worktrees']);
+  const RESERVED = new Set(['_framework', '_baseline', '_cuewright', 'arch', 'cw-project', 'worktrees']);
   const cwNameSet = new Set(manifestSkillNames);
   const unprefixedSet = new Set(
     manifestSkillNames.filter(n => n.startsWith('cw-')).map(n => n.slice(3))
@@ -297,7 +297,7 @@ export async function inventorySkillsDir(skillsDir, manifestSkillNames) {
   const deadFramework = [];
   const orphaned = [];
 
-  const RESERVED = new Set(['_framework', '_baseline', 'arch', 'cw-project', 'worktrees']);
+  const RESERVED = new Set(['_framework', '_baseline', '_cuewright', 'arch', 'cw-project', 'worktrees']);
   const unprefixedNames = new Set(
     manifestSkillNames.filter(n => n.startsWith('cw-')).map(n => n.slice(3))
   );