hammoc 1.5.0 → 1.7.0

package/packages/server/dist/services/marketplaceService.js

@@ -0,0 +1,326 @@
+/**
+ * Story 31.4: Plugin marketplace catalog service (read-only).
+ *
+ * Surfaces the *full* `plugins[]` catalog from each registered marketplace —
+ * the entries Story 28.1 `harnessPluginService.listCards` deliberately discards
+ * (it keeps only installed cards). Builds a unified catalog by reading:
+ *   - `plugins/known_marketplaces.json`           → registered market names
+ *   - `plugins/marketplaces/<name>/.claude-plugin/marketplace.json` → plugins[]
+ *   - `plugins/installed_plugins.json`            → installed flag join (AC1.d)
+ *
+ * Design constraints (Story 31.4):
+ *   - 28.1 `harnessPluginService` is NOT modified — this is a separate
+ *     read-only service so the stable toggle/list path cannot regress.
+ *   - Per-market parse failures are isolated into `errors[]` instead of
+ *     aborting the whole catalog (AC5) — unlike 28.1 which re-throws.
+ *   - Plugin type is decided by the `source` path prefix (AC1.c), not by
+ *     component counts, because unbuilt catalog entries have no installPath.
+ *   - Component counts are reimplemented here (not extracted from 28.1) so the
+ *     stable service is untouched and because the input is a *market repo
+ *     source dir*, not an installPath. De-dup is an optional later cleanup.
+ *   - All catalog file reads go through `harnessService.read` (traversal
+ *     guard). Only the market repo source-dir enumeration uses direct `fs`,
+ *     and refuses any path outside `~/.claude`.
+ */
+import path from 'path';
+import fs from 'fs/promises';
+import { HARNESS_ERRORS, } from '@hammoc/shared';
+import { harnessService } from './harnessService.js';
+import { projectService } from './projectService.js';
+import { getUserHarnessRoot } from '../utils/harnessPaths.js';
+/** installed_plugins.json `version` values this service understands (AC6). */
+const KNOWN_INSTALLED_VERSIONS = new Set([1, 2]);
+// --- helpers ---------------------------------------------------------------
+function isFileNotFound(err) {
+    return err?.code === HARNESS_ERRORS.HARNESS_FILE_NOT_FOUND.code;
+}
+/**
+ * AC1.c: type from `source` path prefix. `./external_plugins/...` → external
+ * MCP wrapper; everything else (`./plugins/...`) → standard.
+ */
+function decideTypeFromSource(source) {
+    const s = (source ?? '').replace(/^\.\//, '');
+    return s.startsWith('external_plugins/') ? 'external-mcp' : 'standard';
+}
+function samePath(a, b) {
+    const na = path.resolve(a);
+    const nb = path.resolve(b);
+    return process.platform === 'win32' ? na.toLowerCase() === nb.toLowerCase() : na === nb;
+}
+function isLikelyMcpServerEntry(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const rec = value;
+    return (typeof rec.command === 'string'
+        || typeof rec.url === 'string'
+        || typeof rec.type === 'string'
+        || typeof rec.transport === 'string');
+}
+// Component counters — reimplemented from 28.1 `countComponents` + 4 helpers.
+// Kept private to this module (not shared util) per Story 31.4 A.1 rationale.
+async function countSkillsDir(dir) {
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        let n = 0;
+        for (const ent of entries) {
+            if (!ent.isDirectory())
+                continue;
+            try {
+                await fs.access(path.join(dir, ent.name, 'SKILL.md'));
+                n += 1;
+            }
+            catch {
+                // no SKILL.md → skip
+            }
+        }
+        return n;
+    }
+    catch {
+        return 0;
+    }
+}
+async function countMarkdownFiles(dir) {
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        let n = 0;
+        for (const ent of entries) {
+            if (ent.isFile() && ent.name.toLowerCase().endsWith('.md'))
+                n += 1;
+        }
+        return n;
+    }
+    catch {
+        return 0;
+    }
+}
+async function countHooksJson(file) {
+    try {
+        const content = await fs.readFile(file, 'utf-8');
+        const parsed = JSON.parse(content);
+        const hooks = parsed?.hooks;
+        if (!hooks || typeof hooks !== 'object')
+            return 0;
+        return Object.values(hooks)
+            .filter(Array.isArray)
+            .reduce((sum, arr) => sum + arr.length, 0);
+    }
+    catch {
+        return 0;
+    }
+}
+async function countMcpServers(file) {
+    try {
+        const content = await fs.readFile(file, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== 'object')
+            return 0;
+        const wrapper = parsed.mcpServers;
+        if (wrapper && typeof wrapper === 'object' && !Array.isArray(wrapper)) {
+            return Object.keys(wrapper).length;
+        }
+        let n = 0;
+        for (const value of Object.values(parsed)) {
+            if (isLikelyMcpServerEntry(value))
+                n += 1;
+        }
+        return n;
+    }
+    catch {
+        return 0;
+    }
+}
+class MarketplaceService {
+    /**
+     * Build the unified catalog. Never throws on per-market or installed-file
+     * problems — they degrade into `errors[]` / `formatWarning` (AC5/AC6).
+     */
+    async listCatalog(currentProjectSlug) {
+        const currentProjectPath = await this.resolveCurrentProjectPath(currentProjectSlug);
+        const userRoot = path.resolve(getUserHarnessRoot());
+        // Step 1: known_marketplaces.json (absent or malformed → empty catalog).
+        let known = {};
+        try {
+            const res = await harnessService.read({
+                scope: 'user',
+                relativePath: 'plugins/known_marketplaces.json',
+            });
+            known = this.safeParse(res.content ?? '', {});
+        }
+        catch (err) {
+            if (!isFileNotFound(err))
+                throw err;
+            return { marketplaces: [], entries: [], errors: [] };
+        }
+        const marketplaces = Object.keys(known).filter((k) => k && typeof k === 'string');
+        // Step 2+3: per-market marketplace.json → catalog entries; isolate failures.
+        const entries = [];
+        const errors = [];
+        for (const marketName of marketplaces) {
+            let raw;
+            try {
+                const res = await harnessService.read({
+                    scope: 'user',
+                    relativePath: `plugins/marketplaces/${marketName}/.claude-plugin/marketplace.json`,
+                });
+                raw = res.content ?? '';
+            }
+            catch (err) {
+                errors.push({
+                    marketplace: marketName,
+                    code: isFileNotFound(err)
+                        ? HARNESS_ERRORS.HARNESS_FILE_NOT_FOUND.code
+                        : HARNESS_ERRORS.HARNESS_PARSE_ERROR.code,
+                });
+                continue;
+            }
+            let meta;
+            try {
+                meta = JSON.parse(raw);
+            }
+            catch {
+                errors.push({ marketplace: marketName, code: HARNESS_ERRORS.HARNESS_PARSE_ERROR.code });
+                continue;
+            }
+            for (const plugin of meta.plugins ?? []) {
+                if (!plugin?.name)
+                    continue;
+                const entry = {
+                    key: `${plugin.name}@${marketName}`,
+                    name: plugin.name,
+                    marketplace: marketName,
+                    description: plugin.description,
+                    version: plugin.version,
+                    author: plugin.author,
+                    category: plugin.category,
+                    pluginType: decideTypeFromSource(plugin.source),
+                    source: plugin.source,
+                    installed: false, // filled in step 4
+                };
+                const counts = await this.countComponentsForSource(userRoot, marketName, plugin.source);
+                if (counts)
+                    entry.componentCounts = counts;
+                entries.push(entry);
+            }
+        }
+        // Step 4: installed_plugins.json join + format warning (AC1.d / AC6).
+        const { installedKeys, formatWarning } = await this.readInstalledState(currentProjectPath);
+        for (const entry of entries) {
+            entry.installed = installedKeys.has(entry.key);
+        }
+        return {
+            marketplaces,
+            entries,
+            errors,
+            ...(formatWarning ? { formatWarning } : {}),
+        };
+    }
+    /**
+     * Read installed_plugins.json into a set of installed keys + an optional
+     * format warning. Absent file → no installs, no warning (normal). Unknown
+     * version / wrong shape / parse error → degrade with a warning (AC6).
+     */
+    async readInstalledState(currentProjectPath) {
+        const installedKeys = new Set();
+        let content;
+        try {
+            const res = await harnessService.read({
+                scope: 'user',
+                relativePath: 'plugins/installed_plugins.json',
+            });
+            content = res.content ?? '';
+        }
+        catch (err) {
+            if (isFileNotFound(err))
+                return { installedKeys };
+            throw err;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch {
+            return { installedKeys, formatWarning: { reason: 'parseError' } };
+        }
+        let formatWarning;
+        if (typeof parsed.version === 'number' && !KNOWN_INSTALLED_VERSIONS.has(parsed.version)) {
+            formatWarning = { detectedVersion: parsed.version, reason: 'unrecognizedVersion' };
+        }
+        const plugins = parsed.plugins;
+        if (plugins && typeof plugins === 'object' && !Array.isArray(plugins)) {
+            for (const [key, value] of Object.entries(plugins)) {
+                const arr = Array.isArray(value) ? value : [value];
+                const installed = arr.some((e) => {
+                    if (!e || typeof e !== 'object')
+                        return false;
+                    if (e.scope === 'project') {
+                        return (!!currentProjectPath
+                            && typeof e.projectPath === 'string'
+                            && samePath(e.projectPath, currentProjectPath));
+                    }
+                    // user scope (or unspecified) → globally installed
+                    return true;
+                });
+                if (installed)
+                    installedKeys.add(key);
+            }
+        }
+        else if (plugins !== undefined) {
+            formatWarning = formatWarning ?? {
+                detectedVersion: typeof parsed.version === 'number' ? parsed.version : undefined,
+                reason: 'unexpectedShape',
+            };
+        }
+        return { installedKeys, formatWarning };
+    }
+    /**
+     * Best-effort component tally from the cloned market repo source dir
+     * (`<userRoot>/plugins/marketplaces/<market>/<source>/`). Returns undefined
+     * when the dir is missing or resolves outside `~/.claude` (type badge still
+     * renders without counts).
+     */
+    async countComponentsForSource(userRoot, marketName, source) {
+        if (!source || typeof source !== 'string')
+            return undefined;
+        const rel = source.replace(/^\.\//, '');
+        const abs = path.resolve(userRoot, 'plugins', 'marketplaces', marketName, rel);
+        // Refuse anything outside ~/.claude (defends against `..` in source).
+        if (abs !== userRoot && !abs.startsWith(userRoot + path.sep))
+            return undefined;
+        try {
+            const stat = await fs.stat(abs);
+            if (!stat.isDirectory())
+                return undefined;
+        }
+        catch {
+            return undefined;
+        }
+        const [skills, commands, agents, hooks, mcpServers] = await Promise.all([
+            countSkillsDir(path.join(abs, 'skills')),
+            countMarkdownFiles(path.join(abs, 'commands')),
+            countMarkdownFiles(path.join(abs, 'agents')),
+            countHooksJson(path.join(abs, 'hooks', 'hooks.json')),
+            countMcpServers(path.join(abs, '.mcp.json')),
+        ]);
+        return { skills, commands, agents, hooks, mcpServers };
+    }
+    async resolveCurrentProjectPath(slug) {
+        if (!slug)
+            return undefined;
+        try {
+            return await projectService.resolveOriginalPath(slug);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    safeParse(content, fallback) {
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            return fallback;
+        }
+    }
+}
+export const marketplaceService = new MarketplaceService();
+//# sourceMappingURL=marketplaceService.js.map

package/packages/server/dist/services/marketplaceService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplaceService.js","sourceRoot":"","sources":["../../src/services/marketplaceService.ts"],"names":[],"mappings":"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"}

package/packages/server/dist/services/observabilityService.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Story 31.3 (Task A.1 / A.2): Observability MCP-call persistence + collection.
+ *
+ * Backend = JSONL rolling log under `~/.hammoc/observability/<projectSlug>.jsonl`
+ * (spike #3, §16 — 30k records query in ~34ms; SQLite not needed; consistent
+ * with architecture §9 "file-based storage, no external DB" and the existing
+ * `~/.hammoc/` plaintext files). `~/.hammoc/` is a SIBLING of `.claude/` and
+ * therefore outside the harness whitelist, so we use direct `fs` here — exactly
+ * like `preferencesService` does for `~/.hammoc/preferences.json` (the
+ * `storageService` named in the epic does not exist; `fileSystemService` /
+ * direct fs is the real pattern, S-B).
+ *
+ * Records are append-only. Argument/result BODIES are never stored — only their
+ * UTF-8 byte sizes — so secrets/file contents cannot leak (AC-A1.c).
+ *
+ * Collection seam: `createMcpCallRecorder` returns a small per-stream stateful
+ * object that the shared callback builder (`buildStreamCallbacks`) drives via
+ * onToolUse / onToolResult / onTurnEnd. A record is appended EXACTLY ONCE per
+ * call at onToolResult; orphans (no result) are flushed once at turn end with
+ * null fields (S-A / N-A).
+ */
+import { type McpCallRecord, type McpCallAggregate, type ObservabilityQuery, type ObservabilityMcpCallsResponse, type ToolResult } from '@hammoc/shared';
+/** Parse `mcp__<server>__<tool>` → `<server>`; built-ins → null (AC-A1.d). */
+export declare function parseServerName(toolName: string): string | null;
+/** UTF-8 byte length of an arbitrary value's JSON (args) — body discarded. */
+export declare function argByteSize(input: unknown): number;
+/** UTF-8 byte length of a tool result body (output ?? error ?? ''). */
+export declare function resultByteSize(result: ToolResult): number;
+declare class ObservabilityService {
+    /** Serializes appends so concurrent streams never interleave partial lines. */
+    private appendChain;
+    /** Last prune time per project (epoch ms) — throttles append-time prune. */
+    private lastPruneAt;
+    private dir;
+    private filePath;
+    /**
+     * Append one record (AC-A1.c). Serialized via an internal promise chain.
+     * Triggers a throttled prune so the retention window is enforced without
+     * startup wiring (AC-A3.b — "append 시점 또는 서버 기동 시 prune").
+     */
+    recordCall(record: McpCallRecord): Promise<void>;
+    /** Throttled prune triggered from the append path. Fire-and-forget. */
+    private maybePrune;
+    /** Read + parse all records for a project (skips malformed lines). */
+    private readAll;
+    /**
+     * Query the log with filters + aggregation (AC-A1.b / AC-A2). Always applies
+     * the retention cutoff on read so expired records never surface even before a
+     * compaction runs.
+     */
+    query(projectSlug: string, filter?: ObservabilityQuery): Promise<ObservabilityMcpCallsResponse>;
+    /**
+     * Drop records older than `retentionDays` and rewrite the file (AC-A3.b).
+     * Returns the number of records removed. Routed through the append chain so a
+     * rewrite never races a concurrent append.
+     */
+    prune(projectSlug: string, retentionDays?: number): Promise<number>;
+}
+/** Aggregate by (serverName, toolName). Exported for unit tests. */
+export declare function aggregate(records: McpCallRecord[]): McpCallAggregate[];
+export declare const observabilityService: ObservabilityService;
+/**
+ * Drives MCP-call collection from the shared callback builder. One instance per
+ * stream. Maintains an in-memory `toolUseId → start info` map so the two
+ * separately-fired callbacks (`onToolUse` has no result, `onToolResult` has no
+ * start time) can be joined into a single complete record with `durationMs`.
+ *
+ * Lifecycle (S-A / N-A):
+ *   - onToolUse    → buffer start info (no append).
+ *   - onToolResult → append ONE complete record, delete the map entry.
+ *   - onTurnEnd    → flush remaining (orphan) entries as null-field records, clear.
+ * The map is therefore bounded to a single turn's lifetime (no leak).
+ */
+export interface McpCallRecorder {
+    onToolUse(toolUseId: string, toolName: string, input: unknown): void;
+    onToolResult(toolUseId: string, result: ToolResult, sessionId: string | undefined): void;
+    onTurnEnd(sessionId: string | undefined): void;
+}
+/**
+ * Create a recorder. `resolveProjectSlug` is a thunk (sync for the queue path
+ * where `this.projectSlug` is known; async for the browser path where the slug
+ * is resolved from the working directory). The resolved slug is memoized; until
+ * it resolves (or if it is null — no project context) appends are skipped.
+ */
+export declare function createMcpCallRecorder(resolveProjectSlug: () => string | null | undefined | Promise<string | null | undefined>): McpCallRecorder;
+export {};
+//# sourceMappingURL=observabilityService.d.ts.map

package/packages/server/dist/services/observabilityService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observabilityService.d.ts","sourceRoot":"","sources":["../../src/services/observabilityService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAClC,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AASxB,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEzD;AAOD,cAAM,oBAAoB;IACxB,+EAA+E;IAC/E,OAAO,CAAC,WAAW,CAAoC;IACvD,4EAA4E;IAC5E,OAAO,CAAC,WAAW,CAA6B;IAEhD,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,QAAQ;IAIhB;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAetD,uEAAuE;YACzD,UAAU;IAYxB,sEAAsE;YACxD,OAAO;IAoBrB;;;;OAIG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAsBzG;;;;OAIG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,SAA+B,GAAG,OAAO,CAAC,MAAM,CAAC;CAehG;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,gBAAgB,EAAE,CA4BtE;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAM/D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACrE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACzF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CAChD;AASD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,kBAAkB,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GACvF,eAAe,CAmEjB"}

package/packages/server/dist/services/observabilityService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observabilityService.js","sourceRoot":"","sources":["../../src/services/observabilityService.ts"],"names":[],"mappings":"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"}

package/packages/server/dist/services/projectService.d.ts

@@ -4,7 +4,7 @@
  * [Source: Story 3.1 - Task 2]
  * [Extended: Story 3.6 - Task 2: Project creation service]
  */
-import type { PromptHistoryData, PromptChainItem, ProjectInfo, ProjectSettings, UpdateProjectSettingsRequest, ProjectSettingsApiResponse, CreateProjectRequest, CreateProjectResponse, ValidatePathResponse } from '@hammoc/shared';
+import type { PromptHistoryData, PromptChainItem, ProjectInfo, ProjectSettings, UpdateProjectSettingsRequest, ProjectSettingsApiResponse, CreateProjectRequest, CreateProjectResponse, ValidatePathResponse, EngineMode } from '@hammoc/shared';
 /**
  * ProjectService - Scans and lists Claude Code projects
  */
@@ -43,6 +43,18 @@ declare class ProjectService {
      * redundant parseSessionsIndex() calls.
      */
     private _buildEffectiveResponse;
+    /**
+     * Resolve the effective conversation engine mode for a project (Epic 33, Story 33.3).
+     *
+     * Engine-side counterpart to `_buildEffectiveResponse`'s `effectiveEngineMode`: both
+     * run through `computeEffectiveEngineMode`, so the override precedence has one source
+     * of truth. The three conversation call sites (main chat, rewind, queue) call this to
+     * decide which engine the factory instantiates.
+     *
+     * `originalPath` is the project's real filesystem path — the same value the factory
+     * receives as `workingDirectory`.
+     */
+    getEffectiveEngineMode(originalPath: string): Promise<EngineMode>;
     /**
      * Returns project settings merged with global preferences.
      * Calculates effective values and identifies which fields are overridden.

package/packages/server/dist/services/projectService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projectService.d.ts","sourceRoot":"","sources":["../../src/services/projectService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"projectService.d.ts","sourceRoot":"","sources":["../../src/services/projectService.ts"],"names":[],"mappings":"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"}

package/packages/server/dist/services/projectService.js

@@ -9,6 +9,7 @@ import os from 'os';
 import fs from 'fs/promises';
 import { existsSync } from 'fs';
 import { fileURLToPath } from 'url';
+import { DEFAULT_ENGINE_MODE } from '@hammoc/shared';
 import { preferencesService } from './preferencesService.js';
 import { createLogger } from '../utils/logger.js';
 const log = createLogger('projectService');
@@ -17,6 +18,18 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const SERVER_PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
 const BMAD_RESOURCES_DIR = path.join(SERVER_PACKAGE_ROOT, 'resources', 'bmad-method');
+/**
+ * Pure resolver for the effective conversation engine mode (Epic 33 SSoT).
+ *
+ * A project override wins over the global preference, which wins over the default.
+ *
+ * Extracted from the inline expression so both the settings API response
+ * (`_buildEffectiveResponse`) and the engine-side resolver (`getEffectiveEngineMode`)
+ * consume one expression and can never drift — the precedence logic has a single home.
+ */
+function computeEffectiveEngineMode(override, globalEngineMode) {
+    return override ?? globalEngineMode ?? DEFAULT_ENGINE_MODE;
+}
 /**
  * Validate path for security (path traversal prevention)
  * Cross-platform compatible (Windows, macOS, Linux)
@@ -270,14 +283,33 @@ class ProjectService {
             _overrides.push('modelOverride');
         if (projectSettings.permissionModeOverride !== undefined)
             _overrides.push('permissionModeOverride');
+        if (projectSettings.engineModeOverride !== undefined)
+            _overrides.push('engineModeOverride');
         return {
             ...projectSettings,
             effectiveModel: projectSettings.modelOverride ?? globalPrefs.defaultModel ?? '',
             effectivePermissionMode: projectSettings.permissionModeOverride
                 ?? (globalPrefs.permissionMode === 'latest' ? (globalPrefs.lastPermissionMode ?? 'default') : (globalPrefs.permissionMode ?? 'default')),
+            effectiveEngineMode: computeEffectiveEngineMode(projectSettings.engineModeOverride, globalPrefs.engineMode),
             _overrides,
         };
     }
+    /**
+     * Resolve the effective conversation engine mode for a project (Epic 33, Story 33.3).
+     *
+     * Engine-side counterpart to `_buildEffectiveResponse`'s `effectiveEngineMode`: both
+     * run through `computeEffectiveEngineMode`, so the override precedence has one source
+     * of truth. The three conversation call sites (main chat, rewind, queue) call this to
+     * decide which engine the factory instantiates.
+     *
+     * `originalPath` is the project's real filesystem path — the same value the factory
+     * receives as `workingDirectory`.
+     */
+    async getEffectiveEngineMode(originalPath) {
+        const projectSettings = await this.readProjectSettings(originalPath);
+        const globalPrefs = await preferencesService.getEffectivePreferences();
+        return computeEffectiveEngineMode(projectSettings.engineModeOverride, globalPrefs.engineMode);
+    }
     /**
      * Returns project settings merged with global preferences.
      * Calculates effective values and identifies which fields are overridden.