@specpow/framework 0.2.0

package/dist/core/artifact-graph/state.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 状态检测器
+ *
+ * 检测工件的完成状态（文件是否存在）
+ */
+import type { Artifact } from './types.js';
+import type { WorkflowStage } from '../workflow-state.js';
+export declare class StateDetector {
+    /**
+     * 检测单个工件是否已完成
+     */
+    isComplete(artifact: Artifact, changeRoot: string): boolean;
+    /**
+     * 检测变更目录下所有工件的状态
+     */
+    detectAll(artifacts: Artifact[], changeRoot: string): Map<string, boolean>;
+    /**
+     * 获取变更目录下已存在的文件集合
+     *
+     * 返回相对于 changeRoot 的路径集合，
+     * 与 Artifact.output 的路径格式保持一致
+     */
+    getExistingFiles(changeRoot: string): Set<string>;
+    /**
+     * 从文件路径推断工作流阶段
+     *
+     * P2-14: 工作流状态标签支持
+     */
+    inferStageFromArtifact(artifact: Artifact): WorkflowStage | null;
+    /**
+     * 检测变更目录的工作流阶段
+     *
+     * 通过分析目录结构和文件内容推断当前阶段
+     */
+    detectWorkflowStage(changeRoot: string): WorkflowStage | null;
+    /**
+     * 生成工作流状态摘要
+     */
+    generateWorkflowSummary(artifacts: Artifact[], changeRoot: string): WorkflowSummary;
+}
+/**
+ * 工作流摘要
+ */
+export interface WorkflowSummary {
+    currentStage: WorkflowStage | null;
+    totalArtifacts: number;
+    completedArtifacts: number;
+    completionRate: number;
+    artifactsByStage: Partial<Record<WorkflowStage, {
+        total: number;
+        completed: number;
+    }>>;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/core/artifact-graph/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,qBAAa,aAAa;IACxB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAc3D;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ1E;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAsBjD;;;;OAIG;IACH,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,IAAI;IAchE;;;;OAIG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAgC7D;;OAEG;IACH,uBAAuB,CACrB,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,EAAE,MAAM,GACjB,eAAe;CAmCnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE;QAC9C,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC,CAAC;CACL"}

package/dist/core/artifact-graph/state.js

@@ -0,0 +1,149 @@
+/**
+ * 状态检测器
+ *
+ * 检测工件的完成状态（文件是否存在）
+ */
+import { existsSync, readdirSync, statSync } from 'fs';
+import { resolve, join, relative } from 'path';
+import { globSync } from 'glob';
+import { inferStageFromPath } from '../workflow-state.js';
+export class StateDetector {
+    /**
+     * 检测单个工件是否已完成
+     */
+    isComplete(artifact, changeRoot) {
+        if (!artifact.output)
+            return false;
+        const outputPath = resolve(changeRoot, artifact.output);
+        // 支持 glob 模式
+        if (artifact.output.includes('*')) {
+            const matches = globSync(artifact.output, { cwd: changeRoot });
+            return matches.length > 0;
+        }
+        return existsSync(outputPath);
+    }
+    /**
+     * 检测变更目录下所有工件的状态
+     */
+    detectAll(artifacts, changeRoot) {
+        const results = new Map();
+        for (const artifact of artifacts) {
+            results.set(artifact.id, this.isComplete(artifact, changeRoot));
+        }
+        return results;
+    }
+    /**
+     * 获取变更目录下已存在的文件集合
+     *
+     * 返回相对于 changeRoot 的路径集合，
+     * 与 Artifact.output 的路径格式保持一致
+     */
+    getExistingFiles(changeRoot) {
+        const files = new Set();
+        const walk = (dir) => {
+            if (!existsSync(dir))
+                return;
+            const entries = readdirSync(dir);
+            for (const entry of entries) {
+                const fullPath = join(dir, entry);
+                const stat = statSync(fullPath);
+                if (stat.isFile()) {
+                    // 存储相对路径，与 artifact.output 格式一致
+                    files.add(relative(changeRoot, fullPath));
+                }
+                else if (stat.isDirectory()) {
+                    walk(fullPath);
+                }
+            }
+        };
+        walk(changeRoot);
+        return files;
+    }
+    /**
+     * 从文件路径推断工作流阶段
+     *
+     * P2-14: 工作流状态标签支持
+     */
+    inferStageFromArtifact(artifact) {
+        // 从输出路径推断
+        if (artifact.output) {
+            const stage = inferStageFromPath(artifact.output);
+            if (stage)
+                return stage;
+        }
+        // 从工件 ID 推断
+        const stageFromId = inferStageFromPath(artifact.id);
+        if (stageFromId)
+            return stageFromId;
+        return null;
+    }
+    /**
+     * 检测变更目录的工作流阶段
+     *
+     * 通过分析目录结构和文件内容推断当前阶段
+     */
+    detectWorkflowStage(changeRoot) {
+        // 检查是否存在特定阶段的标志文件
+        const stageIndicators = [
+            { file: 'explore.md', stage: 'explore' },
+            { file: 'proposal.md', stage: 'propose' },
+            { file: 'design.md', stage: 'propose' },
+            { file: 'tasks.md', stage: 'propose' },
+            { file: 'apply.log', stage: 'apply' },
+            { file: 'verification.md', stage: 'verify' },
+            { file: 'archive.log', stage: 'archive' },
+        ];
+        for (const { file, stage } of stageIndicators) {
+            if (existsSync(join(changeRoot, file))) {
+                return stage;
+            }
+        }
+        // 检查子目录
+        const subdirs = readdirSync(changeRoot, { withFileTypes: true })
+            .filter(entry => entry.isDirectory())
+            .map(entry => entry.name);
+        if (subdirs.includes('explore'))
+            return 'explore';
+        if (subdirs.includes('proposal'))
+            return 'propose';
+        if (subdirs.includes('implementation'))
+            return 'apply';
+        if (subdirs.includes('verification'))
+            return 'verify';
+        if (subdirs.includes('archive'))
+            return 'archive';
+        return null;
+    }
+    /**
+     * 生成工作流状态摘要
+     */
+    generateWorkflowSummary(artifacts, changeRoot) {
+        const completionStatus = this.detectAll(artifacts, changeRoot);
+        const currentStage = this.detectWorkflowStage(changeRoot);
+        const totalArtifacts = artifacts.length;
+        const completedArtifacts = Array.from(completionStatus.values())
+            .filter(Boolean).length;
+        const artifactsByStage = new Map();
+        for (const artifact of artifacts) {
+            const stage = this.inferStageFromArtifact(artifact);
+            if (stage) {
+                const stats = artifactsByStage.get(stage) || { total: 0, completed: 0 };
+                stats.total++;
+                if (completionStatus.get(artifact.id)) {
+                    stats.completed++;
+                }
+                artifactsByStage.set(stage, stats);
+            }
+        }
+        return {
+            currentStage,
+            totalArtifacts,
+            completedArtifacts,
+            completionRate: totalArtifacts > 0
+                ? (completedArtifacts / totalArtifacts) * 100
+                : 0,
+            artifactsByStage: Object.fromEntries(artifactsByStage),
+        };
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/core/artifact-graph/state.js.map

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

package/dist/core/artifact-graph/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * 工件图类型定义
+ *
+ * 使用 Zod 进行运行时验证，确保数据完整性
+ */
+import { z } from 'zod';
+/**
+ * 工件状态
+ */
+export declare const ArtifactStatusSchema: z.ZodEnum<["ready", "blocked", "done", "skipped"]>;
+export type ArtifactStatus = z.infer<typeof ArtifactStatusSchema>;
+/**
+ * 单个工件定义
+ */
+export declare const ArtifactSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    requires: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    template: z.ZodOptional<z.ZodString>;
+    instruction: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    conditional: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    requires: string[];
+    output?: string | undefined;
+    description?: string | undefined;
+    template?: string | undefined;
+    instruction?: string | undefined;
+    conditional?: boolean | undefined;
+}, {
+    name: string;
+    id: string;
+    output?: string | undefined;
+    description?: string | undefined;
+    requires?: string[] | undefined;
+    template?: string | undefined;
+    instruction?: string | undefined;
+    conditional?: boolean | undefined;
+}>;
+export type Artifact = z.infer<typeof ArtifactSchema>;
+/**
+ * Apply 阶段定义
+ */
+export declare const ApplyPhaseSchema: z.ZodObject<{
+    requires: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    requires: string[];
+}, {
+    requires?: string[] | undefined;
+}>;
+export type ApplyPhase = z.infer<typeof ApplyPhaseSchema>;
+/**
+ * Schema YAML 完整定义
+ */
+export declare const SchemaYamlSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    artifacts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        requires: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        template: z.ZodOptional<z.ZodString>;
+        instruction: z.ZodOptional<z.ZodString>;
+        output: z.ZodOptional<z.ZodString>;
+        conditional: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        requires: string[];
+        output?: string | undefined;
+        description?: string | undefined;
+        template?: string | undefined;
+        instruction?: string | undefined;
+        conditional?: boolean | undefined;
+    }, {
+        name: string;
+        id: string;
+        output?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+        template?: string | undefined;
+        instruction?: string | undefined;
+        conditional?: boolean | undefined;
+    }>, "many">;
+    apply: z.ZodDefault<z.ZodObject<{
+        requires: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requires: string[];
+    }, {
+        requires?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    apply: {
+        requires: string[];
+    };
+    artifacts: {
+        name: string;
+        id: string;
+        requires: string[];
+        output?: string | undefined;
+        description?: string | undefined;
+        template?: string | undefined;
+        instruction?: string | undefined;
+        conditional?: boolean | undefined;
+    }[];
+    description?: string | undefined;
+}, {
+    name: string;
+    artifacts: {
+        name: string;
+        id: string;
+        output?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+        template?: string | undefined;
+        instruction?: string | undefined;
+        conditional?: boolean | undefined;
+    }[];
+    apply?: {
+        requires?: string[] | undefined;
+    } | undefined;
+    description?: string | undefined;
+}>;
+export type SchemaYaml = z.infer<typeof SchemaYamlSchema>;
+/**
+ * 工件构建状态（运行时）
+ */
+export interface ArtifactBuildState {
+    artifact: Artifact;
+    status: ArtifactStatus;
+    outputPath?: string;
+    missingDeps: string[];
+}
+/**
+ * 工件图状态快照
+ */
+export interface GraphState {
+    schemaName: string;
+    changeName: string;
+    changeRoot: string;
+    planningHome: string;
+    artifacts: ArtifactBuildState[];
+    applyRequires: string[];
+    actionContext: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/artifact-graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB,oDAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/core/artifact-graph/types.js

@@ -0,0 +1,44 @@
+/**
+ * 工件图类型定义
+ *
+ * 使用 Zod 进行运行时验证，确保数据完整性
+ */
+import { z } from 'zod';
+/**
+ * 工件状态
+ */
+export const ArtifactStatusSchema = z.enum([
+    'ready', // 依赖已满足，可以创建
+    'blocked', // 依赖未满足
+    'done', // 已完成（文件存在）
+    'skipped', // 被跳过（条件不满足）
+]);
+/**
+ * 单个工件定义
+ */
+export const ArtifactSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    requires: z.array(z.string()).default([]), // 依赖的其他工件 ID
+    template: z.string().optional(), // 模板文件路径
+    instruction: z.string().optional(), // 给 AI 的指令
+    output: z.string().optional(), // 输出路径/glob 模式
+    conditional: z.boolean().optional(), // 是否为条件工件
+});
+/**
+ * Apply 阶段定义
+ */
+export const ApplyPhaseSchema = z.object({
+    requires: z.array(z.string()).default(['tasks']), // 实施前需要完成的工件
+});
+/**
+ * Schema YAML 完整定义
+ */
+export const SchemaYamlSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    artifacts: z.array(ArtifactSchema),
+    apply: ApplyPhaseSchema.default({ requires: ['tasks'] }),
+});
+//# sourceMappingURL=types.js.map

package/dist/core/artifact-graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,OAAO,EAAO,aAAa;IAC3B,SAAS,EAAK,QAAQ;IACtB,MAAM,EAAQ,YAAY;IAC1B,SAAS,EAAK,aAAa;CAC5B,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAQ,aAAa;IAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAmB,SAAS;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAgB,WAAW;IAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAqB,eAAe;IACjE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAe,UAAU;CAC7D,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,EAAG,aAAa;CACjE,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAClC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACzD,CAAC,CAAC"}

package/dist/core/channel/channel-event-log.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Channel 事件日志
+ *
+ * P2-13: 事件日志持久化
+ *
+ * 功能：
+ * - 事件日志存储
+ * - 日志查询
+ * - 日志归档
+ */
+import type { ChannelEvent } from './channel-types.js';
+export declare class EventLogStore {
+    private logDir;
+    private currentEvents;
+    private maxEventsPerFile;
+    constructor(logDir: string, maxEventsPerFile?: number);
+    /**
+     * 添加事件
+     */
+    add(event: ChannelEvent): Promise<void>;
+    /**
+     * 查询事件
+     */
+    query(filter?: EventLogFilter): Promise<ChannelEvent[]>;
+    /**
+     * 获取最近事件
+     */
+    getRecent(limit?: number): Promise<ChannelEvent[]>;
+    /**
+     * 保存当前日志
+     */
+    save(): Promise<void>;
+    /**
+     * 轮转日志
+     */
+    rotate(): Promise<void>;
+    /**
+     * 归档旧日志
+     */
+    archive(before: number): Promise<number>;
+    /**
+     * 清空所有日志
+     */
+    clear(): Promise<void>;
+    /**
+     * 获取统计信息
+     */
+    getStats(): Promise<EventLogStats>;
+    /**
+     * 加载所有事件
+     */
+    private loadAllEvents;
+    /**
+     * 获取当前日志文件路径
+     */
+    private getCurrentLogFile;
+    /**
+     * 获取日志文件数量
+     */
+    private getLogFileCount;
+}
+export interface EventLogFilter {
+    type?: string;
+    agentId?: string;
+    timeRange?: {
+        start: number;
+        end: number;
+    };
+}
+export interface EventLogStats {
+    totalEvents: number;
+    eventsByType: Record<string, number>;
+    recentEvents24h: number;
+    recentEvents7d: number;
+    logFileCount: number;
+}
+/**
+ * 创建事件日志存储
+ */
+export declare function createEventLogStore(logDir: string, maxEventsPerFile?: number): EventLogStore;
+//# sourceMappingURL=channel-event-log.d.ts.map

package/dist/core/channel/channel-event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-event-log.d.ts","sourceRoot":"","sources":["../../../src/core/channel/channel-event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,MAAM,EAAE,gBAAgB,SAAO;IASnD;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;OAEG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqB7D;;OAEG;IACG,SAAS,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKrD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAqBxC;;OAEG;YACW,aAAa;IAqB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAGxB;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,aAAa,CAE5F"}

package/dist/core/channel/channel-event-log.js

@@ -0,0 +1,177 @@
+/**
+ * Channel 事件日志
+ *
+ * P2-13: 事件日志持久化
+ *
+ * 功能：
+ * - 事件日志存储
+ * - 日志查询
+ * - 日志归档
+ */
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+// ─── 事件日志存储 ───────────────────────────────────────────
+export class EventLogStore {
+    logDir;
+    currentEvents = [];
+    maxEventsPerFile;
+    constructor(logDir, maxEventsPerFile = 1000) {
+        this.logDir = logDir;
+        this.maxEventsPerFile = maxEventsPerFile;
+        if (!existsSync(logDir)) {
+            mkdirSync(logDir, { recursive: true });
+        }
+    }
+    /**
+     * 添加事件
+     */
+    async add(event) {
+        this.currentEvents.push(event);
+        // 检查是否需要轮转
+        if (this.currentEvents.length >= this.maxEventsPerFile) {
+            await this.rotate();
+        }
+    }
+    /**
+     * 查询事件
+     */
+    async query(filter) {
+        await this.loadAllEvents();
+        let events = [...this.currentEvents];
+        if (filter) {
+            events = events.filter(e => {
+                if (filter.type && e.type !== filter.type)
+                    return false;
+                if (filter.agentId && e.agentId !== filter.agentId)
+                    return false;
+                if (filter.timeRange) {
+                    if (e.timestamp < filter.timeRange.start || e.timestamp > filter.timeRange.end) {
+                        return false;
+                    }
+                }
+                return true;
+            });
+        }
+        return events;
+    }
+    /**
+     * 获取最近事件
+     */
+    async getRecent(limit = 100) {
+        await this.loadAllEvents();
+        return this.currentEvents.slice(-limit);
+    }
+    /**
+     * 保存当前日志
+     */
+    async save() {
+        if (this.currentEvents.length === 0) {
+            return;
+        }
+        const logFile = this.getCurrentLogFile();
+        writeFileSync(logFile, JSON.stringify(this.currentEvents, null, 2), 'utf-8');
+    }
+    /**
+     * 轮转日志
+     */
+    async rotate() {
+        if (this.currentEvents.length === 0) {
+            return;
+        }
+        // 保存当前日志
+        await this.save();
+        // 清空当前事件
+        this.currentEvents = [];
+    }
+    /**
+     * 归档旧日志
+     */
+    async archive(before) {
+        await this.loadAllEvents();
+        const archived = this.currentEvents.filter(e => e.timestamp < before);
+        this.currentEvents = this.currentEvents.filter(e => e.timestamp >= before);
+        if (archived.length > 0) {
+            const archiveFile = join(this.logDir, `archive-${Date.now()}.json`);
+            writeFileSync(archiveFile, JSON.stringify(archived, null, 2), 'utf-8');
+        }
+        await this.save();
+        return archived.length;
+    }
+    /**
+     * 清空所有日志
+     */
+    async clear() {
+        this.currentEvents = [];
+        // 删除所有日志文件
+        const files = readdirSync(this.logDir).filter(f => f.endsWith('.json'));
+        for (const file of files) {
+            const filePath = join(this.logDir, file);
+            if (existsSync(filePath)) {
+                // 注意：这里不删除文件，只清空内容
+                writeFileSync(filePath, '[]', 'utf-8');
+            }
+        }
+    }
+    /**
+     * 获取统计信息
+     */
+    async getStats() {
+        await this.loadAllEvents();
+        const now = Date.now();
+        const oneDayAgo = now - 24 * 60 * 60 * 1000;
+        const oneWeekAgo = now - 7 * 24 * 60 * 60 * 1000;
+        const eventsByType = new Map();
+        for (const event of this.currentEvents) {
+            eventsByType.set(event.type, (eventsByType.get(event.type) || 0) + 1);
+        }
+        return {
+            totalEvents: this.currentEvents.length,
+            eventsByType: Object.fromEntries(eventsByType),
+            recentEvents24h: this.currentEvents.filter(e => e.timestamp > oneDayAgo).length,
+            recentEvents7d: this.currentEvents.filter(e => e.timestamp > oneWeekAgo).length,
+            logFileCount: this.getLogFileCount(),
+        };
+    }
+    /**
+     * 加载所有事件
+     */
+    async loadAllEvents() {
+        if (this.currentEvents.length > 0) {
+            return; // 已加载
+        }
+        const files = readdirSync(this.logDir)
+            .filter(f => f.endsWith('.json') && !f.startsWith('archive-'))
+            .sort();
+        for (const file of files) {
+            const filePath = join(this.logDir, file);
+            try {
+                const content = readFileSync(filePath, 'utf-8');
+                const events = JSON.parse(content);
+                this.currentEvents.push(...events);
+            }
+            catch (error) {
+                console.warn(`Failed to load event log ${file}:`, error);
+            }
+        }
+    }
+    /**
+     * 获取当前日志文件路径
+     */
+    getCurrentLogFile() {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        return join(this.logDir, `events-${timestamp}.json`);
+    }
+    /**
+     * 获取日志文件数量
+     */
+    getLogFileCount() {
+        return readdirSync(this.logDir).filter(f => f.endsWith('.json')).length;
+    }
+}
+/**
+ * 创建事件日志存储
+ */
+export function createEventLogStore(logDir, maxEventsPerFile) {
+    return new EventLogStore(logDir, maxEventsPerFile);
+}
+//# sourceMappingURL=channel-event-log.js.map