@litfamily/lithermes 1.0.8 → 1.0.9

package/assets/lithermes-plugin/skills/lit-pptx/bin/office.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// LitHermes Office runtime. All dependencies live outside the installed plugin.
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, cpSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const plugin = resolve(root, '..', '..');
+const runtime = join(root, 'runtime');
+const digest = createHash('sha256').update(readFileSync(join(runtime, 'package-lock.json'))).update(readFileSync(join(runtime, 'requirements.lock'))).digest('hex').slice(0, 16);
+const cacheBase = process.env.XDG_CACHE_HOME || join(process.env.HERMES_HOME || process.env.HOME || homedir(), '.cache');
+const cache = join(cacheBase, 'lithermes', 'office', digest);
+const nodeCache = join(cache, 'node');
+const pythonCache = join(cache, 'python');
+const python = join(pythonCache, 'bin', 'python');
+const [nodeMajor, nodeMinor] = process.versions.node.split('.').map(Number);
+const nodeSupported = nodeMajor > 20 || (nodeMajor === 20 && nodeMinor >= 9);
+const ready = () => existsSync(join(cache, 'READY')) && existsSync(join(nodeCache, 'node_modules', 'pptxgenjs')) && existsSync(join(nodeCache, 'node_modules', 'sharp')) && existsSync(python);
+const run = (command, args, options = {}) => {
+  const result = spawnSync(command, args, { stdio: 'inherit', ...options });
+  if (result.error) throw result.error;
+  if (result.status !== 0) throw new Error(`${command} exited ${result.status ?? result.signal}`);
+};
+
+function install() {
+  if (ready()) return;
+  mkdirSync(cache, { recursive: true });
+  const staging = join(cache, `staging-${process.pid}`);
+  rmSync(staging, { recursive: true, force: true });
+  mkdirSync(staging, { recursive: true });
+  console.error('LitHermes Office: installing pinned dependencies in the product cache (first use).');
+  try {
+    const nodeStage = join(staging, 'node');
+    mkdirSync(nodeStage);
+    for (const name of ['package.json', 'package-lock.json']) cpSync(join(runtime, name), join(nodeStage, name));
+    run('npm', ['ci', '--prefix', nodeStage, '--omit=dev', '--ignore-scripts', '--no-audit', '--no-fund'], { env: { ...process.env, npm_config_cache: join(cache, 'npm-cache') } });
+    const pythonStage = join(staging, 'python');
+    run(process.env.LITHERMES_OFFICE_BOOTSTRAP_PYTHON || 'python3', ['-m', 'venv', pythonStage]);
+    run(join(pythonStage, 'bin', 'python'), ['-m', 'pip', 'install', '--disable-pip-version-check', '--require-hashes', '-r', join(runtime, 'requirements.lock')]);
+    rmSync(nodeCache, { recursive: true, force: true });
+    rmSync(pythonCache, { recursive: true, force: true });
+    renameSync(nodeStage, nodeCache);
+    renameSync(pythonStage, pythonCache);
+    writeFileSync(join(cache, 'READY'), digest + '\n');
+  } finally {
+    rmSync(staging, { recursive: true, force: true });
+  }
+}
+
+const [action, ...args] = process.argv.slice(2);
+if (action === 'doctor') {
+  const tools = ['soffice', 'pandoc', 'xelatex'].map(name => `${name}=${spawnSync('sh', ['-c', `command -v ${name}`], { stdio: 'ignore' }).status === 0 ? 'available' : 'missing'}`);
+  console.log(`office-runtime=${ready() ? 'READY' : 'NOT_INSTALLED'} node=${nodeSupported ? 'supported' : 'requires-20.9+'} cache=${cache} ${tools.join(' ')}`);
+  process.exit(0);
+}
+const target = {
+  pptx: ['node', join(root, 'scripts', 'compile-deck.js')],
+  qa: [python, join(root, 'scripts', 'qa_deck.py')],
+  integrity: [python, join(root, 'scripts', 'integrity.py')],
+  docx: [python, join(plugin, 'skills', 'lit-docx', 'scripts', 'convert_md_to_docx.py')],
+  edit: [python, join(plugin, 'skills', 'lit-docx', 'scripts', 'edit_docx.py')],
+  pdf: [python, join(plugin, 'skills', 'lit-docx', 'scripts', 'convert_md_to_pdf.py')],
+  audit: [python, join(plugin, 'skills', 'lit-docx', 'scripts', 'visual_audit.py')],
+  lint: [python, join(plugin, 'skills', 'lit-docx', 'scripts', 'slop_lint.py')],
+  learn: [python, join(root, 'scripts', 'learn_template.py')],
+}[action];
+if (!target) {
+  console.error('usage: node office.mjs doctor|pptx|qa|integrity|docx|edit|pdf|audit|lint|learn [arguments]');
+  process.exit(2);
+}
+if (!nodeSupported) throw new Error('LitHermes Office requires Node.js 20.9 or newer for its pinned image runtime');
+install();
+const env = { ...process.env, NODE_PATH: join(nodeCache, 'node_modules'), LITHERMES_OFFICE_PYTHON: python };
+run(target[0] === python ? join(pythonCache, 'bin', 'python') : target[0], [target[1], ...args], { env });

package/assets/lithermes-plugin/skills/lit-pptx/fonts/PRETENDARD-OFL.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2021, Kil Hyung-jin (https://github.com/orioncactus/pretendard),
+with Reserved Font Name Pretendard.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/lithermes-plugin/skills/lit-pptx/fonts/a2z-font/OFL.txt

@@ -0,0 +1,94 @@
+Copyright © 2026 PT&, with the designer Lee Juim. Latin glyphs from Outfit (Smartsheet Inc, Rodrigo Fuenzalida).
+(Bundled in this skill from https://github.com/Freesentation/A2Z v1.001)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/lithermes-plugin/skills/lit-pptx/fonts/a2z-font/SOURCE.md

@@ -0,0 +1,29 @@
+# 에이투지체 (A2Z) — 번들 폰트 출처/공급망
+
+- 폰트: 에이투지체 (A2Z), 제작 "오토노머스에이투지 × 이주임"
+- 버전: v1.001
+- 라이선스: **SIL Open Font License (OFL)** — 상업 사용·수정·재배포·임베딩 허용, 출처표기 불요, 폰트 자체 유료판매 금지
+- 공식 배포: https://freesentation.blog/a2z · 레포: https://github.com/Freesentation/A2Z
+- 다운로드(OTF): https://github.com/Freesentation/A2Z/raw/refs/heads/main/v1.001/에이투지체-otf-v1.001.zip
+- **SHA256 (otf zip, 공급망 핀):** `e169dcd454b100fbf420a8bd86c67b88c9f939b8045a7792789fdf7dadfaf1a7`
+
+## 웨이트 = 별도 family (중요)
+각 웨이트가 독립 family로 등록됨. PowerPoint/pptxgenjs에서 굵기는 `bold=true`가 아니라 **family명 직접 지정**으로 선택.
+
+| 파일 | name(1) EN | name(1) KR | weight |
+|---|---|---|---|
+| A2Z-Thin.otf | A2Z 1 Thin | 에이투지체 1 Thin | 100 |
+| A2Z-ExtraLight.otf | A2Z 2 ExtraLight | 에이투지체 2 ExtraLight | 200 |
+| A2Z-Light.otf | A2Z 3 Light | 에이투지체 3 Light | 300 |
+| A2Z-Regular.otf | A2Z 4 Regular | 에이투지체 4 Regular | 400 |
+| A2Z-Medium.otf | A2Z 5 Medium | 에이투지체 5 Medium | 500 |
+| A2Z-SemiBold.otf | A2Z 6 SemiBold | 에이투지체 6 SemiBold | 600 |
+| A2Z-Bold.otf | A2Z 7 Bold | 에이투지체 7 Bold | 700 |
+| A2Z-ExtraBold.otf | A2Z 8 ExtraBold | 에이투지체 8 ExtraBold | 800 |
+| A2Z-Black.otf | A2Z 9 Black | 에이투지체 9 Black | 900 |
+
+- typo family(16) = `A2Z`, subfamily(17) = `N Weight`
+- CJK 덱 호환을 위해 PPTX 출력은 한국어 family명(`에이투지체 N Weight`)을 1차로 사용 권장(Phase 4에서 확정).
+
+## 라이선스 동봉
+- `OFL.txt` 동봉 완료(SIL OFL 1.1 원문 + 폰트 name 테이블 기준 저작권 헤더: `Copyright © 2026 PT&`, 디자이너 Lee Juim). Reserved Font Name 미선언.

package/assets/lithermes-plugin/skills/lit-pptx/references/anti-slop-checklist.md

@@ -0,0 +1,71 @@
+# Anti-Slop Checklist for PPTX Outputs
+
+Run after building any deck. Brand specifics (palette, fonts) come from the chosen enrolled template — this checklist is template-agnostic.
+
+## Automated checks
+- `python3 scripts/qa_deck.py output.pptx` — honest gate: overflow/overlap/off-slide + WCAG contrast + anti-slop terms + objective executive/research OOXML checks (exit non-zero = FAIL).
+- `python3 scripts/inventory.py output.pptx verification.json --issues-only` — geometry issues only.
+- A clean gate means **no known defects, not that the deck looks good** — render and eyeball every slide (next section).
+
+## Human-eye checks
+
+### Slide-level
+- Every slide has a real, specific title (not placeholder text).
+- Accent colors are semantic, not decorative.
+- No slide looks like a spreadsheet pasted without editing.
+
+### Table-level
+- Header row visually distinct; numeric columns right-aligned.
+- Units in headers, not repeated per row; totals obvious but not over-decorated.
+
+### KPI / metrics
+- Primary metric is the largest element; delta color is consistent deck-wide; labels are secondary. ≤ 1 accent + optional delta color.
+
+### Text hygiene
+- No `TBD`/`TODO`/placeholder/AI-hype wording (gated by `FORBIDDEN_TERMS.json`).
+- Source notes exist for external numbers/charts. Headers are specific (avoid bare "Value"/"Metric"/"Score").
+
+### Executive/research copy: hard fail vs review-only
+
+- **Hard fail:** authoring/process trace (`본 슬라이드는…`, `슬라이드 7은…`, `최종본에서 걸러냈다`) and unresolved placeholders (`[자사 확인 필요]`, `[출처 확인 필요]`, `[작성 중]`).
+- **Review-only:** unsupported absolutes (`논문이 없다`, `없다는 것이 발견`), empty rhetoric (`판이 굳었다`, `전제로 깐다`), command-like planning (`닫아야 할 게이트`, `역전 금지`), unexplained RAM/FTO/CNKI/코퍼스/전이원, and arbitrary dates or day counts without an approved source.
+- Review-only findings must be recorded and rewritten where warranted, but they do not become brittle automated failures. Prefer “검토한 데이터베이스 범위에서는 확인되지 않았다” and expand specialist terms on first use.
+
+## Visual design laws (impeccable-adapted)
+Apply with a human eye AFTER automated checks. Targets a static export (no motion/gradients; no borders/shadows on text).
+
+### Anti-slop visual bans (absolute)
+- [ ] No side-stripe accents (colored `border-left/right` > 1px) — use a 1px hairline, a flat tint, a leading numeral, or an icon on a wrapper `<div>`.
+- [ ] No ghost cards: one box = a 1px border OR a ≤8px shadow, never both; no empty outlined boxes as decoration.
+- [ ] One corner-radius law deck-wide (default sharp); pills only for tags/chips.
+- [ ] No identical card grid — vary span/size or mix card with non-card.
+- [ ] No eyebrow reflex / `01·02·03` on every slide unless it genuinely is an ordered sequence.
+- [ ] No hero-metric ornament — a big number only when it IS the slide's data.
+- [ ] No card-everything / card-in-card — group with spacing and hairline dividers.
+- [ ] No gratuitous blobs, noise, or sketchy SVG. Use the chosen template's gradient or mesh only when it supports hierarchy.
+
+### Contrast & color (within the template's palette)
+- [ ] Body/running text ≥ 4.5:1; large text (≥18pt, or bold ≥14pt) and structural lines ≥ 3:1 — measure the pair (`qa_deck.py` enforces this).
+- [ ] No gray text on a colored fill; darken the fill's own hue instead. Color is never the sole signal — deltas carry a ▲/▼ glyph + sign.
+- [ ] Accent coverage ≤ ~10% of the slide; one color = one meaning deck-wide. Use the template palette; invent no inline one-off hex.
+
+### Typography
+- [ ] One family in ≤ 3–4 weights, one role each; body never set in a display cut. For per-weight-family fonts (에이투지체/Example Sans) pick weight by family name, never a bold flag.
+- [ ] ≤ 3–4 distinct sizes per slide on one ramp; no muddy near-equal sizes. Display ≤ ~40pt for the boilerplate templates.
+- [ ] UPPERCASE labels take positive tracking (override the narrow body default). Headings line-height 1.1–1.2; body 1.3–1.7 (Korean body looser).
+- [ ] No single-word widow on a heading's last line (author manual breaks — `text-wrap` does not survive export). Numeric columns right-aligned.
+
+### Layout & hierarchy
+- [ ] Squint test passes: the one primary element + the groupings are obvious at a blur.
+- [ ] Exactly one primary element per slide (≥ 2:1 to the next level); ≤ 4 items per group; even density across the deck.
+- [ ] One 4pt spacing scale (4/8/12/16/24/32/48); vary gaps for rhythm; one alignment axis per region.
+- [ ] Every border/divider/box earns its place — remove anything carrying no information before export.
+
+### Objective evidence checks
+
+- [ ] No explicit run is below the absolute 6pt floor. Primary reading text remains ≥12pt; captions/sources may use 6–10.5pt.
+- [ ] No colored vertical side-stripe is attached to a card. A full-width structural rule is not a side stripe.
+- [ ] A picture or table is not materially covered by a later text/image/table object.
+- [ ] A picture declared as `figure`, `evidence`, or `source capture` has a visible adjacent numbered caption and `Source:`/`출처:`.
+- [ ] Every appendix DOI, canonical-link, or raw-URL field contains an actual external OOXML hyperlink relationship; detection does not depend on a special “link available” phrase.
+- [ ] Thumbnail review still judges hierarchy, whitespace, chart intuitiveness, executive tone, and whether caption/source/interpretation read as one group.

package/assets/lithermes-plugin/skills/lit-pptx/references/authoring-guide.md

@@ -0,0 +1,139 @@
+# Authoring Guide (Markdown → PPTX)
+
+How to author a deck in the constrained Markdown dialect that `scripts/compile-deck.js` compiles. Template-agnostic — the enrolled template owns fonts, palette, dimensions, and decorations. The full contract is `slide-formats/markdown-slide-spec-v1.md`; this guide is the working reference.
+
+## 1. Pick a template (and font)
+```bash
+node scripts/compile-deck.js --list-templates
+node scripts/compile-deck.js --list-layouts <TEMPLATE>   # blocks + regions per layout
+```
+Bundled templates:
+| Template | Canvas | Font | Use |
+|----------|--------|------|-----|
+| `BOILERPLATE-PRETENDARD` (default) | 4:3 (10×7.5in) | Pretendard | General professional/technical decks |
+| `BOILERPLATE-A2Z` | 4:3 (10×7.5in) | 에이투지체 (A2Z) | Same layout, A2Z typography |
+| `AZURE-PRO` | 16:9 (13.333×7.5in) | Pretendard | General professional deck |
+| *(learned)* | from source | from source | `scripts/learn_template.py <your.pptx> --name <NAME>` to enroll your own brand |
+
+Font note: **Pretendard** is one weighted family (bold via weight). **에이투지체** ships one family *per weight* (`에이투지체 7 Bold`) — weight is chosen by family name, never a bold flag. The template encodes this; you just write content.
+
+## 2. Deck skeleton
+```markdown
+---
+template: BOILERPLATE-PRETENDARD
+title: Deck Title
+date: 2026-06-29
+---
+
+---
+layout: cover
+
+# Deck Title
+---
+
+---
+layout: content
+
+## Section title
+
+- **Bold section header**
+  (1) sub-item with a concrete detail
+  (2) another sub-item
+- **Second header**
+---
+
+---
+layout: closing
+
+# 감사합니다
+---
+```
+**Separator rule (critical):** a `---` line, then a blank line, then `---` + the next `layout:`. This is how slides are split — see the spec.
+
+## 3. Layouts (the 5 approved)
+- `cover` — title + metadata + date
+- `content` — title + body (bullets/numbered/sections), optional table + image + captions
+- `main` — content + an optional bordered `main-box` callout
+- `summary` — two grouped blocks (top/bottom) + optional image/table
+- `closing` — single centered title
+
+Each layout supports a fixed set of blocks per template — check `--list-layouts`. Tables use standard Markdown pipes; images use `![alt](path)`; captions follow the spec.
+
+### Executive/research compositions
+
+These are semantic compositions of existing v1 blocks, so they remain renderer compatible:
+
+1. **figure plus interpretation**
+
+   ```markdown
+   ![Figure 1. Pressure trend | Source: test report, p. 12](assets/pressure.png)
+
+   - **Observation** Pressure remained inside the validated band.
+     (1) Limitation: one operating condition was not sampled.
+     (2) Implication: repeat the test before scale-up.
+   ```
+
+2. **table plus decision takeaway** — keep units in headers, quantitative cells compact, ≤6 columns, and add a blockquote caption/source immediately after the table.
+3. **source capture** — use a legible screenshot with locator/date in the alt text and state its limitation and relevance in the body.
+4. **two-record appendix evidence** — show at most two records per slide; include a one-line summary, source locator, and clickable DOI/canonical link when available. In a table cell, write `[원문](https://example.org/record)`; the PPTX renderer emits an external OOXML hyperlink relationship.
+
+Do not write authoring trace or unresolved placeholders. Treat overclaim, jargon, imperative tone, unsupported schedules, hierarchy, and visual density as review-only items to resolve during thumbnail review.
+
+## 4. Compile
+```bash
+node scripts/compile-deck.js deck.md --template <TEMPLATE> --html out.html      # preview
+node scripts/compile-deck.js deck.md --template <TEMPLATE> --pptx out.pptx --embed-fonts
+```
+`--embed-fonts` makes the deck self-contained (renders on machines without the font). `--ast out.json` dumps the intermediate AST.
+
+## 5. Verify (always)
+```bash
+python3 scripts/qa_deck.py out.pptx        # overflow/overlap + WCAG contrast + anti-slop; non-zero = FAIL
+soffice --headless --convert-to pdf --outdir renders out.pptx   # then render PDF pages to PNG and inspect them
+```
+A clean gate is defect-absence, not quality — read the thumbnails. See `references/anti-slop-checklist.md`.
+
+## 6. Anti-patterns (fix before shipping)
+- Generic titles ("개요"/"Overview") → make them specific.
+- Padding bullets that restate the heading → cut or add real information.
+- Manually adding logos/lines/colors/fonts → the template applies decorations; don't.
+- Overloaded slides (> ~8 bullets, > ~8 table rows, > 4 items per summary group) → split.
+- Placeholder/AI-slop wording → gated by `FORBIDDEN_TERMS.json`.
+- Evidence image with only a filename-like alt → write a numbered caption plus `Source:`/`출처:` so the visible caption stays bound to the figure.
+- Appendix DOI/canonical/raw URL field without a hyperlink → add an actual PowerPoint hyperlink. QA detects the field directly and verifies its external OOXML relationship; no special “link available” phrase is required.
+
+## 7. Bring your own brand
+```bash
+python3 scripts/learn_template.py corporate.pptx --name MY-BRAND   # extracts fonts/palette/geometry, closed-set verified
+node scripts/compile-deck.js deck.md --template MY-BRAND --pptx out.pptx --embed-fonts
+```
+The learned template only references fonts/colors/assets present in your source (off-brand-by-construction).
+
+## Placement (spec v2)
+
+Reach for the least freedom that says the thing. Each tier gives up a guardrail, and
+the one below it is harder to get right.
+
+| Want | Write | Gives up |
+|---|---|---|
+| the template's geometry, a different slot | `::: region name=<region>` | nothing |
+| two things beside each other | `:::: columns 2fr 1fr gap=0.3` with `::: col` inside | portability stays; you choose the split |
+| something the template never anticipated | `::: box x= y= w= h=` and `::: shape <kind> …` | every guardrail — nothing reflows around it |
+| a slide with no template furniture at all | `layout: free` | the template's whole contribution |
+| a different look, same layout | `variant: split-navy` | nothing |
+
+Containers nest by fence length: the outer fence is longer (`::::` holds `:::`).
+`::: shape` is one line with no closing fence. Shapes sit behind content, boxes on top.
+
+Full contract: `slide-formats/markdown-slide-spec-v2.md`.
+
+**A slide built with a box, a shape or `layout: free` has to be looked at** — render it,
+gate it, then read the thumbnail. The gate reports defects; it does not report that a
+slide reads badly.
+
+## Charts
+
+Never drawn here. Call `/scientific-visualization`, hand it the deck's visual system
+with `compile-deck.js --template <T> --export-viz-context ctx.json`, and place the
+result as a captioned figure. Register the font *file* from `ctx.json` rather than the
+family name — a Korean family resolved by name alone renders as boxes.

package/assets/lithermes-plugin/skills/lit-pptx/references/consensus-protocol.md

@@ -0,0 +1,125 @@
+# Consensus Protocol — PPTX Ralplan
+
+## Overview
+Sequential Planner → Architect → Critic loop for PPTX slide structure planning. The loop runs until all reviewers APPROVE or max iterations (3) are exhausted.
+
+## Agent Roles
+
+### Planner (Orchestrator acts as Planner)
+- Reads the interview spec (or direct user request)
+- Creates a slide-by-slide implementation plan
+- Specifies layout, content, data, and render path per slide
+
+### Architect (Agent tool with agents/architect.md)
+- Reviews plan for layout feasibility, template compliance
+- Checks font names, dimensions, data expression validity
+- Flags BLOCKER issues that would cause rendering failures
+
+### Critic (Agent tool with agents/critic.md)
+- Evaluates content quality, anti-slop compliance
+- Checks for forbidden patterns, generic headings, padding
+- Scores overall quality on 1-10 scale
+
+## Loop Process
+
+```
+Iteration 1:
+  Planner creates plan
+      ↓
+  Architect reviews → APPROVE or REJECT with issues
+      ↓ (if REJECT)
+  Planner revises based on Architect feedback
+      ↓
+  Architect reviews again
+      ↓
+  Critic evaluates → APPROVE or REJECT
+      ↓ (if REJECT)
+  Planner revises based on Critic feedback
+
+Iteration 2: (if previous rejected)
+  [repeat Planner → Architect → Critic sequence]
+
+Iteration 3: (final attempt)
+  [repeat, force-approve if still has only minor issues]
+```
+
+## Approval Gates
+
+### Architect APPROVE Criteria
+- All layouts valid
+- Font usage matches the chosen template (for per-weight-family fonts like 에이투지체/Example Sans, weight is selected by family name, not a bold flag)
+- Dimensions match the chosen template (e.g. 10×7.5in 4:3 for BOILERPLATE-*, 10.833×7.5in for a custom template)
+- No anti-slop violations
+- Render paths appropriate per slide complexity
+
+### Critic APPROVE Criteria
+- Quality score ≥ 7/10
+- Zero CRITICAL issues
+- At most 2 MAJOR issues
+- No FORBIDDEN_TERMS
+
+### Forced Approval
+If after 3 iterations the plan has only MINOR issues, force-approve with notes. Do not loop indefinitely.
+
+## State Persistence
+State is stored in `.pptx-pipeline/plan-state.json`:
+```json
+{
+  "active": true,
+  "iteration": 1,
+  "max_iterations": 3,
+  "architect_verdict": null,
+  "critic_verdict": null,
+  "issues_resolved": [],
+  "started_at": "ISO timestamp"
+}
+```
+
+## Output Plan Format
+Write to `.pptx-pipeline/plan-{slug}.md`:
+```markdown
+# PPTX Implementation Plan: {title}
+
+## Consensus Metadata
+- Iterations: {n}
+- Architect verdict: APPROVE
+- Critic verdict: APPROVE
+- Quality score: N/10
+
+## Slide-by-Slide Implementation
+### Slide 1: Cover
+- Layout: cover
+- Title: "..."
+- Metadata: date, department
+- Render path: compile-deck.js
+
+### Slide 2: TOC
+- Layout: content
+- Title: "목차"
+- Items: [...]
+- Render path: compile-deck.js
+
+### Slide 3-N: Content
+- Layout: content | main
+- Title: "..."
+- Body: [bullet structure]
+- Data: [table spec if any]
+- Render path: compile-deck.js | pptxgenjs-direct
+
+### Slide N+1: Summary
+- Layout: summary
+- Group 1: [heading + items]
+- Group 2: [heading + items]
+- Image: [path or none]
+- Table: [spec or none]
+- Render path: compile-deck.js
+
+### Slide N+2: Closing
+- Layout: closing
+- Render path: compile-deck.js
+
+## QA Plan
+- Compile: `node scripts/compile-deck.js deck.md --template <TEMPLATE> --pptx output.pptx --embed-fonts` (default `<TEMPLATE>` = BOILERPLATE-PRETENDARD)
+- Verify: `python scripts/inventory.py output.pptx verify.json --issues-only`
+- No FORBIDDEN_TERMS check: `python validate_pptx.py output.pptx`
+```