chati-dev 4.5.13 → 4.5.14

package/src/installer/core.js

@@ -5,9 +5,9 @@ import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
 import { IDE_CONFIGS, IDE_TO_PROVIDER } from '../config/ide-configs.js';
 import { mergeClaudeMCPConfig, upsertManagedMcpToml } from '../config/mcp-configs.js';
-import { generateSessionYaml, generateConfigYaml, generateClaudeMd, generateClaudeLocalMd, generateCodexSkill, generateGeminiRouter, generateGrokRouter, generateGeminiSessionLock, generateAgentsOverrideMd, generateCodexConstitutionGuardRules, generateCodexReadProtectionRules } from './templates.js';
+import { generateSessionYaml, generateConfigYaml, generateProjectContext, generateClaudeMd, generateClaudeLocalMd, generateCodexSkill, generateGeminiRouter, generateGrokRouter, generateGeminiSessionLock, generateAgentsOverrideMd, generateCodexConstitutionGuardRules, generateCodexReadProtectionRules } from './templates.js';
 import { generateContextFiles } from '../config/context-file-generator.js';
-import { adaptFrameworkFile, ADAPTABLE_FILES } from '../config/framework-adapter.js';
+import { adaptFrameworkFile, ADAPTABLE_FILES, stripLegacyBuildSurface } from '../config/framework-adapter.js';
 import { generateClaudeSettings } from '../config/claude-settings-generator.js';
 import { generateProviderOverlays } from './provider-overlay.js';
 import { applyInstalledPathReplacement } from './path-replacement.js';
@@ -27,6 +27,9 @@ const FRAMEWORK_SOURCE = existsSync(BUNDLED_SOURCE) ? BUNDLED_SOURCE : MONOREPO_
  */
 export async function installFramework(config) {
   const { targetDir, projectType, language, selectedIDEs, selectedMCPs, projectName, allProviders } = config;
+  const enabledProviders = allProviders?.length
+    ? [...new Set(allProviders)]
+    : [...new Set((selectedIDEs || []).map(ide => IDE_TO_PROVIDER[ide]).filter(Boolean))];
   // Always derive version from package.json (single source of truth)
   let { version } = config;
   if (!version) {
@@ -58,7 +61,7 @@ export async function installFramework(config) {
   if (!existsSync(sessionPath)) {
     writeFileSync(
       sessionPath,
-      generateSessionYaml({ projectName, projectType, language, selectedIDEs, selectedMCPs, allProviders }),
+      generateSessionYaml({ projectName, projectType, language, selectedIDEs, selectedMCPs, allProviders: enabledProviders }),
       'utf-8'
     );
   }
@@ -128,17 +131,17 @@ export async function installFramework(config) {
     createDir(join(memoriesBase, dir));
   }
 
-  // Copy the canonical framework as a provider-neutral fallback. Every enabled
-  // CLI receives its own explicit adapted overlay below.
-  copyFrameworkFiles(frameworkDir, 'claude');
+  // Copy the provider-neutral canonical framework. Every enabled CLI receives
+  // an explicit native overlay below, but no provider owns the source core.
+  copyFrameworkFiles(frameworkDir, null);
 
   // Generate symmetric provider overlays. No CLI is permanently primary.
-  if (allProviders && allProviders.length > 0) {
-    generateProviderOverlays(targetDir, FRAMEWORK_SOURCE, allProviders);
+  if (enabledProviders.length > 0) {
+    generateProviderOverlays(targetDir, FRAMEWORK_SOURCE, enabledProviders);
   }
 
   if (isRuntimeV2) {
-    pruneLegacyExecutionSurface(frameworkDir, allProviders || []);
+    pruneLegacyExecutionSurface(frameworkDir, enabledProviders);
     pruneLegacyRegistryEntities(frameworkDir);
   }
 
@@ -179,7 +182,7 @@ export async function installFramework(config) {
   // Write config.yaml
   writeFileSync(
     join(frameworkDir, 'config.yaml'),
-    generateConfigYaml({ version, projectType, language, selectedIDEs, allProviders, runtimeVersion: config.runtimeVersion }),
+    generateConfigYaml({ version, projectType, language, selectedIDEs, allProviders: enabledProviders, runtimeVersion: config.runtimeVersion }),
     'utf-8'
   );
 
@@ -187,7 +190,7 @@ export async function installFramework(config) {
   // session becomes that session's orchestrator.
   for (const ideKey of selectedIDEs) {
     const ideProvider = IDE_TO_PROVIDER[ideKey];
-    const hasProviderOverlay = ideProvider && allProviders?.includes(ideProvider);
+    const hasProviderOverlay = ideProvider && enabledProviders.includes(ideProvider);
     const orchestratorPath = hasProviderOverlay
       ? `.chati.dev/.adapted/${ideProvider}/orchestrator/chati.md`
       : '.chati.dev/orchestrator/chati.md';
@@ -200,10 +203,30 @@ export async function installFramework(config) {
   }
 
   const hasClaude = selectedIDEs.includes('claude-code');
-  const hasNonClaude = selectedIDEs.some(ide => ide !== 'claude-code');
-
-  // 4. Generate base content (used as source for all provider context files)
-  const baseContent = generateClaudeMd({ projectName, projectType, language });
+  // 4. Generate the provider-neutral project context. Harness files consume
+  // this artifact and never become the source for one another.
+  const contextConfig = { projectName, projectType, language };
+  const projectContext = generateProjectContext(contextConfig);
+  const projectContextPath = join(targetDir, '.chati', 'project-context.md');
+  const legacyClaudePath = join(targetDir, 'CLAUDE.md');
+  const legacyClaudeContent = existsSync(legacyClaudePath)
+    ? readFileSync(legacyClaudePath, 'utf-8')
+    : null;
+  const installedProjectContext = existsSync(projectContextPath)
+    ? mergeProjectContext(readFileSync(projectContextPath, 'utf-8'), projectContext)
+    : seedProjectContextFromLegacyClaude(projectContext, legacyClaudeContent);
+  writeFileSync(projectContextPath, installedProjectContext, 'utf-8');
+
+  // Once legacy Chati state has been promoted into the neutral context, do
+  // not leave a frozen second source of truth behind just because Claude is
+  // not one of the selected harnesses. User-authored CLAUDE.md content remains
+  // untouched; only recognized legacy Chati state sections are removed.
+  if (!hasClaude && legacyClaudeContent && looksLikeLegacyChatiContext(legacyClaudeContent)) {
+    const sanitizedClaude = stripLegacyStateSections(legacyClaudeContent);
+    if (sanitizedClaude !== legacyClaudeContent) {
+      writeFileSync(legacyClaudePath, sanitizedClaude, 'utf-8');
+    }
+  }
 
   // 5. Claude Code specific: .claude/rules/chati/, CLAUDE.md, CLAUDE.local.md
   if (hasClaude) {
@@ -223,19 +246,18 @@ export async function installFramework(config) {
     // Preserve existing CLAUDE.md on reinstall — user or magic-docs may have
     // edited it. Section-aware merge if exists; fresh write if not.
     const claudeMdPath = join(targetDir, 'CLAUDE.md');
+    const claudeContent = generateClaudeMd(contextConfig);
     if (existsSync(claudeMdPath)) {
       const existingClaudeMd = readFileSync(claudeMdPath, 'utf-8');
-      writeFileSync(claudeMdPath, mergeClaudeMd(existingClaudeMd, baseContent), 'utf-8');
+      writeFileSync(claudeMdPath, mergeClaudeMd(existingClaudeMd, claudeContent), 'utf-8');
     } else {
-      writeFileSync(claudeMdPath, baseContent, 'utf-8');
+      writeFileSync(claudeMdPath, claudeContent, 'utf-8');
     }
     writeFileSync(join(targetDir, 'CLAUDE.local.md'), generateClaudeLocalMd(), 'utf-8');
   }
 
-  // 6. Non-Claude providers: generate context files (GEMINI.md, AGENTS.md) from base content
-  if (hasNonClaude) {
-    generateContextFiles(targetDir, baseContent);
-  }
+  // 6. Generate every non-Claude native context from the neutral artifact.
+  generateContextFiles(targetDir, installedProjectContext);
 
   // 7. Update .gitignore with runtime session lock files
   updateGitignore(targetDir, selectedIDEs);
@@ -292,6 +314,12 @@ function pruneLegacyExecutionSurface(frameworkDir, providers) {
         }
       }
     }
+    const orchestratorPath = join(root, 'orchestrator', 'chati.md');
+    if (existsSync(orchestratorPath)) {
+      const content = readFileSync(orchestratorPath, 'utf-8');
+      const pruned = stripLegacyBuildSurface(content);
+      if (pruned !== content) writeFileSync(orchestratorPath, pruned, 'utf-8');
+    }
   }
 }
 
@@ -387,8 +415,8 @@ function copyDirRecursive(srcDir, destDir, provider, relBase = '') {
         let content = readFileSync(srcPath, 'utf-8');
         // Always apply path replacement for installed location
         content = applyInstalledPathReplacement(content);
-        // Provider adaptation on top (for non-Claude)
-        if (provider !== 'claude' && ADAPTABLE_FILES.has(relPath)) {
+        // Provider-native overlay rendering on top of the neutral core.
+        if (provider && ADAPTABLE_FILES.has(relPath)) {
           content = adaptFrameworkFile(content, relPath, provider);
         }
         writeFileSync(destPath, content, 'utf-8');
@@ -409,7 +437,7 @@ function copyDirRecursive(srcDir, destDir, provider, relBase = '') {
  * @param {string} destDir - Target framework directory (e.g., {project}/chati.dev/)
  * @param {string} provider - Primary provider for text adaptation ('claude' | 'gemini' | 'codex')
  */
-export function copyFrameworkFiles(destDir, provider = 'claude') {
+export function copyFrameworkFiles(destDir, provider = null) {
   if (!existsSync(FRAMEWORK_SOURCE)) return;
 
   // Copy loose root files (with path replacement)
@@ -420,7 +448,7 @@ export function copyFrameworkFiles(destDir, provider = 'claude') {
     createDir(dirname(dest));
     let content = readFileSync(src, 'utf-8');
     content = applyInstalledPathReplacement(content);
-    if (provider !== 'claude' && ADAPTABLE_FILES.has(file)) {
+    if (provider && ADAPTABLE_FILES.has(file)) {
       content = adaptFrameworkFile(content, file, provider);
     }
     writeFileSync(dest, content, 'utf-8');
@@ -764,62 +792,158 @@ export function updateGitignore(targetDir, selectedIDEs) {
  * re-rendered from the fresh template; everything else is kept as-is.
  */
 function mergeClaudeMd(existing, fresh) {
-  // Framework-managed sections — these come from the install template AND from
-  // magic-docs runtime updates. Replace these from fresh template; preserve all others.
-  const frameworkSections = [
-    // Install template (templates.js generateClaudeMd)
-    '## Project Context',
-    '## Chati.dev',
-    // Magic-docs runtime sections (when project starts)
-    '## Current State',
-    '## Session Lock',
-    '## Recent Decisions',
-    '## Framework',
-    '## How to Resume',
-  ];
+  const startMarker = '<!-- chati-claude:start -->';
+  const endMarker = '<!-- chati-claude:end -->';
+  const preserved = looksLikeLegacyChatiContext(existing)
+    ? stripLegacyStateSections(existing)
+    : existing;
+  return mergeManagedBlock(preserved, fresh, startMarker, endMarker);
+}
 
-  // If existing has no framework sections at all, user has a custom CLAUDE.md;
-  // just append the framework template separator + fresh template below.
-  const hasAnyFwSection = frameworkSections.some(h => existing.includes(h));
-  if (!hasAnyFwSection) {
-    return existing.trimEnd() + '\n\n<!-- Chati.dev framework context (auto-managed) -->\n\n' + fresh;
+function mergeProjectContext(existing, fresh) {
+  const startMarker = '<!-- chati-context:start -->';
+  const endMarker = '<!-- chati-context:end -->';
+  const start = existing.indexOf(startMarker);
+  const end = existing.indexOf(endMarker);
+  if (start !== -1 && end !== -1 && end > start) {
+    return mergeManagedBlock(existing, fresh, startMarker, endMarker);
   }
 
-  // Otherwise, do section-level replacement — for each framework section in fresh,
-  // replace the corresponding section in existing (or append if missing).
-  let merged = existing;
-  for (const header of frameworkSections) {
-    const freshSection = extractSection(fresh, header);
-    if (!freshSection) continue;
-    if (merged.includes(header)) {
-      merged = replaceSection(merged, header, freshSection);
-    } else {
-      merged = merged.trimEnd() + '\n\n' + freshSection;
+  // Repair pre-install Magic Docs files and partially damaged managed blocks.
+  // Keep runtime state and custom notes, but remove orphaned managed metadata
+  // before placing one valid canonical block at the top.
+  const hadManagedMetadata = existing.includes(startMarker)
+    || existing.includes(endMarker)
+    || (existing.includes('## Project Context') && existing.includes('No primary harness is configured'));
+  let preserved = existing
+    .replaceAll(startMarker, '')
+    .replaceAll(endMarker, '');
+  if (hadManagedMetadata) {
+    preserved = preserved.replace(/^# [^\n]+\n+(?=## Project Context)/m, '');
+  }
+  preserved = removeSection(preserved, '## Project Context');
+  preserved = removeSection(preserved, '## Chati.dev');
+  preserved = preserved.replace(/^\s+/, '').replace(/\n{3,}/g, '\n\n').trimEnd();
+  return mergeManagedBlock(preserved, fresh, startMarker, endMarker);
+}
+
+function mergeManagedBlock(existing, fresh, startMarker, endMarker) {
+  const existingStart = existing.indexOf(startMarker);
+  const existingEnd = existing.indexOf(endMarker);
+  if (existingStart !== -1 && existingEnd !== -1 && existingEnd > existingStart) {
+    return existing.slice(0, existingStart)
+      + fresh.trimEnd()
+      + existing.slice(existingEnd + endMarker.length);
+  }
+  const preserved = existing.trimEnd();
+  return preserved ? `${fresh.trimEnd()}\n\n${preserved}\n` : fresh;
+}
+
+const LEGACY_MANAGED_HEADERS = [
+  '## Project Context',
+  '## Session Lock',
+  '## Current State',
+  '## Recent Decisions',
+  '## How to Resume',
+  '## Framework',
+  '## Chati.dev',
+];
+
+const LEGACY_ROOT_ONLY_HEADERS = [
+  '## Project Overview',
+  '## Quick Start',
+  '## Key References',
+  '## Pipeline',
+];
+
+const LEGACY_APPEND_MARKER = '<!-- Chati.dev framework context (auto-managed) -->';
+
+function looksLikeLegacyChatiContext(content) {
+  if (content.includes('<!-- chati-claude:start -->')) return false;
+  const exactLegacyRoot = /^# Chati\.dev Project Context\s*$/m.test(content);
+  const hasRuntimeFingerprint = content.includes('.chati/session.yaml')
+    || content.includes('<!-- SESSION-LOCK:')
+    || /(?<![.\w])\/chati(?![-/\w])/.test(content);
+  const hasLegacySection = content.includes('## Chati.dev')
+    || content.includes('Chati.dev framework context');
+  return (exactLegacyRoot && hasRuntimeFingerprint)
+    || (hasLegacySection && hasRuntimeFingerprint);
+}
+
+function stripLegacyStateSections(content) {
+  const markerIndex = content.indexOf(LEGACY_APPEND_MARKER);
+  if (markerIndex !== -1) {
+    let authoredPrefix = content.slice(0, markerIndex).trimEnd();
+    const currentState = extractSection(authoredPrefix, '## Current State');
+    // Magic Docs v1 inserted its generated state before the first authored ##
+    // heading. With an appended legacy Chati block this placed managed state
+    // above the marker, so dropping only the suffix left a frozen second source
+    // of truth in CLAUDE.md. Remove only the unmistakable generated shape and
+    // preserve a user-authored Current State section.
+    if (isLegacyMagicDocsState(currentState)) {
+      authoredPrefix = authoredPrefix.replace(currentState, '')
+        .replace(/\n{3,}/g, '\n\n')
+        .trimEnd();
     }
+    return authoredPrefix ? `${authoredPrefix}\n` : '';
   }
-  return merged;
+
+  const headers = /^# Chati\.dev Project Context\s*$/m.test(content)
+    ? [...LEGACY_MANAGED_HEADERS, ...LEGACY_ROOT_ONLY_HEADERS]
+    : LEGACY_MANAGED_HEADERS;
+  return headers
+    .reduce((result, header) => removeSection(result, header), content)
+    .replace(/^# Chati\.dev Project Context\s*\n?/m, '')
+    .replace(/\n?---\s*\n\*This file is auto-updated by each agent[^\n]*\*\s*$/m, '')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim() + '\n';
+}
+
+function isLegacyMagicDocsState(section) {
+  if (!section) return false;
+  const hasTimestamp = /^- \*\*Last Updated\*\*: \d{4}-\d{2}-\d{2}\s*$/m.test(section);
+  const hasRuntimeField = /^- \*\*(?:Agent|Pipeline|Task|Progress)\*\*:/m.test(section);
+  return hasTimestamp && hasRuntimeField;
 }
 
 function extractSection(content, header) {
+  if (!content) return null;
   const lines = content.split('\n');
   const startIdx = lines.findIndex(l => l.trim() === header);
   if (startIdx === -1) return null;
   let endIdx = startIdx + 1;
   while (endIdx < lines.length && !lines[endIdx].match(/^##\s/)) endIdx++;
-  return lines.slice(startIdx, endIdx).join('\n');
+  return lines.slice(startIdx, endIdx).join('\n').trimEnd();
 }
 
-function replaceSection(content, header, newSection) {
-  const lines = content.split('\n');
-  const startIdx = lines.findIndex(l => l.trim() === header);
-  if (startIdx === -1) return content;
-  let endIdx = startIdx + 1;
-  while (endIdx < lines.length && !lines[endIdx].match(/^##\s/)) endIdx++;
-  return [
-    ...lines.slice(0, startIdx),
-    newSection,
-    ...lines.slice(endIdx),
-  ].join('\n');
+function removeSection(content, header) {
+  const section = extractSection(content, header);
+  if (!section) return content;
+  return content.replace(section, '').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n';
+}
+
+function seedProjectContextFromLegacyClaude(fresh, legacyClaudeContent) {
+  if (!legacyClaudeContent || !looksLikeLegacyChatiContext(legacyClaudeContent)) return fresh;
+  const markerIndex = legacyClaudeContent.indexOf(LEGACY_APPEND_MARKER);
+  let currentState;
+  let recentDecisions;
+  if (markerIndex !== -1) {
+    const authoredPrefix = legacyClaudeContent.slice(0, markerIndex);
+    const managedSuffix = legacyClaudeContent.slice(markerIndex + LEGACY_APPEND_MARKER.length);
+    const prefixState = extractSection(authoredPrefix, '## Current State');
+    currentState = isLegacyMagicDocsState(prefixState)
+      ? prefixState
+      : extractSection(managedSuffix, '## Current State');
+    recentDecisions = extractSection(managedSuffix, '## Recent Decisions');
+  } else {
+    currentState = extractSection(legacyClaudeContent, '## Current State');
+    recentDecisions = extractSection(legacyClaudeContent, '## Recent Decisions');
+  }
+  const migrated = [
+    currentState,
+    recentDecisions,
+  ].filter(Boolean);
+  return migrated.length > 0 ? `${fresh.trimEnd()}\n\n${migrated.join('\n\n')}\n` : fresh;
 }
 
 /**

package/src/installer/provider-overlay.js

@@ -40,7 +40,7 @@ export function generateProviderOverlays(targetDir, frameworkSource, allProvider
       const srcPath = join(frameworkSource, file);
       if (!existsSync(srcPath)) continue;
 
-      // Read CANONICAL (Claude) content from source, then adapt for target provider
+      // Read provider-neutral canonical content, then add native harness mechanics.
       const canonicalContent = readFileSync(srcPath, 'utf-8');
       const installedContent = applyInstalledPathReplacement(canonicalContent);
       const adapted = adaptFrameworkFile(installedContent, file, provider);

package/src/installer/templates.js

@@ -1,10 +1,25 @@
 import * as yaml from 'js-yaml';
 
+const IDE_PROVIDER_MAP = Object.freeze({
+  'claude-code': 'claude',
+  'gemini-cli': 'gemini',
+  'codex-cli': 'codex',
+  'grok-cli': 'grok',
+});
+
+function configuredProviders(config) {
+  if (Array.isArray(config.allProviders) && config.allProviders.length > 0) {
+    return [...new Set(config.allProviders)];
+  }
+  return [...new Set((config.selectedIDEs || []).map(ide => IDE_PROVIDER_MAP[ide]).filter(Boolean))];
+}
+
 /**
  * Generate session.yaml content
  */
 export function generateSessionYaml(config) {
-  const { projectName, projectType, language, selectedIDEs, selectedMCPs, allProviders } = config;
+  const { projectName, projectType, language, selectedIDEs, selectedMCPs } = config;
+  const providers = configuredProviders(config);
 
   // Schema MUST match session-manager.js DEFAULT_SESSION fields,
   // otherwise validateSession() rejects installer-generated sessions.
@@ -27,7 +42,7 @@ export function generateSessionYaml(config) {
     user_level_confidence: 0.0,
     ides: selectedIDEs,
     mcps: selectedMCPs,
-    providers_enabled: allProviders && allProviders.length > 0 ? allProviders : ['claude'],
+    providers_enabled: providers,
     completed_agents: [],
     agent_results: {},
     mode_transitions: [],
@@ -82,57 +97,13 @@ export function generateSessionYaml(config) {
   return yaml.dump(session, { lineWidth: -1, quoteStyle: 'double', forceQuotes: false });
 }
 
-/**
- * Optimal model assignments per provider.
- * Deep reasoning agents (architect, qa, dev, detail, brownfield-wu) get the top model.
- * Lightweight agents (brief, phases, ux, greenfield-wu, devops, orchestrator) get the fast model.
- */
-export const PROVIDER_MODEL_MAPS = {
-  claude: {
-    deep: 'opus', light: 'sonnet', minimal: 'haiku',
-    agents: {
-      orchestrator: 'sonnet', 'greenfield-wu': 'haiku', 'brownfield-wu': 'opus',
-      brief: 'sonnet', detail: 'opus', architect: 'opus', ux: 'sonnet',
-      phases: 'sonnet', tasks: 'sonnet', 'qa-planning': 'opus',
-      dev: 'opus', 'qa-implementation': 'opus', 'qa-visual': 'opus', devops: 'sonnet',
-    },
-  },
-  gemini: {
-    deep: 'pro', light: 'flash', minimal: 'flash',
-    agents: {
-      orchestrator: 'flash', 'greenfield-wu': 'flash', 'brownfield-wu': 'pro',
-      brief: 'flash', detail: 'pro', architect: 'pro', ux: 'flash',
-      phases: 'flash', tasks: 'flash', 'qa-planning': 'pro',
-      dev: 'pro', 'qa-implementation': 'pro', 'qa-visual': 'pro', devops: 'flash',
-    },
-  },
-  codex: {
-    deep: 'codex', light: 'mini', minimal: 'mini',
-    agents: {
-      orchestrator: 'mini', 'greenfield-wu': 'mini', 'brownfield-wu': 'codex',
-      brief: 'mini', detail: 'codex', architect: 'codex', ux: 'mini',
-      phases: 'mini', tasks: 'mini', 'qa-planning': 'codex',
-      dev: 'codex', 'qa-implementation': 'codex', 'qa-visual': 'codex', devops: 'mini',
-    },
-  },
-  grok: {
-    deep: 'grok-4.6', light: 'grok-4.5', minimal: 'grok-4.3',
-    agents: {
-      orchestrator: 'grok-4.5', 'greenfield-wu': 'grok-4.3', 'brownfield-wu': 'grok-4.6',
-      brief: 'grok-4.5', detail: 'grok-4.6', architect: 'grok-4.6', ux: 'grok-4.5',
-      phases: 'grok-4.5', tasks: 'grok-4.5', 'qa-planning': 'grok-4.6',
-      dev: 'grok-4.6', 'qa-implementation': 'grok-4.6', 'qa-visual': 'grok-4.6', devops: 'grok-4.5',
-    },
-  },
-};
-
 /**
  * Generate config.yaml content
  */
 export function generateConfigYaml(config) {
-  const { version, projectType, language, allProviders } = config;
+  const { version, projectType, language } = config;
   const selectedIDEs = config.selectedIDEs || [];
-  const providers = allProviders && allProviders.length > 0 ? allProviders : ['claude'];
+  const providers = configuredProviders(config);
 
   const configData = {
     version: version,
@@ -164,7 +135,7 @@ export function generateConfigYaml(config) {
     tech_presets: true,
     doctor_autofix: true,
     brandbook: true,
-    // Intelligence Upgrade (v4.0.5 — Claude Code patterns)
+    // Intelligence Upgrade
     undercover_mode: true,
     memory_extraction: true,
     memory_consolidation: true,
@@ -175,11 +146,9 @@ export function generateConfigYaml(config) {
     model_fallback: true,
     frustration_detection: true,
     bash_security_checks: true,
-    // Agent Teams are planning-only in runtime v2.
-    // Only effective when the active session runs in Claude (gated in cli.js
-    // isAgentTeamsEnabled). Gemini and Codex always fall back to sequential
-    // pipeline silently. See plan: was previously false for "safe rollout"
-    // but the v4.2.0 launch never actually shipped, so this is a fresh start.
+    // Runtime v2 uses the strict provider-neutral parallel runner. The legacy
+    // native team path is available only for an explicitly active harness that
+    // supports it.
     agent_teams: true,
     team_planning_size: 4,
     ...(config.runtimeVersion === 2 ? {} : { team_build_size: 2 }),
@@ -197,20 +166,39 @@ export function generateConfigYaml(config) {
 }
 
 /**
- * Generate CLAUDE.md content (minimal — framework rules auto-loaded from .claude/rules/chati/)
+ * Generate the provider-neutral project context owned by Chati.dev.
+ * Provider harness files consume this artifact but never become its source.
  */
-export function generateClaudeMd(config) {
+export function generateProjectContext(config) {
   const { projectName, projectType, language } = config;
 
-  return `# ${projectName}
+  return `<!-- chati-context:start -->
+# ${projectName}
 
 ## Project Context
 - **Type**: ${projectType === 'greenfield' ? 'Greenfield (new project)' : 'Brownfield (existing project)'}
 - **Language**: ${language}
 
 ## Chati.dev
-Framework rules loaded from \`.claude/rules/chati/\`. Runtime state in \`CLAUDE.local.md\`.
-Type \`/chati\` to start.
+Provider and model routing is resolved per task from the signed installation
+capability snapshot. No primary harness is configured.
+<!-- chati-context:end -->
+`;
+}
+
+/**
+ * Generate the native Claude Code entry context. The shared project context
+ * remains in .chati/project-context.md and is imported instead of duplicated.
+ */
+export function generateClaudeMd(_config) {
+  return `<!-- chati-claude:start -->
+@.chati/project-context.md
+
+## Claude Code integration
+Framework rules are loaded from \`.claude/rules/chati/\`.
+Runtime session state is stored in \`CLAUDE.local.md\`.
+Type \`/chati\` to start or resume Chati.dev.
+<!-- chati-claude:end -->
 `;
 }
 
@@ -256,14 +244,15 @@ Parse the JSON output before responding:
 - When the action includes \`pipeline.spawn_command\`, execute that exact command.
   Never replace it with an inferred provider check or a manually constructed command.
 - A router-provided spawn command starts an external provider CLI. Execute it
-  with native escalated execution: set \`sandbox_permissions\` to
-  \`require_escalated\`, preserve the exact command and working directory, and
-  offer the narrow reusable prefix
-  \`["node", "<absolute path from spawn_command to run-agent.js>"]\`.
+  with the active harness's native process permissions, preserving the exact
+  command and working directory. If the harness sandboxes OS credentials,
+  request its native narrow approval for that command. Never invent a tool
+  parameter that the active harness does not support.
 - Do not run that provider command inside the workspace sandbox first. A
   \`PROVIDER_NOT_READY\` or \`PROVIDER_NOT_AUTHENTICATED\` result from a sandboxed
-  attempt is not proof that the user is logged out. Rerun it once with native
-  escalation before reporting an authentication failure.
+  attempt is not proof that the user is logged out. Rerun it once through the
+  harness's native approved execution path before reporting an authentication
+  failure.
 
 ## CRITICAL: Language Override
 
@@ -343,6 +332,7 @@ execute the full orchestrator at \`${orchPath}\`.
 Load this context:
 - \`.chati/session.yaml\`
 - \`AGENTS.md\`
+- \`.grok/session-lock.md\`
 - \`artifacts/handoffs/\`
 - \`.chati.dev/config.yaml\`
 

package/src/installer-v2/index.js

@@ -50,6 +50,8 @@ const ARTIFACT_KEYS = new Set([
 ]);
 const INSTALLATION_KEYS = new Set([
   'installation_id', 'profile', 'enabled_providers', 'capability_snapshot_ref',
+  // Read-only compatibility for early v2 artifacts. Current installers never
+  // emit these fields and runtime routing does not consume them.
   'policy_ref', 'primary_binding', 'primary_harness', 'external_integrations',
 ]);
 const BINDING_KEYS = new Set([