Add Dyad Update Management Guide and custom hooks for smart context

- Organized custom modifications in src/custom/
- Added update-dyad-v2.sh for selective updates
- Preserved custom smart context functionality
- Created backup system for safe updates

UPDATE_GUIDE.md

@@ -0,0 +1,198 @@
+# Dyad Update Management Guide
+
+This guide explains how to update your forked Dyad application while preserving your custom modifications.
+
+## 🎯 Overview
+
+Your setup uses a **selective update strategy** that:
+- Keeps your custom code separate from the main codebase
+- Automatically preserves custom modifications during updates
+- Provides backup and rollback capabilities
+- Minimizes merge conflicts
+
+## 📁 Custom Code Structure
+
+Your custom modifications are organized in `src/custom/`:
+
+```
+src/custom/
+├── index.ts                    # Main entry point for custom features
+├── hooks/
+│   └── useSmartContext.ts     # Custom smart context hook
+├── ipc/
+│   └── smart_context_handlers.ts  # Custom IPC handlers
+└── utils/
+    └── smart_context_store.ts     # Custom utilities
+```
+
+## 🚀 Update Process
+
+### Method 1: Automated Update (Recommended)
+
+Use the provided update script:
+
+```bash
+./update-dyad-v2.sh
+```
+
+**What the script does:**
+1. Creates a timestamped backup
+2. Backs up your custom code
+3. Fetches latest changes from upstream
+4. Resets to the latest upstream version
+5. Restores your custom code
+6. Pushes updates to your fork
+
+### Method 2: Manual Update
+
+If you prefer manual control:
+
+```bash
+# 1. Create backup
+cp -r src/custom/ dyad-backup-$(date +%Y%m%d-%H%M%S)/
+
+# 2. Fetch latest changes
+git fetch upstream
+
+# 3. Reset to latest upstream
+git reset --hard upstream/main
+
+# 4. Restore custom code
+cp -r dyad-backup-*/src/custom/ src/
+
+# 5. Commit and push
+git add src/custom/
+git commit -m "Restore custom code after update"
+git push origin main
+```
+
+## 🔄 Update Workflow
+
+### Before Updating
+1. **Test current state** - Ensure your app works properly
+2. **Commit any changes** - Don't have uncommitted work
+3. **Check custom code** - Note any modifications that might need updates
+
+### After Updating
+1. **Run npm install** - Update dependencies if needed
+2. **Test the application** - Ensure everything works
+3. **Check custom integrations** - Verify custom features still work
+4. **Update custom code** if needed - Adapt to any API changes
+
+## 🛠️ Adding New Custom Features
+
+When adding new custom features:
+
+1. **Place in src/custom/** - Keep custom code organized
+2. **Update imports** - Use relative imports within custom directory
+3. **Document changes** - Note what each custom feature does
+4. **Test integration** - Ensure custom features work with main app
+
+Example:
+```typescript
+// src/custom/components/MyCustomComponent.tsx
+import { useSmartContext } from '../hooks/useSmartContext';
+
+export const MyCustomComponent = () => {
+  // Your custom logic
+};
+```
+
+## 🚨 Troubleshooting
+
+### Merge Conflicts
+If you encounter merge conflicts during manual updates:
+
+```bash
+# Abort the merge
+git merge --abort
+
+# Use the automated script instead
+./update-dyad-v2.sh
+```
+
+### Custom Code Not Working
+After an update, if custom features don't work:
+
+1. **Check API changes** - The upstream may have changed interfaces
+2. **Update imports** - File paths might have changed
+3. **Review breaking changes** - Check upstream release notes
+4. **Test incrementally** - Isolate the problematic code
+
+### Backup Restoration
+If you need to restore from backup:
+
+```bash
+# Find your backup directory
+ls dyad-backup-*
+
+# Restore specific files
+cp -r dyad-backup-YYYYMMDD-HHMMSS/src/custom/ src/
+
+# Or restore entire project (last resort)
+rm -rf * .gitignore
+cp -r dyad-backup-YYYYMMDD-HHMMSS/* .
+cp dyad-backup-YYYYMMDD-HHMMSS/.gitignore .
+```
+
+## 📋 Best Practices
+
+### Regular Maintenance
+- **Update frequently** - Smaller updates are easier to manage
+- **Test after each update** - Catch issues early
+- **Keep custom code minimal** - Only customize what's necessary
+- **Document customizations** - Future you will thank you
+
+### Code Organization
+- **Separate concerns** - Keep UI, logic, and utilities separate
+- **Use TypeScript** - Catch integration issues early
+- **Follow existing patterns** - Match the upstream code style
+- **Avoid modifying core files** - Use extension patterns when possible
+
+### Backup Strategy
+- **Multiple backups** - Keep several backup versions
+- **Offsite backup** - Consider cloud storage for critical backups
+- **Test backups** - Ensure you can restore from backup
+- **Label clearly** - Use descriptive backup names
+
+## 🔧 Advanced Configuration
+
+### Custom Update Script
+You can modify `update-dyad-v2.sh` to:
+- Skip certain files from backup
+- Add custom post-update steps
+- Include additional validation
+- Send notifications on completion
+
+### Selective File Restoration
+To restore only specific custom files:
+
+```bash
+# Restore specific directory
+cp -r dyad-backup-*/src/custom/hooks/ src/custom/
+
+# Restore specific file
+cp dyad-backup-*/src/custom/index.ts src/custom/
+```
+
+## 📞 Getting Help
+
+If you encounter issues:
+
+1. **Check this guide first** - Most common issues are covered
+2. **Review the script output** - Error messages are informative
+3. **Test with a clean state** - Start fresh if needed
+4. **Document the issue** - Note what you were trying to do
+
+## 🎉 Success Indicators
+
+You'll know the update was successful when:
+- ✅ Script completes without errors
+- ✅ Custom code is present in `src/custom/`
+- ✅ Application starts and runs normally
+- ✅ Custom features work as expected
+- ✅ No merge conflicts in git status
+
+---
+
+**Remember**: The goal is to make updates painless and predictable. When in doubt, use the automated script and keep good backups!

dyad-backup-20251205-195655/commit-history.txt

@@ -0,0 +1,7 @@
+52a977b backup: auto-commit before update - Fri Dec  5 15:16:35 +07 2025
+8a1cecb backup: auto-commit before update - Fri Dec  5 15:12:17 +07 2025
+e6de49c fix: update .gitignore to exclude 'out/' directory
+6d74721 Add user settings configuration for GPT-5 Codex model with Azure provider
+d22227b feat: implement fuzzy search and replace functionality with Levenshtein distance
+11986a0 Add project files
+3b43cb5 Add blank

dyad-backup-20251205-195655/custom/hooks/useSmartContext.ts

@@ -0,0 +1,60 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { IpcClient } from "@/ipc/ipc_client";
+import type {
+  SmartContextMeta,
+  SmartContextSnippet,
+  SmartContextRetrieveResult,
+} from "@/ipc/ipc_types";
+
+export function useSmartContextMeta(chatId: number) {
+  return useQuery<SmartContextMeta, Error>({
+    queryKey: ["smart-context", chatId, "meta"],
+    queryFn: async () => {
+      const ipc = IpcClient.getInstance();
+      return ipc.getSmartContextMeta(chatId);
+    },
+    enabled: !!chatId,
+  });
+}
+
+export function useRetrieveSmartContext(
+  chatId: number,
+  query: string,
+  budgetTokens: number,
+) {
+  return useQuery<SmartContextRetrieveResult, Error>({
+    queryKey: ["smart-context", chatId, "retrieve", query, budgetTokens],
+    queryFn: async () => {
+      const ipc = IpcClient.getInstance();
+      return ipc.retrieveSmartContext({ chatId, query, budgetTokens });
+    },
+    enabled: !!chatId && !!query && budgetTokens > 0,
+    meta: { showErrorToast: true },
+  });
+}
+
+export function useUpsertSmartContextSnippets(chatId: number) {
+  const qc = useQueryClient();
+  return useMutation<number, Error, Array<Pick<SmartContextSnippet, "text" | "source">>>({
+    mutationFn: async (snippets) => {
+      const ipc = IpcClient.getInstance();
+      return ipc.upsertSmartContextSnippets(chatId, snippets);
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["smart-context", chatId] });
+    },
+  });
+}
+
+export function useUpdateRollingSummary(chatId: number) {
+  const qc = useQueryClient();
+  return useMutation<SmartContextMeta, Error, { summary: string }>({
+    mutationFn: async ({ summary }) => {
+      const ipc = IpcClient.getInstance();
+      return ipc.updateSmartContextRollingSummary(chatId, summary);
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["smart-context", chatId, "meta"] });
+    },
+  });
+}

dyad-backup-20251205-195655/custom/index.ts

@@ -0,0 +1,18 @@
+// Custom modules for moreminimore-vibe
+// This file exports all custom functionality to make imports easier
+
+// Custom hooks
+export { useSmartContextMeta, useRetrieveSmartContext, useUpsertSmartContextSnippets, useUpdateRollingSummary } from './hooks/useSmartContext';
+
+// Custom IPC handlers (these will need to be imported and registered in the main process)
+export { registerSmartContextHandlers } from './ipc/smart_context_handlers';
+
+// Custom utilities
+export * from './utils/smart_context_store';
+
+// Re-export types that might be needed
+export type {
+  SmartContextMeta,
+  SmartContextSnippet,
+  SmartContextRetrieveResult,
+} from '../ipc/ipc_types';

dyad-backup-20251205-195655/custom/ipc/smart_context_handlers.ts

@@ -0,0 +1,65 @@
+import log from "electron-log";
+import { createLoggedHandler } from "./safe_handle";
+import {
+  appendSnippets,
+  readMeta,
+  retrieveContext,
+  updateRollingSummary,
+  rebuildIndex,
+  type SmartContextSnippet,
+  type SmartContextMeta,
+} from "../utils/smart_context_store";
+
+const logger = log.scope("smart_context_handlers");
+const handle = createLoggedHandler(logger);
+
+export interface UpsertSnippetsParams {
+  chatId: number;
+  snippets: Array<{
+    text: string;
+    source:
+      | { type: "message"; messageIndex?: number }
+      | { type: "code"; filePath: string }
+      | { type: "attachment"; name: string; mime?: string }
+      | { type: "other"; label?: string };
+  }>;
+}
+
+export interface RetrieveContextParams {
+  chatId: number;
+  query: string;
+  budgetTokens: number;
+}
+
+export function registerSmartContextHandlers() {
+  handle("sc:get-meta", async (_event, chatId: number): Promise<SmartContextMeta> => {
+    return readMeta(chatId);
+  });
+
+  handle(
+    "sc:upsert-snippets",
+    async (_event, params: UpsertSnippetsParams): Promise<number> => {
+      const count = await appendSnippets(params.chatId, params.snippets);
+      return count;
+    },
+  );
+
+  handle(
+    "sc:update-rolling-summary",
+    async (_event, params: { chatId: number; summary: string }): Promise<SmartContextMeta> => {
+      return updateRollingSummary(params.chatId, params.summary);
+    },
+  );
+
+  handle(
+    "sc:retrieve-context",
+    async (_event, params: RetrieveContextParams) => {
+      return retrieveContext(params.chatId, params.query, params.budgetTokens);
+    },
+  );
+
+  handle("sc:rebuild-index", async (_event, chatId: number) => {
+    await rebuildIndex(chatId);
+    return { ok: true } as const;
+  });
+}

dyad-backup-20251205-195655/custom/utils/smart_context_store.ts

@@ -0,0 +1,212 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { getUserDataPath } from "../../paths/paths";
+import { estimateTokens } from "./token_utils";
+
+export type SmartContextSource =
+  | { type: "message"; messageIndex?: number }
+  | { type: "code"; filePath: string }
+  | { type: "attachment"; name: string; mime?: string }
+  | { type: "other"; label?: string };
+
+export interface SmartContextSnippet {
+  id: string;
+  text: string;
+  score?: number;
+  source: SmartContextSource;
+  ts: number; // epoch ms
+  tokens?: number;
+}
+
+export interface SmartContextMetaConfig {
+  maxSnippets?: number;
+}
+
+export interface SmartContextMeta {
+  entityId: string; // e.g., chatId as string
+  updatedAt: number;
+  rollingSummary?: string;
+  summaryTokens?: number;
+  config?: SmartContextMetaConfig;
+}
+
+function getThreadDir(chatId: number): string {
+  const base = path.join(getUserDataPath(), "smart-context", "threads");
+  return path.join(base, String(chatId));
+}
+
+function getMetaPath(chatId: number): string {
+  return path.join(getThreadDir(chatId), "meta.json");
+}
+
+function getSnippetsPath(chatId: number): string {
+  return path.join(getThreadDir(chatId), "snippets.jsonl");
+}
+
+async function ensureDir(dir: string): Promise<void> {
+  await fs.mkdir(dir, { recursive: true });
+}
+
+export async function readMeta(chatId: number): Promise<SmartContextMeta> {
+  const dir = getThreadDir(chatId);
+  await ensureDir(dir);
+  const metaPath = getMetaPath(chatId);
+  try {
+    const raw = await fs.readFile(metaPath, "utf8");
+    const meta = JSON.parse(raw) as SmartContextMeta;
+    return meta;
+  } catch {
+    const fresh: SmartContextMeta = {
+      entityId: String(chatId),
+      updatedAt: Date.now(),
+      rollingSummary: "",
+      summaryTokens: 0,
+      config: { maxSnippets: 400 },
+    };
+    await fs.writeFile(metaPath, JSON.stringify(fresh, null, 2), "utf8");
+    return fresh;
+  }
+}
+
+export async function writeMeta(
+  chatId: number,
+  meta: SmartContextMeta,
+): Promise<void> {
+  const dir = getThreadDir(chatId);
+  await ensureDir(dir);
+  const metaPath = getMetaPath(chatId);
+  const updated: SmartContextMeta = {
+    ...meta,
+    entityId: String(chatId),
+    updatedAt: Date.now(),
+  };
+  await fs.writeFile(metaPath, JSON.stringify(updated, null, 2), "utf8");
+}
+
+export async function updateRollingSummary(
+  chatId: number,
+  summary: string,
+): Promise<SmartContextMeta> {
+  const meta = await readMeta(chatId);
+  const summaryTokens = estimateTokens(summary || "");
+  const next: SmartContextMeta = {
+    ...meta,
+    rollingSummary: summary,
+    summaryTokens,
+  };
+  await writeMeta(chatId, next);
+  return next;
+}
+
+export async function appendSnippets(
+  chatId: number,
+  snippets: Omit<SmartContextSnippet, "id" | "ts" | "tokens">[],
+): Promise<number> {
+  const dir = getThreadDir(chatId);
+  await ensureDir(dir);
+  const snippetsPath = getSnippetsPath(chatId);
+  const withDefaults: SmartContextSnippet[] = snippets.map((s) => ({
+    id: randomUUID(),
+    ts: Date.now(),
+    tokens: estimateTokens(s.text),
+    ...s,
+  }));
+  const lines = withDefaults.map((obj) => JSON.stringify(obj)).join("\n");
+  await fs.appendFile(snippetsPath, (lines ? lines + "\n" : ""), "utf8");
+
+  // prune if exceeded max
+  const meta = await readMeta(chatId);
+  const maxSnippets = meta.config?.maxSnippets ?? 400;
+  try {
+    const file = await fs.readFile(snippetsPath, "utf8");
+    const allLines = file.split("\n").filter(Boolean);
+    if (allLines.length > maxSnippets) {
+      const toKeep = allLines.slice(allLines.length - maxSnippets);
+      await fs.writeFile(snippetsPath, toKeep.join("\n") + "\n", "utf8");
+      return toKeep.length;
+    }
+    return allLines.length;
+  } catch {
+    return withDefaults.length;
+  }
+}
+
+export async function readAllSnippets(chatId: number): Promise<SmartContextSnippet[]> {
+  try {
+    const raw = await fs.readFile(getSnippetsPath(chatId), "utf8");
+    return raw
+      .split("\n")
+      .filter(Boolean)
+      .map((line) => JSON.parse(line) as SmartContextSnippet);
+  } catch {
+    return [];
+  }
+}
+
+function normalize(value: number, min: number, max: number): number {
+  if (max === min) return 0;
+  return (value - min) / (max - min);
+}
+
+function keywordScore(text: string, query: string): number {
+  const toTokens = (s: string) =>
+    s
+      .toLowerCase()
+      .replace(/[^a-z0-9_\- ]+/g, " ")
+      .split(/\s+/)
+      .filter(Boolean);
+  const qTokens = new Set(toTokens(query));
+  const tTokens = toTokens(text);
+  if (qTokens.size === 0 || tTokens.length === 0) return 0;
+  let hits = 0;
+  for (const tok of tTokens) if (qTokens.has(tok)) hits++;
+  return hits / tTokens.length; // simple overlap ratio
+}
+
+export interface RetrieveContextResult {
+  rollingSummary?: string;
+  usedTokens: number;
+  snippets: SmartContextSnippet[];
+}
+
+export async function retrieveContext(
+  chatId: number,
+  query: string,
+  budgetTokens: number,
+): Promise<RetrieveContextResult> {
+  const meta = await readMeta(chatId);
+  const snippets = await readAllSnippets(chatId);
+  const now = Date.now();
+  let minTs = now;
+  let maxTs = 0;
+  for (const s of snippets) {
+    if (s.ts < minTs) minTs = s.ts;
+    if (s.ts > maxTs) maxTs = s.ts;
+  }
+  const scored = snippets.map((s) => {
+    const recency = normalize(s.ts, minTs, maxTs);
+    const kw = keywordScore(s.text, query);
+    const base = 0.6 * kw + 0.4 * recency;
+    const score = base;
+    return { ...s, score } as SmartContextSnippet;
+  });
+  scored.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+
+  const picked: SmartContextSnippet[] = [];
+  let usedTokens = 0;
+  for (const s of scored) {
+    const t = s.tokens ?? estimateTokens(s.text);
+    if (usedTokens + t > budgetTokens) break;
+    picked.push(s);
+    usedTokens += t;
+  }
+
+  const rollingSummary = meta.rollingSummary || "";
+  return { rollingSummary, usedTokens, snippets: picked };
+}
+
+export async function rebuildIndex(_chatId: number): Promise<void> {
+  // Placeholder for future embedding/vector index rebuild.
+  return;
+}

dyad-backup-20251205-195655/last-changes.diff

@@ -0,0 +1,13 @@
+diff --git a/update-dyad.sh b/update-dyad.sh
+index 2763b94..4d7da4c 100755
+--- a/update-dyad.sh
++++ b/update-dyad.sh
+@@ -78,7 +78,7 @@ git log --oneline HEAD..upstream/main --reverse
+ 
+ # Attempt to merge
+ print_status "Merging upstream changes into your branch..."
+-if git merge upstream/main -m "merge: update from upstream - $(date)"; then
++if git merge upstream/main -m "merge: update from upstream - $(date)" --allow-unrelated-histories; then
+     print_success "✅ Update completed successfully!"
+     
+     # Check for any conflicts that need manual resolution

src/custom/hooks/useSmartContext.ts

@@ -0,0 +1,60 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { IpcClient } from "@/ipc/ipc_client";
+import type {
+  SmartContextMeta,
+  SmartContextSnippet,
+  SmartContextRetrieveResult,
+} from "@/ipc/ipc_types";
+
+export function useSmartContextMeta(chatId: number) {
+  return useQuery<SmartContextMeta, Error>({
+    queryKey: ["smart-context", chatId, "meta"],
+    queryFn: async () => {
+      const ipc = IpcClient.getInstance();
+      return ipc.getSmartContextMeta(chatId);
+    },
+    enabled: !!chatId,
+  });
+}
+
+export function useRetrieveSmartContext(
+  chatId: number,
+  query: string,
+  budgetTokens: number,
+) {
+  return useQuery<SmartContextRetrieveResult, Error>({
+    queryKey: ["smart-context", chatId, "retrieve", query, budgetTokens],
+    queryFn: async () => {
+      const ipc = IpcClient.getInstance();
+      return ipc.retrieveSmartContext({ chatId, query, budgetTokens });
+    },
+    enabled: !!chatId && !!query && budgetTokens > 0,
+    meta: { showErrorToast: true },
+  });
+}
+
+export function useUpsertSmartContextSnippets(chatId: number) {
+  const qc = useQueryClient();
+  return useMutation<number, Error, Array<Pick<SmartContextSnippet, "text" | "source">>>({
+    mutationFn: async (snippets) => {
+      const ipc = IpcClient.getInstance();
+      return ipc.upsertSmartContextSnippets(chatId, snippets);
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["smart-context", chatId] });
+    },
+  });
+}
+
+export function useUpdateRollingSummary(chatId: number) {
+  const qc = useQueryClient();
+  return useMutation<SmartContextMeta, Error, { summary: string }>({
+    mutationFn: async ({ summary }) => {
+      const ipc = IpcClient.getInstance();
+      return ipc.updateSmartContextRollingSummary(chatId, summary);
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["smart-context", chatId, "meta"] });
+    },
+  });
+}

src/custom/index.ts

@@ -0,0 +1,18 @@
+// Custom modules for moreminimore-vibe
+// This file exports all custom functionality to make imports easier
+
+// Custom hooks
+export { useSmartContextMeta, useRetrieveSmartContext, useUpsertSmartContextSnippets, useUpdateRollingSummary } from './hooks/useSmartContext';
+
+// Custom IPC handlers (these will need to be imported and registered in the main process)
+export { registerSmartContextHandlers } from './ipc/smart_context_handlers';
+
+// Custom utilities
+export * from './utils/smart_context_store';
+
+// Re-export types that might be needed
+export type {
+  SmartContextMeta,
+  SmartContextSnippet,
+  SmartContextRetrieveResult,
+} from '../ipc/ipc_types';

src/custom/ipc/smart_context_handlers.ts

@@ -0,0 +1,65 @@
+import log from "electron-log";
+import { createLoggedHandler } from "./safe_handle";
+import {
+  appendSnippets,
+  readMeta,
+  retrieveContext,
+  updateRollingSummary,
+  rebuildIndex,
+  type SmartContextSnippet,
+  type SmartContextMeta,
+} from "../utils/smart_context_store";
+
+const logger = log.scope("smart_context_handlers");
+const handle = createLoggedHandler(logger);
+
+export interface UpsertSnippetsParams {
+  chatId: number;
+  snippets: Array<{
+    text: string;
+    source:
+      | { type: "message"; messageIndex?: number }
+      | { type: "code"; filePath: string }
+      | { type: "attachment"; name: string; mime?: string }
+      | { type: "other"; label?: string };
+  }>;
+}
+
+export interface RetrieveContextParams {
+  chatId: number;
+  query: string;
+  budgetTokens: number;
+}
+
+export function registerSmartContextHandlers() {
+  handle("sc:get-meta", async (_event, chatId: number): Promise<SmartContextMeta> => {
+    return readMeta(chatId);
+  });
+
+  handle(
+    "sc:upsert-snippets",
+    async (_event, params: UpsertSnippetsParams): Promise<number> => {
+      const count = await appendSnippets(params.chatId, params.snippets);
+      return count;
+    },
+  );
+
+  handle(
+    "sc:update-rolling-summary",
+    async (_event, params: { chatId: number; summary: string }): Promise<SmartContextMeta> => {
+      return updateRollingSummary(params.chatId, params.summary);
+    },
+  );
+
+  handle(
+    "sc:retrieve-context",
+    async (_event, params: RetrieveContextParams) => {
+      return retrieveContext(params.chatId, params.query, params.budgetTokens);
+    },
+  );
+
+  handle("sc:rebuild-index", async (_event, chatId: number) => {
+    await rebuildIndex(chatId);
+    return { ok: true } as const;
+  });
+}

src/custom/utils/smart_context_store.ts

@@ -0,0 +1,212 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { getUserDataPath } from "../../paths/paths";
+import { estimateTokens } from "./token_utils";
+
+export type SmartContextSource =
+  | { type: "message"; messageIndex?: number }
+  | { type: "code"; filePath: string }
+  | { type: "attachment"; name: string; mime?: string }
+  | { type: "other"; label?: string };
+
+export interface SmartContextSnippet {
+  id: string;
+  text: string;
+  score?: number;
+  source: SmartContextSource;
+  ts: number; // epoch ms
+  tokens?: number;
+}
+
+export interface SmartContextMetaConfig {
+  maxSnippets?: number;
+}
+
+export interface SmartContextMeta {
+  entityId: string; // e.g., chatId as string
+  updatedAt: number;
+  rollingSummary?: string;
+  summaryTokens?: number;
+  config?: SmartContextMetaConfig;
+}
+
+function getThreadDir(chatId: number): string {
+  const base = path.join(getUserDataPath(), "smart-context", "threads");
+  return path.join(base, String(chatId));
+}
+
+function getMetaPath(chatId: number): string {
+  return path.join(getThreadDir(chatId), "meta.json");
+}
+
+function getSnippetsPath(chatId: number): string {
+  return path.join(getThreadDir(chatId), "snippets.jsonl");
+}
+
+async function ensureDir(dir: string): Promise<void> {
+  await fs.mkdir(dir, { recursive: true });
+}
+
+export async function readMeta(chatId: number): Promise<SmartContextMeta> {
+  const dir = getThreadDir(chatId);
+  await ensureDir(dir);
+  const metaPath = getMetaPath(chatId);
+  try {
+    const raw = await fs.readFile(metaPath, "utf8");
+    const meta = JSON.parse(raw) as SmartContextMeta;
+    return meta;
+  } catch {
+    const fresh: SmartContextMeta = {
+      entityId: String(chatId),
+      updatedAt: Date.now(),
+      rollingSummary: "",
+      summaryTokens: 0,
+      config: { maxSnippets: 400 },
+    };
+    await fs.writeFile(metaPath, JSON.stringify(fresh, null, 2), "utf8");
+    return fresh;
+  }
+}
+
+export async function writeMeta(
+  chatId: number,
+  meta: SmartContextMeta,
+): Promise<void> {
+  const dir = getThreadDir(chatId);
+  await ensureDir(dir);
+  const metaPath = getMetaPath(chatId);
+  const updated: SmartContextMeta = {
+    ...meta,
+    entityId: String(chatId),
+    updatedAt: Date.now(),
+  };
+  await fs.writeFile(metaPath, JSON.stringify(updated, null, 2), "utf8");
+}
+
+export async function updateRollingSummary(
+  chatId: number,
+  summary: string,
+): Promise<SmartContextMeta> {
+  const meta = await readMeta(chatId);
+  const summaryTokens = estimateTokens(summary || "");
+  const next: SmartContextMeta = {
+    ...meta,
+    rollingSummary: summary,
+    summaryTokens,
+  };
+  await writeMeta(chatId, next);
+  return next;
+}
+
+export async function appendSnippets(
+  chatId: number,
+  snippets: Omit<SmartContextSnippet, "id" | "ts" | "tokens">[],
+): Promise<number> {
+  const dir = getThreadDir(chatId);
+  await ensureDir(dir);
+  const snippetsPath = getSnippetsPath(chatId);
+  const withDefaults: SmartContextSnippet[] = snippets.map((s) => ({
+    id: randomUUID(),
+    ts: Date.now(),
+    tokens: estimateTokens(s.text),
+    ...s,
+  }));
+  const lines = withDefaults.map((obj) => JSON.stringify(obj)).join("\n");
+  await fs.appendFile(snippetsPath, (lines ? lines + "\n" : ""), "utf8");
+
+  // prune if exceeded max
+  const meta = await readMeta(chatId);
+  const maxSnippets = meta.config?.maxSnippets ?? 400;
+  try {
+    const file = await fs.readFile(snippetsPath, "utf8");
+    const allLines = file.split("\n").filter(Boolean);
+    if (allLines.length > maxSnippets) {
+      const toKeep = allLines.slice(allLines.length - maxSnippets);
+      await fs.writeFile(snippetsPath, toKeep.join("\n") + "\n", "utf8");
+      return toKeep.length;
+    }
+    return allLines.length;
+  } catch {
+    return withDefaults.length;
+  }
+}
+
+export async function readAllSnippets(chatId: number): Promise<SmartContextSnippet[]> {
+  try {
+    const raw = await fs.readFile(getSnippetsPath(chatId), "utf8");
+    return raw
+      .split("\n")
+      .filter(Boolean)
+      .map((line) => JSON.parse(line) as SmartContextSnippet);
+  } catch {
+    return [];
+  }
+}
+
+function normalize(value: number, min: number, max: number): number {
+  if (max === min) return 0;
+  return (value - min) / (max - min);
+}
+
+function keywordScore(text: string, query: string): number {
+  const toTokens = (s: string) =>
+    s
+      .toLowerCase()
+      .replace(/[^a-z0-9_\- ]+/g, " ")
+      .split(/\s+/)
+      .filter(Boolean);
+  const qTokens = new Set(toTokens(query));
+  const tTokens = toTokens(text);
+  if (qTokens.size === 0 || tTokens.length === 0) return 0;
+  let hits = 0;
+  for (const tok of tTokens) if (qTokens.has(tok)) hits++;
+  return hits / tTokens.length; // simple overlap ratio
+}
+
+export interface RetrieveContextResult {
+  rollingSummary?: string;
+  usedTokens: number;
+  snippets: SmartContextSnippet[];
+}
+
+export async function retrieveContext(
+  chatId: number,
+  query: string,
+  budgetTokens: number,
+): Promise<RetrieveContextResult> {
+  const meta = await readMeta(chatId);
+  const snippets = await readAllSnippets(chatId);
+  const now = Date.now();
+  let minTs = now;
+  let maxTs = 0;
+  for (const s of snippets) {
+    if (s.ts < minTs) minTs = s.ts;
+    if (s.ts > maxTs) maxTs = s.ts;
+  }
+  const scored = snippets.map((s) => {
+    const recency = normalize(s.ts, minTs, maxTs);
+    const kw = keywordScore(s.text, query);
+    const base = 0.6 * kw + 0.4 * recency;
+    const score = base;
+    return { ...s, score } as SmartContextSnippet;
+  });
+  scored.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+
+  const picked: SmartContextSnippet[] = [];
+  let usedTokens = 0;
+  for (const s of scored) {
+    const t = s.tokens ?? estimateTokens(s.text);
+    if (usedTokens + t > budgetTokens) break;
+    picked.push(s);
+    usedTokens += t;
+  }
+
+  const rollingSummary = meta.rollingSummary || "";
+  return { rollingSummary, usedTokens, snippets: picked };
+}
+
+export async function rebuildIndex(_chatId: number): Promise<void> {
+  // Placeholder for future embedding/vector index rebuild.
+  return;
+}

update-dyad-v2.sh

@@ -0,0 +1,135 @@
+#!/bin/bash
+
+# Dyad Update Script v2 - Selective Update Approach
+# This script updates your forked Dyad app by backing up custom code,
+# resetting to upstream, then restoring custom code.
+
+set -e  # Exit on any error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Function to print colored output
+print_status() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+# Check if we're in a git repository
+if ! git rev-parse --git-head > /dev/null 2>&1; then
+    print_error "Not in a git repository. Please run this script from the project root."
+    exit 1
+fi
+
+print_status "Starting Dyad selective update process..."
+print_status "Current branch: $(git branch --show-current)"
+
+# Create a temporary backup directory
+BACKUP_DIR="dyad-backup-$(date +%Y%m%d-%H%M%S)"
+print_status "Creating backup in: $BACKUP_DIR"
+
+mkdir -p "$BACKUP_DIR"
+
+# Backup custom code structure
+print_status "Backing up your custom code..."
+
+# Backup the custom directory if it exists
+if [ -d "src/custom" ]; then
+    cp -r src/custom "$BACKUP_DIR/"
+    print_success "Backed up src/custom/"
+fi
+
+# Backup any other custom files you might have added
+# Add any additional files/directories you want to preserve here
+
+# Backup current state as a reference
+print_status "Creating reference backup..."
+git log --oneline -10 > "$BACKUP_DIR/commit-history.txt"
+git diff HEAD~1 > "$BACKUP_DIR/last-changes.diff" 2>/dev/null || true
+
+# Fetch latest changes from upstream
+print_status "Fetching latest changes from upstream..."
+if git fetch upstream; then
+    print_success "Successfully fetched changes from upstream."
+else
+    print_error "Failed to fetch from upstream. Check your internet connection."
+    exit 1
+fi
+
+# Get the upstream commit info
+UPSTREAM_COMMIT=$(git rev-parse upstream/main)
+print_status "Upstream commit: $UPSTREAM_COMMIT"
+
+# Reset to upstream
+print_status "Resetting to upstream/main..."
+if git reset --hard upstream/main; then
+    print_success "Successfully reset to upstream/main."
+else
+    print_error "Failed to reset to upstream/main."
+    exit 1
+fi
+
+# Restore custom code
+print_status "Restoring your custom code..."
+
+if [ -d "$BACKUP_DIR/custom" ]; then
+    cp -r "$BACKUP_DIR/custom" src/
+    print_success "Restored src/custom/"
+fi
+
+# Update package.json to include any custom dependencies if needed
+print_status "Checking for custom dependencies..."
+
+# Add custom files to git
+print_status "Adding custom files to git..."
+git add src/custom/ UPDATE_GUIDE.md update-dyad*.sh 2>/dev/null || true
+
+# Create a commit for the update
+print_status "Creating commit for the update..."
+git commit -m "feat: update to upstream $UPSTREAM_COMMIT and restore custom code
+
+- Updated to latest upstream version
+- Restored custom code in src/custom/
+- Preserved custom modifications
+
+Backup saved in: $BACKUP_DIR" || {
+    print_warning "No changes to commit (custom code already matches upstream)"
+}
+
+# Push to origin
+print_status "Pushing to your fork..."
+if git push origin main --force-with-lease; then
+    print_success "Successfully pushed to origin."
+else
+    print_warning "Push failed. Push manually with: git push origin main --force-with-lease"
+fi
+
+print_success "🎉 Update completed successfully!"
+print_status "Summary:"
+print_status "- Updated to latest upstream version"
+print_status "- Your custom code has been preserved in src/custom/"
+print_status "- Backup saved in: $BACKUP_DIR"
+print_status ""
+print_status "Next steps:"
+print_status "1. Test the application to ensure everything works"
+print_status "2. Run 'npm install' to update dependencies if needed"
+print_status "3. Check if any of your custom code needs updates for the new version"
+print_status ""
+print_status "If you need to restore from backup:"
+print_status "1. Copy files from $BACKUP_DIR back to your project"
+print_status "2. Commit and push the changes"