@polymorphism-tech/morph-spec 9.4.0 → 9.5.0

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

@@ -3,6 +3,8 @@ import { existsSync, readFileSync, rmSync } from 'fs';
 import { join, resolve } from 'path';
 
 import { runBuildCheck, getBuildSteps, isDotnetStack } from '../../../framework/hooks/shared/build-check.js';
+import { changedPathsAgainst, detectDefaultBranch } from '../git/default-branch.js';
+import { resolveBaseRef } from '../git/branch-classifier.js';
 import { composeProjectName, runE2eCheck } from '../../../framework/hooks/shared/e2e-check.js';
 import { buildComposeEnv } from '../e2e/compose-env.js';
 import { e2eApplicability } from '../e2e/applicability.js';
@@ -218,8 +220,10 @@ async function runBuildNode({ projectPath, stack, paths: declaredPaths = {}, tim
     return { status: 'skip', command: null, durationMs: 0, reason: 'requested', output: '' };
   }
 
-  const { paths, hint } = resolveDotnetBuild(projectPath, stack, declaredPaths);
-  const steps = getBuildSteps(stack, { cwd: projectPath, frontendPath: paths.frontendPath, backendPath: paths.backendPath, backendTarget: paths.backendTarget });
+  const resolved = resolveDotnetBuild(projectPath, stack, declaredPaths);
+  const { hint } = resolved;
+  const paths = { ...resolved.paths, lintFiles: featureLintFiles(projectPath, stack, resolved.paths.frontendPath) };
+  const steps = getBuildSteps(stack, { cwd: projectPath, frontendPath: paths.frontendPath, backendPath: paths.backendPath, backendTarget: paths.backendTarget, lintFiles: paths.lintFiles });
   if (steps.length === 0) {
     const reason = stack ? `no build command for stack "${stack}"` : 'no stack configured';
     return { status: 'skip', command: null, durationMs: 0, reason, output: '' };
@@ -240,6 +244,18 @@ async function runBuildNode({ projectPath, stack, paths: declaredPaths = {}, tim
   };
 }
 
+const LINTABLE = /\.(?:tsx?|jsx?|mjs|cjs)$/;
+
+/** The feature's own source files under the frontend, relative to it; `[]` when the base does not resolve. */
+export function featureLintFiles(projectPath, stack, frontendPath, { changed } = {}) {
+  if (!/nextjs|react|vue|node/i.test(stack ?? '')) return [];
+  const paths = changed ?? changedPathsAgainst(resolveBaseRef(detectDefaultBranch(projectPath), projectPath), projectPath);
+  const prefix = frontendPath ? `${frontendPath.replace(/\\/g, '/').replace(/\/$/, '')}/` : '';
+  return paths
+    .filter((p) => LINTABLE.test(p) && p.startsWith(prefix) && existsSync(join(projectPath, p)))
+    .map((p) => p.slice(prefix.length));
+}
+
 function appendBuildFeedback(feedback, buildNode) {
   if (buildNode.status !== 'fail') return;
   for (const line of linesOf(buildNode.output)) {

package/src/utils/agents-installer.js

@@ -281,27 +281,23 @@ export const DISPATCH_CONTRACT = [
     'o caminho do relatório e, se houver, o worktree. O resto é este contrato.',
   '',
   '1. RELATÓRIO: GRAVE o arquivo de relatório que o dispatch nomeia (`.morph/features/{feature}/3-implement/reports/F{n}.md`) ' +
-    'ANTES de encerrar — é o retorno autoritativo, não a sua mensagem final. `SendMessage` não é substituto do relatório e não deve ser chamado.',
-  '2. ESTADO: NÃO toque em `plan.md`, `checks.json`, `feature.json`, `state.json` nem no board de sessão — todo estado é gravado exclusivamente pelo orquestrador.',
+    'ANTES de encerrar — é o retorno autoritativo, não a sua mensagem final.',
+  '2. ESTADO: NÃO toque em `plan.md`, `checks.json`, `feature.json` nem `state.json`: o estado é do orquestrador.',
   '3. TESTE: a prova é do orquestrador (`morph-spec verify {feature}`, depois do seu retorno), não sua. Escreva os testes pelo orçamento: ' +
     'um por Cn `prova: teste`, variantes em tabela (`[Theory]`/`it.each`); `leitura` sem teste. NÃO rode teste a cada marco nem faça ciclo red→green: ' +
     'escreva código e testes, compile, e rode SÓ o filtro dos seus testes UMA vez, em primeiro plano, antes do relatório; se falhar, corrija e rode só os que falharam. ' +
     'Grave a saída em arquivo (`… > .morph/logs/test-last.log 2>&1`, sem nada depois) e leia o arquivo — um pipe troca o exit do teste pelo do último comando. ' +
     'Em batch paralelo SEM isolamento, só compile. Com `isolation: "worktree"`, o mesmo vale no seu worktree, e o último ato é o commit na branch dele.',
-  '4. ESCOPO: uma fatia, ~4 arquivos (nunca mais de 8). Escopo maior falha e volta — fatie antes, não depois.',
-  '5. SOBREVIVÊNCIA: o limite de turnos corta sem aviso: commite `chore(F{n}): wip …` a cada marco (um arquivo ou uma fatia escrita), não só ao fim — ' +
-    'e só os seus arquivos (`git add <paths>`, nunca `-A` nem diretório). Sem commit, a retomada recomeça do zero.',
-  '6. PROCESSOS: NUNCA `taskkill /IM node.exe` (derruba os MCPs de todas as sessões). Encerre dev server pelo PID que você mesmo subiu. ' +
-    'Build e suíte pesados rodam por `morph-spec heavy run -- <comando>`, em primeiro plano. Exit 3 é fila cheia depois da espera da própria fila: ' +
-    'não repita nem espere em laço — diga no relatório o que não rodou.',
-  '7. REUSO: antes de criar tipo, componente, hook ou serviço NOVO, verifique se já existe: `morph-spec graph explain <nome>` e ' +
+  '4. SOBREVIVÊNCIA: o limite de turnos corta sem aviso: commite `chore(F{n}): wip …` a cada marco (um arquivo ou uma fatia escrita), não só ao fim — ' +
+    'e só os seus arquivos (`git add <paths>`, nunca diretório). Sem commit, a retomada recomeça do zero.',
+  '5. PROCESSOS: encerre dev server pelo PID que você mesmo subiu. Build e suíte pesados rodam por `morph-spec heavy run -- <comando>`, em primeiro plano; ' +
+    'exit 3 é fila cheia: não repita nem espere em laço, diga no relatório o que não rodou.',
+  '6. REUSO: antes de criar tipo, componente, hook ou serviço NOVO, verifique se já existe: `morph-spec graph explain <nome>` e ' +
     '`graph affected <conceito> --uses-only`; sem grafo (`no-graph`), caia para `grep -rn "<nome>"` e siga — a ausência de grafo nunca bloqueia. ' +
     'Se criar mesmo assim, diga por que em uma linha no relatório.',
-  '8. MUTAÇÃO: nunca altere, reverta, mova ou apague código de produção para ver um teste falhar (`sed`, `mv`, `git show HEAD:… >`, `git stash`, ' +
-    '`git checkout --`). A prova de que o teste morde é do verificador (Gate 3).',
-  '9. ESCRITA: código e teste do projeto só por Write/Edit, nunca pelo Bash — heredoc, redirecionamento, `sed -i` ou script python/node que grava (`cat > X.cs <<EOF`, `sed -i … X.cs`): ' +
-    'os guards de escrita só enxergam Write/Edit.',
-  '10. BLOQUEIO: decisão que não é sua (requisito contra o plano ou um ADR, escolha deixada ao humano) → `BLOQUEADO` na 1ª linha, ' +
+  '7. MUTAÇÃO: nunca altere, reverta, mova ou apague código de produção para ver um teste falhar; a prova de que o teste morde é do verificador.',
+  '8. ESCRITA: código e teste do projeto só por Write/Edit, nunca pelo Bash (heredoc, `sed -i`, script que grava): os guards só enxergam Write/Edit.',
+  '9. BLOQUEIO: decisão que não é sua (requisito contra o plano ou um ADR, escolha deixada ao humano) → `BLOQUEADO` na 1ª linha, ' +
     'com a pergunta e as opções. Dificuldade técnica não é bloqueio.',
   '',
   'Formato do relatório (o `report-check` lê estas marcas):',
@@ -416,11 +412,8 @@ function buildBody(agent, maxTurns) {
       '',
       '## Working fast',
       '',
-      'Independent tool calls go in the SAME response: read every listed file at once, fire the Greps together. ' +
-        'Use Read/Grep/Glob, never grep/sed/cat/find via Bash. Check a library API in the `context7` MCP before guessing ' +
-        '(load a deferred `mcp__` tool with ToolSearch). Write the tests the budget asks for, then run only your own ' +
-        'filter ONCE before the report — no red→green cycles, no `morph-spec verify` (the orchestrator proves it). ' +
-        'Never alter, revert or move production code to watch a test fail: mutation proof belongs to the Gate 3 verifier.',
+      'Independent tool calls go in the SAME response: read every listed file at once, fire the searches together. ' +
+        'Check a library API in the `context7` MCP before guessing (load a deferred `mcp__` tool with ToolSearch).',
     );
   }
 

package/src/utils/claude-settings-manager.js

@@ -7,34 +7,6 @@ const MORPH_MANAGED_KEY = '_morph_managed';
 export { installClaudeHooks, installGlobalStatusline, getHooksVersion } from './hooks-installer.js';
 export { installAgents } from './agents-installer.js';
 
-export async function installEnvVars(targetPath, envVars) {
-  const settings = await loadSettings(targetPath);
-
-  settings.env = settings.env || {};
-
-  const added = [];
-  for (const [key, value] of Object.entries(envVars)) {
-    if (!(key in settings.env)) {
-      settings.env[key] = value;
-      added.push(key);
-    }
-  }
-
-  settings[MORPH_MANAGED_KEY] = settings[MORPH_MANAGED_KEY] || {};
-  settings[MORPH_MANAGED_KEY].env_added =
-    settings[MORPH_MANAGED_KEY].env_added || [];
-  for (const key of added) {
-    if (!settings[MORPH_MANAGED_KEY].env_added.includes(key)) {
-      settings[MORPH_MANAGED_KEY].env_added.push(key);
-    }
-  }
-  settings[MORPH_MANAGED_KEY].generated_at = new Date().toISOString();
-
-  await saveSettings(targetPath, settings);
-
-  return { added, total: Object.keys(settings.env).length };
-}
-
 export async function resetMorphSettings(targetPath) {
   const claudeDir = join(targetPath, '.claude');
   const settingsPath = join(claudeDir, 'settings.local.json');

package/src/utils/file-copier.js

@@ -58,63 +58,10 @@ export async function writeFile(path, content) {
   await fs.writeFile(path, content, 'utf8');
 }
 
-export async function removeDir(path) {
-  await fs.remove(path);
-}
-
 export async function readFile(path) {
   return fs.readFile(path, 'utf8');
 }
 
-// Hard link first: it needs no admin on Windows (same NTFS volume).
-export async function createSymlink(target, link, type = 'file') {
-  await fs.ensureDir(dirname(link));
-
-  if (type === 'dir') {
-    return createDirectoryLink(target, link);
-  }
-
-  try {
-    await fs.link(target, link);
-    return 'hardlink';
-  } catch {
-    try {
-      await fs.ensureSymlink(target, link, 'file');
-      return 'symlink';
-    } catch {
-      await copyFile(target, link);
-      return 'copy';
-    }
-  }
-}
-
-export async function createDirectoryLink(target, link) {
-  await fs.ensureDir(dirname(link));
-
-  if (await pathExists(link)) {
-    await fs.remove(link);
-  }
-
-  if (process.platform === 'win32') {
-    // A junction needs no admin; ensureSymlink('dir') would.
-    try {
-      await fs.symlink(target, link, 'junction');
-      return 'junction';
-    } catch {
-      await copyDirectory(target, link);
-      return 'copy';
-    }
-  } else {
-    try {
-      await fs.ensureSymlink(target, link, 'dir');
-      return 'symlink';
-    } catch {
-      await copyDirectory(target, link);
-      return 'copy';
-    }
-  }
-}
-
 export const MORPH_GITIGNORE_ENTRIES = [
     // Rebuilt from the committed feature.json files; committing it sweeps every feature into one commit.
     '.morph/state.json',

package/framework/hooks/shared/activity-logger.js

@@ -1,131 +0,0 @@
-// Append-only on purpose: rewriting a whole JSON doc per event is O(n²) across
-// a session. Fail-silent: never blocks a hook.
-
-import {
-  appendFileSync, readFileSync, mkdirSync, existsSync, statSync, renameSync, writeFileSync,
-} from 'fs';
-import { join } from 'path';
-
-const LOGS_DIR = '.morph/logs';
-export const ACTIVITY_FILE = join(LOGS_DIR, 'activity.jsonl');
-
-export const ROTATE_THRESHOLD_BYTES = 2 * 1024 * 1024;
-
-function getActivityPath(projectPath) {
-  return join(projectPath || process.cwd(), ACTIVITY_FILE);
-}
-
-function ensureLogsDir(projectPath) {
-  const dir = join(projectPath || process.cwd(), LOGS_DIR);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-}
-
-function nowTs() {
-  return new Date().toTimeString().slice(0, 8);
-}
-
-function appendLine(projectPath, line) {
-  try {
-    ensureLogsDir(projectPath);
-    appendFileSync(getActivityPath(projectPath), JSON.stringify(line) + '\n', 'utf-8');
-  } catch {
-  }
-}
-
-function readLines(projectPath) {
-  try {
-    const activityPath = getActivityPath(projectPath);
-    if (!existsSync(activityPath)) return [];
-    const raw = readFileSync(activityPath, 'utf-8');
-    const lines = [];
-    for (const l of raw.split('\n')) {
-      const trimmed = l.trim();
-      if (!trimmed) continue;
-      try {
-        lines.push(JSON.parse(trimmed));
-      } catch {
-        // a process killed mid-write leaves a truncated line
-      }
-    }
-    return lines;
-  } catch {
-    return [];
-  }
-}
-
-export function logHookActivity(name, event, result, projectPath) {
-  appendLine(projectPath, { kind: 'hook', name, event, result, ts: nowTs() });
-}
-
-export function logEvent(type, data, projectPath) {
-  appendLine(projectPath, { kind: 'event', type, data, ts: nowTs() });
-}
-
-/** @returns {{ sessionId: string, feature: string, phase: string, hooks: Array, events: Array }|null} */
-export function readActivity(projectPath) {
-  const lines = readLines(projectPath);
-  if (lines.length === 0) return null;
-
-  const session = lines.find((l) => l.kind === 'session') || {};
-  const strip = ({ kind, ...rest }) => rest;
-
-  return {
-    sessionId: session.sessionId || '',
-    feature: session.feature || '',
-    phase: session.phase || '',
-    hooks: lines.filter((l) => l.kind === 'hook').map(strip),
-    events: lines.filter((l) => l.kind === 'event').map(strip),
-  };
-}
-
-// The one write that truncates: the 'session' header is what `readActivity()`
-// recovers sessionId/feature/phase from.
-export function resetActivity(sessionId, feature, phase, projectPath) {
-  try {
-    ensureLogsDir(projectPath);
-    const session = {
-      kind: 'session',
-      sessionId: sessionId || new Date().toISOString(),
-      feature: feature || '',
-      phase: phase || '',
-    };
-    writeFileSync(getActivityPath(projectPath), JSON.stringify(session) + '\n', 'utf-8');
-  } catch {
-  }
-}
-
-export function archiveSession(projectPath) {
-  try {
-    const activityPath = getActivityPath(projectPath);
-    if (!existsSync(activityPath)) return;
-
-    const lines = readLines(projectPath);
-    const hasMeaningfulContent = lines.some((l) => l.kind === 'hook' || l.kind === 'event');
-    if (!hasMeaningfulContent) return;
-
-    const session = lines.find((l) => l.kind === 'session') || {};
-    const sessionsDir = join(projectPath || process.cwd(), LOGS_DIR, 'sessions');
-    mkdirSync(sessionsDir, { recursive: true });
-
-    const stamp = (session.sessionId || new Date().toISOString()).replace(/[:.]/g, '-');
-    const archivePath = join(sessionsDir, `${stamp}.jsonl`);
-    renameSync(activityPath, archivePath);
-  } catch {
-  }
-}
-
-/** @returns {boolean} true if a rotation was performed */
-export function rotateActivityLogIfLarge(projectPath, thresholdBytes = ROTATE_THRESHOLD_BYTES) {
-  try {
-    const activityPath = getActivityPath(projectPath);
-    if (!existsSync(activityPath)) return false;
-    const { size } = statSync(activityPath);
-    if (size < thresholdBytes) return false;
-    archiveSession(projectPath);
-    return true;
-  } catch {
-    return false;
-  }
-}

package/framework/standards/frontend/design-system/naming.md

@@ -1,68 +0,0 @@
-# CSS Naming Convention
-
-> **Scope:** universal
-> **Layer:** 0 (resumo injetado pela rule `frontend-standards` ao editar `**/*.tsx`/`**/*.css`/`**/*.scss`; texto completo sob demanda via `morph-spec standards --find`)
-> **Keywords:** css, bem, naming, class names, conventions
-> **Load When:** always
-
-**Verified against:** CSS (BEM + custom properties — language-level, no framework). Last-verified: 2026-05-20.
-
----
-
-## Principles
-
-1. **Page prefix** — Prevents conflicts
-2. **BEM for components** — Clear hierarchy
-3. **Namespaced variables** — No library collisions
-4. **State suffixes** — Consistent modifiers
-
----
-
-## Page Prefixes
-
-| Page | Example |
-|------|---------|
-| Home | `.home-hero`, `.home-features` |
-| Checkout | `.checkout-form`, `.checkout-summary` |
-| Dashboard | `.dashboard-stats`, `.dashboard-chart` |
-| Auth | `.auth-form`, `.auth-social-buttons` |
-
-## BEM for Reusable Components
-
-```css
-.card { }              /* Block */
-.card__header { }      /* Element */
-.card__body { }
-.card--featured { }    /* Modifier */
-```
-
-**Rule:** BEM for reusable components. Page prefix for page-specific elements.
-
-## CSS Variables with Namespace
-
-```css
-:root {
-  --app-primary: #007bff;
-  --app-spacing-md: 1rem;
-  --app-font-heading: 'Segoe UI', sans-serif;
-}
-```
-
-## State Suffixes
-
-| State | Suffix |
-|-------|--------|
-| Active | `--active` |
-| Disabled | `--disabled` |
-| Loading | `--loading` |
-| Error | `--error` |
-
-```css
-.button { }
-.button--active { }
-.button--disabled { }
-```
-
----
-
-*MORPH-SPEC by Polymorphism Tech*

package/src/commands/validation/index.js

@@ -1,2 +0,0 @@
-export { validateFeatureCommand } from './validate-feature.js';
-export { verifyCommand } from './verify.js';

package/src/lib/validators/code-budget/index.js

@@ -1,2 +0,0 @@
-export * from './code-budget-validator.js';
-export * from '../../../../framework/hooks/shared/comment-scanner.js';

package/src/lib/validators/contracts/index.js

@@ -1 +0,0 @@
-export * from './contract-compliance-validator.js';

package/src/lib/validators/nextjs/index.js

@@ -1 +0,0 @@
-export { validateNextComponent, validateNextComponentFiles } from './next-component-validator.js';

package/src/lib/validators/packages/index.js

@@ -1 +0,0 @@
-export * from './package-validator.js';

package/src/lib/validators/reuse/index.js

@@ -1,2 +0,0 @@
-export * from './reuse-validator.js';
-export * from './symbol-scanner.js';