@polymorphism-tech/morph-spec 4.8.1 → 4.8.5

package/scripts/validate-real.mjs

@@ -1,255 +0,0 @@
-/**
- * scripts/validate-real.mjs
- *
- * Real-world integration validation for output-schema.js centralization.
- * Creates a temp .morph project, creates a feature, and verifies all paths.
- *
- * Usage: node scripts/validate-real.mjs
- */
-
-import { join, dirname } from 'path';
-import { writeFileSync, mkdirSync, existsSync, readFileSync, rmSync } from 'fs';
-import { spawnSync } from 'child_process';
-import { fileURLToPath, pathToFileURL } from 'url';
-import { tmpdir } from 'os';
-
-// Helper: convert Windows absolute path to file:// URL for dynamic import
-function toFileUrl(p) { return pathToFileURL(p).href; }
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(__dirname, '..');
-
-let passed = 0;
-let failed = 0;
-
-function ok(label, condition, detail = '') {
-  if (condition) {
-    console.log(`  ✓ ${label}`);
-    passed++;
-  } else {
-    console.error(`  ✗ ${label}${detail ? '\n    ' + detail : ''}`);
-    failed++;
-  }
-}
-
-function section(title) {
-  console.log(`\n── ${title} ──`);
-}
-
-// ============================================================================
-// 1. output-schema.js — paths and derived constants
-// ============================================================================
-section('1. output-schema.js exports');
-
-const {
-  OUTPUT_SCHEMA, getOutputPath, getAbsoluteOutputPath, getFeatureDir, getAllOutputPaths,
-  FILENAME_TO_OUTPUT, OUTPUT_PHASE_MAP, PROTECTED_SPEC_FILES,
-} = await import(toFileUrl(join(ROOT, 'src/core/paths/output-schema.js')));
-
-ok('OUTPUT_SCHEMA has 12 keys', Object.keys(OUTPUT_SCHEMA).length === 12);
-ok('spec path correct',
-  getOutputPath('my-feature', 'spec') === '.morph/features/my-feature/1-design/spec.md');
-ok('contracts path correct',
-  getOutputPath('my-feature', 'contracts') === '.morph/features/my-feature/1-design/contracts.cs');
-ok('tasks path correct',
-  getOutputPath('my-feature', 'tasks') === '.morph/features/my-feature/3-tasks/tasks.md');
-ok('uiDesignSystem path correct',
-  getOutputPath('my-feature', 'uiDesignSystem') === '.morph/features/my-feature/2-ui/design-system.md');
-ok('clarifications path correct',
-  getOutputPath('my-feature', 'clarifications') === '.morph/features/my-feature/1-design/clarifications.md');
-ok('recap path correct',
-  getOutputPath('my-feature', 'recap') === '.morph/features/my-feature/4-implement/recap.md');
-
-const allPaths = Object.keys(OUTPUT_SCHEMA).map(k => getOutputPath('feat', k));
-ok('no backslashes in any getOutputPath() result',
-  allPaths.every(p => !p.includes('\\')),
-  allPaths.filter(p => p.includes('\\')).join(', ') || 'all clean');
-
-const absSpec = getAbsoluteOutputPath('/project', 'my-feature', 'spec');
-ok('getAbsoluteOutputPath ends with spec.md', absSpec.endsWith('spec.md'));
-
-const all = getAllOutputPaths('test-feat');
-ok('getAllOutputPaths returns 12 entries', Object.keys(all).length === 12);
-ok('getAllOutputPaths created:false for all', Object.values(all).every(v => v.created === false));
-ok('getAllOutputPaths paths match getOutputPath',
-  Object.entries(all).every(([k, v]) => v.path === getOutputPath('test-feat', k)));
-
-ok("FILENAME_TO_OUTPUT['spec.md'] === 'spec'",      FILENAME_TO_OUTPUT['spec.md'] === 'spec');
-ok("FILENAME_TO_OUTPUT['contracts.cs'] === 'contracts'", FILENAME_TO_OUTPUT['contracts.cs'] === 'contracts');
-ok("OUTPUT_PHASE_MAP['spec'] === 'design'",          OUTPUT_PHASE_MAP['spec'] === 'design');
-ok("OUTPUT_PHASE_MAP['tasks'] === 'tasks'",          OUTPUT_PHASE_MAP['tasks'] === 'tasks');
-ok("PROTECTED_SPEC_FILES['spec.md'] === 'design'",  PROTECTED_SPEC_FILES['spec.md'] === 'design');
-ok("PROTECTED_SPEC_FILES['tasks.md'] === 'tasks'",  PROTECTED_SPEC_FILES['tasks.md'] === 'tasks');
-ok("PROTECTED_SPEC_FILES has no 'proposal.md'",     !('proposal.md' in PROTECTED_SPEC_FILES));
-ok("getFeatureDir uses forward slashes",            !getFeatureDir('x').includes('\\'));
-ok("getFeatureDir correct",                         getFeatureDir('my-feature') === '.morph/features/my-feature');
-
-// ============================================================================
-// 2. state-manager ensureFeature() creates correct paths in state.json
-// ============================================================================
-section('2. state-manager.js ensureFeature()');
-
-// Create an isolated temp .morph project
-const tempDir = join(tmpdir(), `morph-val-${Date.now()}`);
-const morphDir = join(tempDir, '.morph');
-const configDir = join(morphDir, 'config');
-mkdirSync(configDir, { recursive: true });
-mkdirSync(join(morphDir, 'features'), { recursive: true });
-mkdirSync(join(morphDir, 'context'), { recursive: true });
-
-writeFileSync(join(configDir, 'config.json'), JSON.stringify({
-  framework: 'morph-spec', project: { name: 'test-project' }
-}, null, 2));
-
-const origCwd = process.cwd();
-process.chdir(tempDir);
-
-const { initState, updateFeature, loadState } = await import(toFileUrl(join(ROOT, 'src/core/state/state-manager.js')));
-// initState creates state.json; updateFeature calls ensureFeature internally
-initState({ name: 'test-project', type: 'test' });
-await updateFeature('my-feature', 'status', 'draft');
-const state = loadState();
-const feat = state.features['my-feature'];
-
-process.chdir(origCwd);
-
-ok('ensureFeature creates outputs block', !!feat?.outputs);
-ok('outputs has 12 keys', Object.keys(feat?.outputs ?? {}).length === 12);
-
-let allMatch = true;
-const mismatches = [];
-for (const [key, { path }] of Object.entries(feat?.outputs ?? {})) {
-  const expected = getOutputPath('my-feature', key);
-  if (path !== expected) {
-    allMatch = false;
-    mismatches.push(`${key}: got "${path}", expected "${expected}"`);
-  }
-}
-ok('ALL output paths match output-schema.js', allMatch, mismatches.join('\n    '));
-
-ok("spec path in state.json",
-  feat.outputs.spec?.path === '.morph/features/my-feature/1-design/spec.md');
-ok("contracts path in state.json",
-  feat.outputs.contracts?.path === '.morph/features/my-feature/1-design/contracts.cs');
-ok("uiDesignSystem path in state.json",
-  feat.outputs.uiDesignSystem?.path === '.morph/features/my-feature/2-ui/design-system.md');
-ok("no backslashes in state.json output paths",
-  Object.values(feat.outputs).every(({ path }) => !path.includes('\\')));
-
-// ============================================================================
-// 3. v3 → v4 migration uses getAllOutputPaths
-// ============================================================================
-section('3. v3 → v4 migration');
-
-// Write a v3.0.0 state in a fresh temp dir
-const tempDir2 = join(tmpdir(), `morph-val2-${Date.now()}`);
-const morphDir2 = join(tempDir2, '.morph');
-const configDir2 = join(morphDir2, 'config');
-mkdirSync(configDir2, { recursive: true });
-mkdirSync(join(morphDir2, 'features'), { recursive: true });
-
-const v3State = {
-  version: '3.0.0',
-  project: { name: 'legacy', type: 'test' },
-  features: {
-    'legacy-feat': {
-      status: 'draft', phase: 'design',
-      outputs: {
-        spec:      { created: true,  path: '.morph/features/legacy-feat/spec.md' },
-        contracts: { created: false, path: '.morph/features/legacy-feat/contracts.cs' },
-        tasks:     { created: false, path: '.morph/features/legacy-feat/tasks.md' },
-      }
-    }
-  },
-  metadata: { totalFeatures: 1, lastUpdated: new Date().toISOString() }
-};
-writeFileSync(join(morphDir2, 'state.json'), JSON.stringify(v3State, null, 2));
-
-process.chdir(tempDir2);
-// state-manager is already cached; read the file directly to check migration
-// Re-use the already-imported module (ESM cache) — just call loadState directly
-const migrated = loadState();
-process.chdir(origCwd);
-
-ok('version migrated to 4.0.0', migrated.version === '4.0.0');
-ok('spec path migrated to 1-design subfolder',
-  migrated.features['legacy-feat'].outputs.spec?.path
-    === '.morph/features/legacy-feat/1-design/spec.md');
-ok('contracts path migrated to 1-design subfolder',
-  migrated.features['legacy-feat'].outputs.contracts?.path
-    === '.morph/features/legacy-feat/1-design/contracts.cs');
-ok('tasks path migrated to 3-tasks subfolder',
-  migrated.features['legacy-feat'].outputs.tasks?.path
-    === '.morph/features/legacy-feat/3-tasks/tasks.md');
-
-// ============================================================================
-// 4. phase-utils.js matches output-schema.js
-// ============================================================================
-section('4. phase-utils.js constants sync');
-
-const {
-  FILENAME_TO_OUTPUT: PU_FTO,
-  OUTPUT_PHASE_MAP: PU_OPM,
-  PROTECTED_SPEC_FILES: PU_PSF,
-  PHASE_DIRS,
-} = await import(toFileUrl(join(ROOT, 'framework/hooks/shared/phase-utils.js')));
-
-ok('FILENAME_TO_OUTPUT matches schema', JSON.stringify(PU_FTO) === JSON.stringify(FILENAME_TO_OUTPUT));
-ok('OUTPUT_PHASE_MAP matches schema',   JSON.stringify(PU_OPM) === JSON.stringify(OUTPUT_PHASE_MAP));
-ok('PROTECTED_SPEC_FILES matches schema', JSON.stringify(PU_PSF) === JSON.stringify(PROTECTED_SPEC_FILES));
-ok("PHASE_DIRS['setup'] = '0-proposal' (manual extra)", PHASE_DIRS['setup'] === '0-proposal');
-ok("PHASE_DIRS['sync'] = '4-implement' (manual extra)", PHASE_DIRS['sync'] === '4-implement');
-ok("PHASE_DIRS['clarify'] = '1-design' (from schema)",  PHASE_DIRS['clarify'] === '1-design');
-
-// ============================================================================
-// 5. generate-refs.js --check exits 0
-// ============================================================================
-section('5. generate-refs.js --check (CI mode)');
-
-const checkResult = spawnSync(
-  process.execPath,
-  [join(ROOT, 'scripts/generate-refs.js'), '--check'],
-  { encoding: 'utf8' }
-);
-
-ok('exits 0 (no drift)', checkResult.status === 0,
-  checkResult.status !== 0 ? (checkResult.stdout + checkResult.stderr).trim() : '');
-ok('reports all up to date',
-  (checkResult.stdout || '').includes('OK: All generated refs are in sync'));
-
-// ============================================================================
-// 6. Simulate "add new output type" round-trip
-// ============================================================================
-section('6. Error handling: invalid output type');
-
-let threw = false;
-try {
-  getOutputPath('my-feature', 'nonExistentType');
-} catch (e) {
-  threw = e.message.includes('Unknown output type');
-}
-ok('getOutputPath throws on unknown type', threw);
-
-let threw2 = false;
-try {
-  getAbsoluteOutputPath('/proj', 'feat', 'bogus');
-} catch (e) {
-  threw2 = e.message.includes('Unknown output type');
-}
-ok('getAbsoluteOutputPath throws on unknown type', threw2);
-
-// ============================================================================
-// Cleanup + summary
-// ============================================================================
-try { rmSync(tempDir, { recursive: true, force: true }); } catch {}
-try { rmSync(tempDir2, { recursive: true, force: true }); } catch {}
-
-console.log(`\n${'─'.repeat(52)}`);
-console.log(`Results: ${passed} passed, ${failed} failed`);
-if (failed === 0) {
-  console.log('✅  ALL VALIDATIONS PASSED');
-  process.exit(0);
-} else {
-  console.error('❌  SOME VALIDATIONS FAILED');
-  process.exit(1);
-}