@karmaniverous/stan-cli 0.11.7 → 0.12.0

package/README.md

@@ -2,7 +2,7 @@
 
 # STAN — STAN Tames Autoregressive Nonsense
 
-[![npm version](https://img.shields.io/npm/v/@karmaniverous/stan-cli.svg)](https://www.npmjs.com/package/@karmaniverous/stan-cli) ![Node Current](https://img.shields.io/node/v/@karmaniverous/stan-cli) <!-- TYPEDOC_EXCLUDE --> [![docs](https://img.shields.io/badge/docs-website-blue)](https://docs.karmanivero.us/stan) [![changelog](https://img.shields.io/badge/changelog-latest-blue.svg)](https://github.com/karmaniverous/stan-cli/tree/main/CHANGELOG.md)<!-- /TYPEDOC_EXCLUDE --> [![license](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](https://github.com/karmaniverous/stan-cli/tree/main/LICENSE.md)
+[![npm version](https://img.shields.io/npm/v/@karmaniverous/stan-cli.svg)](https://www.npmjs.com/package/@karmaniverous/stan-cli) ![Node Current](https://img.shields.io/node/v/@karmaniverous/stan-cli) <!-- TYPEDOC_EXCLUDE --> [![docs](https://img.shields.io/badge/docs-website-blue)](https://docs.karmanivero.us/stan) [![changelog](https://img.shields.io/badge/changelog-latest-blue.svg)](https://github.com/karmaniverous/stan-cli/tree/main/CHANGELOG.md)<!-- /TYPEDOC_EXCLUDE --> [![license](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](https://github.com/karmaniverous/stan-cli/tree/main/LICENSE)
 
 ![STAN Loop](https://github.com/karmaniverous/stan-cli/raw/main/assets/stan-loop.png)
 
@@ -100,7 +100,7 @@ scripts:
   typecheck: npm run typecheck
 ```
 
-See [STAN Configuration](./docs-src/configuration.md) for more!
+See [STAN Configuration](./guides/configuration.md) for more!
 
 ---
 
@@ -130,7 +130,7 @@ See [STAN Configuration](./docs-src/configuration.md) for more!
   stan patch -f file.patch # from file
   ```
 
-See [CLI Usage & Examples](./docs-src/cli-examples.md) for more!
+See [CLI Usage & Examples](./guides/cli-examples.md) for more!
 
 ---
 
@@ -138,23 +138,23 @@ See [CLI Usage & Examples](./docs-src/cli-examples.md) for more!
 
 - [API reference](https://docs.karmanivero.us/stan)
 - Guides:
-  - [Getting Started](./docs-src/getting-started.md) — Install the CLI, initialize a repo, and attach archives in chat. Recommended chat setup: import the STAN GPT agent into TypingMind (bootloader included; requires GPT‑5 access) via [this link](https://www.typingmind.com/characters/c-01K5X5RVA4N1DWBQWWJBYDNX2W).
-  - [The STAN Loop](./docs-src/the-stan-loop.md) — How Build & Snapshot → Share & Baseline → Discuss & Patch work together.
-  - [CLI Usage & Examples](./docs-src/cli-examples.md) — Common flags and invocation patterns, including `-p`, `-P`, `-S`, `-A`, and `-c`.
-  - [Migration — Namespaced Configuration](./docs-src/migration.md) — Upgrade legacy configs using `stan init` (backs up `.bak`; supports `--dry-run`).
-  - [Stan Configuration](./docs-src/configuration.md) — All config keys, includes/excludes semantics, and phase‑scoped CLI defaults.
-  - [Patch Workflow & Diagnostics](./docs-src/patch-workflow.md) — Unified diff policy, diagnostics envelopes, and assistant expectations.
-  - [Archives & Snapshots](./docs-src/archives-and-snapshots.md) — What goes into `archive.tar`/`archive.diff.tar`, combine mode, and snapshot history. Additional references:
-
+  - [Getting Started](./guides/getting-started.md) — Install the CLI, initialize a repo, and attach archives in chat. Recommended chat setup: import the STAN GPT agent into TypingMind (bootloader included; requires GPT‑5 access) via [this link](https://www.typingmind.com/characters/c-01K5X5RVA4N1DWBQWWJBYDNX2W).
+  - [The STAN Loop](./guides/the-stan-loop.md) — How Build & Snapshot → Share & Baseline → Discuss & Patch work together.
+  - [CLI Usage & Examples](./guides/cli-examples.md) — Common flags and invocation patterns, including `-p`, `-P`, `-S`, `-A`, and `-c`.
+  - [Migration — Namespaced Configuration](./guides/migration.md) — Upgrade legacy configs using `stan init` (backs up `.bak`; supports `--dry-run`).
+  - [Stan Configuration](./guides/configuration.md) — All config keys, includes/excludes semantics, and phase‑scoped CLI defaults.
+  - [Patch Workflow & Diagnostics](./guides/patch-workflow.md) — Unified diff policy, diagnostics envelopes, and assistant expectations.
+  - [Archives & Snapshots](./guides/archives-and-snapshots.md) — What goes into `archive.tar`/`archive.diff.tar`, combine mode, and snapshot history. Additional references:
+- [Bootloader & Assistant Setup](./guides/bootloader.md) — How the assistant loads `.stan/system/stan.system.md` from attached archives.
 - The following documents are maintained by STAN and live under `<stanPath>/system/` in your repo:
   - `stan.project.md` contains your evolving project requirements.
-  - `stan-todo.md` contains your evolving development plan.
+  - `stan.todo.md` contains your evolving development plan.
 
 - Case studies:
-  - [rrstack](./docs-src/case-studies/rrstack.md) — how STAN enabled rapid development in a couple of days.
-- Comparison: [Why STAN Over Alternatives?](./docs-src/why-stan-over-alternatives.md)
-- Tutorial: [Quickstart (End‑to‑End)](./docs-src/tutorial-quickstart.md)
-- FAQ: answers to common questions and pitfalls.
+  - [rrstack](./guides/case-studies/rrstack.md) — how STAN enabled rapid development in a couple of days.
+- Comparison: [Why STAN Over Alternatives?](./guides/why-stan-over-alternatives.md)
+- Tutorial: [Quickstart (End‑to‑End)](./guides/tutorial-quickstart.md)
+- [FAQ](./guides/faq.md) — answers to common questions and pitfalls.
 - Contributing: [Dev Quickstart](./contributing.md)
 
 ---

package/dist/cjs/classifier-Bqzr65UC-D9z0tWqn.js

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