@uic-coe-connect/cli 0.3.1 → 0.6.0

package/dist/commands/apps.js

@@ -34,9 +34,10 @@ export function registerAppCommands() {
                 table(apps.map((a) => ({
                     id: a.id,
                     name: a.name,
+                    vm: a.vmId ?? "—",
                     url: a.url,
                     pipelines: String(a.pipelines?.length ?? 0),
-                })), ["id", "name", "url", "pipelines"]);
+                })), ["id", "name", "vm", "url", "pipelines"]);
             });
         },
     }, {
@@ -49,6 +50,7 @@ export function registerAppCommands() {
                 details([
                     ["Id", app.id],
                     ["Name", app.name],
+                    ["VM", app.vmId ?? "—"],
                     ["URL", app.url],
                     ["Repo", app.repo ?? "—"],
                     ["Branch", app.branch ?? "—"],

package/dist/commands/logs.js

@@ -46,9 +46,9 @@ export function registerLogCommands() {
                 }
             };
             for (const block of first.logs) {
-                info(`── ${block.process} (${block.status}, ${block.restarts} restarts) · ${stream === "out" ? "stdout" : "stderr"} ──`);
+                info(`── ${block.process} (${block.status}${block.restarts === undefined ? "" : `, ${block.restarts} restarts`}) · ${stream === "out" ? "stdout" : "stderr"} ──`);
                 if (block.lines.length === 0) {
-                    info("  (empty)");
+                    info(block.error ? `  (${block.error})` : "  (empty)");
                 }
                 else {
                     render(block, block.lines);

package/dist/commands/pipelines.js

@@ -24,6 +24,13 @@ function parseStep(token) {
             return { type: "chown" };
         case "env":
             return { type: "env", subdir: arg || subdir || undefined };
+        case "docker": {
+            const action = (arg || "up");
+            if (!["up", "restart", "build"].includes(action)) {
+                throw new CliError(`docker step action must be up, restart or build: got "${arg}"`, 6);
+            }
+            return { type: "docker", action, subdir: subdir || undefined };
+        }
         case "npm":
             if (!arg)
                 throw new CliError(`npm step needs a script: npm:ci or npm:build@subdir`, 6);
@@ -35,7 +42,7 @@ function parseStep(token) {
                 throw new CliError(`pm2 step needs an action: pm2:restart@process-name`, 6);
             return { type: "pm2", action: arg, process: subdir || undefined };
         default:
-            throw new CliError(`Unknown step "${token}".`, 6, "Valid: pull, scan, env[:subdir], chown, npm:<script>[@subdir], migrate[:subdir], pm2:<action>[@process]");
+            throw new CliError(`Unknown step "${token}".`, 6, "Valid: pull, scan, env[:subdir], chown, npm:<script>[@subdir], migrate[:subdir], docker[:<up|restart|build>][@subdir], pm2:<action>[@process]");
     }
 }
 function describeStep(step) {
@@ -46,6 +53,8 @@ function describeStep(step) {
             return `migrate${step.subdir ? ` (${step.subdir})` : ""}`;
         case "env":
             return `write .env${step.subdir ? ` (${step.subdir})` : ""}`;
+        case "docker":
+            return `docker compose ${step.action ?? "up"}${step.subdir ? ` (${step.subdir})` : ""}`;
         case "pm2":
             return `pm2 ${step.action}${step.process ? ` ${step.process}` : ""}`;
         default:
@@ -118,7 +127,7 @@ export function registerPipelineCommands() {
         summary: "Create a pipeline from a step list",
         usage: 'pipelines create <app> --name "Full deploy" <step>... | --steps-file <f.json>',
         details: [
-            "Steps: pull, scan, env[:subdir], chown, npm:<script>[@subdir], migrate[:subdir], pm2:<action>[@process]",
+            "Steps: pull, scan, env[:subdir], chown, npm:<script>[@subdir], migrate[:subdir], docker[:<up|restart|build>][@subdir], pm2:<action>[@process]",
             'Example: coe pipelines create myapp --name "Full" pull scan npm:ci@backend pm2:restart@myapp-api',
         ],
         async run({ args, client }) {

package/dist/commands/vms.d.ts

@@ -0,0 +1 @@
+export declare function registerVmCommands(): void;

package/dist/commands/vms.js

@@ -0,0 +1,29 @@
+import { emit, info, table } from "../output.js";
+import { register } from "../registry.js";
+export function registerVmCommands() {
+    register({
+        name: "vms list",
+        summary: "The VMs this COEConnect knows about, and which it can act on",
+        usage: "vms list",
+        details: [
+            "An app runs on exactly one VM; deploys, logs and env all act there.",
+            "`managed` means this COEConnect instance may act on that VM — the dev",
+            "deployment manages only itself, so a prod app shows managed=no there.",
+        ],
+        async run({ client }) {
+            const result = await client().request("GET", "/vms");
+            emit(result, () => {
+                table(result.vms.map((v) => ({
+                    id: v.id,
+                    hostname: v.hostname,
+                    label: v.label ?? "—",
+                    here: v.local ? "yes" : "",
+                    managed: v.managed ? "yes" : "no",
+                    agent: v.tokenPrefix ? `${v.tokenPrefix}…` : "no token",
+                })), ["id", "hostname", "label", "here", "managed", "agent"]);
+                info("");
+                info(`This server runs on ${result.localVmId}; it manages ${result.managed.join(", ")}.`);
+            });
+        },
+    });
+}

package/dist/index.js

@@ -8,7 +8,7 @@ import { registerEnvCommands } from "./commands/env.js";
 import { registerLogCommands } from "./commands/logs.js";
 import { registerPipelineCommands } from "./commands/pipelines.js";
 import { registerResourceCommands } from "./commands/resources.js";
-import { registerRoleCommands } from "./commands/roles.js";
+import { registerVmCommands } from "./commands/vms.js";
 import { info, setJsonMode } from "./output.js";
 import { allCommands, findCommand, register } from "./registry.js";
 registerAuthCommands();
@@ -18,8 +18,8 @@ registerDeployCommands();
 registerAccessCommands();
 registerEnvCommands();
 registerResourceCommands();
-registerRoleCommands();
 registerLogCommands();
+registerVmCommands();
 function parseArgs(argv) {
     const positional = [];
     const flags = {};

package/dist/types.d.ts

@@ -18,6 +18,10 @@ export type DeployStep = {
 } | {
     type: "migrate";
     subdir?: string;
+} | {
+    type: "docker";
+    subdir?: string;
+    action?: "up" | "restart" | "build";
 } | {
     type: "chown";
 } | {
@@ -33,50 +37,36 @@ export interface NamedPipeline {
     name: string;
     config: DeployConfig;
 }
-export type RoleOperator = "equals" | "contains" | "startsWith" | "regex";
-export interface RoleCondition {
+export type AccessOperator = "equals" | "contains" | "startsWith" | "regex";
+export interface AccessCondition {
     attribute: string;
-    operator: RoleOperator;
+    operator: AccessOperator;
     value: string;
 }
 /**
- * A rule matches when ALL its conditions hold; a role is granted when ANY rule
+ * A rule matches when ALL its conditions hold; access is granted when ANY rule
  * matches. The property is `all`, not `conditions` — the server reads `.all`
  * and silently drops rules shaped any other way.
  */
-export interface RoleRule {
-    all: RoleCondition[];
-}
-export interface AppRole {
-    key: string;
-    label: string;
-    description?: string;
-    members: string[];
-    rules: RoleRule[];
+export interface AccessRule {
+    all: AccessCondition[];
 }
 export interface StaffAccess {
     everyone: boolean;
     members: string[];
-    rules: RoleRule[];
+    rules: AccessRule[];
     exceptions: string[];
 }
 export interface AppAccess {
     devTeam: string[];
     staff: StaffAccess;
 }
-/** An app's role-resolve token, minus anything that could reconstruct it. */
-export interface RolesTokenInfo {
-    appId: string;
-    /** Leading characters only — enough to recognise which token is deployed. */
-    prefix: string;
-    createdAt: string;
-    createdBy: string;
-    lastUsedAt?: string;
-}
 export interface RegisteredApp {
     id: string;
     name: string;
     url: string;
+    /** Which VM hosts this app — deploys, logs and env all act on that machine. */
+    vmId: string;
     repo?: string;
     branch?: string;
     /**
@@ -86,7 +76,6 @@ export interface RegisteredApp {
      */
     envKeys: string[];
     pipelines?: NamedPipeline[];
-    roles?: AppRole[];
     access?: AppAccess;
     createdAt: string;
     updatedAt: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uic-coe-connect/cli",
-  "version": "0.3.1",
-  "description": "The coe CLI \u2014 manage COEConnect apps (pipelines, deploys, access, env) from a terminal, with browser-approved auth. Designed to be driven by an AI agent.",
+  "version": "0.6.0",
+  "description": "The coe CLI — manage COEConnect apps (pipelines, deploys, access, env) from a terminal, with browser-approved auth. Designed to be driven by an AI agent.",
   "type": "module",
   "bin": {
     "coe": "./dist/index.js"