errcode

const (
	// RepoNotFound: working directory is not inside a git repo with an
	// `origin` remote, and no `--repo` flag was provided.
	RepoNotFound Code = "REPO_NOT_FOUND"

	// RepoFlagInvalid: the value passed to `--repo` does not match the
	// `<owner>/<name>` shape.
	RepoFlagInvalid Code = "REPO_FLAG_INVALID"

	// DataDirUnwritable: the resolved data directory cannot be created
	// or is not writable.
	DataDirUnwritable Code = "DATA_DIR_UNWRITABLE"

	// UnknownSubcommand: the user invoked a subcommand (or used a flag)
	// the CLI does not recognise.
	UnknownSubcommand Code = "UNKNOWN_SUBCOMMAND"

	// InternalError: unexpected internal failure (panic recovery, I/O
	// failure not anticipated by a more specific code).
	InternalError Code = "INTERNAL_ERROR"
)

const (
	// ConfigUnwritable: the resolved config file cannot be created, or
	// its parent directory is not writable.
	ConfigUnwritable Code = "CONFIG_UNWRITABLE"

	// ConfigInvalid: the config file parses as YAML but violates a
	// structural rule (e.g. a target with every sub-path set falsy).
	ConfigInvalid Code = "CONFIG_INVALID"

	// ConfigInvalidRepoURL: `repo-url` is not a remote git URL. Local
	// paths and `file://` URLs are rejected.
	ConfigInvalidRepoURL Code = "CONFIG_INVALID_REPO_URL"

	// ConfigKeyNotScriptable: `tai config set` was invoked on a nested
	// or array key. Use a dedicated subcommand or `tai config edit`.
	ConfigKeyNotScriptable Code = "CONFIG_KEY_NOT_SCRIPTABLE"

	// ConfigDuplicateTarget: `tai config target add` was invoked for a
	// `root` that already exists in the targets array.
	ConfigDuplicateTarget Code = "CONFIG_DUPLICATE_TARGET"

	// ConfigTargetNotFound: `tai config target remove` was invoked for a
	// `root` that does not exist in the targets array.
	ConfigTargetNotFound Code = "CONFIG_TARGET_NOT_FOUND"

	// ConfigEditorUnset: `tai config edit` was invoked with no $EDITOR
	// environment variable set.
	ConfigEditorUnset Code = "CONFIG_EDITOR_UNSET"

	// TaiNotConfigured: an operation requiring both `repo-url` and
	// `targets` was run with at least one missing.
	TaiNotConfigured Code = "TAI_NOT_CONFIGURED"

	// MissingArg: a subcommand was invoked with the wrong number of
	// positional arguments (typically too few). The user picked a real
	// verb; the error is about arity, not unrecognised input.
	//
	// Distinct from UnknownSubcommand (verb not in the registry) and
	// from CONFIG_KEY_NOT_SCRIPTABLE (key shape rejected). Exit code
	// is Usage (1).
	MissingArg Code = "MISSING_ARG"
)

const (
	// RepoFetchFailed: `git fetch` against the configured source repo
	// failed for reasons other than network-unreachable (e.g.
	// authentication, 4xx). Network-unreachable is handled implicitly
	// via the cache-fallback warning and does NOT surface as an error.
	RepoFetchFailed Code = "REPO_FETCH_FAILED"

	// RepoInitTargetNotEmpty: `tai repo init <path>` was invoked
	// against an existing directory that already contains files. The
	// scaffold refuses to overwrite — the user must delete or move the
	// existing contents.
	RepoInitTargetNotEmpty Code = "REPO_INIT_TARGET_NOT_EMPTY"

	// RepoInitGitUnavailable: `tai repo init` finished writing the
	// scaffold but `git` is not on PATH, so the auto `git init` +
	// initial commit step cannot run. Files remain on disk; the user
	// can run `git init` themselves once git is installed.
	RepoInitGitUnavailable Code = "REPO_INIT_GIT_UNAVAILABLE"
)

const (
	// WorkflowInvalid: a workflow YAML file under `<clone>/workflows/`
	// violates the schema (missing required fields, unknown top-level
	// key, `kind: agent`, reserved name `list`/`run`).
	WorkflowInvalid Code = "WORKFLOW_INVALID"

	// WorkflowNotFound: `tai workflow run <name>` was invoked for a
	// name that does not resolve to any loaded workflow.
	WorkflowNotFound Code = "WORKFLOW_NOT_FOUND"

	// StandardInvalid: a standard file under `<clone>/standards/`
	// uses a reserved name (`list`, `load`).
	StandardInvalid Code = "STANDARD_INVALID"

	// StandardNotFound: `tai standards load <name>` was invoked for a
	// name that does not resolve to any loaded standard.
	StandardNotFound Code = "STANDARD_NOT_FOUND"
)

const (
	// PluginUnknown: `tai plugins install <name>` was invoked for a
	// name that has no entry in the built-in first-party registry
	// AND no `--source` flag was supplied.
	PluginUnknown Code = "PLUGIN_UNKNOWN"

	// PluginNameReserved: the user attempted to install a plugin
	// whose name collides with a reserved top-level verb
	// (config, sync, repo, install-commands, workflow, standards,
	// plugins, help, version).
	PluginNameReserved Code = "PLUGIN_NAME_RESERVED"

	// PluginAssetNaming: a plugin's downloaded `assets/skills/` or
	// `assets/agents/` contains an entry whose name does not start
	// with the mandatory `tai-<plugin>-` prefix.
	PluginAssetNaming Code = "PLUGIN_ASSET_NAMING"

	// PluginFetchUnauthorized: the release-asset fetch returned 401
	// or 403. Distinct from PluginFetchFailed because the
	// remediation is specific: set $GITHUB_TOKEN (or the host's
	// equivalent credential env var).
	PluginFetchUnauthorized Code = "PLUGIN_FETCH_UNAUTHORIZED"

	// PluginFetchFailed: the release-asset fetch failed for a reason
	// other than auth (5xx, network unreachable, malformed asset).
	PluginFetchFailed Code = "PLUGIN_FETCH_FAILED"
)

const (
	// DBOpenFailed: the database file exists or can be created, but a
	// connection-level operation (open, pragma) failed.
	DBOpenFailed Code = "DB_OPEN_FAILED"

	// DBMigrationFailed: one or more migrations failed to apply; the
	// database is in its pre-migration state.
	DBMigrationFailed Code = "DB_MIGRATION_FAILED"

	// DBConstraintViolation: an insert or update violated a NOT NULL,
	// CHECK, UNIQUE, or foreign-key constraint.
	DBConstraintViolation Code = "DB_CONSTRAINT_VIOLATION"
)

const (
	// InstallTargetUnwritable: the install target directory cannot be
	// created or is not writable.
	InstallTargetUnwritable Code = "INSTALL_TARGET_UNWRITABLE"

	// InstallInvalidTarget: the value passed to --commands-dir is
	// malformed (empty string, traversal outside a writable area).
	InstallInvalidTarget Code = "INSTALL_INVALID_TARGET"

	// InstallLedgerCorrupt: an embedded ledger file failed to parse at
	// runtime.
	InstallLedgerCorrupt Code = "INSTALL_LEDGER_CORRUPT"
)

const (
	// ImportInvalidJSON: the stdin payload is not valid JSON.
	ImportInvalidJSON Code = "IMPORT_INVALID_JSON"

	// ImportSchemaInvalid: the stdin JSON parses but fails one or more
	// schema rules.
	ImportSchemaInvalid Code = "IMPORT_SCHEMA_INVALID"

	// ImportAmbiguousRefs: a comment's external_refs resolve to more
	// than one existing comment row.
	ImportAmbiguousRefs Code = "IMPORT_AMBIGUOUS_REFS"
)

const (
	// TriageNoScope: the current branch matches no PR and no branch row,
	// and no --pr/--branch was provided.
	TriageNoScope Code = "TRIAGE_NO_SCOPE"

	// TriageAmbiguousScope: the current branch matches both a
	// prs.head_branch and a branches.name row.
	TriageAmbiguousScope Code = "TRIAGE_AMBIGUOUS_SCOPE"

	// TriageNotFound: the referenced PR, branch, comment, or batch does
	// not exist in the resolved scope.
	TriageNotFound Code = "TRIAGE_NOT_FOUND"

	// TriageInvalidFlags: conflicting or missing flags on a triage verb
	// (e.g. --pr + --branch, missing --reason, --id + --batch).
	TriageInvalidFlags Code = "TRIAGE_INVALID_FLAGS"

	// TriageConfirmationRequired: tai forget was invoked non-
	// interactively without --yes or a truthy TAI_ACCEPT_DESTRUCTIVE.
	TriageConfirmationRequired Code = "TRIAGE_CONFIRMATION_REQUIRED"
)