@canra/cli 0.6.0 → 0.7.0

package/README.md

@@ -24,8 +24,8 @@ canra search json
 | `canra search <query>` | Search the registry |
 | `canra info <owner>/<name>` | Show a spec's metadata |
 | `canra fetch <owner>/<name>[@version]` | Download a spec (latest or a pinned version), verify its SHA-256, and save it to `.canra/specs/<owner>/<name>/` |
-| `canra outdated [--json]` | Check fetched specs for newer versions; exits 1 if any is outdated |
-| `canra update [<owner>/<name>]` | Re-fetch the latest version of every outdated spec (or the named one) |
+| `canra outdated [--json]` | Check fetched specs for newer versions; exits 1 if any is outdated or quarantined |
+| `canra update [<owner>/<name>]` | Re-fetch the latest version of every outdated spec (or the named one); exits 1 if any spec is quarantined or fails to update |
 | `canra remove <owner>/<name>` | Delete a fetched spec from `.canra/specs/` |
 | `canra login` | Save a registry URL and API token |
 | `canra whoami` | Show which account your saved token belongs to |

package/canra.js

@@ -645,6 +645,20 @@ function needsUpdate(row) {
   return row.status === "outdated" || (row.status === "current" && Boolean(row.moved_to));
 }
 
+function isQuarantined(row) {
+  return row.status === "quarantined";
+}
+
+function warnQuarantined(results) {
+  const quarantined = results.filter(isQuarantined);
+  for (const r of quarantined) {
+    console.warn(
+      `Warning: ${printable(r.owner)}/${printable(r.name)} is quarantined on the registry and cannot be updated. Remove it with canra remove, or wait for the registry to restore it.`,
+    );
+  }
+  return quarantined.length;
+}
+
 async function cmdOutdated(args) {
   const asJson = args.includes("--json");
   const refs = scanLocalSpecs();
@@ -655,19 +669,22 @@ async function cmdOutdated(args) {
 
   const results = await checkRemote(getRegistry(), refs);
   const outdated = results.filter(needsUpdate).length;
+  const quarantined = results.filter(isQuarantined).length;
 
+  // --json prints no warnings, so the output stays machine-readable; the exit code carries the quarantine signal.
   if (asJson) {
     console.log(JSON.stringify(results, null, 2));
   } else {
     printOutdatedTable(results);
-    if (results.some(needsUpdate)) {
+    warnQuarantined(results);
+    if (outdated > 0) {
       console.log(`\n${outdated} outdated spec${outdated !== 1 ? "s" : ""}.`);
       console.log("Run canra update, then git diff .canra/ to review the changes.");
-    } else {
+    } else if (quarantined === 0) {
       console.log("\nAll specs are up to date.");
     }
   }
-  if (outdated > 0) process.exitCode = 1;
+  if (outdated > 0 || quarantined > 0) process.exitCode = 1;
 }
 
 function deleteLocalSpec(owner, name) {
@@ -724,9 +741,12 @@ async function cmdUpdate(specArg) {
   }
 
   const registry = getRegistry();
-  const targets = (await checkRemote(registry, refs)).filter(needsUpdate);
+  const results = await checkRemote(registry, refs);
+  const quarantined = warnQuarantined(results);
+  const targets = results.filter(needsUpdate);
   if (targets.length === 0) {
-    console.log("All specs are up to date.");
+    if (quarantined === 0) console.log("All specs are up to date.");
+    else process.exitCode = 1;
     return;
   }
 
@@ -761,7 +781,7 @@ async function cmdUpdate(specArg) {
     }
   }
   if (updated > 0) console.log("\nRun git diff .canra/ to review the changes.");
-  if (failed > 0) process.exitCode = 1;
+  if (failed > 0 || quarantined > 0) process.exitCode = 1;
 }
 
 function cmdHelp() {
@@ -786,9 +806,11 @@ Commands:
   whoami                   Print the user your saved token authenticates as
   info <owner>/<name>      Print spec metadata
   outdated [--json]        Check .canra/specs/ for newer versions; exits 1 if
-                           any spec is outdated; --json prints the results
+                           any spec is outdated or quarantined; --json prints
+                           the results
   update [<owner>/<name>]  Re-fetch the latest version of every outdated spec
-                           (or just the named one); review with git diff .canra/
+                           (or just the named one); review with git diff .canra/;
+                           exits 1 if any spec is quarantined or fails
   remove <owner>/<name>    Delete a fetched spec from .canra/specs/
   help                     Print this help message
   version                  Print CLI version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canra/cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "CLI for Canra, the registry of machine-readable specs: fetch, search, and publish specs.",
   "keywords": [
     "canra",