zam-core 0.5.1 → 0.5.3

package/dist/index.d.ts

@@ -1586,6 +1586,10 @@ interface ReviewContext {
 }
 /** Default cap on resolved content length, so bridge JSON / terminal output stays bounded. */
 declare const DEFAULT_REVIEW_CONTEXT_MAX_CHARS = 6000;
+/** How long resolved review context stays in the in-process cache (5 minutes). */
+declare const REVIEW_CONTEXT_CACHE_TTL_MS: number;
+/** Clear the in-process review-context cache (mainly for tests). */
+declare function clearReviewContextCache(): void;
 /**
  * Resolves a given token's source_link into readable textual content.
  */
@@ -1785,9 +1789,8 @@ declare function planUpdate(decision: UpdateDecision): UpdateStep[];
  * and NOT the personal folder, so the mode never travels through a shared Turso
  * database or a synced folder, where it would be wrong for the other machine.
  *
- * The personal-content folder itself is unchanged: it stays the existing
- * `personal.workspace_dir` setting, and can already point at any local or
- * file-synced directory (Drive, OneDrive, Dropbox, iCloud) — no GitHub required.
+ * Workspace selection is machine-local too: `activeWorkspaceId` points at one
+ * entry in `workspaces`, while legacy database settings are migrated by the CLI.
  */
 
 type InstallMode = "developer" | "default";
@@ -1799,6 +1802,8 @@ interface InstallConfig {
     ai?: MachineAiConfig;
     /** Machine-local paths to existing personal/team/community workspaces. */
     workspaces?: WorkspaceConfig[];
+    /** Machine-local id of the workspace currently active in this install. */
+    activeWorkspaceId?: string;
 }
 type MachineAiRole = "vision" | "recall" | "text";
 type MachineApiFlavor = "chat-completions" | "anthropic-messages";
@@ -1852,6 +1857,9 @@ declare function getMachineAiConfig(path?: string): MachineAiConfig;
 declare function saveMachineAiConfig(ai: MachineAiConfig, path?: string): void;
 declare function getConfiguredWorkspaces(path?: string): WorkspaceConfig[];
 declare function saveConfiguredWorkspaces(workspaces: WorkspaceConfig[], path?: string): void;
+declare function getActiveWorkspaceId(path?: string): string | undefined;
+declare function setActiveWorkspaceId(id: string | undefined, path?: string): void;
+declare function getActiveWorkspace(path?: string): WorkspaceConfig | undefined;
 declare function upsertConfiguredWorkspace(workspace: WorkspaceConfig, path?: string): WorkspaceConfig[];
 declare function removeConfiguredWorkspace(id: string, path?: string): WorkspaceConfig[];
 /**
@@ -1930,7 +1938,8 @@ interface RepoPaths {
 }
 /**
  * Resolve absolute paths for personal, team, and organization repositories.
- * Personal falls back to personal.workspace_dir if repo.personal is not set.
+ * Personal falls back to the active machine-local workspace if repo.personal is
+ * not set.
  */
 declare function getRepoPaths(db: Database): Promise<RepoPaths>;
 /**
@@ -1948,4 +1957,4 @@ declare function resolveAllBeliefPaths(db: Database): Promise<string[]>;
  */
 declare function resolveAllGoalPaths(db: Database): Promise<string[]>;
 
-export { type ADOConfig, type ADOCredentials, type AgentSkill, type AnalysisResult, type ApplySessionSynthesisInput, type ApplySessionSynthesisResult, BUILT_IN_SENSITIVE_MATCHERS, type BloomLevel$1 as BloomLevel, type CaptureDecision, type CaptureDenialReason, type CaptureRequest, type Card, type CardDeletionImpact, type CardState$1 as CardState, type CascadeBlockResult, type CommandRecord, type CommandSequence, type ConnectionOptions, type CreateAgentSkillInput, type CreateGoalInput, type CreateReviewInput, type CreateSessionInput, type CreateTokenInput, type Credentials, DEFAULT_OBSERVER_POLICY, DEFAULT_REVIEW_CONTEXT_MAX_CHARS, type Database, type DatabaseProvider, type DatabaseTargetInfo, type DatabaseValue, type DeleteCardResult, type DeleteTokenResult, type DiscoveryOptions, type DomainCompetence, type EvaluateInput, type EvaluateResult, type ExecuteReviewActionInput, type ExecutionContext, type FSRSParameters, type Goal, type GoalFrontmatter, type GoalStatus, type GoalSummary, HOMEBREW_CASK, type ImportResult, type InstallChannel, type InstallConfig, type InstallMode, type InstallPlan, type InstallResult, type LocalLLMRunner, type LogStepInput, type MachineAiConfig, type MachineProviderRecord, type MachineRoleBinding, type MonitorEvent, type Neighborhood, type NeighborhoodToken, OBSERVER_POLICY_UNSET_HINT, OBSERVER_POLICY_VERSION, type ObservationRating, type ObserverConsent, type ObserverPolicy, type ObserverRetention, type ObserverScope, type ObserverSettingKey, type PrepareSessionSynthesisInput, type Prerequisite, type PrerequisiteWithToken, type PromptInput, type Rating, type RecallPrompt, type RemoteDatabaseOptions, type RepoPaths, type ResolvedCaptureTarget, type ResolvedReference, type ReviewActionResult, type ReviewActionType, type ReviewContext, type ReviewLog, type ReviewQueue, type ReviewQueueItem, type ReviewQueueOptions, type RunResult, SIDECAR_POLICY_FILE, SNAPSHOT_VERSION, type SchedulingCard, type Session, type SessionStep, type SessionSummary, type SessionSynthesisCandidate, type SessionSynthesisEvidence, type SessionSynthesisPreview, type SessionSynthesisRecord, type SidecarPrivacyPolicy, type SkillProposal, type SkillSource, type SnapshotManifest, type Statement, type SupportedLocale, type SymbiosisMode, type SynthesisConfidence, type SystemProfile, type Token, type TokenDeleteImpact, type TokenPattern, type TranslationKey, type TursoCredentials, UI_OBSERVATION_PROTOCOL_VERSION, type UiActionType, type UiApplicationContext, type UiCandidateToken, type UiEvidenceRef, type UiEvidenceType, type UiObservationKind, type UiObservationReport, type UiObservedAction, type UnblockResult, type UpdateActionKind, type UpdateCardInput, type UpdateDecision, type UpdateStep, type UpdateStepKind, type UpdateTokenInput, type UserSetting, type UserStats, WINGET_PACKAGE_ID, type WorkItem, type WorkspaceConfig, type WorkspaceKind, type WorkspaceSourceControl, addPrerequisite, analyzeObservation, appendUiObservationReport, applySessionSynthesis, buildReviewQueue, buildUiSynthesisCandidates, cascadeBlock, clearADOCredentials, clearProviderApiKey, clearTursoCredentials, compareVersions, createAgentSkill, createFSRS, createGoal, createToken, decidePostCapture, decidePreCapture, decideUpdate, deleteCardForUser, deleteSetting, deleteToken, deprecateToken, detectSyncProvider, detectSystemLocale, discoverSkills, distributeGlobalSkills, endSession, ensureCard, ensureMonitorDir, ensureUiObserverDir, evaluateRating, executeReviewAction, exportSnapshot, extractTasks, extractTokenRefs, fetchActiveWorkItems, findTokens, generateBashHooks, generateBashUnhooks, generateConceptFreeCue, generatePowerShellHooks, generatePowerShellUnhooks, generatePrompt, generateZshHooks, generateZshUnhooks, getADOCredentials, getAgentSkill, getAllSettings, getAllSettingsDetailed, getBlockedCards, getCard, getCardById, getCardDeletionImpact, getConfiguredWorkspaces, getDatabaseTargetInfo, getDefaultDbPath, getDependents, getDomainCompetence, getDueCards, getGoal, getGoalTree, getInstallChannel, getInstallMode, getMachineAiConfig, getMonitorDir, getMonitorLogStats, getMonitorPath, getPackageSkillPath, getPrerequisites, getProviderApiKey, getRepoPaths, getReviewsForCard, getReviewsForUser, getSessionSummary, getSessionSynthesisRecords, getSetting, getSystemProfile, getTokenById, getTokenBySlug, getTokenDeleteImpact, getTokenNeighborhood, getTursoCredentials, getUiObservationPath, getUiObserverDir, getUserStats, hasCommand, importSnapshot, injectShellHooks, installFastFlowLM, installOllama, installOpenCode, interleave, isObserverPolicyConfigured, isUiObservationReport, listAgentSkills, listGoals, listProviderApiKeyRefs, listTokens, loadADOConfig, loadCredentials, loadInstallConfig, logReview, logStep, matchBuiltInSensitive, matchDenylist, matchesFilePath, monitorLogExists, normalizeLocale, normalizePath, openDatabase, openDatabaseWithSync, openRemoteDatabase, pairCommands, parseGoalFile, parseMonitorLog, parseObserverList, parseObserverPolicy, parseSnapshot, parseUiObservationLog, planOpenCodeInstall, planUpdate, prepareLocalModel, prepareSessionSynthesis, readMonitorLog, readUiObservationLog, removeConfiguredWorkspace, resolveAllBeliefPaths, resolveAllGoalPaths, resolveObserverPolicy, resolveReference, resolveRepoPath, resolveReviewContext, saveConfiguredWorkspaces, saveCredentials, saveInstallConfig, saveMachineAiConfig, serializeGoal, setADOCredentials, setInstallChannel, setInstallMode, setProviderApiKey, setSetting, setTursoCredentials, startSession, syncObserverSidecarPolicy, t, toSidecarPrivacyPolicy, uiObservationLogExists, uiObservationTimeSpan, unblockReady, updateCard, updateGoalStatus, updateToken, upsertConfiguredWorkspace, verifySnapshot, wouldCreateCycle, writeMonitorEvent };
+export { type ADOConfig, type ADOCredentials, type AgentSkill, type AnalysisResult, type ApplySessionSynthesisInput, type ApplySessionSynthesisResult, BUILT_IN_SENSITIVE_MATCHERS, type BloomLevel$1 as BloomLevel, type CaptureDecision, type CaptureDenialReason, type CaptureRequest, type Card, type CardDeletionImpact, type CardState$1 as CardState, type CascadeBlockResult, type CommandRecord, type CommandSequence, type ConnectionOptions, type CreateAgentSkillInput, type CreateGoalInput, type CreateReviewInput, type CreateSessionInput, type CreateTokenInput, type Credentials, DEFAULT_OBSERVER_POLICY, DEFAULT_REVIEW_CONTEXT_MAX_CHARS, type Database, type DatabaseProvider, type DatabaseTargetInfo, type DatabaseValue, type DeleteCardResult, type DeleteTokenResult, type DiscoveryOptions, type DomainCompetence, type EvaluateInput, type EvaluateResult, type ExecuteReviewActionInput, type ExecutionContext, type FSRSParameters, type Goal, type GoalFrontmatter, type GoalStatus, type GoalSummary, HOMEBREW_CASK, type ImportResult, type InstallChannel, type InstallConfig, type InstallMode, type InstallPlan, type InstallResult, type LocalLLMRunner, type LogStepInput, type MachineAiConfig, type MachineProviderRecord, type MachineRoleBinding, type MonitorEvent, type Neighborhood, type NeighborhoodToken, OBSERVER_POLICY_UNSET_HINT, OBSERVER_POLICY_VERSION, type ObservationRating, type ObserverConsent, type ObserverPolicy, type ObserverRetention, type ObserverScope, type ObserverSettingKey, type PrepareSessionSynthesisInput, type Prerequisite, type PrerequisiteWithToken, type PromptInput, REVIEW_CONTEXT_CACHE_TTL_MS, type Rating, type RecallPrompt, type RemoteDatabaseOptions, type RepoPaths, type ResolvedCaptureTarget, type ResolvedReference, type ReviewActionResult, type ReviewActionType, type ReviewContext, type ReviewLog, type ReviewQueue, type ReviewQueueItem, type ReviewQueueOptions, type RunResult, SIDECAR_POLICY_FILE, SNAPSHOT_VERSION, type SchedulingCard, type Session, type SessionStep, type SessionSummary, type SessionSynthesisCandidate, type SessionSynthesisEvidence, type SessionSynthesisPreview, type SessionSynthesisRecord, type SidecarPrivacyPolicy, type SkillProposal, type SkillSource, type SnapshotManifest, type Statement, type SupportedLocale, type SymbiosisMode, type SynthesisConfidence, type SystemProfile, type Token, type TokenDeleteImpact, type TokenPattern, type TranslationKey, type TursoCredentials, UI_OBSERVATION_PROTOCOL_VERSION, type UiActionType, type UiApplicationContext, type UiCandidateToken, type UiEvidenceRef, type UiEvidenceType, type UiObservationKind, type UiObservationReport, type UiObservedAction, type UnblockResult, type UpdateActionKind, type UpdateCardInput, type UpdateDecision, type UpdateStep, type UpdateStepKind, type UpdateTokenInput, type UserSetting, type UserStats, WINGET_PACKAGE_ID, type WorkItem, type WorkspaceConfig, type WorkspaceKind, type WorkspaceSourceControl, addPrerequisite, analyzeObservation, appendUiObservationReport, applySessionSynthesis, buildReviewQueue, buildUiSynthesisCandidates, cascadeBlock, clearADOCredentials, clearProviderApiKey, clearReviewContextCache, clearTursoCredentials, compareVersions, createAgentSkill, createFSRS, createGoal, createToken, decidePostCapture, decidePreCapture, decideUpdate, deleteCardForUser, deleteSetting, deleteToken, deprecateToken, detectSyncProvider, detectSystemLocale, discoverSkills, distributeGlobalSkills, endSession, ensureCard, ensureMonitorDir, ensureUiObserverDir, evaluateRating, executeReviewAction, exportSnapshot, extractTasks, extractTokenRefs, fetchActiveWorkItems, findTokens, generateBashHooks, generateBashUnhooks, generateConceptFreeCue, generatePowerShellHooks, generatePowerShellUnhooks, generatePrompt, generateZshHooks, generateZshUnhooks, getADOCredentials, getActiveWorkspace, getActiveWorkspaceId, getAgentSkill, getAllSettings, getAllSettingsDetailed, getBlockedCards, getCard, getCardById, getCardDeletionImpact, getConfiguredWorkspaces, getDatabaseTargetInfo, getDefaultDbPath, getDependents, getDomainCompetence, getDueCards, getGoal, getGoalTree, getInstallChannel, getInstallMode, getMachineAiConfig, getMonitorDir, getMonitorLogStats, getMonitorPath, getPackageSkillPath, getPrerequisites, getProviderApiKey, getRepoPaths, getReviewsForCard, getReviewsForUser, getSessionSummary, getSessionSynthesisRecords, getSetting, getSystemProfile, getTokenById, getTokenBySlug, getTokenDeleteImpact, getTokenNeighborhood, getTursoCredentials, getUiObservationPath, getUiObserverDir, getUserStats, hasCommand, importSnapshot, injectShellHooks, installFastFlowLM, installOllama, installOpenCode, interleave, isObserverPolicyConfigured, isUiObservationReport, listAgentSkills, listGoals, listProviderApiKeyRefs, listTokens, loadADOConfig, loadCredentials, loadInstallConfig, logReview, logStep, matchBuiltInSensitive, matchDenylist, matchesFilePath, monitorLogExists, normalizeLocale, normalizePath, openDatabase, openDatabaseWithSync, openRemoteDatabase, pairCommands, parseGoalFile, parseMonitorLog, parseObserverList, parseObserverPolicy, parseSnapshot, parseUiObservationLog, planOpenCodeInstall, planUpdate, prepareLocalModel, prepareSessionSynthesis, readMonitorLog, readUiObservationLog, removeConfiguredWorkspace, resolveAllBeliefPaths, resolveAllGoalPaths, resolveObserverPolicy, resolveReference, resolveRepoPath, resolveReviewContext, saveConfiguredWorkspaces, saveCredentials, saveInstallConfig, saveMachineAiConfig, serializeGoal, setADOCredentials, setActiveWorkspaceId, setInstallChannel, setInstallMode, setProviderApiKey, setSetting, setTursoCredentials, startSession, syncObserverSidecarPolicy, t, toSidecarPrivacyPolicy, uiObservationLogExists, uiObservationTimeSpan, unblockReady, updateCard, updateGoalStatus, updateToken, upsertConfiguredWorkspace, verifySnapshot, wouldCreateCycle, writeMonitorEvent };

package/dist/index.js

@@ -3674,6 +3674,14 @@ function generatePrompt(input) {
 import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
 import { dirname as dirname3, join as join7, resolve } from "path";
 var DEFAULT_REVIEW_CONTEXT_MAX_CHARS = 6e3;
+var REVIEW_CONTEXT_CACHE_TTL_MS = 5 * 60 * 1e3;
+var reviewContextCache = /* @__PURE__ */ new Map();
+function reviewContextCacheKey(sourceLink, maxChars) {
+  return `${sourceLink}\0${maxChars}`;
+}
+function clearReviewContextCache() {
+  reviewContextCache.clear();
+}
 function htmlToText(html) {
   let content = html;
   const bodyMatch = /<body[^>]*>([\s\S]*?)<\/body>/i.exec(html);
@@ -3816,6 +3824,11 @@ async function resolveReviewContext(sourceLink, opts = {}) {
   const cleaned = sourceLink?.trim();
   if (!cleaned) return null;
   const maxChars = opts.maxChars ?? DEFAULT_REVIEW_CONTEXT_MAX_CHARS;
+  const cacheKey = reviewContextCacheKey(cleaned, maxChars);
+  const cached = reviewContextCache.get(cacheKey);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached.context;
+  }
   const resolved = await resolveReference(cleaned);
   let content = resolved.content;
   let truncated = false;
@@ -3823,7 +3836,7 @@ async function resolveReviewContext(sourceLink, opts = {}) {
     content = content.slice(0, maxChars);
     truncated = true;
   }
-  return {
+  const context = {
     sourceLink: cleaned,
     sourceType: resolved.sourceType,
     content,
@@ -3831,6 +3844,11 @@ async function resolveReviewContext(sourceLink, opts = {}) {
     url: resolved.url,
     truncated
   };
+  reviewContextCache.set(cacheKey, {
+    context,
+    expiresAt: Date.now() + REVIEW_CONTEXT_CACHE_TTL_MS
+  });
+  return context;
 }
 function normalizePath(p) {
   const base = p.split("#")[0].trim();
@@ -4515,22 +4533,49 @@ function getConfiguredWorkspaces(path = defaultConfigPath()) {
 function saveConfiguredWorkspaces(workspaces, path = defaultConfigPath()) {
   const config = loadInstallConfig(path);
   config.workspaces = workspaces;
+  if (config.activeWorkspaceId && !workspaces.some((workspace) => workspace.id === config.activeWorkspaceId)) {
+    config.activeWorkspaceId = workspaces[0]?.id;
+  }
   saveInstallConfig(config, path);
 }
+function getActiveWorkspaceId(path = defaultConfigPath()) {
+  return loadInstallConfig(path).activeWorkspaceId;
+}
+function setActiveWorkspaceId(id, path = defaultConfigPath()) {
+  const config = loadInstallConfig(path);
+  if (id) {
+    config.activeWorkspaceId = id;
+  } else {
+    delete config.activeWorkspaceId;
+  }
+  saveInstallConfig(config, path);
+}
+function getActiveWorkspace(path = defaultConfigPath()) {
+  const config = loadInstallConfig(path);
+  const id = config.activeWorkspaceId;
+  return id ? config.workspaces?.find((workspace) => workspace.id === id) : void 0;
+}
 function upsertConfiguredWorkspace(workspace, path = defaultConfigPath()) {
-  const current = getConfiguredWorkspaces(path);
+  const config = loadInstallConfig(path);
+  const current = config.workspaces ?? [];
   const next = [
     ...current.filter((candidate) => candidate.id !== workspace.id),
     workspace
   ];
-  saveConfiguredWorkspaces(next, path);
+  config.workspaces = next;
+  saveInstallConfig(config, path);
   return next;
 }
 function removeConfiguredWorkspace(id, path = defaultConfigPath()) {
-  const next = getConfiguredWorkspaces(path).filter(
+  const config = loadInstallConfig(path);
+  const next = (config.workspaces ?? []).filter(
     (workspace) => workspace.id !== id
   );
-  saveConfiguredWorkspaces(next, path);
+  config.workspaces = next;
+  if (config.activeWorkspaceId === id) {
+    config.activeWorkspaceId = next[0]?.id;
+  }
+  saveInstallConfig(config, path);
   return next;
 }
 function detectSyncProvider(dir) {
@@ -4862,7 +4907,7 @@ function getSystemProfile() {
 import { existsSync as existsSync10 } from "fs";
 import { resolve as resolve2 } from "path";
 async function getRepoPaths(db) {
-  const personalSetting = await getSetting(db, "repo.personal") || await getSetting(db, "personal.workspace_dir");
+  const personalSetting = await getSetting(db, "repo.personal") || getActiveWorkspace()?.path;
   const teamSetting = await getSetting(db, "repo.team");
   const orgSetting = await getSetting(db, "repo.org");
   return {
@@ -5032,6 +5077,7 @@ export {
   HOMEBREW_CASK,
   OBSERVER_POLICY_UNSET_HINT,
   OBSERVER_POLICY_VERSION,
+  REVIEW_CONTEXT_CACHE_TTL_MS,
   SIDECAR_POLICY_FILE,
   SNAPSHOT_VERSION,
   UI_OBSERVATION_PROTOCOL_VERSION,
@@ -5045,6 +5091,7 @@ export {
   cascadeBlock,
   clearADOCredentials,
   clearProviderApiKey,
+  clearReviewContextCache,
   clearTursoCredentials,
   compareVersions,
   createAgentSkill,
@@ -5082,6 +5129,8 @@ export {
   generateZshHooks,
   generateZshUnhooks,
   getADOCredentials,
+  getActiveWorkspace,
+  getActiveWorkspaceId,
   getAgentSkill,
   getAllSettings,
   getAllSettingsDetailed,
@@ -5174,6 +5223,7 @@ export {
   saveMachineAiConfig,
   serializeGoal,
   setADOCredentials,
+  setActiveWorkspaceId,
   setInstallChannel,
   setInstallMode,
   setProviderApiKey,