CLI reference — Internal

Generated by bun run generate:cli-reference from spec/admin-api-openapi.json. Do not hand-edit — regenerate after refreshing the spec.

Every operation below is documented CLI-first (nayaone-admin api <operationId>) per PRD-407/DO-7. The REST /admin-api/* method+path is the fallback/alternative integration option.

17 operations in this area.

internalAllocatePulumiCloudResourceId

Allocate (or fetch existing) n1CloudResourceId for a Pulumi stack/name pair (PRD-245 Phase M.3).

CLI (preferred):

nayaone-admin api internalAllocatePulumiCloudResourceId --body '{}'

REST fallback: POST /admin-api/internal/pulumi/allocate-cloud-resource-id

internalDeletePulumiStackState

Purge a Pulumi stack’s mirror projection (pulumi_stack_state + pulumi_stack_resource + R2 mirror) from the D1 oracle (PRD-350 M29).

CLI (preferred):

nayaone-admin api internalDeletePulumiStackState --param project=<project> --param stack=<stack> --body '{}'

REST fallback: DELETE /admin-api/internal/pulumi-state/stacks/{project}/{stack}

internalGetPulumiDriftCounts

Aggregate drift counts (intent_only / state_only / mismatch) for the /admin/health chip.

CLI (preferred):

nayaone-admin api internalGetPulumiDriftCounts

REST fallback: GET /admin-api/internal/pulumi-state/drift/counts

internalGetPulumiStackDetail

Read a single Pulumi stack state from the D1 oracle projection (PRD-241 Phase C-api).

CLI (preferred):

nayaone-admin api internalGetPulumiStackDetail --param project=<project> --param stack=<stack>

REST fallback: GET /admin-api/internal/pulumi-state/stacks/{project}/{stack}

internalGetPulumiStackFreshness

Batch lookup of last writeback timestamp + resource_count per stack (PRD-241 Phase F).

CLI (preferred):

nayaone-admin api internalGetPulumiStackFreshness --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/freshness

internalListOrphanOrgStacks

List n1-orgs Pulumi-state stacks in R2 and flag those whose org is absent from D1 (PRD-359).

CLI (preferred):

nayaone-admin api internalListOrphanOrgStacks

REST fallback: GET /admin-api/internal/pulumi-state/orphan-org-stacks

internalListPulumiDrift

List cloud_resource ↔ pulumi_stack_resource drift rows by kind (PRD-241 Phase E).

CLI (preferred):

nayaone-admin api internalListPulumiDrift

REST fallback: GET /admin-api/internal/pulumi-state/drift

internalListPulumiKnownStacks

List all known Pulumi stacks (project_id + stack_name pairs)

CLI (preferred):

nayaone-admin api internalListPulumiKnownStacks

REST fallback: GET /admin-api/internal/pulumi-state/known-stacks

internalListPulumiStackResources

Cross-stack browse over pulumi_stack_resource projection (PRD-241 Phase C-api).

CLI (preferred):

nayaone-admin api internalListPulumiStackResources

REST fallback: GET /admin-api/internal/pulumi-state/stacks

internalListPulumiStackResourcesSsrm

AG Grid Enterprise Server-Side Row Model contract over pulumi_stack_resource (PRD-241 Phase C-ui).

CLI (preferred):

nayaone-admin api internalListPulumiStackResourcesSsrm --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/stacks/ssrm

internalPruneOrphanOrgStacks

Prune verify-empty orphan n1-orgs Pulumi-state stacks from R2 (PRD-359). Dry-run by default.

CLI (preferred):

nayaone-admin api internalPruneOrphanOrgStacks --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/orphan-org-stacks/prune

internalReconcileIntentTombstones

Tombstone alive cloud_resource rows that no live Pulumi state row matches (PRD-369 intent_only).

CLI (preferred):

nayaone-admin api internalReconcileIntentTombstones --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/reconcile/intent-tombstones

internalReconcileOracleProjection

Backfill the Oracle projection: project every id-bearing Pulumi resource into cloud_resource (PRD-369).

CLI (preferred):

nayaone-admin api internalReconcileOracleProjection --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/reconcile/projection

internalReconcileSoftDeletedBoxTunnels

Delete orphaned Cloudflare tunnels + tombstone their mirror rows for soft-deleted boxes (PRD-369 H.6).

CLI (preferred):

nayaone-admin api internalReconcileSoftDeletedBoxTunnels --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/reconcile/softdeleted-box-tunnels

internalReconcileStackGoneNullUrnTombstones

Tombstone alive NULL-pulumi_urn cloud_resource rows whose stack has no live state (PRD-369 null-urn destroy-orphan).

CLI (preferred):

nayaone-admin api internalReconcileStackGoneNullUrnTombstones --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/reconcile/stackgone-nullurn-tombstones

internalRecordCloudOrphanCensus

Record a fleet-reaper cloud-orphan census sweep (PRD-369 Phase D/E).

CLI (preferred):

nayaone-admin api internalRecordCloudOrphanCensus --body '{}'

REST fallback: POST /admin-api/internal/pulumi/orphan-census

internalSubmitPulumiStateWriteback

Write Pulumi stack state into the D1 oracle projection (PRD-241 Phase B).

CLI (preferred):

nayaone-admin api internalSubmitPulumiStateWriteback --body '{}'

REST fallback: POST /admin-api/internal/pulumi-state/writeback