kennel 0.2.30 → 0.2.32

package/dist/cli/dispatch.js

@@ -102,6 +102,11 @@ export async function dispatch(argv) {
         deploy(args);
         return;
     }
+    if (command === 'llm') {
+        const { llm } = await import('../llm/command.js');
+        await llm(args);
+        return;
+    }
     // Built-in commands win; use an explicit path (./tasks) to open a folder
     // whose name is also an installed plugin command.
     if (/^[a-z][a-z0-9-]*$/u.test(command)) {

package/dist/cli/usage.js

@@ -12,6 +12,7 @@ export function usage() {
   kennel view [folder] [--host <host>] [--port <port>] [--dry-run]
   kennel open|o [folder] [--open] [--host <host>] [--port <port>] [--dry-run]
   knl <plugin-id|alias> [folder] [--item <id>] [--open] [--dry-run]
+  knl llm [folder|--folder <path>] [full|--depth <count>] [--profile <name>|--no-instructions] [--no-plugins] [--copy]
   kennel serve [folder] [--host <host>] [--port <port>] [--lan|--tailscale]
   kennel share|display [folder] [--lan|--tailscale] [--port <port>] [--dry-run]
   kennel dev [path] [--config <json-file>] [--port <port>] [--script <script>] [--dry-run] [-- <args...>]
@@ -34,5 +35,8 @@ Without an interactive terminal, the viewer prints its URL without a menu.
 Installed plugin ids are commands, for example knl tasks or knl calendar.
 Plugins can declare extra aliases, for example knl mail for plugin id email.
 Use --item <id> for a plugin detail view. Built-in commands take priority.
+
+knl llm prints only agent instructions, profiles, and the research write destination.
+Use knl llm full for repository details and plugin sections. Run knl llm --help for details.
 `);
 }

package/dist/core/runtime.js

@@ -17027,7 +17027,7 @@ var require__2020 = __commonJS(function(exports, module) {
 import {
   createServer
 } from "node:http";
-import { readFile as readFile9, realpath as realpath5, stat as stat8 } from "node:fs/promises";
+import { readFile as readFile10, realpath as realpath5, stat as stat9 } from "node:fs/promises";
 import { extname as extname7, isAbsolute as isAbsolute7, relative as relative11, resolve as resolve12 } from "node:path";
 
 // packages/api/src/server/watcher.ts
@@ -21993,7 +21993,7 @@ function sendContract(response, url, body, headers = {}) {
 
 // packages/api/src/server/folder-metadata-plugin.ts
 import { realpathSync as realpathSync2 } from "node:fs";
-import { readdir as readdir5, readFile as readFile8, stat as stat7 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile9, stat as stat8 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
 import {
   basename as basename6,
@@ -37086,12 +37086,26 @@ var iconExtensions = new Map([
   ["image/jpeg", "jpg"],
   ["image/png", "png"]
 ]);
+var maxSearchIconBytes = 512 * 1024;
+var searchIconTypes = new Map([
+  [".gif", "image/gif"],
+  [".ico", "image/x-icon"],
+  [".jpeg", "image/jpeg"],
+  [".jpg", "image/jpeg"],
+  [".png", "image/png"],
+  [".svg", "image/svg+xml"],
+  [".webp", "image/webp"]
+]);
 function assetKey(value) {
   return createHash4("sha256").update(value).digest("hex");
 }
 function encodeBase64Url(value) {
   return Buffer.from(value, "utf8").toString("base64").replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
 }
+function decodeBase64Url(value) {
+  const padded = `${value}${"=".repeat((4 - value.length % 4) % 4)}`;
+  return Buffer.from(padded.replaceAll("-", "+").replaceAll("_", "/"), "base64").toString("utf8");
+}
 function iconUrl(folder, hash, mediaType) {
   return `/api/folders/${encodeBase64Url(folder)}/assets/${hash}.${iconExtensions.get(mediaType)}`;
 }
@@ -37115,6 +37129,54 @@ async function folderIcon(folder, assets, assetFiles, fallback) {
   };
   return key;
 }
+async function searchIconDataUrl(icon) {
+  if (!icon)
+    return;
+  if (icon.startsWith("data:"))
+    return icon;
+  const mediaType = searchIconTypes.get(extname4(icon).toLowerCase());
+  if (!mediaType)
+    return;
+  const details = await stat5(icon).catch(() => {
+    return;
+  });
+  if (!details?.size || details.size > maxSearchIconBytes)
+    return;
+  return `data:${mediaType};base64,${(await readFile7(icon)).toString("base64")}`;
+}
+async function faviconAsset(folderName, assets) {
+  if (process.env.KENNEL_EXTERNAL_ICONS !== "1")
+    return;
+  const host = await folderWebsite(folderName);
+  if (!host)
+    return;
+  const key = `favicon:${host}`;
+  assets[key] = {
+    mediaType: "image/png",
+    source: "favicon",
+    url: `/api/folder-favicon?path=${encodeURIComponent(folderName)}&host=${encodeURIComponent(host)}`
+  };
+  return key;
+}
+async function iconWithFaviconFallback(folder, assets, assetFiles) {
+  return folderIcon(folder, assets, assetFiles, (folderName) => faviconAsset(folderName, assets));
+}
+async function hydrateFolderIcons(metadata, assetFiles) {
+  const assets = {};
+  const projects = metadata.projects?.items ?? [];
+  const [iconAssetKey, projectItems] = await Promise.all([
+    iconWithFaviconFallback(metadata.folder, assets, assetFiles),
+    Promise.all(projects.map(async (project) => ({
+      ...project,
+      iconAssetKey: await iconWithFaviconFallback(project.worktree, assets, assetFiles)
+    })))
+  ]);
+  return {
+    assets,
+    iconAssetKey,
+    projects: { items: projectItems }
+  };
+}
 async function workspaceBreadcrumbIcons(breadcrumbs, assetFiles, assets = {}) {
   return Promise.all(breadcrumbs.map(async (crumb) => {
     const iconAssetKey = await folderIcon(crumb.path, assets, assetFiles);
@@ -37126,6 +37188,7 @@ async function workspaceBreadcrumbIcons(breadcrumbs, assetFiles, assets = {}) {
 // packages/api/src/server/plugins.ts
 import { pathToFileURL } from "node:url";
 import { existsSync as existsSync3 } from "node:fs";
+import { mkdir as mkdir2, readFile as readFile8, stat as stat7, writeFile as writeFile4 } from "node:fs/promises";
 import { dirname as dirname7, resolve as resolve10, sep as sep6 } from "node:path";
 
 // packages/notes/src/server.ts
@@ -37147,6 +37210,7 @@ var notesManifest = {
 
 // packages/notes/src/server.ts
 var markdownExtensions = new Set([".md", ".markdown"]);
+var llmNoteLimit = 20;
 async function listMarkdownFiles(folder) {
   const files = [];
   const visit = async (current) => {
@@ -37192,6 +37256,45 @@ async function loadNotes(folder, linkedFolders = []) {
     status: "available"
   };
 }
+function codeSpan(text) {
+  const escaped = text.replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]/gu, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`);
+  const longest = Math.max(0, ...(escaped.match(/`+/g) ?? []).map((run) => run.length));
+  const fence = "`".repeat(longest + 1);
+  const pad = escaped.startsWith("`") || escaped.endsWith("`") ? " " : "";
+  return `${fence}${pad}${escaped}${pad}${fence}`;
+}
+async function notesLlmSections({
+  folder,
+  linkedFolders = [],
+  signal
+}) {
+  const groups = [];
+  const notes = [];
+  for (const source of [folder, ...linkedFolders]) {
+    signal.throwIfAborted();
+    const files = await listMarkdownFiles(source);
+    const paths = files.map((file) => resolve9(source, file.relativePath));
+    groups.push({ folder: source, paths });
+    files.forEach((file, index) => notes.push({ activityAt: file.activityAt, path: paths[index] }));
+  }
+  if (notes.length === 0)
+    return [];
+  const recent = notes.sort((left, right) => right.activityAt - left.activityAt || (left.path < right.path ? -1 : left.path > right.path ? 1 : 0)).slice(0, llmNoteLimit);
+  return [
+    {
+      id: "notes",
+      title: "Markdown notes",
+      lines: [
+        ...groups.filter((group) => group.paths.length > 0).map((group) => `- Source: ${codeSpan(group.folder)} (${group.paths.length} ${group.paths.length === 1 ? "note" : "notes"})`),
+        `- Total notes: ${notes.length}`,
+        "",
+        `Most recently changed (${recent.length} of ${notes.length}):`,
+        "",
+        ...recent.map((note) => `- ${codeSpan(note.path)}`)
+      ]
+    }
+  ];
+}
 function createNotesPlugin() {
   return {
     ...notesManifest,
@@ -37206,7 +37309,8 @@ function createNotesPlugin() {
       linkedFolders
     }) {
       return { data: await loadNotes(folder, linkedFolders), kind: "available" };
-    }
+    },
+    llm: notesLlmSections
   };
 }
 
@@ -37220,6 +37324,44 @@ function configuredFolderServerRegistry(registry, resolvedConfig) {
   ];
   return new Map(ids.map((id) => [id, registry.get(id)]));
 }
+var defaultPluginRegistryConfig = {
+  plugins: { disable: [], order: [] }
+};
+function stringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function parsePluginRegistryConfig(content) {
+  const parsed = JSON.parse(content);
+  const config = parsed && typeof parsed === "object" ? parsed : {};
+  return {
+    plugins: {
+      disable: stringArray(config.plugins?.disable),
+      order: stringArray(config.plugins?.order)
+    }
+  };
+}
+async function nearestKennelConfig(folder) {
+  for (let current = folder;; current = dirname7(current)) {
+    const candidate = resolve10(current, "kennel.json");
+    const details = await stat7(candidate).catch(() => {
+      return;
+    });
+    if (details?.isFile())
+      return candidate;
+    if (dirname7(current) === current)
+      return;
+  }
+}
+async function folderPluginRegistryConfig(folder) {
+  const path = await nearestKennelConfig(folder);
+  if (!path)
+    return defaultPluginRegistryConfig;
+  try {
+    return parsePluginRegistryConfig(await readFile8(path, "utf8"));
+  } catch {
+    return defaultPluginRegistryConfig;
+  }
+}
 function createFolderServerPlugins() {
   return [createNotesPlugin()];
 }
@@ -37691,25 +37833,6 @@ var {
   searchProjectIndex,
   sortProjectList
 } = local;
-var maxIconBytes3 = 512 * 1024;
-var iconTypes2 = new Map([
-  [".jpeg", "image/jpeg"],
-  [".jpg", "image/jpeg"],
-  [".png", "image/png"]
-]);
-var iconExtensions2 = new Map([
-  ["image/jpeg", "jpg"],
-  ["image/png", "png"]
-]);
-var searchIconTypes = new Map([
-  [".gif", "image/gif"],
-  [".ico", "image/x-icon"],
-  [".jpeg", "image/jpeg"],
-  [".jpg", "image/jpeg"],
-  [".png", "image/png"],
-  [".svg", "image/svg+xml"],
-  [".webp", "image/webp"]
-]);
 var projectSearchCacheMs = 5000;
 var metadataExtensions = new Set([
   ".html",
@@ -37785,42 +37908,6 @@ function apiHostAllowed(value, remote) {
   const allowlist = (process.env.KENNEL_VIEWER_HOSTS ?? "").split(",").map((host) => host.trim().toLowerCase()).filter(Boolean);
   return allowlist.includes(hostname);
 }
-function decodeBase64Url(value) {
-  const padded = `${value}${"=".repeat((4 - value.length % 4) % 4)}`;
-  return Buffer.from(padded.replaceAll("-", "+").replaceAll("_", "/"), "base64").toString("utf8");
-}
-async function searchIconDataUrl(icon) {
-  if (!icon)
-    return;
-  if (icon.startsWith("data:"))
-    return icon;
-  const mediaType = searchIconTypes.get(extname6(icon).toLowerCase());
-  if (!mediaType)
-    return;
-  const details = await stat7(icon).catch(() => {
-    return;
-  });
-  if (!details?.size || details.size > maxIconBytes3)
-    return;
-  return `data:${mediaType};base64,${(await readFile8(icon)).toString("base64")}`;
-}
-async function faviconAsset(folderName, assets) {
-  if (process.env.KENNEL_EXTERNAL_ICONS !== "1")
-    return;
-  const host = await folderWebsite(folderName);
-  if (!host)
-    return;
-  const key = `favicon:${host}`;
-  assets[key] = {
-    mediaType: "image/png",
-    source: "favicon",
-    url: `/api/folder-favicon?path=${encodeURIComponent(folderName)}&host=${encodeURIComponent(host)}`
-  };
-  return key;
-}
-async function iconWithFaviconFallback(folder, assets, assetFiles) {
-  return folderIcon(folder, assets, assetFiles, (folderName) => faviconAsset(folderName, assets));
-}
 async function repositoryIdentity(folder, assets) {
   const remoteUrl = await gitRemoteUrl(folder).catch(() => {
     return;
@@ -37844,22 +37931,6 @@ async function repositoryIdentity(folder, assets) {
     return;
   }
 }
-async function hydrateAssets(metadata, assetFiles) {
-  const assets = {};
-  const projects = metadata.projects?.items ?? [];
-  const [iconAssetKey, projectItems] = await Promise.all([
-    iconWithFaviconFallback(metadata.folder, assets, assetFiles),
-    Promise.all(projects.map(async (project) => ({
-      ...project,
-      iconAssetKey: await iconWithFaviconFallback(project.worktree, assets, assetFiles)
-    })))
-  ]);
-  return {
-    assets,
-    iconAssetKey,
-    projects: { items: projectItems }
-  };
-}
 function unique(values) {
   return [...new Set(values)];
 }
@@ -37871,8 +37942,8 @@ async function shallowMetadata(folder) {
   const visible = entries.filter((entry) => !entry.name.startsWith(".") && entry.name !== "node_modules");
   const files = await Promise.all(visible.filter((entry) => entry.isFile() && [".markdown", ".md"].includes(extname6(entry.name).toLowerCase())).map(async (entry) => {
     const path = resolve11(folder, entry.name);
-    const details = await stat7(path);
-    const content = await readFile8(path, "utf8").catch(() => "");
+    const details = await stat8(path);
+    const content = await readFile9(path, "utf8").catch(() => "");
     const title = markdownMetadata(content).title;
     return {
       activityAt: details.mtimeMs,
@@ -37926,7 +37997,7 @@ async function notesFiles(folder, files, origin) {
       const path = file.path ?? (file.relativePath ? resolve11(folder, file.relativePath) : undefined);
       if (!path)
         return origin ? { ...file, folder: origin } : file;
-      const content = [".markdown", ".md"].includes(extname6(path).toLowerCase()) ? await readFile8(path, "utf8").catch(() => "") : "";
+      const content = [".markdown", ".md"].includes(extname6(path).toLowerCase()) ? await readFile9(path, "utf8").catch(() => "") : "";
       const title = content ? markdownMetadata(content).title : undefined;
       return {
         ...file,
@@ -38044,44 +38115,6 @@ async function projectSearchItem(project, match) {
     worktree: project.worktree
   };
 }
-var defaultPluginRegistryConfig = {
-  plugins: { disable: [], order: [] }
-};
-function stringArray(value) {
-  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
-}
-function parsePluginRegistryConfig(content) {
-  const parsed = JSON.parse(content);
-  const config = parsed && typeof parsed === "object" ? parsed : {};
-  return {
-    plugins: {
-      disable: stringArray(config.plugins?.disable),
-      order: stringArray(config.plugins?.order)
-    }
-  };
-}
-async function nearestKennelConfig(folder) {
-  for (let current = folder;; current = dirname9(current)) {
-    const candidate = resolve11(current, "kennel.json");
-    const details = await stat7(candidate).catch(() => {
-      return;
-    });
-    if (details?.isFile())
-      return candidate;
-    if (dirname9(current) === current)
-      return;
-  }
-}
-async function folderPluginRegistryConfig(folder) {
-  const path = await nearestKennelConfig(folder);
-  if (!path)
-    return defaultPluginRegistryConfig;
-  try {
-    return parsePluginRegistryConfig(await readFile8(path, "utf8"));
-  } catch {
-    return defaultPluginRegistryConfig;
-  }
-}
 function pluginConfigWarnings(registry, config) {
   const ids = unique([...config.plugins.disable, ...config.plugins.order]);
   return ids.filter((id) => !registry.has(id)).map((id) => `unknown plugin id "${id}" — not installed in this build`);
@@ -38257,7 +38290,7 @@ function createFolderApi({
               "Content-Type": asset.mediaType,
               ETag: `"${hash}"`
             });
-            response.end(await readFile8(asset.path));
+            response.end(await readFile9(asset.path));
           } catch (error) {
             response.writeHead(404, {
               "Content-Type": "text/plain; charset=utf-8"
@@ -38336,7 +38369,7 @@ function createFolderApi({
               {
                 path: relative10(folder, target.path),
                 kind: target.kind,
-                content: previewTextKind(target.kind) ? await readFile8(target.path, "utf8") : ""
+                content: previewTextKind(target.kind) ? await readFile9(target.path, "utf8") : ""
               }
             ] : []
           } : await readFolder(folder);
@@ -38352,7 +38385,7 @@ function createFolderApi({
               documentError(response);
               return;
             }
-            const details = await stat7(target.path);
+            const details = await stat8(target.path);
             if (!details.isFile()) {
               documentError(response);
               return;
@@ -38364,7 +38397,7 @@ function createFolderApi({
               return;
             }
             watch(folder);
-            const content = previewTextKind(target.kind) ? await readFile8(target.path, "utf8") : "";
+            const content = previewTextKind(target.kind) ? await readFile9(target.path, "utf8") : "";
             sendContract(response, url, {
               content,
               kind: target.kind,
@@ -38393,7 +38426,7 @@ function createFolderApi({
               documentError(response);
               return;
             }
-            const details = await stat7(target.path);
+            const details = await stat8(target.path);
             if (!details.isFile()) {
               documentError(response);
               return;
@@ -38417,7 +38450,7 @@ function createFolderApi({
                 "Content-Disposition": `attachment; filename="${basename6(target.path)}"`
               } : {}
             });
-            response.end(await readFile8(target.path));
+            response.end(await readFile9(target.path));
           } catch (error) {
             documentError(response);
           }
@@ -38431,7 +38464,7 @@ function createFolderApi({
               documentError(response);
               return;
             }
-            const details = await stat7(target.path);
+            const details = await stat8(target.path);
             if (!details.isFile()) {
               documentError(response);
               return;
@@ -38443,7 +38476,7 @@ function createFolderApi({
               return;
             }
             watch(folder);
-            const data = await readFile8(target.path);
+            const data = await readFile9(target.path);
             const baseHeaders = {
               "Accept-Ranges": "bytes",
               "Cache-Control": "private, max-age=0, must-revalidate",
@@ -38700,7 +38733,7 @@ function createFolderApi({
               response.off("close", cancel);
             }
             const [hydrated, workspace] = await Promise.all([
-              hydrateAssets({ folder, projects: { items: projects } }, assetFiles),
+              hydrateFolderIcons({ folder, projects: { items: projects } }, assetFiles),
               readWorkspace(folder)
             ]);
             workspace.breadcrumbs = await workspaceBreadcrumbIcons(workspace.breadcrumbs ?? [], assetFiles, hydrated.assets);
@@ -38713,7 +38746,7 @@ function createFolderApi({
             return;
           }
           const metadata = machine ? await shallowMetadata(folder) : await loadFolderData(folder);
-          const assets = await hydrateAssets(metadata, assetFiles);
+          const assets = await hydrateFolderIcons(metadata, assetFiles);
           const body = {
             ...metadata,
             ...assets,
@@ -38760,7 +38793,7 @@ async function sendFile(request, response, directory, pathname, fallback) {
     response.end();
     return;
   }
-  if (!(await stat8(target).catch(() => null))?.isFile()) {
+  if (!(await stat9(target).catch(() => null))?.isFile()) {
     if (!fallback) {
       response.writeHead(404);
       response.end();
@@ -38778,7 +38811,7 @@ async function sendFile(request, response, directory, pathname, fallback) {
     "Content-Type": contentTypes[extname7(target)] ?? "application/octet-stream",
     "X-Content-Type-Options": "nosniff"
   });
-  response.end(request.method === "HEAD" ? undefined : await readFile9(target));
+  response.end(request.method === "HEAD" ? undefined : await readFile10(target));
 }
 function createKennelApi(options) {
   const remote = options.remoteAccess || !isLoopbackServerHost(options.host);

package/dist/llm/clipboard.d.ts

@@ -0,0 +1 @@
+export declare function copyToClipboard(text: string): Promise<void>;

package/dist/llm/clipboard.js

@@ -0,0 +1,59 @@
+import { spawn } from 'node:child_process';
+import { accessSync, constants } from 'node:fs';
+import { delimiter, join } from 'node:path';
+function onPath(command) {
+    return (process.env.PATH ?? '').split(delimiter).some((directory) => {
+        if (!directory)
+            return false;
+        try {
+            accessSync(join(directory, command), constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** The platform clipboard tool. No shell runs, so the text is never interpreted. */
+function clipboardTool() {
+    if (process.platform === 'darwin')
+        return { command: 'pbcopy', args: [], encoding: 'utf8' };
+    // clip.exe reads UTF-16LE text that starts with a byte order mark.
+    if (process.platform === 'win32')
+        return { command: 'clip', args: [], encoding: 'utf16le' };
+    if (process.env.WAYLAND_DISPLAY && onPath('wl-copy'))
+        return { command: 'wl-copy', args: [], encoding: 'utf8' };
+    if (process.env.DISPLAY && onPath('xclip'))
+        return { command: 'xclip', args: ['-selection', 'clipboard'], encoding: 'utf8' };
+    if (process.env.DISPLAY && onPath('xsel'))
+        return { command: 'xsel', args: ['--clipboard', '--input'], encoding: 'utf8' };
+    throw new Error('No clipboard tool is available. Install wl-copy (Wayland) or xclip or xsel (X11) in a desktop session, or run knl llm without --copy.');
+}
+export function copyToClipboard(text) {
+    const tool = clipboardTool();
+    const input = tool.encoding === 'utf16le' ? Buffer.from(`\ufeff${text}`, 'utf16le') : Buffer.from(text, 'utf8');
+    return new Promise((resolve, reject) => {
+        // stderr is inherited: wl-copy keeps serving the selection in a forked
+        // process, and a pipe it holds open would keep this command alive.
+        const child = spawn(tool.command, tool.args, { stdio: ['pipe', 'ignore', 'inherit'] });
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            reject(new Error(`${tool.command} did not finish within 10 seconds`));
+        }, 10_000);
+        child.once('error', (error) => {
+            clearTimeout(timer);
+            reject(new Error(`Cannot run ${tool.command}: ${error.message}`));
+        });
+        child.once('exit', (code, signal) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${tool.command} failed ${signal ? `with signal ${signal}` : `with exit code ${code}`}`));
+        });
+        child.stdin.on('error', () => {
+            // The exit status reports the failure.
+        });
+        child.stdin.end(input);
+    });
+}

package/dist/llm/command.d.ts

@@ -0,0 +1 @@
+export declare function llm(args: string[]): Promise<void>;