@litfamily/litclaude 1.0.6 → 1.0.8

package/plugins/litclaude/lib/rules/session-state.mjs

@@ -23,6 +23,7 @@ import { isAbsolute, join, relative, resolve } from "node:path";
 import { acquireOwnerLock, OwnerLockError, releaseOwnerLock } from "../owner-lock.mjs";
 import { POST_COMPACT_REINJECTION_BUDGET } from "./constants.mjs";
 import { pathIdentity, samePathIdentity } from "../secure-path-read.mjs";
+import { resolveProjectStateRoot } from "../project-state-root.mjs";
 
 const MAX_TRACKED_KEYS = 500;
 const MAX_STATE_BYTES = 256 * 1024;
@@ -42,7 +43,7 @@ const isSameOrChildPath = (parentPath, childPath) => {
 const emptyState = () => ({ injected: [], postCompactCount: 0 });
 
 const safeStateDirectory = (projectRoot, { create }) => {
-  const root = resolve(projectRoot);
+  const root = resolveProjectStateRoot(projectRoot);
   const rootStats = lstatSync(root);
   if (rootStats.isSymbolicLink() || !rootStats.isDirectory()) throw new Error("unsafe project root");
   const realRoot = realpathSync.native(root);

package/plugins/litclaude/lib/start-work-cli.mjs

@@ -1,4 +1,4 @@
-import { resolve } from "node:path";
+import { resolveProjectStateRoot } from "./project-state-root.mjs";
 import {
   cancelStartWork,
   completeStartWork,
@@ -141,7 +141,7 @@ const emitError = (io, error, command) => {
   return status;
 };
 
-export const runStartWorkCli = (argv, io = { stdout: process.stdout, stderr: process.stderr }, defaultRoot = process.cwd()) => {
+export const runStartWorkCli = (argv, io = { stdout: process.stdout, stderr: process.stderr }, defaultRoot = resolveProjectStateRoot()) => {
   const [command, ...args] = argv;
   if (!command || command === "--help" || command === "-h") {
     io.stdout.write(helpText);
@@ -149,7 +149,7 @@ export const runStartWorkCli = (argv, io = { stdout: process.stdout, stderr: pro
   }
   try {
     assertExactOptions(command, args);
-    const root = resolve(value(args, "--root") ?? defaultRoot);
+    const root = resolveProjectStateRoot(value(args, "--root") ?? defaultRoot);
     const result = execute(root, command, args);
     io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
     return 0;

package/plugins/litclaude/lib/wikify-knowledge-cli.mjs

@@ -1,4 +1,6 @@
 import { resolve } from "node:path";
+
+import { resolveProjectStateRoot } from "./project-state-root.mjs";
 import {
   captureKnowledgeEvent,
   queryKnowledge,
@@ -116,7 +118,7 @@ const emitError = (io, error, command, outputJson) => {
 export const runWikifyKnowledgeCli = (
   argv,
   io = { stdout: process.stdout, stderr: process.stderr },
-  defaultRoot = process.cwd(),
+  defaultRoot = resolveProjectStateRoot(),
 ) => {
   const [command, ...args] = argv;
   if (!command || command === "--help" || command === "-h") {

package/plugins/litclaude/lib/wikify-knowledge.mjs

@@ -25,6 +25,7 @@ import {
 } from "./secure-path-read.mjs";
 import { decodeStrictUtf8, parseStrictJson } from "./strict-json.mjs";
 import { containsSecret, URI_USERINFO_PATTERN } from "./secret-shapes.mjs";
+import { resolveProjectStateRoot } from "./project-state-root.mjs";
 
 const MAX_LEDGER_BYTES = 4 * 1024 * 1024;
 const MAX_TEXT_BYTES = 512;
@@ -116,7 +117,7 @@ const deterministicId = (kind, text, provenance, evidence) => {
 };
 
 const canonicalRoot = (root) => {
-  const candidate = resolve(root ?? process.cwd());
+  const candidate = resolveProjectStateRoot(root ?? process.cwd());
   try {
     const details = lstatSync(candidate);
     if (details.isSymbolicLink() || !details.isDirectory()) throw new Error("invalid root");
@@ -137,7 +138,7 @@ const ensurePrivateDirectory = (path) => {
   mkdirSync(path, { mode: 0o700 });
 };
 
-export const knowledgeDirectory = (root = process.cwd()) => {
+export const knowledgeDirectory = (root = resolveProjectStateRoot()) => {
   const canonical = canonicalRoot(root);
   const litDirectory = join(canonical, ".litclaude");
   const directory = join(litDirectory, "knowledge");
@@ -150,8 +151,8 @@ export const knowledgeDirectory = (root = process.cwd()) => {
   }
   return directory;
 };
-export const knowledgeClaimsPath = (root = process.cwd()) => join(knowledgeDirectory(root), "claims.jsonl");
-export const knowledgeSettingsPath = (root = process.cwd()) => join(knowledgeDirectory(root), "settings.json");
+export const knowledgeClaimsPath = (root = resolveProjectStateRoot()) => join(knowledgeDirectory(root), "claims.jsonl");
+export const knowledgeSettingsPath = (root = resolveProjectStateRoot()) => join(knowledgeDirectory(root), "settings.json");
 
 const prepareKnowledgeDirectory = (root) => {
   const canonical = canonicalRoot(root);
@@ -510,7 +511,7 @@ const normalizeEvent = (event, surface) => {
   };
 };
 
-export const readCaptureSettings = (root = process.cwd()) => {
+export const readCaptureSettings = (root = resolveProjectStateRoot()) => {
   return withClaimsLock(root, (directory) => {
     const path = join(directory, "settings.json");
     const snapshot = assertRegularStateFile(path);

package/plugins/litclaude/scripts/scaffold-plan.mjs

@@ -30,6 +30,7 @@ import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { parsePlanTaskRows, planLinesOutsideFences } from "../lib/plan-task-rows.mjs";
+import { resolveProjectStateRoot } from "../lib/project-state-root.mjs";
 import { readRegularStable, samePathIdentity } from "../lib/secure-path-read.mjs";
 
 /** Canonical plan section headers, in order. */
@@ -107,8 +108,9 @@ export function parseArgs(argv) {
 
 /** Confine a write to `.litclaude/drafts/` or `plans/`, `.md` only. */
 export function resolveSafePlanPath(cwd, relPath) {
-  const resolved = resolve(cwd, relPath);
-  const rel = relative(cwd, resolved);
+  const workspaceRoot = resolveProjectStateRoot(cwd);
+  const resolved = resolve(workspaceRoot, relPath);
+  const rel = relative(workspaceRoot, resolved);
   if (rel.startsWith("..") || isAbsolute(rel)) {
     throw new Error(`refused: path escapes the workspace root: ${relPath}`);
   }
@@ -804,6 +806,7 @@ export async function writeGuarded(
     onParentState,
   } = {},
 ) {
+  cwd = resolveProjectStateRoot(cwd);
   const target = resolveSafePlanPath(cwd, relPath);
   const ownInterruption = interruption ?? createInterruptionContext();
   let parentState;
@@ -874,6 +877,7 @@ export async function writeGuarded(
 }
 
 export async function scaffold(cwd, { slug, intent, reset = false, force = false, draftOnly = false, reviewRequired = false }) {
+  cwd = resolveProjectStateRoot(cwd);
   const interruption = createInterruptionContext();
   const created = [];
   const parentStates = new Set();
@@ -1007,6 +1011,7 @@ export function checkPlanStructure(text) {
 }
 
 async function runCheck(checkPath, cwd) {
+  cwd = resolveProjectStateRoot(cwd);
   const target = resolveSafePlanPath(cwd, checkPath);
   const read = readRegularStable(resolve(cwd), target, undefined, { maxBytes: MAX_PLAN_BYTES });
   if (read.failure) {
@@ -1023,7 +1028,8 @@ async function runCheck(checkPath, cwd) {
   return 1;
 }
 
-export async function runScaffoldPlanCli(argv = process.argv, cwd = process.cwd()) {
+export async function runScaffoldPlanCli(argv = process.argv, cwd = resolveProjectStateRoot()) {
+  cwd = resolveProjectStateRoot(cwd);
   const parsed = parseArgs(argv);
   if (parsed.mode === "check") {
     return runCheck(parsed.checkPath, cwd);

package/plugins/litclaude/skills/lit-handoff/SKILL.md

@@ -17,7 +17,7 @@ verdicts: [PASS, DEGRADED, FAIL, BLOCKED]
 
 | Field | Contract | Evidence |
 | --- | --- | --- |
-| activation | Begin the user-visible response with exactly `▲ LIT · lit-handoff`. | First response line and route receipt. |
+| activation | Begin the user-visible response with exactly `🔥 **LIT IGNITED · lit-handoff** 🔥`. | First response line and route receipt. |
 | canonical source | Read the vendored handoff reference completely before acting: `SKILL.md` in the canonical `../../vendor/handoff/` directory. | Source path and destination decision. |
 | completion | Create or update the correct continuation packet without exposing secrets. | Artifact path, checks, and `PASS`, `FAIL`, or `BLOCKED`. |
 
@@ -39,7 +39,7 @@ verdicts: [PASS, DEGRADED, FAIL, BLOCKED]
 
 ## #contract.procedure
 
-1. Print `▲ LIT · lit-handoff` as the first visible line.
+1. Print `🔥 **LIT IGNITED · lit-handoff** 🔥` as the first visible line.
 2. Resolve every linked resource relative to this loaded `SKILL.md` through Claude Code's Skill resource root, never relative to the process cwd. For the exact-bare hook route, use the absolute installed source root injected by the hook. Never assume `~/skills` exists after package installation.
 3. Read the vendored handoff reference `SKILL.md` in full. Follow every destination, stale-state, secret-redaction, and verification rule in that source without abbreviating it.
 4. Inspect existing handoff files and live ledgers or JSONL surfaces before choosing the destination. Prefer live operational truth over stale prose.

package/plugins/litclaude/skills/lit-scientific-visualization/SKILL.md

@@ -17,7 +17,7 @@ verdicts: [PASS, DEGRADED, FAIL, BLOCKED]
 
 | Field | Contract | Evidence |
 | --- | --- | --- |
-| activation | Begin the response with the exact banner `▲ LIT · lit-scientific-visualization`. | First visible response line. |
+| activation | Begin the response with the exact probe `🔥 **LIT IGNITED · lit-scientific-visualization** 🔥`. | First visible response line. |
 | canonical source | Read `../../vendor/scientific-visualization/SKILL.md` completely before plotting. | Source-root receipt. |
 | runtime | Preflight Python and plotting dependencies without installing them. | PASS or DEGRADED doctor output. |
 | completion | Produce and inspect the requested figure artifacts. | Files, dimensions, formats, DPI, and visual QA. |
@@ -35,14 +35,14 @@ verdicts: [PASS, DEGRADED, FAIL, BLOCKED]
 | --- | --- | --- |
 | direct-skill | Claude Code loads `Skill(lit-scientific-visualization)`. | Explicit user intent is required; there is no generic visualization auto-trigger. |
 | command-routed | `/litclaude:lit-scientific-visualization` is invoked. | Follow the command and this full adapter. |
-| hook-routed | The complete UserPromptSubmit prompt is exactly `lit-scientific-visualization` after outer whitespace. | Show the micro mark and discipline as a hook `systemMessage`, inject this adapter and the complete canonical source, and keep all mixed or near-miss prompts inert. |
+| hook-routed | The complete UserPromptSubmit prompt is exactly `lit-scientific-visualization` after outer whitespace. | Show `🔥 LIT IGNITED · lit-scientific-visualization 🔥` in the hook `systemMessage`, inject this adapter and the complete canonical source, and keep all mixed or near-miss prompts inert. |
 | core-ready | Python and matplotlib are available. | Use packaged scripts and verify real exports. |
 | degraded | Python or matplotlib is unavailable. | Report `DEGRADED:` with the missing capability; do not claim artifact creation. |
 | optional-degraded | seaborn, pandas, scipy, plotly, kaleido, numpy, or MDAnalysis is missing. | Use a valid core fallback or report the specific blocked workflow. |
 
 ## #contract.procedure
 
-1. Begin the reply with the exact banner `▲ LIT · lit-scientific-visualization` on its own line. The exact-bare UserPromptSubmit route renders the micro mark and `litclaude · lit-scientific-visualization` as its visible hook `systemMessage`; the probe is model-emitted exactly once; do not treat generic visualization prose as equivalent invocation.
+1. Begin the reply with the exact probe `🔥 **LIT IGNITED · lit-scientific-visualization** 🔥` on its own line. The exact-bare UserPromptSubmit route renders `🔥 LIT IGNITED · lit-scientific-visualization 🔥` as its plain-text hook `systemMessage`; the model probe appears exactly once. Do not treat generic visualization prose as equivalent invocation.
 2. Resolve every linked resource relative to this loaded `SKILL.md` through Claude Code's Skill resource root, never relative to the process cwd. Never hard-code `~/skills` or the source checkout.
 3. Read the [canonical `SKILL.md`](../../vendor/scientific-visualization/SKILL.md) completely, then read only the referenced source files needed for the requested figure. Preserve every restraint, including `rcparams()`, scatter-only semantics, journal sizing, legend treatment, grids, fonts, layout, and export requirements.
 4. Resolve the [bundled doctor](../../bin/litclaude-scientific-visualization-doctor.js) as an installed Skill resource and invoke its absolute path with Node, or use `litclaude doctor`; never run a cwd-relative shell path. Never install Python, matplotlib, or optional packages silently. Ask before any dependency or environment mutation.

package/plugins/litclaude/skills/lit-team/scripts/team.mjs

@@ -38,6 +38,7 @@ import { isAbsolute, join, relative, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 
 import { acquireOwnerLock, OwnerLockError, releaseOwnerLock } from "../../../lib/owner-lock.mjs";
+import { resolveProjectStateRoot } from "../../../lib/project-state-root.mjs";
 import { pathIdentity, samePathIdentity } from "../../../lib/secure-path-read.mjs";
 
 const MIN_MEMBERS = 2;
@@ -61,7 +62,7 @@ const requireTeamId = (teamId) => {
   return teamId;
 };
 
-export const teamsRoot = (cwd = process.cwd()) => join(resolve(cwd), ".litclaude", "teams");
+export const teamsRoot = (cwd = resolveProjectStateRoot()) => join(resolveProjectStateRoot(cwd), ".litclaude", "teams");
 export const teamDir = (cwd, teamId) => join(teamsRoot(cwd), requireTeamId(teamId));
 export const teamStatePath = (cwd, teamId) => join(teamDir(cwd, teamId), "team.json");
 
@@ -87,7 +88,7 @@ const isSameOrChildPath = (parentPath, childPath) => {
 };
 
 const safeDirectory = (cwd, components, { create }) => {
-  const root = resolve(cwd);
+  const root = resolveProjectStateRoot(cwd);
   const rootStats = lstatSync(root);
   if (rootStats.isSymbolicLink() || !rootStats.isDirectory()) throw new TeamError("workspace root is not a safe directory", 65);
   const realRoot = realpathSync.native(root);
@@ -379,7 +380,7 @@ const archive = (cwd, args) => {
 
 const commands = { init, "add-member": addMember, prompt, report, block, status, archive };
 
-export const runTeamCli = (argv, io = { stdout: process.stdout, stderr: process.stderr }, cwd = process.cwd()) => {
+export const runTeamCli = (argv, io = { stdout: process.stdout, stderr: process.stderr }, cwd = resolveProjectStateRoot()) => {
   const [command, ...rest] = argv;
   if (!command || command === "--help" || command === "-h") {
     io.stdout.write(`Usage: team.mjs <${Object.keys(commands).join("|")}> [...args]\n`);

package/plugins/litclaude/skills/litwork/SKILL.md

@@ -583,8 +583,8 @@ history-safety detail when the operation grows past a single commit.
 
 ## Output discipline
 
-- First line, literally: `▲ LIT · litwork`, on its own line, before
-  anything else, exactly once. The harness renders its mark separately; do not repeat it.
+- First line, literally: `🔥 **LIT IGNITED · litwork** 🔥`, on its own line, before
+  anything else, exactly once. The harness shows its plain-text status mark separately; do not draw ASCII art or add a second probe line.
 - After bootstrap in reader mode: the current result, decision, or next required
   action. Keep the notepad path internal unless the request asks for it.
 - During execution in reader mode, surface only a current result, material

package/scripts/prepublish-test-gate.mjs

@@ -0,0 +1,26 @@
+import { spawnSync } from "node:child_process";
+
+const env = Object.fromEntries(
+  Object.entries(process.env).filter(([key]) => key.toLowerCase() !== "npm_config_dry_run"),
+);
+const npmExecPath = process.env.npm_execpath;
+const result = npmExecPath
+  ? spawnSync(process.execPath, [npmExecPath, "test"], { env, stdio: "inherit" })
+  : spawnSync(process.platform === "win32" ? "npm.cmd" : "npm", ["test"], {
+      env,
+      shell: process.platform === "win32",
+      stdio: "inherit",
+    });
+
+if (result.error) {
+  console.error(`prepublish test gate could not start npm test: ${result.error.message}`);
+  process.exitCode = 1;
+} else if (result.signal) {
+  console.error(`prepublish test gate interrupted by ${result.signal}`);
+  process.exitCode = 1;
+} else if (Number.isInteger(result.status)) {
+  process.exitCode = result.status;
+} else {
+  console.error("prepublish test gate received a non-integer npm test exit status");
+  process.exitCode = 1;
+}

package/scripts/qa-real-surface-lib.mjs

@@ -25,6 +25,7 @@ import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { deflateSync } from "node:zlib";
+import { stripAnsi } from "./strip-ansi.mjs";
 
 export const repoRoot = resolve(fileURLToPath(new URL("..", import.meta.url)));
 
@@ -606,8 +607,8 @@ function phaseCorrect(phase, run) {
   if (phase.id === "session_start") return context.startsWith("LitClaude rules loaded for ");
   if (phase.id === "s1_activation") {
     return /LITWORK MODE ENABLED/u.test(context)
-      && /litclaude · lit-loop/u.test(run.parsed.systemMessage ?? "")
-      && /▲ LIT · lit-loop/u.test(context);
+      && /🔥 LIT IGNITED · lit-loop 🔥/u.test(stripAnsi(run.parsed.systemMessage ?? ""))
+      && /🔥 \*\*LIT IGNITED · lit-loop\*\* 🔥/u.test(context);
   }
   return run.parsed.systemMessage === undefined
     && context === "LitClaude prompt hook checked: no workflow activation.";

package/scripts/strip-ansi.mjs

@@ -0,0 +1 @@
+export { stripVTControlCharacters as stripAnsi } from "node:util";