acstack 0.47.1 → 0.48.0

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acstack-cli",
-  "version": "0.47.1",
+  "version": "0.48.0",
   "description": "CLI for the ACStack agentic coding stack",
   "type": "module",
   "license": "MIT",
@@ -25,7 +25,7 @@
     "node": ">=20.0.0"
   },
   "scripts": {
-    "build": "npm run sync-version && node build.mjs",
+    "build": "npm run sync-version && node scripts/build-viewer.mjs && node build.mjs",
     "dev": "node build.mjs --watch",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
@@ -36,11 +36,19 @@
   "devDependencies": {
     "@eslint/js": "^9.39.5",
     "@types/node": "^22.0.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@xyflow/react": "^12.12.0",
     "chalk": "^5.4.0",
     "commander": "^14.0.0",
+    "elkjs": "^0.12.0",
     "esbuild": "^0.24.0",
     "eslint": "^9.39.5",
     "fast-glob": "^3.3.0",
+    "lucide-react": "^1.55.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "react-markdown": "^10.1.0",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^3.0.0",

package/docs/adr/0018-alignment-packs-use-local-viewers.md

@@ -0,0 +1,11 @@
+# Alignment packs use local viewers
+
+Alignment packs must not depend on a remote viewer or remote script. ACStack can open a generated pack in a local browser, including through a localhost server.
+
+## Considered options
+
+A pinned remote viewer keeps generated files smaller. It also makes review depend on network access and trust in a hosted script.
+
+## Consequences
+
+ACStack must inline or vendor the viewer code it needs. A Herdr-style terminal view can follow later if a clean graph viewer exists.

package/docs/adr/index.md

@@ -15,3 +15,4 @@
 - [0015](0015-a-node-id-links-to-its-issue-through-an-anchor.md) – A node id links to its issue through an anchor
 - [0016](0016-the-map-root-carries-no-status-of-its-own.md) – The map root carries no status of its own
 - [0017](0017-call-impeccable-copy-only-its-questions.md) – Call impeccable's command line, and copy only its question sets
+- [0018](0018-alignment-packs-use-local-viewers.md) – Alignment packs use local viewers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acstack",
-  "version": "0.47.1",
+  "version": "0.48.0",
   "private": false,
   "description": "Agentic coding stack with first-class Claude Code and pi support: skills, orchestrator instructions, and verification agents.",
   "license": "MIT",

package/skills/map/SKILL.md

@@ -94,7 +94,7 @@ operation. First the root:
 ```bash
 # files backend – github.md has the equivalent
 ~/.claude/acstack/bin/acstack node create --map <name> --title "<destination>" \
-  --kind destination --label "<at most four words>" \
+  --kind destination --label "<at most four words>" --summary "<one sentence>" \
   --body "<the destination, as settled>"
 ```
 
@@ -111,9 +111,9 @@ operation. First the root:
 - On GitHub, every node body opens with a header line that encodes its edges.
   `trackers/github.md` holds the format. The files backend writes none.
 
-- Every node carries a `kind` and a `label`, both required. A `label` is the
-  node's short name for a diagram. `trackers/files.md` holds the kinds, the
-  caps, and the contract the CLI enforces.
+- Every node carries a required `kind` and `label`, its short diagram name.
+  Work nodes and the destination add a one-sentence business `--summary`.
+  `trackers/files.md` holds the kinds, the caps, and the CLI's contract.
 
 - Every node body carries a diagram, two at most. A childless `notes` node is
   the one exception.

package/skills/map/trackers/files.md

@@ -16,15 +16,18 @@ To enumerate a project's maps: `ls acstack/maps/`.
 
 | Operation | Command |
 | --------- | ------- |
-| create    | `acstack node create --map <name> --title <t> --kind <k> --label <l> [--status] [--mode] [--answers <id>] [--blocked-by <ids>] [--pinned] [--body <md>] [--body-file <path>]` |
+| create    | `acstack node create --map <name> --title <t> --kind <k> --label <l> [--summary <s>] [--status] [--mode] [--answers <id>] [--blocked-by <ids>] [--pinned] [--body <md>] [--body-file <path>]` |
 | read      | `acstack node read <id> --map <name> [--json] [--visuals]` |
-| update    | `acstack node update <id> --map <name> [--title] [--status] [--mode] [--kind] [--label] [--answers] [--blocked-by] [--pinned true\|false] [--body] [--body-file] [--append-body]` |
+| update    | `acstack node update <id> --map <name> [--title] [--status] [--mode] [--kind] [--label] [--summary] [--answers] [--blocked-by] [--pinned true\|false] [--body] [--body-file] [--append-body]` |
 | list      | `acstack node list --map <name> [--status <s>] [--json]` |
 
 `create` rejects a node that omits `--kind` or `--label`. `--kind` takes one of
 `destination`, `notes`, `decision`, `research`, or `work`. `--label` takes the
 node's short name for a diagram, at most four words and thirty characters.
 
+`--summary` is optional: one plain sentence, on one line, for a business
+reader. `create` refuses a blank one, and on `update` an empty string clears it.
+
 ## No body header
 
 The GitHub backend opens every node body with a header line, because an issue