@phren/cli 0.0.10 → 0.0.11

package/mcp/dist/mcp-finding.js

@@ -236,7 +236,7 @@ export function register(server, ctx) {
                     extraAnnotationsByFinding.push(conflicts.checked && conflicts.annotations.length > 0 ? conflicts.annotations : []);
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                    if ((process.env.PHREN_DEBUG))
                         process.stderr.write(`[phren] add_findings semanticConflict: ${errorMessage(err)}\n`);
                     extraAnnotationsByFinding.push([]);
                 }
@@ -499,7 +499,7 @@ export function register(server, ctx) {
                     hasRemote = remotes.length > 0;
                 }
                 catch (err) {
-                    if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                    if ((process.env.PHREN_DEBUG))
                         process.stderr.write(`[phren] push_changes remoteCheck: ${errorMessage(err)}\n`);
                 }
                 if (!hasRemote) {
@@ -523,7 +523,7 @@ export function register(server, ctx) {
                                 runGit(["pull", "--rebase", "--quiet"], { timeout: 15000 });
                             }
                             catch (pullErr) {
-                                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                                if ((process.env.PHREN_DEBUG))
                                     process.stderr.write(`[phren] push_changes pullRebase: ${pullErr instanceof Error ? pullErr.message : String(pullErr)}\n`);
                                 const resolved = autoMergeConflicts(phrenPath);
                                 if (resolved) {
@@ -534,13 +534,13 @@ export function register(server, ctx) {
                                         });
                                     }
                                     catch (continueErr) {
-                                        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                                        if ((process.env.PHREN_DEBUG))
                                             process.stderr.write(`[phren] push_changes rebaseContinue: ${continueErr instanceof Error ? continueErr.message : String(continueErr)}\n`);
                                         try {
                                             runGit(["rebase", "--abort"]);
                                         }
                                         catch (abortErr) {
-                                            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                                            if ((process.env.PHREN_DEBUG))
                                                 process.stderr.write(`[phren] push_changes rebaseAbort: ${abortErr instanceof Error ? abortErr.message : String(abortErr)}\n`);
                                         }
                                         break;
@@ -551,7 +551,7 @@ export function register(server, ctx) {
                                         runGit(["rebase", "--abort"]);
                                     }
                                     catch (abortErr) {
-                                        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                                        if ((process.env.PHREN_DEBUG))
                                             process.stderr.write(`[phren] push_changes rebaseAbort2: ${abortErr instanceof Error ? abortErr.message : String(abortErr)}\n`);
                                     }
                                     break;

package/mcp/dist/mcp-graph.js

@@ -2,7 +2,7 @@ import { mcpResponse } from "./mcp-types.js";
 import { z } from "zod";
 import * as fs from "fs";
 import * as crypto from "crypto";
-import { isValidProjectName } from "./utils.js";
+import { isValidProjectName, errorMessage } from "./utils.js";
 import { queryDocBySourceKey, queryRows, queryFragmentLinks, queryCrossProjectFragments, ensureGlobalEntitiesTable, logFragmentMiss } from "./shared-index.js";
 import { runtimeFile } from "./shared.js";
 import { withFileLock } from "./shared-governance.js";
@@ -209,8 +209,8 @@ export function register(server, ctx) {
                 db.run("INSERT OR IGNORE INTO entities (name, type, first_seen_at) VALUES (?, ?, ?)", [fragmentName, resolvedFragmentType, new Date().toISOString().slice(0, 10)]);
             }
             catch (err) {
-                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] link_findings fragmentInsert: ${err instanceof Error ? err.message : String(err)}\n`);
+                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] link_findings fragmentInsert: ${errorMessage(err)}\n`);
             }
             const fragmentResult = db.exec("SELECT id FROM entities WHERE name = ? AND type = ?", [fragmentName, resolvedFragmentType]);
             if (!fragmentResult?.length || !fragmentResult[0]?.values?.length) {
@@ -232,8 +232,8 @@ export function register(server, ctx) {
                 db.run("INSERT OR IGNORE INTO entities (name, type, first_seen_at) VALUES (?, ?, ?)", [sourceDoc, "document", new Date().toISOString().slice(0, 10)]);
             }
             catch (err) {
-                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] link_findings docFragmentInsert: ${err instanceof Error ? err.message : String(err)}\n`);
+                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] link_findings docFragmentInsert: ${errorMessage(err)}\n`);
             }
             const docFragmentResult = db.exec("SELECT id FROM entities WHERE name = ? AND type = ?", [sourceDoc, "document"]);
             if (!docFragmentResult?.length || !docFragmentResult[0]?.values?.length) {
@@ -245,8 +245,8 @@ export function register(server, ctx) {
                 db.run("INSERT OR IGNORE INTO entity_links (source_id, target_id, rel_type, source_doc) VALUES (?, ?, ?, ?)", [sourceId, targetId, relType, sourceDoc]);
             }
             catch (err) {
-                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] link_findings linkInsert: ${err instanceof Error ? err.message : String(err)}\n`);
+                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] link_findings linkInsert: ${errorMessage(err)}\n`);
                 return mcpResponse({ ok: false, error: "Failed to insert fragment link." });
             }
             // 4a. Also populate global_entities so manual links appear in cross_project_fragments
@@ -255,8 +255,8 @@ export function register(server, ctx) {
                 db.run("INSERT OR IGNORE INTO global_entities (entity, project, doc_key) VALUES (?, ?, ?)", [fragmentName, project, sourceDoc]);
             }
             catch (err) {
-                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] link_findings globalFragments: ${err instanceof Error ? err.message : String(err)}\n`);
+                if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] link_findings globalFragments: ${errorMessage(err)}\n`);
             }
             // 4b. Persist manual link so it survives index rebuilds (mandatory — failure aborts the operation)
             const manualLinksPath = runtimeFile(ctx.phrenPath, "manual-links.json");
@@ -268,8 +268,8 @@ export function register(server, ctx) {
                             existing = JSON.parse(fs.readFileSync(manualLinksPath, "utf8"));
                         }
                         catch (err) {
-                            if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                process.stderr.write(`[phren] link_findings manualLinksRead: ${err instanceof Error ? err.message : String(err)}\n`);
+                            if (process.env.PHREN_DEBUG || (process.env.PHREN_DEBUG))
+                                process.stderr.write(`[phren] link_findings manualLinksRead: ${errorMessage(err)}\n`);
                         }
                     }
                     const newEntry = { entity: fragmentName, entityType: resolvedFragmentType, sourceDoc, relType };

package/mcp/dist/mcp-ops.js

@@ -4,7 +4,7 @@ import * as fs from "fs";
 import * as path from "path";
 import { runtimeFile, getProjectDirs } from "./shared.js";
 import { findFtsCacheForPath } from "./shared-index.js";
-import { isValidProjectName } from "./utils.js";
+import { isValidProjectName, errorMessage } from "./utils.js";
 import { readReviewQueue, readReviewQueueAcrossProjects } from "./data-access.js";
 import { addProjectFromPath } from "./core-project.js";
 import { PROJECT_OWNERSHIP_MODES, parseProjectOwnershipMode } from "./project-config.js";
@@ -44,7 +44,7 @@ export function register(server, ctx) {
             catch (err) {
                 return mcpResponse({
                     ok: false,
-                    error: err instanceof Error ? err.message : String(err),
+                    error: errorMessage(err),
                 });
             }
         });
@@ -108,8 +108,8 @@ export function register(server, ctx) {
             version = pkg.version || "unknown";
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] healthCheck version: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] healthCheck version: ${errorMessage(err)}\n`);
         }
         // FTS index (lives in /tmpphren-fts-*/, not .runtime/)
         let indexStatus = { exists: false };
@@ -117,8 +117,8 @@ export function register(server, ctx) {
             indexStatus = findFtsCacheForPath(phrenPath, activeProfile);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] healthCheck ftsCacheCheck: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] healthCheck ftsCacheCheck: ${errorMessage(err)}\n`);
         }
         // Hook registration
         let hooksEnabled = false;
@@ -127,8 +127,8 @@ export function register(server, ctx) {
             hooksEnabled = getHooksEnabledPreference(phrenPath);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] healthCheck hooksEnabled: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] healthCheck hooksEnabled: ${errorMessage(err)}\n`);
         }
         let mcpEnabled = false;
         try {
@@ -136,8 +136,8 @@ export function register(server, ctx) {
             mcpEnabled = getMcpEnabledPreference(phrenPath);
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] healthCheck mcpEnabled: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] healthCheck mcpEnabled: ${errorMessage(err)}\n`);
         }
         // Profile/machine info
         const machineName = (() => {
@@ -145,8 +145,8 @@ export function register(server, ctx) {
                 return getMachineName();
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] healthCheck machineName: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] healthCheck machineName: ${errorMessage(err)}\n`);
             }
             return undefined;
         })();
@@ -160,8 +160,8 @@ export function register(server, ctx) {
             taskMode = workflowPolicy.taskMode;
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] healthCheck taskMode: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] healthCheck taskMode: ${errorMessage(err)}\n`);
         }
         try {
             const { readInstallPreferences } = await import("./init-preferences.js");
@@ -169,8 +169,8 @@ export function register(server, ctx) {
             proactivity = prefs.proactivity || "high";
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                process.stderr.write(`[phren] healthCheck proactivity: ${err instanceof Error ? err.message : String(err)}\n`);
+            if ((process.env.PHREN_DEBUG))
+                process.stderr.write(`[phren] healthCheck proactivity: ${errorMessage(err)}\n`);
         }
         const lines = [
             `Phren v${version}`,
@@ -262,8 +262,8 @@ export function register(server, ctx) {
                 return lines.filter(line => ERROR_PATTERNS.some(p => p.test(line)));
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] readErrorLines: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] readErrorLines: ${errorMessage(err)}\n`);
                 return [];
             }
         }

package/mcp/dist/mcp-search.js

@@ -35,8 +35,8 @@ export function logSearchMiss(phrenPath, query, project) {
         fs.appendFileSync(missFile, entry + "\n");
     }
     catch (err) {
-        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-            process.stderr.write(`[phren] logSearchMiss: ${err instanceof Error ? err.message : String(err)}\n`);
+        if ((process.env.PHREN_DEBUG))
+            process.stderr.write(`[phren] logSearchMiss: ${errorMessage(err)}\n`);
     }
 }
 const HISTORY_FINDING_STATUSES = new Set(["superseded", "retracted"]);
@@ -160,7 +160,7 @@ export function register(server, ctx) {
             createdAt = stat.birthtime.toISOString();
         }
         catch (err) {
-            if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+            if ((process.env.PHREN_DEBUG))
                 process.stderr.write(`[phren] search_knowledge statFile: ${errorMessage(err)}\n`);
         }
         // Extract tags from content (e.g. [decision], [pitfall], [pattern])
@@ -393,8 +393,8 @@ export function register(server, ctx) {
                 relatedFragments = [...new Set(relatedFragments)].slice(0, 10);
             }
             catch (err) {
-                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                    process.stderr.write(`[phren] fragment query: ${err instanceof Error ? err.message : String(err)}\n`);
+                if ((process.env.PHREN_DEBUG))
+                    process.stderr.write(`[phren] fragment query: ${errorMessage(err)}\n`);
             }
             const formatted = results.map((r) => `### ${r.project}/${r.filename} (${r.type})\n${r.snippet}\n\n\`${r.path}\``);
             // Memory synthesis: generate a concise paragraph from top results when requested
@@ -408,7 +408,7 @@ export function register(server, ctx) {
                         synthCache = JSON.parse(fs.readFileSync(synthCachePath, "utf8"));
                     }
                     catch (err) {
-                        if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
+                        if ((process.env.PHREN_DEBUG))
                             process.stderr.write(`[phren] search_knowledge synthCacheRead: ${errorMessage(err)}\n`);
                     }
                     const cached = synthCache[synthKey];
@@ -433,8 +433,8 @@ export function register(server, ctx) {
                                 fs.writeFileSync(synthCachePath, JSON.stringify(synthCache));
                             }
                             catch (err) {
-                                if ((process.env.PHREN_DEBUG || process.env.PHREN_DEBUG))
-                                    process.stderr.write(`[phren] synthCache write: ${err instanceof Error ? err.message : String(err)}\n`);
+                                if ((process.env.PHREN_DEBUG))
+                                    process.stderr.write(`[phren] synthCache write: ${errorMessage(err)}\n`);
                             }
                         }
                     }

package/mcp/dist/memory-ui-page.js

@@ -267,6 +267,17 @@ ${TASK_UI_STYLES}
   <div id="tab-settings" class="tab-content">
     <div class="settings-shell">
       <div id="settings-status-inline" class="settings-status-inline" aria-live="polite"></div>
+      <section class="settings-section" style="border-top:3px solid color-mix(in srgb, var(--cyan) 45%, var(--border))">
+        <div class="settings-section-header" style="display:flex;align-items:center;justify-content:space-between;gap:16px">
+          <span>Scope</span>
+          <select id="settings-project-select" style="border:1px solid var(--border);border-radius:var(--radius-sm);padding:6px 10px;background:var(--surface);color:var(--ink);font-size:var(--text-sm);font-family:var(--font)">
+            <option value="">Global (all projects)</option>
+          </select>
+        </div>
+        <div class="settings-section-body" style="padding:12px 18px">
+          <div id="settings-scope-note" style="font-size:var(--text-sm);color:var(--muted)">Showing global settings. Select a project to view and edit per-project overrides.</div>
+        </div>
+      </section>
       <section class="settings-section settings-section-findings">
         <div class="settings-section-header">Findings</div>
         <div class="settings-section-body">
@@ -279,6 +290,18 @@ ${TASK_UI_STYLES}
           <div id="settings-behavior" style="color:var(--muted)">Loading...</div>
         </div>
       </section>
+      <section class="settings-section" style="border-top:3px solid color-mix(in srgb, var(--warning) 45%, var(--border))">
+        <div class="settings-section-header">Retention Policy</div>
+        <div class="settings-section-body">
+          <div id="settings-retention" style="color:var(--muted)">Loading...</div>
+        </div>
+      </section>
+      <section class="settings-section" style="border-top:3px solid color-mix(in srgb, var(--success) 45%, var(--border))">
+        <div class="settings-section-header">Workflow Policy</div>
+        <div class="settings-section-body">
+          <div id="settings-workflow" style="color:var(--muted)">Loading...</div>
+        </div>
+      </section>
       <section class="settings-section settings-section-integrations">
         <div class="settings-section-header">Integrations</div>
         <div class="settings-section-body">

package/mcp/dist/memory-ui-scripts.js

@@ -839,14 +839,95 @@ export function renderTasksAndSettingsScript(authToken) {
       });
     }
 
+    function getSettingsProject() {
+      var sel = document.getElementById('settings-project-select');
+      return sel ? sel.value : '';
+    }
+
+    function postProjectOverride(project, field, value, clearField) {
+      var csrfUrl = _tsAuthToken ? tsAuthUrl('/api/csrf-token') : '/api/csrf-token';
+      fetch(csrfUrl).then(function(r) { return r.json(); }).then(function(csrfData) {
+        var payload = { project: project, field: field, value: value || '', clear: clearField ? 'true' : 'false' };
+        var body = new URLSearchParams(payload);
+        if (csrfData.token) body.set('_csrf', csrfData.token);
+        var url = _tsAuthToken ? tsAuthUrl('/api/settings/project-overrides') : '/api/settings/project-overrides';
+        return fetch(url, { method: 'POST', body: body, headers: { 'content-type': 'application/x-www-form-urlencoded' } });
+      }).then(function(r) { return r.json(); }).then(function(data) {
+        if (!data.ok) {
+          setSettingsStatus(data.error || 'Failed to update project override', 'err');
+          return;
+        }
+        _settingsLoaded = false;
+        loadSettings();
+        setSettingsStatus('Project override updated', 'ok');
+      }).catch(function(err) {
+        setSettingsStatus('Failed: ' + String(err), 'err');
+      });
+    }
+
     function loadSettings() {
-      var url = _tsAuthToken ? tsAuthUrl('/api/settings') : '/api/settings';
+      var selectedProject = getSettingsProject();
+      var baseUrl = '/api/settings';
+      if (selectedProject) baseUrl += '?project=' + encodeURIComponent(selectedProject);
+      var url = _tsAuthToken ? tsAuthUrl(baseUrl) : baseUrl;
+
+      // Populate project selector on first load
+      var sel = document.getElementById('settings-project-select');
+      if (sel && sel.querySelectorAll('option[data-proj]').length === 0) {
+        var configUrl = _tsAuthToken ? tsAuthUrl('/api/config') : '/api/config';
+        fetch(configUrl).then(function(r) { return r.json(); }).then(function(d) {
+          if (d.ok && d.projects && d.projects.length && sel) {
+            d.projects.forEach(function(p) {
+              var opt = document.createElement('option');
+              opt.value = p; opt.textContent = p;
+              opt.setAttribute('data-proj', '1');
+              sel.appendChild(opt);
+            });
+            if (selectedProject) sel.value = selectedProject;
+          }
+        }).catch(function() {});
+      }
+
+      var scopeNote = document.getElementById('settings-scope-note');
+      if (scopeNote) {
+        scopeNote.textContent = selectedProject
+          ? 'Showing effective config for "' + selectedProject + '". Overrides are saved to that project\'s phren.project.yaml.'
+          : 'Showing global settings. Select a project to view and edit per-project overrides.';
+      }
+
+      // Wire onChange once
+      if (sel && !sel.getAttribute('data-onchange-wired')) {
+        sel.setAttribute('data-onchange-wired', '1');
+        sel.addEventListener('change', function() {
+          _settingsLoaded = false;
+          loadSettings();
+        });
+      }
+
       fetch(url).then(function(r) { return r.json(); }).then(function(data) {
         if (!data.ok) {
           setSettingsStatus(data.error || 'Failed to load settings', 'err');
           return;
         }
 
+        // Use merged config when a project is selected, else global
+        var effective = (selectedProject && data.merged) ? data.merged : null;
+        var rawOverrides = (selectedProject && data.overrides) ? data.overrides : null;
+        var effectiveSensitivity = effective ? effective.findingSensitivity : (data.findingSensitivity || 'balanced');
+        var effectiveTaskMode = effective ? effective.taskMode : (data.taskMode || 'auto');
+        var effectiveProactivity = data.proactivity || 'high';
+        var effectiveRetention = (effective && effective.retentionPolicy) ? effective.retentionPolicy : (data.retentionPolicy || {});
+        var effectiveWorkflow = (effective && effective.workflowPolicy) ? effective.workflowPolicy : (data.workflowPolicy || {});
+
+        var isProject = Boolean(selectedProject);
+
+        function sourceBadge(isOverride) {
+          if (!isProject) return '';
+          return isOverride
+            ? '<span style="font-size:10px;font-weight:600;color:var(--warning);margin-left:6px;padding:1px 6px;border:1px solid color-mix(in srgb,var(--warning) 40%,transparent);border-radius:var(--radius-sm)">project override</span>'
+            : '<span style="font-size:10px;color:var(--text-muted);margin-left:6px;padding:1px 6px;border:1px solid var(--border);border-radius:var(--radius-sm)">global default</span>';
+        }
+
         var findingDescriptions = {
           high: 'Capture findings proactively, including minor observations.',
           medium: 'Capture findings that are likely useful.',
@@ -856,56 +937,129 @@ export function renderTasksAndSettingsScript(authToken) {
 
         var findingsEl = document.getElementById('settings-findings');
         if (findingsEl) {
-          var fsUi = findingStorageToUi(data.findingSensitivity || 'balanced');
+          var fsUi = findingStorageToUi(effectiveSensitivity);
           var findingsHtml = '';
+          var fsSensOverride = rawOverrides && rawOverrides.findingSensitivity != null;
           findingsHtml += '<div class="settings-control">';
-          findingsHtml += '<div class="settings-control-header"><span class="settings-control-label">Finding sensitivity</span></div>';
+          findingsHtml += '<div class="settings-control-header"><span class="settings-control-label">Finding sensitivity</span>' + sourceBadge(fsSensOverride);
+          if (isProject && fsSensOverride) {
+            findingsHtml += '<button data-ts-action="clearProjectOverride" data-field="findingSensitivity" class="settings-chip" style="font-size:11px;margin-left:auto">Clear override</button>';
+          }
+          findingsHtml += '</div>';
           findingsHtml += '<div class="settings-chip-row">';
           ['high', 'medium', 'low', 'minimal'].forEach(function(level) {
             var active = level === fsUi ? ' active' : '';
-            findingsHtml += '<button data-ts-action="setFindingSensitivity" data-level="' + esc(level) + '" class="settings-chip' + active + '">' + esc(level) + '</button>';
+            var action = isProject ? 'setProjectFindingSensitivity' : 'setFindingSensitivity';
+            findingsHtml += '<button data-ts-action="' + action + '" data-level="' + esc(level) + '" class="settings-chip' + active + '">' + esc(level) + '</button>';
           });
           findingsHtml += '</div>';
           findingsHtml += '<div class="settings-control-note" id="settings-fs-desc">' + esc(findingDescriptions[fsUi] || '') + '</div>';
           findingsHtml += '</div>';
-          findingsHtml += '<div class="settings-control">';
-          findingsHtml += '<div class="settings-control-header"><span class="settings-control-label">Auto-capture</span>';
-          findingsHtml += '<button data-ts-action="toggleAutoCapture" data-enabled="' + (data.autoCaptureEnabled ? 'true' : 'false') + '" class="settings-chip' + (data.autoCaptureEnabled ? ' active' : '') + '">' + (data.autoCaptureEnabled ? 'On' : 'Off') + '</button></div>';
-          findingsHtml += '<div class="settings-control-note">Turn automatic finding capture on or off.</div>';
-          findingsHtml += '</div>';
-          findingsHtml += '<div class="settings-control">';
-          findingsHtml += '<div class="settings-control-header"><span class="settings-control-label">Consolidation threshold</span><span class="badge">' + esc(String(data.consolidationEntryThreshold || 25)) + ' entries</span></div>';
-          findingsHtml += '<div class="settings-control-note">Consolidation is also recommended after 60+ days with at least 10 new entries.</div>';
-          findingsHtml += '</div>';
+          if (!isProject) {
+            findingsHtml += '<div class="settings-control">';
+            findingsHtml += '<div class="settings-control-header"><span class="settings-control-label">Auto-capture</span>';
+            findingsHtml += '<button data-ts-action="toggleAutoCapture" data-enabled="' + (data.autoCaptureEnabled ? 'true' : 'false') + '" class="settings-chip' + (data.autoCaptureEnabled ? ' active' : '') + '">' + (data.autoCaptureEnabled ? 'On' : 'Off') + '</button></div>';
+            findingsHtml += '<div class="settings-control-note">Turn automatic finding capture on or off.</div>';
+            findingsHtml += '</div>';
+            findingsHtml += '<div class="settings-control">';
+            findingsHtml += '<div class="settings-control-header"><span class="settings-control-label">Consolidation threshold</span><span class="badge">' + esc(String(data.consolidationEntryThreshold || 25)) + ' entries</span></div>';
+            findingsHtml += '<div class="settings-control-note">Consolidation is also recommended after 60+ days with at least 10 new entries.</div>';
+            findingsHtml += '</div>';
+          }
           findingsEl.innerHTML = findingsHtml;
         }
 
         var behaviorEl = document.getElementById('settings-behavior');
         if (behaviorEl) {
-          var taskMode = data.taskMode === 'suggest' ? 'manual' : (data.taskMode || 'auto');
-          var proactivity = data.proactivity || 'high';
+          var taskMode = effectiveTaskMode || 'auto';
+          var proactivity = effectiveProactivity;
           var behaviorHtml = '';
+          var taskModeOverride = rawOverrides && rawOverrides.taskMode != null;
           behaviorHtml += '<div class="settings-control">';
-          behaviorHtml += '<div class="settings-control-header"><span class="settings-control-label">Task mode</span></div>';
+          behaviorHtml += '<div class="settings-control-header"><span class="settings-control-label">Task mode</span>' + sourceBadge(taskModeOverride);
+          if (isProject && taskModeOverride) {
+            behaviorHtml += '<button data-ts-action="clearProjectOverride" data-field="taskMode" class="settings-chip" style="font-size:11px;margin-left:auto">Clear override</button>';
+          }
+          behaviorHtml += '</div>';
           behaviorHtml += '<div class="settings-chip-row">';
-          ['auto', 'manual', 'off'].forEach(function(mode) {
+          ['auto', 'suggest', 'manual', 'off'].forEach(function(mode) {
             var active = mode === taskMode ? ' active' : '';
-            behaviorHtml += '<button data-ts-action="setTaskMode" data-mode="' + esc(mode) + '" class="settings-chip' + active + '">' + esc(mode) + '</button>';
-          });
-          behaviorHtml += '</div></div>';
-          behaviorHtml += '<div class="settings-control">';
-          behaviorHtml += '<div class="settings-control-header"><span class="settings-control-label">Proactivity level</span></div>';
-          behaviorHtml += '<div class="settings-chip-row">';
-          ['high', 'medium', 'low'].forEach(function(level) {
-            var active = level === proactivity ? ' active' : '';
-            behaviorHtml += '<button data-ts-action="setProactivity" data-level="' + esc(level) + '" class="settings-chip' + active + '">' + esc(level) + '</button>';
+            var action = isProject ? 'setProjectTaskMode' : 'setTaskMode';
+            behaviorHtml += '<button data-ts-action="' + action + '" data-mode="' + esc(mode) + '" class="settings-chip' + active + '">' + esc(mode) + '</button>';
           });
           behaviorHtml += '</div></div>';
+          if (!isProject) {
+            behaviorHtml += '<div class="settings-control">';
+            behaviorHtml += '<div class="settings-control-header"><span class="settings-control-label">Proactivity level</span></div>';
+            behaviorHtml += '<div class="settings-chip-row">';
+            ['high', 'medium', 'low'].forEach(function(level) {
+              var active = level === proactivity ? ' active' : '';
+              behaviorHtml += '<button data-ts-action="setProactivity" data-level="' + esc(level) + '" class="settings-chip' + active + '">' + esc(level) + '</button>';
+            });
+            behaviorHtml += '</div></div>';
+          }
           behaviorEl.innerHTML = behaviorHtml;
         }
 
+        var retentionEl = document.getElementById('settings-retention');
+        if (retentionEl) {
+          var ret = effectiveRetention;
+          var retHtml = '';
+          function retRow(label, field, value, note) {
+            var isOverride = isProject && rawOverrides && rawOverrides.retentionPolicy && rawOverrides.retentionPolicy[field] !== undefined;
+            retHtml += '<div class="settings-control">';
+            retHtml += '<div class="settings-control-header"><span class="settings-control-label">' + esc(label) + '</span>' + sourceBadge(isOverride);
+            retHtml += '<span class="settings-control-value" style="margin-left:auto">' + esc(String(value != null ? value : '—')) + '</span>';
+            if (isProject && isOverride) {
+              retHtml += '<button data-ts-action="clearProjectOverride" data-field="' + esc(field) + '" class="settings-chip" style="font-size:11px">Clear</button>';
+            }
+            retHtml += '</div>';
+            if (note) retHtml += '<div class="settings-control-note">' + esc(note) + '</div>';
+            if (isProject) {
+              retHtml += '<div style="display:flex;gap:8px;align-items:center;margin-top:8px">' +
+                '<input type="number" id="ret-input-' + esc(field) + '" value="' + esc(String(value != null ? value : '')) + '" style="width:100px;border:1px solid var(--border);border-radius:var(--radius-sm);padding:4px 8px;font-size:var(--text-sm);background:var(--surface);color:var(--ink)">' +
+                '<button data-ts-action="setProjectRetention" data-field="' + esc(field) + '" class="settings-chip active" style="font-size:11px">Set</button>' +
+                '</div>';
+            }
+            retHtml += '</div>';
+          }
+          retRow('TTL days', 'ttlDays', ret.ttlDays, 'Memories older than this are eligible for pruning.');
+          retRow('Retention days', 'retentionDays', ret.retentionDays, 'Hard cutoff — memories past this age are removed.');
+          retRow('Auto-accept threshold', 'autoAcceptThreshold', ret.autoAcceptThreshold, 'Confidence score (0–1) above which memories are auto-accepted.');
+          retRow('Min inject confidence', 'minInjectConfidence', ret.minInjectConfidence, 'Minimum confidence score to inject a memory into context.');
+          retentionEl.innerHTML = retHtml;
+        }
+
+        var workflowEl = document.getElementById('settings-workflow');
+        if (workflowEl) {
+          var wf = effectiveWorkflow;
+          var wfHtml = '';
+          var lctOverride = isProject && rawOverrides && rawOverrides.workflowPolicy && rawOverrides.workflowPolicy.lowConfidenceThreshold !== undefined;
+          var riskySectionsOverride = isProject && rawOverrides && rawOverrides.workflowPolicy && Array.isArray(rawOverrides.workflowPolicy.riskySections) && rawOverrides.workflowPolicy.riskySections.length > 0;
+          wfHtml += '<div class="settings-control">';
+          wfHtml += '<div class="settings-control-header"><span class="settings-control-label">Low confidence threshold</span>' + sourceBadge(lctOverride);
+          wfHtml += '<span class="settings-control-value" style="margin-left:auto">' + esc(String(wf.lowConfidenceThreshold != null ? wf.lowConfidenceThreshold : '—')) + '</span>';
+          if (isProject && lctOverride) {
+            wfHtml += '<button data-ts-action="clearProjectOverride" data-field="lowConfidenceThreshold" class="settings-chip" style="font-size:11px">Clear</button>';
+          }
+          if (isProject) {
+            wfHtml += '</div><div style="display:flex;gap:8px;align-items:center;margin-top:8px">' +
+              '<input type="number" id="wf-input-lowConfidenceThreshold" min="0" max="1" step="0.05" value="' + esc(String(wf.lowConfidenceThreshold != null ? wf.lowConfidenceThreshold : '')) + '" style="width:100px;border:1px solid var(--border);border-radius:var(--radius-sm);padding:4px 8px;font-size:var(--text-sm);background:var(--surface);color:var(--ink)">' +
+              '<button data-ts-action="setProjectWorkflow" data-field="lowConfidenceThreshold" class="settings-chip active" style="font-size:11px">Set</button>' +
+              '</div>';
+          } else {
+            wfHtml += '</div>';
+          }
+          wfHtml += '<div class="settings-control-note">Memories below this confidence score are flagged for review.</div></div>';
+          wfHtml += '<div class="settings-control">';
+          wfHtml += '<div class="settings-control-header"><span class="settings-control-label">Risky sections</span>' + sourceBadge(riskySectionsOverride);
+          wfHtml += '<span class="settings-control-value" style="margin-left:auto">' + esc(Array.isArray(wf.riskySections) ? wf.riskySections.join(', ') : '—') + '</span></div>';
+          wfHtml += '<div class="settings-control-note">Sections that trigger approval gates when memories are written.</div></div>';
+          workflowEl.innerHTML = wfHtml;
+        }
+
         var integrationsEl = document.getElementById('settings-integrations');
-        if (integrationsEl) {
+        if (integrationsEl && !isProject) {
           var tools = Array.isArray(data.hookTools) ? data.hookTools : [];
           var html = '';
           html += '<div class="settings-control-header" style="margin-bottom:10px"><span class="settings-control-label">Global MCP</span>';
@@ -923,6 +1077,8 @@ export function renderTasksAndSettingsScript(authToken) {
           });
           html += '</tbody></table>';
           integrationsEl.innerHTML = html;
+        } else if (integrationsEl && isProject) {
+          integrationsEl.innerHTML = '<div style="color:var(--muted);font-size:var(--text-sm)">Integration settings are global — switch to Global scope to edit them.</div>';
         }
       }).catch(function(err) {
         setSettingsStatus('Failed to load settings: ' + String(err), 'err');
@@ -1063,6 +1219,33 @@ export function renderTasksAndSettingsScript(authToken) {
       else if (action === 'toggleIntegrationTool') { toggleIntegrationTool(actionEl.getAttribute('data-tool')); }
       else if (action === 'showSessionDetail') { showSessionDetail(actionEl.getAttribute('data-session-id')); }
       else if (action === 'backToSessionsList') { backToSessionsList(); }
+      else if (action === 'setProjectFindingSensitivity') {
+        var proj = getSettingsProject();
+        var level = actionEl.getAttribute('data-level');
+        postProjectOverride(proj, 'findingSensitivity', findingUiToStorage(level || 'medium'), false);
+      }
+      else if (action === 'setProjectTaskMode') {
+        var proj = getSettingsProject();
+        postProjectOverride(proj, 'taskMode', actionEl.getAttribute('data-mode') || 'auto', false);
+      }
+      else if (action === 'clearProjectOverride') {
+        var proj = getSettingsProject();
+        postProjectOverride(proj, actionEl.getAttribute('data-field') || '', '', true);
+      }
+      else if (action === 'setProjectRetention') {
+        var proj = getSettingsProject();
+        var field = actionEl.getAttribute('data-field') || '';
+        var inputEl = document.getElementById('ret-input-' + field);
+        var val = inputEl ? inputEl.value : '';
+        postProjectOverride(proj, field, val, false);
+      }
+      else if (action === 'setProjectWorkflow') {
+        var proj = getSettingsProject();
+        var field = actionEl.getAttribute('data-field') || '';
+        var inputEl = document.getElementById('wf-input-' + field);
+        var val = inputEl ? inputEl.value : '';
+        postProjectOverride(proj, field, val, false);
+      }
     });
 
     window.setFindingSensitivity = function(level) {