@polymorphism-tech/morph-spec 8.45.0 → 8.47.0

package/framework/commands/commit.md

@@ -1,166 +0,0 @@
----
-allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git diff:*), Bash(git log:*)
-argument-hint: [message] | --no-verify | --amend
-description: Create well-formatted commits with conventional commit format and emoji
----
-
-# Smart Git Commit
-
-Create well-formatted commit: $ARGUMENTS
-
-## Current Repository State
-
-- Git status: !git status --porcelain
-- Current branch: !git branch --show-current
-- Staged changes: !git diff --cached --stat
-- Unstaged changes: !git diff --stat
-- Recent commits: !git log --oneline -5
-
-## What This Command Does
-
-1. Unless specified with --no-verify, automatically runs pre-commit checks:
-   - pnpm lint to ensure code quality
-   - pnpm build to verify the build succeeds
-   - pnpm generate:docs to update documentation
-2. Checks which files are staged with git status
-3. If 0 files are staged, automatically adds all modified and new files with git add
-4. Performs a git diff to understand what changes are being committed
-5. Analyzes the diff to determine if multiple distinct logical changes are present
-6. If multiple distinct changes are detected, suggests breaking the commit into multiple smaller commits
-7. For each commit (or the single commit if not split), creates a commit message using emoji conventional commit format
-
-## Best Practices for Commits
-
-- **Verify before committing**: Ensure code is linted, builds correctly, and documentation is updated
-- **Atomic commits**: Each commit should contain related changes that serve a single purpose
-- **Split large changes**: If changes touch multiple concerns, split them into separate commits
-- **Conventional commit format**: Use the format <type>: <description> where type is one of:
-  - feat: A new feature
-  - fix: A bug fix
-  - docs: Documentation changes
-  - style: Code style changes (formatting, etc)
-  - refactor: Code changes that neither fix bugs nor add features
-  - perf: Performance improvements
-  - test: Adding or fixing tests
-  - chore: Changes to the build process, tools, etc.
-- **Present tense, imperative mood**: Write commit messages as commands (e.g., "add feature" not "added feature")
-- **Concise first line**: Keep the first line under 72 characters
-- **Emoji**: Each commit type is paired with an appropriate emoji:
-  - ✨ feat: New feature
-  - 🐛 fix: Bug fix
-  - 📝 docs: Documentation
-  - 💄 style: Formatting/style
-  - ♻️ refactor: Code refactoring
-  - ⚡️ perf: Performance improvements
-  - ✅ test: Tests
-  - 🔧 chore: Tooling, configuration
-  - 🚀 ci: CI/CD improvements
-  - 🗑️ revert: Reverting changes
-  - 🧪 test: Add a failing test
-  - 🚨 fix: Fix compiler/linter warnings
-  - 🔒️ fix: Fix security issues
-  - 👥 chore: Add or update contributors
-  - 🚚 refactor: Move or rename resources
-  - 🏗️ refactor: Make architectural changes
-  - 🔀 chore: Merge branches
-  - 📦️ chore: Add or update compiled files or packages
-  - ➕ chore: Add a dependency
-  - ➖ chore: Remove a dependency
-  - 🌱 chore: Add or update seed files
-  - 🧑‍💻 chore: Improve developer experience
-  - 🧵 feat: Add or update code related to multithreading or concurrency
-  - 🔍️ feat: Improve SEO
-  - 🏷️ feat: Add or update types
-  - 💬 feat: Add or update text and literals
-  - 🌐 feat: Internationalization and localization
-  - 👔 feat: Add or update business logic
-  - 📱 feat: Work on responsive design
-  - 🚸 feat: Improve user experience / usability
-  - 🩹 fix: Simple fix for a non-critical issue
-  - 🥅 fix: Catch errors
-  - 👽️ fix: Update code due to external API changes
-  - 🔥 fix: Remove code or files
-  - 🎨 style: Improve structure/format of the code
-  - 🚑️ fix: Critical hotfix
-  - 🎉 chore: Begin a project
-  - 🔖 chore: Release/Version tags
-  - 🚧 wip: Work in progress
-  - 💚 fix: Fix CI build
-  - 📌 chore: Pin dependencies to specific versions
-  - 👷 ci: Add or update CI build system
-  - 📈 feat: Add or update analytics or tracking code
-  - ✏️ fix: Fix typos
-  - ⏪️ revert: Revert changes
-  - 📄 chore: Add or update license
-  - 💥 feat: Introduce breaking changes
-  - 🍱 assets: Add or update assets
-  - ♿️ feat: Improve accessibility
-  - 💡 docs: Add or update comments in source code
-  - 🗃️ db: Perform database related changes
-  - 🔊 feat: Add or update logs
-  - 🔇 fix: Remove logs
-  - 🤡 test: Mock things
-  - 🥚 feat: Add or update an easter egg
-  - 🙈 chore: Add or update .gitignore file
-  - 📸 test: Add or update snapshots
-  - ⚗️ experiment: Perform experiments
-  - 🚩 feat: Add, update, or remove feature flags
-  - 💫 ui: Add or update animations and transitions
-  - ⚰️ refactor: Remove dead code
-  - 🦺 feat: Add or update code related to validation
-  - ✈️ feat: Improve offline support
-
-## Guidelines for Splitting Commits
-
-When analyzing the diff, consider splitting commits based on these criteria:
-
-1. **Different concerns**: Changes to unrelated parts of the codebase
-2. **Different types of changes**: Mixing features, fixes, refactoring, etc.
-3. **File patterns**: Changes to different types of files (e.g., source code vs documentation)
-4. **Logical grouping**: Changes that would be easier to understand or review separately
-5. **Size**: Very large changes that would be clearer if broken down
-
-## Examples
-
-Good commit messages:
-- ✨ feat: add user authentication system
-- 🐛 fix: resolve memory leak in rendering process
-- 📝 docs: update API documentation with new endpoints
-- ♻️ refactor: simplify error handling logic in parser
-- 🚨 fix: resolve linter warnings in component files
-- 🧑‍💻 chore: improve developer tooling setup process
-- 👔 feat: implement business logic for transaction validation
-- 🩹 fix: address minor styling inconsistency in header
-- 🚑️ fix: patch critical security vulnerability in auth flow
-- 🎨 style: reorganize component structure for better readability
-- 🔥 fix: remove deprecated legacy code
-- 🦺 feat: add input validation for user registration form
-- 💚 fix: resolve failing CI pipeline tests
-- 📈 feat: implement analytics tracking for user engagement
-- 🔒️ fix: strengthen authentication password requirements
-- ♿️ feat: improve form accessibility for screen readers
-
-Example of splitting commits:
-- First commit: ✨ feat: add new solc version type definitions
-- Second commit: 📝 docs: update documentation for new solc versions
-- Third commit: 🔧 chore: update package.json dependencies
-- Fourth commit: 🏷️ feat: add type definitions for new API endpoints
-- Fifth commit: 🧵 feat: improve concurrency handling in worker threads
-- Sixth commit: 🚨 fix: resolve linting issues in new code
-- Seventh commit: ✅ test: add unit tests for new solc version features
-- Eighth commit: 🔒️ fix: update dependencies with security vulnerabilities
-
-## Command Options
-
-- --no-verify: Skip running the pre-commit checks (lint, build, generate:docs)
-
-## Important Notes
-
-- By default, pre-commit checks (pnpm lint, pnpm build, pnpm generate:docs) will run to ensure code quality
-- If these checks fail, you'll be asked if you want to proceed with the commit anyway or fix the issues first
-- If specific files are already staged, the command will only commit those files
-- If no files are staged, it will automatically stage all modified and new files
-- The commit message will be constructed based on the changes detected
-- Before committing, the command will review the diff to identify if multiple commits would be more appropriate
-- If suggesting multiple commits, it will help you stage and commit the changes separately
-- Always reviews the commit diff to ensure the message matches the changes

package/framework/rubrics/backend.json

@@ -1,41 +0,0 @@
-{
-  "id": "backend",
-  "version": "1.1.0",
-  "description": "Backend-focused rubric. Higher weight on architecture, security, and package health. Deterministic-validator weights for the verify validators node; the score is informational — the node fails on validator errors.",
-  "categories": {
-    "functionality": {
-      "weight": 0.25,
-      "validators": ["contract-compliance"],
-      "description": "Core feature correctness and contract compliance"
-    },
-    "code_quality": {
-      "weight": 0.25,
-      "validators": ["architecture", "reuse", "code-budget"],
-      "description": "Architecture patterns, dependency direction, code structure, reuse of what the codebase already has, and comment and test budget"
-    },
-    "design_ui": {
-      "weight": 0.05,
-      "validators": ["design-system", "css", "contrast", "nextjs-component"],
-      "description": "Design system compliance (minimal weight for backend projects)"
-    },
-    "security": {
-      "weight": 0.15,
-      "validators": [],
-      "description": "Security posture (agent-evaluated, no automated validator)"
-    },
-    "packages": {
-      "weight": 0.20,
-      "validators": ["packages"],
-      "description": "Dependency health, version compatibility, and deprecated packages"
-    },
-    "maf_compliance": {
-      "weight": 0.10,
-      "validators": [],
-      "description": "MAF agent compliance (agent-evaluated, applies only when the feature touches AI agents): Microsoft.Agents.AI GA packages used; Model Registry alias referenced not hardcoded models; structured output for pipelined agents; prompts from DB not hardcoded; no Semantic Kernel; no hosted agent services."
-    }
-  },
-  "thresholds": {
-    "approve": 9.0,
-    "retry": 6.0
-  }
-}

package/framework/rubrics/default.json

@@ -1,36 +0,0 @@
-{
-  "id": "default",
-  "version": "1.1.0",
-  "description": "Default rubric for general-purpose projects. Balanced weights across all categories. Deterministic-validator weights for the verify validators node; the score is informational — the node fails on validator errors.",
-  "categories": {
-    "functionality": {
-      "weight": 0.30,
-      "validators": ["contract-compliance"],
-      "description": "Core feature correctness and contract compliance"
-    },
-    "code_quality": {
-      "weight": 0.25,
-      "validators": ["architecture", "reuse", "code-budget"],
-      "description": "Architecture patterns, code structure, reuse of what the codebase already has, and comment and test budget"
-    },
-    "design_ui": {
-      "weight": 0.15,
-      "validators": ["design-system", "css", "contrast", "nextjs-component"],
-      "description": "Design system compliance, CSS quality, and UI correctness"
-    },
-    "security": {
-      "weight": 0.15,
-      "validators": [],
-      "description": "Security posture (agent-evaluated, no automated validator)"
-    },
-    "packages": {
-      "weight": 0.15,
-      "validators": ["packages"],
-      "description": "Dependency health and compatibility"
-    }
-  },
-  "thresholds": {
-    "approve": 9.0,
-    "retry": 6.0
-  }
-}

package/framework/rubrics/frontend.json

@@ -1,36 +0,0 @@
-{
-  "id": "frontend",
-  "version": "1.1.0",
-  "description": "Frontend-focused rubric. Higher weight on design system compliance and UI quality. Deterministic-validator weights for the verify validators node; the score is informational — the node fails on validator errors.",
-  "categories": {
-    "functionality": {
-      "weight": 0.25,
-      "validators": ["contract-compliance"],
-      "description": "Core feature correctness and contract compliance"
-    },
-    "code_quality": {
-      "weight": 0.15,
-      "validators": ["architecture", "reuse", "code-budget"],
-      "description": "Architecture patterns, code structure, reuse of what the codebase already has, and comment and test budget"
-    },
-    "design_ui": {
-      "weight": 0.35,
-      "validators": ["design-system", "css", "contrast", "nextjs-component"],
-      "description": "Design system compliance, CSS quality, contrast ratios, and component correctness"
-    },
-    "security": {
-      "weight": 0.10,
-      "validators": [],
-      "description": "Security posture (agent-evaluated, no automated validator)"
-    },
-    "packages": {
-      "weight": 0.15,
-      "validators": ["packages"],
-      "description": "Dependency health and compatibility"
-    }
-  },
-  "thresholds": {
-    "approve": 9.0,
-    "retry": 6.0
-  }
-}

package/framework/templates/project/validate.js

@@ -1,97 +0,0 @@
-#!/usr/bin/env node
-
-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: [],
-};
-
-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,
-    };
-  }
-}
-
-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';
-
-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': {
-    results.issues.push({ level: 'info', message: `${validator} requires manual review` });
-    break;
-  }
-
-  default:
-    results.issues.push({ level: 'warning', message: `Unknown validator: ${validator}` });
-    break;
-}
-
-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/src/dashboard/app/pages/Rubrics.jsx

@@ -1,97 +0,0 @@
-import morphData from 'virtual:morph-data';
-import KnowledgeMarkdown from '../components/KnowledgeMarkdown.jsx';
-import { useSelection } from '../components/EntityLink.jsx';
-
-const DOCS = morphData.docs || { rubrics: [] };
-const CHECKLIST = DOCS.rubrics.find((r) => r.id === 'review-checklist');
-const VALIDATORS = morphData.rubrics || [];
-
-const GROUPS = [
-  { title: 'Avaliador do Gate 3', hint: 'veredito e bloqueadores com evidência', items: CHECKLIST ? [{ key: 'dim:review-checklist', title: CHECKLIST.title, doc: CHECKLIST }] : [] },
-  { title: 'Validadores determinísticos', hint: 'pesos por categoria no verify', items: VALIDATORS.map((v) => ({ key: `val:${v.id}`, title: `Rubrica ${v.id}`, validator: v })) },
-].filter((g) => g.items.length);
-
-const ALL = GROUPS.flatMap((g) => g.items);
-
-function ValidatorRubric({ v }) {
-  return (
-    <article className="prose-morph">
-      <h1>Rubrica {v.id}</h1>
-      {v.description && <p>{v.description}</p>}
-      <table>
-        <thead><tr><th>Categoria</th><th>Peso</th><th>Validadores</th><th>O que mede</th></tr></thead>
-        <tbody>
-          {Object.entries(v.categories).map(([name, c]) => (
-            <tr key={name}>
-              <td>{name}</td>
-              <td className="font-mono">{c.weight ?? '—'}</td>
-              <td className="font-mono text-xs">{(c.validators || []).join(', ') || '—'}</td>
-              <td>{c.description || ''}</td>
-            </tr>
-          ))}
-        </tbody>
-      </table>
-      <p>O score é informativo: o nó de validadores do verify reprova por erro de validador, não pelo número.</p>
-    </article>
-  );
-}
-
-export function RubricsView({ sel, onSel }) {
-  const current = ALL.find((i) => i.key === sel) || null;
-  return (
-    <div className="mx-auto max-w-7xl px-4 pb-24 pt-10 md:px-10 md:pt-14">
-      <header className="rise mb-8">
-        <h1 className="text-4xl font-semibold tracking-tight md:text-5xl">Rubricas</h1>
-        <p className="mt-3 max-w-2xl text-sm leading-relaxed text-[var(--color-dim)]">
-          Com o que o trabalho é julgado. O avaliador independente decide SHIP ou FIX, e só bloqueia com evidência de UC, teste, regressão ou segurança.
-          Os validadores rodam no <span className="font-mono text-[var(--color-fg)]">morph-spec verify</span>, sem modelo.
-        </p>
-      </header>
-      <div className="rise-2 grid gap-6 lg:grid-cols-[17rem_minmax(0,1fr)]">
-        <nav aria-label="Rubricas" className="lg:sticky lg:top-4 lg:self-start">
-          <button
-            type="button"
-            onClick={() => onSel(null)}
-            aria-current={!current ? 'page' : undefined}
-            className={['fluid mb-4 block w-full rounded-lg px-3 py-2 text-left text-sm transition-colors', !current ? 'bg-white/[0.08] text-[var(--color-fg)]' : 'text-[var(--color-dim)] hover:bg-white/[0.04]'].join(' ')}
-          >
-            Como o Gate 3 decide
-          </button>
-          {GROUPS.map((g) => (
-            <div key={g.title} className="mb-5">
-              <p className="px-3 text-xs text-[var(--color-faint)]">{g.title}</p>
-              <p className="mb-1.5 px-3 text-[11px] text-[var(--color-faint)]">{g.hint}</p>
-              <ul>
-                {g.items.map((i) => (
-                  <li key={i.key}>
-                    <button
-                      type="button"
-                      onClick={() => onSel(i.key)}
-                      aria-current={current?.key === i.key ? 'page' : undefined}
-                      className={['fluid block w-full truncate rounded-lg px-3 py-1.5 text-left text-sm transition-colors', current?.key === i.key ? 'bg-white/[0.08] text-[var(--color-fg)]' : 'text-[var(--color-dim)] hover:bg-white/[0.04] hover:text-[var(--color-fg)]'].join(' ')}
-                      title={i.title}
-                    >
-                      {i.title}
-                    </button>
-                  </li>
-                ))}
-              </ul>
-            </div>
-          ))}
-        </nav>
-        <div className="bezel min-w-0">
-          <div className="bezel-core min-w-0 px-6 py-8 md:px-12 md:py-10">
-            {!current && (CHECKLIST ? <KnowledgeMarkdown text={CHECKLIST.content} /> : <p className="text-sm text-[var(--color-dim)]">Escolha uma rubrica.</p>)}
-            {current?.doc && <KnowledgeMarkdown text={current.doc.content} />}
-            {current?.validator && <ValidatorRubric v={current.validator} />}
-          </div>
-        </div>
-      </div>
-    </div>
-  );
-}
-
-export default function Rubrics() {
-  const [sel, setSel] = useSelection();
-  return <RubricsView sel={sel} onSel={setSel} />;
-}

package/src/dashboard/scanner/rubrics-scanner.js

@@ -1,12 +0,0 @@
-import { readFileSync, readdirSync, existsSync } from 'fs';
-import { join } from 'path';
-
-export function scanRubrics(frameworkDir) {
-  const dir = join(frameworkDir, 'rubrics');
-  if (!existsSync(dir)) return [];
-  return readdirSync(dir).filter(f => f.endsWith('.json')).map(f => {
-    const d = JSON.parse(readFileSync(join(dir, f), 'utf8'));
-    return { id: d.id, version: d.version || '1.0.0', description: d.description || '',
-      categories: d.categories || {}, thresholds: d.thresholds || { approve: 9.0, retry: 6.0 } };
-  });
-}