oh-my-knowledge 0.31.0 → 0.33.0

package/dist/observability/experience-frontmatter.js

@@ -0,0 +1,100 @@
+/**
+ * skill SKILL.md frontmatter 读取 + 投影到 experience 报告字段。
+ *
+ * experience.ts 在构建复盘报告时需要三处 frontmatter 投影:
+ *   - `loadFrontmatterSkillType`:读 `skillType` / `type` / `category` 字段,
+ *     归一化为 `ExperienceRuntimeSkillType`(router / executor / advisory / ...),
+ *     用于声明侧 skill 类型(对照 trace 推断)
+ *   - `loadSkillDeclarationCheck`:解析 SKILL.md 的 hard rules / workflows 声明,
+ *     用于复盘报告里的 declaration 步骤
+ *   - `loadExpectedToolsForSkill`:读 `expected_tools` / `expectedTools` 字段,
+ *     用于「真用上声明的工具」判定
+ *
+ * 设计原则:
+ *   - 只做 IO + 投影:读 skill.md、解析 frontmatter、归一化字段
+ *   - 不做事件链路推断:`traceInferredSkillType` 等不属于 frontmatter 投影,留在 experience.ts
+ *   - 所有读文件异常 swallow:复盘报告不该因为缺一个 skill.md 而 throw,
+ *     缺失时降级为 undefined / [] / `{declared:false,count:0}`
+ *
+ * 阶段 3 PR2 拆分历史:原本住在 experience.ts 内部,与事件链路投影逻辑混杂。
+ * 拆出独立文件后,experience.ts 主体回归「事件 → 复盘字段」单职责,frontmatter
+ * IO 改为通过本模块显式调用。
+ */
+import { readFileSync } from 'node:fs';
+import { parseSkillFrontmatter, validateSkillHardRules, validateSkillWorkflows } from '../shared/hard-rules.js';
+import { findSkillMdPath } from './skill-chain.js';
+export function loadFrontmatterSkillType(skillName, cwd) {
+    const path = findSkillMdPath(skillName, cwd ?? '');
+    if (!path)
+        return undefined;
+    try {
+        const parsed = parseSkillFrontmatter(readFileSync(path, 'utf8'));
+        if (!parsed.ok)
+            return undefined;
+        const raw = parsed.data?.skillType ?? parsed.data?.type ?? parsed.data?.category;
+        return normalizeRuntimeSkillType(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function loadSkillDeclarationCheck(skillName, cwd) {
+    const path = findSkillMdPath(skillName, cwd ?? process.cwd());
+    if (!path) {
+        return {
+            hardRules: { declared: false, count: 0 },
+            workflows: { declared: false, count: 0 },
+        };
+    }
+    try {
+        const content = readFileSync(path, 'utf-8');
+        const hardRules = validateSkillHardRules(content);
+        const workflows = validateSkillWorkflows(content);
+        return {
+            hardRules: { declared: hardRules.declared, count: hardRules.rules.length },
+            workflows: { declared: workflows.declared, count: workflows.workflows.reduce((sum, workflow) => sum + workflow.nodes.length, 0) },
+        };
+    }
+    catch {
+        return {
+            hardRules: { declared: false, count: 0 },
+            workflows: { declared: false, count: 0 },
+        };
+    }
+}
+export function loadExpectedToolsForSkill(skillName, cwd) {
+    const path = findSkillMdPath(skillName, cwd ?? process.cwd());
+    if (!path)
+        return [];
+    try {
+        const parsed = parseSkillFrontmatter(readFileSync(path, 'utf-8'));
+        const data = parsed.ok ? parsed.data : undefined;
+        const value = data?.expected_tools ?? data?.expectedTools;
+        return Array.isArray(value)
+            ? unique(value.filter((item) => typeof item === 'string' && Boolean(item.trim())).map((item) => item.trim()))
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+function normalizeRuntimeSkillType(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.trim().toLowerCase().replace(/[_\s-]+/g, '_');
+    if (normalized === 'router' || normalized === 'route')
+        return 'router';
+    if (normalized === 'delegation' || normalized === 'delegate' || normalized === 'delegator')
+        return 'delegation';
+    if (normalized === 'executor' || normalized === 'execute')
+        return 'executor';
+    if (normalized === 'advisory' || normalized === 'advisor' || normalized === 'consulting')
+        return 'advisory';
+    if (normalized === 'workflow_owner' || normalized === 'workflowowner' || normalized === 'workflow')
+        return 'workflow_owner';
+    return undefined;
+}
+function unique(values) {
+    return Array.from(new Set(values));
+}
+//# sourceMappingURL=experience-frontmatter.js.map

package/dist/observability/experience-frontmatter.js.map

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

package/dist/observability/experience.d.ts

@@ -0,0 +1,23 @@
+import 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, ObservationInboxItem, ObservationReviewState } from '../types/index.js';
+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 declare function aggregateExperienceChecklistItemStatus(statuses: ExperienceChecklistItemStatus[]): ExperienceChecklistItemStatus;
+interface BuildExperienceInput {
+    sessions: CcSession[];
+    segments: SkillSegment[];
+    items: ObservationInboxItem[];
+    generatedAt: string;
+    reviewState?: ObservationReviewState;
+}
+export declare function buildObservationExperienceReport(input: BuildExperienceInput): ObservationExperienceReport;
+export declare function isExperienceTraceInProgress(session: ExperienceSessionSummary): boolean;
+export declare function hasRecognizableUserGoalText(value: string | undefined): boolean;
+export declare function foldExperienceChecklistItems(items: ExperienceChecklistItem[]): {
+    status: ExperienceReviewerReportStepStatus;
+    reason: ExperienceParentReason;
+    sourceItemKeys: string[];
+};
+//# sourceMappingURL=experience.d.ts.map

package/dist/observability/experience.d.ts.map

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