@vincemakes/kiso-code 0.3.0 → 0.5.0

package/dist/dispatch.js

@@ -27,7 +27,9 @@ export function dispatch(line, ctx) {
             bodyLog(cmd("/mode", "show the approval tier; /mode <name> switches (manual/default/accept-edits/plan/bypass)"));
             bodyLog(cmd("/model", "list model profiles; /model <name|provider/model> switches"));
             bodyLog(cmd("/compact", "summarize the older conversation to free context"));
-            bodyLog(cmd("exit", "leave the session"));
+            // KC1: the composer's keys ride the SAME bodyLog call (it splits
+            // on \n) — the help gains a row, the cli source does not
+            bodyLog(`${cmd("exit", "leave the session")}\n${cmd("keys", "enter sends · ctrl+J inserts a newline (shift+enter where the terminal encodes it)")}`);
             ctx.input.prompt();
         });
         return;

package/dist/index.d.ts

@@ -22,6 +22,7 @@
  * index.ts keeps the entry: banner, input sources, the A area prompt,
  * makeAgent, and main.
  */
+import { type ContextPolicy } from "@vincemakes/kiso-runtime";
 export { applyProjectMerges } from "./trust-ui.js";
 /**
  * A area: the coding-agent system prompt — ONE constant, byte-stable for the
@@ -30,6 +31,7 @@ export { applyProjectMerges } from "./trust-ui.js";
 /** The built-in prompt. Exported for scripts/request-surface.mjs — the
  *  model-side token-rent counter measures the REAL bytes, never a copy. */
 export declare const SYSTEM_PROMPT = "You are kiso, a coding agent. You work in a workspace\ndirectory and change code with tools. Be concise: answer in a few lines\nunless the task genuinely needs more. Never claim a file was changed\nunless a tool confirmed it.\n\nTool discipline:\n- READ BEFORE YOU EDIT. For any file you are about to change, read it\n  first \u2014 never guess its content.\n- Use edit_file for targeted changes and write_file for full rewrites.\n  Prefer many small edits over one large write.\n- shell is for commands: builds, tests, git, grep. Be careful \u2014 shell has\n  side effects and may take time. Run one command at a time and inspect\n  the output before continuing.\n- Batch independent tool calls into one reply \u2014 they run in parallel.\n- search_text and list_dir are cheap \u2014 locate first, then read ranges\n  with read_file offset/limit; never read a whole large file in one call.\n- Do not re-read a file you already read unchanged \u2014 rely on the earlier\n  result.\n- When a tool fails, read the error and adjust; do not repeat the same\n  call blindly.\n\nWorkflow: understand the request, find the relevant code, make the\nsmallest change that works, then verify with a command (tests/build).\nReport what you did in one or two lines per change.";
+/** Hard cap for injected instructions — truncate and say so. */
 /**
  * A area: read the FIRST present instruction file (AGENTS.md preferred) and
  * return it as an injected section, or "" when none exists. Truncated at
@@ -40,3 +42,21 @@ export declare function readProjectInstructions(cwd: string): string;
 /** A area: the session's system prompt — the constant plus any project
  *  instructions found in the workspace. Deterministic per cwd. */
 export declare function composeSystemPrompt(cwd: string): string;
+/**
+ * E6: the run-start context policy, OFF unless env-armed (invalid values
+ * are ABSENT, never a crash — the autoCompactFromEnv convention).
+ * The product arming is KISO_CONTEXT_WINDOW → window − POLICY_RESERVE
+ * (the window rides the config as windowTokens; the runtime owns the
+ * arithmetic — never a fixed low absolute). KISO_POLICY_SUMMARY_TRIGGER
+ * survives ONLY as the legacy absolute override when no window is set
+ * (bench back-compat); the window wins when both are set.
+ * KISO_POLICY_SUMMARY_KEEP (rounds) and KISO_POLICY_SUMMARY_KEEP_TOKENS
+ * override the runtime defaults (KEEP_RECENT_ROUNDS = 4,
+ * KEEP_TOKENS_DEFAULT = 20,000) — emitted only when set.
+ * KISO_POLICY_SUMMARY_MAX_FAILURES overrides the (h) circuit-breaker
+ * default (MAX_SUMMARY_FAILURES = 3).
+ * KISO_POLICY_DROP=1 switches the armed mode to the crux C arm
+ * (mechanical drop — same trigger/keep envs); KISO_POLICY_MICROCOMPACT
+ * arms the session-aware override (MIN_TURNS = the no-fire guard).
+ */
+export declare function contextPolicyFromEnv(): ContextPolicy | undefined;

package/dist/index.js

@@ -26,8 +26,7 @@ import { readFileSync, realpathSync, rmSync } from "node:fs";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 import { join } from "node:path";
-import { Body, Editor, bannerLines, palette, renderSessionLine } from "@vincemakes/kiso-tui";
-import { escapeTerminal } from "@vincemakes/kiso-tui";
+import { Body, Editor, bannerLines, escapeTerminal, palette, renderSessionLine } from "@vincemakes/kiso-tui";
 import { createAgent, disposeExtensions, loadExtensions, loadProjectExtensions, SessionStore, } from "@vincemakes/kiso-runtime";
 import { createFauxProvider } from "@vincemakes/kiso-evals";
 import { createCodingTools } from "@vincemakes/kiso-tools-node";
@@ -223,14 +222,13 @@ function bannerExtensionText() {
  *  resize; the resume list re-gates with the tier); off-TTY: the
  *  historical `[N extensions: ...]` standalone line (zero change). */
 function extensionsBanner(resume = []) {
-    if (process.stdout.isTTY) {
-        body.banner(VERSION, bannerExtensionText().replace(/^ · /, ""), resume);
-        return;
-    }
     const text = bannerExtensionText();
-    if (text === "")
+    if (!process.stdout.isTTY) {
+        if (text !== "")
+            bodyLog(`${text}\n`);
         return;
-    bodyLog(`${text}\n`);
+    }
+    body.banner(VERSION, text.replace(/^ · /, ""), resume);
 }
 /** W5: the opening-screen resume list — up to 3 recent sessions, newest
  *  first, the CURRENT session excluded (it is not something to pick back
@@ -278,7 +276,6 @@ Report what you did in one or two lines per change.`;
 /** The project-instructions file names, in priority order (A area). */
 const INSTRUCTION_FILES = ["AGENTS.md", "CLAUDE.md"];
 /** Hard cap for injected instructions — truncate and say so. */
-const INSTRUCTION_MAX = 8 * 1024;
 /**
  * A area: read the FIRST present instruction file (AGENTS.md preferred) and
  * return it as an injected section, or "" when none exists. Truncated at
@@ -294,8 +291,7 @@ export function readProjectInstructions(cwd) {
         catch {
             continue; // not present — try the next
         }
-        const body = text.length > INSTRUCTION_MAX ? text.slice(0, INSTRUCTION_MAX) + `\n\n[truncated at ${INSTRUCTION_MAX} chars]` : text;
-        return `\n\n=== Project instructions (${name}) ===\n${body}`;
+        return `\n\n=== Project instructions (${name}) ===\n${text.length > 8 * 1024 ? text.slice(0, 8 * 1024) + `\n\n[truncated at ${8 * 1024} chars]` : text}`;
     }
     return "";
 }
@@ -305,6 +301,51 @@ export function composeSystemPrompt(cwd) {
     const injected = readProjectInstructions(cwd);
     return injected === "" ? SYSTEM_PROMPT : `${SYSTEM_PROMPT}\n${injected}`;
 }
+/**
+ * E6: the run-start context policy, OFF unless env-armed (invalid values
+ * are ABSENT, never a crash — the autoCompactFromEnv convention).
+ * The product arming is KISO_CONTEXT_WINDOW → window − POLICY_RESERVE
+ * (the window rides the config as windowTokens; the runtime owns the
+ * arithmetic — never a fixed low absolute). KISO_POLICY_SUMMARY_TRIGGER
+ * survives ONLY as the legacy absolute override when no window is set
+ * (bench back-compat); the window wins when both are set.
+ * KISO_POLICY_SUMMARY_KEEP (rounds) and KISO_POLICY_SUMMARY_KEEP_TOKENS
+ * override the runtime defaults (KEEP_RECENT_ROUNDS = 4,
+ * KEEP_TOKENS_DEFAULT = 20,000) — emitted only when set.
+ * KISO_POLICY_SUMMARY_MAX_FAILURES overrides the (h) circuit-breaker
+ * default (MAX_SUMMARY_FAILURES = 3).
+ * KISO_POLICY_DROP=1 switches the armed mode to the crux C arm
+ * (mechanical drop — same trigger/keep envs); KISO_POLICY_MICROCOMPACT
+ * arms the session-aware override (MIN_TURNS = the no-fire guard).
+ */
+export function contextPolicyFromEnv() {
+    const summaryTrigger = positiveIntEnv("KISO_POLICY_SUMMARY_TRIGGER");
+    const contextWindow = positiveIntEnv("KISO_CONTEXT_WINDOW");
+    const microcompactTrigger = positiveIntEnv("KISO_POLICY_MICROCOMPACT");
+    if (summaryTrigger === undefined && contextWindow === undefined && microcompactTrigger === undefined)
+        return undefined;
+    return {
+        ...(summaryTrigger === undefined && contextWindow === undefined ? {} : {
+            [(process.env.KISO_POLICY_DROP === "1" ? "drop" : "summary")]: {
+                ...(contextWindow !== undefined ? { windowTokens: contextWindow } : summaryTrigger !== undefined ? { triggerTokens: summaryTrigger } : {}),
+                ...kv("keepRounds", "KISO_POLICY_SUMMARY_KEEP"),
+                ...kv("keepTokens", "KISO_POLICY_SUMMARY_KEEP_TOKENS"),
+                ...kv("maxFailures", "KISO_POLICY_SUMMARY_MAX_FAILURES"),
+            },
+        }),
+        ...(microcompactTrigger !== undefined ? { microcompact: { thresholdTokens: microcompactTrigger, ...kv("keepResults", "KISO_POLICY_MICROCOMPACT_KEEP"), ...kv("minTurns", "KISO_POLICY_MICROCOMPACT_MIN_TURNS") } } : {}),
+    };
+}
+/** { [key]: value } when the env int is set — the spread-friendly optional field. */
+function kv(key, env) {
+    const v = positiveIntEnv(env);
+    return v !== undefined ? { [key]: v } : {};
+}
+/** Parse a positive-int env var — absent or invalid is undefined (no crash). */
+function positiveIntEnv(name) {
+    const n = Number.parseInt(process.env[name] ?? "", 10);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
 async function makeAgent(sessionId, input, modelFlag) {
     // E3: the project-level trust gate runs BEFORE any extension load (the
     // mcp/skills merges must be in the env when the user-level extensions
@@ -358,6 +399,8 @@ async function makeAgent(sessionId, input, modelFlag) {
     // re-reads the config's extensions array per run).
     const extensions = [...modeExtensions(), ...loadedExtensions];
     setCurrentAgentExtensions(extensions);
+    // E6: the run-start context policy (captured once — exactOptionalPropertyTypes).
+    const contextPolicy = contextPolicyFromEnv();
     const definition = {
         model,
         store,
@@ -379,6 +422,8 @@ async function makeAgent(sessionId, input, modelFlag) {
         // 200k window → 100k tokens). Long sessions compact old read/list/
         // search/shell outputs instead of silently growing past the window.
         microcompact: { thresholdTokens: contextWindowTokens() / 2 },
+        // E6: the run-start context policy — OFF unless env-armed (beats the microcompact default when both fire).
+        ...(contextPolicy !== undefined ? { contextPolicy } : {}),
         maxTurns: 20,
         // Modes: the five tiers join at the CHAIN HEAD, before the user/
         // project extensions (the deny>ask>allow composition keeps a user
@@ -462,11 +507,8 @@ async function main() {
         // (its verdict decides whether the project config exists at all) —
         // unless a higher layer (--mode flag / KISO_MODE) already decided.
         const applyConfigMode = () => {
-            if (modeFlag !== -1 || process.env.KISO_MODE !== undefined)
-                return;
-            const m = mergedConfig.mode;
-            if (m !== undefined)
-                setMode(m);
+            if (modeFlag === -1 && process.env.KISO_MODE === undefined && mergedConfig.mode !== undefined)
+                setMode(mergedConfig.mode);
         };
         switch (command) {
             case "chat": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vincemakes/kiso-code",
-  "version": "0.3.0",
-  "description": "kiso CLI \u2014 the durable coding agent that survives kill -9: kiso chat / kiso resume / kiso sessions.",
+  "version": "0.5.0",
+  "description": "kiso CLI — the durable coding agent that survives kill -9: kiso chat / kiso resume / kiso sessions.",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -18,18 +18,18 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@vincemakes/kiso-core": "0.2.0",
-    "@vincemakes/kiso-evals": "0.2.0",
-    "@vincemakes/kiso-mcp-ext": "0.2.0",
-    "@vincemakes/kiso-provider-anthropic": "0.2.0",
-    "@vincemakes/kiso-provider-openai": "0.2.0",
-    "@vincemakes/kiso-runtime": "0.2.1",
-    "@vincemakes/kiso-skills-ext": "0.2.0",
-    "@vincemakes/kiso-subagent-ext": "0.2.0",
-    "@vincemakes/kiso-task-ext": "0.2.0",
-    "@vincemakes/kiso-tools-node": "0.2.0",
-    "@vincemakes/kiso-tui": "0.2.0",
-    "@vincemakes/kiso-tui-cells": "0.2.0"
+    "@vincemakes/kiso-core": "0.5.0",
+    "@vincemakes/kiso-evals": "0.5.0",
+    "@vincemakes/kiso-mcp-ext": "0.5.0",
+    "@vincemakes/kiso-provider-anthropic": "0.5.0",
+    "@vincemakes/kiso-provider-openai": "0.5.0",
+    "@vincemakes/kiso-runtime": "0.5.0",
+    "@vincemakes/kiso-skills-ext": "0.5.0",
+    "@vincemakes/kiso-subagent-ext": "0.5.0",
+    "@vincemakes/kiso-task-ext": "0.5.0",
+    "@vincemakes/kiso-tools-node": "0.5.0",
+    "@vincemakes/kiso-tui": "0.5.0",
+    "@vincemakes/kiso-tui-cells": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",