@longzai-intelligence-agent-tools/config 0.0.13

package/dist/index.d.ts

@@ -0,0 +1,208 @@
+//#region src/types.d.ts
+/**
+ * 共享提示词类别（config 侧自持定义，与 core 包机制域联合类型结构一致）
+ *
+ * agents = 根指令条目（hub agents/items/ → .lzi/agents/items/<ns>/）；
+ * rules = 项目规则（hub rules/ → .lzi/rules/<ns>/，trae 工具提示词
+ * .trae/rules/ 的真源集中化通道）。本包零运行时依赖，不跨包引用
+ * core 类型（沿订阅类型双轨维护的既有模式，结构兼容由 zod 兜底）。
+ */
+type SharedPromptsCategory = 'agents' | 'rules';
+/**
+ * 共享提示词订阅（项目侧配置单元）
+ *
+ * 项目对某 hub 仓的订阅声明，配置于 agent-tools 专属配置文件
+ * lzi-agent-tools.config.ts（见 SharedPromptsConfig），由
+ * shared register / shared unregister 机器维护。
+ * 只含跨机器稳定的项目事实（身份与语义）；hub 位置是机器本地
+ * 环境数据，落 .env 的 LZI_AGENT_TOOLS_SHARED_PROMPTS_ROOT，不进 git。
+ */
+type SharedPromptsSubscription = {
+  /**
+   * hub 仓库名（目录名，如 longzai-intelligence-agent-prompts；稳定标识，非路径）
+   */
+  readonly name: string;
+  /**
+   * 订阅类别（决定 hub 条目库与项目物化目标目录）；缺省按 agents 解析
+   * （手写配置兼容），机器再生配置显式写入
+   */
+  readonly category?: SharedPromptsCategory;
+  /**
+   * 订阅范围 glob 列表（相对 hub 侧该类别的条目库目录，如 ['lang/**']）；null = 订阅全部
+   */
+  readonly include: readonly string[] | null;
+  /**
+   * 排除 glob 列表（相对 hub 侧该类别的条目库目录，从 include 命中集中剔除）；null = 无排除
+   */
+  readonly exclude: readonly string[] | null;
+};
+/**
+ * 共享提示词配置（agentTools.sharedPrompts）
+ *
+ * 订阅列表的配置载体。经 shared-config 标准组合加载：
+ * 专属文件 lzi-agent-tools.config.ts 优先，统一配置 lzi.config.ts 的
+ * agentTools 字段兜底（先命中者整配置生效，不做字段级合并）。
+ */
+type SharedPromptsConfig = {
+  /**
+   * 订阅列表（按声明顺序；命名空间全表唯一）
+   */
+  readonly subscriptions: readonly SharedPromptsSubscription[];
+};
+/**
+ * rules 类别 → trae 的分发形态
+ *
+ * 只影响产物落位（IDE 兼容面），不影响真源组织（hub 库与 .lzi/rules/
+ * 的主题目录强制与平铺守卫不变，0011 第四轮裁定）。
+ */
+type RulesTraeDistribution = {
+  /**
+   * 平铺开关：true = `.trae/rules/` 产物平铺到目录根（仅文件名落位，
+   * 丢弃真源主题子目录层级）；false = 保留主题子目录。
+   * 缺省 **true**——Trae 对 rules 子目录的支持未证实，默认取 322 仓
+   * 历史证明的平铺布局（0011 第五轮裁定）。
+   */
+  readonly flatten?: boolean;
+};
+/**
+ * 类别分发形态配置（IDE 产物目录布局）
+ *
+ * v1 仅 rules → trae 一个旋钮（rules 域限定红线：claude/zcode 零分发）。
+ */
+type DistributionConfig = {
+  /**
+   * rules 类别分发形态
+   */
+  readonly rules?: {
+    /**
+     * trae（.trae/rules/）产物布局
+     */
+    readonly trae?: RulesTraeDistribution;
+  };
+};
+/**
+ * Agent Tools 配置
+ *
+ * 通过 shared-config 标准组合提供：专属文件 lzi-agent-tools.config.ts
+ * （default export 本类型，shared register 机器维护）优先于统一配置
+ * lzi.config.ts 的 agentTools 字段。
+ */
+type AgentToolsConfig = {
+  /**
+   * 目标 Agent 类型输入串
+   *
+   * 支持单值（claude）、多值（逗号分隔，如 claude,trae）或 auto（按真源推断）。
+   * 优先级低于环境变量 LZI_AGENT_TYPE，高于默认 auto。
+   */
+  readonly agentType?: string;
+  /**
+   * 占位符值
+   *
+   * 替换源 markdown 中的 {{KEY}}。机器特定绝对路径应写在此处。
+   */
+  readonly placeholders?: Record<string, string>;
+  /**
+   * 类别分发形态（IDE 产物目录布局；可人工编辑，register 再生时按当时解析值保留）
+   */
+  readonly distribution?: DistributionConfig;
+  /**
+   * 共享提示词订阅配置
+   *
+   * 订阅的增删走 shared register / shared unregister（写入专属配置文件）；
+   * 也可在统一配置中手工声明（专属文件存在时整配置以专属文件为准）。
+   */
+  readonly sharedPrompts?: SharedPromptsConfig;
+};
+//#endregion
+//#region src/constants.d.ts
+/**
+ * agent-tools 配置域常量（配置管理的单一真源）
+ */
+/**
+ * agent-tools 专属配置文件名
+ *
+ * shared-config 标准组合的项目侧落点：本文件（default export
+ * AgentToolsConfig）优先于统一配置 lzi.config.ts 的 agentTools 字段，
+ * 先命中者整配置生效（loadUnifiedConfig 的 standaloneFile 通道）。
+ * 由 shared register / shared unregister 以解析值整文件再生
+ * （agentType / placeholders 等字段按当时解析值保留）。
+ * 配置属于项目管理层——.lzi/ 是纯内容真源目录，不落任何配置文件。
+ */
+declare const STANDALONE_CONFIG_FILE: 'lzi-agent-tools.config.ts';
+/**
+ * 环境变量名称常量
+ *
+ * 前缀规矩（docs/issues/0010）：agent-tools 新增环境变量一律
+ * LZI_AGENT_TOOLS_ 前缀（域段 = 完整工具名，与包名、专属配置文件名
+ * 的域段一字不差）。存量 LZI_AGENT_TYPE / LZI_PLACEHOLDER_ 属例外，
+ * 未经裁定不迁移。
+ *
+ * 例外补记（0011 用户第四轮裁定）：hub 根目录变量由
+ * LZI_AGENT_TOOLS_SHARED_PROMPTS_ROOT 明确更名为 LZI_AGENT_PROMPTS_ROOT
+ * （去除 TOOLS/SHARED 词汇，域段与 hub 仓名对齐），属 0010 前缀规矩的
+ * 裁定例外，非新变量。
+ */
+declare const ENV_KEYS: {
+  /**
+   * 当前 Agent 类型（存量变量，早于 0010 前缀规矩）
+   */
+  readonly AGENT_TYPE: 'LZI_AGENT_TYPE';
+  /**
+   * 占位符环境变量前缀（存量变量，早于 0010 前缀规矩）
+   */
+  readonly PLACEHOLDER_PREFIX: 'LZI_PLACEHOLDER_';
+  /**
+   * 共享提示词中心仓根目录（机器本地真源；0011 第四轮裁定更名）
+   *
+   * hub 定位解析链的最高优先级：值承载于项目 .env（Bun 自动加载，
+   * 不进 git）——hub 位置是机器环境数据，配置文件零路径。
+   * shared register 定位成功后幂等固化到 .env；.env.example 由
+   * register 维护占位条目（进 git，不含机器数据）。
+   */
+  readonly PROMPTS_ROOT: 'LZI_AGENT_PROMPTS_ROOT';
+};
+//#endregion
+//#region src/define-config.config.d.ts
+/**
+ * 定义 agent-tools 专属配置的工厂函数
+ *
+ * 纯类型透传，运行时无副作用。项目在 lzi-agent-tools.config.ts 中
+ * 通过本函数默认导出配置（shared-config 标准组合的 standalone 通道，
+ * loadUnifiedConfig 读取 default export）。
+ *
+ * @example
+ *   ```typescript
+ *   import { defineConfig } from '@longzai-intelligence-agent-tools/config';
+ *
+ *   export default defineConfig({
+ *     sharedPrompts: {
+ *       subscriptions: [
+ *         {
+ *           name: 'longzai-intelligence-agent-prompts',
+ *           namespace: 'shared',
+ *           include: null,
+ *           exclude: null,
+ *         },
+ *       ],
+ *     },
+ *   });
+ *   ```;
+ *
+ * @param config - agent-tools 配置对象
+ * @returns 传入的配置对象（原样返回）
+ */
+declare function defineConfig(config: AgentToolsConfig): AgentToolsConfig;
+//#endregion
+//#region src/templates.d.ts
+/**
+ * 生成 agent-tools 专属配置文件内容（lzi-agent-tools.config.ts）
+ *
+ * undefined 字段整体省略（agentType / placeholders / sharedPrompts），
+ * placeholders 键排序保证确定性；订阅列表为空时省略 sharedPrompts。
+ *
+ * @param config - 配置状态模型（agentType / placeholders 按当时解析值保留）
+ * @returns 完整 TS 模块源码（含维护语义头与文件尾换行）
+ */
+declare const buildAgentToolsConfigFileContent: (config: AgentToolsConfig) => string;
+//#endregion
+export { type AgentToolsConfig, type DistributionConfig, ENV_KEYS, type RulesTraeDistribution, STANDALONE_CONFIG_FILE, type SharedPromptsCategory, type SharedPromptsConfig, type SharedPromptsSubscription, buildAgentToolsConfigFileContent, defineConfig };

package/dist/index.js

@@ -0,0 +1,17 @@
+const e=`lzi-agent-tools.config.ts`,t={AGENT_TYPE:`LZI_AGENT_TYPE`,PLACEHOLDER_PREFIX:`LZI_PLACEHOLDER_`,PROMPTS_ROOT:`LZI_AGENT_PROMPTS_ROOT`};function n(e){return e}const r=e=>`'${e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}'`,i=e=>`[${e.map(e=>r(e)).join(`, `)}]`,a=e=>{let t=e.agentType===void 0?``:`  agentType: ${r(e.agentType)},\n`,n=e.placeholders===void 0?``:`  placeholders: {\n${Object.keys(e.placeholders).sort().map(t=>`    ${r(t)}: ${r(e.placeholders?.[t]??``)},`).join(`
+`)}\n  },\n`,a=e.sharedPrompts===void 0||e.sharedPrompts.subscriptions.length===0?``:`  sharedPrompts: {\n    subscriptions: [\n${e.sharedPrompts.subscriptions.map(e=>`      {\n        name: ${r(e.name)},\n        category: ${r(e.category??`agents`)},\n        include: ${e.include===null?`null`:i(e.include)},\n        exclude: ${e.exclude===null?`null`:i(e.exclude)},\n      },`).join(`
+`)}\n    ],\n  },\n`;return`/**
+ * agent-tools 专属配置（shared-config 标准组合：本文件 > lzi.config.ts 的 agentTools 字段）
+ *
+ * 由 lzi-agent-cli 维护：shared register / shared unregister 以解析值整文件再生，
+ * 节内手工注释不保留（长篇说明请写入项目 docs）。agentType / placeholders /
+ * distribution 可手工编辑，再生时按当时解析值保留。订阅零路径：hub 位置是
+ * 机器本地环境数据，由项目 .env 的 LZI_AGENT_PROMPTS_ROOT 提供（register 定位后固化）。
+ */
+import type { AgentToolsConfig } from '@longzai-intelligence-agent-tools/config';
+
+const config: AgentToolsConfig = {
+${t}${n}${e.distribution?.rules?.trae===void 0?``:`  distribution: {\n    rules: {\n      trae: {\n        flatten: ${e.distribution.rules.trae.flatten===!0},\n      },\n    },\n  },\n`}${a}};
+
+export default config;
+`};export{t as ENV_KEYS,e as STANDALONE_CONFIG_FILE,a as buildAgentToolsConfigFileContent,n as defineConfig};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@longzai-intelligence-agent-tools/config",
+  "version": "0.0.13",
+  "private": false,
+  "license": "UNLICENSED",
+  "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": {}
+}