@samuelfaj/distill 1.4.6 → 1.4.7

package/README.md

@@ -23,6 +23,8 @@ D inspect remotes + MR meta
 R merge/update may block w/o token
 ```
 
+Inline variables such as `workspace=#w3` and `version=#v1` are learned into DSL memory and reused in later prompts.
+
 `/distill` also has DSL memory:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samuelfaj/distill",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "description": "Compress command output for downstream LLMs.",
   "license": "MIT",
   "bin": {
@@ -16,11 +16,11 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@samuelfaj/distill-darwin-arm64": "1.4.6",
-    "@samuelfaj/distill-darwin-x64": "1.4.6",
-    "@samuelfaj/distill-linux-arm64": "1.4.6",
-    "@samuelfaj/distill-linux-x64": "1.4.6",
-    "@samuelfaj/distill-win32-x64": "1.4.6"
+    "@samuelfaj/distill-darwin-arm64": "1.4.7",
+    "@samuelfaj/distill-darwin-x64": "1.4.7",
+    "@samuelfaj/distill-linux-arm64": "1.4.7",
+    "@samuelfaj/distill-linux-x64": "1.4.7",
+    "@samuelfaj/distill-win32-x64": "1.4.7"
   },
   "publishConfig": {
     "access": "public"

package/skills/distill/SKILL.md

@@ -165,6 +165,35 @@ C PATH pkg bin => repo patch ignored
 R missing token => merge blocked
 ```
 
+## Variable Dict
+
+Every thread must use DSL/Dict when it helps compression.
+Start with `Dict:` when meanings are not already shared.
+Define short thread variables inline when a noun will repeat:
+
+```text
+S npm workspace=#w3 version=#v1 sync no-op
+D patch=#p1 package=#p2 manifests mechanically
+D regen lock after #p2 manifest sync
+N no release tag before clean verify
+```
+
+After definition, use the variable:
+
+```text
+D inspect #w3 config
+D bump #v1 in #p2 manifests
+```
+
+Rules:
+
+- variable key format: `#` + letter + digit, for example `#w3`
+- one stable meaning per variable inside the thread
+- do not define variables for secrets, people, IDs, paths, URLs, or one-off terms
+- do not redefine an active variable; add a new key if meaning changed
+- inline `#` variables are active immediately after explicit assignment
+- learn reusable variables with `Dict+` or transcript learning when available
+
 ## Good Response Forms
 
 Tiny status:
@@ -206,7 +235,12 @@ R not committed
 
 ## Glossary And Memory
 
-Keep an internal alias dict per conversation. Do not create files.
+Use two memory layers:
+
+- thread dict: internal aliases for the current conversation
+- persisted dict: entries saved by `distill dsl learn`, `distill dsl learn-thread --stdin`, or explicit user action
+
+Do not manually create memory files. Let the `distill` CLI own JSON memory writes.
 
 Use aliases only when they stay obvious:
 
@@ -245,7 +279,15 @@ Dict: S=state C=context D=action R=risk O=outcome N=no-go P=proof 1=failing-test
 Dict+: A1=authentication bug fix
 ```
 
-Expire learned terms mentally if they stop appearing. A term should not become part of thread DSL unless it appears at least twice in a short window or the user explicitly approves it.
+Persisted learned terms start as candidates and promote only through lifecycle rules. A term should not become part of active DSL unless it appears at least twice in a short window or the user explicitly approves it.
+
+At every thread end or handoff, when transcript export is available, run:
+
+```bash
+distill dsl learn-thread --stdin < transcript.txt
+```
+
+This analyzes repeated usage, rejects sensitive/noisy terms, asks the configured reviewer model for strict JSON, and persists only compact candidates.
 
 ## Tool Calls