@polymorphism-tech/morph-spec 4.8.19 → 4.9.0

package/framework/hooks/dev/validate-standard-format.js

@@ -1,73 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Dev PreToolUse Hook: Validate Standard Format
- *
- * Event: PreToolUse | Matcher: Write|Edit
- * Scope: Framework codebase only (dev hook)
- *
- * Validates that files written to framework/standards/ follow the required format:
- *   - `> **Scope:**` metadata header
- *   - `> **Layer:**` metadata header
- *   - `> **Keywords:**` metadata header
- *   - Footer: `*MORPH-SPEC by Polymorphism Tech*`
- *
- * Only validates on Write (full content). Edit operations pass through.
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readStdin } from '../shared/stdin-reader.js';
-import { getFilePath, getContentToValidate, isWriteOperation } from '../shared/payload-utils.js';
-import { block, pass } from '../shared/hook-response.js';
-
-try {
-  const payload = await readStdin();
-  if (!payload) pass();
-
-  const filePath = getFilePath(payload);
-  if (!filePath) pass();
-
-  // Only check framework/standards/**/*.md
-  if (!filePath.includes('framework/standards/')) pass();
-  if (!filePath.endsWith('.md')) pass();
-
-  // Skip non-standard files
-  const basename = filePath.split('/').pop();
-  if (basename === 'README.md') pass();
-  if (basename === 'STANDARDS.json') pass();
-
-  // Only validate full Write operations (not Edit patches)
-  if (!isWriteOperation(payload)) pass();
-
-  const content = getContentToValidate(payload);
-  if (!content) pass();
-
-  const missing = [];
-
-  if (!/>\s*\*\*Scope:\*\*/.test(content)) {
-    missing.push('> **Scope:** metadata header');
-  }
-  if (!/>\s*\*\*Layer:\*\*/.test(content)) {
-    missing.push('> **Layer:** metadata header');
-  }
-  if (!/>\s*\*\*Keywords:\*\*/.test(content)) {
-    missing.push('> **Keywords:** metadata header');
-  }
-  if (!/\*MORPH-SPEC by Polymorphism Tech\*/.test(content)) {
-    missing.push('Footer: *MORPH-SPEC by Polymorphism Tech*');
-  }
-
-  if (missing.length > 0) {
-    block(
-      `MORPH-SPEC: Standard file '${basename}' is missing required format elements:\n` +
-      missing.map(m => `  - ${m}`).join('\n') + '\n\n' +
-      'All framework standards must include Scope/Layer/Keywords metadata headers and the standard footer.'
-    );
-  }
-
-  pass();
-} catch {
-  // Fail-open
-  process.exit(0);
-}

package/framework/templates/meta-prompts/hops/hop-retry.md

@@ -1,78 +0,0 @@
-# HOP Retry — Attempt {{RETRY_COUNT}}/{{MAX_RETRIES}}
-
-You are retrying a previously failed task. This HOP provides failure context and adjusted guidance.
-
-## Retry Context
-- Feature: {{FEATURE_NAME}}
-- Agent: {{AGENT_ID}}
-- Attempt: {{RETRY_COUNT}} of {{MAX_RETRIES}}
-- Original task: {{TASK_ID}}
-
-## Previous Failure Analysis
-
-### What Failed
-{{FAILURE_DESCRIPTION}}
-
-### Error Details
-```
-{{ERROR_DETAILS}}
-```
-
-### What Was Tried
-{{PREVIOUS_ATTEMPTS}}
-
-## Adjusted Approach for This Attempt
-
-{{#if RETRY_COUNT == 1}}
-### First Retry: Minor Adjustments
-- Review the error message carefully
-- Check standards compliance (most common cause)
-- Verify file paths and imports
-- Try the same approach with the specific error fixed
-{{/if}}
-
-{{#if RETRY_COUNT == 2}}
-### Second Retry: Alternative Approach
-- The direct approach failed twice — try an alternative
-- Simplify: can you achieve the goal with less complexity?
-- Check if dependencies are available (imports, packages)
-- Consider a different implementation pattern
-{{/if}}
-
-{{#if RETRY_COUNT == 3}}
-### Final Retry: Escalation-Ready
-- This is the last automated attempt
-- Try the simplest possible implementation
-- If this fails, provide detailed diagnostic info for human escalation
-- Document exactly why each approach failed
-{{/if}}
-
-## Original Task
-{{ORIGINAL_TASK_DESCRIPTION}}
-
-## Constraints (Unchanged)
-{{CONSTRAINTS}}
-
-## How to Report
-
-If this attempt succeeds:
-```
-RETRY SUCCESS
-Attempt: {{RETRY_COUNT}}
-Fixed: [what you changed from previous attempt]
-Files: [created/modified]
-```
-
-If this attempt fails:
-```
-RETRY FAILED
-Attempt: {{RETRY_COUNT}}
-Error: [exact error message]
-Root cause hypothesis: [your analysis]
-Escalation needed: [what human decision is required]
-```
-
-{{#if RETRY_COUNT >= MAX_RETRIES}}
-## ⚠️ Final Attempt
-If this attempt fails, the task will be escalated to the user. Provide maximum diagnostic detail.
-{{/if}}

package/framework/templates/meta-prompts/hops/hop-validation.md

@@ -1,97 +0,0 @@
-# HOP Validation — {{VALIDATION_TYPE}}
-
-You are a **Validation Agent** running a focused review of work produced by another agent.
-
-## Validation Identity
-- Validator Type: {{VALIDATION_TYPE}}
-- Reviewing Agent: {{REVIEWED_AGENT}}
-- Feature: {{FEATURE_NAME}}
-- Checkpoint: {{CHECKPOINT_NUM}}
-
-## What to Validate
-
-### Files Under Review
-{{FILES_TO_REVIEW}}
-
-### Validation Criteria
-{{VALIDATION_CRITERIA}}
-
-## Validation Checklist
-
-{{#if IS_ARCHITECTURE}}
-### Architecture Validation
-- [ ] No DbContext injected directly in Blazor components (use IDbContextFactory)
-- [ ] Services registered in correct DI order
-- [ ] No async void (except event handlers)
-- [ ] Clean Architecture layers respected (no domain depending on infrastructure)
-- [ ] No circular dependencies between services
-- [ ] Repository pattern used for data access
-{{/if}}
-
-{{#if IS_SECURITY}}
-### Security Validation
-- [ ] No hardcoded secrets, passwords, API keys, or connection strings
-- [ ] All user inputs validated (FluentValidation or data annotations)
-- [ ] SQL queries use parameterization (no string interpolation in queries)
-- [ ] No XSS vulnerabilities (no raw HTML rendering of user input)
-- [ ] Authentication required on protected endpoints
-- [ ] Authorization checks in place (not just authentication)
-- [ ] Sensitive data not logged
-{{/if}}
-
-{{#if IS_DESIGN_SYSTEM}}
-### Design System Validation
-- [ ] Only CSS variables used (no hardcoded hex colors)
-- [ ] Spacing in multiples of 4px (4, 8, 12, 16, 24, 32, 48, 64)
-- [ ] Typography uses design tokens (`var(--font-size-*)`)
-- [ ] Components use design system components (Fluent UI / MudBlazor / shadcn)
-- [ ] No inline styles (unless required for dynamic values)
-- [ ] Responsive breakpoints used correctly
-{{/if}}
-
-{{#if IS_PACKAGES}}
-### Package Validation
-- [ ] No duplicate package references in .csproj
-- [ ] No version conflicts (NU1605/NU1608 warnings)
-- [ ] Azure.Identity explicitly specified (not transitively assumed)
-- [ ] All packages compatible with .NET 10
-- [ ] No deprecated packages used
-{{/if}}
-
-## Output Format
-
-Provide a structured validation report:
-
-```
-VALIDATION REPORT
-Type: {{VALIDATION_TYPE}}
-Feature: {{FEATURE_NAME}}
-Checkpoint: {{CHECKPOINT_NUM}}
-Status: [PASSED | FAILED | WARNING]
-
-Errors (block progress):
-- [list each error with file:line reference]
-
-Warnings (non-blocking):
-- [list each warning with recommendation]
-
-Passed Checks:
-- [list checks that passed]
-
-Files Reviewed: X
-Issues Found: Y errors, Z warnings
-```
-
-## Severity Levels
-
-| Severity | Meaning | Blocks Progress? |
-|----------|---------|-----------------|
-| `error` | Violates critical standard | ✅ Yes |
-| `warning` | Suboptimal but functional | ⚠️ No |
-| `info` | Suggestion for improvement | ℹ️ No |
-
-## Escalation
-If you find errors that require design decisions (not just fixes), flag with:
-```
-ESCALATION NEEDED: [description of decision required]
-```

package/framework/templates/meta-prompts/hops/hop-wrapper.md

@@ -1,36 +0,0 @@
-# HOP Wrapper — {{HOP_NAME}}
-
-This is a **Higher-Order Prompt (HOP)** that wraps another prompt with additional context and constraints.
-
-## Wrapped Prompt
-{{INNER_PROMPT}}
-
-## Additional Context Injected by HOP
-
-### Feature Context
-- Feature: {{FEATURE_NAME}}
-- Phase: {{PHASE}}
-- Agent: {{AGENT_ID}}
-
-### Standards Override
-{{#if STANDARDS_OVERRIDE}}
-For this execution, prioritize these standards over defaults:
-{{STANDARDS_OVERRIDE}}
-{{/if}}
-
-### Pre-Execution Checklist
-Before executing the wrapped prompt, verify:
-{{PRE_CONDITIONS}}
-
-### Post-Execution Checklist
-After executing the wrapped prompt, verify:
-{{POST_CONDITIONS}}
-
-## HOP Metadata
-- HOP Type: wrapper
-- Version: {{HOP_VERSION}}
-- Created: {{DATE}}
-- Applied to: {{AGENT_ID}}
-
-## Execution Note
-The agent receiving this HOP should execute the inner prompt with the additional context above applied throughout their work. The pre/post checklists are mandatory checkpoints.

package/framework/workflows/configs/design-impl.json

@@ -1,49 +0,0 @@
-{
-  "id": "design-impl",
-  "name": "Design Implementation (Prototype → Code)",
-  "description": "Convert HTML prototype or mockups to functional code",
-  "criteria": {
-    "hasPrototype": true,
-    "prototypeFormats": ["html", "figma", "mockups", "screenshots"]
-  },
-  "keywords": [
-    "prototipo",
-    "prototype",
-    "figma",
-    "html para",
-    "html to",
-    "convert html",
-    "converter design",
-    "convert design",
-    "replicar",
-    "replicate",
-    "from design",
-    "from mockup",
-    "mockup",
-    "screenshot",
-    "wireframe"
-  ],
-  "phases": {
-    "run": ["prototype-analysis", "tasks", "implement"],
-    "skip": ["proposal", "setup", "uiux", "design", "clarify", "sync"],
-    "combined": {
-      "prototype-analysis": ["proposal", "design"]
-    }
-  },
-  "pausePoints": [
-    {
-      "phase": "prototype-analysis",
-      "question": "Confirm HTML → CSS mapping?"
-    },
-    {
-      "phase": "tasks",
-      "question": "Approve screen implementation list?"
-    }
-  ],
-  "outputs": {
-    "required": ["recap.md"],
-    "optional": ["design-system.css"],
-    "skip": ["proposal.md", "spec.md", "contracts.cs"]
-  },
-  "priority": 1
-}

package/framework/workflows/configs/express.json

@@ -1,45 +0,0 @@
-{
-  "id": "express",
-  "name": "Express (Backend Focus)",
-  "description": "Streamlined workflow for backend changes - skips UI/UX and Clarify phases",
-  "criteria": {
-    "maxFiles": 20,
-    "maxLines": 500,
-    "maxComponents": 0,
-    "noInfrastructure": false,
-    "noArchitecturalDecisions": false
-  },
-  "keywords": [
-    "api",
-    "endpoint",
-    "service",
-    "repository",
-    "migration",
-    "background job",
-    "integration",
-    "backend",
-    "data",
-    "queue",
-    "webhook"
-  ],
-  "phases": {
-    "run": ["proposal", "setup", "design", "tasks", "implement"],
-    "skip": ["uiux", "clarify", "sync"],
-    "combined": {}
-  },
-  "pausePoints": [
-    {
-      "phase": "design",
-      "question": "Approve spec and contracts before task breakdown?"
-    },
-    {
-      "phase": "tasks",
-      "question": "Approve task breakdown before implementation?"
-    }
-  ],
-  "outputs": {
-    "required": ["proposal", "spec", "contracts", "tasks"],
-    "optional": ["schema-analysis", "decisions", "recap"]
-  },
-  "priority": 3
-}

package/framework/workflows/configs/fast-track.json

@@ -1,42 +0,0 @@
-{
-  "id": "fast-track",
-  "name": "Fast Track (Trivial)",
-  "description": "Quick fixes, small bugs, CSS tweaks - minimal overhead",
-  "criteria": {
-    "maxFiles": 3,
-    "maxLines": 50,
-    "maxComponents": 0,
-    "noInfrastructure": true,
-    "noArchitecturalDecisions": true
-  },
-  "keywords": [
-    "bug",
-    "fix",
-    "corrigir",
-    "ajustar",
-    "hotfix",
-    "edge case",
-    "cor",
-    "css",
-    "typo",
-    "correction"
-  ],
-  "phases": {
-    "run": ["quick-analysis", "implement"],
-    "skip": ["proposal", "setup", "uiux", "design", "clarify", "tasks", "sync"],
-    "combined": {
-      "quick-analysis": ["proposal", "setup", "design"]
-    }
-  },
-  "pausePoints": [
-    {
-      "phase": "quick-analysis",
-      "question": "Approve or adjust solution?"
-    }
-  ],
-  "outputs": {
-    "required": [],
-    "optional": ["commit-message"]
-  },
-  "priority": 1
-}

package/framework/workflows/configs/full-morph.json

@@ -1,79 +0,0 @@
-{
-  "id": "full-morph",
-  "name": "Full MORPH (High Complexity)",
-  "description": "Complete system features - all phases mandatory, strategic decisions",
-  "criteria": {
-    "minFiles": 10,
-    "minLines": 500,
-    "minComponents": 3,
-    "infrastructure": true,
-    "architecturalDecisions": true
-  },
-  "keywords": [
-    "sistema",
-    "system",
-    "autenticação",
-    "authentication",
-    "integração",
-    "integration",
-    "integrate",
-    "pattern",
-    "cqrs",
-    "subsistema",
-    "subsystem",
-    "architecture",
-    "infraestrutura",
-    "infrastructure",
-    "complete",
-    "completo",
-    "complex",
-    "complexo",
-    "full",
-    "entire"
-  ],
-  "phases": {
-    "run": ["context", "proposal", "setup", "uiux", "design", "clarify", "tasks", "implement", "sync"],
-    "skip": [],
-    "combined": {}
-  },
-  "pausePoints": [
-    {
-      "phase": "proposal",
-      "question": "Approve proposal? (3 items: 1 action + 1 question + 1 suggestion)"
-    },
-    {
-      "phase": "uiux",
-      "question": "Approve wireframes/UI design system?",
-      "condition": "hasUIAgents"
-    },
-    {
-      "phase": "design",
-      "question": "Approve complete spec + contracts + decisions?"
-    },
-    {
-      "phase": "tasks",
-      "question": "Approve task breakdown with dependencies?"
-    },
-    {
-      "phase": "sync",
-      "question": "Approve promotion of decisions to project standards?"
-    }
-  ],
-  "outputs": {
-    "required": [
-      "proposal.md",
-      "ui-design-system.md",
-      "ui-mockups.md",
-      "ui-components.md",
-      "ui-flows.md",
-      "spec.md",
-      "contracts.cs",
-      "tasks.json",
-      "decisions.md",
-      "recap.md"
-    ],
-    "optional": [],
-    "skip": []
-  },
-  "priority": 3
-}

package/framework/workflows/configs/fusion.json

@@ -1,39 +0,0 @@
-{
-  "id": "fusion",
-  "name": "Fusion Workflow (F-Thread)",
-  "description": "Run N agents in parallel, aggregate results using best-of-n or consensus strategy",
-  "priority": 3,
-  "keywords": [
-    "uncertainty", "uncertain", "critical decision", "compare approaches",
-    "best approach", "prototype", "explore options", "which is better",
-    "not sure how", "multiple solutions", "benchmark", "evaluate options",
-    "decision point", "architecture decision"
-  ],
-  "criteria": {
-    "minFiles": 1,
-    "maxFiles": 20
-  },
-  "phases": {
-    "run": ["proposal", "design", "implement", "sync"],
-    "skip": ["setup", "uiux", "clarify", "tasks"]
-  },
-  "threadType": "fusion",
-  "execution": {
-    "agentCount": 3,
-    "strategy": "best-of-n",
-    "aggregation": {
-      "best-of-n": {
-        "scoringCriteria": ["completeness", "checkpoint_compliance", "code_quality"],
-        "selectTop": 1
-      },
-      "consensus": {
-        "mergeOverlapping": true
-      },
-      "manual-select": {
-        "presentAll": true,
-        "requireUserChoice": true
-      }
-    }
-  },
-  "outputs": ["proposal.md", "decisions.md", "fusion-results.md"]
-}

package/framework/workflows/configs/long-running.json

@@ -1,33 +0,0 @@
-{
-  "id": "long-running",
-  "name": "Long-Running Workflow (L-Thread)",
-  "description": "Autonomous implementation with stop hooks every 30 minutes for validation",
-  "priority": 3,
-  "keywords": [
-    "autonomous", "large scope", "full system", "end to end", "e2e",
-    "complete implementation", "no interruption", "long running", "unattended",
-    "extended", "batch", "automated", "hands-off", "without interruption"
-  ],
-  "criteria": {
-    "minFiles": 10
-  },
-  "phases": {
-    "run": ["proposal", "design", "tasks", "implement", "sync"],
-    "skip": ["setup", "uiux", "clarify"]
-  },
-  "threadType": "long-running",
-  "execution": {
-    "stopHooks": {
-      "enabled": true,
-      "intervalMinutes": 30,
-      "maxRetries": 5,
-      "hooks": ["validate-and-continue", "validate-checkpoints"],
-      "onFailure": "provide-feedback-and-continue"
-    },
-    "checkpoints": {
-      "frequency": 3,
-      "blockOnFailure": true
-    }
-  },
-  "outputs": ["proposal.md", "spec.md", "tasks.json", "decisions.md", "recap.md"]
-}

package/framework/workflows/configs/spec-only.json

@@ -1,43 +0,0 @@
-{
-  "id": "spec-only",
-  "name": "Spec Only (Documentation)",
-  "description": "Documentation-driven workflow - produces specs and plans without implementation",
-  "criteria": {
-    "maxFiles": 0,
-    "maxLines": 0,
-    "maxComponents": 0,
-    "noInfrastructure": false,
-    "noArchitecturalDecisions": false
-  },
-  "keywords": [
-    "spec",
-    "specification",
-    "document",
-    "plan",
-    "architecture",
-    "design",
-    "rfc",
-    "proposal",
-    "planning"
-  ],
-  "phases": {
-    "run": ["proposal", "setup", "uiux", "design", "clarify", "tasks"],
-    "skip": ["implement", "sync"],
-    "combined": {}
-  },
-  "pausePoints": [
-    {
-      "phase": "design",
-      "question": "Approve technical specification?"
-    },
-    {
-      "phase": "tasks",
-      "question": "Approve task breakdown? (Implementation will not be executed)"
-    }
-  ],
-  "outputs": {
-    "required": ["proposal", "spec", "contracts", "decisions", "tasks"],
-    "optional": ["schema-analysis", "clarifications", "ui-design-system", "ui-mockups"]
-  },
-  "priority": 5
-}

package/framework/workflows/configs/ui-refresh.json

@@ -1,49 +0,0 @@
-{
-  "id": "ui-refresh",
-  "name": "UI Refresh (Visual Redesign)",
-  "description": "Visual changes only - no business logic modifications",
-  "criteria": {
-    "hasExistingPages": true,
-    "onlyVisualChanges": true,
-    "noBusinessLogic": true,
-    "noInfrastructure": true
-  },
-  "keywords": [
-    "redesign",
-    "redesenhar",
-    "bonito",
-    "estetica",
-    "aesthetic",
-    "modernizar",
-    "modernize",
-    "restyling",
-    "refresh visual",
-    "refresh ui",
-    "make prettier",
-    "look better"
-  ],
-  "phases": {
-    "run": ["visual-analysis", "design-system", "implement"],
-    "skip": ["proposal", "setup", "uiux", "clarify", "tasks", "sync"],
-    "combined": {
-      "visual-analysis": ["proposal", "design"],
-      "design-system": ["uiux"]
-    }
-  },
-  "pausePoints": [
-    {
-      "phase": "visual-analysis",
-      "question": "Choose aesthetic direction?"
-    },
-    {
-      "phase": "design-system",
-      "question": "Approve CSS components checklist?"
-    }
-  ],
-  "outputs": {
-    "required": ["design-refresh-checklist.md", "design-system.css", "recap.md"],
-    "optional": [],
-    "skip": ["proposal.md", "spec.md", "contracts.cs", "tasks.json"]
-  },
-  "priority": 2
-}