litclaude-ai 0.3.21 → 0.3.22

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.3.22 - 2026-07-07 — full lit-family bare invocation release prep
+
+- Prepare `litclaude-ai@0.3.22` for npm publication after extending bare lit-family prompt-hook routes to inject the installed `SKILL.md` body.
+- Keep the safe natural-language `lit start work` BLOCKED handoff while explicit bare skill routes carry full prompt context.
+
 ## 0.3.21 - 2026-07-07 — full bare skill-body routing
 
 - Inject bundled `SKILL.md` bodies for bare `hyperplan`, `litresearch`, `lit research`, `init-deep`, and explicit `$start-work` prompt-hook routes so activation carries the same substantive skill contract as the installed payload.

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.21-2ea44f" />
+  <img src="https://img.shields.io/badge/version-0.3.22-2ea44f" />
   <img src="https://img.shields.io/badge/Claude%20Code-plugin-blueviolet" />
   <img src="https://img.shields.io/badge/license-MIT-blue" />
 </p>
@@ -22,10 +22,10 @@
 > `litclaude@litclaude-ai`, so normal `claude` launches can load the
 > LitClaude skills and hooks without a long `--plugin-dir` command.
 
-This checkout is prepared as `litclaude-ai@0.3.21` for personal install
+This checkout is prepared as `litclaude-ai@0.3.22` for personal install
 convenience. The repo can remain quiet; preparing npm package metadata here does
 not imply public repo promotion, marketplace publication, or advertisement.
-Future package releases still require explicit user approval. The v0.3.21
+Future package releases still require explicit user approval. The v0.3.22
 release materials inject the bundled skill bodies for bare `hyperplan`,
 `litresearch`, `lit research`, `init-deep`, and explicit `$start-work` prompt-hook routes while
 preserving the v0.3.19 adversarial planning skill, the v0.3.18 read-only `lit-recap` session recap surface, the v0.3.17 separate-worker native `/goal` launcher, the v0.3.16
@@ -113,7 +113,7 @@ directory, the normal install command works:
 
 ```bash
 cd /tmp
-npx --yes litclaude-ai@0.3.21 install
+npx --yes litclaude-ai@0.3.22 install
 ```
 
 Validate the installed plugin:
@@ -126,7 +126,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.21] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
+[🔥LITCLAUDE v0.3.22] | 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.21-2ea44f" />
+  <img src="https://img.shields.io/badge/version-0.3.22-2ea44f" />
   <img src="https://img.shields.io/badge/Claude%20Code-plugin-blueviolet" />
   <img src="https://img.shields.io/badge/license-MIT-blue" />
 </p>
@@ -26,11 +26,11 @@
 > 설치되므로, 매번 긴 `--plugin-dir` 없이 일반 `claude` 실행에서
 > LitClaude skill과 hook을 불러올 수 있습니다.
 
-현재 checkout은 `litclaude-ai@0.3.21` 배포 준비용으로 정리되어 있습니다. 목적은
+현재 checkout은 `litclaude-ai@0.3.22` 배포 준비용으로 정리되어 있습니다. 목적은
 다른 PC에서도 빠르게 설치하기 위한 개인용 package metadata를 갖추는 것입니다.
 npm package metadata를 준비했다고 해서 홍보, 공개 저장소 운영, Claude
 marketplace 등록을 의미하지는 않습니다. 새 버전 배포는 항상 별도의 명시적
-승인 후에 진행합니다. v0.3.21 release material은 bare `hyperplan`,
+승인 후에 진행합니다. v0.3.22 release material은 bare `hyperplan`,
 `litresearch`, `lit research`, `init-deep`, explicit `$start-work` prompt-hook route에
 bundled skill body를 주입하면서, v0.3.19 adversarial planning
 skill, v0.3.18 read-only `lit-recap` session recap surface, v0.3.17 별도 worker 기반 native `/goal`
@@ -117,7 +117,7 @@ checkout을 먼저 해석해서 `sh: litclaude-ai: command not found`로 실패
 
 ```bash
 cd /tmp
-npx --yes litclaude-ai@0.3.21 install
+npx --yes litclaude-ai@0.3.22 install
 ```
 
 설치 상태를 확인합니다.
@@ -130,7 +130,7 @@ installer는 Claude Code의 `statusLine` command도 packaged LitClaude HUD로
 설정합니다. 색상을 제거한 예시는 다음처럼 시작합니다.
 
 ```text
-[🔥LITCLAUDE v0.3.21] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
+[🔥LITCLAUDE v0.3.22] | 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.21` is the current release candidate — a full bare
+Status: `litclaude-ai@0.3.22` is the current release candidate — a full bare
 skill-body prompt-hook routing release on top of the planning-only Hyperplan skill and read-only `lit-recap`
 session recap surface (command, skill, and bounded hook routing
 including the Korean `리캡` trigger), the dry-run-first native `/goal`
@@ -12,9 +12,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.21`,
-`plugins/litclaude/.claude-plugin/plugin.json` is aligned to `0.3.21`, and the
-plugin-local MCP server reports `0.3.21`.
+`package.json` is aligned to `0.3.22`,
+`plugins/litclaude/.claude-plugin/plugin.json` is aligned to `0.3.22`, and the
+plugin-local MCP server reports `0.3.22`.
 
 This release carries the v0.2.2 Dynamic workflow hardening surfaces:
 `/dynamic-workflow`, `workflow-check --json`, native `/goal` fallback guidance,
@@ -63,9 +63,9 @@ No npm publication is required for this track.
 Before requesting publication approval, confirm these artifacts from the current
 checkout:
 
-- `package.json` version is `0.3.21`.
-- `plugins/litclaude/.claude-plugin/plugin.json` version is `0.3.21`.
-- `plugins/litclaude/bin/litclaude-mcp.js` reports server version `0.3.21`.
+- `package.json` version is `0.3.22`.
+- `plugins/litclaude/.claude-plugin/plugin.json` version is `0.3.22`.
+- `plugins/litclaude/bin/litclaude-mcp.js` reports server version `0.3.22`.
 - Prompt-hook tests cover bundled `SKILL.md` body injection for bare `hyperplan`, `litresearch`, `lit research`, `init-deep`, and explicit `$start-work`, while 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "litclaude-ai",
-  "version": "0.3.21",
+  "version": "0.3.22",
   "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.",
-  "version": "0.3.21",
+  "version": "0.3.22",
   "author": {
     "name": "LitClaude contributors"
   },

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

@@ -48,17 +48,17 @@ const plainWordBoundary = /^[A-Za-z0-9]$/u;
 const compoundWordBoundary = /^[A-Za-z0-9_-]$/u;
 
 const triggerByToken = {
-  "deep-interview": { command: "/litclaude:deep-interview", skill: "Skill(deep-interview)", discipline: "deep-interview" },
-  "dynamic-workflow": { command: "/litclaude:dynamic-workflow", skill: "Skill(lit-loop)", discipline: "dynamic-workflow" },
-  "agent-team": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", discipline: "agent-team" },
+  "deep-interview": { command: "/litclaude:deep-interview", skill: "Skill(deep-interview)", skillId: "deep-interview", discipline: "deep-interview" },
+  "dynamic-workflow": { command: "/litclaude:dynamic-workflow", skill: "Skill(lit-loop)", skillId: "lit-loop", discipline: "dynamic-workflow" },
+  "agent-team": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", skillId: "lit-loop", discipline: "agent-team" },
   hyperplan: { command: "/litclaude:lit-plan", skill: "Skill(hyperplan)", skillId: "hyperplan", discipline: "lit-plan" },
   "init-deep": { command: "/litclaude:init-deep", skill: "Skill(init-deep)", skillId: "init-deep", discipline: "init-deep" },
-  "lit-plan": { command: "/litclaude:lit-plan", skill: "Skill(lit-plan)", discipline: "lit-plan" },
-  "lit-recap": { command: "/litclaude:lit-recap", skill: "Skill(lit-recap)", discipline: "lit-recap" },
-  "lit-loop": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", discipline: "lit-loop" },
+  "lit-plan": { command: "/litclaude:lit-plan", skill: "Skill(lit-plan)", skillId: "lit-plan", discipline: "lit-plan" },
+  "lit-recap": { command: "/litclaude:lit-recap", skill: "Skill(lit-recap)", skillId: "lit-recap", discipline: "lit-recap" },
+  "lit-loop": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", skillId: "lit-loop", discipline: "lit-loop" },
   "start-work": { command: "/litclaude:start-work", skill: "Skill(start-work)", skillId: "start-work", discipline: "start-work" },
-  "review-work": { command: "/litclaude:review-work", skill: "Skill(review-work)", discipline: "review-work" },
-  litgoal: { command: "/litclaude:litgoal", skill: "Skill(litgoal)", discipline: "litgoal" },
+  "review-work": { command: "/litclaude:review-work", skill: "Skill(review-work)", skillId: "review-work", discipline: "review-work" },
+  litgoal: { command: "/litclaude:litgoal", skill: "Skill(litgoal)", skillId: "litgoal", discipline: "litgoal" },
   litresearch: { command: "/litclaude:litresearch", skill: "Skill(litresearch)", skillId: "litresearch", discipline: "litresearch" },
 };
 
@@ -160,6 +160,12 @@ const findDollarCommandTrigger = (raw) => {
   return { ...triggerByToken[match[1]], source: "dollar-command" };
 };
 
+const findLeadingBareCommandTrigger = (raw) => {
+  const match = /^\s*(deep-interview|init-deep|lit-plan|lit-recap|lit-loop|start-work|review-work|litgoal|litresearch)(?=$|[^\w-])/u.exec(raw);
+  if (!match) return undefined;
+  return { ...triggerByToken[match[1]], source: "bare-command" };
+};
+
 const hasLitTrigger = (raw) => containsCompoundBoundedWord(raw, "lit") || containsCompoundBoundedWord(raw, "litwork");
 
 const hangulSyllable = /^[가-힣]$/u;
@@ -211,6 +217,8 @@ const findWorkflowTrigger = (prompt) => {
   const dollarTrigger = findDollarCommandTrigger(raw);
   if (dollarTrigger) return dollarTrigger;
   if (containsSlashCommandMention(raw)) return undefined;
+  const bareCommandTrigger = findLeadingBareCommandTrigger(raw);
+  if (bareCommandTrigger) return bareCommandTrigger;
   if (containsCompoundBoundedWord(raw, "hyperplan")) return { ...triggerByToken.hyperplan, source: "bare-command" };
   if (containsCompoundBoundedWord(raw, "init-deep")) return { ...triggerByToken["init-deep"], source: "bare-command" };
   const recapTrigger = findRecapTrigger(raw);
@@ -250,12 +258,13 @@ const teamGateContext = (discipline) => {
   return ["Native agent team setup gate: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is not set, so do not claim a teammate launch. To enable native teams, launch with `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude --teammate-mode auto` or set `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` plus optional `teammateMode: auto`; fallback to subagent delegation or Dynamic workflow meanwhile."];
 };
 
-const recapContext = ({ command, skill, discipline, source }) => [
+const recapContext = ({ command, skill, skillId, discipline, source }) => [
   `Treat this prompt as an explicit request to use LitClaude ${discipline} discipline now; load or follow ${command} / ${skill} semantics before ordinary task execution.`,
   modeContracts[discipline],
   "Read-only recap surfaces: read .litclaude/litgoal/goals.json, .litclaude/litgoal/ledger.jsonl, and .litclaude/litgoal/brief.md when present (plus repo-level evidence/ paths), and combine them with current-session context. The read-only `litclaude-ai litgoal status --json` and `criteria` subcommands are the only litgoal CLI reads allowed.",
   "Output contract: reply in Korean by default using the fixed lit-recap headers from Skill(lit-recap); switch the body to English only when the user asks (--en / in English / 영어); produce the brief `## ⚡ 요약` digest on --brief / 짧게; keep technical tokens (paths, commands, identifiers) verbatim.",
   `Activation source: ${source ?? "legacy"}. Slash commands and slash-command mentions are handled by Claude Code's native command surface and do not activate this prompt hook. Code spans, code fences, substrings, and compound tokens are ignored. Secret-bearing prompt material is never persisted raw; recap output may only reference redacted summaries and evidence paths.`,
+  ...staticSkillBodyContext({ skillId }),
 ].join(" ");
 
 const litworkContext = ({ command, skill, skillId, discipline, softConfirm, safetyBlock, source }, input) => [

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.21";
+const serverVersion = "0.3.22";
 
 const publicSourceReadTool = {
   name: "public_source_read",