oh-my-knowledge 0.30.0 → 0.32.0

package/dist/observability/review-state.js

@@ -0,0 +1,169 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function observationReviewStateKey(targetType, targetId) {
+    return `${targetType}:${targetId}`;
+}
+export function observationMetricScopeFor(metricKey) {
+    return metricKey === 'user_correction'
+        || metricKey === 'user_interruption'
+        || metricKey === 'user_follow_up'
+        || metricKey === 'hard_rule'
+        || metricKey === 'user_goal_shift'
+        ? 'skill_segment'
+        : 'message';
+}
+export function observationMetricAnnotationTargetId(ref, metricKey) {
+    const hasStableTraceRef = Boolean(ref.sourceTrace || ref.sessionId || ref.messageIndex !== undefined || ref.messageUuid || ref.toolUseId);
+    const scope = observationMetricScopeFor(metricKey);
+    const stable = [
+        metricKey,
+        ...(scope === 'skill_segment' ? [scope, ref.metricScopeId ?? ''] : []),
+        ref.sourceTrace ?? '',
+        ref.sessionId ?? '',
+        ref.messageIndex === undefined ? '' : String(ref.messageIndex),
+        ref.messageUuid ?? '',
+        ref.toolUseId ?? '',
+        hasStableTraceRef ? '' : ref.id ?? '',
+    ].join('\u0000');
+    return `metric:${metricKey}:${createHash('sha256').update(stable).digest('hex').slice(0, 16)}`;
+}
+export function observationMetricAnnotationVerdict(state, ref, metricKey) {
+    if (!state)
+        return undefined;
+    const targetId = observationMetricAnnotationTargetId(ref, metricKey);
+    const entry = state.entries[observationReviewStateKey('evidence_metric', targetId)];
+    return entry?.verdict === 'confirmed' || entry?.verdict === 'rejected' ? entry.verdict : undefined;
+}
+export function observationReviewStatePath(observationsDir) {
+    return join(observationsDir, 'review-state.json');
+}
+export function emptyObservationReviewState(now = new Date().toISOString()) {
+    return {
+        kind: 'observe-review-state',
+        schemaVersion: 1,
+        updatedAt: now,
+        entries: {},
+    };
+}
+export function loadObservationReviewState(observationsDir) {
+    const path = observationReviewStatePath(observationsDir);
+    if (!existsSync(path))
+        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') {
+            return emptyObservationReviewState();
+        }
+        return {
+            kind: '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))),
+        };
+    }
+    catch {
+        return emptyObservationReviewState();
+    }
+}
+export function updateObservationReviewState(observationsDir, update, now = new Date().toISOString()) {
+    assertReviewStateUpdate(update);
+    const state = loadObservationReviewState(observationsDir);
+    const key = observationReviewStateKey(update.targetType, update.targetId);
+    state.entries[key] = {
+        targetType: update.targetType,
+        targetId: update.targetId,
+        verdict: update.verdict,
+        reviewedAt: now,
+        ...(update.note ? { note: update.note.slice(0, 500) } : {}),
+        ...(update.reason ? { reason: update.reason.slice(0, 500) } : {}),
+        ...(update.metricKey ? { metricKey: update.metricKey } : {}),
+        ...(update.metricKey ? { metricScope: update.metricScope ?? observationMetricScopeFor(update.metricKey) } : {}),
+        ...(update.metricScopeId ? { metricScopeId: update.metricScopeId.slice(0, 200) } : {}),
+        ...(update.sourceTrace ? { sourceTrace: update.sourceTrace } : {}),
+        ...(update.sessionId ? { sessionId: update.sessionId } : {}),
+        ...(update.messageIndex !== undefined ? { messageIndex: update.messageIndex } : {}),
+        ...(update.messageUuid ? { messageUuid: update.messageUuid } : {}),
+        ...(update.toolUseId ? { toolUseId: update.toolUseId } : {}),
+        ...(update.snippet ? { snippet: update.snippet.slice(0, 500) } : {}),
+    };
+    state.updatedAt = now;
+    mkdirSync(observationsDir, { recursive: true });
+    writeFileSync(observationReviewStatePath(observationsDir), JSON.stringify(state, null, 2));
+    return state;
+}
+export function deleteObservationReviewState(observationsDir, targetType, targetId, now = new Date().toISOString()) {
+    if (!isReviewTargetType(targetType))
+        throw new Error('invalid review targetType');
+    if (typeof targetId !== 'string' || targetId.trim() === '')
+        throw new Error('invalid review targetId');
+    const state = loadObservationReviewState(observationsDir);
+    const key = observationReviewStateKey(targetType, targetId);
+    delete state.entries[key];
+    state.updatedAt = now;
+    mkdirSync(observationsDir, { recursive: true });
+    writeFileSync(observationReviewStatePath(observationsDir), JSON.stringify(state, null, 2));
+    return state;
+}
+function assertReviewStateUpdate(value) {
+    if (!isReviewTargetType(value.targetType))
+        throw new Error('invalid review targetType');
+    if (typeof value.targetId !== 'string' || value.targetId.trim() === '')
+        throw new Error('invalid review targetId');
+    if (!isReviewVerdict(value.verdict))
+        throw new Error('invalid review verdict');
+    if (value.targetType === 'evidence_metric' && !isObservationMetricKey(value.metricKey))
+        throw new Error('invalid metricKey');
+    if (value.metricScope !== undefined && !isObservationMetricScope(value.metricScope))
+        throw new Error('invalid metricScope');
+    if ((value.verdict === 'confirmed' || value.verdict === 'rejected') && value.targetType !== 'evidence_metric')
+        throw new Error('metric verdict requires evidence_metric targetType');
+}
+function isReviewStateEntry(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const entry = value;
+    return isReviewTargetType(entry.targetType)
+        && typeof entry.targetId === 'string'
+        && isReviewVerdict(entry.verdict)
+        && typeof entry.reviewedAt === 'string';
+}
+function isReviewTargetType(value) {
+    return value === 'experience_session'
+        || value === 'inbox_item'
+        || value === 'skill'
+        || value === 'goal_slice_correction'
+        || value === 'evidence_metric'
+        || value === 'reviewer_judgment'
+        || value === 'soft_standard'
+        || value === 'goal_keyword_correction'
+        || value === 'result_artifact_correction'
+        || value === 'completion_result_correction'
+        || value === 'deliverable_artifact_correction'
+        || value === 'skill_relevance_correction'
+        || value === 'workflow_completion_correction'
+        || value === 'hardrule_execution_correction'
+        || value === 'main_tool_execution_correction';
+}
+function isReviewVerdict(value) {
+    return value === 'reviewed' || value === 'real_issue' || value === 'not_issue' || value === 'needs_more_context' || value === 'confirmed' || value === 'rejected';
+}
+function isObservationMetricScope(value) {
+    return value === 'message' || value === 'skill_segment';
+}
+function isObservationMetricKey(value) {
+    return value === 'user_correction'
+        || value === 'user_interruption'
+        || value === 'user_follow_up'
+        || value === 'negative_feedback'
+        || value === 'positive_feedback'
+        || value === 'hard_rule'
+        || value === 'user_goal_shift'
+        || value === 'result_artifact'
+        || value === 'completion_result'
+        || value === 'deliverable_artifact'
+        || value === 'progress_update'
+        || value === 'self_correction'
+        || value === 'repeated_execution';
+}
+//# sourceMappingURL=review-state.js.map

package/dist/observability/review-state.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * inbox 报告侧的 skill-chain 改进建议字典。
+ *
+ * 仅为 inbox UI 展示用，不动 doctor 的 pass/fail 语义。
+ * code 命名风格与 doctor i18n key（如 `skill_metadata.hint.hardrules`）对齐，
+ * 这样将来 doctor 若也要展示同样的提示，code 可复用。
+ */
+import type { SkillChainAdvisory, SkillChainAdvisoryCode } from '../types/index.js';
+export type { SkillChainAdvisory, SkillChainAdvisoryCode };
+export declare function getSkillChainAdvisory(code: SkillChainAdvisoryCode): SkillChainAdvisory;
+/**
+ * 把 commandTemplate 里的 `${skillName}` 占位符替换成实际 skill 名。
+ * 只接受字母/数字/横线/下划线，避免 shell 注入风险。
+ */
+export declare function resolveAdvisoryCommand(advisory: SkillChainAdvisory, skillName: string): string | undefined;
+//# sourceMappingURL=skill-chain-advisories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-chain-advisories.d.ts","sourceRoot":"","sources":["../../src/observability/skill-chain-advisories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEpF,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AAmD3D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CAEtF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1G"}

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

@@ -0,0 +1,69 @@
+/**
+ * inbox 报告侧的 skill-chain 改进建议字典。
+ *
+ * 仅为 inbox UI 展示用，不动 doctor 的 pass/fail 语义。
+ * code 命名风格与 doctor i18n key（如 `skill_metadata.hint.hardrules`）对齐，
+ * 这样将来 doctor 若也要展示同样的提示，code 可复用。
+ */
+const ADVISORIES = {
+    hardrules_not_declared: {
+        code: 'hardrules_not_declared',
+        shortLabel: '未标准化 hardRules',
+        message: '未在 SKILL.md frontmatter 标准化声明 hardRules。以下内容为检测结果；建议沉淀为标准化 hardRules。',
+        exampleYaml: [
+            '---',
+            'name: your-skill',
+            'description: ...',
+            'hardRules:',
+            '  - id: must-confirm-project',
+            '    rule: 生成前先确认 projectId',
+            '    expectedBehavior: 调用方未提供 projectId 时主动追问，不要凭空生成',
+            '  - id: read-domain-first',
+            '    rule: 必须读取领域知识',
+            '    expectedBehavior: 先读 domain/*.md，缺失就降级提示，禁止跳过',
+            '---',
+        ].join('\n'),
+    },
+    workflows_not_declared: {
+        code: 'workflows_not_declared',
+        shortLabel: '未标准化 workflows',
+        message: '未在 SKILL.md frontmatter 标准化声明 workflows。以下内容为检测结果；建议沉淀为标准化 workflows。',
+        exampleYaml: [
+            '---',
+            'name: your-skill',
+            'workflows:',
+            '  - id: main',
+            '    description: 标准主流程',
+            '    nodes:',
+            '      - id: collect-input',
+            '        action: 收集需求与上下文',
+            '      - id: read-domain',
+            '        action: 读取领域知识',
+            '      - id: generate',
+            '        action: 生成产物',
+            '      - id: upload',
+            '        action: 上传到需求管理系统',
+            '---',
+        ].join('\n'),
+    },
+    skill_md_not_found: {
+        code: 'skill_md_not_found',
+        shortLabel: '本地未找到 SKILL.md',
+        message: '本地常见 skill 目录里没有这个 skill 的 SKILL.md，inbox 跑不了静态/运行时审计。如果你想看更多体检维度（依赖检查、可读性等），可以试试 omk doctor；inbox 本身不依赖它。',
+        commandTemplate: 'omk doctor ~/.claude/skills/${skillName}/SKILL.md --static-only',
+    },
+};
+export function getSkillChainAdvisory(code) {
+    return ADVISORIES[code];
+}
+/**
+ * 把 commandTemplate 里的 `${skillName}` 占位符替换成实际 skill 名。
+ * 只接受字母/数字/横线/下划线，避免 shell 注入风险。
+ */
+export function resolveAdvisoryCommand(advisory, skillName) {
+    if (!advisory.commandTemplate)
+        return undefined;
+    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-advisories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-chain-advisories.js","sourceRoot":"","sources":["../../src/observability/skill-chain-advisories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,UAAU,GAAuD;IACrE,sBAAsB,EAAE;QACtB,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,uEAAuE;QAChF,WAAW,EAAE;YACX,KAAK;YACL,kBAAkB;YAClB,kBAAkB;YAClB,YAAY;YACZ,8BAA8B;YAC9B,4BAA4B;YAC5B,qDAAqD;YACrD,2BAA2B;YAC3B,oBAAoB;YACpB,mDAAmD;YACnD,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD,sBAAsB,EAAE;QACtB,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,uEAAuE;QAChF,WAAW,EAAE;YACX,KAAK;YACL,kBAAkB;YAClB,YAAY;YACZ,cAAc;YACd,wBAAwB;YACxB,YAAY;YACZ,2BAA2B;YAC3B,0BAA0B;YAC1B,yBAAyB;YACzB,wBAAwB;YACxB,sBAAsB;YACtB,sBAAsB;YACtB,oBAAoB;YACpB,2BAA2B;YAC3B,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,oBAAoB;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,4GAA4G;QACrH,eAAe,EAAE,iEAAiE;KACnF;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAA4B,EAAE,SAAiB;IACpF,IAAI,CAAC,QAAQ,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;IAC9E,OAAO,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { ObservationExperienceReport, ObservationRuntimeCheck, ObservationRuntimeCheckStatus, ObservationSkillChain, SkillRuntimeEvidencePack, SkillRuntimeEvidencePackNode, SkillRuntimeEvidencePackRef, SkillRuntimeEvidencePackSourceType } from '../types/index.js';
+export type { ObservationRuntimeCheck, ObservationRuntimeCheckStatus, ObservationSkillChain, SkillRuntimeEvidencePack, SkillRuntimeEvidencePackNode, SkillRuntimeEvidencePackRef, SkillRuntimeEvidencePackSourceType, };
+export declare function buildObservationSkillChains(skillNames: string[], cwd?: string, experienceReports?: ObservationExperienceReport[]): Record<string, ObservationSkillChain>;
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-chain.d.ts","sourceRoot":"","sources":["../../src/observability/skill-chain.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAGV,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,EAC7B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,EACnC,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,uBAAuB,EACvB,6BAA6B,EAC7B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,GACnC,CAAC;AAIF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,SAAgB,EAAE,iBAAiB,GAAE,2BAA2B,EAAO,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAGnL;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAgB,EAAE,iBAAiB,GAAE,2BAA2B,EAAO,GAAG,qBAAqB,CA2C/J;AAkaD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}