cli

func APICommand ¶

func APICommand() *cli.Command

APICommand returns the api command group.

func CohortCommand ¶

func CohortCommand() *cli.Command

CohortCommand returns the cohort command group.

func ConvertCommand ¶

func ConvertCommand() *cli.Command

ConvertCommand returns the convert command.

func DedupCommand ¶ added in v0.39.0

func DedupCommand() *cli.Command

DedupCommand returns the `pulse dedup` leaf: retro-dedup an EXISTING single-file cohort into a grouped (format 0x02) cohort — the existing-cohort twin of `pulse import <fmt> --group`.

It is its own top-level leaf, beside `pulse widen`, for the reasons widen is: `.pulse` is never a convert SOURCE, so there is no `.pulse` → `.pulse` conversion for it to be a mode of, and an in-place rewrite earns a name a reader cannot mistake for a read. It is not an import mode either — import reads a tabular SOURCE, and the point of retro-dedup is that the source may be gone.

All behaviour is pulse.Dedup; this leaf parses flags, calls it once and formats the report.

func ErrorsCommand ¶ added in v0.5.0

func ErrorsCommand() *cli.Command

ErrorsCommand returns the errors command group. Two leaves:

• `pulse errors lookup CODE [--json]`
• `pulse errors list [--domain D] [--query Q] [--json]`

Both wrap the errors-package lookup surface. CODE detail (Message + Fixup hints) lives behind the lookup tool rather than the bootstrap manifest, so per-session context stays lean.

func ExamplesCommand ¶ added in v0.5.0

func ExamplesCommand() *cli.Command

ExamplesCommand returns the examples command group. Two leaves:

• `pulse examples search [--query Q] [--tag T] [--category C] [--json]`
• `pulse examples show NAME [--json]`

Both wrap the embedded request-example library (examples package).

func ExportCommand ¶

func ExportCommand() *cli.Command

ExportCommand returns the export command group.

func ImportCommand ¶

func ImportCommand() *cli.Command

ImportCommand returns the import command group.

func IndexCommand ¶ added in v0.27.0

func IndexCommand() *cli.Command

IndexCommand returns the `pulse index` command group covering point-lookup sidecar index management: `build`, `list`, `verify`, `drop` — mirroring the `pulse shard` subcommand tree's leaf shape.

func MCPCommand ¶ added in v0.2.0

func MCPCommand(version string) *cli.Command

MCPCommand returns the mcp command leaf. Running it serves the MCP protocol over stdio so AI clients (Claude Desktop, Claude Code, etc.) can discover and call Pulse tools. version is the build identity, threaded into both the advertised server Implementation.Version and the adapter Config.

func ProfileCommand ¶ added in v0.2.0

func ProfileCommand() *cli.Command

ProfileCommand returns the `pulse profile` command group.

func SchemaCommand ¶ added in v0.23.0

func SchemaCommand() *cli.Command

SchemaCommand returns the schema command. It prints the bundled JSON Schema (draft 2020-12) describing every public Pulse payload — the request envelopes and the universal output Envelope. The artifact is a self-contained JSON Schema document (it carries its own $schema/$id), so it is emitted raw rather than wrapped in the descriptor Envelope.

This is the offline equivalent of fetching the published file at the $id URL or the pulse://schema MCP resource. CLI is a thin adapter: the schema is built by descriptor.BuildPayloadSchema().

func ShardCommand ¶ added in v0.8.0

func ShardCommand() *cli.Command

ShardCommand returns the `pulse shard` command group covering archive create / add / remove / list / compact / verify / extract. Shard mutations use the atomic temp+rename pattern so partial writes never appear at the canonical archive path.

func SkillsCommand ¶

func SkillsCommand() *cli.Command

SkillsCommand returns the skills command group.

func SynthCommand ¶ added in v0.2.0

func SynthCommand() *cli.Command

SynthCommand returns the `pulse synth` command group.

func WidenCommand ¶ added in v0.38.0

func WidenCommand() *cli.Command

WidenCommand returns the `pulse widen` leaf: widen one set column of a single-file cohort to a wider set rung, rewriting the cohort in place.

It is its own top-level leaf rather than a mode of `pulse convert` because `.pulse` is reserved on the import side — a legal convert TARGET, never a convert SOURCE (io/format.SupportedImport) — so there is no `.pulse` → `.pulse` conversion for a widen to ride on. It is also not a `pulse cohort` subcommand for the same reason `pulse index` is not: this mutates the cohort file itself, and a destructive in-place rewrite earns a name a reader cannot mistake for a read.

All of the behaviour is pulse.WidenSetField: layout dispatch, the refusal policy and the atomic temp/fsync/rename rewrite. This leaf parses three flags, calls it once, and formats the report.

func WriteJSONPublic ¶

func WriteJSONPublic(w io.Writer, data any) error

WriteJSONPublic is the exported version of writeJSON for use from main.