@yansirplus/cli 0.5.19 → 0.5.20

package/agent-catalog/agentOS/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: agentOS
-description: Generated installed catalog for agentOS 0.5.19 public packages, API intent, agent navigation, invariants, errors, and provenance.
+description: Generated installed catalog for agentOS 0.5.20 public packages, API intent, agent navigation, invariants, errors, and provenance.
 ---
 
 # agentOS
 
-This catalog is generated for `@yansirplus/cli` 0.5.19. Treat files under `references/` as installed-version facts; do not infer future API from chat context, archived CST events, or source checkouts.
+This catalog is generated for `@yansirplus/cli` 0.5.20. Treat files under `references/` as installed-version facts; do not infer future API from chat context, archived CST events, or source checkouts.
 
 ## Routes
 

package/agent-catalog/agentOS/references/package-map.md

@@ -1,6 +1,6 @@
 # agentOS Package Map
 
-Release version: `0.5.19`
+Release version: `0.5.20`
 Published scope: `@yansirplus`
 
 ## Packages

package/agent-catalog/agentOS/references/provenance.json

@@ -9,7 +9,7 @@
   "package": {
     "sourcePackage": "@agent-os/cli",
     "publicPackage": "@yansirplus/cli",
-    "version": "0.5.19",
+    "version": "0.5.20",
     "publicScope": "@yansirplus",
     "catalogRoot": "agent-catalog/agentOS"
   },
@@ -145,32 +145,32 @@
     },
     {
       "path": "package.json",
-      "sha256": "02940aa4cd34acac3b0b5bb1f39927754e94a23ce9b2a70a155004acb2e3afd4",
+      "sha256": "7602f432f07aa72589a6700f26c491d50329094f6fd9770bc709827d344ad978",
       "byteSize": 5045
     },
     {
       "path": "packages/cli/package.json",
-      "sha256": "1c2159ba24e9ef008bea31a4f6eed0b884f1b882479536ef4a0fcf8626696f57",
+      "sha256": "19cdc2e6c3f13e24d6fe89b16af99aca6874aac7d31d2793d2e5e5b2ae5279fc",
       "byteSize": 691
     },
     {
       "path": "packages/client/package.json",
-      "sha256": "d408d2940177fd71f73c9041d87043c476544738df9a7945eb09f2c99995ebb9",
+      "sha256": "a6670af7b93bb94056c0a7a197c163a95f5c6a19f8daabb946f90e1efa7e37e5",
       "byteSize": 1246
     },
     {
       "path": "packages/core/package.json",
-      "sha256": "d034f01df3a182485df8fc213441b0aaeaf3ab0cf2ea10fc2364f1ee8f11df42",
+      "sha256": "34367092b56381ca66738c7cd30d8e1adfa4ccc157fad1bc688aa4b15e5982a3",
       "byteSize": 3570
     },
     {
       "path": "packages/evals/package.json",
-      "sha256": "d1b6aed4f7db19c6052b9ec9358e720ced7b106ef4ad2bd6d7cc9d37b0ab161d",
+      "sha256": "fd6521f1780f51af6f7d1c48df2b3274a092b3d46787775b0089ee2e45948723",
       "byteSize": 532
     },
     {
       "path": "packages/runtime/package.json",
-      "sha256": "b1ab0889c3af19999d41f66da04e54f99c24e1b3c76f88845a6b80653e17eed3",
+      "sha256": "0802aae1fdb5e02f8f893fee7841b9a87eb97c86ad1577aa657648121dd4c30b",
       "byteSize": 4008
     },
     {
@@ -182,12 +182,12 @@
   "outputFiles": [
     {
       "path": "agent-catalog/agentOS/SKILL.md",
-      "sha256": "a4acb0b6cdfbfa2accd1189d49f6993801dffd63be0972911b87218efee53999",
+      "sha256": "4969cd3ac708ef73aff1d0ce75d61bd89cbe03179f0b947e5d7540c19388548c",
       "byteSize": 1048
     },
     {
       "path": "agent-catalog/agentOS/references/package-map.md",
-      "sha256": "da752eace7b9c924dfae92c3bb613caaf9dc2c6e367ddc444e892439d3ec8f0e",
+      "sha256": "5e59a7b83caaf33b6214e0c5d776ecc3a7bc4306bc4ce8399052ecc3e16d260e",
       "byteSize": 14055
     },
     {

package/dist/main.mjs

@@ -12,19 +12,6 @@ import {
   restoreConsumer,
 } from "./consumer-overlay.mjs";
 import { releaseStatus } from "./release-status.mjs";
-import {
-  algorithmicCheckerAcceptsArgs,
-  hasAlgorithmicChecker,
-  runAlgorithmicChecker,
-} from "./check/algorithmic-checks.mjs";
-import {
-  deriveAffectedGates,
-  printAffectedGates,
-  runAffectedGates,
-} from "./check/gate-selector.mjs";
-import { runDefaultGate } from "./check/default-gate.mjs";
-import { runEffectScanGate } from "./check/effect-scan-gate.mjs";
-import { listGuards, runGroup, runGuard } from "./runner.mjs";
 
 const packageRootFromMain = () => path.dirname(path.dirname(fileURLToPath(import.meta.url)));
 
@@ -110,6 +97,9 @@ const expectNoExtraArgs = (args, command) => {
   }
 };
 
+const isHelpCommand = (command) =>
+  command === undefined || command === "--help" || command === "-h";
+
 const runBuildRunner = async (command, args) => {
   const runner = fileURLToPath(new URL("./build/build-cli.js", import.meta.url));
   const bundled = await bundleModuleForNode(runner, {
@@ -154,6 +144,21 @@ const runEval = async (args) => runBuildRunner("eval", args);
 
 const runPreflight = async (args) => runBuildRunner("preflight", args);
 
+const loadRunner = () => import("./runner.mjs");
+
+const runCheckGroup = async (group) => {
+  const { runGroup } = await loadRunner();
+  await runGroup(group);
+};
+
+const loadAlgorithmicChecks = () => import("./check/algorithmic-checks.mjs");
+
+const loadGateSelector = () => import("./check/gate-selector.mjs");
+
+const loadDefaultGate = () => import("./check/default-gate.mjs");
+
+const loadEffectScanGate = () => import("./check/effect-scan-gate.mjs");
+
 const sourceConsumerProducer = () => {
   const modulePath = path.join(repoRootFromMain(), "tooling/distribution/pack-check.mjs");
   const supportPath = path.join(repoRootFromMain(), "tooling/distribution/support.mjs");
@@ -174,6 +179,10 @@ const sourceConsumerProducer = () => {
 
 const runConsumer = async (args) => {
   const [command, ...rest] = args;
+  if (isHelpCommand(command)) {
+    printHelp();
+    return;
+  }
   const commandArgs = rest[0] === "--" ? rest.slice(1) : rest;
   const sourceContext = sourceConsumerProducer() ?? {};
   const context = { packageRoot: packageRootFromMain(), ...sourceContext };
@@ -197,6 +206,10 @@ const runConsumer = async (args) => {
 
 const runRelease = async (args) => {
   const [command, ...rest] = args;
+  if (isHelpCommand(command)) {
+    printHelp();
+    return;
+  }
   const commandArgs = rest[0] === "--" ? rest.slice(1) : rest;
   const sourceContext = sourceConsumerProducer() ?? {};
   const context = { packageRoot: packageRootFromMain(), ...sourceContext };
@@ -211,18 +224,25 @@ const runRelease = async (args) => {
 
 const runCheck = async (args) => {
   const [command, ...rest] = args;
+  if (isHelpCommand(command)) {
+    printHelp();
+    return;
+  }
   switch (command) {
     case "all":
       expectNoExtraArgs(rest, "agentos check all");
-      await runGroup("all");
+      await runCheckGroup("all");
       return;
     case "default":
       expectNoExtraArgs(rest, "agentos check default");
-      await runDefaultGate();
+      {
+        const { runDefaultGate } = await loadDefaultGate();
+        await runDefaultGate();
+      }
       return;
     case "structural":
       expectNoExtraArgs(rest, "agentos check structural");
-      await runGroup("all");
+      await runCheckGroup("all");
       return;
     case "affected": {
       let base;
@@ -249,6 +269,8 @@ const runCheck = async (args) => {
           throw new Error(`agentos check affected: unexpected argument ${arg}`);
         }
       }
+      const { deriveAffectedGates, printAffectedGates, runAffectedGates } =
+        await loadGateSelector();
       const result = deriveAffectedGates({ base, head });
       printAffectedGates(result, { json });
       if (run) runAffectedGates(result);
@@ -256,45 +278,56 @@ const runCheck = async (args) => {
     }
     case "docs":
       expectNoExtraArgs(rest, "agentos check docs");
-      await runGroup("check-docs");
+      await runCheckGroup("check-docs");
       return;
     case "effect-scan":
-      runEffectScanGate(rest, { defaultRepoRoot: repoRootFromMain() });
+      {
+        const { runEffectScanGate } = await loadEffectScanGate();
+        runEffectScanGate(rest, { defaultRepoRoot: repoRootFromMain() });
+      }
       return;
     case "effect-manifests":
       expectNoExtraArgs(rest, "agentos check effect-manifests");
-      await runGroup("check-effect-manifests");
+      await runCheckGroup("check-effect-manifests");
       return;
     case "release":
       expectNoExtraArgs(rest, "agentos check release");
-      await runGroup("release");
+      await runCheckGroup("release");
       return;
     case "site":
       expectNoExtraArgs(rest, "agentos check site");
-      await runGroup("check-site");
+      await runCheckGroup("check-site");
       return;
     case "guard-coverage":
       expectNoExtraArgs(rest, "agentos check guard-coverage");
-      await runGroup("guard-coverage");
+      await runCheckGroup("guard-coverage");
       return;
     case "guard": {
       const [ruleId, ...extra] = rest;
       if (ruleId === undefined) throw new Error("agentos check guard: missing <rule-id>");
       expectNoExtraArgs(extra, "agentos check guard");
+      const { runGuard } = await loadRunner();
       await runGuard(ruleId);
       return;
     }
     case "guards":
       expectNoExtraArgs(rest, "agentos check guards");
-      for (const id of listGuards()) console.log(id);
+      {
+        const { listGuards } = await loadRunner();
+        for (const id of listGuards()) console.log(id);
+      }
       return;
     default:
-      if (command !== undefined && hasAlgorithmicChecker(command)) {
-        if (!algorithmicCheckerAcceptsArgs(command)) {
-          expectNoExtraArgs(rest, `agentos check ${command}`);
+      {
+        const { algorithmicCheckerAcceptsArgs, hasAlgorithmicChecker, runAlgorithmicChecker } =
+          await loadAlgorithmicChecks();
+        if (command !== undefined && hasAlgorithmicChecker(command)) {
+          if (!algorithmicCheckerAcceptsArgs(command)) {
+            expectNoExtraArgs(rest, `agentos check ${command}`);
+          }
+          await runAlgorithmicChecker(command, rest);
+          return;
         }
-        await runAlgorithmicChecker(command, rest);
-        return;
       }
       throw new Error(
         "agentos check: choose one of all, default, structural, affected, docs, effect-scan, effect-manifests, release, site, guard-coverage, guard, guards, or an algorithmic checker id",
@@ -304,22 +337,26 @@ const runCheck = async (args) => {
 
 const runGenerate = async (args) => {
   const [command, ...rest] = args;
+  if (isHelpCommand(command)) {
+    printHelp();
+    return;
+  }
   switch (command) {
     case "docs":
       expectNoExtraArgs(rest, "agentos generate docs");
-      await runGroup("generate-docs");
+      await runCheckGroup("generate-docs");
       return;
     case "effect-manifests":
       expectNoExtraArgs(rest, "agentos generate effect-manifests");
-      await runGroup("generate-effect-manifests");
+      await runCheckGroup("generate-effect-manifests");
       return;
     case "site":
       if (rest[0] === "--watch") {
         expectNoExtraArgs(rest.slice(1), "agentos generate site --watch");
-        await runGroup("generate-site-watch");
+        await runCheckGroup("generate-site-watch");
       } else {
         expectNoExtraArgs(rest, "agentos generate site");
-        await runGroup("generate-site");
+        await runCheckGroup("generate-site");
       }
       return;
     default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yansirplus/cli",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "type": "module",
   "license": "UNLICENSED",
   "publishConfig": {
@@ -24,9 +24,9 @@
     "PUBLIC_API.md"
   ],
   "dependencies": {
-    "@yansirplus/core": "0.5.19",
-    "@yansirplus/evals": "0.5.19",
-    "@yansirplus/runtime": "0.5.19",
+    "@yansirplus/core": "0.5.20",
+    "@yansirplus/evals": "0.5.20",
+    "@yansirplus/runtime": "0.5.20",
     "esbuild": "0.27.3",
     "yaml": "2.9.0"
   },