oh-my-knowledge 0.32.0 → 0.34.0

package/dist/managed/store.d.ts

@@ -0,0 +1,76 @@
+import type { ArtifactKind, DeriveManagedStateInput, DerivedManagedState, ManagedArtifactRecord, ManagedArtifactSource, ManagedDistributionTarget } from '../types/index.js';
+/**
+ * 受管记录的 per-record 文件存储。一条记录一个 `.omk/managed/<id>.json`,镜像 report-store 的
+ * 成熟模式(原子 tmp+rename):每次 install 只碰自己那个文件,independent write、不丢别人、
+ * 天然可扩展。无数据库——这个规模(每项目几十条、CLI 单写者)JSON 文件足够,且保住"可读可
+ * grep 可 diff"的透明价值。
+ *
+ * **消费方无关的核心层**:本模块不依赖 CLI、不打印、不退出,所有函数接收显式 `dir`。CLI 命令只是
+ * 众多消费方之一;omk 长成平台后 server / web / SDK 复用同一模块,甚至换 DB 实现也只需镜像这组
+ * load/upsert 签名。记录的构造统一走 `buildManagedArtifactRecord`,新增字段只改这一处、所有消费方继承。
+ */
+export declare function managedDir(cwd?: string): string;
+export declare function globalManagedDir(): string;
+export declare function recordPath(dir: string, id: string): string;
+/** 稳定身份 = hash(kind, name)。源路径是可变属性、不进 id。kind 取自固定枚举(无 `|`),分隔可注入。 */
+export declare function managedRecordId(kind: ArtifactKind, name: string): string;
+/**
+ * 给定相对源根的路径分段(空数组 = 源根本身),判断是否进可分发树。hash 的 walk、copy 的 filter、
+ * git 物化共用此一处,保证三者完全一致。
+ *
+ * 关键:检查**每一段**而非只看叶子。本地 walk / cpSync 是逐层下降、命中目录即剪枝,只看叶子也够;
+ * 但 git ls-tree 给的是**扁平路径**(如 `.omk/samples.json`),只看叶子 `samples.json` 会让 `.omk`
+ * 内容漏过。故:任一段命中全局排除即排除;首段命中 root-only(evolve)即排除(嵌套同名是合法资产)。
+ */
+export declare function isDistributablePath(segments: string[]): boolean;
+/**
+ * artifact 内容 hash —— drift baseline 与 evidence 绑定的依据。
+ *   - 文件-skill:单个 .md 的字节;
+ *   - 目录-skill:覆盖**整棵可分发目录树**(SKILL.md + references/ 等资产,但排除 .omk / .git /
+ *     evolve 等评测迭代产物),按相对路径排序后把每个文件的`路径 + 字节长度 + 内容`喂进同一个
+ *     sha256 —— 改任意资产都会令 hash 变化、drift 不漏;只补样本则 hash 不动。
+ * 用 createHash 直接喂 Buffer(字节级,二进制资产也稳;分隔符是运行时字节,源码里不引入任何不可见字符)。
+ * 读时(未来 list / drift 检查)用同一函数重算比对。
+ */
+export declare function hashArtifactSource(source: string, isDirectorySkill: boolean): string;
+export declare function loadManagedRecord(dir: string, id: string): ManagedArtifactRecord | null;
+/** 读全部记录。项目目录空 → 兜底全局(镜像 observe inbox 的 project→global)。 */
+export declare function loadAllManagedRecords(dir?: string): ManagedArtifactRecord[];
+/**
+ * 纯合并逻辑(无 IO):install 写的是事实,绝不动 evidence/decisions(那是 eval/promote 的地盘)。
+ *   - distribution 按 path 去重(同路径以新值替换);
+ *   - evidence / decisions 一律保留旧值(install 带来的恒为空)——这是设计要的"版本历史 + 附带证据",
+ *     用来支撑 rollback;**但保留 ≠ 当作当前有效**:每条 evidence 携带它测的 contentHash,读时由
+ *     `deriveManagedState` 只把与当前 contentHash 匹配的 evidence 算作当前证据,所以重装到新内容后
+ *     旧证据仍在记录里(可回滚),却不会让新内容被读成 measurable;
+ *   - installedAt 保留首次("under management since");contentHash / source 刷新到本次安装。
+ */
+export declare function mergeManagedRecord(prev: ManagedArtifactRecord | null, next: ManagedArtifactRecord): ManagedArtifactRecord;
+/** 读旧记录 → 合并 → 原子 tmp+rename 只写该 id 的文件。返回合并后记录。 */
+export declare function upsertManagedRecord(dir: string, record: ManagedArtifactRecord): ManagedArtifactRecord;
+/**
+ * 统一的记录构造点——所有消费方(CLI / 未来 server / SDK)经此组装,保证 schema 一致。
+ * 只接收事实(身份、源、hash、分发落点);evidence/decisions 恒为空(eval/promote 的地盘)。
+ */
+export declare function buildManagedArtifactRecord(input: {
+    name: string;
+    kind: ArtifactKind;
+    source: ManagedArtifactSource;
+    contentHash: string;
+    installedAt: string;
+    distribution: ManagedDistributionTarget[];
+    id?: string;
+}): ManagedArtifactRecord;
+/** install 调用的便捷封装。 */
+export declare function recordManagedArtifact(record: ManagedArtifactRecord, opts?: {
+    dir?: string;
+}): ManagedArtifactRecord;
+/**
+ * 读时推导生命周期标签。
+ *   - 源缺失或 hash 漂(当前内容 ≠ 记录 contentHash)→ stale;
+ *   - 否则有**当前**证据 / samples → measurable;
+ *   - 否则 installed。
+ * 「当前证据」= contentHash 与记录当前 contentHash 匹配的 evidence —— 旧内容的 evidence 不算数,
+ * 这正是 #203「证据必须跟 artifact 一起走」的读时保证。`'discovered'` 留给无分发的记录,此函数不产生。
+ */
+export declare function deriveManagedState(input: DeriveManagedStateInput): DerivedManagedState;

package/dist/managed/store.js

@@ -0,0 +1,260 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, normalize } from 'node:path';
+import { hashString } from '../eval-core/evaluation-reporting.js';
+/**
+ * 受管记录的 per-record 文件存储。一条记录一个 `.omk/managed/<id>.json`,镜像 report-store 的
+ * 成熟模式(原子 tmp+rename):每次 install 只碰自己那个文件,independent write、不丢别人、
+ * 天然可扩展。无数据库——这个规模(每项目几十条、CLI 单写者)JSON 文件足够,且保住"可读可
+ * grep 可 diff"的透明价值。
+ *
+ * **消费方无关的核心层**:本模块不依赖 CLI、不打印、不退出,所有函数接收显式 `dir`。CLI 命令只是
+ * 众多消费方之一;omk 长成平台后 server / web / SDK 复用同一模块,甚至换 DB 实现也只需镜像这组
+ * load/upsert 签名。记录的构造统一走 `buildManagedArtifactRecord`,新增字段只改这一处、所有消费方继承。
+ */
+export function managedDir(cwd = process.cwd()) {
+    return join(cwd, '.omk', 'managed');
+}
+export function globalManagedDir() {
+    return join(homedir(), '.oh-my-knowledge', 'managed');
+}
+export function recordPath(dir, id) {
+    return join(dir, `${id}.json`);
+}
+/** 稳定身份 = hash(kind, name)。源路径是可变属性、不进 id。kind 取自固定枚举(无 `|`),分隔可注入。 */
+export function managedRecordId(kind, name) {
+    return hashString(`${kind}|${name}`);
+}
+/**
+ * 不进 artifact「可分发树」的条目 —— omk 的评测 / 迭代 / VCS / 系统产物,既不该被拷进 agent
+ * skill 目录,也不该计入 artifact contentHash。区分两类语义,避免误伤合法嵌套资产:
+ *   - **任意层级排除**:隐藏元数据 / VCS / 系统 / 依赖目录,任何深度出现都是噪声
+ *     (`.omk` = samples / managed / observations;`.git`;`node_modules`;OS 垃圾);
+ *   - **仅源根第一层排除**:omk 保留的工作目录,只在 skill 根有保留语义,嵌套同名是用户合法资产
+ *     (`evolve` 是 `<skillDir>/evolve/` 候选快照;但 `references/evolve/guide.md` 应正常分发并计入 hash)。
+ * spec 里 artifact content hash 与 sample-set hash 是分开的证据轴,故只补样本(.omk)不该改 hash。
+ */
+const GLOBAL_EXCLUDED_NAMES = new Set(['.omk', '.git', 'node_modules', '.DS_Store', 'Thumbs.db']);
+const ROOT_ONLY_EXCLUDED_NAMES = new Set(['evolve']);
+/**
+ * 给定相对源根的路径分段(空数组 = 源根本身),判断是否进可分发树。hash 的 walk、copy 的 filter、
+ * git 物化共用此一处,保证三者完全一致。
+ *
+ * 关键:检查**每一段**而非只看叶子。本地 walk / cpSync 是逐层下降、命中目录即剪枝,只看叶子也够;
+ * 但 git ls-tree 给的是**扁平路径**(如 `.omk/samples.json`),只看叶子 `samples.json` 会让 `.omk`
+ * 内容漏过。故:任一段命中全局排除即排除;首段命中 root-only(evolve)即排除(嵌套同名是合法资产)。
+ */
+export function isDistributablePath(segments) {
+    if (segments.length === 0)
+        return true; // 源根永远算
+    for (const seg of segments) {
+        if (GLOBAL_EXCLUDED_NAMES.has(seg))
+            return false;
+    }
+    if (ROOT_ONLY_EXCLUDED_NAMES.has(segments[0]))
+        return false;
+    return true;
+}
+/**
+ * artifact 内容 hash —— drift baseline 与 evidence 绑定的依据。
+ *   - 文件-skill:单个 .md 的字节;
+ *   - 目录-skill:覆盖**整棵可分发目录树**(SKILL.md + references/ 等资产,但排除 .omk / .git /
+ *     evolve 等评测迭代产物),按相对路径排序后把每个文件的`路径 + 字节长度 + 内容`喂进同一个
+ *     sha256 —— 改任意资产都会令 hash 变化、drift 不漏;只补样本则 hash 不动。
+ * 用 createHash 直接喂 Buffer(字节级,二进制资产也稳;分隔符是运行时字节,源码里不引入任何不可见字符)。
+ * 读时(未来 list / drift 检查)用同一函数重算比对。
+ */
+export function hashArtifactSource(source, isDirectorySkill) {
+    if (!isDirectorySkill) {
+        return createHash('sha256').update(readFileSync(source)).digest('hex').slice(0, 12);
+    }
+    const rels = [];
+    const walk = (dir, segments) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const segs = [...segments, entry.name];
+            if (!isDistributablePath(segs))
+                continue;
+            // 软链既非 isFile 也非 isDirectory,天然跳过 —— 与 copyArtifactToTarget 的 filter 一致
+            // (hash 覆盖的 == 分发出去的),避免软链目标改变却不触发 drift,也回避软链环。
+            if (entry.isDirectory())
+                walk(join(dir, entry.name), segs);
+            else if (entry.isFile())
+                rels.push(segs.join('/'));
+        }
+    };
+    walk(source, []);
+    rels.sort();
+    const h = createHash('sha256');
+    const sep = Buffer.from([0]);
+    for (const rel of rels) {
+        const content = readFileSync(join(source, rel));
+        // 路径与内容都做长度前缀,彻底排除"不同树拼出同一串"的歧义(文件名虽不含 NUL,核心层仍按可注入防)。
+        h.update(String(Buffer.byteLength(rel)));
+        h.update(sep);
+        h.update(rel);
+        h.update(sep);
+        h.update(String(content.length));
+        h.update(sep);
+        h.update(content);
+        h.update(sep);
+    }
+    return h.digest('hex').slice(0, 12);
+}
+function isStringField(v) {
+    return typeof v === 'string';
+}
+// 校验到元素级:记录文件是用户可手改的(透明性是设计价值),`evidence:[null]` / 缺字段的 distribution
+// 都是现实的坏手改;若只查 Array.isArray,坏元素会在 deriveManagedState / mergeManagedRecord 里
+// 解引用崩溃(且在 load 的 try/catch 之外)。这里直接判脏 → load 丢弃该文件,消费方永远拿不到半成品。
+function isManagedArtifactRecord(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const r = value;
+    if (!(r.recordKind === 'managed-artifact'
+        && r.schemaVersion === 2
+        && isStringField(r.id)
+        && isStringField(r.name)
+        && isStringField(r.kind)
+        && isStringField(r.contentHash)
+        && r.source && typeof r.source === 'object'
+        && isStringField(r.source.locator)
+        && isStringField(r.source.sourceKind)
+        && Array.isArray(r.distribution)
+        && Array.isArray(r.evidence)
+        && Array.isArray(r.decisions)))
+        return false;
+    const okDist = r.distribution.every((d) => d && typeof d === 'object'
+        && isStringField(d.path) && isStringField(d.contentHash));
+    const okEv = r.evidence.every((e) => e && typeof e === 'object'
+        && isStringField(e.reportId) && isStringField(e.contentHash));
+    const okDec = r.decisions.every((d) => d && typeof d === 'object'
+        && isStringField(d.decisionKind));
+    return okDist && okEv && okDec;
+}
+export function loadManagedRecord(dir, id) {
+    const path = recordPath(dir, id);
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        return isManagedArtifactRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readRecordsFromDir(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        if (!entry.endsWith('.json'))
+            continue;
+        try {
+            const parsed = JSON.parse(readFileSync(join(dir, entry), 'utf-8'));
+            if (isManagedArtifactRecord(parsed))
+                out.push(parsed);
+        }
+        catch {
+            // 跳过损坏文件
+        }
+    }
+    return out;
+}
+/** 读全部记录。项目目录空 → 兜底全局(镜像 observe inbox 的 project→global)。 */
+export function loadAllManagedRecords(dir = managedDir()) {
+    const local = readRecordsFromDir(dir);
+    if (local.length > 0)
+        return local;
+    const global = globalManagedDir();
+    if (dir !== global) {
+        const fallback = readRecordsFromDir(global);
+        if (fallback.length > 0)
+            return fallback;
+    }
+    return local;
+}
+/**
+ * 纯合并逻辑(无 IO):install 写的是事实,绝不动 evidence/decisions(那是 eval/promote 的地盘)。
+ *   - distribution 按 path 去重(同路径以新值替换);
+ *   - evidence / decisions 一律保留旧值(install 带来的恒为空)——这是设计要的"版本历史 + 附带证据",
+ *     用来支撑 rollback;**但保留 ≠ 当作当前有效**:每条 evidence 携带它测的 contentHash,读时由
+ *     `deriveManagedState` 只把与当前 contentHash 匹配的 evidence 算作当前证据,所以重装到新内容后
+ *     旧证据仍在记录里(可回滚),却不会让新内容被读成 measurable;
+ *   - installedAt 保留首次("under management since");contentHash / source 刷新到本次安装。
+ */
+export function mergeManagedRecord(prev, next) {
+    if (!prev)
+        return next;
+    // 按归一化路径去重(消除尾斜杠 / `.` / 重复分隔导致同一物理目标被记两条)。normalize 保留尾斜杠,故再去尾。
+    const normKey = (p) => normalize(p).replace(/[\\/]+$/, '') || p;
+    const byPath = new Map();
+    for (const t of prev.distribution)
+        byPath.set(normKey(t.path), t);
+    for (const t of next.distribution)
+        byPath.set(normKey(t.path), t);
+    // 维护点:`...next` 取本次安装的事实,下面四个字段从 prev 保留(历史 / 首次时间)。
+    // 将来若新增任何"必须从安装基线保留"的字段,务必加进这份覆盖清单,否则会被 next 静默覆盖成 undefined。
+    // 注意语义边界:distribution 是**多源容忍**的(按归一化 path 累积去重),而 source / contentHash 是
+    // **末次写入(单源)**。同一 (kind,name) 先 file 后 git 重装会得到一条 source=git 的记录,但 distribution
+    // 仍含 file 时代的落点 —— 那些落点会按 git 的 contentHash 被判 drift。这是"换源即重基线"的有意取舍。
+    return {
+        ...next,
+        installedAt: prev.installedAt,
+        distribution: [...byPath.values()],
+        evidence: prev.evidence,
+        decisions: prev.decisions,
+    };
+}
+/** 读旧记录 → 合并 → 原子 tmp+rename 只写该 id 的文件。返回合并后记录。 */
+export function upsertManagedRecord(dir, record) {
+    const merged = mergeManagedRecord(loadManagedRecord(dir, record.id), record);
+    mkdirSync(dir, { recursive: true });
+    const path = recordPath(dir, record.id);
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify(merged, null, 2));
+    renameSync(tmp, path);
+    return merged;
+}
+/**
+ * 统一的记录构造点——所有消费方(CLI / 未来 server / SDK)经此组装,保证 schema 一致。
+ * 只接收事实(身份、源、hash、分发落点);evidence/decisions 恒为空(eval/promote 的地盘)。
+ */
+export function buildManagedArtifactRecord(input) {
+    return {
+        recordKind: 'managed-artifact',
+        schemaVersion: 2,
+        id: input.id ?? managedRecordId(input.kind, input.name),
+        name: input.name,
+        kind: input.kind,
+        source: input.source,
+        contentHash: input.contentHash,
+        installedAt: input.installedAt,
+        distribution: input.distribution,
+        evidence: [],
+        decisions: [],
+    };
+}
+/** install 调用的便捷封装。 */
+export function recordManagedArtifact(record, opts = {}) {
+    return upsertManagedRecord(opts.dir ?? managedDir(), record);
+}
+/**
+ * 读时推导生命周期标签。
+ *   - 源缺失或 hash 漂(当前内容 ≠ 记录 contentHash)→ stale;
+ *   - 否则有**当前**证据 / samples → measurable;
+ *   - 否则 installed。
+ * 「当前证据」= contentHash 与记录当前 contentHash 匹配的 evidence —— 旧内容的 evidence 不算数,
+ * 这正是 #203「证据必须跟 artifact 一起走」的读时保证。`'discovered'` 留给无分发的记录,此函数不产生。
+ */
+export function deriveManagedState(input) {
+    const { record, currentContentHash, hasSamplesOrDoctorPass } = input;
+    const hasEvidence = record.evidence.some((e) => e.contentHash === record.contentHash);
+    const drifted = currentContentHash === undefined || currentContentHash !== record.contentHash;
+    if (drifted)
+        return { label: 'stale', drifted: true, hasEvidence };
+    if (hasEvidence || hasSamplesOrDoctorPass)
+        return { label: 'measurable', drifted: false, hasEvidence };
+    return { label: 'installed', drifted: false, hasEvidence };
+}

package/dist/observability/experience-frontmatter.d.ts

@@ -34,4 +34,3 @@ export interface SkillDeclarationCheck {
 export declare function loadFrontmatterSkillType(skillName: string, cwd?: string): ExperienceRuntimeSkillType | undefined;
 export declare function loadSkillDeclarationCheck(skillName: string, cwd?: string): SkillDeclarationCheck;
 export declare function loadExpectedToolsForSkill(skillName: string, cwd?: string): string[];
-//# sourceMappingURL=experience-frontmatter.d.ts.map

package/dist/observability/experience-frontmatter.js

@@ -97,4 +97,3 @@ function normalizeRuntimeSkillType(value) {
 function unique(values) {
     return Array.from(new Set(values));
 }
-//# sourceMappingURL=experience-frontmatter.js.map

package/dist/observability/experience.d.ts

@@ -3,7 +3,7 @@ import type { CcSession } from './trace-source.js';
 import type { SkillSegment } from './trace-segmenter.js';
 export { findNegativeFeedbackMatches, findPositiveFeedbackMatches, findUserCorrectionMatches, findUserGoalShiftMatches, hasNegativeFeedbackSignal, hasPositiveFeedbackSignal, hasUserCorrectionSignal, hasUserGoalShiftSignal, } from './feedback-matchers.js';
 export type { TextMatchRange } from './feedback-matchers.js';
-export type { ExperienceAssistiveInference, ExperienceAssistiveInferenceCautionCode, ExperienceAssistiveInferenceCode, ExperienceAssistiveInferenceConfidence, ExperienceChecklistContribution, ExperienceChecklistItem, ExperienceChecklistItemStatus, ExperienceEpisode, ExperienceEpisodeArtifact, ExperienceEpisodeArtifactKind, ExperienceEpisodeBoundaryReason, ExperienceEpisodeOutcome, ExperienceEpisodeRole, ExperienceEvidenceChain, ExperienceEvidenceKind, ExperienceEvidenceRef, ExperienceFeedbackAttribution, ExperienceFeedbackAttributionReason, ExperienceFeedbackAttributionRole, ExperienceFeedbackSignal, ExperienceFeedbackSignalType, ExperienceGoalEvidenceRef, ExperienceGoalSlice, ExperienceGoalSliceReasonCode, ExperienceInvocation, ExperienceMessageRange, ExperienceOrchestrationEdge, ExperienceOrchestrationEdgeKind, ExperienceOrchestrationEdgeStatus, ExperienceOutcomeClosure, ExperienceParentReason, ExperienceReviewBasisCode, ExperienceReviewIndicators, ExperienceReviewPriority, ExperienceReviewerReport, ExperienceReviewerReportFinding, ExperienceReviewerReportFindingLevel, ExperienceReviewerReportFindingSource, ExperienceReviewerReportScope, ExperienceReviewerReportStep, ExperienceReviewerReportStepStatus, ExperienceRuleFinding, ExperienceRuleFindingCode, ExperienceRuleFindingLevel, ExperienceRuntimeSkillType, ExperienceRuntimeSkillTypeSource, ExperienceSessionStory, ExperienceSessionStoryAnswer, ExperienceSessionStoryAnswerKey, ExperienceSessionStoryGoalSlice, ExperienceSessionStoryGraphEdge, ExperienceSessionStoryGraphNode, ExperienceSessionStoryNode, ExperienceSessionStoryNodeKind, ExperienceSessionStorySkillLink, ExperienceSessionStorySkillRole, ExperienceSessionStorySubagentDispatch, ExperienceSessionSummary, ExperienceSkillSegment, ExperienceSkillSummary, ExperienceTimelineBranch, ExperienceTimelineEvent, ExperienceTimelineTree, ObservationExperienceReport, };
+export type { ExperienceAssistiveInference, ExperienceAssistiveInferenceCautionCode, ExperienceAssistiveInferenceCode, ExperienceAssistiveInferenceConfidence, ExperienceChecklistContribution, ExperienceChecklistItem, ExperienceChecklistItemStatus, ExperienceEpisode, ExperienceEpisodeArtifact, ExperienceEpisodeArtifactKind, ExperienceEpisodeBoundaryReason, ExperienceEpisodeOutcome, ExperienceEpisodeRole, ExperienceEvidenceChain, ExperienceEvidenceKind, ExperienceEvidenceRef, ExperienceFeedbackAttribution, ExperienceFeedbackAttributionReason, ExperienceFeedbackAttributionRole, ExperienceFeedbackSignal, ExperienceFeedbackSignalType, ExperienceGoalEvidenceRef, ExperienceGoalSlice, ExperienceGoalSliceReasonCode, ExperienceInvocation, ExperienceMessageRange, ExperienceOrchestrationEdge, ExperienceOrchestrationEdgeKind, ExperienceOrchestrationEdgeStatus, ExperienceOutcomeClosure, ExperienceParentReason, ExperienceReviewBasisCode, ExperienceReviewIndicators, ExperienceReviewPriority, ExperienceReviewerReport, ExperienceReviewerReportFinding, ExperienceReviewerReportFindingLevel, ExperienceReviewerReportFindingSource, ExperienceReviewerReportScope, ExperienceReviewerReportStep, ExperienceReviewerReportStepStatus, ExperienceRuleFinding, ExperienceRuleFindingCode, ExperienceRuleFindingLevel, ExperienceRuntimeSkillType, ExperienceRuntimeSkillTypeSource, ExperienceSessionStory, ExperienceSessionStoryAnswer, ExperienceSessionStoryAnswerKey, ExperienceSessionStoryGoalSlice, ExperienceSessionStoryGraphEdge, ExperienceSessionStoryGraphNode, ExperienceSessionStoryNode, ExperienceSessionStoryNodeKind, ExperienceSessionStorySkillLink, ExperienceSessionStorySkillRole, ExperienceSessionStorySubagentDispatch, ExperienceSessionSummary, ExperienceSkillSegment, ExperienceSkillSummary, ExperienceTimelineBranch, ExperienceTimelineEvent, ExperienceTimelineTree, ObservationExperienceReport, ObservationReviewState, };
 export declare function aggregateExperienceChecklistItemStatus(statuses: ExperienceChecklistItemStatus[]): ExperienceChecklistItemStatus;
 interface BuildExperienceInput {
     sessions: CcSession[];
@@ -20,4 +20,3 @@ export declare function foldExperienceChecklistItems(items: ExperienceChecklistI
     reason: ExperienceParentReason;
     sourceItemKeys: string[];
 };
-//# sourceMappingURL=experience.d.ts.map

package/dist/observability/experience.js

@@ -131,7 +131,7 @@ export function buildObservationExperienceReport(input) {
     const sessions = summarizeExperienceSessions(invocations, sessionGroupsByKey, input.generatedAt, input.reviewState);
     const skills = summarizeExperienceSkills(sessions, invocations);
     return {
-        kind: 'observe-experience',
+        reportKind: 'observe-experience',
         schemaVersion: 1,
         scope: 'evidence-only',
         generatedAt: input.generatedAt,
@@ -3435,4 +3435,3 @@ function unique(values) {
 function hashParts(...parts) {
     return createHash('sha256').update(parts.join('\u0000')).digest('hex').slice(0, 16);
 }
-//# sourceMappingURL=experience.js.map

package/dist/observability/feedback-matchers.d.ts

@@ -34,4 +34,3 @@ export declare function findNegativeFeedbackMatches(value: string): TextMatchRan
 export declare function hasNegativeFeedbackSignal(value: string): boolean;
 export declare function findPositiveFeedbackMatches(value: string): TextMatchRange[];
 export declare function hasPositiveFeedbackSignal(value: string): boolean;
-//# sourceMappingURL=feedback-matchers.d.ts.map

package/dist/observability/feedback-matchers.js

@@ -229,4 +229,3 @@ function isTextBoundary(value) {
         return true;
     return TEXT_BOUNDARY_CHARS.has(value);
 }
-//# sourceMappingURL=feedback-matchers.js.map

package/dist/observability/feedback-projection.d.ts

@@ -18,4 +18,3 @@
  */
 export { findNegativeFeedbackMatches, findPositiveFeedbackMatches, findUserCorrectionMatches, findUserGoalShiftMatches, hasUserCorrectionSignal, hasUserGoalShiftSignal, } from './feedback-matchers.js';
 export type { ExperienceAssistiveInference, ExperienceAssistiveInferenceCautionCode, ExperienceAssistiveInferenceCode, ExperienceChecklistItem, ExperienceEvidenceChain, ExperienceEvidenceRef, ExperienceFeedbackAttribution, ExperienceInvocation, ExperienceReviewIndicators, ExperienceReviewBasisCode, ExperienceReviewPriority, ExperienceReviewerReport, ExperienceRuleFinding, ExperienceRuleFindingCode, ExperienceRuleFindingLevel, ExperienceEpisode, ExperienceFeedbackSignal, ExperienceSkillSegment, ExperienceSessionStoryAnswer, ExperienceSessionSummary, ExperienceTimelineEvent, } from './experience.js';
-//# sourceMappingURL=feedback-projection.d.ts.map

package/dist/observability/feedback-projection.js

@@ -17,4 +17,3 @@
  * 继续直接 import experience.ts —— 它们不是「视图」,不在 facade 收敛范围内。
  */
 export { findNegativeFeedbackMatches, findPositiveFeedbackMatches, findUserCorrectionMatches, findUserGoalShiftMatches, hasUserCorrectionSignal, hasUserGoalShiftSignal, } from './feedback-matchers.js';
-//# sourceMappingURL=feedback-projection.js.map

package/dist/observability/inbox-view-model.d.ts

@@ -40,4 +40,3 @@ export type { ResolvedObservationReviewSession, ResolvedOwnerSuggestion } from '
 export type { SkillChainAdvisoryCode } from './skill-chain-advisories.js';
 export type { ExperienceProblemBucket, ExperienceProblemPattern, ExperienceProblemSignal } from './problem-patterns.js';
 export type { SkillDerivedStandard, SkillLlmEnhancedReviewSections } from './soft-standards/index.js';
-//# sourceMappingURL=inbox-view-model.d.ts.map

package/dist/observability/inbox-view-model.js

@@ -177,4 +177,3 @@ export { observationMetricAnnotationTargetId } from './review-state.js';
 export { resolveObservationReviewSession } from './resolved-review.js';
 export { getSkillChainAdvisory, resolveAdvisoryCommand } from './skill-chain-advisories.js';
 export { ASSISTANT_DELIVERABLE_ARTIFACT_RE, hasAssistantDeliverableArtifactText, hasAssistantDeliverySignalText, hasUserHardRuleText, HARD_RULE_TEXT_RE, isAssistantProgressUpdateText, isScheduledTaskPromptText, isSyntheticUserMessageText, isUserInteractionMetricText, } from './text-signals.js';
-//# sourceMappingURL=inbox-view-model.js.map

package/dist/observability/inbox.d.ts

@@ -25,4 +25,3 @@ export declare function findObservationInboxItem(id: string, dir?: string): Obse
 export declare function buildObservationMessageWindow(item: Pick<ObservationInboxItem, 'sourceTrace' | 'signalType' | 'evidence'>, radius?: number): ObservationMessageWindow | undefined;
 export declare function formatObservationShow(item: ObservationInboxItem): string;
 export declare function selectExploreInboxItems(items: ObservationInboxItem[], limit: number, includeNoise?: boolean, random?: () => number): ObservationInboxItem[];
-//# sourceMappingURL=inbox.d.ts.map

package/dist/observability/inbox.js

@@ -432,7 +432,7 @@ export function buildObservationInboxReport(tracePath, options = {}) {
     const items = finishInboxAggregation(aggregationState);
     const experience = buildObservationExperienceReport({ sessions, segments, items, generatedAt, reviewState: options.reviewState });
     const report = {
-        kind: 'observe-inbox',
+        reportKind: 'observe-inbox',
         schemaVersion: 1,
         meta: {
             tracePath,
@@ -567,7 +567,7 @@ export function loadObservationInboxReports(dir = DEFAULT_OBSERVATIONS_DIR) {
             return null;
         }
     })
-        .filter((r) => r?.kind === 'observe-inbox');
+        .filter((r) => r?.reportKind === 'observe-inbox');
 }
 export function loadLatestObservationInboxReport(dir = DEFAULT_OBSERVATIONS_DIR) {
     const reports = loadObservationInboxReports(dir);
@@ -762,4 +762,3 @@ export function selectExploreInboxItems(items, limit, includeNoise = false, rand
     }
     return shuffled.slice(0, limit);
 }
-//# sourceMappingURL=inbox.js.map

package/dist/observability/problem-patterns.d.ts

@@ -9,4 +9,3 @@ export declare function buildExperienceProblemPatterns(input: {
     reviewState?: ObservationReviewState;
 }): ExperienceProblemPattern[];
 export declare function mergeExperienceProblemPatterns(patterns: ExperienceProblemPattern[]): ExperienceProblemPattern[];
-//# sourceMappingURL=problem-patterns.d.ts.map

package/dist/observability/problem-patterns.js

@@ -241,4 +241,3 @@ function maxTimestamp(a, b) {
 function hashParts(...parts) {
     return createHash('sha256').update(parts.join('\u0000')).digest('hex').slice(0, 16);
 }
-//# sourceMappingURL=problem-patterns.js.map

package/dist/observability/resolved-review.d.ts

@@ -34,4 +34,3 @@ export interface ResolvedOwnerSuggestion {
 }
 export declare function resolveObservationReviewSession(options: ResolveObservationReviewSessionOptions): ResolvedObservationReviewSession;
 export declare function resolveObservationReviewPriority(priority: ExperienceReviewPriority, enhancedReview: SkillLlmEnhancedReviewSections | undefined, hasManualReview: boolean): ExperienceReviewPriority;
-//# sourceMappingURL=resolved-review.d.ts.map

package/dist/observability/resolved-review.js

@@ -222,9 +222,9 @@ function typeSpecificChecklistItems(enhancedReview, skillType) {
 function runtimeNodeChecklistItems(enhancedReview) {
     const runtimeResults = enhancedReview.runtimeNodeResults?.nodes ?? [];
     if (runtimeResults.length > 0) {
-        return runtimeResults.slice(0, 12).map((node) => checklistItem(`runtime_node_${node.kind}_${node.nodeId}`, `${runtimeNodeKindLabel(node.kind)}：${node.title || node.nodeId}`, runtimeNodeChecklistStatus(node.status), node.reason || '规则层基于 LLM 拆解的 typed signal 匹配运行证据。', node.status === 'violated' || node.status === 'degraded' ? 'attention' : 'informational'));
+        return runtimeResults.slice(0, 12).map((node) => checklistItem(`runtime_node_${node.nodeKind}_${node.nodeId}`, `${runtimeNodeKindLabel(node.nodeKind)}：${node.title || node.nodeId}`, runtimeNodeChecklistStatus(node.status), node.reason || '规则层基于 LLM 拆解的 typed signal 匹配运行证据。', node.status === 'violated' || node.status === 'degraded' ? 'attention' : 'informational'));
     }
-    return (enhancedReview.runtimeNodeAssessment?.nodes ?? []).slice(0, 12).map((node) => checklistItem(`legacy_llm_node_${node.kind}_${node.nodeId}`, `${node.kind === 'workflowNode' ? '流程节点' : '硬性规则'}：${node.nodeId}`, checklistStatus(node.status), node.reason ?? '旧版模型节点复核结果。', node.status === 'failed' || node.status === 'degraded' ? 'attention' : 'informational'));
+    return (enhancedReview.runtimeNodeAssessment?.nodes ?? []).slice(0, 12).map((node) => checklistItem(`legacy_llm_node_${node.nodeKind}_${node.nodeId}`, `${node.nodeKind === 'workflowNode' ? '流程节点' : '硬性规则'}：${node.nodeId}`, checklistStatus(node.status), node.reason ?? '旧版模型节点复核结果。', node.status === 'failed' || node.status === 'degraded' ? 'attention' : 'informational'));
 }
 function runtimeNodeKindLabel(kind) {
     if (kind === 'hardRule')
@@ -515,10 +515,10 @@ function ownerSuggestionTexts(enhancedReview, skillType) {
     const checklistLabelByKey = new Map((enhancedReview?.typeSpecificAssessment?.checklist ?? [])
         .map((item) => [item.key, `${skillTypeLabel(skillType ?? enhancedReview?.skillType)}：${readableTypeSpecificLabel(item, skillType ?? enhancedReview?.skillType)}`]));
     for (const node of enhancedReview?.runtimeNodeResults?.nodes ?? []) {
-        checklistLabelByKey.set(node.nodeId, `${runtimeNodeKindLabel(node.kind)}：${node.title || node.nodeId}`);
+        checklistLabelByKey.set(node.nodeId, `${runtimeNodeKindLabel(node.nodeKind)}：${node.title || node.nodeId}`);
     }
     for (const node of enhancedReview?.runtimeNodeAssessment?.nodes ?? []) {
-        checklistLabelByKey.set(node.suggestionKey ?? node.nodeId, `${node.kind === 'workflowNode' ? '流程节点' : '硬性规则'}：${node.nodeId}`);
+        checklistLabelByKey.set(node.suggestionKey ?? node.nodeId, `${node.nodeKind === 'workflowNode' ? '流程节点' : '硬性规则'}：${node.nodeId}`);
     }
     return (enhancedReview?.ownerSuggestions ?? [])
         .flatMap((suggestion) => {
@@ -549,4 +549,3 @@ function shortList(values) {
         .slice(0, 4)
         .join(' / ');
 }
-//# sourceMappingURL=resolved-review.js.map

package/dist/observability/review-state.d.ts

@@ -17,4 +17,3 @@ export declare function emptyObservationReviewState(now?: string): ObservationRe
 export declare function loadObservationReviewState(observationsDir: string): ObservationReviewState;
 export declare function updateObservationReviewState(observationsDir: string, update: ObservationReviewStateUpdate, now?: string): ObservationReviewState;
 export declare function deleteObservationReviewState(observationsDir: string, targetType: ObservationReviewTargetType, targetId: string, now?: string): ObservationReviewState;
-//# sourceMappingURL=review-state.d.ts.map

package/dist/observability/review-state.js

@@ -40,7 +40,7 @@ export function observationReviewStatePath(observationsDir) {
 }
 export function emptyObservationReviewState(now = new Date().toISOString()) {
     return {
-        kind: 'observe-review-state',
+        reportKind: 'observe-review-state',
         schemaVersion: 1,
         updatedAt: now,
         entries: {},
@@ -52,11 +52,11 @@ export function loadObservationReviewState(observationsDir) {
         return emptyObservationReviewState();
     try {
         const parsed = JSON.parse(readFileSync(path, 'utf-8'));
-        if (parsed.kind !== 'observe-review-state' || parsed.schemaVersion !== 1 || !parsed.entries || typeof parsed.entries !== 'object') {
+        if (parsed.reportKind !== 'observe-review-state' || parsed.schemaVersion !== 1 || !parsed.entries || typeof parsed.entries !== 'object') {
             return emptyObservationReviewState();
         }
         return {
-            kind: 'observe-review-state',
+            reportKind: 'observe-review-state',
             schemaVersion: 1,
             updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : new Date().toISOString(),
             entries: Object.fromEntries(Object.entries(parsed.entries).filter(([, entry]) => isReviewStateEntry(entry))),
@@ -166,4 +166,3 @@ function isObservationMetricKey(value) {
         || value === 'self_correction'
         || value === 'repeated_execution';
 }
-//# sourceMappingURL=review-state.js.map

package/dist/observability/skill-chain-advisories.d.ts

@@ -13,4 +13,3 @@ export declare function getSkillChainAdvisory(code: SkillChainAdvisoryCode): Ski
  * 只接受字母/数字/横线/下划线，避免 shell 注入风险。
  */
 export declare function resolveAdvisoryCommand(advisory: SkillChainAdvisory, skillName: string): string | undefined;
-//# sourceMappingURL=skill-chain-advisories.d.ts.map

package/dist/observability/skill-chain-advisories.js

@@ -66,4 +66,3 @@ export function resolveAdvisoryCommand(advisory, skillName) {
     const safe = /^[A-Za-z0-9_.-]+$/.test(skillName) ? skillName : '<skill-name>';
     return advisory.commandTemplate.replace(/\$\{skillName\}/g, safe);
 }
-//# sourceMappingURL=skill-chain-advisories.js.map

package/dist/observability/skill-chain.d.ts

@@ -4,4 +4,3 @@ export declare function buildObservationSkillChains(skillNames: string[], cwd?:
 export declare function buildObservationSkillChain(skillName: string, cwd?: string, experienceReports?: ObservationExperienceReport[]): ObservationSkillChain;
 export declare function findSkillMdPath(skillName: string, cwd: string): string | undefined;
 export declare function __resetSkillIndexCacheForTests(): void;
-//# sourceMappingURL=skill-chain.d.ts.map

package/dist/observability/skill-chain.js

@@ -68,13 +68,13 @@ function buildRuntimeChecks(skillName, definition, hardRules, workflows, workflo
     const invocations = experienceReports.flatMap((report) => report.invocations.filter((invocation) => invocation.skillName === skillName));
     const evidence = runtimeEvidence(invocations);
     const hardRuleChecks = hardRules.map((rule) => evaluateRuntimeText({
-        kind: 'hardRule',
+        nodeKind: 'hardRule',
         id: rule.id,
         title: rule.rule,
         expectation: rule.expectedBehavior,
     }, evidence));
     const workflowChecks = workflows.flatMap((workflow) => workflow.nodes.map((node) => evaluateRuntimeText({
-        kind: 'workflowNode',
+        nodeKind: 'workflowNode',
         id: `${workflow.id}.${node.id}`,
         title: node.action || `${workflow.id} / ${node.id}`,
         expectation: node.action,
@@ -130,7 +130,7 @@ function buildSkillRuntimeEvidencePack(input) {
         ...input.hardRules.map((rule) => nodeEvidenceForCheck({
             check: standardById.get(rule.id),
             nodeId: rule.id,
-            kind: 'hardRule',
+            nodeKind: 'hardRule',
             title: rule.rule,
             expectation: rule.expectedBehavior,
             refs: allRuntimeRefs,
@@ -138,7 +138,7 @@ function buildSkillRuntimeEvidencePack(input) {
         ...workflowNodes.map((node) => nodeEvidenceForCheck({
             check: standardById.get(node.id),
             nodeId: node.id,
-            kind: 'workflowNode',
+            nodeKind: 'workflowNode',
             title: node.title,
             expectation: node.expectation,
             refs: allRuntimeRefs,
@@ -185,7 +185,7 @@ function nodeEvidenceForCheck(input) {
         : [];
     return {
         nodeId: input.nodeId,
-        kind: input.kind,
+        nodeKind: input.nodeKind,
         title: input.title,
         expectation: input.expectation,
         deterministicStatus: input.check?.status ?? 'manual_review',
@@ -471,4 +471,3 @@ export function findSkillMdPath(skillName, cwd) {
 export function __resetSkillIndexCacheForTests() {
     skillIndexCache.clear();
 }
-//# sourceMappingURL=skill-chain.js.map