@jefuriiij/synthra 0.1.16 → 0.1.17

package/dist/server/index.js

@@ -1553,9 +1553,11 @@ function resolvePaths(projectRoot) {
 
 // src/cli/bootstrap.ts
 import { mkdir as mkdir3, readFile as readFile7, stat as stat2, writeFile as writeFile3 } from "fs/promises";
+import { basename as basename2 } from "path";
 
 // src/hooks/claude-md.ts
 import { readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
+import { basename, dirname as dirname4 } from "path";
 var POLICY_VERSION = 3;
 var POLICY_BEGIN = `<!-- synthra-policy v${POLICY_VERSION} BEGIN -->`;
 var POLICY_END = `<!-- synthra-policy v${POLICY_VERSION} END -->`;
@@ -1656,7 +1658,39 @@ function policyBlock() {
     POLICY_END
   ].join("\n");
 }
-async function patchClaudeMd(path) {
+function onboardingSkeleton(projectName) {
+  return [
+    `# ${projectName}`,
+    "",
+    "> Onboarding notes for AI coding agents. Synthra's graph already knows the",
+    "> code's *structure* (files, symbols, imports) \u2014 this file is for what the",
+    "> graph can't infer: how to run the project, its conventions, and the",
+    "> decisions behind them. Keep it lean and current; delete prompts you don't need.",
+    "",
+    "## Build & test",
+    "",
+    "- TODO: install deps / build",
+    "- TODO: run tests / lint / typecheck",
+    "- TODO: run the app locally",
+    "",
+    "## Conventions",
+    "",
+    "- TODO: code style, naming, file layout the agent should follow",
+    "",
+    "## Key decisions",
+    "",
+    '- TODO: non-obvious choices and *why* ("we use X not Y because \u2026")',
+    "",
+    "## Gotchas",
+    "",
+    `- TODO: traps, footguns, "don't touch X without Y"`,
+    "",
+    "_Tip: run `/init` in Claude Code to auto-draft the sections above, then trim",
+    "to the durable bits. Synthra manages its own block below \u2014 leave it._",
+    ""
+  ].join("\n");
+}
+async function patchClaudeMd(path, projectName) {
   let existing;
   try {
     existing = await readFile6(path, "utf8");
@@ -1665,7 +1699,8 @@ async function patchClaudeMd(path) {
   }
   const block = policyBlock();
   if (existing === null) {
-    await writeFile2(path, block + "\n", "utf8");
+    const name = projectName || basename(dirname4(path)) || "this project";
+    await writeFile2(path, onboardingSkeleton(name) + "\n" + block + "\n", "utf8");
     return { created: true, updated: false, skipped: false };
   }
   const stripped = existing.replace(ANY_BLOCK_RE, "");
@@ -1722,7 +1757,7 @@ async function bootstrap(paths) {
   const contextCreated = await ensureDir(paths.contextDir);
   const gitignoreUpdated = await patchGitignore(paths.gitignore);
   const claudeMdExistedBefore = await exists(paths.claudeMd);
-  const patch = await patchClaudeMd(paths.claudeMd);
+  const patch = await patchClaudeMd(paths.claudeMd, basename2(paths.projectRoot));
   return {
     graphCreated,
     contextCreated,
@@ -1775,8 +1810,12 @@ async function scanProject(projectRootRaw, opts = {}) {
     if (boot.graphCreated) log.info("  created .synthra-graph/");
     if (boot.contextCreated) log.info("  created .synthra/");
     if (boot.gitignoreUpdated) log.info("  updated .gitignore");
-    if (boot.claudeMdCreated) log.info("  created CLAUDE.md");
-    else if (boot.claudeMdUpdated) log.info("  updated CLAUDE.md");
+    if (boot.claudeMdCreated) {
+      log.info("  created CLAUDE.md \u2014 onboarding skeleton for the agent");
+      log.info("    \u21B3 fill in Build / Conventions / Decisions (or run /init in Claude to auto-draft)");
+    } else if (boot.claudeMdUpdated) {
+      log.info("  updated CLAUDE.md");
+    }
   }
   const walked = [];
   for await (const file of walk(projectRoot)) walked.push(file);
@@ -2073,7 +2112,7 @@ function resolveBranchPaths(contextDir, branch, isDefault) {
 
 // src/memory/context-md.ts
 import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile4 } from "fs/promises";
-import { dirname as dirname4 } from "path";
+import { dirname as dirname5 } from "path";
 var MAX_BULLETS = 3;
 function deriveContextMd(entries, branch) {
   const tasks = entries.filter((e) => e.type === "task").reverse();
@@ -2116,13 +2155,13 @@ function formatContextMd(ctx) {
   return lines.join("\n");
 }
 async function writeContextMd(path, ctx) {
-  await mkdir4(dirname4(path), { recursive: true });
+  await mkdir4(dirname5(path), { recursive: true });
   await writeFile4(path, formatContextMd(ctx), "utf8");
 }
 
 // src/memory/context-store.ts
 import { mkdir as mkdir5, readFile as readFile10, writeFile as writeFile5 } from "fs/promises";
-import { dirname as dirname5 } from "path";
+import { dirname as dirname6 } from "path";
 var SCHEMA_VERSION = 1;
 async function readEntries(path) {
   try {
@@ -2134,7 +2173,7 @@ async function readEntries(path) {
   }
 }
 async function writeEntries(path, entries) {
-  await mkdir5(dirname5(path), { recursive: true });
+  await mkdir5(dirname6(path), { recursive: true });
   const store = { schema_version: SCHEMA_VERSION, entries };
   await writeFile5(path, JSON.stringify(store, null, 2) + "\n", "utf8");
 }
@@ -2848,7 +2887,7 @@ async function handleContextUpdate(req, ctx) {
 
 // src/server/routes/gate.ts
 import { appendFile as appendFile2, mkdir as mkdir6 } from "fs/promises";
-import { dirname as dirname6 } from "path";
+import { dirname as dirname7 } from "path";
 var BLOCKABLE_TOOLS = /* @__PURE__ */ new Set(["Grep", "Glob"]);
 var RECENT_ACTIVITY_WINDOW_MS = 5 * 60 * 1e3;
 function extractQuery(toolName, input) {
@@ -2878,7 +2917,7 @@ function recentlyTouchedMatchesQuery(recentPaths, queryTokens) {
 }
 async function logDecision(ctx, toolName, query, decision, reason) {
   try {
-    await mkdir6(dirname6(ctx.paths.gateLog), { recursive: true });
+    await mkdir6(dirname7(ctx.paths.gateLog), { recursive: true });
     const entry = {
       ts: (/* @__PURE__ */ new Date()).toISOString(),
       tool: toolName,
@@ -2935,14 +2974,14 @@ async function handleGate(req, ctx) {
 
 // src/server/routes/log.ts
 import { appendFile as appendFile3, mkdir as mkdir7 } from "fs/promises";
-import { dirname as dirname7 } from "path";
+import { dirname as dirname8 } from "path";
 async function handleLog(entry, ctx) {
   if (!entry || typeof entry.input_tokens !== "number" || typeof entry.output_tokens !== "number") {
     throw new Error("log: input_tokens and output_tokens (number) are required");
   }
   const written_at = (/* @__PURE__ */ new Date()).toISOString();
   const record = { ...entry, written_at };
-  await mkdir7(dirname7(ctx.paths.tokenLog), { recursive: true });
+  await mkdir7(dirname8(ctx.paths.tokenLog), { recursive: true });
   await appendFile3(ctx.paths.tokenLog, JSON.stringify(record) + "\n", "utf8");
   return { ok: true, written_at };
 }