Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,16 @@ Versions before 0.8.0 are in the [git tags](https://github.com/WireCatLabs/cli-b
Every entry says what changed as a caller sees it, why, and what to watch for — the rules are
[`docs/dev/CONVENTIONS.md`](docs/dev/CONVENTIONS.md#the-changelog).

## Unreleased

### Added

- **The words of a content CLI (posts on a site or blog).** `posts` and `channels` are resources, `stats` is a view
as well as the root command (`posts stats <post>`), and `--slug <slug>`, `--tags <ids>` and `--replace-body` have
their roles. cli-core's content commands use them, and reuse the words the vocabulary had: `--text-file`,
`--description`, `--at-time`, `--allow-delete`, `tags` and `users`. Before this, `cli-dev lint` refused a CLI made
from cli-core's content commands.

## 0.122.0 — 19.11.2026

### Added
Expand Down
19 changes: 19 additions & 0 deletions src/standards/flags-content.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
import type { VocabularyFlag } from "./vocabulary.js"

/** Posts and pages on a site or blog the owner publishes. */
export const CONTENT_FLAGS: VocabularyFlag[] = [
{ name: "--slug", value: "<slug>", role: "value", type: "string", meaning: "the last part of its web address" },
{
name: "--tags",
value: "<ids>",
role: "value",
type: "list",
meaning: "its tags and categories, by comma-separated ids; replaces the ones it has",
},
{
name: "--replace-body",
role: "mode",
type: "switch",
meaning: "write the new text over a body the tool cannot fully read back, losing what it could not show",
},
]
5 changes: 5 additions & 0 deletions src/standards/vocabulary.ts
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
import * as v from "valibot"
import { ACCOUNT_FLAGS } from "./flags-account.js"
import { CALENDAR_FLAGS } from "./flags-calendar.js"
import { CONTENT_FLAGS } from "./flags-content.js"
import { CRM_FLAGS } from "./flags-crm.js"
import { HOW_FLAGS } from "./flags-how.js"
import { KNOWLEDGE_FLAGS } from "./flags-knowledge.js"
Expand Down Expand Up @@ -256,6 +257,8 @@ const collections: [string, string][] = [
["messages", "posts in a messenger chat, or emails"],
["drafts", "e-mails saved in a mailbox's Drafts folder, written and not sent"],
["polls", "polls in a chat"],
["posts", "posts and pages on a site or blog the owner publishes"],
["channels", "the sites and social accounts the owner publishes posts on"],
["reactions", "reactions to a message"],
["recipients", "who a message goes to"],
["replies", "the automatic replies of a profile"],
Expand Down Expand Up @@ -387,6 +390,7 @@ const singulars: [string, string][] = [

const views: [string, string][] = [
["tree", "the parent and child hierarchy of stored sources"],
["stats", "a thing's own numbers, such as a post's views, as read at each sync"],
["logs", "the log of a running process"],
["events", "what happened in a thing over time"],
["scheduled", "what is scheduled to happen"],
Expand Down Expand Up @@ -463,5 +467,6 @@ export const VOCABULARY: Vocabulary = defineVocabulary({
...KNOWLEDGE_FLAGS,
...CRM_FLAGS,
...SCHEDULE_FLAGS,
...CONTENT_FLAGS,
],
})