@crewhaus/target-onchain-game 0.1.8 → 0.2.0

package/dist/index.d.ts

@@ -32,9 +32,9 @@
  * loop end-to-end against an anvil fork.
  */
 import { CrewhausError } from "@crewhaus/errors";
-import type { Bundle, IrChainGameV0 } from "@crewhaus/ir";
+import { type Bundle, type EmitReadmeOptions, type IrChainGameV0 } from "@crewhaus/ir";
 export declare class TargetEmitError extends CrewhausError {
     readonly name = "TargetEmitError";
     constructor(message: string, cause?: unknown);
 }
-export declare function emitOnchainGame(ir: IrChainGameV0): Bundle;
+export declare function emitOnchainGame(ir: IrChainGameV0, opts?: EmitReadmeOptions): Bundle;

package/dist/index.js

@@ -33,6 +33,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) {
@@ -59,7 +60,7 @@ function renderWalletKeyRef(walletId, ref) {
     }
     return renderSecretRef(ref);
 }
-export function emitOnchainGame(ir) {
+export function emitOnchainGame(ir, opts = {}) {
     if (ir.chain.id !== ir.wallet.chainId) {
         throw new TargetEmitError(`wallet.chainId "${ir.wallet.chainId}" does not match chain.id "${ir.chain.id}"`);
     }
@@ -184,5 +185,11 @@ function selectorOf(method: string): string {
   );
 }
 `;
-    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-game",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "type": "module",
   "description": "Codegen for the §47 `onchain-game` perceive-act-perceive loop. Emits a daemon that reads game state, asks the model for a move, broadcasts the move, awaits confirmation, and repeats.",
   "main": "dist/index.js",
@@ -15,9 +15,9 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.1.8",
-    "@crewhaus/infra-utils": "0.1.8",
-    "@crewhaus/ir": "0.1.8"
+    "@crewhaus/errors": "0.2.0",
+    "@crewhaus/infra-utils": "0.2.0",
+    "@crewhaus/ir": "0.2.0"
   },
   "license": "Apache-2.0",
   "author": {