feat: add Claude Code plugin support, wiki sync CI, marketplace docs

- Add update-marketplace job to release.yml (auto-updates CLI version in marketplace)
- Add wiki-sync.yml workflow (syncs docs/wiki/ to GitHub Wiki on push)
- Add Claude Code Integration section to Getting-Started.md
- Add Claude Code Plugin section to AGENTS.md with skill update checklist

Author: RoboNET

.github/workflows/release.yml

@@ -183,3 +183,47 @@ jobs:
         with:
           generate_release_notes: true
           files: ./release-assets/*
+
+  update-marketplace:
+    needs: release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Extract version from tag
+        id: version
+        run: echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_OUTPUT
+
+      - name: Checkout marketplace
+        uses: actions/checkout@v4
+        with:
+          repository: RoboNET/FlexRender-Marketplace
+          token: ${{ secrets.MARKETPLACE_PAT }}
+          path: marketplace
+
+      - name: Update cli-version.json
+        run: |
+          cd marketplace
+          python3 -c "
+          import json
+          with open('flexrender/cli-version.json') as f:
+              data = json.load(f)
+          data['recommendedVersion'] = '${{ steps.version.outputs.VERSION }}'
+          with open('flexrender/cli-version.json', 'w') as f:
+              json.dump(data, f, indent=2)
+              f.write('\n')
+          "
+
+      - name: Create PR
+        working-directory: marketplace
+        env:
+          GH_TOKEN: ${{ secrets.MARKETPLACE_PAT }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git checkout -b update-cli-${{ steps.version.outputs.VERSION }}
+          git add flexrender/cli-version.json
+          git commit -m "chore: update recommendedVersion to ${{ steps.version.outputs.VERSION }}"
+          git push origin update-cli-${{ steps.version.outputs.VERSION }}
+          gh pr create \
+            --title "Update CLI to v${{ steps.version.outputs.VERSION }}" \
+            --body "Automated update from FlexRender release v${{ steps.version.outputs.VERSION }}" \
+            --base main

.github/workflows/wiki-sync.yml

@@ -0,0 +1,38 @@
+name: Sync Wiki
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/wiki/**'
+
+permissions:
+  contents: write
+
+jobs:
+  sync-wiki:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Checkout wiki
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository }}.wiki
+          path: wiki
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Sync wiki files
+        run: |
+          cp docs/wiki/*.md wiki/
+          cd wiki
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          if git diff --cached --quiet; then
+            echo "No changes to sync"
+          else
+            git commit -m "docs: sync wiki from docs/wiki ($(date -u +%Y-%m-%dT%H:%M:%SZ))"
+            git push
+          fi

AGENTS.md

@@ -403,6 +403,51 @@ var sb = new StringBuilder(estimatedCapacity);
 - [ ] `Span<T>` used for string/array slicing instead of `Substring()`/`Array.Copy()`
 - [ ] SKPaint/SKFont objects are reused or pooled, not created per-element
 
+## Claude Code Plugin (FlexRender-Marketplace)
+
+The FlexRender plugin for Claude Code lives in a separate repository: [`RoboNET/FlexRender-Marketplace`](https://github.com/RoboNET/FlexRender-Marketplace).
+
+**When to update the plugin skills:**
+
+Any change to the following areas requires updating the corresponding skill in the marketplace repo:
+
+| Changed Area | Skill to Update | Skill Path |
+|-------------|-----------------|------------|
+| YAML template syntax, element types, properties, expressions | `template` | `flexrender/skills/template/SKILL.md` |
+| C# API, FlexRenderBuilder, AST classes, NuGet packages, DI | `template-csharp` | `flexrender/skills/template-csharp/SKILL.md` |
+| Content parsers (Markdown, HTML, NDC), IContentParser API | `content-formats` | `flexrender/skills/content-formats/SKILL.md` |
+| CLI commands, options, output formats | `template` | `flexrender/skills/template/SKILL.md` (CLI Reference section) |
+
+**Checklist for code changes:**
+
+- [ ] If YAML syntax changed — update `template` skill
+- [ ] If new element type added — update `template` skill (Element Types + Common Properties)
+- [ ] If template expressions changed — update `template` skill (Template Expressions section)
+- [ ] If C# public API changed — update `template-csharp` skill
+- [ ] If NuGet package added/renamed — update `template-csharp` skill (NuGet Package Selection)
+- [ ] If content parser changed — update `content-formats` skill
+- [ ] If CLI command added/changed — update `template` skill (CLI Reference section)
+- [ ] If `KnownProperties.cs` updated — check if `template` skill needs property table updates
+
+**Plugin structure:**
+
+```
+flexrender-marketplace/flexrender/
+├── .claude-plugin/plugin.json    # Plugin manifest
+├── cli-version.json              # CLI version requirements (auto-updated by CI)
+├── hooks/hooks.json              # SessionStart hook for CLI auto-install
+├── scripts/
+│   ├── run-hook.cmd              # Cross-platform polyglot wrapper
+│   └── ensure-cli.sh            # CLI check/install script
+├── skills/
+│   ├── template/SKILL.md         # YAML template authoring skill
+│   ├── template-csharp/SKILL.md  # C# integration skill
+│   └── content-formats/SKILL.md  # Content parsers skill
+└── README.md
+```
+
+**CI automation:** The `release.yml` workflow automatically creates a PR in the marketplace repo to update `cli-version.json` when a new FlexRender version is released.
+
 ## Common Tasks
 
 ### Add new element type

docs/wiki/Getting-Started.md

@@ -346,6 +346,25 @@ var render = new FlexRenderBuilder()
     .Build();
 ```
 
+## Claude Code Integration
+
+Install the FlexRender plugin to get AI-assisted template authoring, live preview, and CLI management:
+
+```bash
+# Add the marketplace (one-time)
+claude plugins add-marketplace https://github.com/RoboNET/FlexRender-Marketplace
+
+# Install the plugin
+claude plugins install flexrender@FlexRender-Marketplace
+```
+
+The plugin provides three skills:
+- **`template`** -- create, edit, debug YAML templates with live watch preview
+- **`template-csharp`** -- C# AST integration, NuGet package selection, builder API
+- **`content-formats`** -- Markdown, HTML, and NDC content parser reference
+
+The CLI (`flexrender`) is automatically installed on first session start.
+
 ## Next Steps
 
 - [[Template-Syntax]] -- learn all element types and properties

llms-full.txt

@@ -898,6 +898,25 @@ Key features:
 - Form feed, line spacing, tab controls
 
 ```yaml
+# Load NDC data from a local file
+- type: content
+  source: "file:ndc-data/receipt.bin"
+  format: ndc
+  options:
+    columns: 40
+    font_family: "JetBrains Mono"
+    charsets:
+      I:
+        font: bold
+        font_style: bold
+        encoding: qwerty-jcuken
+        uppercase: true
+      J:
+        encoding: qwerty-jcuken
+      "2":
+        font: default
+
+# Or load from a template variable (C# API with BytesValue)
 - type: content
   source: "{{receiptData}}"
   format: ndc
@@ -911,6 +930,18 @@ Key features:
         font_style: bold
 ```
 
+NDC options:
+- `columns` -- receipt width in characters (default: 40, standard for 80mm thermal printers)
+- `input_encoding` -- byte encoding: `latin1` (default), `utf-8`, `ascii`
+- `font_family` -- monospaced font for accurate column alignment
+- `char_width_ratio` -- character width ratio (default: 0.6)
+- `charsets` -- per-charset styling keyed by designator character from `ESC(X` sequences:
+  - `encoding` -- `qwerty-jcuken` (Latin→Cyrillic), `none`, `ascii`
+  - `font` / `font_style` -- font name or style (`bold`, `italic`, `bold-italic`, `regular`)
+  - `font_size` -- explicit size in pixels (auto-calculated if omitted)
+  - `color` -- text color (hex)
+  - `uppercase` -- convert to uppercase after encoding
+
 Register via `.WithNdc()` (FlexRender.Content.Ndc package, 0 external dependencies).
 
 ## Color Format

llms.txt

@@ -284,15 +284,26 @@ Binary sources pass `ReadOnlyMemory<byte>` directly to `IBinaryContentParser` im
 
 #### NDC Content
 ```yaml
+# Load NDC data from a local .bin file
 - type: content
-  source: "{{receiptData}}"
+  source: "file:ndc-data/receipt.bin"
   format: ndc
   options:
     columns: 40
     font_family: "JetBrains Mono"
+    charsets:
+      I:
+        font: bold
+        font_style: bold
+        encoding: qwerty-jcuken
+        uppercase: true
+      J:
+        encoding: qwerty-jcuken
+      "2":
+        font: default
 ```
 
-Requires NDC parser registration: `.WithNdc()` (FlexRender.Content.Ndc). Parses binary NDC ATM printer data streams. Supports charset switching, QWERTY→JCUKEN encoding, embedded barcodes, auto font sizing.
+Requires NDC parser registration: `.WithNdc()` (FlexRender.Content.Ndc). Parses binary NDC ATM printer data streams. Source can be `file:path`, `{{variable}}` (with `BytesValue`), or `data:` URI. Options: `columns` (default 40), `input_encoding` (`latin1`/`utf-8`/`ascii`), `charsets` with per-charset `encoding` (`qwerty-jcuken`), `font_style`, `uppercase`, `color`.
 
 ## YAML Validation