not-manage 0.2.1 → 0.2.3

package/src/resource-command-runner.js

@@ -3,7 +3,10 @@ const {
   fetchResourcePage,
   getValidAccessToken,
 } = require("./clio-api");
+const { readIdsInput } = require("./agent-input");
 const { fetchPages } = require("./resource-utils");
+const { maybeCompactPayload } = require("./compact-output");
+const { UsageError } = require("./cli-errors");
 const { maybeRedactData, maybeRedactPayload } = require("./redaction");
 const { getConfig, getTokenSet } = require("./store");
 
@@ -44,6 +47,16 @@ async function fetchDefaultItemPayload({ accessToken, apiPath, config, id, query
   return fetchResourceById(config, accessToken, apiPath, id, query);
 }
 
+function buildGetJsonEnvelope(items, requestedCount) {
+  return {
+    data: items,
+    meta: {
+      requested_count: requestedCount,
+      returned_count: items.length,
+    },
+  };
+}
+
 function createListCommand(commandConfig) {
   const {
     apiPath,
@@ -69,7 +82,10 @@ function createListCommand(commandConfig) {
       options,
       query,
     });
-    const data = maybeRedactData(result.data, options, redactionResourceType);
+    const data = maybeCompactPayload(
+      maybeRedactData(result.data, options, redactionResourceType),
+      options
+    );
 
     if (options.json) {
       const jsonMeta = buildJsonMeta ? buildJsonMeta({ data, options, result }) : {};
@@ -105,11 +121,62 @@ function createGetCommand(commandConfig) {
   } = commandConfig;
 
   return async function getCommand(options = {}) {
-    if (!options.id) {
-      throw new Error(usage);
+    if (!options.id && !options.idsFile) {
+      throw new UsageError(usage, {
+        code: "missing_resource_id",
+        hint: usage.replace(/^Usage:\s*/, ""),
+        details: { missing: ["id"] },
+      });
     }
 
     const { accessToken, config } = await getAuthContext();
+
+    if (options.idsFile) {
+      if (options.id) {
+        throw new UsageError("Pass either an ID argument or `--ids-file`, not both.", {
+          code: "conflicting_id_inputs",
+          hint: "Use `not-manage <resource> get <id>` or `not-manage <resource> get --ids-file ids.txt --json`.",
+        });
+      }
+      if (!options.json) {
+        throw new UsageError("Bulk `get` from `--ids-file` requires `--json`.", {
+          code: "json_required_for_bulk_get",
+          hint: "Re-run with `--json` or `--agent`.",
+        });
+      }
+
+      const ids = await readIdsInput(options.idsFile);
+      if (ids.length === 0) {
+        throw new UsageError("Bulk `get` did not receive any IDs.", {
+          code: "missing_resource_id",
+          hint: "Provide one ID per line, a JSON array of IDs, or objects with an `id` field.",
+          details: { missing: ["id"] },
+        });
+      }
+
+      const items = [];
+      for (const id of ids) {
+        const payload = await fetchItemPayload({
+          accessToken,
+          apiPath,
+          config,
+          id,
+          options,
+          query: {
+            fields: options.fields || defaultFields,
+          },
+        });
+        const redactedPayload = maybeCompactPayload(
+          maybeRedactPayload(payload, options, redactionResourceType),
+          options
+        );
+        items.push(redactedPayload?.data ?? redactedPayload);
+      }
+
+      console.log(JSON.stringify(buildGetJsonEnvelope(items, ids.length), null, options.compact ? 0 : 2));
+      return;
+    }
+
     const payload = await fetchItemPayload({
       accessToken,
       apiPath,
@@ -120,7 +187,10 @@ function createGetCommand(commandConfig) {
         fields: options.fields || defaultFields,
       },
     });
-    const redactedPayload = maybeRedactPayload(payload, options, redactionResourceType);
+    const redactedPayload = maybeCompactPayload(
+      maybeRedactPayload(payload, options, redactionResourceType),
+      options
+    );
 
     if (options.json) {
       console.log(JSON.stringify(redactedPayload, null, 2));
@@ -132,6 +202,7 @@ function createGetCommand(commandConfig) {
 }
 
 module.exports = {
+  buildGetJsonEnvelope,
   buildListJsonEnvelope,
   buildSummaryMessage,
   createGetCommand,

package/src/resource-handlers.js

@@ -6,6 +6,7 @@ const {
 } = require("./resource-display");
 const { buildListQueryFromResource } = require("./resource-query-builder");
 const { createGetCommand, createListCommand } = require("./resource-command-runner");
+const { getResourceMetadata } = require("./resource-metadata");
 
 const RESOURCE_HANDLERS = {
   activities: {
@@ -21,7 +22,7 @@ const RESOURCE_HANDLERS = {
 const GENERIC_HANDLER_CACHE = new Map();
 
 function createGenericHandlers(resourceMetadata) {
-  if (!resourceMetadata || !resourceMetadata.display) {
+  if (!resourceMetadata) {
     return null;
   }
 
@@ -30,15 +31,23 @@ function createGenericHandlers(resourceMetadata) {
     return cached;
   }
 
+  const displayMetadata =
+    resourceMetadata.display
+      ? resourceMetadata
+      : getResourceMetadata(resourceMetadata.handlerKey);
+  if (!displayMetadata?.display) {
+    return null;
+  }
+
   const handlers = {};
 
-  if (resourceMetadata.capabilities.list.enabled && resourceMetadata.display.list) {
-    const printList = createListPrinter(resourceMetadata.display.list);
+  if (resourceMetadata.capabilities.list.enabled && displayMetadata.display.list) {
+    const printList = createListPrinter(displayMetadata.display.list);
     handlers.list = createListCommand({
       apiPath: resourceMetadata.apiPath,
       buildQuery: (options) =>
         buildListQueryFromResource(resourceMetadata, options, resourceMetadata.listQuery),
-      formatRow: resourceMetadata.display.list.formatRow,
+      formatRow: displayMetadata.display.list.formatRow,
       pluralLabel: resourceMetadata.summaryLabels.plural,
       printList,
       redactionResourceType: resourceMetadata.redaction.resourceType,
@@ -46,8 +55,8 @@ function createGenericHandlers(resourceMetadata) {
     });
   }
 
-  if (resourceMetadata.capabilities.get.enabled && resourceMetadata.display.get) {
-    const printItem = createDetailPrinter(resourceMetadata.display.get);
+  if (resourceMetadata.capabilities.get.enabled && displayMetadata.display.get) {
+    const printItem = createDetailPrinter(displayMetadata.display.get);
     handlers.get = createGetCommand({
       apiPath: resourceMetadata.apiPath,
       defaultFields: resourceMetadata.defaultFields.get,

package/src/resource-metadata.js

@@ -2217,9 +2217,27 @@ function listRequiredOptionFlags(resourceMetadata, sub) {
   });
 }
 
+function findMissingRequiredOptions(resourceMetadata, sub, options = {}) {
+  if (!resourceMetadata) {
+    return [];
+  }
+
+  const requiredOptions = resourceMetadata.capabilities?.[sub]?.requiredOptions || [];
+  return requiredOptions
+    .filter((propertyName) => {
+      const value = options[propertyName];
+      return value === undefined || value === null || value === "";
+    })
+    .map((propertyName) => {
+      const optionName = resourceMetadata.optionSchema?.[sub]?.[propertyName]?.option;
+      return optionName ? `--${optionName}` : `--${propertyName}`;
+    });
+}
+
 module.exports = {
   RESOURCE_METADATA,
   RESOURCE_ORDER,
+  findMissingRequiredOptions,
   getResourceMetadata,
   listResourceMetadata,
   listRequiredOptionFlags,

package/src/store.js

@@ -153,7 +153,7 @@ async function getStoredTokenSet() {
     };
   } catch (_error) {
     throw new Error(
-      "Stored token data is invalid. Run `not-manage auth revoke` then `not-manage auth login`."
+      "Stored token data is invalid. Run `not-manage auth revoke --yes` then `not-manage auth login`."
     );
   }
 }

package/src/postinstall.js

@@ -1,140 +0,0 @@
-const { setupWizard } = require("./commands-auth");
-const { ask, withPrompt } = require("./prompt");
-const { findConfig } = require("./store");
-
-const SKIP_POSTINSTALL_ENV_VARS = [
-  "NOT_MANAGE_SKIP_POSTINSTALL_SETUP",
-  "CLIO_MANAGE_SKIP_POSTINSTALL_SETUP",
-];
-
-function printConfidentialityNotice(log = console.log) {
-  log("Confidentiality notice:");
-  log("  not-manage can display client-identifying, confidential, or privileged matter data.");
-  log("  `--redacted` is best-effort only and may miss identifiers in labels, custom fields, or free text.");
-  log("  Review all output before sharing it with AI tools, tickets, chats, or other third parties.");
-  log("  Use only with workflows and vendors your firm has approved.");
-}
-
-function shouldShowPostinstallNotice(options = {}) {
-  const env = options.env || process.env;
-
-  if (SKIP_POSTINSTALL_ENV_VARS.some((name) => env[name] === "1")) {
-    return false;
-  }
-
-  if (env.CI) {
-    return false;
-  }
-
-  if (env.npm_config_global !== "true") {
-    return false;
-  }
-
-  return true;
-}
-
-function shouldRunPostinstallOnboarding(options = {}) {
-  const stdin = options.stdin || process.stdin;
-  const stdout = options.stdout || process.stdout;
-
-  if (!shouldShowPostinstallNotice(options)) {
-    return false;
-  }
-
-  if (!stdin.isTTY || !stdout.isTTY) {
-    return false;
-  }
-
-  return true;
-}
-
-function printPostinstallIntro(log = console.log) {
-  log("");
-  log("+===========================================+");
-  log("|           NOT MANAGE IS INSTALLED         |");
-  log("+===========================================+");
-  log("|     Start first-time setup from npm?      |");
-  log("+===========================================+");
-  log("");
-  log("This prompt only appears on fresh interactive global installs.");
-  log("If you skip it now, run `not-manage setup` whenever you are ready.");
-  log("");
-  printConfidentialityNotice(log);
-  log("");
-}
-
-function printPostinstallInstalledNotice(log = console.log) {
-  log("");
-  log("not-manage is installed.");
-  printConfidentialityNotice(log);
-  log("Run `not-manage setup` whenever you are ready.");
-}
-
-function printPostinstallWelcomeBack(log = console.log) {
-  log("");
-  log("Welcome back. Clio is already configured on this machine.");
-  log("Run `not-manage auth status` to verify the current connection, or `not-manage setup` to reconfigure.");
-}
-
-async function maybeRunPostinstallOnboarding(options = {}) {
-  const log = options.log || console.log;
-  const findConfigFn = options.findConfig || findConfig;
-  const setupWizardFn = options.setupWizard || setupWizard;
-  const withPromptFn = options.withPrompt || withPrompt;
-  const askFn = options.ask || ask;
-
-  if (!shouldShowPostinstallNotice(options)) {
-    return false;
-  }
-
-  const config = await findConfigFn();
-  if (config) {
-    printPostinstallWelcomeBack(log);
-    return false;
-  }
-
-  if (!shouldRunPostinstallOnboarding(options)) {
-    printPostinstallInstalledNotice(log);
-    return false;
-  }
-
-  printPostinstallIntro(log);
-
-  const answer = String(
-    await withPromptFn((rl) => askFn(rl, "Start guided Clio setup now", "yes"))
-  )
-    .trim()
-    .toLowerCase();
-
-  if (["n", "no", "skip"].includes(answer)) {
-    log("Skipping setup for now. Run `not-manage setup` when you are ready.");
-    return false;
-  }
-
-  await setupWizardFn();
-  return true;
-}
-
-async function main(options = {}) {
-  const log = options.log || console.log;
-  const errorLog = options.errorLog || console.error;
-
-  try {
-    await maybeRunPostinstallOnboarding(options);
-  } catch (_error) {
-    errorLog("Post-install setup was skipped.");
-    log("Run `not-manage setup` when you are ready.");
-  }
-}
-
-if (require.main === module) {
-  main();
-}
-
-module.exports = {
-  main,
-  maybeRunPostinstallOnboarding,
-  printConfidentialityNotice,
-  shouldShowPostinstallNotice,
-  shouldRunPostinstallOnboarding,
-};