@tricknowtech/context 0.1.0 → 0.1.1

package/dist/{chunk-DEH5MUFT.js → chunk-BWATZKYM.js}

@@ -228,12 +228,41 @@ var PROJECT_CONTEXT_GLOBS = [
   ".cursorrules",
   ".github/copilot-instructions.md",
   ".claude/settings.json",
+  // `.local.json` variants are gitignored by default, so nothing else carries
+  // them — which makes them exactly the kind of file this tool exists for.
+  ".claude/settings.local.json",
   ".claude/memory/",
   ".claude/plans/",
   ".claude/commands/",
   ".claude/agents/",
   ".claude/skills/"
 ];
+function planStem(fileName) {
+  return fileName.replace(/\.md$/, "").replace(/-agent-[0-9a-f]+$/i, "");
+}
+function collectPlans(plansDir, projectRoot, exclude) {
+  const all = walk(plansDir, { exclude });
+  if (all.length === 0) return [];
+  const projectName = path3.basename(projectRoot);
+  const related = /* @__PURE__ */ new Set();
+  const stems = /* @__PURE__ */ new Set();
+  for (const abs of all) {
+    let text = "";
+    try {
+      text = fs3.readFileSync(abs, "utf8");
+    } catch {
+      continue;
+    }
+    if (text.includes(projectRoot) || text.includes(projectName)) {
+      related.add(abs);
+      stems.add(planStem(path3.basename(abs)));
+    }
+  }
+  for (const abs of all) {
+    if (stems.has(planStem(path3.basename(abs)))) related.add(abs);
+  }
+  return [...related];
+}
 function push(out, sourcePath, storePath, tier, sourceRoot, ctx) {
   let size = 0;
   try {
@@ -268,10 +297,24 @@ function collect(projectRoot, cfg, tiers) {
       }
       push(files, abs, `project/${rel}`, "core", "project", ctx);
     }
-    const memoryDir = path3.join(userClaude, "projects", key, "memory");
-    for (const abs of walk(memoryDir, { exclude })) {
-      const rel = toPosix(path3.relative(memoryDir, abs));
-      push(files, abs, `memory/${rel}`, "core", "user", ctx);
+    const projectsDir = path3.join(userClaude, "projects");
+    let projectKeys = [];
+    try {
+      projectKeys = fs3.readdirSync(projectsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && (d.name === key || d.name.startsWith(key + "-"))).map((d) => d.name);
+    } catch {
+      projectKeys = [];
+    }
+    for (const pk of projectKeys) {
+      const memoryDir = path3.join(projectsDir, pk, "memory");
+      for (const abs of walk(memoryDir, { exclude })) {
+        const rel = toPosix(path3.relative(memoryDir, abs));
+        const storePath = pk === key ? `memory/${rel}` : `memory-sub/${pk.slice(key.length + 1)}/${rel}`;
+        push(files, abs, storePath, "core", "user", ctx);
+      }
+    }
+    for (const abs of collectPlans(path3.join(userClaude, "plans"), projectRoot, exclude)) {
+      const rel = toPosix(path3.relative(path3.join(userClaude, "plans"), abs));
+      push(files, abs, `plans/${rel}`, "core", "user", ctx);
     }
     const skillsDir = path3.join(userClaude, "skills");
     for (const abs of walk(skillsDir, { exclude })) {
@@ -307,6 +350,44 @@ function collect(projectRoot, cfg, tiers) {
   }
   return { files, skippedTracked, ctx };
 }
+function describeExcluded(projectRoot, tiers) {
+  const userClaude = userClaudeDir();
+  const key = cwdKey(projectRoot);
+  const out = [];
+  const measure = (dir, filter) => {
+    let files = 0;
+    let bytes = 0;
+    for (const abs of walk(dir, { exclude: [] })) {
+      if (filter && !filter(abs)) continue;
+      files++;
+      try {
+        bytes += fs3.statSync(abs).size;
+      } catch {
+      }
+    }
+    return { files, bytes };
+  };
+  if (!tiers.includes("transcripts")) {
+    const projDir = path3.join(userClaude, "projects", key);
+    const m = measure(projDir, (p) => !p.includes(`${path3.sep}memory${path3.sep}`));
+    if (m.files > 0) {
+      out.push({
+        label: "session transcripts",
+        ...m,
+        reason: "cloud-only \u2014 append-only logs this large would permanently bloat the repo"
+      });
+    }
+  }
+  for (const [dir, label, reason] of [
+    ["uploads", "pasted files/images", "session-scoped binaries; regenerate rather than sync"],
+    ["file-history", "edit-undo snapshots", "transient local undo state, not portable context"],
+    ["tasks", "task outputs", "session-scoped tool output"]
+  ]) {
+    const m = measure(path3.join(userClaude, dir));
+    if (m.files > 0) out.push({ label, ...m, reason });
+  }
+  return out.filter((g) => g.bytes > 0);
+}
 function summarize(files) {
   const empty = { count: 0, bytes: 0 };
   const out = {
@@ -606,6 +687,7 @@ export {
   loadConfig,
   saveConfig,
   collect,
+  describeExcluded,
   summarize,
   SLASH_COMMAND_PATH,
   SLASH_COMMAND_BODY,

package/dist/cli.cjs

@@ -273,12 +273,41 @@ var PROJECT_CONTEXT_GLOBS = [
   ".cursorrules",
   ".github/copilot-instructions.md",
   ".claude/settings.json",
+  // `.local.json` variants are gitignored by default, so nothing else carries
+  // them — which makes them exactly the kind of file this tool exists for.
+  ".claude/settings.local.json",
   ".claude/memory/",
   ".claude/plans/",
   ".claude/commands/",
   ".claude/agents/",
   ".claude/skills/"
 ];
+function planStem(fileName) {
+  return fileName.replace(/\.md$/, "").replace(/-agent-[0-9a-f]+$/i, "");
+}
+function collectPlans(plansDir, projectRoot, exclude) {
+  const all = walk(plansDir, { exclude });
+  if (all.length === 0) return [];
+  const projectName = import_node_path3.default.basename(projectRoot);
+  const related = /* @__PURE__ */ new Set();
+  const stems = /* @__PURE__ */ new Set();
+  for (const abs of all) {
+    let text = "";
+    try {
+      text = import_node_fs3.default.readFileSync(abs, "utf8");
+    } catch {
+      continue;
+    }
+    if (text.includes(projectRoot) || text.includes(projectName)) {
+      related.add(abs);
+      stems.add(planStem(import_node_path3.default.basename(abs)));
+    }
+  }
+  for (const abs of all) {
+    if (stems.has(planStem(import_node_path3.default.basename(abs)))) related.add(abs);
+  }
+  return [...related];
+}
 function push(out2, sourcePath, storePath, tier, sourceRoot, ctx) {
   let size = 0;
   try {
@@ -313,10 +342,24 @@ function collect(projectRoot, cfg, tiers) {
       }
       push(files, abs, `project/${rel}`, "core", "project", ctx);
     }
-    const memoryDir = import_node_path3.default.join(userClaude, "projects", key, "memory");
-    for (const abs of walk(memoryDir, { exclude })) {
-      const rel = toPosix(import_node_path3.default.relative(memoryDir, abs));
-      push(files, abs, `memory/${rel}`, "core", "user", ctx);
+    const projectsDir = import_node_path3.default.join(userClaude, "projects");
+    let projectKeys = [];
+    try {
+      projectKeys = import_node_fs3.default.readdirSync(projectsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && (d.name === key || d.name.startsWith(key + "-"))).map((d) => d.name);
+    } catch {
+      projectKeys = [];
+    }
+    for (const pk of projectKeys) {
+      const memoryDir = import_node_path3.default.join(projectsDir, pk, "memory");
+      for (const abs of walk(memoryDir, { exclude })) {
+        const rel = toPosix(import_node_path3.default.relative(memoryDir, abs));
+        const storePath = pk === key ? `memory/${rel}` : `memory-sub/${pk.slice(key.length + 1)}/${rel}`;
+        push(files, abs, storePath, "core", "user", ctx);
+      }
+    }
+    for (const abs of collectPlans(import_node_path3.default.join(userClaude, "plans"), projectRoot, exclude)) {
+      const rel = toPosix(import_node_path3.default.relative(import_node_path3.default.join(userClaude, "plans"), abs));
+      push(files, abs, `plans/${rel}`, "core", "user", ctx);
     }
     const skillsDir = import_node_path3.default.join(userClaude, "skills");
     for (const abs of walk(skillsDir, { exclude })) {
@@ -352,6 +395,44 @@ function collect(projectRoot, cfg, tiers) {
   }
   return { files, skippedTracked, ctx };
 }
+function describeExcluded(projectRoot, tiers) {
+  const userClaude = userClaudeDir();
+  const key = cwdKey(projectRoot);
+  const out2 = [];
+  const measure = (dir, filter) => {
+    let files = 0;
+    let bytes = 0;
+    for (const abs of walk(dir, { exclude: [] })) {
+      if (filter && !filter(abs)) continue;
+      files++;
+      try {
+        bytes += import_node_fs3.default.statSync(abs).size;
+      } catch {
+      }
+    }
+    return { files, bytes };
+  };
+  if (!tiers.includes("transcripts")) {
+    const projDir = import_node_path3.default.join(userClaude, "projects", key);
+    const m = measure(projDir, (p) => !p.includes(`${import_node_path3.default.sep}memory${import_node_path3.default.sep}`));
+    if (m.files > 0) {
+      out2.push({
+        label: "session transcripts",
+        ...m,
+        reason: "cloud-only \u2014 append-only logs this large would permanently bloat the repo"
+      });
+    }
+  }
+  for (const [dir, label, reason] of [
+    ["uploads", "pasted files/images", "session-scoped binaries; regenerate rather than sync"],
+    ["file-history", "edit-undo snapshots", "transient local undo state, not portable context"],
+    ["tasks", "task outputs", "session-scoped tool output"]
+  ]) {
+    const m = measure(import_node_path3.default.join(userClaude, dir));
+    if (m.files > 0) out2.push({ label, ...m, reason });
+  }
+  return out2.filter((g) => g.bytes > 0);
+}
 function summarize(files) {
   const empty = { count: 0, bytes: 0 };
   const out2 = {
@@ -735,6 +816,13 @@ function cmdPush(opts = {}) {
   if (skippedTracked.length > 0) {
     lines.push("", `${skippedTracked.length} project files skipped \u2014 git already tracks them.`);
   }
+  const excluded = describeExcluded(root, tiers);
+  if (excluded.length > 0) {
+    lines.push("", "Not included (by design):");
+    for (const g of excluded) {
+      lines.push(`  ${g.label.padEnd(22)} ${formatBytes(g.bytes).padStart(9)}  ${g.reason}`);
+    }
+  }
   if (!opts.dryRun) {
     lines.push("", "Commit .contextsync/ to carry this context with the repo.");
   }
@@ -854,7 +942,7 @@ function parseArgs(argv) {
 function run(argv) {
   const { command, flags } = parseArgs(argv);
   if (flags.has("h") || flags.has("help")) return { code: 0, lines: [USAGE] };
-  if (flags.has("v") || flags.has("version")) return { code: 0, lines: ["0.1.0"] };
+  if (flags.has("v") || flags.has("version")) return { code: 0, lines: ["0.1.1"] };
   switch (command) {
     case "init":
       return cmdInit({ artifacts: flags.has("artifacts"), force: flags.has("force") });

package/dist/cli.js

@@ -7,6 +7,7 @@ import {
   configPath,
   cwdKey,
   defaultConfig,
+  describeExcluded,
   ensureGitignoreEntries,
   findProjectRoot,
   formatBytes,
@@ -19,7 +20,7 @@ import {
   storeDir,
   summarize,
   userClaudeDir
-} from "./chunk-DEH5MUFT.js";
+} from "./chunk-BWATZKYM.js";
 
 // src/commands.ts
 import fs from "fs";
@@ -129,6 +130,13 @@ function cmdPush(opts = {}) {
   if (skippedTracked.length > 0) {
     lines.push("", `${skippedTracked.length} project files skipped \u2014 git already tracks them.`);
   }
+  const excluded = describeExcluded(root, tiers);
+  if (excluded.length > 0) {
+    lines.push("", "Not included (by design):");
+    for (const g of excluded) {
+      lines.push(`  ${g.label.padEnd(22)} ${formatBytes(g.bytes).padStart(9)}  ${g.reason}`);
+    }
+  }
   if (!opts.dryRun) {
     lines.push("", "Commit .contextsync/ to carry this context with the repo.");
   }
@@ -248,7 +256,7 @@ function parseArgs(argv) {
 function run(argv) {
   const { command, flags } = parseArgs(argv);
   if (flags.has("h") || flags.has("help")) return { code: 0, lines: [USAGE] };
-  if (flags.has("v") || flags.has("version")) return { code: 0, lines: ["0.1.0"] };
+  if (flags.has("v") || flags.has("version")) return { code: 0, lines: ["0.1.1"] };
   switch (command) {
     case "init":
       return cmdInit({ artifacts: flags.has("artifacts"), force: flags.has("force") });

package/dist/index.cjs

@@ -299,12 +299,41 @@ var PROJECT_CONTEXT_GLOBS = [
   ".cursorrules",
   ".github/copilot-instructions.md",
   ".claude/settings.json",
+  // `.local.json` variants are gitignored by default, so nothing else carries
+  // them — which makes them exactly the kind of file this tool exists for.
+  ".claude/settings.local.json",
   ".claude/memory/",
   ".claude/plans/",
   ".claude/commands/",
   ".claude/agents/",
   ".claude/skills/"
 ];
+function planStem(fileName) {
+  return fileName.replace(/\.md$/, "").replace(/-agent-[0-9a-f]+$/i, "");
+}
+function collectPlans(plansDir, projectRoot, exclude) {
+  const all = walk(plansDir, { exclude });
+  if (all.length === 0) return [];
+  const projectName = import_node_path3.default.basename(projectRoot);
+  const related = /* @__PURE__ */ new Set();
+  const stems = /* @__PURE__ */ new Set();
+  for (const abs of all) {
+    let text = "";
+    try {
+      text = import_node_fs3.default.readFileSync(abs, "utf8");
+    } catch {
+      continue;
+    }
+    if (text.includes(projectRoot) || text.includes(projectName)) {
+      related.add(abs);
+      stems.add(planStem(import_node_path3.default.basename(abs)));
+    }
+  }
+  for (const abs of all) {
+    if (stems.has(planStem(import_node_path3.default.basename(abs)))) related.add(abs);
+  }
+  return [...related];
+}
 function push(out, sourcePath, storePath, tier, sourceRoot, ctx) {
   let size = 0;
   try {
@@ -339,10 +368,24 @@ function collect(projectRoot, cfg, tiers) {
       }
       push(files, abs, `project/${rel}`, "core", "project", ctx);
     }
-    const memoryDir = import_node_path3.default.join(userClaude, "projects", key, "memory");
-    for (const abs of walk(memoryDir, { exclude })) {
-      const rel = toPosix(import_node_path3.default.relative(memoryDir, abs));
-      push(files, abs, `memory/${rel}`, "core", "user", ctx);
+    const projectsDir = import_node_path3.default.join(userClaude, "projects");
+    let projectKeys = [];
+    try {
+      projectKeys = import_node_fs3.default.readdirSync(projectsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && (d.name === key || d.name.startsWith(key + "-"))).map((d) => d.name);
+    } catch {
+      projectKeys = [];
+    }
+    for (const pk of projectKeys) {
+      const memoryDir = import_node_path3.default.join(projectsDir, pk, "memory");
+      for (const abs of walk(memoryDir, { exclude })) {
+        const rel = toPosix(import_node_path3.default.relative(memoryDir, abs));
+        const storePath = pk === key ? `memory/${rel}` : `memory-sub/${pk.slice(key.length + 1)}/${rel}`;
+        push(files, abs, storePath, "core", "user", ctx);
+      }
+    }
+    for (const abs of collectPlans(import_node_path3.default.join(userClaude, "plans"), projectRoot, exclude)) {
+      const rel = toPosix(import_node_path3.default.relative(import_node_path3.default.join(userClaude, "plans"), abs));
+      push(files, abs, `plans/${rel}`, "core", "user", ctx);
     }
     const skillsDir = import_node_path3.default.join(userClaude, "skills");
     for (const abs of walk(skillsDir, { exclude })) {

package/dist/index.js

@@ -31,7 +31,7 @@ import {
   summarize,
   userClaudeDir,
   walk
-} from "./chunk-DEH5MUFT.js";
+} from "./chunk-BWATZKYM.js";
 export {
   ALL_TIERS,
   CONFIG_FILE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tricknowtech/context",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Carry a project's LLM context — memory, skills, instructions and session handoff — between machines. Local-first, commit it to your repo.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -14,8 +14,8 @@
     }
   },
   "bin": {
-    "ctx": "./dist/cli.js",
-    "tricknowtech-context": "./dist/cli.js"
+    "ctx": "dist/cli.js",
+    "tricknowtech-context": "dist/cli.js"
   },
   "files": [
     "dist"