@vincemakes/kiso-code 0.2.2 → 0.4.0

package/dist/builtin.js

@@ -1,10 +1,19 @@
 /**
- * R-D 0.1.45 — the built-in layer: the four official extensions (mcp,
- * skills, subagent, task), shipped in the cli package and registered by
+ * R-D 0.1.45 — the built-in layer: the three official extensions (mcp,
+ * skills, subagent), shipped in the cli package and registered by
  * MODULE IMPORT — never a disk scan (the user layer's loadExtensions stays
  * word-for-word untouched). The cascade, base → top: built-in → user
  * (~/.kiso/extensions) → project (.kiso/extensions, trust-gated).
  *
+ * E5 (the composition round, finding E5-F1/F2): the task extension left
+ * the default composition — on 13 consecutive real-provider sessions it
+ * paid its rent (system:ext:task + tool:task_set on every request) and
+ * was never called, not even on the guidance's own designed trigger. It
+ * stays an official extension, OPT-IN via the user layer: copy
+ * extensions/task/src/kiso-task.mjs into ~/.kiso/extensions/ (a user or
+ * project extension named "task" is now a plain extension — no built-in
+ * to shadow or collide with).
+ *
  *  - a user extension may SHADOW a built-in by name — the user's deliberate
  *    install wins (a built-in cannot be uninstalled), loudly, and the
  *    shadowed built-in leaves the loaded set and the banner;
@@ -15,9 +24,8 @@
 import createMcp from "@vincemakes/kiso-mcp-ext";
 import createSkills from "@vincemakes/kiso-skills-ext";
 import createSubagent from "@vincemakes/kiso-subagent-ext";
-import createTask from "@vincemakes/kiso-task-ext";
 export async function builtInLayer(user, project) {
-    const all = await Promise.all([createMcp(), createSkills(), createSubagent(), createTask()]);
+    const all = await Promise.all([createMcp(), createSkills(), createSubagent()]);
     const shadowed = all.filter((b) => user.some((u) => u.name === b.name));
     for (const s of shadowed) {
         console.error(`[extensions] user extension "${s.name}" shadows the built-in — the built-in is not loaded`);

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";
@@ -200,8 +199,8 @@ function makeLineInput() {
 /** R-D 0.1.45: the `[N extensions: ...]` text — the built-in column, then
  *  the user-level names, then the project-level ones marked `project:`.
  *  The built-in column is the banner's truthful face of the built-in layer:
- *  a fresh install reads `[4 extensions: built-in: mcp, skills, subagent,
- *  task]` with zero disk setup. */
+ *  a fresh install reads `[3 extensions: built-in: mcp, skills, subagent]`
+ *  with zero disk setup (E5: the task extension is opt-in). */
 function bannerExtensionText() {
     const total = builtInExtensions.length + userExtensions.length + projectExtensions.length;
     if (total === 0)
@@ -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/dist/state.d.ts

@@ -87,9 +87,10 @@ export declare let currentModelName: string;
 export declare function setCurrentModelName(value: string): void;
 /** E1: the extensions loaded by makeAgent — their names feed the banner. */
 export declare let loadedExtensions: readonly KisoExtension[];
-/** R-D 0.1.45: the BUILT-IN layer — the four official extensions, shipped
- *  with the cli (module imports, never a disk scan; builtin.ts). The
- *  banner's marked column; a user extension may shadow a built-in. */
+/** R-D 0.1.45: the BUILT-IN layer — the three default official extensions,
+ *  shipped with the cli (module imports, never a disk scan; builtin.ts).
+ *  E5: the task extension is opt-in, not built-in. The banner's marked
+ *  column; a user extension may shadow a built-in. */
 export declare let builtInExtensions: readonly KisoExtension[];
 /** E1: the USER-level extensions alone — the banner's unmarked part (E3:
  *  loadedExtensions later includes the project-level ones too). */

package/dist/state.js

@@ -78,9 +78,10 @@ export function setCurrentModelName(value) {
 }
 /** E1: the extensions loaded by makeAgent — their names feed the banner. */
 export let loadedExtensions = [];
-/** R-D 0.1.45: the BUILT-IN layer — the four official extensions, shipped
- *  with the cli (module imports, never a disk scan; builtin.ts). The
- *  banner's marked column; a user extension may shadow a built-in. */
+/** R-D 0.1.45: the BUILT-IN layer — the three default official extensions,
+ *  shipped with the cli (module imports, never a disk scan; builtin.ts).
+ *  E5: the task extension is opt-in, not built-in. The banner's marked
+ *  column; a user extension may shadow a built-in. */
 export let builtInExtensions = [];
 /** E1: the USER-level extensions alone — the banner's unmarked part (E3:
  *  loadedExtensions later includes the project-level ones too). */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vincemakes/kiso-code",
-  "version": "0.2.2",
-  "description": "kiso CLI \u2014 the durable coding agent that survives kill -9: kiso chat / kiso resume / kiso sessions.",
+  "version": "0.4.0",
+  "description": "kiso CLI — the durable coding agent that survives kill -9: kiso chat / kiso resume / kiso sessions.",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -23,7 +23,7 @@
     "@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-runtime": "0.3.0",
     "@vincemakes/kiso-skills-ext": "0.2.0",
     "@vincemakes/kiso-subagent-ext": "0.2.0",
     "@vincemakes/kiso-task-ext": "0.2.0",