@pencil-agent/nano-pencil 1.14.1 → 1.14.2

package/dist/build-meta.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.14.1",
-  "commitHash": "b4f6f24",
+  "version": "1.14.2",
+  "commitHash": "62cd264",
   "branch": "main",
-  "builtAt": "2026-05-23T15:05:06.541Z"
+  "builtAt": "2026-05-26T18:24:58.388Z"
 }

package/dist/builtin-extensions.d.ts

@@ -4,6 +4,18 @@
  * [TO]: Consumed by main.ts, test files
  * [HERE]: builtin-extensions.ts - built-in extension registry for NanoPencil
  */
+export type BuiltinExtensionRiskLevel = "passive" | "command" | "tool" | "background" | "write-capable";
+export interface BuiltinExtension {
+    id: string;
+    category: "default" | "optional" | "package";
+    defaultEnabled: boolean;
+    riskLevel: BuiltinExtensionRiskLevel;
+    requiresUI: boolean;
+    startsTimers: boolean;
+    writesWorkspace: boolean;
+    externalProcess: boolean;
+}
+export declare const builtInExtensions: readonly BuiltinExtension[];
 /**
  * Get the list of built-in extension paths that NanoPencil loads by default
  *
@@ -14,7 +26,7 @@
  * - SecurityAudit (security audit)
  * - MCP (MCP protocol adapter)
  *
- * Optional extensions need to be enabled via configuration:
+ * Optional extensions need to be enabled via configuration or --extension:
  * - Simplify (code simplification) - extensions/optional/simplify/
  * - export-html (HTML export) - extensions/optional/export-html/
  */

package/dist/builtin-extensions.js

@@ -12,7 +12,6 @@ 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");
 const BUNDLED_BROWSER_EXTENSION = join(__dirname, "extensions", "defaults", "browser", "index.js");
 const BUNDLED_SECURITY_AUDIT_EXTENSION = join(__dirname, "extensions", "defaults", "security-audit", "index.js");
@@ -21,6 +20,7 @@ const BUNDLED_PRESENCE_EXTENSION = join(__dirname, "extensions", "defaults", "pr
 const BUNDLED_INTERVIEW_EXTENSION = join(__dirname, "extensions", "defaults", "interview", "index.js");
 const BUNDLED_LOOP_EXTENSION = join(__dirname, "extensions", "defaults", "loop", "index.js");
 const BUNDLED_PLAN_EXTENSION = join(__dirname, "extensions", "defaults", "plan", "index.js");
+const BUNDLED_DISCIPLINE_EXTENSION = join(__dirname, "extensions", "defaults", "discipline", "index.js");
 const BUNDLED_DIAGNOSTICS_EXTENSION = join(__dirname, "extensions", "defaults", "diagnostics", "index.js");
 const BUNDLED_SAL_EXTENSION = join(__dirname, "extensions", "defaults", "sal", "index.js");
 const BUNDLED_TOKEN_SAVE_EXTENSION = join(__dirname, "extensions", "defaults", "token-save", "index.js");
@@ -32,7 +32,31 @@ const BUNDLED_BTW_EXTENSION = join(__dirname, "extensions", "defaults", "btw", "
 const BUNDLED_RECAP_EXTENSION = join(__dirname, "extensions", "defaults", "recap", "index.js");
 const BUNDLED_DEBUG_EXTENSION = join(__dirname, "extensions", "defaults", "debug", "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");
+export const builtInExtensions = [
+    { id: "diagnostics", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false },
+    { id: "sal", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "token-save", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "nanomem", category: "package", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "link-world", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
+    { id: "browser", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
+    { id: "security-audit", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "soul", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "presence", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: false },
+    { id: "interview", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "grub", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
+    { id: "loop", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false },
+    { id: "plan", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "discipline", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "subagent", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
+    { id: "team", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
+    { id: "idle-think", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: true },
+    { id: "btw", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "recap", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "debug", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "mcp", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true },
+    { id: "simplify", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: true },
+    { id: "export-html", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: false },
+];
 /** Find package root from current module location (containing package.json with nano-pencil related name) */
 function findPackageRoot(startDir) {
     let dir = startDir;
@@ -66,7 +90,7 @@ function findPackageRoot(startDir) {
  * - SecurityAudit (security audit)
  * - MCP (MCP protocol adapter)
  *
- * Optional extensions need to be enabled via configuration:
+ * Optional extensions need to be enabled via configuration or --extension:
  * - Simplify (code simplification) - extensions/optional/simplify/
  * - export-html (HTML export) - extensions/optional/export-html/
  */
@@ -135,16 +159,6 @@ export function getBuiltinExtensionPaths() {
             }
         }
     }
-    // === Simplify extension (optional source, compiled to dist/extensions/optional/simplify) ===
-    if (existsSync(BUNDLED_SIMPLIFY_EXTENSION)) {
-        paths.push(BUNDLED_SIMPLIFY_EXTENSION);
-    }
-    else {
-        // Development mode: try .ts source file
-        const simplifyTs = join(__dirname, "extensions", "optional", "simplify", "index.ts");
-        if (existsSync(simplifyTs))
-            paths.push(simplifyTs);
-    }
     // === 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);
@@ -226,7 +240,15 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(planTs))
             paths.push(planTs);
     }
-    // === MCP extension (MCP tool protocol adapter) ===
+    // === Discipline extension (default engineering workflow skills and bootstrap) ===
+    if (existsSync(BUNDLED_DISCIPLINE_EXTENSION)) {
+        paths.push(BUNDLED_DISCIPLINE_EXTENSION);
+    }
+    else {
+        const disciplineTs = join(__dirname, "extensions", "defaults", "discipline", "index.ts");
+        if (existsSync(disciplineTs))
+            paths.push(disciplineTs);
+    }
     // Built-in SubAgent extension
     if (existsSync(BUNDLED_SUBAGENT_EXTENSION)) {
         paths.push(BUNDLED_SUBAGENT_EXTENSION);
@@ -290,15 +312,6 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(mcpTs))
             paths.push(mcpTs);
     }
-    // === export-html extension (optional, HTML export functionality) ===
-    if (existsSync(BUNDLED_EXPORT_HTML_EXTENSION)) {
-        paths.push(BUNDLED_EXPORT_HTML_EXTENSION);
-    }
-    else {
-        const exportHtmlTs = join(__dirname, "extensions", "optional", "export-html", "index.ts");
-        if (existsSync(exportHtmlTs))
-            paths.push(exportHtmlTs);
-    }
     return paths;
 }
 /**

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

@@ -43,6 +43,9 @@ export interface MarkdownSettings {
     codeBlockIndent?: string;
 }
 export type TransportSetting = Transport;
+export type AgentLoopFrameworkSetting = "standard" | "weak-model-compatible";
+export type AgentLoopFrameworkSettingInput = AgentLoopFrameworkSetting | "high-intelligence" | "low-intelligence" | "structured-adaptive";
+export declare function normalizeAgentLoopFrameworkSetting(value: AgentLoopFrameworkSettingInput | undefined): AgentLoopFrameworkSetting | undefined;
 /**
  * Package source for npm/git packages.
  * - String form: load all resources from the package
@@ -61,6 +64,7 @@ export interface Settings {
     defaultProvider?: string;
     defaultModel?: string;
     defaultThinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    agentLoopFramework?: AgentLoopFrameworkSettingInput;
     transport?: TransportSetting;
     steeringMode?: "all" | "one-at-a-time";
     followUpMode?: "all" | "one-at-a-time";
@@ -213,6 +217,8 @@ export declare class SettingsManager {
     setTheme(theme: string): void;
     getDefaultThinkingLevel(): "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     setDefaultThinkingLevel(level: "off" | "minimal" | "low" | "medium" | "high" | "xhigh"): void;
+    getAgentLoopFramework(): AgentLoopFrameworkSetting | undefined;
+    setAgentLoopFramework(framework: AgentLoopFrameworkSettingInput | undefined): void;
     getTransport(): TransportSetting;
     setTransport(transport: TransportSetting): void;
     getCompactionEnabled(): boolean;

package/dist/core/config/settings-manager.js

@@ -4,6 +4,13 @@ import lockfile from "proper-lockfile";
 import { APP_NAME, CONFIG_DIR_NAME } from "../../config.js";
 import { defaultAgentDirContext } from "../agent-dir/agent-dir-context.js";
 import { readFile, writeFile, mkdir } from "node:fs/promises";
+export function normalizeAgentLoopFrameworkSetting(value) {
+    if (value === "high-intelligence")
+        return "standard";
+    if (value === "low-intelligence" || value === "structured-adaptive")
+        return "weak-model-compatible";
+    return value;
+}
 /** Deep merge settings: project/overrides take precedence, nested objects merge recursively */
 function deepMergeSettings(base, overrides) {
     const result = { ...base };
@@ -564,6 +571,20 @@ export class SettingsManager {
         this.markModified("defaultThinkingLevel");
         this.save();
     }
+    getAgentLoopFramework() {
+        return normalizeAgentLoopFrameworkSetting(this.settings.agentLoopFramework);
+    }
+    setAgentLoopFramework(framework) {
+        const normalized = normalizeAgentLoopFrameworkSetting(framework);
+        if (normalized === undefined) {
+            delete this.globalSettings.agentLoopFramework;
+        }
+        else {
+            this.globalSettings.agentLoopFramework = normalized;
+        }
+        this.markModified("agentLoopFramework");
+        this.save();
+    }
     getTransport() {
         return this.settings.transport ?? "sse";
     }

package/dist/core/extensions/runner.d.ts

@@ -81,6 +81,7 @@ export declare class ExtensionRunner {
     private getSystemPromptFn;
     private getSoulManagerFn;
     private getSettingsFn;
+    private getSkillsFn;
     private newSessionHandler;
     private forkHandler;
     private navigateTreeHandler;

package/dist/core/extensions/runner.js

@@ -99,6 +99,7 @@ export class ExtensionRunner {
     getSystemPromptFn = () => "";
     getSoulManagerFn = () => undefined;
     getSettingsFn = () => ({});
+    getSkillsFn = () => [];
     newSessionHandler = async () => ({ cancelled: false });
     forkHandler = async () => ({ cancelled: false });
     navigateTreeHandler = async () => ({ cancelled: false });
@@ -175,6 +176,7 @@ export class ExtensionRunner {
         this.getSystemPromptFn = contextActions.getSystemPrompt;
         this.getSoulManagerFn = contextActions.getSoulManager;
         this.getSettingsFn = contextActions.getSettings;
+        this.getSkillsFn = contextActions.getSkills;
         // Process provider registrations queued during extension loading
         for (const { name, config } of this.runtime.pendingProviderRegistrations) {
             this.modelRegistry.registerProvider(name, config);
@@ -413,6 +415,7 @@ export class ExtensionRunner {
             getSystemPrompt: () => this.getSystemPromptFn(),
             getSoulManager: () => this.getSoulManagerFn(),
             getSettings: () => this.getSettingsFn(),
+            getSkills: () => this.getSkillsFn(),
         };
     }
     createCommandContext() {

package/dist/core/extensions/types.d.ts

@@ -18,6 +18,7 @@ import type { KeybindingsManager } from "../keybindings.js";
 import type { CustomMessage } from "../messages.js";
 import type { ModelRegistry } from "../model-registry.js";
 import type { BranchSummaryEntry, CompactionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session/session-manager.js";
+import type { Skill } from "../skills.js";
 import type { SlashCommandInfo } from "../slash-commands.js";
 import type { BashOperations } from "../tools/bash.js";
 import type { EditToolDetails } from "../tools/edit.js";
@@ -232,6 +233,8 @@ export interface ExtensionContext {
     getSoulManager(): unknown | undefined;
     /** Get current merged settings (project overrides global). */
     getSettings(): import("../config/settings-manager.js").Settings;
+    /** Get currently loaded skills after user/project/default resource precedence is applied. */
+    getSkills(): readonly Skill[];
 }
 /**
  * Extended context for command handlers.
@@ -294,7 +297,7 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
     interruptBehavior?: "cancel" | "block";
     /** Optional semantic validation after schema validation and before execute. */
     validateInput?: (params: Static<TParams>) => void | string | Promise<void | string>;
-    /** Optional maximum text result size enforced by low-intelligence-adaptation tool orchestration. */
+    /** Optional maximum text result size enforced by weak-model-compatible tool orchestration. */
     maxResultSizeChars?: number;
     /** Usage guidance for system prompt (optional) */
     guidance?: string;
@@ -802,14 +805,14 @@ export interface ExtensionAPI {
      *   api: "anthropic-messages",
      *   models: [
      *     {
-     *       id: "high-intelligence-model",
-     *       name: "High Intelligence Model (proxy)",
+     *       id: "example-model",
+     *       name: "Example Model (proxy)",
      *       reasoning: false,
      *       input: ["text", "image"],
      *       cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
      *       contextWindow: 200000,
      *       maxTokens: 16384,
-     *       agentLoopFramework: "low-intelligence"
+     *       agentLoopFramework: "weak-model-compatible"
      *     }
      *   ]
      * });
@@ -870,9 +873,9 @@ export interface ProviderConfig {
 }
 /** Configuration for a model within a provider. */
 export interface ProviderModelConfig {
-    /** Model ID (e.g., "high-intelligence-model"). */
+    /** Model ID (e.g., "example-model"). */
     id: string;
-    /** Display name (e.g., "High Intelligence Model"). */
+    /** Display name (e.g., "Example Model"). */
     name: string;
     /** API type override for this model. */
     api?: Api;
@@ -994,6 +997,7 @@ export interface ExtensionContextActions {
     getSystemPrompt: () => string;
     getSoulManager: () => unknown | undefined;
     getSettings: () => import("../config/settings-manager.js").Settings;
+    getSkills: () => readonly Skill[];
 }
 /**
  * Actions for ExtensionCommandContext (ctx.* in command handlers).

package/dist/core/i18n/slash-commands.js

@@ -7,7 +7,7 @@
 export const slashCommands = {
     settings: "Open settings menu",
     model: "Select model (opens selector UI)",
-    "agent-loop": "Set high/low-intelligence agent loop adaptation for this session",
+    "agent-loop": "Set standard or weak-model-compatible agent loop for this session",
     "scoped-models": "Enable/disable models for Ctrl+P cycling",
     apikey: "Update API key for current provider",
     mcp: "Manage MCP servers (list, enable, disable)",

package/dist/core/i18n/slash-commands.zh.js

@@ -7,7 +7,7 @@
 export const slashCommands = {
     settings: "打开设置菜单",
     model: "选择模型（打开选择器界面）",
-    "agent-loop": "设置本会话的高智能/低智能 agent loop 适配",
+    "agent-loop": "设置本会话的 standard/弱模型兼容 agent loop",
     "scoped-models": "启用/禁用 Ctrl+P 循环的模型",
     apikey: "更新当前提供商的 API 密钥",
     mcp: "管理 MCP 服务器（列出、启用、禁用）",

package/dist/core/model-registry.d.ts

@@ -7,8 +7,8 @@
 import { type Api, type AssistantMessageEventStream, type Context, type Model, type OAuthProviderInterface, type SimpleStreamOptions } from "@pencil-agent/ai";
 import type { AuthStorage } from "./config/auth-storage.js";
 import { clearConfigValueCache } from "./config/resolve-config-value.js";
-type AgentLoopFramework = "high-intelligence" | "low-intelligence";
-type AgentLoopFrameworkInput = AgentLoopFramework | "standard" | "structured-adaptive";
+type AgentLoopFramework = "standard" | "weak-model-compatible";
+type AgentLoopFrameworkInput = AgentLoopFramework | "high-intelligence" | "low-intelligence" | "structured-adaptive";
 /** Clear the config value command cache. Exported for testing. */
 export declare const clearApiKeyCache: typeof clearConfigValueCache;
 /**

package/dist/core/model-registry.js

@@ -42,9 +42,10 @@ const OpenAIResponsesCompatSchema = Type.Object({
 });
 const OpenAICompatSchema = Type.Union([OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema]);
 const AgentLoopFrameworkSchema = Type.Union([
+    Type.Literal("standard"),
+    Type.Literal("weak-model-compatible"),
     Type.Literal("high-intelligence"),
     Type.Literal("low-intelligence"),
-    Type.Literal("standard"),
     Type.Literal("structured-adaptive"),
 ]);
 // Schema for custom model definition
@@ -85,10 +86,10 @@ const ModelOverrideSchema = Type.Object({
     compat: Type.Optional(OpenAICompatSchema),
 });
 function normalizeAgentLoopFramework(value) {
-    if (value === "standard")
-        return "high-intelligence";
-    if (value === "structured-adaptive")
-        return "low-intelligence";
+    if (value === "high-intelligence")
+        return "standard";
+    if (value === "low-intelligence" || value === "structured-adaptive")
+        return "weak-model-compatible";
     return value;
 }
 const ProviderConfigSchema = Type.Object({

package/dist/core/runtime/agent-session.d.ts

@@ -24,7 +24,7 @@ import { AgentDirContext } from "../agent-dir/agent-dir-context.js";
 import type { BashOperations } from "../tools/bash.js";
 import { type SessionSlashCommandDescriptor } from "./slash-command-catalog.js";
 export type { SessionSlashCommandDescriptor } from "./slash-command-catalog.js";
-type AgentLoopFrameworkInput = AgentLoopFramework | "standard" | "structured-adaptive";
+type AgentLoopFrameworkInput = AgentLoopFramework | "high-intelligence" | "low-intelligence" | "structured-adaptive";
 /** Parsed skill block from a user message */
 export interface ParsedSkillBlock {
     name: string;

package/dist/core/runtime/extension-core-bindings.js

@@ -173,5 +173,6 @@ export function bindExtensionCore(runner, host) {
         },
         getSystemPrompt: () => host.systemPrompt,
         getSoulManager: () => host.soulManager,
+        getSkills: () => host.resourceLoader.getSkills().skills,
     });
 }

package/dist/core/runtime/sdk.js

@@ -247,6 +247,7 @@ export async function createAgentSession(options = {}) {
         steeringMode: settingsManager.getSteeringMode(),
         followUpMode: settingsManager.getFollowUpMode(),
         transport: settingsManager.getTransport(),
+        agentLoopFramework: settingsManager.getAgentLoopFramework(),
         thinkingBudgets: settingsManager.getThinkingBudgets(),
         maxRetryDelayMs: settingsManager.getRetrySettings().maxDelayMs,
         getApiKey: async (provider) => {

package/dist/extensions/defaults/AGENT.md

@@ -14,12 +14,20 @@ browser/install.md: Browser Harness setup and troubleshooting instructions, expo
 browser/src/browser_harness/: Vendored Browser Harness Python package, CDP daemon, IPC bridge, admin commands, and helper functions
 browser/interaction-skills/: Reusable Browser Harness mechanics guides for browser interactions
 browser/agent-workspace/: Seed workspace copied to .nanopencil/browser-workspace for editable helpers and domain skills
+discipline/index.ts: Engineering discipline extension entry, registers skill tool, default workflow skills, and lightweight before_agent_start bootstrap prompt
+discipline/skills/: Built-in engineering workflow skills for brainstorming, debugging, TDD, verification, planning, code review, worktrees, and branch finishing
+idle-think/index.ts: IdleThink extension entry, session lifecycle registration, activity tracking, and persistent insight prompt injection
+idle-think/idle-think-runtime.ts: IdleThink runtime boundary - state, budget reset, interval ownership, abort cleanup, exploration orchestration, insight persistence, and diagnostic reporting
+idle-think/thinker.ts: IdleThink read-only SubAgent exploration runner, project context collection, network capability detection, and exploration prompt construction
+idle-think/insights.ts: IdleThink nanomem-backed project-scoped insight storage and system prompt injection
+idle-think/curiosity.ts: IdleThink curiosity queue persistence, topic selection, dedupe, and explored-topic pruning
 link-world/index.ts: Internet access integration entry, registers link_world_admin/link_world_exec/web_search/web_fetch tools, /link-world status/doctor/version/install commands, and bundled internet-search resources
 link-world/link-world-agent.md: Agent-facing skill that tells models to prefer web_search/web_fetch and link_world_admin/link_world_exec over bash for internet tasks
 link-world/network-routing.md: Routing skill that tells models when to use web_search/web_fetch/link-world versus browser automation
 link-world/agent-workspace/: Seed workspace copied to .nanopencil/link-world-workspace for project-local domain skills and notes
 mcp/index.ts: MCP protocol integration extension, MCP guidance resources
-presence/index.ts: AI-driven opening + idle presence lines, uses NanoMemEngine episodes/preferences/lessons + git/cwd snapshot, injects latest line into agent systemPrompt every turn for main-conversation perception, 30s debounce + idle in-flight lock, configurable via settings.presence.enabled, PRESENCE_MESSAGE_TYPE renderer
+presence/index.ts: AI-driven opening + idle presence lines, git/cwd snapshot, systemPrompt injection of recent presence lines, timers/debounce/idle in-flight lock, settings.presence.enabled guard, PRESENCE_MESSAGE_TYPE renderer
+presence/presence-memory.ts: Presence memory boundary - NanoMem directory/project discovery, memory-derived locale detection, randomized preference/lesson highlight selection for greeting prompts
 plan/index.ts: Plan Mode extension entry, /plan /plan:validate /plan:approve commands, EnterPlanMode/ExitPlanMode tools, permission gating, TUI status/widget, workflow prompt injection
 plan/types.ts: Plan mode types, persisted state payload, attachment variants, permission result model
 plan/plan-file-manager.ts: Plan file path management, slug generation, settings-aware plans directory, plan state hydration/serialization, resume/fork copy helpers
@@ -34,24 +42,37 @@ subagent/index.ts: SubAgent extension entry, /subagent:/subagent:run/:stop/:stat
 subagent/subagent-parser.ts: SubAgent command parsing, parseSubAgentCommand/buildSubAgentHelp
 subagent/subagent-runner.ts: SubAgent orchestration — research (read-only) and implement (isolated worktree) roles, diff preview and apply flow
 subagent/subagent-types.ts: SubAgent extension types — SubAgentPhase, SubAgentWorkerInfo, SubAgentRunState, SubAgentRunReport
-interview/index.ts: Requirement clarification extension, /interview command, lightweight before_agent_start hook
+interview/index.ts: Requirement clarification extension entry, /interview and /grill-me commands, interview tool registration, custom message renderers, lightweight before_agent_start hook
+interview/interview-runtime.ts: Interview probe/runtime boundary - synchronous prompt heuristics, workspace context collection, LLM probe coercion, UI follow-up loop, refined intent injection text
 security-audit/interface.ts: Security audit interface, SecurityCheckResult/AuditEvent/SecurityEngine
 security-audit/index.ts: Security extension entry, audit logging and dangerous pattern detection
 security-audit/engine/interceptor.ts: Request/response interception, InterceptorResult confirmation flow
 security-audit/engine/logger.ts: Security event logging, JSON file audit trail
 security-audit/engine/detector.ts: Vulnerability detection, pattern matching for dangerous commands
 soul/index.ts: AI personality evolution extension, persistent personality across sessions
-grub/index.ts: Grub extension entry - autonomous iterative task runner extracted from legacy loop, /grub command + GRUB_MESSAGE_TYPE renderer
-grub/grub-controller.ts: GrubController - drives autonomous grub iterations, state machine for LoopTaskState
+grub/index.ts: Grub extension entry - autonomous iterative task runner, /grub command, dual-phase prompt injection, feature-list guard dispatch, GRUB_MESSAGE_TYPE renderer
+grub/grub-controller.ts: GrubController - drives autonomous grub iterations, durable GrubTaskState, initializer baseline capture, feature-list mutation validation
+grub/grub-decision.ts: Grub assistant protocol parser, extracts validated loop-state decisions from assistant text
 grub/grub-parser.ts: Grub command parsing, parseGrubCommand/buildGrubHelp
-grub/grub-types.ts: Grub types, GrubStatus/GrubDecisionStatus/GrubDecision/GrubTaskState/GrubTaskSnapshot
-grub/README.md: Grub extension documentation - autonomous "keep digging until done" runner
+grub/grub-prompts.ts: Grub prompt construction boundary, initializer/coding system prompts and per-task dispatch prompts
+grub/grub-harness.ts: Grub harness artifact boundary, .grub/<id>/ feature-list/progress-log/init.sh creation
+grub/grub-format.ts: Grub user-facing status/result formatter for readable TUI messages
+grub/grub-turn.ts: Grub turn-end coordinator, parsing assistant output, checklist gates, retry/terminal update events
+grub/grub-i18n.ts: Grub localization helper, English/Chinese prompts and TUI strings
+grub/grub-feature-list.ts: feature-list.json IO, initializer skeleton, legacy checklist migration, passes/evidence-only diff validation
+grub/grub-persistence.ts: Cross-session .grub/<id>/state.json persistence, active task discovery, stale harness pruning
+grub/grub-types.ts: Grub types, GrubStatus/GrubDecisionStatus/GrubDecision/GrubTaskState/GrubTaskSnapshot/FeatureList/PersistedGrubState
+grub/README.md: Grub extension documentation - autonomous "keep digging until done" runner without default git commits
 loop/index.ts: Loop extension entry - session-scoped recurring prompt/command scheduler with pause/resume/run-now/max-runs/quiet, /loop command + LOOP_MESSAGE_TYPE renderer
 loop/scheduler-controller.ts: SchedulerController - in-memory recurring task store with pause/resume/run-now/max-runs, MAX_SCHEDULED_TASKS=50
 loop/scheduler-parser.ts: Loop command parsing with flags/subcommands, parseSchedulerCommand/parseDurationSpec/buildSchedulerHelp, --name/--max/--quiet
 loop/scheduler-types.ts: Scheduled loop types, LoopPayloadKind/ScheduledLoopTask/LoopStartSpec/ParsedSchedulerCommand
 loop/README.md: Loop extension documentation - recurring scheduler usage and flags
-sal/index.ts: SAL extension entry, enabled by default, registers --nosal/--sal-ab/--sal-rebuild-terrain flags, /sal:coverage /sal:status /sal:setup commands, before_agent_start/tool_execution_start/agent_end hooks; /sal:setup writes ~/.memory-experiments/credentials.json with adapter inference (insforge/jsonl/noop); publishes structuralAnchor via core/runtime/turn-context (no SAL-specific globals); emits run_start/turn_anchor/run_end eval events through pluggable EvalSink with best-effort shutdown flushing; publishes SAL eval background failures to diagnostic:event; writes local .memory-experiments sidecar anchors only when --sal-ab or NANOPENCIL_SAL_AB=1 is enabled; runtime no-op when --nosal is set
+sal/index.ts: SAL extension entry, enabled by default, registers flags, /sal:* commands, lifecycle hooks, terrain snapshot refresh, eval event emission, and stale-run cleanup scheduling; delegates config, context, runtime contracts, and tool_trace analytics to focused SAL modules
+sal/sal-config.ts: SAL build metadata, eval environment constants, credential loading, truthy parsing, stale-cleanup/A-B flag resolution, experiment id normalization, and sidecar directory resolution
+sal/sal-context.ts: SAL anchor system-prompt injection formatting plus A/B sidecar turn-record persistence
+sal/sal-runtime.ts: SAL shared BuildMeta/TurnState/SalRuntime contracts used across config, context, trace, and entry modules
+sal/sal-trace.ts: SAL tool path extraction, task intent inference, and bounded tool_trace payload construction
 sal/terrain.ts: TerrainSnapshot/TerrainNode/TerrainEdge model, buildTerrainIndex(), checkDipCoverage(), isSnapshotStale(), moduleIdForPath(), parses P2 AGENT.md and P3 file headers
 sal/anchors.ts: StructuralAnchor/AnchorResolution model, locateTask(), locateAction(), evidence-driven scoring with tunable SalWeights, CJK bigram tokenization
 sal/weights.ts: SalWeights interface, SAL_DEFAULT_WEIGHTS, loadSalWeights() reads sal-config.json from workspace or .memory-experiments/sal/
@@ -61,11 +82,13 @@ sal/eval/noop-sink.ts: noopSink — silent EvalSink used when eval disabled or n
 sal/eval/insforge-sink.ts: InsForgeEvalSink — PostgREST adapter, routes run_start→eval_runs INSERT (merge-duplicates) with legacy-schema fallback, writes turn_anchor/tool_trace/memory_recalls/run_end only after parent run confirmation, tool_trace→eval_tool_traces with PGRST204 fallback, memory_recalls→eval_memory_recalls batch INSERT, run_end→eval_runs PATCH; allowSelfSigned TLS option logs only in development runtime, batching with default 2000ms interval
 sal/eval/jsonl-sink.ts: JsonlEvalSink — append-only filesystem adapter, one JSON object per line, accepts file:// URLs or plain paths, auto-creates parent dir, batched writes
 sal/README.md: SAL extension usage, sidecar output layout, weights override, pluggability contract
-team/index.ts: AgentTeam extension entry, /team <task>, /team:spawn/:preset/:send/:status/:progress/:psyche/:dashboard/:task/:mail/:allow-path/:stop/:terminate/:approve/:mode commands, TEAM_MESSAGE_TYPE speaker-stream renderer, realtime status/dashboard updates
+team/index.ts: AgentTeam extension entry, /team <task>, /team:spawn/:preset/:send/:status/:progress/:psyche/:dashboard/:task/:mail/:allow-path/:stop/:terminate/:approve/:mode command registration and dispatch
+team/team-ui.ts: AgentTeam message renderer, list/status/task formatting, dashboard visibility/timer ownership, realtime observer, speaker-stream emission helpers
 team/team-types.ts: TeammateRole/TeammateMode/TeammateStatus/TeamTask/HarnessState/PsycheWeights/TeamUtterance/Handoff/LeaderPlan/AgentLiveView/TeammateIdentity/PersistedTeammate/TeamSpawnSpec/TeamSendResult types
 team/team-state-store.ts: TeamStateStore class - durable teammate persistence via JSON files in <agentDir>/teams/
 team/team-parser.ts: Team command parser - parseTeamCommand/buildTeamHelp for /team:* subcommands
-team/team-runtime.ts: TeamRuntime class - teammate registry, stable internal labels plus visible teammate names, per-teammate send queue, task/mailbox prompt context, lifecycle, realtime status/live events, durable tasks, mailbox + permission + transcript wiring
+team/team-runtime.ts: TeamRuntime class - teammate registry, stable internal labels plus visible teammate names, per-teammate send queue, lifecycle, durable tasks, mailbox + permission + transcript wiring
+team/team-runtime-helpers.ts: TeamRuntime helper boundary - teammate prompt construction, harness turn preparation, live event projection, tool selection, path guards, label/role/text helpers
 team/team-orchestrator.ts: Leader orchestration helpers - plan building, speaker utterance creation, @mention parsing, and handoff execution
 team/team-task-store.ts: TeamTaskStore class - durable shared task list in <storageDir>/tasks.json
 team/team-harness.ts: Harness protocol helpers - context files, phase instructions, checkpoint/revert, feature validation

package/dist/extensions/defaults/btw/index.js

@@ -62,10 +62,13 @@ async function handleBtwCommand(args, ctx, api) {
     const userMessage = contextText
         ? `Previous conversation:\n${contextText}\n\nUser's question: ${question}`
         : `User's question: ${question}`;
+    let timeout;
     try {
         const response = await Promise.race([
             ctx.completeSimple(BTW_SYSTEM_PROMPT, userMessage),
-            new Promise((resolve) => setTimeout(() => resolve(undefined), BTW_TIMEOUT_MS)),
+            new Promise((resolve) => {
+                timeout = setTimeout(() => resolve(undefined), BTW_TIMEOUT_MS);
+            }),
         ]);
         if (response) {
             api.sendMessage({
@@ -82,6 +85,10 @@ async function handleBtwCommand(args, ctx, api) {
         const message = error instanceof Error ? error.message : String(error);
         ctx.ui.notify(`BTW error: ${message}`, "error");
     }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
 }
 // ============================================================================
 // Extension entry

package/dist/extensions/defaults/discipline/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: disciplineExtension - registers skill tool, nanoPencil engineering discipline skills, and lightweight bootstrap prompt
+ * [FROM]: Depends on node:path, node:url, node:fs, core/extensions/types
+ * [TO]: Auto-loaded by builtin-extensions.ts as a default extension; consumed by ResourceLoader via resources_discover
+ * [HERE]: extensions/defaults/discipline/index.ts - default engineering workflow discipline package
+ */
+import type { ExtensionAPI } from "../../../core/extensions/types.js";
+export default function disciplineExtension(api: ExtensionAPI): Promise<void>;