@simplium/hive 4.0.0

package/hooks/hive-log.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+/**
+ * HIVE traceability hook (Claude Code PostToolUse, matcher: Task).
+ *
+ * When a HIVE agent is invoked as a subagent via the Task tool, this hook
+ * automatically appends:
+ *   - a row to HIVE-LOG.md          (ISO 42001 A.9 — human-readable audit trail)
+ *   - a line to .claude/hive-events.jsonl  (machine-readable event stream
+ *     for external observability collectors, e.g. Argos)
+ *
+ * Replaces the honor-system footer: logging no longer depends on the agent
+ * remembering to run log-session. Manual log-session remains as fallback
+ * for skills and out-of-band work.
+ *
+ * Design constraints:
+ *   - Zero dependencies (plain Node ≥18) — consumer projects need nothing installed.
+ *   - Never blocks: always exits 0, even on malformed input.
+ *   - Only logs agents that are HIVE adapters (checks the version stamp in
+ *     .claude/agents/<name>.md) — other subagents are ignored.
+ */
+
+import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+
+const LOG_HEADER = `# HIVE Session Log
+
+AI agent invocation log for traceability (ISO 42001 A.9 — logging of AI decision-making events).
+
+Rows are appended automatically by the HIVE hook on Task-tool invocations.
+Manual fallback: \`npm run log-session -- --agent <name> --task "..." --outcome COMPLETED|PARTIAL|FAILED [--tokens N]\`
+
+| Date | Agent | Task | Outcome | Tokens |
+|------|-------|------|---------|--------|
+`;
+
+function sanitizeCell(text, maxLen = 120) {
+  return String(text ?? "")
+    .replace(/\s+/g, " ")
+    .replace(/\|/g, "\\|")
+    .trim()
+    .slice(0, maxLen);
+}
+
+function main() {
+  let input;
+  try {
+    input = JSON.parse(readFileSync(0, "utf-8"));
+  } catch {
+    return; // malformed stdin — never block
+  }
+
+  if (input.hook_event_name !== "PostToolUse" || input.tool_name !== "Task") return;
+
+  const agent = input.tool_input?.subagent_type;
+  if (!agent || !/^[a-z][a-z0-9-]*$/.test(agent)) return;
+
+  const projectDir = input.cwd || process.cwd();
+
+  // Only log HIVE agents: the adapter file must exist and carry the HIVE stamp
+  const adapterPath = join(projectDir, ".claude", "agents", `${agent}.md`);
+  if (!existsSync(adapterPath)) return;
+  const adapterHead = readFileSync(adapterPath, "utf-8").slice(0, 2000);
+  if (!adapterHead.includes("HIVE Framework v")) return;
+
+  const task = sanitizeCell(input.tool_input?.description || input.tool_input?.prompt || "—");
+  const date = new Date().toISOString().split("T")[0];
+
+  // Token count: only if the host provides it in the tool response; never invented
+  const usage = input.tool_response?.usage ?? input.tool_response?.totalTokens ?? undefined;
+  const tokens =
+    typeof usage === "number"
+      ? String(usage)
+      : typeof usage?.total_tokens === "number"
+        ? String(usage.total_tokens)
+        : "—";
+
+  // 1) HIVE-LOG.md (create with header if missing)
+  const logPath = join(projectDir, "HIVE-LOG.md");
+  const row = `| ${date} | ${agent} | ${task} | COMPLETED | ${tokens} |`;
+  if (existsSync(logPath)) {
+    const current = readFileSync(logPath, "utf-8");
+    writeFileSync(logPath, current.trimEnd() + "\n" + row + "\n", "utf-8");
+  } else {
+    writeFileSync(logPath, LOG_HEADER + row + "\n", "utf-8");
+  }
+
+  // 2) JSONL event stream
+  const eventsPath = join(projectDir, ".claude", "hive-events.jsonl");
+  mkdirSync(dirname(eventsPath), { recursive: true });
+  appendFileSync(
+    eventsPath,
+    JSON.stringify({
+      ts: new Date().toISOString(),
+      event: "hive_agent_invocation",
+      agent,
+      task,
+      session_id: input.session_id ?? null,
+    }) + "\n",
+    "utf-8",
+  );
+}
+
+try {
+  main();
+} catch {
+  // never block the tool flow
+}
+process.exit(0);

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@simplium/hive",
+  "version": "4.0.0",
+  "description": "Multi-agent AI framework for software development — 36 specialized agents, NestJS runtime, evidence-based validation, MCP integration",
+  "license": "Apache-2.0",
+  "author": "José (Simplium.io) <servicios@simplium.io>",
+  "homepage": "https://github.com/marcablanca/hive-framework#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marcablanca/hive-framework.git"
+  },
+  "bugs": {
+    "url": "https://github.com/marcablanca/hive-framework/issues"
+  },
+  "keywords": [
+    "ai-agents",
+    "claude",
+    "multi-agent",
+    "nestjs",
+    "mcp",
+    "orchestration",
+    "hive",
+    "llm"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "packageManager": "npm@11.11.0",
+  "bin": {
+    "hive-init": "bin/hive-init.mjs"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "hooks/",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prepack": "tsx scripts/build-package.ts",
+    "test": "vitest run",
+    "lint": "eslint scripts bin hooks --max-warnings 0",
+    "typecheck": "tsc --noEmit",
+    "validate": "tsx scripts/validate.ts",
+    "reindex": "tsx scripts/reindex.ts",
+    "secrets-audit": "tsx scripts/secrets-audit.ts",
+    "adapters": "tsx scripts/generate-adapters.ts",
+    "log-session": "tsx scripts/log-session.ts",
+    "cost-report": "tsx scripts/cost-report.ts",
+    "init-project": "tsx scripts/init-project.ts",
+    "eval": "tsx scripts/eval-layer1.ts"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.109.1",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.20.0",
+    "eslint": "^10.5.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.4",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.61.1",
+    "vitest": "^3.2.6"
+  },
+  "overrides": {
+    "vite": ">=6.4.2"
+  },
+  "dependencies": {
+    "glob": "^11.0.0",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.0",
+    "zod": "^3.23.0"
+  }
+}