@polymorphism-tech/morph-spec 8.1.0 → 8.1.1

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

@@ -1,160 +1,160 @@
-/**
- * Activity Logger — Session-scoped hook event log
- *
- * Writes hook activity to .morph/logs/activity.json for live consumption
- * by `morph-spec monitor`.
- *
- * Design constraints:
- * - Synchronous only (hooks run in process, no async overhead)
- * - Fail-silent (never throws — hooks must not be blocked by logger)
- * - ≤5ms per call (no retries, no network)
- * - Windows-safe paths via path.join
- */
-
-import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from 'fs';
-import { join } from 'path';
-
-const LOGS_DIR = '.morph/logs';
-const ACTIVITY_FILE = join(LOGS_DIR, 'activity.json');
-
-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 readRaw(activityPath) {
-  try {
-    if (!existsSync(activityPath)) return null;
-    return JSON.parse(readFileSync(activityPath, 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Log a hook firing event to the session activity log.
- *
- * @param {string} name   - Hook name (e.g. 'dispatch.js', 'enrich-prompt')
- * @param {string} event  - Claude Code event (e.g. 'PostToolUse', 'UserPromptSubmit')
- * @param {string} result - Outcome summary (e.g. 'ok', 'blocked', 'checkpoint_saved')
- * @param {string} [projectPath] - Project root (defaults to cwd)
- */
-export function logHookActivity(name, event, result, projectPath) {
-  try {
-    const activityPath = getActivityPath(projectPath);
-    ensureLogsDir(projectPath);
-
-    const now = new Date();
-    const ts = now.toTimeString().slice(0, 8); // HH:MM:SS
-
-    const data = readRaw(activityPath) || { sessionId: '', feature: '', phase: '', hooks: [], skills: [] };
-
-    data.hooks = data.hooks || [];
-    data.hooks.push({ name, event, result, ts });
-
-    writeFileSync(activityPath, JSON.stringify(data, null, 2), 'utf-8');
-  } catch {
-    // Fail-silent — never block hooks
-  }
-}
-
-
-/**
- * Read the current activity log.
- *
- * @param {string} [projectPath]
- * @returns {{ sessionId: string, feature: string, phase: string, hooks: Array, skills: Array }|null}
- */
-export function readActivity(projectPath) {
-  try {
-    return readRaw(getActivityPath(projectPath));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Reset the activity log for a new session.
- * Called from SessionStart hook to clear stale data.
- *
- * @param {string} sessionId  - ISO timestamp of new session
- * @param {string} feature    - Active feature name (empty string if none)
- * @param {string} phase      - Current phase (empty string if none)
- * @param {string} [projectPath]
- */
-export function resetActivity(sessionId, feature, phase, projectPath) {
-  try {
-    ensureLogsDir(projectPath);
-    const data = {
-      sessionId: sessionId || new Date().toISOString(),
-      feature: feature || '',
-      phase: phase || '',
-      hooks: [],
-      skills: []
-    };
-    writeFileSync(getActivityPath(projectPath), JSON.stringify(data, null, 2), 'utf-8');
-  } catch {
-    // Fail-silent
-  }
-}
-
-/**
- * Log a structured event to the session activity log.
- *
- * @param {string} type   - Event type (e.g., 'task_start', 'loop_detected')
- * @param {Object} data   - Event data payload
- * @param {string} [projectPath] - Project root (defaults to cwd)
- */
-export function logEvent(type, data, projectPath) {
-  try {
-    const activityPath = getActivityPath(projectPath);
-    ensureLogsDir(projectPath);
-
-    const now = new Date();
-    const ts = now.toTimeString().slice(0, 8); // HH:MM:SS
-
-    const activity = readRaw(activityPath) || { sessionId: '', feature: '', phase: '', hooks: [], events: [] };
-    activity.events = activity.events || [];
-    activity.events.push({ type, data, ts });
-
-    writeFileSync(activityPath, JSON.stringify(activity, null, 2), 'utf-8');
-  } catch {
-    // Fail-silent
-  }
-}
-
-/**
- * Archive current activity.json to sessions/ directory for historical logging.
- * Called at the start of a new session.
- *
- * @param {string} [projectPath] - Project root (defaults to cwd)
- */
-export function archiveSession(projectPath) {
-  try {
-    const activityPath = getActivityPath(projectPath);
-    if (!existsSync(activityPath)) return;
-
-    const data = readRaw(activityPath);
-    if (!data) return;
-
-    // Only archive if there are meaningful events
-    if ((!data.hooks || data.hooks.length === 0) && (!data.events || data.events.length === 0)) return;
-
-    const sessionsDir = join(projectPath || process.cwd(), LOGS_DIR, 'sessions');
-    mkdirSync(sessionsDir, { recursive: true });
-
-    const sessionId = (data.sessionId || new Date().toISOString()).replace(/[:.]/g, '-');
-    const archivePath = join(sessionsDir, `${sessionId}.json`);
-    writeFileSync(archivePath, JSON.stringify(data, null, 2), 'utf-8');
-
-    unlinkSync(activityPath);
-  } catch {
-    // Fail-silent
-  }
-}
+/**
+ * Activity Logger — Session-scoped hook event log
+ *
+ * Writes hook activity to .morph/logs/activity.json for live consumption
+ * by `morph-spec monitor`.
+ *
+ * Design constraints:
+ * - Synchronous only (hooks run in process, no async overhead)
+ * - Fail-silent (never throws — hooks must not be blocked by logger)
+ * - ≤5ms per call (no retries, no network)
+ * - Windows-safe paths via path.join
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from 'fs';
+import { join } from 'path';
+
+const LOGS_DIR = '.morph/logs';
+const ACTIVITY_FILE = join(LOGS_DIR, 'activity.json');
+
+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 readRaw(activityPath) {
+  try {
+    if (!existsSync(activityPath)) return null;
+    return JSON.parse(readFileSync(activityPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Log a hook firing event to the session activity log.
+ *
+ * @param {string} name   - Hook name (e.g. 'dispatch.js', 'enrich-prompt')
+ * @param {string} event  - Claude Code event (e.g. 'PostToolUse', 'UserPromptSubmit')
+ * @param {string} result - Outcome summary (e.g. 'ok', 'blocked', 'checkpoint_saved')
+ * @param {string} [projectPath] - Project root (defaults to cwd)
+ */
+export function logHookActivity(name, event, result, projectPath) {
+  try {
+    const activityPath = getActivityPath(projectPath);
+    ensureLogsDir(projectPath);
+
+    const now = new Date();
+    const ts = now.toTimeString().slice(0, 8); // HH:MM:SS
+
+    const data = readRaw(activityPath) || { sessionId: '', feature: '', phase: '', hooks: [], skills: [] };
+
+    data.hooks = data.hooks || [];
+    data.hooks.push({ name, event, result, ts });
+
+    writeFileSync(activityPath, JSON.stringify(data, null, 2), 'utf-8');
+  } catch {
+    // Fail-silent — never block hooks
+  }
+}
+
+
+/**
+ * Read the current activity log.
+ *
+ * @param {string} [projectPath]
+ * @returns {{ sessionId: string, feature: string, phase: string, hooks: Array, skills: Array }|null}
+ */
+export function readActivity(projectPath) {
+  try {
+    return readRaw(getActivityPath(projectPath));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Reset the activity log for a new session.
+ * Called from SessionStart hook to clear stale data.
+ *
+ * @param {string} sessionId  - ISO timestamp of new session
+ * @param {string} feature    - Active feature name (empty string if none)
+ * @param {string} phase      - Current phase (empty string if none)
+ * @param {string} [projectPath]
+ */
+export function resetActivity(sessionId, feature, phase, projectPath) {
+  try {
+    ensureLogsDir(projectPath);
+    const data = {
+      sessionId: sessionId || new Date().toISOString(),
+      feature: feature || '',
+      phase: phase || '',
+      hooks: [],
+      skills: []
+    };
+    writeFileSync(getActivityPath(projectPath), JSON.stringify(data, null, 2), 'utf-8');
+  } catch {
+    // Fail-silent
+  }
+}
+
+/**
+ * Log a structured event to the session activity log.
+ *
+ * @param {string} type   - Event type (e.g., 'task_start', 'loop_detected')
+ * @param {Object} data   - Event data payload
+ * @param {string} [projectPath] - Project root (defaults to cwd)
+ */
+export function logEvent(type, data, projectPath) {
+  try {
+    const activityPath = getActivityPath(projectPath);
+    ensureLogsDir(projectPath);
+
+    const now = new Date();
+    const ts = now.toTimeString().slice(0, 8); // HH:MM:SS
+
+    const activity = readRaw(activityPath) || { sessionId: '', feature: '', phase: '', hooks: [], events: [] };
+    activity.events = activity.events || [];
+    activity.events.push({ type, data, ts });
+
+    writeFileSync(activityPath, JSON.stringify(activity, null, 2), 'utf-8');
+  } catch {
+    // Fail-silent
+  }
+}
+
+/**
+ * Archive current activity.json to sessions/ directory for historical logging.
+ * Called at the start of a new session.
+ *
+ * @param {string} [projectPath] - Project root (defaults to cwd)
+ */
+export function archiveSession(projectPath) {
+  try {
+    const activityPath = getActivityPath(projectPath);
+    if (!existsSync(activityPath)) return;
+
+    const data = readRaw(activityPath);
+    if (!data) return;
+
+    // Only archive if there are meaningful events
+    if ((!data.hooks || data.hooks.length === 0) && (!data.events || data.events.length === 0)) return;
+
+    const sessionsDir = join(projectPath || process.cwd(), LOGS_DIR, 'sessions');
+    mkdirSync(sessionsDir, { recursive: true });
+
+    const sessionId = (data.sessionId || new Date().toISOString()).replace(/[:.]/g, '-');
+    const archivePath = join(sessionsDir, `${sessionId}.json`);
+    writeFileSync(archivePath, JSON.stringify(data, null, 2), 'utf-8');
+
+    unlinkSync(activityPath);
+  } catch {
+    // Fail-silent
+  }
+}

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/rubrics/backend.json

@@ -1,41 +1,41 @@
-{
-  "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.",
-  "categories": {
-    "functionality": {
-      "weight": 0.25,
-      "validators": ["contract-compliance"],
-      "description": "Core feature correctness and contract compliance"
-    },
-    "code_quality": {
-      "weight": 0.25,
-      "validators": ["architecture"],
-      "description": "Architecture patterns, dependency direction, and code structure"
-    },
-    "design_ui": {
-      "weight": 0.05,
-      "validators": ["design-system", "css", "contrast", "nextjs-component"],
-      "description": "Design system compliance (minimal weight for backend projects)"
-    },
-    "security": {
-      "weight": 0.15,
-      "validators": [],
-      "description": "Security posture (agent-evaluated, no automated validator)"
-    },
-    "packages": {
-      "weight": 0.20,
-      "validators": ["packages"],
-      "description": "Dependency health, version compatibility, and deprecated packages"
-    },
-    "maf_compliance": {
-      "weight": 0.10,
-      "validators": [],
-      "description": "MAF agent compliance (agent-evaluated, applies only when the feature touches AI agents): Microsoft.Agents.AI GA packages used; Model Registry alias referenced not hardcoded models; structured output for pipelined agents; prompts from DB not hardcoded; no Semantic Kernel; no hosted agent services."
-    }
-  },
-  "thresholds": {
-    "approve": 9.0,
-    "retry": 6.0
-  }
-}
+{
+  "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.",
+  "categories": {
+    "functionality": {
+      "weight": 0.25,
+      "validators": ["contract-compliance"],
+      "description": "Core feature correctness and contract compliance"
+    },
+    "code_quality": {
+      "weight": 0.25,
+      "validators": ["architecture"],
+      "description": "Architecture patterns, dependency direction, and code structure"
+    },
+    "design_ui": {
+      "weight": 0.05,
+      "validators": ["design-system", "css", "contrast", "nextjs-component"],
+      "description": "Design system compliance (minimal weight for backend projects)"
+    },
+    "security": {
+      "weight": 0.15,
+      "validators": [],
+      "description": "Security posture (agent-evaluated, no automated validator)"
+    },
+    "packages": {
+      "weight": 0.20,
+      "validators": ["packages"],
+      "description": "Dependency health, version compatibility, and deprecated packages"
+    },
+    "maf_compliance": {
+      "weight": 0.10,
+      "validators": [],
+      "description": "MAF agent compliance (agent-evaluated, applies only when the feature touches AI agents): Microsoft.Agents.AI GA packages used; Model Registry alias referenced not hardcoded models; structured output for pipelined agents; prompts from DB not hardcoded; no Semantic Kernel; no hosted agent services."
+    }
+  },
+  "thresholds": {
+    "approve": 9.0,
+    "retry": 6.0
+  }
+}

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

@@ -1,45 +1,45 @@
----
-paths:
-  - "**/Agents/**"
-  - "**/agents/**"
-  - "**/*Agent*.cs"
-stacks:
-  - dotnet
----
-
-# Microsoft Agent Framework Standards
-
-> **Layer 0/1 — auto-carregados.** São os standards core: aplicam-se a praticamente todo
-> agente MAF. Carregue-os sempre que tocar código de agentes.
-
-@.morph/framework/standards/ai-agents/setup.md
-@.morph/framework/standards/ai-agents/sweet-spot.md
-@.morph/framework/standards/ai-agents/providers/model-registry.md
-@.morph/framework/standards/ai-agents/structured-output.md
-@.morph/framework/standards/ai-agents/multi-agent-patterns.md
-@.morph/framework/standards/ai-agents/prompts-in-db.md
-@.morph/framework/standards/ai-agents/rag-custom-pgvector.md
-@.morph/framework/standards/ai-agents/middleware-patterns.md
-@.morph/framework/standards/ai-agents/workflows.md
-@.morph/framework/standards/ai-agents/production.md
-
----
-
-> **Layer 2 — sob demanda (NÃO auto-carregados).** São standards de modalidade, otimização e
-> MCP: relevantes apenas quando a feature usa especificamente esse recurso. Carregue via
-> `morph-standards` quando uma keyword corresponder — manter fora do auto-load preserva o
-> context window para o trabalho que importa.
-
-| Standard | Carregue quando a feature envolve |
-|----------|-----------------------------------|
-| `ai-agents/modalities-vision.md` | imagem → texto (OCR, análise de documento, visão) |
-| `ai-agents/modalities-image-gen.md` | texto → imagem (geração de mockups, posts, assets) |
-| `ai-agents/modalities-speech-to-text.md` | áudio → texto (transcrição, legendagem) |
-| `ai-agents/modalities-text-to-speech.md` | texto → áudio (síntese de voz) |
-| `ai-agents/batching.md` | processar N prompts independentes em lote (Batch API) |
-| `ai-agents/service-tier-flex.md` | otimização de custo em jobs assíncronos (tier flex) |
-| `ai-agents/agent-session.md` | agentes conversacionais com histórico/reducers |
-| `ai-agents/context-providers.md` | injeção dinâmica de contexto (`AIContextProvider`) |
-| `ai-agents/mcp-tools.md` | agente MAF consome um MCP server externo |
-| `ai-agents/mcp-server.md` | projeto expõe capacidades como MCP server |
-| `integration/mcp/mcp-tools.md` | integração MCP cross-domain (fora do escopo MAF) |
+---
+paths:
+  - "**/Agents/**"
+  - "**/agents/**"
+  - "**/*Agent*.cs"
+stacks:
+  - dotnet
+---
+
+# Microsoft Agent Framework Standards
+
+> **Layer 0/1 — auto-carregados.** São os standards core: aplicam-se a praticamente todo
+> agente MAF. Carregue-os sempre que tocar código de agentes.
+
+@.morph/framework/standards/ai-agents/setup.md
+@.morph/framework/standards/ai-agents/sweet-spot.md
+@.morph/framework/standards/ai-agents/providers/model-registry.md
+@.morph/framework/standards/ai-agents/structured-output.md
+@.morph/framework/standards/ai-agents/multi-agent-patterns.md
+@.morph/framework/standards/ai-agents/prompts-in-db.md
+@.morph/framework/standards/ai-agents/rag-custom-pgvector.md
+@.morph/framework/standards/ai-agents/middleware-patterns.md
+@.morph/framework/standards/ai-agents/workflows.md
+@.morph/framework/standards/ai-agents/production.md
+
+---
+
+> **Layer 2 — sob demanda (NÃO auto-carregados).** São standards de modalidade, otimização e
+> MCP: relevantes apenas quando a feature usa especificamente esse recurso. Carregue via
+> `morph-standards` quando uma keyword corresponder — manter fora do auto-load preserva o
+> context window para o trabalho que importa.
+
+| Standard | Carregue quando a feature envolve |
+|----------|-----------------------------------|
+| `ai-agents/modalities-vision.md` | imagem → texto (OCR, análise de documento, visão) |
+| `ai-agents/modalities-image-gen.md` | texto → imagem (geração de mockups, posts, assets) |
+| `ai-agents/modalities-speech-to-text.md` | áudio → texto (transcrição, legendagem) |
+| `ai-agents/modalities-text-to-speech.md` | texto → áudio (síntese de voz) |
+| `ai-agents/batching.md` | processar N prompts independentes em lote (Batch API) |
+| `ai-agents/service-tier-flex.md` | otimização de custo em jobs assíncronos (tier flex) |
+| `ai-agents/agent-session.md` | agentes conversacionais com histórico/reducers |
+| `ai-agents/context-providers.md` | injeção dinâmica de contexto (`AIContextProvider`) |
+| `ai-agents/mcp-tools.md` | agente MAF consome um MCP server externo |
+| `ai-agents/mcp-server.md` | projeto expõe capacidades como MCP server |
+| `integration/mcp/mcp-tools.md` | integração MCP cross-domain (fora do escopo MAF) |