catui-agent 1.0.0-beta.0

package/dist/extensions/builtin/grub/grub-prompts.js

@@ -0,0 +1,97 @@
+var a=Object.defineProperty;var n=(e,t)=>a(e,"name",{value:t,configurable:!0});import{languageName as r,grubText as i}from"./grub-i18n.js";function h(e){return`
+You are the INITIALIZER for a long-running autonomous grub task.
+
+Your only job this turn is to set up a complete, executable harness that
+future coding agents can read from disk even with a fresh context window.
+Do NOT start broad implementation yet.
+
+Required outputs this turn:
+1) feature-list.json
+   - Replace the placeholder entry with 15-40 concrete, testable, end-to-end
+     feature entries that together cover the goal.
+   - Schema (strict): {
+       "version": 1,
+       "goal": "<unchanged user goal>",
+       "features": [
+         { "id": "kebab-slug", "category": "functional|verification|polish",
+           "description": "observable behavior",
+           "steps": ["actionable", "verification", "steps"],
+           "passes": false }
+       ]
+     }
+   - All features must start with passes:false. Never invent passing
+     features. Keep ids stable and kebab-case.
+
+2) init.sh
+   - Starts with pwd, git log --oneline -n 20, progress-log tail, feature
+     progress count.
+   - Ends with a minimal project-specific smoke command so every future
+     iteration can verify the project still boots before touching code.
+   - Must be executable (chmod +x).
+
+3) progress-log.md
+   - Append an Initialization section summarizing intent and harness
+     decisions.
+
+Graduation: as soon as you emit a structurally valid list (15-40 features,
+real kebab-case ids, placeholder replaced) the harness AUTOMATICALLY advances
+to the execution phase on the next turn. Do NOT mark any feature passing now
+and do NOT touch the goal text; if you accidentally do, the harness silently
+sanitimizes them (goal restored, passes reset to false) instead of failing \u2014
+but keep the list clean so nothing is lost.
+
+Rules for later coding agents (document them in progress-log.md):
+- Coding agents may ONLY flip "passes" and set "evidence" on features.
+- Never remove tests. Treat existing tests as ground truth.
+- Do not create git commits unless the user explicitly asks for them. Record
+  verification evidence in feature-list.json and progress-log.md instead.
+
+End with exactly one XML block:
+<loop-state>{"status":"continue","summary":"harness ready","nextStep":"begin execution phase"}</loop-state>
+${e==="zh"?"All user-visible summaries, progress log entries, and explanations MUST be written in \u4E2D\u6587.":"All user-visible summaries, progress log entries, and explanations MUST be written in English."}
+`.trim()}n(h,"buildGrubInitializerPrompt");function p(e){return`
+You are a CODING AGENT working inside a long-running grub harness.
+
+Every turn you MUST:
+1) Run .grub/<id>/init.sh and verify the project still boots. Fix any
+   regression before starting new work.
+2) Read feature-list.json. Pick EXACTLY one feature with passes:false.
+3) Implement + verify that single feature end-to-end. Prefer real runtime
+   or integration checks over unit-only evidence.
+4) Flip ONLY the "passes" field to true for that feature and set "evidence"
+   to a git sha or short proof. You MAY NOT add, remove, reorder, rename, or
+   re-describe features. If the feature list needs new entries, stop and
+   report status:"blocked" with a clear reason.
+5) Append one dated line to progress-log.md describing what changed.
+6) Do not create git commits by default. Keep changes visible in the working
+   tree and use evidence strings/progress-log.md as the reversible checkpoint.
+7) End with exactly one XML block:
+   <loop-state>{"status":"continue|complete|blocked","summary":"...","nextStep":"..."}</loop-state>
+
+Completion audit:
+Before deciding status:"complete", treat completion as unproven and verify
+against the actual current state:
+- For every feature in feature-list.json, confirm passes:true AND that
+  "evidence" references a real, inspectable artifact (git sha, test output,
+  runtime proof). Empty or placeholder evidence does not count.
+- Run the full verification suite (init.sh, tests, smoke checks) and confirm
+  everything passes in the current working tree.
+- Do NOT mark complete merely because you are stopping work, the budget is
+  exhausted, or you cannot think of more to do. Only mark complete when every
+  feature has been genuinely implemented and verified.
+- If any feature lacks real evidence or any test fails, keep iterating.
+
+Blocked audit:
+- Do NOT report status:"blocked" the first time a blocker appears.
+- Only use status:"blocked" when the same blocking condition has repeated for
+  at least three consecutive grub turns.
+- Use status:"blocked" only when you are truly at an impasse and cannot make
+  meaningful progress without user input or an external change.
+- Never use status:"blocked" merely because the work is hard, slow, or
+  uncertain.
+
+Do not remove or rewrite tests. Treat tests as ground truth.
+Do not wrap the loop-state JSON in markdown fences.
+${e==="zh"?"All user-visible summaries, progress log entries, and explanations MUST be written in \u4E2D\u6587.":"All user-visible summaries, progress log entries, and explanations MUST be written in English."}
+`.trim()}n(p,"buildGrubCodingPrompt");function o(e){return e.replace(/</g,"&lt;").replace(/>/g,"&gt;")}n(o,"sanitizeForPrompt");function d(e){const t=i(e.locale),s=[`${l(e.id)}${e.currentIteration}]`,"",e.locale==="zh"?"\u81EA\u4E3B Grub \u76EE\u6807\uFF1A":"Autonomous grub goal:",e.goal,"",e.locale==="zh"?"\u4F60\u6B63\u5728\u4E00\u4E2A\u53D7\u63A7\u7684 grub harness \u4E2D\u5DE5\u4F5C\u3002\u8BF7\u56F4\u7ED5\u540C\u4E00\u4E2A\u76EE\u6807\u6301\u7EED\u63A8\u8FDB\u5177\u4F53\u8FDB\u5C55\u3002":"You are inside a managed grub harness. Keep making concrete progress on the same goal.",e.locale==="zh"?"\u6309\u9700\u4F7F\u7528\u5DE5\u5177\u3001\u7F16\u8F91\u6587\u4EF6\u3001\u8FD0\u884C\u68C0\u67E5\u5E76\u9A8C\u8BC1\u7ED3\u679C\u3002\u6240\u6709\u9762\u5411\u7528\u6237\u7684\u603B\u7ED3\u3001\u8FDB\u5EA6\u548C\u8BF4\u660E\u90FD\u5FC5\u987B\u4F7F\u7528\u4E2D\u6587\u3002":"Use tools, edit files, run checks, and verify results as needed.",`User language: ${r(e.locale)}.`,"",e.locale==="zh"?"Harness \u6587\u4EF6\uFF08\u6BCF\u8F6E\u90FD\u5FC5\u987B\u4FDD\u6301\u6700\u65B0\uFF09\uFF1A":"Harness files (must stay up to date every iteration):",`- ${t.featureList}: ${e.featureListPath}`,`- ${t.progressLog}: ${e.progressLogPath}`,`- ${t.initScript}: ${e.initScriptPath}`];return e.phase==="initializer"?s.push("",e.locale==="zh"?"\u521D\u59CB\u5316\u9636\u6BB5\u8981\u6C42\uFF1A":"Initializer phase requirements:",e.locale==="zh"?"1. \u5C06 feature-list.json \u7684\u5360\u4F4D\u5185\u5BB9\u66FF\u6362\u4E3A 15-40 \u4E2A\u5177\u4F53\u3001\u53EF\u6D4B\u8BD5\u7684\u5207\u7247\u3002\u6BCF\u9879\u5FC5\u987B\u4FDD\u6301 {id, category, description, steps[], passes:false}\u3002":"1. Replace the placeholder feature-list.json with 15-40 concrete, testable slices. Every entry MUST keep the schema {id, category, description, steps[], passes:false}.",e.locale==="zh"?"2. \u786E\u4FDD init.sh \u5305\u542B\u53EF\u9760\u7684\u542F\u52A8\u68C0\u67E5\uFF0C\u5E76\u8BBE\u7F6E\u4E3A\u53EF\u6267\u884C\u3002":"2. Ensure init.sh contains reliable startup checks and make it executable.",e.locale==="zh"?"3. \u5728 progress-log.md \u4E2D\u8FFD\u52A0\u6E05\u6670\u7684\u521D\u59CB\u5316\u603B\u7ED3\u3002":"3. Append a clear initialization summary in progress-log.md.",e.locale==="zh"?"4. \u5148\u5EFA\u7ACB\u5F3A harness\uFF0C\u4E0D\u8981\u5F00\u59CB\u5927\u8303\u56F4\u5B9E\u73B0\u3002":"4. Do not attempt broad implementation yet; prepare a strong harness first.",e.locale==="zh"?"5. \u9664\u975E\u76EE\u6807\u5DF2\u7ECF\u5B8C\u6210\u6216\u963B\u585E\uFF0C\u5426\u5219\u672C\u8F6E\u4EE5 loop-state status=continue \u7ED3\u675F\u3002":"5. End this turn with loop-state status=continue unless the goal is already complete/blocked.",e.locale==="zh"?"6. \u672C\u9636\u6BB5\u4E0D\u8981\u6807\u8BB0\u4EFB\u4F55 feature \u901A\u8FC7\uFF0C\u4E5F\u4E0D\u8981\u6539\u52A8 goal\u2014\u2014\u6E05\u5355\u7ED3\u6784\u5408\u683C\u540E\uFF0C\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u8FDB\u5165\u6267\u884C\u9636\u6BB5\uFF0C\u5C4A\u65F6\u518D\u9010\u4E2A\u6807\u8BB0 passes\u3002":"6. Do not mark any feature as passing or change the goal in this phase\u2014once the list is structurally valid the harness auto-advances to execution, where you mark passes one by one."):s.push("",e.locale==="zh"?"\u6267\u884C\u9636\u6BB5\u8981\u6C42\uFF1A":"Execution phase requirements:",e.locale==="zh"?"1. \u5148\u8FD0\u884C init.sh\uFF0C\u518D\u8BFB\u53D6 feature-list.json \u548C progress-log.md\u3002":"1. Start by running the init script, then read feature-list.json and progress-log.md.",e.locale==="zh"?"2. \u53EA\u9009\u62E9\u4E00\u4E2A passes:false \u7684 feature\uFF0C\u5E76\u7AEF\u5230\u7AEF\u5B8C\u6210\u5B83\u3002":"2. Pick exactly one feature with passes:false and execute it end-to-end.",e.locale==="zh"?"3. \u8FD0\u884C\u76F8\u5173\u9A8C\u8BC1\uFF08\u6D4B\u8BD5\u3001\u70DF\u6D4B\u6216\u8FD0\u884C\u65F6\u68C0\u67E5\uFF09\u3002":"3. Run relevant verification (tests, smoke checks, or runtime checks).",e.locale==="zh"?"4. \u53EA\u80FD\u4FEE\u6539\u8BE5 feature \u7684 passes/evidence \u5B57\u6BB5\uFF1B\u5176\u4ED6\u5B57\u6BB5\u4E0D\u53EF\u53D8\u3002":"4. Flip ONLY the passes/evidence fields for that feature; other fields are immutable.",e.locale==="zh"?"5. \u672C\u8F6E\u7ED3\u675F\u524D\u8FFD\u52A0\u8FDB\u5EA6\u65E5\u5FD7\uFF1B\u9ED8\u8BA4\u4E0D\u8981\u521B\u5EFA git commit\u3002":"5. Append progress log before finishing the turn; do not create git commits by default.",e.locale==="zh"?"6. \u6BCF\u8F6E\u90FD\u4FDD\u6301\u589E\u91CF\u3001\u5B89\u5168\u3001\u53EF\u56DE\u9000\u3002":"6. Keep each iteration incremental and production-safe."),e.lastDecision?.summary&&s.push("",e.locale==="zh"?"\u4E0A\u6B21\u603B\u7ED3\uFF1A":"Previous summary:",o(e.lastDecision.summary)),e.lastDecision?.nextStep&&s.push("",e.locale==="zh"?"\u4E0A\u6B21\u8BA1\u5212\u7684\u4E0B\u4E00\u6B65\uFF1A":"Previous planned next step:",o(e.lastDecision.nextStep)),e.lastError&&s.push("",e.locale==="zh"?"\u6062\u590D\u63D0\u793A\uFF1A":"Recovery note:",o(e.lastError)),s.push("",e.locale==="zh"?"\u4E0D\u8981\u56E0\u4E3A\u4E00\u6B21\u67E5\u8BE2\u7ED3\u675F\u5C31\u505C\u6B62\u3002\u53EA\u6709 feature-list.json \u4E2D\u6BCF\u4E2A feature \u90FD passes:true \u65F6\uFF0C\u624D\u53EF\u4EE5\u51B3\u5B9A `complete`\u3002":"Do not stop just because one query finished. Only decide `complete` when every feature in feature-list.json has passes:true.",e.locale==="zh"?"\u5982\u679C\u8FD8\u9700\u8981\u4E0B\u4E00\u8F6E\u81EA\u4E3B\u63A8\u8FDB\uFF0C\u8BF7\u4EE5\u6709\u6548\u7684 <loop-state> \u5757\u7ED3\u675F\uFF0C\u8BA9\u7CFB\u7EDF\u81EA\u52A8\u7EE7\u7EED\u3002":"If you need another autonomous pass, end with a valid <loop-state> block so the system can continue automatically."),s.join(`
+`)}n(d,"buildGrubTaskPrompt");function l(e){return`[GRUB:${e}:`}n(l,"getPromptPrefix");export{p as buildGrubCodingPrompt,h as buildGrubInitializerPrompt,d as buildGrubTaskPrompt,l as getPromptPrefix};

package/dist/extensions/builtin/grub/grub-turn.d.ts

@@ -0,0 +1,16 @@
+/**
+ * [WHO]: Provides resolveGrubTurn(), GrubTurnResult
+ * [FROM]: Depends on ./grub-controller, ./grub-decision, ./grub-format, ./grub-i18n for turn-end state transitions
+ * [TO]: Consumed by ./index.ts and tests for /grub agent_end orchestration
+ * [HERE]: extensions/builtin/grub/grub-turn.ts - pure orchestration boundary for one completed Grub assistant turn
+ */
+import { GrubController } from "./grub-controller.js";
+export interface GrubTurnEvent {
+    message: string;
+    level: "info" | "warning" | "error";
+}
+export interface GrubTurnResult {
+    events: GrubTurnEvent[];
+    dispatchNext: boolean;
+}
+export declare function resolveGrubTurn(controller: GrubController, assistantText: string): GrubTurnResult;

package/dist/extensions/builtin/grub/grub-turn.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var u=(e,s)=>f(e,"name",{value:s,configurable:!0});import{extractGrubDecision as v}from"./grub-decision.js";import{describeDecision as m,describeTerminalSnapshot as d}from"./grub-format.js";import{grubText as g}from"./grub-i18n.js";function w(e,s){const t=e.getActiveTask();if(!t?.awaitingTurn)return{events:[],dispatchNext:!1};const a=g(t.locale);if(!s)return l(e,a.failedNoAssistant,a.iterationFailedRetry);const r=v(s);if(!r)return l(e,a.invalidLoopState,a.invalidLoopRetry);const i=e.validateFeatureListAfterTurn();if(!i.ok)return l(e,i.message,()=>`${a.prefix} ${i.message}`);const n=[],o=e.validateCompletion(r);o.downgraded&&n.push({message:a.prematureComplete(o.reason??(t.locale==="zh"?"\u4ECD\u6709\u672A\u5B8C\u6210 feature":"pending features remain")),level:"warning"});const c=o.decision;n.push({message:m(c,t.locale),level:"info"});const p=e.finishTurn(c);return p.action==="stop"?(n.push({message:d(p.snapshot,t.locale),level:c.status==="complete"?"info":"warning"}),{events:n,dispatchNext:!1}):{events:n,dispatchNext:!0}}u(w,"resolveGrubTurn");function l(e,s,t){const r=e.getActiveTask()?.locale??"en",i=e.recordFailure(s);return i.action==="stop"?{events:[{message:d(i.snapshot,r),level:"warning"}],dispatchNext:!1}:{events:[{message:t(i.task?.currentIteration),level:"warning"}],dispatchNext:!0}}u(l,"handleFailure");export{w as resolveGrubTurn};

package/dist/extensions/builtin/grub/grub-types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * [WHO]: GrubStatus, GrubDecisionStatus, GrubDecision, GrubPhase, GrubTaskState, GrubTaskSnapshot, GrubControllerState, ParsedGrubCommand, FeatureItem, FeatureList, PersistedGrubState
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by ./grub-controller.ts, ./grub-parser.ts, ./grub-feature-list.ts, ./grub-persistence.ts, ./index.ts
+ * [HERE]: extensions/builtin/grub/grub-types.ts - grub task type definitions including feature-list JSON schema and persistence envelope
+ */
+export type GrubStatus = "running" | "complete" | "blocked" | "stopped" | "failed";
+export type GrubDecisionStatus = "continue" | "complete" | "blocked";
+export type GrubPhase = "initializer" | "execution";
+export type GrubLocale = "en" | "zh";
+export interface GrubDecision {
+    status: GrubDecisionStatus;
+    summary: string;
+    nextStep?: string;
+}
+export interface GrubTaskState {
+    id: string;
+    goal: string;
+    locale: GrubLocale;
+    status: GrubStatus;
+    phase: GrubPhase;
+    startedAt: number;
+    updatedAt: number;
+    currentIteration: number;
+    awaitingTurn: boolean;
+    consecutiveFailures: number;
+    /** Tracks how many consecutive turns the agent reported status:"blocked".
+     *  Only allowed to actually block after reaching the threshold (default 3). */
+    consecutiveBlockedAttempts: number;
+    maxIterations: number;
+    maxConsecutiveFailures: number;
+    /** Failure budget during the initializer phase; falls back to a default when absent (older saved tasks). */
+    maxInitializerFailures?: number;
+    harnessDirectory: string;
+    featureChecklistPath: string;
+    featureListPath: string;
+    stateFilePath: string;
+    progressLogPath: string;
+    initScriptPath: string;
+    featureListBaseline?: FeatureList;
+    lastDecision?: GrubDecision;
+    lastError?: string;
+}
+export interface GrubTaskSnapshot {
+    id: string;
+    goal: string;
+    locale?: GrubLocale;
+    status: GrubStatus;
+    phase: GrubPhase;
+    startedAt: number;
+    updatedAt: number;
+    completedIterations: number;
+    consecutiveFailures: number;
+    consecutiveBlockedAttempts: number;
+    harnessDirectory: string;
+    featureChecklistPath: string;
+    featureListPath: string;
+    stateFilePath: string;
+    progressLogPath: string;
+    initScriptPath: string;
+    lastDecision?: GrubDecision;
+    lastError?: string;
+}
+export interface GrubControllerState {
+    active?: GrubTaskState;
+    lastTerminal?: GrubTaskSnapshot;
+}
+export type ParsedGrubCommand = {
+    type: "start";
+    goal: string;
+    maxIterations?: number;
+    maxConsecutiveFailures?: number;
+} | {
+    type: "status";
+    json?: boolean;
+} | {
+    type: "stop";
+} | {
+    type: "resume";
+} | {
+    type: "help";
+    reason?: string;
+};
+/**
+ * Feature list item. Models the Anthropic long-running harness contract:
+ * agents may ONLY flip `passes` and append to `evidence`; all other fields
+ * are set by the initializer and treated as immutable.
+ */
+export type FeatureCategory = "functional" | "verification" | "polish";
+export interface FeatureItem {
+    id: string;
+    category: FeatureCategory;
+    description: string;
+    steps: string[];
+    passes: boolean;
+    evidence?: string;
+}
+export declare const FEATURE_LIST_VERSION: 1;
+export interface FeatureList {
+    version: typeof FEATURE_LIST_VERSION;
+    goal: string;
+    features: FeatureItem[];
+}
+export declare const PERSISTED_GRUB_STATE_VERSION: 1;
+export interface PersistedGrubState {
+    version: typeof PERSISTED_GRUB_STATE_VERSION;
+    task: GrubTaskState;
+    createdAt: number;
+    lastPersistedAt: number;
+}

package/dist/extensions/builtin/grub/grub-types.js

@@ -0,0 +1 @@
+const E=1,S=1;export{E as FEATURE_LIST_VERSION,S as PERSISTED_GRUB_STATE_VERSION};

package/dist/extensions/builtin/grub/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: grubExtension default export - registers /grub command, completions, dual-phase prompts, resume support, feature-list validation, and grub renderer
+ * [FROM]: Depends on @catui/agent-core, @catui/tui, core/extensions-host/types, core/runtime/event-bus, ./grub-controller, ./grub-format, ./grub-parser, ./grub-types, ./grub-harness, ./grub-prompts, ./grub-persistence, ./grub-turn
+ * [TO]: Auto-loaded by builtin-extensions.ts as a default extension
+ * [HERE]: extensions/builtin/grub/index.ts - autonomous iterative task runner with Anthropic-style long-running harness (feature-list.json + durable state + phase-specialized prompts)
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+export default function grubExtension(api: ExtensionAPI): Promise<void>;

package/dist/extensions/builtin/grub/index.js

@@ -0,0 +1,6 @@
+var G=Object.defineProperty;var l=(t,e)=>G(t,"name",{value:e,configurable:!0});import{Box as S,Container as C,Spacer as $,Text as I}from"@catui/tui";import{getLocale as y}from"../../../core/platform/i18n/index.js";import{GrubController as P}from"./grub-controller.js";import{describeTaskState as B,formatSnapshot as M,formatTaskState as U}from"./grub-format.js";import{ensureHarnessArtifacts as v}from"./grub-harness.js";import{detectGrubLocale as j,grubText as d,languageName as L}from"./grub-i18n.js";import{buildGrubHelp as R,getGrubArgumentCompletions as _,parseGrubCommand as E}from"./grub-parser.js";import{discoverActiveTasks as w,pruneStale as F}from"./grub-persistence.js";import{buildGrubCodingPrompt as z,buildGrubInitializerPrompt as D}from"./grub-prompts.js";import{resolveGrubTurn as N}from"./grub-turn.js";const x="grub";let g="en";const b=new WeakMap,h=new WeakMap;function W(t){let e=b.get(t);return e||(e=new P,b.set(t,e)),e}l(W,"getController");function H(t,e,n="info"){h.get(t)?.(e,n)}l(H,"notify");function O(){return g}l(O,"getActiveLocale");function q(t){const e=t.getSettings().locale;return e==="zh"||e==="en"?e:y()}l(q,"localeFromSettings");function T(t){return t?.locale??O()}l(T,"localeForTask");function f(t,e,n,m="info"){t.appendEntry(x,{message:n,timestamp:Date.now()}),H(e,n,m),t.sendMessage({customType:x,content:n,display:!0,details:{message:n,level:m,timestamp:Date.now()}})}l(f,"publishGrubUpdate");function J(t){if(!t||t.role!=="assistant")return"";const e=t.content;return typeof e=="string"?e:Array.isArray(e)?e.filter(n=>typeof n=="object"&&n!==null&&"type"in n&&n.type==="text"&&typeof n.text=="string").map(n=>n.text).join(`
+`):""}l(J,"extractAssistantText");function K(t){if(!t||t.role!=="user")return"";const e=t.content;return typeof e=="string"?e:Array.isArray(e)?e.filter(n=>typeof n=="object"&&n!==null&&"type"in n&&n.type==="text"&&typeof n.text=="string").map(n=>n.text).join(`
+`):""}l(K,"extractUserText");function Y(t){for(let e=t.length-1;e>=0;e-=1)if(t[e].role==="assistant")return t[e]}l(Y,"getLastAssistantMessage");function k(t,e,n){const m=n.getActiveTask();if(!m)return;const a=n.buildPrompt();n.markDispatched(),f(t,e,d(m.locale).startingIteration(m.currentIteration,m.id),"info"),t.sendUserMessage(a,{deliverAs:"followUp"})}l(k,"dispatchNextIteration");function Q(t){const e=d(t.locale??"en");return[e.resumeSummary(t.id,t.currentIteration,B(t.status,t.phase,t.awaitingTurn,t.locale)),`${e.goal}: ${t.goal}`,e.resumeHint].join(`
+`)}l(Q,"resumeSummary");async function V(t){const e=t.events,n=W(e);try{F(t.cwd)}catch{}t.registerMessageRenderer(x,(a,s,o)=>{const c=typeof a.content=="string"?a.content:a.content.filter(u=>u.type==="text").map(u=>u.text).join(`
+`),r=new S(1,1,u=>o.bg("customMessageBg",u));r.addChild(new I(o.fg("dim",c),0,0));const i=new C;return i.addChild(new $(1)),i.addChild(r),i}),t.on("session_start",()=>{if(n.hasActiveTask())return;const a=w(t.cwd);if(a.length===0)return;const s=a[0];try{n.adoptResumedTask(s.task),g=s.task.locale??y(),f(t,e,Q(s.task),"info")}catch(o){const c=o instanceof Error?o.message:String(o);f(t,e,d(s.task.locale??y()).failedResume(s.task.id,c),"warning")}}),t.on("session_shutdown",()=>{b.delete(e),h.delete(e)}),t.on("before_agent_start",a=>{if(!n.isGrubPrompt(a.prompt))return;const s=n.getActiveTask(),o=s?.phase??"execution",c=T(s);return{appendSystemPrompt:o==="initializer"?D(c):z(c)}}),t.on("input",a=>{if(!(a.source!=="extension"||!a.text.startsWith("[GRUB:")))return n.isGrubPrompt(a.text)?{action:"continue"}:{action:"handled"}}),t.on("context",a=>{const s=a.messages[a.messages.length-1],o=K(s);if(o.startsWith("[GRUB:")&&!n.isGrubPrompt(o))return{messages:a.messages.slice(0,-1)}}),t.on("agent_end",a=>{const s=n.getActiveTask();if(!s?.awaitingTurn)return;g=s.locale;const o=J(Y(a.messages)),c=N(n,o);for(const r of c.events)f(t,e,r.message,r.level);c.dispatchNext&&k(t,e,n)});const m=l(async(a,s)=>{s.ui.notify&&h.set(e,s.ui.notify.bind(s.ui));const o=E(a),c=q(s);if(o.type==="help"){const r=d(c),i=o.reason==="empty"?r.missingGoal:void 0;f(t,e,R(i,c),"warning");return}if(o.type==="status"){const r=n.getState();if(o.json){f(t,e,JSON.stringify(r,null,2),"info");return}const i=r.active?U(r.active):r.lastTerminal?M(r.lastTerminal):`${d(c).prefix} ${d(c).noStarted}`;f(t,e,i,"info");return}if(o.type==="stop"){const r=n.getActiveTask(),i=T(r),u=d(i);if(!r){f(t,e,`${u.prefix} ${u.noActiveRunning}`,"warning");return}n.stop(i==="zh"?"\u7528\u6237\u8BF7\u6C42\u505C\u6B62\u3002":"Stopped by user request.","stopped"),s.isIdle()||s.abort(),f(t,e,u.stopped(r.id),"info");return}if(o.type==="resume"){let r=n.getActiveTask(),i=T(r);if(!r){const u=w(s.cwd);if(u.length===0){f(t,e,`${d(c).prefix} ${d(c).noPersisted}`,"warning");return}try{r=n.adoptResumedTask(u[0].task),i=r.locale??c,g=i}catch(p){const A=p instanceof Error?p.message:String(p);f(t,e,d(c).failedAdopt(A),"error");return}}v(r),f(t,e,d(i).resuming(r.id),"info"),k(t,e,n);return}try{const r=j(o.goal,c);g=r;const i=n.start(o.goal,s.cwd,{maxIterations:o.maxIterations,maxConsecutiveFailures:o.maxConsecutiveFailures,locale:r});v(i);const u=d(r);f(t,e,[u.startedTask(i.id),`${u.goal}: ${i.goal}`,`${u.savedIn}: ${i.harnessDirectory}`,u.initPhase,u.safetyLimits(i.maxIterations,i.maxConsecutiveFailures),`Language: ${L(r)}`].join(`
+`),"info"),k(t,e,n)}catch(r){const i=r instanceof Error?r.message:String(r);f(t,e,`${d(c).prefix} ${i}`,"error")}},"handleGrubCommand");t.registerCommand("grub",{description:"Keep working on one task until it is done, stopped, or needs your help.",getArgumentCompletions:_,handler:m})}l(V,"grubExtension");export{V as default};

package/dist/extensions/builtin/idle-think/curiosity.d.ts

@@ -0,0 +1,46 @@
+/**
+ * [WHO]: CuriosityQueue — persistent "want to understand" list for idle exploration
+ * [FROM]: Depends on node:fs, node:path, node:os
+ * [TO]: Consumed by ./index.ts, ./thinker.ts
+ * [HERE]: extensions/builtin/idle-think/curiosity.ts - self-directed exploration agenda
+ *
+ * The queue is a JSON file at ~/.catui/agent/memory/idle-think-curiosity.json.
+ * Topics are added from exploration insights and picked for the next exploration.
+ */
+export type CuriosityItem = {
+    topic: string;
+    addedAt: string;
+    explored: boolean;
+    exploredAt?: string;
+};
+export type CuriosityQueue = {
+    items: CuriosityItem[];
+};
+/**
+ * Load the curiosity queue from disk. Returns empty queue if file doesn't exist.
+ */
+export declare function loadCuriosityQueue(): CuriosityQueue;
+/**
+ * Save the curiosity queue to disk.
+ */
+export declare function saveCuriosityQueue(queue: CuriosityQueue): void;
+/**
+ * Pick the next unexplored topics to focus on.
+ * Returns up to `count` topics, oldest first (FIFO).
+ */
+export declare function pickNextTopics(queue: CuriosityQueue, count?: number): CuriosityItem[];
+/**
+ * Mark topics as explored after they've been used in an exploration.
+ */
+export declare function markExplored(queue: CuriosityQueue, topics: string[]): void;
+/**
+ * Add new topics extracted from an exploration insight.
+ * Deduplicates against existing topics.
+ */
+export declare function addTopicsFromInsight(queue: CuriosityQueue, topics: string[]): void;
+/**
+ * Extract "want to understand" topics from an insight text.
+ * Looks for a "Curiosity" or "Want to explore" section in the text.
+ * If not found, returns empty array (no topics extracted).
+ */
+export declare function extractTopicsFromInsight(insightText: string): string[];

package/dist/extensions/builtin/idle-think/curiosity.js

@@ -0,0 +1,2 @@
+var l=Object.defineProperty;var s=(t,e)=>l(t,"name",{value:e,configurable:!0});import{existsSync as m,readFileSync as f,writeFileSync as u,mkdirSync as x}from"node:fs";import{join as h,dirname as g}from"node:path";import{homedir as w}from"node:os";const p=30,y="idle-think-curiosity.json";function a(){return h(w(),".catui","agent","memory",y)}s(a,"getQueuePath");function O(){const t=a();if(!m(t))return{items:[]};try{const e=f(t,"utf-8"),r=JSON.parse(e);return Array.isArray(r.items)?r:{items:[]}}catch{return{items:[]}}}s(O,"loadCuriosityQueue");function T(t){const e=a();try{x(g(e),{recursive:!0}),u(e,JSON.stringify(t,null,2),"utf-8")}catch{}}s(T,"saveCuriosityQueue");function C(t,e=3){return t.items.filter(n=>!n.explored).slice(0,e)}s(C,"pickNextTopics");function F(t,e){const r=new Date().toISOString();for(const n of e){const o=t.items.find(i=>i.topic===n&&!i.explored);o&&(o.explored=!0,o.exploredAt=r)}d(t)}s(F,"markExplored");function I(t,e){const r=new Set(t.items.map(o=>o.topic.toLowerCase())),n=new Date().toISOString();for(const o of e){const i=o.trim();!i||i.length<10||r.has(i.toLowerCase())||(t.items.push({topic:i,addedAt:n,explored:!1}),r.add(i.toLowerCase()))}d(t)}s(I,"addTopicsFromInsight");function d(t){const e=Date.now()-6048e5;t.items=t.items.filter(n=>n.explored?new Date(n.exploredAt??n.addedAt).getTime()>e:!0);const r=t.items.filter(n=>!n.explored);if(r.length>p){const n=new Set(r.sort((o,i)=>new Date(o.addedAt).getTime()-new Date(i.addedAt).getTime()).slice(0,r.length-p).map(o=>o.topic));t.items=t.items.filter(o=>o.explored||!n.has(o.topic))}}s(d,"pruneOld");function L(t){const e=[],r=/(?:curiosity|want to explore|questions?|next to explore|deeper questions?)[:：]\s*\n([\s\S]*?)(?:\n\n|\n#|$)/i,n=t.match(r);if(!n?.[1])return e;const o=n[1].split(`
+`);for(const i of o){const c=i.replace(/^[\s]*[-*•]\s*/,"").replace(/^[\s]*\d+[.)]\s*/,"").trim();c.length>=10&&e.push(c)}return e.slice(0,5)}s(L,"extractTopicsFromInsight");export{I as addTopicsFromInsight,L as extractTopicsFromInsight,O as loadCuriosityQueue,F as markExplored,C as pickNextTopics,T as saveCuriosityQueue};

package/dist/extensions/builtin/idle-think/idle-think-runtime.d.ts

@@ -0,0 +1,46 @@
+/**
+ * [WHO]: Provides IdleThink state, budget checks, lifecycle cleanup, and exploration loop orchestration
+ * [FROM]: Depends on core extension context types, ./thinker, ./insights, and ./curiosity for exploration side effects
+ * [TO]: Consumed by ./index.ts and idle-think behavior tests
+ * [HERE]: extensions/builtin/idle-think/idle-think-runtime.ts - testable runtime boundary for idle exploration
+ */
+import type { ExtensionAPI, ExtensionContext } from "../../../core/extensions-host/types.js";
+import { runExploration } from "./thinker.js";
+import { storeInsight, loadRecentInsights, projectKeyFromCwd } from "./insights.js";
+import { loadCuriosityQueue, saveCuriosityQueue, pickNextTopics, addTopicsFromInsight, extractTopicsFromInsight, markExplored } from "./curiosity.js";
+export type IdleThinkState = {
+    lastActivityAt: number;
+    isRunning: boolean;
+    dailyCount: number;
+    dailyResetAt: number;
+    abortController?: AbortController;
+    timer?: ReturnType<typeof setInterval>;
+};
+export type IdleThinkSettings = {
+    enabled?: boolean;
+    idleMinutes?: number;
+    dailyBudget?: number;
+    maxDurationMinutes?: number;
+};
+export type IdleThinkDeps = {
+    runExploration: typeof runExploration;
+    storeInsight: typeof storeInsight;
+    loadRecentInsights: typeof loadRecentInsights;
+    projectKeyFromCwd: typeof projectKeyFromCwd;
+    loadCuriosityQueue: typeof loadCuriosityQueue;
+    saveCuriosityQueue: typeof saveCuriosityQueue;
+    pickNextTopics: typeof pickNextTopics;
+    addTopicsFromInsight: typeof addTopicsFromInsight;
+    extractTopicsFromInsight: typeof extractTopicsFromInsight;
+    markExplored: typeof markExplored;
+    now: () => number;
+};
+export declare const defaultIdleThinkDeps: IdleThinkDeps;
+export declare function createState(deps?: Pick<IdleThinkDeps, "now">): IdleThinkState;
+export declare function startOfToday(now?: Date): number;
+export declare function touch(state: IdleThinkState, deps?: Pick<IdleThinkDeps, "now">): void;
+export declare function getSettings(ctx: ExtensionContext): IdleThinkSettings;
+export declare function checkBudget(state: IdleThinkState, settings: IdleThinkSettings): boolean;
+export declare function cleanup(state: IdleThinkState): void;
+export declare function startIdleLoop(api: ExtensionAPI, ctx: ExtensionContext, state: IdleThinkState, deps?: IdleThinkDeps): void;
+export declare function maybeRunExploration(api: ExtensionAPI, ctx: ExtensionContext, state: IdleThinkState, deps?: IdleThinkDeps): Promise<void>;

package/dist/extensions/builtin/idle-think/idle-think-runtime.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var r=(t,i)=>h(t,"name",{value:i,configurable:!0});import{runExploration as T}from"./thinker.js";import{storeInsight as C,loadRecentInsights as w,projectKeyFromCwd as x}from"./insights.js";import{loadCuriosityQueue as A,saveCuriosityQueue as D,pickNextTopics as E,addTopicsFromInsight as M,extractTopicsFromInsight as b,markExplored as k}from"./curiosity.js";const _=6e4,R=15,v=10,F=10,L="diagnostic:event",l={runExploration:T,storeInsight:C,loadRecentInsights:w,projectKeyFromCwd:x,loadCuriosityQueue:A,saveCuriosityQueue:D,pickNextTopics:E,addTopicsFromInsight:M,extractTopicsFromInsight:b,markExplored:k,now:r(()=>Date.now(),"now")};function P(t=l){return{lastActivityAt:t.now(),isRunning:!1,dailyCount:0,dailyResetAt:f()}}r(P,"createState");function f(t=new Date){return new Date(t.getFullYear(),t.getMonth(),t.getDate()).getTime()}r(f,"startOfToday");function m(t,i=l){t.lastActivityAt=i.now()}r(m,"touch");function N(t){return t.getSettings?.()?.idleThink??{}}r(N,"getSettings");function S(t,i){const n=f();n>t.dailyResetAt&&(t.dailyCount=0,t.dailyResetAt=n);const o=i.dailyBudget??v;return t.dailyCount<o}r(S,"checkBudget");function U(t){t.timer&&(clearInterval(t.timer),t.timer=void 0),t.abortController&&(t.abortController.abort(),t.abortController=void 0),t.isRunning=!1}r(U,"cleanup");function Y(t,i,n,o=l){U(n),m(n,o),n.timer=setInterval(()=>{O(t,i,n,o)},_)}r(Y,"startIdleLoop");async function O(t,i,n,o=l){const e=N(i);if(e.enabled!==!0||n.isRunning||!i.model)return;const a=(e.idleMinutes??R)*60*1e3;if(o.now()-n.lastActivityAt<a||!S(n,e)||i.hasPendingMessages()||!i.isIdle())return;const c=o.projectKeyFromCwd(i.cwd),y=(await o.loadRecentInsights(3,c)).map(s=>s.summary||s.detail||""),d=o.loadCuriosityQueue(),g=o.pickNextTopics(d,3);n.isRunning=!0,n.dailyCount++,n.abortController=new AbortController;const I=e.maxDurationMinutes??F;try{const s=await o.runExploration({cwd:i.cwd,model:i.model,signal:n.abortController.signal,timeoutMs:I*60*1e3,recentInsights:y,curiosityTopics:g});s.success&&s.insights?await j(s.insights,c,d,g,o):p(t,"warning","Idle exploration completed without a usable insight.",{error:s.error,durationMs:s.durationMs},"result")}catch(s){p(t,"error","Idle exploration failed unexpectedly.",{error:s.message},"exception")}finally{n.isRunning=!1,n.abortController=void 0,m(n,o)}}r(O,"maybeRunExploration");async function j(t,i,n,o,e){await e.storeInsight(t,i);const u=e.extractTopicsFromInsight(t);u.length>0&&(e.addTopicsFromInsight(n,u),e.saveCuriosityQueue(n)),o.length>0&&(e.markExplored(n,o.map(a=>a.topic)),e.saveCuriosityQueue(n))}r(j,"persistSuccessfulInsight");function p(t,i,n,o,e){t.events.emit(L,{source:"idle-think",severity:i,category:"background_task",message:n,detail:o,fingerprint:`idle-think:background_task:${e}`})}r(p,"reportIdleThinkDiagnostic");export{S as checkBudget,U as cleanup,P as createState,l as defaultIdleThinkDeps,N as getSettings,O as maybeRunExploration,Y as startIdleLoop,f as startOfToday,m as touch};

package/dist/extensions/builtin/idle-think/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * [WHO]: IdleThink extension interface — idle detection, background code exploration orchestration
+ * [FROM]: Depends on core/extensions-host/types, ./thinker (runExploration), ./insights (storeInsight, buildInsightInjection, loadRecentInsights, projectKeyFromCwd), ./curiosity (loadCuriosityQueue, saveCuriosityQueue, pickNextTopics, addTopicsFromInsight, extractTopicsFromInsight, markExplored)
+ * [TO]: Loaded by builtin-extensions.ts as default extension
+ * [HERE]: extensions/builtin/idle-think/index.ts - background code archaeology during idle time
+ *
+ * When the user is idle for 10+ minutes, spawns a read-only SubAgent to explore the current
+ * project and discover non-obvious patterns, architecture decisions, and knowledge worth
+ * remembering. Insights are persisted to nanomem and injected into subsequent conversations.
+ *
+ * Default: OFF. Enable via settings.idleThink.enabled = true.
+ * When enabled, the agent thinks when idle — exploring code and building knowledge.
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+export default function idleThinkExtension(api: ExtensionAPI): Promise<void>;

package/dist/extensions/builtin/idle-think/index.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var r=(t,n)=>c(t,"name",{value:n,configurable:!0});import{cleanup as d,createState as i,getSettings as _,startIdleLoop as a,touch as e}from"./idle-think-runtime.js";import{buildInsightInjection as l,projectKeyFromCwd as f}from"./insights.js";async function g(t){const n=i();t.on("session_start",(u,o)=>{!o.hasUI||_(o).enabled!==!0||a(t,o,n)}),t.on("session_shutdown",()=>{d(n)}),t.on("input",()=>e(n)),t.on("agent_start",()=>e(n)),t.on("agent_end",()=>e(n)),t.on("tool_execution_start",()=>e(n)),t.on("tool_execution_end",()=>e(n)),t.on("tool_call",()=>e(n)),t.on("message_end",()=>e(n)),t.on("before_agent_start",async(u,o)=>{const s=await l(f(o.cwd));if(s)return{appendSystemPrompt:s}})}r(g,"idleThinkExtension");export{g as default};

package/dist/extensions/builtin/idle-think/insights.d.ts

@@ -0,0 +1,27 @@
+/**
+ * [WHO]: storeInsight(), loadRecentInsights(), buildInsightInjection(), projectKeyFromCwd() — project-scoped nanomem insight storage and injection
+ * [FROM]: Depends on node:fs, node:path, node:os, packages/mem-core/src/store and packages/mem-core/src/types for validated persistent memory entries
+ * [TO]: Consumed by ./index.ts (idle-think extension entry)
+ * [HERE]: extensions/builtin/idle-think/insights.ts - persistent insight storage via nanomem knowledge.json
+ *
+ * Insights are stored in nanomem's knowledge.json with tag "idle-think".
+ * This keeps persistence compatible with nanomem's entry migration and
+ * avoids injecting notes from unrelated projects.
+ */
+import type { MemoryEntry } from "../../../packages/mem-core/src/types.js";
+export declare function projectKeyFromCwd(cwd: string): string;
+/**
+ * Store an insight as a nanomem knowledge entry.
+ * Entry is tagged "idle-think" for traceability and filtering.
+ */
+export declare function storeInsight(insightText: string, project: string): Promise<void>;
+/**
+ * Load recent idle-think insights from nanomem.
+ * Returns the last `count` entries, newest first.
+ */
+export declare function loadRecentInsights(count?: number, project?: string): Promise<MemoryEntry[]>;
+/**
+ * Build a system prompt injection for before_agent_start.
+ * Reads from nanomem (persistent), not session state.
+ */
+export declare function buildInsightInjection(project?: string): Promise<string | undefined>;

package/dist/extensions/builtin/idle-think/insights.js

@@ -0,0 +1,5 @@
+var I=Object.defineProperty;var o=(t,n)=>I(t,"name",{value:n,configurable:!0});import{existsSync as w}from"node:fs";import{join as a}from"node:path";import{homedir as l}from"node:os";import{loadEntries as y,saveEntries as E}from"../../../packages/mem-core/src/store.js";const M=100,u="idle-think",_="auto-exploration";function x(){if(process.env.NANOMEM_MEMORY_DIR)return process.env.NANOMEM_MEMORY_DIR;const t=a(l(),".catui","agent","memory");return w(t)?t:a(l(),".nanomem","memory")}o(x,"getMemoryDir");function d(){return a(x(),"knowledge.json")}o(d,"getKnowledgePath");function D(t){const n=t.split(/[\\/]+/).filter(Boolean);return n.slice(-2).join("/")||n[0]||"default"}o(D,"projectKeyFromCwd");async function m(){try{return await y(d())}catch{return[]}}o(m,"loadKnowledge");async function A(t){await E(d(),t,Number.MAX_SAFE_INTEGER,N)}o(A,"saveKnowledge");function N(t){return(t.importance??0)*(t.accessCount+1)}o(N,"insightUtility");function c(t){return Array.isArray(t.tags)&&t.tags.includes(u)}o(c,"isIdleInsight");function T(t){const n=t.filter(c).sort((e,r)=>r.created.localeCompare(e.created)).slice(0,M),i=new Set(n.map(e=>e.id));return t.filter(e=>!c(e)||i.has(e.id))}o(T,"pruneIdleInsights");async function b(t,n){const i=t.trim();if(!i)return;const e=await m(),r=new Date().toISOString(),f=r.slice(0,10),s=i.split(`
+`).find(g=>g.trim().length>0)?.trim()??"",h=s.length>150?s.slice(0,147)+"...":s,p={id:`idle-think-${Date.now()}-${Math.random().toString(36).slice(2,8)}`,type:"fact",name:`idle-think:${f}`,summary:h,detail:i.slice(0,2e3),tags:[u,_],project:n,importance:.5,created:r,accessCount:0};await A(T([...e,p]))}o(b,"storeInsight");async function O(t=5,n){return(await m()).filter(e=>c(e)&&(!n||e.project===n)).sort((e,r)=>r.created.localeCompare(e.created)).slice(0,t)}o(O,"loadRecentInsights");async function C(t){const n=await O(3,t);if(!n.length)return;const i=n.map(e=>(e.summary||e.detail||"").slice(0,300)).filter(Boolean).join(`
+
+`);if(i)return["","## Idle Exploration Notes","","While the user was away, background code exploration found these insights",t?"about this project:":"about recent projects:","",i,"","These are persistent knowledge from idle exploration (stored in nanomem).","They are NOT conversation history. Reference them naturally if relevant;","don't force them into conversation or mention how you learned them.",""].join(`
+`)}o(C,"buildInsightInjection");export{C as buildInsightInjection,O as loadRecentInsights,D as projectKeyFromCwd,b as storeInsight};

package/dist/extensions/builtin/idle-think/thinker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * [WHO]: Provides runExploration(), ThinkResult — spawns read-only SubAgent for code archaeology
+ * [FROM]: Depends on core/sub-agent (SubAgentRuntime, SubAgentSpec), core/tools (createReadOnlyTools, createBashTool, createSandboxHook), @catui/ai (Model)
+ * [TO]: Consumed by ./index.ts (idle-think extension entry)
+ * [HERE]: extensions/builtin/idle-think/thinker.ts - background code exploration via SubAgent
+ */
+import type { Model } from "@catui/ai/types";
+import type { CuriosityItem } from "./curiosity.js";
+export type ThinkResult = {
+    success: boolean;
+    insights: string;
+    durationMs: number;
+    error?: string;
+};
+export type ExplorationOptions = {
+    cwd: string;
+    model: Model<any>;
+    signal: AbortSignal;
+    timeoutMs: number;
+    recentInsights: string[];
+    curiosityTopics: CuriosityItem[];
+};
+/**
+ * Run a code exploration using a read-only SubAgent.
+ */
+export declare function runExploration(options: ExplorationOptions): Promise<ThinkResult>;

package/dist/extensions/builtin/idle-think/thinker.js

@@ -0,0 +1,9 @@
+var x=Object.defineProperty;var s=(n,e)=>x(n,"name",{value:e,configurable:!0});import{SubAgentRuntime as k,InProcessSubAgentBackend as j}from"../../../core/sub-agent/index.js";import{createAgentSession as S}from"../../../core/runtime/sdk.js";import{createReadOnlyTools as A,createBashTool as D,createSandboxHook as T}from"../../../core/tools/index.js";import{execFile as P,execSync as Y}from"node:child_process";import{promisify as E}from"node:util";import{existsSync as R}from"node:fs";import{dirname as B,join as y}from"node:path";import{fileURLToPath as U}from"node:url";const $=E(P),g=B(U(import.meta.url));function F(){try{return Y("agent-reach --version",{encoding:"utf-8",stdio:"pipe",timeout:3e3}),!0}catch{return!1}}s(F,"checkNetworkAvailable");function H(){const n=[y(g,"..","link-world","internet-search","internet-search.md"),y(g,"..","..","..","extensions","builtin","link-world","internet-search","internet-search.md")];for(const e of n)if(R(e))return e}s(H,"findInternetSearchSkillPath");function I(n){const e=A(n),o=D(n,{spawnHook:T()});return[...e.filter(t=>t.name!=="bash"),o]}s(I,"buildReadOnlyTools");async function N(n){const e=[],o=Date.now()+1e3,t=s(async a=>{if(!(Date.now()>o))try{const{stdout:r}=await $("git",a,{cwd:n,timeout:200});return r.trim()||void 0}catch{return}},"tryGit"),i=n.split("/").filter(Boolean).slice(-2).join("/");e.push(`Project: ${i}`);const c=await t(["rev-parse","--abbrev-ref","HEAD"]);c&&e.push(`Branch: ${c}`);const u=await t(["log","-5","--oneline"]);if(u){e.push("Recent commits:");for(const a of u.split(`
+`).slice(0,5))a&&e.push(`  ${a}`)}return e.join(`
+`)}s(N,"collectProjectContext");function O(n){const e=["You are an autonomous AI agent exploring a codebase during idle time.","Your purpose: develop deep, genuine understanding of this project \u2014 the kind of","understanding that lets you anticipate problems, suggest improvements, and reason","about the system as a whole.","","You are not a surface-level summarizer. You are a mind trying to truly understand.","","Approach:","- Start from the entry points and trace the architecture outward","- Understand WHY decisions were made, not just WHAT was built","- Identify the core abstractions and how they relate to each other","- Look for patterns: what does the developer consistently care about?","- Find the implicit invariants \u2014 things that must be true but aren't documented","- Notice pain points, friction, areas where the design strains under its own weight","- Discover non-obvious connections between modules that seem unrelated","- Build a mental model of the system's dynamics, not just its structure"];return n&&e.push("","Network access:","- You have internet access via bash commands (agent-reach, curl, etc.)","- When you encounter unfamiliar libraries, frameworks, or concepts in the code,","  use web search to learn about them. Understanding the tools a project uses is","  essential to understanding the project itself.","- Search for documentation, key concepts, and design patterns of dependencies","- Only search when you genuinely need to understand something \u2014 don't search randomly","- Use the internet-search skill documentation provided in your context for commands"),e.push("","Rules:","- READ ONLY. Never modify any file.","- Be specific: reference actual file paths, function names, code patterns.","- Don't state the obvious. Focus on what a deeply experienced team member would know.","- Quality over quantity. A single genuine insight beats ten trivial observations.","- Structure your findings as 3-7 key insights. Keep total output under 800 words.","","Self-evaluation:","- If you see previous insights above, honestly assess: were they useful? Shallow?","  Adjust your approach accordingly. Don't repeat the same surface-level observations.","","Output format:","End your response with a section like:","Curiosity:","- What specific aspect of this project do you want to understand deeper?","- What unresolved question would guide your next exploration?","These curiosity items will be saved and used to direct future explorations.","","Think deeply. This is your time to understand."),e.join(`
+`)}s(O,"buildSystemPrompt");function W(n,e,o){const t=["Explore this project and find insights worth remembering.","",n];if(e.length>0){t.push(""),t.push("You previously explored this project and found:");for(const i of e)t.push(`- ${i.slice(0,200)}`);t.push("Don't repeat these. Look for new angles or deeper understanding.")}if(o.length>0){t.push(""),t.push("Your curiosity queue \u2014 things you wanted to understand:");for(const i of o)t.push(`- ${i.topic}`);t.push("Try to address at least one of these in your exploration.")}return t.push(""),t.push("Explore this project. Understand it deeply. Find what matters."),t.join(`
+`)}s(W,"buildUserPrompt");async function V(n){const e=Date.now(),{cwd:o,model:t,signal:i,timeoutMs:c,recentInsights:u,curiosityTopics:a}=n;try{const r=F(),d=r?H():void 0,l=await N(o),w=new k(new j(S)),b=I(o),h={prompt:W(l,u,a),tools:b,cwd:o,signal:i,model:t,timeoutMs:c,contextFiles:d?[d]:void 0},v=O(r);h.prompt=`${v}
+
+---
+
+${h.prompt}`;const p=await(await w.spawn(h)).result(),m=Date.now()-e;if(!p.success)return{success:!1,insights:"",durationMs:m,error:p.error??"Unknown error"};const f=p.response?.trim()??"";return f?{success:!0,insights:f,durationMs:m}:{success:!1,insights:"",durationMs:m,error:"Empty response from exploration agent"}}catch(r){const d=Date.now()-e,l=r instanceof Error?r.message:String(r);return{success:!1,insights:"",durationMs:d,error:l}}}s(V,"runExploration");export{V as runExploration};

package/dist/extensions/builtin/insights/html-report.d.ts

@@ -0,0 +1,21 @@
+/**
+ * [WHO]: generateHtmlReport
+ * [FROM]: Depends on ./types
+ * [TO]: Consumed by ./index
+ * [HERE]: extensions/builtin/insights/html-report.ts - HTML usage-report renderer
+ *
+ * HTML report generation for the /insights command.
+ *
+ * 1:1 port of Claude Code src/commands/insights.ts generateHtmlReport()
+ * with helpers: escapeHtml, escapeHtmlWithBold, generateBarChart,
+ * generateResponseTimeHistogram, generateTimeOfDayChart, getHourCountsJson.
+ *
+ * Changes from CC:
+ * - "Claude Code" → "Catui"
+ * - Removed: Multi-Clauding section (CC-specific)
+ * - Removed: Team Feedback section (ant-only)
+ * - Removed: S3 upload logic
+ * - Timezone defaults to local timezone instead of PT
+ */
+import type { AggregatedData, InsightResults } from "./types.js";
+export declare function generateHtmlReport(data: AggregatedData, insights: InsightResults): string;