Skip to content

chore: repo hygiene — gitignore argent init artifacts + resync package-lock for npm 11#383

Merged
filip131311 merged 2 commits into
mainfrom
filip/gitignore-agent-harness-config
Jun 19, 2026
Merged

chore: repo hygiene — gitignore argent init artifacts + resync package-lock for npm 11#383
filip131311 merged 2 commits into
mainfrom
filip/gitignore-agent-harness-config

Conversation

@filip131311

@filip131311 filip131311 commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

Two related repo-hygiene fixes surfaced while triaging a "lock files problem on main".

1. package-lock.json out of sync (fixes the failing CI check)

The lockfile.yml job (package-lock.json in sync) was failing on every PR, including this one — but it's pre-existing drift on main, not caused by the .gitignore change.

Root cause: the committed lockfile carried 26× "peer": true, and "dev": true, markers written by an older npm. CI pins Node 24 (npm 11), which no longer emits those markers, so npm install --package-lock-only produced a 27-line diff and the check failed. (Locally under Node 22 / npm 10 the markers are preserved, so the drift was invisible there — which is why the first pass looked green.)

Fix: regenerated with Node 24 / npm 11.12.127 deletions, no version/resolved/integrity changes (pure metadata normalization). Matches exactly what CI expects.

2. gitignore argent init agent-harness artifacts

Running argent init inside the repo writes generated config into the repo root that was never ignored:

  • .agents/, .codex/config.toml, .gemini/, .opencode/, opencode.json
  • skills-lock.json

These appeared as untracked clutter on every branch and could be committed by accident. skills-lock.json is the worst offender — it bakes in machine-specific absolute paths (/Users/<name>/.nvm/.../@swmansion/argent/skills). These are the same class of artifact as the already-ignored .claude/, .cursor/, .vscode/, .mcp.json, just the newer harnesses. git log --all confirms none were ever tracked, so nothing is removed from history.

… `argent init`

Running `argent init` inside the repo writes MCP/skill config for the newer
agent harnesses (.agents/, .codex/, .gemini/, .opencode/, opencode.json) plus a
skills-lock.json. None were ignored, so they showed up as untracked clutter on
every branch (including main) and could be committed by accident.

These are the same class of generated artifact as the already-ignored
.claude/, .cursor/, .vscode/, .mcp.json entries — just the newer harnesses.
skills-lock.json is especially unsafe to commit: it bakes in machine-specific
absolute skill paths (e.g. /Users/<name>/.nvm/.../@swmansion/argent/skills).

None of these paths were ever tracked, so ignoring them removes no history.
The committed lockfile carried 26 `"peer": true` and 1 `"dev": true` markers
written by an older npm. CI's lockfile-sync job runs under Node 24 (npm 11),
which no longer emits those markers, so `npm install --package-lock-only`
produced a 27-line diff and the "package-lock.json in sync" check failed on
every PR — pre-existing drift on main, unrelated to the .gitignore change.

Regenerated with Node 24 / npm 11.12.1: 27 deletions, no version/resolved/
integrity changes (pure metadata normalization). Matches what CI expects.
@filip131311 filip131311 changed the title chore: gitignore agent-harness config + skills-lock.json generated by argent init chore: repo hygiene — gitignore argent init artifacts + resync package-lock for npm 11 Jun 19, 2026
@filip131311 filip131311 merged commit af75eee into main Jun 19, 2026
5 checks passed
@filip131311 filip131311 deleted the filip/gitignore-agent-harness-config branch June 19, 2026 20:43
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.

1 participant