@ibotor/smart-trellis 0.5.22 → 0.5.24

package/README.md

@@ -1,113 +1,208 @@
 # Smart Trellis
 
-`smart-trellis` 是基于 Trellis 原始能力扩展出来的智能初始化入口。
+`smart-trellis` 是 Trellis 的智能初始化与联调增强包。它保留原 Trellis 的完整项目结构，同时把常见初始化选项收束成更少、更明确的配置入口。
 
-它不会替换 `trellis init` 的核心逻辑，而是在执行前自动推断项目配置，并把原本需要反复确认的大量问题转换为默认行为。你通常只需要确认要配置哪些 AI 工具，例如 Codex、Cursor、Claude Code 等。
+这个 npm 包提供三个命令：
 
-## 新增命令
+```text
+smart-trellis  # 智能初始化入口
+trellis        # 原 Trellis CLI
+tl             # trellis 的短别名
+```
+
+当前 npm latest：`0.5.23`。
+
+## 安装
+
+```bash
+npm install -g @ibotor/smart-trellis@latest
+```
+
+安装后，在项目根目录执行：
 
 ```bash
 smart-trellis init
 ```
 
-这个命令等价于一个更省心的 `trellis init`：
+如果希望临时使用，也可以不全局安装：
 
-- 自动调用原始 Trellis 初始化流程。
-- 自动开启非交互初始化，跳过 monorepo 和 spec source 的大量选择。
-- 自动检测 monorepo 项目结构。
-- 自动检测开发者名称，优先使用 `--user`，其次使用 `git config user.name`，最后使用系统用户名。
-- 默认工具为 `codex,cursor`。
-- 如果没有传 `--tools`、没有传具体工具参数、也没有传 `--yes`，只会弹出一次工具选择。
+```bash
+npx -p @ibotor/smart-trellis smart-trellis init
+```
 
-## 和 `trellis init` 的区别
+## smart-trellis 迭代功能
 
-| 命令 | 适合场景 | 交互量 |
-| --- | --- | --- |
-| `trellis init` | 需要完整手动控制 Trellis 初始化选项 | 会询问 monorepo、每个包的 spec source、工具等 |
-| `smart-trellis init` | 希望快速初始化一个项目，并保留 Trellis 原完整结构 | 通常只确认工具，或完全无交互 |
+### 1. `smart-trellis init`
+
+`smart-trellis init` 用来简化 Trellis 初始化配置。它会调用原始 `trellis init`，但提前帮你处理常见默认值，让新项目更快进入可用状态。
 
-`smart-trellis init` 仍然会生成 Trellis 的完整结构，包括 `.trellis/`、`.agents/skills/`、平台配置目录和 `AGENTS.md`。
+核心能力：
 
-## 新设备安装
+| 能力 | 说明 | 常用参数 |
+| --- | --- | --- |
+| 简化 Trellis 初始化配置 | 默认启用非交互初始化，自动检测 monorepo、开发者名称和常用 AI 工具 | `--yes`、`--tools`、`--user` |
+| 配置触发方式 | 支持用户主动触发，或让 Trellis 在开发请求中自动判断是否进入任务流程 | `--trellis-activation explicit`、`--trellis-activation auto` |
+| 配置 `.gitignore` | 初始化时可选择是否把 `.trellis/` 和 AI 工具生成目录加入 `.gitignore` | `--gitignore-config`、`--no-gitignore-config` |
 
-新设备只需要安装一次 npm 包：
+推荐的新项目初始化方式：
 
 ```bash
-npm install -g @ibotor/smart-trellis
+smart-trellis init \
+  --tools codex,cursor \
+  --user <developer-name> \
+  --trellis-activation explicit \
+  --gitignore-config
 ```
 
-安装后，在任意新项目根目录执行：
+如果希望完全使用默认配置：
 
 ```bash
-smart-trellis init
+smart-trellis init --yes
 ```
 
-如果你暂时不想全局安装，也可以用 npm exec：
+`--yes` 会使用默认工具 `codex,cursor`，并把 `.trellis/`、`.codex/`、`.cursor/`、`.agents/skills/` 等生成目录写入 `.gitignore`。
+
+#### 初始化时会生成什么
+
+根据选择的工具不同，生成内容会略有差异。常见输出包括：
+
+| 路径 | 作用 |
+| --- | --- |
+| `.trellis/` | Trellis workflow、spec、tasks、workspace、脚本等核心目录 |
+| `.agents/skills/` | 跨工具复用的 Trellis skills |
+| `.codex/` | Codex 专用配置、agents、hooks、skills |
+| `.cursor/` | Cursor 专用 commands、skills、agents、hooks |
+| `.github/` | GitHub Copilot prompts、agents、hooks 等 |
+| `AGENTS.md` | 项目级 AI 助手协作说明 |
+
+#### 触发方式配置
+
+`smart-trellis init` 支持配置 Trellis 的 activation mode：
+
+| 模式 | 行为 | 适合场景 |
+| --- | --- | --- |
+| `explicit` | 用户明确说 `/trellis start`、`$trellis-start`、`走 Trellis` 等才启动任务流程 | 希望普通问答和小改动不被 Trellis 接管 |
+| `auto` | Trellis 根据当前开发请求自动判断是否进入任务流程 | 希望 AI 主动进入 Trellis 工作流 |
+
+示例：
 
 ```bash
-npm exec --package @ibotor/smart-trellis -- smart-trellis init
+smart-trellis init --tools codex,cursor --trellis-activation explicit
 ```
 
-也可以在 CI 或临时环境里使用 `npx`：
+旧项目可以先更新模板，再在 `.trellis/config.yaml` 里设置：
 
 ```bash
-npx -p @ibotor/smart-trellis smart-trellis init
+trellis update
+```
+
+```yaml
+trellis:
+  activation_mode: explicit
 ```
 
-## 基础用法
+#### `.gitignore` 配置
 
-进入项目根目录后执行：
+初始化时可以选择是否把生成目录加入项目 `.gitignore`。以 `codex,cursor` 为例，候选项通常是：
+
+```text
+.trellis/
+.codex/
+.agents/skills/
+.cursor/
+```
+
+规则：
+
+- 交互模式下会显示多选项，默认全选。
+- 没有 `.gitignore` 时会创建。
+- 已有 `.codex` 或 `.codex/` 时不会重复添加 `.codex/`。
+- 已有 `.agents/` 时，不会再重复添加 `.agents/skills/`。
+- 候选目录来自 Trellis 的 AI 工具注册表，不手写平台清单。
+
+脚本模式下直接全选：
 
 ```bash
-smart-trellis init
+smart-trellis init --tools codex,cursor --gitignore-config
 ```
 
-如果你希望完全不出现交互，并使用默认工具 `codex,cursor`：
+完全不修改 `.gitignore`：
 
 ```bash
-smart-trellis init --yes
+smart-trellis init --tools codex,cursor --no-gitignore-config
 ```
 
-不加 `--yes` 时，初始化过程会提示你选择 AI 工具，并选择 Trellis activation mode：
+注意：如果把 `.trellis/` 加入 `.gitignore`，Trellis 的 spec、tasks、workspace 等状态默认不会被 Git 跟踪。适合把 Trellis 配置当本地工作区的团队；如果团队希望提交 `.trellis/spec/` 或任务记录，请在多选时取消 `.trellis/`。
 
-- `auto`：默认行为，Trellis 可以为开发/重构需求自动启动任务流程。
-- `explicit`：Trellis 只在你明确使用 `/trellis start` / `$trellis-start` / “走 Trellis” 时启动。
+### 2. 前后端联调
 
-如果你希望直接指定工具：
+前后端联调用来让 AI 根据 Apifox 接口链接读取接口详情，并和当前项目里的 API 封装、请求参数、响应字段、代理配置进行对照。
 
-```bash
-smart-trellis init --tools codex,cursor
+当前真实入口名是 `trellis-joint-debugger`：
+
+```text
+Cursor: /trellis-joint-debugger
+Codex / .agents/skills: $trellis-joint-debugger
+```
+
+使用场景：
+
+- 前端已经有页面或 API wrapper，但接口参数对不上。
+- 后端接口文档在 Apifox，想让 AI 自动读取 method、path、query、body、response。
+- 只想提供 Apifox 链接，让 AI 帮你定位本地代码里该改哪里。
+
+支持的 Apifox 链接格式：
+
+```text
+app.apifox.com/link/project/{projectId}/apis/api-{apiId}
+app.apifox.com/project/{projectId}/apis/api-{apiId}
 ```
 
-如果你希望指定开发者名称：
+第一次使用前，可以保存 Apifox token：
 
 ```bash
-smart-trellis init --tools codex,cursor --user adong
+python3 ./.trellis/scripts/apifox_token.py save
 ```
 
-如果你希望 Trellis 不主动接管普通开发需求，而是必须显式使用 `/trellis start` / `$trellis-start` / “走 Trellis” 才启动：
+也可以检查当前是否已配置：
 
 ```bash
-smart-trellis init --tools codex,cursor --trellis-activation explicit
+python3 ./.trellis/scripts/apifox_token.py check
 ```
 
-上面的命令大致等价于：
+token 读取优先级：
+
+1. `APIFOX_ACCESS_TOKEN` 环境变量
+2. `~/.trellis/apifox.env`
+3. 旧项目内 `.trellis/.runtime/apifox.env`
+
+联调流程会做什么：
+
+1. 从 Apifox 链接解析 `projectId` 和 `apiId`。
+2. 请求 Apifox Web API 读取接口详情。
+3. 提取 method、path、query/path/header/body、responses。
+4. 展开请求体或响应体里的 schema 引用。
+5. 搜索当前项目里的 API 封装、请求客户端、代理配置和环境配置。
+6. 对比 Apifox 字段和本地代码字段。
+7. 如需真实请求业务后端，会根据项目代理和环境配置执行；如果返回 `401` 或缺少登录态，会明确报告。
+
+旧项目先运行：
 
 ```bash
-trellis init --yes --codex --cursor --user adong
+trellis update
 ```
 
-## 工具选择
+## 常用参数
 
-支持两种写法。
+### 指定工具
 
-第一种，使用 `--tools` 传逗号分隔的工具名：
+逗号形式：
 
 ```bash
 smart-trellis init --tools codex,cursor,claude
 ```
 
-第二种，使用独立工具参数：
+独立参数形式：
 
 ```bash
 smart-trellis init --codex --cursor --claude
@@ -132,21 +227,25 @@ droid
 pi
 ```
 
-## Registry 用法
+### 指定开发者名称
 
-`smart-trellis init` 兼容原 `trellis init --registry` 能力，可以从自定义 GitHub、GitLab、Bitbucket 仓库拉取 spec。
+```bash
+smart-trellis init --tools codex,cursor --user adong
+```
 
-### 直接下载 spec 目录
+如果不传 `--user`，会优先读取 `git config user.name`，再回退到系统用户名。
 
-仓库目录会被下载到当前项目的 `.trellis/spec/`：
+### Registry 和模板
+
+`smart-trellis init` 兼容原 `trellis init --registry` 能力，可以从自定义 GitHub、GitLab、Bitbucket 仓库拉取 spec。
 
 ```bash
-smart-trellis init --tools codex,cursor --registry gh:myorg/myrepo/my-team-spec
+smart-trellis init \
+  --tools codex,cursor \
+  --registry gh:myorg/myrepo/my-team-spec
 ```
 
-### Marketplace 模式指定模板
-
-如果 registry 目录里有 `index.json`，并且里面定义了多个模板，非交互模式下必须指定 `--template`：
+Marketplace 模式：
 
 ```bash
 smart-trellis init \
@@ -155,9 +254,7 @@ smart-trellis init \
   --template my-template
 ```
 
-如果不指定 `--template`，Trellis 无法在非交互模式下自动判断要使用哪个模板。
-
-### 指定分支
+指定分支：
 
 ```bash
 smart-trellis init \
@@ -165,122 +262,66 @@ smart-trellis init \
   --registry gh:myorg/myrepo/specs#develop
 ```
 
-### GitLab 和 Bitbucket
+GitLab 和 Bitbucket：
 
 ```bash
 smart-trellis init --tools codex,cursor --registry gitlab:myorg/myrepo/specs
 smart-trellis init --tools codex,cursor --registry bitbucket:myorg/myrepo/specs
 ```
 
-## 文件覆盖策略
-
-`smart-trellis init` 默认会以安全方式写入文件。因为它内部会启用非交互模式，所以遇到已经存在的文件时默认跳过，避免覆盖已有配置。
-
-如果你要强制覆盖已有文件：
-
-```bash
-smart-trellis init --tools codex,cursor --force
-```
-
-如果你希望明确跳过已有文件：
-
-```bash
-smart-trellis init --tools codex,cursor --skip-existing
-```
-
-使用远程模板时，也可以控制 spec 目录写入方式：
+远程模板写入策略：
 
 ```bash
 smart-trellis init --tools codex,cursor --registry gh:myorg/myrepo/specs --overwrite
 smart-trellis init --tools codex,cursor --registry gh:myorg/myrepo/specs --append
 ```
 
-## Monorepo 控制
-
-默认情况下，`smart-trellis init` 会让 Trellis 自动检测当前项目是否为 monorepo。
+### 文件覆盖和 Monorepo
 
-强制启用 monorepo：
+默认写入策略偏安全：遇到已有文件会跳过，避免覆盖本地配置。
 
 ```bash
-smart-trellis init --tools codex,cursor --monorepo
+smart-trellis init --tools codex,cursor --force
+smart-trellis init --tools codex,cursor --skip-existing
 ```
 
-跳过 monorepo 检测：
+Monorepo 默认自动检测。也可以手动指定：
 
 ```bash
+smart-trellis init --tools codex,cursor --monorepo
 smart-trellis init --tools codex,cursor --no-monorepo
 ```
 
-## 初始化后会生成什么
-
-根据选择的工具不同，生成内容会略有差异。常见输出包括：
-
-- `.trellis/`：Trellis workflow、spec、tasks、workspace 等核心目录。
-- `.agents/skills/`：跨工具复用的 Trellis skills。
-- `.codex/`：Codex 专用配置、skills、agents、hooks。
-- `.cursor/`：Cursor 专用配置、commands、skills、agents、hooks。
-- `AGENTS.md`：项目级 AI 助手协作说明。
-
-所以，`smart-trellis init` 的目标不是只生成一个轻量配置，而是用更少确认步骤生成原 Trellis 初始化应有的完整结果。
-
-## Apifox 前后端联调入口
-
-初始化 Cursor / Codex 等平台后，会生成 `trellis-joint-debugger` 入口，用于根据 Apifox 接口链接自动解析接口详情并辅助前后端联调。
+## 更新已有项目
 
-常见触发方式：
+已初始化项目通常只需要：
 
-- Cursor：`/trellis-joint-debugger`
-- Codex / `.agents/skills`：`$trellis-joint-debugger`
-
-当用户提供以下 Apifox 链接，并提到“联调”“接口”“参数”“详情”“完成它”等开发意图时，入口会优先走 Apifox Web API，而不是默认打开浏览器页面：
-
-```text
-app.apifox.com/link/project/{projectId}/apis/api-{apiId}
-app.apifox.com/project/{projectId}/apis/api-{apiId}
+```bash
+npm install -g @ibotor/smart-trellis@latest
+trellis update
 ```
 
-第一次使用前，需要配置 Apifox access token：
+如果要使用 Apifox 联调能力，再配置一次用户级 token：
 
 ```bash
-python3 ./.trellis/scripts/apifox_token.py check
 python3 ./.trellis/scripts/apifox_token.py save
 ```
 
-`save` 会使用隐藏输入，并把 token 保存到用户级配置：
-
-```text
-~/.trellis/apifox.env
-```
-
-因此同一台机器上只需要配置一次，后续所有 Trellis 项目都可以复用。运行时读取优先级为：
-
-1. `APIFOX_ACCESS_TOKEN` 环境变量
-2. `~/.trellis/apifox.env`
-3. 旧项目内 `.trellis/.runtime/apifox.env`（仅兼容读取）
-
-token 只用于请求 header，不会被命令打印。接口详情会通过：
-
-```text
-GET https://api.apifox.com/api/v1/projects/{projectId}/http-apis/{apiId}
-```
-
-如请求体或响应中出现 `$ref: #/definitions/{schemaId}`，会继续根据接口详情里的 `moduleId` 请求 data-schemas 并解析入参/出参字段。随后 Trellis 会将 method、path、入参、出参与当前项目中的 API 封装核对；如果要联调真实后端，再根据项目代理和环境配置请求业务后端。若缺少业务登录态，应明确报告 `401` / 未登录，不猜测数据。
-
 ## 本地开发验证
 
-在本仓库开发时，可以先构建 CLI：
+在本仓库开发时，先构建 CLI：
 
 ```bash
 pnpm --filter @ibotor/smart-trellis build
 ```
 
-然后直接用本地 bin 测试：
+直接用本地 bin 测试：
 
 ```bash
 node packages/cli/bin/smart-trellis.js init --tools codex,cursor --user adong
 ```
 
-也可以在一个临时项目里验证：
+也可以在临时项目里验证：
 
 ```bash
 mkdir /tmp/smart-trellis-demo
@@ -289,29 +330,11 @@ echo '{"name":"smart-trellis-demo"}' > package.json
 node /path/to/smart-trellis/packages/cli/bin/smart-trellis.js init --tools codex,cursor --user adong
 ```
 
-## 推荐团队用法
-
-团队成员在新项目里只需要执行：
-
-```bash
-smart-trellis init --tools codex,cursor --user <developer-name>
-```
-
-如果你维护了团队统一 spec registry，则推荐：
-
-```bash
-smart-trellis init \
-  --tools codex,cursor \
-  --user <developer-name> \
-  --registry gh:<org>/<repo>/<spec-path>
-```
-
-如果 registry 是 marketplace：
+发布前建议至少运行：
 
 ```bash
-smart-trellis init \
-  --tools codex,cursor \
-  --user <developer-name> \
-  --registry gh:<org>/<repo>/<marketplace-path> \
-  --template <template-id>
+pnpm --filter @ibotor/smart-trellis test
+pnpm --filter @ibotor/smart-trellis build
+pnpm --filter @ibotor/smart-trellis lint
+pnpm --filter @ibotor/smart-trellis typecheck
 ```

package/dist/cli/smart.js

@@ -22,7 +22,9 @@ const initCommand = program
     .option("--overwrite", "Overwrite existing spec directory when using template")
     .option("--append", "Only add missing files when using template")
     .option("-r, --registry <source>", "Use a custom template registry (e.g., gh:myorg/myrepo/specs)")
-    .option("--trellis-activation <mode>", "Set no-task Trellis activation mode: auto or explicit");
+    .option("--trellis-activation <mode>", "Set no-task Trellis activation mode: auto or explicit")
+    .option("--gitignore-config", "Add generated config directories to .gitignore without prompting")
+    .option("--no-gitignore-config", "Do not add generated config directories to .gitignore");
 for (const tool of getInitToolChoices()) {
     initCommand.option(`--${tool.key}`, `Include ${tool.name}`);
 }

package/dist/cli/smart.js.map

@@ -1 +1 @@
-{"version":3,"file":"smart.js","sourceRoot":"","sources":["../../src/cli/smart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAyB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAC;AAElE,MAAM,WAAW,GAAG,OAAO;KACxB,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;KACxE,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC;KAClE,MAAM,CACL,mBAAmB,EACnB,mDAAmD,CACpD;KACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KACnE,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC;KAC3C,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;KAClD,MAAM,CACL,uBAAuB,EACvB,uDAAuD,CACxD;KACA,MAAM,CACL,aAAa,EACb,uDAAuD,CACxD;KACA,MAAM,CAAC,UAAU,EAAE,4CAA4C,CAAC;KAChE,MAAM,CACL,yBAAyB,EACzB,8DAA8D,CAC/D;KACA,MAAM,CACL,6BAA6B,EAC7B,uDAAuD,CACxD,CAAC;AAEJ,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,EAAE,CAAC;IACxC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"smart.js","sourceRoot":"","sources":["../../src/cli/smart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAyB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAC;AAElE,MAAM,WAAW,GAAG,OAAO;KACxB,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;KACxE,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC;KAClE,MAAM,CACL,mBAAmB,EACnB,mDAAmD,CACpD;KACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KACnE,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC;KAC3C,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;KAClD,MAAM,CACL,uBAAuB,EACvB,uDAAuD,CACxD;KACA,MAAM,CACL,aAAa,EACb,uDAAuD,CACxD;KACA,MAAM,CAAC,UAAU,EAAE,4CAA4C,CAAC;KAChE,MAAM,CACL,yBAAyB,EACzB,8DAA8D,CAC/D;KACA,MAAM,CACL,6BAA6B,EAC7B,uDAAuD,CACxD;KACA,MAAM,CACL,oBAAoB,EACpB,kEAAkE,CACnE;KACA,MAAM,CACL,uBAAuB,EACvB,uDAAuD,CACxD,CAAC;AAEJ,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,EAAE,CAAC;IACxC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/smart-init.d.ts

@@ -1,10 +1,11 @@
 import { type InitOptions } from "./init.js";
-import type { CliFlag } from "../types/ai-tools.js";
+import { type CliFlag } from "../types/ai-tools.js";
 type SmartToolFlagOptions = Partial<Record<CliFlag, boolean>>;
 export type TrellisActivationMode = "auto" | "explicit";
 export type SmartInitOptions = SmartToolFlagOptions & {
     append?: boolean;
     force?: boolean;
+    gitignoreConfig?: boolean;
     monorepo?: boolean;
     overwrite?: boolean;
     registry?: string;
@@ -19,6 +20,8 @@ export declare const SMART_DEFAULT_TOOLS: CliFlag[];
 export declare function parseSmartToolsOption(value: string): CliFlag[];
 export declare function parseSmartTrellisActivationMode(value: string | undefined): TrellisActivationMode | undefined;
 export declare function patchTrellisActivationConfig(content: string, mode: TrellisActivationMode): string;
+export declare function getSmartGitignoreCandidates(tools: CliFlag[]): string[];
+export declare function patchGitignoreConfigDirs(content: string, entries: string[]): string;
 export declare function createSmartInitOptions(options: SmartInitOptions, tools: CliFlag[], detectedUser?: string): InitOptions;
 export declare function detectDeveloperName(cwd?: string): string | undefined;
 export declare function smartInit(options: SmartInitOptions): Promise<void>;

package/dist/commands/smart-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-init.d.ts","sourceRoot":"","sources":["../../src/commands/smart-init.ts"],"names":[],"mappings":"AAMA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,KAAK,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAAO,EAAwB,CAAC;AAgBlE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAkB9D;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,qBAAqB,GAAG,SAAS,CAWnC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAwCR;AAmDD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CA6Bb;AAED,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAsB,GAC1B,MAAM,GAAG,SAAS,CAoBpB;AAuED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxE"}
+{"version":3,"file":"smart-init.d.ts","sourceRoot":"","sources":["../../src/commands/smart-init.ts"],"names":[],"mappings":"AASA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAErE,KAAK,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAAO,EAAwB,CAAC;AAiBlE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAkB9D;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,qBAAqB,GAAG,SAAS,CAWnC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAwCR;AA2CD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAUtE;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAmBR;AAiED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CA6Bb;AAED,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAsB,GAC1B,MAAM,GAAG,SAAS,CAoBpB;AAmGD,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBxE"}

package/dist/commands/smart-init.js

@@ -3,9 +3,11 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import inquirer from "inquirer";
-import { getInitToolChoices } from "../configurators/index.js";
+import { getInitToolChoices, resolveCliFlag, } from "../configurators/index.js";
 import { init } from "./init.js";
+import { getManagedPaths } from "../types/ai-tools.js";
 export const SMART_DEFAULT_TOOLS = ["codex", "cursor"];
+const TRELLIS_GITIGNORE_ENTRY = ".trellis/";
 function supportedToolFlags() {
     return getInitToolChoices().map((tool) => tool.key);
 }
@@ -71,6 +73,75 @@ export function patchTrellisActivationConfig(content, mode) {
     const separator = content.endsWith("\n") ? "\n" : "\n\n";
     return `${content}${separator}trellis:\n  activation_mode: ${mode}\n`;
 }
+function normalizeGitignoreDirEntry(value) {
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith("!")) {
+        return undefined;
+    }
+    const normalized = trimmed
+        .replace(/\\/g, "/")
+        .replace(/^\/+/, "")
+        .replace(/\/+$/g, "");
+    if (!normalized) {
+        return undefined;
+    }
+    return `${normalized}/`;
+}
+function uniqueDirEntries(entries) {
+    const seen = new Set();
+    const unique = [];
+    for (const entry of entries) {
+        const normalized = normalizeGitignoreDirEntry(entry);
+        if (!normalized || seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        unique.push(normalized);
+    }
+    return unique;
+}
+function gitignoreEntryCoversCandidate(gitignoreEntry, candidate) {
+    const normalized = normalizeGitignoreDirEntry(gitignoreEntry);
+    return (normalized === candidate ||
+        Boolean(normalized && candidate.startsWith(normalized)));
+}
+export function getSmartGitignoreCandidates(tools) {
+    const entries = [TRELLIS_GITIGNORE_ENTRY];
+    for (const tool of tools) {
+        const platformId = resolveCliFlag(tool);
+        if (!platformId) {
+            throw new Error(`Unknown tool "${tool}".`);
+        }
+        entries.push(...getManagedPaths(platformId));
+    }
+    return uniqueDirEntries(entries);
+}
+export function patchGitignoreConfigDirs(content, entries) {
+    const candidates = uniqueDirEntries(entries);
+    if (candidates.length === 0) {
+        return content;
+    }
+    const existingLines = content.split(/\r?\n/);
+    const missing = candidates.filter((candidate) => !existingLines.some((line) => gitignoreEntryCoversCandidate(line, candidate)));
+    if (missing.length === 0) {
+        return content;
+    }
+    const prefix = content && !content.endsWith("\n") ? `${content}\n` : content;
+    return `${prefix}${missing.join("\n")}\n`;
+}
+function applyGitignoreConfigDirs(cwd, entries) {
+    if (entries.length === 0) {
+        return;
+    }
+    const gitignorePath = path.join(cwd, ".gitignore");
+    const content = fs.existsSync(gitignorePath)
+        ? fs.readFileSync(gitignorePath, "utf-8")
+        : "";
+    const patched = patchGitignoreConfigDirs(content, entries);
+    if (patched !== content) {
+        fs.writeFileSync(gitignorePath, patched, "utf-8");
+    }
+}
 function applyTrellisActivationConfig(cwd, mode) {
     if (!mode) {
         return;
@@ -169,6 +240,28 @@ async function resolveSmartTools(options) {
     ]);
     return answers.tools;
 }
+async function resolveSmartGitignoreConfigDirs(options, tools) {
+    const candidates = getSmartGitignoreCandidates(tools);
+    if (options.gitignoreConfig === false || candidates.length === 0) {
+        return [];
+    }
+    if (options.gitignoreConfig === true || options.yes) {
+        return candidates;
+    }
+    const answers = await inquirer.prompt([
+        {
+            type: "checkbox",
+            name: "gitignoreConfigDirs",
+            message: "Select generated config directories to add to .gitignore:",
+            choices: candidates.map((entry) => ({
+                checked: true,
+                name: entry,
+                value: entry,
+            })),
+        },
+    ]);
+    return answers.gitignoreConfigDirs ?? [];
+}
 async function resolveSmartTrellisActivation(options) {
     const parsed = parseSmartTrellisActivationMode(options.trellisActivation);
     const hasExplicitTools = !!options.tools ||
@@ -198,9 +291,11 @@ async function resolveSmartTrellisActivation(options) {
 }
 export async function smartInit(options) {
     const tools = await resolveSmartTools(options);
+    const gitignoreConfigDirs = await resolveSmartGitignoreConfigDirs(options, tools);
     const activationMode = await resolveSmartTrellisActivation(options);
     const initOptions = createSmartInitOptions(options, tools, detectDeveloperName());
     await init(initOptions);
     applyTrellisActivationConfig(process.cwd(), activationMode);
+    applyGitignoreConfigDirs(process.cwd(), gitignoreConfigDirs);
 }
 //# sourceMappingURL=smart-init.js.map