{"_id":"@arelis-ai/governance-cli","name":"@arelis-ai/governance-cli","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@arelis-ai/governance-cli","version":"1.0.0","description":"Arelis CLI - DevOps & Infrastructure Orchestration Tool for governed AI systems","type":"module","bin":{"arelis":"dist/index.js"},"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"dependencies":{"commander":"^12.0.0","@inquirer/prompts":"^5.0.0","execa":"^9.0.0","fs-extra":"^11.2.0","handlebars":"^4.7.8","undici":"^6.0.0","zod":"^3.23.0","picocolors":"^1.0.0","tsx":"^4.0.0","@arelis-ai/governance-audit":"1.0.0","@arelis-ai/governance-core":"1.0.0","@arelis-ai/governance-policy":"1.0.0","@arelis-ai/governance-storage-postgres":"1.0.0","@arelis-ai/governance-sinks-http":"1.0.0"},"devDependencies":{"@prisma/client":"^5.10.0","@testcontainers/postgresql":"^10.0.0","@types/fs-extra":"^11.0.0","@types/node":"^20.0.0","testcontainers":"^10.0.0","tsup":"^8.0.0","typescript":"^5.4.0","vitest":"^1.2.0","@arelis-ai/governance-models":"1.0.0","@arelis-ai/governance-providers-aws-bedrock":"1.0.0","@arelis-ai/governance-providers-azure-openai":"1.0.0","@arelis-ai/governance-providers-google-vertex":"1.0.0","@arelis-ai/governance-providers-huggingface":"1.0.0"},"keywords":["arelis","cli","ai","governance","infrastructure","devops"],"engines":{"node":">=20.0.0"},"license":"UNLICENSED","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"scripts":{"build":"tsup","dev":"tsx src/index.ts","lint":"eslint src --ext .ts","lint:fix":"eslint src --ext .ts --fix","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","typecheck":"tsc --noEmit"},"_id":"@arelis-ai/governance-cli@1.0.0","_integrity":"sha512-UrFPuCWutkSSD2WdfgcALWYQz7RbggnO5ebqi4/vql8YpLVAAplxt2MDB0A/20eJCAZ+gf+Erd4IY6OCzPri3Q==","_resolved":"/tmp/083cfe152364e691313fa08412ec1030/arelis-ai-governance-cli-1.0.0.tgz","_from":"file:arelis-ai-governance-cli-1.0.0.tgz","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-UrFPuCWutkSSD2WdfgcALWYQz7RbggnO5ebqi4/vql8YpLVAAplxt2MDB0A/20eJCAZ+gf+Erd4IY6OCzPri3Q==","shasum":"2d0813d1b44a79d833ca36335dc30231ee9af323","tarball":"https://registry.npmjs.org/@arelis-ai/governance-cli/-/governance-cli-1.0.0.tgz","fileCount":5,"unpackedSize":872097,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDBxYlFQev3meD/OyxWhUk9ahjwdyWkukgNvD7EP7MEUAiEA5eBdWcfnhuQU3TugsJYNmHzCPyvHZ2+U810/byCXfpk="}]},"_npmUser":{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"},"directories":{},"maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/governance-cli_1.0.0_1771423339258_0.35158205801195086"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-18T14:02:19.137Z","1.0.0":"2026-02-18T14:02:19.443Z","modified":"2026-02-18T14:02:19.672Z"},"maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"description":"Arelis CLI - DevOps & Infrastructure Orchestration Tool for governed AI systems","keywords":["arelis","cli","ai","governance","infrastructure","devops"],"license":"UNLICENSED","readme":"# @arelis-ai/governance-cli\n\nCommand-line tool for bootstrapping, provisioning, connecting, validating, and diagnosing AI infrastructure and services used by the Arelis SDK runtime.\n\n## Installation\n\n```bash\nnpm install -g @arelis-ai/governance-cli\n# or\npnpm add -g @arelis-ai/governance-cli\n# or\nyarn global add @arelis-ai/governance-cli\n```\n\n## Quick Start\n\n```bash\n# Initialize a new Arelis project\narelis init\n\n# Connect to control plane\narelis connect\n\n# Validate configuration\narelis validate\n\n# Run diagnostics\narelis doctor\n```\n\n## Commands\n\n### Core Commands\n\n| Command             | Description                                 |\n| ------------------- | ------------------------------------------- |\n| `arelis init`       | Initialize a new Arelis project             |\n| `arelis connect`    | Connect to Arelis control plane             |\n| `arelis provision`  | Provision infrastructure via IaC            |\n| `arelis validate`   | Validate configuration and connectivity     |\n| `arelis doctor`     | Run diagnostics and get remediation hints   |\n| `arelis config`     | View and manage configuration               |\n| `arelis status`     | Summarize config, auth, and endpoint health |\n| `arelis destroy`    | Destroy provisioned infrastructure          |\n| `arelis completion` | Generate shell completions                  |\n\n### Auth Commands\n\n| Command              | Description                                 |\n| -------------------- | ------------------------------------------- |\n| `arelis auth login`  | Store control plane credentials for CLI use |\n| `arelis auth logout` | Remove stored credentials                   |\n| `arelis auth status` | Show auth status                            |\n| `arelis auth whoami` | Show local CLI identity context             |\n\n### Domain Commands\n\n| Command                 | Description                        |\n| ----------------------- | ---------------------------------- |\n| `arelis mcp add`        | Add an MCP server to configuration |\n| `arelis mcp list`       | List configured MCP servers        |\n| `arelis mcp test`       | Test MCP server connectivity       |\n| `arelis knowledge add`  | Add a knowledge base               |\n| `arelis knowledge list` | List configured knowledge bases    |\n| `arelis knowledge test` | Test knowledge base connectivity   |\n| `arelis models test`    | Test model provider endpoint       |\n| `arelis agents run`     | Run a single-step agent prompt     |\n\n### Config Commands\n\n| Command                            | Description                   |\n| ---------------------------------- | ----------------------------- |\n| `arelis config get <path>`         | Read a configuration value    |\n| `arelis config set <path> <value>` | Update a configuration value  |\n| `arelis config patch <json>`       | Patch configuration with JSON |\n\n### Provider Commands\n\n| Command                     | Description                           |\n| --------------------------- | ------------------------------------- |\n| `arelis hf auth login`      | Configure HuggingFace authentication  |\n| `arelis hf endpoint create` | Create HuggingFace Inference Endpoint |\n| `arelis aws auth status`    | Check AWS credentials                 |\n| `arelis aws provision`      | Provision AWS infrastructure          |\n| `arelis gc auth login`      | Configure Google Cloud authentication |\n| `arelis gc provision`       | Provision GCP infrastructure          |\n| `arelis azure auth login`   | Configure Azure authentication        |\n| `arelis azure provision`    | Provision Azure infrastructure        |\n\n## Global Flags\n\n| Flag                | Description                                    |\n| ------------------- | ---------------------------------------------- |\n| `--config <path>`   | Override config file location                  |\n| `--json`            | Output in JSON format                          |\n| `--output <format>` | Output format (text, json, yaml, table, sarif) |\n| `--verbose`         | Detailed output                                |\n| `--no-color`        | Plain output without colors                    |\n| `--yes`             | Auto-confirm prompts                           |\n| `--dry-run`         | Print actions without executing                |\n| `--profile <name>`  | Select configuration profile                   |\n\n## Configuration\n\nArelis CLI uses `arelis.config.ts` (or `.json`) for project configuration. It also supports profile-specific overrides and layered configs:\n\n- Project base: `arelis.config.ts` / `arelis.config.json`\n- Project profile: `arelis.config.<profile>.ts` / `arelis.config.<profile>.json`\n- Local overrides: `.arelis/config.json` (and `.arelis/config.<profile>.json`)\n- Global overrides: `~/.config/arelis/config.json` (or `%APPDATA%/arelis/config.json` on Windows)\n\n```typescript\nimport type { ArelisProjectConfig } from '@arelis-ai/governance-cli';\n\nconst config: ArelisProjectConfig = {\n  project: {\n    name: 'my-ai-app',\n    environment: 'prod',\n  },\n  controlPlane: {\n    endpoint: 'https://aims.company.com',\n    apiKeyRef: 'env:ARELIS_API_KEY',\n  },\n  audit: {\n    sink: 'http',\n    endpoint: 'https://audit.company.com/ingest',\n    mode: 'hash',\n  },\n  telemetry: {\n    otelEndpoint: 'http://otel-collector:4318',\n    serviceName: 'my-ai-app',\n  },\n  models: {\n    defaultRoute: 'primary',\n    providers: {\n      huggingface: [\n        {\n          id: 'support-llm',\n          kind: 'hf-inference-endpoint',\n          endpoint: 'https://xxx.endpoints.huggingface.cloud',\n          authRef: 'env:HUGGINGFACE_TOKEN',\n          governance: {\n            dataResidency: 'EU',\n            lifecycle: 'approved',\n          },\n        },\n      ],\n    },\n  },\n};\n\nexport default config;\n```\n\n## Plugins\n\nLoad plugins by listing them in your config or via `ARELIS_PLUGINS`:\n\n```json\n{\n  \"cli\": {\n    \"plugins\": [\"@arelis-ai/governance-cli-plugin-example\"]\n  }\n}\n```\n\nPlugins may register additional commands and validation checks by exporting a default plugin object.\n\n## Secret References\n\nArelis CLI never stores secrets directly. Instead, use references:\n\n| Format           | Example                       | Description          |\n| ---------------- | ----------------------------- | -------------------- |\n| `env:VAR`        | `env:ARELIS_API_KEY`          | Environment variable |\n| `file:/path`     | `file:/etc/secrets/token`     | File path            |\n| `vault:path#key` | `vault:secret/arelis#api_key` | HashiCorp Vault (v1) |\n\n## Infrastructure as Code\n\nThe CLI supports multiple IaC tools:\n\n### Terraform\n\n```bash\narelis provision --iac terraform --stack audit-pipeline --cloud aws\n```\n\n### CDK\n\n```bash\narelis aws provision audit-pipeline --iac cdk\n```\n\n### Helm\n\n```bash\narelis provision --iac helm --stack otel-collector\n```\n\n## Provider Integration\n\n### HuggingFace\n\n```bash\n# Login\narelis hf auth login\n\n# Create endpoint\narelis hf endpoint create \\\n  --name support-llm \\\n  --repo my-org/model \\\n  --region eu \\\n  --instance nvidia-a10g\n\n# Check status\narelis hf endpoint status support-llm\n```\n\n### AWS\n\n```bash\n# Check credentials\narelis aws auth status\n\n# Provision infrastructure\narelis aws provision audit-pipeline --iac cdk --region us-east-1\n\n# Deploy model\narelis aws deploy sagemaker --model s3://bucket/model.tar.gz\n\n# Register endpoint\narelis aws register --id my-model --endpoint https://...\n```\n\n### Google Cloud\n\n```bash\n# Login\narelis gc auth login\n\n# Check status\narelis gc auth status\n\n# Provision infrastructure\narelis gc provision audit-pipeline --iac terraform --project my-project\n\n# Deploy model\narelis gc deploy vertex --name my-model\n```\n\n### Azure\n\n```bash\n# Login\narelis azure auth login\n\n# Check status\narelis azure auth status\n\n# Provision infrastructure\narelis azure provision audit-pipeline --iac bicep\n\n# Deploy model\narelis azure deploy azure-ml --name my-model\n```\n\n## CI/CD Integration\n\n```yaml\n# .github/workflows/validate.yml\nname: Validate Arelis Config\non: [push, pull_request]\njobs:\n  validate:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - run: npm install\n      - run: npx arelis validate --json\n        env:\n          ARELIS_API_KEY: ${{ secrets.ARELIS_API_KEY }}\n```\n\n## Exit Codes\n\n| Code | Description                                    |\n| ---- | ---------------------------------------------- |\n| 0    | Success                                        |\n| 1    | Error (validation failure, connectivity issue) |\n\n## Development\n\n```bash\n# Build\npnpm build\n\n# Test\npnpm test\n\n# Lint\npnpm lint\n\n# Type check\npnpm typecheck\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-b6246763da7f3b2a284e8540d1ed1378"}