Skip to content

docs: align suite framing with cross-CLI INTEROP (template-vault-cli v0.4.8)#2

Merged
DrBaher merged 1 commit into
mainfrom
docs/suite-framing-interop
May 19, 2026
Merged

docs: align suite framing with cross-CLI INTEROP (template-vault-cli v0.4.8)#2
DrBaher merged 1 commit into
mainfrom
docs/suite-framing-interop

Conversation

@DrBaher
Copy link
Copy Markdown
Owner

@DrBaher DrBaher commented May 19, 2026

Summary

The README's "Part of the contract-operations CLI suite" header was the three-CLI framing (nda-review → docx2pdf → sign) and didn't reference template-vault-cli (the storage layer) or compare-cli (the auxiliary drift detector). template-vault-cli v0.4.8 codified the suite framing in docs/INTEROP.md; this PR brings docx2pdf-cli's header into line.

Updated header (one line; keeps the existing single-paragraph format and parenthetical role descriptions):

Part of the contract-operations CLI suite. draft-cli (fill placeholders) → nda-review-cli (review, redline, negotiate) → docx2pdf-cli (DOCX → PDF) → sign-cli (signing + audit). Storage layer: template-vault-cli. Drift detection: compare-cli. Showcase site.

Changes:

  • "three-CLI contract suite" → "contract-operations CLI suite" (matches the canonical suite name).
  • Adds draft-cli as the first chain step (placeholder fill).
  • Splits draft out of nda-review-cli's parenthetical: "(draft, review, negotiate)" → "(review, redline, negotiate)".
  • Adds template-vault-cli (storage) and compare-cli (drift) as auxiliaries after the linear chain — per INTEROP.md, auxiliaries are noted separately rather than inserted into the chain.

Out of scope (deliberately not in this PR)

Per the INTEROP doc, sibling repos may adopt the broader UX conventions (-V short flag, --demo, --why envelope shape, ~/.config/contract-ops/ for any shared config) at their own pace. None of those are changed here — this PR is a docs nudge only.

Test plan

  • npm test — 110/110 pass.
  • No code changed; no version bump; no CHANGELOG entry (release machinery untouched).
  • Manual: header renders correctly on github.com once merged.

🤖 Generated with Claude Code

…v0.4.8)

Add template-vault-cli (storage layer) and compare-cli (drift detector) to
the suite-chain header, and split draft-cli out of nda-review-cli's role so
the linear chain (draft → review → convert → sign) is explicit. Matches the
convention now documented in template-vault-cli/docs/INTEROP.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@DrBaher DrBaher force-pushed the docs/suite-framing-interop branch from 84b0847 to 210033e Compare May 19, 2026 18:33
@DrBaher DrBaher merged commit 15facec into main May 19, 2026
6 checks passed
@DrBaher DrBaher deleted the docs/suite-framing-interop branch May 19, 2026 18:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant