feat: table context in document view + MCP registry metadata (#50)

* feat(docx-core): add table structure context to document view pipeline

- Add TableContext type with row/col coordinates, header text, grid-aware
  column positions, and table dimension metadata
- Add isW() and getDirectChildrenByName() shared DOM helpers
- Add table-aware toon rendering: th(r,c)/td(r,c) styles, #TABLE/#END_TABLE
  markers with dimensions-only format
- Derive table context via ancestor DOM walking in buildDocumentView()
- Add extractTables() module with header-keyed records and merged cell detection
- Preserve empty table cell paragraphs for structural completeness
- Maintain paragraph parity (same IDs in same order as before)
- Re-export tables module from barrel index

* feat(docx-mcp): add table markers to read_file output formats

- Update budget-aware toon renderer to emit #TABLE/#END_TABLE markers
  and use formatToonDataLine() for table-aware th/td styles
- Add renderSimpleWithTableMarkers() for non-budget simple format
- Update renderSimpleWithBudget() to handle table boundary markers
- Table markers count toward token budget but not paragraphsReturned
- Balanced #END_TABLE emitted on mid-table budget truncation

* test(docx-core, docx-mcp): add BDD tests for table context and table markers

- Add 14 BDD tests for table context derivation: simple table, paragraph
  parity, w:ins-wrapped rows, gridSpan, vMerge, multi-paragraph cells,
  empty cells, multiple tables, mixed body content, nested tables,
  renderToon markers, th/td styles, formatToonDataLine, collectTableMarkerInfo
- Add 4 pagination tests for table markers: toon output markers,
  paragraphsReturned not inflated, simple format markers, JSON table_context

* docs(openspec): add change proposal for table context in document view

- Add proposal, delta specs (docx-primitives, mcp-server), and task
  checklist for the add-table-context-to-document-view change
- Add E2E test script for visual inspection of table rendering

* docs(openspec): update spec to reflect header-dedup in #TABLE marker

The #TABLE marker no longer repeats column headers — they appear
exactly once in the th(0,N) data rows which carry editable _bk_* IDs.

* chore: add serial IDs to table context spec scenarios and fix spec-coverage

- Add SDX-TABLE-01..12 serial IDs to delta spec scenarios
- Update test .openspec() annotations to use serial IDs (DRY)
- Fix validators to resolve bare serial IDs in .openspec() calls
- Add TEST_FEATURE constants for spec-coverage discovery

* chore(openspec): archive table-context, inplace-cross-run, and mixed-status changes

Archive three completed changes into canonical specs:
- add-table-context-to-document-view → docx-primitives + mcp-server
- update-inplace-cross-run-recovery → docx-comparison
- fix-inplace-mixed-status-runs → archive only (no delta specs)

* test: add 13 coverage tests for table context edge cases and budget renderers

Covers getDirectChildrenByName, empty tables, gridSpan defaults,
multi-paragraph headers, consecutive tables, compact mode,
renderSimpleWithTableMarkers, and mid-table budget truncation paths.

* chore: retrigger CI

* Add MCP Registry metadata for SafeDocx discoverability

- Add server.json conforming to 2025-12-11 MCP Registry schema
- Add mcpName field, server.json to files array, and 8 new keywords in package.json
- Extend bump_version.mjs to sync server.json version in check and bump modes
- Add server.json version validation to release workflow preflight job
- Check off registry listing item in mcp-docs-checklist

* chore: add tables test, update README branding, and regenerate coverage baselines

* chore(release): bump workspace versions to 0.4.0

Author: stevenobiajulu

.github/workflows/release.yml

@@ -54,6 +54,11 @@ jobs:
             echo "Tag version ($TAG_VERSION) must match packages/safe-docx-mcpb/manifest.json version ($MANIFEST_VERSION)."
             exit 1
           fi
+          SERVER_VERSION="$(node -e "const fs=require('fs');const s=JSON.parse(fs.readFileSync('./packages/safe-docx/server.json','utf8'));process.stdout.write(s.version)")"
+          if [ "$TAG_VERSION" != "$SERVER_VERSION" ]; then
+            echo "Tag version ($TAG_VERSION) must match packages/safe-docx/server.json version ($SERVER_VERSION)."
+            exit 1
+          fi
 
       - name: Verify release commit is on main
         run: |

README.md

@@ -3,7 +3,9 @@
 [![CI](https://github.com/usejunior/safe-docx/actions/workflows/ci.yml/badge.svg)](https://github.com/usejunior/safe-docx/actions/workflows/ci.yml)
 [![codecov](https://img.shields.io/codecov/c/github/usejunior/safe-docx/main)](https://app.codecov.io/gh/usejunior/safe-docx)
 
-Use coding agents for paperwork too.
+**safe-docx** by [UseJunior](https://usejunior.com) — use coding agents for paperwork too.
+
+Part of the [UseJunior developer tools](https://usejunior.com/developer-tools/safe-docx).
 
 Safe Docx is an open-source TypeScript stack for surgical editing of existing Microsoft Word `.docx` files. It is built for workflows where an agent proposes changes and a human still needs reliable, formatting-preserving document edits.
 
@@ -133,6 +135,11 @@ npm run coverage:packages:check
 npm run coverage:matrix
 ```
 
+## See Also
+
+- [Open Agreements](https://github.com/open-agreements/open-agreements) — fill standard legal templates with coding agents (NDAs, SAFEs, NVCA)
+- [UseJunior Developer Tools](https://usejunior.com/developer-tools/safe-docx) — product page with install options and tool catalog
+
 ## Governance
 
 - [Contributing Guide](CONTRIBUTING.md)

coverage/allure-test-filename-baseline.json

@@ -1,3 +1 @@
-{
-  "allowed_allure_test_files": []
-}
+{"allowed_allure_test_files": []}

coverage/package-coverage-baseline.json

@@ -1,11 +1,11 @@
 {
-  "generated_at": "2026-03-01T00:30:00.000Z",
+  "generated_at": "2026-03-14T16:27:41.537Z",
   "packages": {
     "docx-core": {
-      "lines": 83.45,
-      "branches": 81.77,
-      "functions": 88.48,
-      "statements": 83.45,
+      "lines": 84.97,
+      "branches": 83.8,
+      "functions": 90.52,
+      "statements": 84.97,
       "deltas": {
         "lines": null,
         "branches": null,
@@ -14,10 +14,10 @@
       }
     },
     "docx-mcp": {
-      "lines": 85.80,
-      "branches": 78.54,
-      "functions": 93.29,
-      "statements": 85.80,
+      "lines": 87.07,
+      "branches": 80.72,
+      "functions": 93.04,
+      "statements": 87.07,
       "deltas": {
         "lines": null,
         "branches": null,
@@ -27,9 +27,9 @@
     }
   },
   "aggregate": {
-    "lines_mean": 84.68,
-    "branches_mean": 80.15,
-    "functions_mean": 90.88,
-    "statements_mean": 84.68
+    "lines_mean": 86.02,
+    "branches_mean": 82.26,
+    "functions_mean": 91.78,
+    "statements_mean": 86.02
   }
 }

docs/safe-docx/mcp-docs-checklist.md

@@ -48,5 +48,5 @@ Before adding more docs, trim anything that matches one of these:
 - [x] Generate tool docs from schema source (`docs/tool-reference.generated.md`).
 - [x] Add three golden prompts.
 - [ ] Publish `.mcpb` artifact in CI release flow.
-- [ ] List public package in MCP Registry when open-source launch is ready.
+- [x] List public package in MCP Registry when open-source launch is ready.
 - [ ] Add concise troubleshooting section in package README after first support feedback cycle.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "safe-docx-suite",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "private": true,
   "description": "Monorepo for Safe DOCX packages",
   "repository": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usejunior/allure-test-factory",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Shared Allure test helpers for vitest — BDD context, OpenSpec auto-inference, Prism.js highlighting",
   "type": "module",
   "exports": {

packages/allure-test-factory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usejunior/docx-core",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "OOXML (.docx) core library: primitives, comparison, and track changes",
   "type": "module",
   "main": "dist/index.js",

packages/docx-core/package.json

@@ -21,6 +21,7 @@ This matrix maps canonical spec `#### Scenario:` entries to scenario mappings ex
 | Continuation pattern inherits formatting | covered | `src/openspec.traceability.test.ts` |  |
 | Creating atom with revision detection | covered | `src/openspec.traceability.test.ts` |  |
 | Creating atom without revision context | covered | `src/openspec.traceability.test.ts` |  |
+| Cross-run pass rescues inplace output | missing | n/a | No scenario mapping found in current tests |
 | Custom footnote marks respected | covered | `src/openspec.traceability.test.ts` |  |
 | Custom threshold applied | covered | `src/openspec.traceability.test.ts` |  |
 | Different properties | covered | `src/openspec.traceability.test.ts` |  |
@@ -48,6 +49,7 @@ This matrix maps canonical spec `#### Scenario:` entries to scenario mappings ex
 | Partial overlap | covered | `src/openspec.traceability.test.ts` |  |
 | Proper nested list renders hierarchically | covered | `src/openspec.traceability.test.ts` |  |
 | Range IDs properly paired | covered | `src/openspec.traceability.test.ts` |  |
+| Rebuild fallback only after all inplace passes fail | missing | n/a | No scenario mapping found in current tests |
 | Remove existing revision tracking | covered | `src/openspec.traceability.test.ts` |  |
 | Reserved footnote IDs excluded from numbering | covered | `src/openspec.traceability.test.ts` |  |
 | Run with properties | covered | `src/openspec.traceability.test.ts` |  |
@@ -61,6 +63,7 @@ This matrix maps canonical spec `#### Scenario:` entries to scenario mappings ex
 | Status for moved destination content | covered | `src/openspec.traceability.test.ts` |  |
 | Status for moved source content | covered | `src/openspec.traceability.test.ts` |  |
 | Status for unmatched atoms | covered | `src/openspec.traceability.test.ts` |  |
+| Table-heavy run-fragmented templates preserve tracked table structure | missing | n/a | No scenario mapping found in current tests |
 | Text becomes bold | covered | `src/openspec.priority-scenarios.test.ts`, `src/openspec.traceability.test.ts` |  |
 | Unknown property name | covered | `src/openspec.traceability.test.ts` |  |