@polymorphism-tech/morph-spec 4.7.2 → 4.8.4

package/scripts/generate-refs.js

@@ -1,336 +0,0 @@
-#!/usr/bin/env node
-/**
- * scripts/generate-refs.js
- *
- * Generates derived files from the single source of truth:
- *   src/core/paths/output-schema.js
- *
- * Outputs:
- *   framework/hooks/shared/phase-utils.js  — constants derived from OUTPUT_SCHEMA
- *   framework/skills/level-1-workflows/*.md — morph:outputs blocks
- *
- * Usage:
- *   node scripts/generate-refs.js          # generate files
- *   node scripts/generate-refs.js --check  # validate only (CI, exit 1 if drift)
- */
-
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { OUTPUT_SCHEMA } from '../src/core/paths/output-schema.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(__dirname, '..');
-const CHECK_MODE = process.argv.includes('--check');
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-/**
- * Phase entries that cannot be derived from OUTPUT_SCHEMA because they share
- * directories with other phases (no dedicated output type of their own).
- */
-const PHASE_DIRS_EXTRAS = {
-  setup:  '0-proposal',  // setup outputs (proposal.md) go in 0-proposal dir
-  sync:   '4-implement', // sync updates standards, works in implement space
-};
-
-/** Canonical phase ordering for PHASE_ORDER constant. */
-const PHASE_ORDER = ['proposal', 'setup', 'uiux', 'design', 'clarify', 'tasks', 'implement', 'sync'];
-
-/**
- * Skill files that contain <!-- morph:outputs:PHASE --> blocks.
- * Keyed by the phase name to inject, value is the file path relative to ROOT.
- */
-const SKILL_FILES = [
-  { file: 'framework/skills/level-1-workflows/phase-setup.md',     phase: 'proposal'  },
-  { file: 'framework/skills/level-1-workflows/phase-uiux.md',      phase: 'uiux'      },
-  { file: 'framework/skills/level-1-workflows/phase-design.md',    phase: 'design'    },
-  { file: 'framework/skills/level-1-workflows/phase-tasks.md',     phase: 'tasks'     },
-  { file: 'framework/skills/level-1-workflows/phase-implement.md', phase: 'implement' },
-];
-
-// ============================================================================
-// Derivation helpers
-// ============================================================================
-
-function derivePhaseDirs() {
-  const dirs = {};
-  for (const entry of Object.values(OUTPUT_SCHEMA)) {
-    dirs[entry.phase] = entry.phaseDir;
-  }
-  // Add extras in their canonical order (will be merged after schema-derived entries)
-  for (const [phase, dir] of Object.entries(PHASE_DIRS_EXTRAS)) {
-    dirs[phase] = dir;
-  }
-  // Re-order to match PHASE_ORDER
-  const ordered = {};
-  for (const phase of PHASE_ORDER) {
-    if (dirs[phase]) ordered[phase] = dirs[phase];
-  }
-  return ordered;
-}
-
-function deriveOutputPhaseMap() {
-  return Object.fromEntries(
-    Object.entries(OUTPUT_SCHEMA).map(([key, entry]) => [key, entry.phase])
-  );
-}
-
-function deriveFilenameToOutput() {
-  return Object.fromEntries(
-    Object.entries(OUTPUT_SCHEMA).map(([key, entry]) => [entry.filename, key])
-  );
-}
-
-function deriveProtectedSpecFiles() {
-  return Object.fromEntries(
-    Object.entries(OUTPUT_SCHEMA)
-      .filter(([, entry]) => entry.protected && entry.approvalGate)
-      .map(([, entry]) => [entry.filename, entry.approvalGate])
-  );
-}
-
-// ============================================================================
-// phase-utils.js generator
-// ============================================================================
-
-/**
- * Static utility functions that live in phase-utils.js.
- * Not derived from OUTPUT_SCHEMA — they operate on file paths generically.
- */
-const UTIL_FUNCTIONS = `
-/**
- * Extract feature name from a .morph/features/{feature}/... path
- * @param {string} filePath - File path to analyze
- * @returns {string|null} Feature name or null
- */
-export function extractFeatureName(filePath) {
-  const normalized = filePath.replace(/\\\\/g, '/');
-  const match = normalized.match(/\\.morph\\/features\\/([^/]+)\\//);
-  return match ? match[1] : null;
-}
-
-/**
- * Extract phase subdirectory from a .morph/features/{feature}/{phaseDir}/... path
- * @param {string} filePath - File path to analyze
- * @returns {string|null} Phase directory (e.g., '0-proposal', '1-design') or null
- */
-export function extractPhaseDir(filePath) {
-  const normalized = filePath.replace(/\\\\/g, '/');
-  const match = normalized.match(/\\.morph\\/features\\/[^/]+\\/(\\d+-[^/]+)\\//);
-  return match ? match[1] : null;
-}
-
-/**
- * Check if a file path is inside .morph/features/
- * @param {string} filePath
- * @returns {boolean}
- */
-export function isFeaturePath(filePath) {
-  const normalized = filePath.replace(/\\\\/g, '/');
-  return normalized.includes('.morph/features/');
-}
-
-/**
- * Check if a file path is inside .morph/framework/ (readonly)
- * @param {string} filePath
- * @returns {boolean}
- */
-export function isFrameworkPath(filePath) {
-  const normalized = filePath.replace(/\\\\/g, '/');
-  return normalized.includes('.morph/framework/');
-}
-
-/**
- * Check if a file path is state.json
- * @param {string} filePath
- * @returns {boolean}
- */
-export function isStatePath(filePath) {
-  const normalized = filePath.replace(/\\\\/g, '/');
-  return normalized.endsWith('.morph/state.json');
-}
-
-/**
- * Get the basename of a file path
- * @param {string} filePath
- * @returns {string}
- */
-export function getBasename(filePath) {
-  const normalized = filePath.replace(/\\\\/g, '/');
-  return normalized.split('/').pop();
-}
-`;
-
-function formatJsObject(obj) {
-  const needsQuotes = (key) => /[^a-zA-Z0-9_$]/.test(key);
-  const entries = Object.entries(obj).map(([k, v]) => {
-    const fmtKey = needsQuotes(k) ? `'${k}'` : k;
-    return `  ${fmtKey}: '${v}',`;
-  });
-  return `{\n${entries.join('\n')}\n}`;
-}
-
-function generatePhaseUtilsContent() {
-  const phaseDirs      = derivePhaseDirs();
-  const outputPhaseMap = deriveOutputPhaseMap();
-  const filenameToOut  = deriveFilenameToOutput();
-  const protectedFiles = deriveProtectedSpecFiles();
-
-  return `// GENERATED by scripts/generate-refs.js — DO NOT EDIT manually
-// Source of truth: src/core/paths/output-schema.js
-// Regenerate with: node scripts/generate-refs.js
-/**
- * Shared phase utilities for Claude Code hooks.
- *
- * Maps phases to directories and output types.
- */
-
-/** Phase order */
-export const PHASE_ORDER = ${JSON.stringify(PHASE_ORDER)};
-
-/** Map phase → allowed output subdirectory */
-export const PHASE_DIRS = ${formatJsObject(phaseDirs)};
-
-/** Map output type (camelCase) → phase that produces it */
-export const OUTPUT_PHASE_MAP = ${formatJsObject(outputPhaseMap)};
-
-/** Map filename → output type (camelCase) */
-export const FILENAME_TO_OUTPUT = ${formatJsObject(filenameToOut)};
-
-/** Protected spec files and the approval gate that locks them */
-export const PROTECTED_SPEC_FILES = ${formatJsObject(protectedFiles)};
-${UTIL_FUNCTIONS}`;
-}
-
-// ============================================================================
-// Markdown block generator
-// ============================================================================
-
-function generateOutputTable(phaseName) {
-  const entries = Object.entries(OUTPUT_SCHEMA)
-    .filter(([, entry]) => entry.phase === phaseName);
-
-  if (entries.length === 0) return null;
-
-  const rows = entries
-    .map(([key, entry]) =>
-      `| \`${key}\` | \`.morph/features/{feature}/${entry.phaseDir}/${entry.filename}\` |`
-    )
-    .join('\n');
-
-  return `| Output | Caminho |\n|--------|---------|
-${rows}`;
-}
-
-function replaceMarkdownBlocks(content, phaseName) {
-  const table = generateOutputTable(phaseName);
-  if (!table) return { changed: false, content };
-
-  const updated = content.replace(
-    /<!-- morph:outputs:(\w+) -->([\s\S]*?)<!-- \/morph:outputs -->/g,
-    (_match, blockPhase, _inner) => {
-      const blockTable = generateOutputTable(blockPhase);
-      if (!blockTable) return _match;
-      return `<!-- morph:outputs:${blockPhase} -->\n${blockTable}\n<!-- /morph:outputs -->`;
-    }
-  );
-
-  return { changed: updated !== content, content: updated };
-}
-
-// ============================================================================
-// Write / check helpers
-// ============================================================================
-
-let driftFound = false;
-
-function writeOrCheck(filePath, generated, label) {
-  const current = existsSync(filePath) ? readFileSync(filePath, 'utf8') : null;
-
-  if (current === generated) {
-    console.log(`  ✓ ${label} — up to date`);
-    return;
-  }
-
-  if (CHECK_MODE) {
-    console.error(`  ✗ ${label} — DRIFT DETECTED (run: node scripts/generate-refs.js)`);
-    if (current === null) {
-      console.error(`    File does not exist: ${filePath}`);
-    } else {
-      // Show first difference line
-      const curLines = current.split('\n');
-      const genLines = generated.split('\n');
-      for (let i = 0; i < Math.max(curLines.length, genLines.length); i++) {
-        if (curLines[i] !== genLines[i]) {
-          console.error(`    First diff at line ${i + 1}:`);
-          console.error(`      current:   ${JSON.stringify(curLines[i] ?? '(missing)')}`);
-          console.error(`      generated: ${JSON.stringify(genLines[i] ?? '(missing)')}`);
-          break;
-        }
-      }
-    }
-    driftFound = true;
-  } else {
-    writeFileSync(filePath, generated, 'utf8');
-    console.log(`  ✎ ${label} — updated`);
-  }
-}
-
-// ============================================================================
-// Main
-// ============================================================================
-
-console.log(CHECK_MODE ? '\nChecking generated refs...' : '\nGenerating refs from output-schema.js...');
-console.log('');
-
-// 1. Generate / check phase-utils.js
-const phaseUtilsPath = join(ROOT, 'framework/hooks/shared/phase-utils.js');
-const phaseUtilsContent = generatePhaseUtilsContent();
-writeOrCheck(phaseUtilsPath, phaseUtilsContent, 'framework/hooks/shared/phase-utils.js');
-
-// 2. Update / check morph:outputs blocks in skill markdown files
-console.log('');
-for (const { file, phase } of SKILL_FILES) {
-  const filePath = join(ROOT, file);
-  if (!existsSync(filePath)) {
-    console.log(`  - ${file} — not found, skipping`);
-    continue;
-  }
-
-  const content = readFileSync(filePath, 'utf8');
-  const hasMarker = content.includes(`<!-- morph:outputs:${phase} -->`);
-
-  if (!hasMarker) {
-    console.log(`  - ${file} — no morph:outputs:${phase} marker, skipping`);
-    continue;
-  }
-
-  const { changed, content: updated } = replaceMarkdownBlocks(content, phase);
-
-  if (!changed) {
-    console.log(`  ✓ ${file} — up to date`);
-  } else if (CHECK_MODE) {
-    console.error(`  ✗ ${file} — morph:outputs block DRIFT DETECTED`);
-    driftFound = true;
-  } else {
-    writeFileSync(filePath, updated, 'utf8');
-    console.log(`  ✎ ${file} — morph:outputs block updated`);
-  }
-}
-
-console.log('');
-
-if (CHECK_MODE) {
-  if (driftFound) {
-    console.error('FAIL: Generated files are out of sync with output-schema.js');
-    console.error('      Run: node scripts/generate-refs.js');
-    process.exit(1);
-  } else {
-    console.log('OK: All generated refs are in sync with output-schema.js');
-  }
-} else {
-  console.log('Done. Commit any changed files.');
-}

package/scripts/generate-standards-registry.js

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-/**
- * One-time script to generate framework/standards/STANDARDS.json
- * by scanning all .md files in framework/standards/.
- *
- * Usage: node scripts/generate-standards-registry.js
- */
-
-import { readdirSync, statSync, writeFileSync } from 'fs';
-import { join, relative } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = fileURLToPath(new URL('.', import.meta.url));
-const BASE = join(__dirname, '..', 'framework', 'standards');
-
-function scanDir(dir) {
-  const entries = [];
-  for (const f of readdirSync(dir)) {
-    const full = join(dir, f);
-    const rel = relative(BASE, full).replace(/\\/g, '/');
-    if (statSync(full).isDirectory()) {
-      entries.push(...scanDir(full));
-    } else if (f.endsWith('.md') && f !== 'README.md') {
-      const parts = rel.split('/');
-      entries.push({
-        id: rel.replace(/\//g, '-').replace('.md', ''),
-        name: f.replace('.md', '').replace(/-/g, ' '),
-        path: rel,
-        category: parts[0],
-        subcategory: parts.length > 2 ? parts[1] : null,
-        tags: parts.slice(0, -1),
-      });
-    }
-  }
-  return entries;
-}
-
-const standards = scanDir(BASE);
-const registry = { version: '1.0.0', standards };
-const outPath = join(BASE, 'STANDARDS.json');
-writeFileSync(outPath, JSON.stringify(registry, null, 2) + '\n');
-console.log(`Generated ${standards.length} standards entries`);
-console.log(`Categories: ${[...new Set(standards.map(s => s.category))].join(', ')}`);
-console.log(`Written to: ${outPath}`);

package/scripts/scan-nextjs.mjs

@@ -1,169 +0,0 @@
-#!/usr/bin/env node
-/**
- * scan-nextjs.mjs - CLI scan for Next.js violations.
- * Usage: node scripts/scan-nextjs.mjs [path] [--json]
- * Exit: 0=clean, 1=errors, 2=scan failed
- */
-
-import { readFileSync, existsSync, readdirSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { validateNextComponent } from '../src/lib/validators/nextjs/next-component-validator.js';
-
-const args = process.argv.slice(2);
-const jsonMode = args.includes('--json');
-const pathArg = args.find(a => !a.startsWith('--'));
-const targetPath = pathArg ? resolve(pathArg) : resolve('src');
-
-function checkUseEffectFetch(content, filePath) {
-  const issues = [];
-  if (/useEffect\s*\(\s*(?:async\s+)?\(\s*\)\s*=>/.test(content) && /\bfetch\s*\(/.test(content)) {
-    issues.push({
-      type: 'error',
-      message: "useEffect used for data fetching — use Server Components or TanStack Query (useQuery) instead",
-      suggestion: "Replace with a Server Component fetch or TanStack Query useQuery hook",
-      file: filePath,
-    });
-  }
-  return issues;
-}
-
-function checkDefaultExport(content, filePath) {
-  const issues = [];
-  const fileName = filePath.split('/').pop() ?? '';
-  const SPECIAL = ['page.tsx', 'layout.tsx', 'loading.tsx', 'error.tsx', 'not-found.tsx'];
-  if (!SPECIAL.includes(fileName) && /^export\s+default\s+/m.test(content) && fileName.endsWith('.tsx')) {
-    issues.push({
-      type: 'warning',
-      message: `Default export in '${fileName}' — prefer named exports for easier refactoring`,
-      suggestion: "Change to: export function ComponentName() {}",
-      file: filePath,
-    });
-  }
-  return issues;
-}
-
-function findTsxFiles(dir) {
-  const results = [];
-  let entries;
-  try {
-    entries = readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return results;
-  }
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (['node_modules', '.next', 'dist', '.git'].includes(entry.name)) continue;
-    if (entry.isDirectory()) {
-      results.push(...findTsxFiles(fullPath));
-    } else if (entry.name.endsWith('.tsx') || entry.name.endsWith('.ts')) {
-      results.push(fullPath);
-    }
-  }
-  return results;
-}
-function main() {
-  if (!existsSync(targetPath)) {
-    const msg = `Error: Path does not exist: ${targetPath}`;
-    if (jsonMode) {
-      console.log(JSON.stringify({ error: msg, exitCode: 2 }));
-    } else {
-      process.stderr.write(msg + '\n');
-    }
-    process.exit(2);
-  }
-
-  let files;
-  try {
-    files = findTsxFiles(targetPath);
-  } catch (err) {
-    const msg = `Error scanning directory: ${err.message}`;
-    if (jsonMode) {
-      console.log(JSON.stringify({ error: msg, exitCode: 2 }));
-    } else {
-      process.stderr.write(msg + '\n');
-    }
-    process.exit(2);
-  }
-
-  const normalizedTarget = targetPath.replace(/\\/g, '/');
-
-  const allIssues = [];
-  for (const filePath of files) {
-    let content;
-    try {
-      content = readFileSync(filePath, 'utf8');
-    } catch {
-      continue;
-    }
-    const normalizedFile = filePath.replace(/\\/g, '/');
-    const relPath = normalizedFile.startsWith(normalizedTarget)
-      ? normalizedFile.slice(normalizedTarget.length).replace(/^\//, '')
-      : normalizedFile;
-
-    const issues = [
-      ...validateNextComponent(content, relPath),
-      ...checkUseEffectFetch(content, relPath),
-      ...checkDefaultExport(content, relPath),
-    ];
-    allIssues.push(...issues);
-  }
-
-  const errors = allIssues.filter(i => i.type === 'error');
-  const warnings = allIssues.filter(i => i.type === 'warning');
-
-  if (jsonMode) {
-    const out = JSON.stringify({
-      files: files.length,
-      issues: allIssues.map(i => ({
-        severity: i.type,
-        message: i.message,
-        file: i.file,
-        line: i.line ?? null,
-        suggestion: i.suggestion ?? null,
-      })),
-      errors: errors.length,
-      warnings: warnings.length,
-      exitCode: errors.length > 0 ? 1 : 0,
-    }, null, 2);
-    process.stdout.write(out + '\n');
-    process.exit(errors.length > 0 ? 1 : 0);
-  }
-
-  const displayPath = targetPath.replace(process.cwd().replace(/\\/g, '/'), '.').replace(/\\/g, '/');
-  console.log(`🔍 Scanning ${displayPath} (${files.length} file${files.length !== 1 ? "s" : ""})...`);
-  console.log("");
-
-  if (allIssues.length === 0) {
-    console.log(`✅ No issues found — ${files.length} file${files.length !== 1 ? "s" : ""} scanned`);
-    console.log(`Summary: ${files.length} files scanned | 0 issues (0 critical, 0 high, 0 medium)`);
-    process.exit(0);
-  }
-
-  if (errors.length > 0) {
-    console.log(`CRITICAL (${errors.length})`);
-    for (const issue of errors) {
-      const loc = issue.line ? `:${issue.line}` : "";
-      console.log(`  ${issue.file}${loc}  — ${issue.message}`);
-      if (issue.suggestion) console.log(`    → ${issue.suggestion}`);
-    }
-    console.log('');
-  }
-
-  if (warnings.length > 0) {
-    console.log(`HIGH/MEDIUM (${warnings.length})`);
-    for (const issue of warnings) {
-      console.log(`  ${issue.file}  — ${issue.message}`);
-    }
-    console.log('');
-  }
-
-  const cleanFiles = files.length - new Set(allIssues.map(i => i.file)).size;
-  if (cleanFiles > 0) {
-    console.log(`✅ No issues found in ${cleanFiles} file${cleanFiles !== 1 ? "s" : ""}`);
-  }
-
-  console.log(`Summary: ${files.length} files scanned | ${allIssues.length} issue${allIssues.length !== 1 ? "s" : ""} (${errors.length} critical, ${warnings.length} high/medium)`);
-  process.exit(errors.length > 0 ? 1 : 0);
-}
-
-main();