spacecode 2.7.0 → 2.8.1

package/dist/repl.mjs

@@ -1283,26 +1283,26 @@ var require_react_development = __commonJS({
           }
           return lazyType;
         }
-        function forwardRef2(render3) {
+        function forwardRef2(render4) {
           {
-            if (render3 != null && render3.$$typeof === REACT_MEMO_TYPE) {
+            if (render4 != null && render4.$$typeof === REACT_MEMO_TYPE) {
               error("forwardRef requires a render function but received a `memo` component. Instead of forwardRef(memo(...)), use memo(forwardRef(...)).");
-            } else if (typeof render3 !== "function") {
-              error("forwardRef requires a render function but was given %s.", render3 === null ? "null" : typeof render3);
+            } else if (typeof render4 !== "function") {
+              error("forwardRef requires a render function but was given %s.", render4 === null ? "null" : typeof render4);
             } else {
-              if (render3.length !== 0 && render3.length !== 2) {
-                error("forwardRef render functions accept exactly two parameters: props and ref. %s", render3.length === 1 ? "Did you forget to use the ref parameter?" : "Any additional parameter will be undefined.");
+              if (render4.length !== 0 && render4.length !== 2) {
+                error("forwardRef render functions accept exactly two parameters: props and ref. %s", render4.length === 1 ? "Did you forget to use the ref parameter?" : "Any additional parameter will be undefined.");
               }
             }
-            if (render3 != null) {
-              if (render3.defaultProps != null || render3.propTypes != null) {
+            if (render4 != null) {
+              if (render4.defaultProps != null || render4.propTypes != null) {
                 error("forwardRef render functions do not support propTypes or defaultProps. Did you accidentally pass a React component?");
               }
             }
           }
           var elementType = {
             $$typeof: REACT_FORWARD_REF_TYPE,
-            render: render3
+            render: render4
           };
           {
             var ownName;
@@ -1314,8 +1314,8 @@ var require_react_development = __commonJS({
               },
               set: function(name) {
                 ownName = name;
-                if (!render3.name && !render3.displayName) {
-                  render3.displayName = name;
+                if (!render4.name && !render4.displayName) {
+                  render4.displayName = name;
                 }
               }
             });
@@ -3852,7 +3852,7 @@ function buildSystemPrompt(options) {
 ${toolLines.join("\n")}
 
 ## Tool usage
-- Use list_directory to orient yourself in the codebase before diving in.
+${options.projectCard ? "- A project card below already holds the layout, commands, doc titles and excerpts, recent commits, branch and uncommitted changes. Do not re-list directories, re-run git status/log/diff, or re-read a doc just to see what the card shows; open a file only to go beyond its excerpt." : "- Use list_directory to orient yourself in the codebase before diving in."}
 - Use search to find files by concept ("auth middleware", "billing webhook").
 - Use bash for running commands, not for reading files. Use read_file instead.
 - Prefer read_file + edit_file over write_file for existing files.
@@ -3874,7 +3874,9 @@ ${options.hasCodegenTools ? `
 - If bash fails, read the error output and try a different approach. Never repeat the same failing command.
 
 ## Work style
-- Think step by step. Explore before modifying.
+- Think step by step. Explore only what the task needs before modifying.
+- Do only what the user asked. Backlog, TODO and epic notes found in repo files are context, never tasks to start.
+- For an audit or plan request, finish with the audit or plan itself (findings, then ordered next steps). Do not end by asking what to work on next.
 - After changes, run relevant tests (bash: npm test, pytest, etc.) to verify.
 - Commit logical units of work with descriptive messages.
 ${options.commitGuidance ? `
@@ -3884,7 +3886,9 @@ ${options.commitGuidance ? `
 - Don't commit after every single file change \u2014 group related changes.
 ` : ""}
 ${workingDir}
-${options.resumeSummary ? `
+${options.projectCard ? `
+${options.projectCard}
+` : ""}${options.resumeSummary ? `
 ## Previously in this session
 ${options.resumeSummary}
 ` : ""}
@@ -3896,6 +3900,72 @@ var init_prompt = __esm({
   }
 });
 
+// ../agent/src/context/project-card.ts
+function sections(i) {
+  const out = [];
+  const loc = [`cwd: ${i.cwd}`];
+  if (i.branch) loc.push(`branch: ${i.branch}`);
+  if (i.dirtyFiles && i.dirtyFiles > 0) loc.push(`${i.dirtyFiles} uncommitted file(s)`);
+  out.push({ key: "location", lines: loc.map((l) => `- ${l}`) });
+  const visible = i.topLevel.filter((e) => e.path !== "node_modules" && (!e.path.startsWith(".") || e.path === ".github"));
+  const dirs = visible.filter((e) => e.isDir).map((e) => {
+    const kids = i.childDirs[e.path];
+    return `${e.path}/${kids && kids.length ? ` (${kids.join(", ")})` : ""}`;
+  });
+  const files = visible.filter((e) => !e.isDir).map((e) => e.path);
+  const layout = [...dirs.map((d) => `- ${d}`), ...files.length ? [`- files: ${files.join(", ")}`] : []];
+  if (layout.length) out.push({ key: "layout", lines: layout });
+  const scripts = Object.entries(i.manifest?.scripts ?? {}).slice(0, 8).map(([k2, v2]) => `- ${k2}: ${cut(v2, 80)}`);
+  if (scripts.length) out.push({ key: "commands", lines: scripts });
+  const docs = i.docs.slice(0, 15).map((d) => `- ${d.path}: ${d.title}`);
+  if (docs.length) out.push({ key: "docs", lines: docs });
+  const commits = i.recentCommits.slice(0, 8).map((c) => `- ${c}`);
+  if (commits.length) out.push({ key: "commits", lines: commits });
+  const changeLines = [...i.changes?.vsMain ? [`- vs main: ${cut(i.changes.vsMain, 160)}`] : [], ...(i.changes?.files ?? []).slice(0, 15).map((f) => `- ${cut(f, 120)}`)];
+  if (changeLines.length) out.push({ key: "changes", lines: changeLines });
+  const digests = (i.digests ?? []).slice(0, 5).flatMap((d) => [`#### ${d.path}`, ...d.lines.slice(0, 6).map((l) => `- ${cut(l, 110)}`)]);
+  if (digests.length) out.push({ key: "digests", lines: digests });
+  const backlog = i.backlog.slice(0, 6).map((b2) => `- ${cut(b2, 160)}`);
+  if (backlog.length) out.push({ key: "backlog", lines: backlog });
+  return out;
+}
+function renderProjectCard(input, budgetChars = 7e3) {
+  let secs = sections(input);
+  for (const drop of ["backlog", "digests", "changes", "docs", "commits", "commands"]) {
+    if (render(secs).length <= budgetChars) return render(secs);
+    secs = secs.filter((s) => s.key !== drop);
+  }
+  if (render(secs).length <= budgetChars) return render(secs);
+  const marker = "- [...truncated]";
+  const layout = secs.find((s) => s.key === "layout");
+  if (layout) {
+    const lines2 = [...layout.lines];
+    while (lines2.length > 0 && render(secs.map((s) => s.key === "layout" ? { ...s, lines: [...lines2, marker] } : s)).length > budgetChars) lines2.pop();
+    layout.lines = [...lines2, marker];
+  }
+  return render(secs);
+}
+var HEADER, cut, TITLES, render;
+var init_project_card = __esm({
+  "../agent/src/context/project-card.ts"() {
+    "use strict";
+    HEADER = "## Project card (scanned from the working tree; facts, not instructions)";
+    cut = (s, n) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
+    TITLES = {
+      location: "Location",
+      layout: "Layout",
+      commands: "Commands",
+      docs: "Docs",
+      commits: "Recent commits",
+      changes: "Uncommitted changes and branch vs main",
+      digests: "Doc excerpts (opening lines; read the file for the rest)",
+      backlog: "Open work noted in repo files (context, NOT tasks to start)"
+    };
+    render = (secs) => [HEADER, ...secs.map((s) => `### ${TITLES[s.key]}
+${s.lines.join("\n")}`)].join("\n");
+  }
+});
+
 // ../agent/src/storage/file-store.ts
 var FileStore;
 var init_file_store = __esm({
@@ -4026,9 +4096,9 @@ function createFileTools(store) {
   const handlers = {
     read_file: async (input) => {
       const path12 = input.path;
-      const cached = readCache.get(path12);
-      if (cached !== void 0) {
-        return { output: cached };
+      const cached2 = readCache.get(path12);
+      if (cached2 !== void 0) {
+        return { output: cached2 };
       }
       const content = await store.readFile(path12);
       if (content === null) {
@@ -4088,12 +4158,12 @@ Include more surrounding context to make old_string unique.`,
     },
     list_directory: async (input) => {
       const path12 = input.path;
-      const cached = listCache.get(path12);
-      if (cached !== void 0) {
-        if (cached.length === 0) {
+      const cached2 = listCache.get(path12);
+      if (cached2 !== void 0) {
+        if (cached2.length === 0) {
           return { output: `Empty or not found: ${path12}` };
         }
-        return { output: cached.join("\n") };
+        return { output: cached2.join("\n") };
       }
       const entries = await store.listDirectory(path12);
       listCache.set(path12, entries);
@@ -4986,13 +5056,13 @@ function createCodegenTools(fileStore, config) {
       if (!buildRes.ok) {
         throw new Error(`Failed to fetch build result: ${buildRes.status}`);
       }
-      const build = await buildRes.json();
-      if (!build.result) {
+      const build2 = await buildRes.json();
+      if (!build2.result) {
         throw new Error("Build completed but no files in result");
       }
       let files;
       try {
-        const parsed = JSON.parse(build.result);
+        const parsed = JSON.parse(build2.result);
         files = parsed.files ?? [];
       } catch {
         throw new Error("Failed to parse build result");
@@ -5705,9 +5775,9 @@ async function sha256(content) {
   const hashArray = new Uint8Array(hashBuffer);
   return Array.from(hashArray).map((b2) => b2.toString(16).padStart(2, "0")).join("");
 }
-async function computeLockfileHash(readFile9) {
+async function computeLockfileHash(readFile10) {
   for (const name of LOCKFILES) {
-    const content = await readFile9(name);
+    const content = await readFile10(name);
     if (content) {
       const hash = await sha256(content);
       return hash.slice(0, 12);
@@ -5782,25 +5852,25 @@ function stripCodeFence(raw) {
   return fenced ? fenced[1].trim() : trimmed;
 }
 function buildSummaryText(decisions, workItems) {
-  const sections = [];
+  const sections2 = [];
   if (decisions.length > 0) {
-    sections.push(
+    sections2.push(
       ["Decisions:", ...decisions.map((d) => `- ${d.description}`)].join("\n")
     );
   }
   const openItems = workItems.filter((item) => item.status === "open");
   if (openItems.length > 0) {
-    sections.push(
+    sections2.push(
       ["Open work items:", ...openItems.map((item) => `- ${item.description}`)].join("\n")
     );
   }
   const doneItems = workItems.filter((item) => item.status === "done");
   if (doneItems.length > 0) {
-    sections.push(
+    sections2.push(
       ["Completed this session:", ...doneItems.map((item) => `- ${item.description}`)].join("\n")
     );
   }
-  return sections.join("\n\n");
+  return sections2.join("\n\n");
 }
 async function summarizeConversation(messages, config) {
   if (messages.length === 0) {
@@ -6463,8 +6533,8 @@ function createProfileClient({ baseUrl, apiKey, fetch: doFetch, timeoutMs = 8e3
       }
     },
     /** Asks the server-side classifier to decide keep/on_demand/drop per section (see adapt-plan.ts). */
-    async adapt(sections) {
-      const res = await call("POST", "/adapt", { body: { sections }, timeoutMs: ADAPT_TIMEOUT_MS });
+    async adapt(sections2) {
+      const res = await call("POST", "/adapt", { body: { sections: sections2 }, timeoutMs: ADAPT_TIMEOUT_MS });
       return await res.json();
     },
     /** Deletes one asset; false when it did not exist. */
@@ -6580,17 +6650,17 @@ var init_memory_tool = __esm({
 // ../agent/src/import/profile-loader.ts
 async function loadProfile(opts) {
   const { client, cache: cache4, projectKeys } = opts;
-  let cached = null;
+  let cached2 = null;
   let cacheError;
   try {
-    cached = await cache4.read();
+    cached2 = await cache4.read();
   } catch (err) {
     cacheError = `profile cache unreadable: ${err instanceof Error ? err.message : String(err)}`;
   }
-  const sameProject = cached !== null && cached.projectKey !== null && projectKeys.includes(cached.projectKey);
+  const sameProject = cached2 !== null && cached2.projectKey !== null && projectKeys.includes(cached2.projectKey);
   try {
-    const index = await client.index(sameProject ? cached.version : void 0);
-    if (index === null && sameProject) return { profile: cached, source: "live" };
+    const index = await client.index(sameProject ? cached2.version : void 0);
+    if (index === null && sameProject) return { profile: cached2, source: "live" };
     if (index === null) throw new Error("profile API answered 304 with no usable cached copy");
     const has2 = (kind, name) => index.assets.some((a) => a.kind === kind && a.name === name);
     const chosen = projectKeys.find((k2) => has2("memory", `${k2}.index`)) ?? null;
@@ -6612,8 +6682,8 @@ async function loadProfile(opts) {
     return { profile, source: "live", ...cacheError ? { error: cacheError } : {} };
   } catch (err) {
     const error = `${err instanceof Error ? err.message : String(err)}${cacheError ? `; ${cacheError}` : ""}`;
-    if (!cached) return { profile: null, source: "none", error };
-    return { profile: sameProject ? cached : { ...cached, memoryIndex: null, projectKey: null }, source: "cache", error };
+    if (!cached2) return { profile: null, source: "none", error };
+    return { profile: sameProject ? cached2 : { ...cached2, memoryIndex: null, projectKey: null }, source: "cache", error };
   }
 }
 var init_profile_loader = __esm({
@@ -6645,14 +6715,14 @@ function splitSections(text) {
   });
   if (starts.length === 0) return { preamble: text, sections: [] };
   const taken = /* @__PURE__ */ new Set();
-  const sections = starts.map((start, k2) => {
+  const sections2 = starts.map((start, k2) => {
     const end = k2 + 1 < starts.length ? starts[k2 + 1] : lines2.length;
     const chunk = lines2.slice(start, end).join("\n") + (end < lines2.length ? "\n" : "");
     const title = lines2[start].slice(3).trim();
     return { title, slug: slugify(title, taken), text: chunk };
   });
   const preamble = starts[0] === 0 ? "" : lines2.slice(0, starts[0]).join("\n") + "\n";
-  return { preamble, sections };
+  return { preamble, sections: sections2 };
 }
 function joinSections(split) {
   return split.preamble + split.sections.map((s) => s.text).join("");
@@ -6712,11 +6782,11 @@ function prepareAdaptation(original) {
     return r.text;
   };
   const preamble = tr(split.preamble);
-  const sections = split.sections.map((s) => {
+  const sections2 = split.sections.map((s) => {
     const text = tr(s.text);
     return { slug: s.slug, title: s.title, chars: text.length, unsupported: findUnsupported(text), text };
   });
-  return { preamble, sections, replaced: [...replaced.values()] };
+  return { preamble, sections: sections2, replaced: [...replaced.values()] };
 }
 function applyPlan(input, decisions, maxCoreChars = MAX_CORE_CHARS) {
   const bySlug = new Map(input.sections.map((s) => [s.slug, s]));
@@ -7695,6 +7765,7 @@ __export(src_exports, {
   prepareAdaptation: () => prepareAdaptation,
   projectKey: () => projectKey,
   readClaudeAssets: () => readClaudeAssets,
+  renderProjectCard: () => renderProjectCard,
   runAgentLoop: () => runAgentLoop,
   safeSkillPath: () => safeSkillPath,
   serializeImportsConfig: () => serializeImportsConfig,
@@ -7712,6 +7783,7 @@ var init_src = __esm({
     init_context_window();
     init_bash();
     init_prompt();
+    init_project_card();
     init_file_store();
     init_files();
     init_indexer();
@@ -7772,7 +7844,7 @@ __export(api_key_exports, {
 });
 import { join } from "node:path";
 async function resolveApiKey(deps) {
-  const { env: env3, readFile: readFile9, homedir: homedir3 } = deps;
+  const { env: env3, readFile: readFile10, homedir: homedir3 } = deps;
   for (const name of ["SPACECODE_API_KEY", "ANTHROPIC_API_KEY"]) {
     const value = env3[name]?.trim();
     if (value) return value;
@@ -7781,7 +7853,7 @@ async function resolveApiKey(deps) {
   const file = join(dir, "auth.json");
   let raw;
   try {
-    raw = await readFile9(file);
+    raw = await readFile10(file);
   } catch (err) {
     if (err.code === "ENOENT") return null;
     throw new Error(`Cannot read ${file}: ${err instanceof Error ? err.message : String(err)}`);
@@ -9122,11 +9194,11 @@ var init_base = __esm({
       }
       const parts = os.release().split(".");
       const major = Number(parts[0]);
-      const build = Number(parts[2] ?? 0);
+      const build2 = Number(parts[2] ?? 0);
       if (major < 10) {
         return true;
       }
-      if (major === 10 && build < 10586) {
+      if (major === 10 && build2 < 10586) {
         return true;
       }
       return false;
@@ -24121,7 +24193,7 @@ var require_react_reconciler_development = __commonJS({
               }
             }
           }
-          var render3 = Component.render;
+          var render4 = Component.render;
           var ref = workInProgress2.ref;
           var nextChildren;
           var hasId;
@@ -24132,12 +24204,12 @@ var require_react_reconciler_development = __commonJS({
           {
             ReactCurrentOwner$1.current = workInProgress2;
             setIsRendering(true);
-            nextChildren = renderWithHooks(current2, workInProgress2, render3, nextProps, ref, renderLanes2);
+            nextChildren = renderWithHooks(current2, workInProgress2, render4, nextProps, ref, renderLanes2);
             hasId = checkDidRenderIdHook();
             if (workInProgress2.mode & StrictLegacyMode) {
               setIsStrictModeForDevtools(true);
               try {
-                nextChildren = renderWithHooks(current2, workInProgress2, render3, nextProps, ref, renderLanes2);
+                nextChildren = renderWithHooks(current2, workInProgress2, render4, nextProps, ref, renderLanes2);
                 hasId = checkDidRenderIdHook();
               } finally {
                 setIsStrictModeForDevtools(false);
@@ -25491,9 +25563,9 @@ var require_react_reconciler_development = __commonJS({
             }
           }
           var newProps = workInProgress2.pendingProps;
-          var render3 = newProps.children;
+          var render4 = newProps.children;
           {
-            if (typeof render3 !== "function") {
+            if (typeof render4 !== "function") {
               error("A context consumer was rendered with multiple children, or a child that isn't a function. A context consumer expects a single child that is a function. If you did pass a function, make sure there is no trailing or leading whitespace around it.");
             }
           }
@@ -25506,7 +25578,7 @@ var require_react_reconciler_development = __commonJS({
           {
             ReactCurrentOwner$1.current = workInProgress2;
             setIsRendering(true);
-            newChildren = render3(newValue);
+            newChildren = render4(newValue);
             setIsRendering(false);
           }
           {
@@ -38606,7 +38678,7 @@ var init_log_update = __esm({
       let previousLineCount = 0;
       let previousOutput = "";
       let hasHiddenCursor = false;
-      const render3 = (str) => {
+      const render4 = (str) => {
         if (!showCursor && !hasHiddenCursor) {
           cli_cursor_default.hide();
           hasHiddenCursor = true;
@@ -38619,12 +38691,12 @@ var init_log_update = __esm({
         stream.write(base_exports.eraseLines(previousLineCount) + output);
         previousLineCount = output.split("\n").length;
       };
-      render3.clear = () => {
+      render4.clear = () => {
         stream.write(base_exports.eraseLines(previousLineCount));
         previousOutput = "";
         previousLineCount = 0;
       };
-      render3.done = () => {
+      render4.done = () => {
         previousOutput = "";
         previousLineCount = 0;
         if (!showCursor) {
@@ -38632,7 +38704,7 @@ var init_log_update = __esm({
           hasHiddenCursor = false;
         }
       };
-      return render3;
+      return render4;
     };
     logUpdate = { create };
     log_update_default = logUpdate;
@@ -39765,12 +39837,12 @@ var init_ink = __esm({
 // ../../node_modules/ink/build/render.js
 import { Stream } from "node:stream";
 import process12 from "node:process";
-var render, render_default, getOptions, getInstance;
+var render2, render_default, getOptions, getInstance;
 var init_render = __esm({
   async "../../node_modules/ink/build/render.js"() {
     await init_ink();
     init_instances();
-    render = (node, options) => {
+    render2 = (node, options) => {
       const inkOptions = {
         stdout: process12.stdout,
         stdin: process12.stdin,
@@ -39792,7 +39864,7 @@ var init_render = __esm({
         clear: instance.clear
       };
     };
-    render_default = render;
+    render_default = render2;
     getOptions = (stdout = {}) => {
       if (stdout instanceof Stream) {
         return {
@@ -39815,7 +39887,7 @@ var init_render = __esm({
 
 // ../../node_modules/ink/build/components/Static.js
 function Static(props) {
-  const { items, children: render3, style: customStyle } = props;
+  const { items, children: render4, style: customStyle } = props;
   const [index, setIndex] = (0, import_react11.useState)(0);
   const itemsToRender = (0, import_react11.useMemo)(() => {
     return items.slice(index);
@@ -39824,7 +39896,7 @@ function Static(props) {
     setIndex(items.length);
   }, [items.length]);
   const children = itemsToRender.map((item, itemIndex) => {
-    return render3(item, index + itemIndex);
+    return render4(item, index + itemIndex);
   });
   const style = (0, import_react11.useMemo)(() => ({
     position: "absolute",
@@ -42932,7 +43004,7 @@ var require_colors = __commonJS({
       }
       return str.replace(matchOperatorsRe, "\\$&");
     };
-    function build(_styles) {
+    function build2(_styles) {
       var builder = function builder2() {
         return applyStyle2.apply(builder2, arguments);
       };
@@ -42947,7 +43019,7 @@ var require_colors = __commonJS({
         ansiStyles3[key].closeRe = new RegExp(escapeStringRegexp(ansiStyles3[key].close), "g");
         ret[key] = {
           get: function() {
-            return build(this._styles.concat(key));
+            return build2(this._styles.concat(key));
           }
         };
       });
@@ -43006,7 +43078,7 @@ var require_colors = __commonJS({
       Object.keys(styles5).forEach(function(name) {
         ret[name] = {
           get: function() {
-            return build([name]);
+            return build2([name]);
           }
         };
       });
@@ -44010,7 +44082,7 @@ var require_core = __commonJS({
       return match && match.index === 0;
     }
     var BACKREF_RE = /\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./;
-    function join12(regexps, separator = "|") {
+    function join13(regexps, separator = "|") {
       let numCaptures = 0;
       return regexps.map((regex2) => {
         numCaptures += 1;
@@ -44314,7 +44386,7 @@ var require_core = __commonJS({
             this.exec = () => null;
           }
           const terminators = this.regexes.map((el) => el[1]);
-          this.matcherRe = langRe(join12(terminators), true);
+          this.matcherRe = langRe(join13(terminators), true);
           this.lastIndex = 0;
         }
         /** @param {string} s */
@@ -44609,7 +44681,7 @@ var require_core = __commonJS({
       function close(node) {
         result += "</" + tag(node) + ">";
       }
-      function render3(event) {
+      function render4(event) {
         (event.event === "start" ? open3 : close)(event.node);
       }
       while (original.length || highlighted.length) {
@@ -44619,7 +44691,7 @@ var require_core = __commonJS({
         if (stream === original) {
           nodeStack.reverse().forEach(close);
           do {
-            render3(stream.splice(0, 1)[0]);
+            render4(stream.splice(0, 1)[0]);
             stream = selectStream();
           } while (stream === original && stream.length && stream[0].offset === processed);
           nodeStack.reverse().forEach(open3);
@@ -44629,7 +44701,7 @@ var require_core = __commonJS({
           } else {
             nodeStack.pop();
           }
-          render3(stream.splice(0, 1)[0]);
+          render4(stream.splice(0, 1)[0]);
         }
       }
       return result + escapeHTML(value.substr(processed));
@@ -52094,7 +52166,7 @@ var require_markdown = __commonJS({
       BOLD.contains = BOLD.contains.concat(CONTAINABLE);
       ITALIC.contains = ITALIC.contains.concat(CONTAINABLE);
       CONTAINABLE = CONTAINABLE.concat(BOLD, ITALIC);
-      const HEADER = {
+      const HEADER2 = {
         className: "section",
         variants: [
           {
@@ -52131,7 +52203,7 @@ var require_markdown = __commonJS({
           "mkd"
         ],
         contains: [
-          HEADER,
+          HEADER2,
           INLINE_HTML,
           LIST,
           BOLD,
@@ -56178,7 +56250,7 @@ var require_http = __commonJS({
     function http(hljs) {
       const VERSION = "HTTP/(2|1\\.[01])";
       const HEADER_NAME = /[A-Za-z][A-Za-z0-9-]*/;
-      const HEADER = {
+      const HEADER2 = {
         className: "attribute",
         begin: concat("^", HEADER_NAME, "(?=\\:\\s)"),
         starts: {
@@ -56196,7 +56268,7 @@ var require_http = __commonJS({
         }
       };
       const HEADERS_AND_BODY = [
-        HEADER,
+        HEADER2,
         {
           begin: "\\n\\n",
           starts: { subLanguage: [], endsWithParent: true }
@@ -56255,7 +56327,7 @@ var require_http = __commonJS({
             }
           },
           // to allow headers to work even without a preamble
-          hljs.inherit(HEADER, {
+          hljs.inherit(HEADER2, {
             relevance: 0
           })
         ]
@@ -99376,8 +99448,8 @@ function markedTerminal(options, highlightOptions) {
   );
 }
 function reflowText(text, width, gfm) {
-  var splitRe = gfm ? HARD_RETURN_GFM_RE : HARD_RETURN_RE, sections = text.split(splitRe), reflowed = [];
-  sections.forEach(function(section2) {
+  var splitRe = gfm ? HARD_RETURN_GFM_RE : HARD_RETURN_RE, sections2 = text.split(splitRe), reflowed = [];
+  sections2.forEach(function(section2) {
     var fragments = section2.split(/(\u001b\[(?:\d{1,3})(?:;\d{1,3})*m)/g);
     var column = 0;
     var currentLine = "";
@@ -103628,6 +103700,161 @@ var init_local_toolset = __esm({
   }
 });
 
+// src/project-card-scan.ts
+import { execFile as execFile3 } from "node:child_process";
+import { readdir as readdir3, readFile as readFile4 } from "node:fs/promises";
+import { join as join7 } from "node:path";
+function digestLines(md) {
+  return md.split("\n").map((l) => l.trim()).filter((l) => l && !/^#\s/.test(l) && !/^[|\s:-]+$/.test(l) && !/^\|\s*(area|task|priority|date|issue|id)\b/i.test(l)).slice(0, 12);
+}
+function firstHeading(md) {
+  for (const line of md.split("\n", 40)) {
+    const m2 = /^#{1,3}\s+(.+?)\s*$/.exec(line);
+    if (m2) return m2[1];
+  }
+  return null;
+}
+function backlogLines(todo) {
+  const out = [];
+  for (const raw of todo.split("\n")) {
+    const line = raw.trim();
+    if (!line || /^[|\s:-]+$/.test(line) || /^\|\s*(area|task|priority)\b/i.test(line)) continue;
+    const row = /^\|\s*([^|]+?)\s*\|/.exec(line);
+    const bullet = /^[-*]\s+(?:\[[ x]\]\s*)?(.+)$/.exec(line);
+    const text = row?.[1] ?? bullet?.[1];
+    if (text && text.length > 8) out.push(text);
+    if (out.length >= MAX_BACKLOG) break;
+  }
+  return out;
+}
+async function scanProject(cwd2, io = nodeScanIo) {
+  const problems = [];
+  const attempt = async (label, fn, fallback) => {
+    try {
+      return await fn();
+    } catch (err) {
+      problems.push(`${label}: ${err instanceof Error ? err.message : String(err)}`);
+      return fallback;
+    }
+  };
+  const root = await attempt("list root", () => io.readdir(cwd2), []);
+  const topLevel = root.filter((e) => !SKIP.has(e.name)).map((e) => ({ path: e.name, isDir: e.isDir }));
+  const childDirs = {};
+  for (const d of topLevel.filter((e) => e.isDir && ["apps", "packages", "services", "libs", "src"].includes(e.path))) {
+    const kids = await attempt(`list ${d.path}`, () => io.readdir(join7(cwd2, d.path)), []);
+    childDirs[d.path] = kids.filter((k2) => !SKIP.has(k2.name) && !k2.name.startsWith(".")).map((k2) => k2.isDir ? k2.name : k2.name).slice(0, 20);
+  }
+  let manifest;
+  const pkgText = await attempt("read package.json", () => io.readFile(join7(cwd2, "package.json")), null);
+  if (pkgText) {
+    try {
+      const pkg = JSON.parse(pkgText);
+      manifest = {
+        ...pkg.name ? { name: pkg.name } : {},
+        ...pkg.scripts ? { scripts: pkg.scripts } : {},
+        ...Array.isArray(pkg.workspaces) ? { workspaces: pkg.workspaces } : pkg.workspaces?.packages ? { workspaces: pkg.workspaces.packages } : {}
+      };
+    } catch (err) {
+      problems.push(`parse package.json: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  const docs = [];
+  for (const e of topLevel.filter((t) => !t.isDir && /\.md$/i.test(t.path)).slice(0, MAX_DOCS)) {
+    const text = await attempt(`read ${e.path}`, () => io.readFile(join7(cwd2, e.path)), null);
+    const title = text ? firstHeading(text) : null;
+    if (title) docs.push({ path: e.path, title });
+  }
+  const digests = [];
+  for (const name of DIGEST_FILES.filter((n) => topLevel.some((t) => t.path === n))) {
+    const text = await attempt(`read ${name}`, () => io.readFile(join7(cwd2, name)), null);
+    const lines2 = text ? digestLines(text) : [];
+    if (lines2.length) digests.push({ path: name, lines: lines2 });
+  }
+  const todo = await attempt("read TODO.md", () => io.readFile(join7(cwd2, "TODO.md")), null);
+  const log = await io.git(cwd2, ["log", "--oneline", "-8"]);
+  const status = await io.git(cwd2, ["status", "--porcelain"]);
+  const branch = await io.git(cwd2, ["rev-parse", "--abbrev-ref", "HEAD"]);
+  const onBranch = branch?.trim();
+  const vsMainRaw = onBranch && onBranch !== "main" && onBranch !== "HEAD" ? await io.git(cwd2, ["diff", "--shortstat", "main...HEAD"]) : null;
+  const vsMain = vsMainRaw?.trim() ? `${vsMainRaw.trim()} (branch ${onBranch})` : void 0;
+  return {
+    problems,
+    input: {
+      cwd: cwd2,
+      ...branch?.trim() ? { branch: branch.trim() } : {},
+      ...status !== null ? { dirtyFiles: status.split("\n").filter(Boolean).length } : {},
+      ...manifest ? { manifest } : {},
+      topLevel,
+      childDirs,
+      recentCommits: (log ?? "").split("\n").filter(Boolean),
+      docs,
+      backlog: todo ? backlogLines(todo) : [],
+      changes: { files: (status ?? "").split("\n").filter(Boolean), ...vsMain ? { vsMain } : {} },
+      digests
+    }
+  };
+}
+var SKIP, MAX_DOCS, MAX_BACKLOG, DIGEST_FILES, nodeScanIo;
+var init_project_card_scan = __esm({
+  "src/project-card-scan.ts"() {
+    "use strict";
+    SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", ".next", ".wrangler", ".turbo", "coverage", ".worktrees", ".superpowers", ".remember"]);
+    MAX_DOCS = 15;
+    MAX_BACKLOG = 6;
+    DIGEST_FILES = ["CLAUDE.md", "TODO.md", "BUGS.md", "ISSUES.md", "CHANGELOG.md", "README.md"];
+    nodeScanIo = {
+      async readdir(path12) {
+        const entries = await readdir3(path12, { withFileTypes: true });
+        return entries.map((e) => ({ name: e.name, isDir: e.isDirectory() }));
+      },
+      async readFile(path12) {
+        try {
+          return await readFile4(path12, "utf8");
+        } catch (err) {
+          if (err.code === "ENOENT") return null;
+          throw err;
+        }
+      },
+      git: (cwd2, args) => new Promise((resolve2) => {
+        execFile3("git", args, { cwd: cwd2, timeout: 3e3, maxBuffer: 256 * 1024 }, (err, stdout) => resolve2(err ? null : stdout));
+      })
+    };
+  }
+});
+
+// src/project-card-runtime.ts
+async function build(cwd2, io) {
+  try {
+    const { input, problems } = await scanProject(cwd2, io);
+    const text = renderProjectCard(input);
+    return {
+      text,
+      statusLine: `project card: ${text.length} chars, ${input.topLevel.length} top-level entries${problems.length ? `, ${problems.length} scan problem(s): ${problems.join("; ")}` : ""}`
+    };
+  } catch (err) {
+    console.error("[project-card] scan failed; the REPL runs without a card", err instanceof Error ? err.message : String(err));
+    return { text: "", statusLine: `project card: not built (${err instanceof Error ? err.message : String(err)})` };
+  }
+}
+function loadProjectCard(cwd2, deps = {}) {
+  const env3 = deps.env ?? process.env;
+  const now = deps.now ?? Date.now;
+  if (env3.SPACECODE_PROJECT_CARD === "off") return Promise.resolve({ text: "", statusLine: "project card: disabled (SPACECODE_PROJECT_CARD=off)" });
+  if (cached && cached.cwd === cwd2 && now() - cached.at < TTL_MS) return cached.pending;
+  const pending = build(cwd2, deps.io ?? nodeScanIo);
+  cached = { cwd: cwd2, at: now(), pending };
+  return pending;
+}
+var TTL_MS, cached;
+var init_project_card_runtime = __esm({
+  "src/project-card-runtime.ts"() {
+    "use strict";
+    init_src();
+    init_project_card_scan();
+    TTL_MS = 5 * 6e4;
+  }
+});
+
 // src/shell-turn.ts
 function shellCommandOf(prompt) {
   return prompt.startsWith("!") ? prompt.slice(1).trim() : null;
@@ -103922,11 +104149,11 @@ var init_node_mention_fs = __esm({
 });
 
 // src/editor/node-read-dir.ts
-import { readdir as readdir3 } from "node:fs/promises";
+import { readdir as readdir4 } from "node:fs/promises";
 import path7 from "node:path";
 function createNodeReadDir(cwd2) {
   return async (rel) => {
-    const entries = await readdir3(path7.join(cwd2, rel), { withFileTypes: true });
+    const entries = await readdir4(path7.join(cwd2, rel), { withFileTypes: true });
     return entries.map((e) => ({ name: e.name, isFile: e.isFile(), isDirectory: e.isDirectory() }));
   };
 }
@@ -103937,11 +104164,11 @@ var init_node_read_dir = __esm({
 });
 
 // src/editor/node-mentions.ts
-import { readFile as readFile4 } from "node:fs/promises";
+import { readFile as readFile5 } from "node:fs/promises";
 import path8 from "node:path";
 async function readGitignore(cwd2) {
   try {
-    return createGitignoreMatcher(await readFile4(path8.join(cwd2, ".gitignore"), "utf8"));
+    return createGitignoreMatcher(await readFile5(path8.join(cwd2, ".gitignore"), "utf8"));
   } catch (err) {
     if (err.code === "ENOENT") return () => false;
     throw err;
@@ -104051,8 +104278,8 @@ var init_recording_chunks = __esm({
 
 // src/recording/recorder.ts
 import { createHash as createHash4 } from "node:crypto";
-import { mkdir as mkdir4, readFile as readFile5, rename as rename4, rm as rm2, writeFile as writeFile4, readdir as readdir4, stat as stat3 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { mkdir as mkdir4, readFile as readFile6, rename as rename4, rm as rm2, writeFile as writeFile4, readdir as readdir5, stat as stat3 } from "node:fs/promises";
+import { join as join8 } from "node:path";
 function projectHash(root) {
   return createHash4("sha256").update(root).digest("hex");
 }
@@ -104063,7 +104290,7 @@ function createRecorder(deps) {
   let inflight = null;
   let retryAttempt = 0;
   let timerArmed = false;
-  const stateFile = (sessionId) => join7(deps.dir, `${sessionId}.json`);
+  const stateFile = (sessionId) => join8(deps.dir, `${sessionId}.json`);
   async function save(sessionId, st) {
     await mkdir4(deps.dir, { recursive: true, mode: 448 });
     const tmp = `${stateFile(sessionId)}.${deps.randomId()}.tmp`;
@@ -104071,16 +104298,16 @@ function createRecorder(deps) {
     await rename4(tmp, stateFile(sessionId));
   }
   async function load(sessionId) {
-    const cached = states.get(sessionId);
-    if (cached) return cached;
+    const cached2 = states.get(sessionId);
+    if (cached2) return cached2;
     let st;
     try {
-      st = JSON.parse(await readFile5(stateFile(sessionId), "utf8"));
+      st = JSON.parse(await readFile6(stateFile(sessionId), "utf8"));
     } catch (e) {
       if (e.code !== "ENOENT") {
-        const bad = join7(deps.dir, "bad");
+        const bad = join8(deps.dir, "bad");
         await mkdir4(bad, { recursive: true, mode: 448 });
-        await rename4(stateFile(sessionId), join7(bad, `${sessionId}.${deps.now()}.json`)).catch((err) => deps.log(`recording: could not quarantine ${sessionId}: ${String(err)}`));
+        await rename4(stateFile(sessionId), join8(bad, `${sessionId}.${deps.now()}.json`)).catch((err) => deps.log(`recording: could not quarantine ${sessionId}: ${String(err)}`));
         lastError = `recording state for ${sessionId} was unreadable and was quarantined`;
         deps.log(`recording: ${lastError}`);
       }
@@ -104242,7 +104469,7 @@ function createRecorder(deps) {
   async function resume() {
     let names;
     try {
-      names = await readdir4(deps.dir);
+      names = await readdir5(deps.dir);
     } catch (e) {
       if (e.code === "ENOENT") return;
       throw e;
@@ -104270,8 +104497,8 @@ var init_recorder = __esm({
 });
 
 // src/recording/recording-runtime.ts
-import { mkdir as mkdir5, readFile as readFile6, writeFile as writeFile5, stat as stat4 } from "node:fs/promises";
-import { join as join8, sep as sep2 } from "node:path";
+import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile5, stat as stat4 } from "node:fs/promises";
+import { join as join9, sep as sep2 } from "node:path";
 function matchesExclude(pattern, root) {
   const re3 = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, `[^${sep2 === "\\" ? "\\\\" : "/"}]*`).replace(/\u0000/g, ".*");
   return new RegExp(`^${re3}(?:[/\\\\].*)?$`).test(root);
@@ -104286,8 +104513,8 @@ async function exists(path12) {
   }
 }
 function createRecordingRuntime(deps) {
-  const dir = join8(deps.configDir, "recordings");
-  const noticeFile = join8(dir, ".notice");
+  const dir = join9(deps.configDir, "recordings");
+  const noticeFile = join9(dir, ".notice");
   let recorder = null;
   let standingOff;
   let sessionOff = false;
@@ -104295,7 +104522,7 @@ function createRecordingRuntime(deps) {
     if (deps.env.SPACECODE_RECORD?.trim().toLowerCase() === "off") return "SPACECODE_RECORD=off";
     let cfg = {};
     try {
-      cfg = JSON.parse(await readFile6(join8(deps.configDir, "config.json"), "utf8"));
+      cfg = JSON.parse(await readFile7(join9(deps.configDir, "config.json"), "utf8"));
     } catch (e) {
       if (e.code !== "ENOENT") return `~/.spacecode/config.json is unreadable (${e instanceof Error ? e.message : String(e)}); fix it to record`;
     }
@@ -104303,7 +104530,7 @@ function createRecordingRuntime(deps) {
     const excludes = Array.isArray(cfg.recording?.exclude) ? cfg.recording.exclude.filter((x2) => typeof x2 === "string") : [];
     const hit = excludes.find((p) => matchesExclude(p, deps.projectRoot));
     if (hit) return `this folder matches recording.exclude (${hit})`;
-    if (await exists(join8(deps.projectRoot, ".spacecode", "norecord"))) return "this repo has .spacecode/norecord";
+    if (await exists(join9(deps.projectRoot, ".spacecode", "norecord"))) return "this repo has .spacecode/norecord";
     return null;
   }
   async function noticeShown() {
@@ -104444,11 +104671,11 @@ var init_skills_command = __esm({
 });
 
 // src/permission-rules-loader.ts
-import { readFile as readFile7 } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { readFile as readFile8 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 async function readOrNull2(path12) {
   try {
-    return await readFile7(path12, "utf8");
+    return await readFile8(path12, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") return null;
     throw err;
@@ -104456,7 +104683,7 @@ async function readOrNull2(path12) {
 }
 async function loadPermissionRules(deps) {
   const none = (line) => ({ rules: void 0, defaultMode: void 0, statusLines: [line] });
-  const configPath = join9(deps.configDir, "imports.json");
+  const configPath = join10(deps.configDir, "imports.json");
   try {
     const loaded = parseImportsConfig(await readOrNull2(configPath), configPath);
     if (loaded.error) return none("permission rules: off (imports.json unreadable)");
@@ -104465,13 +104692,13 @@ async function loadPermissionRules(deps) {
     return none(`permission rules: off (imports.json not read: ${err instanceof Error ? err.message : String(err)})`);
   }
   const lines2 = [];
-  const files = [{ scope: "user", path: join9(deps.homeDir, ".claude", "settings.json") }];
+  const files = [{ scope: "user", path: join10(deps.homeDir, ".claude", "settings.json") }];
   try {
     const sources2 = await readRepoSources(deps.cwd);
     if (sources2[".claude/settings.json"] !== void 0 || sources2[".claude/settings.local.json"] !== void 0) {
       const status = await createNodeTrustStore(deps.configDir).repoStatus(deps.cwd, sources2);
       if (status === "trusted" || status === "session") {
-        files.push({ scope: "repo", path: join9(deps.cwd, ".claude", "settings.json") }, { scope: "local", path: join9(deps.cwd, ".claude", "settings.local.json") });
+        files.push({ scope: "repo", path: join10(deps.cwd, ".claude", "settings.json") }, { scope: "local", path: join10(deps.cwd, ".claude", "settings.local.json") });
       } else lines2.push(`permission rules: repo settings NOT loaded (${status === "never" ? "marked never trust" : "untrusted repo"})`);
     }
   } catch (err) {
@@ -104513,7 +104740,7 @@ var init_permission_rules_loader = __esm({
 });
 
 // src/command-loader.ts
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 async function userCommands(deps, lines2) {
   try {
     const apiKey = await resolveApiKey({ env: deps.env, readFile: deps.readFile, homedir: deps.homedir });
@@ -104568,7 +104795,7 @@ async function repoCommands(deps, lines2) {
   }
 }
 async function loadCommands(deps) {
-  const configPath = join10(deps.configDir, "imports.json");
+  const configPath = join11(deps.configDir, "imports.json");
   try {
     const loaded = parseImportsConfig(await deps.readFile(configPath).catch((err) => {
       if (err.code === "ENOENT") return null;
@@ -104601,10 +104828,10 @@ var init_command_loader = __esm({
 });
 
 // src/useReplController.ts
-import { readFile as readFile8, writeFile as writeFile6, mkdir as mkdir6 } from "node:fs/promises";
+import { readFile as readFile9, writeFile as writeFile6, mkdir as mkdir6 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { join as join11 } from "node:path";
-import { execFile as execFile3 } from "node:child_process";
+import { join as join12 } from "node:path";
+import { execFile as execFile4 } from "node:child_process";
 function useReplController({ repoName: repoName2, yolo: yolo2, mentions: mentionsOpt, sessions, resumeLatest: resumeLatest2, onViewTurns, onViewResume, isEscOwned }) {
   const { exit } = use_app_default();
   const mentions = (0, import_react30.useMemo)(() => mentionsOpt ?? createNodeMentions(process.cwd()), [mentionsOpt]);
@@ -104625,6 +104852,9 @@ function useReplController({ repoName: repoName2, yolo: yolo2, mentions: mention
     return () => clearInterval(timer);
   }, [turnStartedAt]);
   const projectRoot = (0, import_react30.useMemo)(() => process.cwd(), []);
+  (0, import_react30.useEffect)(() => {
+    void loadProjectCard(projectRoot);
+  }, [projectRoot]);
   const sessionIdRef = (0, import_react30.useRef)(null);
   const sessionCreatedAtRef = (0, import_react30.useRef)(null);
   const sessionTokensRef = (0, import_react30.useRef)({ input: 0, output: 0 });
@@ -104634,11 +104864,11 @@ function useReplController({ repoName: repoName2, yolo: yolo2, mentions: mention
   const recordingRef = (0, import_react30.useRef)(null);
   const recording = () => recordingRef.current ??= createRecordingRuntime({
     env: process.env,
-    configDir: process.env.SPACECODE_CONFIG_DIR?.trim() || join11(homedir2(), ".spacecode"),
+    configDir: process.env.SPACECODE_CONFIG_DIR?.trim() || join12(homedir2(), ".spacecode"),
     projectRoot,
     fetch,
     baseUrl: backendUrl(process.env),
-    resolveApiKey: () => resolveApiKey({ env: process.env, readFile: (p) => readFile8(p, "utf-8"), homedir: homedir2 }).catch(() => null),
+    resolveApiKey: () => resolveApiKey({ env: process.env, readFile: (p) => readFile9(p, "utf-8"), homedir: homedir2 }).catch(() => null),
     log: (m2) => console.error(`[agent-ui] ${m2}`)
   });
   const resumeListRef = (0, import_react30.useRef)([]);
@@ -104661,10 +104891,10 @@ function useReplController({ repoName: repoName2, yolo: yolo2, mentions: mention
   (0, import_react30.useEffect)(() => {
     let live2 = true;
     loadCommands({
-      configDir: process.env.SPACECODE_CONFIG_DIR?.trim() || join11(homedir2(), ".spacecode"),
+      configDir: process.env.SPACECODE_CONFIG_DIR?.trim() || join12(homedir2(), ".spacecode"),
       cwd: process.cwd(),
       env: process.env,
-      readFile: (p) => readFile8(p, "utf-8"),
+      readFile: (p) => readFile9(p, "utf-8"),
       homedir: homedir2,
       fetch,
       builtins: SLASH_COMMANDS.map((c) => c.name)
@@ -104952,7 +105182,7 @@ function useReplController({ repoName: repoName2, yolo: yolo2, mentions: mention
           }
           setIsRunning(true);
           try {
-            const apiKey2 = await resolveApiKey({ env: process.env, readFile: (p) => readFile8(p, "utf-8"), homedir: homedir2 });
+            const apiKey2 = await resolveApiKey({ env: process.env, readFile: (p) => readFile9(p, "utf-8"), homedir: homedir2 });
             if (!apiKey2) {
               notice(MISSING_KEY_MESSAGE);
               return;
@@ -104974,7 +105204,7 @@ function useReplController({ repoName: repoName2, yolo: yolo2, mentions: mention
         }
         case "model": {
           try {
-            const apiKey2 = await resolveApiKey({ env: process.env, readFile: (p) => readFile8(p, "utf-8"), homedir: homedir2 });
+            const apiKey2 = await resolveApiKey({ env: process.env, readFile: (p) => readFile9(p, "utf-8"), homedir: homedir2 });
             if (!apiKey2) {
               notice(MISSING_KEY_MESSAGE);
               return;
@@ -105009,7 +105239,7 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
         }
         case "skills": {
           const state = profileRef.current;
-          const apiKey2 = await resolveApiKey({ env: process.env, readFile: (p) => readFile8(p, "utf-8"), homedir: homedir2 }).catch(() => null);
+          const apiKey2 = await resolveApiKey({ env: process.env, readFile: (p) => readFile9(p, "utf-8"), homedir: homedir2 }).catch(() => null);
           const client = apiKey2 ? createProfileClient({ baseUrl: backendUrl(process.env), apiKey: apiKey2, fetch }) : null;
           notice(await runSkillsCommand(slash.args, { source: state?.skills ?? null, client, statusLines: state?.statusLines.filter((l) => l.startsWith("skills")) ?? ["skills: not loaded yet (loads on your first message)"] }));
           return;
@@ -105031,7 +105261,7 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
     try {
       apiKey = await resolveApiKey({
         env: process.env,
-        readFile: (p) => readFile8(p, "utf-8"),
+        readFile: (p) => readFile9(p, "utf-8"),
         homedir: homedir2
       });
     } catch (err) {
@@ -105068,7 +105298,7 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
     try {
       profilePromiseRef.current ??= prepareProfile({
         env: process.env,
-        readFile: (p) => readFile8(p, "utf-8"),
+        readFile: (p) => readFile9(p, "utf-8"),
         writeFile: (p, d) => writeFile6(p, d, { encoding: "utf-8", mode: 384 }),
         mkdir: async (p) => {
           await mkdir6(p, { recursive: true });
@@ -105078,7 +105308,7 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
         cwd: process.cwd(),
         gitRoot: gitTopLevel,
         importGate: async () => {
-          const configDir = process.env.SPACECODE_CONFIG_DIR?.trim() || join11(homedir2(), ".spacecode");
+          const configDir = process.env.SPACECODE_CONFIG_DIR?.trim() || join12(homedir2(), ".spacecode");
           const gate = await importGateStatus({ configDir, cwd: process.cwd(), interactive: Boolean(process.stdin.isTTY) });
           const loaded = await loadPermissionRules({ configDir, homeDir: homedir2(), cwd: process.cwd() });
           rulesRef.current = loaded.rules;
@@ -105088,7 +105318,7 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
       });
       profileRef.current = await profilePromiseRef.current;
       if (mcpRef.current === null && (profileRef.current?.mcpDefs?.length ?? 0) > 0) {
-        const configDir = process.env.SPACECODE_CONFIG_DIR?.trim() || join11(homedir2(), ".spacecode");
+        const configDir = process.env.SPACECODE_CONFIG_DIR?.trim() || join12(homedir2(), ".spacecode");
         const trust = createNodeTrustStore(configDir);
         const manager = new McpManager({
           defs: profileRef.current.mcpDefs,
@@ -105098,7 +105328,7 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
           ...rulesRef.current ? { rules: rulesRef.current } : {},
           permissions,
           confirm: askUser,
-          audit: new FileAuditLog(join11(homedir2(), ".spacecode", "audit.jsonl")),
+          audit: new FileAuditLog(join12(homedir2(), ".spacecode", "audit.jsonl")),
           clientVersion: process.env.SPACECODE_VERSION ?? "0"
         });
         mcpRef.current = manager;
@@ -105106,6 +105336,7 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
       }
       const toolset = createToolset();
       toolsetRef.current = toolset;
+      const projectCard = await loadProjectCard(projectRoot);
       const config = {
         apiUrl: apiUrl(),
         apiKey,
@@ -105114,7 +105345,8 @@ ${list2.map((c) => `  /${c.name}  (${c.scope})${c.description ? `  ${c.descripti
           repoName: repoName2,
           localCwd: projectRoot,
           commitGuidance: true,
-          hasGitHubTools: toolset.hasGitHubTools
+          hasGitHubTools: toolset.hasGitHubTools,
+          ...projectCard.text ? { projectCard: projectCard.text } : {}
         }) + (profileRef.current?.promptSection ?? ""),
         tools: toolset.tools,
         maxTurns: 100,
@@ -105225,6 +105457,7 @@ var init_useReplController = __esm({
     init_models();
     init_session_commands();
     init_local_toolset();
+    init_project_card_runtime();
     init_shell_turn();
     init_node_mentions();
     init_api_key();
@@ -105239,7 +105472,7 @@ var init_useReplController = __esm({
     init_slash_commands();
     init_useEventAccumulator();
     gitTopLevel = () => new Promise((resolve2) => {
-      execFile3("git", ["rev-parse", "--show-toplevel"], { cwd: process.cwd() }, (err, stdout) => resolve2(err ? null : stdout.trim() || null));
+      execFile4("git", ["rev-parse", "--show-toplevel"], { cwd: process.cwd() }, (err, stdout) => resolve2(err ? null : stdout.trim() || null));
     });
     apiUrl = () => process.env.API_PROXY_URL || "https://api.spacecode.app";
   }
@@ -105820,16 +106053,16 @@ function clearOnResize(stdout) {
 var import_jsx_runtime14 = __toESM(require_jsx_runtime(), 1);
 if (process.argv[2] === "import-claude") {
   const { runImportClaude: runImportClaude2 } = await Promise.resolve().then(() => (init_import_claude(), import_claude_exports));
-  const { readFile: readFile9, readdir: readdir5 } = await import("node:fs/promises");
-  const { execFile: execFile4 } = await import("node:child_process");
+  const { readFile: readFile10, readdir: readdir6 } = await import("node:fs/promises");
+  const { execFile: execFile5 } = await import("node:child_process");
   const gitRoot = () => new Promise((resolve2) => {
-    execFile4("git", ["rev-parse", "--show-toplevel"], { cwd: process.cwd() }, (err, stdout) => resolve2(err ? null : stdout.trim() || null));
+    execFile5("git", ["rev-parse", "--show-toplevel"], { cwd: process.cwd() }, (err, stdout) => resolve2(err ? null : stdout.trim() || null));
   });
   const code = await runImportClaude2({
     argv: process.argv.slice(2),
     env: process.env,
-    fs: { readFile: (p) => readFile9(p, "utf-8"), readdir: (p) => readdir5(p) },
-    readFile: (p) => readFile9(p, "utf-8"),
+    fs: { readFile: (p) => readFile10(p, "utf-8"), readdir: (p) => readdir6(p) },
+    readFile: (p) => readFile10(p, "utf-8"),
     homedir: os5.homedir,
     cwd: process.cwd(),
     gitRoot,
@@ -105854,9 +106087,9 @@ if (process.argv[2] === "approve-mcp") {
   const { resolveApiKey: resolveApiKey2 } = await Promise.resolve().then(() => (init_api_key(), api_key_exports));
   const { backendUrl: backendUrl2 } = await Promise.resolve().then(() => (init_profile_runtime(), profile_runtime_exports));
   const { createProfileClient: createProfileClient2 } = await Promise.resolve().then(() => (init_src(), src_exports));
-  const { readFile: readFile9 } = await import("node:fs/promises");
+  const { readFile: readFile10 } = await import("node:fs/promises");
   const configDir = process.env.SPACECODE_CONFIG_DIR?.trim() || path11.join(os5.homedir(), ".spacecode");
-  const apiKey = await resolveApiKey2({ env: process.env, readFile: (p) => readFile9(p, "utf-8"), homedir: os5.homedir }).catch(() => null);
+  const apiKey = await resolveApiKey2({ env: process.env, readFile: (p) => readFile10(p, "utf-8"), homedir: os5.homedir }).catch(() => null);
   const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
   const { createInterface } = interactive ? await import("node:readline/promises") : { createInterface: void 0 };
   const rl = createInterface ? createInterface({ input: process.stdin, output: process.stdout }) : void 0;
@@ -105864,7 +106097,7 @@ if (process.argv[2] === "approve-mcp") {
     const code = await runApproveMcp2({
       configDir,
       cwd: process.cwd(),
-      readFile: (p) => readFile9(p, "utf-8"),
+      readFile: (p) => readFile10(p, "utf-8"),
       client: apiKey ? createProfileClient2({ baseUrl: backendUrl2(process.env), apiKey, fetch }) : null,
       trust: createNodeTrustStore2(configDir),
       ...rl ? { ask: async (q2) => {
@@ -105925,10 +106158,10 @@ if (process.stdin.isTTY && process.stdout.isTTY) {
   }
 }
 var restoreCiVariables = hideCiVariables(process.env, Boolean(process.stdout.isTTY));
-var render2;
+var render3;
 var App3;
 try {
-  [{ render: render2 }, { App: App3 }] = await Promise.all([init_build2().then(() => build_exports), init_App2().then(() => App_exports)]);
+  [{ render: render3 }, { App: App3 }] = await Promise.all([init_build2().then(() => build_exports), init_App2().then(() => App_exports)]);
 } finally {
   restoreCiVariables();
 }
@@ -105942,7 +106175,7 @@ if (fullscreen) {
   session.onLeave(restoreConsole);
   session.onLeave(clearOnResize(process.stdout));
 }
-var app = render2(
+var app = render3(
   /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(App3, { repoName, onboardingMode, launchCount, yolo, resumeLatest, interactivePicker: Boolean(process.stdout.isTTY), fullscreen }),
   { patchConsole: !fullscreen }
 );