@caddis/cli 0.4.16 → 0.4.19

package/bundles/antigravity-plugin/scripts/caddis_statusline.py

@@ -38,8 +38,22 @@ import shutil
 import subprocess
 import sys
 import time
+import datetime
+import traceback
 from pathlib import Path
 
+_DEBUG_LOG = Path.home() / ".caddis" / "statusline_debug.log"
+def _debug_log(msg: str):
+    if not os.environ.get("CADDIS_STATUSLINE_DEBUG"):
+        return
+    try:
+        with open(_DEBUG_LOG, "a", encoding="utf-8") as f:
+            f.write(f"[{datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S.%f')}] [PID {os.getpid()}] {msg}\n")
+    except Exception:
+        pass
+
+_debug_log(f"INVOKE: argv={sys.argv} cwd={os.getcwd()}")
+
 # --------------------------------------------------------------------------------------
 # Config
 # --------------------------------------------------------------------------------------
@@ -186,17 +200,30 @@ def term_width() -> int:
 # Host facts the payload does not carry
 # --------------------------------------------------------------------------------------
 
+_GIT_CACHE_FILE = Path.home() / ".caddis" / ".git_status_cache.json"
+
+
 def git_facts(cwd: str) -> dict:
     """One `git status --porcelain=v2 --branch` call -> branch, staged/unstaged/untracked,
-    ahead/behind. The v2 format gives all of it in a single invocation, which is why the
-    old bash line dropped its two-calls-plus-grep-plus-awk approach."""
+    ahead/behind. Uses a 2-second cache file per cwd to eliminate git process thrashing on rapid
+    status updates."""
     out = {"branch": "", "staged": 0, "unstaged": 0, "untracked": 0, "ahead": 0, "behind": 0}
     if not cwd or not os.path.isdir(cwd):
         return out
+
+    now = time.time()
+    try:
+        if _GIT_CACHE_FILE.exists():
+            cached = json.loads(_GIT_CACHE_FILE.read_text(encoding="utf-8"))
+            if cached.get("cwd") == cwd and (now - cached.get("time", 0)) < 2.0:
+                return cached.get("facts", out)
+    except Exception:
+        pass
+
     try:
         proc = subprocess.run(
             ["git", "-C", cwd, "--no-optional-locks", "status", "--porcelain=v2", "--branch"],
-            stdout=subprocess.PIPE, stderr=subprocess.DEVNULL, timeout=1.0,
+            stdout=subprocess.PIPE, stderr=subprocess.DEVNULL, timeout=0.8,
         )
         text = proc.stdout.decode("utf-8", "replace")
     except Exception:
@@ -223,6 +250,12 @@ def git_facts(cwd: str) -> dict:
             out["unstaged"] += 1
         elif line.startswith("? "):
             out["untracked"] += 1
+
+    try:
+        _GIT_CACHE_FILE.write_text(json.dumps({"cwd": cwd, "time": now, "facts": out}), encoding="utf-8")
+    except Exception:
+        pass
+
     return out
 
 
@@ -722,7 +755,19 @@ def wire_host(host: str, settings_path: Path, command: str, dry_run: bool) -> in
     if host == "agy":
         entry["enabled"] = True  # agy ignores a statusLine block without this
 
-    if data.get("statusLine") == entry:
+    changed = False
+    if data.get("statusLine") != entry:
+        data["statusLine"] = entry
+        changed = True
+
+    if host == "agy":
+        title_cmd = command.replace("--profile agy", "--title")
+        title_entry = {"type": "command", "command": title_cmd, "enabled": True}
+        if data.get("title") != title_entry:
+            data["title"] = title_entry
+            changed = True
+
+    if not changed:
         print("  ok %-6s already wired" % host)
         return 0
 
@@ -730,7 +775,6 @@ def wire_host(host: str, settings_path: Path, command: str, dry_run: bool) -> in
         if settings_path.exists():
             backup = settings_path.with_suffix(settings_path.suffix + ".bak-caddis-statusline")
             shutil.copyfile(str(settings_path), str(backup))
-        data["statusLine"] = entry
         settings_path.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
     print("  ok %-6s wired -> %s" % (host, settings_path))
     return 0
@@ -761,6 +805,12 @@ def check() -> int:
         else:
             print("  !! %-6s points elsewhere: %s" % (host, cmd))
             bad += 1
+        if host == "agy":
+            t_entry = data.get("title")
+            if isinstance(t_entry, dict) and "statusline.py" in str(t_entry.get("command", "")) and "--title" in str(t_entry.get("command", "")):
+                print("  ok agy-title %s" % t_entry.get("command"))
+            else:
+                print("  -- agy-title not wired to statusline.py (run --install to wire)")
     return bad
 
 
@@ -815,6 +865,7 @@ def main(argv=None) -> int:
     parser.add_argument("--sample", action="store_true", help="render a fake payload (preview / test)")
     parser.add_argument("--dry-run", action="store_true", help="with --install: print, write nothing")
     parser.add_argument("--no-color", action="store_true", help="render without ANSI colour")
+    parser.add_argument("--title", action="store_true", help="render terminal title (agy)")
     args = parser.parse_args(argv)
 
     # The line is Unicode. On Windows the default cp1252 stdout raises on ◆/⎇/█.
@@ -827,6 +878,21 @@ def main(argv=None) -> int:
     except Exception:
         pass
 
+    if args.title:
+        cwd = os.getcwd()
+        repo = os.path.basename(cwd) or cwd
+        facts = git_facts(cwd)
+        branch = facts.get("branch", "")
+        if branch:
+            print(f"agy: {repo} [{branch}]")
+        else:
+            print(f"agy: {repo}")
+        try:
+            sys.stdout.flush()
+        except Exception:
+            pass
+        return 0
+
     if args.install:
         hosts = ["claude", "agy"] if args.host == "both" else [args.host]
         return 1 if install(hosts, args.dry_run) else 0
@@ -838,31 +904,39 @@ def main(argv=None) -> int:
     if args.no_color:
         cfg["color"] = False
 
+    t0 = time.time()
     if args.sample:
         data = SAMPLES[args.profile]
     else:
         try:
             raw = sys.stdin.read()
-        except Exception:
+        except Exception as e:
+            _debug_log(f"stdin.read exception: {e}")
             raw = ""
+        _debug_log(f"stdin read: {len(raw)} bytes in {time.time()-t0:.3f}s")
         start = raw.find("{")  # strip a UTF-8 BOM or any leading noise
         try:
             data = json.loads(raw[start:]) if start >= 0 else {}
-        except Exception:
+        except Exception as e:
+            _debug_log(f"json.loads exception: {e}")
             data = {}
         if not isinstance(data, dict):
             data = {}
 
     try:
         line = RENDERERS[args.profile](data, cfg)
-    except Exception:
+        _debug_log(f"Rendered in {time.time()-t0:.3f}s")
+    except Exception as e:
+        _debug_log(f"Renderer exception: {traceback.format_exc()}")
         # A status line must never break the host. Degrade to the directory name.
         line = os.path.basename(os.getcwd())
 
     try:
         print(line)
         sys.stdout.flush()
-    except (BrokenPipeError, OSError):
+        _debug_log(f"Printed and flushed in {time.time()-t0:.3f}s")
+    except (BrokenPipeError, OSError) as e:
+        _debug_log(f"BrokenPipeError on flush: {e}")
         # Parent process cancelled or closed stdout pipe (e.g. agy runner on user prompt/state switch).
         # Redirecting to devnull prevents Windows Python from throwing unhandled TextIOWrapper errors on exit.
         try:
@@ -871,7 +945,8 @@ def main(argv=None) -> int:
         except Exception:
             pass
         return 0
-    except Exception:
+    except Exception as e:
+        _debug_log(f"Flush exception: {e}")
         return 0
 
     return 0
@@ -880,10 +955,12 @@ def main(argv=None) -> int:
 if __name__ == "__main__":
     try:
         code = main()
-    except BaseException:
+    except BaseException as e:
+        _debug_log(f"Unhandled exception in main: {traceback.format_exc()}")
         code = 0
     try:
         sys.stdout.flush()
-    except Exception:
-        pass
-    sys.exit(code)
+    except Exception as e:
+        _debug_log(f"Final flush exception: {e}")
+    _debug_log(f"EXIT with code {code}")
+    os._exit(code)

package/bundles/antigravity-plugin/skills/_registry.md

@@ -50,6 +50,8 @@
 | Code Documentation | `code-documentation/` | Writing effective code documentation - API docs, README files, inline comments, and technical guides. Use for documenting codebases, APIs, or writing developer guides. |
 | Confluence Hla | `confluence-hla/` | Author enterprise High-Level Architecture (HLA) documents in Simplified Technical English and generate Confluence Storage Format XHTML with self-contained PlantUML diagrams, wrapped tables, and zero AI fingerprints. Use when creating high-level architecture designs, architecture documentation for Confluence, or converting markdown architecture to Confluence storage format. |
 | Explainer Doc | `explainer-doc/` | Write a document that hands off work to a team who did NOT do the investigation — an external vendor, another team, a contractor — and who must be able to act on it alone. Use when the user says "write a spec for the X team", "document this for someone outside the team", "explainer doc", "implementation spec for a vendor", "hand this off to Y", or is about to write a design doc whose primary reader did not live through the debugging/design process. NOT for internal specs where the reader already has full context (use technical-writing or writing-plans instead) — this is specifically for the "stranger must follow it alone" case. |
+| Hld | `hld/` | Generate High-Level Design (HLD) Markdown documentation and Confluence XHTML with Draw.io diagrams. |
+| Lld | `lld/` | Generate Lower-Level Design (LLD) Markdown documentation and Confluence XHTML with Draw.io diagrams. |
 | Tech Explainer | `tech-explainer/` | >- |
 | Technical Writing | `technical-writing/` | Technical documentation best practices for READMEs, API docs, architecture docs, runbooks, and developer guides. Use when writing or reviewing documentation, creating onboarding guides, or establishing documentation standards. |
 | Writing Plans | `writing-plans/` | Use when you have a spec or requirements for a multi-step task, before touching code |
@@ -83,6 +85,7 @@
 | Kb | `kb/` | Rebuild the KB index (.caddis/kb/DOC-MAP.md) — create it if missing, index un-indexed notes, report dangling links |
 | Mermaid Db | `mermaid-db/` | Turn a SQL artifact (proc, view, query, .sql file, or table name) into a Mermaid diagram that explains it — git-diffable, saved as .md |
 | Migrate Dir | `migrate-dir/` | Rename this repo's legacy `.claudster/` artifact dir to `.caddis/` — dry-run first, `git mv` to keep history, merges a straggler dir, rewrites live refs. Opt-in, never automatic. |
+| Mmr | `mmr/` | Multi-Model Review & Runner (MMR) — run an ad-hoc task in an isolated multi-lane sandbox with rate-limit failover, test gates, and second-vendor review, or run a fast cross-model review on a diff |
 | Park | `park/` | File a future-work item in the one backlog — .caddis/parking-lot/ — or list what is open |
 | Pr Merge | `pr-merge/` | End-to-end pull request and merge lane — push feature branch, open or update PR, monitor CI to green, merge to default branch, and clean up the feature branch. |
 | Prd | `prd/` | Capture requirements through structured discovery and write a PRD |

package/bundles/antigravity-plugin/skills/hld/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: hld
+description: Generate High-Level Design (HLD) Markdown documentation and Confluence XHTML with Draw.io diagrams.
+---
+
+# /hld Command
+
+Run the High-Level Design (HLD) generation procedure:
+
+1. **Research & Scope Analysis:**
+   - Review target application architecture, user navigation surfaces, and primary databases.
+   - Enforce HLD boundaries: exclude internal API routes, low-level stored procedures, and detailed ETL scripts.
+   - Use high-level reporting summary tables and domain entities only.
+
+2. **Author Canonical Markdown Document:**
+   - Create document at `docs/<app>/<app>-hld.md`.
+   - Adhere strictly to the standard 7-section HLD structure.
+   - Ensure Mermaid diagrams depict automated schedulers as system participants, not human actors.
+   - Use ASD-STE100 Simplified Technical English: active voice, short sentences, zero em-dashes.
+
+3. **Convert to Confluence Storage Format XHTML:**
+   - Run the Draw.io-enabled converter:
+     ```bash
+     python scripts/convert_doc_to_confluence.py docs/<app>/<app>-hld.md --output docs/<app>/<app>-hld.html
+     ```
+   - Verify that all diagrams are converted to native `<ac:structured-macro ac:name="drawio">` blocks.
+   - Verify that output validates as well-formed XML.

package/bundles/antigravity-plugin/skills/lld/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: lld
+description: Generate Lower-Level Design (LLD) Markdown documentation and Confluence XHTML with Draw.io diagrams.
+---
+
+# /lld Command
+
+Run the Lower-Level Design (LLD) generation procedure:
+
+1. **Detailed Technical Discovery:**
+   - Scan physical hosts, service managers (NSSM, systemd), environment configurations, and ports.
+   - Extract internal API routes, controllers, middleware, and dependency injection patterns.
+   - Inspect database schemas, tables, views, primary keys, and index configurations.
+   - Catalog stored procedures (`usp_*`), parameter lists, business logic flows, and return codes.
+   - Map batch ingestion scripts, command-line arguments, and background refresher polling loops.
+
+2. **Author Canonical Markdown Document:**
+   - Create document at `docs/<app>/<app>-lld.md`.
+   - Adhere strictly to the standard 7-section LLD structure.
+   - Detail every stored procedure, table, ETL job, and endpoint contract.
+   - Include detailed Mermaid sequence, flowchart, and component interaction diagrams.
+   - Use ASD-STE100 Simplified Technical English: active voice, short sentences, zero em-dashes.
+
+3. **Convert to Confluence Storage Format XHTML:**
+   - Run the Draw.io-enabled converter:
+     ```bash
+     python scripts/convert_doc_to_confluence.py docs/<app>/<app>-lld.md --output docs/<app>/<app>-lld.html
+     ```
+   - Verify that all diagrams are converted to native `<ac:structured-macro ac:name="drawio">` blocks.
+   - Verify that output validates as well-formed XML.

package/bundles/antigravity-plugin/skills/mmr/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: mmr
+description: Multi-Model Review & Runner (MMR) — run an ad-hoc task in an isolated multi-lane sandbox with rate-limit failover, test gates, and second-vendor review, or run a fast cross-model review on a diff
+---
+
+# /caddis:mmr — Multi-Model Review & Runner
+
+Execute an ad-hoc task across model lanes (GLM-5.3 → Codex Sol → Claude) inside an isolated
+git worktree with automated test gates and second-vendor review (DeepSeek). Destroys the worktree
+immediately on completion (zero worktree leaks) and leaves the output on a clean branch with a
+simple Verdict Card.
+
+When invoked without a task prompt (or with a git range), `/mmr` runs a direct cross-model diff review.
+
+## Natural Language Triggers
+You can trigger MMR naturally without typing the full slash command:
+- *"Run this on another lane: &lt;task&gt;"* &rarr; `/mmr "<task>"`
+- *"Try this with multilane: &lt;task&gt;"* &rarr; `/mmr "<task>"`
+- *"Keep it"* / *"Keep the changes"* &rarr; `/mmr keep`
+- *"Drop it"* / *"Discard the attempt"* &rarr; `/mmr drop`
+- *"Check mmr status"* / *"Which lanes are ready?"* &rarr; `/mmr status`
+- *"Review this diff with mmr"* &rarr; `/mmr`
+
+---
+
+## Commands
+
+### 1. Run an Ad-Hoc Task
+```bash
+python scripts/caddis_adhoc.py run "<task description>" [--type backend|tests|docs|ui|hard]
+# Shorthand:
+python scripts/caddis_adhoc.py "<task description>"
+```
+- **Sandbox Isolation:** Creates an ephemeral 1-phase plan at `.caddis/orchestrator/adhoc/<slug>.md`.
+- **Pre-flight Checks:** Verifies dirty tree and API keys. Warns if local edits exist.
+- **Failover Cascade:** Automatically cascades from GLM to Codex to Claude if a lane is out of budget.
+- **Local Test Gates:** Runs project test gates before review.
+- **Cross-Vendor Review:** DeepSeek or GLM reviews the diff.
+- **Immediate Worktree Cleanup:** Stashes/commits results to `lane/adhoc-<slug>` and immediately removes the worktree. Zero open worktrees remain.
+- **Verdict Card:** Prints PASS/FAIL summary with diff stats and next actions.
+
+### 2. Keep the Result
+```bash
+python scripts/caddis_adhoc.py keep
+```
+- Keeps the output branch `lane/adhoc-<slug>`.
+- **Main Branch Protection:** If you are on `main` or `master`, direct merge is disabled to protect trunk. Recommends running `/ship-pr`.
+- If on a feature branch and the working tree is clean, provides squash-merge instructions.
+
+### 3. Drop the Result
+```bash
+python scripts/caddis_adhoc.py drop
+```
+- Deletes the branch `lane/adhoc-<slug>`.
+- Deletes the ephemeral plan file and run logs.
+- Workspace remains clean and untouched.
+
+### 4. Check Status
+```bash
+python scripts/caddis_adhoc.py status
+```
+- Displays API key readiness for all lanes (`Anthropic`, `DeepSeek`, `GLM`, `OpenAI`).
+- Shows the latest task status, model used, and gates/review verdicts.
+- Lists any unmerged `lane/adhoc-*` branches.
+
+### 5. Review Diff Only
+```bash
+python scripts/caddis_adhoc.py review [--range <range>]
+# Shorthand (no args):
+python scripts/caddis_adhoc.py
+```
+- Fast cross-model review of working tree or git range (e.g., `origin/main..HEAD`).
+
+---
+
+## Tool Resolution
+Resolve `caddis_adhoc.py` deterministically:
+```bash
+if [ -f "${CLAUDE_PLUGIN_ROOT}/scripts/caddis_adhoc.py" ]; then
+  TOOL="${CLAUDE_PLUGIN_ROOT}/scripts/caddis_adhoc.py"
+elif [ -f "scripts/caddis_adhoc.py" ]; then
+  TOOL="scripts/caddis_adhoc.py"
+else
+  echo "caddis_adhoc.py not found — report this and stop."
+  exit 3
+fi
+```

package/bundles/antigravity-plugin-extras/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "caddis-extras",
-  "version": "1.3.29",
+  "version": "1.3.30",
   "description": "caddis-extras — the long-tail skills for the Antigravity (agy) caddis plugin; install alongside caddis for the full set."
 }

package/bundles/antigravity-plugin-extras/skills/_registry.md

@@ -61,6 +61,8 @@
 | Architecture Document | `architecture-document/` | Generate professional enterprise-grade HLD and LLD documents from the living Architecture.md. Outputs DOCX (editable) or PPTX (executive summary) using existing document skills. |
 | Doc Coauthoring | `doc-coauthoring/` | Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. |
 | Documentation Analyzer | `documentation-analyzer/` | Analyze codebases, explain code functionality, and generate comprehensive documentation. Use when documenting a project, creating README files, or understanding complex code. |
+| Hld | `hld/` | Generates High-Level Design (HLD) Markdown documentation and converts to Confluence Storage Format XHTML with inline PlantUML macros. |
+| Lld | `lld/` | Generates Lower-Level Design (LLD) Markdown documentation and converts to Confluence Storage Format XHTML with inline PlantUML macros. |
 | Naming Analyzer | `naming-analyzer/` | Suggest better variable, function, and class names based on context and conventions. |
 | Prd To Code | `prd-to-code/` | Transform PRD documents into working application code using a systematic 6-phase methodology. Use when starting projects from requirements or converting specs to implementation. |
 

package/bundles/antigravity-plugin-extras/skills/hld/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: hld
+description: Generates High-Level Design (HLD) Markdown documentation and converts to Confluence Storage Format XHTML with inline PlantUML macros.
+---
+
+# High-Level Design (HLD) Authoring Skill
+
+## Overview
+This skill generates High-Level Design (HLD) documents for enterprise application fleet systems and converts them to Confluence Storage Format XHTML with self-contained, inline PlantUML (`<ac:structured-macro ac:name="plantuml">`) diagrams.
+
+## Scope and Boundary Principles (Strict)
+1. **High-Level Design Only:**
+   - Include: Business initiative goals, high-level architecture topology, user surfaces, high-level database references, security & network boundaries, and target state roadmap.
+   - **DO NOT INCLUDE:**
+     - Internal application API routes or controller implementation details.
+     - Stored procedure names, parameter lists, or SQL code.
+     - Low-level ETL batch scripts, job schedules, or internal script arguments.
+     - Low-level table schemas or physical column definitions.
+2. **Database Representation:**
+   - Mention the physical database host and database name.
+   - List high-level reporting summary tables or key domain mart entities only.
+   - Low-level tables and stored procedures belong strictly in the Lower-Level Design (LLD).
+3. **Sequence Diagrams:**
+   - Automated schedulers (such as Windows Task Scheduler or cron) must be depicted as system components or lifeline participants, **NEVER** as human actors.
+4. **Diagram Rendering and Orthogonal Connectors:**
+   - Diagrams are converted to native Confluence PlantUML macros (`<ac:structured-macro ac:name="plantuml">`) using `skinparam linetype ortho`.
+   - `skinparam linetype ortho` ensures that all arrows connecting boxes are strictly orthogonal (90-degree right angles, zero diagonal slants).
+   - PlantUML renders inline upon copy-paste into Confluence with zero attachment access errors.
+5. **No AI Traces and Clean STE:**
+   - The HLD must contain zero hints or traces of AI generation (no model names, tool mentions, or meta-notices in the Confluence HTML).
+   - Write in Simplified Technical English (ASD-STE100): short sentences, active voice, and clear technical descriptions.
+   - Executive Metadata is omitted from the Confluence HTML view (metadata belongs in LLD).
+
+## Standard HLD Document Structure (Markdown)
+Every HLD document must follow this standardized 7-section structure:
+
+```markdown
+---
+type: design
+status: current
+feature: <app>-hld
+creation-agent: caddis
+Original Author: Solutions Architecture
+Creation Date: <YYYY-MM-DDTHH:MM:SSZ>
+Creating Model: gemini-3.5-flash
+---
+
+# High-Level Architecture (HLA): <Application Name>
+
+## Document Information
+
+### Version History
+| Version | Date | Author | Description |
+|---|---|---|---|
+| 1.0 | <YYYY-MM-DD> | Solutions Architecture | Initial High-Level Architecture Draft |
+
+---
+
+## 1. Executive Summary
+- 1.1 Initiative Goal
+- 1.2 Solution Architecture Summary
+- 1.3 Business Value & Operational Outcomes
+
+## 2. Project Context and Scope
+- 2.1 Background
+- 2.2 Scope (In Scope / Out of Scope)
+- 2.3 Architecture Boundaries and Key Assumptions
+
+## 3. Solution Approach and Workflow
+- 3.1 Operational Process Flow (Mermaid flowchart)
+- 3.2 End-to-End Operational Sequence Diagram (Mermaid sequence diagram with system scheduler participant)
+
+## 4. Solution Architecture Landscape
+- 4.1 Solution Design and Architecture (Mermaid topology diagram)
+- 4.2 User Surfaces and Capabilities Overview (Summary table of primary operational interfaces)
+- 4.3 High-Level Data Model and Summary Mart (High-level summary entities only, no stored procedures or DDL)
+- 4.4 High-Level Data Flow and Integration (Mermaid data lineage flow)
+
+## 5. Security Architecture and Controls
+- 5.1 Identity and Access Management (Authentication seams, roles, authorization boundaries)
+- 5.2 Network Boundaries and Perimeter Controls (Subnets, ports, host environments)
+- 5.3 Data Protection and Privacy (Encryption, sensitive data handling)
+- 5.4 Auditability and Governance
+
+## 6. Target State Roadmap (Work In Progress)
+- 6.1 Enterprise Identity Evolution
+- 6.2 Automated Operational Integration
+
+## 7. Appendix
+- 7.1 Terms and Definitions
+- 7.2 Reference Documents
+```
+
+## Conversion Workflow
+1. Write the canonical HLD Markdown file to `docs/<app>/<app>-hld.md`.
+2. Run the conversion script:
+   ```bash
+   python scripts/convert_doc_to_confluence.py docs/<app>/<app>-hld.md --output docs/<app>/<app>-hld.html
+   ```
+3. Verify that the output validates as well-formed XML and contains `<ac:structured-macro ac:name="plantuml">` blocks with `skinparam linetype ortho`.