@polymorphism-tech/morph-spec 7.8.1 → 7.9.0

package/framework/templates/meta-prompts/validators/pre-commit-validator.md

@@ -1,95 +1,95 @@
-# Pre-Commit Validator
-
-You are running as part of the **pre-commit hook** to validate changes before they are committed.
-
-## Trigger Context
-- Hook: pre-commit
-- Feature: {{FEATURE_NAME}}
-- Branch: {{BRANCH_NAME}}
-- Staged Files: {{STAGED_FILE_COUNT}} files
-
-## Staged Files Under Review
-
-{{STAGED_FILES}}
-
-## Validation Sequence
-
-### 1. Conventional Commit Format Check
-Verify the commit message (if provided) follows Conventional Commits:
-```
-<type>(<scope>): <description>
-
-Types: feat, fix, docs, style, refactor, test, chore, perf, ci, build
-```
-
-Valid examples:
-- `feat(auth): add JWT refresh token rotation`
-- `fix(api): resolve handler lifecycle in reports endpoint`
-- `chore(deps): update TanStack Query to 5.x`
-
-### 2. Secret Scan
-Check staged files for accidental secrets:
-- Connection strings with passwords
-- API keys or tokens
-- Private keys (-----BEGIN RSA PRIVATE KEY-----)
-- `.env` files accidentally staged
-
-**Blockers** (commit must be rejected):
-- Any `password=` or `pwd=` outside development appsettings
-- API keys matching common patterns (sk-*, xoxb-*, ghp_*)
-- Private key headers
-
-### 3. Agent Spec Validation (if agents.json staged)
-If `.morph/framework/agents.json` is in staged files:
-- Valid JSON structure
-- All required agent fields present (agentId, role, tier, domain)
-- No duplicate agentIds
-- Valid tier values (1-4)
-
-### 4. Spec Format Validation (if spec.md staged)
-If any `spec.md` is staged:
-- Has required sections: Overview, Requirements, Technical Design, Data Model, API Contracts
-- No placeholder text (`{{TODO}}`, `TBD`, `[PLACEHOLDER]`)
-- Word count > 200 (meaningful spec)
-
-### 5. Stack-Specific Validation
-{{#if IS_CSHARP}}
-For C# files:
-- No `TODO` comments in staged code
-- No `Console.WriteLine` in production code (use ILogger)
-- No `Thread.Sleep` (use async alternatives)
-{{/if}}
-
-{{#if IS_TYPESCRIPT}}
-For TypeScript files:
-- No `any` type (use proper types)
-- No `console.log` in production components
-- No commented-out code blocks > 3 lines
-{{/if}}
-
-## Decision
-
-**All checks pass:**
-```
-✅ Pre-commit validation passed
-   Proceeding with commit.
-```
-
-**Blocking issue found:**
-```
-❌ Pre-commit BLOCKED
-
-   Issue: [description]
-   File: [file:line]
-   Fix: [specific instruction]
-
-   Commit rejected. Fix the issue and retry.
-```
-
-**Warning only (commit proceeds):**
-```
-⚠️ Pre-commit warnings (commit allowed)
-
-   Warning: [description]
-   Recommendation: [suggestion]
-```
+# Pre-Commit Validator
+
+You are running as part of the **pre-commit hook** to validate changes before they are committed.
+
+## Trigger Context
+- Hook: pre-commit
+- Feature: {{FEATURE_NAME}}
+- Branch: {{BRANCH_NAME}}
+- Staged Files: {{STAGED_FILE_COUNT}} files
+
+## Staged Files Under Review
+
+{{STAGED_FILES}}
+
+## Validation Sequence
+
+### 1. Conventional Commit Format Check
+Verify the commit message (if provided) follows Conventional Commits:
+```
+<type>(<scope>): <description>
+
+Types: feat, fix, docs, style, refactor, test, chore, perf, ci, build
+```
+
+Valid examples:
+- `feat(auth): add JWT refresh token rotation`
+- `fix(api): resolve handler lifecycle in reports endpoint`
+- `chore(deps): update TanStack Query to 5.x`
+
+### 2. Secret Scan
+Check staged files for accidental secrets:
+- Connection strings with passwords
+- API keys or tokens
+- Private keys (-----BEGIN RSA PRIVATE KEY-----)
+- `.env` files accidentally staged
+
+**Blockers** (commit must be rejected):
+- Any `password=` or `pwd=` outside development appsettings
+- API keys matching common patterns (sk-*, xoxb-*, ghp_*)
+- Private key headers
+
+### 3. Agent Spec Validation (if agents.json staged)
+If `.morph/framework/agents.json` is in staged files:
+- Valid JSON structure
+- All required agent fields present (agentId, role, tier, domain)
+- No duplicate agentIds
+- Valid tier values (1-4)
+
+### 4. Spec Format Validation (if spec.md staged)
+If any `spec.md` is staged:
+- Has required sections: Overview, Requirements, Technical Design, Data Model, API Contracts
+- No placeholder text (`{{TODO}}`, `TBD`, `[PLACEHOLDER]`)
+- Word count > 200 (meaningful spec)
+
+### 5. Stack-Specific Validation
+{{#if IS_CSHARP}}
+For C# files:
+- No `TODO` comments in staged code
+- No `Console.WriteLine` in production code (use ILogger)
+- No `Thread.Sleep` (use async alternatives)
+{{/if}}
+
+{{#if IS_TYPESCRIPT}}
+For TypeScript files:
+- No `any` type (use proper types)
+- No `console.log` in production components
+- No commented-out code blocks > 3 lines
+{{/if}}
+
+## Decision
+
+**All checks pass:**
+```
+✅ Pre-commit validation passed
+   Proceeding with commit.
+```
+
+**Blocking issue found:**
+```
+❌ Pre-commit BLOCKED
+
+   Issue: [description]
+   File: [file:line]
+   Fix: [specific instruction]
+
+   Commit rejected. Fix the issue and retry.
+```
+
+**Warning only (commit proceeds):**
+```
+⚠️ Pre-commit warnings (commit allowed)
+
+   Warning: [description]
+   Recommendation: [suggestion]
+```

package/framework/templates/project/validate.js

@@ -1,120 +1,120 @@
-#!/usr/bin/env node
-/**
- * bin/validate.js — generated by morph-spec setup-infra
- *
- * Thin validator entry-point called by morph-spec validate-completion hook:
- *   node bin/validate.js <validator> [--json]
- *
- * Supported validators: architecture, nextjs-component,
- *   packages, design-system, ui-contrast, css
- *
- * Exits 0 on pass, 1 on validation errors.
- * --json flag prints structured JSON to stdout.
- */
-
-const validator = process.argv[2];
-const isJson = process.argv.includes('--json');
-
-if (!validator) {
-  console.error('Usage: node bin/validate.js <validator> [--json]');
-  process.exit(1);
-}
-
-const { execSync } = await import('child_process');
-const { existsSync } = await import('fs');
-const { join } = await import('path');
-
-const cwd = process.cwd();
-
-const results = {
-  validator,
-  errors: 0,
-  warnings: 0,
-  passed: true,
-  issues: [],
-};
-
-/**
- * Run a shell command and capture output.
- * Returns { success, stdout, stderr }.
- */
-function runCommand(cmd, options = {}) {
-  try {
-    const stdout = execSync(cmd, { cwd, stdio: ['pipe', 'pipe', 'pipe'], ...options }).toString();
-    return { success: true, stdout, stderr: '' };
-  } catch (err) {
-    return {
-      success: false,
-      stdout: err.stdout?.toString() || '',
-      stderr: err.stderr?.toString() || err.message,
-    };
-  }
-}
-
-// ── Stack detection ───────────────────────────────────────────────────────────
-
-const hasFrontend = existsSync(join(cwd, 'src/frontend')) || existsSync(join(cwd, 'frontend'));
-const hasBackend  = existsSync(join(cwd, 'src/backend'))  || existsSync(join(cwd, 'backend'));
-const hasSln      = existsSync(join(cwd, 'src/backend/backend.sln')) ||
-                    existsSync(join(cwd, 'src/backend/Backend.sln'));
-
-const frontendDir = existsSync(join(cwd, 'src/frontend')) ? 'src/frontend' : 'frontend';
-const backendDir  = existsSync(join(cwd, 'src/backend'))  ? 'src/backend'  : 'backend';
-
-// ── Validator dispatch ────────────────────────────────────────────────────────
-
-switch (validator) {
-  case 'architecture': {
-    if (hasBackend && hasSln) {
-      const slnFile = hasSln ? (
-        existsSync(join(cwd, 'src/backend/backend.sln')) ? 'backend.sln' : 'Backend.sln'
-      ) : '.';
-      const result = runCommand(`dotnet build ${slnFile} --no-restore -warnaserror`, { cwd: join(cwd, backendDir) });
-      if (!result.success) {
-        results.errors++;
-        results.passed = false;
-        results.issues.push({ level: 'error', message: `dotnet build failed: ${result.stderr.split('\n')[0]}` });
-      }
-    }
-    break;
-  }
-
-  case 'nextjs-component':
-  case 'packages':
-  case 'design-system': {
-    if (hasFrontend) {
-      const result = runCommand('npx tsc --noEmit', { cwd: join(cwd, frontendDir) });
-      if (!result.success) {
-        results.errors++;
-        results.passed = false;
-        results.issues.push({ level: 'error', message: `TypeScript errors found. Run: npx tsc --noEmit` });
-      }
-    }
-    break;
-  }
-
-  case 'ui-contrast':
-  case 'css': {
-    // CSS/contrast validators are visual — report as informational
-    results.issues.push({ level: 'info', message: `${validator} requires manual review` });
-    break;
-  }
-
-  default:
-    results.issues.push({ level: 'warning', message: `Unknown validator: ${validator}` });
-    break;
-}
-
-// ── Output ────────────────────────────────────────────────────────────────────
-
-if (isJson) {
-  console.log(JSON.stringify(results, null, 2));
-} else {
-  const icon = results.passed ? '✅' : '❌';
-  console.log(`${icon} Validator: ${validator} — ${results.passed ? 'PASSED' : `FAILED (${results.errors} errors)`}`);
-  for (const issue of results.issues) {
-    console.log(`  [${issue.level}] ${issue.message}`);
-  }
-}
-
-process.exit(results.passed ? 0 : 1);
+#!/usr/bin/env node
+/**
+ * bin/validate.js — generated by morph-spec setup-infra
+ *
+ * Thin validator entry-point called by morph-spec validate-completion hook:
+ *   node bin/validate.js <validator> [--json]
+ *
+ * Supported validators: architecture, nextjs-component,
+ *   packages, design-system, ui-contrast, css
+ *
+ * Exits 0 on pass, 1 on validation errors.
+ * --json flag prints structured JSON to stdout.
+ */
+
+const validator = process.argv[2];
+const isJson = process.argv.includes('--json');
+
+if (!validator) {
+  console.error('Usage: node bin/validate.js <validator> [--json]');
+  process.exit(1);
+}
+
+const { execSync } = await import('child_process');
+const { existsSync } = await import('fs');
+const { join } = await import('path');
+
+const cwd = process.cwd();
+
+const results = {
+  validator,
+  errors: 0,
+  warnings: 0,
+  passed: true,
+  issues: [],
+};
+
+/**
+ * Run a shell command and capture output.
+ * Returns { success, stdout, stderr }.
+ */
+function runCommand(cmd, options = {}) {
+  try {
+    const stdout = execSync(cmd, { cwd, stdio: ['pipe', 'pipe', 'pipe'], ...options }).toString();
+    return { success: true, stdout, stderr: '' };
+  } catch (err) {
+    return {
+      success: false,
+      stdout: err.stdout?.toString() || '',
+      stderr: err.stderr?.toString() || err.message,
+    };
+  }
+}
+
+// ── Stack detection ───────────────────────────────────────────────────────────
+
+const hasFrontend = existsSync(join(cwd, 'src/frontend')) || existsSync(join(cwd, 'frontend'));
+const hasBackend  = existsSync(join(cwd, 'src/backend'))  || existsSync(join(cwd, 'backend'));
+const hasSln      = existsSync(join(cwd, 'src/backend/backend.sln')) ||
+                    existsSync(join(cwd, 'src/backend/Backend.sln'));
+
+const frontendDir = existsSync(join(cwd, 'src/frontend')) ? 'src/frontend' : 'frontend';
+const backendDir  = existsSync(join(cwd, 'src/backend'))  ? 'src/backend'  : 'backend';
+
+// ── Validator dispatch ────────────────────────────────────────────────────────
+
+switch (validator) {
+  case 'architecture': {
+    if (hasBackend && hasSln) {
+      const slnFile = hasSln ? (
+        existsSync(join(cwd, 'src/backend/backend.sln')) ? 'backend.sln' : 'Backend.sln'
+      ) : '.';
+      const result = runCommand(`dotnet build ${slnFile} --no-restore -warnaserror`, { cwd: join(cwd, backendDir) });
+      if (!result.success) {
+        results.errors++;
+        results.passed = false;
+        results.issues.push({ level: 'error', message: `dotnet build failed: ${result.stderr.split('\n')[0]}` });
+      }
+    }
+    break;
+  }
+
+  case 'nextjs-component':
+  case 'packages':
+  case 'design-system': {
+    if (hasFrontend) {
+      const result = runCommand('npx tsc --noEmit', { cwd: join(cwd, frontendDir) });
+      if (!result.success) {
+        results.errors++;
+        results.passed = false;
+        results.issues.push({ level: 'error', message: `TypeScript errors found. Run: npx tsc --noEmit` });
+      }
+    }
+    break;
+  }
+
+  case 'ui-contrast':
+  case 'css': {
+    // CSS/contrast validators are visual — report as informational
+    results.issues.push({ level: 'info', message: `${validator} requires manual review` });
+    break;
+  }
+
+  default:
+    results.issues.push({ level: 'warning', message: `Unknown validator: ${validator}` });
+    break;
+}
+
+// ── Output ────────────────────────────────────────────────────────────────────
+
+if (isJson) {
+  console.log(JSON.stringify(results, null, 2));
+} else {
+  const icon = results.passed ? '✅' : '❌';
+  console.log(`${icon} Validator: ${validator} — ${results.passed ? 'PASSED' : `FAILED (${results.errors} errors)`}`);
+  for (const issue of results.issues) {
+    console.log(`  [${issue.level}] ${issue.message}`);
+  }
+}
+
+process.exit(results.passed ? 0 : 1);

package/framework/templates/state.template.json

@@ -1,17 +1,17 @@
-{
-  "version": "3.0.0",
-  "project": {
-    "name": "{{PROJECT_NAME}}",
-    "type": "{{PROJECT_TYPE}}",
-    "createdAt": "{{TIMESTAMP}}",
-    "updatedAt": "{{TIMESTAMP}}"
-  },
-  "features": {},
-  "threads": {},
-  "metadata": {
-    "totalFeatures": 0,
-    "completedFeatures": 0,
-    "totalTimeSpent": 0,
-    "lastUpdated": "{{TIMESTAMP}}"
-  }
-}
+{
+  "version": "3.0.0",
+  "project": {
+    "name": "{{PROJECT_NAME}}",
+    "type": "{{PROJECT_TYPE}}",
+    "createdAt": "{{TIMESTAMP}}",
+    "updatedAt": "{{TIMESTAMP}}"
+  },
+  "features": {},
+  "threads": {},
+  "metadata": {
+    "totalFeatures": 0,
+    "completedFeatures": 0,
+    "totalTimeSpent": 0,
+    "lastUpdated": "{{TIMESTAMP}}"
+  }
+}