@karmaniverous/stan-cli 0.8.0

package/dist/types/index.d.ts

@@ -0,0 +1,60 @@
+import { ContextConfig } from '@karmaniverous/stan-core';
+
+/**
+ * Render a help footer that lists available script keys and examples. *
+ * @param cwd - Repo root (or descendant) used to locate `stan.config.*`.
+ * @returns Multi‑line string (empty when config cannot be loaded).
+ *
+ * Notes:
+ * - Examples reflect the new flags (`-s`, `-x`, `-q`) and defaults (run all + archives).
+ * - When `STAN_DEBUG=1`, logs the reason configuration could not be loaded.
+ */
+declare const renderAvailableScriptsHelp: (cwd: string) => string;
+
+/**
+ * Script selection:
+ * - `string[]` selects the listed keys,
+ * - `null` denotes “all configured scripts”.
+ */
+type Selection = string[] | null;
+/** Execution strategy for running scripts. */
+type ExecutionMode = 'concurrent' | 'sequential';
+/**
+ * Behavior flags controlling archive/combine/keep semantics:
+ * - `archive`: create archive.tar and archive.diff.tar.
+ * - `combine`: include script outputs inside archives and remove them on disk.
+ * - `keep`: do not clear the output directory before running.
+ * - `plan`: when false, suppress printing the run plan before execution.
+ */
+type RunBehavior = {
+    combine?: boolean;
+    keep?: boolean;
+    archive?: boolean;
+    live?: boolean;
+    hangWarn?: number;
+    hangKill?: number;
+    hangKillGrace?: number;
+    plan?: boolean;
+};
+
+/**
+ * High‑level runner for `stan run`.
+ *
+ * Responsibilities:
+ * - Preflight docs/version (best‑effort).
+ * - Ensure output/diff directories.
+ * - Print the run plan.
+ * - Execute selected scripts (in the chosen mode).
+ * - Optionally create regular and diff archives (combine/keep behaviors).
+ *
+ * @param cwd - Repo root for execution.
+ * @param config - Resolved configuration.
+ * @param selection - Explicit list of script keys (or `null` to run all).
+ * @param mode - Execution mode (`concurrent` by default).
+ * @param behaviorMaybe - Archive/combine/keep flags.
+ * @returns Absolute paths to created artifacts (script outputs and/or archives).
+ */
+declare const runSelected: (cwd: string, config: ContextConfig, selection?: string[] | null, mode?: ExecutionMode, behaviorMaybe?: RunBehavior) => Promise<string[]>;
+
+export { renderAvailableScriptsHelp, runSelected };
+export type { ExecutionMode, RunBehavior, Selection };

package/package.json

@@ -0,0 +1,167 @@
+{
+  "author": "Jason Williscroft",
+  "auto-changelog": {
+    "output": "CHANGELOG.md",
+    "unreleased": true,
+    "commitLimit": false,
+    "hideCredit": true
+  },
+  "bin": {
+    "stan": "./dist/cli/stan.js"
+  },
+  "bugs": {
+    "url": "https://github.com/karmaniverous/stan-cli/issues"
+  },
+  "dependencies": {
+    "@karmaniverous/stan-core": "^0.1.1",
+    "@vitest/eslint-plugin": "^1.3.16",
+    "chalk": "^5.6.2",
+    "clipboardy": "^5.0.0",
+    "commander": "^14.0.1",
+    "fs-extra": "^11.3.2",
+    "inquirer": "^12.9.6",
+    "log-update": "^7.0.1",
+    "package-directory": "^8.1.0",
+    "signal-exit": "^4.1.0",
+    "table": "^6.9.0",
+    "tree-kill": "^1.2.2",
+    "yaml": "^2.8.1"
+  },
+  "description": "STAN is a CLI that bridges your IDE with your favorite LLM and drives a rapid, powerful, low-friction, design-first iterative development process. Real-world AI-assisted development for professional engineers!",
+  "devDependencies": {
+    "@dotenvx/dotenvx": "^1.51.0",
+    "@eslint/js": "^9.37.0",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.2",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/eslint-config-prettier": "^6.11.3",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^24.7.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "auto-changelog": "^2.5.0",
+    "eslint": "^9.37.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-jsonc": "^2.21.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-tsdoc": "^0.4.0",
+    "happy-dom": "^19.0.2",
+    "jsonc-eslint-parser": "^2.4.1",
+    "knip": "^5.64.2",
+    "lefthook": "^1.13.6",
+    "prettier": "^3.6.2",
+    "release-it": "^19.0.5",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.52.4",
+    "rollup-plugin-dts": "^6.2.3",
+    "tslib": "^2.8.1",
+    "tsx": "^4.20.6",
+    "typedoc": "^0.28.13",
+    "typedoc-plugin-mdn-links": "^5.0.9",
+    "typedoc-plugin-replace-text": "^4.2.0",
+    "typedoc-plugin-zod": "^1.4.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/mjs/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://github.com/karmaniverous/stan-cli#readme",
+  "keywords": [
+    "ai",
+    "ai-assisted",
+    "ai-assisted-development",
+    "cli",
+    "snapshot",
+    "archive",
+    "tar",
+    "unified-diff",
+    "patch",
+    "code-review",
+    "context",
+    "typescript",
+    "typedoc",
+    "eslint",
+    "prettier",
+    "rollup",
+    "vitest"
+  ],
+  "license": "BSD-3-Clause",
+  "main": "dist/cjs/index.js",
+  "module": "dist/mjs/index.js",
+  "name": "@karmaniverous/stan-cli",
+  "publishConfig": {
+    "access": "public"
+  },
+  "release-it": {
+    "git": {
+      "changelog": "npx auto-changelog --stdout --template https://raw.githubusercontent.com/release-it/release-it/main/templates/changelog-compact.hbs",
+      "commitMessage": "chore: release v${version}",
+      "requireBranch": "main"
+    },
+    "github": {
+      "release": true
+    },
+    "hooks": {
+      "after:init": [
+        "npm run lint",
+        "npm run test",
+        "npm run knip",
+        "npm run build"
+      ],
+      "before:npm:release": [
+        "npx auto-changelog -p",
+        "npm run docs",
+        "git add -A"
+      ],
+      "after:release": [
+        "git switch -c release/${version}",
+        "git push -u origin release/${version}",
+        "git switch ${branchName}"
+      ]
+    },
+    "npm": {
+      "publish": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/karmaniverous/stan-cli.git"
+  },
+  "scripts": {
+    "build": "rimraf dist .rollup.cache .tsbuildinfo && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "changelog": "auto-changelog",
+    "docs": "typedoc",
+    "knip": "knip",
+    "lint": "eslint .",
+    "lint:fix": "npm run lint -- --fix .",
+    "release": "dotenvx run -f .env.local -- release-it",
+    "release:pre": "npm run release -- --no-git.requireBranch --github.prerelease --preRelease",
+    "relink": "npm uninstall -g @karmaniverous/stan-cli && npm run build && npm link",
+    "stan": "tsx src/cli/stan/stan.ts",
+    "test": "vitest --run --coverage --silent",
+    "typecheck": "tsc"
+  },
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "version": "0.8.0"
+}