@allstak/wizard 0.1.3 → 0.1.5

package/dist/sourcemaps/vite.js

@@ -1,9 +1,10 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { patchJsModule, ensureImport, removeImport } from '../patchers/js-ast.js';
-import { appendManagedBlock, removeManagedSourceBlock } from '../patchers/source-block.js';
-const PKG = '@allstak/js/vite';
-const PKG_NAMED = 'allstakVitePlugin';
+import { removeManagedSourceBlock } from '../patchers/source-block.js';
+const PKG = '@allstak/react/vite';
+const LEGACY_PKG = '@allstak/js/vite';
+const PKG_NAMED = 'allstakSourcemaps';
 function locate(projectRoot) {
     for (const c of ['vite.config.ts', 'vite.config.mjs', 'vite.config.js']) {
         const full = resolve(projectRoot, c);
@@ -26,16 +27,18 @@ export const viteSourceMapProvider = {
         await patchJsModule(tx, cfg, (mod) => {
             ensureImport(mod, { from: PKG, named: [PKG_NAMED] });
         });
-        await appendManagedBlock(tx, cfg, [
-            `// allstak-wizard: ensure the plugin is in your vite plugins array, e.g.:`,
-            `//   plugins: [react(), ${PKG_NAMED}({ apiKey: process.env.ALLSTAK_API_KEY, project: '${ctx.project}' })]`,
-        ].join('\n'), { style: 'slash', validateJs: true });
+        const src = readFileSync(cfg, 'utf8');
+        const next = ensureVitePluginConfigured(src, ctx);
+        if (next !== src) {
+            await tx.write(cfg, next);
+        }
     },
     async unwire(ctx, tx) {
         const cfg = locate(ctx.projectRoot);
         if (!cfg)
             return;
         await patchJsModule(tx, cfg, (mod) => removeImport(mod, PKG));
+        await patchJsModule(tx, cfg, (mod) => removeImport(mod, LEGACY_PKG));
         await removeManagedSourceBlock(tx, cfg, 'slash');
     },
     async status(ctx) {
@@ -43,10 +46,10 @@ export const viteSourceMapProvider = {
         if (!cfg)
             return { provider: 'vite', state: 'missing', configFile: null };
         const src = readFileSync(cfg, 'utf8');
-        const wired = src.includes(PKG);
+        const wired = src.includes(PKG) || src.includes(LEGACY_PKG);
         if (!wired)
             return { provider: 'vite', state: 'missing', configFile: cfg };
-        if (!src.includes(PKG_NAMED)) {
+        if (!src.includes(PKG_NAMED) && !src.includes('allstakVitePlugin')) {
             return {
                 provider: 'vite',
                 state: 'drifted',
@@ -54,7 +57,87 @@ export const viteSourceMapProvider = {
                 reason: `${PKG} imported but ${PKG_NAMED} not referenced — plugin may not be invoked`,
             };
         }
+        if (!/plugins\s*:\s*\[[\s\S]*allstak(?:Sourcemaps|VitePlugin)\s*\(/.test(src)) {
+            return {
+                provider: 'vite',
+                state: 'drifted',
+                configFile: cfg,
+                reason: 'source-map helper is imported but not present in the Vite plugins array',
+            };
+        }
+        if (!/build\s*:\s*\{[\s\S]*sourcemap\s*:\s*true/.test(src)) {
+            return {
+                provider: 'vite',
+                state: 'drifted',
+                configFile: cfg,
+                reason: 'Vite build.sourcemap is not enabled',
+            };
+        }
         return { provider: 'vite', state: 'wired', configFile: cfg };
     },
 };
+function ensureVitePluginConfigured(src, ctx) {
+    let next = src;
+    if (!next.includes(`${PKG_NAMED}(`)) {
+        next = insertIntoPluginsArray(next, [
+            `${PKG_NAMED}({`,
+            `      release: process.env.ALLSTAK_RELEASE ?? '${ctx.release ?? ''}',`,
+            `      token: process.env.ALLSTAK_UPLOAD_TOKEN,`,
+            `      dist: process.env.ALLSTAK_DIST ?? 'web',`,
+            `      silent: process.env.CI !== 'true',`,
+            `    })`,
+        ].join('\n    '));
+    }
+    next = ensureSourcemapEnabled(next);
+    return next;
+}
+function insertIntoPluginsArray(src, pluginExpr) {
+    const match = /plugins\s*:\s*\[/.exec(src);
+    if (!match || match.index === undefined)
+        return src;
+    const open = src.indexOf('[', match.index);
+    const close = findMatching(src, open, '[', ']');
+    if (close < 0)
+        return src;
+    const beforeClose = src.slice(0, close).trimEnd();
+    const needsComma = !beforeClose.endsWith('[') && !beforeClose.endsWith(',');
+    const insertion = `${needsComma ? ',' : ''}\n    ${pluginExpr},`;
+    return `${src.slice(0, close)}${insertion}${src.slice(close)}`;
+}
+function ensureSourcemapEnabled(src) {
+    if (/build\s*:\s*\{[\s\S]*sourcemap\s*:\s*true/.test(src))
+        return src;
+    const match = /build\s*:\s*\{/.exec(src);
+    if (!match || match.index === undefined)
+        return src;
+    const open = src.indexOf('{', match.index);
+    return `${src.slice(0, open + 1)}\n    sourcemap: true,${src.slice(open + 1)}`;
+}
+function findMatching(src, openIndex, openChar, closeChar) {
+    if (openIndex < 0 || src[openIndex] !== openChar)
+        return -1;
+    let depth = 0;
+    let quote = null;
+    for (let i = openIndex; i < src.length; i += 1) {
+        const ch = src[i];
+        const prev = src[i - 1];
+        if (quote) {
+            if (ch === quote && prev !== '\\')
+                quote = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`') {
+            quote = ch;
+            continue;
+        }
+        if (ch === openChar)
+            depth += 1;
+        if (ch === closeChar) {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
 //# sourceMappingURL=vite.js.map

package/dist/sourcemaps/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/sourcemaps/vite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/sourcemaps/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,MAAM,GAAG,GAAG,qBAAqB,CAAC;AAClC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AACtC,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAEtC,SAAS,MAAM,CAAC,WAAmB;IACjC,KAAK,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,wBAAwB;IAC/B,aAAa,EAAE,GAAG;IAElB,KAAK,CAAC,MAAM,CAAC,GAAG;QACd,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;YACnC,YAAY,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,0BAA0B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE;QAClB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;QACrE,MAAM,wBAAwB,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAG;QACd,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAC1E,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;QAC3E,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACnE,OAAO;gBACL,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,SAAS;gBAChB,UAAU,EAAE,GAAG;gBACf,MAAM,EAAE,GAAG,GAAG,iBAAiB,SAAS,6CAA6C;aACtF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,8DAA8D,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9E,OAAO;gBACL,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,SAAS;gBAChB,UAAU,EAAE,GAAG;gBACf,MAAM,EAAE,yEAAyE;aAClF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,OAAO;gBACL,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,SAAS;gBAChB,UAAU,EAAE,GAAG;gBACf,MAAM,EAAE,qCAAqC;aAC9C,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAC/D,CAAC;CACF,CAAC;AAEF,SAAS,0BAA0B,CAAC,GAAW,EAAE,GAAgC;IAC/E,IAAI,IAAI,GAAG,GAAG,CAAC;IACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,GAAG,sBAAsB,CAAC,IAAI,EAAE;YAClC,GAAG,SAAS,IAAI;YAChB,kDAAkD,GAAG,CAAC,OAAO,IAAI,EAAE,IAAI;YACvE,gDAAgD;YAChD,gDAAgD;YAChD,0CAA0C;YAC1C,QAAQ;SACT,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW,EAAE,UAAkB;IAC7D,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,UAAU,GAAG,CAAC;IACjE,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW;IACzC,IAAI,2CAA2C,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtE,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,yBAAyB,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,SAAiB,EAAE,QAAgB,EAAE,SAAiB;IACvF,IAAI,SAAS,GAAG,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAA2B,IAAI,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,EAAE,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI;gBAAE,KAAK,GAAG,IAAI,CAAC;YAChD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3C,KAAK,GAAG,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,QAAQ;YAAE,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/util/wizard-version.d.ts

@@ -2,5 +2,5 @@
  * Single source of truth for the wizard's own version string. Bumping `package.json`
  * does NOT auto-update this constant — keep them in sync. Tests assert equality.
  */
-export declare const WIZARD_VERSION = "0.1.3";
+export declare const WIZARD_VERSION = "0.1.4";
 //# sourceMappingURL=wizard-version.d.ts.map

package/dist/util/wizard-version.js

@@ -2,5 +2,5 @@
  * Single source of truth for the wizard's own version string. Bumping `package.json`
  * does NOT auto-update this constant — keep them in sync. Tests assert equality.
  */
-export const WIZARD_VERSION = '0.1.3';
+export const WIZARD_VERSION = '0.1.4';
 //# sourceMappingURL=wizard-version.js.map

package/docs/architecture/v02-java-host-fix-spec.md

@@ -22,14 +22,10 @@ SDK-side blocker."
 
 ## Required SDK-side change
 
-Reference the AllStak SDK workspace at:
-
-```
-/Volumes/M.2/MyProjects/AllStak-Projects/sdks/allstak-java-sdk
-```
-
-The change is small but needs to land in the SDK before the wizard's `java`
-integration can graduate from `experimental`:
+Target package: `allstak-java-sdk` (the Java SDK in the AllStak SDK
+monorepo, sibling of `@allstak/wizard`). The change is small but must land
+in the SDK before the wizard's `java` integration can graduate from
+`experimental`:
 
 ### 1. Add a `host` field to `AllStakConfig`
 

package/docs/architecture/v02-sourcemaps-e2e-spec.md

@@ -8,7 +8,7 @@ against the live backend. This spec documents what v0.2 must add.
 
 ## What works today (v0.1.x)
 
-- `vite` provider: AST-injects `import { allstakVitePlugin } from '@allstak/js/vite'` and adds a managed-block hint.
+- `vite` provider: imports `allstakSourcemaps` from `@allstak/react/vite`, adds it to the real Vite `plugins` array, and enables `build.sourcemap`.
 - `next` provider: managed-block hint pointing the user at `withAllStak`.
 - `webpack` provider: managed-block hint only.
 - `metro` provider: intentionally inert; `detect()` returns false.

package/docs/beta/README.md

@@ -0,0 +1,17 @@
+# `@allstak/wizard@beta` — public beta docs
+
+| Doc | What it covers |
+|-----|----------------|
+| [quickstart](./quickstart.md) | Install + run in five minutes |
+| [react](./react.md) | React (Vite or CRA) integration |
+| [next](./next.md) | Next.js 13+ integration |
+| [node](./node.md) | Vanilla Node.js / TypeScript |
+| [doctor](./doctor.md) | Deterministic diagnostics + `--live-probe` |
+| [restore](./restore.md) | Persistent snapshots + rollback |
+| [config](./config.md) | `allstak.config.*` schema + precedence + migrations |
+| [ci](./ci.md) | Running unattended in CI |
+| [privacy](./privacy.md) | Telemetry contract — what we send and how to disable |
+| [known-limitations](./known-limitations.md) | Honest list of what's NOT supported |
+| [troubleshooting](./troubleshooting.md) | Common errors mapped to fixes |
+| [errors](../errors.md) | Canonical error catalog |
+| [architecture](../architecture/) | Internal design docs (registry, transaction, rollback, etc.) |

package/docs/beta/ci.md

@@ -0,0 +1,122 @@
+# Running in CI
+
+The wizard is designed to run unattended once you've committed an
+`allstak.config.*` and stashed an API key.
+
+## One-shot setup in a CI step
+
+```yaml
+# .github/workflows/setup-allstak.yml (excerpt)
+- name: Configure AllStak
+  env:
+    ALLSTAK_API_KEY: ${{ secrets.ALLSTAK_API_KEY }}
+  run: |
+    npx @allstak/wizard@beta -i react -y \
+      --skip-deps \
+      --release "$GITHUB_SHA"
+```
+
+Why these flags:
+
+- `-y`: skip the confirmation prompt. The wizard refuses with `E_USER_CANCELLED`
+  in non-interactive mode otherwise.
+- `--skip-deps`: don't run a package install — your CI step before this
+  already installed dependencies.
+- `--release "$GITHUB_SHA"`: stamp the deploy commit on every event.
+
+The CLI exits 0 on success, 2 on `WizardError`, and 130 on user cancel
+(impossible in `-y` mode but documented for completeness).
+
+## Doctor in CI (smoke check)
+
+```yaml
+- name: Doctor
+  env:
+    ALLSTAK_API_KEY: ${{ secrets.ALLSTAK_API_KEY }}
+  run: |
+    npx @allstak/wizard@beta --json doctor \
+      --live-probe \
+      --project-id ${{ vars.ALLSTAK_PROJECT_ID }} \
+      > doctor.json
+    jq -e '.outcome == "success"' doctor.json
+```
+
+`--live-probe` sends a real test event and polls for ingestion. Use it as
+a deploy gate — if the ingestion path is broken, fail the deploy before
+users hit it.
+
+## JSON output everywhere
+
+`--json` writes a single JSON object to stdout (status text goes to stderr).
+Pipe it to `jq` or your own parser. Shape:
+
+```json
+{
+  "schemaVersion": 1,
+  "command": "init",
+  "outcome": "success",
+  "errorCode": null,
+  "durationMs": 4200,
+  "events": [...],
+  "diff": [...],
+  "doctor": [...],
+  "data": { ... }
+}
+```
+
+## Telemetry in CI
+
+Telemetry is on by default. To disable:
+
+```bash
+ALLSTAK_WIZARD_TELEMETRY=0 npx @allstak/wizard@beta ...
+# or
+npx @allstak/wizard@beta --no-telemetry ...
+```
+
+See [privacy.md](./privacy.md) for the exact payload shape. Telemetry
+failures NEVER abort the wizard.
+
+## Snapshot retention in CI
+
+Each wizard run writes a snapshot to `.allstak-wizard/backups/`. In CI the
+default retention of 10 is usually fine. To disable pruning entirely
+(useful when you keep a separate audit log):
+
+```bash
+npx @allstak/wizard@beta -i react -y --snapshot-keep 0
+```
+
+To skip persistent snapshots entirely (in-process rollback only) — not
+currently supported. Plans for v0.2.
+
+## Self-hosted in CI
+
+Either pass flags or commit a config:
+
+```bash
+npx @allstak/wizard@beta \
+  --host https://api.allstak.acme.com \
+  --dashboard-host https://app.allstak.acme.com \
+  -i react -y
+```
+
+## Validating the wizard itself
+
+The wizard ships a CI matrix workflow under `.github/workflows/ci.yml` that
+runs install/repair/uninstall/restore cycles against React+Vite, Next, and
+Node fixtures across Node 18/20/22. Fork the workflow if you want to
+gate your own CI on it.
+
+## Recommended pre-deploy chain
+
+```bash
+npm ci
+npm run test
+npx @allstak/wizard@beta config validate
+npx @allstak/wizard@beta -i react -y --release "$GIT_SHA"
+npx @allstak/wizard@beta --json doctor --live-probe \
+  --project-id "$ALLSTAK_PROJECT_ID" \
+  --api-key "$ALLSTAK_API_KEY"
+npm run build
+```

package/docs/beta/config.md

@@ -0,0 +1,124 @@
+# `allstak.config.*`
+
+Optional project-level config so you don't repeat `--org`, `--project`,
+`--host`, etc. on every wizard invocation. Discovered from the project root
+upward; the first matching file wins.
+
+Loader order (first match wins):
+
+1. `allstak.config.ts`
+2. `allstak.config.mts`
+3. `allstak.config.mjs`
+4. `allstak.config.js`
+5. `allstak.config.cjs`
+6. `allstak.config.json`
+
+`.ts` / `.mts` configs require running the wizard via a TypeScript-aware
+launcher (`npx tsx`, `bun`, or `deno run`). Plain `.mjs` / `.json` work
+without any toolchain.
+
+## Schema
+
+```ts
+import { defineConfig } from '@allstak/wizard/config';
+
+export default defineConfig({
+  schemaVersion: 1,
+  organization: 'my-org',
+  project: 'my-project',
+  environment: 'production',
+  release: process.env.GIT_SHA,
+  sourceMaps: {
+    enabled: true,
+    ignore: ['node_modules'],
+  },
+  selfHosted: {
+    apiHost: 'https://api.allstak.example',
+    ingestHost: 'https://api.allstak.example',
+    dashboardHost: 'https://app.allstak.example',
+  },
+  snapshotKeep: 10,
+});
+```
+
+All fields are optional. `defineConfig` is a typed-identity helper; at
+runtime it just returns its input.
+
+## Precedence
+
+```
+CLI flag  >  env var  >  config file  >  built-in default
+```
+
+Examples:
+
+| Setting | CLI | Env | Config | Default |
+|---------|-----|-----|--------|---------|
+| organization | `--org` | `ALLSTAK_ORG` | `organization` | — |
+| project | `--project` | `ALLSTAK_PROJECT` | `project` | — |
+| environment | `--environment` | `ALLSTAK_ENVIRONMENT` | `environment` | `production` |
+| release | `--release` | `ALLSTAK_RELEASE` | `release` (string or function) | — |
+| api host | `--host` | `ALLSTAK_HOST` | `selfHosted.apiHost` | `https://api.allstak.sa` |
+| ingest host | `--ingest-host` | `ALLSTAK_INGEST_HOST` | `selfHosted.ingestHost` | matches api host |
+| dashboard host | `--dashboard-host` | `ALLSTAK_DASHBOARD_HOST` | `selfHosted.dashboardHost` | derived from api |
+| source-maps | `--skip-source-maps` | — | `sourceMaps.enabled` | `true` |
+| snapshot-keep | `--snapshot-keep` | `ALLSTAK_SNAPSHOT_KEEP` | `snapshotKeep` | `10` |
+
+## Validation
+
+```bash
+npx @allstak/wizard@beta config validate
+```
+
+Reports the discovered file path, the declared `schemaVersion`, and any
+deprecation warnings.
+
+## Migration
+
+When the wizard ships a new schema, `allstak config migrate` upgrades your
+config in place.
+
+```bash
+npx @allstak/wizard@beta config migrate            # rewrites .json files
+npx @allstak/wizard@beta config migrate --dry-run  # prints planned changes
+```
+
+For `.ts` / `.mjs` configs the wizard prints the migrated shape and asks
+you to apply it manually — we don't roundtrip TypeScript through an AST
+serializer that would mangle your imports and comments.
+
+The wizard treats a missing `schemaVersion` as `1`. Always declaring it
+explicitly future-proofs your config.
+
+## Self-hosted
+
+Wizard never assumes `api.allstak.sa`. For a self-hosted deployment:
+
+```ts
+export default defineConfig({
+  schemaVersion: 1,
+  selfHosted: {
+    apiHost: 'https://api.allstak.acme.com',
+    ingestHost: 'https://api.allstak.acme.com',
+    dashboardHost: 'https://app.allstak.acme.com',
+  },
+});
+```
+
+CLI users can also pass `--host`, `--ingest-host`, `--dashboard-host`
+directly. **Caveat:** the Java SDK currently hardcodes its host; the wizard
+will warn when `-i java` runs against a non-default host until the SDK
+ships a configurable host field.
+
+## Release as a function
+
+Useful for CI:
+
+```ts
+release: process.env.GIT_SHA,                 // string at config-load time
+release: () => process.env.GIT_SHA,           // function evaluated each run
+release: () => execSync('git rev-parse HEAD').toString().trim(),
+```
+
+If the function returns `undefined`, the wizard falls through the precedence
+chain (env, default).

package/docs/beta/doctor.md

@@ -0,0 +1,79 @@
+# `allstak doctor`
+
+Deterministic diagnostic with named stages. Read-only by default;
+`--live-probe` adds a real test event roundtrip.
+
+## Stages
+
+The doctor runs all stages in this fixed order, even when an early stage
+fails (so you see the whole picture):
+
+| Stage | What it checks |
+|-------|----------------|
+| `auth` | Credentials present + accepted (`--api-key` or stored JWT). Auto-refreshes JWT if it expires soon. |
+| `reachability` | Configured host responds (HTTP-level only — no `/health` exists, so it probes `/api/v1/auth/me` and treats `401` as "alive"). |
+| `config` | `allstak.config.*` discovered (or absent — both fine). Reports the source path. |
+| `integration` | Delegates to the integration's own doctor — env present? entry patched? imports wired? |
+| `event-ingest` | (only with `--live-probe`) Sends a real event to `/ingest/v1/errors`, polls `/api/v1/errors` for ingestion. |
+| `release-linkage` | Confirms the configured release is attached to the test event. |
+| `source-maps` | Asks each registered source-map provider for its wired/drifted/missing state. |
+
+## Output
+
+Each stage emits exactly one line: `pass`, `warn`, `fail`, or `skip`, plus
+a fix hint when applicable. `--json` produces a structured array under
+`data.stages` for programmatic consumption.
+
+```bash
+npx @allstak/wizard@beta doctor
+```
+
+```
+» Doctor
+✓ [auth] Authenticated as me@example.com.
+✓ [reachability] Reached https://api.allstak.sa.
+✓ [config] Loaded config from /repo/allstak.config.ts.
+✓ [integration] react: ok (4 checks)
+- [event-ingest] Skipped (pass --live-probe to enable).
+- [release-linkage] Skipped: live probe required to verify release linkage end-to-end.
+✓ [source-maps] Wired: vite
+✓ Doctor: setup looks good.
+```
+
+## Live probe
+
+Requires both:
+
+- `--api-key` (project-scoped — sends the test event),
+- `--project-id <uuid>` (the project UUID, visible in the dashboard URL).
+
+```bash
+npx @allstak/wizard@beta doctor --live-probe \
+  --api-key ask_live_... \
+  --project-id 7e8e... \
+  --live-probe-timeout 60000
+```
+
+Flow:
+
+1. Wizard generates a random fingerprint (`wizard-probe-<6-hex>`).
+2. POSTs an event to `/ingest/v1/errors` with that fingerprint in metadata.
+3. Polls `/api/v1/errors?projectId=&from=&query=<fingerprint>` every 2.5s.
+4. Reports the dashboard URL of the captured event when found.
+
+If polling times out, the doctor returns `E_INGEST_VERIFY_FAILED` with the
+event id you can hand to support.
+
+## JSON mode
+
+```bash
+npx @allstak/wizard@beta --json doctor | jq '.data.stages'
+```
+
+Each entry is `{ stage, status, detail, fix?, data? }`.
+
+## When stages fail
+
+The CLI exits non-zero (code 2) on any `fail`. `warn` and `skip` do not
+change exit code. See [errors.md](../errors.md) for the canonical error
+codes each stage can emit.

package/docs/beta/expo.md

@@ -0,0 +1,69 @@
+# Expo (React Native)
+
+**Stability:** internal experimental. Managed workflow only. The wizard refuses to run on
+projects that have already prebuilt to native (i.e. an `ios/` or `android/`
+directory at the project root) — bare-via-prebuild has too many failure
+modes for an unattended patcher and remains `unsupported` in v0.1.
+
+## What you get
+
+- `@allstak/react-native` installed.
+- `.env` populated with `ALLSTAK_API_KEY` (and the standard companions).
+- `app.json` gets the AllStak Expo plugin appended to `expo.plugins[]`
+  (idempotent — re-running does not duplicate the entry).
+- `App.tsx` gets:
+  - An AST-injected `import { AllStakProvider } from '@allstak/react-native'`.
+  - A managed-block hint reminding you to wrap your root component in
+    `<AllStakProvider>…</AllStakProvider>`.
+- `app.config.{js,ts}` gets the same managed-block hint if it exists.
+
+## Run
+
+```bash
+npx @allstak/wizard@beta -i expo
+```
+
+## Compatibility
+
+- `expo >= 50`. Older versions refused with `E_UNSUPPORTED_VERSION`.
+- `react-native >= 0.73`.
+- **Managed workflow only.** Bare/prebuilt projects (`ios/` or `android/`
+  present) are refused with a clear error. To use AllStak in a bare RN
+  app, follow the SDK README directly — the wizard will not patch native
+  Xcode/Gradle config in v0.1.
+
+## Wiring `<AllStakProvider>`
+
+The wizard cannot safely AST-edit your component tree (App.tsx shapes
+vary too much — function/class/forwardRef/HOC). It places a managed-block
+hint and you wire the provider yourself:
+
+```tsx
+import { AllStakProvider } from '@allstak/react-native';
+
+export default function App() {
+  return (
+    <AllStakProvider apiKey={process.env.EXPO_PUBLIC_ALLSTAK_API_KEY}>
+      {/* your app */}
+    </AllStakProvider>
+  );
+}
+```
+
+`doctor` reports `warn` on `provider-wired` until the live call is detected
+(comments inside the managed-block hint are stripped before matching, so
+the example above does not produce a false positive).
+
+## Capabilities the wizard does NOT claim
+
+- **No source-map upload wiring.** Metro source-maps are deferred to v0.2
+  (no-op `skip` in `doctor`).
+- **No native edits.** No Podfile / Gradle / Info.plist / AndroidManifest
+  changes. EAS Build users get the plugin reference in `app.json` and Expo
+  takes care of the rest.
+
+## Verify
+
+```bash
+npx @allstak/wizard@beta doctor -i expo
+```

package/docs/beta/fastify.md

@@ -0,0 +1,62 @@
+# Fastify
+
+**Stability:** internal experimental. AST-safe import (ESM only) + managed-block hint.
+The wizard branches on module system: ESM entries get an AST-injected
+`import { allstakFastify }`; CJS entries get the managed-block hint only
+(the wizard does NOT inject `require()` calls, which interact badly with
+top-of-file conditional/dynamic require patterns).
+
+## What you get
+
+- `@allstak/fastify` installed.
+- `.env` populated with `ALLSTAK_API_KEY`.
+- Entry file (resolved from `package.json:scripts.start`,
+  `package.json:main`, or conventional `src/server.{ts,js,mjs}` /
+  `src/index.{ts,js,mjs}`):
+  - **ESM** (`type: module` / `.mjs` / `import` syntax in the file):
+    AST-injected import.
+  - **CJS**: import skipped, hint-only.
+  - Both: a managed-block hint demonstrating
+    `app.register(allstakFastify, { ... })`.
+
+## Run
+
+```bash
+npx @allstak/wizard@beta -i fastify
+```
+
+## Compatibility
+
+- `fastify >= 4`. Older versions refused with `E_UNSUPPORTED_VERSION`.
+
+## Wiring `app.register`
+
+```ts
+import Fastify from 'fastify';
+import { allstakFastify } from '@allstak/fastify';
+
+const app = Fastify({ logger: true });
+await app.register(allstakFastify, {
+  apiKey: process.env.ALLSTAK_API_KEY,
+});
+// … your routes
+await app.listen({ port: 3000 });
+```
+
+`doctor` reports `warn` on `plugin-registered` until a non-comment
+`app.register(allstakFastify, ...)` call is detected (line comments
+are stripped before matching so the wizard's own hint does not satisfy
+the check).
+
+## Capabilities the wizard does NOT claim
+
+- **No source-map upload wiring.** Deferred to v0.2.
+- **No CJS AST patching.** CJS users wire the `require(...)` and
+  `app.register(...)` calls per the managed-block hint.
+- **No bundler integration** (esbuild/tsup/etc.) — out of scope for v0.1.
+
+## Verify
+
+```bash
+npx @allstak/wizard@beta doctor -i fastify
+```