@longzai-intelligence-git/config 0.1.6 → 0.1.8

package/README.md

@@ -0,0 +1,13 @@
+# @longzai-intelligence-git/config
+
+Longzai Intelligence Git 的配置契约。
+
+## 简介
+
+治理本仓工具配置文件的统一口径：`lzi-git.config.ts` 所需的全部类型与 defineConfig 助手在此定义，零业务逻辑、零运行时依赖。
+
+## 能力
+
+- 定义 lzi-git.config.ts 配置类型契约（LziGitConfig）
+- 提供 defineConfig 配置助手
+- 定义 .gitignore 格式化选项、分组类型与预设键（含默认选项与默认预设）

package/dist/index.d.ts

@@ -132,6 +132,16 @@ type GitignorePresets = Partial<Record<GitignorePresetKey, boolean>>;
  * defineConfig 合并 presets 时用此作为基底，用户覆盖优先。
  */
 declare const DEFAULT_GITIGNORE_PRESETS: GitignorePresets;
+/**
+ * 内置禁止忽略项默认清单。
+ *
+ * @remarks
+ *   清单内的文件必须被 git 跟踪，禁止被任何忽略模式命中。
+ *   AGENTS.md 与 CLAUDE.md 曾于 2026-09-18 作为 lzi-agent-cli 合成产物纳入忽略，
+ *   2026-09-23 用户裁定两文件必须进源代码管理，自 `lzi` 预设移除后由本清单承担反向守门。
+ *   `format` 在格式化时政策性剔除命中项，`check` 检出违规并以非零退出报告。
+ */
+declare const DEFAULT_GITIGNORE_FORBIDDEN: readonly string[];
 /**
  * lzi-git.config.ts 根配置。
  *
@@ -166,7 +176,85 @@ type LziGitConfig = {
      * 未提供时仅使用 preset 分组。
      */
     readonly groups?: readonly GitignoreGroup[];
+    /**
+     * 禁止忽略项清单。
+     *
+     * @remarks
+     *   清单内的文件必须被 git 跟踪，忽略模式命中任一项即为违例。
+     *   `format` 在格式化时政策性剔除命中的忽略模式行，`check` 检出违规并以非零退出报告。
+     *   提供空数组可关闭守门，未提供时回退到内置默认清单。
+     * @default DEFAULT_GITIGNORE_FORBIDDEN
+     */
+    readonly forbidden?: readonly string[];
   };
+  /**
+   * fetch 调度配置。
+   *
+   * 形态为部分覆盖，未提供字段由 `@longzai-intelligence-git/fetch-scheduler` 的内置默认值兜底，
+   * 本包只声明配置形状，默认值真源在引擎包。
+   */
+  readonly fetchScheduler?: FetchSchedulerUserConfig;
+};
+/**
+ * fetch 调度配置的用户覆盖形态
+ *
+ * 与 `@longzai-intelligence-git/fetch-scheduler` 的 `FetchSchedulerOptions` 字段对位，
+ * 全字段可选，层级结构与引擎选项一致
+ */
+type FetchSchedulerUserConfig = {
+  /**
+   * 三档拉取间隔的部分覆盖
+   */
+  readonly tierTtlMs?: {
+    /**
+     * 活跃档拉取间隔，毫秒
+     */
+    readonly active?: number;
+    /**
+     * 近期档拉取间隔，毫秒
+     */
+    readonly recent?: number;
+    /**
+     * 休眠档拉取间隔，毫秒
+     */
+    readonly dormant?: number;
+  };
+  /**
+   * 活跃档判定窗口，毫秒
+   */
+  readonly activeWindowMs?: number;
+  /**
+   * 近期档判定窗口，毫秒
+   */
+  readonly recentWindowMs?: number;
+  /**
+   * 每仓到期抖动比例
+   */
+  readonly jitterRatio?: number;
+  /**
+   * 常驻轮询间隔，毫秒
+   */
+  readonly tickIntervalMs?: number;
+  /**
+   * 单轮拉取并发上限
+   */
+  readonly concurrency?: number;
+  /**
+   * 单仓拉取超时，毫秒
+   */
+  readonly fetchTimeoutMs?: number;
+  /**
+   * 连续失败退避阶梯，毫秒数组
+   */
+  readonly backoffStepsMs?: readonly number[];
+  /**
+   * 单轮最大派发数
+   */
+  readonly maxBatchSize?: number;
+  /**
+   * 参与调度的分档集合，取值为 `active`、`recent`、`dormant`
+   */
+  readonly tiers?: readonly ('active' | 'recent' | 'dormant')[];
 };
 //#endregion
 //#region src/define-config.d.ts
@@ -174,9 +262,10 @@ type LziGitConfig = {
  * lzi-git.config.ts 配置定义助手（内置默认预设 + 深合并覆盖）。
  *
  * 合并规则：
- *   - options：浅合并（用户字段覆盖 DEFAULT_GITIGNORE_OPTIONS 对应字段）
- *   - presets：浅合并（用户开关覆盖 DEFAULT_GITIGNORE_PRESETS 对应键，未列出的走 preset 自身 default）
- *   - groups：原样保留（用户自定义分组，可选；未提供则无自定义分组）
+ *
+ * - options：浅合并（用户字段覆盖 DEFAULT_GITIGNORE_OPTIONS 对应字段）
+ * - presets：浅合并（用户开关覆盖 DEFAULT_GITIGNORE_PRESETS 对应键，未列出的走 preset 自身 default）
+ * - groups：原样保留（用户自定义分组，可选；未提供则无自定义分组）
  *
  * 镜像 @longzai-intelligence-oxfmt/config 的 deep-merge defineConfig 模式。
  *
@@ -197,4 +286,4 @@ type LziGitConfig = {
  */
 declare const defineConfig: (userConfig?: LziGitConfig) => LziGitConfig;
 //#endregion
-export { DEFAULT_GITIGNORE_OPTIONS, DEFAULT_GITIGNORE_PRESETS, GITIGNORE_PRESETS, GitignoreFormatOptions, GitignoreGroup, GitignorePresetDefinition, GitignorePresetKey, GitignorePresets, LziGitConfig, defineConfig };
+export { DEFAULT_GITIGNORE_FORBIDDEN, DEFAULT_GITIGNORE_OPTIONS, DEFAULT_GITIGNORE_PRESETS, FetchSchedulerUserConfig, GITIGNORE_PRESETS, GitignoreFormatOptions, GitignoreGroup, GitignorePresetDefinition, GitignorePresetKey, GitignorePresets, LziGitConfig, defineConfig };

package/dist/index.js

@@ -1 +1 @@
-const e={groupByConfig:!0,injectMode:`root-only`,sortWithinGroup:!0,dedupe:!0,blankLinesBetweenGroups:1,miscGroupComment:`其他`},t={node:{comment:`依赖与构建`,patterns:[`node_modules/`,`dist/`,`build/`,`.cache/`,`*.log`,`*.tsbuildinfo`,`tsup.config.bundled_*.mjs`],default:!0},electron:{comment:`Electron`,patterns:[`out/`],default:!0},bun:{comment:`Bun`,patterns:[`.bun/`],default:!0},turbo:{comment:`Turbo`,patterns:[`.turbo/`],default:!0},swc:{comment:`SWC`,patterns:[`.swc/`],default:!0},coverage:{comment:`测试覆盖率`,patterns:[`coverage/`,`.nyc_output/`],default:!0},sqlite:{comment:`SQLite 数据库`,patterns:[`*.db`,`*.db-journal`,`*.db-wal`,`*.db-shm`,`*.sqlite`,`*.sqlite3`,`*.sqlite-journal`,`*.sqlite-wal`,`*.sqlite-shm`],default:!0},env:{comment:`环境变量`,patterns:[`.env`,`.env.*`,`!.env.example`],default:!0},idea:{comment:`JetBrains IDE`,patterns:[`.idea/`],default:!0},vscode:{comment:`VSCode`,patterns:[`.vscode/*`,`!.vscode/settings.json`,`!.vscode/tasks.json`,`!.vscode/launch.json`,`!.vscode/extensions.json`],default:!1},macos:{comment:`macOS 系统文件`,patterns:[`.DS_Store`],default:!0},windows:{comment:`Windows 系统文件`,patterns:[`Thumbs.db`,`ehthumbs.db`,`Desktop.ini`],default:!1},linux:{comment:`Linux 系统文件`,patterns:[`*~`],default:!1},npm:{comment:`npm`,patterns:[`.npmrc`],default:!0},agent:{comment:`AI Agent 本地文件`,patterns:[`CLAUDE.local.md`],default:!0},lzi:{comment:`lzi 工具链产物`,patterns:[`.lzi/issues/`],default:!0}},n=Object.fromEntries(Object.keys(t).map(e=>[e,t[e].default])),r={gitignore:{options:e,presets:n}},i=t=>{if(t===void 0||t.gitignore===void 0)return r;let i=t.gitignore,a={options:{...e,...i.options},presets:{...n,...i.presets},...i.groups===void 0?{}:{groups:i.groups}};return{...t,gitignore:a}};export{e as DEFAULT_GITIGNORE_OPTIONS,n as DEFAULT_GITIGNORE_PRESETS,t as GITIGNORE_PRESETS,i as defineConfig};
+const e={groupByConfig:!0,injectMode:`root-only`,sortWithinGroup:!0,dedupe:!0,blankLinesBetweenGroups:1,miscGroupComment:`其他`},t={node:{comment:`依赖与构建`,patterns:[`node_modules/`,`dist/`,`build/`,`.cache/`,`*.log`,`*.tsbuildinfo`,`tsup.config.bundled_*.mjs`],default:!0},electron:{comment:`Electron`,patterns:[`out/`],default:!0},bun:{comment:`Bun`,patterns:[`.bun/`],default:!0},turbo:{comment:`Turbo`,patterns:[`.turbo/`],default:!0},swc:{comment:`SWC`,patterns:[`.swc/`],default:!0},coverage:{comment:`测试覆盖率`,patterns:[`coverage/`,`.nyc_output/`],default:!0},sqlite:{comment:`SQLite 数据库`,patterns:[`*.db`,`*.db-journal`,`*.db-wal`,`*.db-shm`,`*.sqlite`,`*.sqlite3`,`*.sqlite-journal`,`*.sqlite-wal`,`*.sqlite-shm`],default:!0},env:{comment:`环境变量`,patterns:[`.env`,`.env.*`,`!.env.example`],default:!0},idea:{comment:`JetBrains IDE`,patterns:[`.idea/`],default:!0},vscode:{comment:`VSCode`,patterns:[`.vscode/*`,`!.vscode/settings.json`,`!.vscode/tasks.json`,`!.vscode/launch.json`,`!.vscode/extensions.json`],default:!1},macos:{comment:`macOS 系统文件`,patterns:[`.DS_Store`],default:!0},windows:{comment:`Windows 系统文件`,patterns:[`Thumbs.db`,`ehthumbs.db`,`Desktop.ini`],default:!1},linux:{comment:`Linux 系统文件`,patterns:[`*~`],default:!1},npm:{comment:`npm`,patterns:[`.npmrc`],default:!0},agent:{comment:`AI Agent 本地文件`,patterns:[`CLAUDE.local.md`],default:!0},lzi:{comment:`lzi 工具链产物`,patterns:[`.lzi/issues/`],default:!0}},n=Object.fromEntries(Object.keys(t).map(e=>[e,t[e].default])),r=[`AGENTS.md`,`CLAUDE.md`],i={gitignore:{options:e,presets:n,forbidden:r}},a=t=>{if(t===void 0)return i;if(t.gitignore===void 0)return{...t,gitignore:i.gitignore};let a=t.gitignore,o={options:{...e,...a.options},presets:{...n,...a.presets},...a.groups===void 0?{}:{groups:a.groups},forbidden:a.forbidden??r};return{...t,gitignore:o}};export{r as DEFAULT_GITIGNORE_FORBIDDEN,e as DEFAULT_GITIGNORE_OPTIONS,n as DEFAULT_GITIGNORE_PRESETS,t as GITIGNORE_PRESETS,a as defineConfig};

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "@longzai-intelligence-git/config",
-  "version": "0.1.6",
-  "description": "Longzai Intelligence Git - lzi-git.config.ts 配置契约",
+  "version": "0.1.8",
+  "description": "Longzai Intelligence Git 配置契约",
+  "keywords": [
+    "config",
+    "git",
+    "longzai-intelligence",
+    "schema"
+  ],
   "files": [
     "dist"
   ],