@crewhaus/target-onchain 0.1.7 → 0.2.0

package/dist/index.d.ts

@@ -33,9 +33,9 @@
  * slice) boots the bundle against an in-process anvil fork.
  */
 import { CrewhausError } from "@crewhaus/errors";
-import type { Bundle, IrChainV0 } from "@crewhaus/ir";
+import { type Bundle, type EmitReadmeOptions, type IrChainV0 } from "@crewhaus/ir";
 export declare class TargetEmitError extends CrewhausError {
     readonly name = "TargetEmitError";
     constructor(message: string, cause?: unknown);
 }
-export declare function emitOnchain(ir: IrChainV0): Bundle;
+export declare function emitOnchain(ir: IrChainV0, opts?: EmitReadmeOptions): Bundle;

package/dist/index.js

@@ -34,6 +34,7 @@
  */
 import { CrewhausError } from "@crewhaus/errors";
 import { escapeJsonString } from "@crewhaus/infra-utils";
+import { renderBundleReadme, } from "@crewhaus/ir";
 export class TargetEmitError extends CrewhausError {
     name = "TargetEmitError";
     constructor(message, cause) {
@@ -107,7 +108,7 @@ function renderTrigger(t) {
     }
     return `  { kind: "address", chainId: ${JSON.stringify(t.chainId)}, address: ${JSON.stringify(t.address)}, direction: ${JSON.stringify(t.direction)} }`;
 }
-export function emitOnchain(ir) {
+export function emitOnchain(ir, opts = {}) {
     if (ir.chains.length === 0) {
         throw new TargetEmitError("onchain target requires at least one chain binding");
     }
@@ -209,5 +210,11 @@ export async function acceptOrRedact(payload: string): Promise<{ accept: boolean
 // the structured payload directly. Until then, the emitted bundle is a
 // callable module that downstream daemons or tests import.
 `;
-    return { files: [{ path: "agent.ts", content }] };
+    const files = [{ path: "agent.ts", content }];
+    // Item 42 — generated bundle README; default ON (`crewhaus compile
+    // --no-readme` opts out).
+    if (opts.readme !== false) {
+        files.push({ path: "README.md", content: renderBundleReadme(ir) });
+    }
+    return { files };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/target-onchain",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "type": "module",
   "description": "Codegen for the §47 `onchain` event-driven daemon. Emits a self-contained agent.ts that subscribes to chain triggers, classifies inbound events, dedupes by tx-hash + log-index, and runs one agent turn per event.",
   "main": "dist/index.js",
@@ -15,9 +15,9 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.1.7",
-    "@crewhaus/infra-utils": "0.1.7",
-    "@crewhaus/ir": "0.1.7"
+    "@crewhaus/errors": "0.2.0",
+    "@crewhaus/infra-utils": "0.2.0",
+    "@crewhaus/ir": "0.2.0"
   },
   "license": "Apache-2.0",
   "author": {