repowise 0.1.89 → 0.1.90

package/dist/bin/repowise.js

@@ -321,6 +321,51 @@ async function scanLocalContextFiles(repoRoot, contextFolder) {
   }
 }
 
+// ../../packages/shared/dist/lib/project-overview-injection.js
+var START_MARKER = "<!-- repowise:agent-instructions:start -->";
+var END_MARKER = "<!-- repowise:agent-instructions:end -->";
+var AI_AGENT_USAGE_INSTRUCTIONS = `${START_MARKER}
+## How AI Agents Should Use This Context
+
+This document is the **entry point** for RepoWise's pre-analyzed codebase context. The \`repowise-context/\` folder contains architecture, API contracts, data models, coding patterns, user flows, and domain knowledge \u2014 pre-extracted so AI agents can answer most questions without searching the codebase.
+
+**Rules for using this context:**
+
+1. **Route first.** Use the *Context File Routing Map* below to identify which file(s) cover the domain of the current task. Files are organized by scope (root = cross-cutting, \`apps/<name>/\` = app-specific) and by concern (architecture, data models, API contracts, coding patterns, etc.).
+
+2. **Read before searching.** Consult the matching context file(s) before running grep/glob or reading source files. These files are the authoritative source for architecture, patterns, and conventions in this project.
+
+3. **Fall back when needed.** If the context files don't cover the question \u2014 or if the question is about ephemeral state (recent commits, branch status, in-flight work) \u2014 then use code search.
+
+4. **Propagate to subagents.** When delegating work to a sub-task or spawning another agent, explicitly instruct it to read \`repowise-context/project-overview.md\` first. Subagents do not inherit the parent agent's instructions automatically.
+
+5. **Don't edit these files manually.** The \`repowise-context/\` folder is regenerated by RepoWise on every sync. Manual edits will be overwritten. Update the source code and let the next sync regenerate the context.
+${END_MARKER}`;
+function injectAgentInstructions(content) {
+  const lineEnding = content.includes("\r\n") ? "\r\n" : "\n";
+  const canonicalBlock = AI_AGENT_USAGE_INSTRUCTIONS.replace(/\n/g, lineEnding);
+  const startIdx = content.indexOf(START_MARKER);
+  const endIdx = content.indexOf(END_MARKER);
+  if (startIdx >= 0 && endIdx > startIdx) {
+    const currentBlock = content.slice(startIdx, endIdx + END_MARKER.length);
+    if (currentBlock === canonicalBlock) {
+      return content;
+    }
+    return content.slice(0, startIdx) + canonicalBlock + content.slice(endIdx + END_MARKER.length);
+  }
+  const h1Match = content.match(/^# Project Overview\s*$/m);
+  if (h1Match && h1Match.index !== void 0) {
+    const insertAt = h1Match.index + h1Match[0].length;
+    return content.slice(0, insertAt) + lineEnding + lineEnding + canonicalBlock + content.slice(insertAt);
+  }
+  const h2Match = content.match(/^## Summary\s*$/m);
+  if (h2Match && h2Match.index !== void 0) {
+    const insertAt = h2Match.index + h2Match[0].length;
+    return content.slice(0, insertAt) + lineEnding + lineEnding + canonicalBlock + content.slice(insertAt);
+  }
+  return canonicalBlock + lineEnding + lineEnding + content;
+}
+
 // ../listener/dist/lib/config.js
 import { readFile as readFile2, writeFile as writeFile2, rename, unlink as unlink2, mkdir as mkdir2, chmod } from "fs/promises";
 import { join as join3 } from "path";
@@ -912,7 +957,8 @@ async function fetchContextFromServer(repoId, localPath, apiUrl) {
       const content = await contentRes.text();
       const filePath = join8(contextDir, file.fileName);
       await mkdir5(dirname3(filePath), { recursive: true });
-      await writeFile5(filePath, content, "utf-8");
+      const finalContent = file.fileName === "project-overview.md" ? injectAgentInstructions(content) : content;
+      await writeFile5(filePath, finalContent, "utf-8");
       updatedFiles.push(file.fileName);
     }
     console.log(`Context fetch for ${repoId}: downloaded ${updatedFiles.length}/${files.length} file(s)`);
@@ -1674,6 +1720,31 @@ async function checkStaleContext(repos, state, groups) {
   }
   return dirty;
 }
+async function reconcileAgentInstructions(repos) {
+  for (const repo of repos) {
+    const path = join13(repo.localPath, "repowise-context", "project-overview.md");
+    let content;
+    try {
+      content = await readFile6(path, "utf-8");
+    } catch (err) {
+      const code = err?.code;
+      if (code === "ENOENT" || code === "ENOTDIR" || code === "EACCES" || code === "EPERM" || code === "EISDIR") {
+        continue;
+      }
+      console.warn(`[reconcile] read failed for ${repo.repoId}:`, err instanceof Error ? err.message : String(err));
+      continue;
+    }
+    const injected = injectAgentInstructions(content);
+    if (injected === content)
+      continue;
+    try {
+      await writeFile8(path, injected, "utf-8");
+      console.log(`[reconcile] Reconciled agent instructions for ${repo.repoId}`);
+    } catch (err) {
+      console.warn(`[reconcile] write failed for ${repo.repoId}:`, err instanceof Error ? err.message : String(err));
+    }
+  }
+}
 async function startListener() {
   running = true;
   const configDir = getConfigDir();
@@ -1810,6 +1881,11 @@ async function startListener() {
   console.error = (...args) => origError(`[${ts()}]`, ...args);
   console.warn = (...args) => origWarn(`[${ts()}]`, ...args);
   console.log(`RepoWise Listener started \u2014 watching ${allRepoIds.length} repo(s)`);
+  try {
+    await reconcileAgentInstructions(config2.repos);
+  } catch (err) {
+    console.warn("[reconcile] Initial agent instructions reconciliation failed:", err instanceof Error ? err.message : String(err));
+  }
   const shutdown = async () => {
     console.log("Shutting down...");
     stop();
@@ -1946,6 +2022,11 @@ async function startListener() {
       } catch (err) {
         console.warn("[self-heal] Stale context check failed:", err instanceof Error ? err.message : String(err));
       }
+      try {
+        await reconcileAgentInstructions(config2.repos);
+      } catch (err) {
+        console.warn("[reconcile] Agent instructions reconciliation failed:", err instanceof Error ? err.message : String(err));
+      }
     }
     if (latestCliVersion && currentVersion && !config2.noAutoUpdate && (state.crashCount ?? 0) < CRASH_LOOP_THRESHOLD) {
       if (latestCliVersion !== state.lastUpdateTargetVersion) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repowise",
-  "version": "0.1.89",
+  "version": "0.1.90",
   "type": "module",
   "description": "AI-optimized codebase context generator",
   "bin": {