@techninja/clearstack 0.3.14 → 0.3.15

package/lib/check.js

@@ -42,11 +42,9 @@ export function loadConfig(projectDir) {
   };
 }
 
-/**
- * Build check commands for the detected package manager.
- * @param {string} runner
- */
-function buildCmds(runner) {
+/** Build check commands for the detected package manager. */
+export function buildCmds(projectDir) {
+  const runner = detectRunner(projectDir);
   const audit = runner === 'pnpm exec' ? 'pnpm audit --prod' : 'npm audit --omit=dev';
   return {
     lint: `${runner} eslint --config .configs/eslint.config.js . --fix`,
@@ -58,8 +56,6 @@ function buildCmds(runner) {
   };
 }
 
-/** @deprecated Use buildCmds() instead — kept for backward compat. */
-export const CMDS = buildCmds('npx');
 
 /** @typedef {{ key: string, name: string, parent?: string, run: () => boolean }} Check */
 
@@ -108,10 +104,10 @@ export function parentKeys(checks) {
   return [...new Set(checks.filter((c) => c.parent).map((c) => c.parent))];
 }
 
-/** Run the full spec compliance check (used by clearstack CLI). */
+/** Run the full spec compliance check (used by clearstack CLI and scripts/spec.js). */
 export async function check(projectDir, scope) {
   const cfg = loadConfig(projectDir);
-  const cmds = buildCmds(detectRunner(projectDir));
+  const cmds = buildCmds(projectDir);
   const checks = buildChecks(projectDir, cfg, cmds);
 
   if (scope && scope !== 'all') {
@@ -127,7 +123,7 @@ export async function check(projectDir, scope) {
     return;
   }
 
-  console.log('Running spec compliance check...\n');
+  console.log('🔍 Clearstack compliance checking now... 💙\n');
   const results = checks.map((c) => c.run());
   const passed = results.filter(Boolean).length;
   console.log(`\n${'='.repeat(40)}`);

package/lib/package-gen.js

@@ -21,7 +21,7 @@ export async function writePackageJson(dest, vars, existing) {
     dev: 'node --watch --env-file=.env --env-file=.env.local src/server.js',
     postinstall: 'node scripts/setup.js',
     test: 'node scripts/test.js',
-    spec: 'clearstack',
+    spec: 'node scripts/spec.js',
   };
 
   const specDeps = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techninja/clearstack",
-  "version": "0.3.14",
+  "version": "0.3.15",
   "type": "module",
   "description": "A no-build web component framework specification — scaffold, validate, and evolve spec-compliant projects",
   "bin": {

package/templates/shared/.github/workflows/spec.yml

@@ -24,20 +24,8 @@ jobs:
       - name: Install Playwright Chromium
         run: npx playwright install chromium --with-deps
 
-      - name: Code line counts (≤150)
-        run: node scripts/spec.js code
-
-      - name: Doc line counts (≤500)
-        run: node scripts/spec.js docs
-
-      - name: ESLint
-        run: npx eslint --config .configs/eslint.config.js .
-
-      - name: Prettier
-        run: npx prettier --config .configs/.prettierrc --check src scripts server.js tests
-
-      - name: JSDoc types (tsc --checkJs)
-        run: npx tsc --project .configs/jsconfig.json
+      - name: Spec compliance
+        run: node scripts/spec.js all
 
       - name: Node tests
         run: node --test tests/*.test.js src/utils/*.test.js src/store/*.test.js

package/templates/shared/scripts/spec.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+/**
+ * Spec enforcement — interactive menu + CLI shortcuts.
+ * Delegates all check logic to @techninja/clearstack.
+ * @module scripts/spec
+ */
+
+import {
+  loadConfig,
+  buildChecks,
+  buildCmds,
+  resolveChecks,
+  parentKeys,
+  check,
+} from '@techninja/clearstack/lib/check.js';
+
+const ROOT = new URL('..', import.meta.url).pathname.replace(/\/$/, '');
+const [sub, subsub] = process.argv.slice(2);
+const scope = subsub ? `${sub} ${subsub}` : sub;
+
+if (scope) {
+  await check(ROOT, scope);
+} else {
+  await interactive(ROOT);
+}
+
+/** Show interactive menu, then run the selected check. */
+async function interactive(dir) {
+  const cfg = loadConfig(dir);
+  const checks = buildChecks(dir, cfg, buildCmds(dir));
+  try {
+    const { select } = await import('@inquirer/prompts');
+    const action = await select({
+      message: 'Spec checker — what do you want to validate?',
+      choices: menuChoices(checks),
+    });
+    await check(dir, action);
+  } catch (e) {
+    if (e?.name === 'ExitPromptError') process.exit(0);
+    throw e;
+  }
+}
+
+/** Build interactive menu choices with hierarchy. */
+function menuChoices(checks) {
+  const choices = [];
+  const seen = new Set();
+  for (const c of checks) {
+    if (c.parent && !seen.has(c.parent)) {
+      seen.add(c.parent);
+      const kids = checks.filter((k) => k.parent === c.parent);
+      const label = kids.map((k) => k.name).join(' + ');
+      choices.push({ name: `${label} [${c.parent}]`, value: c.parent });
+      for (const k of kids)
+        choices.push({ name: `  ${k.name} [${c.parent} ${k.key}]`, value: `${c.parent} ${k.key}` });
+    } else if (!c.parent) {
+      choices.push({ name: `${c.name} [${c.key}]`, value: c.key });
+    }
+  }
+  choices.push({ name: 'All (full spec check)', value: 'all' });
+  return choices;
+}