@tryaura/aura-cli 0.1.0

package/dist/types-DmBu6g0d.d.ts

@@ -0,0 +1,84 @@
+import { AuraConfigurationLayer, AuraPlugin, Environment, TelemetrySink } from "@tryaura/aura-sdk";
+import { Readable, Writable } from "node:stream";
+//#region src/types.d.ts
+/** Process status produced by every Aura CLI command. */
+type CliExitCode = 0 | 1 | 2 | 3;
+/** Distribution-controlled names and help metadata. */
+interface CliBranding {
+  /** Executable name shown in command usage. */
+  readonly command: string;
+  /** Product name shown in human-readable output. */
+  readonly displayName: string;
+  /** Short product description shown in top-level help. */
+  readonly description?: string | undefined;
+  /** Documentation link shown alongside human-readable reports. */
+  readonly docsUrl?: string | undefined;
+  /** Distribution version exposed through `--version`. */
+  readonly version?: string | undefined;
+}
+/** Distribution-owned plugin registry policy exposed without leaking Aura's private core package. */
+interface CliRegistryOptions {
+  /** Plugins allowed to contribute bare check ids such as `INS-001`. */
+  readonly bareCheckIdPlugins?: readonly string[] | undefined;
+}
+/** Build-time composition of one Aura distribution. */
+interface CliDistro {
+  readonly branding: CliBranding;
+  /** Data-only defaults applied below a selected team preset. */
+  readonly defaults?: AuraConfigurationLayer | undefined;
+  /** Bundled preset reference used when neither the workspace nor user selected one. */
+  readonly defaultPreset?: string | undefined;
+  readonly plugins: readonly AuraPlugin[];
+  /**
+   * Registry policy this distribution grants its own plugins, such as bare check ids.
+   *
+   * Distribution-owned rather than plugin-owned: the grant is only meaningful because `plugins` is
+   * a build-time list this distribution controls.
+   */
+  readonly registry?: CliRegistryOptions | undefined;
+  /**
+   * Where run events are sent. Absent, telemetry is a no-op and the run records nothing.
+   *
+   * The sink can never fail a run: throws are swallowed, and the final flush is bounded. The user
+   * always wins over the distribution — `DO_NOT_TRACK` or `AURA_TELEMETRY=off` in the invoking
+   * environment disables the sink outright.
+   */
+  readonly telemetry?: TelemetrySink | undefined;
+}
+/**
+ * Injectable process boundary used by tests and embedding applications.
+ *
+ * Every ambient value the run depends on is listed here. An embedder that supplies all of them gets
+ * a run that reads nothing from the surrounding process.
+ */
+interface CliRuntime {
+  /** Command arguments without the executable and script path. */
+  readonly argv?: readonly string[] | undefined;
+  /**
+   * Color depth reported to the command framework.
+   *
+   * Defaults to what the terminal supports, honouring `NO_COLOR` and `FORCE_COLOR`. Always no color
+   * when `stdout` is injected, since the destination is then not a terminal Aura can ask.
+   */
+  readonly colorDepth?: number | undefined;
+  /** Directory the command was invoked from. */
+  readonly cwd?: string | undefined;
+  /** Base environment inherited by probes. */
+  readonly environmentVariables?: Readonly<Record<string, string | undefined>> | undefined;
+  /** Base home directory before a `--home` override. Defaults to the operating-system home. */
+  readonly homeDir?: string | undefined;
+  /**
+   * Network access for the run. Defaults to the kernel's bounded TLS-only client; the testkit
+   * injects a loopback-only variant so no test run can reach beyond the machine.
+   */
+  readonly httpGet?: Environment["httpGet"] | undefined;
+  /** Clock used to stamp telemetry events. Defaults to the system clock. */
+  readonly now?: (() => Date) | undefined;
+  readonly stderr?: Writable | undefined;
+  readonly stdin?: Readable | undefined;
+  readonly stdout?: Writable | undefined;
+  /** Receives the final code. Defaults to setting `process.exitCode`. */
+  readonly setExitCode?: ((exitCode: CliExitCode) => void) | undefined;
+}
+//#endregion
+export { CliRuntime as a, CliRegistryOptions as i, CliDistro as n, CliExitCode as r, CliBranding as t };

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@tryaura/aura-cli",
+  "version": "0.1.0",
+  "description": "The composable Aura CLI runtime and official plugin distribution.",
+  "keywords": [
+    "agent",
+    "aura",
+    "cli",
+    "plugin"
+  ],
+  "homepage": "https://github.com/tryaura/aura/tree/main/packages/cli#readme",
+  "bugs": "https://github.com/tryaura/aura/issues",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tryaura/aura.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "aura": "./dist/bin/aura.js"
+  },
+  "files": [
+    "content",
+    "dist",
+    "schema"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "default": "./dist/plugins/index.js"
+    },
+    "./schema/check-output-v1.json": "./schema/check-output-v1.schema.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "clipanion": "3.2.1",
+    "diff": "9.0.0",
+    "ignore": "7.0.6",
+    "semver": "7.8.5",
+    "smol-toml": "1.8.0",
+    "string-width": "4.2.3",
+    "toml-eslint-parser": "^1.0.3",
+    "typanion": "3.14.0",
+    "undici": "7.29.0",
+    "@tryaura/aura-sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "ajv": "8.20.0",
+    "vitest": "4.1.10",
+    "@tryaura/adapter-claude-code": "0.0.0",
+    "@tryaura/adapter-cursor": "0.0.0",
+    "@tryaura/checks-core": "0.0.0",
+    "@tryaura/adapter-codex": "0.0.0",
+    "@tryaura/content-official": "0.0.0",
+    "@tryaura/core": "0.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsdown && tsdown --config tsdown.types.config.ts",
+    "typecheck": "tsc --noEmit && tsc --project tsconfig.type-tests.json"
+  }
+}

package/schema/check-output-v1.schema.json

@@ -0,0 +1,261 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://tryaura.sh/schemas/check-output-v1.schema.json",
+  "title": "Aura check JSON output v1",
+  "oneOf": [{ "$ref": "#/$defs/report" }, { "$ref": "#/$defs/explanation" }],
+  "$defs": {
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["errors", "informational", "passed", "warnings"],
+      "properties": {
+        "errors": { "type": "integer", "minimum": 0 },
+        "informational": { "type": "integer", "minimum": 0 },
+        "passed": { "type": "integer", "minimum": 0 },
+        "warnings": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "layer"],
+      "properties": {
+        "label": { "type": "string" },
+        "layer": { "enum": ["cli", "default", "distro", "manifest", "preset"] }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "categories",
+        "diagnostics",
+        "errors",
+        "exitCode",
+        "informational",
+        "passed",
+        "warnings"
+      ],
+      "properties": {
+        "categories": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/counts" }
+        },
+        "diagnostics": { "type": "integer", "minimum": 0 },
+        "errors": { "type": "integer", "minimum": 0 },
+        "exitCode": { "enum": [0, 1, 2, 3] },
+        "informational": { "type": "integer", "minimum": 0 },
+        "passed": { "type": "integer", "minimum": 0 },
+        "warnings": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "message", "phase"],
+      "properties": {
+        "detail": { "type": "string" },
+        "id": { "type": "string" },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "phase": { "enum": ["check", "detect", "files", "fix", "parse", "read", "support"] }
+      }
+    },
+    "support": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "supportedRange"],
+      "properties": {
+        "status": { "enum": ["supported", "unknown", "unsupported"] },
+        "supportedRange": { "type": "string" },
+        "version": { "type": "string" }
+      }
+    },
+    "app": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["appId", "detection", "displayName"],
+      "properties": {
+        "appId": { "type": "string" },
+        "detection": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["installed"],
+          "properties": {
+            "authenticated": { "type": "boolean" },
+            "installed": { "type": "boolean" },
+            "version": { "type": "string" }
+          }
+        },
+        "detectionScope": { "type": "string" },
+        "displayName": { "type": "string" },
+        "support": { "$ref": "#/$defs/support" }
+      }
+    },
+    "location": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path"],
+      "properties": {
+        "column": { "type": "integer", "minimum": 1 },
+        "line": { "type": "integer", "minimum": 1 },
+        "path": { "type": "string" }
+      }
+    },
+    "presentation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["columns", "kind", "rowsKey"],
+      "properties": {
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["heading", "key"],
+            "properties": {
+              "align": { "enum": ["left", "right"] },
+              "falseLabel": { "type": "string" },
+              "format": { "enum": ["boolean", "integer", "percentage", "text"] },
+              "heading": { "type": "string" },
+              "key": { "type": "string" },
+              "trueLabel": { "type": "string" }
+            }
+          }
+        },
+        "kind": { "const": "metadata-table" },
+        "rowsKey": { "type": "string" }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["checkId", "findingId", "fixability", "message", "scope", "severity"],
+      "properties": {
+        "checkId": { "type": "string" },
+        "details": { "type": "string" },
+        "findingId": { "type": "string" },
+        "fixability": { "enum": ["auto", "guided", "manual"] },
+        "locations": { "type": "array", "items": { "$ref": "#/$defs/location" } },
+        "message": { "type": "string" },
+        "metadata": { "type": "object" },
+        "presentation": { "$ref": "#/$defs/presentation" },
+        "scope": { "enum": ["global", "project"] },
+        "severity": { "enum": ["error", "info", "warn"] }
+      }
+    },
+    "fixOperation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["effect", "paths"],
+      "properties": {
+        "conflict": { "type": "string" },
+        "diff": { "type": "string" },
+        "effect": {
+          "enum": ["archive", "conflict", "create", "move", "noop", "remove", "symlink", "update"]
+        },
+        "paths": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "fix": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["checkId", "findingId", "manualSteps", "operations", "status", "summary"],
+      "properties": {
+        "checkId": { "type": "string" },
+        "findingId": { "type": "string" },
+        "manualSteps": { "type": "array", "items": { "type": "string" } },
+        "message": { "type": "string" },
+        "operations": { "type": "array", "items": { "$ref": "#/$defs/fixOperation" } },
+        "status": { "enum": ["applied", "failed", "partial", "planned"] },
+        "summary": { "type": "string" }
+      }
+    },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "apps",
+        "diagnostics",
+        "findings",
+        "kind",
+        "passedChecks",
+        "schemaVersion",
+        "status",
+        "summary"
+      ],
+      "properties": {
+        "apps": { "type": "array", "items": { "$ref": "#/$defs/app" } },
+        "diagnostics": { "type": "array", "items": { "$ref": "#/$defs/diagnostic" } },
+        "findings": { "type": "array", "items": { "$ref": "#/$defs/finding" } },
+        "fixes": { "type": "array", "items": { "$ref": "#/$defs/fix" } },
+        "kind": { "const": "check-report" },
+        "passedChecks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "title"],
+            "properties": {
+              "id": { "type": "string" },
+              "title": { "type": "string" }
+            }
+          }
+        },
+        "schemaVersion": { "const": 1 },
+        "status": { "enum": ["clean", "empty", "error", "operational-error", "warning"] },
+        "summary": { "$ref": "#/$defs/summary" }
+      }
+    },
+    "explanation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "explain",
+        "fixability",
+        "fixesApplicable",
+        "id",
+        "kind",
+        "provenance",
+        "schemaVersion",
+        "scope",
+        "severity",
+        "thresholds",
+        "title"
+      ],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "explain": { "type": "string" },
+        "fixability": { "enum": ["auto", "guided", "manual"] },
+        "fixesApplicable": { "type": "boolean" },
+        "id": { "type": "string" },
+        "kind": { "const": "check-explanation" },
+        "preset": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["name", "reference"],
+          "properties": {
+            "name": { "type": "string" },
+            "reference": { "type": "string" }
+          }
+        },
+        "provenance": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["enabled", "severity", "thresholds"],
+          "properties": {
+            "enabled": { "$ref": "#/$defs/provenance" },
+            "severity": { "$ref": "#/$defs/provenance" },
+            "thresholds": { "$ref": "#/$defs/provenance" }
+          }
+        },
+        "schemaVersion": { "const": 1 },
+        "scope": { "enum": ["global", "project"] },
+        "severity": { "enum": ["error", "info", "warn"] },
+        "thresholds": { "type": "object" },
+        "title": { "type": "string" }
+      }
+    }
+  }
+}