ima-claude 2.9.0 → 2.13.0

package/plugins/ima-claude/skills/gh-cli/SKILL.md

@@ -0,0 +1,286 @@
+---
+name: gh-cli
+description: >-
+  GitHub CLI (gh) for pull requests, issues, releases, Actions, code review, and repo
+  management. Primary tool for GitHub operations — reliable, fast, always available.
+  Use when: creating PRs, reviewing PRs, managing issues, checking CI status, creating
+  releases, searching GitHub, or any github.com operation. Triggers on: GitHub, gh,
+  pull request, PR, issue, release, actions, workflow, CI status, code review, merge PR.
+  NOT for Gitea — use mcp-gitea for internal repos.
+---
+
+# GitHub CLI (`gh`) — GitHub Operations
+
+The `gh` CLI is the primary tool for all GitHub operations. It's authenticated, reliable, and covers the full GitHub API surface.
+
+## Prerequisites
+
+```bash
+# Verify authentication
+gh auth status
+```
+
+The CLI must be authenticated (`gh auth login`) before use. Verify scopes with `gh auth status`.
+
+## Command Reference
+
+### Pull Requests
+
+| Operation | Command |
+|-----------|---------|
+| Create PR | `gh pr create --title "..." --body "..." --base main` |
+| Create PR (fill from commits) | `gh pr create --fill` |
+| Create draft PR | `gh pr create --draft --title "..." --body "..."` |
+| List open PRs | `gh pr list` |
+| List PRs by state | `gh pr list --state closed` |
+| List PRs by author | `gh pr list --author "@me"` |
+| List PRs by label | `gh pr list --label "bug"` |
+| View PR details | `gh pr view 123` |
+| View PR in browser | `gh pr view 123 --web` |
+| View PR diff | `gh pr diff 123` |
+| Check CI status | `gh pr checks 123` |
+| Checkout PR locally | `gh pr checkout 123` |
+| Merge PR (squash) | `gh pr merge 123 --squash` |
+| Merge PR (rebase) | `gh pr merge 123 --rebase` |
+| Merge PR (merge commit) | `gh pr merge 123 --merge` |
+| Merge + delete branch | `gh pr merge 123 --squash --delete-branch` |
+| Close PR | `gh pr close 123` |
+| Reopen PR | `gh pr reopen 123` |
+| Edit PR | `gh pr edit 123 --title "..." --body "..."` |
+| Add reviewer | `gh pr edit 123 --add-reviewer username` |
+| Add label | `gh pr edit 123 --add-label "bug"` |
+| Mark as ready | `gh pr ready 123` |
+| Comment on PR | `gh pr comment 123 --body "..."` |
+| Review PR (approve) | `gh pr review 123 --approve --body "LGTM"` |
+| Review PR (request changes) | `gh pr review 123 --request-changes --body "..."` |
+| Review PR (comment only) | `gh pr review 123 --comment --body "..."` |
+| My PR status | `gh pr status` |
+
+### Issues
+
+| Operation | Command |
+|-----------|---------|
+| Create issue | `gh issue create --title "..." --body "..."` |
+| Create issue with labels | `gh issue create --title "..." --label "bug" --label "priority"` |
+| Create issue with assignee | `gh issue create --title "..." --assignee "@me"` |
+| List open issues | `gh issue list` |
+| List by state | `gh issue list --state closed` |
+| List by label | `gh issue list --label "bug"` |
+| List by assignee | `gh issue list --assignee "@me"` |
+| View issue | `gh issue view 42` |
+| View in browser | `gh issue view 42 --web` |
+| Close issue | `gh issue close 42` |
+| Close with comment | `gh issue close 42 --comment "Fixed in v2.11.0"` |
+| Reopen issue | `gh issue reopen 42` |
+| Comment on issue | `gh issue comment 42 --body "..."` |
+| Edit issue | `gh issue edit 42 --title "..." --body "..."` |
+| Add label | `gh issue edit 42 --add-label "in-progress"` |
+| Remove label | `gh issue edit 42 --remove-label "triage"` |
+| Assign | `gh issue edit 42 --add-assignee username` |
+| Pin issue | `gh issue pin 42` |
+| Transfer issue | `gh issue transfer 42 owner/other-repo` |
+| My issue status | `gh issue status` |
+
+### Repositories
+
+| Operation | Command |
+|-----------|---------|
+| View repo | `gh repo view owner/name` |
+| View in browser | `gh repo view --web` |
+| Clone repo | `gh repo clone owner/name` |
+| Fork repo | `gh repo fork owner/name` |
+| Create repo | `gh repo create name --public --description "..."` |
+| Create private repo | `gh repo create name --private` |
+| List my repos | `gh repo list` |
+| List org repos | `gh repo list org-name` |
+| Sync fork | `gh repo sync owner/name` |
+| Set default repo | `gh repo set-default owner/name` |
+
+### Releases & Tags
+
+| Operation | Command |
+|-----------|---------|
+| Create release | `gh release create v1.0.0 --title "v1.0.0" --notes "..."` |
+| Create draft release | `gh release create v1.0.0 --draft --title "v1.0.0" --notes "..."` |
+| Create release from tag | `gh release create v1.0.0 --generate-notes` |
+| Upload assets | `gh release upload v1.0.0 ./dist/*.tar.gz` |
+| List releases | `gh release list` |
+| View release | `gh release view v1.0.0` |
+| Download assets | `gh release download v1.0.0` |
+| Delete release | `gh release delete v1.0.0` |
+| Edit release | `gh release edit v1.0.0 --title "..." --notes "..."` |
+
+### GitHub Actions (Workflows & Runs)
+
+| Operation | Command |
+|-----------|---------|
+| List workflows | `gh workflow list` |
+| View workflow | `gh workflow view workflow-name` |
+| Run workflow | `gh workflow run workflow-name` |
+| Run with inputs | `gh workflow run workflow-name -f key=value` |
+| Disable workflow | `gh workflow disable workflow-name` |
+| Enable workflow | `gh workflow enable workflow-name` |
+| List recent runs | `gh run list` |
+| List runs for workflow | `gh run list --workflow workflow-name` |
+| View run details | `gh run view 12345` |
+| View run logs | `gh run view 12345 --log` |
+| Watch run progress | `gh run watch 12345` |
+| Download artifacts | `gh run download 12345` |
+| Rerun failed jobs | `gh run rerun 12345 --failed` |
+| Cancel run | `gh run cancel 12345` |
+
+### Search (Cross-Repository)
+
+| Operation | Command |
+|-----------|---------|
+| Search repos | `gh search repos "query" --sort stars` |
+| Search issues | `gh search issues "query" --repo owner/name` |
+| Search PRs | `gh search prs "query" --state open` |
+| Search code | `gh search code "pattern" --repo owner/name` |
+| Search commits | `gh search commits "query" --repo owner/name` |
+
+### Labels
+
+| Operation | Command |
+|-----------|---------|
+| List labels | `gh label list` |
+| Create label | `gh label create "name" --color "0075ca" --description "..."` |
+| Edit label | `gh label edit "name" --new-name "..." --color "..."` |
+| Delete label | `gh label delete "name" --yes` |
+| Clone labels to another repo | `gh label clone source-owner/source-repo` |
+
+### Raw API Access
+
+For operations not covered by built-in commands:
+
+```bash
+# GET request
+gh api repos/{owner}/{repo}/topics
+
+# POST request
+gh api repos/{owner}/{repo}/labels -f name="priority" -f color="ff0000"
+
+# With pagination
+gh api repos/{owner}/{repo}/issues --paginate
+
+# GraphQL
+gh api graphql -f query='{ viewer { login } }'
+
+# JSON output + jq filtering
+gh api repos/{owner}/{repo}/pulls --jq '.[].title'
+```
+
+## Decision Logic
+
+```
+Is this a GitHub-hosted repo?
+  Check: git remote -v → shows github.com
+  → Yes: Use gh CLI (this skill)
+  → No: Is it Gitea-hosted?
+      → Yes: Use mcp-gitea tools (see mcp-gitea skill)
+      → Unknown: Ask the user
+
+For local-only git operations (commit, diff, log, stash, rebase):
+  → Always use git CLI directly — gh is for GitHub API operations
+
+Operation routing:
+  PRs (create, review, merge, list)  → gh pr ...
+  Issues (create, comment, close)    → gh issue ...
+  Releases (create, upload, list)    → gh release ...
+  CI/CD status, rerun, logs          → gh run ... / gh workflow ...
+  Search across GitHub               → gh search ...
+  Anything not in built-in commands  → gh api ...
+```
+
+## Common Workflows
+
+### Create a PR with Body via HEREDOC
+
+```bash
+gh pr create --title "feat: add gh-cli skill" --body "$(cat <<'EOF'
+## Summary
+- Added gh-cli skill for GitHub CLI operations
+- Replaces unreliable MCP GitHub integration
+
+## Test plan
+- [ ] Verify gh auth status
+- [ ] Test PR creation workflow
+EOF
+)"
+```
+
+### Check CI and Merge When Ready
+
+```bash
+# Check CI status
+gh pr checks 123
+
+# If all checks pass, merge
+gh pr merge 123 --squash --delete-branch
+```
+
+### Create a Release with Changelog
+
+```bash
+gh release create v2.12.0 \
+  --title "v2.12.0 — Add gh-cli skill" \
+  --generate-notes \
+  --latest
+```
+
+### Cross-Repo Issue Search
+
+```bash
+# Find all open bugs assigned to me across repos
+gh search issues "is:open assignee:@me label:bug" --limit 20
+
+# Find PRs awaiting my review
+gh search prs "is:open review-requested:@me" --limit 20
+```
+
+### View PR Comments (API)
+
+```bash
+# List PR review comments
+gh api repos/{owner}/{repo}/pulls/123/comments --jq '.[].body'
+
+# List issue/PR timeline comments
+gh api repos/{owner}/{repo}/issues/123/comments --jq '.[] | "\(.user.login): \(.body)"'
+```
+
+## Output Formatting
+
+The `gh` CLI supports structured output:
+
+```bash
+# JSON output
+gh pr list --json number,title,state
+
+# JSON + jq filter
+gh pr list --json number,title --jq '.[] | "\(.number): \(.title)"'
+
+# Table format (default for list commands)
+gh issue list
+
+# Web browser
+gh pr view 123 --web
+```
+
+## Cross-Repository Operations
+
+Use `--repo` or `-R` to target any GitHub repo:
+
+```bash
+gh pr list -R owner/other-repo
+gh issue create -R owner/other-repo --title "..."
+gh run list -R owner/other-repo
+```
+
+## When NOT to Use
+
+| Situation | Use Instead |
+|-----------|-------------|
+| Gitea-hosted repos | `mcp-gitea` tools |
+| Local git operations (commit, diff, stash) | `git` CLI directly |
+| Reading local files | Read tool |
+| Pushing/pulling code | `git push` / `git pull` |

package/plugins/ima-claude/skills/ima-doc2pdf/SKILL.md

@@ -0,0 +1,242 @@
+---
+name: ima-doc2pdf
+description: >-
+  Convert DOCX content into branded IMA PDF documents using ReportLab with Lato
+  typography, navy headings, justified body text, running footers, and embedded
+  images. Produces branded PDF documents with content pages. Generates a placeholder
+  cover that can be replaced by ima-cover-creator for production output. Use when: converting a Word doc to branded PDF,
+  creating PDF content pages for Canva import, generating an IMA branded document PDF,
+  or when the user says "convert this docx to PDF," "branded PDF," "content pages,"
+  "PDF for Canva," or "doc to PDF." Also triggers on: "make a PDF from this Word
+  file," "export to PDF," "generate branded PDF," "IMA branded document PDF."
+  Always load ima-brand alongside for color/typography authority.
+---
+
+# IMA DOCX → Branded PDF
+
+Extracts content from any Word document and generates a branded IMA PDF with
+Lato typography, navy/gold colors, and IMA layout standards. Works with guides,
+reports, white papers, and other IMA documents. Outputs content pages only
+(no cover page) — the cover is handled by `ima-cover-creator` and merged via pypdf.
+
+---
+
+## Why ReportLab for Content
+
+Content pages are pure document flow: headings, body paragraphs, bullet lists,
+inline bold/italic, embedded images, and running footers. ReportLab handles all of
+this with proper Lato font registration, automatic page breaks, and precise
+typographic control. No coordinate math needed — the flow engine does the work.
+
+---
+
+## Quick Start
+
+### 1. Install dependencies (once)
+
+```bash
+pip install python-docx reportlab Pillow pypdf --break-system-packages
+```
+
+### 2. Generate content PDF
+
+```bash
+python3 scripts/generate_pdf.py path/to/document.docx --out content.pdf
+```
+
+### 3. Merge with cover (from ima-cover-creator)
+
+```python
+from pypdf import PdfReader, PdfWriter
+
+cover = PdfReader("cover.pdf")
+content = PdfReader("content.pdf")
+
+writer = PdfWriter()
+writer.add_page(cover.pages[0])
+
+# Skip the first 2 pages (ReportLab's placeholder cover + overflow)
+for page in content.pages[2:]:
+    writer.add_page(page)
+
+with open("final.pdf", "wb") as f:
+    writer.write(f)
+```
+
+---
+
+## Pipeline
+
+```
+DOCX
+  ↓  extract_docx.py (text, structure, metadata)
+  ↓  generate_pdf.py (ReportLab → branded PDF)
+  ↓
+content.pdf (N pages, no cover)
+  +
+cover.pdf (from ima-cover-creator)
+  ↓  pypdf merge
+  ↓
+final.pdf → Canva import
+```
+
+---
+
+## Typography Spec (Canva-confirmed)
+
+All values confirmed from Canva design data. Font: Lato (Google Fonts).
+
+### Headings
+
+| Element | Size | Weight | Color | Align |
+|---------|------|--------|-------|-------|
+| Section heading (h2) | 15pt | Bold | #00066F | Center |
+| Sub-heading (h3) | 13pt | Bold | #00066F | Left |
+| Intro heading | 15pt | Bold | #00066F | Center |
+
+### Body Text
+
+| Element | Size | Weight | Color | Align |
+|---------|------|--------|-------|-------|
+| Body paragraph | 12pt | Regular | #000000 | Justify |
+| Body bold inline | 12pt | Bold | #000000 | Justify |
+| Body bold navy | 12pt | Bold | #00066F | Justify |
+| Bullet item | 12pt | Regular | #000000 | Left |
+| Bullet marker | — | — | #00066F | — |
+
+### Other Elements
+
+| Element | Size | Weight | Color |
+|---------|------|--------|-------|
+| Footer | 10pt | Regular | #666666 |
+| Reference entry | 8pt | Regular | #333333 |
+| Reference heading | 13pt | Bold | #00066F |
+| Q&A question | 12pt | Bold | #00066F |
+| Q&A answer | 12pt | Regular | #000000 |
+| Warning box | 12pt | Bold | #FFFFFF on #00066F bg |
+
+### Page Setup
+
+| Property | Value |
+|----------|-------|
+| Page size | US Letter (8.5 × 11 in) |
+| Margins | 0.5 in all sides |
+| Body width | 7.5 in |
+| Footer height | 0.4 in from bottom |
+
+---
+
+## Content Extraction
+
+The `extract_docx.py` script classifies each Word paragraph into typed blocks:
+
+| Type | Description |
+|------|-------------|
+| `h1` | Top-level heading (title) |
+| `h2` | Section heading |
+| `h3` | Sub-heading |
+| `heading_bold` | All-bold paragraph (inline heading) |
+| `body` | Regular paragraph |
+| `bullet` | List item |
+| `author` | Author name |
+| `date` | Date string |
+| `disclaimer` | Disclaimer text |
+| `warning` | Warning box content |
+| `question` | Q&A question |
+| `answer_start` | Q&A answer (YES/NO prefix) |
+| `reference` | Numbered citation |
+| `ref_heading` | "References" heading |
+| `figure_caption` | Figure/table caption |
+| `page_break` | Hard page break |
+
+Each block includes `runs` with per-run bold/italic flags for inline formatting.
+
+---
+
+## Image Handling
+
+The script extracts embedded DOCX images via `python-docx`:
+
+1. Reads all image relationships from the DOCX package
+2. Maps paragraph indices to embedded image positions
+3. Writes images to temp files
+4. Inserts ReportLab `Image` flowables at the correct positions
+5. Scales to fit within `page_width - 2 × margin`
+
+Images that appear between text paragraphs (image-only paragraphs) are also caught
+and appended after all text content.
+
+---
+
+## Cover Page Behavior
+
+The ReportLab script generates a **placeholder cover** (navy background with title
+text) as pages 1-2 of its output. This exists so the script works standalone, but
+when pairing with `ima-cover-creator`, **skip the first 2 pages** during merge.
+
+To check which pages to skip:
+```python
+from pypdf import PdfReader
+r = PdfReader("content.pdf")
+for i in range(min(3, len(r.pages))):
+    text = r.pages[i].extract_text()[:100]
+    print(f"Page {i}: {text}")
+```
+
+The first content page typically starts with "Introduction" or a section heading.
+
+---
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `generate_pdf.py` | Main: DOCX → branded PDF via ReportLab |
+| `extract_docx.py` | Extracts structured content from Word documents |
+| `docx_utils.py` | Shared utilities for DOCX parsing |
+
+---
+
+## Fonts
+
+Lato TTF files are auto-downloaded from Google Fonts on first run into the `fonts/`
+directory (which is git-ignored). The font family (Regular, Bold, Italic, BoldItalic)
+is registered with ReportLab so that `<b>` and `<i>` markup works in Paragraph objects.
+
+If the fonts are already present, the download is skipped.
+
+---
+
+## Customization
+
+### Adjusting the footer
+
+The footer shows the document title and date. To customize:
+```python
+# In generate_pdf.py, the footer text is built from:
+title_short = (title[:60] + "...") if len(title) > 60 else title
+footer_text = f"{title_short} ({clean_date})"
+```
+
+### Adding new paragraph types
+
+1. Add a classifier rule in `extract_docx.py`
+2. Add a handler in `block_to_flowables()` in `generate_pdf.py`
+3. Create a ReportLab `ParagraphStyle` in `build_styles()`
+
+---
+
+## Relationship to Other Skills
+
+| Skill | Role |
+|-------|------|
+| **ima-cover-creator** | Generates branded cover page (PPTX → PDF) |
+| **ima-cancer-care-guides** | Full pipeline including Markdown source and Canva API mapping |
+| **ima-brand** | Source of truth for colors, typography, voice |
+
+**Typical workflow:**
+```
+ima-cover-creator  →  cover.pdf (1 page)
+ima-doc2pdf        →  content.pdf (skip first 2 pages)
+pypdf merge        →  final.pdf → Canva import
+```

package/plugins/ima-claude/skills/ima-doc2pdf/references/formatting-spec.md

@@ -0,0 +1,88 @@
+# Content Page Formatting Spec
+
+Values confirmed from Canva design data (Cancer Drug Resistance Guide, March 2026).
+Canva internal units × 0.75 = points.
+
+## Page Setup
+
+| Property | Value |
+|----------|-------|
+| Page size | US Letter (8.5 × 11 in / 612 × 792 pt) |
+| Margins | 0.5 in (36 pt) all sides |
+| Body text width | 7.5 in (540 pt) |
+| Footer position | 0.4 in from bottom |
+
+## Color Palette
+
+| Name | Hex | Usage |
+|------|-----|-------|
+| Trustworthy Indigo | #00066F | Headings, bullet markers, warning bg |
+| Body Black | #000000 | Body text (pure black, not #1A1A1A) |
+| Dark Gray | #333333 | Reference entries |
+| Gray Text | #666666 | Footer |
+| Light Gray | #CCCCCC | Footer rule |
+| White | #FFFFFF | Warning text |
+| Vital Gold | #FFCC00 | Warning emphasis |
+
+## Section Heading (h2)
+
+- Font: Lato 15pt Bold
+- Color: #00066F (navy)
+- Alignment: Center
+- Spacing: 16pt above, 5pt below
+
+## Sub-heading (h3)
+
+- Font: Lato 13pt Bold
+- Color: #00066F (navy)
+- Alignment: Left
+- Spacing: 10pt above, 3pt below
+
+## Body Paragraph
+
+- Font: Lato 12pt Regular
+- Color: #000000
+- Alignment: Justify
+- Line height: 1.4 (14.5pt leading)
+- Spacing: 6pt below
+
+## Bullet Lists
+
+- Font: Lato 12pt Regular
+- Color: #000000
+- Bullet marker color: #00066F (navy)
+- Indent: 18pt
+- Spacing: 1pt above, 1pt below each item
+
+## Bold Inline Variants
+
+- **Body bold** (#000000): Drug names, emphasis
+- **Body bold navy** (#00066F): Inline sub-headings
+
+## Warning Box
+
+- Background: #00066F (navy) — note: ReportLab uses solid, Canva uses gradient
+- Text: Lato 12pt Bold, #FFFFFF
+- Emphasis: Vital Gold #FFCC00
+- Alignment: Center
+- Padding: 10pt all sides
+
+## Footer
+
+- Font: Lato 10pt
+- Color: #666666
+- Alignment: Center
+- Content: "{Document Title} ({Date})"
+- Rule above: 0.5pt, #CCCCCC
+
+## References
+
+- Heading: Lato 13pt Bold, #00066F
+- Entry: Lato 8pt Regular, #333333
+- Hanging indent: 14pt
+
+## Q&A
+
+- Question: Lato 12pt Bold, #00066F
+- Answer: Lato 12pt Regular, #000000
+- YES/NO prefix: Bold

package/plugins/ima-claude/skills/ima-doc2pdf/scripts/docx_utils.py

@@ -0,0 +1,21 @@
+"""
+Shared utilities for Word document processing across ima-cancer-care-guides scripts.
+"""
+
+from docx.oxml.ns import qn
+
+
+def has_page_break(para):
+    """Detect a hard page break in a Word paragraph.
+
+    Checks both explicit w:br type=page runs and section-level page breaks
+    (w:pPr/w:sectPr), which appear on the last paragraph of a section.
+    """
+    for run in para.runs:
+        for br in run._element.findall(qn('w:br')):
+            if br.get(qn('w:type')) == 'page':
+                return True
+    pPr = para._element.find(qn('w:pPr'))
+    if pPr is not None and pPr.find(qn('w:sectPr')) is not None:
+        return True
+    return False