storymaps 1.1.2 → 1.2.1

package/README.md

@@ -133,6 +133,15 @@ storymaps status other.yml            # progress overview of a specific file
 
 Progress overview: slices, status counts, and blocked stories.
 
+### `log`
+
+```bash
+storymaps log                         # activity log for storymap.yml
+storymaps log storymaps.io/abc123     # activity log for a specific map
+```
+
+Shows timestamped activity entries with source labels (cli, mobile, web).
+
 ### `lock` / `unlock`
 
 ```bash

package/bin/storymaps.js

@@ -16,6 +16,7 @@ import { openCommand } from '../lib/commands/open.js';
 import { lockCommand } from '../lib/commands/lock.js';
 import { unlockCommand } from '../lib/commands/unlock.js';
 import { statusCommand } from '../lib/commands/status.js';
+import { logCommand } from '../lib/commands/log.js';
 
 
 const program = new Command();
@@ -101,6 +102,12 @@ program
     .option('-f, --file <path>', 'path to storymap file', 'storymap.yml')
     .action(statusCommand);
 
+program
+    .command('log')
+    .description('Show activity log for a map')
+    .argument('[target]', 'map ID, domain/ID, or full URL')
+    .option('-f, --file <path>', 'local file path', 'storymap.yml')
+    .action(logCommand);
 
 program.parseAsync().catch(err => {
     const message = err.name === 'ExitPromptError' ? 'Cancelled.'

package/lib/commands/log.js

@@ -0,0 +1,42 @@
+// Storymaps CLI — AGPL-3.0 — see LICENCE for details
+// storymaps log — show activity log for a map
+
+import { resolve } from 'node:path';
+import chalk from 'chalk';
+import { resolveTarget } from '../util/identity.js';
+import { getLog } from '../util/api.js';
+
+function formatTime(ts) {
+    const d = new Date(ts);
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    const time = `${pad(d.getHours())}:${pad(d.getMinutes())}`;
+
+    if (d.toDateString() === now.toDateString()) return time;
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${time}`;
+}
+
+function sourceLabel(entry) {
+    if (entry.src === 'cli') return '>_';
+    if (entry.src === 'mobile') return '📱';
+    return '🌐';
+}
+
+export async function logCommand(target, opts) {
+    const filePath = resolve(opts.file || 'storymap.yml');
+    const { id, baseUrl } = await resolveTarget(target, filePath);
+
+    const entries = await getLog(baseUrl, id);
+
+    if (entries.length === 0) {
+        console.log(chalk.dim('No activity yet.'));
+        return;
+    }
+
+    for (const entry of entries) {
+        const time = chalk.dim(formatTime(entry.ts));
+        const icon = sourceLabel(entry);
+        const who = entry.src !== 'cli' ? `${entry.name || 'guest'}: ` : '';
+        console.log(`${time}  ${icon}  ${who}${entry.text}`);
+    }
+}

package/lib/util/api.js

@@ -97,4 +97,10 @@ export async function removeLock(baseUrl, id, passwordHash) {
     return res.json();
 }
 
+export async function getLog(baseUrl, id) {
+    const res = await fetch(`${baseUrl}/api/maps/${id}/log`);
+    await handleResponse(res);
+    return res.json();
+}
+
 export { ApiError };

package/package.json

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