Skip to content

Connect the Blog and Notes apps to the commands that drive them - #331

Merged
allenhutchison merged 2 commits into
mainfrom
claude/project-thread-6xx6ha
Nov 21, 2026
Merged

allenhutchison merged 2 commits into
mainfrom
claude/project-thread-6xx6ha

Conversation

@allenhutchison

@allenhutchison allenhutchison commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Requested by Allen · project thread

Human overview

A session copying a blog into a room posted the first article as a chat message, because nothing in the help said that a blog post is a room note. This adds a Blog section to pepper agents guide, a hint under Notes and Blog in pepper rooms show, a line in the notes help, a plainer message from pepper apps run <app> when the app names no actions, and a Blog entry in help/cli.md. Closes #330.

AI reviewer

Details for agents: what the diff does, invariants, verification, checklist
  • data/agent-skill/SKILL.md: new ### Blog posts subsection at the end of section 8. It says a post is a room note (name = title, body = Markdown with no frontmatter or title heading), an article never goes in a chat message, an agent drafts by editing a note a member made (it cannot create one, section 9), publishing/withdrawing/listing posts is an owner's step in the Blog app with no CLI command, that publishing a note again updates its post, and that an import should list the room's notes first because creating a note never dedupes by name. It also says a post's date is the day it is published. The drift guard requires that outside section 9 the document present no command an agent token can't run, so note creation and apps run are described in prose there, not as invocations.
  • render.py: APP_HINTS, keyed by app key, printed dim under an installed app in rooms show. Only notes and blog have hints. Apps without an entry print nothing extra.
  • cli.py: the notes help names the Notes and Blog apps. apps run SLUG with no action now prints the "owner-scoped only" note only when the list is non-empty, and a "names no actions, don't guess" line when it is empty. The --json output is unchanged.
  • help/cli.md: a Blog posts bullet, inside <!-- rollout: blog --> so the public docs leave it out while the feature is gated.
  • Not in scope: CLI commands that publish posts. They need server work first, which will get its own issue.

Verification: uv run pytest -q -n auto passed with 3533 passed and 2 skipped (run before the help/cli.md edit, which is Markdown only). After that edit, tests/test_docs_push.py passed with 9 tests, and ruff format --check, ruff check and ty check src/pepper_cli/ were clean.

Checklist (repo-specific)

  • uv run ruff format --check and uv run ruff check clean (no new lint ignores)
  • uv run ty check src/pepper_cli/ clean
  • uv run pytest passes; coverage floor in .claude/maintainerd.json not lowered
  • Server-contract changes: N/A, no wire change
  • No token or credential is logged, printed, or put in a fixture
  • README and the bundled SKILL.md updated if commands or output changed
  • Help: help/cli.md updated

Generated by Claude Code

RetriggerView in GreptileConfidence Score: 5/5

The PR appears safe to merge; the previous help issue is fixed and no new actionable issues were found.

Summary

The PR explains that Blog posts start as room notes and that owners publish them in the Blog app.

  • Blog posts now follow the room-note path, with an owner publishing them in the Blog app.
  • App listings explain when the server names no actions.

Reviews (2) · Last reviewed commit: "Show the notes help in pepper notes --he..." · Reviewed by Greptile

The agent guide gains a Blog posts section: a post is a room note, an
article never goes in a chat message, publishing is an owner's step in
the Blog app, and an import should skip titles already there. rooms show
prints a hint under Notes and Blog, the notes help names the apps built
on it, and apps run with no action says plainly when an app names none.

Closes #330

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QNDeh8UnNXHotbcjuA9MbM
@vycari-review

vycari-review Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

Vycari Review: Vycari Review did not publish a review of ca882db: it could not be reviewed in time (the daily review budget is spent, so Vycari Review did not run on this commit). See the check run; the next push or sweep retries.
Results below are from round 1 on 473070b.

Vycari Review

Round 1 on 473070b. The verdict is the Vycari Review check run, and each open finding is an inline thread. Reply on every P0 and P1 thread: Fixed in <sha>, or Disputed: with a reason. P2s are the author's call: fix one, or reply Deferred: #<issue> (the PR's one follow-up issue) or Declined: with a reason, and VR stops re-raising it. From round 2 on, VR raises no new P2s: it checks the fixes and looks for P0s and P1s.

Open: P0 0 · P1 0 · P2 0 · disputed 0 · confirmed fixed 0 · withdrawn 0

Hand-off: Greptile requested on 473070b.

No open findings this round.

P2s, judge's notes and closed findings

Judge's notes

All 2 candidate findings were refuted.

@allenhutchison allenhutchison self-assigned this Nov 20, 2026
@vycari-review

vycari-review Bot commented Nov 20, 2026

Copy link
Copy Markdown

@greptileai review

Comment thread src/pepper_cli/cli.py Resolved
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QNDeh8UnNXHotbcjuA9MbM
@vycari-review

vycari-review Bot commented Nov 20, 2026

Copy link
Copy Markdown

@greptileai review

@allenhutchison
allenhutchison added this pull request to the merge queue Nov 21, 2026
Merged via the queue into main with commit 7bcaaa2 Nov 21, 2026
5 checks passed
@allenhutchison
allenhutchison deleted the claude/project-thread-6xx6ha branch November 21, 2026 00:15
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.

Help doesn't connect a room's Blog and Notes apps to the commands that drive them

2 participants