@pi-claudian/auto-save-to-markdown 0.3.0 → 0.3.2

package/README.md

@@ -94,11 +94,10 @@ Assistant · 13:05:40 · claude-sonnet-4-5
 
 I'll trace the middleware order first.
 
-**Tool calls**
-
-- `read` — {"filePath":"/Users/me/project/src/auth/middleware.ts"}
-
-> **Tool · read** /Users/me/project/src/auth/middleware.ts — 120 lines …
+> [!quote]- Tool Calls · 1 (read)
+> **`read`** `{"filePath":"/Users/me/project/src/auth/middleware.ts"}`
+>
+> > `import { NextResponse } from "next/server"; export function middleware(…) …`
 
 ---
 ```
@@ -109,7 +108,10 @@ per-turn tool calls are each folded into a collapsed Obsidian callout —
 tool call and result in one line, so the file stays readable while still
 showing what the agent did. Callouts are used instead of HTML `<details>`
 because Obsidian renders markdown inside HTML blocks unreliably; outside
-Obsidian the callouts degrade to plain blockquotes.
+Obsidian the callouts degrade to plain blockquotes. Result and argument
+previews are wrapped in inline code spans (with a delimiter sized to survive
+backticks inside the content), so raw tool output renders literally instead of
+being parsed as markdown.
 
 Each message block opens with a setext level-1 info header (`User · …`,
 underlined with `===`) — one level above the `##` headings AI content
@@ -163,6 +165,10 @@ always contains the complete conversation, not the compacted context.
 PI_CLAUDIAN_DEBUG=1 pi
 ```
 
+Any value other than an explicit false token (empty, `0`, `false`, `no`, `off` —
+case-insensitive) enables it; unset the variable (or set one of those tokens)
+to turn it off.
+
 ## License
 
 MIT

package/README.zh.md

@@ -84,11 +84,10 @@ Assistant · 13:05:40 · claude-sonnet-4-5
 
 我先追踪一下中间件链。
 
-**Tool calls**
-
-- `read` — {"filePath":"/Users/me/project/src/auth/middleware.ts"}
-
-> **Tool · read** /Users/me/project/src/auth/middleware.ts — 120 lines …
+> [!quote]- Tool Calls · 1 (read)
+> **`read`** `{"filePath":"/Users/me/project/src/auth/middleware.ts"}`
+>
+> > `import { NextResponse } from "next/server"; export function middleware(…) …`
 
 ---
 ```
@@ -98,7 +97,9 @@ Assistant · 13:05:40 · claude-sonnet-4-5
 `> [!quote]- Tool Calls · …`），每个工具调用和结果各压缩成一行摘要，既可读
 又能看出 agent 做了什么。之所以用 callout 而不是 HTML `<details>`，是因为
 Obsidian 对 HTML 块内嵌 Markdown 的渲染不可靠；在非 Obsidian 环境下 callout
-退化为普通引用块。
+退化为普通引用块。结果与参数预览会包在 inline code 里（分隔符长度会自动
+压过内容中的反引号序列），工具的原始输出因此按字面渲染，不会被当作
+Markdown 解析。
 
 每个消息块以 setext 一级信息头（`User · …`，下一行以 `===` 下划）开头——
 高于 AI 内容常见的 `##` 二级标题，解析时也能与内容中的 `#` 一级标题区分
@@ -143,6 +144,9 @@ markdown 文件只记录**一个分支**——即该分支看到的 root→leaf
 PI_CLAUDIAN_DEBUG=1 pi
 ```
 
+除显式假值（空串、`0`、`false`、`no`、`off`，忽略大小写）以外的任何值都会开启
+调试；取消该变量或将其设为其中某个假值即可关闭。
+
 ## 许可
 
 MIT

package/debug.ts

@@ -1,9 +1,10 @@
 /**
  * Shared debug logging for all @pi-claudian extensions.
  *
- * Enable by setting the PI_CLAUDIAN_DEBUG environment variable to any truthy
- * value (e.g. "1"). Output goes to stderr via console.error, so it never mixes
- * with pi's stdout and can be captured separately:
+ * Enable by setting the PI_CLAUDIAN_DEBUG environment variable to any value
+ * other than an explicit false token (empty, "0", "false", "no", "off" —
+ * case-insensitive). Output goes to stderr via console.error, so it never
+ * mixes with pi's stdout and can be captured separately:
  *
  *   PI_CLAUDIAN_DEBUG=1 pi            # show inline
  *   PI_CLAUDIAN_DEBUG=1 pi 2>debug.log  # capture to a file
@@ -15,9 +16,11 @@
  */
 
 const TAG = "[pi-claudian]";
-const enabled = Boolean(process.env.PI_CLAUDIAN_DEBUG);
+const FALSE_TOKENS = new Set(["", "0", "false", "no", "off"]);
+const raw = process.env.PI_CLAUDIAN_DEBUG?.trim().toLowerCase();
+const enabled = raw !== undefined && !FALSE_TOKENS.has(raw);
 
-/** Log a debug message when PI_CLAUDIAN_DEBUG is set. */
+/** Log a debug message when PI_CLAUDIAN_DEBUG is set to an enabling value. */
 export function debug(...args: unknown[]): void {
   if (!enabled) return;
   console.error(TAG, ...args);

package/index.ts

@@ -32,7 +32,10 @@
  *   instead of HTML `<details>` because Obsidian's views render embedded
  *   markdown inside HTML blocks unreliably, while callouts fold and render
  *   markdown in both Live Preview and Reading view. Outside Obsidian the
- *   callouts degrade to plain blockquotes. A result whose call was saved in
+ *   callouts degrade to plain blockquotes. Argument previews and result
+ *   previews are wrapped in inline code spans (delimiter sized to survive
+ *   backticks inside the content), so raw output renders literally instead
+ *   of being parsed as markdown. A result whose call was saved in
  *   an earlier file (mid-turn manual save) falls back to a standalone
  *   one-line block.
  * - Branching: each file records exactly ONE branch (the root→leaf path
@@ -293,6 +296,19 @@ export default function (pi: ExtensionAPI) {
 
   // ---------- markdown rendering ----------
 
+  /**
+   * Inline code span for arbitrary raw output (tool results, argument JSON):
+   * the delimiter is always one backtick longer than the longest backtick run
+   * inside the text, so content that itself contains backticks cannot break
+   * the span. Tool output renders literally instead of being parsed as
+   * markdown (headings, bold, wiki links …).
+   */
+  function inlineCode(text: string): string {
+    const longest = (text.match(/`+/g) ?? []).reduce((a, r) => Math.max(a, r.length), 0);
+    const fence = "`".repeat(longest + 1);
+    return `${fence}${text}${fence}`;
+  }
+
   /**
    * Strip leading blank lines and trailing whitespace from a rendered block,
    * so joins and separators always keep exactly one blank line around them
@@ -325,7 +341,7 @@ export default function (pi: ExtensionAPI) {
 
   /** Standalone one-line block for a result whose call is not in this file. */
   function renderToolResult(m: ToolResultMessage): string {
-    return `> **Tool · ${m.toolName}** ${resultPreview(m)}`.trim();
+    return `> **Tool · ${m.toolName}** ${inlineCode(resultPreview(m))}`.trim();
   }
 
   /** "read, web_search ×2" — tool names with repeat counts, first-seen order. */
@@ -346,12 +362,17 @@ export default function (pi: ExtensionAPI) {
     return `> [!${type}]- ${title}\n${lines.join("\n")}`;
   }
 
-  /** Fold tool calls and their paired results into one collapsed callout. */
+  /**
+   * Fold tool calls and their paired results into one collapsed callout.
+   * Argument JSON and result previews are wrapped in inline code spans, so
+   * raw output renders literally instead of being parsed as markdown.
+   */
   function renderToolCallsCallout(calls: RenderedToolCall[]): string {
     const summary = summarizeToolNames(calls.map((c) => c.name));
     const items = calls.map((c) => {
-      const head = c.args ? `**\`${c.name}\`** \`${c.args}\`` : `**\`${c.name}\`**`;
-      const result = c.result === null ? "_(no result)_" : c.result || "_(empty result)_";
+      const head = c.args ? `**\`${c.name}\`** ${inlineCode(c.args)}` : `**\`${c.name}\`**`;
+      const result =
+        c.result === null ? "_(no result)_" : inlineCode(c.result || "_(empty result)_");
       return `${head}\n\n> ${result}`;
     });
     return callout("quote", `Tool Calls · ${calls.length} (${summary})`, items.join("\n\n"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-claudian/auto-save-to-markdown",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Pi extension that automatically saves each completed conversation turn as a markdown file with YAML frontmatter, one file per session-tree branch.",
   "type": "module",
   "license": "MIT",