@habitat-ai/plugin-cli 0.2.0

package/dist/commands/check.d.ts

@@ -0,0 +1,15 @@
+import type { Client } from "@habitat-ai/service/client";
+import { Command } from "@oclif/core";
+type CheckResult = Awaited<ReturnType<Client["catalog"]["check"]>>;
+/** Projects one selected Habitat catalog check into Oclif. */
+export default class Check extends Command {
+    static description: string;
+    static flags: {
+        readonly instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly owner: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly rule: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly runner: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CheckResult>;
+}
+export {};

package/dist/commands/check.js

@@ -0,0 +1,31 @@
+import { Command, Flags } from "@oclif/core";
+import { habitatClientFrom } from "../lib/binding.js";
+/** Projects one selected Habitat catalog check into Oclif. */
+export default class Check extends Command {
+    static description = "Check resolved Habitat applications";
+    static flags = {
+        instance: Flags.string({ description: "Exact Habitat instance identity" }),
+        owner: Flags.string({ description: "Repository project whose applications enter the check" }),
+        rule: Flags.string({
+            description: "Habitat rule identity; repeat to select a rule set",
+            multiple: true,
+        }),
+        runner: Flags.string({ description: "Mechanical runner identity" }),
+    };
+    async run() {
+        const { flags } = await this.parse(Check);
+        const rules = Array.isArray(flags.rule) ? flags.rule : flags.rule ? [flags.rule] : [];
+        const selectors = {
+            ...(flags.instance !== undefined ? { instance: flags.instance } : {}),
+            ...(flags.owner !== undefined ? { owner: flags.owner } : {}),
+            ...(rules.length === 1 ? { rule: rules[0] } : {}),
+            ...(rules.length > 1 ? { rules } : {}),
+            ...(flags.runner !== undefined ? { runner: flags.runner } : {}),
+        };
+        const result = await habitatClientFrom(this.config).catalog.check(Object.keys(selectors).length === 0 ? {} : { selectors });
+        this.log(JSON.stringify(result, null, 2));
+        if (result._tag !== "Completed" || !result.ok)
+            this.exit(1);
+        return result;
+    }
+}

package/dist/commands/hook.d.ts

@@ -0,0 +1,12 @@
+import type { Client } from "@habitat-ai/service/client";
+import { Command } from "@oclif/core";
+type HookResult = Awaited<ReturnType<Client["catalog"]["check"]>>;
+/** Runs one bounded Habitat operation for a repository-owned local hook. */
+export default class Hook extends Command {
+    static description: string;
+    static args: {
+        readonly name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<HookResult>;
+}
+export {};

package/dist/commands/hook.js

@@ -0,0 +1,24 @@
+import { Args, Command } from "@oclif/core";
+import { habitatClientFrom } from "../lib/binding.js";
+/** Runs one bounded Habitat operation for a repository-owned local hook. */
+export default class Hook extends Command {
+    static description = "Run a Habitat local-hook entrypoint";
+    static args = {
+        name: Args.string({
+            required: true,
+            options: ["agent-stop"],
+            description: "Named Habitat hook operation",
+        }),
+    };
+    async run() {
+        await this.parse(Hook);
+        const result = await habitatClientFrom(this.config).catalog.check({
+            selectors: { runner: "habitat" },
+        });
+        if (result._tag !== "Completed" || !result.ok) {
+            this.log(JSON.stringify(result, null, 2));
+            this.exit(1);
+        }
+        return result;
+    }
+}

package/dist/commands/resolve.d.ts

@@ -0,0 +1,9 @@
+import type { Client } from "@habitat-ai/service/client";
+import { Command } from "@oclif/core";
+type ResolveResult = Awaited<ReturnType<Client["catalog"]["resolve"]>>;
+/** Projects current-workspace Habitat catalog resolution into Oclif. */
+export default class Resolve extends Command {
+    static description: string;
+    run(): Promise<ResolveResult>;
+}
+export {};

package/dist/commands/resolve.js

@@ -0,0 +1,14 @@
+import { Command } from "@oclif/core";
+import { habitatClientFrom } from "../lib/binding.js";
+/** Projects current-workspace Habitat catalog resolution into Oclif. */
+export default class Resolve extends Command {
+    static description = "Resolve the current Habitat authority catalog";
+    async run() {
+        await this.parse(Resolve);
+        const result = await habitatClientFrom(this.config).catalog.resolve({});
+        this.log(JSON.stringify(result, null, 2));
+        if (result._tag === "Rejected")
+            this.exit(1);
+        return result;
+    }
+}

package/dist/lib/binding.d.ts

@@ -0,0 +1,10 @@
+import type { Client } from "@habitat-ai/service/client";
+import { type Config } from "@oclif/core";
+/** Oclif load options carrying the ready Habitat client selected by the app. */
+export type HabitatOclifLoadOptions = Config["options"] & {
+    readonly habitatClient: Client;
+};
+/** Adds the app-owned Habitat client to one native Oclif configuration. */
+export declare function bindHabitatClient(options: Config["options"], client: Client): HabitatOclifLoadOptions;
+/** Reads the ready Habitat client from the current native Oclif configuration. */
+export declare function habitatClientFrom(config: Config): Client;

package/dist/lib/binding.js

@@ -0,0 +1,16 @@
+import { Errors } from "@oclif/core";
+const HABITAT_CLIENT = "habitatClient";
+/** Adds the app-owned Habitat client to one native Oclif configuration. */
+export function bindHabitatClient(options, client) {
+    return Object.freeze({ ...options, [HABITAT_CLIENT]: client });
+}
+/** Reads the ready Habitat client from the current native Oclif configuration. */
+export function habitatClientFrom(config) {
+    if (!hasHabitatClient(config.options)) {
+        throw new Errors.CLIError("The Habitat app did not supply its service binding.");
+    }
+    return config.options.habitatClient;
+}
+function hasHabitatClient(options) {
+    return HABITAT_CLIENT in options && options.habitatClient !== undefined;
+}

package/oclif.manifest.json

@@ -0,0 +1,103 @@
+{
+  "commands": {
+    "hook": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Named Habitat hook operation",
+          "name": "name",
+          "options": [
+            "agent-stop"
+          ],
+          "required": true
+        }
+      },
+      "description": "Run a Habitat local-hook entrypoint",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hook",
+      "pluginAlias": "@habitat-ai/plugin-cli",
+      "pluginName": "@habitat-ai/plugin-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "hook.js"
+      ]
+    },
+    "resolve": {
+      "aliases": [],
+      "args": {},
+      "description": "Resolve the current Habitat authority catalog",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "resolve",
+      "pluginAlias": "@habitat-ai/plugin-cli",
+      "pluginName": "@habitat-ai/plugin-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "resolve.js"
+      ]
+    },
+    "check": {
+      "aliases": [],
+      "args": {},
+      "description": "Check resolved Habitat applications",
+      "flags": {
+        "instance": {
+          "description": "Exact Habitat instance identity",
+          "name": "instance",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "owner": {
+          "description": "Repository project whose applications enter the check",
+          "name": "owner",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "rule": {
+          "description": "Habitat rule identity; repeat to select a rule set",
+          "name": "rule",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "runner": {
+          "description": "Mechanical runner identity",
+          "name": "runner",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "check",
+      "pluginAlias": "@habitat-ai/plugin-cli",
+      "pluginName": "@habitat-ai/plugin-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "check.js"
+      ]
+    }
+  },
+  "version": "0.2.0"
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@habitat-ai/plugin-cli",
+  "version": "0.2.0",
+  "private": false,
+  "description": "Native Oclif projections for the Habitat catalog service",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist",
+    "oclif.manifest.json",
+    "package.json"
+  ],
+  "exports": {
+    "./binding": {
+      "types": "./dist/lib/binding.d.ts",
+      "default": "./dist/lib/binding.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "manifest": "NODE_ENV=production bun --bun oclif manifest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check:test": "tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run --project plugin-habitat"
+  },
+  "dependencies": {
+    "@habitat-ai/service": "0.2.0",
+    "@oclif/core": "^4.11.4"
+  },
+  "devDependencies": {
+    "@effect/platform-node": "4.0.0-beta.101",
+    "effect": "4.0.0-beta.101",
+    "oclif": "4.23.27",
+    "typescript": "^5.9.3"
+  },
+  "oclif": {
+    "commands": "./dist/commands",
+    "topicSeparator": " "
+  },
+  "nx": {
+    "tags": [
+      "type:plugin",
+      "surface:cli",
+      "capability:habitat"
+    ],
+    "targets": {
+      "check:test": {
+        "dependsOn": [
+          "build",
+          "^build"
+        ]
+      },
+      "test": {
+        "dependsOn": [
+          "build"
+        ]
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}