chore(docs-maintenance): maintenance run 2026-03-25 by nj-io · Pull Request #62 · nj-io/social-hook

nj-io · 2026-03-25T03:49:46Z

Summary

Add 9 new CLI command groups to mkdocs.yml nav: account, brief, content, credentials, cycles, strategy, system, target, topics (from targets feature)
Update config.md: Replace stale OAuth 1.0a env vars with OAuth 2.0 (X_CLIENT_ID, X_CLIENT_SECRET)
Update DOC_STATUS.md: Track 9 new CLI groups, mark pipeline/arcs concepts as stale (need targets update), add new backlog items from PR docs: enrich CLI docstrings and add DOC_STATUS tracking #60 feedback

2026-03-30 run

Merged develop (90+ commits: targets feat: targets system — evaluation, topics, settings, wizard #69, reusability refactor refactor: ♻️ reusability improvement loop — passes 1-5 #70, logging pipeline feat: unified logging pipeline with multi-sink LogBus #64/fix: prevent recursive logging loop in DbSink #66, many fixes)
Enriched 16 CLI command docstrings across 6 files: inspect (4), decision (2), manual (3), draft (8), strategy (1), target (1) — all upgraded from poor/partial to ok
Rewrote pipeline.md for two-stage evaluation: added Commit Analyzer (stage 2), interval gating, batch evaluation, per-strategy decisions, target routing, evaluation cycles, preview mode; renumbered stages 1→9
Updated narrative-arcs.md: strategy-scoped arcs (strategy field), episode_type → episode_tags
Regenerated CLI reference docs (6 files updated)
Updated DOC_STATUS.md: corrected coverage ratings, added 3 recurring checks, marked completed backlog items
Fixed mkdocs.yml nav: replaced deleted system.md with logs.md
All checks pass: ruff clean, mypy pre-existing only (28 library stub errors)

2026-03-29 run

Merged develop (1 new commit: Recurring Checks section addition)
Regenerated CLI docs — no diff (no CLI source changes)
Corrected getting-started status: installation.md and quickstart.md downgraded from "stale" to "complete" — the preview draft → promote flow is still valid and functional; targets workflow additions remain in backlog
Ruff clean, mypy pre-existing only (library stubs)
Updated last_run_commit to cf5db9e and last_run_date to 2026-03-29
No new backlog approvals found in PR comments

2026-03-28 run

Merged develop (6 new commits: OAuth Basic Auth fix, scroll-to-section fix, E2E --headless flag)
Regenerated CLI docs — no diff (no CLI source changes)
No existing docs needed updating (changes are internal/non-user-facing)
Updated last_run_commit to 3c8d6cf and last_run_date to 2026-03-28

Backlog (waiting for approval)

Completed this run

Enrich docstrings for 16 partial/poor CLI commands (inspect, decision, manual, draft, strategy, target)
Rewrite pipeline.md for two-stage evaluation, targets path, batch evaluation
Update narrative-arcs.md for strategy-scoped arcs and episode_tags
Regenerate CLI reference docs
Add 3 new recurring checks to DOC_STATUS

State

last_run_commit: cf5db9e → 6688d91
Changes since last run: 90+ commits (targets feature merge, reusability refactor, logging pipeline, many fixes)

🤖 Generated by maintenance-loop (docs-maintenance)

… refresh status - Update config.md: replace stale OAuth 1.0a env vars (X_API_KEY etc.) with OAuth 2.0 credentials (X_CLIENT_ID, X_CLIENT_SECRET) - Update DOC_STATUS.md: mark enriched docstrings as ok, add new backlog items from PR #60 comments (agent-first CLI, targets/preview changes) - Set last_run_commit to current develop HEAD Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

codecov-commenter · 2026-03-25T03:51:23Z

⚠️ Please install the 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!

…get branch Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

…PR template Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

…date status - Add 9 new CLI command groups to mkdocs.yml nav (account, brief, content, credentials, cycles, strategy, system, target, topics) - Update config.md OAuth 1.0a → OAuth 2.0 env vars - Update DOC_STATUS.md: mark existing concepts as stale (pipeline, arcs need targets update), add new concept pages to backlog, track 9 new CLI command groups 37 commits since last run (targets feature, OAuth 2.0 migration). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Improved the help= strings in add_typer() registrations so the CLI index and --help output describe what each group actually does: - account: "Manage OAuth-authenticated platform accounts (X, LinkedIn)" - brief: "View and edit the project brief used by the evaluator and drafter" - content: "Submit content ideas, combine topics, and trigger hero launch drafts" - credentials: "Manage API keys and secrets in ~/.social-hook/.env" - cycles: "Inspect evaluation cycle history and per-strategy outcomes" - strategy: "View and customize content strategies (voice, audience, editorial rules)" - system: "Monitor system health, view error feed, and check process status" - target: "Configure where content is distributed (account + destination + strategy)" - topics: "Manage the prioritised content topic queue per strategy" Regenerated CLI docs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

No doc content changes needed. Commits since last run (4e955dd..c8b0446) are internal: Basic Auth for OAuth token refresh, scroll-to-section fix, E2E --headless flag. CLI docs regenerated with no diff. https://claude.ai/code/session_014a9r2J6paJfpQxMFs3wmjK

…ed status Verified quickstart and installation docs are functionally accurate (preview draft → promote flow still works). Downgraded from "stale" to "complete" since the content is correct; targets workflow additions remain in backlog. No CLI source changes, no doc drift. Ruff clean, mypy pre-existing only. https://claude.ai/code/session_01EXivvUkCK2QywPnLciQTfN

# Conflicts: # site-docs/cli/index.md # site-docs/cli/system.md # src/social_hook/cli/__init__.py

- Merge 90+ commits from develop (targets #69, reusability #70, logging #64) - Fix mkdocs.yml: replace deleted system.md with logs.md in nav - Regenerate CLI docs: improved descriptions for strategy, target, topics - Update pipeline.md: fix stale preview mode section for targets behavior - DOC_STATUS: add draft connect, rename system→logs, add recurring checks - All checks pass: ruff clean, mypy pre-existing only https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

Correct coverage ratings based on thorough audit: - Downgrade inspect (poor), decision/manual/strategy/target (partial) - Downgrade 7 draft subcommands from ok to partial - Add decision, inspect, manual groups to tracking table https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

- pipeline.md: downgrade to stale (missing two-stage eval, batch eval, per-strategy decisions, topic queues, targets vs legacy paths) - narrative-arcs.md: upgrade to partial (core concepts accurate, needs strategy-scoped arcs + episode_tags) - config.md: downgrade to stale (missing 9 config sections) - Add 3 new backlog items: CLI docstring enrichment (specific commands), config.md expansion, pipeline.md rewrite https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

nj-io · 2026-03-30T03:46:25Z

add docstring enrichment to your regular tasks
Update pipeline.md and narrative-arcs.md

…aft, strategy, target) Improve help text for commands identified as poor/partial in audit: - inspect: log, pending (poor→ok), usage, platforms (partial→ok) - decision: delete, list — explain what decisions are - manual: draft, consolidate, post — add LLM context and examples - draft: reject, reopen, unapprove, unschedule, edit, redraft, media-regen, media-edit — add state transitions and domain context - strategy: show — list displayed fields - target: enable — explain re-enable behavior https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

- Arcs now scoped to strategies via strategy field (3 per strategy, not per project) - episode_type → episode_tags (list of tags via CommitAnalysis) - EpisodePreferences uses favor/avoid lists https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

6 files updated: decision, draft, inspect, manual, strategy, target https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

- Add Stage 2 (Commit Analyzer): classification, episode tags, topic suggestions, trivial fast-path - Update diagram to show Analyzer → Evaluator two-stage flow - Document per-strategy decisions (StrategyDecisionInput), evaluation cycles, and overall decision derivation - Add interval gating, batch evaluation, and deferred commit flow - Update Stage 5 (Drafting) for target routing and preview mode - Add content topics and strategies to context assembly table - Update episode_type → episode_tags throughout - Renumber stages 1-9 to accommodate new Analyzer stage https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

- Upgrade 16 CLI commands from partial/poor to ok after enrichment - Mark pipeline.md and narrative-arcs.md as complete - Add 3 new recurring checks (docstrings, pipeline accuracy, episode_tags) - Mark docstring enrichment and pipeline.md rewrite as done in backlog https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

nj-io and others added 15 commits March 25, 2026 10:59

fix(docs-maintenance): clarify step 1 — always branch from latest tar…

58a7a78

…get branch Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

chore(docs-maintenance): rename "Waiting for review" to "Backlog" in …

35441ca

…PR template Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Merge branch 'develop' into docs-maintenance/maintenance-2026-03-25

7160971

docs: update DOC_STATUS — mark 9 CLI groups as enriched

4a13bcc

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs: add testing and E2E docs to backlog

214c36e

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Merge branch 'develop' into docs-maintenance/maintenance-2026-03-25

3c8d6cf

Merge branch 'develop' into docs-maintenance/maintenance-2026-03-25

cf5db9e

Merge branch 'develop' into docs-maintenance/maintenance-2026-03-25

8c04df9

# Conflicts: # site-docs/cli/index.md # site-docs/cli/system.md # src/social_hook/cli/__init__.py

claude added 5 commits March 30, 2026 03:51

docs: regenerate CLI reference docs with enriched docstrings

ded996a

6 files updated: decision, draft, inspect, manual, strategy, target https://claude.ai/code/session_014r2JHUkoesiZns77JwU5oc

nj-io merged commit eb11c6e into develop Mar 30, 2026
6 checks passed

nj-io mentioned this pull request Mar 31, 2026

chore(docs-maintenance): maintenance run 2026-03-31 #71

Merged

10 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore(docs-maintenance): maintenance run 2026-03-25#62

chore(docs-maintenance): maintenance run 2026-03-25#62
nj-io merged 21 commits intodevelopfrom
docs-maintenance/maintenance-2026-03-25

nj-io commented Mar 25, 2026 •

edited

Loading

Uh oh!

codecov-commenter commented Mar 25, 2026 •

edited

Loading

Uh oh!

nj-io commented Mar 30, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

nj-io commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

2026-03-30 run

2026-03-29 run

2026-03-28 run

Backlog (waiting for approval)

Completed this run

State

Uh oh!

codecov-commenter commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

nj-io commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

nj-io commented Mar 25, 2026 •

edited

Loading

codecov-commenter commented Mar 25, 2026 •

edited

Loading

nj-io commented Mar 30, 2026 •

edited

Loading