@sanqianx/project-knowledge 4.7.0 → 5.0.0

package/_site/lib/migration-service.js

@@ -1,442 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
-const { SCHEMAS, SCHEMA_VERSIONS, DomainError } = require('./contracts');
-const AtomicFile = require('./atomic-file');
-const { StorageLayout } = require('./storage-layout');
-const { defaultSettings, validateSettings } = require('./settings-store');
-const { emptyRegistry, validateRegistry } = require('./project-registry-store');
-const { defaultProjectConfig, defaultProjectState, validateProjectConfig, validateProjectState } = require('./project-store');
-const { LEGACY_ASSETS, getLegacyAsset, assetPath } = require('./legacy-data-manifest');
-const { STATES, classifyDataState } = require('./data-state-classifier');
-
-function hashBuffer(buffer) { return crypto.createHash('sha256').update(buffer).digest('hex'); }
-function hashFile(filePath) { return hashBuffer(fs.readFileSync(filePath)); }
-
-function copyRecursive(source, target) {
-  const stat = fs.statSync(source);
-  if (stat.isDirectory()) {
-    fs.mkdirSync(target, { recursive: true });
-    for (const entry of fs.readdirSync(source)) copyRecursive(path.join(source, entry), path.join(target, entry));
-    return;
-  }
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  fs.copyFileSync(source, target, fs.constants.COPYFILE_EXCL);
-}
-
-function removeOwnedPath(target) {
-  if (!fs.existsSync(target)) return;
-  fs.rmSync(target, { recursive: true, force: true });
-}
-
-function pruneEmptyParents(target, boundary) {
-  const root = path.resolve(boundary);
-  let current = path.dirname(path.resolve(target));
-  while (current !== root && current.startsWith(`${root}${path.sep}`)) {
-    if (!fs.existsSync(current) || fs.readdirSync(current).length > 0) break;
-    fs.rmdirSync(current);
-    current = path.dirname(current);
-  }
-}
-
-function deterministicProjectId(slug, config) {
-  const identity = String(config && (config.projectId || config.gitPath || config.localPath || config.repoPath) || slug);
-  const existing = String(config && config.projectId || '');
-  if (/^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$/.test(existing)) return existing;
-  return `project-${crypto.createHash('sha256').update(`${slug}\0${identity}`).digest('hex').slice(0, 20)}`;
-}
-
-function safeReadJson(filePath, fallback = null) {
-  if (!fs.existsSync(filePath)) return fallback;
-  try {
-    // Legacy files written via PowerShell/tooling often carry a UTF-8 BOM;
-    // JSON.parse rejects it, and a BOM must never fail the whole migration.
-    const raw = fs.readFileSync(filePath, 'utf8');
-    return JSON.parse(raw.charCodeAt(0) === 0xfeff ? raw.slice(1) : raw);
-  }
-  catch (error) { throw new DomainError('DATA_CORRUPT', 'Legacy migration source JSON is corrupt.', { status: 500, cause: error, details: { category: path.basename(filePath) } }); }
-}
-
-function sourceSnapshot(paths) {
-  const entries = [];
-  for (const source of paths) {
-    if (!fs.existsSync(source)) continue;
-    const stat = fs.statSync(source);
-    entries.push({
-      path: source,
-      kind: stat.isDirectory() ? 'directory' : 'file',
-      size: stat.size,
-      mtimeMs: stat.mtimeMs,
-      hash: stat.isFile() ? hashFile(source) : '',
-    });
-  }
-  return entries;
-}
-
-function verifySourceSnapshot(entries) {
-  for (const entry of entries) {
-    if (!fs.existsSync(entry.path)) return false;
-    const stat = fs.statSync(entry.path);
-    if (entry.kind === 'file' && (stat.size !== entry.size || hashFile(entry.path) !== entry.hash)) return false;
-  }
-  return true;
-}
-
-function directoryDigest(root) {
-  const hash = crypto.createHash('sha256');
-  const walk = current => {
-    for (const entry of fs.readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-      const item = path.join(current, entry.name);
-      hash.update(`${entry.isDirectory() ? 'd' : 'f'}:${path.relative(root, item).replace(/\\/g, '/')}\0`);
-      if (entry.isDirectory()) walk(item); else if (entry.isFile()) hash.update(fs.readFileSync(item));
-    }
-  };
-  walk(root);
-  return hash.digest('hex');
-}
-
-class MigrationService {
-  constructor(options = {}) {
-    this.layout = options.layout || new StorageLayout(options);
-    this.atomic = options.atomic || AtomicFile;
-    this.legacyDataDir = path.resolve(options.legacyDataDir || this.layout.getDataDir());
-    this.indexValidator = options.indexValidator || (async indexPath => ({ ok: fs.existsSync(indexPath) }));
-    this.logger = options.logger || { info() {}, warn() {}, error() {} };
-  }
-
-  completion() {
-    const completionPath = this.layout.getMigrationCompletionPath();
-    if (!fs.existsSync(completionPath)) return null;
-    const marker = this.atomic.readJsonStrict(completionPath, { category: 'layout-migration-completion' });
-    return marker && ['layout-migration-completion/v1', 'layout-migration-completion/v2'].includes(marker.schema) && marker.migrationId === SCHEMA_VERSIONS.layoutMigration
-      ? marker
-      : null;
-  }
-
-  completionMarker({ runId = '', registry, settings, modelsMigrated = false } = {}) {
-    const profiles = settings && settings.ai && Array.isArray(settings.ai.profiles) ? settings.ai.profiles : [];
-    return {
-      schema: 'layout-migration-completion/v2',
-      migrationId: SCHEMA_VERSIONS.layoutMigration,
-      runId,
-      sourceRoot: this.legacyDataDir,
-      sourceManifestHash: hashBuffer(Buffer.from(JSON.stringify(LEGACY_ASSETS.map(asset => [asset.source, asset.target, asset.kind])))),
-      projectCount: registry.projectOrder.length,
-      aiProfileCount: profiles.length,
-      knowledgeRootConfigured: Boolean(settings.knowledge && settings.knowledge.rootPath),
-      embeddingConfigured: Boolean(settings.embedding && Object.keys(settings.embedding).length),
-      modelsMigrated,
-      completedAt: new Date().toISOString(),
-      verified: true,
-    };
-  }
-
-  validateCompletedState(marker) {
-    try {
-      const registry = this.atomic.readJsonStrict(this.layout.getProjectRegistryPath(), { category: 'project-registry' });
-      validateRegistry(registry);
-      const settings = this.atomic.readJsonStrict(this.layout.getSettingsPath(), { category: 'settings' });
-      validateSettings(settings);
-      for (const projectId of registry.projectOrder) {
-        validateProjectConfig(this.atomic.readJsonStrict(this.layout.getProjectConfigPath(projectId), { category: 'project-config' }), projectId);
-        validateProjectState(this.atomic.readJsonStrict(this.layout.getProjectStatePath(projectId), { category: 'project-state' }));
-      }
-      // marker.projectCount is a migration-time snapshot only. Imports and
-      // deletions legitimately change the live registry count afterwards;
-      // comparing them here rejected every restart after the first legal
-      // project removal (completion-project-count-mismatch false positive).
-      return { ok: true, registry, settings };
-    } catch (error) { return { ok: false, reason: 'completion-state-invalid', error }; }
-  }
-
-  discover() {
-    const paths = LEGACY_ASSETS.map(asset => assetPath(this.legacyDataDir, asset)).filter(file => fs.existsSync(file));
-    const knowledgeStore = safeReadJson(path.join(this.legacyDataDir, 'knowledge-store.json'), {});
-    const indexCandidates = [
-      path.join(this.legacyDataDir, 'knowledge.lancedb'),
-      knowledgeStore && knowledgeStore.rootPath ? path.join(path.resolve(knowledgeStore.rootPath), '.project-knowledge', 'knowledge.lancedb') : '',
-    ].filter(Boolean);
-    const indexPath = indexCandidates.find(candidate => fs.existsSync(candidate)) || '';
-    if (indexPath) paths.push(indexPath);
-    return {
-      legacyProjectsPath: path.join(this.legacyDataDir, 'projects.json'),
-      knowledgeStore,
-      indexPath,
-      modelsPath: assetPath(this.legacyDataDir, getLegacyAsset('models')),
-      sources: sourceSnapshot(paths),
-    };
-  }
-
-  mergeLegacySettings(discovery) {
-    const settings = defaultSettings();
-    const read = name => safeReadJson(path.join(this.legacyDataDir, name), null);
-    const knowledge = read('knowledge-store.json');
-    const ai = read('ai-profiles.json');
-    const embedding = read('embedding-config.json');
-    const logging = read('logging.json');
-    const prompts = read('claude-prompts.json');
-    const github = read('github-team.json');
-    const providers = read('team-git-providers.json');
-    if (knowledge && typeof knowledge.rootPath === 'string') settings.knowledge.rootPath = knowledge.rootPath;
-    if (ai && typeof ai === 'object') settings.ai = ai;
-    if (embedding && typeof embedding === 'object') settings.embedding = embedding;
-    if (logging && typeof logging === 'object') {
-      if (Array.isArray(logging.levels)) settings.logging.levels = logging.levels;
-      settings.legacyExtensions.logging = { ...logging };
-    }
-    if (prompts && typeof prompts === 'object') settings.promptOverrides = prompts;
-    if (github || providers) settings.integrations = { ...(settings.integrations || {}), ...(github ? { githubTeam: github } : {}), ...(providers ? { teamGitProviders: providers } : {}) };
-    settings.updatedAt = new Date().toISOString();
-    return validateSettings(settings);
-  }
-
-  buildProjectRecords(legacyProjects, settings) {
-    const registry = emptyRegistry();
-    const records = [];
-    for (const [slug, rawConfig] of Object.entries(legacyProjects || {})) {
-      const legacy = rawConfig && rawConfig.config && typeof rawConfig.config === 'object' ? rawConfig.config : (rawConfig || {});
-      const projectId = deterministicProjectId(slug, legacy);
-      const knowledgePath = legacy.knowledgePath || legacy.kbPath || (settings.knowledge.rootPath ? path.join(path.resolve(settings.knowledge.rootPath), slug) : path.join(this.legacyDataDir, 'projects', slug));
-      const config = defaultProjectConfig(projectId, {
-        displayName: legacy.displayName || slug,
-        storageName: legacy.storageName || `${slug}-${projectId.slice(-6)}`,
-        repoPath: legacy.repoPath || legacy.gitPath || legacy.localPath || this.legacyDataDir,
-        knowledgePath,
-        enabled: legacy.enabled !== false,
-        createdAt: legacy.createdAt || new Date(0).toISOString(),
-        teamBinding: legacy.teamBinding || (legacy.teamKbId ? { teamKbId: legacy.teamKbId } : null),
-        aiProfileId: legacy.aiProfileId || null,
-        knowledgeLanguage: legacy.knowledgeLanguage || 'zh-CN',
-        relatedProjectIds: legacy.relatedProjectIds || [],
-        repoIdentity: legacy.repoIdentity || null,
-        legacyExtensions: { slug, sourceSchema: legacy.schema || '' },
-      });
-      const hasTracking = Boolean(legacy.trackingStartCommit || legacy.lastAnalyzedCommit);
-      const state = defaultProjectState({
-        trackingStartCommit: legacy.trackingStartCommit || null,
-        lastAnalyzedCommit: legacy.lastAnalyzedCommit || null,
-        trackingMode: hasTracking ? 'normal' : (legacy.repoStatus === 'empty-repo' ? 'empty-repo' : 'normal'),
-        hook: { managedVersion: 0, migrationVersion: 0, lastVerifiedAt: '' },
-      });
-      validateProjectConfig(config, projectId);
-      validateProjectState(state);
-      registry.projectOrder.push(projectId);
-      registry.projects[projectId] = { createdAt: config.createdAt, displayNameSnapshot: config.displayName };
-      records.push({ slug, projectId, config, state });
-    }
-    registry.updatedAt = new Date().toISOString();
-    validateRegistry(registry);
-    return { registry, records };
-  }
-
-  injectFault(options, stage) {
-    if (options && options.faultAt === stage) throw new Error(`injected migration fault: ${stage}`);
-  }
-
-  async migrateIfNeeded(options = {}) {
-    const existingCompletion = this.completion();
-    if (existingCompletion) {
-      const verified = this.validateCompletedState(existingCompletion);
-      if (!verified.ok) return { ok: false, migrated: false, completed: false, requiresManualRecovery: true, reason: verified.reason, error: verified.error };
-      if (existingCompletion.schema === 'layout-migration-completion/v2') return { ok: true, migrated: false, completed: true, marker: existingCompletion };
-      const marker = this.completionMarker({ runId: existingCompletion.runId || 'v1-marker-upgrade', registry: verified.registry, settings: verified.settings, modelsMigrated: fs.existsSync(this.layout.getCachePath('models')) });
-      this.atomic.writeJsonAtomic(this.layout.getMigrationCompletionPath(), marker);
-      return { ok: true, migrated: false, completed: true, marker };
-    }
-    const state = classifyDataState(this.legacyDataDir);
-    if (state.state === STATES.FRESH) return { ok: true, migrated: false, completed: false, reason: 'fresh-install' };
-    if (state.state === STATES.CORRUPT || state.state === STATES.MIGRATION_INCOMPLETE) {
-      return { ok: false, migrated: false, completed: false, requiresManualRecovery: true, reason: state.state.toLowerCase() };
-    }
-    const discovery = this.discover();
-    this.injectFault(options, 'discovery');
-    // A user may have configured only AI/embedding/knowledge settings before
-    // ever importing a project. That is still legacy user data and must be
-    // migrated into an explicitly empty v2 registry, never treated as Fresh.
-    const legacyProjects = safeReadJson(discovery.legacyProjectsPath, {});
-    if (legacyProjects && legacyProjects.schema === SCHEMAS.projectRegistry && legacyProjects.schemaVersion === 2 && fs.existsSync(this.layout.getSettingsPath())) {
-      validateRegistry(legacyProjects);
-      const settings = this.atomic.readJsonStrict(this.layout.getSettingsPath(), { category: 'settings' });
-      validateSettings(settings);
-      const marker = this.completionMarker({ runId: 'validated-existing-v2', registry: legacyProjects, settings, modelsMigrated: fs.existsSync(this.layout.getCachePath('models')) });
-      this.atomic.writeJsonAtomic(this.layout.getMigrationCompletionPath(), marker);
-      return { ok: true, migrated: false, completed: true, marker };
-    }
-    if (state.state !== STATES.LEGACY) return { ok: false, migrated: false, completed: false, requiresManualRecovery: true, reason: 'legacy-state-not-migratable' };
-
-    const migrationId = options.migrationRunId || `layout-v2-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
-    const recoveryDir = this.layout.getRecoveryPath(migrationId);
-    const backupDir = path.join(recoveryDir, 'backup');
-    const stagingDir = path.join(recoveryDir, 'staging');
-    fs.mkdirSync(backupDir, { recursive: true });
-    fs.mkdirSync(stagingDir, { recursive: true });
-    const journalPath = path.join(recoveryDir, 'journal.json');
-    const journal = {
-      schema: SCHEMAS.migrationJournal,
-      migrationId: SCHEMA_VERSIONS.layoutMigration,
-      runId: migrationId,
-      phase: 'discovered',
-      startedAt: new Date().toISOString(),
-      sources: discovery.sources,
-      activated: [],
-    };
-    this.atomic.writeJsonAtomic(journalPath, journal);
-    const legacyRegistryBackup = path.join(backupDir, 'projects.json');
-    try {
-      for (const entry of discovery.sources) {
-        const relative = path.relative(this.legacyDataDir, entry.path);
-        const safeRelative = relative.startsWith('..') || path.isAbsolute(relative)
-          ? path.join('external', hashBuffer(Buffer.from(entry.path)).slice(0, 16), path.basename(entry.path))
-          : relative;
-        copyRecursive(entry.path, path.join(backupDir, safeRelative));
-      }
-      journal.phase = 'backed-up';
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      this.injectFault(options, 'backup');
-
-      const settings = this.mergeLegacySettings(discovery);
-      const projectData = this.buildProjectRecords(legacyProjects, settings);
-      const staged = [];
-      const stageJson = (relative, value) => {
-        const stagedPath = path.join(stagingDir, relative);
-        this.atomic.writeJsonAtomic(stagedPath, value);
-        staged.push({ relative, kind: 'file', hash: hashFile(stagedPath) });
-      };
-      stageJson('settings.json', settings);
-      for (const record of projectData.records) {
-        stageJson(path.join('projects', record.projectId, 'config.json'), record.config);
-        stageJson(path.join('projects', record.projectId, 'state.json'), record.state);
-      }
-      stageJson('projects.json', projectData.registry);
-      let modelsMigrated = false;
-      if (fs.existsSync(discovery.modelsPath)) {
-        const modelTarget = this.layout.getCachePath('models');
-        if (fs.existsSync(modelTarget)) {
-          if (directoryDigest(discovery.modelsPath) !== directoryDigest(modelTarget)) {
-            throw new DomainError('MIGRATION_TARGET_CONFLICT', 'Legacy model cache conflicts with the current model cache.', { status: 409, details: { category: 'cache/models' } });
-          }
-        } else {
-          const relative = path.join('cache', 'models');
-          copyRecursive(discovery.modelsPath, path.join(stagingDir, relative));
-          staged.push({ relative, kind: 'directory', hash: directoryDigest(path.join(stagingDir, relative)) });
-          modelsMigrated = true;
-        }
-      }
-      if (discovery.indexPath) {
-        const relative = path.join('index', 'knowledge.lancedb');
-        copyRecursive(discovery.indexPath, path.join(stagingDir, relative));
-        staged.push({ relative, kind: 'directory', hash: '' });
-      }
-      journal.staged = staged;
-      journal.projectMap = Object.fromEntries(projectData.records.map(record => [record.slug, record.projectId]));
-      journal.phase = 'staged';
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      this.injectFault(options, 'staging');
-
-      if (!verifySourceSnapshot(discovery.sources)) throw new DomainError('MIGRATION_SOURCE_CHANGED', 'Migration source changed while staging.', { status: 409 });
-      validateSettings(JSON.parse(fs.readFileSync(path.join(stagingDir, 'settings.json'), 'utf8')));
-      validateRegistry(JSON.parse(fs.readFileSync(path.join(stagingDir, 'projects.json'), 'utf8')));
-      for (const record of projectData.records) {
-        validateProjectConfig(JSON.parse(fs.readFileSync(path.join(stagingDir, 'projects', record.projectId, 'config.json'), 'utf8')), record.projectId);
-        validateProjectState(JSON.parse(fs.readFileSync(path.join(stagingDir, 'projects', record.projectId, 'state.json'), 'utf8')));
-      }
-      if (discovery.indexPath) {
-        const indexResult = await this.indexValidator(path.join(stagingDir, 'index', 'knowledge.lancedb'));
-        if (!indexResult || indexResult.ok !== true) throw new DomainError('MIGRATION_FAILED', 'Staged index validation failed.', { status: 500 });
-      }
-      journal.phase = 'validated';
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      this.injectFault(options, 'validation');
-
-      const activationOrder = staged.filter(item => item.relative !== 'projects.json');
-      const activationBackupDir = path.join(backupDir, 'activation-targets');
-      journal.activationTargets = activationOrder.map(item => {
-        const target = path.join(this.layout.getDataDir(), item.relative);
-        const existed = fs.existsSync(target);
-        if (item.kind === 'directory' && existed) {
-          throw new DomainError('MIGRATION_TARGET_CONFLICT', 'Migration target already exists.', { status: 409, details: { category: item.relative } });
-        }
-        if (existed) copyRecursive(target, path.join(activationBackupDir, item.relative));
-        return { relative: item.relative, kind: item.kind, existed };
-      });
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      for (const item of activationOrder) {
-        const source = path.join(stagingDir, item.relative);
-        const target = path.join(this.layout.getDataDir(), item.relative);
-        if (item.kind === 'directory') {
-          copyRecursive(source, target);
-        } else {
-          this.atomic.writeFileAtomic(target, fs.readFileSync(source));
-        }
-        journal.activated.push(item.relative);
-        this.atomic.writeJsonAtomic(journalPath, journal);
-      }
-      this.atomic.writeFileAtomic(this.layout.getProjectRegistryPath(), fs.readFileSync(path.join(stagingDir, 'projects.json')));
-      journal.activated.push('projects.json');
-      journal.phase = 'activated';
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      this.injectFault(options, 'activation');
-
-      validateSettings(this.atomic.readJsonStrict(this.layout.getSettingsPath(), { category: 'settings' }));
-      const openedRegistry = this.atomic.readJsonStrict(this.layout.getProjectRegistryPath(), { category: 'project-registry' });
-      validateRegistry(openedRegistry);
-      for (const projectId of openedRegistry.projectOrder) {
-        validateProjectConfig(this.atomic.readJsonStrict(this.layout.getProjectConfigPath(projectId), { category: 'project-config' }), projectId);
-        validateProjectState(this.atomic.readJsonStrict(this.layout.getProjectStatePath(projectId), { category: 'project-state' }));
-      }
-      journal.phase = 'open-verified';
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      this.injectFault(options, 'open-verification');
-
-      const marker = this.completionMarker({ runId: migrationId, registry: openedRegistry, settings: this.atomic.readJsonStrict(this.layout.getSettingsPath(), { category: 'settings' }), modelsMigrated });
-      this.atomic.writeJsonAtomic(this.layout.getMigrationCompletionPath(), marker);
-      journal.phase = 'completed';
-      journal.completedAt = marker.completedAt;
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      return { ok: true, migrated: true, completed: true, marker, recoveryDir, projectMap: journal.projectMap };
-    } catch (error) {
-      const rollbackErrors = [];
-      for (const targetInfo of [...(journal.activationTargets || [])].reverse()) {
-        const target = path.join(this.layout.getDataDir(), targetInfo.relative);
-        try {
-          if (targetInfo.existed) {
-            const backup = path.join(backupDir, 'activation-targets', targetInfo.relative);
-            if (targetInfo.kind === 'directory') {
-              removeOwnedPath(target);
-              copyRecursive(backup, target);
-            } else {
-              this.atomic.writeFileAtomic(target, fs.readFileSync(backup));
-            }
-          } else {
-            removeOwnedPath(target);
-            pruneEmptyParents(target, this.layout.getDataDir());
-          }
-        } catch (rollbackError) {
-          rollbackErrors.push({ target: targetInfo.relative, message: String(rollbackError.message || rollbackError) });
-        }
-      }
-      try {
-        if (fs.existsSync(legacyRegistryBackup)) {
-          this.atomic.writeFileAtomic(this.layout.getProjectRegistryPath(), fs.readFileSync(legacyRegistryBackup));
-        }
-      } catch (rollbackError) {
-        rollbackErrors.push({ target: 'projects.json', message: String(rollbackError.message || rollbackError) });
-      }
-      journal.phase = 'failed';
-      journal.failedAt = new Date().toISOString();
-      journal.error = { name: error.name || 'Error', code: error.code || '', message: String(error.message || error) };
-      journal.rollback = { ok: rollbackErrors.length === 0, errors: rollbackErrors };
-      this.atomic.writeJsonAtomic(journalPath, journal);
-      this.logger.error('migration.failed', { error, recoveryDir, rollbackErrors });
-      return { ok: false, migrated: false, completed: false, useLegacy: rollbackErrors.length === 0, recoveryDir, error, rollbackErrors };
-    }
-  }
-}
-
-module.exports = {
-  MigrationService,
-  deterministicProjectId,
-  hashFile,
-  sourceSnapshot,
-  verifySourceSnapshot,
-};

package/ui/app.css

@@ -1,58 +0,0 @@
-/* Visual baseline: docs/project-knowledge-v13-package/project-knowledge-base-faithful-repair-ui-v10.html */
-:root{--page:#eef2f6;--panel:#fff;--panel2:#f7f9fc;--line:#d8e1ea;--text:#142033;--muted:#64748b;--side:#f1f5f9;--side2:#e2e8f0;--sideText:#1e293b;--sideMuted:#64748b;--sideBorder:#cbd5e1;--sideHover:rgba(15,23,42,.05);--sideActive:rgba(15,23,42,.08);--accent:#4f6f8f;--accent2:#3e5e75;--good:#2f7d64;--warn:#9a7428;--bad:#af4b4b;--warnText:#a66a00;--badText:#c33b3b;--idle:#8794a6;--claude:#2563eb;--shadow:0 18px 50px rgba(15,23,42,.13)}
-html[data-theme="dark"]{--page:#0c1118;--panel:#141c26;--panel2:#192331;--line:#2a3849;--text:#e3ebf5;--muted:#94a3b8;--side:#080c11;--side2:#111923;--sideText:#d7e0ea;--sideMuted:#94a3b8;--sideBorder:rgba(255,255,255,.1);--sideHover:rgba(255,255,255,.05);--sideActive:rgba(255,255,255,.08);--accent:#7492a5;--accent2:#8da9ba;--good:#75b798;--warn:#c5a15d;--bad:#d36d6d;--warnText:#f2c75c;--badText:#ff7474;--idle:#8794a6;--claude:#60a5fa;--shadow:0 24px 60px rgba(0,0,0,.32)}
-*{box-sizing:border-box}button,input,select,textarea{font:inherit}button{color:inherit}[hidden]{display:none!important}
-body{overflow:hidden;background:var(--page);color:var(--text)}.shell{height:100vh;display:grid;grid-template-columns:310px minmax(0,1fr);background:var(--page)}
-.sidebar{height:100%;overflow:hidden;display:flex;flex-direction:column;background:var(--side);color:var(--sideText);border-right:1px solid var(--sideBorder)}
-.brand{padding:20px;border-bottom:1px solid var(--sideBorder)}.eyebrow{font-size:11px;text-transform:uppercase;letter-spacing:.18em;color:var(--sideMuted)}.brand h1{font-size:20px;margin:4px 0 0}.root{font:11px ui-monospace,SFMono-Regular,Consolas,monospace;color:var(--sideMuted);margin-top:8px;word-break:break-all}
-.project-area{min-height:0;flex:1;display:flex;flex-direction:column;padding:12px}.project-head{display:flex;align-items:center;justify-content:space-between;padding:0 4px 8px}.project-head span{font-size:11px;font-weight:650;text-transform:uppercase;letter-spacing:.14em;color:var(--sideMuted)}
-.small-btn{border:1px solid var(--sideBorder);background:var(--sideHover);color:var(--sideText);border-radius:8px;padding:5px 8px;font-size:11px}.project-list{min-height:0;overflow:auto}.project-card{width:100%;border:1px solid var(--sideBorder);background:var(--sideHover);color:var(--sideText);border-radius:12px;padding:11px 12px;margin-bottom:8px;text-align:left}.project-card.active{background:var(--sideActive);border-color:var(--accent)}.project-line{display:flex;gap:8px;justify-content:space-between}.project-name{font-size:13px;font-weight:650;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.project-id{font-size:11px;margin-top:3px;color:var(--sideMuted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.project-path{font:10px ui-monospace,SFMono-Regular,Consolas,monospace;margin-top:6px;color:var(--sideMuted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.dot{display:inline-block;width:8px;height:8px;border-radius:999px}.good{background:var(--good)}.idle{background:var(--idle)}.warn{background:var(--warn)}.claude{background:var(--claude);box-shadow:0 0 0 4px color-mix(in srgb,var(--claude) 12%,transparent)}
-.sidebar-nav{border-top:1px solid var(--sideBorder);padding:10px}.nav-btn{display:flex;width:100%;align-items:center;justify-content:space-between;border:0;background:transparent;color:var(--sideMuted);border-radius:9px;padding:9px 10px;text-align:left;font-size:13px}.nav-btn:hover,.nav-btn.active{background:var(--sideActive);color:var(--sideText)}.nav-badge{font-size:10px;padding:2px 6px;border-radius:999px;background:var(--sideHover)}
-.main{min-width:0;height:100%;overflow:hidden;padding:20px 26px 24px;display:flex;flex-direction:column}.main-header{flex:none;display:flex;align-items:center;justify-content:space-between;gap:16px;margin-bottom:18px}.subtitle{font-size:12px;color:var(--muted)}.page-title{font-size:24px;font-weight:650;margin-top:3px}.header-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap;justify-content:flex-end}
-.btn,.btn-primary,.btn-danger{border-radius:9px;padding:8px 11px;font-size:12px}.btn{border:1px solid var(--line);background:var(--panel2);color:var(--text)}.btn:hover{filter:brightness(.98)}.btn-primary{border:1px solid transparent;background:var(--accent);color:#fff}.btn-primary:hover{background:var(--accent2)}.btn-danger{border:1px solid color-mix(in srgb,var(--bad) 35%,transparent);background:color-mix(in srgb,var(--bad) 9%,transparent);color:var(--bad)}.input{border:1px solid var(--line);background:var(--panel);color:var(--text);border-radius:9px;padding:8px 10px;min-width:0}.view{min-height:0;flex:1;display:none}.view.active{display:flex}.panel{background:var(--panel);border:1px solid var(--line);border-radius:12px}.panel2{background:var(--panel2);border:1px solid var(--line);border-radius:10px}.muted{color:var(--muted)}.chip{display:inline-flex;align-items:center;gap:5px;border:1px solid var(--line);border-radius:999px;padding:3px 8px;font-size:10px;color:var(--muted);background:var(--panel2)}
-/* Workbench */
-.workbench{width:100%;min-height:0;display:flex;flex-direction:column;overflow:hidden}.workbench-head{display:flex;align-items:center;gap:8px;padding:10px 13px;border-bottom:1px solid var(--line);flex-wrap:wrap}.workbench-title{font-size:13px;font-weight:650}.workbench-session-controls{margin-left:auto;display:flex;align-items:center;gap:6px;min-width:0}.workbench-session{width:min(340px,32vw);height:30px;padding:4px 8px;font-size:10px}.btn.compact{height:30px;padding:0 9px;font-size:10px}.chat{min-height:0;flex:1;overflow:auto;background:var(--panel2);padding:14px;display:flex;flex-direction:column}.empty-chat{margin:auto;max-width:580px;padding:48px 24px;text-align:center;color:var(--muted);border:1px dashed var(--line);border-radius:12px;background:var(--panel)}.msg-row{display:flex;margin:0 0 12px}.msg-row.user{justify-content:flex-end}.bubble{max-width:88%;border:1px solid var(--line);border-radius:12px;padding:10px 12px;font-size:13px;line-height:1.55;background:var(--panel);white-space:pre-wrap;overflow-wrap:anywhere}.user .bubble{background:color-mix(in srgb,var(--accent) 12%,var(--panel));border-color:color-mix(in srgb,var(--accent) 30%,var(--line))}.tool-card{max-width:92%;font-size:11px}.tool-title{color:var(--warn);font-weight:650}.tool-code{margin-top:7px;background:#020617;color:#e2e8f0;border-radius:7px;padding:8px;font:10px ui-monospace,SFMono-Regular,Consolas,monospace;white-space:pre-wrap}.bubble.thinking{border-style:dashed;color:var(--muted);background:color-mix(in srgb,var(--panel2) 76%,var(--panel))}.bubble.status{max-width:92%;font-size:11px;color:var(--muted)}.bubble.permission{max-width:92%;border-color:color-mix(in srgb,var(--warn) 40%,var(--line))}.permission-actions{display:flex;gap:7px;margin-top:9px}.bubble.error{border-color:color-mix(in srgb,var(--bad) 40%,var(--line));color:var(--badText)}.composer{flex:none;border-top:1px solid var(--line);background:var(--panel2)}.composer-row{padding:9px;display:flex;gap:8px;align-items:flex-end}.composer textarea{resize:none;flex:1;max-height:120px;min-height:36px}.send{width:36px;height:36px;padding:0}.toolbar{display:flex;align-items:center;gap:6px;padding:0 9px 9px;font-size:10px;color:var(--muted)}.toolbtn{height:28px;border:0;background:transparent;color:var(--muted);border-radius:6px;padding:0 8px}.toolbtn:hover{background:var(--sideHover)}.token{border:1px solid var(--line);background:var(--panel);border-radius:7px;height:28px;display:flex;align-items:center;gap:6px;padding:0 8px}.mini-circle{width:14px;height:14px;border:3px solid color-mix(in srgb,var(--accent) 35%,transparent);border-top-color:var(--accent);border-radius:50%}
-/* V10 Mature Development Conversations: shared bridge UI, product-facing surface. */
-/* Import */
-.split{width:100%;min-height:0;display:grid;grid-template-columns:minmax(520px,1.25fr) minmax(300px,.75fr);gap:10px}.form-panel,.preview-panel{padding:20px;overflow:auto}.section-title{font-size:17px;font-weight:650}.section-help{font-size:12px;color:var(--muted);margin-top:4px}.form-grid{display:grid;gap:14px;margin-top:18px}.field{display:grid;gap:6px;font-size:12px}.field label{font-weight:600}.notice{border:1px solid var(--line);background:var(--panel2);border-radius:9px;padding:12px;font-size:12px}.notice strong{display:block;margin-bottom:6px}.notice.error{border-color:color-mix(in srgb,var(--bad) 35%,var(--line));color:var(--badText)}.preview-list{display:grid;gap:12px;margin-top:18px}.preview-item{padding:11px 12px}.preview-label{font-size:10px;color:var(--muted);text-transform:uppercase;letter-spacing:.08em}.preview-value{font-size:12px;margin-top:5px;word-break:break-all}.code{font-family:ui-monospace,SFMono-Regular,Consolas,monospace}
-/* V7 Logs: full-height mature run records. Severity uses row text color only; no dots/icons/left accents. */
-.record-toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-bottom:12px;flex:none}.record-toolbar .input{padding:8px 10px;font-size:11px}.record-toolbar .record-search{flex:1;min-width:190px}.record-shell{position:relative;flex:1;min-height:0;display:flex;flex-direction:column;border:1px solid var(--line);border-radius:11px;background:var(--panel);overflow:hidden}.record-list{flex:1;min-height:0;max-height:none;overflow-y:auto;overflow-x:hidden}.record-entry{border-bottom:1px solid color-mix(in srgb,var(--line) 72%,transparent)}.record-entry:last-child{border-bottom:0}.record-row{display:grid;grid-template-columns:minmax(0,1fr) 88px;column-gap:18px;align-items:start;width:100%;min-width:0;overflow:hidden;border:0;background:transparent;color:var(--text);padding:9px 12px;text-align:left}.record-row:hover{background:color-mix(in srgb,var(--panel2) 70%,transparent)}.record-main{min-width:0;overflow:hidden}.record-title{display:block;min-width:0;font-size:12px;line-height:1.4;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.record-meta{display:flex;min-width:0;max-width:100%;gap:7px;align-items:center;margin-top:3px;font-size:10px;color:var(--muted);white-space:nowrap;overflow:hidden}.record-project,.record-category{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.record-project{max-width:210px;flex:0 1 auto}.record-category{max-width:180px;flex:0 1 auto}.record-duration{flex:none}.record-meta-sep{flex:none;opacity:.45}.record-time{display:block;width:88px;min-width:88px;justify-self:end;text-align:right;white-space:nowrap;overflow:hidden;font:10px/1.4 ui-monospace,SFMono-Regular,Consolas,monospace;color:var(--muted)}.record-entry[data-level="trace"] .record-title,.record-entry[data-level="debug"] .record-title{color:color-mix(in srgb,var(--text) 76%,var(--muted))}.record-entry[data-level="warn"] .record-row,.record-entry[data-level="warn"] .record-title,.record-entry[data-level="warn"] .record-meta,.record-entry[data-level="warn"] .record-time{color:var(--warnText)}.record-entry[data-level="error"] .record-row,.record-entry[data-level="fatal"] .record-row,.record-entry[data-level="error"] .record-title,.record-entry[data-level="fatal"] .record-title,.record-entry[data-level="error"] .record-meta,.record-entry[data-level="fatal"] .record-meta,.record-entry[data-level="error"] .record-time,.record-entry[data-level="fatal"] .record-time{color:var(--badText)}.record-entry[data-level="error"] .record-title,.record-entry[data-level="fatal"] .record-title{font-weight:680}.record-entry[data-level="warn"] .record-title{font-weight:620}.record-detail{display:none;padding:10px 12px 12px;border-top:1px dashed var(--line);background:color-mix(in srgb,var(--panel2) 75%,transparent)}.record-entry.open .record-detail{display:block}.record-detail-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:7px 18px;font:10px/1.5 ui-monospace,SFMono-Regular,Consolas,monospace;color:var(--muted)}.record-detail-grid span{min-width:0;overflow-wrap:anywhere}.record-detail-grid b{color:var(--text);font-weight:650}.record-detail-message{margin-top:9px;padding-top:9px;border-top:1px solid var(--line);font-size:11px;line-height:1.55;color:var(--text);overflow-wrap:anywhere}.record-detail-actions{display:flex;gap:6px;margin-top:9px}.record-footer{display:flex;justify-content:space-between;align-items:center;gap:10px;padding:8px 12px;border-top:1px solid var(--line);background:var(--panel2);font-size:10px;color:var(--muted)}.record-empty{display:none;padding:32px 16px;text-align:center;color:var(--muted);font-size:12px}.new-records{display:none;position:absolute;right:18px;bottom:44px;z-index:4;border:1px solid var(--line);border-radius:999px;background:var(--panel);color:var(--text);box-shadow:0 8px 24px rgba(2,6,23,.18);padding:7px 11px;font-size:11px;cursor:pointer}.new-records.show{display:block}.record-note{color:var(--muted);font-size:10px}.record-sync-warning{display:none;margin-bottom:10px;border:1px solid color-mix(in srgb,var(--warn) 35%,var(--line));border-radius:8px;padding:8px 10px;color:var(--warnText);font-size:11px;background:color-mix(in srgb,var(--warn) 7%,transparent)}.record-sync-warning.show{display:block}
-.settings-error-count,.header-error-dot{display:none}
-/* Drawers/modal */
-.backdrop{position:fixed;inset:0;background:rgba(2,6,23,.42);z-index:40;display:none}.backdrop.show{display:block}.drawer{position:fixed;z-index:50;inset:0 0 0 auto;width:min(920px,100vw);height:100vh;min-height:0;background:var(--panel);border-left:1px solid var(--line);box-shadow:-24px 0 64px rgba(2,6,23,.22);display:none;grid-template-columns:170px minmax(0,1fr)}.drawer.show{display:grid}.settings-nav{min-height:0;padding:20px 12px;background:var(--panel2);border-right:1px solid var(--line);overflow:auto;display:flex;flex-direction:column}.settings-nav h3{font-size:16px;margin:0 8px 13px}.settings-nav button{width:100%;border:0;background:transparent;color:var(--muted);border-radius:8px;padding:9px 10px;text-align:left;font-size:12px;margin-top:3px}.settings-nav button.active,.settings-nav button:hover{background:var(--panel);color:var(--text)}.settings-content{min-width:0;min-height:0;height:100%;overflow:hidden;padding:22px;display:flex;flex-direction:column}.drawer-head{flex:none;display:flex;justify-content:space-between;gap:12px;align-items:start;border-bottom:1px solid var(--line);padding-bottom:14px;margin-bottom:18px}.drawer-head h2{font-size:18px;margin:0}.settings-section{display:none;min-height:0}.settings-section.active{display:block;flex:1;min-height:0;overflow:auto}.settings-card{padding:15px;margin-bottom:12px}#settings-logs.active{display:flex;flex:1;min-height:0;overflow:hidden}#settings-logs>.settings-card{flex:1;min-height:0;margin-bottom:0;display:flex;flex-direction:column;overflow:hidden}.grid2{display:grid;grid-template-columns:1fr 1fr;gap:12px}.project-assign{display:flex;justify-content:space-between;gap:12px;align-items:center;padding:10px;margin-top:8px}.danger-zone{border-color:color-mix(in srgb,var(--bad) 30%,var(--line))}
-.context-menu{position:fixed;z-index:70;width:190px;padding:5px;border:1px solid var(--line);border-radius:9px;background:var(--panel);box-shadow:var(--shadow);display:none}.context-menu.show{display:block}.context-menu button{width:100%;border:0;background:transparent;color:var(--bad);padding:9px;border-radius:7px;text-align:left}.context-menu button:hover{background:color-mix(in srgb,var(--bad) 9%,transparent)}
-dialog{width:min(620px,calc(100% - 32px));border:1px solid var(--line);border-radius:12px;background:var(--panel);color:var(--text);box-shadow:var(--shadow);padding:0}dialog::backdrop{background:rgba(2,6,23,.45)}.dialog-head{display:flex;justify-content:space-between;align-items:center;padding:16px 18px;border-bottom:1px solid var(--line)}.dialog-head h3{margin:0;font-size:16px}.dialog-body{padding:16px 18px;display:grid;gap:12px}.dialog-foot{display:flex;justify-content:flex-end;gap:8px;padding:14px 18px;border-top:1px solid var(--line)}.check{display:flex;gap:8px;align-items:center;font-size:12px}
-.mobile-strip{display:none}
-@media(max-width:1180px){.shell{grid-template-columns:260px minmax(0,1fr)}.split{grid-template-columns:1fr}.preview-panel{display:none}.health-stats{grid-template-columns:repeat(2,1fr)}}
-@media(max-width:760px){body{overflow:auto}.shell{display:block;height:auto;min-height:100vh}.sidebar{display:none}.main{height:auto;min-height:100vh;padding:15px}.main-header{position:sticky;top:0;z-index:20;background:color-mix(in srgb,var(--page) 94%,transparent);backdrop-filter:blur(12px);padding:12px 0}.mobile-strip{display:flex;gap:7px;overflow:auto;margin-bottom:12px}.mobile-strip select{flex:1;min-width:0}.mobile-strip button{flex:none}.workbench-session-controls{order:3;width:100%;margin-left:0}.workbench-session{flex:1;width:auto;min-width:0}.drawer{height:100dvh;grid-template-columns:1fr;grid-template-rows:auto minmax(0,1fr)}.settings-nav{display:flex;flex-direction:row;padding:8px;overflow:auto;border-right:0;border-bottom:1px solid var(--line)}.settings-nav h3{display:none}.settings-nav button{width:auto;white-space:nowrap;margin:0}.grid2{grid-template-columns:1fr}}
-@media(max-width:760px){.record-row{grid-template-columns:minmax(0,1fr) 76px;column-gap:12px;padding:9px 10px}.record-time{width:76px;min-width:76px}.record-project{max-width:130px}.record-category{max-width:100px}.record-meta{gap:5px}.record-detail{padding:9px 10px}.record-detail-grid{grid-template-columns:1fr}.record-toolbar .record-search{min-width:100%;order:4}.record-footer{align-items:flex-start;flex-direction:column}.record-title{white-space:normal;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical}}
-@media(prefers-reduced-motion:reduce){*,*::before,*::after{scroll-behavior:auto!important;transition:none!important;animation:none!important}}
-
-/* ===== 模块嵌入（T2）：视图、状态灯、联动 chip、折叠图标、会话子列表 ===== */
-.view.active{flex-direction:column}
-.embed-head{flex:none;display:flex;gap:10px;align-items:center;flex-wrap:wrap;margin-bottom:10px}
-.embed-status{display:inline-flex;align-items:center;gap:6px;border:1px solid var(--line);border-radius:999px;padding:3px 10px;font-size:11px;background:var(--panel)}
-.embed-status .st-dot{width:8px;height:8px;border-radius:99px;background:var(--idle)}
-.embed-status.ok .st-dot{background:var(--good)}
-.embed-status.down{border-color:color-mix(in srgb,var(--bad) 40%,var(--line));color:var(--badText)}
-.embed-open{text-decoration:none}
-.embed{flex:1;min-height:0;border:1px solid var(--line);border-radius:12px;overflow:hidden;background:var(--panel);position:relative}
-.embed iframe{width:100%;height:100%;border:0;display:block;background:#fff}
-.nav-fold{flex:none;width:22px;height:22px;border:1px solid var(--sideBorder);border-radius:6px;background:var(--sideHover);color:var(--sideMuted);font-size:11px;line-height:1;display:inline-flex;align-items:center;justify-content:center;cursor:pointer;user-select:none;margin-left:6px}
-.nav-fold:hover{color:var(--sideText);border-color:var(--accent)}
-.nav-fold.on{background:var(--sideActive);border-color:var(--accent);color:var(--sideText)}
-.project-item{margin-bottom:8px}
-.project-item .project-card{margin-bottom:0;width:100%}
-.proj-caret{flex:none;font-size:10px;color:var(--sideMuted);border:1px solid var(--sideBorder);border-radius:5px;padding:1px 5px;transition:transform .15s}
-.proj-caret.open{transform:rotate(90deg)}
-.proj-sessions{margin:-2px 4px 8px;border-left:2px solid var(--sideBorder);padding-left:8px;display:grid;gap:3px}
-.sess-row{display:flex;align-items:center;gap:6px;text-align:left;border:0;background:transparent;color:var(--sideMuted);border-radius:6px;padding:4px 7px;font-size:11px;cursor:pointer}
-.sess-title{flex:1;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.sess-agent{flex:none;font-size:10px;opacity:.7}
-.sess-row:hover{background:var(--sideActive);color:var(--sideText)}
-.sess-row:hover .sess-arch{display:inline}
-.sess-empty{font-size:10px;color:var(--sideMuted);padding:4px 7px}
-.module-badges{display:flex;gap:4px;margin-top:3px}
-.mbadge{font-size:9px;border:1px solid var(--sideBorder);border-radius:4px;padding:0 4px;color:var(--sideMuted)}
-.mbadge.on{color:var(--good);border-color:color-mix(in srgb,var(--good) 40%,var(--sideBorder))}
-.import-field-help{font-size:10px}