front-cpu 0.1.1

package/dist/isa/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * ISA 指令集类型定义（混合架构版）
+ *
+ * 支持：
+ * 1. 声明式请求配置（单个或多个请求）
+ * 2. 自定义执行逻辑
+ * 3. 乐观更新
+ */
+import type { InstructionContext } from "../types";
+/**
+ * 资源调度策略
+ */
+export type SchedulingStrategy = "out-of-order" | "serial" | "latest" | "read-write";
+/**
+ * 资源访问模式
+ */
+export type ResourceAccessMode = "read" | "write";
+/**
+ * 资源访问描述
+ */
+export interface ResourceAccess {
+    /** 资源ID */
+    id: string;
+    /** 访问模式，默认 write */
+    mode?: ResourceAccessMode;
+}
+/**
+ * 资源标识提取函数
+ * - 兼容旧格式：string[]
+ * - 新格式：{ id, mode }[]
+ */
+export type ResourceIdentifier<TPayload = any> = (payload: TPayload) => Array<string | ResourceAccess>;
+/**
+ * 指令元数据
+ */
+export interface InstructionMeta {
+    /** 指令描述 */
+    description: string;
+    /** 指令分类 */
+    category: "debug" | "task" | "schedule" | "system" | "area";
+    /** 资源标识符提取函数 */
+    resourceIdentifier: ResourceIdentifier;
+    /** 优先级 (0-10) */
+    priority: number;
+    /** 超时时间 (ms) */
+    timeout?: number;
+    /**
+     * 指令级别的调度策略（可选）
+     * 如果指定，会覆盖资源级别和全局默认策略
+     */
+    schedulingStrategy?: SchedulingStrategy;
+}
+/**
+ * HTTP 请求方法
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+/**
+ * 单个 HTTP 请求配置
+ */
+export interface RequestConfig<TPayload = any> {
+    method: HttpMethod;
+    url: string | ((payload: TPayload) => string);
+    body?: (payload: TPayload) => any;
+    headers?: Record<string, string>;
+}
+/**
+ * 多个 HTTP 请求配置
+ */
+export interface MultiRequestConfig<TPayload = any> {
+    /** 请求列表 */
+    requests: Array<RequestConfig<TPayload>>;
+    /** 执行模式：parallel（并发）或 sequential（串行） */
+    mode: "parallel" | "sequential";
+    /** 合并多个请求的结果（可选） */
+    combineResults?: (results: any[]) => any;
+}
+/**
+ * 乐观更新快照
+ */
+export interface OptimisticSnapshot {
+    [key: string]: any;
+}
+/**
+ * 乐观更新配置
+ */
+export interface OptimisticConfig<TPayload = any> {
+    /** 是否启用乐观更新 */
+    enabled: boolean;
+    /** 应用乐观更新，返回快照用于回滚 */
+    apply: (payload: TPayload, context: InstructionContext) => OptimisticSnapshot;
+    /** 回滚乐观更新 */
+    rollback: (snapshot: OptimisticSnapshot) => void;
+}
+/**
+ * 指令定义（混合架构）
+ *
+ * 两种方式（互斥）：
+ * 1. 声明式：配置 `request`（单个或多个）+ `commit`
+ * 2. 自定义：配置 `execute` + `commit`
+ */
+export interface InstructionDefinition<TPayload = any, TResult = any> {
+    /** 指令元数据 */
+    meta: InstructionMeta;
+    /**
+     * HTTP 请求配置
+     * - 单个请求：RequestConfig
+     * - 多个请求：MultiRequestConfig（支持并发/串行）
+     *
+     * 与 `execute` 互斥，优先使用 `request`
+     */
+    request?: RequestConfig<TPayload> | MultiRequestConfig<TPayload>;
+    /**
+     * 乐观更新配置（可选）
+     */
+    optimistic?: OptimisticConfig<TPayload>;
+    /**
+     * 前置验证（可选）
+     */
+    validate?: (payload: TPayload, context: InstructionContext) => Promise<boolean>;
+    /**
+     * 自定义执行逻辑（与 `request` 互斥）
+     *
+     * 适用场景：
+     * - 复杂的条件逻辑
+     * - 需要在请求间传递数据
+     * - 需要与旧系统集成
+     */
+    execute?: (payload: TPayload, context: InstructionContext) => Promise<TResult>;
+    /**
+     * 提交结果（写回阶段调用）
+     *
+     * 用于处理执行结果，如更新 Store
+     * @param result 执行结果
+     * @param payload 指令负载
+     * @param context 指令上下文
+     * @param optimisticSnapshot 乐观更新快照（如果有）
+     */
+    commit?: (result: TResult, payload: TPayload, context: InstructionContext, optimisticSnapshot?: any) => Promise<void>;
+}
+/**
+ * ISA 定义类型
+ */
+export type ISADefinition = Record<string, InstructionDefinition>;
+//# sourceMappingURL=types.d.ts.map

package/dist/isa/types.d.ts.map

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

package/dist/isa/types.js

@@ -0,0 +1,10 @@
+/**
+ * ISA 指令集类型定义（混合架构版）
+ *
+ * 支持：
+ * 1. 声明式请求配置（单个或多个请求）
+ * 2. 自定义执行逻辑
+ * 3. 乐观更新
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/isa/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/isa/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/logging/CPUConsole.d.ts

@@ -0,0 +1,105 @@
+/**
+ * CPU 控制台打印系统
+ *
+ * 职责：
+ * 1. 实时打印指令执行过程
+ * 2. 美观的彩色输出
+ * 3. 分级别控制详细程度
+ * 4. 可折叠的详细信息
+ */
+import type { QueuedInstruction } from '../types';
+import { ConsoleLevel } from './types';
+export declare class CPUConsole {
+    private enabled;
+    private level;
+    private filter;
+    constructor();
+    /**
+     * 加载设置
+     */
+    private loadSettings;
+    /**
+     * 配置方法
+     */
+    setLevel(level: ConsoleLevel): void;
+    setFilter(types: string[]): void;
+    enable(): void;
+    disable(): void;
+    getLevel(): ConsoleLevel;
+    /**
+     * 指令创建
+     */
+    onInstructionCreated(instruction: QueuedInstruction): void;
+    /**
+     * 指令成功
+     */
+    onInstructionSuccess(instruction: QueuedInstruction, duration: number): void;
+    /**
+     * 指令被取消
+     */
+    onInstructionCancelled(instruction: QueuedInstruction, duration: number): void;
+    /**
+     * 指令失败
+     */
+    onInstructionFailure(instruction: QueuedInstruction, error: Error, duration: number): void;
+    /**
+     * 乐观更新应用
+     */
+    onOptimisticApplied(instruction: QueuedInstruction): void;
+    /**
+     * 乐观更新回滚
+     */
+    onOptimisticRolledBack(instruction: QueuedInstruction, reason: string): void;
+    /**
+     * 资源冲突
+     */
+    onSchedulerConflict(instruction: QueuedInstruction, conflictingWith: string[], waitTime: number): void;
+    /**
+     * 网络请求
+     */
+    onNetworkRequest(instruction: QueuedInstruction, method: string, url: string): void;
+    /**
+     * 网络响应
+     */
+    onNetworkResponse(instruction: QueuedInstruction, status: number, latency: number): void;
+    /**
+     * 打印流水线阶段
+     */
+    private printPipelineStages;
+    /**
+     * 打印指令详情
+     */
+    private printInstructionDetails;
+    /**
+     * 打印智能建议
+     */
+    private printSuggestions;
+    /**
+     * 创建耗时条形图
+     */
+    private createDurationBar;
+    /**
+     * 格式化时间
+     */
+    private formatTime;
+    /**
+     * 判断是否应该打印
+     */
+    private shouldPrint;
+    /**
+     * 打印分隔线
+     */
+    printSeparator(title?: string): void;
+    /**
+     * 打印统计信息
+     */
+    printStats(stats: {
+        total: number;
+        success: number;
+        failed: number;
+        avgLatency: number;
+    }): void;
+}
+export declare const cpuConsole: CPUConsole;
+export { ConsoleLevel };
+//# sourceMappingURL=CPUConsole.d.ts.map

package/dist/logging/CPUConsole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CPUConsole.d.ts","sourceRoot":"","sources":["../../src/logging/CPUConsole.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAGtC,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAyB;;IAMvC;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKnC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKhC,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAIf,QAAQ,IAAI,YAAY;IAMxB;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;IAqD1D;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA8E5E;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA+C9E;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkD1F;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;IAiCzD;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAoC5E;;OAEG;IACH,mBAAmB,CACjB,WAAW,EAAE,iBAAiB,EAC9B,eAAe,EAAE,MAAM,EAAE,EACzB,QAAQ,EAAE,MAAM,GACf,IAAI;IAWP;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAWnF;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiBxF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAapC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAuBhG;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAA;AAG1C,OAAO,EAAE,YAAY,EAAE,CAAA"}