@aryacode/dsh-engineering 0.8.2 → 0.8.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.8.3] - 2026-10-27
+
+### Documentation
+
+- **A workflow handbook, generated from one source.** `docs/handbook/Engineering-Handbook.pdf` (7 pages),
+  an editable `.docx` and a printable `.html` cover the four products: what each row needs, the shared
+  read → act → verify → hand-off loop, what the agent does, what stays human, and a "what proves what"
+  table.
+- **Six workflow diagrams** in `docs/diagrams/` (SVG masters and PNG): the shared loop and one per
+  product, with agent steps, human steps and proof steps visually distinguished. They are embedded in
+  `docs/getting-started.md` and in the handbook.
+- The diagrams and handbook are **generated**, not hand-drawn: `scripts/gen-diagrams.py` owns the layout
+  and `scripts/gen-handbook.py` the prose, so a changed workflow is one edit and one regeneration.
+- README: the handbook in the documentation table and the generators in the Development commands.
 ## [0.8.2] - 2026-10-27
 
 ### Documentation

package/README.md

@@ -238,6 +238,7 @@ even when the implementation behind a row is replaced.
 | Document | Owns |
 |---|---|
 | [Getting started](docs/getting-started.md) | The first session: what each row needs, the shared loop, and a paste-ready prompt per product |
+| [Workflow handbook (PDF)](docs/handbook/Engineering-Handbook.pdf) | The whole surface as a printable handbook with the four workflow diagrams; [editable DOCX](docs/handbook/Engineering-Handbook.docx) and [HTML](docs/handbook/Engineering-Handbook.html) beside it |
 | [Tool reference](docs/reference/tools.md) | Every tool, parameter and description (generated) |
 | [Examples](docs/examples.md) | End-to-end sessions per product |
 | [Architecture](docs/architecture.md) | Composition, row model, configuration, client faces, packaging |
@@ -256,8 +257,14 @@ pnpm build:client  # regenerate lib/client.js from the committed face bundles
 pnpm test          # patch, docs, tool-reference, manifest and client-face checks
 pnpm docs:tools    # regenerate the tool reference from the registered definitions
 pnpm docs:check    # fail if the committed reference has drifted
+python scripts/gen-diagrams.py   # regenerate docs/diagrams/*.svg and *.png
+python scripts/gen-handbook.py   # rebuild the PDF, DOCX and HTML handbook from those figures
 ```
 
+The diagrams and the handbook are generated, not hand-drawn: layout lives in
+`scripts/gen-diagrams.py` and the prose in `scripts/gen-handbook.py`, so a changed workflow is one edit
+and one regeneration. Both need Pillow; the handbook also needs python-docx and reportlab.
+
 Tests run through `tsx` so they can read the TypeScript tool factories. A registered tool that no
 skill governs fails the suite — the policy is a test, not a convention.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryacode/dsh-engineering",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "AryaCode engineering bundle: one install surface for the Studio 5000 L5X, FactoryTalk View ME, MotionWorks IEC and FactoryTalk Optix surfaces, one row per product, with the ladder and display previews.",
   "keywords": [
     "dsh",