@spendgraph/cli 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+import type { Spendgraph } from "@spendgraph/sdk";
+import type { Parsed } from "./args.js";
+import type { Loaded } from "./env.js";
+/** What a command is handed: the client, the line it was called with, and the scope it runs in. */
+export interface Ctx {
+    sg: Spendgraph;
+    parsed: Parsed;
+    /** The resolved environment, and which `.env` fed it. */
+    loaded: Loaded;
+    /** A positional argument. Throws `UsageError` naming it when absent. */
+    need(index: number, name: string): string;
+    /** A positional argument, or undefined. */
+    arg(index: number): string | undefined;
+    /** A flag as text, or undefined where it was not passed. */
+    flag(name: string): string | undefined;
+    /** A flag as a boolean. A flag passed without a value is true. */
+    bool(name: string): boolean;
+    /** A flag as a number. Throws `UsageError` where it was passed but is not one. */
+    num(name: string): number | undefined;
+    /** A flag as a comma-separated list. */
+    list(name: string): string[] | undefined;
+    /** The project id, from `--project` or `SPENDGRAPH_PROJECT`. Throws where neither is set. */
+    project(): string;
+    /** `--project` where it was given, for a call that scopes rather than requires it. */
+    scope(): {
+        project?: string;
+    };
+    /**
+     * The request body: `--file`'s JSON with the flags named here laid over it.
+     *
+     * A flag always wins, so `--file base.json --name other` edits one field of a
+     * stored definition without restating the rest of it.
+     */
+    body(fromFlags: Record<string, unknown>): Record<string, unknown>;
+}
+/** One thing the CLI can do, and how to say it. */
+export interface Command {
+    name: string;
+    summary: string;
+    /** Positional arguments, as they appear in help. */
+    usage?: string;
+    /** True where the command never reaches the API, so it runs without credentials. */
+    local?: boolean;
+    run(ctx: Ctx): Promise<unknown>;
+}
+/** A resource, and the commands that act on it. */
+export interface Group {
+    name: string;
+    summary: string;
+    commands: Command[];
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@spendgraph/cli",
+  "version": "0.2.0",
+  "description": "Drive the spendgraph dashboard from a terminal: prompts, tools, projects, keys and spend.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fnLog0/spendgraph.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/fnLog0/spendgraph#readme",
+  "bugs": {
+    "url": "https://github.com/fnLog0/spendgraph/issues"
+  },
+  "keywords": [
+    "cli",
+    "llm",
+    "prompts",
+    "tools",
+    "spend"
+  ],
+  "type": "module",
+  "bin": {
+    "sg": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@spendgraph/sdk": "^0.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}