Bring project scaffolding and CI in line with feed2fedi/zaojun/sub2pod standards #27

New issue

Closed

opened 2026-07-20 00:05:33 +00:00 by coding-agent-marvin8 · 1 comment

coding-agent-marvin8 commented

2026-07-20 00:05:33 +00:00

(Migrated from codeberg.org)

Align longwei's project scaffolding, CI workflows, and documentation with the patterns established in feed2fedi, zaojun, and sub2pod during the 2026-07-19 maintenance sessions.

The full checklist is documented in current-tasks.md (maintainer's private repo). Key areas:

AGENTS.md creation + CLAUDE.md → symlink
AI-DECLARATION.md
Scaffolding alignment (ruff.toml, .gitleaks.toml, .editorconfig, .pre-commit-config.yaml)
CI workflow fixes (setup-uv@v5, gitleaks checksum verification)
fediverse-post recipe fix (remove git commit/push)
Dependency version alignment (zaojun + deptry)

Align longwei's project scaffolding, CI workflows, and documentation with the patterns established in feed2fedi, zaojun, and sub2pod during the 2026-07-19 maintenance sessions. The full checklist is documented in `current-tasks.md` (maintainer's private repo). Key areas: - AGENTS.md creation + CLAUDE.md → symlink - AI-DECLARATION.md - Scaffolding alignment (ruff.toml, .gitleaks.toml, .editorconfig, .pre-commit-config.yaml) - CI workflow fixes (setup-uv@v5, gitleaks checksum verification) - fediverse-post recipe fix (remove git commit/push) - Dependency version alignment (zaojun + deptry)

coding-agent-marvin8 commented

2026-07-20 00:05:48 +00:00

(Migrated from codeberg.org)

Plan of attack

1. AGENTS.md + CLAUDE.md symlink

Create AGENTS.md from current CLAUDE.md with fixes:
- Heading → # AGENTS.md
- Definition of Done: add ruff format --check .
- Commit messages: replace fixed gitmoji list with "Any valid gitmoji is acceptable; refer to https://gitmoji.dev"
- Remove stale references (old changelog tooling, etc.)
ln -sf AGENTS.md CLAUDE.md

2. AI-DECLARATION.md

Create per ai-declaration.md v0.1.2 with level: copilot, deployment: none, review: assist
Add badge to README.md (shield.io linked to ai-declaration.md)

3. Scaffolding alignment

ruff.toml: target-version = "py311", add TID252 ban-relative-imports, add TID to select/fixable
.gitleaks.toml: simplify to title + extend only (remove allowlists)
.editorconfig: remove insert_final_newline = ignore for JSON
.pre-commit-config.yaml: ruff → ruff-check (legacy alias)
After ruff.toml change: run ruff check --fix . then ruff format . (expect UP017 + I001 autofixes)

4. CI workflow overhaul

ci.yml: Replace all curl|sh uv installs with uses: astral-sh/setup-uv@v5 in checks, publish, deploy-docs
ci.yml: Update gitleaks step to read version from .pre-commit-config.yaml with checksum verification
weekly-checks.yml: Replace pip install uv with uses: astral-sh/setup-uv@v5

5. fediverse-post justfile fix

Remove git add, git commit, git push from fediverse-post recipe
Add message: echo "Release-Notes.md reset — commit it with the next piece of work."

6. Dependency alignment

Run zaojun to check for available updates
Bump deps in pyproject.toml and .pre-commit-config.yaml as needed
Add [tool.deptry.per_rule_ignores] with DEP002 entries for constraint-dependencies
uv lock + regenerate pylock.toml

Branch

chore/issue-27-project-scaffolding-alignment

Commits (planned)

📝 create AGENTS.md and symlink CLAUDE.md
📝 add AI-DECLARATION.md and README badge
🔧 align scaffolding configs (ruff, gitleaks, editorconfig, pre-commit)
👷 overhaul CI workflows with setup-uv@v5 and gitleaks checksums
🔧 remove git commit/push from fediverse-post recipe
⬆️ align dependency versions and add deptry ignores

PR

fj --host https://codeberg.org pr create "Bring project scaffolding and CI in line with feed2fedi/zaojun/sub2pod standards" \
  --base main \
  --head chore/issue-27-project-scaffolding-alignment \
  -r MarvinsMastodonTools/longwei \
  --body "Closes #27"

## Plan of attack ### 1. AGENTS.md + CLAUDE.md symlink - Create `AGENTS.md` from current `CLAUDE.md` with fixes: - Heading → `# AGENTS.md` - Definition of Done: add `ruff format --check .` - Commit messages: replace fixed gitmoji list with "Any valid gitmoji is acceptable; refer to https://gitmoji.dev" - Remove stale references (old changelog tooling, etc.) - `ln -sf AGENTS.md CLAUDE.md` ### 2. AI-DECLARATION.md - Create per ai-declaration.md v0.1.2 with level: copilot, deployment: none, review: assist - Add badge to README.md (shield.io linked to ai-declaration.md) ### 3. Scaffolding alignment - `ruff.toml`: `target-version = "py311"`, add TID252 ban-relative-imports, add TID to select/fixable - `.gitleaks.toml`: simplify to title + extend only (remove allowlists) - `.editorconfig`: remove `insert_final_newline = ignore` for JSON - `.pre-commit-config.yaml`: `ruff` → `ruff-check` (legacy alias) - After ruff.toml change: run `ruff check --fix .` then `ruff format .` (expect UP017 + I001 autofixes) ### 4. CI workflow overhaul - `ci.yml`: Replace all `curl|sh` uv installs with `uses: astral-sh/setup-uv@v5` in checks, publish, deploy-docs - `ci.yml`: Update gitleaks step to read version from .pre-commit-config.yaml with checksum verification - `weekly-checks.yml`: Replace `pip install uv` with `uses: astral-sh/setup-uv@v5` ### 5. fediverse-post justfile fix - Remove `git add`, `git commit`, `git push` from fediverse-post recipe - Add message: echo "Release-Notes.md reset — commit it with the next piece of work." ### 6. Dependency alignment - Run `zaojun` to check for available updates - Bump deps in pyproject.toml and .pre-commit-config.yaml as needed - Add `[tool.deptry.per_rule_ignores]` with DEP002 entries for constraint-dependencies - `uv lock` + regenerate `pylock.toml` ### Branch `chore/issue-27-project-scaffolding-alignment` ### Commits (planned) 1. :memo: create AGENTS.md and symlink CLAUDE.md 2. :memo: add AI-DECLARATION.md and README badge 3. :wrench: align scaffolding configs (ruff, gitleaks, editorconfig, pre-commit) 4. :construction_worker: overhaul CI workflows with setup-uv@v5 and gitleaks checksums 5. :wrench: remove git commit/push from fediverse-post recipe 6. :arrow_up: align dependency versions and add deptry ignores ### PR ```bash fj --host https://codeberg.org pr create "Bring project scaffolding and CI in line with feed2fedi/zaojun/sub2pod standards" \ --base main \ --head chore/issue-27-project-scaffolding-alignment \ -r MarvinsMastodonTools/longwei \ --body "Closes #27" ```