storymaps 1.3.0 → 1.3.1

package/README.md

@@ -138,9 +138,10 @@ storymaps diff file1.yml file2.yml    # compare two local files
 ```bash
 storymaps status                      # progress overview of storymap.yml
 storymaps status other.yml            # progress overview of a specific file
+storymaps status storymaps.io/abc123  # progress overview of a map on the server, no file needed
 ```
 
-Progress overview: slices, status counts, and blocked stories.
+Progress overview: slices, status counts, and blocked stories. A link to a map inside a project works too.
 
 ### `log`
 

package/bin/storymaps.js

@@ -99,7 +99,7 @@ program
 program
     .command('status')
     .description('Show a progress overview of the story map')
-    .argument('[file]', 'path to storymap file')
+    .argument('[target]', 'storymap file, or a map ID, domain/ID, or full URL')
     .option('-f, --file <path>', 'path to storymap file', 'storymap.yml')
     .action(statusCommand);
 

package/lib/commands/status.js

@@ -5,6 +5,8 @@ import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import chalk from 'chalk';
 import jsyaml from 'js-yaml';
+import { resolveTarget } from '../util/identity.js';
+import { getMap, ApiError } from '../util/api.js';
 
 const STATUS_ICONS = {
     'done':        chalk.green('●'),
@@ -24,16 +26,34 @@ function pct(n, total) {
     return `${Math.round((n / total) * 100)}%`;
 }
 
-export async function statusCommand(target, opts) {
-    const filePath = resolve(target || opts.file || 'storymap.yml');
-
-    let content;
+// A local file, or else the map on the server when the target is a link or map ID
+async function loadContent(target, opts) {
+    const isUrl = target && /^https?:\/\//i.test(target);
+    const filePath = resolve((!isUrl && target) || opts.file || 'storymap.yml');
+    if (!isUrl) {
+        try {
+            return await readFile(filePath, 'utf-8');
+        } catch {
+            if (!target) {
+                console.error(chalk.red(`File not found: ${filePath}`));
+                process.exit(1);
+            }
+        }
+    }
+    const { id, baseUrl } = await resolveTarget(target, resolve(opts.file || 'storymap.yml'));
     try {
-        content = await readFile(filePath, 'utf-8');
-    } catch {
-        console.error(chalk.red(`File not found: ${filePath}`));
-        process.exit(1);
+        return (await getMap(baseUrl, id, 'yaml')).data;
+    } catch (err) {
+        if (err instanceof ApiError && err.status === 404 && !isUrl && !target.includes('/')) {
+            console.error(chalk.red(`No file or map found: ${target}`));
+            process.exit(1);
+        }
+        throw err;
     }
+}
+
+export async function statusCommand(target, opts) {
+    const content = await loadContent(target, opts);
 
     const map = jsyaml.load(content);
     if (!map || typeof map !== 'object') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storymaps",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "CLI tool for storymaps.io - import, export, validate, and manage user story maps from the terminal",
   "type": "module",
   "bin": {