oh-my-knowledge 0.30.0 → 0.31.0

package/dist/src/cli/commands/observe/inbox.js

@@ -0,0 +1,258 @@
+import { resolve } from 'node:path';
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../oclif/base-command.js';
+import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
+import { integerStringParser } from '../../oclif/parsers.js';
+function pickSkillCount(value, skillName) {
+    if (!value || value[skillName] == null)
+        return undefined;
+    return { [skillName]: value[skillName] };
+}
+function pickSkillString(value, skillName) {
+    if (!value || value[skillName] == null)
+        return undefined;
+    return { [skillName]: value[skillName] };
+}
+function pickSkillToolCounts(value, skillName) {
+    if (!value || value[skillName] == null)
+        return undefined;
+    return { [skillName]: value[skillName] };
+}
+// runObserveInbox export:test/cli/observe.test.ts in-process import 验证 by-skill 聚合行为。
+export async function runObserveInbox(_args, flags, lang) {
+    const { queryObservationInbox, selectExploreInboxItems, loadLatestObservationInboxReports, summarizeObservationInboxBySkill, DEFAULT_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+    const dir = resolve(flags['input-dir'] || DEFAULT_OBSERVATIONS_DIR);
+    if (flags['llm-enhanced-review']) {
+        const { buildObservationInboxViewModel } = await import('../../../observability/inbox-view-model.js');
+        const { extractSkillSoftStandards, DEFAULT_SOFT_STANDARD_MODEL } = await import('../../../observability/soft-standards.js');
+        const view = buildObservationInboxViewModel(dir, { skill: flags.skill });
+        const candidates = Object.values(view.skillChains)
+            .map((chain) => ({ chain, runtimeEvidence: buildLlmEnhancedRuntimeEvidence(view, chain.skillName) }))
+            .filter(({ runtimeEvidence }) => hasLlmEnhancedRuntimeEvidence(runtimeEvidence));
+        const records = [];
+        for (const { chain, runtimeEvidence } of candidates) {
+            records.push(await extractSkillSoftStandards({
+                observationsDir: dir,
+                skillChain: chain,
+                runtimeEvidence,
+                model: flags.model || DEFAULT_SOFT_STANDARD_MODEL,
+                executorName: flags.executor,
+                refresh: flags.refresh,
+            }));
+        }
+        if (flags.json) {
+            console.log(JSON.stringify({ kind: 'observe-llm-enhanced-review', records }, null, 2));
+            return;
+        }
+        if (records.length === 0) {
+            console.log(lang === 'zh' ? '没有可用于 LLM 增强复盘的运行证据' : 'No runtime evidence is available for LLM enhanced review');
+            return;
+        }
+        console.log(lang === 'zh' ? 'LLM 增强复盘已生成:' : 'LLM enhanced review generated:');
+        for (const record of records) {
+            console.log(`- ${record.skillName} standards=${record.standards.length} model=${record.model} prompt=${record.promptId}/${record.promptVersion}`);
+        }
+        return;
+    }
+    let items = queryObservationInbox(dir);
+    if (flags.skill) {
+        items = items.filter((item) => item.skillName === flags.skill);
+    }
+    if (flags['by-skill']) {
+        const reports = flags.skill
+            ? loadLatestObservationInboxReports(dir).map((report) => ({
+                ...report,
+                meta: {
+                    ...report.meta,
+                    skillInvocationCounts: pickSkillCount(report.meta.skillInvocationCounts, String(flags.skill)),
+                    skillSessionCounts: pickSkillCount(report.meta.skillSessionCounts, String(flags.skill)),
+                    skillInvocationLastSeen: pickSkillString(report.meta.skillInvocationLastSeen, String(flags.skill)),
+                    skillToolCallCounts: pickSkillToolCounts(report.meta.skillToolCallCounts, String(flags.skill)),
+                },
+            }))
+            : loadLatestObservationInboxReports(dir);
+        const rows = summarizeObservationInboxBySkill(items, reports);
+        if (flags.json) {
+            console.log(JSON.stringify({ kind: 'observe-inbox-by-skill', rows }, null, 2));
+            return;
+        }
+        if (rows.length === 0) {
+            console.log(lang === 'zh' ? 'observe inbox 为空' : 'observe inbox is empty');
+            return;
+        }
+        console.log(lang === 'zh' ? 'observe inbox by skill:' : 'observe inbox by skill:');
+        for (const row of rows) {
+            console.log(`- ${row.skillName} invocations=${row.invocationCount} sessions=${row.sessionCount} processFindings=${row.observationCount} high=${row.highCount} medium=${row.mediumCount} low=${row.lowCount} noise=${row.noiseCount}${row.latestSeen ? ` latest=${row.latestSeen}` : ''}`);
+        }
+        return;
+    }
+    if (flags.explore) {
+        const n = Math.max(1, Number(flags.explore) || 10);
+        items = selectExploreInboxItems(items, n, flags['include-noise']);
+    }
+    else {
+        const limit = Math.max(1, Number(flags.limit ?? 20) || 20);
+        items = items.slice(0, limit);
+    }
+    if (flags.json) {
+        console.log(JSON.stringify({ kind: 'observe-inbox-query', items }, null, 2));
+        return;
+    }
+    if (items.length === 0) {
+        console.log(lang === 'zh' ? 'observe inbox 为空' : 'observe inbox is empty');
+        return;
+    }
+    console.log(lang === 'zh' ? 'observe inbox:' : 'observe inbox:');
+    for (const item of items) {
+        const evidence = item.evidence.query || item.evidence.path || item.evidence.assistantSnippet || item.evidence.outputSnippet || '';
+        const artifactVersion = item.artifactVersion === 'unknown' ? '⚠ unknown' : item.artifactVersion;
+        console.log(`- [${item.severity}] (${item.sourceKind}) ${item.skillName} ${item.signalType}/${item.signalSubtype} x${item.occurrences} confidence=${item.confidence.toFixed(2)} attribution=${item.attributionConfidence.toFixed(2)}`);
+        console.log(`  lastSeen=${item.lastSeen} version=${artifactVersion}`);
+        console.log(`  reason=${item.severityReasonCode ?? 'unknown'}`);
+        if (evidence)
+            console.log(`  evidence=${evidence.slice(0, 180)}`);
+    }
+    console.log('');
+    console.log(lang === 'zh'
+        ? 'Tip: omk observe inbox --explore 10  # 抽样查看 medium/low 长尾'
+        : 'Tip: omk observe inbox --explore 10  # sample medium/low long-tail items');
+    console.log(lang === 'zh'
+        ? 'Tip: omk observe inbox --explore 10 --include-noise  # 显式包含 noise 桶'
+        : 'Tip: omk observe inbox --explore 10 --include-noise  # explicitly include the noise bucket');
+}
+function hasLlmEnhancedRuntimeEvidence(evidence) {
+    return evidence.userMessages.length > 0
+        || evidence.goalSlices.some((goal) => Boolean(goal.inferredUserGoal || goal.userMessages?.length))
+        || evidence.assistantMessages.length > 0
+        || evidence.artifactCandidates.length > 0
+        || evidence.toolCalls.length > 0
+        || evidence.findings.length > 0;
+}
+function cleanEvidenceText(value) {
+    return (value ?? '').replace(/\s+/g, ' ').trim().slice(0, 800);
+}
+function eventText(event) {
+    return cleanEvidenceText(event?.snippet ?? event?.fullText);
+}
+function buildLlmEnhancedRuntimeEvidence(view, skillName) {
+    const reports = view.experienceReports;
+    const sessions = reports.flatMap((report) => report.sessions.filter((session) => session.skillName === skillName));
+    const invocations = reports.flatMap((report) => report.invocations.filter((invocation) => invocation.skillName === skillName));
+    const goalSlices = reports.flatMap((report) => report.goalSlices.filter((goal) => goal.skillName === skillName));
+    const timeline = invocations.flatMap((invocation) => invocation.timeline ?? []);
+    const userMessages = Array.from(new Set([
+        ...goalSlices.flatMap((goal) => goal.userMessageRefs.map((ref) => cleanEvidenceText(ref.snippet))),
+        ...sessions.map((session) => cleanEvidenceText(session.evidenceChain.firstUserMessage?.snippet)),
+        ...timeline.filter((event) => event.kind === 'user_message').map(eventText),
+    ].filter(Boolean))).slice(0, 12);
+    const assistantMessages = Array.from(new Set([
+        ...sessions.map((session) => cleanEvidenceText(session.evidenceChain.lastAssistantMessage?.snippet)),
+        ...timeline.filter((event) => event.kind === 'assistant_message').map(eventText),
+    ].filter(Boolean))).slice(0, 12);
+    const artifactCandidates = Array.from(new Set(timeline
+        .filter((event) => event.kind === 'assistant_message' && /(?:outputs\/runs|\.md\b|\.html\b|https?:\/\/|产物|文档|报告|方案路径|结果文件)/i.test(eventText(event)))
+        .map(eventText)
+        .filter(Boolean))).slice(0, 8);
+    const toolCalls = Array.from(new Set(timeline
+        .filter((event) => event.kind === 'tool_use')
+        .map((event) => cleanEvidenceText(`${event.toolName ?? 'tool'} ${event.snippet ?? event.fullText ?? ''}`))
+        .filter(Boolean))).slice(0, 12);
+    const findings = Array.from(new Set(sessions.flatMap((session) => [
+        ...(session.reviewerReport?.findings ?? []).map((finding) => cleanEvidenceText(`${finding.title}: ${finding.body}`)),
+        ...(session.ruleFindings ?? []).map((finding) => finding.code),
+    ]).filter(Boolean))).slice(0, 12);
+    return {
+        goalSlices: goalSlices.slice(0, 8).map((goal) => ({
+            id: goal.id,
+            sessionId: goal.sessionId,
+            inferredUserGoal: cleanEvidenceText(goal.inferredUserGoal),
+            userMessages: goal.userMessageRefs.map((ref) => cleanEvidenceText(ref.snippet)).filter(Boolean).slice(0, 5),
+        })),
+        userMessages,
+        assistantMessages,
+        artifactCandidates,
+        toolCalls,
+        findings,
+    };
+}
+export default class ObserveInbox extends BaseCommand {
+    static description = bilingual({
+        zh: '查询 observation inbox(skill 调用洞察）。',
+        en: 'Query observation inbox (skill invocation insights).',
+    });
+    static flags = {
+        lang: LANG_FLAG,
+        'input-dir': Flags.string({
+            description: bilingual({
+                zh: 'inbox 数据目录，默认 .omk/observations（项目级，相对于 cwd）；目录不存在时兜底读 ~/.oh-my-knowledge/observations。',
+                en: 'Inbox data dir, default .omk/observations (project-local); falls back to ~/.oh-my-knowledge/observations when missing.',
+            }),
+        }),
+        skill: Flags.string({
+            description: bilingual({ zh: '只看指定 skill', en: 'Filter to specific skill' }),
+        }),
+        limit: Flags.string({
+            description: bilingual({ zh: '限制条数，默认 20', en: 'Result limit, default 20' }),
+            parse: integerStringParser('--limit', { min: 1 }),
+        }),
+        explore: Flags.string({
+            description: bilingual({
+                zh: '抽样 N 条 medium/low 长尾（replaces limit）',
+                en: 'Sample N medium/low long-tail items (replaces limit)',
+            }),
+            parse: integerStringParser('--explore', { min: 1 }),
+        }),
+        'include-noise': Flags.boolean({
+            description: bilingual({
+                zh: 'explore 时也包含 noise 桶',
+                en: 'Include noise bucket in explore',
+            }),
+            default: false,
+        }),
+        'by-skill': Flags.boolean({
+            description: bilingual({
+                zh: '按 skill 聚合输出',
+                en: 'Aggregate output by skill',
+            }),
+            default: false,
+        }),
+        'llm-enhanced-review': Flags.boolean({
+            description: bilingual({
+                zh: '显式调用模型进行链路增强复盘，包含标准抽取、目标判断、类型判断、产物匹配和 owner 建议',
+                en: 'Explicitly run model-based enhanced chain review including standards, goals, skill type, artifact fit, and owner suggestions',
+            }),
+            default: false,
+        }),
+        refresh: Flags.boolean({
+            description: bilingual({
+                zh: '重新生成 LLM 增强复盘，不复用已有结果',
+                en: 'Refresh LLM enhanced review instead of reusing existing records',
+            }),
+            default: false,
+        }),
+        model: Flags.string({
+            description: bilingual({
+                zh: 'LLM 增强复盘使用的模型，默认 sonnet',
+                en: 'Model for LLM enhanced review, default sonnet',
+            }),
+        }),
+        executor: Flags.string({
+            description: bilingual({
+                zh: 'LLM 增强复盘使用的执行器',
+                en: 'Executor for LLM enhanced review',
+            }),
+        }),
+        json: Flags.boolean({
+            description: bilingual({ zh: 'JSON 格式输出', en: 'JSON output' }),
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ObserveInbox);
+        const lang = this.lang;
+        await this.runWithCliExit(async () => {
+            await runObserveInbox(args, { ...flags, lang }, lang);
+        });
+    }
+}
+//# sourceMappingURL=inbox.js.map

package/dist/src/cli/commands/observe/inbox.js.map

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

package/dist/src/cli/commands/observe/index.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../oclif/base-command.js';
+export default class Observe extends BaseCommand {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        sessionsDir: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        kb: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        last: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        skills: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli/commands/observe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/observe/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAQ1D,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IAC9C,MAAM,CAAC,WAAW,SAGf;IAEH,MAAM,CAAC,QAAQ;;;QAQb;IAEF,MAAM,CAAC,IAAI;;MAQT;IAEF,MAAM,CAAC,KAAK;;;;;;;;MA0BV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8D3B"}

package/dist/src/cli/commands/observe/index.js

@@ -0,0 +1,118 @@
+import { resolve, join } from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
+import { BaseCommand } from '../../oclif/base-command.js';
+import { CliExit } from '../../lib/cli-exit.js';
+import { tCli } from '../../lib/i18n.js';
+import { parseLastWindow } from '../../lib/shared.js';
+// oclif 版 observe 默认命令 — `omk observe <sessions-dir>` 走 health 分析。
+// 三个子命令(ingest / inbox / show)由 src/cli/commands/observe/ 文件目录托管。
+export default class Observe extends BaseCommand {
+    static description = bilingual({
+        zh: '分析 sessions 目录的 skill 调用健康度（默认行为）。子命令:ingest / inbox / show。',
+        en: 'Analyze skill invocation health from sessions dir (default). Subcommands: ingest / inbox / show.',
+    });
+    static examples = [
+        {
+            description: bilingual({
+                zh: '分析最近 7 天',
+                en: 'Analyze last 7 days',
+            }),
+            command: '<%= config.bin %> observe ~/.claude/sessions --last 7d',
+        },
+    ];
+    static args = {
+        sessionsDir: Args.string({
+            description: bilingual({
+                zh: 'sessions 目录路径（如 ~/.claude/sessions）',
+                en: 'Sessions dir path (e.g. ~/.claude/sessions)',
+            }),
+            required: false,
+        }),
+    };
+    static flags = {
+        lang: LANG_FLAG,
+        kb: Flags.string({
+            description: bilingual({ zh: '知识库 root，启用 KB-aware 分析', en: 'KB root, enables KB-aware analysis' }),
+        }),
+        last: Flags.string({
+            description: bilingual({ zh: '时间窗(7d / 24h / 30m）', en: 'Time window (7d / 24h / 30m)' }),
+        }),
+        from: Flags.string({
+            description: bilingual({ zh: '起始时间 ISO，优先级高于 --last', en: 'Start time ISO, overrides --last' }),
+        }),
+        to: Flags.string({
+            description: bilingual({ zh: '结束时间 ISO', en: 'End time ISO' }),
+        }),
+        skills: Flags.string({
+            description: bilingual({
+                zh: '只看指定 skill，逗号分隔',
+                en: 'Filter to specific skills, comma-separated',
+            }),
+        }),
+        'output-dir': Flags.string({
+            description: bilingual({
+                zh: '分析结果输出目录',
+                en: 'Analysis output directory',
+            }),
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Observe);
+        const lang = this.lang;
+        await this.runWithCliExit(async () => {
+            const dir = args.sessionsDir;
+            if (!dir) {
+                console.error(tCli('cli.help.observe', lang).trim());
+                throw new CliExit(1);
+            }
+            const tracePath = resolve(dir);
+            const { existsSync, mkdirSync, writeFileSync } = await import('node:fs');
+            if (!existsSync(tracePath)) {
+                console.error(`Trace path does not exist: ${tracePath}`);
+                throw new CliExit(1);
+            }
+            // 时间窗: --from/--to 优先, --last fallback
+            let from = flags.from;
+            if (!from && flags.last) {
+                const inferred = parseLastWindow(flags.last);
+                if (!inferred) {
+                    console.error(`Invalid --last format: "${flags.last}". Expected e.g. "7d" / "24h" / "30m".`);
+                    throw new CliExit(1);
+                }
+                from = inferred;
+            }
+            const to = flags.to;
+            const skills = flags.skills ? flags.skills.split(',').map((s) => s.trim()).filter(Boolean) : undefined;
+            console.log(`[omk] analyzing ${tracePath}...`);
+            const { computeSkillHealthReport } = await import('../../../observability/skill-health-analyzer.js');
+            const report = computeSkillHealthReport(tracePath, {
+                kbRoot: flags.kb ? resolve(flags.kb) : undefined,
+                from,
+                to,
+                skills,
+            });
+            // JSON 是主产物；HTML 由 report server 的 /analyses/:id 按需渲染。
+            const outDir = resolve(flags['output-dir'] || join(process.env.HOME || '.', '.oh-my-knowledge', 'analyses'));
+            mkdirSync(outDir, { recursive: true });
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            const jsonPath = join(outDir, `${timestamp}-skill-health.json`);
+            writeFileSync(jsonPath, JSON.stringify(report, null, 2));
+            const { sessionCount, segmentCount, toolCallCount, toolFailureRate } = report.meta;
+            console.log('');
+            console.log(`sessions: ${sessionCount} · segments: ${segmentCount} · tool calls: ${toolCallCount} · fail rate: ${(toolFailureRate * 100).toFixed(1)}%`);
+            console.log(`overall: gapRate ${(report.overall.gapRate * 100).toFixed(1)}% · weightedGapRate ${(report.overall.weightedGapRate * 100).toFixed(1)}% · health: ${report.overall.healthBand}`);
+            console.log('');
+            const skillRows = Object.values(report.bySkill)
+                .sort((a, b) => b.segmentCount - a.segmentCount)
+                .slice(0, 10)
+                .map((s) => `  ${s.skillName.padEnd(24)} segs=${String(s.segmentCount).padStart(4)}  gapRate=${String(Math.round(s.gap.gapRate * 100) + '%').padStart(4)}  weighted=${String(Math.round(s.gap.weightedGapRate * 100) + '%').padStart(4)}${s.coverage ? `  cov=${Math.round(s.coverage.fileCoverageRate * 100)}%` : ''}`);
+            console.log('top skills:');
+            console.log(skillRows.join('\n'));
+            console.log('');
+            console.log(`report written to: ${jsonPath}`);
+            console.log(tCli('cli.observe.view_hint', lang));
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/cli/commands/observe/index.js.map

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

package/dist/src/cli/commands/observe/ingest.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../oclif/base-command.js';
+export default class ObserveIngest extends BaseCommand {
+    static description: string;
+    static args: {
+        traceDir: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=ingest.d.ts.map

package/dist/src/cli/commands/observe/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/observe/ingest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,MAAM,CAAC,WAAW,SAGf;IAEH,MAAM,CAAC,IAAI;;MAQT;IAEF,MAAM,CAAC,KAAK;;;MAQV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAuC3B"}

package/dist/src/cli/commands/observe/ingest.js

@@ -0,0 +1,69 @@
+import { resolve } from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../oclif/base-command.js';
+import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
+import { CliExit } from '../../lib/cli-exit.js';
+export default class ObserveIngest extends BaseCommand {
+    static description = bilingual({
+        zh: '把 trace 目录 ingest 成 observation inbox 报告。',
+        en: 'Ingest trace dir into observation inbox report.',
+    });
+    static args = {
+        traceDir: Args.string({
+            description: bilingual({
+                zh: 'trace 目录路径。',
+                en: 'Trace dir path.',
+            }),
+            required: true,
+        }),
+    };
+    static flags = {
+        lang: LANG_FLAG,
+        'output-dir': Flags.string({
+            description: bilingual({
+                zh: '输出目录，默认 .omk/observations（项目级，相对于 cwd）。',
+                en: 'Output dir, default .omk/observations (project-local, relative to cwd).',
+            }),
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ObserveIngest);
+        const lang = this.lang;
+        await this.runWithCliExit(async () => {
+            const dir = args.traceDir;
+            if (!dir) {
+                // oclif Args.required:true 已经保证非空,这里仍兜底防御。
+                throw new CliExit(1);
+            }
+            const tracePath = resolve(dir);
+            const { existsSync } = await import('node:fs');
+            if (!existsSync(tracePath)) {
+                console.error(lang === 'zh'
+                    ? `trace 路径不存在: ${tracePath}`
+                    : `Trace path does not exist: ${tracePath}`);
+                throw new CliExit(1);
+            }
+            // `--output-dir ''` 显式空串拒绝:`resolve('')` 在 Node 里等价于 `process.cwd()`,
+            // 没拦住就会让 shell 里没展开的变量(`--output-dir "$DIR"` 而 `$DIR` 未设)把
+            // observation 报告写到任意 cwd。oclif `Flags.string({})` 没拦空串,这里业务侧
+            // 显式判 + exit 2(POSIX usage error 约定),跟其它 parse error 行为一致。
+            const outDirRaw = flags['output-dir'];
+            if (outDirRaw !== undefined && outDirRaw.trim() === '') {
+                console.error(lang === 'zh'
+                    ? '错误：--output-dir 不能为空字符串。'
+                    : 'Error: --output-dir must not be an empty string.');
+                throw new CliExit(2);
+            }
+            const { buildObservationInboxReport, saveObservationInboxReport, DEFAULT_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+            const outDir = resolve(outDirRaw ?? DEFAULT_OBSERVATIONS_DIR);
+            const { loadObservationReviewState } = await import('../../../observability/review-state.js');
+            const report = buildObservationInboxReport(tracePath, { reviewState: loadObservationReviewState(outDir) });
+            const path = saveObservationInboxReport(report, outDir);
+            console.log(JSON.stringify(report, null, 2));
+            process.stderr.write(lang === 'zh'
+                ? `observe inbox 已写入: ${path}\n`
+                : `observe inbox written to: ${path}\n`);
+        });
+    }
+}
+//# sourceMappingURL=ingest.js.map

package/dist/src/cli/commands/observe/ingest.js.map

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

package/dist/src/cli/commands/observe/show.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../oclif/base-command.js';
+export default class ObserveShow extends BaseCommand {
+    static description: string;
+    static args: {
+        inboxId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'input-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=show.d.ts.map

package/dist/src/cli/commands/observe/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/observe/show.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,MAAM,CAAC,WAAW,SAGf;IAEH,MAAM,CAAC,IAAI;;MAQT;IAEF,MAAM,CAAC,KAAK;;;MAQV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB3B"}

package/dist/src/cli/commands/observe/show.js

@@ -0,0 +1,49 @@
+import { resolve } from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../oclif/base-command.js';
+import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
+import { CliExit } from '../../lib/cli-exit.js';
+export default class ObserveShow extends BaseCommand {
+    static description = bilingual({
+        zh: '展开 observation inbox 中某条 item 的详情。',
+        en: 'Show details of a specific observation inbox item.',
+    });
+    static args = {
+        inboxId: Args.string({
+            description: bilingual({
+                zh: 'inbox item ID。',
+                en: 'Inbox item ID.',
+            }),
+            required: true,
+        }),
+    };
+    static flags = {
+        lang: LANG_FLAG,
+        'input-dir': Flags.string({
+            description: bilingual({
+                zh: 'inbox 数据目录',
+                en: 'Inbox data dir',
+            }),
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ObserveShow);
+        const lang = this.lang;
+        await this.runWithCliExit(async () => {
+            const id = args.inboxId;
+            if (!id) {
+                console.error(lang === 'zh' ? '用法：omk observe show <inbox_id> [--input-dir <path>]' : 'Usage: omk observe show <inbox_id> [--input-dir <path>]');
+                throw new CliExit(1);
+            }
+            const { findObservationInboxItem, formatObservationShow, DEFAULT_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+            const dir = resolve(flags['input-dir'] || DEFAULT_OBSERVATIONS_DIR);
+            const item = findObservationInboxItem(id, dir);
+            if (!item) {
+                console.error(lang === 'zh' ? `未找到 observation：${id}` : `Observation not found: ${id}`);
+                throw new CliExit(1);
+            }
+            console.log(formatObservationShow(item));
+        });
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/src/cli/commands/observe/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../../../src/cli/commands/observe/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,EAAE,EAAE,oCAAoC;QACxC,EAAE,EAAE,oDAAoD;KACzD,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,GAAG;QACZ,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,SAAS,CAAC;gBACrB,EAAE,EAAE,gBAAgB;gBACpB,EAAE,EAAE,gBAAgB;aACrB,CAAC;YACF,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;YACxB,WAAW,EAAE,SAAS,CAAC;gBACrB,EAAE,EAAE,YAAY;gBAChB,EAAE,EAAE,gBAAgB;aACrB,CAAC;SACH,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,qDAAqD,CAAC,CAAC,CAAC,yDAAyD,CAAC,CAAC;gBACjJ,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;YACD,MAAM,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;YACtI,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,wBAAwB,CAAC,CAAC;YACpE,MAAM,IAAI,GAAG,wBAAwB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;gBACxF,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC"}