@litfamily/litclaude 1.0.18 → 1.0.19

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.0.19 - 2026-10-01
+
+- Automatic handoff now finds the handoff it asked for after compaction even when the model formats the marker line, for example as a bullet, in backticks or in bold. A handoff from another session is still ignored.
+- An upgrade no longer stops with an ownership conflict when a bundled Python script left a `__pycache__` folder in the installed plugin.
+
 ## 1.0.18 - 2026-09-30
 
 - `gpt-6.1-sol` is now the recommended coding-lead alternative, since OpenAI lists `gpt-6-sol` as the previous generation. `gpt-6-sol` still works for anyone who already chose it. Claude Code picks the model and LitClaude sets no OpenAI route of its own, so this shows only in the model notes in the README (English and Korean) and in `docs/agents.md`.

package/README.md

@@ -1,14 +1,14 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 <p align="center">Plan, build, and check your work in Claude Code. Leave the next session a place to begin.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/readme/badge-version.svg" alt="1.0.18" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/readme/badge-version.svg" alt="1.0.19" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide and skills gallery on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/README_ko-KR.md">한국어</a>
+  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide and skills gallery on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/README_ko-KR.md">한국어</a>
 </p>
 
 LitClaude is a Claude Code plugin. Add `lit` to a request and Claude pins the goal, writes a
@@ -125,7 +125,7 @@ changed by hand or doesn't look like one LitClaude made, it refuses to touch it.
 ## More
 
 - [Full guide and skills gallery on GitHub](https://github.com/wjgoarxiv/litclaude#readme)
-- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/privacy.md)
-- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/CHANGELOG.md)
-- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/LICENSE)
+- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/privacy.md)
+- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/migration.md)
+- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/CHANGELOG.md)
+- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/LICENSE)

package/README_ko-KR.md

@@ -1,14 +1,14 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 <p align="center">Claude Code에서 계획하고, 만들고, 확인한 일을 다음 세션으로 이어가세요.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/readme/badge-version.svg" alt="1.0.18" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/readme/badge-version.svg" alt="1.0.19" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내와 스킬 갤러리는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/README.md">English</a>
+  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내와 스킬 갤러리는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/README.md">English</a>
 </p>
 
 LitClaude는 Claude Code 플러그인입니다. 요청 끝에 `lit`을 붙이면 Claude가 목표를 먼저
@@ -119,7 +119,7 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
 ## 더 보기
 
 - [전체 안내와 스킬 갤러리 (GitHub)](https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md)
-- [개인정보와 네트워크](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/privacy.md)
-- [이전 안내와 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/CHANGELOG.md)
-- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.18/LICENSE)
+- [개인정보와 네트워크](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/privacy.md)
+- [이전 안내와 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/docs/migration.md)
+- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/CHANGELOG.md)
+- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.19/LICENSE)

package/bin/install-ownership.mjs

@@ -1,6 +1,6 @@
 import { createHash, randomUUID } from "node:crypto";
 import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { compareStableSemver } from "./update-notifier.mjs";
 
 const stableVersion = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
@@ -20,6 +20,9 @@ const legacyVendorPathMap = [
   ["060_autoresearch-skill", "autoresearch", "25ce45fe792de02e04019e6d0c871738e6a1b8b6cb9a91cd2486b3d4cbb715b9"],
   ["064_autoconference-skill", "autoconference", "d305d2d41721c0196cc5aaa09610f1eb4499f7ba53504bd72bdbefdd21ca7da1"],
 ];
+// Python writes bytecode next to the scripts it runs. That cache is generated, never user data, so ownership
+// checks skip it. A symlink or a plain file named __pycache__ is not a cache and is still reported.
+const isBytecodeCache = (name, value) => (value.isDirectory() && name === "__pycache__") || (value.isFile() && name.endsWith(".pyc"));
 const conflict = (path, detail = "") => { throw new Error(`INSTALL_OWNERSHIP_CONFLICT: ${path}; use a compatible CLI or preserve this modified, foreign, or unsupported state before retrying${detail ? `. ${detail}` : ""}`); };
 const stat = (path) => {
   try { return lstatSync(path); } catch (error) { if (error.code === "ENOENT") return null; throw error; }
@@ -45,6 +48,7 @@ function treeHash(root) {
     for (const name of readdirSync(path).sort()) {
       if (!prefix && name === receiptName) continue;
       const next = join(path, name), rel = prefix ? `${prefix}/${name}` : name, value = lstatSync(next);
+      if (isBytecodeCache(name, value)) continue;
       if (!prefix && name === hostUseMarker && value.isDirectory() && readdirSync(next).length === 0) continue;
       if (value.isDirectory()) { entries.push([rel, "directory"]); walk(next, rel); }
       else if (value.isFile() && value.nlink === 1) entries.push([rel, "file", createHash("sha256").update(readFileSync(next)).digest("hex")]);
@@ -59,6 +63,7 @@ function detailedTree(root, { receipt = false } = {}) {
   const rows = [];
   function walk(path, prefix = "") {
     const value = lstatSync(path);
+    if (prefix && isBytecodeCache(prefix.split("/").at(-1), value)) return;
     if (value.isSymbolicLink()) conflict(path, "A preserved skill tree cannot contain symlinks");
     if (value.isDirectory()) {
       rows.push([prefix, "directory", value.mode & 0o777]);
@@ -169,7 +174,7 @@ export function preserveModifiedLegacySkill(plan, litHome) {
   try {
     const currentRows = detailedTree(plan.skillPath, { receipt: true });
     if (!sameRowList(currentRows, plan.skillRows)) conflict(plan.skillPath, "The legacy skill changed after the ownership preflight");
-    cpSync(plan.skillPath, join(staging, "skill"), { recursive: true, errorOnExist: true, force: false });
+    cpSync(plan.skillPath, join(staging, "skill"), { recursive: true, errorOnExist: true, force: false, filter: (source) => !isBytecodeCache(basename(source), lstatSync(source)) });
     if (!sameRowList(detailedTree(join(staging, "skill"), { receipt: true }), plan.skillRows)) {
       conflict(plan.skillPath, "The staged preservation copy does not match the source");
     }

package/docs/assets/readme/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.18"><title>release: 1.0.18</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.18</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.19"><title>release: 1.0.19</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.19</text></g></svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/litclaude",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "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": "1.0.18",
+  "version": "1.0.19",
   "author": {
     "name": "LitClaude contributors"
   },

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

@@ -9,7 +9,7 @@ import {
 } from "../lib/wikify-knowledge.mjs";
 
 const protocolVersion = "2024-11-05";
-const serverVersion = "1.0.18";
+const serverVersion = "1.0.19";
 
 const publicSourceReadTool = {
   name: "public_source_read",

package/plugins/litclaude/lib/auto-handoff.mjs

@@ -243,6 +243,20 @@ const candidateFiles = (cwd, stateRoot) => {
   return files;
 };
 
+// A model often dresses the marker up (bullet, bold label, backticks, an HTML comment). Each line is read
+// with that Markdown decoration removed, then must hold the label and this exact id with a boundary after it.
+const markerOnLine = (line, nonce) => {
+  const plain = line.replace(/<!--|-->|[*_`]/gu, "").replace(/\s+/gu, " ");
+  const label = "Auto-handoff id: ";
+  for (let at = plain.indexOf(label); at !== -1; at = plain.indexOf(label, at + 1)) {
+    const start = at + label.length;
+    if (plain.startsWith(nonce, start) && !/^[0-9a-f]/iu.test(plain.slice(start + nonce.length, start + nonce.length + 1))) return true;
+  }
+  return false;
+};
+
+const hasMarker = (text, nonce) => text.split(/\r?\n/u).some((line) => markerOnLine(line, nonce));
+
 const readHandoff = (path, { nonce, firedAt }) => {
   let fd;
   try {
@@ -251,7 +265,7 @@ const readHandoff = (path, { nonce, firedAt }) => {
     fd = openSync(path, constants.O_RDONLY | NO_FOLLOW);
     if (!fstatSync(fd).isFile()) return null;
     const text = readFileSync(fd, "utf8");
-    return text.includes(`Auto-handoff id: ${nonce}`) ? text : null;
+    return hasMarker(text, nonce) ? text : null;
   } catch {
     return null;
   } finally {