tinker-agent 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable user-facing changes to Tinker are documented here. The project follo
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-08-29
+
+### Added
+
+- Log raw vector cosine scores in `MemorySearch` diagnostics, making hybrid
+  recall ranking easier to inspect and tune.
+
+### Changed
+
+- Restyle the prompt-input footer status line with a muted color palette:
+  model name, workspace path, Git branch, and cache hit rate each get a soft
+  accent color, and normal-pressure context usage now renders in a cool gray
+  instead of plain dim. Red and yellow remain reserved for context-pressure
+  warnings.
+
 ## [2.1.0] - 2026-08-29
 
 ### Added
@@ -249,7 +264,8 @@ All notable user-facing changes to Tinker are documented here. The project follo
 - First formal npm release under the `tinker-agent` package name with the `tinker`
   executable.
 
-[Unreleased]: https://github.com/ishowshao/tinker/compare/v2.1.0...HEAD
+[Unreleased]: https://github.com/ishowshao/tinker/compare/v2.2.0...HEAD
+[2.2.0]: https://github.com/ishowshao/tinker/releases/tag/v2.2.0
 [2.1.0]: https://github.com/ishowshao/tinker/releases/tag/v2.1.0
 [2.0.0]: https://github.com/ishowshao/tinker/releases/tag/v2.0.0
 [1.11.0]: https://github.com/ishowshao/tinker/releases/tag/v1.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tinker-agent",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "A personal coding agent with an interactive TUI and one-shot CLI.",
   "license": "Apache-2.0",
   "type": "module",

package/src/memory/contracts.ts

@@ -14,6 +14,7 @@ export const MAX_MEMORY_KEYWORDS = 8;
 export const MAX_MEMORY_KEYWORD_BYTES = 128;
 export const MEMORY_RRF_K = 60;
 export const MEMORY_EXTRACTION_QUEUE_CAPACITY = 64;
+export const MEMORY_SEARCH_DIAGNOSTIC_VECTOR_SCORES_LIMIT = 10;
 
 export type MemoryEmbeddingKind = "openai-compatible";
 
@@ -146,6 +147,7 @@ export type MemorySearchDiagnostic = {
   readonly ftsReturned: number;
   readonly degraded: MemoryRecallDegraded | null;
   readonly scores: readonly number[];
+  readonly vectorScores: readonly number[];
   readonly ms: number;
 };
 

package/src/memory/memory-coordinator.ts

@@ -21,6 +21,7 @@ import {
   MEMORY_GET_TOOL_NAME,
   MEMORY_RECALL_CANDIDATE_LIMIT,
   MEMORY_RRF_K,
+  MEMORY_SEARCH_DIAGNOSTIC_VECTOR_SCORES_LIMIT,
   MEMORY_SEARCH_LIMIT,
   MEMORY_SEARCH_TOOL_NAME,
   MemoryError,
@@ -470,6 +471,9 @@ export class MemoryCoordinator implements CompletedTurnHook {
           ftsReturned: ftsMatches.length,
           degraded,
           scores: fused.map((match) => roundScore(match.score)),
+          vectorScores: vectorMatches
+            .slice(0, MEMORY_SEARCH_DIAGNOSTIC_VECTOR_SCORES_LIMIT)
+            .map((match) => roundScore(match.score)),
           ms: elapsedMs(startedAt),
         }),
       );
@@ -688,6 +692,7 @@ function searchDiagnostic(input: {
   readonly ftsReturned?: number;
   readonly degraded?: MemoryRecallDegraded | null;
   readonly scores?: readonly number[];
+  readonly vectorScores?: readonly number[];
   readonly ms: number;
 }): MemorySearchDiagnostic {
   return Object.freeze({
@@ -704,6 +709,7 @@ function searchDiagnostic(input: {
     ftsReturned: input.ftsReturned ?? 0,
     degraded: input.degraded ?? null,
     scores: Object.freeze([...(input.scores ?? [])]),
+    vectorScores: Object.freeze([...(input.vectorScores ?? [])]),
     ms: input.ms,
   });
 }

package/src/tui/components/prompt-input.tsx

@@ -741,30 +741,42 @@ export function PromptInput(props: PromptInputProps) {
       </Box>
       {showSuggestions ? null : (
         <Box>
-          <Text dimColor>
-            {props.modelName}
-            {props.reasoningEffort === undefined ? null : ` ${props.reasoningEffort}`} ·{" "}
-            {formatWorkspacePath(props.workspaceRoot)}
-            {props.gitBranch === undefined ? null : ` · ${props.gitBranch}`}
-            {state.phase.kind === "idle" ? null : ` · ${phaseLabel(state.phase)}`}
+          <Text>
+            <Text color={FOOTER_COLORS.model}>{props.modelName}</Text>
+            {props.reasoningEffort === undefined ? null : (
+              <Text dimColor> {props.reasoningEffort}</Text>
+            )}
+            <Text dimColor> · </Text>
+            <Text color={FOOTER_COLORS.workspacePath}>
+              {formatWorkspacePath(props.workspaceRoot)}
+            </Text>
+            {props.gitBranch === undefined ? null : (
+              <>
+                <Text dimColor> · </Text>
+                <Text color={FOOTER_COLORS.gitBranch}>{props.gitBranch}</Text>
+              </>
+            )}
+            {state.phase.kind === "idle" ? null : (
+              <>
+                <Text dimColor> · </Text>
+                <Text dimColor>{phaseLabel(state.phase)}</Text>
+              </>
+            )}
+            {props.contextUsage === undefined ? null : (
+              <>
+                <Text dimColor> · </Text>
+                <Text color={contextColor(props.contextUsage.pressure)}>
+                  {formatContextUsageLine(props.contextUsage)}
+                </Text>
+              </>
+            )}
+            {cacheRate === undefined ? null : (
+              <>
+                <Text dimColor> · </Text>
+                <Text color={FOOTER_COLORS.cacheRate}>{cacheRate}</Text>
+              </>
+            )}
           </Text>
-          {props.contextUsage === undefined ? null : (
-            <>
-              <Text dimColor> · </Text>
-              <Text
-                color={contextColor(props.contextUsage.pressure)}
-                dimColor={props.contextUsage.pressure === "normal"}
-              >
-                {formatContextUsageLine(props.contextUsage)}
-              </Text>
-            </>
-          )}
-          {cacheRate === undefined ? null : (
-            <>
-              <Text dimColor> · </Text>
-              <Text dimColor>{cacheRate}</Text>
-            </>
-          )}
         </Box>
       )}
       {showFileSuggestions ? (
@@ -962,14 +974,25 @@ function fileMentionReplacement(
     : `${filePath} `;
 }
 
+// Decorative palette for the footer status line, kept muted so it reads
+// softly against the dim separators. Red and yellow are deliberately
+// excluded: they stay reserved for context-pressure warnings.
+const FOOTER_COLORS = {
+  model: "#7b9cc4",
+  workspacePath: "#6fa8a8",
+  gitBranch: "#a08fbd",
+  cacheRate: "#7aa37e",
+  contextUsage: "#8a9199",
+} as const;
+
 function contextColor(
   pressure: ContextUsageSnapshot["pressure"],
-): "yellow" | "red" | undefined {
+): "yellow" | "red" | typeof FOOTER_COLORS.contextUsage {
   return pressure === "blocked"
     ? "red"
     : pressure === "triggered"
       ? "yellow"
-      : undefined;
+      : FOOTER_COLORS.contextUsage;
 }
 
 function formatWorkspacePath(workspaceRoot: string): string {