@rendotdev/rig 0.0.17 → 0.0.19

package/dist/{create-59myk91d.js → create-pvym2abv.js}

@@ -1,18 +1,17 @@
 import {
   ToolLoader
-} from "./cli-7zqnqrah.js";
+} from "./cli-f7p31fzm.js";
 import {
   RigToolEntryFiles,
   ToolDiscoveryService
-} from "./cli-vx11bmzr.js";
+} from "./cli-1hm5dxfw.js";
 import {
   RigConfigStore
-} from "./cli-xv4m20sx.js";
-import"./cli-aj56a1ja.js";
+} from "./cli-nk194xv0.js";
 import {
   RigError
 } from "./cli-1c7te5cg.js";
-import"./cli-ne7ed594.js";
+import"./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 
 // src/tools/create.ts
@@ -51,12 +50,12 @@ class ToolCreator {
   name: ${JSON.stringify(name)},
   description: "Describe what this tool does.",
   commands: {
-    example: rig.command({
+    example: rig.defineCommand({
       description: "Example command. Replace this with a real command.",
-      input: rig.input({
+      input: rig.z.object({
         text: rig.z.string().default("example"),
       }),
-      output: rig.output({
+      output: rig.z.object({
         text: rig.z.string(),
       }),
       examples: [

package/dist/cron-aw908dzn.js

@@ -0,0 +1,18 @@
+import {
+  RigCronService,
+  RigCronWorker,
+  cronModuleUrl
+} from "./cli-es8j6mma.js";
+import"./cli-113n7c3t.js";
+import"./cli-884hpkjc.js";
+import"./cli-f7p31fzm.js";
+import"./cli-1hm5dxfw.js";
+import"./cli-nk194xv0.js";
+import"./cli-1c7te5cg.js";
+import"./cli-13q90bjr.js";
+import"./cli-b7jgjgy7.js";
+export {
+  cronModuleUrl,
+  RigCronWorker,
+  RigCronService
+};

package/dist/{dev-link-jpte1gq9.js → dev-link-e1mj8w17.js}

@@ -3,7 +3,7 @@ import {
 } from "./cli-1c7te5cg.js";
 import {
   RigPaths
-} from "./cli-ne7ed594.js";
+} from "./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 
 // src/dev/dev-link.ts
@@ -29,7 +29,10 @@ class DevLinkService {
       });
     }
     await mkdir(binDir, { recursive: true });
-    await writeFile(shimPath, this.shimSource(repoRoot), "utf8");
+    if (typeof Bun !== "undefined")
+      await Bun.write(shimPath, this.shimSource(repoRoot));
+    else
+      await writeFile(shimPath, this.shimSource(repoRoot), "utf8");
     await chmod(shimPath, 493);
     return this.status(options);
   }
@@ -102,7 +105,7 @@ class DevLinkService {
     return `#!/usr/bin/env bash
 # Rig dev shim. Safe to overwrite with \`rig dev link\`.
 RIG_DEV_REPO=${JSON.stringify(repoRoot)}
-exec bun run "$RIG_DEV_REPO/src/cli.ts" "$@"
+exec bun --install=fallback run "$RIG_DEV_REPO/src/cli.ts" "$@"
 `;
   }
   async readExistingShim(shimPath) {
@@ -111,7 +114,7 @@ exec bun run "$RIG_DEV_REPO/src/cli.ts" "$@"
     const stat = await lstat(shimPath);
     if (!stat.isFile())
       return { exists: true, isRigDevShim: false, content: "" };
-    const content = await readFile(shimPath, "utf8");
+    const content = typeof Bun !== "undefined" ? await Bun.file(shimPath).text() : await readFile(shimPath, "utf8");
     return {
       exists: true,
       isRigDevShim: content.includes("Rig dev shim"),

package/dist/{discover-fd9e6j9j.js → discover-95bpzy46.js}

@@ -1,11 +1,10 @@
 import {
   RigToolEntryFiles,
   ToolDiscoveryService
-} from "./cli-vx11bmzr.js";
-import"./cli-xv4m20sx.js";
-import"./cli-aj56a1ja.js";
+} from "./cli-1hm5dxfw.js";
+import"./cli-nk194xv0.js";
 import"./cli-1c7te5cg.js";
-import"./cli-ne7ed594.js";
+import"./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 export {
   ToolDiscoveryService,

package/dist/{help-6k8m07yv.js → help-qj75r0x3.js}

@@ -1,17 +1,16 @@
 import {
   SchemaRenderer
-} from "./cli-dshh1cp9.js";
+} from "./cli-884hpkjc.js";
 import {
   CommandIds,
   ToolLoader
-} from "./cli-7zqnqrah.js";
-import"./cli-vx11bmzr.js";
-import"./cli-xv4m20sx.js";
-import"./cli-aj56a1ja.js";
+} from "./cli-f7p31fzm.js";
+import"./cli-1hm5dxfw.js";
+import"./cli-nk194xv0.js";
 import {
   RigError
 } from "./cli-1c7te5cg.js";
-import"./cli-ne7ed594.js";
+import"./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 
 // src/tools/help.ts

package/dist/{inspect-ks3x7s4n.js → inspect-0ckw7bs5.js}

@@ -1,17 +1,16 @@
 import {
   SchemaRenderer
-} from "./cli-dshh1cp9.js";
+} from "./cli-884hpkjc.js";
 import {
   CommandIds,
   ToolLoader
-} from "./cli-7zqnqrah.js";
-import"./cli-vx11bmzr.js";
-import"./cli-xv4m20sx.js";
-import"./cli-aj56a1ja.js";
+} from "./cli-f7p31fzm.js";
+import"./cli-1hm5dxfw.js";
+import"./cli-nk194xv0.js";
 import {
   RigError
 } from "./cli-1c7te5cg.js";
-import"./cli-ne7ed594.js";
+import"./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 
 // src/tools/inspect.ts

package/dist/list-reekhy3q.js

@@ -0,0 +1,13 @@
+import {
+  ToolListService
+} from "./cli-zgw1jbeg.js";
+import"./cli-884hpkjc.js";
+import"./cli-f7p31fzm.js";
+import"./cli-1hm5dxfw.js";
+import"./cli-nk194xv0.js";
+import"./cli-1c7te5cg.js";
+import"./cli-13q90bjr.js";
+import"./cli-b7jgjgy7.js";
+export {
+  ToolListService
+};

package/dist/{paths-hq1vy0wh.js → paths-3vxw7dek.js}

@@ -1,6 +1,6 @@
 import {
   RigPaths
-} from "./cli-ne7ed594.js";
+} from "./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 export {
   RigPaths

package/dist/{registry-gng9br0x.js → registry-fzc3aeb8.js}

@@ -1,13 +1,12 @@
 import {
   RigConfigStore
-} from "./cli-xv4m20sx.js";
-import"./cli-aj56a1ja.js";
+} from "./cli-nk194xv0.js";
 import {
   RigError
 } from "./cli-1c7te5cg.js";
 import {
   RigPaths
-} from "./cli-ne7ed594.js";
+} from "./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 
 // src/registry/registry.ts

package/dist/rig.js

@@ -1,11 +1,19 @@
 #!/usr/bin/env node
+import {
+  RigCronWorker
+} from "./cli-es8j6mma.js";
+import"./cli-113n7c3t.js";
+import"./cli-884hpkjc.js";
+import"./cli-f7p31fzm.js";
+import"./cli-1hm5dxfw.js";
 import {
   RigPackageRoot
-} from "./cli-aj56a1ja.js";
+} from "./cli-nk194xv0.js";
 import {
   RigError,
   RigErrors
 } from "./cli-1c7te5cg.js";
+import"./cli-13q90bjr.js";
 import {
   __require
 } from "./cli-b7jgjgy7.js";
@@ -32,7 +40,7 @@ class BunRuntimeBootstrap {
     const bunPath = this.resolveBunPath();
     if (!bunPath)
       return;
-    const result = this.spawn(bunPath, [fileURLToPath(metaUrl), ...argv.slice(2)], {
+    const result = this.spawn(bunPath, [this.autoInstallFlag(), fileURLToPath(metaUrl), ...argv.slice(2)], {
       stdio: "inherit",
       env: { ...this.env, RIG_BUN_BOOTSTRAPPED: "1" }
     });
@@ -50,6 +58,9 @@ class BunRuntimeBootstrap {
     ].filter((value) => Boolean(value));
     return candidates.find((candidate) => existsSync(candidate));
   }
+  autoInstallFlag() {
+    return "--install=fallback";
+  }
 }
 
 class CliApplication {
@@ -84,17 +95,22 @@ class CliApplication {
     this.configureEditCommand();
     this.configureRemoveCommand();
     this.configureRunCommand();
+    this.configureCronCommands();
     this.configureTypecheckCommand();
     this.configureDevCommands();
     this.configureUpdateCommand();
     this.program.command("help").argument("[target]", "Tool name or command id (<tool>.<command>).").description("Print general help or tool docs.").action(async (target) => {
       if (!target) {
         const readmePath = join(fileURLToPath(import.meta.url), "..", "..", "README.md");
-        console.log(existsSync(readmePath) ? readFileSync(readmePath, "utf8") : this.program.helpInformation());
+        if (existsSync(readmePath)) {
+          console.log(readFileSync(readmePath, "utf8"));
+        } else {
+          console.log(this.program.helpInformation());
+        }
         return;
       }
       this.requestGeneratedSync();
-      const { ToolHelpService } = await import("./help-6k8m07yv.js");
+      const { ToolHelpService } = await import("./help-qj75r0x3.js");
       console.log(await new ToolHelpService(this.pathOptions()).render(target));
     });
   }
@@ -111,37 +127,37 @@ class CliApplication {
   configureConfigCommands() {
     const configCommand = this.program.command("config").description("Manage Rig config.");
     configCommand.command("show").description("Print config JSON.").action(async () => {
-      const { RigConfigStore } = await import("./config-24gwe08t.js");
+      const { RigConfigStore } = await import("./config-20f90shh.js");
       const configStore = new RigConfigStore(this.pathOptions());
       await configStore.ensure();
       this.printJson(await configStore.read());
     });
     configCommand.command("path").description("Print absolute config path.").action(async () => {
-      const { RigPaths } = await import("./paths-hq1vy0wh.js");
+      const { RigPaths } = await import("./paths-3vxw7dek.js");
       console.log(new RigPaths(this.pathOptions()).configPath);
     });
   }
   configureRegistryCommands() {
     const registryCommand = this.program.command("registry").description("Manage tool registries.");
     registryCommand.command("list").description("List registries as JSON.").action(async () => {
-      const { RegistryConfigService } = await import("./registry-gng9br0x.js");
+      const { RegistryConfigService } = await import("./registry-fzc3aeb8.js");
       this.printJson(await new RegistryConfigService(this.pathOptions()).list());
     });
     registryCommand.command("create").argument("[path]").description("Add a custom registry. Defaults to the current directory.").action(async (pathValue) => {
       this.requestGeneratedSync();
-      const { RegistryConfigService } = await import("./registry-gng9br0x.js");
+      const { RegistryConfigService } = await import("./registry-fzc3aeb8.js");
       this.printJson(await new RegistryConfigService(this.pathOptions()).add(pathValue ?? process.cwd()));
     });
     registryCommand.command("remove").argument("<path>").description("Remove a custom registry.").action(async (pathValue) => {
       this.requestGeneratedSync();
-      const { RegistryConfigService } = await import("./registry-gng9br0x.js");
+      const { RegistryConfigService } = await import("./registry-fzc3aeb8.js");
       this.printJson(await new RegistryConfigService(this.pathOptions()).remove(pathValue));
     });
   }
   configureListCommand() {
     this.program.command("list").alias("ls").description("List discovered tools and commands.").option("--json", "Print full JSON metadata.").option("--plain", "Print a compact plain text command list.").option("--for-path <path>", "Only list tools from registries visible from a path.").action(async (commandOptions) => {
       this.requestGeneratedSync();
-      const { ToolListService } = await import("./list-f7r354tq.js");
+      const { ToolListService } = await import("./list-reekhy3q.js");
       const service = new ToolListService(this.pathOptions());
       const data = await service.list({ visibleFromPath: commandOptions.forPath });
       if (commandOptions.json)
@@ -153,7 +169,7 @@ class CliApplication {
   configureInspectCommand() {
     this.program.command("inspect").argument("<target>", "Tool name or command id (<tool>.<command>.)").description("Print tool or command metadata as JSON.").action(async (target) => {
       this.requestGeneratedSync();
-      const { ToolInspector } = await import("./inspect-ks3x7s4n.js");
+      const { ToolInspector } = await import("./inspect-0ckw7bs5.js");
       this.printJson(await new ToolInspector(this.pathOptions()).inspect(target));
     });
   }
@@ -166,7 +182,7 @@ class CliApplication {
   configureEditCommand() {
     this.program.command("edit").argument("<tool>").description("Print the TypeScript file path for a tool.").action(async (name) => {
       this.requestGeneratedSync();
-      const { ToolFileService } = await import("./create-59myk91d.js");
+      const { ToolFileService } = await import("./create-pvym2abv.js");
       const result = await new ToolFileService(this.pathOptions()).path(name);
       console.log(result.toolPath);
     });
@@ -174,7 +190,7 @@ class CliApplication {
   configureRemoveCommand() {
     this.program.command("remove").argument("<tool>").description("Remove a local tool directory.").action(async (name) => {
       this.requestGeneratedSync();
-      const { ToolRemover } = await import("./create-59myk91d.js");
+      const { ToolRemover } = await import("./create-pvym2abv.js");
       const result = await new ToolRemover(this.pathOptions()).remove(name);
       console.log(`Removed tool ${result.name}`);
       console.log(`Tool directory: ${result.toolDir}`);
@@ -186,10 +202,39 @@ class CliApplication {
       await this.runToolCommand(commandId, args, commandOptions);
     });
   }
+  configureCronCommands() {
+    const cronCommand = this.program.command("cron").description("Manage scheduled Rig tool commands.");
+    cronCommand.command("list").description("List scheduled Rig tool commands as JSON.").action(async () => {
+      const { RigCronService } = await import("./cron-aw908dzn.js");
+      this.printJson(await new RigCronService(this.pathOptions()).list());
+    });
+    cronCommand.command("add").argument("<name>", "Unique job name, using letters, numbers, hyphens, or underscores.").argument("<command>", "Command id, formatted as <tool>.<command>.").argument("<schedule>", "Cron expression or nickname, such as @weekly.").description("Schedule a Rig tool command with fixed JSON input.").option("--input <json>", "JSON input string.").option("--input-file <path>", "Read JSON input from a file.").action(async (name, commandId, schedule, commandOptions) => {
+      const { cronModuleUrl, RigCronService } = await import("./cron-aw908dzn.js");
+      const result = await new RigCronService(this.pathOptions()).add({
+        name,
+        command: commandId,
+        schedule,
+        input: commandOptions.input,
+        inputFile: commandOptions.inputFile,
+        moduleUrl: cronModuleUrl(import.meta.url)
+      });
+      this.printJson(result);
+    });
+    cronCommand.command("remove").argument("<name>", "Cron job name.").description("Remove a scheduled Rig tool command.").action(async (name) => {
+      const { RigCronService } = await import("./cron-aw908dzn.js");
+      this.printJson(await new RigCronService(this.pathOptions()).remove(name));
+    });
+    cronCommand.command("run").argument("<name>", "Cron job name.").description("Run a scheduled Rig tool command now.").action(async (name) => {
+      const { RigCronService } = await import("./cron-aw908dzn.js");
+      const result = await new RigCronService(this.pathOptions()).run(name);
+      this.printJson(result.envelope);
+      process.exitCode = result.exitCode;
+    });
+  }
   configureTypecheckCommand() {
     this.program.command("typecheck").argument("[tool]").description("Type-check local tool files with the injected Rig tool runtime types.").action(async (tool) => {
       this.requestGeneratedSync();
-      const { ToolTypecheckService } = await import("./typecheck-c2k87ppw.js");
+      const { ToolTypecheckService } = await import("./typecheck-971tmqbp.js");
       const result = await new ToolTypecheckService(this.pathOptions()).typecheck(tool);
       this.printJson(result);
       process.exitCode = result.exitCode;
@@ -219,7 +264,7 @@ class CliApplication {
   configureDevCommands() {
     const devCommand = this.program.command("dev").description("Local development helpers.");
     devCommand.command("link").description("Link this checkout as the local rig command for development.").option("--bin-dir <path>", "Directory where the rig shim should be written.").option("--force", "Overwrite an existing non-Rig shim.").action(async (commandOptions) => {
-      const { DevLinkService } = await import("./dev-link-jpte1gq9.js");
+      const { DevLinkService } = await import("./dev-link-e1mj8w17.js");
       const service = new DevLinkService(this.pathOptions());
       const status = await service.link({
         binDir: commandOptions.binDir,
@@ -228,7 +273,7 @@ class CliApplication {
       console.log(service.renderLinkResult(status));
     });
     devCommand.command("unlink").description("Remove the local rig development shim.").option("--bin-dir <path>", "Directory where the rig shim was written.").option("--force", "Remove even if the file is not a Rig dev shim.").action(async (commandOptions) => {
-      const { DevLinkService } = await import("./dev-link-jpte1gq9.js");
+      const { DevLinkService } = await import("./dev-link-e1mj8w17.js");
       const service = new DevLinkService(this.pathOptions());
       const status = await service.unlink({
         binDir: commandOptions.binDir,
@@ -237,12 +282,12 @@ class CliApplication {
       console.log(service.renderUnlinkResult(status));
     });
     devCommand.command("status").description("Show local rig development shim status as JSON.").option("--bin-dir <path>", "Directory where the rig shim should be checked.").action(async (commandOptions) => {
-      const { DevLinkService } = await import("./dev-link-jpte1gq9.js");
+      const { DevLinkService } = await import("./dev-link-e1mj8w17.js");
       this.printJson(await new DevLinkService(this.pathOptions()).status(commandOptions));
     });
   }
   async runToolCommand(commandId, args, commandOptions) {
-    const { ToolRunner } = await import("./run-y66hvyxg.js");
+    const { ToolRunner } = await import("./run-thx15p83.js");
     const commandTarget = this.commandTarget(commandId);
     const result = await new ToolRunner(this.pathOptions()).run(commandTarget.tool, commandTarget.command, {
       ...this.pathOptions(),
@@ -256,9 +301,9 @@ class CliApplication {
   }
   async showDefaultStatus() {
     const [{ RigConfigStore }, { RigPaths }, { ToolDiscoveryService }] = await Promise.all([
-      import("./config-24gwe08t.js"),
-      import("./paths-hq1vy0wh.js"),
-      import("./discover-fd9e6j9j.js")
+      import("./config-20f90shh.js"),
+      import("./paths-3vxw7dek.js"),
+      import("./discover-95bpzy46.js")
     ]);
     const options = this.pathOptions();
     const paths = new RigPaths(options);
@@ -266,8 +311,11 @@ class CliApplication {
     const config = await configStore.ensure();
     const tools = await new ToolDiscoveryService(options).discover();
     const registries = configStore.registryEntries(config);
+    const currentVersion = this.version();
+    this.printMigrationNotice(configStore.migrationResult());
     console.log(`Rig is ready.
 `);
+    console.log(`Version:       ${currentVersion}`);
     console.log(`Config:        ${paths.configPath}`);
     console.log(`Base registry: ${registries[0]?.path}`);
     console.log(`Tools found:   ${tools.length}`);
@@ -276,10 +324,10 @@ Next steps:`);
     console.log("  rig list");
     console.log(`
 Run "rig doctor" if you want to verify your setup.`);
-    await this.printUpdateNotice();
+    await this.printUpdateNotice(currentVersion);
   }
   async createTool(name) {
-    const { ToolCreator } = await import("./create-59myk91d.js");
+    const { ToolCreator } = await import("./create-pvym2abv.js");
     const result = await new ToolCreator(this.pathOptions()).create(name);
     console.log(`Created tool ${result.name}`);
     console.log(`
@@ -299,14 +347,15 @@ Try:`);
   }
   async doctor() {
     const [{ RigConfigStore }, { RigPaths }, { ToolDiscoveryService }] = await Promise.all([
-      import("./config-24gwe08t.js"),
-      import("./paths-hq1vy0wh.js"),
-      import("./discover-fd9e6j9j.js")
+      import("./config-20f90shh.js"),
+      import("./paths-3vxw7dek.js"),
+      import("./discover-95bpzy46.js")
     ]);
     const options = this.pathOptions();
     const paths = new RigPaths(options);
     const configStore = new RigConfigStore(options);
     const config = await configStore.ensure();
+    this.printMigrationNotice(configStore.migrationResult());
     const registries = configStore.registryEntries(config);
     const tools = await new ToolDiscoveryService(options).discover();
     console.log(`Rig doctor
@@ -320,12 +369,31 @@ Try:`);
     console.log(`Tools:         ${tools.length}`);
     console.log(`
 Status: OK`);
-    await this.printUpdateNotice();
+    await this.printUpdateNotice(this.version());
   }
-  async printUpdateNotice() {
+  printMigrationNotice(migration) {
+    if (!migration)
+      return;
+    if (migration.status === "migrated") {
+      console.log("Rig moved its home folder:");
+      console.log(`  From: ${migration.legacyDir}`);
+      console.log(`  To:   ${migration.currentDir}`);
+      if (migration.configUpdated)
+        console.log("  Updated base registry: ~/rig/tools");
+      console.log("");
+      return;
+    }
+    console.log("Rig home folder migration needs your attention:");
+    console.log(`  Old folder: ${migration.legacyDir}`);
+    console.log(`  New folder: ${migration.currentDir}`);
+    console.log(`  Reason: ${migration.reason}`);
+    console.log("Move the files you want to keep into the new folder, then remove the old folder.");
+    console.log("");
+  }
+  async printUpdateNotice(currentVersion) {
     await this.ignoreSyncErrors(async () => {
-      const { NpmUpdateCheckService } = await import("./update-check-87p71vrc.js");
-      const notice = await new NpmUpdateCheckService(this.pathOptions()).check(this.version());
+      const { NpmUpdateCheckService } = await import("./update-check-dpkh7hc6.js");
+      const notice = await new NpmUpdateCheckService(this.pathOptions()).check(currentVersion);
       if (notice)
         console.log(`
 ${notice.message}`);
@@ -336,13 +404,13 @@ ${notice.message}`);
   }
   async syncGeneratedFiles() {
     await this.ignoreSyncErrors(async () => {
-      const { ToolRuntimeCommentSyncService } = await import("./runtime-comment-gvmkkcyh.js");
+      const { ToolRuntimeCommentSyncService } = await import("./runtime-comment-07cpchsr.js");
       await new ToolRuntimeCommentSyncService(this.pathOptions()).sync();
     });
     if (process.env.RIG_AGENT_SYNC === "0")
       return;
     await this.ignoreSyncErrors(async () => {
-      const { AgentInstructionSyncService } = await import("./sync-zsc35m3f.js");
+      const { AgentInstructionSyncService } = await import("./sync-kkqh3axx.js");
       await new AgentInstructionSyncService(this.pathOptions()).sync();
     });
   }
@@ -400,6 +468,7 @@ if (isCliEntrypoint(import.meta.url)) {
 }
 export {
   isCliEntrypoint,
+  RigCronWorker,
   CliApplication,
   BunRuntimeBootstrap
 };

package/dist/run-thx15p83.js

@@ -0,0 +1,13 @@
+import {
+  ToolRunner
+} from "./cli-113n7c3t.js";
+import"./cli-884hpkjc.js";
+import"./cli-f7p31fzm.js";
+import"./cli-1hm5dxfw.js";
+import"./cli-nk194xv0.js";
+import"./cli-1c7te5cg.js";
+import"./cli-13q90bjr.js";
+import"./cli-b7jgjgy7.js";
+export {
+  ToolRunner
+};

package/dist/{runtime-comment-gvmkkcyh.js → runtime-comment-07cpchsr.js}

@@ -1,10 +1,9 @@
 import {
   ToolDiscoveryService
-} from "./cli-vx11bmzr.js";
-import"./cli-xv4m20sx.js";
-import"./cli-aj56a1ja.js";
+} from "./cli-1hm5dxfw.js";
+import"./cli-nk194xv0.js";
 import"./cli-1c7te5cg.js";
-import"./cli-ne7ed594.js";
+import"./cli-13q90bjr.js";
 import"./cli-b7jgjgy7.js";
 
 // src/tools/runtime-comment.ts
@@ -17,19 +16,26 @@ Rig tool runtime:
 - Export a default \`RigToolFactory\`: \`const tool: RigToolFactory = (rig) => rig.defineTool({ ... }); export default tool;\`.
 - \`rig.z\` is Zod. Docs: https://zod.dev/
 - \`rig.defineTool(definition)\` defines the tool.
-- \`rig.command(definition)\` defines one command.
-- \`rig.input(shapeOrSchema)\` validates command input.
-- \`rig.output(shapeOrSchema)\` validates command output.
+- \`rig.defineCommand(definition)\` defines one command with \`{ description, input, output, run }\`.
+- Use \`rig.z.object({ ... })\` for input/output schemas.
 - \`rig.run({ command: "tool.command", input })\` runs another registered Rig command and returns its data.
 - \`rig.$\` runs a Bun Shell tagged template command with escaped interpolations. Docs: https://bun.com/docs/runtime/shell
 - \`rig.args()\` builds argv arrays with \`.raw()\`, \`.flag()\`, \`.value()\`, \`.values()\`, and \`.toArray()\`.
 - \`rig.paths.home()\`, \`rig.paths.resolve(cwd, path)\`, \`rig.paths.ensureParent(path)\`, and \`rig.paths.size(path)\` cover common path work.
+- Add \`env: rig.z.object({ KEY: rig.z.string() })\` to validate a \`.env\` file beside the tool entry file and receive parsed values on \`context.env\`.
+
+Tool SQLite database:
+- Add \`setupDb: (db) => { db.migrate(1, "create table", "create table ..."); }\` when a tool needs persistent state.
+- Rig stores the database beside the tool entry file as \`index.sqlite\` and runs \`setupDb\` before every command.
+- \`db\` is Bun SQLite with \`strict: true\`, WAL mode, and an extra \`db.migrate(version, name, sql)\` helper. Docs: https://bun.com/docs/runtime/sqlite
 
 Command run context:
-- Use \`run: async (context) => { ... }\`. Do not destructure the context object in examples.
 - \`context.input\` is already validated by the input schema.
-- \`context.env\` is the process environment.
+- \`context.env\` is already validated by the tool env schema when defined.
+- \`context.processEnv\` is the process environment.
 - \`context.cwd\` is the current working directory.
+- \`context.db\` is available when the tool defines \`setupDb\`.
+- \`context.rig\` is the toolkit (same as the factory \`rig\` arg, useful for nested tool calls).
 - Return a value that matches the output schema.
 `;