@pencil-agent/nano-pencil 1.11.34 → 1.11.35

package/dist/builtin-extensions.d.ts

@@ -1,26 +1,26 @@
 /**
- * [UPSTREAM]: Depends on node:fs, node:path, config
- * [SURFACE]: BuiltinExtension, getBuiltinExtensionPaths(), builtInExtensions
- * [LOCUS]: builtin-extensions.ts - built-in extension registry for NanoPencil
- * [COVENANT]: Change built-in extensions → update this header
+ * [WHO]: BuiltinExtension, getBuiltinExtensionPaths(), builtInExtensions
+ * [FROM]: Depends on node:fs, node:path, config
+ * [TO]: Consumed by main.ts, test files
+ * [HERE]: builtin-extensions.ts - built-in extension registry for NanoPencil
  */
 /**
- * 获取 NanoPencil 默认加载的内置扩展路径列表
+ * Get the list of built-in extension paths that NanoPencil loads by default
  *
- * 返回所有默认启用的扩展路径（defaults/）：
- * - NanoMem (持久化记忆)
- * - Soul (AI 人格进化)
- * - LinkWorld (联网搜索)
- * - SecurityAudit (安全审计)
- * - MCP (MCP 协议适配)
+ * Returns all default-enabled extension paths (defaults/):
+ * - NanoMem (persistent memory)
+ * - Soul (AI personality evolution)
+ * - LinkWorld (internet search)
+ * - SecurityAudit (security audit)
+ * - MCP (MCP protocol adapter)
  *
- * 可选扩展需要通过配置启用：
- * - Simplify (代码简化) - extensions/optional/simplify/
- * - export-html (HTML 导出) - extensions/optional/export-html/
+ * Optional extensions need to be enabled via configuration:
+ * - Simplify (code simplification) - extensions/optional/simplify/
+ * - export-html (HTML export) - extensions/optional/export-html/
  */
 export declare function getBuiltinExtensionPaths(): string[];
 /**
- * @deprecated 请使用 getBuiltinExtensionPaths()
+ * @deprecated Use getBuiltinExtensionPaths() instead
  */
 export declare function getNanopencilDefaultExtensionPaths(): string[];
 //# sourceMappingURL=builtin-extensions.d.ts.map

package/dist/builtin-extensions.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on node:fs, node:path, config
- * [SURFACE]: BuiltinExtension, getBuiltinExtensionPaths(), builtInExtensions
- * [LOCUS]: builtin-extensions.ts - built-in extension registry for NanoPencil
- * [COVENANT]: Change built-in extensions → update this header
+ * [WHO]: BuiltinExtension, getBuiltinExtensionPaths(), builtInExtensions
+ * [FROM]: Depends on node:fs, node:path, config
+ * [TO]: Consumed by main.ts, test files
+ * [HERE]: builtin-extensions.ts - built-in extension registry for NanoPencil
  */
 import { existsSync, readFileSync } from "node:fs";
 import { createRequire } from "node:module";
@@ -10,7 +10,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
-/** 内置扩展路径 */
+/** Built-in extension paths */
 const BUNDLED_NANOMEM_EXTENSION_PACKAGES = join(__dirname, "packages", "mem-core", "extension.js");
 const BUNDLED_SIMPLIFY_EXTENSION = join(__dirname, "extensions", "optional", "simplify", "index.js");
 const BUNDLED_LINK_WORLD_EXTENSION = join(__dirname, "extensions", "defaults", "link-world", "index.js");
@@ -22,7 +22,7 @@ const BUNDLED_LOOP_EXTENSION = join(__dirname, "extensions", "defaults", "loop",
 const BUNDLED_TEAM_EXTENSION = join(__dirname, "extensions", "defaults", "team", "index.js");
 const BUNDLED_MCP_EXTENSION = join(__dirname, "extensions", "defaults", "mcp", "index.js");
 const BUNDLED_EXPORT_HTML_EXTENSION = join(__dirname, "extensions", "optional", "export-html", "index.js");
-/** 从当前模块位置向上查找包根（含 package.json 且 name 为 nano-pencil 相关） */
+/** Find package root from current module location (containing package.json with nano-pencil related name) */
 function findPackageRoot(startDir) {
     let dir = startDir;
     for (let i = 0; i < 20; i++) {
@@ -46,35 +46,35 @@ function findPackageRoot(startDir) {
     return null;
 }
 /**
- * 获取 NanoPencil 默认加载的内置扩展路径列表
+ * Get the list of built-in extension paths that NanoPencil loads by default
  *
- * 返回所有默认启用的扩展路径（defaults/）：
- * - NanoMem (持久化记忆)
- * - Soul (AI 人格进化)
- * - LinkWorld (联网搜索)
- * - SecurityAudit (安全审计)
- * - MCP (MCP 协议适配)
+ * Returns all default-enabled extension paths (defaults/):
+ * - NanoMem (persistent memory)
+ * - Soul (AI personality evolution)
+ * - LinkWorld (internet search)
+ * - SecurityAudit (security audit)
+ * - MCP (MCP protocol adapter)
  *
- * 可选扩展需要通过配置启用：
- * - Simplify (代码简化) - extensions/optional/simplify/
- * - export-html (HTML 导出) - extensions/optional/export-html/
+ * Optional extensions need to be enabled via configuration:
+ * - Simplify (code simplification) - extensions/optional/simplify/
+ * - export-html (HTML export) - extensions/optional/export-html/
  */
 export function getBuiltinExtensionPaths() {
     const paths = [];
-    // === NanoMem 扩展 ===
-    // 1) 优先使用 build 时打包到 dist/packages 的扩展
+    // === NanoMem extension ===
+    // 1) Prefer extension bundled to dist/packages during build
     if (existsSync(BUNDLED_NANOMEM_EXTENSION_PACKAGES)) {
         paths.push(BUNDLED_NANOMEM_EXTENSION_PACKAGES);
     }
     else {
-        // 2) require.resolve：开发/本地安装时 node_modules 中的 mem-core
+        // 2) require.resolve: mem-core in node_modules during development/local install
         try {
             const extPath = require.resolve("@pencil-agent/mem-core/extension.js");
             if (existsSync(extPath))
                 paths.push(extPath);
         }
         catch {
-            // 3) 按包根 + node_modules/@pencil-agent/mem-core/dist/extension.js 查找
+            // 3) Look for package root + node_modules/@pencil-agent/mem-core/dist/extension.js
             const packageRoot = findPackageRoot(__dirname);
             if (packageRoot) {
                 const candidate = join(packageRoot, "node_modules", "@pencil-agent", "mem-core", "dist", "extension.js");
@@ -83,17 +83,17 @@ export function getBuiltinExtensionPaths() {
             }
         }
     }
-    // === Simplify 扩展（可选源码，编译到 dist/extensions/optional/simplify） ===
+    // === Simplify extension (optional source, compiled to dist/extensions/optional/simplify) ===
     if (existsSync(BUNDLED_SIMPLIFY_EXTENSION)) {
         paths.push(BUNDLED_SIMPLIFY_EXTENSION);
     }
     else {
-        // 开发模式：尝试 .ts 源文件
+        // Development mode: try .ts source file
         const simplifyTs = join(__dirname, "extensions", "optional", "simplify", "index.ts");
         if (existsSync(simplifyTs))
             paths.push(simplifyTs);
     }
-    // === link-world 扩展（内置源码，编译到 dist/extensions/defaults/link-world） ===
+    // === link-world extension (built-in source, compiled to dist/extensions/defaults/link-world) ===
     if (existsSync(BUNDLED_LINK_WORLD_EXTENSION)) {
         paths.push(BUNDLED_LINK_WORLD_EXTENSION);
     }
@@ -102,7 +102,7 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(linkWorldTs))
             paths.push(linkWorldTs);
     }
-    // === Security Audit 扩展（内置源码，编译到 dist/extensions/defaults/security-audit） ===
+    // === Security Audit extension (built-in source, compiled to dist/extensions/defaults/security-audit) ===
     if (existsSync(BUNDLED_SECURITY_AUDIT_EXTENSION)) {
         paths.push(BUNDLED_SECURITY_AUDIT_EXTENSION);
     }
@@ -111,7 +111,7 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(securityAuditTs))
             paths.push(securityAuditTs);
     }
-    // === Soul 扩展（人格进化系统） ===
+    // === Soul extension (personality evolution system) ===
     if (existsSync(BUNDLED_SOUL_EXTENSION)) {
         paths.push(BUNDLED_SOUL_EXTENSION);
     }
@@ -128,7 +128,7 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(presenceTs))
             paths.push(presenceTs);
     }
-    // === Interview 扩展（需求澄清）===
+    // === Interview extension (requirement clarification) ===
     // Placed after Soul to ensure Interview probe sees both Mem + Soul style/systemPrompt injections.
     if (existsSync(BUNDLED_INTERVIEW_EXTENSION)) {
         paths.push(BUNDLED_INTERVIEW_EXTENSION);
@@ -138,7 +138,7 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(interviewTs))
             paths.push(interviewTs);
     }
-    // === Loop 扩展（/loop 定时任务）===
+    // === Loop extension (/grub autonomous task, /loop scheduler) ===
     if (existsSync(BUNDLED_LOOP_EXTENSION)) {
         paths.push(BUNDLED_LOOP_EXTENSION);
     }
@@ -147,7 +147,7 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(loopTs))
             paths.push(loopTs);
     }
-    // === MCP 扩展（MCP 工具协议适配） ===
+    // === MCP extension (MCP tool protocol adapter) ===
     // Built-in team extension
     if (existsSync(BUNDLED_TEAM_EXTENSION)) {
         paths.push(BUNDLED_TEAM_EXTENSION);
@@ -166,7 +166,7 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(mcpTs))
             paths.push(mcpTs);
     }
-    // === export-html 扩展（可选，HTML 导出功能） ===
+    // === export-html extension (optional, HTML export functionality) ===
     if (existsSync(BUNDLED_EXPORT_HTML_EXTENSION)) {
         paths.push(BUNDLED_EXPORT_HTML_EXTENSION);
     }
@@ -178,7 +178,7 @@ export function getBuiltinExtensionPaths() {
     return paths;
 }
 /**
- * @deprecated 请使用 getBuiltinExtensionPaths()
+ * @deprecated Use getBuiltinExtensionPaths() instead
  */
 export function getNanopencilDefaultExtensionPaths() {
     return getBuiltinExtensionPaths();

package/dist/cli/args.d.ts

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on agent-core, chalk, config.ts, core/tools
- * [SURFACE]: Args, Mode, parseArgs(), printHelp()
- * [LOCUS]: cli/args.ts - CLI argument parsing and help display
- * [COVENANT]: Change CLI options → update this header
+ * [WHO]: Args, Mode, parseArgs(), printHelp()
+ * [FROM]: Depends on agent-core, chalk, config.ts, core/tools
+ * [TO]: Consumed by main.ts, core/model-resolver.ts
+ * [HERE]: cli/args.ts - CLI argument parsing and help display
  */
 import type { ThinkingLevel } from "@pencil-agent/agent-core";
 import { type ToolName } from "../core/tools/index.js";

package/dist/cli/config-selector.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on tui, core/config, modes/interactive/components
- * [SURFACE]: ConfigSelectorOptions, ConfigSelector, runConfigSelector()
- * [LOCUS]: cli/config-selector.ts - TUI config selector for `pi config` command
- * [COVENANT]: Change config selector → update this header
+ * [WHO]: ConfigSelectorOptions, ConfigSelector, runConfigSelector()
+ * [FROM]: Depends on tui, core/config, modes/interactive/components
+ * [TO]: Consumed by main.ts
+ * [HERE]: cli/config-selector.ts - TUI config selector for `pi config` command
  */
 import { ProcessTerminal, TUI } from "@pencil-agent/tui";
 import { ConfigSelectorComponent } from "../modes/interactive/components/config-selector.js";

package/dist/cli/file-processor.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on node:fs/promises, ai, chalk, core/tools/path-utils, modes/utils
- * [SURFACE]: ProcessedFiles, processFileArguments()
- * [LOCUS]: cli/file-processor.ts - process @file CLI arguments into content
- * [COVENANT]: Change file processing → update this header
+ * [WHO]: ProcessedFiles, processFileArguments()
+ * [FROM]: Depends on node:fs/promises, ai, chalk, core/tools/path-utils, modes/utils
+ * [TO]: Consumed by main.ts
+ * [HERE]: cli/file-processor.ts - process @file CLI arguments into content
  */
 import { access, readFile, stat } from "node:fs/promises";
 import chalk from "chalk";

package/dist/cli/session-picker.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on tui, core/keybindings, core/session, modes/interactive/components
- * [SURFACE]: selectSession()
- * [LOCUS]: cli/session-picker.ts - TUI session selector for --resume flag
- * [COVENANT]: Change session picker → update this header
+ * [WHO]: selectSession()
+ * [FROM]: Depends on tui, core/keybindings, core/session, modes/interactive/components
+ * [TO]: Consumed by main.ts
+ * [HERE]: cli/session-picker.ts - TUI session selector for --resume flag
  */
 import { ProcessTerminal, TUI } from "@pencil-agent/tui";
 import { KeybindingsManager } from "../core/keybindings.js";

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 /**
- * [UPSTREAM]: Depends on main.ts
- * [SURFACE]: CLI entry point, sets process.title, calls main()
- * [LOCUS]: Entry point; orchestrates argument parsing and mode selection
- * [COVENANT]: Change CLI behavior → update AGENTS.md build commands
+ * [WHO]: CLI entry point, sets process.title, calls main()
+ * [FROM]: Depends on main.ts
+ * [TO]: Consumed by bin/nanopencil (npm binary)
+ * [HERE]: Entry point; orchestrates argument parsing and mode selection
  */
 process.title = "nanopencil";
 import { main } from "./main.js";

package/dist/config.d.ts

@@ -45,7 +45,7 @@ export declare const APP_NAME: string;
 /** Config dir: ~/.nanopencil for nanopencil, ~/.pi for pi. Fallback by package name when piConfig missing. */
 export declare const CONFIG_DIR_NAME: string;
 export declare const VERSION: string;
-/** npm 包名，用于版本检查与更新提示（如 @pencil-agent/nano-pencil） */
+/** npm package name, used for version checking and update prompts (e.g., @pencil-agent/nano-pencil) */
 export declare const PACKAGE_NAME: string;
 export declare const ENV_AGENT_DIR: string;
 /** Get the share viewer URL for a gist ID */

package/dist/config.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on node:fs, node:os, node:path, node:url
- * [SURFACE]: Config path getters (getAgentDir, getModelsPath, etc.), APP_NAME, VERSION
- * [LOCUS]: config.ts - configuration path discovery and constants
- * [COVENANT]: Change config paths → update this header
+ * [WHO]: Config path getters (getAgentDir, getModelsPath, etc.), APP_NAME, VERSION
+ * [FROM]: Depends on node:fs, node:os, node:path, node:url
+ * [TO]: Consumed by main.ts, index.ts, migrations.ts, cli/args.ts, core/model-registry.ts, core/keybindings.ts, core/skills.ts, core/package-manager.ts, core/soul-integration.ts, nanopencil-defaults.ts, utils/changelog.ts, and all extension entry points
+ * [HERE]: config.ts - configuration path discovery and constants
  */
 import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
@@ -157,7 +157,7 @@ export const APP_NAME = pkg.piConfig?.name || "pi";
 /** Config dir: ~/.nanopencil for nanopencil, ~/.pi for pi. Fallback by package name when piConfig missing. */
 export const CONFIG_DIR_NAME = pkg.piConfig?.configDir ?? (pkg.name === "@pencil-agent/nano-pencil" ? ".nanopencil" : ".pi");
 export const VERSION = pkg.version;
-/** npm 包名，用于版本检查与更新提示（如 @pencil-agent/nano-pencil） */
+/** npm package name, used for version checking and update prompts (e.g., @pencil-agent/nano-pencil) */
 export const PACKAGE_NAME = pkg.name || "@pencil-agent/nano-pencil";
 // e.g., PI_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR
 export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;

package/dist/core/bash-executor.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on node:crypto, node:fs, node:os, node:path, child_process, strip-ansi, utils/shell
- * [SURFACE]: executeBash(), executeBashWithOperations(), BashResult
- * [LOCUS]: core/bash-executor.ts - unified bash execution with streaming
- * [COVENANT]: Change bash execution → update this header
+ * [WHO]: executeBash(), executeBashWithOperations(), BashResult
+ * [FROM]: Depends on node:crypto, node:fs, node:os, node:path, child_process, strip-ansi, utils/shell
+ * [TO]: Consumed by core/index.ts, modes/rpc/rpc-types.ts, modes/rpc/rpc-client.ts
+ * [HERE]: core/bash-executor.ts - unified bash execution with streaming
  */
 import { randomBytes } from "node:crypto";
 import { createWriteStream } from "node:fs";

package/dist/core/config/auth-storage.d.ts

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on ai, node:fs, proper-lockfile, config
- * [SURFACE]: AuthStorage class, credential management
- * [LOCUS]: core/config/auth-storage.ts - credential storage for API keys and OAuth
- * [COVENANT]: Change auth storage → update this header
+ * [WHO]: AuthStorage class, credential management
+ * [FROM]: Depends on ai, node:fs, proper-lockfile, config
+ * [TO]: Consumed by index.ts, main.ts, nanopencil-defaults.ts, core/runtime/sdk.ts, core/model-registry.ts, core/mcp/mcp-client.ts, extensions/defaults/mcp/index.ts, and test files
+ * [HERE]: core/config/auth-storage.ts - credential storage for API keys and OAuth
  */
 import { type OAuthCredentials, type OAuthLoginCallbacks, type OAuthProviderId } from "@pencil-agent/ai";
 export type ApiKeyCredential = {

package/dist/core/config/auth-storage.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on ai, node:fs, proper-lockfile, config
- * [SURFACE]: AuthStorage class, credential management
- * [LOCUS]: core/config/auth-storage.ts - credential storage for API keys and OAuth
- * [COVENANT]: Change auth storage → update this header
+ * [WHO]: AuthStorage class, credential management
+ * [FROM]: Depends on ai, node:fs, proper-lockfile, config
+ * [TO]: Consumed by index.ts, main.ts, nanopencil-defaults.ts, core/runtime/sdk.ts, core/model-registry.ts, core/mcp/mcp-client.ts, extensions/defaults/mcp/index.ts, and test files
+ * [HERE]: core/config/auth-storage.ts - credential storage for API keys and OAuth
  */
 import { getEnvApiKey, getOAuthApiKey, getOAuthProvider, getOAuthProviders, } from "@pencil-agent/ai";
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/core/config/resolve-config-value.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on child_process
- * [SURFACE]: resolveConfigValue()
- * [LOCUS]: core/config/resolve-config-value.ts - resolve config values (shell, env, literal)
- * [COVENANT]: Change value resolution → update this header
+ * [WHO]: resolveConfigValue()
+ * [FROM]: Depends on child_process
+ * [TO]: Consumed by core/model-registry.ts, core/config/auth-storage.ts
+ * [HERE]: core/config/resolve-config-value.ts - resolve config values (shell, env, literal)
  */
 import { execSync } from "child_process";
 // Cache for shell command results (persists for process lifetime)

package/dist/core/config/resource-loader.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on node:fs, node:path, chalk, extensions/loader, theme, diagnostics
- * [SURFACE]: DefaultResourceLoader, ResourceLoader, ResourceDiagnostic
- * [LOCUS]: core/config/resource-loader.ts - discovers and loads extensions, skills, themes
- * [COVENANT]: Change resource loading → update P2 core/CLAUDE.md
+ * [WHO]: DefaultResourceLoader, ResourceLoader, ResourceDiagnostic
+ * [FROM]: Depends on node:fs, node:path, chalk, extensions/loader, theme, diagnostics
+ * [TO]: Consumed by index.ts, main.ts, modes/interactive/interactive-mode.ts, extensions/defaults/team/index.ts, and test files
+ * [HERE]: core/config/resource-loader.ts - discovers and loads extensions, skills, themes
  */
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/core/config/settings-manager.d.ts

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on ai, node:fs, proper-lockfile, config.ts
- * [SURFACE]: SettingsManager class, two-tier settings (global + project-local)
- * [LOCUS]: core/config/settings-manager.ts - user preferences aggregation
- * [COVENANT]: Change settings structure → update P2 core/CLAUDE.md
+ * [WHO]: SettingsManager class, two-tier settings (global + project-local)
+ * [FROM]: Depends on ai, node:fs, proper-lockfile, config.ts
+ * [TO]: Consumed by index.ts, main.ts, core/runtime/sdk.ts, cli/config-selector.ts, extensions/defaults/team/index.ts, modes/interactive/components/model-selector.ts, modes/interactive/components/config-selector.ts, and test files
+ * [HERE]: core/config/settings-manager.ts - user preferences aggregation
  */
 import type { Transport } from "@pencil-agent/ai";
 export interface CompactionSettings {

package/dist/core/custom-providers.d.ts

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on config/auth-storage, node:fs
- * [SURFACE]: CUSTOM_ANTHROPIC_PROVIDER, CUSTOM_OPENAI_PROVIDER, registerCustomProvider()
- * [LOCUS]: core/custom-providers.ts - custom provider registration
- * [COVENANT]: Change custom providers → update this header
+ * [WHO]: CUSTOM_ANTHROPIC_PROVIDER, CUSTOM_OPENAI_PROVIDER, registerCustomProvider()
+ * [FROM]: Depends on config/auth-storage, node:fs
+ * [TO]: Consumed by core/model-registry.ts
+ * [HERE]: core/custom-providers.ts - custom provider registration
  */
 import type { AuthStorage } from "./config/auth-storage.js";
 export declare const CUSTOM_ANTHROPIC_PROVIDER = "custom-anthropic";

package/dist/core/defaults.d.ts

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on agent-core
- * [SURFACE]: DEFAULT_THINKING_LEVEL
- * [LOCUS]: core/defaults.ts - default configuration values
- * [COVENANT]: Change defaults → update this header
+ * [WHO]: DEFAULT_THINKING_LEVEL
+ * [FROM]: Depends on agent-core
+ * [TO]: Consumed by main.ts, core/runtime/sdk.ts, core/runtime/agent-session.ts, core/model-resolver.ts
+ * [HERE]: core/defaults.ts - default configuration values
  */
 import type { ThinkingLevel } from "@pencil-agent/agent-core";
 export declare const DEFAULT_THINKING_LEVEL: ThinkingLevel;

package/dist/core/diagnostics.d.ts

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: No external dependencies
- * [SURFACE]: ResourceCollision, ResourceDiagnostic
- * [LOCUS]: core/diagnostics.ts - resource collision and diagnostic types
- * [COVENANT]: Change diagnostics → update this header
+ * [WHO]: ResourceCollision, ResourceDiagnostic
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/config/resource-loader.ts, core/skills.ts
+ * [HERE]: core/diagnostics.ts - resource collision and diagnostic types
  */
 export interface ResourceCollision {
     resourceType: "extension" | "skill" | "prompt" | "theme";

package/dist/core/exec.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on child_process
- * [SURFACE]: ExecOptions, exec()
- * [LOCUS]: core/exec.ts - shared command execution utilities
- * [COVENANT]: Change exec utilities → update this header
+ * [WHO]: ExecOptions, exec()
+ * [FROM]: Depends on child_process
+ * [TO]: Consumed by core/extensions/types.ts, core/extensions/loader.ts
+ * [HERE]: core/exec.ts - shared command execution utilities
  */
 import { spawn } from "node:child_process";
 /**

package/dist/core/export-html/CLAUDE.md

@@ -0,0 +1,12 @@
+# core/export-html/
+
+> P2 | Parent: ../CLAUDE.md
+
+Member List
+tool-renderer.ts: ToolHtmlRendererDeps interface, ToolHtmlRenderer interface, renderToolToHtml(), renders tool calls and results to HTML, consumes ansi-to-html for output formatting
+ansi-to-html.ts: ansiToHtml(), ansiLinesToHtml(), AnsiToHtmlOptions, ANSI to HTML conversion, standard ANSI color palette (0-15), no external dependencies
+index.ts: ToolHtmlRenderer interface, exportSessionToHtml(), HTML export functionality, generates self-contained HTML from session entries, key invariant: produces complete standalone HTML document
+
+Rule: Members complete, one item per line, parent links valid, precise terms first
+
+[COVENANT]: Update this file header on changes and verify against parent CLAUDE.md

package/dist/core/export-html/ansi-to-html.js

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: No external dependencies
- * [SURFACE]: ansiToHtml(), ansiLinesToHtml(), AnsiToHtmlOptions
- * [LOCUS]: core/export-html/ansi-to-html.ts - ANSI to HTML conversion
- * [COVENANT]: Change ANSI conversion → update this header
+ * [WHO]: ansiToHtml(), ansiLinesToHtml(), AnsiToHtmlOptions
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/export-html/tool-renderer.ts, core/export-html/index.ts
+ * [HERE]: core/export-html/ansi-to-html.ts - ANSI to HTML conversion
  */
 // Standard ANSI color palette (0-15)
 const ANSI_COLORS = [

package/dist/core/export-html/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * [UPSTREAM]: Depends on agent-core, node:fs, node:path, config, modes/theme, extensions, session
- * [SURFACE]: ToolHtmlRenderer, exportSessionToHtml()
- * [LOCUS]: core/export-html/index.ts - HTML export functionality
- * [COVENANT]: Change export → update this header
+ * [WHO]: ToolHtmlRenderer, exportSessionToHtml()
+ * [FROM]: Depends on agent-core, node:fs, node:path, config, modes/theme, extensions, session
+ * [TO]: Consumed by core/runtime/agent-session.ts, extensions/optional/export-html/index.ts
+ * [HERE]: core/export-html/index.ts - HTML export functionality
  */
 import type { AgentState } from "@pencil-agent/agent-core";
 import { SessionManager } from "../session/session-manager.js";