smartcompact 0.1.8 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smartcompact",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "type": "module",
   "description": "Compact long agent sessions earlier, at a finished piece of work, to cut cost without losing results (Claude Code, pi, Codex)",
   "license": "MIT",

package/plugin/README.md

@@ -19,10 +19,11 @@ All hooks live in one module, `hooks/register.ts`.
 - **`/smartcompact` command**: answers only its own command (`report`, `pause`, `resume`).
 - **Tool calls**: answers calls to its own `checkpoint` tool by recording the note. For every other tool it only looks at the result to recognize commits, tests, builds and edited files, and passes the result through unchanged.
 - **Task created / completed**: keeps the list of in-progress task names for the ledger.
-- **Prompt submit**: adds context to the turn, never changes the user's message. After a compaction it adds the progress ledger; once per cycle, when the context nears the allow line, it adds a one-line reminder to record progress with `checkpoint`; past the allow line, while it waits for a finished piece of work, it reminds the model to mark each finished step with `checkpoint`, again every further 100k tokens.
+- **Session start after a compaction**: hands the progress ledger to the model as context the user does not see. Subagent compactions are left alone.
+- **Prompt submit**: adds context to the turn, never changes the user's message. Once per cycle, when the context nears the allow line, it adds a one-line reminder to record progress with `checkpoint`; past the allow line, while it waits for a finished piece of work, it reminds the model to mark each finished step with `checkpoint`, again every further 100k tokens.
 - **Turn start**: cancels a compaction still waiting for the user to go idle; any new turn counts, including one started by a slash command.
-- **Turn complete**: keeps the model's final reply and decides whether to compact. When it should, it waits until the user has been idle for 3 minutes (a new turn cancels it) and then compacts the session; the reply is handed back with the ledger. Where a session cannot compact directly (headless sessions such as the desktop app), it runs the `/compact` command itself with SmartCompact's compaction instructions; it runs no other commands.
-- **Compaction**: never blocks or changes a compaction itself. After any compaction of the main session it appends the progress ledger to the compacted context. Subagent compactions are left alone.
+- **Turn complete**: keeps the model's final reply and decides whether to compact. When it should, it waits until the user has been idle for 3 minutes (a new turn cancels it) and then compacts the session; the reply is handed back with the ledger. Where a session cannot compact directly (headless sessions such as the desktop app), it runs the `/compact` command itself, shown as `/compact by SmartCompact`, and supplies SmartCompact's compaction instructions when it runs; it runs no other commands.
+- **Compaction**: records the size before and after. It changes only the `/compact` it queued itself: it fills in the instructions, and skips it if it is no longer needed (the user sent a message or the session already compacted). The user's own and native compactions run unchanged, and the result is never rewritten.
 
 ## Use
 

package/plugin/src/core/ledger.ts

@@ -27,7 +27,7 @@ export const EMPTY_LEDGER: Ledger = Object.freeze({
   notes: Object.freeze({ decisions: [] }),
 }) as Ledger
 
-/** 笔记文本的开头，适配层据此认出上一次放入的笔记并替换。 */
+/** 笔记文本的开头，让模型认出这是插件写的笔记，不是用户的话。 */
 export const LEDGER_MARKER = '[SmartCompact progress ledger]'
 
 /**
@@ -38,7 +38,7 @@ export const COMPACT_INSTRUCTIONS =
   'Preserve the current goal, decisions and their reasons, unfinished work, failed attempts, and exact file paths. ' +
   'Also keep every specific fact the user stated, verbatim, even if the current work does not need it: ' +
   'names of people and customers, dates and time windows, ticket or ID numbers, and constraints. ' +
-  'A SmartCompact progress ledger is attached after the summary; do not restate it.'
+  'A SmartCompact progress ledger is attached after compaction; do not restate it.'
 
 const MAX_FILES = 30
 const MAX_DECISIONS = 30
@@ -216,7 +216,3 @@ function layoutLedger({ facts, notes }: Ledger, { requirements, decisions, files
   section('Files changed', [omitted(facts.filesChanged.length - files.length, 'files'), ...files.map(file => `- ${file}`)])
   return lines.join('\n')
 }
-
-export function isLedgerText(value: string): boolean {
-  return value.startsWith(LEDGER_MARKER)
-}