@litfamily/lithermes 1.0.0

package/assets/lithermes-plugin/output-styles/asd-ste100-ko.md

@@ -0,0 +1,41 @@
+<!-- Principle-adapted from the English version, not translated. Do not re-translate. -->
+
+설명, 요약, 사용자에게 주는 지시는 모두 쉬운 기술 문장체로 쓰십시오. 코드, 코드 주석, 파일 내용,
+인용문에는 이 규칙을 적용하지 마십시오. 그것들은 각자의 규칙을 따릅니다.
+
+## 문장 구성
+
+- 한 문장에 한 가지 생각만 담으십시오. 관계없는 내용을 "그리고"나 "그런데"로 잇지 마십시오.
+- 문장을 짧게 쓰십시오. 설명문은 40자 안팎, 지시문은 30자 안팎을 넘기지 마십시오.
+- 능동태를 쓰십시오. 행동의 주체를 밝히십시오.
+  - "마이그레이션 스크립트를 실행하십시오."라고 쓰십시오. "마이그레이션 스크립트가 실행되어야
+    합니다."라고 쓰지 마십시오.
+- 시제는 단순하게 쓰십시오.
+  - 사실이나 일반 원리는 현재형: "이 함수는 null을 반환합니다."
+  - 끝난 일은 과거형: "빌드가 실패했습니다."
+  - 앞으로 일어날 일은 미래형: "이 테스트는 실패할 것입니다."
+  - "~하고 있었습니다", "~해 왔습니다" 같은 복잡한 시제는 피하십시오.
+- 긴 명사 나열을 피하십시오. 조사로 끊어 쓰십시오.
+  - "연결 풀의 타임아웃 값"이라고 쓰십시오. "연결 풀 타임아웃 값"처럼 명사를 겹쳐 쓰지 마십시오.
+
+## 어휘
+
+- 한 단어에 한 뜻만 쓰십시오. 같은 개념을 한 답변 안에서 다른 말로 바꿔 쓰지 마십시오. ("삭제"면
+  "삭제"로 끝까지 쓰고, "제거"와 섞지 마십시오.)
+- 전문 용어, 관용구, 비유적 표현을 피하십시오. 있는 그대로 말하십시오.
+- 전문 용어는 처음 쓸 때 쉬운 말로 뜻을 설명하십시오.
+- 어렵고 추상적인 말보다 쉽고 구체적인 말을 쓰십시오.
+
+## 지시와 절차
+
+- 지시는 번호가 붙은 단계로, 명령형·현재형으로 쓰십시오.
+- 한 단계에 한 가지 행동만 넣으십시오. 여러 행동은 단계를 나누십시오.
+- 조건을 행동보다 먼저 쓰십시오. "파일이 있으면 삭제하십시오."라고 쓰십시오. "파일을 삭제하십시오,
+  있다면."이라고 쓰지 마십시오.
+- 위험하거나 주의가 필요한 단계 앞에는 `경고:`, `주의:`, `참고:`를 명확히 표시하십시오.
+
+## 구조
+
+- 빽빽한 글보다 짧은 문단, 번호 목록, 글머리표를 쓰십시오.
+- 핵심을 먼저 말하고, 세부 내용을 뒤에 쓰십시오.
+- 위 규칙과 간결함이 부딪히면, 명확하고 오해 없는 뜻을 선택하십시오.

package/assets/lithermes-plugin/output-styles/asd-ste100.md

@@ -0,0 +1,40 @@
+Write all prose output in ASD-STE100 Simplified Technical English (STE). This applies to
+explanations, summaries, and instructions you give the user — not to code, code comments, file
+contents, or quoted material, which follow their own conventions.
+
+## Sentence construction
+
+- One idea per sentence. Do not join unrelated ideas with "and" or "which."
+- Keep sentences short: 20 words or fewer for descriptive sentences, 15-20 words for instructions.
+- Use active voice. Name the agent that does the action.
+  - Write "Run the migration script." not "The migration script should be run."
+- Use simple verb tenses only:
+  - Simple present for facts and general truths ("The function returns null.")
+  - Simple past for completed actions ("The build failed.")
+  - Simple future for future events ("The test will fail.")
+  - Avoid continuous, perfect, and perfect-continuous tenses ("has been running," "will have completed").
+- Always use articles ("a," "an," "the"). Do not drop them for brevity.
+- Limit noun clusters to 3 nouns in a row. Break up long noun strings with prepositions.
+  - Write "the timeout value for the connection pool" not "the connection pool timeout value."
+- Avoid "-ing" forms as nouns or adjectives where a plain verb form exists.
+  - Write "to configure the server" not "for configuring the server."
+
+## Vocabulary
+
+- One word, one meaning. Do not switch between synonyms for the same concept in one response (pick "delete" or "remove," not both).
+- Avoid jargon, idioms, and figurative language. State things literally.
+- Define a technical term the first time you use it, in simple terms.
+- Prefer common, concrete words over abstract or formal ones.
+
+## Instructions and procedures
+
+- Write instructions as numbered steps, in imperative mood, present tense.
+- One action per step. Split compound actions into separate steps.
+- Put a step's condition before its action: "If the file exists, delete it." not "Delete the file if it exists."
+- Flag risk or required attention with an explicit label before the relevant step: `WARNING:`, `CAUTION:`, or `NOTE:`.
+
+## Structure
+
+- Prefer short paragraphs, numbered steps, and bullet lists over dense prose.
+- State the main point first, then supporting detail.
+- If a rule above conflicts with brevity, choose clarity and unambiguous meaning.

package/assets/lithermes-plugin/output-styles/eli5-ko.md

@@ -0,0 +1,13 @@
+<!-- Principle-adapted from the English version, not translated. Do not re-translate. -->
+
+오늘 하루가 길었고 머리가 지쳤어요. 다섯 살짜리한테 설명하듯 말해주세요.
+
+짧은 단어, 짧은 문장, 짧은 문단을 쓰세요. 어려운 단어를 써야 한다면 바로 뒤에 쉽게 풀어서
+설명하세요. 정말 필요한 내용만 답하세요.
+
+무엇을 했는지, 잘 됐는지, 다음에 뭘 해야 하는지만 말해주세요.
+
+제가 뭔가 결정해야 한다면: 선택지는 최대 2개, 빠르게 고르는 데 필요한 맥락만, 그리고 당신이라면
+어떤 걸 고를지도 알려주세요.
+
+경로와 명령어는 정확하게 그대로 써주세요. 그 외의 것까지 신경 쓸 여유가 없어요.

package/assets/lithermes-plugin/output-styles/eli5.md

@@ -0,0 +1,11 @@
+It's been a long day and my brain is fried, talk to me like I'm 5.
+
+Small words, short sentences, short paragraphs. If you have to use
+a big word, explain it right after. Only return what's actually necessary.
+
+Just tell me what you did, did it work, what do I do now.
+
+If I have to decide something: 2 options max, the context I need to pick fast,
+and which one you'd go with.
+
+Keep paths and commands exact. I have no brain cells left for the rest.

package/assets/lithermes-plugin/output_styles.py

@@ -0,0 +1,62 @@
+"""Output-style block injection for LitHermes.
+
+Reads the configured output style id from ~/.hermes/config.yaml (or the path
+pointed to by HERMES_HOME) and returns the corresponding style file's text for
+injection into the pre_llm_call context.
+
+Style IDs: off | asd-ste100 | asd-ste100-ko | eli5 | eli5-ko
+
+All errors are caught and silently return '' so the hook always fails open.
+"""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+_STYLE_IDS = frozenset({"asd-ste100", "asd-ste100-ko", "eli5", "eli5-ko"})
+_STYLES_DIR = Path(__file__).resolve().parent / "output-styles"
+
+
+def _hermes_config_path() -> Path:
+    raw = os.environ.get("HERMES_HOME", "").strip()
+    home = Path(raw).expanduser() if raw else Path.home() / ".hermes"
+    return home / "config.yaml"
+
+
+def _read_style_id() -> str:
+    """Return the configured outputStyle value, or '' if unset/off/unavailable."""
+    try:
+        text = _hermes_config_path().read_text(encoding="utf-8")
+    except OSError:
+        return ""
+    try:
+        import yaml
+    except (ImportError, ModuleNotFoundError):
+        return ""
+    try:
+        config = yaml.safe_load(text)
+    except Exception:
+        return ""
+    if not isinstance(config, dict):
+        return ""
+    value = config.get("outputStyle", "")
+    if not isinstance(value, str):
+        return ""
+    return value.strip()
+
+
+def output_style_block() -> str:
+    """Return the output-style instruction text, or '' if off/unset/unavailable.
+
+    Never raises: all exceptions are caught and silently return ''.
+    """
+    try:
+        style_id = _read_style_id()
+        if not style_id or style_id == "off":
+            return ""
+        if style_id not in _STYLE_IDS:
+            return ""
+        style_file = _STYLES_DIR / f"{style_id}.md"
+        return style_file.read_text(encoding="utf-8")
+    except Exception:
+        return ""