oh-my-knowledge 0.35.0 → 0.36.0

package/dist/server/report-store.d.ts

@@ -20,7 +20,7 @@ export declare function queryJobList(jobStore: JobStore, query?: JobQuery): Prom
 export declare function queryJob(jobStore: JobStore, id: string): Promise<EvaluationJob | null>;
 export interface RunListItem {
     id: string;
-    reportKind: ReportDocument['reportKind'];
+    kind: ReportDocument['kind'];
     meta: ReportDocument['meta'];
     summary?: EvaluationReport['summary'];
     items?: BatchEvaluationReport['items'];

package/dist/server/report-store.js

@@ -39,32 +39,33 @@ export function createFileStore(dir) {
         if (!data || typeof data !== 'object')
             return null;
         const record = data;
-        if (record.reportKind === 'evaluation') {
+        const kind = record.kind === 'evaluation' || record.kind === 'batch-evaluation'
+            ? record.kind
+            : undefined;
+        if (kind === 'evaluation') {
             if (!record.meta || !record.summary || !Array.isArray(record.results))
                 return null;
-            return { ...record, id: typeof record.id === 'string' && record.id ? record.id : fallbackId };
+            return {
+                ...record,
+                kind,
+                id: typeof record.id === 'string' && record.id ? record.id : fallbackId,
+            };
         }
-        if (record.reportKind === 'batch-evaluation') {
+        if (kind === 'batch-evaluation') {
             if (!record.meta || !Array.isArray(record.items))
                 return null;
-            return { ...record, id: typeof record.id === 'string' && record.id ? record.id : fallbackId };
-        }
-        if (record.kind === undefined
-            && record.overview === undefined
-            && record.artifacts === undefined
-            && record.meta
-            && record.summary
-            && Array.isArray(record.results)) {
             return {
                 ...record,
-                reportKind: 'evaluation',
+                kind,
                 id: typeof record.id === 'string' && record.id ? record.id : fallbackId,
             };
         }
+        // 只认 canonical 顶层 `kind`(evaluation / batch-evaluation)。不再为旧格式(顶层无该判别字段的
+        // 历史文件)做读兼容 —— 顶层 kind cutover 是硬切换,旧文件直接判脏丢弃。
         return null;
     }
     function isEvaluationReport(report) {
-        return report.reportKind === 'evaluation';
+        return report.kind === 'evaluation';
     }
     // Studio 每个 / 和 /skills/<name> 请求都调 list(),里面对每个 .json 同步 readFile +
     // JSON.parse。报告数上来后这是主性能瓶颈。缓存策略:fingerprint = dir mtime + 文件名
@@ -217,9 +218,9 @@ export async function queryJob(jobStore, id) {
 export async function queryRunList(reportStore) {
     return (await reportStore.list()).map((report) => ({
         id: report.id,
-        reportKind: report.reportKind,
+        kind: report.kind,
         meta: report.meta,
-        ...(report.reportKind === 'evaluation' ? { summary: report.summary } : { items: report.items }),
+        ...(report.kind === 'evaluation' ? { summary: report.summary } : { items: report.items }),
     }));
 }
 export async function queryRun(reportStore, id) {

package/dist/server/skill-index.js

@@ -69,7 +69,7 @@ function buildIndexFingerprint(reports, analysesDir, doctorsDir, observationsDir
     // 每一段的 right-hand-side 从旧的 "{dir-mtime}-{file-count}" 双标量升级成
     // safeDirJsonContentFingerprint 返回的 "{dir-mtime}|{file1}:{m}:{s},..."
     // content-aware 字符串。
-    const reportIds = reports.map((r) => `${r.id}:${r.meta?.timestamp ?? ''}:${r.reportKind === 'evaluation' ? r.meta.evolve?.skillName ?? '' : ''}`).join(',');
+    const reportIds = reports.map((r) => `${r.id}:${r.meta?.timestamp ?? ''}:${r.kind === 'evaluation' ? r.meta.evolve?.skillName ?? '' : ''}`).join(',');
     const doctorsFp = safeDirJsonContentFingerprint(doctorsDir);
     const analysesFp = safeDirJsonContentFingerprint(analysesDir);
     const observationsFp = safeDirJsonContentFingerprint(observationsDir);
@@ -223,7 +223,8 @@ function scanDoctorReports(dir) {
             continue;
         try {
             const data = JSON.parse(readFileSync(join(dir, file), 'utf-8'));
-            if (data?.reportKind !== 'doctor' || !Array.isArray(data.skills))
+            const kind = data?.kind === 'doctor' ? data.kind : null;
+            if (!kind || !Array.isArray(data.skills))
                 continue;
             const ts = data.timestamp;
             for (const sr of data.skills) {
@@ -260,7 +261,7 @@ export function buildSkillIndex(reports, analysesDir, doctorsDir, observationsDi
     // ── eval 聚合(历史 list)─────────────────────────────────
     const evalBy = {};
     for (const r of reports) {
-        if (r.reportKind !== 'evaluation')
+        if (r.kind !== 'evaluation')
             continue;
         const variants = r.meta.variants || [];
         for (const v of variants) {
@@ -347,7 +348,7 @@ export function buildSkillIndex(reports, analysesDir, doctorsDir, observationsDi
     // list 页对每个 entry 跑 detectInsights 的 CPU 开销迁移到这里,只 miss 时算一次。
     const insightsBySkill = new Map();
     for (const ent of entries) {
-        const evalReport = ent.eval ? reports.find((r) => r.id === ent.eval.reportId && r.reportKind === 'evaluation') : undefined;
+        const evalReport = ent.eval ? reports.find((r) => r.id === ent.eval.reportId && r.kind === 'evaluation') : undefined;
         insightsBySkill.set(ent.skillName, detectInsights(ent, evalReport ?? null, {
             diagnostics: diagnosisBundle.bySkill[ent.skillName] ?? [],
         }));

package/dist/types/doctor.d.ts

@@ -10,7 +10,7 @@ export type DoctorSkillStatus = 'pass' | 'warn' | 'fail';
 export type DoctorOutcome = 'passed' | 'warnings_only' | 'failed';
 /** Bumped whenever DoctorReport schema changes in a way CI consumers should
  *  be able to detect. CI can pin/check this when parsing the JSON. */
-export declare const DOCTOR_REPORT_SCHEMA_VERSION = "2.0.0";
+export declare const DOCTOR_REPORT_SCHEMA_VERSION = "3.0.0";
 export interface DoctorRuleResult {
     ruleId: string;
     severity: DoctorSeverity;
@@ -94,7 +94,7 @@ export interface DoctorSkillReport {
     status: DoctorSkillStatus;
 }
 export interface DoctorReport {
-    reportKind: 'doctor';
+    kind: 'doctor';
     /** Schema version the JSON consumer can pin/check. Bumped on any
      *  user-visible change to this report's shape. See DOCTOR_REPORT_SCHEMA_VERSION. */
     schemaVersion: string;

package/dist/types/doctor.js

@@ -1,6 +1,6 @@
 /** Bumped whenever DoctorReport schema changes in a way CI consumers should
  *  be able to detect. CI can pin/check this when parsing the JSON. */
-export const DOCTOR_REPORT_SCHEMA_VERSION = '2.0.0';
+export const DOCTOR_REPORT_SCHEMA_VERSION = '3.0.0';
 export function isComposerRule(r) {
     return r.ruleKind === 'composer';
 }

package/dist/types/observability.d.ts

@@ -43,8 +43,8 @@ export interface ObservationReviewStateEntry {
     snippet?: string;
 }
 export interface ObservationReviewState {
-    reportKind: 'observe-review-state';
-    schemaVersion: 1;
+    kind: 'observe-review-state';
+    schemaVersion: 2;
     updatedAt: string;
     entries: Record<string, ObservationReviewStateEntry>;
 }
@@ -184,8 +184,8 @@ export interface ObservationSessionTimeRange {
     durationMs?: number;
 }
 export interface ObservationInboxReport {
-    reportKind: 'observe-inbox';
-    schemaVersion: 1;
+    kind: 'observe-inbox';
+    schemaVersion: 2;
     meta: {
         tracePath: string;
         generatedAt: string;
@@ -735,8 +735,8 @@ export interface ExperienceSkillSummary {
     relatedObservationIds: string[];
 }
 export interface ObservationExperienceReport {
-    reportKind: 'observe-experience';
-    schemaVersion: 1;
+    kind: 'observe-experience';
+    schemaVersion: 2;
     scope: 'evidence-only';
     generatedAt: string;
     meta: {

package/dist/types/report.d.ts

@@ -253,8 +253,10 @@ export interface ReportMeta {
      *  for eval-side reports). Value 1 was specified for v0.21+ but never emitted in practice.
      *  Value 2 marked the artifactHashes tree-hash era for local dir-skills (git dir-skills still
      *  SKILL.md-only). Value 3 extends whole-tree hashing to git dir-skills via isolated copies
-     *  (all dir-skills bind). Drift / lineage consumers gate on `>= 2` (tree-hash era); git-dir-skill
-     *  binding additionally requires `>= 3`. */
+     *  (all dir-skills bind). Value 4 keeps the v3 hash/binding semantics but marks the canonical
+     *  top-level discriminant era, so external consumers can version-gate the JSON shape. Drift /
+     *  lineage consumers gate on `>= 2` (tree-hash era); git-dir-skill binding additionally
+     *  requires `>= 3`. */
     schemaVersion?: number;
     /** SHA256-12 of every sample's content (sample_id → hash). Same hash = same sample. */
     sampleHashes?: Record<string, string>;
@@ -355,7 +357,7 @@ export interface SampleSnapshot {
     tripwire?: boolean;
 }
 export interface EvaluationReport {
-    reportKind: 'evaluation';
+    kind: 'evaluation';
     id: string;
     meta: ReportMeta;
     summary: Record<string, VariantSummary>;
@@ -369,6 +371,9 @@ export interface EvaluationReport {
 export type Report = EvaluationReport;
 export interface BatchEvaluationMeta {
     mode: 'skill';
+    /** Batch report JSON schema version. Kept in lockstep with child EvaluationReport top-level
+     *  shape so external consumers can identify the canonical discriminant era. */
+    schemaVersion: number;
     model: string;
     executor: string;
     skillDir: string;
@@ -408,7 +413,7 @@ export interface BatchEvaluationItem {
     variance?: VarianceData;
 }
 export interface BatchEvaluationReport {
-    reportKind: 'batch-evaluation';
+    kind: 'batch-evaluation';
     id: string;
     mode: 'skill';
     meta: BatchEvaluationMeta;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-knowledge",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "packageManager": "yarn@4.16.0",
   "description": "Evaluation framework for LLM knowledge inputs — prompts, RAG corpora, skills, agent workflows. Fix the model, vary the artifact. Built-in statistical rigor: bootstrap CI, Krippendorff α, length-debias, saturation curves.",
   "type": "module",