@cobuilding/repo-tools (英语)

Cobuilding repos 共享寄存器操作工具 .

技能

这种repo不再托管可安装的Codex技能.

work-with-pro 现在住在这里 review-gpt从公共回收中安装:

npx skills add https://github.com/cobuildwithus/review-gpt --skill work-with-pro

工具

• cobuild-open-exec-plan
• cobuild-close-exec-plan
• cobuild-doc-gardening
• cobuild-check-agent-docs-drift
• cobuild-committer
• cobuild-package-audit-context
• cobuild-sync-dependent-repos
• cobuild-switch-package-source
• cobuild-update-changelog
• cobuild-generate-release-notes
• cobuild-release-package

cobuild-close-exec-plan 替换所包 Status: 段落通过下一个段落 空白行,元数据字段,或标题,保留计划的其余部分. 消费者 包括墨菲需要公布的包装升级才能得到这个更正.

配置

cobuild-check-agent-docs-drift, (中文(简体) ), cobuild-doc-gardening, (中文(简体) ), cobuild-committer,以及 cobuild-package-audit-context 从环境变量读取配置,这样每个消耗回波都只能保存薄薄的包装.

支持的 vars :

• COBUILD_DRIFT_REQUIRED_FILES: 新建线- 受限的所需 doc 文物路径 .
• COBUILD_DRIFT_CODE_CHANGE_PATTERN: 代码/进程敏感文件的扩展正则ex.
• COBUILD_DRIFT_CODE_CHANGE_LABEL: 代码/doc耦合失败的信息前缀.
• COBUILD_DRIFT_LARGE_CHANGE_THRESHOLD: 文件计数阈值,需要活动计划.
• COBUILD_DRIFT_CHANGED_COUNT_EXCLUDE_PATTERN: 不包括大变动计数的文件的扩展正则x.
• COBUILD_DRIFT_ALLOW_RELEASE_ARTIFACTS_ONLY: 设置为 1 以允许只释放艺术行为,而不更新文件.
• COBUILD_DOC_GARDENING_EXTRA_TRACKED_PATHS: 外部新建线外限制的额外跟踪医生路径 agent-docs/**。 。 。 .
• COBUILD_COMMITTER_EXAMPLE: 验证失败时显示的常规委员会实例.
• COBUILD_COMMITTER_ALLOWED_TYPES: 可选逗号或新线限定的常规提交类型 cobuild-committer默认为 feat,fix,refactor,build,ci,chore,docs,style,perf,test,release。 。 。 .
• COBUILD_COMMITTER_DISALLOW_GLOBS:新线- 受限制的外壳花纹, 不可执行 .
• COBUILD_AUDIT_CONTEXT_PREFIX: 审计包的默认输出文件名前缀.
• COBUILD_AUDIT_CONTEXT_TITLE:合并后文本捆绑中使用的标题.
• COBUILD_AUDIT_CONTEXT_REPO_LABEL: 帮助文本中使用的repo标签.
• COBUILD_AUDIT_CONTEXT_SENSITIVE_NOTE: 附加到帮助文本中的可选附加句.
• COBUILD_AUDIT_CONTEXT_INCLUDE_TESTS_DEFAULT, (中文(简体) ), COBUILD_AUDIT_CONTEXT_INCLUDE_DOCS_DEFAULT, (中文(简体) ), COBUILD_AUDIT_CONTEXT_INCLUDE_CI_DEFAULT: 默认包括切换( n)0 或者说 1) (中文(简体) ).
• COBUILD_AUDIT_CONTEXT_ALWAYS_PATHS: 新行限制总是包含文件路径 .
• COBUILD_AUDIT_CONTEXT_SCAN_SPECS, (中文(简体) ), COBUILD_AUDIT_CONTEXT_TEST_SCAN_SPECS, (中文(简体) ), COBUILD_AUDIT_CONTEXT_DOC_SCAN_SPECS, (中文(简体) ), COBUILD_AUDIT_CONTEXT_CI_SCAN_SPECS: 新建线下扫描光谱 dir 或者说 dir:glob 形式.
• COBUILD_AUDIT_CONTEXT_PRUNE_DIR_NAMES: 新行- 已限定目录名称被排除在基于扫描的选择之外, 并过滤被屏蔽的本地- residued checks .
• COBUILD_AUDIT_CONTEXT_EXCLUDE_GLOBS:新线-受限外壳被从清单中排除.
• COBUILD_AUDIT_CONTEXT_EXCLUDE_SENSITIVE: 设置为 1 从清单中去掉常见的秘密/存档路径.
• COBUILD_AUDIT_CONTEXT_VALIDATE_SOLIDITY_IMPORT_CLOSURE: 设置为 1 要求固态进口在货单内保持封闭.
• COBUILD_RELEASE_PACKAGE_NAME: 共享释放流的预期包名.
• COBUILD_RELEASE_REPOSITORY_URL: 共享发布流的可选预期寄存器 URL.
• COBUILD_RELEASE_CHECK_CMD: 可选放行检查命令; 默认为 npm run release:check。 。 。 .
• COBUILD_RELEASE_COMMIT_CMD: 可选输入帮助路径; 默认为 scripts/committer。 。 。 .
• COBUILD_RELEASE_COMMIT_TEMPLATE: 可选 printf 模板; 默认为 chore(release): v%s。 。 。 .
• COBUILD_RELEASE_TAG_MESSAGE_TEMPLATE: 可选标记注释模板; 默认为 v%s。 。 。 .
• COBUILD_RELEASE_NOTES_ENABLED: 设置为 1 生成释放注释.
• COBUILD_RELEASE_NOTES_DIR: 可选发布注释输出目录;默认为 release-notes。 。 。 .
• COBUILD_RELEASE_POST_PUSH_CMD:可选 shell 命令在被推出后运行.
• COBUILD_RELEASE_POST_PUSH_SKIP_ENV:可选的env var名称;如果env var是 1跳过后推钩.

释放

• pnpm run release:check
• pnpm run release:patch
• pnpm run release:minor
• pnpm run release:major
• pnpm run sync:repos -- --version <semver>

共享释放流量用途 pnpm 用于版本和发布检查,所以PNPM管理的重置重置程序保存 pnpm-lock.yaml 权威而非再创建 package-lock.json。 。 。 .

消费者最新政策

@cobuild/repo-tools 拟作为出版的包件从 node_modules而不是作为兄弟的退房.

• 目前直接工作场所的消费者: v1-core, (中文(简体) ), wire, (中文(简体) ), interface, (中文(简体) ), chat-api, (中文(简体) ), cli, (中文(简体) ), indexer, (中文(简体) ), healthybob,以及 review-gpt。 。 。 .
• 消费者包装脚本首先从已安装的 dev 依赖中解析 repo-tool bins, 所以一个兄弟 repo-tools 正常回波操作不需要克隆.
• 在一份公布的版本中修改了共享的bins,放出包装符,或配置插件合同后,故意地撞倒了受影响的同父异母兄弟重置,而不是假设代理商会推断推出.

典型的消费者突起指令 :

pnpm up @cobuild/repo-tools@<version>

现在的重播有相同的一个命令发布和弹出形状:

• scripts/release.sh 可以打电话 scripts/sync-dependent-repos.sh 在推后和npm发布能见度后.
• 跳过下游自动起伏 --no-sync-upstreams 或者说 REPO_TOOLS_SKIP_UPSTREAM_SYNC=1。 。 。 .
• 手动运行相同的流程 pnpm run sync:repos -- --version <semver> --wait-for-publish。 。 。 .

实例

切换依赖到已发布的发布 :

pnpm exec cobuild-switch-package-source --package @cobuild/wire --field dependencies --published

切换依赖到本地链接 :

pnpm exec cobuild-switch-package-source --package @cobuild/wire --field dependencies --local ../wire

使用 repo- local 配置构建仅文本的审计捆绑 :

source scripts/repo-tools.config.sh
pnpm exec cobuild-package-audit-context --txt

仅通过先传递信件来提交明确命名的文件, 然后是每个精确路径 :

pnpm exec cobuild-committer "fix(tooling): keep generated output in sync" src/tool.mjs generated/tool.json

罪犯拒绝主动合并, 樱桃点心, 回归, 重建, git am,和测序器操作。 Hooks可能更新被命名的文件,但是它们可能不会去除一个最初选定的修改或者设置一个附加路径;列表中明确生成的输出. 在调和临时索引承诺时,保留现有的有舞台的快照.

cobuild-package-audit-context 现在阶段捆绑从 git- 可见文件, 在匹配 TypeScript 源代码兄弟姐妹时, 推倒未跟踪的 JS/声明侧车, 过滤常见的本地审查- 漏取残留物, 例如 .env, (中文(简体) ), .next, (中文(简体) ), .test-dist, (中文(简体) ), dist,以及 *.tsbuildinfo 从清单上看,没有实施广泛的针对具体建筑的禁止.