acstack 0.47.0 → 0.48.0

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acstack-cli",
-  "version": "0.47.0",
+  "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/docs/terminal-workspace.md

@@ -370,6 +370,9 @@ What `apply` does:
     - It adds web search, URL fetching, GitHub repo cloning, PDF extraction and media understanding tools to pi
     - This is separate from pi's anonymous install and update reporting; `pi.settings.install_telemetry: false` still controls that telemetry setting
     - Set `pi.web_access: false` to leave it out, or to remove it later if this setup installed it
+- It can install `pi-lens` for diagnostics and code-intelligence tools
+    - It is off by default because it is a heavier dev-tool layer
+    - Set `pi.lens: true` to install it, or `pi.lens: false` to remove it later if this setup installed it
 - It installs `pi-slash-anywhere` by default, so slash commands work from any prompt
     - Set `pi.slash_anywhere: false` to leave it out, or to remove it later if this setup installed it
 - It installs `pi-compact-tools` and runs `agentic-retro install-pi`, each behind its own toggle
@@ -380,6 +383,8 @@ What `apply` does:
 - It sets `"toolActivation": "eager"` in `~/.pi/agent/extensions/subagent/config.json`
 - It binds `"app.message.dequeue"` to `"ctrl+enter"` in `~/.pi/agent/keybindings.json`
 - It writes the four keys under `pi.settings` into `~/.pi/agent/settings.json`
+- It patches pi's bundled TUI so Windows Terminal Win32 input records paste as text
+    - `pi update` can replace the bundle, so `setup.sh upgrade pi` reapplies the patch
 
 How it treats pi's files:
 
@@ -396,7 +401,7 @@ How it treats pi's files:
 - `apply` never touches `auth.json`
     - Run `pi`, then `/login`, yourself
 - `setup.sh status` reports pi's version, its packages, the delegation line, `toolActivation`, and whether `auth.json` exists
-- `setup.sh outdated` and `setup.sh upgrade` include `billion-context`, `@juicesharp/rpiv-todo`, `pi-plugin-manager`, `@juicesharp/rpiv-ask-user-question`, `pi-web-access`, and `pi-slash-anywhere` like pi's other npm packages
+- `setup.sh outdated` and `setup.sh upgrade` include `billion-context`, `@juicesharp/rpiv-todo`, `pi-plugin-manager`, `@juicesharp/rpiv-ask-user-question`, `pi-web-access`, `pi-lens`, and `pi-slash-anywhere` like pi's other npm packages
 
 ## 4. How you attach
 
@@ -472,6 +477,7 @@ The two paths deliver keys by different routes.
 - The two routes do not carry the same set
 - The `ctrl+alt` family survives the escape-sequence route and dies on the native one
 - `ctrl+<digit>` does the opposite
+
 - Either way herdr accepts the binding and then never sees the key
 - A chord that does not cross is therefore silently dead, and herdr reports no error
 - `alt+<key>` is the only family that crossed both

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acstack",
-  "version": "0.47.0",
+  "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