@skrr-ai/cli 0.1.116 → 0.1.118

package/oclif.manifest.json

@@ -378,9 +378,10 @@
           "required": true
         }
       },
-      "description": "Install an action listing into an agent",
+      "description": "Install an action listing into an agent. A paid listing shows its price and asks you to confirm first.",
       "examples": [
         "<%= config.bin %> actions install <listing-id> --agent <agent-id>",
+        "<%= config.bin %> actions install <listing-id> --agent <agent-id> --yes",
         "<%= config.bin %> actions install <listing-id> --agent <agent-id> --json"
       ],
       "flags": {
@@ -430,6 +431,20 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm a paid install without prompting. The price is still printed.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "expected-price": {
+          "description": "Refuse unless the install would charge exactly this USD amount (e.g. 4 or 2.50; 0 pins free). Use it to pin the price the person named, not just the one read now.",
+          "name": "expected-price",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -31577,7 +31592,7 @@
       "args": {},
       "description": "Create a commitment (a durable agent contract). Its cadence is manual, an interval or daily clock times; it has no weekday, holiday, business-day or trading-calendar fields",
       "examples": [
-        "<%= config.bin %> commitments create --agent <agent-id> --title \"Ship v2\" --outcome \"v2 is live for all users\" --cadence 6h",
+        "<%= config.bin %> commitments create --agent <agent-id> --title \"Ship v2\" --outcome \"v2 is live for all users\" --cadence 6h --activate",
         "<%= config.bin %> commitments create --agent <agent-id> --title \"Hiring loop\" --outcome \"Every candidate hears back in 48h\" --watch tasks --watch email --cadence 12h",
         "<%= config.bin %> commitments create --agent <agent-id> --title \"SLA\" --outcome \"p95 under 200ms\" --criterion \"p95 latency confirmed\" --evaluator metric --measure <measure-id>",
         "<%= config.bin %> commitments create --agent <agent-id> --title \"AWS cost watch\" --outcome \"Cost regressions are investigated\" --agent-directive-file ./aws-cost-policy.md",
@@ -31702,6 +31717,12 @@
           ],
           "type": "option"
         },
+        "activate": {
+          "description": "Turn the commitment on right after creating it — the same resume + Preflight boundary as `commitments resume`. A refused activation keeps the draft and reports the refusal's code, reason and fix.",
+          "name": "activate",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "deadline": {
           "description": "ISO-8601 deadline for an `achieve` commitment",
           "name": "deadline",
@@ -51926,6 +51947,86 @@
         "update.js"
       ]
     },
+    "guide": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Guide id",
+          "name": "id"
+        },
+        "section": {
+          "description": "Section id",
+          "name": "section"
+        }
+      },
+      "description": "Read Skrr operation guides on demand",
+      "examples": [
+        "<%= config.bin %> guide",
+        "<%= config.bin %> guide tasks",
+        "<%= config.bin %> guide tasks updates --offline"
+      ],
+      "flags": {
+        "bare": {
+          "description": "Bare mode — ignore keychain/file credential sources. Token must come from env or --token.",
+          "name": "bare",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "token": {
+          "description": "Bearer token for this invocation (debugging/impersonation). Overrides env and stored creds.",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "Workspace ID for workspace-scoped requests (also sets X-Workspace-Id).",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "description": "Which stored session to use. Each profile keeps its own credential and deployment, so signing into one does not sign you out of another. Also OVERSKY_PROFILE. List them with `profiles list`.",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "raw": {
+          "description": "With --json, keep the Mongo storage fields (_id next to id, __v) that the CLI otherwise strips. Also OVERSKY_CLI_RAW=1.",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output the guide and source provenance as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "offline": {
+          "description": "Read the bundled release guides without checking credentials or the server",
+          "name": "offline",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "guide",
+      "pluginAlias": "@skrr-ai/cli",
+      "pluginName": "@skrr-ai/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "guide.js"
+      ]
+    },
     "harnesses:alias": {
       "aliases": [],
       "args": {
@@ -55702,7 +55803,7 @@
           ]
         }
       },
-      "description": "Read the detailed task-management guide on demand",
+      "description": "Kept for installed instructions — prints the tasks guide. `skrr guide` reads every guide.",
       "examples": [
         "<%= config.bin %> instructions guide task-management",
         "<%= config.bin %> instructions guide --json"
@@ -69226,7 +69327,7 @@
       "description": "Apply an auditable canonical memory maintenance operation",
       "examples": [
         "<%= config.bin %> memory maintain remember '{\"path\":\"/notes\",\"claim\":\"Ship notes on Fridays.\"}' --agent agent_abc123",
-        "<%= config.bin %> memory maintain archive '{\"factId\":\"fact_abc\"}' --agent agent_abc123"
+        "<%= config.bin %> memory maintain archive '{\"path\":\"/notes/old-note\"}' --agent agent_abc123"
       ],
       "flags": {
         "bare": {
@@ -84921,10 +85022,11 @@
           "required": true
         }
       },
-      "description": "Install a skill from the store to a service (agent)",
+      "description": "Install a skill from the store to a service (agent). A paid skill shows its price and asks you to confirm first.",
       "examples": [
         "<%= config.bin %> skills install <skill-id>",
         "<%= config.bin %> skills install <skill-id> --agent <agent-id>",
+        "<%= config.bin %> skills install <skill-id> --yes",
         "<%= config.bin %> skills install <skill-id> --json"
       ],
       "flags": {
@@ -84981,6 +85083,20 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm a paid install without prompting. The price is still printed.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "expected-price": {
+          "description": "Refuse unless the install would charge exactly this USD amount (e.g. 4 or 2.50; 0 pins free). Use it to pin the price the person named, not just the one read now.",
+          "name": "expected-price",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -86842,15 +86958,12 @@
       ]
     },
     "spaces": {
-      "aliases": [
-        "spaces:guide"
-      ],
+      "aliases": [],
       "args": {},
       "description": "Discover space perspectives and the CLI commands for each one",
       "examples": [
         "<%= config.bin %> spaces",
-        "<%= config.bin %> spaces --json",
-        "<%= config.bin %> spaces guide"
+        "<%= config.bin %> spaces --json"
       ],
       "flags": {
         "bare": {
@@ -90618,6 +90731,83 @@
         "goals.js"
       ]
     },
+    "spaces:guide": {
+      "aliases": [],
+      "args": {
+        "section": {
+          "description": "A section of the spaces guide to read instead of `views`",
+          "name": "section"
+        }
+      },
+      "description": "Alias of `skrr guide spaces views` — the Space perspective map. `skrr guide spaces` reads the whole guide.",
+      "examples": [
+        "<%= config.bin %> spaces guide",
+        "<%= config.bin %> spaces guide goals",
+        "<%= config.bin %> spaces guide --json"
+      ],
+      "flags": {
+        "bare": {
+          "description": "Bare mode — ignore keychain/file credential sources. Token must come from env or --token.",
+          "name": "bare",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "token": {
+          "description": "Bearer token for this invocation (debugging/impersonation). Overrides env and stored creds.",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "Workspace ID for workspace-scoped requests (also sets X-Workspace-Id).",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "description": "Which stored session to use. Each profile keeps its own credential and deployment, so signing into one does not sign you out of another. Also OVERSKY_PROFILE. List them with `profiles list`.",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "raw": {
+          "description": "With --json, keep the Mongo storage fields (_id next to id, __v) that the CLI otherwise strips. Also OVERSKY_CLI_RAW=1.",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output the guide and source provenance as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "offline": {
+          "description": "Read the bundled release guides without checking credentials or the server",
+          "name": "offline",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "spaces:guide",
+      "pluginAlias": "@skrr-ai/cli",
+      "pluginName": "@skrr-ai/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "spaces",
+        "guide.js"
+      ]
+    },
     "spaces:heartbeats:create": {
       "aliases": [],
       "args": {
@@ -105618,7 +105808,8 @@
         "<%= config.bin %> store install agent_abc123 --release ar_def456",
         "<%= config.bin %> store install agent_abc123 --run-on local",
         "<%= config.bin %> store install agent_abc123 --share-outcomes",
-        "<%= config.bin %> store install agent_abc123 --yes --json"
+        "<%= config.bin %> store install agent_abc123 --yes --json",
+        "<%= config.bin %> store install agent_abc123 --yes --expected-price 4"
       ],
       "flags": {
         "bare": {
@@ -105693,6 +105884,13 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "expected-price": {
+          "description": "Refuse unless the purchase would charge exactly this USD amount (e.g. 4 or 2.50; 0 pins free). Use it to pin the price the person named, not just the one read now.",
+          "name": "expected-price",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "run-on": {
           "description": "Where its tools may run. cloud (the default) keeps tools off connected machines; local lets tools use an available connected machine in your account, selected at run time. The agent runs in the cloud either way",
           "name": "run-on",
@@ -117108,17 +117306,56 @@
     "tasks:guide": {
       "aliases": [],
       "args": {},
-      "description": "Find the commands for Task planning, dependencies, preflight, execution, and results",
+      "description": "Alias of `skrr guide tasks commands` — the Task command map. `skrr guide tasks` reads the whole guide.",
       "examples": [
         "<%= config.bin %> tasks guide",
         "<%= config.bin %> tasks guide --json"
       ],
       "flags": {
+        "bare": {
+          "description": "Bare mode — ignore keychain/file credential sources. Token must come from env or --token.",
+          "name": "bare",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "token": {
+          "description": "Bearer token for this invocation (debugging/impersonation). Overrides env and stored creds.",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "Workspace ID for workspace-scoped requests (also sets X-Workspace-Id).",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "description": "Which stored session to use. Each profile keeps its own credential and deployment, so signing into one does not sign you out of another. Also OVERSKY_PROFILE. List them with `profiles list`.",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "raw": {
+          "description": "With --json, keep the Mongo storage fields (_id next to id, __v) that the CLI otherwise strips. Also OVERSKY_CLI_RAW=1.",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
-          "description": "Output the local operations guide as JSON",
+          "description": "Output the guide and source provenance as JSON",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "offline": {
+          "description": "Read the bundled release guides without checking credentials or the server",
+          "name": "offline",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -137936,5 +138173,5 @@
       ]
     }
   },
-  "version": "0.1.116"
+  "version": "0.1.118"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrr-ai/cli",
-  "version": "0.1.116",
+  "version": "0.1.118",
   "description": "Command-line interface for skrr",
   "license": "ISC",
   "author": "skrr",
@@ -29,6 +29,7 @@
     "docs/v1/**",
     "dist/**/*.js",
     "dist/**/*.d.ts",
+    "dist/generated/agent-guides.json",
     "dist/generated/managed-instruction-guides.json",
     "!dist/**/*.test.js",
     "!dist/**/*.test.d.ts",
@@ -42,7 +43,8 @@
     "build": "node ../scripts/with-build-lock.js npm run build:locked",
     "build:locked": "npm run build:siblings && npm run build:compile",
     "build:siblings": "cd .. && bash scripts/worktree-link-node-modules.sh && npm run build:auth-core && npm run build:inference-broker && npm run build:data-provider:only && npm run build:avatar-schemas && npm run build:data-schemas:only",
-    "build:compile": "node scripts/generate-instruction-guides.cjs && rimraf dist && tsc -p tsconfig.build.json && node scripts/write-command-build-manifest.cjs && node scripts/vendor-monorepo-deps.js && cross-env OCLIF_SKIP_NEW_VERSION_CHECK=1 node ./node_modules/oclif/bin/run.js manifest && node scripts/canonicalize-oclif-manifest.cjs && npm run verify:thread-cli",
+    "build:compile": "node scripts/generate-instruction-guides.cjs && node scripts/generate-agent-guides.cjs --check && rimraf dist && tsc -p tsconfig.build.json && node scripts/write-command-build-manifest.cjs && node scripts/vendor-monorepo-deps.js && cross-env OCLIF_SKIP_NEW_VERSION_CHECK=1 node ./node_modules/oclif/bin/run.js manifest && node scripts/canonicalize-oclif-manifest.cjs && npm run verify:thread-cli",
+    "check:agent-guides": "node scripts/generate-agent-guides.cjs --check",
     "check:instruction-guides": "node scripts/generate-instruction-guides.cjs --check",
     "verify:thread-cli": "node scripts/verify-thread-commands.cjs",
     "verify:install-contract": "node scripts/verify-install-contract.cjs",