sinapse-ai 1.12.2 → 1.13.0

package/.sinapse-ai/hooks/sinapse-ds-grounding.cjs

@@ -1,211 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * SINAPSE Design System Grounding Hook — UserPromptSubmit (framework-shipped).
- *
- * @story GA-1.6
- *
- * Reads `~/.claude/sinapse-ai-config.yaml` (Story 10.47 schema) `designSystem`
- * section. Activates only when the user prompt contains UI keywords
- * (PT + EN). Injects the first 3000 chars of the DS law file as
- * `<ds-grounding>` context.
- *
- * Coexistence: the user's personal `~/.claude/hooks/design-system-grounding.cjs` (if present)
- * reads `ds-routing.json` and is unaffected by this file.
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const HOOK_TIMEOUT_MS = 3500;
-const MAX_INJECTION_SIZE = 3000; // chars (story says 3000 for DS)
-const MAX_LAW_PREVIEW = 3000;
-const MIN_PROMPT_CHARS = 15;
-const CONFIG_PATH = path.join(os.homedir(), '.claude', 'sinapse-ai-config.yaml');
-
-const UI_KEYWORDS = [
-  // PT
-  'pagina', 'página', 'lp', 'landing', 'componente', 'interface', 'tela',
-  'layout', 'hero', 'dashboard', 'carrossel', 'slide', 'mockup',
-  'wireframe', 'prototipo', 'protótipo', 'design', 'visual', 'site',
-  'website', 'menu', 'navbar', 'footer', 'botao', 'botão', 'card', 'cards',
-  'secao', 'seção', 'frontend', 'front-end', 'figma', 'react', 'tailwind',
-  'nextjs', 'next.js', 'redesign', 'tipografia', 'paleta',
-  // EN
-  'page', 'component', 'screen', 'section', 'button', 'typography',
-  'palette', 'web app', 'ui ', ' ui',
-];
-
-// Candidate filenames to read as the DS law, in priority order.
-const LAW_CANDIDATES = [
-  '0.0-guidelines.md',
-  'guidelines.md',
-  'principles.md',
-  'README.md',
-  'tokens.json',
-  'design-system.md',
-];
-
-function readStdin() {
-  return new Promise((resolve) => {
-    let data = '';
-    let settled = false;
-    const finish = (val) => { if (!settled) { settled = true; resolve(val); } };
-    try {
-      process.stdin.setEncoding('utf8');
-      process.stdin.on('error', () => finish(null));
-      process.stdin.on('data', (chunk) => { data += chunk; });
-      process.stdin.on('end', () => {
-        try { finish(JSON.parse(data)); } catch { finish(null); }
-      });
-    } catch {
-      finish(null);
-    }
-  });
-}
-
-// Story 10.47: delegate to the shared grounding config loader instead of
-// duplicating the read+parse. The require is guarded so the hook stays
-// fail-open even if the shared module is somehow absent at runtime.
-function loadConfig() {
-  try {
-    return require('../core/grounding/config-loader.cjs').loadGroundingConfig(CONFIG_PATH);
-  } catch {
-    return null;
-  }
-}
-
-function getSection(cfg, name) {
-  if (!cfg || !cfg.grounding) return null;
-  const s = cfg.grounding[name];
-  if (!s || typeof s !== 'object' || !s.enabled) return null;
-  return s;
-}
-
-function isUIPrompt(prompt) {
-  if (!prompt || typeof prompt !== 'string') return false;
-  if (prompt.trim().length < MIN_PROMPT_CHARS) return false;
-  const lower = prompt.toLowerCase();
-  return UI_KEYWORDS.some((k) => lower.includes(k));
-}
-
-function findLawFile(rootPath) {
-  try {
-    if (!rootPath || !fs.existsSync(rootPath)) return null;
-    const stat = fs.statSync(rootPath);
-    if (!stat.isDirectory()) {
-      // If user passed a file directly, use it.
-      return rootPath;
-    }
-    for (const candidate of LAW_CANDIDATES) {
-      const full = path.join(rootPath, candidate);
-      if (fs.existsSync(full)) return full;
-    }
-    // Fallback: first .md/.json in the dir
-    const entries = fs.readdirSync(rootPath).filter(
-      (f) => f.endsWith('.md') || f.endsWith('.json')
-    );
-    if (entries.length > 0) return path.join(rootPath, entries[0]);
-    return null;
-  } catch {
-    return null;
-  }
-}
-
-function readLaw(lawFile) {
-  try {
-    if (!lawFile || !fs.existsSync(lawFile)) return null;
-    let content = fs.readFileSync(lawFile, 'utf8');
-    if (content.length > MAX_LAW_PREVIEW) {
-      content = content.substring(0, MAX_LAW_PREVIEW) + '\n[...truncated...]';
-    }
-    return content;
-  } catch {
-    return null;
-  }
-}
-
-function buildInjection(section, lawContent, projectCwd) {
-  const profileName = section.profileName || 'Custom DS';
-  const rootPath = section.rootPath || '';
-  const parts = [];
-  parts.push(`<ds-grounding source="filesystem" name="${profileName}" project="${projectCwd}">`);
-  parts.push(`DS detectado: ${profileName}`);
-  parts.push(`Localizacao: ${rootPath}`);
-  if (lawContent) {
-    parts.push('--- LEI DO DS (primeiros 3000 chars) ---');
-    parts.push(lawContent);
-  } else {
-    parts.push('(nenhum arquivo de lei encontrado em rootPath)');
-  }
-  parts.push('</ds-grounding>');
-
-  let full = parts.join('\n');
-  if (full.length > MAX_INJECTION_SIZE) {
-    const trailer = '\n[...truncated...]\n</ds-grounding>';
-    full = full.substring(0, MAX_INJECTION_SIZE - trailer.length) + trailer;
-  }
-  return full;
-}
-
-async function main() {
-  const input = await readStdin();
-  if (!input || typeof input !== 'object') return;
-
-  const userPrompt = input.prompt || input.user_prompt || input.message || '';
-  if (!isUIPrompt(userPrompt)) return;
-
-  // Anti-double-injection
-  if (userPrompt.includes('<ds-grounding')) return;
-
-  const cfg = loadConfig();
-  const section = getSection(cfg, 'designSystem');
-  if (!section || !section.rootPath) return;
-
-  const lawFile = findLawFile(section.rootPath);
-  const lawContent = readLaw(lawFile);
-  const projectCwd = input.cwd || process.cwd();
-  const context = buildInjection(section, lawContent, projectCwd);
-
-  const output = JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'UserPromptSubmit',
-      additionalContext: context,
-    },
-  });
-
-  await new Promise((resolve) => {
-    let settled = false;
-    const finish = () => { if (!settled) { settled = true; resolve(); } };
-    try {
-      const flushed = process.stdout.write(output, () => finish());
-      if (flushed) setImmediate(finish);
-    } catch {
-      finish();
-    }
-  });
-}
-
-function run() {
-  const timer = setTimeout(() => process.exit(0), HOOK_TIMEOUT_MS);
-  timer.unref();
-  main()
-    .then(() => { clearTimeout(timer); process.exitCode = 0; })
-    .catch(() => { clearTimeout(timer); process.exitCode = 0; });
-}
-
-if (require.main === module) run();
-
-module.exports = {
-  loadConfig,
-  getSection,
-  isUIPrompt,
-  findLawFile,
-  readLaw,
-  buildInjection,
-  UI_KEYWORDS,
-  CONFIG_PATH,
-  MAX_INJECTION_SIZE,
-};

package/.sinapse-ai/hooks/sinapse-vault-grounding.cjs

@@ -1,194 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * SINAPSE Vault Grounding Hook — UserPromptSubmit (framework-shipped).
- *
- * @story GA-1.6
- *
- * Reads `~/.claude/sinapse-ai-config.yaml` (Story 10.47 schema) and, if the
- * `vault` section is enabled, injects `<vault-grounding>` context into the
- * Claude Code prompt. Closes the gap left by Story 10.47 (which shipped the
- * wizard + library hooks but no executable Claude Code hooks).
- *
- * Coexistence with personal hooks: this file lives at
- *   .sinapse-ai/hooks/sinapse-vault-grounding.cjs
- * and reads `sinapse-ai-config.yaml`. The user's personal
- * `~/.claude/hooks/vault-grounding.cjs` (if present) reads `vault-routing.json`. The two
- * files do not collide (different filenames, different config sources, and
- * fail-open guarantees that running both is safe).
- *
- * Contract:
- *   stdin  : JSON `{ "prompt": "...", "session_id": "...", "cwd": "..." }`
- *   stdout : JSON `{ "hookSpecificOutput": { "hookEventName":
- *            "UserPromptSubmit", "additionalContext": "<vault-grounding>...</vault-grounding>" } }`
- *   exit 0 always (fail-open: silent on every error path).
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const HOOK_TIMEOUT_MS = 3500;
-const MAX_INJECTION_SIZE = 6000; // chars
-const MAX_NOTES = 5;
-const MAX_NOTE_PREVIEW = 500; // chars per note
-const MIN_PROMPT_CHARS = 10;
-const CONFIG_PATH = path.join(os.homedir(), '.claude', 'sinapse-ai-config.yaml');
-
-function readStdin() {
-  return new Promise((resolve) => {
-    let data = '';
-    let settled = false;
-    const finish = (val) => { if (!settled) { settled = true; resolve(val); } };
-    try {
-      process.stdin.setEncoding('utf8');
-      process.stdin.on('error', () => finish(null));
-      process.stdin.on('data', (chunk) => { data += chunk; });
-      process.stdin.on('end', () => {
-        try { finish(JSON.parse(data)); } catch { finish(null); }
-      });
-    } catch {
-      finish(null);
-    }
-  });
-}
-
-// Story 10.47: delegate to the shared grounding config loader instead of
-// duplicating the read+parse. The require is guarded so the hook stays
-// fail-open even if the shared module is somehow absent at runtime.
-function loadConfig() {
-  try {
-    return require('../core/grounding/config-loader.cjs').loadGroundingConfig(CONFIG_PATH);
-  } catch {
-    return null;
-  }
-}
-
-function getSection(cfg, name) {
-  if (!cfg || !cfg.grounding) return null;
-  const s = cfg.grounding[name];
-  if (!s || typeof s !== 'object' || !s.enabled) return null;
-  return s;
-}
-
-/**
- * Pick top-N markdown notes from the vault root, ranked by mtime descending.
- * Returns [{ name, content }]. Truncates each note to MAX_NOTE_PREVIEW chars.
- */
-function pickNotes(vaultPath) {
-  try {
-    if (!vaultPath || !fs.existsSync(vaultPath)) return [];
-    const stat = fs.statSync(vaultPath);
-    if (!stat.isDirectory()) return [];
-
-    const entries = fs.readdirSync(vaultPath, { withFileTypes: true })
-      .filter((e) => e.isFile() && e.name.toLowerCase().endsWith('.md'))
-      .map((e) => {
-        const full = path.join(vaultPath, e.name);
-        try {
-          const s = fs.statSync(full);
-          return { name: e.name, full, mtime: s.mtimeMs };
-        } catch { return null; }
-      })
-      .filter(Boolean);
-
-    entries.sort((a, b) => b.mtime - a.mtime);
-
-    const notes = [];
-    for (const ent of entries.slice(0, MAX_NOTES)) {
-      try {
-        let content = fs.readFileSync(ent.full, 'utf8');
-        if (content.length > MAX_NOTE_PREVIEW) {
-          content = content.substring(0, MAX_NOTE_PREVIEW) + '\n[...truncated...]';
-        }
-        notes.push({ name: ent.name, content });
-      } catch { /* skip unreadable */ }
-    }
-    return notes;
-  } catch {
-    return [];
-  }
-}
-
-function buildInjection(section, notes) {
-  const domain = (Array.isArray(section.domains) && section.domains.length)
-    ? section.domains.join(',')
-    : 'default';
-  const parts = [];
-  parts.push(`<vault-grounding domain="${domain}" mode="summary" vault="${section.path}">`);
-  parts.push('Indice do vault (top notas mais recentes):');
-  if (notes.length === 0) {
-    parts.push('(nenhuma nota .md encontrada no path do vault)');
-  } else {
-    for (const n of notes) {
-      parts.push(`--- ${n.name} ---`);
-      parts.push(n.content);
-    }
-  }
-  parts.push('</vault-grounding>');
-
-  let full = parts.join('\n');
-  if (full.length > MAX_INJECTION_SIZE) {
-    const trailer = '\n[...truncated...]\n</vault-grounding>';
-    full = full.substring(0, MAX_INJECTION_SIZE - trailer.length) + trailer;
-  }
-  return full;
-}
-
-async function main() {
-  const input = await readStdin();
-  if (!input || typeof input !== 'object') return;
-
-  const userPrompt = input.prompt || input.user_prompt || input.message || '';
-  if (typeof userPrompt !== 'string' || userPrompt.trim().length < MIN_PROMPT_CHARS) return;
-
-  // Anti-double-injection: if the prompt already contains <vault-grounding>,
-  // assume another hook (or a previous run) has already injected it.
-  if (userPrompt.includes('<vault-grounding')) return;
-
-  const cfg = loadConfig();
-  const section = getSection(cfg, 'vault');
-  if (!section || !section.path) return;
-
-  const notes = pickNotes(section.path);
-  const context = buildInjection(section, notes);
-
-  const output = JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'UserPromptSubmit',
-      additionalContext: context,
-    },
-  });
-
-  await new Promise((resolve) => {
-    let settled = false;
-    const finish = () => { if (!settled) { settled = true; resolve(); } };
-    try {
-      const flushed = process.stdout.write(output, () => finish());
-      if (flushed) setImmediate(finish);
-    } catch {
-      finish();
-    }
-  });
-}
-
-function run() {
-  const timer = setTimeout(() => process.exit(0), HOOK_TIMEOUT_MS);
-  timer.unref();
-  main()
-    .then(() => { clearTimeout(timer); process.exitCode = 0; })
-    .catch(() => { clearTimeout(timer); process.exitCode = 0; });
-}
-
-if (require.main === module) run();
-
-module.exports = {
-  // Exposed for tests — the executable contract is stdin/stdout.
-  loadConfig,
-  getSection,
-  pickNotes,
-  buildInjection,
-  CONFIG_PATH,
-  MAX_INJECTION_SIZE,
-};

package/bin/lib/register-grounding-hooks.js

@@ -1,145 +0,0 @@
-// bin/lib/register-grounding-hooks.js — register the 3 framework grounding
-// hooks (sinapse-vault, sinapse-ds, sinapse-brand) in `~/.claude/settings.json`.
-//
-// @story GA-1.6
-//
-// Contract:
-// - Idempotent: re-running never duplicates an entry.
-// - Non-destructive: existing UserPromptSubmit hooks (e.g. user's personal
-//   `vault-grounding.cjs`, terminal-bus, etc.) are preserved.
-// - Fail-soft: every error is caught and logged via `notify`; settings.json
-//   is never left in a corrupted state (we read → mutate → write atomically).
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const HOOK_FILENAMES = [
-  'sinapse-vault-grounding.cjs',
-  'sinapse-ds-grounding.cjs',
-  'sinapse-brand-grounding.cjs',
-];
-
-const HOOK_TIMEOUT_MS = 4000;
-
-/**
- * Convert a path to forward slashes for use inside a JSON string. Claude Code
- * on Windows tolerates both, but forward slashes avoid double-escaping issues.
- */
-function toForwardSlash(p) {
-  return p.replace(/\\/g, '/');
-}
-
-/**
- * Build a UserPromptSubmit hook entry block for a given hook absolute path.
- */
-function buildHookEntry(absHookPath) {
-  return {
-    type: 'command',
-    command: `node "${toForwardSlash(absHookPath)}"`,
-    timeout: HOOK_TIMEOUT_MS,
-  };
-}
-
-/**
- * Determine if a UserPromptSubmit `hooks[].command` entry already references
- * one of our hook filenames. Filename-based detection lets us survive path
- * differences (case, trailing slash, .sinapse-ai relocation).
- */
-function commandReferencesHook(commandStr, hookFilename) {
-  if (!commandStr || typeof commandStr !== 'string') return false;
-  return commandStr.includes(hookFilename);
-}
-
-/**
- * Register all 3 grounding hooks in settings.json.
- *
- * @param {object} opts
- * @param {string} opts.settingsPath  Absolute path to `~/.claude/settings.json`.
- * @param {string} opts.hooksDir      Absolute path to `<install>/.sinapse-ai/hooks`.
- * @param {function} [opts.notify]    Optional logger `(msg) => void`.
- * @returns {{added: string[], skipped: string[], errors: string[]}}
- */
-function registerGroundingHooks(opts) {
-  const { settingsPath, hooksDir } = opts;
-  const notify = typeof opts.notify === 'function' ? opts.notify : () => {};
-  const result = { added: [], skipped: [], errors: [] };
-
-  let settings = {};
-  try {
-    if (fs.existsSync(settingsPath)) {
-      const raw = fs.readFileSync(settingsPath, 'utf8');
-      settings = raw.trim() ? JSON.parse(raw) : {};
-    }
-  } catch (err) {
-    result.errors.push(`Could not parse ${settingsPath}: ${err.message}`);
-    notify(`WARN: skipping grounding hook registration — ${err.message}`);
-    return result;
-  }
-
-  if (!settings || typeof settings !== 'object') settings = {};
-  if (!settings.hooks || typeof settings.hooks !== 'object') settings.hooks = {};
-  if (!Array.isArray(settings.hooks.UserPromptSubmit)) settings.hooks.UserPromptSubmit = [];
-
-  // Find or create the matcher block we'll mutate. Prefer an existing block
-  // with `matcher === ''` (the default catch-all) so we group with whatever
-  // is already there.
-  let block = settings.hooks.UserPromptSubmit.find(
-    (b) => b && typeof b === 'object' && (b.matcher === '' || b.matcher === undefined || b.matcher === null),
-  );
-  if (!block) {
-    block = { matcher: '', hooks: [] };
-    settings.hooks.UserPromptSubmit.push(block);
-  }
-  if (!Array.isArray(block.hooks)) block.hooks = [];
-
-  for (const hookName of HOOK_FILENAMES) {
-    const absHookPath = path.join(hooksDir, hookName);
-
-    // Skip registration if the hook file does not exist on disk — registering
-    // a missing file would crash Claude Code on every prompt.
-    if (!fs.existsSync(absHookPath)) {
-      result.errors.push(`Hook file missing: ${absHookPath}`);
-      notify(`WARN: hook file missing, skipping ${hookName}`);
-      continue;
-    }
-
-    // Idempotency: skip if any existing entry references this filename.
-    const alreadyRegistered = settings.hooks.UserPromptSubmit.some((b) => {
-      if (!b || !Array.isArray(b.hooks)) return false;
-      return b.hooks.some((h) => h && commandReferencesHook(h.command, hookName));
-    });
-
-    if (alreadyRegistered) {
-      result.skipped.push(hookName);
-      continue;
-    }
-
-    block.hooks.push(buildHookEntry(absHookPath));
-    result.added.push(hookName);
-    notify(`Registered hook: ${hookName.replace(/\.cjs$/, '')}`);
-  }
-
-  // Persist only if we changed something
-  if (result.added.length > 0) {
-    try {
-      fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
-      fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-    } catch (err) {
-      result.errors.push(`Could not write ${settingsPath}: ${err.message}`);
-      notify(`WARN: could not write settings.json — ${err.message}`);
-    }
-  }
-
-  return result;
-}
-
-module.exports = {
-  registerGroundingHooks,
-  HOOK_FILENAMES,
-  HOOK_TIMEOUT_MS,
-  // Exposed for tests
-  buildHookEntry,
-  commandReferencesHook,
-};