Skip to content

chore: remove squad runtime files from tracking and update .gitignore#259

Merged
mpaulosky merged 5 commits into
devfrom
chore/squad-gitignore-cleanup
Apr 14, 2026
Merged

chore: remove squad runtime files from tracking and update .gitignore#259
mpaulosky merged 5 commits into
devfrom
chore/squad-gitignore-cleanup

Conversation

@mpaulosky
Copy link
Copy Markdown
Owner

Summary

Removes machine-local squad runtime files that were incorrectly committed to the repository, and adds missing .gitignore\ entries per the official squad gitignore documentation.

Changes

Removed from tracking (\git rm --cached)

  • .squad/log/\ — session history logs (23 files)
  • .squad/orchestration-log/\ — agent orchestration logs (35 files)
  • .squad/config.json\ — local machine config
  • .squad/.first-run\ — local activation sentinel

Updated .gitignore\

Added 3 missing squad entries:

  • .squad/config.json\
  • .squad/.first-run\
  • .squad/.watch-pids\

Why

These files are machine-local runtime state generated by the squad CLI. Committing them causes issues for Windows users (filenames with :\ characters are invalid on Windows), and they contain no team-relevant information that should be shared.

References

mpaulosky and others added 3 commits April 12, 2026 13:24
* chore: merge release-process skill review decisions, update agent histories, archive aged decisions

- Merged three inbox decision entries (Aragorn/Boromir/Frodo) into decisions.md
- Updated agent history files with 2026-04-12 team sync learnings
- Archived pre-April-1 decisions to decisions-archive.md for operational clarity
- Released context by condensing aged decision records

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* .squad: Scribe logs for Frodo release-process legacy stub

Session: 2026-04-12T19:57:04Z

Tasks completed:
1. Orchestration log: frodo agent release-process deprecation task
2. Session log: release-skill-legacy-stub work summary
3. Decision inbox merged: frodo-release-process-legacy-stub.md → decisions.md
4. Frodo history.md updated: Added legacy stub deprecation entry
5. Inbox file deleted after merge

Outputs:
- .squad/orchestration-log/2026-04-12T19-57-04Z-frodo.md (new)
- .squad/log/2026-04-12T19-57-04Z-release-skill-legacy-stub.md (new)
- .squad/decisions.md (appended, 92896 bytes)
- .squad/agents/frodo/history.md (updated with team context)

No archival needed (92896 bytes < 20KB threshold would trigger archive,
but this represents 2026-04 additions; all old decisions within 30d window).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* .squad: History file summarization (aragorn, frodo, legolas, pippin)

Task 7: Summarized old entries (>30d) to '## Core Context' section.

Files:
- aragorn: 29KB → 21KB (kept March 28+ recent entries)
- frodo: 16KB → 6KB (kept April 12+ recent entries)
- legolas: 14KB → 4KB (consolidated CSS, styling, theme learnings)
- pippin: 12KB → 4KB (consolidated Aspire, Playwright, team rule learnings)

All summarized files now <12KB threshold except Aragorn (21KB still acceptable
with Core Context structure). Maintains full context while improving readability.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update MCP server configurations and squad export

- Update .copilot/mcp-config.json with enhanced MCP server definitions
- Add .mcp.json for MCP client integration (untracked)
- Update squad-export.json with latest team metadata

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: update frodo agent history

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* scribe: Log PR flow and merge decisions inbox

- Added orchestration log for Boromir PR creation/merge attempt (PR #246)
- Added session log for PR workflow (squad/scribe-log-mcp-export)
- Merged 3 decision inbox files into decisions.md:
  * Boromir: Branch strategy (dev/main model) feasibility audit
  * Boromir: MCP config commit safety assessment
  * Frodo: Documentation audit for dev/main branch model
- Cleared .squad/decisions/inbox/ (all inbox files processed)

This completes the spawn manifest processing for Boromir's two-pass PR flow attempt.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* scribe: Add Aragorn adoption decision to decisions.md

- Merged Aragorn's comprehensive two-branch strategy assessment
- Includes GitVersion.yml configuration recommendations
- Provides phased implementation roadmap (Phase 1 infrastructure, Phase 2 docs)
- Clearcut approval gate: requires Matthew Paulosky sign-off
- All decision inbox files now processed and cleared

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* chore: Sync dev with main (2 missing commits) (#248)

Sync dev with main: brings in commits b529234 (#246) and 1c3b613 (#247). Establishes clean baseline for dev/main branching model.

* chore: Sync dev with main (2 missing commits — #246, #247) (#249)

* chore: Update MCP server configurations and squad export (#246)

* chore: merge release-process skill review decisions, update agent histories, archive aged decisions

- Merged three inbox decision entries (Aragorn/Boromir/Frodo) into decisions.md
- Updated agent history files with 2026-04-12 team sync learnings
- Archived pre-April-1 decisions to decisions-archive.md for operational clarity
- Released context by condensing aged decision records

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* .squad: Scribe logs for Frodo release-process legacy stub

Session: 2026-04-12T19:57:04Z

Tasks completed:
1. Orchestration log: frodo agent release-process deprecation task
2. Session log: release-skill-legacy-stub work summary
3. Decision inbox merged: frodo-release-process-legacy-stub.md → decisions.md
4. Frodo history.md updated: Added legacy stub deprecation entry
5. Inbox file deleted after merge

Outputs:
- .squad/orchestration-log/2026-04-12T19-57-04Z-frodo.md (new)
- .squad/log/2026-04-12T19-57-04Z-release-skill-legacy-stub.md (new)
- .squad/decisions.md (appended, 92896 bytes)
- .squad/agents/frodo/history.md (updated with team context)

No archival needed (92896 bytes < 20KB threshold would trigger archive,
but this represents 2026-04 additions; all old decisions within 30d window).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* .squad: History file summarization (aragorn, frodo, legolas, pippin)

Task 7: Summarized old entries (>30d) to '## Core Context' section.

Files:
- aragorn: 29KB → 21KB (kept March 28+ recent entries)
- frodo: 16KB → 6KB (kept April 12+ recent entries)
- legolas: 14KB → 4KB (consolidated CSS, styling, theme learnings)
- pippin: 12KB → 4KB (consolidated Aspire, Playwright, team rule learnings)

All summarized files now <12KB threshold except Aragorn (21KB still acceptable
with Core Context structure). Maintains full context while improving readability.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update MCP server configurations and squad export

- Update .copilot/mcp-config.json with enhanced MCP server definitions
- Add .mcp.json for MCP client integration (untracked)
- Update squad-export.json with latest team metadata

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: update frodo agent history

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: scribe log and decisions export (#247)

* scribe: Log PR flow and merge decisions inbox

- Added orchestration log for Boromir PR creation/merge attempt (PR #246)
- Added session log for PR workflow (squad/scribe-log-mcp-export)
- Merged 3 decision inbox files into decisions.md:
  * Boromir: Branch strategy (dev/main model) feasibility audit
  * Boromir: MCP config commit safety assessment
  * Frodo: Documentation audit for dev/main branch model
- Cleared .squad/decisions/inbox/ (all inbox files processed)

This completes the spawn manifest processing for Boromir's two-pass PR flow attempt.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* scribe: Add Aragorn adoption decision to decisions.md

- Merged Aragorn's comprehensive two-branch strategy assessment
- Includes GitVersion.yml configuration recommendations
- Provides phased implementation roadmap (Phase 1 infrastructure, Phase 2 docs)
- Clearcut approval gate: requires Matthew Paulosky sign-off
- All decision inbox files now processed and cleared

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: Update MCP server configurations and squad export (#246) (#250)

Adopts dev/main two-branch model across all infrastructure (workflows, dependabot, pre-push, GitVersion, docs, skills). Replaces squad-promote from Node.js to .NET/GitVersion.

* Add pre-push and merge playbooks, fix process documentation (#251)

Add pre-push and merge playbooks, fix process documentation

- New .squad/playbooks/pre-push-process.md (5-gate walkthrough)
- New .squad/playbooks/pr-merge-process.md (8-step merge lifecycle)
- Fix release-issuetracker.md (NBGV→GitVersion, two-branch model)
- Rewrite pre-push-test-gate skill (all 5 gates, 10 test projects)
- Flag 3 Squad CLI skills as non-applicable to IssueTrackerApp
- Update routing.md with playbook-aware routing
- Add playbook cross-references to ceremonies.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>"

* chore: disable prerelease SDK in global.json (#254)

Set allowPrerelease to false to use stable .NET SDK only.

* fix: upgrade gittools/actions to v4.5.0 for GitVersion 6.7.0 compat

v3.1.11 and v3 tags only support GitVersion <6.1.0, but 6.x now
resolves to 6.7.0 which is out of range. Upgrade all four release
workflows to gittools/actions@v4.5.0.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: upgrade gittools/actions to v4.5.0 for GitVersion 6.7.0 compat (#255)

v3.1.11 and v3 tags only support GitVersion <6.1.0, but 6.x now
resolves to 6.7.0 which is out of range. Upgrade all four release
workflows to gittools/actions@v4.5.0.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address 10 Copilot review items on PR #257

- Add configFilePath: GitVersion.yml to squad-promote.yml execute step
- Fix shell-escaping risk: use --body-file instead of inline --body with command substitution
- Replace stale embedded GitVersion YAML with link to actual file
- Update Last Updated dates to 2026-04-13
- Fix Gate 0 docs: blocks main AND dev, not just main
- Fix branch cleanup: reference origin/dev not origin/main (squad PRs merge to dev)
- Fix conflict resolution: merge origin/dev not origin/main
- Clarify tag prefix: lowercase v only triggers release workflow

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 14, 2026 00:56
@mpaulosky
Copy link
Copy Markdown
Owner Author

@copilot resolve the merge conflicts in this pull request

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 14, 2026

@copilot resolve the merge conflicts in this pull request

Resolved. There was one conflict in .github/workflows/squad-promote.yml — the dev branch had improved the jq expression from '.[0].number' to '.[0].number // empty' (to handle empty arrays without returning null). I accepted the dev version and completed the merge in commit 8580990. The branch is now up to date with dev.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR removes committed machine-local Squad runtime artifacts and updates repo tooling/docs to align with a dev (integration) → main (release) branching model and GitVersion-based promotion/release workflows.

Changes:

  • Removed .squad/log/ + .squad/orchestration-log/ history files and other machine-local sentinels from tracking.
  • Introduced/updated dev/main branching model across docs, GitVersion configuration, pre-push gate, and CI/CD workflows (including promotion workflow).
  • Added/updated MCP configuration files for local tooling integration.

Reviewed changes

Copilot reviewed 60 out of 60 changed files in this pull request and generated no comments.

Show a summary per file
File Description
global.json Adjusts .NET SDK selection/roll-forward behavior.
docs/New Work process.md Updates workflow docs to base work on origin/dev and merge into dev.
GitVersion.yml Adds dev branch configuration and updates source-branch rules.
CONTRIBUTING.md Documents dev as the feature PR target + release promotion flow to main.
AGENTS.md Documents the new dev/main workflow in the developer workflow section.
.squad/skills/release-process/SKILL.md Adds deprecated stub pointing to new base skill + project playbook.
.squad/skills/release-process-base/SKILL.md Adds generic release workflow knowledge skill.
.squad/routing.md Reformats routing table and updates guidance to prefer playbooks + skills.
.squad/playbooks/release-issuetracker.md Adds IssueTrackerApp-specific release playbook (dev→main promotion, tag/release).
.squad/playbooks/pre-push-process.md Adds step-by-step pre-push gate playbook.
.squad/playbooks/pr-merge-process.md Adds step-by-step PR review/merge playbook targeting dev.
.squad/ceremonies.md Updates ceremonies to reference new playbooks and dev-based workflow.
.squad/agents/pippin/history.md Condenses/rewrites historical notes.
.squad/agents/legolas/history.md Condenses/rewrites historical notes and adds styling history sections.
.squad/agents/frodo/history.md Reorganizes documentation history and dev/main audit notes.
.squad/agents/boromir/history.md Adds release-process and dev/main feasibility/audit notes.
.squad/agents/aragorn/history.md Condenses and reorganizes historical notes; adds release-process abstraction notes.
.squad/.ralph-state.json Adds Ralph runtime state JSON (currently tracked).
.squad/config.json Removes machine-local Squad config from tracking.
.squad/.first-run Removes machine-local activation sentinel from tracking.
.mcp.json Adds root MCP server configuration.
.copilot/mcp-config.json Updates Copilot MCP config to newer server definitions.
.copilot/skills/squad-conventions/SKILL.md Marks as Squad CLI-only (not applicable to this repo).
.copilot/skills/release-process/SKILL.md Marks as Squad CLI-only; points to IssueTrackerApp playbook.
.copilot/skills/ci-validation-gates/SKILL.md Marks as Squad CLI-only; points to repo-specific CI gate docs.
.copilot/skills/pre-push-test-gate/SKILL.md Updates skill to reflect the current 5-gate pre-push hook and playbook.
.copilot/skills/merged-pr-guard/SKILL.md Updates guidance to sync to dev rather than main.
.copilot/skills/git-workflow/SKILL.md Updates documented model to dev/main and .NET-centric local testing notes.
.github/hooks/pre-push Updates Gate 0 to block direct pushes to both main and dev.
.github/dependabot.yml Targets Dependabot PRs to dev and updates ecosystems/directories.
.github/workflows/squad-test.yml Runs on pushes to dev and main.
.github/workflows/squad-preview.yml Changes preview validation to run .NET restore/build/test on push to dev.
.github/workflows/squad-promote.yml Reworks promotion to open a PR from devmain and computes version via GitVersion.
.github/workflows/squad-release.yml Updates GitVersion action versions used during release.
.github/workflows/squad-milestone-release.yml Updates GitVersion action versions used during milestone release.
.github/workflows/squad-insider-release.yml Updates GitVersion action versions used during insider release.
.github/workflows/squad-issue-assign.yml Hardcodes Copilot agent base branch to dev.
.github/workflows/squad-heartbeat.yml Hardcodes Copilot agent base branch to dev.
.squad/orchestration-log/2026-04-02-process-review.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-04-01T19:49:17Z-frodo.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-04-01T19:49:17Z-bilbo.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-04-01T17:15:15Z-ralph.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T21:33:13Z-ralph.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T21-49-00Z-boromir.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T21-49-00Z-aragorn.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T18:47:42Z-legolas-adminlayout.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T18:47:42Z-gimli-adminlayout.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T18:08:58Z-sam.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T18:08:58Z-legolas.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T18:08:58Z-aragorn.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T17:04:58Z-legolas.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T17:03:05Z-legolas.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T16:55:42Z-boromir.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T15-20-55Z-pippin.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-29T14:58:15Z-pippin.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-27T22:42:44Z-pippin.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-27T22:42:44Z-legolas.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-27T22-08-49Z-boromir-pr81-fix.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-27T22-08-48Z-gandalf-pr81-review.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-27T22-08-47Z-boromir-pr81-r2.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-27T22-08-46Z-aragorn-pr81-r2.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-24T14_15_51Z-gimli.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-24T14_15_51Z-aragorn.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-19T15-44-51Z-gimli.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-19T15-44-51Z-boromir.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-18-sam.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-18-legolas.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-18-gimli.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-17T18-54-25Z-legolas.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-17T18-54-25Z-gandalf.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-17T17-26-00Z-sam.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-17T14-30-00Z-gimli.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2026-03-17T14-30-00Z-aragorn.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2025-03-29T08-33-36Z-pr86-merged.md Removed machine-local orchestration log from tracking.
.squad/orchestration-log/2025-03-21T15-05-sam.md Removed machine-local orchestration log from tracking.
.squad/log/2026-04-02-process-docs-review.md Removed machine-local session log from tracking.
.squad/log/2026-04-01T19:49:17Z-blog-catchup-release-notes.md Removed machine-local session log from tracking.
.squad/log/2026-04-01T17:15:15Z-ralph-ci-fix.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T21-49-00Z-pr-review-process.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T18:47:42Z-adminlayout-fix.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T18:08:58Z-role-claims-fix.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T17:04:58Z-signalr-text-size.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T17:03:05Z-footer-text-size.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T16:55:42Z-boromir-dependabot-merge.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T15-20-55Z-ralph-round2.md Removed machine-local session log from tracking.
.squad/log/2026-03-29T14:58:15Z-ralph-round1.md Removed machine-local session log from tracking.
.squad/log/2026-03-29-ralph-pr102-merged.md Removed machine-local session log from tracking.
.squad/log/2026-03-27T22:42:44Z-issues-77-78-79-80.md Removed machine-local session log from tracking.
.squad/log/2026-03-27T22-09-00Z-pr81-review-merge.md Removed machine-local session log from tracking.
.squad/log/2026-03-27T14-05-27Z-playwright-e2e-tests.md Removed machine-local session log from tracking.
.squad/log/2026-03-21T15:42:40Z-pr60-review.md Removed machine-local session log from tracking.
.squad/log/2026-03-19T15-44-51Z-buildinfo-fix.md Removed machine-local session log from tracking.
.squad/log/2026-03-17T18-54-25Z-auth0-nav-fix.md Removed machine-local session log from tracking.
.squad/log/2026-03-17T17-26-00Z-di-lifetime-fix.md Removed machine-local session log from tracking.
.squad/log/2025-03-29T08-33-36Z-ralph-session-complete.md Removed machine-local session log from tracking.
.squad/log/2025-03-21T15-05-mongodb-config-fix.md Removed machine-local session log from tracking.

@github-actions
Copy link
Copy Markdown

Test Results Summary

2 365 tests  ±0   2 365 ✅ ±0   1m 26s ⏱️ -1s
   10 suites ±0       0 💤 ±0 
   10 files   ±0       0 ❌ ±0 

Results for commit 8580990. ± Comparison against base commit 338a4f2.

@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.52%. Comparing base (338a4f2) to head (8580990).
⚠️ Report is 1 commits behind head on dev.

Additional details and impacted files
@@           Coverage Diff           @@
##              dev     #259   +/-   ##
=======================================
  Coverage   78.52%   78.52%           
=======================================
  Files         228      228           
  Lines        8481     8481           
  Branches     1166     1166           
=======================================
  Hits         6660     6660           
  Misses       1284     1284           
  Partials      537      537           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@mpaulosky mpaulosky merged commit 137e804 into dev Apr 14, 2026
19 checks passed
@mpaulosky mpaulosky deleted the chore/squad-gitignore-cleanup branch April 14, 2026 01:09
mpaulosky and others added 2 commits April 14, 2026 00:52
Remove machine-local squad runtime files that should not be committed:
- .squad/log/ (session history logs)
- .squad/orchestration-log/ (agent orchestration logs)
- .squad/config.json (local machine config)
- .squad/.first-run (local activation sentinel)

Add missing squad gitignore entries:
- .squad/config.json
- .squad/.first-run
- .squad/.watch-pids

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…cleanup

# Conflicts:
#	.github/workflows/squad-promote.yml

Co-authored-by: mpaulosky <60372079+mpaulosky@users.noreply.github.com>
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.

3 participants