Skip to content

Document keeping the bundled CLI out of git - #111

Merged
jimutt merged 1 commit into
mainfrom
claude/ignore-bundle
Nov 3, 2026
Merged

jimutt merged 1 commit into
mainfrom
claude/ignore-bundle

Conversation

@jimutt

@jimutt jimutt commented Nov 3, 2026

Copy link
Copy Markdown
Owner

Docs only (empty changeset). This adds "Keeping the bundled CLI out of git" to docs/install.md, under npx dld-kit init, with a link from the FAQ's "What does it add to my repository?".

It describes two options:

  • Commit it but hide its diff. Add **/dld-common/scripts/dld.mjs linguist-generated=true -diff to .gitattributes. GitHub collapses the file in PRs, and teammates still need nothing installed.
  • Don't commit it. Add **/dld-common/scripts/dld.mjs to .gitignore, and restore the file in each checkout and CI job with npx dld-kit@<installed version> update. In JS projects, an exact dld-kit dev dependency plus "prepare": "dld update" does this on npm install / npm ci.

I tested both in a scratch repo with init --agent claude,codex:

  • .gitignore: a fresh clone has no dld.mjs. dld update then writes only that file in each skills directory (1 written, 0 removed, 12 unchanged) and leaves the working tree clean.
  • prepare: with dld-kit as an exact dev dependency, a plain npm install runs dld update and restores both copies.
  • .gitattributes: git check-attr reports linguist-generated: true and diff: unset for .claude/skills/dld-common/scripts/dld.mjs.

Biome passes.


Generated by Claude Code

Two ways, in docs/install.md: commit dld.mjs with its diff hidden through
.gitattributes, or ignore it and restore it per checkout with a pinned
`dld update`, which a `prepare` script can run on `npm install`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GmUuswDi3BJNN76DyoJHCG
@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Unit test coverage

Lines Functions
Total 99.77% 98.78% (+0.01)

Changes are relative to main.
The floor is 90% of lines and functions in each file; ⚠️ marks files below it.

Per file
File Lines Functions
scripts/release.ts (new) 100.00% 100.00%
src/cli/command.ts 96.88% 100.00%
src/cli/commands/base-option.ts 100.00% 100.00%
src/cli/commands/check-decision-edits.ts 100.00% 100.00%
src/cli/commands/collect-active-decisions.ts 100.00% 100.00%
src/cli/commands/commit-reindex.ts 100.00% 100.00%
src/cli/commands/create-config.ts 100.00% 100.00%
src/cli/commands/create-decision.ts 100.00% 100.00%
src/cli/commands/create-directories.ts 100.00% 100.00%
src/cli/commands/create-empty-index.ts 100.00% 100.00%
src/cli/commands/detect-snapshot-changes.ts 100.00% 100.00%
src/cli/commands/find-annotations.ts 100.00% 100.00%
src/cli/commands/find-collisions.ts 100.00% 100.00%
src/cli/commands/find-missing-amends.ts 100.00% 100.00%
src/cli/commands/find-stale-mentions.ts 100.00% 100.00%
src/cli/commands/init.ts 100.00% 100.00%
src/cli/commands/install-rule.ts 100.00% 100.00%
src/cli/commands/list-proposed.ts 100.00% 100.00%
src/cli/commands/list-taken-ids.ts 100.00% 100.00%
src/cli/commands/next-id.ts 100.00% 100.00%
src/cli/commands/plan-renames.ts 100.00% 100.00%
src/cli/commands/regenerate-index.ts 100.00% 100.00%
src/cli/commands/related-decisions.ts 100.00% 100.00%
src/cli/commands/rename-decision.ts 100.00% 100.00%
src/cli/commands/resolve-base.ts 100.00% 100.00%
src/cli/commands/restore-decision-prose.ts 100.00% 100.00%
src/cli/commands/review-settings.ts 100.00% 100.00%
src/cli/commands/session-context.ts 100.00% 100.00%
src/cli/commands/update-audit-state.ts 100.00% 100.00%
src/cli/commands/update-snapshot-state.ts 100.00% 100.00%
src/cli/commands/update-status.ts 100.00% 100.00%
src/cli/commands/update.ts 100.00% 100.00%
src/cli/commands/verify-annotations.ts 100.00% 100.00%
src/cli/index.ts 100.00% 100.00%
src/cli/install.ts 100.00% 100.00%
src/core/annotations.ts 100.00% 93.75%
src/core/audit.ts 100.00% 100.00%
src/core/commit-reindex.ts 100.00% 100.00%
src/core/config.ts 100.00% 92.86%
src/core/decision-edits.ts 99.47% 100.00%
src/core/decisions.ts 100.00% 100.00%
src/core/errors.ts 100.00% 100.00%
src/core/files.ts 100.00% 100.00%
src/core/git.ts 100.00% 100.00%
src/core/ids.ts 100.00% 100.00%
src/core/index-file.ts 98.21% 100.00%
src/core/init.ts 100.00% 100.00%
src/core/mentions.ts 100.00% 100.00%
src/core/open-prs.ts 100.00% 100.00%
src/core/project.ts 100.00% 100.00%
src/core/proposed.ts 100.00% 100.00%
src/core/records.ts 100.00% 100.00%
src/core/reindex.ts 99.37% 100.00%
src/core/related.ts 97.56% 100.00%
src/core/rename-plan.ts 100.00% 100.00%
src/core/rename.ts 100.00% 100.00%
src/core/review-settings.ts 100.00% 100.00%
src/core/snapshot.ts 100.00% 100.00%
src/core/state.ts 97.92% 100.00%
src/generate/adapters.ts 100.00% 100.00%
src/generate/generate.ts 99.38% 96.15%
src/generate/gitattributes.ts 100.00% 100.00%
src/generate/gitignore.ts 100.00% 100.00%
src/generate/harnesses.ts 100.00% 100.00%
src/generate/install.ts 100.00% 100.00%
src/generate/plugins.ts 100.00% 100.00%
src/generate/rule.ts 100.00% 98.33%
src/generate/template.ts 100.00% 100.00%
src/node-context.ts 97.09% 95.56%
templates/rules/dld-workflow.md 100.00% 100.00%

@jimutt
jimutt merged commit baf5da0 into main Nov 3, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants