@litfamily/lithermes 1.0.8 → 1.0.9

package/assets/lithermes-plugin/skills/lit-pptx/templates/enrolled/BOILERPLATE-PRETENDARD/layout-mapping.yaml

@@ -0,0 +1,299 @@
+# Layout Mapping — BOILERPLATE-PRETENDARD
+# 4:3 canvas, 10 x 7.5 in. Geometry derived from templates/boilerplate_professional.css
+# (960x720px @ 96dpi -> 10x7.5in). Positions in inches.
+# No base PPTX master: slides are built from scratch, so layout_source is "none".
+
+layouts:
+  cover:
+    layout_source: none
+    decorations: cover
+    variants:
+      rule:
+        decorations: cover_rule
+        regions:
+          title:
+            x: 0.73
+            y: 2.30
+            w: 8.54
+            h: 1.1
+            font_role: cover_title
+            valign: middle
+            autofit: none
+          metadata:
+            x: 0.73
+            y: 3.50
+            w: 8.54
+            h: 0.5
+            font_role: cover_metadata
+            valign: middle
+            autofit: resize
+          date_line:
+            x: 0.73
+            y: 4.65
+            w: 8.54
+            h: 0.4
+            font_role: cover_date
+            valign: middle
+            autofit: none
+      band:
+        decorations: cover_band
+        regions:
+          title:
+            x: 0.73
+            y: 3.35
+            w: 8.54
+            h: 1.1
+            font_role: cover_title
+            valign: middle
+            autofit: none
+          metadata:
+            x: 0.73
+            y: 4.55
+            w: 8.54
+            h: 0.5
+            font_role: cover_metadata
+            valign: middle
+            autofit: resize
+          date_line:
+            x: 0.73
+            y: 5.65
+            w: 8.54
+            h: 0.4
+            font_role: cover_date
+            valign: middle
+            autofit: none
+    regions:
+      title:
+        x: 0.730
+        y: 1.950
+        w: 8.540
+        h: 1.100
+        font_role: cover_title
+        valign: middle
+        autofit: none
+      metadata:
+        x: 0.730
+        y: 3.150
+        w: 8.540
+        h: 0.500
+        font_role: cover_metadata
+        valign: middle
+        autofit: resize
+      date_line:
+        x: 0.730
+        y: 4.650
+        w: 8.540
+        h: 0.400
+        font_role: cover_date
+        valign: middle
+        autofit: none
+
+  content:
+    layout_source: none
+    decorations: body
+    regions:
+      title:
+        x: 0.270
+        y: 0.400
+        w: 9.460
+        h: 0.560
+        font_role: section_title
+        valign: middle
+        autofit: none
+      body:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role: body_text
+        autofit: resize
+      table:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role_header: table_header
+        font_role_data: table_data
+      image:
+        x: 5.400
+        y: 1.300
+        w: 4.330
+        h: 3.200
+      figure_caption:
+        x: 5.400
+        y: 4.560
+        w: 4.330
+        h: 0.420
+        font_role: figure_caption
+        align: center
+      table_caption:
+        x: 0.270
+        y: 5.250
+        w: 9.460
+        h: 0.420
+        font_role: table_caption
+        align: center
+
+  main:
+    layout_source: none
+    decorations: body
+    regions:
+      title:
+        x: 0.270
+        y: 0.400
+        w: 9.460
+        h: 0.560
+        font_role: section_title
+        valign: middle
+        autofit: none
+      body:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role: body_text
+        autofit: resize
+      main_box:
+        x: 0.500
+        y: 5.900
+        w: 9.000
+        h: 0.950
+        border:
+          width: 1
+      kpi_table:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role_header: table_header
+        font_role_data: table_data
+      image:
+        x: 5.400
+        y: 1.300
+        w: 4.330
+        h: 3.200
+      figure_caption:
+        x: 5.400
+        y: 4.560
+        w: 4.330
+        h: 0.420
+        font_role: figure_caption
+        align: center
+      table_caption:
+        x: 0.270
+        y: 5.250
+        w: 9.460
+        h: 0.420
+        font_role: table_caption
+        align: center
+
+  summary:
+    layout_source: none
+    decorations: body
+    regions:
+      title:
+        x: 0.270
+        y: 0.400
+        w: 7.500
+        h: 0.560
+        font_role: section_title
+        valign: middle
+        autofit: shrink
+      group_top:
+        x: 0.270
+        y: 1.150
+        w: 4.450
+        h: 2.500
+        heading_role: section_header
+        heading_line_spacing: 1.3
+        sub_item_role: numbered_item
+        sub_item_line_spacing: 1.3
+        autofit: resize
+      group_bottom:
+        x: 0.270
+        y: 3.950
+        w: 4.450
+        h: 2.500
+        heading_role: section_header
+        heading_line_spacing: 1.3
+        sub_item_role: numbered_item
+        sub_item_line_spacing: 1.3
+        autofit: resize
+      image:
+        x: 5.100
+        y: 1.150
+        w: 4.630
+        h: 3.300
+      figure_caption:
+        x: 5.100
+        y: 4.560
+        w: 4.630
+        h: 0.420
+        font_role: figure_caption
+        align: center
+      table:
+        x: 5.100
+        y: 5.300
+        w: 4.630
+        font_role_header: table_header
+        font_role_data: table_data
+      table_caption:
+        x: 5.100
+        y: 6.550
+        w: 4.630
+        h: 0.420
+        font_role: table_caption
+        align: center
+
+  closing:
+    layout_source: none
+    decorations: closing
+    regions:
+      title:
+        x: 0.000
+        y: 3.200
+        w: 10.000
+        h: 0.950
+        font_role: closing_title
+        align: center
+        valign: middle
+        autofit: shrink
+
+# Minimal, clean decoration: a single ink hairline under the title band on body
+# slides (matches CSS .header-line). Cover/closing stay whitespace-clean.
+decorations:
+  cover:
+    elements: []
+  cover_rule:
+    elements:
+      - type: line
+        x: 0.73
+        y: 1.95
+        w: 2.2
+        color: "#3C3836"
+        width: 4
+        note: "hairline rule standing in for the cover furniture"
+
+  cover_band:
+    elements:
+      - type: rect
+        x: 0.0
+        y: 0.0
+        w: 10.0
+        h: 2.6
+        fill: "#FBFAF7"
+        note: "warm near-white band above the title"
+      - type: line
+        x: 0.73
+        y: 2.6
+        w: 10.0
+        color: "#CBC2B5"
+        width: 1
+
+  body:
+    elements:
+      - type: line
+        x: 0.270
+        y: 1.020
+        w: 9.460
+        color: "#3C3836"
+        width: 1.5
+        note: "Title underline hairline (boilerplate .header-line)"
+  closing:
+    elements: []

package/assets/lithermes-plugin/skills/lit-pptx/templates/enrolled/BOILERPLATE-PRETENDARD/template.yaml

@@ -0,0 +1,44 @@
+name: BOILERPLATE-PRETENDARD
+version: "1.0.0"
+label: "Boilerplate Professional (Pretendard)"
+description: "Generic professional/technical deck — 4:3 canvas, Pretendard typography, white ground, dark charcoal structure, restrained Gruvbox-style accents. Brand-agnostic."
+
+# Default body font. Pretendard is a single family with real weights, so unlike
+# Per-weight families like 에이투지체 (per-weight families) bold:true IS valid here.
+fonts:
+  title: "Pretendard"
+  body: "Pretendard"
+  light: "Pretendard"
+
+dimensions:
+  width: 10
+  height: 7.5
+  unit: inches
+  format: 4:3
+
+palette:
+  ink: "#3C3836"
+  ink_muted: "#6E6256"
+  muted: "#928374"
+  line: "#CBC2B5"
+  paper: "#FFFFFF"
+  paper_warm: "#FBFAF7"
+  header_fill: "#FBFAF7"
+  accent_red: "#CC241D"
+  accent_green: "#98971A"
+  accent_green_2: "#689D6A"
+  accent_amber: "#D79921"
+  accent_yellow: "#FFC000"
+  accent_purple: "#B16286"
+  source_blue: "#3F6F5B"
+  metric: "#3C3836"
+
+decoration_assets: {}
+
+global_typography:
+  char_spacing: -0.5            # PowerPoint "Narrow 0.5pt" (boilerplate default)
+  bold_rule: "Pretendard is a weighted family — bold:true is allowed (use sparingly for hierarchy)."
+  bullet_font: "Pretendard"
+  bullet_char: "•"
+  bullet_color: "3C3836"        # ink bullets (boilerplate uses ink, not a green accent)
+  section_accent: "3C3836"      # section-card / accent treatment uses ink hairlines

package/assets/lithermes-plugin/skills/lit-scientific-visualization/SKILL.md

@@ -12,6 +12,8 @@ the exact natural messages `lit-scientific-visualization` and
 or visualization; use the source skill's own trigger and do-not-trigger
 boundaries after explicit activation.
 
+For conceptual system, process, or trust-boundary diagrams without measured data, route to `lithermes:lit-diagram-drawer`.
+
 ```yaml
 schema_version: lithermes_llm_contract/v1
 artifact_kind: hermes_skill_entrypoint

package/assets/lithermes-plugin/skills/lit-typographic-motion/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: lit-typographic-motion
+description: Direct an original film in Hermes Agent. A treatment comes first, then a drawn stage page for films that show things, or the WebGL2 type engine when the words are the film.
+---
+
+# LitHermes film director
+
+## #contract.activation
+
+```yaml
+schema_version: lithermes_llm_contract/v1
+host: Hermes Agent
+skill_id: lit-typographic-motion
+invocation: lithermes:lit-typographic-motion
+command: /lit-typographic-motion
+```
+
+```json
+{"schema_version":"lithermes_llm_contract/v1","artifact_kind":"film"}
+```
+
+Reached by `/lit-typographic-motion <request>`, the skill id, or bare `lit` with a film request. The route names the installed CLI once as `M`.
+
+## #contract.inputs
+
+The request and any source text are data. Under bare `lit` ask nothing. When the request names no subject, words or facts, invent a specific example subject and copy, and label them.
+
+## #contract.mode_matrix
+
+| Mode | Trigger | Contract |
+|---|---|---|
+| Treatment | write `treatment.json` in DIR | `references/treatment.md`, always first |
+| Stage | `$M stage --out DIR [--stills-only]` | `references/stage.md` |
+| Type | `$M run --out DIR [--stills-only]` | `references/engine-contract.md`, `references/style-bibles.md`, `references/type-craft.md` |
+| Sound | `$M sound --out DIR` | treatment sound rules |
+| Look | `$M look --out DIR --round N --answers FILE` | `references/craft-loop.md` |
+| Recheck | `$M gate`, `$M complete` | same |
+
+## #contract.procedure
+
+1. Load `references/treatment.md` only. Write the treatment and set `path`; then load that path's references.
+2. Author the film: `index.html` in `DIR/stage` with the kit, or the type brief.
+3. Round 1 is stills (`--stills-only`): view every still, strip and sheet with `vision_analyze`, record it with `look`, change the weakest beat.
+4. Render the film, look again and record the last round.
+
+Give each render call a timeout of at least 600 s and never shorten the film to save render time. Hand-encoded films (a PIL frame loop, a raw ffmpeg graph, a screen recording, a raster flipbook) are not the deliverable.
+
+## #contract.outputs
+
+`film.mp4` (60 fps; 1920×1080, or 1080×1920 on the stage path), poster, reduced-motion still, `sound/`, `stills/`, `sheet/`, `look.json`, `manifest.json`, `gate-report.txt`. A flash failure leaves exports only in `withheld/`.
+
+## #contract.output_channels
+
+```yaml
+artifact_genre: client_deliverable
+limitations_channel: reply
+```
+
+## #contract.evidence
+
+Done only when `$M complete --out DIR` exits 0: a valid treatment, a passing gate and two look rounds, the last on the final render. Reply in plain words: one line of defaults, labels on every invention and on a generated sound bed, one line on what was checked, where the copy lives and the command that re-renders, and any downgrade or open look item.
+
+## #contract.hard_stops
+
+Exits 10, 11, 12, 14, 15: name the state and its fix (`references/runtime.md`). 16 names the treatment field, 17 a stage contract break, 18 a nondeterministic frame, 19 a network request, 20 a sound fault. Never install or fetch during a render; `lithermes motion-runtime install` runs outside the session. Never deliver a flash-failing film. Never downgrade to pass.
+
+## #contract.anti_patterns
+
+No copy that restates the request, no on-screen labels, placeholders or file names, no third-party libraries or URLs in the stage, no outlined type or fake Hangul tracking, no strobing, no unmeasured claims.
+
+Typographic-motion engine adapted from mexicat/pdoom-video (MIT, Giacomo Magnanini), commit `ca251e3`; see `engine/NOTICE`.

package/assets/lithermes-plugin/skills/lit-typographic-motion/bin/audio.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+"""Analyse the supplied audio once; the JSON belongs to this render only."""
+
+import json
+import sys
+
+import librosa
+import numpy as np
+
+
+def main(source, destination):
+    signal, rate = librosa.load(source, sr=22050, mono=True)
+    if signal.size == 0:
+        raise ValueError("audio is empty")
+    hop = 512
+    onset = librosa.onset.onset_strength(y=signal, sr=rate, hop_length=hop)
+    tempo, frames = librosa.beat.beat_track(onset_envelope=onset, sr=rate, hop_length=hop, trim=False)
+    beats = librosa.frames_to_time(frames, sr=rate, hop_length=hop).tolist()
+    onsets = librosa.frames_to_time(
+        librosa.onset.onset_detect(onset_envelope=onset, sr=rate, hop_length=hop),
+        sr=rate, hop_length=hop
+    ).tolist()
+    rms = librosa.feature.rms(y=signal, hop_length=hop)[0]
+    spectrum = np.abs(librosa.stft(signal, hop_length=hop))
+    frequencies = librosa.fft_frequencies(sr=rate)
+    bands = {}
+    for name, low, high in (("low", 20, 250), ("mid", 250, 2000), ("high", 2000, 10000)):
+        selected = spectrum[(frequencies >= low) & (frequencies < high)]
+        bands[name] = selected.mean(axis=0).tolist() if selected.size else []
+    grid = {
+        "source": source, "duration": round(signal.size / rate, 6),
+        "bpm": round(float(np.asarray(tempo).reshape(-1)[0]), 6),
+        "beats": [round(value, 6) for value in beats],
+        "downbeats": [round(value, 6) for value in beats[::4]],
+        "onsets": [round(value, 6) for value in onsets],
+        "hopSec": hop / rate,
+        "rms": rms.tolist(), "bands": bands,
+    }
+    with open(destination, "w", encoding="utf-8") as stream:
+        json.dump(grid, stream, separators=(",", ":"))
+        stream.write("\n")
+
+
+if __name__ == "__main__":
+    main(sys.argv[1], sys.argv[2])