@hmharness/agent 0.23.24 → 0.23.26

package/dist/code-wm-recorder.d.ts

@@ -1,22 +1,22 @@
-/**
- * @hmharness/agent - Code World Model recorder (production sensor wiring)
- *
- * Round 38 closes the loop the sensors were waiting for: extension page
- * observations now reach a PERSISTED Code World Model. The recorder is a
- * lazy per-home singleton — the first observation loads the model from
- * HMH_HOME, the sensor feeds it, and a debounce flushes to disk. The LSP
- * sensor (round 35) rides the same store once its tools gain an event
- * hook; until then it stays library-only, honestly.
- *
- * Failure posture: everything best-effort — a storage error logs nothing
- * and never breaks the tool that observed the page (evidence must not be
- * able to kill the work it evidences). A crash loses at most one debounce
- * window of observations.
- */
 import { type CodeWorldModel } from '@hmharness/cognitive';
 import type { RawPageData } from '@hmharness/extension';
+import type { Tool } from '@hmharness/kernel';
+import { type CodeWorldSyncInput } from './code-wm-sensor.js';
 /** The onPageRead hook handed to extensionTools — one closure per home. */
 export declare function pageReadSink(home: string): (raw: RawPageData) => void;
+/** The onObserve hook handed to lspTools — the LSP tools' read-only pulls
+ *  become durable Code WM evidence, same store, same debounce. */
+export declare function lspObserveSink(home: string): (obs: CodeWorldSyncInput) => void;
+/** Build facts replace (the model keeps only the LATEST build verdict). */
+export declare function buildSink(home: string): (fact: {
+    ok: boolean;
+    outputDigest?: string;
+}) => void;
+/** Registry-assembly wrapper (round 44): the harmony build tools gain a
+ *  build-fact observation without the domain package learning about
+ *  cognitive. The wrap never alters the tool's result; a sink error is
+ *  swallowed (the observation must not fail the work it evidences). */
+export declare function observeBuildTools(tools: Tool[], home: string): Tool[];
 /** Test isolation: drop caches + pending timers (never used in production). */
 export declare function resetCodeWorldRecorder(): void;
 /** Introspection for tests/status surfaces: the live model for a home. */

package/dist/code-wm-recorder.js

@@ -1,29 +1,74 @@
 /**
  * @hmharness/agent - Code World Model recorder (production sensor wiring)
  *
- * Round 38 closes the loop the sensors were waiting for: extension page
- * observations now reach a PERSISTED Code World Model. The recorder is a
- * lazy per-home singleton — the first observation loads the model from
- * HMH_HOME, the sensor feeds it, and a debounce flushes to disk. The LSP
- * sensor (round 35) rides the same store once its tools gain an event
- * hook; until then it stays library-only, honestly.
+ * Round 38 closed the loop for extension page observations; round 43 adds
+ * the LSP side (lspTools onObserve → symbols/diagnostics); round 44 adds
+ * the build side: the harmony build tools' results become the model's
+ * LATEST BuildFact, wrapped at registry assembly so the domain package
+ * stays single-minded (kernel-only deps — the audit's composition-layer
+ * rule). All three families share the lazy per-home singleton and one
+ * debounced flush. LiveCodeWmSensor remains the wrapper for callers that
+ * own a client and want file-driven syncs; the tool-hook paths share the
+ * ingestion core.
  *
  * Failure posture: everything best-effort — a storage error logs nothing
  * and never breaks the tool that observed the page (evidence must not be
  * able to kill the work it evidences). A crash loses at most one debounce
  * window of observations.
  */
+import { createHash } from 'node:crypto';
 import { loadCodeWorldModel, saveCodeWorldModel } from '@hmharness/cognitive';
 import { syncExtensionRuntime } from "./extension-wm-sensor.js";
+import { syncCodeWorldModel } from "./code-wm-sensor.js";
 const SAVE_DEBOUNCE_MS = 2_000;
 const entries = new Map();
 /** The onPageRead hook handed to extensionTools — one closure per home. */
 export function pageReadSink(home) {
     return (raw) => {
-        void observe(home, raw);
+        void mutate(home, (cwm) => syncExtensionRuntime(cwm, raw));
     };
 }
-async function observe(home, raw) {
+/** The onObserve hook handed to lspTools — the LSP tools' read-only pulls
+ *  become durable Code WM evidence, same store, same debounce. */
+export function lspObserveSink(home) {
+    return (obs) => {
+        if (!obs.symbols?.length && !obs.diagnostics?.length)
+            return;
+        void mutate(home, (cwm) => syncCodeWorldModel(cwm, obs));
+    };
+}
+/** Build facts replace (the model keeps only the LATEST build verdict). */
+export function buildSink(home) {
+    return (fact) => {
+        void mutate(home, (cwm) => cwm.ingest({ build: { ok: fact.ok, ...(fact.outputDigest ? { outputDigest: fact.outputDigest } : {}), at: new Date().toISOString() } }));
+    };
+}
+/** Registry-assembly wrapper (round 44): the harmony build tools gain a
+ *  build-fact observation without the domain package learning about
+ *  cognitive. The wrap never alters the tool's result; a sink error is
+ *  swallowed (the observation must not fail the work it evidences). */
+export function observeBuildTools(tools, home) {
+    const sink = buildSink(home);
+    return tools.map((t) => {
+        if (t.name !== 'harmony_build' && t.name !== 'harmony_cjpm_build')
+            return t;
+        const orig = t.execute.bind(t);
+        const wrapped = {
+            ...t,
+            async execute(args, ctx) {
+                const r = await orig(args, ctx);
+                try {
+                    const out = typeof r.output === 'string' ? r.output : '';
+                    sink({ ok: !r.isError, ...(out ? { outputDigest: createHash('sha256').update(out).digest('hex').slice(0, 16) } : {}) });
+                }
+                catch { /* observation must never fail the tool */ }
+                return r;
+            },
+        };
+        return wrapped;
+    });
+}
+async function mutate(home, fn) {
     try {
         let entry = entries.get(home);
         if (!entry) {
@@ -31,7 +76,7 @@ async function observe(home, raw) {
             entries.set(home, entry);
         }
         const cwm = await entry.load;
-        syncExtensionRuntime(cwm, raw);
+        fn(cwm);
         entry.dirty = true;
         if (!entry.timer) {
             entry.timer = setTimeout(() => {

package/dist/runner.js

@@ -18,7 +18,7 @@ import { opsTools } from '@hmharness/domain-ops';
 import { discoverServers, lspTools } from '@hmharness/lsp';
 import { discoverBrowsers, browserTools } from '@hmharness/browser';
 import { discoverExtensionBridgeSync, extensionTools } from '@hmharness/extension';
-import { pageReadSink } from "./code-wm-recorder.js";
+import { pageReadSink, lspObserveSink, observeBuildTools } from "./code-wm-recorder.js";
 import * as readline from 'node:readline/promises';
 import { stdin } from 'node:process';
 import { baseTools } from "./tools.js";
@@ -39,7 +39,7 @@ export function toServerConfig(c) {
 export const spawnBase = {};
 export function nativeRegistry(depth, opts = {}) {
     const reg = new Registry();
-    reg.registerAll(baseTools).registerAll(harmonyTools).registerAll(opsTools);
+    reg.registerAll(baseTools).registerAll(observeBuildTools(harmonyTools, homeDir())).registerAll(opsTools);
     // W6: LSP Tier-0 code-intelligence tools — registered ONLY when a real
     // server is discoverable on PATH; a machine with no language servers
     // must not carry dead tools. Discovery is synchronous (memoized PATH
@@ -49,7 +49,11 @@ export function nativeRegistry(depth, opts = {}) {
             // healthy-only: a PATH shim whose toolchain lacks the component would
             // register a tool that always errors — skip it, keep the registry honest
             if (discoverServers().some((s) => s.healthy)) {
-                reg.registerAll(lspTools({ workspaceRoot: opts.workspaceRoot ?? process.cwd(), home: homeDir() }));
+                // onObserve feeds the PERSISTED Code World Model (round 43): every
+                // lsp_symbols/lsp_diagnostics pull becomes durable entity/relation/
+                // diagnostic evidence — best-effort, same store as the extension
+                // recorder, never able to fail the tool that observed.
+                reg.registerAll(lspTools({ workspaceRoot: opts.workspaceRoot ?? process.cwd(), home: homeDir(), onObserve: lspObserveSink(homeDir()) }));
             }
         }
         catch { /* lsp optional: never block tool assembly */ }

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "@hmharness/agent",
-  "version": "0.23.24",
-  "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json"
-  },
-  "dependencies": {
-    "@hmharness/cognitive": "0.23.24",
-    "@hmharness/domain-harmony": "0.23.24",
-    "@hmharness/domain-ops": "0.23.24",
-    "@hmharness/evolution": "0.23.24",
-    "@hmharness/kernel": "0.23.24",
-    "@hmharness/observability": "0.23.24",
-    "@hmharness/sandbox": "0.23.24",
-    "@hmharness/lsp": "0.23.24",
-    "@hmharness/browser": "0.23.24",
-    "@hmharness/extension": "0.23.24"
-  },
-  "files": [
-    "dist"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/swsgbl/hmharness.git"
-  },
-  "engines": {
-    "node": ">=22"
-  }
-}
+{
+  "name": "@hmharness/agent",
+  "version": "0.23.26",
+  "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@hmharness/cognitive": "0.23.26",
+    "@hmharness/domain-harmony": "0.23.26",
+    "@hmharness/domain-ops": "0.23.26",
+    "@hmharness/evolution": "0.23.26",
+    "@hmharness/kernel": "0.23.26",
+    "@hmharness/observability": "0.23.26",
+    "@hmharness/sandbox": "0.23.26",
+    "@hmharness/lsp": "0.23.26",
+    "@hmharness/browser": "0.23.26",
+    "@hmharness/extension": "0.23.26"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swsgbl/hmharness.git"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}