@axtary/cli 0.0.1

package/README.md

@@ -0,0 +1,35 @@
+# @axtary/cli
+
+Axtary local CLI for deterministic proxy demos.
+
+This package is private workspace code while `axtary proxy --config axtary.yml` is being shaped.
+
+## Commands
+
+```sh
+axtary demo --config axtary.yml --json
+axtary proxy --config axtary.yml
+axtary smoke --config axtary.yml
+axtary test-policy --config axtary.yml --fixtures examples/policy-fixtures
+```
+
+- `demo` loads config, creates an ephemeral signing key, runs fake GitHub, Slack, Linear, and Jira actions through the proxy, writes the local JSONL ledger, and prints a structured result.
+- `proxy` starts a long-running local HTTP enforcement point with `GET /health`, `GET /state`, and `POST /actions`. It uses fake SaaS adapters by default and can route GitHub, Slack, Linear, AWS, GCP, and local docs actions when their adapter modes are enabled. File-backed configs are cached and policy is reloaded when `axtary.yml` changes.
+- `smoke` validates configured providers without writes: GitHub REST calls `/user`, Slack Web calls `auth.test`, Linear GraphQL queries `viewer`, AWS calls STS `GetCallerIdentity`, GCP checks project access, and local docs checks configured roots.
+- `test-policy` evaluates JSON fixtures against the loaded YAML policy and fails when an expected decision or reason differs.
+
+## Real Provider Smoke Test
+
+Set adapter modes and token environment variables in `axtary.yml`, then run:
+
+```sh
+GITHUB_TOKEN=... SLACK_BOT_TOKEN=... LINEAR_API_KEY=... \
+AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=... GCP_ACCESS_TOKEN=... \
+  axtary smoke --config axtary.yml
+```
+
+Fake adapters are skipped. Missing token environment variables, provider auth failures, or missing local docs roots return a non-zero exit code.
+
+## Design Notes
+
+The CLI currently proves the local product loop. Real provider modes are opt-in through config and read tokens from configured environment variables, so demos remain deterministic and do not accidentally touch production providers.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runAxtaryCli } from "./index.js";
+process.exitCode = await runAxtaryCli();
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,CAAC,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+import { type JsonValue, type AxtaryDecision } from "@axtary/actionpass";
+import { type FakeAdapterState } from "@axtary/adapters";
+import { type LedgerExport, type LedgerExportFormat, type LedgerSyncResult } from "@axtary/ledger";
+import { type ProxyHandleResult } from "@axtary/proxy";
+export declare const DEMO_SCHEMA_VERSION = "axtary.demo.v0";
+export declare const POLICY_TEST_SCHEMA_VERSION = "axtary.policy_test.v0";
+export declare const LOCAL_PROXY_SCHEMA_VERSION = "axtary.local_proxy.v0";
+export declare const LEDGER_EXPORT_RUN_SCHEMA_VERSION = "axtary.ledger_export_run.v0";
+export declare const LEDGER_SYNC_RUN_SCHEMA_VERSION = "axtary.ledger_sync_run.v0";
+export type DemoRunInput = {
+    configPath?: string;
+    ledgerPath?: string;
+    cwd?: string;
+};
+export type ProxyServerInput = DemoRunInput & {
+    host?: string;
+    port?: number;
+};
+export type ProxyServerHandle = {
+    schemaVersion: typeof LOCAL_PROXY_SCHEMA_VERSION;
+    url: string;
+    host: string;
+    port: number;
+    ledgerPath: string;
+    adapters: FakeAdapterState;
+    adapterModes: {
+        github: "fake" | "rest";
+        slack: "fake" | "web";
+        linear: "fake" | "graphql";
+        aws: "off" | "rest";
+        gcp: "off" | "rest";
+        docs: "off" | "local";
+        mcp: "fixture";
+    };
+    close: () => Promise<void>;
+};
+export type PolicyFixture = {
+    name?: string;
+    action: unknown;
+    expectedDecision: "allow" | "deny" | "step_up";
+    expectedReasons?: string[];
+};
+export type PolicyFixtureResult = {
+    filePath: string;
+    name: string;
+    passed: boolean;
+    expectedDecision: string;
+    actualDecision: string;
+    expectedReasons: string[] | null;
+    actualReasons: string[];
+};
+export type PolicyTestRunInput = {
+    configPath?: string;
+    fixturesPath: string;
+    cwd?: string;
+};
+export type PolicyTestRunResult = {
+    schemaVersion: typeof POLICY_TEST_SCHEMA_VERSION;
+    config: {
+        filePath: string | null;
+        policyVersion: string;
+    };
+    fixturesPath: string;
+    passed: boolean;
+    total: number;
+    failed: number;
+    results: PolicyFixtureResult[];
+};
+export type DemoActionResult = {
+    name: string;
+    tool: string;
+    status: ProxyHandleResult["status"];
+    decision: string | null;
+    reasons: string[];
+    actionPassId: string | null;
+    ledgerLine: number | null;
+    result: JsonValue | null;
+};
+export type DemoRunResult = {
+    schemaVersion: typeof DEMO_SCHEMA_VERSION;
+    config: {
+        filePath: string | null;
+        issuer: string;
+        tenant: string;
+    };
+    ledgerPath: string;
+    results: DemoActionResult[];
+    adapters: FakeAdapterState;
+    adapterModes: {
+        github: "fake";
+        slack: "fake";
+        linear: "fake";
+        aws: "off";
+        gcp: "off";
+        mcp: "fixture";
+    };
+    ledger: {
+        valid: boolean;
+        records: number;
+        lastLedgerHash: string | null;
+        failure: string | null;
+    };
+};
+export type CliIo = {
+    stdout?: (text: string) => void;
+    stderr?: (text: string) => void;
+    cwd?: string;
+};
+type SmokeTestInput = DemoRunInput & {
+    env?: Record<string, string | undefined>;
+    fetch?: typeof fetch;
+};
+export type LedgerExportRunInput = DemoRunInput & {
+    from?: string;
+    to?: string;
+    decisions?: AxtaryDecision[];
+    outputPath?: string;
+    format?: LedgerExportFormat;
+};
+export type LedgerExportRunResult = {
+    schemaVersion: typeof LEDGER_EXPORT_RUN_SCHEMA_VERSION;
+    config: {
+        filePath: string | null;
+        tenant: string;
+    };
+    ledgerPath: string;
+    outputPath: string | null;
+    format: LedgerExportFormat;
+    export: LedgerExport;
+};
+export type LedgerSyncRunInput = LedgerExportRunInput & {
+    endpoint: string;
+    tenant?: string;
+    tokenEnv?: string;
+    env?: Record<string, string | undefined>;
+    fetch?: typeof fetch;
+};
+export type LedgerSyncRunResult = {
+    schemaVersion: typeof LEDGER_SYNC_RUN_SCHEMA_VERSION;
+    config: {
+        filePath: string | null;
+        tenant: string;
+    };
+    ledgerPath: string;
+    endpoint: string;
+    sync: LedgerSyncResult;
+};
+export declare function startProxyServer(input?: ProxyServerInput): Promise<ProxyServerHandle>;
+export declare function runDemo(input?: DemoRunInput): Promise<DemoRunResult>;
+export declare function runSmokeTest(input?: SmokeTestInput, io?: CliIo): Promise<number>;
+export declare function runTestPolicy(input: PolicyTestRunInput): Promise<PolicyTestRunResult>;
+export declare function runLedgerExport(input?: LedgerExportRunInput): Promise<LedgerExportRunResult>;
+export declare function runLedgerSync(input: LedgerSyncRunInput): Promise<LedgerSyncRunResult>;
+export declare function runAxtaryCli(argv?: string[], io?: CliIo): Promise<number>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}