konoha-mcp 2.1.13 → 2.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/.agents/skills/konoha/SKILL.md +19 -3
  2. package/.agents/skills/tokubetsu-jonin-skill/SKILL.md +48 -23
  3. package/.agents/skills/tokubetsu-jonin-skill/references/docx.md +25 -4
  4. package/.agents/skills/tokubetsu-jonin-skill/references/elite-powerpoint-designer.md +48 -23
  5. package/.agents/skills/tokubetsu-jonin-skill/references/pdf.md +78 -46
  6. package/.agents/skills/tokubetsu-jonin-skill/references/pptx.md +25 -3
  7. package/.agents/skills/tokubetsu-jonin-skill/references/xlsx.md +60 -33
  8. package/.agents/skills/tokubetsu-jonin-skill/references/zero-ai-human-writing.md +34 -11
  9. package/.agents/skills.fingerprint +1 -1
  10. package/README.md +18 -6
  11. package/apps/web/build/adapter-node.js +1 -1
  12. package/apps/web/build/client/_app/version.json +1 -1
  13. package/apps/web/build/client/_app/version.json.br +0 -0
  14. package/apps/web/build/client/_app/version.json.gz +0 -0
  15. package/apps/web/build/server/chunks/instance.js +3 -3
  16. package/apps/web/build/server/chunks/internal.js +1 -1
  17. package/apps/web/package.json +1 -1
  18. package/bin/cli.js +10 -10
  19. package/bin/lib/ui_commands.js +4 -4
  20. package/docs/ALL-WORKFLOW-DIAGRAMS.md +642 -0
  21. package/docs/ARCHITECTURE.md +15 -7
  22. package/docs/SETUP-CLI.md +1 -1
  23. package/docs/SecurityCompliance/security_compliance_report_google_policy_2.1.13_2026-10-07.md +10 -0
  24. package/docs/SecurityCompliance/security_compliance_report_google_policy_2.1.14_2026-10-08.md +88 -0
  25. package/docs/SecurityCompliance/security_compliance_report_google_policy_2.1.15_2026-10-08.md +74 -0
  26. package/docs/diagrams/README.md +1 -1
  27. package/package.json +3 -2
  28. package/src/agent_manager.js +20 -4
  29. package/src/antigravity_manager.js +8 -6
  30. package/src/canonical_skills.js +1 -1
  31. package/src/codex_manager.js +3 -3
  32. package/src/cursor_bootstrap.js +3 -3
  33. package/src/cursor_manager.js +4 -3
  34. package/src/deploy_utils.js +38 -15
  35. package/src/docs_ai_detector.js +9 -6
  36. package/src/file_tools_router.js +3 -1
  37. package/src/mcp/anti_slop.js +281 -0
  38. package/src/mcp/memory_reporting.js +21 -0
  39. package/src/mcp/skills.js +274 -0
  40. package/src/mcp/tool_dispatch.js +14 -1
  41. package/src/mcp/workflow.js +1 -1
  42. package/src/mcp_tool_manifest.json +59 -0
  43. package/src/platform_utils.js +11 -9
  44. package/src/templates/agents.yaml +21 -0
  45. package/src/templates/skills/konoha/SKILL.md +19 -3
  46. package/src/templates/skills/tokubetsu-jonin-skill/SKILL.md +48 -23
  47. package/src/templates/skills/tokubetsu-jonin-skill/references/docx.md +25 -4
  48. package/src/templates/skills/tokubetsu-jonin-skill/references/elite-powerpoint-designer.md +48 -23
  49. package/src/templates/skills/tokubetsu-jonin-skill/references/pdf.md +78 -46
  50. package/src/templates/skills/tokubetsu-jonin-skill/references/pptx.md +25 -3
  51. package/src/templates/skills/tokubetsu-jonin-skill/references/xlsx.md +60 -33
  52. package/src/templates/skills/tokubetsu-jonin-skill/references/zero-ai-human-writing.md +34 -11
  53. package/src/web_server.js +16 -4
  54. package/.agents/skills/helm-chart-scaffolding/SKILL.md +0 -71
  55. package/.agents/skills/helm-chart-scaffolding/assets/Chart.yaml.template +0 -42
  56. package/.agents/skills/helm-chart-scaffolding/assets/values.yaml.template +0 -185
  57. package/.agents/skills/helm-chart-scaffolding/references/chart-structure.md +0 -509
  58. package/.agents/skills/helm-chart-scaffolding/references/details.md +0 -497
  59. package/.agents/skills/helm-chart-scaffolding/scripts/validate-chart.sh +0 -244
  60. package/src/templates/skills/helm-chart-scaffolding/SKILL.md +0 -71
  61. package/src/templates/skills/helm-chart-scaffolding/references/chart-structure.md +0 -509
  62. package/src/templates/skills/helm-chart-scaffolding/references/details.md +0 -497
@@ -439,10 +439,10 @@ These standards apply to every build mode (`build_from_text`, clone-url flows, `
439
439
  - **High & Medium Risk Elimination**: The target repository manifests MUST be strictly clean from **High** (error/critical/malware/CVE) and **Medium** (warn/gptAnomaly/eval/anomaly) risk alerts (0 High, 0 Medium). Low-level risk (informational/monitor notices like telemetry or minified file alerts) is excluded from blocking delivery.
440
440
  - **Delivery Blocking**: If any High or Medium risk vulnerability or supply-chain issue is detected, delivery is strictly BLOCKED until dependencies are upgraded, overridden, or remediated.
441
441
  - **Standard Confidence Gate Report**: The Kage Reviewer Confidence Gate Report table must include the `Socket Security Gate` row verifying 0 High, 0 Medium findings before delivery.
442
- 75. **Canonical Skills Single Source of Truth & Database Parity (v2.1.13)**:
443
- - **Single Source of Truth (`src/canonical_skills.js`)**: Authoritatively defines `CANONICAL_SKILL_NAMES` (the 16 canonical ninja and core skills) and `KNOWN_EMBEDDED_REFERENCE_SKILLS` (190+ reference skills consolidated inside ninja skills).
442
+ 75. **Canonical Skills Single Source of Truth & Database Parity (v2.1.13 - v2.1.14)**:
443
+ - **Single Source of Truth (`src/canonical_skills.js`)**: Authoritatively defines `CANONICAL_SKILL_NAMES` (the 15 canonical ninja and core skills, with `helm-chart-scaffolding` consolidated into `anbu-skill`) and `KNOWN_EMBEDDED_REFERENCE_SKILLS` (190+ reference skills consolidated inside ninja skills).
444
444
  - **Automatic Deduplication Without Pruning**: `isEmbeddedReference()` in `src/migrate.js` and `src/mcp/skills.js` prevents duplicate standalone skill registration from mirror or project directories, while preserving all user custom skills.
445
- - **100% Database Parity**: The database `~/.konoha/konoha.db` must strictly contain exactly 16 skills of `type = 'skill'` and all referenced sub-skills indexed as `type = 'reference'`.
445
+ - **100% Database Parity**: The database `~/.konoha/konoha.db` strictly contains exactly 15 skills of `type = 'skill'` and all referenced sub-skills indexed as `type = 'reference'`.
446
446
  - **Skill & Mirror Preservation Invariant**: Strictly never prune, delete, or strip `~/.agents/skills/` or any client mirror trees (`.cursor/skills`, `.gemini/skills`, etc.).
447
447
  76. **Least-Privilege Security Boundaries & Scoped Client Tool Permissions (v2.1.13)**:
448
448
  - **Elimination of Wildcard Grants**: Replaces all `*` wildcard approvals in Command Code, Claude Code, and Cursor with explicit, enumerated tool names (`konoha_*`, `semble_*`, `aislop_*`).
@@ -450,4 +450,20 @@ These standards apply to every build mode (`build_from_text`, clone-url flows, `
450
450
  77. **LibreOffice Shim Integrity & Supply Chain Hardening (v2.1.13)**:
451
451
  - **Zero Dynamic Interposition**: Document generation tools (`soffice.py`) avoid dynamic, runtime compilation of untrusted C source code into shared objects (`LD_PRELOAD`).
452
452
  - **Integrity Validation**: Shims and prebuilt binaries must pass cryptographic hash validation or execute directly through safe standard LibreOffice headless CLI flags (`--headless --convert-to`).
453
+ 78. **Accurate Skill Resolution via `use_skills` MCP Tool (v2.1.14)**:
454
+ - **Precise Database Lookup**: Direct resolution from SQLite `konoha.db` by exact skill name (`use_skills({ skills: [...] })`).
455
+ - **Fallback Warning**: If not present in DB, logs structured warning to console and gracefully falls back to local mirror (`.agents/skills/` / `~/.agents/skills/`).
456
+ - **Eliminates Hallucination**: Prevents skill misattribution or agent capability hallucination.
457
+ 79. **Deterministic `anti_slop` Verification Pre-Gate & Tokubetsu-Jonin Human Document Design Layer (v2.1.14)**:
458
+ - **Anti-Slop Pre-Gate Tool (`anti_slop`)**: Executed in Kage pre-delivery review alongside `aislop_scan`. Validates zero AI-slop patterns (lazy placeholders, generic syntax comments, speculative over-engineering, conversational fluff).
459
+ - **Mandatory Agent Anti-Slop Matrix**: `antislop` in all official agents; `antislop-ui` in `jonin`; `antislop-copywriting` in `tokubetsu-jonin`; `antislop-human` in all official agents except `sannin`; `antislop-layoutmobile` in `jonin`; `antislop-code` in all official agents except `sannin`.
460
+ - **Tokubetsu-Jonin Human Document Design Layer**: Strict standards for Word/DOCX, PowerPoint/PPTX, Excel/XLSX, and PDF:
461
+ * 20 gradient themes (T01–T20) with 4-base-color gradients.
462
+ * Text rendered in medium slate `#64748B` on white/light backgrounds.
463
+ * Zero dark colors (no black, dark gray, dark blue anywhere).
464
+ * Typography pairing contracts: Georgia + Calibri (DOCX/reports), Segoe UI Semibold/Georgia + Segoe UI/Calibri (PPTX), Calibri (XLSX), Inter (PDF).
465
+ * Mandatory Kage review gate for all generated documents.
466
+ 80. **Mandatory Release Permission Gate & Zero Auto-Release Invariant (v2.1.14+)**:
467
+ - **Explicit User Confirmation Required**: When maintaining, updating, or fixing the Konoha repository or any client configurations, the agent MUST ALWAYS explicitly ask the user for permission before executing any release action (creating git release commits, git tags, git pushes to release branches, or triggering npm publish / CI release workflows).
468
+ - **Zero Auto-Release Invariant**: Auto-releasing, automatic tagging, or unprompted publishing to npm or GitHub without prior explicit user request and authorization is strictly prohibited. Keep all changes local until explicitly instructed and approved by the user to release.
453
469
 
@@ -37,35 +37,60 @@ In the Konoha workflow, Tokubetsu-Jonin handles the documentation phase after al
37
37
  3. Include rollback and incident response notes.
38
38
 
39
39
  ## SOP 4: Professional Word Document (DOCX) Generation & Refinement
40
- 1. **Strict Light Mode Invariant (Zero Dark Style)**: Strictly enforce pure light mode. Never generate or refine documents with dark covers, dark headers, dark footers, or black/near-black fills. Backgrounds must be pure white (`#FFFFFF`) or pearl (`#F8FAFC`).
41
- 2. **3-Color Minimum Gradient Invariant**: When decorative color is needed for cover ribbons, header bands, or footer accents, create a smooth multi-stop gradient with a **minimum of 3 colors** (e.g., Crimson `#B91C1C` → Amber `#D97706` → Gold `#FDE68A`, or Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA`).
42
- 3. **Burstiness ($\sigma/\mu \ge 0.85$) & Primary Archival Citations**: Every paragraph must juxtapose 1–4 word punchy assertions with 25–45 word multi-clause analytical sentences. Cite exact shelfmarks, docket numbers, and dates (e.g. *ANRI Algemene Secretarie Besluit*, *Arsip Koloniën*, *Mailrapport*, *Prasasti*, *Babad*).
43
- 4. **Executive Table Styling**: Table headers use light executive tint fills (`#F1F5F9`) with bold dark text (`#0F172A`), subtle grid borders (`#CBD5E1`), and numeric columns right-aligned.
44
- 5. **Exact Physical Page Budget**: For N-page targets, calibrate content (~200–260 words per page with table/callout) and add explicit page breaks (`doc.add_page_break()`) up to page N-1.
45
- 6. **Automated Container Scrubbing**: Run `scrub_opc_zip` with `re.IGNORECASE` to purge `python-docx` tags, normalize `docProps/app.xml` to `Microsoft Word for Windows`, and reset `core.xml` attributes.
46
- 7. **Strict Zero Watermark Invariant**: Documents must NEVER contain watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), or translucent overlays.
40
+ 1. **Strict Light Mode & Zero Black/Dark Invariant**: Strictly enforce pure light mode. Never use black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Only bright to mid-tone colors on pure white (`#FFFFFF`) or pearl (`#F8FAFC`) backgrounds, with text in **medium slate `#64748B`**.
41
+ 2. **20 Enterprise 4-Base-Color Themes**: Apply a 4-base-color gradient to the cover, header, and footer lines. Randomly pick ONE of the 20 canonical themes (T01–T20) per document and keep it consistent throughout:
42
+ - T01: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
43
+ - T02: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
44
+ - T03: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
45
+ - T04: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
46
+ - T05: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
47
+ - T06: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
48
+ - T07: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
49
+ - T08: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
50
+ - T09: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
51
+ - T10: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
52
+ - T11: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
53
+ - T12: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
54
+ - T13: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
55
+ - T14: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
56
+ - T15: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
57
+ - T16: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
58
+ - T17: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
59
+ - T18: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
60
+ - T19: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
61
+ - T20: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
62
+ 3. **Typography Contract**: Word/reports strictly use **Georgia (headings) + Calibri (body)** with consistent spacing, alignment, and visual hierarchy.
63
+ 4. **Burstiness ($\sigma/\mu \ge 0.85$) & Primary Archival Citations**: Clean human-written prose (no robotic, filler, or AI-sounding phrasing). Every paragraph juxtaposes punchy assertions with multi-clause analytical sentences, supported by verifiable primary citations and exact metrics.
64
+ 5. **Executive Table Styling**: Table headers use light executive tint fills (`#F1F5F9`) with medium slate text (`#64748B`), subtle grid borders (`#E2E8F0`), and numeric columns right-aligned.
65
+ 6. **Exact Physical Page Budget**: For N-page targets, calibrate content (~200–260 words per page with table/callout) and add explicit page breaks (`doc.add_page_break()`) up to page N-1.
66
+ 7. **Automated Container Scrubbing**: Run `scrub_opc_zip` with `re.IGNORECASE` to purge `python-docx` tags, normalize `docProps/app.xml` to `Microsoft Word for Windows`, and reset `core.xml` attributes.
67
+ 8. **Mandatory Kage Review Gate**: Always use Kage review in every generated DOCX document before final delivery.
47
68
 
48
69
  ## SOP 5: Executive Presentation (PPTX) Deck Design
49
- 1. **Strict Light Mode Invariant**: 100% pure white (`#FFFFFF`) or soft pearl (`#F8FAFC`) slide canvas on ALL slides (including title and conclusion slides). Dark navy or black presentation slides are strictly forbidden.
50
- 2. **3-Color Minimum Gradient Accent**: Title slide and section dividers must feature a smooth 3-color minimum gradient accent bar.
51
- 3. **Visual Hierarchy & Multi-Tier Cards**: 16:9 widescreen layout, 3 rounded rectangle cards per content slide (`#F8FAFC` background, subtle border `#E2E8F0`, 4px accent top strip) featuring Header Tag, Punchy Hook, Analytical Body, and Verifiable Quote.
52
- 4. **Metadata Scrubbing**: Run `scrub_opc_zip` to remove generator tags (`python-pptx`, `pptxgenjs`) from presentation core properties and slides.
53
- 5. **Strict Zero Watermark Invariant**: Presentation slides must NEVER contain watermarks, diagonal stamps, or background evaluation marks.
70
+ 1. **Strict Light Mode & Zero Black/Dark Invariant**: 100% pure white (`#FFFFFF`) or soft pearl (`#F8FAFC`) slide canvas on ALL slides. Never use black, dark gray, or dark blue anywhere. Text strictly in medium slate `#64748B`.
71
+ 2. **4-Base-Color Gradient Theme Accent**: Select ONE of the 20 canonical themes (T01–T20) consistently across title slide, section dividers, and header accent strips.
72
+ 3. **Typography Contract**: PowerPoint strictly uses **Segoe UI Semibold or Georgia (headings) + Segoe UI or Calibri (body)**.
73
+ 4. **Visual Hierarchy & Multi-Tier Cards**: 16:9 widescreen layout, 3 rounded rectangle cards per content slide (`#F8FAFC` background, subtle border `#E2E8F0`, 4px theme gradient accent top strip) featuring Header Tag, Punchy Hook, Analytical Body, and Verifiable Quote.
74
+ 5. **Metadata Scrubbing**: Run `scrub_opc_zip` to remove generator tags (`python-pptx`, `pptxgenjs`) from presentation core properties and slides.
75
+ 6. **Mandatory Kage Review Gate**: Always use Kage review in every generated PPTX presentation.
54
76
 
55
77
  ## SOP 6: Enterprise Financial & Data Spreadsheet (XLSX) Modeling
56
- 1. **Strict Light Mode Invariant**: Pure white sheet background (`#FFFFFF`). Never apply dark header bars or dark fills.
57
- 2. **3-Color Gradient Top Accent Ribbon**: Decorative row (row 3, height 4) featuring a 3-color minimum gradient above the table header.
58
- 3. **Table Headers & Cell Styling**: Light executive fill (`#F1F5F9` or `#ECFDF5`) with bold dark text (`#0F172A`), thin cell borders (`#CBD5E1`), alternating pearl row fills (`#F8FAFC`).
59
- 4. **Model Rigor**: Zero bare decimals; format currency (`$#,##0`), percentages (`0.0%`), and counts (`#,##0`). UPPERCASE formulas (`SUM`, `AVERAGE`, `COUNTIF`, `XLOOKUP`). Lowercase formulas are strictly rejected.
60
- 5. **View Setup**: Freeze panes on header row (`ws.freeze_panes = 'A5'`), explicitly show gridlines (`showGridLines = True`), and auto-fit column widths (+4 padding).
61
- 6. **Strict Zero Watermark Invariant**: Workbooks and sheets must NEVER contain watermarks, sheet header watermarks, or background stamps.
78
+ 1. **Strict Light Mode & Zero Black/Dark Invariant**: Pure white sheet background (`#FFFFFF`). Never use black, dark gray, or dark blue anywhere. Text strictly in medium slate `#64748B`.
79
+ 2. **4-Base-Color Theme Top Accent Ribbon**: Decorative ribbon (row 3, height 4) featuring colors from the chosen theme (T01–T20) above the table header.
80
+ 3. **Typography Contract**: Excel strictly uses **Calibri (headings and body)**.
81
+ 4. **Table Headers & Cell Styling**: Light executive fill (`#F1F5F9` or `#ECFDF5`) with medium slate text (`#64748B`), thin cell borders (`#E2E8F0`), alternating pearl row fills (`#F8FAFC`).
82
+ 5. **Model Rigor**: Zero bare decimals; format currency (`$#,##0`), percentages (`0.0%`), and counts (`#,##0`). UPPERCASE formulas (`SUM`, `AVERAGE`, `COUNTIF`, `XLOOKUP`). Lowercase formulas are strictly rejected.
83
+ 6. **View Setup**: Freeze panes on header row (`ws.freeze_panes = 'A5'`), explicitly show gridlines (`showGridLines = True`), and auto-fit column widths (+4 padding).
84
+ 7. **Mandatory Kage Review Gate**: Always use Kage review in every generated XLSX spreadsheet.
62
85
 
63
86
  ## SOP 7: Publication-Grade PDF Generation
64
- 1. **Strict Light Mode Invariant**: Pure white page backgrounds (`#FFFFFF`). Dark theme covers, pages, or fills are strictly prohibited.
65
- 2. **CSS Paged Media Isolation**: `@page { size: A4 portrait; margin: 16mm 18mm 16mm 18mm; @top-right { ... } @bottom-right { content: "Halaman " counter(page) " dari " counter(pages); } }`. Wrap every page section in `<div class="page">` with `page-break-after: always; box-sizing: border-box;`.
66
- 3. **Executive Callout Boxes**: Light tinted background (`#F8FAFC` or `#F0F9FF`) with a 3-color gradient left border accent.
67
- 4. **Metadata Scrubbing & Sanitization**: Purge automated PDF library tags (`ReportLab`, `WeasyPrint`) using `sanitize_pdf` with `pydyf.Dictionary()` (Title, Author, Creator `Adobe InDesign 19.0`, Producer `Acrobat Distiller 24.0`).
68
- 5. **Strict Zero Watermark Invariant**: PDFs must NEVER contain watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), or translucent overlays.
87
+ 1. **Strict Light Mode & Zero Black/Dark Invariant**: Pure white page backgrounds (`#FFFFFF`). Never use black, dark gray, or dark blue anywhere. Text strictly in medium slate `#64748B`.
88
+ 2. **4-Base-Color Gradient Theme**: Apply the selected canonical theme (T01–T20) across cover, header, and footer lines consistently.
89
+ 3. **Typography Contract**: PDF/digital strictly uses **Inter (headings and body)**.
90
+ 4. **CSS Paged Media Isolation**: `@page { size: A4 portrait; margin: 16mm 18mm 16mm 18mm; @top-right { ... } @bottom-right { content: "Halaman " counter(page) " dari " counter(pages); } }`. Wrap every page section in `<div class="page">` with `page-break-after: always; box-sizing: border-box;`.
91
+ 5. **Executive Callout Boxes**: Light tinted background (`#F8FAFC` or `#F0F9FF`) with a 4-color gradient left border accent.
92
+ 6. **Metadata Scrubbing & Sanitization**: Purge automated PDF library tags (`ReportLab`, `WeasyPrint`) using `sanitize_pdf` with `pydyf.Dictionary()` (Title, Author, Creator `Adobe InDesign 19.0`, Producer `Acrobat Distiller 24.0`).
93
+ 7. **Mandatory Kage Review Gate**: Always use Kage review in every generated PDF document.
69
94
 
70
95
  ## SOP 8: Zero-AI Human Voice & Authenticity Standard
71
96
  1. **Mathematical Burstiness Target ($\sigma/\mu \ge 0.85$)**: Enforce extreme sentence length variance within every single paragraph to defeat sliding-window AI classifiers (preventing the 21.9% detection failure).
@@ -19,11 +19,32 @@ Use this reference whenever generating, editing, or styling Microsoft Word docum
19
19
 
20
20
  ## 1. Zero-AI Human Writing Invariants for Word Documents
21
21
 
22
- - **Strict Light Mode Invariant (Zero Dark Theme Style)**: Under NO circumstances create, generate, or style Word documents with dark theme style. Dark covers, dark pages, dark headers, dark footers, and black or near-black background fills are STRICTLY PROHIBITED. All document backgrounds must be pure white (`#FFFFFF`) or subtle pearl white (`#F8FAFC`) for executive readability.
23
- - **3-Color Minimum Gradient for Covers, Headers, & Footers**: When color or visual distinction is needed for cover pages, header bands, footer accents, or hero dividers, ALWAYS create a smooth multi-stop gradient with a MINIMUM of 3 colors (e.g. Crisp Executive Sapphire `#1E3A8A` → `#2563EB` → `#60A5FA`, Emerald Wealth `#065F46` → `#0D9488` → `#38BDF8`, or Dawn Coral `#9A3412` → `#EA580C` → `#FDBA74`). Never use a dark gradient or single flat dark blocks.
24
- - **Business & Enterprise Class Polish**: Typography must use modern corporate fonts (Aptos, Calibri, Arial, Georgia) with clean point sizing, 1.15 line spacing, generous cell padding (minimum 120 DXA), subtle light borders (`#CBD5E1`), and soft zebra stripes (`#F8FAFC`).
25
- - **Strict Zero Watermark Invariant**: Under NO circumstances should generated, styled, or edited Word documents contain watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), translucent image overlays, or evaluation markings. All pages must feature clean, unblemished white canvases.
22
+ - **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances create, generate, or style Word documents with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All document backgrounds must be pure white (`#FFFFFF`) or pearl (`#F8FAFC`), with text strictly in **medium slate `#64748B`**.
23
+ - **20 Canonical 4-Base-Color Themes**: When decorative color is applied to cover ribbons, header bands, or footer lines, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per document and keeping it consistent throughout:
24
+ - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
25
+ - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
26
+ - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
27
+ - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
28
+ - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
29
+ - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
30
+ - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
31
+ - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
32
+ - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
33
+ - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
34
+ - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
35
+ - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
36
+ - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
37
+ - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
38
+ - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
39
+ - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
40
+ - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
41
+ - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
42
+ - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
43
+ - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
44
+ - **Strict Typography Contract**: Word/reports strictly use **Georgia (headings) + Calibri (body)** with clean point sizing, 1.15 line spacing, generous cell padding (minimum 120 DXA), subtle light borders (`#E2E8F0`), and soft zebra stripes (`#F8FAFC`).
45
+ - **Strict Zero Watermark Invariant**: Under NO circumstances should generated Word documents contain watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), translucent image overlays, or evaluation markings.
26
46
  - **Metadata Scrubbing**: Always set document core properties (`creator`, `lastModifiedBy`) to the project or author name; remove default library tags (`python-docx`, `docx-js`).
47
+ - **Mandatory Kage Review Gate**: Every generated DOCX document must undergo Kage review before completion.
27
48
 
28
49
  ---
29
50
 
@@ -16,17 +16,40 @@ Transform content into world-class presentations with the design quality of Appl
16
16
  ## Core Design Philosophy & Business-Class Invariants
17
17
 
18
18
  > [!IMPORTANT]
19
- > **Strict Light Mode Invariant (Zero Dark Theme)**: Under no circumstances should presentations be designed with dark backgrounds, black slides, or dark navy full-bleed covers. All presentations must use pure white (`#FFFFFF`) or soft pearl (`#F8FAFC` / `#FAFAFA`) canvases.
20
- > **3-Color Minimum Gradient Invariant**: When decorative accents, header/footer bands, title dividers, or KPI highlights are applied, strictly use a smooth gradient with a **minimum of 3 colors** (e.g., Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` or Teal `#0D9488` → Cyan `#06B6D4` → Mint `#6EE7B7`).
19
+ > **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances should presentations be designed with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All slide canvases must be pure white (`#FFFFFF`) or soft pearl (`#F8FAFC` / `#FAFAFA`), with text strictly in **medium slate `#64748B`**.
20
+ > **20 Canonical 4-Base-Color Themes**: When decorative accents, header/footer bands, title dividers, or KPI highlights are applied, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per presentation deck and keeping it consistent throughout:
21
+ > - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
22
+ > - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
23
+ > - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
24
+ > - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
25
+ > - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
26
+ > - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
27
+ > - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
28
+ > - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
29
+ > - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
30
+ > - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
31
+ > - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
32
+ > - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
33
+ > - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
34
+ > - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
35
+ > - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
36
+ > - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
37
+ > - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
38
+ > - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
39
+ > - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
40
+ > - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
41
+ > **Strict Typography Contract**: PowerPoint presentations strictly use **Segoe UI Semibold or Georgia (headings) + Segoe UI or Calibri (body)** with text in medium slate `#64748B`.
42
+ > **Mandatory Kage Review Gate**: Always use Kage review on every generated PowerPoint presentation.
21
43
 
22
44
  **Principles:**
23
45
  1. **Pure Light Mode Canvas** - Clean white backgrounds with executive crisp contrast.
24
- 2. **3-Color Gradient Accents** - Sophisticated, multi-stop accents; zero monotone dark blocks.
25
- 3. **Minimalism First** - Remove everything that doesn't serve a clear purpose.
26
- 4. **Bold & Clear** - Large typography, high contrast, confident colors.
27
- 5. **Visual Hierarchy** - Guide attention through size, color, and spacing.
28
- 6. **Consistent Branding** - Every element follows the design system.
29
- 7. **Purposeful Motion** - Animations only where they add clarity or emphasis.
46
+ 2. **4-Base-Color Theme Gradient Accents** - Sophisticated, multi-stop accents matching T01–T20; zero monotone dark blocks.
47
+ 3. **Medium Slate `#64748B` Typography** - High-legibility, zero dark gray or black text.
48
+ 4. **Minimalism First** - Remove everything that doesn't serve a clear purpose.
49
+ 5. **Bold & Clear** - Large typography, high contrast, confident colors.
50
+ 6. **Visual Hierarchy** - Guide attention through size, color, and spacing.
51
+ 7. **Consistent Branding** - Every element follows the chosen theme consistently.
52
+ 8. **Purposeful Motion** - Animations only where they add clarity or emphasis.
30
53
 
31
54
  ## When to Use This Skill
32
55
 
@@ -41,37 +64,39 @@ Transform content into world-class presentations with the design quality of Appl
41
64
 
42
65
  ### Available Brand Styles
43
66
 
67
+ All presentation styles strictly enforce **Pure Light Mode**, text in **medium slate `#64748B`**, and smooth **4-base-color gradient ribbons** from one of the 20 canonical themes (T01–T20):
68
+
44
69
  **1. Tech Keynote (Executive Light Edition)**
45
- - **Colors**: Pure white background (#FFFFFF), slate text (#0F172A), 3-color gradient accent bar (#1E3A8A → #2563EB → #60A5FA)
46
- - **Typography**: SF Pro Display (title 72-96pt), SF Pro Text (body 32-44pt)
70
+ - **Colors**: Pure white background (#FFFFFF), medium slate text (#64748B), 4-base-color gradient accent bar (T01–T20)
71
+ - **Typography**: Segoe UI Semibold (title 54-72pt), Segoe UI (body 24-32pt)
47
72
  - **Layout**: Extreme whitespace, single focal point per slide
48
73
  - **Transitions**: Push, Fade (duration: 0.6s)
49
74
  - **Style**: Minimalist, premium, product-focused light mode
50
75
 
51
- **2. Corporate Professional (Microsoft/IBM Style)**
52
- - **Colors**: Pure white background (#FFFFFF), deep slate (#0F172A), 3-color gradient ribbon (#003366 → #0078D4 → #60A5FA), warm gray cards (#F8FAFC)
53
- - **Typography**: Segoe UI (title 54-72pt), body (24-32pt)
76
+ **2. Corporate Professional (Enterprise Executive Edition)**
77
+ - **Colors**: Pure white background (#FFFFFF), medium slate text (#64748B), 4-base-color gradient ribbon (T01–T20), soft pearl cards (#F8FAFC)
78
+ - **Typography**: Georgia (title 54-72pt), Calibri (body 24-32pt)
54
79
  - **Layout**: Balanced, grid-based, data-friendly
55
80
  - **Transitions**: Morph, Fade (duration: 0.8s)
56
81
  - **Style**: Trustworthy, data-driven, enterprise-ready light mode
57
82
 
58
- **3. Creative Bold (Google/Airbnb Style)**
59
- - **Colors**: Pure white canvas (#FFFFFF), 3-color gradient accents (#0D9488 → #06B6D4 → #6EE7B7)
60
- - **Typography**: Product Sans or Montserrat (title 64-84pt)
61
- - **Layout**: Dynamic, asymmetric, playful spacing
83
+ **3. Creative Bold (Design Innovation Edition)**
84
+ - **Colors**: Pure white canvas (#FFFFFF), medium slate text (#64748B), 4-base-color gradient accents (T01–T20)
85
+ - **Typography**: Segoe UI Semibold (title 54-72pt), Calibri (body 24-32pt)
86
+ - **Layout**: Dynamic, asymmetric, generous spacing
62
87
  - **Transitions**: Zoom, Reveal (duration: 0.5s)
63
88
  - **Style**: Energetic, innovative, design-forward light mode
64
89
 
65
- **4. Financial Elite (Goldman Sachs/McKinsey Style)**
66
- - **Colors**: Pure white background (#FFFFFF), deep charcoal (#1E293B), 3-color bronze/amber gradient (#9A3412 → #F59E0B → #FDE68A)
67
- - **Typography**: Garamond or Georgia (serif, elegant)
90
+ **4. Financial Elite (Institutional Boardroom Edition)**
91
+ - **Colors**: Pure white background (#FFFFFF), medium slate text (#64748B), 4-base-color gradient metrics ribbon (T01–T20)
92
+ - **Typography**: Georgia (title 54-72pt), Calibri (body 24-32pt)
68
93
  - **Layout**: Traditional hierarchy, centered, balanced
69
94
  - **Transitions**: Subtle Fade only (duration: 0.4s)
70
95
  - **Style**: Sophisticated, authoritative, premium light mode
71
96
 
72
- **5. Startup Pitch (Y Combinator/500 Startups Style)**
73
- - **Colors**: Pure white canvas (#FFFFFF), bold slate typography (#0F172A), 3-color gradient metric highlights
74
- - **Typography**: Inter or Roboto (modern sans-serif)
97
+ **5. Startup Pitch (Venture Showcase Edition)**
98
+ - **Colors**: Pure white canvas (#FFFFFF), medium slate typography (#64748B), 4-base-color gradient metric highlights (T01–T20)
99
+ - **Typography**: Segoe UI Semibold (title 54-72pt), Segoe UI (body 24-32pt)
75
100
  - **Layout**: Problem-solution focused, metric-heavy
76
101
  - **Transitions**: Quick Push (duration: 0.3s)
77
102
  - **Style**: Energetic, data-driven, founder-friendly light mode
@@ -21,28 +21,52 @@ Use this reference whenever generating, styling, or auditing standalone PDF docu
21
21
  ## 1. Zero-AI Human Document Invariants
22
22
 
23
23
  When creating executive PDFs:
24
- - **Strict Light Mode Invariant (Zero Dark Style)**: PDFs must strictly use pure light mode. Never apply dark theme fills, dark covers, dark header blocks, or black/near-black backgrounds to any page. Page backgrounds must be pure white (`#FFFFFF`) or pearl (`#FAFAFA`).
25
- - **3-Color Minimum Gradient Invariant**: When decorative color is applied to headers, footers, cover accents, or callout ribbons, always use a smooth multi-stop gradient with a minimum of 3 colors (e.g., Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` or Teal `#0D9488` → Cyan `#06B6D4` → Mint `#6EE7B7`). Monotone dark bars or 2-color harsh transitions are strictly forbidden.
24
+ - **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances create, generate, or style PDF documents with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All document backgrounds must be pure white (`#FFFFFF`) or pearl (`#FAFAFA`), with text strictly in **medium slate `#64748B`**.
25
+ - **20 Canonical 4-Base-Color Themes**: When decorative color is applied to headers, footers, cover accents, or callout ribbons, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per document and keeping it consistent throughout:
26
+ - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
27
+ - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
28
+ - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
29
+ - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
30
+ - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
31
+ - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
32
+ - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
33
+ - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
34
+ - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
35
+ - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
36
+ - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
37
+ - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
38
+ - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
39
+ - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
40
+ - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
41
+ - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
42
+ - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
43
+ - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
44
+ - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
45
+ - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
26
46
  - **Dynamic Two-Pass Pagination**: Every multi-page PDF must include running headers/footers with dynamic page numbering in the exact format: `Page X of Y`. Hardcoded single numbers (`Page 1`) signal naive generation.
27
- - **Professional Font Pairing**: Body copy set in crisp, readable sans-serif (Helvetica, Inter, Arial, Calibri) at 10–10.5pt with 14–15pt leading. Headlines in bold, authoritative hierarchy (H1: 22–26pt, H2: 15–18pt, H3: 12–14pt).
28
- - **Executive Data Tables**: Table headers use light executive fills (`#F1F5F9` or `#E2E8F0`) with dark typography (`#0F172A`). Subtle grid borders (`#E2E8F0`). Alternating rows use pearl shading (`#F8FAFC`).
29
- - **Executive Callout Boxes**: Light tinted fill (`#F0F9FF` or `#F8FAFC`) with a 3-color gradient accent bar along the left edge.
47
+ - **Strict Typography Contract**: PDF/digital deliverables strictly use **Inter (headings and body)** (fallback: Helvetica/Arial). Body copy at 10–10.5pt with 14–15pt leading in medium slate `#64748B`. Headlines in bold, authoritative hierarchy (H1: 22–26pt, H2: 15–18pt, H3: 12–14pt) in medium slate `#64748B`.
48
+ - **Executive Data Tables**: Table headers use light executive fills (`#F1F5F9`) with `#64748B` typography. Subtle grid borders (`#CBD5E1` / `#E2E8F0`). Alternating rows use pearl shading (`#F8FAFC`).
49
+ - **Executive Callout Boxes**: Light tinted fill (`#F8FAFC`) with a 4-color gradient accent bar along the left edge.
30
50
  - **Strict Zero Watermark Invariant**: Under NO circumstances should generated, styled, or compiled PDFs include watermarks, diagonal background stamps ("DRAFT", "CONFIDENTIAL", "SAMPLE"), translucent overlay text, or evaluation markings. All pages must be crisp, unblemished, executive-class documents.
31
51
  - **Metadata Scrubbing**: Author, Title, and Subject fields must be sanitized to human executive attributes; automated generator tags (e.g. `ReportLab PDF Library`, `WeasyPrint`) must be purged.
52
+ - **Mandatory Kage Review Gate**: Every generated PDF document must undergo Kage review before completion.
32
53
 
33
54
  ---
34
55
 
35
56
  ## 2. Professional Color Palettes (Pure Light Mode)
36
57
 
37
- | Element | Executive Slate & Sapphire (Default) | Forest & Mint Finance | Modern Azure Tech |
38
- |---|---|---|---|
39
- | **Page Background** | Pure White `#FFFFFF` | Pure White `#FFFFFF` | Pure White `#FFFFFF` |
40
- | **Body Typography** | Deep Slate `#1E293B` | Deep Slate `#1E293B` | Charcoal `#334155` |
41
- | **Headings** | Midnight Slate `#0F172A` | Deep Spruce `#064E3B` | Deep Navy `#0C4A6E` |
42
- | **3-Color Accent Gradient** | Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA` | Pine `#047857` → Teal `#0D9488` → Mint `#34D399` | Cobalt `#1D4ED8` → Blue `#3B82F6` → Ice `#93C5FD` |
43
- | **Table Header Fill** | Executive Tint `#F1F5F9` | Sage Tint `#ECFDF5` | Azure Tint `#F0F9FF` |
44
- | **Table Header Text** | Bold Slate `#0F172A` | Bold Spruce `#064E3B` | Bold Navy `#0C4A6E` |
45
- | **Callout Background** | Soft Slate `#F8FAFC` | Soft Sage `#F0FDF4` | Soft Sky `#F0F9FF` |
58
+ Never use black, dark gray, dark blue, or dark theme fills. Use refined business-class light palettes with text in medium slate `#64748B`:
59
+
60
+ | Element | Specification & Values |
61
+ |---|---|
62
+ | **Page Background** | Pure White `#FFFFFF` or Soft Pearl `#FAFAFA` |
63
+ | **Typography (Headings & Body)** | Medium Slate `#64748B` (Inter font exclusively) |
64
+ | **4-Base-Color Accent Gradient** | 4-base-color gradient ribbon matching chosen theme (T01–T20) |
65
+ | **Table Header Fill** | Executive Light Tint `#F1F5F9` |
66
+ | **Table Header Text** | Medium Slate `#64748B` (Bold) |
67
+ | **Table Cell Borders** | Subtle Light Slate `#CBD5E1` / `#E2E8F0` |
68
+ | **Alternating Rows** | Soft Pearl `#F8FAFC` |
69
+ | **Callout Background** | Soft Slate `#F8FAFC` with 4-color left border accent |
46
70
 
47
71
  ---
48
72
 
@@ -88,22 +112,26 @@ class NumberedCanvas(canvas.Canvas):
88
112
  if self._pageNumber > 1:
89
113
  self.drawString(54, 11 * inch - 36, "Konoha Infrastructure Engineering · Architecture Audit")
90
114
  self.drawRightString(8.5 * inch - 54, 11 * inch - 36, "Q3 Production Performance")
91
- # 3-Color Gradient Running Header Accent Ribbon
92
- self.setFillColor(colors.HexColor("#1E3A8A"))
93
- self.rect(54, 11 * inch - 42, 170, 2, fill=True, stroke=False)
94
- self.setFillColor(colors.HexColor("#2563EB"))
95
- self.rect(224, 11 * inch - 42, 170, 2, fill=True, stroke=False)
96
- self.setFillColor(colors.HexColor("#60A5FA"))
97
- self.rect(394, 11 * inch - 42, 110, 2, fill=True, stroke=False)
115
+ # 4-Base-Color Gradient Running Header Accent Ribbon (Theme T01)
116
+ self.setFillColor(colors.HexColor("#8A4FD0"))
117
+ self.rect(54, 11 * inch - 42, 125, 2, fill=True, stroke=False)
118
+ self.setFillColor(colors.HexColor("#E8453C"))
119
+ self.rect(179, 11 * inch - 42, 125, 2, fill=True, stroke=False)
120
+ self.setFillColor(colors.HexColor("#F08A24"))
121
+ self.rect(304, 11 * inch - 42, 125, 2, fill=True, stroke=False)
122
+ self.setFillColor(colors.HexColor("#F7C948"))
123
+ self.rect(429, 11 * inch - 42, 75, 2, fill=True, stroke=False)
98
124
 
99
125
  # Footer (all pages)
100
- # 3-Color Gradient Running Footer Accent Ribbon
101
- self.setFillColor(colors.HexColor("#1E3A8A"))
102
- self.rect(54, 46, 170, 1.5, fill=True, stroke=False)
103
- self.setFillColor(colors.HexColor("#2563EB"))
104
- self.rect(224, 46, 170, 1.5, fill=True, stroke=False)
105
- self.setFillColor(colors.HexColor("#60A5FA"))
106
- self.rect(394, 46, 110, 1.5, fill=True, stroke=False)
126
+ # 4-Base-Color Gradient Running Footer Accent Ribbon (Theme T01)
127
+ self.setFillColor(colors.HexColor("#8A4FD0"))
128
+ self.rect(54, 46, 125, 1.5, fill=True, stroke=False)
129
+ self.setFillColor(colors.HexColor("#E8453C"))
130
+ self.rect(179, 46, 125, 1.5, fill=True, stroke=False)
131
+ self.setFillColor(colors.HexColor("#F08A24"))
132
+ self.rect(304, 46, 125, 1.5, fill=True, stroke=False)
133
+ self.setFillColor(colors.HexColor("#F7C948"))
134
+ self.rect(429, 46, 75, 1.5, fill=True, stroke=False)
107
135
 
108
136
  self.drawString(54, 32, "Confidential · Internal Executive Review Only")
109
137
  page_str = f"Page {self._pageNumber} of {page_count}"
@@ -129,7 +157,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
129
157
  fontName='Helvetica-Bold',
130
158
  fontSize=24,
131
159
  leading=30,
132
- textColor=colors.HexColor("#0F172A"),
160
+ textColor=colors.HexColor("#64748B"),
133
161
  spaceAfter=8
134
162
  )
135
163
  subtitle_style = ParagraphStyle(
@@ -138,7 +166,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
138
166
  fontName='Helvetica',
139
167
  fontSize=12,
140
168
  leading=16,
141
- textColor=colors.HexColor("#475569"),
169
+ textColor=colors.HexColor("#64748B"),
142
170
  spaceAfter=20
143
171
  )
144
172
  body_style = ParagraphStyle(
@@ -147,7 +175,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
147
175
  fontName='Helvetica',
148
176
  fontSize=10,
149
177
  leading=14,
150
- textColor=colors.HexColor("#1E293B"),
178
+ textColor=colors.HexColor("#64748B"),
151
179
  spaceAfter=10
152
180
  )
153
181
 
@@ -183,7 +211,7 @@ def build_executive_pdf(output_path="executive_report.pdf"):
183
211
  t = Table(table_data, colWidths=[150, 110, 110, 134])
184
212
  t.setStyle(TableStyle([
185
213
  ('BACKGROUND', (0, 0), (-1, 0), colors.HexColor("#F1F5F9")),
186
- ('TEXTCOLOR', (0, 0), (-1, 0), colors.HexColor("#0F172A")),
214
+ ('TEXTCOLOR', (0, 0), (-1, 0), colors.HexColor("#64748B")),
187
215
  ('BOTTOMPADDING', (0, 0), (-1, -1), 6),
188
216
  ('TOPPADDING', (0, 0), (-1, -1), 6),
189
217
  ('GRID', (0, 0), (-1, -1), 0.5, colors.HexColor("#CBD5E1")),
@@ -227,32 +255,32 @@ For environments leveraging HTML-to-PDF compilation via `weasyprint`, use strict
227
255
  }
228
256
  @bottom-right {
229
257
  content: "Page " counter(page) " of " counter(pages);
230
- font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
258
+ font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
231
259
  font-size: 8pt;
232
260
  font-weight: bold;
233
- color: #0F172A;
261
+ color: #64748B;
234
262
  }
235
263
  }
236
264
 
237
265
  body {
238
- font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
239
- color: #1E293B;
266
+ font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
267
+ color: #64748B;
240
268
  background-color: #FFFFFF;
241
269
  line-height: 1.5;
242
270
  font-size: 10pt;
243
271
  }
244
272
 
245
- /* 3-Color Minimum Gradient Accent Ribbon */
273
+ /* 4-Base-Color Theme Gradient Accent Ribbon (Theme T01) */
246
274
  .gradient-bar {
247
275
  height: 4px;
248
- background: linear-gradient(90deg, #1E3A8A 0%, #2563EB 50%, #60A5FA 100%);
276
+ background: linear-gradient(90deg, #8A4FD0 0%, #E8453C 33%, #F08A24 66%, #F7C948 100%);
249
277
  margin-bottom: 24px;
250
278
  border-radius: 2px;
251
279
  }
252
280
 
253
281
  h1 {
254
282
  font-size: 22pt;
255
- color: #0F172A;
283
+ color: #64748B;
256
284
  margin: 0 0 6px 0;
257
285
  font-weight: 700;
258
286
  }
@@ -271,7 +299,7 @@ table {
271
299
 
272
300
  th {
273
301
  background-color: #F1F5F9;
274
- color: #0F172A;
302
+ color: #64748B;
275
303
  font-weight: 600;
276
304
  text-align: left;
277
305
  padding: 8px 12px;
@@ -282,6 +310,7 @@ th {
282
310
  td {
283
311
  padding: 8px 12px;
284
312
  border: 1px solid #E2E8F0;
313
+ color: #64748B;
285
314
  font-size: 9pt;
286
315
  }
287
316
 
@@ -304,9 +333,12 @@ tr:nth-child(even) td {
304
333
  ## 5. Delivery & Verification Checklist
305
334
 
306
335
  Before releasing any executive PDF document:
307
- 1. **Zero Dark Theme Invariant**: Every page must have a pure white (`#FFFFFF`) or pearl (`#FAFAFA`) background. Zero dark covers, headers, or fills.
308
- 2. **3-Color Minimum Gradient Invariant**: Running header/footer ribbons, cover accents, or decorative dividers must use at least 3 gradient stops (e.g. Sapphire `#1E3A8A` → Azure `#2563EB` → Sky `#60A5FA`).
309
- 3. **Table Header Fills**: Executive light tint (`#F1F5F9` or `#E2E8F0`) with crisp high-contrast dark text (`#0F172A`).
310
- 4. **Dynamic Pagination**: Footers must display dynamic `Page X of Y` computed over the actual document length.
311
- 5. **No Overflow / Clipping**: Verify tables and text blocks fit within page margins without trailing orphans or text clipping.
312
- 6. **Metadata Sanitization**: Check PDF properties with `pdfinfo` or Adobe Reader to ensure generator tags (`ReportLab`, `WeasyPrint`) are replaced with professional author and organization names.
336
+ 1. **Strict Light Mode & Zero Black/Dark Invariant**: Every page must have a pure white (`#FFFFFF`) or pearl (`#FAFAFA`) background. Zero black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds).
337
+ 2. **Medium Slate `#64748B` Typography**: All typography strictly in `#64748B`.
338
+ 3. **Inter Typography Contract**: Inter font strictly used for headings and body.
339
+ 4. **4-Base-Color Theme Gradient**: Running header/footer ribbons, cover accents, or decorative dividers must use a 4-base-color gradient matching one of the 20 canonical themes (T01–T20) consistently.
340
+ 5. **Table Header Fills**: Executive light tint (`#F1F5F9`) with medium slate `#64748B` text and subtle `#CBD5E1` borders.
341
+ 6. **Dynamic Pagination**: Footers must display dynamic `Page X of Y` computed over the actual document length.
342
+ 7. **No Overflow / Clipping**: Verify tables and text blocks fit within page margins without trailing orphans or text clipping.
343
+ 8. **Metadata Sanitization**: Check PDF properties with `pdfinfo` or Adobe Reader to ensure generator tags (`ReportLab`, `WeasyPrint`) are replaced with professional author and organization names.
344
+ 9. **Mandatory Kage Review Gate**: Always run Kage review to verify zero-slop compliance, visual hierarchy, and 0% AI detection before delivery.
@@ -21,8 +21,29 @@ Use this reference whenever building, modifying, or styling presentations and sl
21
21
  ## 1. Zero-AI Slide Design Invariants
22
22
 
23
23
  When creating slide presentations:
24
- - **Strict Light Mode Invariant (Zero Dark Theme Style)**: Under NO circumstances generate, style, or refine slides with dark theme style. Dark slide backgrounds, black title slides, dark hero covers, dark header bars, and near-black card fills are STRICTLY FORBIDDEN. All slides must use pure white (`#FFFFFF`) or soft pearl white (`#F8FAFC`).
25
- - **3-Color Minimum Gradient for Covers, Headers, & Footers**: When visual color or decorative emphasis is needed for title slide covers, header bands, footer accents, or card divider rules, ALWAYS create a smooth multi-stop gradient with a MINIMUM of 3 colors (e.g. Executive Sapphire `#1E3A8A` → `#2563EB` → `#60A5FA`, Teal-to-Cyan-to-Mint `#0D9488` → `#06B6D4` → `#6EE7B7`, or Sunrise Amber `#9A3412` → `#F59E0B` → `#FDE68A`). Never use dark gradients or single flat dark blocks.
24
+ - **Strict Light Mode & Zero Black/Dark Invariant**: Under NO circumstances generate, style, or refine slides with black, dark gray, or dark blue anywhere (text, fills, lines, backgrounds). Strictly forbidden: `#000000`, `#000`, dark navy, dark slate (`#0F172A`, `#1E293B`, `#1E3A8A`), or dark blocks. All slides must use pure white (`#FFFFFF`) or pearl (`#F8FAFC`), with text strictly in **medium slate `#64748B`**.
25
+ - **20 Canonical 4-Base-Color Themes**: When decorative color or visual emphasis is needed for title covers, headers, footers, card accent strips, or divider rules, ALWAYS apply a smooth **4-base-color gradient**, randomly selecting ONE of the 20 canonical themes (T01–T20) per deck and keeping it consistent throughout:
26
+ - **T01**: `linear-gradient(90deg,#8A4FD0,#E8453C,#F08A24,#F7C948)`
27
+ - **T02**: `linear-gradient(90deg,#17B3A3,#3A8DDE,#8A4FD0,#E85DA0)`
28
+ - **T03**: `linear-gradient(90deg,#34B38A,#F7C948,#F08A24,#E85DA0)`
29
+ - **T04**: `linear-gradient(90deg,#3A8DDE,#17B3A3,#6FCF7A,#F7C948)`
30
+ - **T05**: `linear-gradient(90deg,#8A4FD0,#D6459E,#E8453C,#F5A04A)`
31
+ - **T06**: `linear-gradient(90deg,#5CC46A,#F7C948,#F08A24,#E8453C)`
32
+ - **T07**: `linear-gradient(90deg,#4F8DF0,#8A4FD0,#E85DA0,#F5A04A)`
33
+ - **T08**: `linear-gradient(90deg,#17B3A3,#6FCF7A,#F7C948,#F2705F)`
34
+ - **T09**: `linear-gradient(90deg,#3AA6C9,#8A4FD0,#E85DA0,#F7C948)`
35
+ - **T10**: `linear-gradient(90deg,#3A8DDE,#52D1BC,#8BCB4A,#F5A623)`
36
+ - **T11**: `linear-gradient(90deg,#8A4FD0,#E85DA0,#F2705F,#F7C948)`
37
+ - **T12**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#E85D75)`
38
+ - **T13**: `linear-gradient(90deg,#4F8DF0,#D6459E,#E85D75,#F5A04A)`
39
+ - **T14**: `linear-gradient(90deg,#8A4FD0,#3A8DDE,#17B3A3,#8BCB4A)`
40
+ - **T15**: `linear-gradient(90deg,#E85DA0,#E8453C,#F08A24,#8BCB4A)`
41
+ - **T16**: `linear-gradient(90deg,#7C5CE0,#3A8DDE,#52D1BC,#6FCF7A)`
42
+ - **T17**: `linear-gradient(90deg,#E8453C,#F08A24,#F7C948,#8BCB4A)`
43
+ - **T18**: `linear-gradient(90deg,#3A8DDE,#8A4FD0,#D6459E,#F2705F)`
44
+ - **T19**: `linear-gradient(90deg,#17B3A3,#8BCB4A,#F7C948,#F08A24)`
45
+ - **T20**: `linear-gradient(90deg,#E85DA0,#F08A24,#F7C948,#17B3A3)`
46
+ - **Strict Typography Contract**: PowerPoint strictly uses **Segoe UI Semibold or Georgia (headings) + Segoe UI or Calibri (body)** with consistent spacing, alignment, and visual hierarchy.
26
47
  - **The "Rule of One"**: Exactly 1 central thesis or key takeaway per slide.
27
48
  - **Strict Ban on AI Bullet Walls**: Never write slides with 4–6 generic bullet points of identical sentence length.
28
49
  - *Bad (AI)*: 5 bullets each starting with "Ensures that...", "Facilitates...", "Helps to optimize..."
@@ -30,8 +51,9 @@ When creating slide presentations:
30
51
  - **Stat Callouts as Visuals**: When presenting performance, savings, or metrics, render the number in massive 44–60pt bold font with a concise 12pt label below it.
31
52
  - **Asymmetric 2-Column Layouts**: Use 60/40 or 70/30 split layouts (e.g. left side big takeaway and key metrics, right side data table or architectural diagram).
32
53
  - **16:9 Widescreen Standard**: Always format for 16:9 widescreen (`layout: 'LAYOUT_16x9'` in pptxgenjs; `slide_width = Inches(13.333)`, `slide_height = Inches(7.5)` in python-pptx).
33
- - **Strict Zero Watermark Invariant**: Under NO circumstances should presentation slide decks contain watermarks, translucent "CONFIDENTIAL" / "DRAFT" diagonal stamps, or background evaluation watermarks.
54
+ - **Strict Zero Watermark Invariant**: Under NO circumstances should presentation slide decks contain watermarks, translucent stamps, or background evaluation watermarks.
34
55
  - **Metadata Scrubbing**: Set core presentation properties (`creator`, `lastModifiedBy`, `title`) to the human author or project name; remove `python-pptx` and `pptxgenjs` tags.
56
+ - **Mandatory Kage Review Gate**: Always use Kage review on every generated PPTX presentation.
35
57
 
36
58
  ---
37
59