Adding Commands
Add a Custy CLI command while preserving option, model, resolver, core, registration, and test boundaries.
Add a Custy CLI command while preserving option, model, resolver, core, registration, and test boundaries.
Implement, register, order, compose, and test one focused Custy pipeline step.
Add and integrate a Custy version-tag strategy across the protocol, CLI enum, workflow dispatch, tests, and documentation.
Review experimental changelog properties that are loaded but not yet applied by the active pipeline.
Find every generated or actively supported Custy configuration property by full TOML path.
Understand Custy's active runtime layers, dependency flow, subsystem boundaries, and architectural trade-offs.
Configure which message backups Custy cleans and how many recent files it keeps.
Configure layered prefix, merge-state, age, and date filters for branch cleanup.
Configure breaking-change enablement, keyword detection, and the rendered section label.
Configure command-level changelog generation behavior.
Navigate every content and rendering table under tool.custy.changelog.
Trace Custy's active changelog flow from Git ranges and message providers through semantic processing, release planning, Jinja rendering, and file output.
Resolve missing or duplicate entries, incorrect release ranges, noisy grouping, pending-content limitations, broken links, template errors, and unexpected output.
Preview layered Custy branch filters before deleting matching local and remote branches.
Configure presentation-only removal of separators, headings, summaries, metadata, and keywords.
Navigate backup retention and branch-selection configuration.
Navigate every table under tool.custy.cli.
Trace Custy's Typer entrypoints, command registration, global context, argument resolution, and core delegation.
Find every active Custy root command, command group, subcommand, entrypoint, and documentation route.
Find the supported Custy commands for project setup, validation, versioning, changelogs, Git operations, and pipelines.
Understand how focused CLI commands, ordered pipeline profiles, and Custy's experimental workflow command differ.
Choose Custy, Commitizen, automatic discovery, or basic Git message-file checks.
Reference all 20 Custy resolver profiles, their consumers, availability, and exact expanded steps.
Understand how Custy creates, loads, owns, and safely replaces project configuration.
Navigate every Custy configuration namespace, table, property, default, and implementation status.
Reference Custy's project-owned TOML root, namespaces, precedence, lifecycle, cache boundary, and implementation-status language.
Understand how Custy resolves explicit CLI values, project configuration, and built-in defaults.
Trace Custy configuration from packaged initialization resources through TOML loading, precedence, typed subsystem models, and runtime consumers.
Resolve missing or invalid TOML, wrong working directories, unexpected precedence, stale cached values, path errors, templates, and initialization replacements.
Configure console threshold, Rich presentation, timestamps, levels, and formatting.
Prepare a focused, tested, documented, and reviewable contribution to Custy.
Configure merge-commit and Conventional Commit type exclusion before changelog processing.
Understand Custy's orchestration and domain subsystems, their responsibilities, dependencies, and current coupling.
Understand how Custy merges public profiles, removes duplicate steps, and enforces global order.
Automate repeatable Git, versioning, changelog, backup, cleanup, and release workflows from one configurable CLI.
Set up Custy for development, understand its extension points, test changes, and prepare focused contributions.
Understand the exact Dev profile phases, side effects, omissions, and recovery boundary.
Prepare a Python 3.14+ environment, install Custy in editable mode, and verify contributor tools.
See which Custy release this documentation represents, when it was reviewed, and how to compare another installed version.
Preview supported Custy mutations while allowing discovery, validation, and resolution to continue.
Configure editor precedence for commit and tag message review on local hosts and inside containers.
Reference Custy's runtime tools, working-directory assumptions, external editor behavior, theme variables, Git authentication boundary, and terminal compatibility.
Reference Custy's current success, usage, explicit exit, validation, pipeline, Git, configuration, cleanup, and unexpected-error behavior.
Use Custy's Dev profile safely for reviewed commit-and-branch-push work.
Configure cross-command preview, force, debugging, staging, and validation defaults.
Follow how Custy resolves, builds, and executes a pipeline and how failures are handled.
Carry a new Custy setting from the packaged TOML template through resolution, runtime use, tests, and documentation.
Configure Custy's persistent rotating log file, size, retention, and format.
Understand Release plus Custy's experimental post-push branch workflow finalization.
Install Custy, prepare an existing Git repository, and preview your first development pipeline safely.
Choose safe native or direct pre-commit execution for local and container workflows.
Trace Custy's Git factory, executor protocol, high-level service, result models, dry-run boundary, tag sorting, and consumers.
Navigate service-level remote groups and push strategy under tool.custy.git.
Configure service-level main, backup, or all selection and understand reserved auto-push behavior.
Configure Custy's default remote plus primary and optional backup remote groups.
Resolve repository detection, staging, commit, tag, remote, authentication, push, branch, and cleanup problems safely.
Reference Custy's root options, aliases, placement, configuration resolution, defaults, and current exit behavior.
Configure Custy's default overwrite and confirmation behavior during project initialization.
Navigate Custy's Rich console and rotating file logging configuration.
Create, verify, retain, clean, and restore Custy's commit and tag message backups.
Configure the version source used by Custy commands.
Reference Custy's project configuration, templates, version file, changelog, backups, logs, packaged resources, and working-directory behavior.
Configure whether and how the project commit-message file joins generated history.
Understand Custy's profiles, expansion, global ordering, step registry, builders, shared context, and sequential execution.
Understand Custy's public profiles, execution model, safety boundaries, and extension points.
Reference Custy's six public Run profiles, direct-command profiles, internal composition profiles, step counts, and ordering rules.
Prepare, preview, publish, and verify a versioned Custy release without treating it as one atomic action.
Configure the primary Custy project source directory.
Compare the six public Custy Run profiles and navigate the complete 20-profile resolver catalog.
Configure direct and pipeline push defaults under tool.custy.cli.push.
Use concise, source-aligned indexes for Custy's CLI, global options, configuration, version formats, pipeline profiles, paths, environment, and exit behavior.
Understand how Custy's Release profile progresses from preflight validation to versioning, changelog generation, commit, tag, and push.
Understand generated release metadata and its current compatibility boundary.
Understand Custy's complete validated version, changelog, commit, tag, and push sequence.
Configure release extraction plus hidden, title-only, and custom-message behavior per version.
Configure all 28 changelog visibility, layout, formatting, sorting, and visual properties.
Configure the repository base URL and version-comparison link generation.
Understand Custy's effective-value priority and how documentation status maps to implementation.
Classify Custy's local, Git, interactive, and remote effects and review a practical execution checklist.
Map commit scopes and Conventional Commit types to reader-facing changelog labels.
Reference every STEP_ORDER priority and understand when Custy sorts merged profiles.
Developer guide to Custy's BaseStep, registry, builder, shared context, ordering, and tests.
Understand Custy's separate strategies for generating version tags, sorting existing tags, and converting version formats.
Configure retained commit-message and tag-message backup locations.
Configure changelog, commit-message, and tag-message file paths.
Navigate Custy's configured template files and backup directories.
Choose focused Custy tests, understand the suite layers, and run complete validation before review.
Diagnose Custy failures from the first symptom, inspect current state, correct the smallest cause, and verify recovery safely.
Recover safely by identifying the last successful Custy effect before retrying a command or profile.
Complete common Custy tasks safely, from daily development and releases to backups, branch cleanup, and recovery.
Reference Custy's SemVer, PEP 440, Commitizen, date, and Git-count forms, stage detection, basic conversion, generation, and sorting boundaries.
Understand how Custy resolves a release version, prepares artifacts, updates project files, and later creates a Git tag.
Configure version strategy, bump behavior, and optional date-tag formatting.
Resolve missing version files, invalid strategies, unexpected formats, conversion limits, Commitizen failures, tag conflicts, and unapplied updates.
Configure the experimental workflow command's enforcement, transition, and backup defaults.
Understand WorkflowConfig, WorkflowEngineBuilder, service construction, phase methods, runtime state, and finalization behavior.
Resolve rejected profiles, normalized ordering, validation stops, partial pipelines, inactive option adapters, failed publication, and experimental workflow behavior.