@longzai-intelligence-git/massive-sync-runner 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+import { GitExecutor } from "@longzai-intelligence-git/core";
+//#region src/types.d.ts
+/**
+ * 同步策略
+ */
+type SyncStrategy = 'rebase' | 'fast_forward_only' | 'merge';
+/**
+ * 同步阶段标识
+ */
+type SyncStage = 'fetch' | 'rebase' | 'merge' | 'push';
+/**
+ * 同步进度（单次快照）
+ */
+type SyncProgress = {
+  stage: SyncStage;
+  stageRatio: number;
+  overallRatio: number;
+  processedCount: number;
+  totalCount: number;
+};
+/**
+ * 同步断点（阶段完成时落盘，供 resume 恢复）
+ */
+type SyncCheckpoint = {
+  id: string;
+  taskId: string;
+  completedStages: SyncStage[];
+  currentPosition?: string | null;
+  processedCount: number;
+  updatedAt: number;
+};
+/**
+ * 单阶段结果
+ */
+type SyncStageResult = {
+  stage: SyncStage;
+  status: 'completed' | 'skipped';
+  durationMs: number;
+  resultingSha: string | null;
+  error: string | null;
+};
+/**
+ * 同步任务最终结果
+ */
+type SyncResult = {
+  taskId: string;
+  stages: SyncStageResult[];
+  totalDurationMs: number;
+  success: boolean;
+};
+/**
+ * 同步执行入参（全字段可选，缺省由 runner 填默认值）
+ */
+type SyncInput = {
+  remote?: string;
+  ref?: string;
+  strategy?: SyncStrategy;
+  segmentSize?: number;
+  stallTimeoutMs?: number;
+  absoluteTimeoutMs?: number;
+  stageTimeoutMs?: number;
+  stageRetries?: number;
+};
+/**
+ * 断点存储接口（平台无关，file/in-memory 实现各自满足）
+ */
+type CheckpointStore = {
+  save(checkpoint: SyncCheckpoint): Promise<void>;
+  remove(id: string): Promise<void>;
+  list(): Promise<SyncCheckpoint[]>;
+};
+/**
+ * 运行器依赖
+ */
+type SyncRunnerDeps = {
+  /**
+   * git 执行器
+   */
+  executor: GitExecutor;
+  /**
+   * 仓库工作目录
+   */
+  repoPath: string;
+  /**
+   * 断点存储（可选，传入后阶段完成时落盘，支持 resume）
+   */
+  checkpointStore?: CheckpointStore;
+  /**
+   * 进度回调（可选）
+   */
+  onProgress?: (progress: SyncProgress) => void;
+};
+/**
+ * 执行结果（成功/失败二态，失败时可选携带部分断点）
+ */
+type SyncRunOutcome = {
+  success: true;
+  result: SyncResult;
+} | {
+  success: false;
+  error: Error;
+  partial?: SyncCheckpoint;
+};
+/**
+ * 同步运行器（函数式 API）
+ */
+type SyncRunner = {
+  /**
+   * 执行完整同步（fetch→rebase/merge→push）
+   */
+  run(input: SyncInput): Promise<SyncRunOutcome>;
+  /**
+   * 从断点恢复同步
+   */
+  resume(input: SyncInput, checkpoint: SyncCheckpoint): Promise<SyncRunOutcome>;
+  /**
+   * 取消运行中的同步（协作式，在阶段切换处生效）
+   */
+  cancel(): void;
+};
+//#endregion
+//#region src/create-sync-runner.d.ts
+/**
+ * 创建同步运行器
+ *
+ * @param deps - 运行器依赖（executor + repoPath + 可选 checkpointStore/onProgress）
+ * @returns SyncRunner 实例（run/resume/cancel）
+ */
+declare const createSyncRunner: (deps: SyncRunnerDeps) => SyncRunner;
+//#endregion
+//#region src/file-checkpoint-store.d.ts
+/**
+ * 文件存储选项
+ */
+type FileCheckpointStoreOptions = {
+  /**
+   * 仓库工作目录（`.git` 的父目录）
+   */
+  repoPath: string;
+  /**
+   * 断点目录（相对 repoPath，默认 `.git/lzi-sync`）
+   */
+  dirName?: string;
+};
+/**
+ * 创建文件系统断点存储
+ *
+ * @param options - 文件存储选项（仓库路径 + 可选断点目录名）
+ * @returns CheckpointStore 实现，所有方法均落盘到 `<repoPath>/<dirName>/<taskId>.json`
+ */
+declare const createFileCheckpointStore: (options: FileCheckpointStoreOptions) => CheckpointStore;
+//#endregion
+export { type CheckpointStore, type FileCheckpointStoreOptions, type SyncCheckpoint, type SyncInput, type SyncProgress, type SyncResult, type SyncRunOutcome, type SyncRunner, type SyncRunnerDeps, type SyncStage, type SyncStageResult, type SyncStrategy, createFileCheckpointStore, createSyncRunner };

package/dist/index.js

@@ -0,0 +1 @@
+import"./rolldown-runtime-BqT_7tdF.js";import{createRefName as e}from"@longzai-intelligence-git/core";import{createSyncPipeline as t}from"@longzai-intelligence-git/massive-sync-pipeline";import{promises as n}from"node:fs";import*as r from"node:path";const i={remote:`origin`,ref:`refs/heads/main`,strategy:`rebase`,segmentSize:1e3,stallTimeoutMs:12e4,absoluteTimeoutMs:18e5,stageTimeoutMs:3e5,stageRetries:3},a=e=>e,o=n=>{let r={cancelled:!1},o=`sync-${Date.now()}-${Math.random().toString(36).slice(2,8)}`,s=async(s,c)=>{let l=t(n.executor),u=[],d=Date.now();try{let t=await l.execute({executor:n.executor,repoPath:n.repoPath,remote:s.remote??i.remote,ref:e(s.ref??i.ref),strategy:s.strategy??i.strategy,segmentSize:s.segmentSize??i.segmentSize,stallTimeoutMs:s.stallTimeoutMs??i.stallTimeoutMs,absoluteTimeoutMs:s.absoluteTimeoutMs??i.absoluteTimeoutMs,stageTimeoutMs:s.stageTimeoutMs??i.stageTimeoutMs,stageRetries:s.stageRetries??i.stageRetries,resumeFrom:c==null?void 0:{completedStages:c.completedStages,currentPosition:c.currentPosition??void 0},hooks:{onStageCompleted:async(e,t,r)=>{let i=a(e);u.includes(i)||u.push(i),n.checkpointStore!=null&&await n.checkpointStore.save({id:o,taskId:o,completedStages:[...u],currentPosition:t,processedCount:r,updatedAt:Date.now()})},onProgress:e=>{n.onProgress?.(e)},shouldCancel:()=>r.cancelled}});if(n.checkpointStore!=null)try{await n.checkpointStore.remove(o)}catch{}let f=t.stages.map(e=>({stage:a(e.stage),status:e.status,durationMs:e.durationMs,resultingSha:e.resultingSha,error:e.error}));return{success:!0,result:{taskId:o,stages:f,totalDurationMs:Date.now()-d,success:!0}}}catch(e){return{success:!1,error:e instanceof Error?e:Error(String(e)),partial:n.checkpointStore==null?void 0:{id:o,taskId:o,completedStages:[...u],currentPosition:null,processedCount:0,updatedAt:Date.now()}}}};return{run:e=>s(e,void 0),resume:(e,t)=>s(e,t),cancel:()=>{r.cancelled=!0}}};function s(e){return typeof e!=`object`||!e?!1:`id`in e&&`taskId`in e&&`completedStages`in e&&`processedCount`in e&&`updatedAt`in e}const c=e=>{if(s(e))return e;throw TypeError(`JSON 结构不符合 SyncCheckpoint`)},l=e=>{let t=r.join(e.repoPath,e.dirName??`.git/lzi-sync`),i=async()=>{await n.mkdir(t,{recursive:!0})},a=e=>r.join(t,`${e}.json`);return{async save(e){await i(),await n.writeFile(a(e.taskId),JSON.stringify(e,null,2),`utf8`)},async remove(e){try{await n.unlink(a(e))}catch{}},async list(){try{let e=await n.readdir(t),i=[];for(let a of e)if(a.endsWith(`.json`))try{let e=await n.readFile(r.join(t,a),`utf8`);i.push(c(JSON.parse(e)))}catch{}return i}catch{return[]}}}};export{l as createFileCheckpointStore,o as createSyncRunner};

package/dist/rolldown-runtime-BqT_7tdF.js

@@ -0,0 +1 @@
+import"node:module";export{};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@longzai-intelligence-git/massive-sync-runner",
+  "version": "0.0.1",
+  "description": "Longzai Intelligence Git - 巨量同步任务运行器（函数式状态机执行核心，cli/desktop 直接消费，非 Port）",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "@longzai-intelligence-git/core": "0.0.1",
+    "@longzai-intelligence-git/massive-sync-pipeline": "0.0.1"
+  },
+  "peerDependencies": {
+    "zod": "^4.4.3"
+  }
+}