@skrr-ai/cli 0.1.93 → 0.1.95

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrr-ai/cli",
-  "version": "0.1.93",
+  "version": "0.1.95",
   "description": "Command-line interface for skrr",
   "license": "ISC",
   "author": "skrr",
@@ -26,8 +26,10 @@
   "main": "dist/index.js",
   "files": [
     "bin",
+    "docs/v1/**",
     "dist/**/*.js",
     "dist/**/*.d.ts",
+    "dist/generated/managed-instruction-guides.json",
     "!dist/**/*.test.js",
     "!dist/**/*.test.d.ts",
     "!dist/**/*.spec.js",
@@ -40,18 +42,20 @@
     "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": "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 && npm run verify:thread-cli",
+    "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",
+    "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",
     "test": "cross-env NODE_OPTIONS=\"--experimental-vm-modules --max-old-space-size=4096\" jest --ci",
     "watch": "tsc -w -p tsconfig.build.json",
     "clean": "rimraf dist",
-    "prepack": "npm run build && cross-env OCLIF_SKIP_NEW_VERSION_CHECK=1 node ./node_modules/oclif/bin/run.js manifest"
+    "prepack": "npm run build && cross-env OCLIF_SKIP_NEW_VERSION_CHECK=1 node ./node_modules/oclif/bin/run.js manifest && node scripts/canonicalize-oclif-manifest.cjs"
   },
   "dependencies": {
     "@oclif/core": "^4.0.0",
     "@oclif/plugin-autocomplete": "^3.2.56",
     "@oclif/plugin-warn-if-update-available": "^3.1.0",
-    "@skrr-ai/auth-core": "^0.4.15",
+    "@skrr-ai/auth-core": "^0.4.20",
     "proper-lockfile": "^4.1.2",
     "qrcode-terminal": "^0.12.0",
     "socket.io-client": "^4.8.3",
@@ -74,18 +78,13 @@
     "dirname": "skrr",
     "commands": "./dist/commands",
     "hooks": {
+      "init": "./dist/hooks/init",
       "command_not_found": "./dist/hooks/command-not-found"
     },
     "topicSeparator": " ",
     "plugins": [
-      "@oclif/plugin-autocomplete",
-      "@oclif/plugin-warn-if-update-available"
+      "@oclif/plugin-autocomplete"
     ],
-    "warn-if-update-available": {
-      "timeoutInDays": 14,
-      "registry": "https://registry.npmjs.org",
-      "message": "<%= config.name %> <%= config.version %> is out of date — <%= latest %> is available. Run `npm update -g @skrr-ai/cli` (or update the skrr app)."
-    },
     "topics": {
       "convos": {
         "description": "Manage conversations"
@@ -114,6 +113,9 @@
       "agents:scene-background": {
         "description": "An agent's 3D backdrop: upload an image for it (presets are set with --scene-background)"
       },
+      "agents:roles": {
+        "description": "Preview, install, export, and withdraw portable agent role specifications"
+      },
       "agents:channels": {
         "description": "Connect, inspect, test, and disconnect agent channels"
       },
@@ -450,6 +452,9 @@
       "tokens": {
         "description": "Create, list and revoke personal access tokens (osk_pat_*) — the expiring, revocable credential CI uses as SKRR_TOKEN"
       },
+      "security": {
+        "description": "Review your account's sign-ins, sessions, and access tokens"
+      },
       "integrations": {
         "description": "Invoke integration tools and manage toolkit connections for an agent"
       },

package/dist/commands/commitments/autonomy.d.ts

@@ -1,30 +0,0 @@
-import { BaseCommand } from '../../base-command';
-/**
- * `skrr commitments autonomy <id> --mode <mode>` — grant or withdraw how much the
- * commitment may do on its own.
- *
- * The one public autonomy axis:
- *   monitor  — observe and report; never execute external work
- *   prepare  — reason and freeze a plan for approval
- *   execute  — act within the explicit execution policy
- *
- * Use this rather than `commitments update`: the API replaces `policy` wholesale,
- * whereas this endpoint merges the change into the existing policy.
- *
- * The merge is field-by-field over the policy fields the Commitment Store owns;
- * report destinations remain the separate `reports[]` contract.
- */
-export default class CommitmentsAutonomy extends BaseCommand {
-    static hidden: boolean;
-    static description: string;
-    static examples: string[];
-    static args: {
-        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        mode: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        reason: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/commitments/autonomy.js

@@ -1,67 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@oclif/core");
-const base_command_1 = require("../../base-command");
-const web_url_1 = require("../../lib/web-url");
-const commitments_1 = require("../../lib/commitments");
-/**
- * `skrr commitments autonomy <id> --mode <mode>` — grant or withdraw how much the
- * commitment may do on its own.
- *
- * The one public autonomy axis:
- *   monitor  — observe and report; never execute external work
- *   prepare  — reason and freeze a plan for approval
- *   execute  — act within the explicit execution policy
- *
- * Use this rather than `commitments update`: the API replaces `policy` wholesale,
- * whereas this endpoint merges the change into the existing policy.
- *
- * The merge is field-by-field over the policy fields the Commitment Store owns;
- * report destinations remain the separate `reports[]` contract.
- */
-class CommitmentsAutonomy extends base_command_1.BaseCommand {
-    // Kept callable for existing scripts, but omitted from command discovery so
-    // new users see one product vocabulary: Monitor, Prepare, Execute.
-    static hidden = true;
-    static description = "Set a commitment's autonomy mode (how much it may act unattended)";
-    static examples = [
-        '<%= config.bin %> commitments mode <commitment-id> prepare',
-        '<%= config.bin %> commitments mode <commitment-id> execute',
-    ];
-    static args = {
-        id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
-    };
-    static flags = {
-        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
-        mode: core_1.Flags.string({
-            description: 'Compatibility command. Prefer commitments mode <id> monitor|prepare|execute; use commitments pause to stop wakes.',
-            options: [...commitments_1.COMMITMENT_AUTHORABLE_AUTONOMY_MODES],
-            required: true,
-        }),
-        reason: core_1.Flags.string({
-            description: 'Why the change — recorded on the contract-change ledger',
-        }),
-    };
-    async run() {
-        this.requireAuth();
-        const { args, flags } = await this.parse(CommitmentsAutonomy);
-        let commitment;
-        const storedMode = (0, commitments_1.storedAutonomyModeForAuthoring)(flags.mode);
-        try {
-            commitment = await commitments_1.commitmentApi.autonomy(args.id, {
-                autonomyMode: storedMode,
-                ...(flags.reason ? { reason: flags.reason } : {}),
-            });
-        }
-        catch (err) {
-            this.handleApiError(err);
-        }
-        if (flags.json) {
-            this.log(JSON.stringify((0, web_url_1.withCommitmentUrl)(this.cliConfig.baseURL, commitment), null, 2));
-            return;
-        }
-        this.log('Compatibility command accepted. Use commitments mode <id> monitor|prepare|execute for new workflows.');
-        (0, commitments_1.renderCommitmentSummary)(commitment, (line) => this.log(line));
-    }
-}
-exports.default = CommitmentsAutonomy;

package/dist/commands/commitments/mode.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@oclif/core");
-const base_command_1 = require("../../base-command");
-const commitments_1 = require("../../lib/commitments");
-const commitment_product_1 = require("../../lib/commitment-product");
-const web_url_1 = require("../../lib/web-url");
-class CommitmentsMode extends base_command_1.BaseCommand {
-    static description = 'Choose how a commitment progresses: Monitor, Prepare, or Execute';
-    static examples = ['<%= config.bin %> commitments mode <id> execute'];
-    static args = {
-        id: core_1.Args.string({ required: true, ignoreStdin: true }),
-        mode: core_1.Args.string({
-            required: true,
-            ignoreStdin: true,
-            options: [...commitment_product_1.COMMITMENT_PRODUCT_MODES],
-        }),
-    };
-    static flags = {
-        json: core_1.Flags.boolean({ description: 'Output the complete contract as JSON' }),
-        verbose: core_1.Flags.boolean({ description: 'Include compatibility values' }),
-        reason: core_1.Flags.string({ description: 'Reason recorded with this contract change' }),
-    };
-    async run() {
-        this.requireAuth();
-        const { args, flags } = await this.parse(CommitmentsMode);
-        try {
-            if (args.mode === 'off') {
-                this.error('Use commitments pause <id> to stop wakes; lifecycle is separate from mode.');
-            }
-            const result = await commitments_1.commitmentApi.mode(args.id, {
-                mode: (0, commitment_product_1.productMode)(args.mode),
-                ...(flags.reason ? { reason: flags.reason } : {}),
-            });
-            const linked = (0, web_url_1.withCommitmentUrl)(this.cliConfig.baseURL, result);
-            if (flags.json)
-                return this.log(JSON.stringify(linked, null, 2));
-            const stagingForPromotion = result.pack?.phase === 'shadow';
-            this.log(stagingForPromotion
-                ? `Promotion mode staged as ${(0, commitment_product_1.productModeLabel)(args.mode)}.`
-                : `Mode set to ${(0, commitment_product_1.productModeLabel)(args.mode)}.`);
-            if (stagingForPromotion) {
-                this.log('Live Pack Shadow remains Monitor until explicit promotion.');
-            }
-            if ((0, commitment_product_1.productMode)(args.mode) === 'monitor') {
-                this.log(`${stagingForPromotion ? 'Promotion delivery' : 'Delivery'} set to Report only. Monitor cannot create patches, branches, or pull requests.`);
-            }
-            (0, commitments_1.renderCommitmentSummary)(result, (line) => this.log(line));
-            if (flags.verbose)
-                this.log(`Compatibility value: ${result.policy?.autonomyMode}`);
-            this.log(`URL: ${linked.url}`);
-        }
-        catch (error) {
-            this.handleApiError(error);
-        }
-    }
-}
-exports.default = CommitmentsMode;

package/dist/commands/commitments/pack/promote.d.ts

@@ -1,19 +0,0 @@
-import { BaseCommand } from '../../../base-command';
-/**
- * Graduate a Pack out of shadow and restore the saved Mode and delivery.
- *
- * Explicit by design — promotion is never inferred from a passing preflight.
- * The saved policy tracks explicit policy writes made DURING shadow, so an
- * autonomy change made while observing is not discarded here.
- */
-export default class CommitmentsPackPromote extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static args: {
-        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/commitments/pack/promote.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@oclif/core");
-const base_command_1 = require("../../../base-command");
-const commitments_1 = require("../../../lib/commitments");
-const commitment_product_1 = require("../../../lib/commitment-product");
-/**
- * Graduate a Pack out of shadow and restore the saved Mode and delivery.
- *
- * Explicit by design — promotion is never inferred from a passing preflight.
- * The saved policy tracks explicit policy writes made DURING shadow, so an
- * autonomy change made while observing is not discarded here.
- */
-class CommitmentsPackPromote extends base_command_1.BaseCommand {
-    static description = 'Graduate a Pack out of shadow, restoring its staged Mode and delivery';
-    static examples = ['<%= config.bin %> commitments pack promote <commitment-id>'];
-    static args = {
-        id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
-    };
-    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
-    async run() {
-        this.requireAuth();
-        const { args, flags } = await this.parse(CommitmentsPackPromote);
-        let result;
-        try {
-            result = await commitments_1.commitmentPackApi.promote(args.id);
-        }
-        catch (err) {
-            this.handleApiError(err);
-            return;
-        }
-        if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
-            return;
-        }
-        this.log(`Pack:  ${result.pack?.id}@${result.pack?.version}`);
-        this.log(`Phase: ${result.phase}`);
-        const mode = result.commitment?.policy?.autonomyMode;
-        if (mode)
-            this.log(`Mode: ${(0, commitment_product_1.productModeLabel)(mode)}`);
-        if (result.commitment?.delivery?.mode) {
-            this.log(`Delivery: ${(0, commitment_product_1.deliveryLabel)(result.commitment.delivery.mode)}`);
-        }
-    }
-}
-exports.default = CommitmentsPackPromote;

package/dist/commands/commitments/pack/shadow.d.ts

@@ -1,20 +0,0 @@
-import { BaseCommand } from '../../../base-command';
-export declare const SHADOW_ACTIVE_COPY = "Shadow is active in Monitor: checks continue, but delivery cannot run and live delivery stays\nReport only. The prior Mode and delivery are saved as the promotion target;\n`skrr commitments pack promote` applies them.";
-/**
- * Activate shadow: the Commitment goes active in Monitor and starts checking.
- * Its prior Mode and delivery are saved as the target for `promote`.
- *
- * Requires a STORED preflight verdict of `ready`, which is why
- * `pack preflight` exists as its own command.
- */
-export default class CommitmentsPackShadow extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static args: {
-        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/commitments/pack/shadow.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SHADOW_ACTIVE_COPY = void 0;
-const core_1 = require("@oclif/core");
-const base_command_1 = require("../../../base-command");
-const commitments_1 = require("../../../lib/commitments");
-exports.SHADOW_ACTIVE_COPY = 'Shadow is active in Monitor: checks continue, but delivery cannot run and live delivery stays\nReport only. The prior Mode and delivery are saved as the promotion target;\n`skrr commitments pack promote` applies them.';
-/**
- * Activate shadow: the Commitment goes active in Monitor and starts checking.
- * Its prior Mode and delivery are saved as the target for `promote`.
- *
- * Requires a STORED preflight verdict of `ready`, which is why
- * `pack preflight` exists as its own command.
- */
-class CommitmentsPackShadow extends base_command_1.BaseCommand {
-    static description = 'Activate shadow: run the Pack in Monitor while saving its Mode and delivery promotion target';
-    static examples = ['<%= config.bin %> commitments pack shadow <commitment-id>'];
-    static args = {
-        id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
-    };
-    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
-    async run() {
-        this.requireAuth();
-        const { args, flags } = await this.parse(CommitmentsPackShadow);
-        let result;
-        try {
-            result = await commitments_1.commitmentPackApi.shadow(args.id);
-        }
-        catch (err) {
-            this.handleApiError(err);
-            return;
-        }
-        if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
-            return;
-        }
-        this.log(`Pack:  ${result.pack?.id}@${result.pack?.version}`);
-        this.log(`Phase: ${result.phase}`);
-        this.log(`\n${exports.SHADOW_ACTIVE_COPY}`);
-    }
-}
-exports.default = CommitmentsPackShadow;