storymaps 1.2.5 → 1.2.6

package/README.md

@@ -257,6 +257,8 @@ slices:
 
 Cards support: `name`, `body`, `color`, `status` (done / in-progress / planned / blocked), `points`, `tags`, and `url`.
 
+Slices support: `name`, `stories`, `goal` (up to 200 characters), `targetDate` (`YYYY-MM-DD`), and `collapsed` with `closedReason` (complete / closed).
+
 ## Self-Hosting
 
 The CLI works with any storymaps.io instance:
@@ -267,6 +269,36 @@ storymaps init --site storymaps.yourcompany.com
 
 See the [main project README](https://github.com/jackgleeson/storymaps.io#self-hosting) for setup instructions.
 
+## Development
+
+```bash
+npm install
+npm test
+```
+
+`npm test` runs the unit tests in `test/unit` with Node's built-in test runner (Node 22 or later). They cover the YAML format, the API client, the change summary, and how a target resolves to a map, with no server needed. CI runs them on Node 22 and 24 for every push to `main` and every pull request.
+
+To try a change against a local storymaps.io server, run the CLI from the repo, for example `node bin/storymaps.js pull localhost/<map-id>`.
+
+### Releasing
+
+1. Commit your changes on `main`.
+2. Bump the version in `package.json` and commit it as "Bump version to x.y.z". Use a patch for fixes and a minor version for new features.
+3. Tag the commit and push both:
+   ```bash
+   git tag vx.y.z
+   git push origin main vx.y.z
+   ```
+4. Check you're logged in to npm, then publish:
+   ```bash
+   npm whoami        # if this fails, run npm login
+   npm pack --dry-run   # optional: list what will be published
+   npm publish
+   ```
+5. Confirm the new version is live with `npm view storymaps version`.
+
+Only `bin/`, `lib/`, the README and the licence are published (see `files` in `package.json`).
+
 ## Licence
 
 AGPL-3.0 - see [LICENCE](LICENCE) for details.

package/lib/commands/init.js

@@ -36,11 +36,6 @@ slices:
     stories:
       New Step:
         - name: New Task or Detail
-notes: >-
-  Thanks for trying Storymaps.io! If you find it useful, please consider starring the open-source repo:
-  https://github.com/jackgleeson/storymaps.io
-
-  Have a great day!
 `;
 }
 
@@ -83,7 +78,8 @@ export async function initCommand(opts) {
     try {
         const { id } = await postMap(baseUrl, output, 'text/yaml');
         output = output.replace(/^(name: My Story Map\n)/, `$1id: ${id}\n`);
-        console.log(chalk.green(`Created storymap.yml (map ID: ${id})\n`));
+        console.log(chalk.green(`Created storymap.yml (map ID: ${id})`));
+        console.log(`${chalk.cyan(`${baseUrl}/${id}`)}\n`);
     } catch {
         console.log(chalk.green('Created storymap.yml\n'));
         console.log(chalk.dim('Tip: run "storymaps push" to upload the map when you\'re ready to sync.\n'));

package/package.json

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