CLI Commands

Overview

Usage: repotype [options] [command]

Repository schema validation, scaffolding, fix, and service runtime

Options:
  -V, --version                             output the version number
  -h, --help                                display help for command

Commands:
  validate [options] [target]
  report [options] [target]
  fix [options] [target]
  cleanup-run [options] [target]
  install-checks [options]
  install-watcher [options]

Commands

validate

Validate repository against rules

repotype validate repotype validate [options] [target]

Options:

Flag	Description
`--json`	emit machine-readable JSON (default: false)
`--config <path>`	explicit config file path (repotype.yaml) (default: "")
`-h,`	—help display help for command

Full help output

Usage: repotype validate [options] [target]

Arguments:
  target           file or directory to validate (default: ".")

Options:
  --json           emit machine-readable JSON (default: false)
  --config <path>  explicit config file path (repotype.yaml) (default: "")
  -h, --help       display help for command

fix

Auto-fix violations

repotype fix repotype fix [options] [target]

Options:

Flag	Description
`--config <path>`	explicit config file path (repotype.yaml) (default: "")
`-h,`	—help display help for command

Full help output

Usage: repotype fix [options] [target]

Arguments:
  target           file or directory to validate/fix (default: ".")

Options:
  --config <path>  explicit config file path (repotype.yaml) (default: "")
  -h, --help       display help for command

report

Generate compliance reports

repotype report repotype report [options] [target]

Options:

Flag	Description
`--json`	emit machine-readable JSON report (default: false)
`--format <format>`	report format: markdown
`--config <path>`	explicit config file path (repotype.yaml) (default: "")
`--output <file>`	write report to file
`-h,`	—help display help for command

Full help output

Usage: repotype report [options] [target]

Arguments:
  target             file or directory to report on (default: ".")

Options:
  --json             emit machine-readable JSON report (default: false)
  --format <format>  report format: markdown | json | html (default:
                     "markdown")
  --config <path>    explicit config file path (repotype.yaml) (default: "")
  --output <file>    write report to file
  -h, --help         display help for command

explain

Explain rules for a specific file

repotype explain repotype explain [options] <file>

Options:

Flag	Description
`--json`	emit machine-readable JSON (default: false)
`--config <path>`	explicit config file path (repotype.yaml) (default: "")
`-h,`	—help display help for command

Full help output

Usage: repotype explain [options] <file>

Arguments:
  file             file path

Options:
  --json           emit machine-readable JSON (default: false)
  --config <path>  explicit config file path (repotype.yaml) (default: "")
  -h, --help       display help for command

init

Initialize repotype.yaml config

repotype init repotype init [options] [target]

Options:

Flag	Description
`--type <type>`	preset type: default
`--from <path>`	external YAML config to copy as repotype.yaml
`--force`	overwrite existing repotype.yaml if present (default: false)
`-h,`	—help display help for command

Full help output

Usage: repotype init [options] [target]

Initialize repotype.yaml from generic preset or external source

Arguments:
  target         target directory for repotype.yaml (default: ".")

Options:
  --type <type>  preset type: default|strict (default: "default")
  --from <path>  external YAML config to copy as repotype.yaml
  --force        overwrite existing repotype.yaml if present (default: false)
  -h, --help     display help for command

status

Show operations status

repotype status repotype status [options] [target]

Options:

Flag	Description
`--json`	emit machine-readable JSON (default: false)
`-h,`	—help display help for command

Full help output

Usage: repotype status [options] [target]

Arguments:
  target      repository path (default: ".")

Options:
  --json      emit machine-readable JSON (default: false)
  -h, --help  display help for command

apply

Apply operations (hooks, watcher)

repotype apply repotype apply [options] [target]

Options:

Flag	Description
`--json`	emit machine-readable JSON (default: false)
`-h,`	—help display help for command

Full help output

Usage: repotype apply [options] [target]

Arguments:
  target      repository path (default: ".")

Options:
  --json      emit machine-readable JSON (default: false)
  -h, --help  display help for command

scaffold

Generate files from templates

repotype scaffold repotype scaffold [options] <templateId> <output>

Options:

Flag	Description
`--set <kv>`	template variable key=value (default: [])
`-h,`	—help display help for command

Full help output

Usage: repotype scaffold [options] <templateId> <output>

Arguments:
  templateId  template id from repotype.yaml
  output      output file path

Options:
  --set <kv>  template variable key=value (default: [])
  -h, --help  display help for command

cleanup-run

Move severely invalid files to queue

repotype cleanup-run repotype cleanup-run [options] [target]

Options:

Flag	Description
`--queue <dir>`	sort queue directory (default: “sort_queue”)
`--min-errors <n>`	minimum error count before moving file (default: “3”)
`--dry-run`	show what would be moved without moving files (default:
`--json`	emit machine-readable JSON (default: false)
`-h,`	—help display help for command

Full help output

Usage: repotype cleanup-run [options] [target]

Arguments:
  target            file or directory to validate/cleanup (default: ".")

Options:
  --queue <dir>     sort queue directory (default: "sort_queue")
  --min-errors <n>  minimum error count before moving file (default: "3")
  --dry-run         show what would be moved without moving files (default:
                    false)
  --json            emit machine-readable JSON (default: false)
  -h, --help        display help for command

install-checks

Install git hooks

repotype install-checks repotype install-checks [options]

Options:

Flag	Description
`--hook <hook>`	pre-commit
`--target <dir>`	repository path (default: ”.”)
`-h,`	—help display help for command

Full help output

Usage: repotype install-checks [options]

Options:
  --hook <hook>   pre-commit | pre-push | both (default: "both")
  --target <dir>  repository path (default: ".")
  -h, --help      display help for command

install-watcher

Install file watcher

repotype install-watcher repotype install-watcher [options]

Options:

Flag	Description
`--target <dir>`	repository path (default: ”.”)
`--schedule <cron>`	cron schedule expression (default: ”/15 * * *“)
`--queue <dir>`	sort queue directory (default: “sort_queue”)
`--min-errors <n>`	minimum errors before moving file (default: “3”)
`--log-file <file>`	watcher stdout/stderr log file (default:
`--dry-run`	print cron line without writing crontab (default: false)
`-h,`	—help display help for command

Full help output

Usage: repotype install-watcher [options]

Options:
  --target <dir>     repository path (default: ".")
  --schedule <cron>  cron schedule expression (default: "*/15 * * * *")
  --queue <dir>      sort queue directory (default: "sort_queue")
  --min-errors <n>   minimum errors before moving file (default: "3")
  --log-file <file>  watcher stdout/stderr log file (default:
                     ".repotype/logs/watcher.log")
  --dry-run          print cron line without writing crontab (default: false)
  -h, --help         display help for command

generate schema

Generate schema from existing files

repotype generate schema repotype generate schema [options] <target> <output>

Options:

Flag	Description
`--pattern <glob>`	glob pattern when target is a directory (default:
`-h,`	—help display help for command

Full help output

Usage: repotype generate schema [options] <target> <output>

Arguments:
  target            file or directory to infer frontmatter schema from
  output            output JSON schema path

Options:
  --pattern <glob>  glob pattern when target is a directory (default:
                    "**/*.md")
  -h, --help        display help for command

plugins status

Show plugin status

repotype plugins status repotype plugins status [options] [target]

Options:

Flag	Description
`--json`	emit machine-readable JSON (default: false)
`-h,`	—help display help for command

Full help output

Usage: repotype plugins status [options] [target]

Arguments:
  target      repository path (default: ".")

Options:
  --json      emit machine-readable JSON (default: false)
  -h, --help  display help for command

plugins install

Install plugin dependencies

repotype plugins install repotype plugins install [options] [target]

Options:

Flag	Description
`--json`	emit machine-readable JSON (default: false)
`-h,`	—help display help for command

Full help output

Usage: repotype plugins install [options] [target]

Arguments:
  target      repository path (default: ".")

Options:
  --json      emit machine-readable JSON (default: false)
  -h, --help  display help for command

serve

Start HTTP API server

repotype serve repotype serve [options]

Options:

Flag	Description
`--port <port>`	service port (default: “4310”)
`--cwd <cwd>`	service working directory (default:
`-h,`	—help display help for command

Full help output

Usage: repotype serve [options]

Options:
  --port <port>  service port (default: "4310")
  --cwd <cwd>    service working directory (default:
                 "/Users/saiterminal/git/supernal/families/supernal-coding/packages/repotype")
  -h, --help     display help for command

Global Options

These options work with all commands:

Flag	Description
`--help`	Show help for command
`--version`	Show version number
`--json`	Output in JSON format

Exit Codes

Code	Meaning
`0`	Success
`1`	Validation errors found
`2`	Configuration or runtime error