cli-surface-sync

Name: cli-surface-sync
Author: vepo

Keep CLI flags, exit codes, and user docs in sync

by vepo(0) 0 installs

Free

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Instruction file imported from vepo/csvi (.cursor/rules/cli-surface-sync.mdc). Copyright stays with the author.

CLI surface sync

When adding or changing flags, exit codes, or commands, update all of these in the same change:

Artifact	What to update
`src/bin/main.c`	`getopt_long` options, `usage()`, validation
`src/lib/common/errors.h`	New `CSVI_EXIT_*` constants
`man/csvi.1`	OPTIONS, COMMANDS, EXIT STATUS
`docs/tutorial.md`	CLI options, exit codes, user workflows
`docs/architecture.md`	CLI surface and exit-code tables
`Commands.md`	Key bindings and `:` commands (if changed)

Boundaries

Only main.c returns process exit codes (return CSVI_EXIT_*).
Library functions return int status or NULL; main or csvi_viewer_* maps them to exit codes.
--help and --version write to stdout; errors and --verbose diagnostics go to stderr.

Do not add CLI flags without updating the man page.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/vepo-csvi-cli-surface-sync-rule/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

vepo-csvi-cli-surface-sync-rule.ocm.jsonjson

{
  "ocm": "1",
  "id": "vepo-csvi-cli-surface-sync-rule",
  "kind": "skill",
  "name": "cli-surface-sync",
  "description": "Keep CLI flags, exit codes, and user docs in sync",
  "publisher": "vepo",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github-cursor-rules"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Keep CLI flags, exit codes, and user docs in sync"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github-cursor-rules",
      "repository": "https://github.com/vepo/csvi",
      "path": ".cursor/rules/cli-surface-sync.mdc",
      "ref": "b3c96ce956ab02d3f82a63d213dd6656c29d113d",
      "url": "https://github.com/vepo/csvi/blob/b3c96ce956ab02d3f82a63d213dd6656c29d113d/.cursor/rules/cli-surface-sync.mdc",
      "key": "vepo/csvi/.cursor/rules/cli-surface-sync.mdc"
    },
    "applies_to": "src/bin/**,man/**,Commands.md,src/lib/common/errors.h"
  },
  "instructions": "# CLI surface sync\n\nWhen adding or changing flags, exit codes, or commands, update **all** of these in the same change:\n\n| Artifact | What to update |\n|----------|----------------|\n| `src/bin/main.c` | `getopt_long` options, `usage()`, validation |\n| `src/lib/common/errors.h` | New `CSVI_EXIT_*` constants |\n| `man/csvi.1` | OPTIONS, COMMANDS, EXIT STATUS |\n| `docs/tutorial.md` | CLI options, exit codes, user workflows |\n| `docs/architecture.md` | CLI surface and exit-code tables |\n| `Commands.md` | Key bindings and `:` commands (if changed) |\n\n## Boundaries\n\n- Only `main.c` returns process exi",
  "cost": {
    "context_tokens": 219
  }
}

Fetch it by URL: GET /api/v1/registry/vepo-csvi-cli-surface-sync-rule/manifest?version=1.0.0

About

CLI surface sync

Boundaries

Use it

Manifest

Reviews