kc-beta 0.3.2 → 0.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kc-beta",
-  "version": "0.3.2",
+  "version": "0.5.4",
   "description": "KC Agent — LLM document verification agent (pure Node.js CLI)",
   "type": "module",
   "bin": {

package/src/agent/confidence-scorer.js

@@ -30,6 +30,14 @@ export class ConfidenceScorer {
     this._loadCalibration();
   }
 
+  /** Re-point at a new workspace. Used by `engine.renameSession()` (Bug 3). */
+  _setWorkspacePath(newWorkspacePath) {
+    this._workspace = newWorkspacePath;
+    this._calibrationPath = path.join(newWorkspacePath, "confidence_calibration.json");
+    // Re-load priors from the new workspace's .env (in case it was edited externally)
+    this._loadConfig();
+  }
+
   _loadConfig() {
     const envPath = path.join(this._workspace, ".env");
     if (!fs.existsSync(envPath)) return;

package/src/agent/context-window.js

@@ -12,10 +12,15 @@ export class ContextWindow {
    * @param {number} [opts.reserveForResponse=8192] - Tokens reserved for model output
    * @param {number} [opts.recentWindowSize=30] - Number of recent messages to always keep
    */
-  constructor({ contextLimit, reserveForResponse = 8192, recentWindowSize = 30 }) {
+  constructor({ contextLimit, reserveForResponse = 8192, recentWindowSize = 30, triggerFraction = 0.70 }) {
     this.contextLimit = contextLimit;
     this.reserveForResponse = reserveForResponse;
     this.recentWindowSize = recentWindowSize;
+    // Fraction of budget that triggers windowing. v0.5.3 used 0.85 which only
+    // fired after runtime was already deep in the danger zone (a subsequent
+    // tool result could tip it over before the next check). 0.70 leaves room
+    // for one more tool result before hitting the hard ceiling.
+    this.triggerFraction = triggerFraction;
   }
 
   /**
@@ -29,7 +34,7 @@ export class ContextWindow {
     const budget = this.contextLimit - this.reserveForResponse;
 
     // If within budget, return as-is
-    if (totalTokens <= budget * 0.85) {
+    if (totalTokens <= budget * this.triggerFraction) {
       return { messages, wasWindowed: false, removedCount: 0 };
     }
 

package/src/agent/context.js

@@ -68,6 +68,31 @@ during execution with high-threshold matching, not patched into main workflows.
 based on extraction method, source text presence, historical accuracy, and corner \
 case proximity. Confidence bands (high/medium/low) drive QC sampling rates.
 
+## File System
+
+Your workspace is a git repository. Every write to a tracked path (skills, \
+workflows, rules, glossary, AGENT.md, tasks.json) is auto-committed with a \
+trace ID. Use \`sandbox_exec\` with \`cwd: "workspace"\` to run git directly: \
+\`git log --oneline\`, \`git diff HEAD~3 -- rule_skills/R001/\`, \
+\`git checkout HEAD~5 -- rule_skills/R001/\`. High-volume runtime data \
+(logs/, sub_agents/, input/, output/, samples/) is gitignored — git status \
+shows only meaningful changes.
+
+Large tool outputs (above ~2000 tokens) are automatically offloaded — you'll \
+see a digest with \`[…truncated, full at: logs/tool_results/<id>.txt …]\`. \
+Read the full file with \`workspace_file\` only if you need the detail. The \
+event log keeps the full output regardless, so audits never lose data.
+
+Three workspace tools beyond \`workspace_file\` and \`sandbox_exec\`:
+- \`copy_to_workspace\` — pull a specific file from the project dir into \
+\`refs/\` when you need a workspace-local working copy. Default is to read \
+project files in place via \`scope: "project"\`; only copy when you genuinely need to.
+- \`snapshot\` — freeze the current workspace state (git tag + manifest). Use \
+before risky operations or for release bundles.
+- \`archive_file\` — move a file to an \`archived/\` subdirectory next to it. \
+Use after a workflow consumes an input doc, or when an old result is no longer \
+the primary view.
+
 ## Working with the Developer User
 
 The developer user configures the project, provides regulations and samples, and \

package/src/agent/corner-case-registry.js

@@ -18,6 +18,11 @@ export class CornerCaseRegistry {
     this._load();
   }
 
+  /** Re-point at a new workspace. Used by `engine.renameSession()` (Bug 3). */
+  _setWorkspacePath(newWorkspacePath) {
+    this._path = path.join(newWorkspacePath, "corner_cases.json");
+  }
+
   _load() {
     if (!fs.existsSync(this._path)) return;
     try {