@litfamily/litclaude 1.0.5 → 1.0.7

package/plugins/litclaude/lib/canonical-skill-resources.mjs

@@ -22,32 +22,13 @@ export const canonicalSkillResourceManifest = Object.freeze(
     ["lib/rules/matcher.mjs", "83334358a035a9fedf3d7970b2454825d4ca8d0082b5a8779efc8ad8fdeecd5b"],
     ["lib/rules/ordering.mjs", "c6da1ef0b228b8f0932b54422d2bc9744eb6bfbb8f5bb70b30b8f1a798765d1c"],
     ["lib/rules/scanner.mjs", "c62d672a66af25f29fe1d05b09288583425a2bf55f20d788f81d1578035f79f9"],
-    ["lib/rules/session-state.mjs", "8f700f2fb0debd03c7141b93db980412db32d61524deef63144c12f9f5063d85"],
+    ["lib/rules/session-state.mjs", "ad660cadf147b102437da95a771bae19ee2140bf39c58915b8cb498e8d04f2af"],
     ["lib/secret-shapes.mjs", "73733bb5927d6d1e00c529acc847b79d8664d10f94100bcc7452824615ab87ba"],
     ["lib/secure-path-read.mjs", "c2991d0279f7399c3022c78babe28e653260f2a2e9ff4a5df692883ccf8807fd"],
-    ["lib/skill-loop/apply.mjs", "c00aa7a40d76cb5390ac7c13af4a2eda4ff8d090f10c2a4f1e4a72ac158d3ac9"],
-    ["lib/skill-loop/authority.mjs", "41911124a5141480538bbd9887c4d5cec2ea38552ed03c05bd3d3412f0c11b1d"],
-    ["lib/skill-loop/cli.mjs", "333135a39c36e7eab6b10d5a3859dce68ba98b7c83bbf36144d53b19f4bdc1f4"],
-    ["lib/skill-loop/common.mjs", "c65eec46eaad369b989337876960dcba9a0f25f40320862dc1c4a298a7e7a730"],
-    ["lib/skill-loop/config.mjs", "833e73f74ffdf43068a95aa6c50dc29e9080b0549871bdc0a5669a01c752cba6"],
-    ["lib/skill-loop/curator.mjs", "6776eb46fb0c1f79a2a217f495b2195e54cac044f61dfe9298447c9b2bd2de76"],
-    ["lib/skill-loop/hook-runtime.mjs", "34af32eb44e04aed2f452dcc01556f4f113b9e4896bcdb633402c4e273763006"],
-    ["lib/skill-loop/hook-state.mjs", "cbe544247069ee004acb389f70ef7d9f25f0afd8a5df9c5567c365bf47989938"],
-    ["lib/skill-loop/ledger.mjs", "5367b62c21f8bad2e8efb34caa9e2a5c79de85d9d762d7a583cc66ea9da325e5"],
-    ["lib/skill-loop/mutation-transaction.mjs", "485b871b3cc5e8c3234df9bf0a84f240fddc4f91dbff94607d1e046248bf33f9"],
-    ["lib/skill-loop/proposal-reader.mjs", "b979d2a848eef091fabb001ce2e8a8a4fd8dc6e16e874add0f34dc99b3575af4"],
-    ["lib/skill-loop/proposal-record.mjs", "352888ab9d0b7235414ca9ce068c119fb2230d1abe46bcff602d55feff0552bc"],
-    ["lib/skill-loop/proposal-store.mjs", "07e06e035a8fd5b58baf41fd6df244f120bb14a857ea6b98f0d71f362dd4c358"],
-    ["lib/skill-loop/proposals.mjs", "bc0a880b149c8293065d458eaf464ba79e08da93b1912c695239af8cbb8cedec"],
-    ["lib/skill-loop/review-runner.mjs", "fcd4f1c122b3c50934358c376cda544808c0286793e1e882fee72277258d4c7c"],
-    ["lib/skill-loop/review-transaction.mjs", "a74f21f6d24014d1ade5c6bf760d7452ed491df4471f7d14a8ef3423028db4c3"],
-    ["lib/skill-loop/review.mjs", "90118466b694bc56aa605e4eeb1fbd34ce57367c4075adbb52d2ec2f2182bc45"],
-    ["lib/skill-loop/usage.mjs", "9a80b2979014c46bdd9527140ef193abacd3a1b4eafd458f32315d5902aa2b99"],
-    ["lib/skill-observer.mjs", "13466c511a870cb4809e327c8a9181cdba17da9883ef05995f6ca8c698a925b6"],
     ["lib/strict-json.mjs", "d941f327aabce5ffc212770852cfbc7e08dd03471e4e9bc9560eff54f06d489a"],
-    ["lib/wikify-knowledge-cli.mjs", "d98e4b3ea0efe3dcd483750c2dc3a5d0dfd14bc6eb349437902b1e01b8fa2ff4"],
-    ["lib/wikify-knowledge.mjs", "4d2f4e0ac3bc0b40ac513470b324e853e2aeeb3f009216c13d8e12ec08e6c28b"],
-    ["scripts/scaffold-plan.mjs", "c014b9acb49a647c97044dfb5a83eb5cc2bd4e13774ad1a9f213b9e074559d3e"],
+    ["lib/wikify-knowledge-cli.mjs", "6835f8d6d98a3dd26266409366c23b2da437c0cd41e63537f0f200667655132b"],
+    ["lib/wikify-knowledge.mjs", "00dc8509d007484105dab87c1562d1657ef0f01ac8840a7d2f18898768d375b3"],
+    ["scripts/scaffold-plan.mjs", "b171ffccdaff8b9a586fe65590a154eeb663e7359fd34b6ee0e942d452381d2a"],
     ["skills/autoconference/SKILL.md", "3731208dc3838d4d2916fb01da0c8cb63cca36342c2ffb5770770b3332d06cd3"],
     ["skills/autoresearch/SKILL.md", "2b69c53bade3851cfb9c770bce80afe5f9e75b9629719e9ba95a4b0045eaf5b3"],
     ["skills/browser-drive/scripts/capability-probe.mjs", "e767912bc034eaf9081256d8aa2f2bf63c7d9d29e39cb5e56f390e872df794f7"],
@@ -187,12 +168,9 @@ export const canonicalSkillResourceManifest = Object.freeze(
     ["skills/lit-comprehend/references/micro-worlds.md", "92fc1401fc14c5bcbbeded00ff45819aacd2ead50b86f8a0f45985d19461bfa4"],
     ["skills/lit-comprehend/scripts/verify-explainer.mjs", "837a6fe18e2fea8ed015c8e024b36f9f7e2ebb7f6abe433fc69b1db60a152994"],
     ["skills/lit-team/SKILL.md", "6d4ca726d1240db7692ccc95802ab6abfd45588147ec663dafa1b3b233a08a13"],
-    ["skills/lit-team/scripts/team.mjs", "ef259aa156d8476a40d0ac6f6f3ac54b81bde35c88bf3a0467878ffd57714931"],
+    ["skills/lit-team/scripts/team.mjs", "a0be61f09cc1c10989b12709135ac4b99260496f840dcf58514478082e239fe7"],
     ["skills/litresearch/ATTRIBUTION.md", "1ed8b43d48a13d7fc106cbfd86bc1bac0316529bdac4e2e38043fafeae2a8e15"],
     ["skills/litwork/SKILL.md", "18d91a20d882d72f9795cfeb8d46a3e07c773d66853d51aa965cdcec5513bea3"],
-    ["skills/skill-observer/SKILL.md", "a67b72d877c45f519711f59e285302e1c1c8afbdda85009df07f1cf30a1a5d57"],
-    ["skills/skill-observer/references/review-contract.md", "f55dc8334f3b8d8498c84d57725fa03af8fbd689b2dd7cce25e49931629ee54f"],
-    ["skills/skill-observer/scripts/skill-loop.mjs", "36915455a8f22a03975108d48dea83e8f6aa827936f9fdac3c09eca3fec9072d"],
     ["skills/visual-qa/SKILL.md", "089d26a14800b461cfd628b4789f676308d5e09fe13e9e24632b8fd6305c8517"],
     ["skills/visual-qa/references/capture-playbook.md", "92cad16893118c9e878cabbb49dc2187049ec6e759fcc4e6006d79bdae998689"],
     ["skills/visual-qa/references/complete-contract.md", "8dd878975eb386b8b5d0b5439ed7bc50de9c4e3ee2aeff6d553c4299c5b30cb4"],

package/plugins/litclaude/lib/lit-plan-persistence.mjs

@@ -6,6 +6,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 
+import { resolveProjectStateRoot } from "./project-state-root.mjs";
 import { findProjectRoot } from "./rules/discovery.mjs";
 
 export const LIT_PLAN_MAX_BLOCKS = 2;
@@ -15,7 +16,7 @@ export const LIT_PLAN_BLOCK_REASON = "lit-plan must persist plans/<slug>.md (run
 const MTIME_TOLERANCE_MS = 1000;
 const TASK_ROW = /^- \[ \] \d+\./mu;
 
-export const litPlanTurnPath = (cwd = process.cwd()) => join(resolve(cwd), ".litclaude", "lit-plan", "turn.json");
+export const litPlanTurnPath = (cwd = resolveProjectStateRoot()) => join(resolveProjectStateRoot(cwd), ".litclaude", "lit-plan", "turn.json");
 
 const readTurn = (cwd) => {
   const path = litPlanTurnPath(cwd);

package/plugins/litclaude/lib/litgoal/paths.mjs

@@ -1,12 +1,14 @@
-import { join, resolve } from "node:path";
+import { join } from "node:path";
 
-export const litgoalStateDir = (cwd = process.cwd()) => join(resolve(cwd), ".litclaude", "litgoal");
-export const litgoalBriefPath = (cwd = process.cwd()) => join(litgoalStateDir(cwd), "brief.md");
-export const litgoalGoalsPath = (cwd = process.cwd()) => join(litgoalStateDir(cwd), "goals.json");
-export const litgoalLedgerPath = (cwd = process.cwd()) => join(litgoalStateDir(cwd), "ledger.jsonl");
-export const litgoalLockDir = (cwd = process.cwd()) => join(litgoalStateDir(cwd), ".lock");
-export const litgoalSessionsDir = (cwd = process.cwd()) => join(litgoalStateDir(cwd), "sessions");
+import { resolveProjectStateRoot } from "../project-state-root.mjs";
+
+export const litgoalStateDir = (cwd = resolveProjectStateRoot()) => join(resolveProjectStateRoot(cwd), ".litclaude", "litgoal");
+export const litgoalBriefPath = (cwd = resolveProjectStateRoot()) => join(litgoalStateDir(cwd), "brief.md");
+export const litgoalGoalsPath = (cwd = resolveProjectStateRoot()) => join(litgoalStateDir(cwd), "goals.json");
+export const litgoalLedgerPath = (cwd = resolveProjectStateRoot()) => join(litgoalStateDir(cwd), "ledger.jsonl");
+export const litgoalLockDir = (cwd = resolveProjectStateRoot()) => join(litgoalStateDir(cwd), ".lock");
+export const litgoalSessionsDir = (cwd = resolveProjectStateRoot()) => join(litgoalStateDir(cwd), "sessions");
 // Where a completed goal is preserved when a fresh session opens new state (drift 6a).
 // The session id is filename-sanitized because it arrives from the host.
-export const litgoalSessionArchivePath = (cwd = process.cwd(), sessionId = "unknown") =>
+export const litgoalSessionArchivePath = (cwd = resolveProjectStateRoot(), sessionId = "unknown") =>
   join(litgoalSessionsDir(cwd), `${String(sessionId).replace(/[^A-Za-z0-9_-]/gu, "").slice(0, 64) || "unknown"}.json`);

package/plugins/litclaude/lib/project-state-root.mjs

@@ -0,0 +1,22 @@
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+
+import { findProjectRoot } from "./rules/discovery.mjs";
+
+const outermostGitRoot = (startDir) => {
+  let root = null;
+  let current = startDir;
+  for (;;) {
+    if (existsSync(join(current, ".git"))) root = current;
+    const parent = dirname(current);
+    if (parent === current) return root;
+    current = parent;
+  }
+};
+
+// State placement is intentionally separate from nearest-marker rule discovery: a nested
+// package.json is a valid rules boundary, but .litclaude belongs at the outer Git root.
+export const resolveProjectStateRoot = (startDir = process.cwd()) => {
+  const start = resolve(startDir);
+  return outermostGitRoot(start) ?? findProjectRoot(start) ?? start;
+};

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-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/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;
+}