@polymorphism-tech/morph-spec 8.43.0 → 8.45.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/lib/worktree/env-allocator.js

@@ -168,10 +168,10 @@ export const PORT_OFFSETS = Object.freeze({ web: 0, api: 1, postgres: 2, redis:
  * not in the root's. Every value is a string (env-safe); key order is stable.
  *
  * @param {{ base: number, range: [number, number] }} block
- * @param {{ stack?: string, feature?: string }} [opts]
+ * @param {{ stack?: string, feature?: string, aliases?: Record<string, string> }} [opts] - aliases: resolvePortAliases()
  * @returns {Record<string,string>}
  */
-export function portLayout(block, { stack = '', feature = '' } = {}) {
+export function portLayout(block, { stack = '', feature = '', aliases = {} } = {}) {
   const env = {};
   if (feature) env.COMPOSE_PROJECT_NAME = composeProjectName(feature);
   env.MORPH_PORT_BASE = String(block.base);
@@ -183,9 +183,39 @@ export function portLayout(block, { stack = '', feature = '' } = {}) {
   if (/\bdotnet\b/i.test(String(stack))) {
     env.ASPNETCORE_URLS = `http://localhost:${block.base + PORT_OFFSETS.api}`;
   }
+  for (const [alias, port] of Object.entries(aliases)) env[alias] = String(block.base + PORT_OFFSETS[port]);
   return env;
 }
 
+const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const RESERVED_ENV_NAMES = new Set([
+  ...Object.keys(portLayout({ base: 0, range: [0, 0] }, { stack: 'dotnet', feature: 'x' })),
+  'PLAYWRIGHT_BASE_URL',
+  'MORPH_FEATURE',
+]);
+
+// e2e.portEnvNames: extra env names for the same four ports, so a compose file reading
+// ${PG_PORT} is fed by the block, not by its own default. An entry that cannot be
+// honoured is dropped and named in `problems`.
+export function resolvePortAliases(config) {
+  const declared = config?.e2e?.portEnvNames;
+  const aliases = {};
+  const problems = [];
+  if (declared === undefined || declared === null) return { aliases, problems };
+  if (typeof declared !== 'object' || Array.isArray(declared)) {
+    return { aliases, problems: [`e2e.portEnvNames deve ser um objeto { ${Object.keys(PORT_OFFSETS).join('|')}: "NOME" }`] };
+  }
+  for (const [port, name] of Object.entries(declared)) {
+    const at = `e2e.portEnvNames.${port}`;
+    if (!Object.hasOwn(PORT_OFFSETS, port)) problems.push(`${at}: porta desconhecida (use ${Object.keys(PORT_OFFSETS).join('|')})`);
+    else if (typeof name !== 'string' || !ENV_NAME.test(name)) problems.push(`${at}: ${JSON.stringify(name)} não é um nome de variável de ambiente válido`);
+    else if (RESERVED_ENV_NAMES.has(name)) problems.push(`${at}: "${name}" já é uma variável do layout`);
+    else if (Object.hasOwn(aliases, name)) problems.push(`${at}: "${name}" já é o alias de ${aliases[name]}`);
+    else aliases[name] = port;
+  }
+  return { aliases, problems };
+}
+
 /**
  * Render the `.morph/worktree.env` contents for a block: a header, the
  * feature, and exactly the `portLayout()` pairs — nothing else, so the file
@@ -199,15 +229,15 @@ export function portLayout(block, { stack = '', feature = '' } = {}) {
  * @param {string} feature - the env-registry key: `<feature>` or `task/<name>`
  * @param {{ base: number, range: [number, number] }} block
  * @param {string} [stack] - config.json `project.stack` (e.g. "nextjs+dotnet")
- * @param {{ morphFeature?: string|null }} [opts]
+ * @param {{ morphFeature?: string|null, aliases?: Record<string, string> }} [opts]
  * @returns {string}
  */
-export function buildEnvFileContent(feature, block, stack = '', { morphFeature = null } = {}) {
+export function buildEnvFileContent(feature, block, stack = '', { morphFeature = null, aliases = {} } = {}) {
   const lines = [
     `# Managed by morph-spec — ambiente dedicado desta worktree (feature: ${feature}).`,
     '# Derivado, git-invisível, regenerado por `worktree setup|link`; nunca editar nem commitar.',
     `MORPH_FEATURE=${morphFeature || feature}`,
-    ...Object.entries(portLayout(block, { stack, feature })).map(([k, v]) => `${k}=${v}`),
+    ...Object.entries(portLayout(block, { stack, feature, aliases })).map(([k, v]) => `${k}=${v}`),
   ];
   return `${lines.join('\n')}\n`;
 }

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