Skip to content

docs: daily maintenance loop — 2026-04-12#75

Open
nj-io wants to merge 17 commits intodevelopfrom
docs/maintenance-2026-04-09
Open

docs: daily maintenance loop — 2026-04-12#75
nj-io wants to merge 17 commits intodevelopfrom
docs/maintenance-2026-04-09

Conversation

@nj-io
Copy link
Copy Markdown
Owner

@nj-io nj-io commented Apr 9, 2026

Summary

2026-04-12

2026-04-11

  • Enrich: 25 CLI subcommand docstrings across 8 files — arc (5), journey (3), memory (3), project (8), config (2), media (1), events (1), rate-limits (1) — terse one-liners replaced with explanatory prose and examples
  • Fix: quickstart.md social-hook trigger shown without arguments — command requires --commit <hash> --repo <path>
  • Fix: pipeline.md preview mode only mentioned "no connected targets" — now also documents the OAuth credential check
  • Regenerated: CLI docs (8 files updated to reflect enriched subcommand docstrings)
  • All 11 recurring checks pass. Ruff clean, mypy 28 pre-existing errors
  • No new backlog approvals found in PR chore(docs-maintenance): maintenance run 2026-03-31 #71 or PR docs: daily maintenance loop — 2026-04-12 #75 comments

2026-04-10

  • Enrich: 8 CLI group help texts in __init__.pyarc, decision, inspect, manual, media, memory, project, snapshot upgraded from terse one-liners to descriptive help
  • Fix: quickstart.md section 6 claimed "git hook triggers automatically" unconditionally — now explains both hook path (after full setup) and manual social-hook trigger path
  • Track: 8 previously untracked CLI groups added to DOC_STATUS coverage table
  • Regenerated: CLI docs (9 files updated to reflect enriched group help)
  • Fix: stale last_run_commit (previous value referenced non-existent SHA)
  • All 11 recurring checks pass. Ruff clean, mypy 28 pre-existing errors

2026-04-09

  • Fix: quickstart docs (installation.md, quickstart.md) incorrectly claimed "install git post-commit hook" — actual step is "import commit history"
  • Fix: added max_discovery_tokens (default 60000) and max_file_size (default 256000) to content-config.md context table
  • Fix: stale post_category values and media adapter name
  • Update: DOC_STATUS.md — refreshed recurring check dates, added 2 new recurring checks

Waiting for review

  • Add rate_limits section to config.md (RateLimitsConfig: max_evaluations_per_day, min_evaluation_gap_minutes, batch_throttled)
  • Add identities section to config.md (IdentityConfig + default_identity: named authorship identities)
  • Add content_strategies section to config.md (ContentStrategyConfig + content_strategy: named strategies with audience, voice, post_when, avoid)
  • Document pipeline entry points beyond git commits (operator suggestions via trigger_secondary.py)
  • Document target source-dependency routing (source: field in target config)

Test plan

  • Verify mkdocs serve renders updated pages without errors
  • Confirm quickstart steps match social-hook quickstart --help output
  • Confirm CLI reference index shows enriched group and subcommand descriptions

https://claude.ai/code/session_01LGUDXXcNL8eh8MyzVU1W33

nj-io and others added 13 commits March 21, 2026 15:29
chore: merge develop into main
…ponents--social-hook

chore(main): release 0.10.0
chore: merge develop into main
…ponents--social-hook

chore(main): release 0.11.0
release: ✨ targets system — multi-account content flows with two-stage evaluation
…ponents--social-hook

chore(main): release 0.12.0
…g config fields

- Fix: quickstart docs incorrectly claimed "install git post-commit hook";
  actual step is "import commit history" (installation.md, quickstart.md)
- Add max_discovery_tokens and max_file_size to content-config.md context table
- Bootstrap site-docs/DOC_STATUS.md with coverage tracking, recurring checks,
  and backlog items (rate_limits, identities, content_strategies sections)

https://claude.ai/code/session_0156sD1TVpZesJ9cdabJghaF
- pipeline.md: post_category values `standalone`/`reactive` → `arc`/`opportunistic`/`experiment` (matches PostCategory enum)
- pipeline.md: media adapter "Gemini" → "nano_banana_pro" (matches adapter registry)
- narrative-arcs.md: "reactive" → "experiment" in narrative debt description

https://claude.ai/code/session_0156sD1TVpZesJ9cdabJghaF
@codecov-commenter
Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

claude added 4 commits April 10, 2026 02:20
…ckstart trigger docs

- Enrich 8 CLI group help texts in __init__.py: arc, decision, inspect, manual,
  media, memory, project, snapshot (terse one-liners → descriptive help)
- Fix quickstart.md section 6: was "git hook triggers automatically" → now explains
  both hook path (full setup) and manual `social-hook trigger` path
- Add 8 untracked CLI groups to DOC_STATUS coverage table
- Regenerate CLI docs (9 files updated)
- Fix stale last_run_commit (previous SHA didn't exist)
- All 11 recurring checks pass; ruff clean, mypy 28 pre-existing

https://claude.ai/code/session_01AFCxKuYJUUjGowAFFwdJYq
# Conflicts:
#	.release-please-manifest.json
#	CHANGELOG.md
#	pyproject.toml
#	src/social_hook/__init__.py
…track batch-evaluate

- Update quickstart.md: document --strategy/-s and --branch/-b flags
- Update installation.md: quickstart steps include config.yaml creation
- Track new decision batch-evaluate command in DOC_STATUS
- All 11 recurring checks pass (ruff clean, mypy 28 pre-existing)
- No new backlog approvals in PR #71-#74 comments

https://claude.ai/code/session_01LGUDXXcNL8eh8MyzVU1W33
@nj-io nj-io changed the title docs: daily maintenance loop — 2026-04-09 docs: daily maintenance loop — 2026-04-12 Apr 12, 2026
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