@open-agent-toolkit/cli 0.0.27 → 0.0.29

package/dist/commands/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAMpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAk3BD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAwET"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoDpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAyiCD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0GT"}

package/dist/commands/config/index.js

@@ -1,7 +1,9 @@
+import { join } from 'node:path';
 import { buildCommandContext } from '../../app/command-context.js';
 import { resolveProjectsRoot } from '../shared/oat-paths.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
-import { readOatConfig, readOatLocalConfig, writeOatConfig, writeOatLocalConfig, } from '../../config/oat-config.js';
+import { readOatConfig, readOatLocalConfig, readUserConfig, writeOatConfig, writeOatLocalConfig, writeUserConfig, } from '../../config/oat-config.js';
+import { resolveEffectiveConfig, } from '../../config/resolve.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
 import { Command } from 'commander';
 import { createConfigDumpCommand } from './dump.js';
@@ -11,6 +13,7 @@ const KEY_ORDER = [
     'archive.s3Uri',
     'archive.s3SyncOnComplete',
     'archive.summaryExportPath',
+    'archive.wrapUpExportPath',
     'autoReviewAtCheckpoints',
     'lastPausedProject',
     'documentation.root',
@@ -26,6 +29,12 @@ const KEY_ORDER = [
     'tools.research',
     'tools.utility',
     'tools.workflows',
+    'workflow.hillCheckpointDefault',
+    'workflow.archiveOnComplete',
+    'workflow.createPrOnComplete',
+    'workflow.postImplementSequence',
+    'workflow.reviewExecutionModel',
+    'workflow.autoNarrowReReviewScope',
     'worktrees.root',
 ];
 const CONFIG_CATALOG = [
@@ -150,6 +159,17 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set archive.summaryExportPath <value>',
         description: 'Repository-relative directory where completion copies project summaries for durable tracked reference.',
     },
+    {
+        key: 'archive.wrapUpExportPath',
+        group: 'Shared Repo (.oat/config.json)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'string',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set archive.wrapUpExportPath <value>',
+        description: 'Repository-relative directory where the oat-wrap-up skill writes date-ranged shipping digests. When unset, the skill falls back to `.oat/repo/reference/wrap-ups`.',
+    },
     {
         key: 'tools.core',
         group: 'Shared Repo (.oat/config.json)',
@@ -268,8 +288,74 @@ const CONFIG_CATALOG = [
         type: 'string | null',
         defaultValue: 'null',
         mutability: 'read/write',
-        owningCommand: 'user config APIs (not surfaced via oat config set)',
-        description: 'User-level active idea fallback when no repo-local active idea is set.',
+        owningCommand: 'oat config set activeIdea <value> --user',
+        description: 'User-level active idea fallback used when no repo-local active idea is set. Writable via `oat config set activeIdea <value> --user`.',
+    },
+    {
+        key: 'workflow.hillCheckpointDefault',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'every | final',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.hillCheckpointDefault <value>',
+        description: 'Default HiLL checkpoint behavior in oat-project-implement: "every" pauses after every phase, "final" pauses only after the last phase. When unset, the skill prompts. Resolution: env > local > shared > user > default.',
+    },
+    {
+        key: 'workflow.archiveOnComplete',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'boolean',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.archiveOnComplete <true|false>',
+        description: 'Skip the "Archive after completion?" prompt in oat-project-complete. When unset, the skill prompts. Resolution: env > local > shared > user > default.',
+    },
+    {
+        key: 'workflow.createPrOnComplete',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'boolean',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.createPrOnComplete <true|false>',
+        description: 'Skip the "Open a PR?" prompt in oat-project-complete. When true, completion auto-triggers PR creation. Resolution: env > local > shared > user > default.',
+    },
+    {
+        key: 'workflow.postImplementSequence',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'wait | summary | pr | docs-pr',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.postImplementSequence <value>',
+        description: 'Default post-implementation chaining: "wait" stops without auto-chaining, "summary" generates summary only, "pr" runs pr-final (which auto-generates summary), "docs-pr" runs docs sync then pr-final. When unset, the skill prompts. Resolution: env > local > shared > user > default.',
+    },
+    {
+        key: 'workflow.reviewExecutionModel',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'subagent | inline | fresh-session',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.reviewExecutionModel <value>',
+        description: 'Default execution model for the final review step in oat-project-implement: "subagent" dispatches a review subagent, "inline" runs the review in-context, "fresh-session" prints guidance for running the review in a separate session (with an escape hatch to subagent/inline). When unset, the skill prompts. Resolution: env > local > shared > user > default.',
+    },
+    {
+        key: 'workflow.autoNarrowReReviewScope',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'boolean',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.autoNarrowReReviewScope <true|false>',
+        description: 'Auto-narrow re-review scope to fix-task commits in oat-project-review-provide when re-reviewing completed fix tasks. Has no effect on initial reviews (there is nothing to narrow to). When unset, the skill prompts. Resolution: env > local > shared > user > default.',
     },
     {
         key: 'sync.defaultStrategy',
@@ -312,7 +398,10 @@ const DEFAULT_DEPENDENCIES = {
     writeOatConfig,
     readOatLocalConfig,
     writeOatLocalConfig,
+    readUserConfig,
+    writeUserConfig,
     resolveProjectsRoot,
+    resolveEffectiveConfig,
     processEnv: process.env,
 };
 function isConfigKey(value) {
@@ -325,150 +414,168 @@ function normalizeSharedRoot(value) {
     }
     return trimmed.replace(/\/+$/, '');
 }
-async function resolveProjectsRootWithSource(repoRoot, dependencies) {
-    const envRoot = dependencies.processEnv.OAT_PROJECTS_ROOT?.trim();
-    if (envRoot) {
-        return {
-            key: 'projects.root',
-            value: envRoot.replace(/\/+$/, ''),
-            source: 'env',
-        };
+const WORKFLOW_ENUM_VALUES = {
+    'workflow.hillCheckpointDefault': ['every', 'final'],
+    'workflow.postImplementSequence': ['wait', 'summary', 'pr', 'docs-pr'],
+    'workflow.reviewExecutionModel': ['subagent', 'inline', 'fresh-session'],
+};
+const WORKFLOW_BOOLEAN_KEYS = new Set([
+    'workflow.archiveOnComplete',
+    'workflow.createPrOnComplete',
+    'workflow.autoNarrowReReviewScope',
+]);
+function isWorkflowKey(key) {
+    return key.startsWith('workflow.');
+}
+function isStateKey(key) {
+    return (key === 'activeIdea' ||
+        key === 'activeProject' ||
+        key === 'lastPausedProject');
+}
+function isStructuralKey(key) {
+    return (key === 'projects.root' ||
+        key === 'worktrees.root' ||
+        key === 'git.defaultBranch' ||
+        key.startsWith('documentation.') ||
+        key.startsWith('archive.') ||
+        key.startsWith('tools.'));
+}
+function validateSurfaceForKey(key, surface) {
+    if (surface === 'auto') {
+        return;
     }
-    const config = await dependencies.readOatConfig(repoRoot);
-    const configRoot = config.projects?.root?.trim();
-    if (configRoot) {
-        return {
-            key: 'projects.root',
-            value: configRoot.replace(/\/+$/, ''),
-            source: 'config.json',
-        };
+    if (isStructuralKey(key)) {
+        if (surface !== 'shared') {
+            throw new Error(`Cannot set structural key '${key}' at '${surface}' scope. Structural keys (projects.root, worktrees.root, git.*, documentation.*, archive.*, tools.*) can only be set at shared scope (.oat/config.json).`);
+        }
+        return;
     }
-    const value = await dependencies.resolveProjectsRoot(repoRoot, dependencies.processEnv);
-    return {
-        key: 'projects.root',
-        value,
-        source: 'default',
-    };
+    if (isStateKey(key)) {
+        // activeIdea has both a repo-local and a user-level surface in the
+        // catalog (the user-level entry is the global fallback). Both surfaces
+        // are writable; shared is not supported because an idea pointer is not
+        // a team decision.
+        if (key === 'activeIdea') {
+            if (surface !== 'local' && surface !== 'user') {
+                throw new Error(`Cannot set 'activeIdea' at '${surface}' scope. activeIdea can only be set at local scope (.oat/config.local.json) or user scope (~/.oat/config.json).`);
+            }
+            return;
+        }
+        // activeProject and lastPausedProject are per-checkout state only.
+        if (surface !== 'local') {
+            throw new Error(`Cannot set state key '${key}' at '${surface}' scope. State keys (activeProject, lastPausedProject) can only be set at local scope (.oat/config.local.json).`);
+        }
+        return;
+    }
+    // autoReviewAtCheckpoints is currently shared-only. Multi-surface support
+    // for behavioral keys is out of scope for p01-t04 (workflow.* keys only).
+    if (key === 'autoReviewAtCheckpoints' && surface !== 'shared') {
+        throw new Error(`Cannot set 'autoReviewAtCheckpoints' at '${surface}' scope. This key is currently shared-only.`);
+    }
+    // Workflow keys accept any non-auto surface.
 }
-async function getConfigValue(repoRoot, key, dependencies) {
-    if (key === 'projects.root') {
-        return resolveProjectsRootWithSource(repoRoot, dependencies);
+function defaultSurfaceForKey(key) {
+    if (isWorkflowKey(key) || isStateKey(key)) {
+        return 'local';
     }
-    if (key.startsWith('documentation.')) {
-        const config = await dependencies.readOatConfig(repoRoot);
-        const doc = config.documentation;
-        let value = null;
-        if (key === 'documentation.root') {
-            value = doc?.root ?? null;
-        }
-        else if (key === 'documentation.tooling') {
-            value = doc?.tooling ?? null;
-        }
-        else if (key === 'documentation.config') {
-            value = doc?.config ?? null;
-        }
-        else if (key === 'documentation.requireForProjectCompletion') {
-            value =
-                doc?.requireForProjectCompletion != null
-                    ? String(doc.requireForProjectCompletion)
-                    : 'false';
+    return 'shared';
+}
+function parseWorkflowValue(key, rawValue) {
+    if (WORKFLOW_BOOLEAN_KEYS.has(key)) {
+        const normalized = rawValue.trim().toLowerCase();
+        if (normalized !== 'true' && normalized !== 'false') {
+            throw new Error(`Invalid value for ${key}: expected 'true' or 'false', got '${rawValue}'`);
         }
-        return {
-            key,
-            value,
-            source: doc ? 'config.json' : 'default',
-        };
+        return normalized === 'true';
     }
-    if (key.startsWith('archive.')) {
-        const config = await dependencies.readOatConfig(repoRoot);
-        const archive = config.archive;
-        let value = null;
-        if (key === 'archive.s3Uri') {
-            value = archive?.s3Uri ?? null;
-        }
-        else if (key === 'archive.s3SyncOnComplete') {
-            value =
-                archive?.s3SyncOnComplete != null
-                    ? String(archive.s3SyncOnComplete)
-                    : 'false';
-        }
-        else if (key === 'archive.summaryExportPath') {
-            value = archive?.summaryExportPath ?? null;
+    const allowed = WORKFLOW_ENUM_VALUES[key];
+    if (allowed) {
+        const normalized = rawValue.trim();
+        if (!allowed.includes(normalized)) {
+            throw new Error(`Invalid value for ${key}: expected one of ${allowed.join(' | ')}, got '${rawValue}'`);
         }
-        return {
-            key,
-            value,
-            source: archive ? 'config.json' : 'default',
-        };
+        return normalized;
     }
-    if (key.startsWith('tools.')) {
-        const config = await dependencies.readOatConfig(repoRoot);
-        const packName = key.slice('tools.'.length);
-        const tools = config.tools ?? {};
-        return {
-            key,
-            value: String(tools[packName] ?? false),
-            source: config.tools ? 'config.json' : 'default',
-        };
+    throw new Error(`Unknown workflow key: ${key}`);
+}
+function applyWorkflowValue(workflow, key, value) {
+    const subKey = key.slice('workflow.'.length);
+    return {
+        ...workflow,
+        [subKey]: value,
+    };
+}
+function formatResolvedValue(value) {
+    if (value === null || value === undefined) {
+        return null;
     }
-    if (key === 'git.defaultBranch') {
-        const config = await dependencies.readOatConfig(repoRoot);
-        return {
-            key,
-            value: config.git?.defaultBranch ?? null,
-            source: config.git?.defaultBranch ? 'config.json' : 'default',
-        };
+    if (typeof value === 'boolean') {
+        return String(value);
     }
-    if (key === 'worktrees.root') {
-        const envRoot = dependencies.processEnv.OAT_WORKTREES_ROOT?.trim();
-        if (envRoot) {
-            return {
-                key,
-                value: envRoot.replace(/\/+$/, ''),
-                source: 'env',
-            };
-        }
-        const config = await dependencies.readOatConfig(repoRoot);
-        const value = config.worktrees?.root?.trim();
-        if (value) {
-            return {
-                key,
-                value: value.replace(/\/+$/, ''),
-                source: 'config.json',
-            };
-        }
-        return {
-            key,
-            value: '.worktrees',
-            source: 'default',
-        };
+    if (typeof value === 'string') {
+        return value;
     }
-    if (key === 'autoReviewAtCheckpoints') {
-        const config = await dependencies.readOatConfig(repoRoot);
-        return {
-            key,
-            value: config.autoReviewAtCheckpoints != null
-                ? String(config.autoReviewAtCheckpoints)
-                : 'false',
-            source: config.autoReviewAtCheckpoints != null ? 'config.json' : 'default',
-        };
+    if (Array.isArray(value)) {
+        return value.join(',');
+    }
+    return String(value);
+}
+async function getConfigValue(repoRoot, userConfigDir, key, dependencies) {
+    const resolved = await dependencies.resolveEffectiveConfig(repoRoot, userConfigDir, dependencies.processEnv);
+    const entry = resolved.resolved[key];
+    if (!entry) {
+        return { key, value: null, source: 'default' };
     }
-    const localConfig = await dependencies.readOatLocalConfig(repoRoot);
-    const localKey = key;
-    const hasKey = Object.hasOwn(localConfig, localKey);
-    const value = localConfig[localKey] ?? null;
     return {
         key,
-        value,
-        source: hasKey ? 'config.local.json' : 'default',
+        value: formatResolvedValue(entry.value),
+        source: entry.source,
     };
 }
-async function setConfigValue(repoRoot, key, rawValue, dependencies) {
+async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, dependencies) {
+    validateSurfaceForKey(key, surface);
+    const effectiveSurface = surface === 'auto' ? defaultSurfaceForKey(key) : surface;
+    if (isWorkflowKey(key)) {
+        const parsedValue = parseWorkflowValue(key, rawValue);
+        const displayValue = typeof parsedValue === 'boolean' ? String(parsedValue) : parsedValue;
+        if (effectiveSurface === 'user') {
+            const userConfig = await dependencies.readUserConfig(userConfigDir);
+            await dependencies.writeUserConfig(userConfigDir, {
+                ...userConfig,
+                workflow: applyWorkflowValue(userConfig.workflow ?? {}, key, parsedValue),
+            });
+            return { key, value: displayValue, source: 'user' };
+        }
+        if (effectiveSurface === 'local') {
+            const localConfig = await dependencies.readOatLocalConfig(repoRoot);
+            await dependencies.writeOatLocalConfig(repoRoot, {
+                ...localConfig,
+                workflow: applyWorkflowValue(localConfig.workflow ?? {}, key, parsedValue),
+            });
+            return { key, value: displayValue, source: 'local' };
+        }
+        // shared
+        const sharedConfig = await dependencies.readOatConfig(repoRoot);
+        await dependencies.writeOatConfig(repoRoot, {
+            ...sharedConfig,
+            workflow: applyWorkflowValue(sharedConfig.workflow ?? {}, key, parsedValue),
+        });
+        return { key, value: displayValue, source: 'shared' };
+    }
     if (key === 'activeIdea' ||
         key === 'activeProject' ||
         key === 'lastPausedProject') {
-        const localConfig = await dependencies.readOatLocalConfig(repoRoot);
         const nextValue = rawValue === '' ? null : rawValue;
+        // activeIdea --user writes to ~/.oat/config.json
+        if (key === 'activeIdea' && effectiveSurface === 'user') {
+            const userConfig = await dependencies.readUserConfig(userConfigDir);
+            await dependencies.writeUserConfig(userConfigDir, {
+                ...userConfig,
+                activeIdea: nextValue,
+            });
+            return { key, value: nextValue, source: 'user' };
+        }
+        const localConfig = await dependencies.readOatLocalConfig(repoRoot);
         await dependencies.writeOatLocalConfig(repoRoot, {
             ...localConfig,
             [key]: nextValue,
@@ -476,7 +583,7 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
         return {
             key,
             value: nextValue,
-            source: 'config.local.json',
+            source: 'local',
         };
     }
     const config = await dependencies.readOatConfig(repoRoot);
@@ -505,7 +612,7 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
         return {
             key,
             value: resultValue,
-            source: 'config.json',
+            source: 'shared',
         };
     }
     if (key.startsWith('archive.')) {
@@ -519,6 +626,9 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
         else if (key === 'archive.summaryExportPath') {
             archive.summaryExportPath = normalizeSharedRoot(rawValue);
         }
+        else if (key === 'archive.wrapUpExportPath') {
+            archive.wrapUpExportPath = normalizeSharedRoot(rawValue);
+        }
         await dependencies.writeOatConfig(repoRoot, {
             ...config,
             archive,
@@ -529,7 +639,7 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
         return {
             key,
             value: resultValue,
-            source: 'config.json',
+            source: 'shared',
         };
     }
     if (key.startsWith('tools.')) {
@@ -543,7 +653,7 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
         return {
             key,
             value: String(tools[packName] ?? false),
-            source: 'config.json',
+            source: 'shared',
         };
     }
     if (key === 'git.defaultBranch') {
@@ -561,7 +671,7 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
         return {
             key,
             value: nextValue,
-            source: 'config.json',
+            source: 'shared',
         };
     }
     if (key === 'autoReviewAtCheckpoints') {
@@ -573,7 +683,7 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
         return {
             key,
             value: String(nextValue),
-            source: 'config.json',
+            source: 'shared',
         };
     }
     const normalizedValue = normalizeSharedRoot(rawValue);
@@ -592,7 +702,7 @@ async function setConfigValue(repoRoot, key, rawValue, dependencies) {
     return {
         key,
         value: normalizedValue,
-        source: 'config.json',
+        source: 'shared',
     };
 }
 function formatList(values) {
@@ -656,7 +766,8 @@ async function runGet(keyArg, context, dependencies) {
             throw new Error(`Unknown config key: ${keyArg}`);
         }
         const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
-        const value = await getConfigValue(repoRoot, keyArg, dependencies);
+        const userConfigDir = join(context.home, '.oat');
+        const value = await getConfigValue(repoRoot, userConfigDir, keyArg, dependencies);
         if (context.json) {
             context.logger.json({
                 status: 'ok',
@@ -679,13 +790,14 @@ async function runGet(keyArg, context, dependencies) {
         process.exitCode = 1;
     }
 }
-async function runSet(keyArg, rawValue, context, dependencies) {
+async function runSet(keyArg, rawValue, surface, context, dependencies) {
     try {
         if (!isConfigKey(keyArg)) {
             throw new Error(`Unknown config key: ${keyArg}`);
         }
         const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
-        const result = await setConfigValue(repoRoot, keyArg, rawValue, dependencies);
+        const userConfigDir = join(context.home, '.oat');
+        const result = await setConfigValue(repoRoot, userConfigDir, keyArg, rawValue, surface, dependencies);
         if (context.json) {
             context.logger.json({
                 status: 'ok',
@@ -711,9 +823,10 @@ async function runSet(keyArg, rawValue, context, dependencies) {
 async function runList(context, dependencies) {
     try {
         const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const userConfigDir = join(context.home, '.oat');
         const values = [];
         for (const key of KEY_ORDER) {
-            values.push(await getConfigValue(repoRoot, key, dependencies));
+            values.push(await getConfigValue(repoRoot, userConfigDir, key, dependencies));
         }
         if (context.json) {
             context.logger.json({
@@ -789,9 +902,39 @@ export function createConfigCommand(overrides = {}) {
         .description('Set an OAT config value')
         .argument('<key>', 'Config key')
         .argument('<value>', 'Config value')
-        .action(async (key, value, _options, command) => {
+        .option('--shared', 'Write to the shared repo config (.oat/config.json)')
+        .option('--local', 'Write to the repo-local config (.oat/config.local.json)')
+        .option('--user', 'Write to the user-level config (~/.oat/config.json)')
+        .action(async (key, value, options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
-        await runSet(key, value, context, dependencies);
+        try {
+            const flagsPresent = [
+                options.shared,
+                options.local,
+                options.user,
+            ].filter(Boolean).length;
+            if (flagsPresent > 1) {
+                throw new Error('--shared, --local, and --user flags are mutually exclusive; pass at most one.');
+            }
+            let surface = 'auto';
+            if (options.shared)
+                surface = 'shared';
+            else if (options.local)
+                surface = 'local';
+            else if (options.user)
+                surface = 'user';
+            await runSet(key, value, surface, context, dependencies);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (context.json) {
+                context.logger.json({ status: 'error', message });
+            }
+            else {
+                context.logger.error(message);
+            }
+            process.exitCode = 1;
+        }
     }))
         .addCommand(new Command('list')
         .description('List resolved OAT config values with sources')

package/dist/commands/init/tools/shared/skill-manifest.d.ts

@@ -5,7 +5,7 @@
  * `bundle-assets.sh` maintains its own bash array — `bundle-consistency.test.ts`
  * validates that it stays in sync with these lists.
  */
-export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-subagent-implement", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto"];
+export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-subagent-implement", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
 export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-reviewer.md"];
 export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];

package/dist/commands/init/tools/shared/skill-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,eAAe,svBA8BlB,CAAC;AAEX,eAAO,MAAM,eAAe,wDAGlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,mHAKd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,eAAe,qwBA+BlB,CAAC;AAEX,eAAO,MAAM,eAAe,wDAGlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,mHAKd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}

package/dist/commands/init/tools/shared/skill-manifest.js

@@ -36,6 +36,7 @@ export const WORKFLOW_SKILLS = [
     'oat-repo-knowledge-index',
     'oat-worktree-bootstrap',
     'oat-worktree-bootstrap-auto',
+    'oat-wrap-up',
 ];
 export const WORKFLOW_AGENTS = [
     'oat-codebase-mapper.md',

package/dist/config/oat-config.d.ts

@@ -12,6 +12,18 @@ export interface OatArchiveConfig {
     s3Uri?: string;
     s3SyncOnComplete?: boolean;
     summaryExportPath?: string;
+    wrapUpExportPath?: string;
+}
+export type WorkflowHillCheckpointDefault = 'every' | 'final';
+export type WorkflowPostImplementSequence = 'wait' | 'summary' | 'pr' | 'docs-pr';
+export type WorkflowReviewExecutionModel = 'subagent' | 'inline' | 'fresh-session';
+export interface OatWorkflowConfig {
+    hillCheckpointDefault?: WorkflowHillCheckpointDefault;
+    archiveOnComplete?: boolean;
+    createPrOnComplete?: boolean;
+    postImplementSequence?: WorkflowPostImplementSequence;
+    reviewExecutionModel?: WorkflowReviewExecutionModel;
+    autoNarrowReReviewScope?: boolean;
 }
 export type OatToolsConfig = Partial<Record<'core' | 'ideas' | 'docs' | 'workflows' | 'utility' | 'project-management' | 'research', boolean>>;
 export interface OatConfig {
@@ -28,16 +40,19 @@ export interface OatConfig {
     documentation?: OatDocumentationConfig;
     localPaths?: string[];
     autoReviewAtCheckpoints?: boolean;
+    workflow?: OatWorkflowConfig;
 }
 export interface OatLocalConfig {
     version: number;
     activeProject?: string | null;
     lastPausedProject?: string | null;
     activeIdea?: string | null;
+    workflow?: OatWorkflowConfig;
 }
 export interface UserConfig {
     version: number;
     activeIdea?: string | null;
+    workflow?: OatWorkflowConfig;
 }
 export interface ActiveProjectResolution {
     name: string | null;