@polymorphism-tech/morph-spec 4.21.0 → 5.0.1

package/framework/skills/level-0-meta/morph-post-implementation/scripts/detect-dev-server.mjs

@@ -1,153 +0,0 @@
-#!/usr/bin/env node
-/**
- * detect-dev-server.mjs
- *
- * Detects an active dev server on common localhost ports,
- * optionally starting one if not found.
- *
- * Usage:
- *   node detect-dev-server.mjs [startCommand]
- *
- * Examples:
- *   node detect-dev-server.mjs
- *   node detect-dev-server.mjs "npm run dev"
- *   node detect-dev-server.mjs "dotnet run --project src/Api/Api.csproj"
- *
- * Output JSON (stdout):
- *   { found: true,  url: "http://localhost:3000", started?: true }  → exit 0
- *   { found: false, error?: "..." }                                  → exit 1
- *
- * Behavior:
- *   1. Scan ports [3000, 3001, 4200, 5000, 5001, 7000, 8000, 8080] with 500ms timeout
- *   2. If found → output { found: true, url } and exit 0
- *   3. If not found and startCommand provided:
- *      - Spawn startCommand as background process
- *      - Poll ports every 2s for up to 30s
- *      - If server starts → output { found: true, url, started: true } and exit 0
- *      - If timeout → output { found: false, error: "timeout after 30s" } and exit 1
- *   4. If not found and no startCommand → output { found: false } and exit 1
- */
-
-import { spawn } from 'child_process';
-
-const PORTS = [3000, 3001, 4200, 5000, 5001, 7000, 8000, 8080];
-const FETCH_TIMEOUT_MS = 500;
-const START_TIMEOUT_MS = 30_000;
-const POLL_INTERVAL_MS = 2_000;
-
-const startCommand = process.argv[2] ?? null;
-
-/**
- * Try to fetch a URL with a timeout.
- * Returns true if response is received (any status code), false on network error/timeout.
- */
-async function isPortOpen(url) {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
-  try {
-    await fetch(url, { signal: controller.signal });
-    return true;
-  } catch {
-    return false;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-/**
- * Scan all known ports and return the first responsive URL, or null.
- */
-async function scanPorts() {
-  for (const port of PORTS) {
-    const url = `http://localhost:${port}`;
-    if (await isPortOpen(url)) {
-      return url;
-    }
-  }
-  return null;
-}
-
-// ─── Step 1: Scan for existing server ────────────────────────────────────────
-
-const existing = await scanPorts();
-
-if (existing) {
-  console.log(JSON.stringify({ found: true, url: existing }, null, 2));
-  process.exit(0);
-}
-
-// ─── Step 2: No server found, try to start one ───────────────────────────────
-
-if (!startCommand) {
-  console.log(JSON.stringify({ found: false }, null, 2));
-  process.exit(1);
-}
-
-// Spawn the start command as a background process
-// Support both simple commands and commands with "cd X && Y" syntax
-let child;
-try {
-  // Use shell=true to handle complex commands like "cd frontend && npm run dev"
-  child = spawn(startCommand, [], {
-    shell: true,
-    detached: false,
-    stdio: ['ignore', 'pipe', 'pipe'],
-  });
-
-  // Suppress child output (we only care if it starts)
-  child.stdout?.resume();
-  child.stderr?.resume();
-} catch (err) {
-  console.log(JSON.stringify({ found: false, error: `Failed to spawn: ${err.message}` }, null, 2));
-  process.exit(1);
-}
-
-// Poll for the server to become available
-const startedAt = Date.now();
-
-const result = await new Promise((resolve) => {
-  const poll = async () => {
-    const elapsed = Date.now() - startedAt;
-
-    if (elapsed >= START_TIMEOUT_MS) {
-      resolve({ found: false, error: 'timeout after 30s — server did not start in time' });
-      return;
-    }
-
-    const url = await scanPorts();
-    if (url) {
-      resolve({ found: true, url, started: true });
-      return;
-    }
-
-    setTimeout(poll, POLL_INTERVAL_MS);
-  };
-
-  // Handle child process errors / early exit
-  child.on('error', (err) => {
-    resolve({ found: false, error: `Process error: ${err.message}` });
-  });
-
-  child.on('exit', (code) => {
-    // Only treat as error if it exited quickly (< 3s) with non-zero
-    if (Date.now() - startedAt < 3_000 && code !== 0 && code !== null) {
-      resolve({ found: false, error: `Process exited with code ${code}` });
-    }
-    // Otherwise it may have crashed after starting — let the poll timeout handle it
-  });
-
-  // Start polling after a short initial delay
-  setTimeout(poll, POLL_INTERVAL_MS);
-});
-
-// Clean up the child process if still running
-if (child && !child.killed) {
-  try {
-    child.kill('SIGTERM');
-  } catch {
-    // ignore cleanup errors
-  }
-}
-
-console.log(JSON.stringify(result, null, 2));
-process.exit(result.found ? 0 : 1);

package/framework/skills/level-0-meta/morph-post-implementation/scripts/detect-stack.mjs

@@ -1,234 +0,0 @@
-#!/usr/bin/env node
-/**
- * detect-stack.mjs
- *
- * Detects the project tech stack from config, context, or file scan.
- *
- * Usage:
- *   node detect-stack.mjs
- *
- * Output JSON:
- *   {
- *     stack: "DOTNET" | "NEXTJS" | "FULLSTACK" | "UNKNOWN",
- *     frontendPath: string | null,
- *     backendPath: string | null,
- *     startCommand: string | null
- *   }
- *
- * Detection order (most reliable first):
- *   1. .morph/config/config.json → config.project.stack + frontendPath/backendPath
- *   2. .morph/context/README.md → "## Tech Stack" section
- *   3. Fallback: glob *.csproj (DOTNET) + package.json with dep "next" (NEXTJS)
- *
- * Exit code: 0 always
- */
-
-import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
-import { join, relative, dirname } from 'path';
-
-const cwd = process.cwd();
-
-/** Try to read a JSON file safely. Returns null on failure. */
-function readJson(filePath) {
-  try {
-    return JSON.parse(readFileSync(filePath, 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-
-/** Try to read a text file safely. Returns null on failure. */
-function readText(filePath) {
-  try {
-    return readFileSync(filePath, 'utf-8');
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Find files matching a pattern recursively.
- * Returns relative paths from cwd.
- */
-function findFiles(dir, predicate, maxDepth = 4, _depth = 0) {
-  if (_depth > maxDepth) return [];
-  if (!existsSync(dir)) return [];
-  const results = [];
-  const ignored = ['node_modules', '.git', '.next', 'dist', 'build', '.turbo', 'bin', 'obj', '.morph'];
-  try {
-    for (const entry of readdirSync(dir, { withFileTypes: true })) {
-      if (entry.isDirectory()) {
-        if (!ignored.includes(entry.name)) {
-          results.push(...findFiles(join(dir, entry.name), predicate, maxDepth, _depth + 1));
-        }
-      } else if (entry.isFile() && predicate(entry.name)) {
-        results.push(join(dir, entry.name));
-      }
-    }
-  } catch {
-    // ignore permission errors
-  }
-  return results;
-}
-
-/**
- * Normalize a stack string from config to canonical form.
- * Handles values like "nextjs+dotnet", "dotnet", "next.js", "nextjs", etc.
- */
-function normalizeStack(raw) {
-  if (!raw || typeof raw !== 'string') return null;
-  const s = raw.toLowerCase();
-  const hasDotnet = s.includes('dotnet') || s.includes('.net');
-  const hasNext = s.includes('next') || s.includes('nextjs');
-  if (hasDotnet && hasNext) return 'FULLSTACK';
-  if (hasDotnet) return 'DOTNET';
-  if (hasNext) return 'NEXTJS';
-  return null;
-}
-
-/**
- * Parse "## Tech Stack" section from a README-style markdown file.
- * Returns normalized stack or null.
- */
-function parseReadmeStack(content) {
-  if (!content) return null;
-  // Find "## Tech Stack" section and read next ~10 lines
-  const lines = content.split('\n');
-  let inSection = false;
-  const sectionLines = [];
-  for (const line of lines) {
-    if (/^##\s+tech\s+stack/i.test(line)) {
-      inSection = true;
-      continue;
-    }
-    if (inSection) {
-      if (/^##/.test(line)) break; // next section
-      sectionLines.push(line.toLowerCase());
-    }
-  }
-  if (sectionLines.length === 0) return null;
-  const text = sectionLines.join(' ');
-  const hasDotnet = /dotnet|\.net|c#|asp\.net/.test(text);
-  const hasNext = /next\.?js|nextjs/.test(text);
-  if (hasDotnet && hasNext) return 'FULLSTACK';
-  if (hasDotnet) return 'DOTNET';
-  if (hasNext) return 'NEXTJS';
-  return null;
-}
-
-/**
- * Build a startCommand from stack + paths.
- */
-function buildStartCommand(stack, frontendPath, backendPath) {
-  if (stack === 'NEXTJS') {
-    const base = frontendPath ? join(cwd, frontendPath) : cwd;
-    // Check for custom dev script
-    const pkgPath = join(base, 'package.json');
-    const pkg = readJson(pkgPath);
-    if (pkg?.scripts?.dev) {
-      return frontendPath ? `cd ${frontendPath} && npm run dev` : 'npm run dev';
-    }
-    return frontendPath ? `cd ${frontendPath} && npm run dev` : 'npm run dev';
-  }
-  if (stack === 'DOTNET') {
-    if (backendPath) {
-      // Try to find .csproj inside backendPath
-      const csprojFiles = findFiles(join(cwd, backendPath), (n) => n.endsWith('.csproj'), 2);
-      if (csprojFiles.length > 0) {
-        const rel = relative(cwd, csprojFiles[0]).replace(/\\/g, '/');
-        return `dotnet run --project ${rel}`;
-      }
-      return `dotnet run --project ${backendPath}`;
-    }
-    // Find any .csproj
-    const csprojFiles = findFiles(cwd, (n) => n.endsWith('.csproj'), 4);
-    if (csprojFiles.length > 0) {
-      const rel = relative(cwd, csprojFiles[0]).replace(/\\/g, '/');
-      return `dotnet run --project ${rel}`;
-    }
-    return 'dotnet run';
-  }
-  if (stack === 'FULLSTACK') {
-    // Prefer Next.js start for smoke testing
-    const fe = frontendPath ? join(cwd, frontendPath) : cwd;
-    return frontendPath ? `cd ${frontendPath} && npm run dev` : 'npm run dev';
-  }
-  return null;
-}
-
-// ─── Detection Strategy 1: .morph/config/config.json ─────────────────────────
-
-const configPath = join(cwd, '.morph', 'config', 'config.json');
-const config = readJson(configPath);
-
-if (config?.config?.project?.stack) {
-  const stack = normalizeStack(config.config.project.stack);
-  if (stack) {
-    const frontendPath = config.config.project.frontendPath ?? null;
-    const backendPath = config.config.project.backendPath ?? null;
-    const startCommand = buildStartCommand(stack, frontendPath, backendPath);
-    console.log(JSON.stringify({ stack, frontendPath, backendPath, startCommand }, null, 2));
-    process.exit(0);
-  }
-}
-
-// ─── Detection Strategy 2: .morph/context/README.md ──────────────────────────
-
-const readmePath = join(cwd, '.morph', 'context', 'README.md');
-const readmeContent = readText(readmePath);
-const readmeStack = parseReadmeStack(readmeContent);
-
-if (readmeStack) {
-  const startCommand = buildStartCommand(readmeStack, null, null);
-  console.log(JSON.stringify({
-    stack: readmeStack,
-    frontendPath: null,
-    backendPath: null,
-    startCommand,
-  }, null, 2));
-  process.exit(0);
-}
-
-// ─── Detection Strategy 3: File scan ─────────────────────────────────────────
-
-const csprojFiles = findFiles(cwd, (n) => n.endsWith('.csproj'), 4);
-const hasDotnet = csprojFiles.length > 0;
-
-// Find package.json files with "next" dependency (excluding node_modules already filtered)
-const packageJsonFiles = findFiles(cwd, (n) => n === 'package.json', 4);
-let hasNext = false;
-let nextPackageDir = null;
-
-for (const pkgFile of packageJsonFiles) {
-  const pkg = readJson(pkgFile);
-  if (pkg?.dependencies?.next || pkg?.devDependencies?.next) {
-    hasNext = true;
-    nextPackageDir = relative(cwd, dirname(pkgFile)).replace(/\\/g, '/') || null;
-    break;
-  }
-}
-
-let stack = 'UNKNOWN';
-let frontendPath = null;
-let backendPath = null;
-
-if (hasDotnet && hasNext) {
-  stack = 'FULLSTACK';
-  frontendPath = nextPackageDir;
-  backendPath = csprojFiles.length > 0
-    ? relative(cwd, dirname(csprojFiles[0])).replace(/\\/g, '/') || null
-    : null;
-} else if (hasDotnet) {
-  stack = 'DOTNET';
-  backendPath = csprojFiles.length > 0
-    ? relative(cwd, dirname(csprojFiles[0])).replace(/\\/g, '/') || null
-    : null;
-} else if (hasNext) {
-  stack = 'NEXTJS';
-  frontendPath = nextPackageDir;
-}
-
-const startCommand = buildStartCommand(stack, frontendPath, backendPath);
-
-console.log(JSON.stringify({ stack, frontendPath, backendPath, startCommand }, null, 2));
-process.exit(0);

package/framework/skills/level-0-meta/morph-simulation-checklist/SKILL.md

@@ -1,106 +0,0 @@
----
-name: morph-simulation-checklist
-description: Checklist for implementing mock/simulation clients for external .NET services (AI APIs, payments, email). Use when setting up simulation mode without real API access, when creating fake service implementations for development/testing, or when debugging external service integrations.
-user-invocable: true
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-stacks:
-  - dotnet
----
-
-# Simulation Checklist
-
-Checklist for simulating external services (AI, payment, email APIs) in .NET projects.
-
-## Pre-Implementation
-
-### 1. Map All Dependencies
-
-- [ ] List ALL interfaces in the flow (`grep -r "I{ServiceName}" src/ --include="*.cs" -l`)
-- [ ] Identify **transitive dependencies** (e.g., `ArtGenerationService` → `IReplicateClient` + `IImageDownloader`)
-- [ ] Document dependency trace: services to mock, transitive deps, required lifetimes
-
-### 2. Verify Lifetimes
-
-| State | Lifetime | Example |
-|-------|----------|---------|
-| Stateful (Dictionary, List) | **Singleton** | `FakeReplicateClient` with prediction store |
-| Stateless | **Scoped** | `FakeEmailClient` that only logs |
-
-```csharp
-// ❌ Stateful + Scoped = loses state between requests
-services.AddScoped<IReplicateClient, FakeReplicateClient>();
-// ✅ Stateful + Singleton
-services.AddSingleton<IReplicateClient, FakeReplicateClient>();
-```
-
-### 3. Read Complete Interfaces
-
-- [ ] Check full signatures — don't miss optional parameters (`attachments`, `CancellationToken`)
-- [ ] For AI mocks: verify current prompts, model in use, response format
-- [ ] For email mocks: check for attachments/inline images, log simulated sends
-- [ ] For payment mocks: implement state transitions (PENDING → CONFIRMED → REFUNDED), simulate webhooks
-
-## Configuration Template
-
-```json
-// appsettings.Development.json
-{ "Simulation": { "Enabled": true, "ImageDelayMs": 500, "PlaceholderImageUrl": "https://picsum.photos/1024/1024" } }
-```
-
-```csharp
-if (configuration.GetValue<bool>("Simulation:Enabled"))
-    services.AddSimulationClients(configuration);  // Stateful→Singleton, Stateless→Scoped
-else
-    services.AddProductionClients(configuration);
-```
-
-## MORPH-SPEC Integration
-
-When implementing simulation as a morph-spec task:
-
-```bash
-# Track the simulation setup task
-morph-spec task start {feature} {task-id}
-
-# After implementation, validate the feature
-morph-spec validate-feature {feature}
-
-# Complete the task (triggers Tier-4 validators)
-morph-spec task done {feature} {task-id}
-```
-
-Reference the project's service lifetime patterns:
-```bash
-# Check existing DI patterns in the project
-grep -r "AddSingleton\|AddScoped\|AddTransient" src/ --include="*.cs" -l
-```
-
-## Post-Implementation
-
-- [ ] Validate DI: `dotnet build && dotnet run` + health check
-- [ ] Test full flow end-to-end (not just unit tests)
-- [ ] Verify simulation logs — confirm mocks are being called
-- [ ] Run `morph-spec validate-feature {feature}` to check architecture compliance
-
-## Common Errors
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| Mock loses state between requests | Scoped lifetime for stateful service | Change to Singleton |
-| `Unable to resolve service` at runtime | Transitive dependency not registered | Map ALL dependencies |
-| Incorrect method signature | Didn't read full interface | Check optional params |
-| Mock returns wrong data | Prompts/model changed | Read current prompts |
-| Works in test, fails at runtime | Test doesn't cover full DI | Test with `dotnet run` |
-
-## Checklist
-
-- [ ] All interfaces mapped (including transitive)
-- [ ] Lifetimes correct (stateful=Singleton, stateless=Scoped)
-- [ ] Complete interface signatures implemented
-- [ ] Simulation toggle via config
-- [ ] End-to-end flow tested in simulation mode
-- [ ] No real API calls in simulation mode
-
----
-
-*MORPH-SPEC Simulation Checklist*