litclaude-ai 0.3.39 → 0.3.40

package/CHANGELOG.md

@@ -17,7 +17,15 @@
   tools, so the harness read-before-write guard never sees them — copying an
   example literally could clobber a file in the user's working directory.
 
-## Unreleased — `lit-comprehend` explainer artifacts
+## Unreleased — output styles enrollment and `lit-comprehend` explainer artifacts
+
+- Add output styles enrollment to the installer: a `chooseOutputStyle` prompt
+  (mirroring `chooseHudAccent`) lets users pick `off`, `asd-ste100`,
+  `asd-ste100-ko`, `eli5`, or `eli5-ko` on every install run, defaulted from
+  the prior choice. The installer writes `settings.outputStyle` clobber-safely —
+  skipping the write and printing a note when the field was changed outside
+  LitClaude — and tracks `outputStyleChoice`/`outputStyleWrittenName` under
+  the `litclaude` settings key for idempotent reinstall defaulting.
 
 - Add the `lit-comprehend` skill, the `/litclaude:lit-comprehend` command, and the
   `lit-comprehend` / `comprehend` / `lit comprehend` / `$lit-comprehend` /

package/README.md

@@ -9,7 +9,7 @@
 </p>
 <p align="center">
   <img src="https://img.shields.io/badge/npm-litclaude--ai-cb3837" />
-  <img src="https://img.shields.io/badge/version-0.3.39-2ea44f" />
+  <img src="https://img.shields.io/badge/version-0.3.40-2ea44f" />
   <img src="https://img.shields.io/badge/Claude%20Code-plugin-blueviolet" />
   <img src="https://img.shields.io/badge/license-MIT-blue" />
 </p>
@@ -174,18 +174,18 @@ cd /tmp
 npx --yes litclaude-ai@latest install
 ```
 
-`0.3.39` is the version prepared by this checkout. Registry lookup is authoritative
+`0.3.40` is the version prepared by this checkout. Registry lookup is authoritative
 for whether that exact version can be installed:
 
 ```bash
-npm view litclaude-ai@0.3.39 version
+npm view litclaude-ai@0.3.40 version
 ```
 
-If that lookup returns 0.3.39, the exact install is available:
+If that lookup returns 0.3.40, the exact install is available:
 
 ```bash
 cd /tmp
-npx --yes litclaude-ai@0.3.39 install
+npx --yes litclaude-ai@0.3.40 install
 ```
 
 Otherwise, wait for explicit human publication and repeat the lookup before using
@@ -216,7 +216,7 @@ The installer also sets Claude Code's `statusLine` command to the packaged
 LitClaude HUD. A typical no-color render starts like:
 
 ```text
-[🔥LITCLAUDE v0.3.39] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
+[🔥LITCLAUDE v0.3.40] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
 ```
 
 The `↻` suffix is a compact rate-limit reset countdown. It is separated from

package/README_ko-KR.md

@@ -9,7 +9,7 @@
 </p>
 <p align="center">
   <img src="https://img.shields.io/badge/npm-litclaude--ai-cb3837" />
-  <img src="https://img.shields.io/badge/version-0.3.39-2ea44f" />
+  <img src="https://img.shields.io/badge/version-0.3.40-2ea44f" />
   <img src="https://img.shields.io/badge/Claude%20Code-plugin-blueviolet" />
   <img src="https://img.shields.io/badge/license-MIT-blue" />
 </p>
@@ -183,18 +183,18 @@ cd /tmp
 npx --yes litclaude-ai@latest install
 ```
 
-`0.3.39`은 이 checkout에서 준비 중인 version입니다. exact version의 설치 가능
+`0.3.40`은 이 checkout에서 준비 중인 version입니다. exact version의 설치 가능
 여부에는 registry 조회 결과를 authoritative한 기준으로 사용합니다.
 
 ```bash
-npm view litclaude-ai@0.3.39 version
+npm view litclaude-ai@0.3.40 version
 ```
 
-조회 결과가 0.3.39이면 exact install을 사용할 수 있습니다.
+조회 결과가 0.3.40이면 exact install을 사용할 수 있습니다.
 
 ```bash
 cd /tmp
-npx --yes litclaude-ai@0.3.39 install
+npx --yes litclaude-ai@0.3.40 install
 ```
 
 그렇지 않으면 명시적인 human publication을 기다립니다. 게시 후 조회를 다시 실행해
@@ -225,7 +225,7 @@ installer는 Claude Code의 `statusLine` command도 packaged LitClaude HUD로
 설정합니다. 색상을 제거한 예시는 다음처럼 시작합니다.
 
 ```text
-[🔥LITCLAUDE v0.3.39] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
+[🔥LITCLAUDE v0.3.40] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
 ```
 
 `↻` 표시는 rate-limit reset까지 남은 시간을 짧게 보여주는 countdown입니다.

package/RELEASE_CHECKLIST.md

@@ -1,6 +1,6 @@
 # LitClaude Release Checklist
 
-Status: `litclaude-ai@0.3.39` is the current release candidate — exact canonical
+Status: `litclaude-ai@0.3.40` is the current release candidate — exact canonical
 frontend corpus plus Claude-native `autoresearch`, `autoconference`, and `wikify`
 workflow-family integration. It byte-pins the frontend library, legal companions,
 family source closures, and adapters through independent commitments and package
@@ -45,9 +45,9 @@ side-effect-free, the launcher starts only a separate Claude Code
 print/background worker, and the release preserves the Korean polishing
 command, strict multi-agent review pipeline, fidelity guardrails, package
 hygiene checks, native route gates, and safe start-work handoff behavior.
-`package.json` is aligned to `0.3.39`,
-`plugins/litclaude/.claude-plugin/plugin.json` is aligned to `0.3.39`, and the
-plugin-local MCP server reports `0.3.39`.
+`package.json` is aligned to `0.3.40`,
+`plugins/litclaude/.claude-plugin/plugin.json` is aligned to `0.3.40`, and the
+plugin-local MCP server reports `0.3.40`.
 
 This release carries the v0.2.2 Dynamic workflow hardening surfaces:
 `/dynamic-workflow`, `workflow-check --json`, native `/goal` fallback guidance,
@@ -280,9 +280,9 @@ checkout and from an isolated install of the packed tarball:
 Before requesting publication approval, confirm these artifacts from the current
 checkout:
 
-- `package.json` version is `0.3.39`.
-- `plugins/litclaude/.claude-plugin/plugin.json` version is `0.3.39`.
-- `plugins/litclaude/bin/litclaude-mcp.js` reports server version `0.3.39`.
+- `package.json` version is `0.3.40`.
+- `plugins/litclaude/.claude-plugin/plugin.json` version is `0.3.40`.
+- `plugins/litclaude/bin/litclaude-mcp.js` reports server version `0.3.40`.
 - Prompt-hook tests cover bundled `SKILL.md` body injection for bare `hyperplan`, `litresearch`, `lit research`, `init-deep`, and explicit leading `$start-work`; diagnostic/copy mentions stay inert while leading natural-language `lit start work` stays BLOCKED.
 - `lit search` and `lit query` route to `/litclaude:litresearch` without activating on slash mentions, code spans, or non-lit prompts.
 - Litresearch web lanes require public API/feed preference, validator-first checks, route traces, prompt-injection quarantine, and honest auth/paywall/private-data stop reasons.

package/bin/litclaude-ai.js

@@ -100,6 +100,19 @@ const knownExternalLspPlugins = {
 };
 const spinnerFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 const hudAccentThemes = HUD_ACCENT_THEMES;
+const OUTPUT_STYLE_OPTIONS = [
+  { id: "off", label: "None / keep current" },
+  { id: "asd-ste100", label: "ASD-STE100 (English)" },
+  { id: "asd-ste100-ko", label: "ASD-STE100 (한국어)" },
+  { id: "eli5", label: "ELI5 (English)" },
+  { id: "eli5-ko", label: "ELI5 (한국어)" },
+];
+const OUTPUT_STYLE_NAMES = {
+  "asd-ste100": "LitClaude — ASD-STE100",
+  "asd-ste100-ko": "LitClaude — ASD-STE100 (한국어)",
+  "eli5": "LitClaude — ELI5",
+  "eli5-ko": "LitClaude — ELI5 (한국어)",
+};
 const permissionModes = new Set(["safe", "balanced", "yolo"]);
 const permissionOwnershipDescription =
   "preserves pre-existing entries; removes only LitClaude-inserted entries on mode change or uninstall";
@@ -351,6 +364,50 @@ const chooseHudAccent = async (existingAccent = "cyan") => {
   }
 };
 
+const normalizeOutputStyle = (value) => {
+  if (!value) return "off";
+  const v = String(value).trim().toLowerCase();
+  const match = OUTPUT_STYLE_OPTIONS.find((opt) => opt.id === v);
+  return match ? match.id : "off";
+};
+
+const shouldPromptOutputStyle = () => {
+  if (process.env.LITCLAUDE_OUTPUT_STYLE_PROMPT === "1") return true;
+  if (process.env.LITCLAUDE_OUTPUT_STYLE_PROMPT === "0") return false;
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY && !process.env.CI);
+};
+
+const chooseOutputStyle = async (existingChoice = "off") => {
+  const preserved = normalizeOutputStyle(existingChoice);
+  const envStyle = process.env.LITCLAUDE_OUTPUT_STYLE;
+  if (envStyle && process.env.LITCLAUDE_OUTPUT_STYLE_PROMPT !== "1") {
+    return normalizeOutputStyle(envStyle);
+  }
+  if (!shouldPromptOutputStyle()) return envStyle ? normalizeOutputStyle(envStyle) : preserved;
+
+  process.stdout.write("Choose LitClaude output style:\n");
+  for (const [index, option] of OUTPUT_STYLE_OPTIONS.entries()) {
+    process.stdout.write(`  ${index}) ${option.label}\n`);
+  }
+
+  const preservedLabel = OUTPUT_STYLE_OPTIONS.find((opt) => opt.id === preserved)?.label ?? preserved;
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question(`Style 0-4 [${preservedLabel}]: `);
+    const trimmed = answer.trim();
+    const byIndex = OUTPUT_STYLE_OPTIONS[Number.parseInt(trimmed, 10)]?.id;
+    const selected = byIndex !== undefined ? byIndex : (trimmed ? normalizeOutputStyle(trimmed) : preserved);
+    const isExplicitOff = trimmed.toLowerCase() === "off" || trimmed.toLowerCase() === "none";
+    if (trimmed && byIndex === undefined && selected === "off" && !isExplicitOff) {
+      process.stdout.write("OUTPUT_STYLE_WARNING: unknown style; using 'off'\n");
+    }
+    process.stdout.write(`OUTPUT_STYLE_SELECTED: ${selected}\n`);
+    return selected;
+  } finally {
+    rl.close();
+  }
+};
+
 const hudCommandForPlugin = (pluginPath, accent = "cyan") =>
   `LITCLAUDE_HUD_ACCENT=${normalizeHudAccent(accent)} node "${join(pluginPath, "bin", "litclaude-hud.js")}"`;
 
@@ -458,6 +515,30 @@ const installHudStatusLine = (pluginPath, home = claudeHome(), accent = "cyan")
   writeClaudeSettings(settings, home);
 };
 
+const installOutputStyle = (choice, home = claudeHome()) => {
+  if (choice === "off") return;
+  const writtenName = OUTPUT_STYLE_NAMES[choice] ?? null;
+  if (!writtenName) return;
+
+  const settings = readClaudeSettings(home);
+  const existingLitClaude = settings[litClaudeSettingsKey] ?? {};
+  const previousWrittenName = existingLitClaude.outputStyleWrittenName ?? null;
+
+  const currentOutputStyle = settings.outputStyle;
+  if (currentOutputStyle === undefined || currentOutputStyle === previousWrittenName) {
+    settings.outputStyle = writtenName;
+  } else {
+    process.stdout.write(`Note: outputStyle was changed outside LitClaude (currently "${currentOutputStyle}"). Switch it via /config if you want LitClaude's style.\n`);
+  }
+
+  settings[litClaudeSettingsKey] = {
+    ...existingLitClaude,
+    outputStyleChoice: choice,
+    outputStyleWrittenName: writtenName,
+  };
+  writeClaudeSettings(settings, home);
+};
+
 const uninstallHudStatusLine = (home = claudeHome()) => {
   const settingsPath = claudeSettingsPath(home);
   if (!existsSync(settingsPath)) return;
@@ -840,6 +921,7 @@ const install = async ({ dryRun, rest }) => {
   const existingLitClaude = readClaudeSettings(home)[litClaudeSettingsKey] ?? {};
   const { permissionMode, permissionExplicit } = parseInstallOptions(rest, existingLitClaude.permissionMode);
   const existingHudAccent = normalizeHudAccent(existingLitClaude.hudAccent);
+  const existingOutputStyle = existingLitClaude.outputStyleChoice ?? "off";
   const requestedHudAccent = process.env.LITCLAUDE_HUD_ACCENT
     ? normalizeHudAccent(process.env.LITCLAUDE_HUD_ACCENT)
     : existingHudAccent;
@@ -868,6 +950,7 @@ const install = async ({ dryRun, rest }) => {
   }
 
   const hudAccent = await chooseHudAccent(existingHudAccent);
+  const outputStyleChoice = await chooseOutputStyle(existingOutputStyle);
   progress.prepare({ claudeTarget: home, litTarget: litClaudeHome });
   await progress.run(
     {
@@ -901,7 +984,10 @@ const install = async ({ dryRun, rest }) => {
       purpose: "Enable the plugin and HUD, then update global Claude settings permissions.allow/deny",
       target: claudeSettingsPath(home),
     },
-    () => registerClaudePlugin(targetPlugin, localMarketplace, home, hudAccent, permissionMode),
+    () => {
+      registerClaudePlugin(targetPlugin, localMarketplace, home, hudAccent, permissionMode);
+      installOutputStyle(outputStyleChoice, home);
+    },
   );
 
   const litRoot = versionRoot(litClaudeHome);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "litclaude-ai",
-  "version": "0.3.39",
+  "version": "0.3.40",
   "description": "Claude Code-native workflow distribution.",
   "type": "module",
   "bin": {

package/plugins/litclaude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "litclaude",
   "description": "Claude Code-native workflow plugin with a bounded-authority start-work lifecycle.",
-  "version": "0.3.39",
+  "version": "0.3.40",
   "author": {
     "name": "LitClaude contributors"
   },

package/plugins/litclaude/bin/litclaude-mcp.js

@@ -3,7 +3,7 @@
 import { readPublicSource } from "../lib/public-source-reader/reader.mjs";
 
 const protocolVersion = "2024-11-05";
-const serverVersion = "0.3.39";
+const serverVersion = "0.3.40";
 
 const publicSourceReadTool = {
   name: "public_source_read",

package/plugins/litclaude/output-styles/asd-ste100.md

@@ -0,0 +1,46 @@
+---
+name: "LitClaude — ASD-STE100"
+description: Write responses in ASD-STE100 Simplified Technical English — short sentences, active voice, controlled vocabulary, one instruction per step.
+keep-coding-instructions: true
+---
+
+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/plugins/litclaude/output-styles/asd-ste100_ko-KR.md

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

package/plugins/litclaude/output-styles/eli5.md

@@ -0,0 +1,17 @@
+---
+name: "LitClaude — ELI5"
+description: keep it simple pls
+keep-coding-instructions: true
+---
+
+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/plugins/litclaude/output-styles/eli5_ko-KR.md

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