Skip to content

chore: single-source CI/CD and docs, add operator runbook - #653

Merged
AsperforMias merged 1 commit into
mainfrom
chore/single-source-docs-and-workflows
Nov 8, 2026
Merged

AsperforMias merged 1 commit into
mainfrom
chore/single-source-docs-and-workflows

Conversation

@AsperforMias

Copy link
Copy Markdown
Collaborator

Summary

  • Reusable workflows. component-ci.yml and component-release.yml give the private components (ghfind-server, ghfind-frontend) the same CI and release gate as this repo. Their own ci.yml/release.yml become thin callers. release.yml here calls component-release.yml too.
  • Runbook. docs/runbook.md is a man-page style operator guide: release, compose, rollback, Feed cutover, recovery, App key rotation, add-path, local assembly, variables/secrets, files. docs/architecture.md stays the design doc and links to it. The stale compose-paths.txt step is removed.
  • Cleanup. Removed .github/pr-evidence/ (monorepo PR screenshots) and ran go mod tidy. The public module needs no third-party Go deps; the assembled workspace uses ghfind-server's go.mod.
  • README, README.zh, CONTRIBUTING and AGENTS now describe where the full suite really runs (after merge on main, then on deploy) and link to the runbook.

Test plan

  • actionlint 1.7.12 (-shellcheck= -pyflakes=, same flags as CI)
  • node --test scripts/feed-github-protection.test.mjs (19 pass)
  • go build ./... (root and scoring) with the tidied go.mod
  • Required PR checks green
  • Private repos switched to the callers, with their CI green

🤖 Generated with Claude Code

- component-ci.yml / component-release.yml: reusable CI and release for the
  private components, so all three repositories share one release gate
- release.yml: thin caller of component-release.yml
- docs/runbook.md: man-page style operator runbook (release, compose,
  rollback, Feed cutover, recovery, key rotation, add-path, develop)
- docs/architecture.md: link the runbook, drop compose-paths.txt
- remove .github/pr-evidence (monorepo PR screenshots) and the unused Go
  dependencies left from the monorepo (go mod tidy)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AsperforMias
AsperforMias merged commit 9453d92 into main Nov 8, 2026
3 checks passed
@AsperforMias
AsperforMias deleted the chore/single-source-docs-and-workflows branch November 8, 2026 09:16
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