@sanqianx/project-knowledge 4.7.0 → 4.8.0

package/_modules/knowledge-engine/src/store.js

@@ -0,0 +1,239 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const { validateProjectId } = require('./runtime/contracts');
+const { RuntimeLayout } = require('./runtime/layout');
+
+/**
+ * 单文件 JSON 状态层（<data>/engine-state.json）：注册项目、分析运行、事件流。
+ * 任务、消费游标与受控写入元数据一起原子落盘，运行期凭据不进入本层。
+ */
+class EngineStore {
+  constructor(dataDir, options = {}) {
+    this.dataDir = dataDir;
+    this.file = path.join(dataDir, 'engine-state.json');
+    this.state = { schemaVersion: 2, projects: [], runs: [], events: [], cursor: 0, journalCursors: {}, memories: [], sharedScopes: [] };
+    if (!options.deferLoad) this.load();
+  }
+
+  load() {
+    try {
+      const raw = JSON.parse(fs.readFileSync(this.file, 'utf8'));
+      if (raw && (raw.schemaVersion === undefined || raw.schemaVersion === 1)) {
+        const backup = path.join(this.dataDir, `legacy-debug-state-${crypto.randomUUID()}.json`);
+        require('./runtime/atomic-file').writeJsonAtomic(backup, raw);
+        this.state.legacyStateBackup = backup;
+        this.save();
+        return;
+      }
+      if (raw?.schemaVersion !== 2) throw new Error('Unsupported engine state');
+      if (!raw || !Array.isArray(raw.projects) || !Array.isArray(raw.runs) || !Array.isArray(raw.events) || !Number.isSafeInteger(raw.cursor) || raw.cursor < 0) throw new Error('Invalid engine state');
+      if (raw.memories && !Array.isArray(raw.memories) || raw.sharedScopes && !Array.isArray(raw.sharedScopes) || raw.journalCursors && (typeof raw.journalCursors !== 'object' || Array.isArray(raw.journalCursors))) throw new Error('Invalid engine projections');
+      const ids = new Set();
+      for (const project of raw.projects) {
+        validateProjectId(project.projectId);
+        if (ids.has(project.projectId) || !path.isAbsolute(project.repoPath || '') || !path.isAbsolute(project.knowledgePath || '') || !project.runtime?.analysis || !project.runtime?.index) throw new Error('Invalid project runtime');
+        ids.add(project.projectId);
+      }
+      const runIds = new Set();
+      for (const run of raw.runs) {
+        validateProjectId(run.projectId);
+        if (!/^run-[a-f0-9-]{36}$/.test(run.runId || '') || runIds.has(run.runId) || !/^[a-f0-9]{40}$/.test(run.commitSha || '') || !['queued', 'running', 'failed', 'succeeded', 'index-pending'].includes(run.state) || !Number.isSafeInteger(run.sequence) || run.sequence < 1) throw new Error('Invalid queued run');
+        runIds.add(run.runId);
+      }
+      for (const [journalId, sequence] of Object.entries(raw.journalCursors || {})) if (!/^(global|sha256:[a-f0-9]{64})$/.test(journalId) || !Number.isSafeInteger(sequence) || sequence < 0) throw new Error('Invalid journal cursor');
+      for (const scope of raw.sharedScopes || []) if (!scope || !['brain', 'domain'].includes(scope.kind) || !path.isAbsolute(scope.knowledgePath || '')) throw new Error('Invalid shared scope');
+      for (const memory of raw.memories || []) if (!memory || !['candidate', 'confirmed', 'ignored'].includes(memory.status) || typeof memory.text !== 'string' || !memory.evidence?.projectId || !/^[a-f0-9]{40}$/.test(memory.evidence.commitSha || '')) throw new Error('Invalid memory record');
+      this.state = { ...this.state, ...raw };
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw Object.assign(new Error('引擎状态损坏，已保留原文件；请从备份恢复。'), { code: 'DATA_CORRUPT', cause: error });
+    }
+  }
+
+  isEmpty() {
+    return this.state.projects.length === 0 && this.state.runs.length === 0;
+  }
+
+  replace(next) {
+    this.state = next;
+    this.save();
+  }
+
+  save() {
+    fs.mkdirSync(this.dataDir, { recursive: true });
+    const tmp = this.file + '.tmp';
+    const fd = fs.openSync(tmp, 'w', 0o600);
+    try { fs.writeFileSync(fd, JSON.stringify(this.state, null, 2), 'utf8'); fs.fsyncSync(fd); }
+    finally { fs.closeSync(fd); }
+    fs.renameSync(tmp, this.file);
+  }
+
+  listProjects() {
+    return this.state.projects.slice();
+  }
+
+  getProject(projectId) {
+    return this.state.projects.find(p => p.projectId === projectId) || null;
+  }
+
+  addProject(input) {
+    validateProjectId(input.projectId);
+    const layout = new RuntimeLayout(this.dataDir);
+    if (!path.isAbsolute(input.repoPath || '') || !path.isAbsolute(input.knowledgePath || '')) throw Object.assign(new Error('代码目录和知识目录必须为绝对路径。'), { status: 400, code: 'INVALID_ARGUMENT' });
+    const existing = this.getProject(input.projectId);
+    if (input.knowledgeLanguage !== undefined && !['zh-CN', 'en-US'].includes(input.knowledgeLanguage)) throw Object.assign(new Error('知识语言无效。'), { status: 400, code: 'INVALID_ARGUMENT' });
+    if (this.state.runs.some(r => r.projectId === input.projectId && ['queued', 'running'].includes(r.state)) && existing
+      && (!layout.pathsEqual(existing.repoPath, input.repoPath) || !layout.pathsEqual(existing.knowledgePath, input.knowledgePath))) throw Object.assign(new Error('运行中不能改变目录绑定。'), { status: 409, code: 'PROJECT_BUSY' });
+    for (const project of this.state.projects) {
+      if (project.projectId !== input.projectId && (layout.isPathInside(project.knowledgePath, input.knowledgePath, { realpath: true }) || layout.isPathInside(input.knowledgePath, project.knowledgePath, { realpath: true }))) throw Object.assign(new Error('知识目录与已登记项目冲突。'), { status: 409, code: 'KNOWLEDGE_PATH_CONFLICT' });
+    }
+    for (const scope of this.state.sharedScopes) {
+      if (layout.isPathInside(scope.knowledgePath, input.knowledgePath, { realpath: true }) || layout.isPathInside(input.knowledgePath, scope.knowledgePath, { realpath: true })) throw Object.assign(new Error('项目目录不能占用共享知识目录。'), { status: 409, code: 'KNOWLEDGE_PATH_CONFLICT' });
+    }
+    // Registration is a projection, not a second settings/credential store.
+    const fields = { projectId: input.projectId, name: input.name || input.projectId, repoPath: path.resolve(input.repoPath), knowledgePath: path.resolve(input.knowledgePath), brainId: input.brainId || existing?.brainId || 'brain-default', knowledgeLanguage: input.knowledgeLanguage || existing?.knowledgeLanguage || 'zh-CN', enabled: input.enabled !== false };
+    for (const key of ['brainId', 'domainId', 'journalId', 'vectorProjectId', 'profileId', 'trackingStartCommit']) {
+      if (input[key] !== undefined) fields[key] = input[key] === null ? null : String(input[key]);
+    }
+    if (input.relatedProjectIds) fields.relatedProjectIds = input.relatedProjectIds.map(validateProjectId);
+    if (Number.isSafeInteger(input.conversationBaselineCursor)) fields.conversationBaselineCursor = input.conversationBaselineCursor;
+    if (input.conversationBaselineCursors) fields.conversationBaselineCursors = Object.fromEntries(Object.entries(input.conversationBaselineCursors).map(([id, cursor]) => {
+      if (!/^(global|sha256:[a-f0-9]{64})$/.test(id) || !Number.isSafeInteger(cursor) || cursor < 0) throw Object.assign(new Error('会话跟踪基线无效。'), { status: 400, code: 'INVALID_ARGUMENT' });
+      return [id, cursor];
+    }));
+    if (input.repoIdentity) fields.repoIdentity = Object.fromEntries(['schema', 'workspaceId', 'workspaceRoot', 'commonDir', 'remote'].map(key => [key, input.repoIdentity[key] == null ? null : String(input.repoIdentity[key])]));
+    if (existing) {
+      const priorBaselines = { ...(existing.runtime.conversationBaselineCursors || {}) };
+      if (!Object.hasOwn(priorBaselines, 'global')) priorBaselines.global = existing.runtime.conversationBaselineCursor ?? 0;
+      for (const [journalId, cursor] of Object.entries(fields.conversationBaselineCursors || {})) if (!Object.hasOwn(priorBaselines, journalId)) priorBaselines[journalId] = cursor;
+      existing.runtime.conversationBaselineCursors = priorBaselines;
+      delete fields.conversationBaselineCursor;
+      delete fields.conversationBaselineCursors;
+      Object.assign(existing, fields, { updatedAt: new Date().toISOString() });
+      this.save();
+      return { project: existing, reused: true };
+    }
+    const project = {
+      ...fields,
+      runtime: initialRuntime(input),
+      lastCommitSha: null,
+      lastRunAt: null,
+      createdAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString(),
+    };
+    this.state.projects.push(project);
+    this.save();
+    return { project, reused: false };
+  }
+
+  removeProject(projectId) {
+    if (this.state.runs.some(r => r.projectId === projectId && ['queued', 'running'].includes(r.state))) throw Object.assign(new Error('请等待当前维护运行结束后再解绑。'), { status: 409, code: 'PROJECT_BUSY' });
+    const before = this.state.projects.length;
+    this.state.projects = this.state.projects.filter(p => p.projectId !== projectId);
+    this.save();
+    return this.state.projects.length < before;
+  }
+
+  listRuns(projectId) {
+    const runs = projectId
+      ? this.state.runs.filter(r => r.projectId === projectId)
+      : this.state.runs;
+    return runs.slice().sort((a, b) => String(b.startedAt).localeCompare(String(a.startedAt)));
+  }
+
+  getRun(runId) {
+    return this.state.runs.find(r => r.runId === runId) || null;
+  }
+
+  addRun(input) {
+    if (!/^[a-f0-9]{40}$/i.test(input.commitSha || '')) throw Object.assign(new Error('必须提供完整的真实提交 SHA。'), { status: 400, code: 'INVALID_ARGUMENT' });
+    const prior = this.state.runs.find(r => r.projectId === input.projectId && r.commitSha === input.commitSha.toLowerCase());
+    if (prior) return prior;
+    const run = {
+      runId: 'run-' + crypto.randomUUID(),
+      projectId: input.projectId,
+      commitSha: input.commitSha.toLowerCase(),
+      trigger: input.trigger || 'manual',
+      note: input.note || '',
+      state: 'queued',
+      startedAt: new Date().toISOString(),
+      finishedAt: null,
+      durationMs: null,
+      error: null,
+      staging: null,
+      phase: 'queued',
+      sequence: this.state.runs.length + 1,
+      indexState: 'pending',
+      journalId: input.journalId || null,
+      journalSequence: input.journalSequence || null,
+    };
+    this.state.runs.push(run);
+    const project = this.getProject(input.projectId);
+    if (project) {
+      project.lastCommitSha = run.commitSha;
+      project.lastRunAt = run.startedAt;
+    }
+    this.save();
+    return run;
+  }
+
+  updateRun(runId, patch) {
+    const run = this.getRun(runId);
+    if (!run) return null;
+    Object.assign(run, patch);
+    if (run.finishedAt && run.state !== 'queued') {
+      run.durationMs = Math.max(0, new Date(run.finishedAt) - new Date(run.startedAt));
+    }
+    this.save();
+    return run;
+  }
+
+  addEvent(input) {
+    const event = {
+      seq: ++this.state.cursor,
+      type: input.type,
+      projectId: input.projectId || null,
+      summary: input.summary || '',
+      at: new Date().toISOString(),
+      runId: input.runId || null,
+      commitSha: input.commitSha || null,
+      phase: input.phase || null,
+    };
+    this.state.events.push(event);
+    if (this.state.events.length > 500) this.state.events = this.state.events.slice(-500);
+    this.save();
+    return event;
+  }
+
+  listEvents(limit) {
+    const cap = Math.max(1, Math.min(Number(limit) || 50, 500));
+    return this.state.events.slice(-cap).reverse();
+  }
+
+  readRuntime(projectId) {
+    const project = this.getProject(projectId);
+    if (!project) throw Object.assign(new Error('项目未登记。'), { code: 'PROJECT_NOT_FOUND', status: 404 });
+    return structuredClone(project.runtime || initialRuntime(project));
+  }
+
+  async updateRuntime(projectId, fn) {
+    const project = this.getProject(projectId);
+    const draft = this.readRuntime(projectId);
+    const result = fn(draft);
+    if (result && typeof result.then === 'function') throw new Error('Runtime mutations must be synchronous');
+    project.runtime = draft;
+    this.save();
+    return structuredClone(draft);
+  }
+
+  setJournalCursor(journalId, sequence) {
+    this.state.journalCursors[journalId] = Math.max(this.state.journalCursors[journalId] || 0, sequence);
+    this.save();
+  }
+}
+
+function initialRuntime(project = {}) { return { lastAnalyzedCommit: project.trackingStartCommit || null, conversationBaselineCursor: project.conversationBaselineCursor ?? null, conversationBaselineCursors: project.conversationBaselineCursors || {}, consumedRequirements: [], analysis: { status: 'idle', activeClaim: null, lastError: null }, index: { generation: 0, dirty: false, status: 'pending' } }; }
+
+module.exports = { EngineStore, initialRuntime };

package/_modules/knowledge-engine/ui/app.css

@@ -0,0 +1,172 @@
+/* 与 event-bridge / vector-hub 一致：灰阶四层、单一蓝与克制的语义色。 */
+:root {
+  --bg-side: #191a1d; --bg-main: #202125; --bg-card: #292a2f; --bg-card-raised: #2d2f35; --bg-input: #34363c;
+  --bg-hover: #303237; --bg-active: #393b42; --line: #3b3d44; --line-soft: #2d2f35; --text: #ebebed;
+  --text-2: #a9abb1; --text-3: #73757c; --label: #91939a; --blue: #5b93f7; --blue-soft: rgba(91, 147, 247, .13);
+  --green: #42cf9d; --green-soft: rgba(66, 207, 157, .11); --red: #ec776c; --red-soft: rgba(236, 119, 108, .12);
+  --amber: #e8ae5c; --amber-soft: rgba(232, 174, 92, .12); --mono: Consolas, "Microsoft YaHei", monospace;
+}
+* { box-sizing: border-box; margin: 0; padding: 0; }
+.debug-only { display: none !important; }
+.engine-debug .debug-only { display: flex !important; }
+body.kb-embedded:not([data-kb-theme="dark"]) {
+  --bg-side: #f8f9fb; --bg-main: #ffffff; --bg-card: #ffffff; --bg-card-raised: #f8f9fb; --bg-input: #edf1f4;
+  --bg-hover: #edf1f4; --bg-active: #e6edf3; --line: #dce2e8; --line-soft: #dce2e8;
+  --text: #202733; --text-2: #687587; --text-3: #8e99a7; --label: #687587;
+  --blue: #516f89; --blue-soft: #e6edf3; --green: #397761; --green-soft: #edf6f1; --red: #a05252; --red-soft: #fbeeee;
+  color-scheme: light;
+}
+body.kb-embedded[data-kb-theme="dark"] { --bg-side:#1b2028; --bg-main:#20252d; --bg-card:#252b34; --bg-card-raised:#2c333e; --bg-input:#2c333e; --bg-hover:#2c333e; --bg-active:#293748; --line:#39424f; --line-soft:#39424f; --text:#e6ebf0; --text-2:#a0aaba; --text-3:#788393; --label:#a0aaba; --blue:#8aa8cf; --blue-soft:#293748; --green:#81b29a; --red:#d88b8b; }
+.kb-embedded aside { width: 208px; min-width: 208px; }
+.kb-embedded .brand { display: none; }
+.kb-embedded #btnShowRegister, .kb-embedded #registerForm, .kb-embedded [data-del] { display: none; }
+.kb-embedded main { padding: 24px 32px; max-width: none; }
+.kb-embedded .metric strong { font-size: 24px; }
+html, body { min-height: 100%; }
+body { background: var(--bg-main); color: var(--text); font: 13px/1.55 -apple-system, BlinkMacSystemFont, "Segoe UI", "Microsoft YaHei", sans-serif; color-scheme: dark; }
+button, input, select { font: inherit; }
+button { color: inherit; background: none; border: 0; cursor: pointer; }
+button:focus-visible, input:focus-visible, select:focus-visible { outline: 2px solid var(--blue); outline-offset: 2px; }
+::-webkit-scrollbar { width: 10px; height: 10px; }
+::-webkit-scrollbar-thumb { background: #4a4c53; border: 3px solid transparent; border-radius: 99px; background-clip: content-box; }
+.hidden { display: none !important; }
+.mono { color: var(--text-2); font-family: var(--mono); font-size: 11.5px; }
+
+#app { display: flex; min-height: 100vh; }
+aside { width: 224px; min-width: 224px; background: var(--bg-side); border-right: 1px solid var(--line-soft); display: flex; flex-direction: column; position: sticky; top: 0; height: 100vh; }
+.brand { display: flex; align-items: center; gap: 9px; padding: 17px 15px 16px; border-bottom: 1px solid var(--line-soft); }
+.mark { height: 25px; width: 25px; display: grid; place-items: center; border-radius: 7px; background: var(--text); color: #17181b; font: 700 10px/1 var(--mono); }
+.brand-copy { display: grid; line-height: 1.2; }
+.brand-copy strong { font-size: 12px; font-weight: 600; }
+.brand-copy span { margin-top: 3px; color: var(--text-3); font-size: 10.5px; }
+.nav { flex: 1; padding: 13px 8px; overflow-y: auto; }
+.nav-label { padding: 0 10px 7px; color: var(--text-3); font-size: 10px; font-weight: 600; letter-spacing: .09em; text-transform: uppercase; }
+.nav-label-lower { margin-top: 17px; }
+.nav-item { width: 100%; display: flex; align-items: center; gap: 9px; padding: 8px 10px; border-radius: 6px; color: var(--text-2); font-size: 12.5px; text-align: left; }
+.nav-symbol { width: 14px; color: var(--text-3); font-family: var(--mono); text-align: center; }
+.nav-item:hover { background: var(--bg-hover); color: var(--text); }
+.nav-item.on { background: var(--bg-active); color: var(--text); }
+.nav-item.on .nav-symbol { color: var(--blue); }
+.side-foot { display: flex; align-items: center; gap: 8px; padding: 12px 15px; border-top: 1px solid var(--line-soft); color: var(--text-3); font-size: 11px; }
+.dot, .readiness-dot { width: 7px; height: 7px; flex: 0 0 auto; border-radius: 50%; background: var(--red); }
+.dot.up, .is-ok { background: var(--green); box-shadow: 0 0 0 3px var(--green-soft); }
+
+main { flex: 1; min-width: 0; padding: 28px clamp(22px, 4vw, 54px) 48px; }
+.topbar, .view { max-width: 1220px; margin: 0 auto; }
+.topbar { display: flex; align-items: end; justify-content: space-between; gap: 20px; padding-bottom: 22px; }
+.eyebrow, .section-kicker { color: var(--text-3); font-size: 10.5px; font-weight: 600; letter-spacing: .08em; text-transform: uppercase; }
+h1 { margin-top: 3px; font-size: 24px; font-weight: 600; line-height: 1.2; }
+h2 { font-size: 14px; font-weight: 600; line-height: 1.35; }
+.scope-control { display: grid; gap: 4px; min-width: 180px; color: var(--text-3); font-size: 10.5px; }
+select, input { min-width: 0; width: 100%; padding: 7px 9px; background: var(--bg-input); border: 1px solid var(--line); border-radius: 6px; color: var(--text); font-size: 12.5px; }
+select:focus, input:focus { border-color: var(--blue); outline: none; }
+.view { display: none; }
+.view.on { display: block; }
+.view-intro { display: flex; align-items: center; justify-content: space-between; gap: 18px; margin-bottom: 16px; color: var(--text-2); }
+.view-intro p { max-width: 720px; }
+.view-intro.compact { margin-bottom: 14px; }
+.btn { padding: 6px 11px; background: var(--bg-card-raised); border: 1px solid var(--line); border-radius: 6px; color: var(--text-2); font-size: 12px; white-space: nowrap; }
+.btn:hover { background: var(--bg-hover); color: var(--text); }
+.btn.primary { border-color: var(--blue); background: var(--blue); color: white; }
+.btn.primary:hover { filter: brightness(1.08); }
+.btn.danger:hover { border-color: var(--red); background: var(--red-soft); color: var(--red); }
+.quiet-link { color: var(--blue); font-size: 11.5px; }
+.quiet-link:hover { text-decoration: underline; }
+
+.panel, .flow-panel { background: var(--bg-card); border: 1px solid var(--line-soft); border-radius: 9px; padding: 15px 16px; }
+.panel-heading { display: flex; align-items: flex-start; justify-content: space-between; gap: 14px; margin-bottom: 13px; }
+.panel-heading h2 { margin-top: 2px; }
+.phase-pill, .badge { display: inline-flex; align-items: center; min-height: 20px; padding: 1px 8px; border-radius: 99px; font: 10.5px/1.5 var(--mono); white-space: nowrap; }
+.phase-pill { border: 1px solid var(--line); color: var(--text-3); }
+.flow-panel { margin-bottom: 12px; background: linear-gradient(110deg, var(--bg-card), #282b32); }
+.flow-track { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr)); list-style: none; overflow: hidden; border: 1px solid var(--line); border-radius: 7px; }
+.flow-step { position: relative; display: flex; gap: 10px; min-height: 78px; padding: 13px 11px; background: rgba(0,0,0,.06); border-right: 1px solid var(--line); }
+.flow-step:last-child { border-right: 0; }
+.flow-step::after { content: ""; position: absolute; right: -1px; top: 13px; height: 18px; border-right: 2px solid var(--blue); opacity: .78; }
+.flow-step:last-child::after { display: none; }
+.flow-step.is-active { background: var(--blue-soft); }
+.flow-step.is-done .flow-number { border-color: rgba(66,207,157,.55); color: var(--green); }
+.flow-step.is-active .flow-number { border-color: rgba(91,147,247,.7); color: var(--blue); }
+.flow-step.is-pending { opacity: .65; }
+.flow-number { width: 21px; height: 21px; flex: 0 0 21px; display: grid; place-items: center; border: 1px solid var(--line); border-radius: 50%; color: var(--text-3); font: 10px/1 var(--mono); }
+.flow-step strong { display: block; font-size: 12px; font-weight: 500; }
+.flow-step small { display: block; margin-top: 4px; color: var(--text-3); font-size: 10.5px; line-height: 1.35; }
+
+.metric-grid { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 10px; margin-bottom: 12px; }
+.metric { padding: 13px 15px; background: var(--bg-card); border: 1px solid var(--line-soft); border-radius: 8px; }
+.metric span, .metric small { display: block; }
+.metric span { color: var(--label); font-size: 11px; }
+.metric strong { display: block; margin: 2px 0; font: 600 23px/1.2 var(--mono); }
+.metric small { color: var(--text-3); font-size: 10.5px; }
+.metric-warn strong { color: var(--red); }
+.overview-grid { display: grid; grid-template-columns: minmax(0, 1.45fr) minmax(300px, .85fr); gap: 12px; align-items: start; }
+.table-wrap { overflow-x: auto; }
+table { width: 100%; border-collapse: collapse; font-size: 12px; }
+th { padding: 5px 8px 7px; border-bottom: 1px solid var(--line-soft); color: var(--label); font-size: 10.5px; font-weight: 500; text-align: left; white-space: nowrap; }
+td { padding: 8px; border-bottom: 1px solid var(--line-soft); vertical-align: top; }
+tbody tr:last-child td { border-bottom: 0; }
+tbody tr.click { cursor: pointer; }
+tbody tr.click:hover, tbody tr.sel { background: var(--bg-hover); }
+td.wrap { min-width: 170px; word-break: break-word; }
+.empty { padding: 16px; color: var(--text-3); text-align: center; }
+.badge.queued, .badge.running { background: var(--blue-soft); color: var(--blue); }
+.badge.running { animation: pulse 1.3s ease infinite; }
+.badge.succeeded { background: var(--green-soft); color: var(--green); }
+.badge.failed { background: var(--red-soft); color: var(--red); }
+.badge.type { border: 1px solid var(--line); color: var(--text-2); }
+@keyframes pulse { 50% { opacity: .55; } }
+.attention-body { min-height: 48px; margin: -2px 0 12px; color: var(--text-2); }
+.service-list { border-top: 1px solid var(--line-soft); font-size: 11.5px; }
+.service-list div { display: grid; grid-template-columns: 105px 1fr; gap: 8px; padding: 7px 0; border-bottom: 1px solid var(--line-soft); }
+.service-list div:last-child { border: 0; }
+.service-list dt { color: var(--text-3); }
+.service-list dd { min-width: 0; color: var(--text-2); overflow-wrap: anywhere; }
+
+.toolbar { display: flex; gap: 8px; margin-bottom: 12px; }
+.filters select { width: auto; min-width: 145px; }
+.form { margin-bottom: 12px; }
+.form-row { display: flex; gap: 10px; margin-bottom: 10px; }
+.form label { display: flex; flex: 1; flex-direction: column; gap: 4px; color: var(--label); font-size: 11px; }
+.form .checkbox { flex: 0 0 auto; flex-direction: row; align-items: center; gap: 7px; padding-top: 20px; color: var(--text-2); font-size: 12px; }
+.form .checkbox input { width: auto; }
+.form-actions { display: flex; gap: 8px; }
+.detail-grid { display: grid; grid-template-columns: minmax(225px, .7fr) minmax(0, 1.3fr); gap: 20px; }
+.kv div { display: grid; grid-template-columns: 92px minmax(0, 1fr); gap: 10px; padding: 5px 0; }
+.kv dt { color: var(--text-3); }
+.kv dd { min-width: 0; overflow-wrap: anywhere; }
+.panel-sub { margin: 0 0 6px; color: var(--text-3); font-size: 10.5px; letter-spacing: .03em; text-transform: uppercase; }
+.code { max-height: 270px; padding: 10px; overflow: auto; background: var(--bg-side); border: 1px solid var(--line-soft); border-radius: 6px; color: var(--text-2); font: 11px/1.55 var(--mono); white-space: pre-wrap; word-break: break-word; }
+.run-timeline { display: grid; grid-template-columns: repeat(5, 1fr); gap: 6px; list-style: none; margin-bottom: 16px; }
+.run-timeline li { position: relative; padding: 7px 8px; border-left: 2px solid var(--line); color: var(--text-3); font-size: 11px; }
+.run-timeline li.done { border-color: var(--green); color: var(--green); }
+.run-timeline li.current { border-color: var(--blue); color: var(--blue); }
+.run-timeline li.failed { border-color: var(--red); color: var(--red); }
+
+.knowledge-hero { display: flex; align-items: end; justify-content: space-between; gap: 22px; margin-bottom: 12px; }
+.knowledge-path { max-width: 650px; margin-top: 5px; overflow-wrap: anywhere; }
+.knowledge-summary { min-width: 145px; text-align: right; }
+.knowledge-summary span, .knowledge-summary small { display: block; color: var(--text-3); font-size: 10.5px; }
+.knowledge-summary strong { display: block; margin: 2px 0; font: 600 16px/1.3 var(--mono); }
+.knowledge-list { display: grid; gap: 0; }
+.knowledge-operation { display: grid; grid-template-columns: 74px minmax(0, 1fr) auto; gap: 11px; align-items: start; padding: 10px 0; border-bottom: 1px solid var(--line-soft); }
+.knowledge-operation:last-child { border: 0; }
+.operation-kind { color: var(--blue); font: 10.5px/1.7 var(--mono); }
+.knowledge-operation strong { display: block; font: 12px/1.45 var(--mono); overflow-wrap: anywhere; }
+.knowledge-operation small { display: block; margin-top: 2px; color: var(--text-3); font-size: 11px; }
+.knowledge-operation em { color: var(--text-3); font-size: 10.5px; font-style: normal; white-space: nowrap; }
+.readiness-list > div { display: grid; grid-template-columns: 12px 1fr auto; gap: 9px; align-items: start; padding: 10px 0; border-bottom: 1px solid var(--line-soft); }
+.readiness-list > div:last-child { border: 0; }
+.readiness-dot { margin-top: 5px; }
+.readiness-dot.is-pending { background: var(--amber); box-shadow: 0 0 0 3px var(--amber-soft); }
+.readiness-list strong { display: block; font-size: 12px; font-weight: 500; }
+.readiness-list small { display: block; margin-top: 2px; color: var(--text-3); font-size: 11px; }
+.readiness-list b { color: var(--text-3); font: 10.5px/1.7 var(--mono); white-space: nowrap; }
+.answer { color: var(--text); line-height: 1.75; white-space: pre-wrap; }
+.citations { padding-left: 19px; color: var(--text-2); font-size: 11.5px; }
+.citations li { margin: 3px 0; }
+.score { color: var(--blue); font-family: var(--mono); }
+#toast { position: fixed; bottom: 18px; left: 50%; z-index: 5; max-width: min(92vw, 560px); padding: 8px 14px; transform: translateX(-50%) translateY(10px); background: var(--bg-card-raised); border: 1px solid var(--line); border-radius: 7px; color: var(--text); opacity: 0; pointer-events: none; transition: opacity .18s ease, transform .18s ease; }
+#toast.show { transform: translateX(-50%); opacity: 1; }
+
+@media (max-width: 980px) { .flow-track { grid-template-columns: 1fr; } .flow-step { min-height: auto; border-right: 0; border-bottom: 1px solid var(--line); } .flow-step:last-child { border-bottom: 0; } .flow-step::after { top: auto; bottom: -1px; right: auto; left: 16px; width: 18px; height: 0; border-right: 0; border-bottom: 2px solid var(--blue); } .metric-grid { grid-template-columns: repeat(2, 1fr); } .overview-grid { grid-template-columns: 1fr; } }
+@media (max-width: 720px) { #app { display: block; } aside { position: static; width: auto; min-width: 0; height: auto; } .brand { padding-bottom: 11px; } .nav { display: flex; gap: 3px; padding: 7px 8px; overflow-x: auto; } .nav-label, .nav-symbol, .side-foot { display: none; } .nav-item { width: auto; white-space: nowrap; } main { padding: 21px 15px 36px; } .topbar { align-items: start; } .scope-control { min-width: 130px; } h1 { font-size: 21px; } .view-intro, .knowledge-hero { align-items: flex-start; flex-direction: column; } .form-row, .detail-grid { display: grid; grid-template-columns: 1fr; } .form .checkbox { padding-top: 0; } .run-timeline { grid-template-columns: 1fr; } .knowledge-summary { text-align: left; } }