@polymorphism-tech/morph-spec 8.44.0 → 8.46.0

package/src/lib/validators/reuse/reuse-validator.js

@@ -3,8 +3,8 @@
  *
  * A terceira camada do ciclo de reuso, no molde do `design-system-validator`:
  *
- *   PROSA (morph-plan §1c, personas)  ──►  ARTEFATO (2-plan/reuse-map.md,
- *   `reuse` em tasks.json)  ──►  COBRANÇA (este arquivo)
+ *   PROSA (morph-plan, personas)  ──►  ARTEFATO (`reuse` em tasks.json)
+ *   ──►  COBRANÇA (este arquivo)
  *
  * Prosa sozinha não segura — `morph-brainstorming/SKILL.md:39` já manda olhar
  * o que existe, e o ProspectPRO redefiniu `SimpleBuilding` em cinco arquivos da
@@ -21,8 +21,8 @@
  *   3. Mesma feature = achado (`error`); feature diferente = aviso
  *      (`warning`), porque VSA prescreve DTO homônimo entre slices.
  *   4. Veredito `CRIAR` declarado no plano (tasks.json `reuse`) rebaixa o
- *      achado a aviso: a decisão foi tomada no Gate 2, com justificativa no
- *      reuse-map. O validador cobra a decisão AUSENTE, não a decisão tomada.
+ *      achado a aviso: a decisão foi tomada no Gate 2, com justificativa em
+ *      `why`. O validador cobra a decisão AUSENTE, não a decisão tomada.
  *
  * Sem grafo o validador não roda (ADR-002: ausência de grafo nunca bloqueia).
  *
@@ -155,7 +155,7 @@ export function findDuplicateSymbols(declarations, existing, opts = {}) {
         ? `Reuse ou estenda o tipo existente em vez de redeclarar. Confirme com ` +
           `\`morph-spec graph explain ${decls[0].name}\` (sem grafo: ` +
           `\`grep -rn "${decls[0].name}"\`) e, se a criação for mesmo necessária, ` +
-          `registre o veredito CRIAR com justificativa no reuse-map da feature.`
+          'registre o veredito CRIAR com a justificativa em "why" no tasks[].reuse da task.'
         : `VSA tolera DTO homônimo entre slices — confirme que são conceitos ` +
           `diferentes e não a mesma coisa escrita duas vezes.`,
     });
@@ -170,9 +170,7 @@ export function findDuplicateSymbols(declarations, existing, opts = {}) {
 /**
  * Vereditos de reuso carimbados no plano: `tasks[].reuse[]`.
  *
- * Ler do `tasks.json` — e não do `reuse-map.md` — é deliberado: o veredito é
- * um dado estruturado, e o markdown existe para o humano ler no Gate 2. Duas
- * leituras do mesmo fato, cada uma na forma certa para o seu consumidor.
+ * O veredito mora só no `tasks.json`: dado estruturado, lido aqui e no Gate 2.
  *
  * @param {string} projectPath
  * @param {string} featureName

package/src/lib/validators/verify-runner.js

@@ -4,7 +4,7 @@
  * v8 adds a DETERMINISTIC verification node that runs BEFORE the LLM judge
  * in the per-task loop: build + tests + validators (code, free) first; the
  * LLM judge is only invoked once verify passes. This is a BINARY gate
- * (pass/fail per node), NOT a second "bar 9" — the bar 9 remains morph-eval's.
+ * (pass/fail per node).
  *
  * The `e2e` node closes the last gap in that chain: build proves the code
  * COMPILES, tests prove units behave, validators read structure — none of

package/src/scripts/setup-infra.js

@@ -346,7 +346,7 @@ export async function setupInfra(targetPath, {
 
   // --- 7c. Copy framework/evals → .morph/framework/evals ---
   // Rubricas .md (bandas 0-10) + trace-schema.md — referenciadas por
-  // morph-eval/morph-review/agents.json via .morph/framework/evals/.
+  // morph-review/agents.json via .morph/framework/evals/.
   log('Step 7c: Copying evals (rubrics .md + trace schema)...');
   const evalsSrc = join(FRAMEWORK_DIR, 'evals');
   const evalsDest = join(frameworkDestDir, 'evals');

package/src/utils/agent-id-mapper.js

@@ -1,11 +1,11 @@
-/**
- * Map an agents.json ID to the Claude Code subagent_type.
- *
- * @param {string} id - Agent ID from agents.json (e.g., "nextjs-expert")
- * @param {number} [tier] - Agent tier (1-4). Defaults to non-validator.
- * @returns {string} subagent_type matching .claude/agents/ filename stem
- */
-export function agentIdToSubagentType(id, tier) {
-  const prefix = tier === 4 ? 'morph-validator-' : 'morph-';
-  return `${prefix}${id}`;
-}
+/**
+ * Map an agents.json ID to the Claude Code subagent_type.
+ *
+ * @param {string} id - Agent ID from agents.json (e.g., "nextjs-expert")
+ * @param {number} [tier] - Agent tier (1-4). Defaults to non-validator.
+ * @returns {string} subagent_type matching .claude/agents/ filename stem
+ */
+export function agentIdToSubagentType(id, tier) {
+  const prefix = tier === 4 ? 'morph-validator-' : 'morph-';
+  return `${prefix}${id}`;
+}

package/src/utils/agents-installer.js

@@ -433,7 +433,7 @@ function buildFrontmatter(agent, description, knownMcpIds, maxTurns) {
     `description: ${description}`,
     // model is dimensioned per stage/criticality in agents.json (v5.2.0):
     // evaluator (quality multiplier) → opus, domain implementers → sonnet,
-    // scout (read-only, cheap) → haiku. Falls back to `inherit` only for
+    // scout → sonnet (measured: same cost as haiku, fewer rejected maps). Falls back to `inherit` only for
     // personas that omit the field.
     `model: ${agent.model ?? 'inherit'}`,
     `tools: ${buildToolsLine(agent, knownMcpIds)}`,
@@ -490,14 +490,10 @@ function buildBody(agent, maxTurns) {
   lines.push(
     '## How you operate',
     '',
-    'You are a domain persona dispatched per task. Read the spec/mandate/tasks/standards passed to you, do the work, and return a concise summary plus an auto-score 0-10. Refer to MORPH.md section 6 for the dispatch contract.',
+    'You are a domain persona dispatched per task. Read the spec/tasks/standards passed to you, do the work, and report each doneCriteria with its evidence. Refer to MORPH.md section 6 for the dispatch contract.',
     '',
-    // Generic on purpose: this body reaches every dispatch (implement, apply,
-    // uiux, hotfix, review). The scout has no canonical file and no Write; the
-    // evaluator's file is evaluator-report.md. `PARCIAL` on line 1 is what
-    // report-check reads (verdict report-incomplete, action resume); "no
-    // score" keeps an evaluator partial from carrying a Composite-Score the
-    // gate would read as final.
+    // `PARCIAL` on line 1 is what report-check reads; "no verdict" keeps an
+    // evaluator partial from carrying a Verdict the gate would read as final.
     '## Turn budget',
     '',
     // Pasted into EVERY dispatch of every persona — kept to the minimum that
@@ -506,7 +502,7 @@ function buildBody(agent, maxTurns) {
     `You have ${maxTurns} turns (\`maxTurns\`); at the ceiling you are cut off mid-work, without warning. ` +
       'One response is one turn, however many parallel tool calls it makes. ' +
       `By turn ${checkpointTurn(maxTurns)}, if your dispatch names a report file, save a partial there — ` +
-      '`PARCIAL` on line 1, done, remaining, files, no score (final report only) — then continue or stop, your call; the final report replaces it.',
+      '`PARCIAL` on line 1, done, remaining, files, no verdict (final report only) — then continue or stop, your call; the final report replaces it.',
   );
 
   // The dispatch template is paraphrased by the orchestrator in the field; this