klyro 1.0.17 → 1.0.20

package/dist/tools/search/glob.js

@@ -7,6 +7,7 @@ import { z } from 'zod';
 import { defineTool } from '../types.js';
 import { resolveWithinCwd } from '../../policy/path-guard.js';
 import { safe } from '../normalize.js';
+import { IgnoreFilter } from './ignore.js';
 const InputSchema = z.object({
     pattern: z.string().min(1).describe('Glob pattern, e.g. "**/*.ts" or "src/**/*.json"'),
     cwd: z.string().optional().describe('Base directory; defaults to workspace cwd'),
@@ -25,7 +26,8 @@ export const globTool = defineTool({
             const max = input.maxResults ?? DEFAULT_MAX;
             const matches = [];
             let truncated = false;
-            await walk(base, base, matcher, max + 1, matches, () => (truncated = true));
+            const ignore = await IgnoreFilter.load(ctx.cwd);
+            await walk(base, base, matcher, max + 1, matches, () => (truncated = true), ignore, ctx.cwd);
             // Normalize to relative, forward-slash paths from ctx.cwd (so
             // tool inputs/outputs are stable across Windows and POSIX).
             const rel = matches.slice(0, max).map((m) => path.relative(ctx.cwd, m).split(path.sep).join('/'));
@@ -50,7 +52,7 @@ export function globToRegex(pattern) {
         .replace(/::DOUBLESTAR::/g, '.*');
     return new RegExp(`${anchor}${escaped}$`);
 }
-async function walk(root, dir, matcher, cap, out, onCap) {
+async function walk(root, dir, matcher, cap, out, onCap, ignore, cwd) {
     if (out.length >= cap)
         return;
     let names;
@@ -66,6 +68,9 @@ async function walk(root, dir, matcher, cap, out, onCap) {
         if (SKIP_DIRS.has(name))
             continue;
         const full = path.join(dir, name);
+        const relToCwd = path.relative(cwd, full);
+        if (ignore.ignores(relToCwd))
+            continue;
         let isDir = false;
         try {
             const s = await fs.lstat(full);
@@ -83,6 +88,6 @@ async function walk(root, dir, matcher, cap, out, onCap) {
                 onCap();
         }
         if (isDir)
-            await walk(root, full, matcher, cap, out, onCap);
+            await walk(root, full, matcher, cap, out, onCap, ignore, cwd);
     }
 }

package/dist/tools/search/grep.js

@@ -7,6 +7,7 @@ import { z } from 'zod';
 import { defineTool } from '../types.js';
 import { resolveWithinCwd } from '../../policy/path-guard.js';
 import { safe, TOOL_ERROR_CODES } from '../normalize.js';
+import { IgnoreFilter } from './ignore.js';
 const InputSchema = z.object({
     pattern: z.string().min(1).describe('JavaScript regular expression (not ripgrep syntax)'),
     cwd: z.string().optional(),
@@ -48,6 +49,7 @@ export const grepTool = defineTool({
             const hits = [];
             let searched = 0;
             let truncated = false;
+            const ignore = await IgnoreFilter.load(ctx.cwd);
             await walk(base, async (file) => {
                 if (hits.length >= max) {
                     truncated = true;
@@ -88,7 +90,7 @@ export const grepTool = defineTool({
                         hits.push(hit);
                     }
                 }
-            });
+            }, ignore, ctx.cwd);
             return { pattern: input.pattern, hits, truncated, searchedFiles: searched };
         });
     },
@@ -102,7 +104,7 @@ function globToRegex(g) {
         .replace(/::DS::/g, '.*');
     return new RegExp(`^${escaped}$`);
 }
-async function walk(dir, visit) {
+async function walk(dir, visit, ignore, cwd) {
     let names;
     try {
         names = await fs.readdir(dir);
@@ -114,6 +116,11 @@ async function walk(dir, visit) {
         if (SKIP_DIRS.has(name))
             continue;
         const full = path.join(dir, name);
+        if (ignore && cwd) {
+            const relToCwd = path.relative(cwd, full);
+            if (ignore.ignores(relToCwd))
+                continue;
+        }
         let isDir = false;
         try {
             const s = await fs.lstat(full);
@@ -125,7 +132,7 @@ async function walk(dir, visit) {
             continue;
         }
         if (isDir)
-            await walk(full, visit);
+            await walk(full, visit, ignore, cwd);
         else
             await visit(full);
     }

package/dist/tools/search/ignore.d.ts

@@ -0,0 +1,8 @@
+/** Converts a .gitignore rule to a regex. Assumes no negative (!) rules for now. */
+export declare function ignoreRuleToRegex(rule: string): RegExp | null;
+export declare class IgnoreFilter {
+    private rules;
+    static load(cwd: string): Promise<IgnoreFilter>;
+    /** Accepts a relative path (posix or windows) and returns true if it should be ignored. */
+    ignores(relPath: string): boolean;
+}

package/dist/tools/search/ignore.js

@@ -0,0 +1,49 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/** Converts a .gitignore rule to a regex. Assumes no negative (!) rules for now. */
+export function ignoreRuleToRegex(rule) {
+    let p = rule.trim();
+    if (!p || p.startsWith('#') || p.startsWith('!'))
+        return null;
+    // Strip trailing slashes
+    if (p.endsWith('/'))
+        p = p.slice(0, -1);
+    // If it starts with /, anchor to root; else it can match anywhere
+    const anchorStart = p.startsWith('/') ? '^' : '(?:^|/)';
+    if (p.startsWith('/'))
+        p = p.slice(1);
+    const escaped = p
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*\*/g, '::DS::')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\?/g, '[^/]')
+        .replace(/::DS::/g, '.*');
+    return new RegExp(`${anchorStart}${escaped}(?:/|$)`);
+}
+export class IgnoreFilter {
+    rules = [];
+    static async load(cwd) {
+        const filter = new IgnoreFilter();
+        for (const name of ['.gitignore', '.klyroignore']) {
+            try {
+                const content = await fs.readFile(path.join(cwd, name), 'utf-8');
+                for (const line of content.split('\n')) {
+                    const re = ignoreRuleToRegex(line);
+                    if (re)
+                        filter.rules.push(re);
+                }
+            }
+            catch { /* missing/unreadable */ }
+        }
+        return filter;
+    }
+    /** Accepts a relative path (posix or windows) and returns true if it should be ignored. */
+    ignores(relPath) {
+        const normalized = relPath.replace(/\\/g, '/');
+        for (const re of this.rules) {
+            if (re.test(normalized))
+                return true;
+        }
+        return false;
+    }
+}

package/dist/tools/search/search-files.js

@@ -16,6 +16,7 @@ import { defineTool } from '../types.js';
 import { resolveWithinCwd } from '../../policy/path-guard.js';
 import { safe } from '../normalize.js';
 import { globToRegex } from './glob.js';
+import { IgnoreFilter } from './ignore.js';
 const InputSchema = z.object({
     query: z.string().optional().describe('Substring or regex to match against file paths (case-insensitive)'),
     glob: z.string().optional().describe('Glob pattern to constrain candidates, e.g. "src/**/*.ts"'),
@@ -29,7 +30,7 @@ function queryToRegex(query) {
     const escaped = query.replace(/[.+^${}()|[\]\\]/g, '\\$&');
     return new RegExp(escaped, 'i');
 }
-async function walk(root, dir, onFile) {
+async function walk(root, dir, onFile, ignore, cwd) {
     let names;
     try {
         names = await fs.readdir(dir);
@@ -41,6 +42,11 @@ async function walk(root, dir, onFile) {
         if (SKIP_DIRS.has(name))
             continue;
         const full = path.join(dir, name);
+        if (ignore && cwd) {
+            const relToCwd = path.relative(cwd, full);
+            if (ignore.ignores(relToCwd))
+                continue;
+        }
         let isDir = false;
         try {
             const s = await fs.lstat(full);
@@ -52,7 +58,7 @@ async function walk(root, dir, onFile) {
             continue;
         }
         if (isDir)
-            await walk(root, full, onFile);
+            await walk(root, full, onFile, ignore, cwd);
         else
             await onFile(full);
     }
@@ -69,6 +75,7 @@ export const searchFilesTool = defineTool({
             const globRe = input.glob ? globToRegex(input.glob) : null;
             const candidates = [];
             const now = Date.now();
+            const ignore = await IgnoreFilter.load(ctx.cwd);
             await walk(base, base, async (full) => {
                 const rel = path.relative(ctx.cwd, full).split(path.sep).join('/');
                 if (globRe && !globRe.test(rel))
@@ -101,7 +108,7 @@ export const searchFilesTool = defineTool({
                 // Recency: 0..30 points, 0 days = 30, 30+ days = 0
                 score += Math.max(0, 30 - ageDays);
                 candidates.push({ path: rel, score, mtimeMs, firstParty });
-            });
+            }, ignore, ctx.cwd);
             candidates.sort((a, b) => b.score - a.score);
             const truncated = candidates.length > max;
             return { matches: candidates.slice(0, max), truncated };

package/dist/tui/app.js

@@ -7,6 +7,8 @@ import React, { useState, useEffect, useRef, useCallback, useMemo } from 'react'
 import { Box, Text, useInput, useStdout } from 'ink';
 import Spinner from 'ink-spinner';
 import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import * as path from 'node:path';
 import { TuiApprovalBridge, ApprovalModal } from './approval.js';
 import { parse as parseSlash, suggestCommands } from '../cli/slash/parser.js';
 import { loadCustomCommands, listCompletableFiles } from '../cli/slash/custom.js';
@@ -33,6 +35,40 @@ function Header({ cwd, model, version, width }) {
     const showLinks = width >= 120;
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, flexShrink: 0, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { bold: true, color: tokens.colors.accent, children: ["KLYRO  v", version] }), showLinks ? _jsx(Text, { color: tokens.colors.dim, children: "\u2502  /help   /config   /clear   /exit" }) : null] }), _jsxs(Text, { color: tokens.colors.dim, children: [model, "  \u00B7  ", cwd] }), branch ? _jsxs(Text, { color: tokens.colors.dim, children: ["\u2387  ", branch] }) : null] }));
 }
+/**
+ * 5.5c — compact todo checklist. Live `plan` state (`todo_write` →
+ * `plan_update` events → `updatePlan`) wins; when it is empty, best-effort
+ * read of `.klyro/plans/todos.json` so a reloaded TUI still shows the list.
+ */
+const TODO_STATUSES = ['pending', 'in_progress', 'done', 'failed', 'skipped'];
+function loadTodosFromDisk(cwd) {
+    try {
+        const raw = readFileSync(path.join(cwd, '.klyro', 'plans', 'todos.json'), 'utf-8');
+        const arr = JSON.parse(raw);
+        if (!Array.isArray(arr))
+            return [];
+        return arr
+            .filter((t) => typeof t.title === 'string' && t.title.length > 0)
+            .map((t, i) => ({
+            id: typeof t.id === 'string' ? t.id : `disk-${i}`,
+            title: t.title,
+            status: TODO_STATUSES.includes(t.status)
+                ? t.status
+                : 'pending',
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+function TodoChecklist({ plan, cwd }) {
+    // Disk fallback only when live state is empty (never masks live updates).
+    const disk = useMemo(() => (plan.length > 0 ? [] : loadTodosFromDisk(cwd)), [plan.length, cwd]);
+    const items = plan.length > 0 ? plan : disk;
+    if (items.length === 0)
+        return null;
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, marginTop: 0, marginBottom: 1, children: [_jsxs(Box, { children: [_jsxs(Text, { color: tokens.colors.guide, children: ["  ", g('guide'), "   "] }), _jsxs(Text, { bold: true, children: [g('todoPlan'), " Plan  ", items.filter((p) => p.status === 'done').length, "/", items.length] })] }), items.slice(0, 8).map((p, i) => (_jsxs(Box, { children: [_jsxs(Text, { color: tokens.colors.guide, children: ["  ", g('guide'), "   "] }), _jsxs(Text, { color: p.status === 'done' ? tokens.colors.ok : p.status === 'in_progress' ? tokens.colors.accent : tokens.colors.dim, children: [p.status === 'done' ? g('todoDone') : p.status === 'in_progress' ? g('todoActive') : g('todoPending'), " ", i + 1, ". ", redact(p.title)] })] }, p.id)))] }));
+}
 function verbForTool(name) {
     if (name === 'read_file')
         return 'Read';
@@ -1287,5 +1323,5 @@ export function App(props) {
                                 if (it.kind === 'diff')
                                     return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, marginBottom: 1, children: [_jsx(Text, { bold: true, color: tokens.colors.soft, children: it.summary ?? 'Diff' }), it.hunks.map((h, i) => (_jsxs(Box, { flexDirection: "column", marginTop: 0, children: [_jsx(Text, { color: tokens.colors.soft, children: h.path }), h.lines.map((l, j) => (_jsxs(Text, { wrap: "wrap", color: l.kind === 'add' ? tokens.colors.ok : l.kind === 'remove' ? tokens.colors.err : tokens.colors.dim, children: [l.kind === 'add' ? '+ ' : l.kind === 'remove' ? '- ' : '  ', redact(l.text)] }, j)))] }, i)))] }, it.id));
                                 return null;
-                            }) : null, showThinking && status.status === 'running' && !streamingIdRef.current ? (_jsxs(Box, { paddingLeft: 2, marginBottom: 1, children: [_jsxs(Text, { color: tokens.colors.guide, children: ["  ", g('guide'), "   "] }), _jsxs(Text, { color: tokens.colors.accent, children: [_jsx(Spinner, { type: "dots" }), " "] }), _jsx(Text, { color: tokens.colors.dim, children: "Thinking... (esc \u00D72 to cancel)" }), _jsxs(Text, { color: tokens.colors.dim, children: ["  ", (elapsed / 1000).toFixed(1), "s"] })] })) : null, showPlan && plan.length > 0 ? (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, marginTop: 0, marginBottom: 1, children: [_jsxs(Box, { children: [_jsxs(Text, { color: tokens.colors.guide, children: ["  ", g('guide'), "   "] }), _jsxs(Text, { bold: true, children: [g('todoPlan'), " Plan  ", plan.filter((p) => p.status === 'done').length, "/", plan.length] })] }), plan.slice(0, 8).map((p, i) => (_jsxs(Box, { children: [_jsxs(Text, { color: tokens.colors.guide, children: ["  ", g('guide'), "   "] }), _jsxs(Text, { color: p.status === 'done' ? tokens.colors.ok : p.status === 'in_progress' ? tokens.colors.accent : tokens.colors.dim, children: [p.status === 'done' ? g('todoDone') : p.status === 'in_progress' ? g('todoActive') : g('todoPending'), " ", i + 1, ". ", redact(p.title)] })] }, p.id)))] })) : null, showQueued && queuedInputs.length > 0 ? (_jsx(Box, { flexDirection: "column", paddingLeft: 2, marginBottom: 1, children: queuedInputs.map((q, i) => (_jsxs(Text, { color: tokens.colors.dim, children: ["queued: ", redact(q.slice(0, 60)), i === 0 ? '  esc to drop' : ''] }, i))) })) : null] }), isFullscreen && !atBottom ? (_jsx(Box, { flexDirection: "column", width: 1, marginLeft: 1, children: Array.from({ length: trackH }).map((_, i) => (_jsx(Text, { color: i === thumbPos ? tokens.colors.accent : tokens.colors.guide, children: i === thumbPos ? '●' : '│' }, i))) })) : null] }), pinned && badgeLabel(atBottom, pendingNew, status.status !== 'running') ? (_jsx(Box, { justifyContent: "center", flexShrink: 0, children: _jsxs(Text, { backgroundColor: tokens.colors.accentSoft, color: tokens.colors.accent, bold: true, children: [' ', badgeLabel(atBottom, pendingNew, status.status !== 'running'), ' '] }) })) : null, slashSuggest.length > 0 ? (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, flexShrink: 0, children: [slashSuggest.map((s, i) => (_jsxs(Text, { color: i === 0 ? tokens.colors.accent : tokens.colors.dim, children: [i === 0 ? '▸' : ' ', " /", s.name, "  \u2014 ", s.hint] }, s.name))), _jsx(Text, { color: tokens.colors.dim, children: "  tab to complete" })] })) : null, slashSuggest.length === 0 && pathSuggest.length > 0 ? (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, flexShrink: 0, children: [pathSuggest.map((s, i) => (_jsxs(Text, { color: i === 0 ? tokens.colors.accent : tokens.colors.dim, children: [i === 0 ? '▸' : ' ', " ", s.name] }, s.name))), _jsx(Text, { color: tokens.colors.dim, children: "  tab to complete" })] })) : null, _jsx(ApprovalModal, { bridge: bridge }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsx(Text, { color: tokens.colors.guide, children: g('rule').repeat(Math.max(10, width - 2)) }), _jsxs(Box, { children: [_jsxs(Text, { color: tokens.colors.accent, bold: true, children: [g('prompt'), " "] }), vimMode === 'normal' ? _jsx(Text, { color: tokens.colors.warn, bold: true, children: "--NORMAL-- " }) : null, _jsx(InputWithCursor, { input: input, cursor: vimCursor })] }), _jsx(Text, { color: tokens.colors.guide, children: g('rule').repeat(Math.max(10, width - 2)) })] }), _jsxs(Box, { justifyContent: "space-between", flexShrink: 0, children: [_jsxs(Text, { color: tokens.colors.dim, children: [status.status === 'running' ? (_jsxs(Text, { color: tokens.colors.accent, children: [_jsx(Spinner, { type: "dots" }), " working  \u00B7  "] })) : null, baseHints, maxTop > 0 && isFullscreen ? '  ·  PgUp/Dn scroll' : ''] }), _jsxs(Text, { color: tokens.colors.dim, children: [maxTop > 0 && isFullscreen ? `⇅ ${topRow}/${maxTop} · ` : '', cost > 0 ? `$${cost.toFixed(2)} · ` : '', ctxPct, "% ctx \u00B7 ", status.model, status.status === 'running' ? ' ●' : ''] })] })] }));
+                            }) : null, showThinking && status.status === 'running' && !streamingIdRef.current ? (_jsxs(Box, { paddingLeft: 2, marginBottom: 1, children: [_jsxs(Text, { color: tokens.colors.guide, children: ["  ", g('guide'), "   "] }), _jsxs(Text, { color: tokens.colors.accent, children: [_jsx(Spinner, { type: "dots" }), " "] }), _jsx(Text, { color: tokens.colors.dim, children: "Thinking... (esc \u00D72 to cancel)" }), _jsxs(Text, { color: tokens.colors.dim, children: ["  ", (elapsed / 1000).toFixed(1), "s"] })] })) : null, showPlan ? _jsx(TodoChecklist, { plan: plan, cwd: props.cwd }) : null, showQueued && queuedInputs.length > 0 ? (_jsx(Box, { flexDirection: "column", paddingLeft: 2, marginBottom: 1, children: queuedInputs.map((q, i) => (_jsxs(Text, { color: tokens.colors.dim, children: ["queued: ", redact(q.slice(0, 60)), i === 0 ? '  esc to drop' : ''] }, i))) })) : null] }), isFullscreen && !atBottom ? (_jsx(Box, { flexDirection: "column", width: 1, marginLeft: 1, children: Array.from({ length: trackH }).map((_, i) => (_jsx(Text, { color: i === thumbPos ? tokens.colors.accent : tokens.colors.guide, children: i === thumbPos ? '●' : '│' }, i))) })) : null] }), pinned && badgeLabel(atBottom, pendingNew, status.status !== 'running') ? (_jsx(Box, { justifyContent: "center", flexShrink: 0, children: _jsxs(Text, { backgroundColor: tokens.colors.accentSoft, color: tokens.colors.accent, bold: true, children: [' ', badgeLabel(atBottom, pendingNew, status.status !== 'running'), ' '] }) })) : null, slashSuggest.length > 0 ? (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, flexShrink: 0, children: [slashSuggest.map((s, i) => (_jsxs(Text, { color: i === 0 ? tokens.colors.accent : tokens.colors.dim, children: [i === 0 ? '▸' : ' ', " /", s.name, "  \u2014 ", s.hint] }, s.name))), _jsx(Text, { color: tokens.colors.dim, children: "  tab to complete" })] })) : null, slashSuggest.length === 0 && pathSuggest.length > 0 ? (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, flexShrink: 0, children: [pathSuggest.map((s, i) => (_jsxs(Text, { color: i === 0 ? tokens.colors.accent : tokens.colors.dim, children: [i === 0 ? '▸' : ' ', " ", s.name] }, s.name))), _jsx(Text, { color: tokens.colors.dim, children: "  tab to complete" })] })) : null, _jsx(ApprovalModal, { bridge: bridge }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsx(Text, { color: tokens.colors.guide, children: g('rule').repeat(Math.max(10, width - 2)) }), _jsxs(Box, { children: [_jsxs(Text, { color: tokens.colors.accent, bold: true, children: [g('prompt'), " "] }), vimMode === 'normal' ? _jsx(Text, { color: tokens.colors.warn, bold: true, children: "--NORMAL-- " }) : null, _jsx(InputWithCursor, { input: input, cursor: vimCursor })] }), _jsx(Text, { color: tokens.colors.guide, children: g('rule').repeat(Math.max(10, width - 2)) })] }), _jsxs(Box, { justifyContent: "space-between", flexShrink: 0, children: [_jsxs(Text, { color: tokens.colors.dim, children: [status.status === 'running' ? (_jsxs(Text, { color: tokens.colors.accent, children: [_jsx(Spinner, { type: "dots" }), " working  \u00B7  "] })) : null, baseHints, maxTop > 0 && isFullscreen ? '  ·  PgUp/Dn scroll' : ''] }), _jsxs(Text, { color: tokens.colors.dim, children: [maxTop > 0 && isFullscreen ? `⇅ ${topRow}/${maxTop} · ` : '', cost > 0 ? `$${cost.toFixed(2)} · ` : '', ctxPct, "% ctx \u00B7 ", status.model, status.status === 'running' ? ' ●' : ''] })] })] }));
 }

package/dist/tui/app.test.js

@@ -215,9 +215,9 @@ describe('App', () => {
     });
     it('pressing End re-engages follow-tail and reveals new content', async () => {
         const { stdin, lastFrame } = render(_jsx(App, { initialModel: "m", maxSteps: 10, cwd: "/test", onPrompt: async () => { }, onSlash: async () => { }, isFullscreen: true, initialTranscript: makeInitialTranscript(25) }));
-        await new Promise((r) => setTimeout(r, 100));
+        await new Promise((r) => setTimeout(r, 200));
         stdin.write(KEY_HOME);
-        await new Promise((r) => setTimeout(r, 100));
+        await new Promise((r) => setTimeout(r, 200));
         const g = globalThis;
         g.__klyroAppAppend({
             id: 'late-1',
@@ -229,7 +229,7 @@ describe('App', () => {
         expect(lastFrame() ?? '').not.toMatch(/LATE-1-tag/);
         // End re-engages follow-tail and shows the new content.
         stdin.write(KEY_END);
-        await new Promise((r) => setTimeout(r, 100));
+        await new Promise((r) => setTimeout(r, 200));
         const frame = lastFrame() ?? '';
         expect(frame).toMatch(/LATE-1-tag/);
     });
@@ -757,6 +757,20 @@ describe('App', () => {
         expect(f2() ?? '').toContain(readVersion());
         expect(f2() ?? '').not.toContain('0.1.27');
     });
+    it('shows the todo checklist when plan updates arrive (5.5c)', async () => {
+        const { lastFrame } = render(_jsx(App, { initialModel: "m", maxSteps: 10, cwd: "/test", onPrompt: async () => { }, onSlash: async () => { } }));
+        const g = globalThis;
+        for (let i = 0; i < 40 && !g.__klyroAppPlan; i++)
+            await new Promise((r) => setTimeout(r, 25));
+        expect(g.__klyroAppPlan).toBeDefined();
+        g.__klyroAppPlan?.([
+            { id: '1', title: 'Read files', status: 'done' },
+            { id: '2', title: 'Edit code', status: 'in_progress' },
+        ]);
+        const frame = await waitForMatch(lastFrame, /Read files/);
+        expect(frame).toMatch(/Plan/);
+        expect(frame).toMatch(/Edit code/);
+    });
     it('Shift+Up / Shift+Down scroll by one line', async () => {
         const { stdin, lastFrame } = render(_jsx(App, { initialModel: "m", maxSteps: 10, cwd: "/test", onPrompt: async () => { }, onSlash: async () => { }, isFullscreen: true, initialTranscript: makeInitialTranscript(25) }));
         await new Promise((r) => setTimeout(r, 50));

package/dist/tui/transcript-commands.d.ts

@@ -32,3 +32,17 @@ export interface TranscriptKey {
  *   Ctrl+Home → first · Ctrl+End → last · anything else → undefined.
  */
 export declare function getTranscriptCommand(input: string, key: TranscriptKey): TranscriptCommand | undefined;
+/**
+ * 4.4c — `# note` command: a line starting with `# ` (hash + space) is a
+ * session note, not a prompt. Returns the note text, or undefined when the
+ * line is not a note (a lone `#` or `#nospace` stays a regular prompt).
+ */
+export declare function parseSessionNote(line: string): string | undefined;
+/**
+ * Handle one input line as a potential `# note`. When it is a note, the
+ * text is appended as session-note feedback through `append` (the same
+ * channel as other command feedback — the caller's queuedAppend) and
+ * persisted via `persist` when the caller has a session-file hook.
+ * Returns true when the line was consumed as a note.
+ */
+export declare function handleHashNoteLine(line: string, append: (text: string) => void, persist?: (note: string) => void | Promise<void>): boolean;

package/dist/tui/transcript-commands.js

@@ -30,3 +30,34 @@ export function getTranscriptCommand(input, key) {
         return 'messages_last';
     return undefined;
 }
+/**
+ * 4.4c — `# note` command: a line starting with `# ` (hash + space) is a
+ * session note, not a prompt. Returns the note text, or undefined when the
+ * line is not a note (a lone `#` or `#nospace` stays a regular prompt).
+ */
+export function parseSessionNote(line) {
+    if (!line.startsWith('# '))
+        return undefined;
+    const note = line.slice(2).trim();
+    if (!note)
+        return undefined;
+    return note;
+}
+/**
+ * Handle one input line as a potential `# note`. When it is a note, the
+ * text is appended as session-note feedback through `append` (the same
+ * channel as other command feedback — the caller's queuedAppend) and
+ * persisted via `persist` when the caller has a session-file hook.
+ * Returns true when the line was consumed as a note.
+ */
+export function handleHashNoteLine(line, append, persist) {
+    const note = parseSessionNote(line);
+    if (note === undefined)
+        return false;
+    append(`[note] ${note}`);
+    try {
+        void persist?.(note);
+    }
+    catch { /* best-effort only */ }
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klyro",
-  "version": "1.0.17",
+  "version": "1.0.20",
   "description": "Klyro — autonomous coding harness CLI that streams from any OpenAI-compatible or Anthropic LLM endpoint.",
   "type": "module",
   "main": "dist/index.js",