@karmaniverous/stan-cli 0.11.6 → 0.12.0

package/dist/types/index.d.ts

@@ -9,12 +9,26 @@
  */
 declare const renderAvailableScriptsHelp: (cwd: string) => string;
 
-type ScriptEntry = string | {
+/** Object form of a configured script entry. */
+type ScriptObject = {
+    /** Shell command to execute for this script key. */
     script: string;
+    /**
+     * Optional regular expression pattern used to classify output as a warning
+     * even when the process exits with code 0.
+     */
     warnPattern?: string;
     /** Optional regex flags that override the default flags behavior for warnPattern. */
     warnPatternFlags?: string;
 };
+/**
+ * Script entry in `stan-cli.scripts`.
+ *
+ * - string: shorthand command (e.g., "npm run test")
+ * - object: extended form with a `script` command and optional warning pattern
+ */
+type ScriptEntry = string | ScriptObject;
+/** Map of script keys to their configured commands (string shorthand or object form). */
 type ScriptMap = Record<string, ScriptEntry>;
 
 /**
@@ -26,18 +40,24 @@ type Selection = string[] | null;
 /** Execution strategy for running scripts. */
 type ExecutionMode = 'concurrent' | 'sequential';
 
+/** Runner-local configuration (CLI-owned scripts + engine selection inputs). */
 type RunnerConfig = {
+    /** STAN workspace directory name (e.g., ".stan"). */
     stanPath: string;
+    /** CLI-owned scripts mapping (script key -\> command config). */
     scripts: ScriptMap;
     /**
      * Optional engine selection context (propagated to the archive phase).
      * When present, these are honored by createArchive/createArchiveDiff.
      */
     includes?: string[];
+    /** Deny-list globs (engine config excludes plus any overlay-composed excludes). */
     excludes?: string[];
+    /** Optional imports map used to stage external context into <stanPath>/imports. */
     imports?: Record<string, string[]>;
     /** High-precedence re-includes (passed to core; subject to reserved denials). */
     anchors?: string[];
+    /** Optional extra plan lines (facet view) printed in the run plan. */
     overlayPlan?: string[];
 };
 /**
@@ -48,13 +68,21 @@ type RunnerConfig = {
  * - `plan`: when false, suppress printing the run plan before execution.
  */
 type RunBehavior = {
+    /** Include script outputs inside archives and remove them from disk afterward. */
     combine?: boolean;
+    /** Keep (do not clear) the output directory before running. */
     keep?: boolean;
+    /** Create archive.tar and archive.diff.tar. */
     archive?: boolean;
+    /** Enable the live TTY UI when available. */
     live?: boolean;
+    /** Seconds of inactivity before warning/stalled labeling (TTY only). */
     hangWarn?: number;
+    /** Seconds of inactivity before terminating the process tree (TTY only). */
     hangKill?: number;
+    /** Seconds to wait after SIGTERM before SIGKILL (TTY only). */
     hangKillGrace?: number;
+    /** When false, suppress printing the plan header before execution. */
     plan?: boolean;
     /** Plan-only display string for resolved system prompt source (when present). */
     prompt?: string;
@@ -81,4 +109,4 @@ type RunBehavior = {
 declare const runSelected: (cwd: string, config: RunnerConfig, selection?: string[] | null, mode?: ExecutionMode, behaviorMaybe?: RunBehavior, promptChoice?: string) => Promise<string[]>;
 
 export { renderAvailableScriptsHelp, runSelected };
-export type { ExecutionMode, RunBehavior, RunnerConfig, ScriptEntry, ScriptMap, Selection };
+export type { ExecutionMode, RunBehavior, RunnerConfig, ScriptEntry, ScriptMap, ScriptObject, Selection };

package/package.json

@@ -13,24 +13,24 @@
     "url": "https://github.com/karmaniverous/stan-cli/issues"
   },
   "dependencies": {
-    "@karmaniverous/stan-core": "^0.4.6",
-    "@vitest/eslint-plugin": "^1.4.0",
+    "@karmaniverous/stan-core": "^0.4.7",
+    "@vitest/eslint-plugin": "^1.6.4",
     "chalk": "^5.6.2",
-    "clipboardy": "^5.0.0",
+    "clipboardy": "^5.0.2",
     "commander": "^14.0.2",
-    "fs-extra": "^11.3.2",
-    "inquirer": "^12.10.0",
+    "fs-extra": "^11.3.3",
+    "inquirer": "^13.1.0",
     "package-directory": "^8.1.0",
     "signal-exit": "^4.1.0",
     "table": "^6.9.0",
     "tree-kill": "^1.2.2",
-    "yaml": "^2.8.1",
-    "zod": "^4.1.12"
+    "yaml": "^2.8.2",
+    "zod": "^4.2.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.1",
-    "@eslint/js": "^9.39.1",
+    "@dotenvx/dotenvx": "^1.51.2",
+    "@eslint/js": "^9.39.2",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
@@ -39,34 +39,34 @@
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/eslint-config-prettier": "^6.11.3",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^24.10.0",
-    "@vitest/coverage-v8": "^4.0.7",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
     "auto-changelog": "^2.5.0",
     "cross-env": "^10.1.0",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "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": "^20.0.10",
-    "jsonc-eslint-parser": "^2.4.1",
-    "knip": "^5.67.1",
-    "lefthook": "^2.0.2",
-    "prettier": "^3.6.2",
-    "release-it": "^19.0.5",
-    "rimraf": "^6.1.0",
-    "rollup": "^4.52.5",
-    "rollup-plugin-dts": "^6.2.3",
+    "eslint-plugin-tsdoc": "^0.5.0",
+    "happy-dom": "^20.0.11",
+    "jsonc-eslint-parser": "^2.4.2",
+    "knip": "^5.78.0",
+    "lefthook": "^2.0.13",
+    "prettier": "^3.7.4",
+    "release-it": "^19.2.2",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.54.0",
+    "rollup-plugin-dts": "^6.3.0",
     "tslib": "^2.8.1",
-    "tsx": "^4.20.6",
-    "typedoc": "^0.28.14",
+    "tsx": "^4.21.0",
+    "typedoc": "^0.28.15",
     "typedoc-plugin-mdn-links": "^5.0.10",
     "typedoc-plugin-replace-text": "^4.2.0",
     "typedoc-plugin-zod": "^1.4.3",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.3",
-    "vitest": "^4.0.7"
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^4.0.16"
   },
   "engines": {
     "node": ">=20"
@@ -164,5 +164,5 @@
   },
   "type": "module",
   "types": "dist/types/index.d.ts",
-  "version": "0.11.6"
+  "version": "0.12.0"
 }

package/dist/cjs/classifier-DeYwffC_-CjzCgatc.js

@@ -1 +0,0 @@
-"use strict";var t=require("node:fs/promises"),e=require("node:path");const s=1048576;exports.classifyForArchive=async(n,r)=>{const a=[],i=[],o=[];await Promise.all(r.map(async r=>{const c=r.replace(/\\/g,"/"),l=e.resolve(n,r);let h=0;try{h=(await t.stat(l)).size}catch{return}let u,p=!1;try{p=await(async e=>{try{const s=await t.open(e,"r");try{const t=Buffer.allocUnsafe(8192),{bytesRead:e}=await s.read(t,0,t.length,0);for(let s=0;s<e;s+=1)if(0===t[s])return!0;return!1}finally{await s.close().catch(()=>{})}}catch{return!1}})(l)}catch{p=!1}if(p)i.push({path:c,size:h});else{a.push(c);try{(h<=s||h<5*s)&&(u=(t=>{const e=t.replace(/\r\n/g,"\n");return 0===e.length?0:e.split("\n").length})(await t.readFile(l,"utf8")))}catch{}(h>s||"number"==typeof u&&u>3e3)&&o.push({path:c,size:h,loc:u})}}));const c=[];if(i.length>0){c.push(`Binary files excluded from archive (${i.length.toString()}):`);for(const t of i)c.push(`  - ${t.path}  (${t.size.toString()} bytes)`);c.push("")}if(o.length>0){c.push(`Large text files (included; consider excludes if unwanted) (${o.length.toString()}):`);for(const t of o){const e=[`  - ${t.path}`,`(${t.size.toString()} bytes)`];"number"==typeof t.loc&&e.push(`${t.loc.toString()} LOC`),c.push(e.join(" "))}c.push(""),c.push(`Thresholds: size > ${s.toString()} bytes or LOC > ${3e3.toString()}`)}0===c.length&&c.push("No archive warnings.");const l=c.join("\n")+(c.length?"\n":"");return{textFiles:a,excludedBinaries:i,largeText:o,warningsBody:l}};

package/dist/cli/classifier-DeYwffC_-DftahF7h.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-import { stat, open, readFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
-
-const s=1048576,o=async(o,i)=>{const a=[],c=[],h=[];await Promise.all(i.map(async i=>{const l=i.replace(/\\/g,"/");const u=resolve(o,i);let p=0;try{p=(await stat(u)).size;}catch{return}let f,g=false;try{g=await(async t=>{try{const e=await open(t,"r");try{const t=Buffer.allocUnsafe(8192),{bytesRead:n}=await e.read(t,0,t.length,0);for(let e=0;e<n;e+=1)if(0===t[e])return !0;return !1}finally{await e.close().catch(()=>{});}}catch{return !1}})(u);}catch{g=false;}if(g)return void c.push({path:l,size:p});a.push(l);try{if(p<=s||p<5*s){f=(t=>{const e=t.replace(/\r\n/g,"\n");return 0===e.length?0:e.split("\n").length})(await readFile(u,"utf8"));}}catch{}(p>s||"number"==typeof f&&f>3e3)&&h.push({path:l,size:p,loc:f});}));const l=[];if(c.length>0){l.push(`Binary files excluded from archive (${c.length.toString()}):`);for(const t of c)l.push(`  - ${t.path}  (${t.size.toString()} bytes)`);l.push("");}if(h.length>0){l.push(`Large text files (included; consider excludes if unwanted) (${h.length.toString()}):`);for(const t of h){const e=[`  - ${t.path}`,`(${t.size.toString()} bytes)`];"number"==typeof t.loc&&e.push(`${t.loc.toString()} LOC`),l.push(e.join(" "));}l.push(""),l.push(`Thresholds: size > ${s.toString()} bytes or LOC > ${3e3.toString()}`);}0===l.length&&l.push("No archive warnings.");const u=l.join("\n")+(l.length?"\n":"");return {textFiles:a,excludedBinaries:c,largeText:h,warningsBody:u}};
-
-export { o as classifyForArchive };

package/dist/mjs/classifier-DeYwffC_-C7wwqop3.js

@@ -1 +0,0 @@
-import{stat as t,open as e,readFile as n}from"node:fs/promises";import{resolve as s}from"node:path";const r=1048576,o=async(o,a)=>{const i=[],c=[],h=[];await Promise.all(a.map(async a=>{const l=a.replace(/\\/g,"/"),p=s(o,a);let u=0;try{u=(await t(p)).size}catch{return}let f,g=!1;try{g=await(async t=>{try{const n=await e(t,"r");try{const t=Buffer.allocUnsafe(8192),{bytesRead:e}=await n.read(t,0,t.length,0);for(let n=0;n<e;n+=1)if(0===t[n])return!0;return!1}finally{await n.close().catch(()=>{})}}catch{return!1}})(p)}catch{g=!1}if(g)c.push({path:l,size:u});else{i.push(l);try{(u<=r||u<5*r)&&(f=(t=>{const e=t.replace(/\r\n/g,"\n");return 0===e.length?0:e.split("\n").length})(await n(p,"utf8")))}catch{}(u>r||"number"==typeof f&&f>3e3)&&h.push({path:l,size:u,loc:f})}}));const l=[];if(c.length>0){l.push(`Binary files excluded from archive (${c.length.toString()}):`);for(const t of c)l.push(`  - ${t.path}  (${t.size.toString()} bytes)`);l.push("")}if(h.length>0){l.push(`Large text files (included; consider excludes if unwanted) (${h.length.toString()}):`);for(const t of h){const e=[`  - ${t.path}`,`(${t.size.toString()} bytes)`];"number"==typeof t.loc&&e.push(`${t.loc.toString()} LOC`),l.push(e.join(" "))}l.push(""),l.push(`Thresholds: size > ${r.toString()} bytes or LOC > ${3e3.toString()}`)}0===l.length&&l.push("No archive warnings.");const p=l.join("\n")+(l.length?"\n":"");return{textFiles:i,excludedBinaries:c,largeText:h,warningsBody:p}};export{o as classifyForArchive};