scope-demo / where

where - cli-guard examples/scope

NAME

where - print the resolved commit scope

SYNOPSIS

where

DESCRIPTION

Prints the resolved scope path for the current invocation. Useful for an agent verifying that --commit-scope will resolve correctly before invoking a verb that produces an audit row.

Examples:

# inside a git repo, default --commit-scope=auto
cd /path/to/some/repo
scope-demo where
# scope: /path/to/some/repo

# outside any git repo, default auto fails
cd /tmp
scope-demo where
# error: scope: cwd is not inside a git repo
# exit: 1

# explicit path overrides cwd
cd /tmp
scope-demo --commit-scope=/path/to/some/repo where
# scope: /path/to/some/repo

# explicit path that is not a git repo fails
scope-demo --commit-scope=/tmp where
# error: scope: /tmp is not inside a git repo
# exit: 1

# env var when flag is at default
COILY_COMMIT_SCOPE=/path/to/some/repo scope-demo where
# scope: /path/to/some/repo

Read this command as a preflight: if where succeeds, every subsequent verb in this shell binds to the same scope. If it fails, fix the scope BEFORE running a real verb so you don't burn an audit-row slot on a misconfigured call.

Usage:

where [GLOBAL OPTIONS] [command [COMMAND OPTIONS]] [ARGUMENTS...]