@polymorphism-tech/morph-spec 8.43.0 → 8.45.0

package/framework/hooks/shared/comment-scanner.js

@@ -16,7 +16,7 @@ const PROCESS_CITATION = [
   /\bADR[-\s]?\d+/,
   /\bFR[-\s]?\d+/,
   /\bgate\s?[1-3]\b/i,
-  /\b(?:spec|mandate)\.md\b/i,
+  /\bspec\.md\b/i,
   /\bmockups?\b/i,
 ];
 

package/framework/hooks/shared/phase-utils.js

@@ -29,10 +29,8 @@ export const OUTPUT_PHASE_MAP = {
   uiComponents: 'uiux',
   uiFlows: 'uiux',
   spec: 'plan',
-  mandate: 'plan',
   tasks: 'plan',
   decisions: 'plan',
-  reuseMap: 'plan',
   usecases: 'plan',
   recap: 'implement',
   evidencias: 'implement',
@@ -49,10 +47,8 @@ export const FILENAME_TO_OUTPUT = {
   'components.md': 'uiComponents',
   'flows.md': 'uiFlows',
   'spec.md': 'spec',
-  'mandate.md': 'mandate',
   'tasks.json': 'tasks',
   'decisions.md': 'decisions',
-  'reuse-map.md': 'reuseMap',
   'recap.md': 'recap',
   'review-report.md': 'reviewReport',
   'evaluator-report.md': 'evaluatorReport',
@@ -65,7 +61,6 @@ export const PROTECTED_SPEC_FILES = {
   'components.md': 'uiux',
   'flows.md': 'uiux',
   'spec.md': 'plan',
-  'mandate.md': 'plan',
   'tasks.json': 'plan',
 };
 

package/framework/hooks/shared/stdin-reader.js

@@ -1,26 +1,26 @@
-/**
- * Shared stdin reader for Claude Code hooks.
- *
- * Reads JSON payload from stdin (provided by Claude Code to hooks).
- * Returns parsed object or null on failure.
- */
-
-/**
- * Read and parse JSON from stdin
- * @returns {Promise<Object|null>} Parsed JSON or null
- */
-export function readStdin() {
-  return new Promise((resolve) => {
-    let input = '';
-    process.stdin.setEncoding('utf-8');
-    process.stdin.on('data', (chunk) => { input += chunk; });
-    process.stdin.on('end', () => {
-      try {
-        resolve(JSON.parse(input || '{}'));
-      } catch {
-        resolve(null);
-      }
-    });
-    process.stdin.on('error', () => resolve(null));
-  });
-}
+/**
+ * Shared stdin reader for Claude Code hooks.
+ *
+ * Reads JSON payload from stdin (provided by Claude Code to hooks).
+ * Returns parsed object or null on failure.
+ */
+
+/**
+ * Read and parse JSON from stdin
+ * @returns {Promise<Object|null>} Parsed JSON or null
+ */
+export function readStdin() {
+  return new Promise((resolve) => {
+    let input = '';
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', (chunk) => { input += chunk; });
+    process.stdin.on('end', () => {
+      try {
+        resolve(JSON.parse(input || '{}'));
+      } catch {
+        resolve(null);
+      }
+    });
+    process.stdin.on('error', () => resolve(null));
+  });
+}

package/framework/phases.json

@@ -42,13 +42,12 @@
       "displayName": "Plan",
       "goals": [
         "Write spec.md (technical spec)",
-        "Write mandate.md (implementation contract with stack defaults + forbidden patterns)",
         "Write tasks.json (ordered task breakdown)"
       ],
-      "requiredOutputs": ["spec", "mandate", "tasks"],
+      "requiredOutputs": ["spec", "tasks"],
       "optionalOutputs": ["decisions"],
       "pausePoints": [
-        { "id": "plan", "label": "Gate 2 — Approve spec + mandate + tasks" }
+        { "id": "plan", "label": "Gate 2 — Approve spec + tasks" }
       ],
       "skill": "morph-plan"
     },
@@ -59,7 +58,7 @@
       "displayName": "Implementation",
       "goals": [
         "Execute tasks in order with auto-advance between tasks",
-        "Apply morph-eval after each task",
+        "Advance a task only on verify green and its doneCriteria met",
         "Maintain recap.md and execution trace"
       ],
       "requiredOutputs": ["recap"],
@@ -73,8 +72,7 @@
       "folder": "4-review",
       "displayName": "Review",
       "goals": [
-        "Verify implementation against mandate",
-        "Apply morph-eval at phase scope to produce dimension scores",
+        "Independent evaluator verdict (SHIP/FIX) with evidence-typed blockers",
         "Produce review-report.md and present Gate 3"
       ],
       "requiredOutputs": ["reviewReport"],

package/framework/rubrics/backend.json

@@ -1,7 +1,7 @@
 {
   "id": "backend",
   "version": "1.1.0",
-  "description": "Backend-focused rubric. Higher weight on architecture, security, and package health. Deterministic-validator rubric — approve threshold aligned to the single bar 9 from MORPH.md §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,

package/framework/rubrics/default.json

@@ -1,7 +1,7 @@
 {
   "id": "default",
   "version": "1.1.0",
-  "description": "Default rubric for general-purpose projects. Balanced weights across all categories. Deterministic-validator rubric — approve threshold aligned to the single bar 9 from MORPH.md §0 (the LLM eval rubrics live in framework/evals/rubrics/*.md).",
+  "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,

package/framework/rubrics/frontend.json

@@ -1,7 +1,7 @@
 {
   "id": "frontend",
   "version": "1.1.0",
-  "description": "Frontend-focused rubric. Higher weight on design system compliance and UI quality. Deterministic-validator rubric — approve threshold aligned to the single bar 9 from MORPH.md §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,

package/framework/rules/ai-agents-standards.md

@@ -50,6 +50,7 @@ stacks:
 | `ai-agents/conversational-agent-with-phases.md` | conversa com fases no turno — allow-list de tools, `ChatToolMode`, teto de tool calls |
 | `ai-agents/guardrails.md` | regra proibida vira código — guard de tool, pertinência, argumento não confiável, fail-open |
 | `ai-agents/testing-ai.md` | testar agente sem rede — `IChatClient` fake, harness de turno, golden de prompt |
+| `ai-agents/tool-adapters.md` | tool de agente que carrega regra de negócio — a regra em `*Ops` com desfecho tipado, o texto do modelo no adaptador, teste em duas camadas e migração neutra |
 | `ai-agents/evals-with-cache.md` | eval de modelo/prompt no CI **sem credencial e sem rede**: cache de respostas commitada, dataset versionado, o que entra na chave de cache, troca de modelo e regressão de prompt |
 | `ai-agents/cost-and-budget.md` | custo em dinheiro — `UsageCostMiddleware`, tarifa por token, teto de orçamento |
 | `ai-agents/llm-runtime-defaults.md` | knobs de runtime da chamada — timeout, retry, `strict` JSON schema, temperatura/reasoning |

package/framework/rules/morph-workflow.md

@@ -15,7 +15,7 @@ stacks:
 
 1. **Proposal** — Problem statement + scope + risks (`0-proposal/proposal.md`). No acceptance criteria: verifiable behaviour lives in the use cases.
 2. **UI/UX Design** (optional, UI-heavy) — Design system + mockups + flows. The phase id is `uiux` (that is the gate name); the folder is `1-design/`
-3. **Plan** — Use cases first, then technical spec + mandate + tasks (`2-plan/usecases/UC-{nn}-{slug}.md`, `spec.md`, `mandate.md`, `tasks.json`). Each use case post-condition must be observable in a test and reaches the task's `doneCriteria` verbatim.
+3. **Plan** — Use cases first, then technical spec + tasks (`2-plan/usecases/UC-{nn}-{slug}.md`, `spec.md`, `tasks.json`). Each use case post-condition must be observable in a test and reaches the task's `doneCriteria` verbatim.
 4. **Implement** — Code + recap (`3-implement/recap.md`)
 5. **Review** — Review report + Gate 3 (`4-review/review-report.md`)
 
@@ -72,7 +72,7 @@ All outputs go in `.morph/features/{feature}/`:
 |-------|------|
 | Proposal | `0-proposal/proposal.md`, `stack-scan.md` |
 | Design (optional) | `1-design/design-system.md`, `mockups.md`, `components.md`, `flows.md` |
-| Plan | `2-plan/spec.md`, `mandate.md`, `tasks.json`, `decisions.md` |
+| Plan | `2-plan/usecases/`, `spec.md`, `tasks.json`, `decisions.md` |
 | Implement | `3-implement/recap.md` + source code; `3-implement/evidencias/{taskId}.md` (condicional — task cujo `doneCriteria` julga saída de LLM) |
 | Review | `4-review/review-report.md` |
 
@@ -206,8 +206,8 @@ here would put a second, staler copy in permanent context:
 
 | Concern | Where it actually lives |
 |---------|-------------------------|
-| How many tests to write | The test budget copied into the feature's `mandate.md`: one test per postcondition, same-behavior cases in one table, no test that only pins text |
-| Verifying a task before `status: "done"` | `morph-spec verify {feature} [task]` (build + tests + validators + e2e), then the `morph-eval` skill for the 0-10 score |
+| How many tests to write | The test budget in `morph-plan` §5: one test per postcondition, same-behavior cases in one table, no test that only pins text |
+| Verifying a task before `status: "done"` | `morph-spec verify {feature} [task]` (build + tests + validators + e2e) green, and each `doneCriteria` with the test or `file:line` that proves it |
 | Parallel dispatch | `morph-spec dag {feature}` decides sequential vs parallel; execution and isolation rules are in `morph-apply` §2/§3b |
 | Closing the phase / opening the PR | `morph-review` for Gate 3, then `morph-spec finish {feature} --pr\|--merge` |
 
@@ -215,7 +215,7 @@ here would put a second, staler copy in permanent context:
 
 ## Scope Escalation
 
-The plan contract frozen at Gate 2 — `spec.md`, `mandate.md`, and the immutable `tasks.json`
+The plan contract frozen at Gate 2 — `spec.md` and the immutable `tasks.json`
 fields listed in `morph-task-tracking.md` — is enforced by the `protect-spec-files` hook. When a
 task turns out to be bigger than estimated, three different situations resolve three different ways:
 
@@ -225,7 +225,7 @@ task turns out to be bigger than estimated, three different situations resolve t
 | **Error of fact**: the spec asserts something about the code that the code contradicts, with no scope change | Append an `## Errata` block at the END of the file. Body untouched, append-only, accepted by `protect-spec-files` **without revoking the gate** — freezing the CONTRACT is not freezing an ERROR OF FACT (MORPH.md §3) |
 | **The scope itself changed**: the contract no longer describes the work | `morph-spec unapprove {feature} plan --reason "..."`, amend the plan, then re-approve. There is no shortcut around the gate for this one |
 
-Scope ambiguity the `mandate.md` does not cover is **not** an escalation: record it in
+Scope ambiguity the plan does not cover is **not** an escalation: record it in
 `decisions.md`, resolve it the conservative way, and keep going — only pause if it is genuinely
 blocking (`morph-implement` §5).
 

package/framework/schemas/feature.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "MORPH-SPEC feature.json",
-  "description": "Canonical shape of the authoritative, committed per-feature state at .morph/features/{feature}/feature.json (v5 per-feature state model). Born via `morph-spec create` (explicit) or the state-sync hook (implicit fallback). Server-side writers: `morph-spec approve/advance` (approvalGates), `morph-spec score` (taskScores), `morph-spec gate-decision` (gateDecisions), `morph-spec archive`/`finish` (status/archivedAt — `finish` archives internally before integrating). Never hand-edit the CLI-owned fields — manual Edits collide with the state-sync hook. This schema is documentational: additionalProperties stays true so older/newer CLIs interoperate.",
+  "description": "Canonical shape of the authoritative, committed per-feature state at .morph/features/{feature}/feature.json (v5 per-feature state model). Born via `morph-spec create` (explicit) or the state-sync hook (implicit fallback). Server-side writers: `morph-spec approve/advance` (approvalGates), `morph-spec gate-decision` (gateDecisions), `morph-spec archive`/`finish` (status/archivedAt — `finish` archives internally before integrating). Never hand-edit the CLI-owned fields — manual Edits collide with the state-sync hook. This schema is documentational: additionalProperties stays true so older/newer CLIs interoperate.",
   "type": "object",
   "required": ["status", "approvalGates"],
   "properties": {
@@ -57,7 +57,7 @@
           "reason": { "type": "string", "description": "The signal that drove the decision (or 'nenhum sinal de risco')." },
           "signals": {
             "type": "object",
-            "description": "Risk signals evaluated (free-form): taskCount, evalScore, standardsViolations, designSystemDivergence..."
+            "description": "Risk signals evaluated (free-form): taskCount, evaluatorVerdict, standardsViolations, designSystemDivergence..."
           },
           "trust": { "type": "string", "enum": ["auto", "manual"] },
           "decidedAt": { "type": "string", "format": "date-time" },
@@ -69,32 +69,6 @@
         "additionalProperties": false
       }
     },
-    "taskScores": {
-      "type": "object",
-      "description": "Per-task eval scores, written ONLY by `morph-spec score` (updatedAt is server-side; attempts auto-increment; bestScore is kept).",
-      "propertyNames": { "pattern": "^T\\d+$" },
-      "additionalProperties": {
-        "type": "object",
-        "required": ["lastScore", "bestScore", "attempts", "updatedAt"],
-        "properties": {
-          "lastScore": { "type": "number", "minimum": 0, "maximum": 10 },
-          "bestScore": { "type": "number", "minimum": 0, "maximum": 10 },
-          "attempts": { "type": "integer", "minimum": 1 },
-          "dimensions": {
-            "type": "object",
-            "properties": {
-              "architecture": { "type": "number", "minimum": 0, "maximum": 10 },
-              "contracts": { "type": "number", "minimum": 0, "maximum": 10 },
-              "codeQuality": { "type": "number", "minimum": 0, "maximum": 10 },
-              "testCoverage": { "type": "number", "minimum": 0, "maximum": 10 }
-            },
-            "additionalProperties": false
-          },
-          "updatedAt": { "type": "string", "format": "date-time" }
-        },
-        "additionalProperties": false
-      }
-    },
     "taskVerifications": {
       "type": "object",
       "description": "Deterministic verify results per task, written ONLY by `morph-spec verify` (task scope). updatedAt is server-side; attempts auto-increment. Persisted only from the primary root or the feature's own registered worktree — see verify.js decidePersistence().",

package/framework/schemas/tasks.schema.json

@@ -38,7 +38,7 @@
           },
           "reuse": {
             "type": "array",
-            "description": "Veredito de reuso por conceito que ESTA task introduz, carimbado por morph-plan a partir do 2-plan/reuse-map.md. Optional. Part of the plan contract: frozen after Gate 2. A justificativa de um CRIAR mora no reuse-map.md, nunca aqui — duas verdades do mesmo fato divergem.",
+            "description": "Veredito de reuso por conceito que ESTA task introduz, carimbado por morph-plan. Optional. Part of the plan contract: frozen after Gate 2.",
             "items": {
               "type": "object",
               "required": ["concept", "verdict"],
@@ -51,11 +51,15 @@
                 "verdict": {
                   "type": "string",
                   "enum": ["REUSAR", "ESTENDER", "CRIAR"],
-                  "description": "REUSAR: usar o que existe. ESTENDER: partir do que existe. CRIAR: nada cobre o caso — exige justificativa de uma linha no reuse-map.md."
+                  "description": "REUSAR: usar o que existe. ESTENDER: partir do que existe. CRIAR: nada cobre o caso — exige `why`."
                 },
                 "target": {
                   "type": "string",
                   "description": "Path (ou path:símbolo) do que será reusado/estendido. Vazio ou ausente em CRIAR."
+                },
+                "why": {
+                  "type": "string",
+                  "description": "Uma linha: por que nada existente cobre o caso. Exigido em CRIAR."
                 }
               },
               "additionalProperties": false

package/framework/skills/README.md

@@ -14,9 +14,8 @@ These are the only skills the harness needs. MORPH.md references them by path.
 |----------------------|----------------------------------------------------------------------|----------------|
 | `morph-brainstorming` | Business understanding + brownfield scan → proposal.md (Gate 1)     | yes            |
 | `morph-stack-scan`    | Detect stack drift in existing projects, report in stack-scan.md     | yes            |
-| `morph-plan`          | Produce spec.md + mandate.md + tasks.json (Gate 2)                   | yes            |
+| `morph-plan`          | Produce use cases + spec.md + tasks.json (Gate 2)                   | yes            |
 | `morph-implement`     | Execute each task with standard + persona, auto-advance between tasks| no             |
-| `morph-eval`          | Score work 0-10 across 4 dimensions, silence on score >= 9           | no             |
 | `morph-review`        | Final review report with scores + recommendation (Gate 3)            | yes            |
 | `morph-standards`     | Locate and load a specific standard on demand                        | no             |
 

package/framework/skills/core/create-umbraco-lp/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a criação de uma landing page nova ponta-a-ponta a partir do
 version: core
 when-to-invoke: ao iniciar um novo projeto de LP com o template Umbraco genérico
 user-invokable: true
-cliVersion: "8.43.0"
+cliVersion: "8.45.0"
 stacks:
   - umbraco
 ---

package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md

@@ -4,7 +4,7 @@ description: Migra uma landing page existente (React/Vite, Next.js estático ou
 version: core
 when-to-invoke: ao receber instrução "use /migrate-lp-to-umbraco {projeto}" do usuário, ou quando o usuário descrever necessidade de migrar uma LP para Umbraco
 user-invokable: true
-cliVersion: "8.43.0"
+cliVersion: "8.45.0"
 stacks:
   - umbraco
 ---