Interfaces
CLI
amalgament-harness is the local operator CLI. Read commands open the database read-only and accept --as-of.
Set up
| Command | Arguments | What it does |
|---|---|---|
demo-init |
database |
Create a synthetic business and local demo accounts |
bootstrap |
database username business |
Create a local owner and first business |
install-contract |
database business owner contract |
Install a contract (owner only) |
validate |
contract |
Validate a contract and its scenarios |
diff-contracts |
before after |
Show structural changes; not migration compatibility |
principal-id |
database username |
Resolve a username to a principal ID |
serve |
database |
Run the local service and web workspace |
serve takes --host, --port, --models, --adapters, --model-user-hour, --model-business-day, --synthetic-pulls and --demo-gateway.
Read
status, discover, object, objects, links, evaluate, query, survey and sample take the database, business and principal ID. See Inspect with the CLI.
Sources
| Command | What it does |
|---|---|
authorize-source / revoke-source |
Allow, or end, the investigation of one loopback source |
onboard-synthetic |
Preview or apply a complete loopback source mapping |
install-synthetic-pull |
Install a fixed loopback source mapping; no pull runs |
schedule-synthetic-pull |
Schedule bounded, atomic pulls |
inspect-synthetic-pull |
Show pull runs and evidence |
preview-suppressed-pull / resume-suppressed-pull |
Review and resume a paused source |
Integrity
| Command | What it does |
|---|---|
verify |
Verify the event chain |
anchor / verify-anchor |
Export and check a signed checkpoint |
backup / check-backup / restore |
Back up, check and restore a database |
clear-stale-lock |
Clear a stale writer lease after a crash |
erase-payloads |
Owner-only payload retention |
bind-oidc |
Bind a user to an OIDC issuer and subject |