@allstak/wizard 0.1.3

package/dist/output/json.js

@@ -0,0 +1,60 @@
+import { relative } from 'node:path';
+export class JsonReporter {
+    events = [];
+    diffs = [];
+    doctorReports = [];
+    listManifests = null;
+    step(label, detail) {
+        this.events.push({ kind: 'step', label, detail: detail ?? null });
+        console.error(`» ${label}${detail ? ` — ${detail}` : ''}`);
+    }
+    info(label, detail) {
+        this.events.push({ kind: 'info', label, detail: detail ?? null });
+        console.error(`› ${label}${detail ? ` — ${detail}` : ''}`);
+    }
+    warn(label, detail) {
+        this.events.push({ kind: 'warn', label, detail: detail ?? null });
+        console.error(`! ${label}${detail ? ` — ${detail}` : ''}`);
+    }
+    success(label, detail) {
+        this.events.push({ kind: 'success', label, detail: detail ?? null });
+        console.error(`✓ ${label}${detail ? ` — ${detail}` : ''}`);
+    }
+    error(label, detail) {
+        this.events.push({ kind: 'error', label, detail: detail ?? null });
+        console.error(`✗ ${label}${detail ? ` — ${detail}` : ''}`);
+    }
+    diff(diffs, cwd) {
+        for (const d of diffs) {
+            this.diffs.push({
+                path: relative(cwd, d.path) || d.path,
+                kind: d.kind,
+                beforeBytes: d.before?.length ?? 0,
+                afterBytes: d.after.length,
+            });
+        }
+    }
+    doctor(report) {
+        this.doctorReports.push(report);
+        console.error(`» doctor ${report.integration}: ${report.summary}`);
+    }
+    list(manifests) {
+        this.listManifests = manifests;
+    }
+    finalize(payload) {
+        const out = {
+            schemaVersion: 1,
+            command: payload.command,
+            outcome: payload.outcome,
+            durationMs: payload.durationMs,
+            errorCode: payload.errorCode ?? null,
+            events: this.events,
+            diff: this.diffs,
+            doctor: this.doctorReports,
+            list: this.listManifests,
+            data: payload.data ?? null,
+        };
+        process.stdout.write(JSON.stringify(out, null, 2) + '\n');
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/output/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"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"}

package/dist/output/types.d.ts

@@ -0,0 +1,36 @@
+import type { DoctorReport } from '../registry/types.js';
+import type { IntegrationManifest } from '../registry/manifest.js';
+import type { PlannedDiff } from '../transaction/tx.js';
+/**
+ * Reporter abstraction. The CLI swaps between a human-readable reporter and a
+ * machine-readable JSON reporter based on `--json`. Integrations and commands
+ * never call `console.log` directly for structured output — they go through
+ * `Reporter`. Side-channel logs (`log.debug`) remain on stderr.
+ */
+export interface Reporter {
+    /** Free-text status line (one per logical step). */
+    step(label: string, detail?: string): void;
+    info(label: string, detail?: string): void;
+    warn(label: string, detail?: string): void;
+    success(label: string, detail?: string): void;
+    error(label: string, detail?: string): void;
+    /** Print the planned diff (used in --dry-run). */
+    diff(diffs: readonly PlannedDiff[], cwd: string): void;
+    /** Print a doctor report. */
+    doctor(report: DoctorReport): void;
+    /** Print the integration list (`allstak-wizard list`). */
+    list(manifests: readonly IntegrationManifest[]): void;
+    /** Final emit — flushes JSON output, no-op for human reporter. */
+    finalize(payload: ReporterFinalize): void;
+}
+export interface ReporterFinalize {
+    command: string;
+    outcome: 'success' | 'failure' | 'cancelled' | 'noop';
+    /** Duration in ms (wall clock). */
+    durationMs: number;
+    /** Error code when outcome=failure. */
+    errorCode?: string;
+    /** Optional structured payload (e.g. doctor results) the reporter can include. */
+    data?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/output/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;GAKG;AAEH,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,kDAAkD;IAClD,IAAI,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvD,6BAA6B;IAC7B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAEnC,0DAA0D;IAC1D,IAAI,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAAC;IAEtD,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;IACtD,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/output/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/output/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":""}

package/dist/patchers/env-file.d.ts

@@ -0,0 +1,21 @@
+import { Transaction } from '../transaction/tx.js';
+export interface EnvVar {
+    key: string;
+    value: string;
+    /** When set, included as a comment line before the var. */
+    comment?: string;
+}
+/**
+ * Idempotent env-file writer. Uses managed-block markers so re-runs don't append
+ * duplicates and `uninstall` can cleanly remove our additions.
+ *
+ * Will NEVER overwrite an existing user-set value with a different one — if the
+ * key is already defined outside the managed block, we skip and return it in
+ * `skipped` so the caller can warn.
+ */
+export declare function patchEnvFile(tx: Transaction, filePath: string, vars: EnvVar[]): Promise<{
+    written: string[];
+    skipped: string[];
+}>;
+export declare function removeEnvBlock(tx: Transaction, filePath: string): Promise<void>;
+//# sourceMappingURL=env-file.d.ts.map

package/dist/patchers/env-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../src/patchers/env-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkCnD;AAED,wBAAsB,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrF"}

package/dist/patchers/env-file.js

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { upsertManagedBlock, removeManagedBlock } from './markers.js';
+/**
+ * Idempotent env-file writer. Uses managed-block markers so re-runs don't append
+ * duplicates and `uninstall` can cleanly remove our additions.
+ *
+ * Will NEVER overwrite an existing user-set value with a different one — if the
+ * key is already defined outside the managed block, we skip and return it in
+ * `skipped` so the caller can warn.
+ */
+export async function patchEnvFile(tx, filePath, vars) {
+    const existing = existsSync(filePath) ? readFileSync(filePath, 'utf8') : '';
+    const written = [];
+    const skipped = [];
+    // Identify keys already set OUTSIDE the managed block.
+    const outsideBlock = stripManagedBlock(existing);
+    const userDefined = new Set(parseEnvKeys(outsideBlock));
+    const filtered = vars.filter((v) => {
+        if (userDefined.has(v.key)) {
+            skipped.push(v.key);
+            return false;
+        }
+        written.push(v.key);
+        return true;
+    });
+    if (filtered.length === 0 && !hasManagedBlockMarker(existing)) {
+        return { written, skipped };
+    }
+    const block = filtered
+        .map((v) => {
+        const lines = [];
+        if (v.comment)
+            lines.push(`# ${v.comment}`);
+        lines.push(`${v.key}=${escapeEnvValue(v.value)}`);
+        return lines.join('\n');
+    })
+        .join('\n');
+    const next = upsertManagedBlock(existing, block || '# (no managed vars)', 'hash');
+    await tx.write(filePath, next);
+    return { written, skipped };
+}
+export async function removeEnvBlock(tx, filePath) {
+    if (!existsSync(filePath))
+        return;
+    const existing = readFileSync(filePath, 'utf8');
+    const next = removeManagedBlock(existing, 'hash');
+    if (next === existing)
+        return;
+    if (next.trim() === '') {
+        await tx.delete(filePath);
+    }
+    else {
+        await tx.write(filePath, next);
+    }
+}
+function escapeEnvValue(v) {
+    if (/[\s"'#=]/.test(v)) {
+        return `"${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return v;
+}
+function parseEnvKeys(content) {
+    const keys = [];
+    for (const line of content.split('\n')) {
+        const m = /^\s*([A-Z_][A-Z0-9_]*)\s*=/.exec(line);
+        if (m)
+            keys.push(m[1]);
+    }
+    return keys;
+}
+function stripManagedBlock(content) {
+    return removeManagedBlock(content, 'hash');
+}
+function hasManagedBlockMarker(content) {
+    return content.includes('allstak-wizard:v');
+}
+//# sourceMappingURL=env-file.js.map

package/dist/patchers/env-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.js","sourceRoot":"","sources":["../../src/patchers/env-file.ts"],"names":[],"mappings":"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"}

package/dist/patchers/js-ast.d.ts

@@ -0,0 +1,29 @@
+import { type ProxifiedModule } from 'magicast';
+import { Transaction } from '../transaction/tx.js';
+export type ModuleEditor = (mod: ProxifiedModule<any>) => void | Promise<void>;
+/**
+ * Parse a JS/TS file with magicast (recast under the hood — preserves formatting),
+ * apply mutations, write the result inside the transaction with a syntax-validation
+ * step that re-parses the output and fails the transaction on parse error.
+ */
+export declare function patchJsModule(tx: Transaction, filePath: string, editor: ModuleEditor): Promise<{
+    changed: boolean;
+}>;
+/**
+ * Ensure a module-level import statement exists. Idempotent: if an equivalent
+ * import is present (same source + same imported names), this is a no-op.
+ *
+ * Examples:
+ *   ensureImport(mod, { from: '@allstak/react', named: ['AllStakProvider'] })
+ *   ensureImport(mod, { from: '@allstak/js', defaultAs: 'AllStak' })
+ */
+export declare function ensureImport(mod: ProxifiedModule<any>, spec: {
+    from: string;
+    named?: string[];
+    defaultAs?: string;
+}): void;
+/**
+ * Remove every named/default import from `from`. Used by uninstall.
+ */
+export declare function removeImport(mod: ProxifiedModule<any>, from: string): void;
+//# sourceMappingURL=js-ast.d.ts.map

package/dist/patchers/js-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-ast.d.ts","sourceRoot":"","sources":["../../src/patchers/js-ast.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAmB/B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC,EACzB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,IAAI,CA4BN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAK1E"}

package/dist/patchers/js-ast.js

@@ -0,0 +1,71 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { parseModule, generateCode } from 'magicast';
+/**
+ * Parse a JS/TS file with magicast (recast under the hood — preserves formatting),
+ * apply mutations, write the result inside the transaction with a syntax-validation
+ * step that re-parses the output and fails the transaction on parse error.
+ */
+export async function patchJsModule(tx, filePath, editor) {
+    if (!existsSync(filePath)) {
+        throw new Error(`Cannot patch ${filePath}: file does not exist`);
+    }
+    const before = readFileSync(filePath, 'utf8');
+    const mod = parseModule(before);
+    await editor(mod);
+    let { code } = generateCode(mod);
+    // Magicast's roundtrip can strip a trailing newline on inputs that end with
+    // comment blocks. Preserve the original file's trailing-newline convention so
+    // re-runs of the wizard remain byte-identical.
+    if (before.endsWith('\n') && !code.endsWith('\n'))
+        code += '\n';
+    if (code === before)
+        return { changed: false };
+    await tx.write(filePath, code, async (_path, content) => {
+        // Re-parse to confirm valid syntax — magicast/babel will throw on invalid output.
+        parseModule(content);
+    });
+    return { changed: true };
+}
+/**
+ * Ensure a module-level import statement exists. Idempotent: if an equivalent
+ * import is present (same source + same imported names), this is a no-op.
+ *
+ * Examples:
+ *   ensureImport(mod, { from: '@allstak/react', named: ['AllStakProvider'] })
+ *   ensureImport(mod, { from: '@allstak/js', defaultAs: 'AllStak' })
+ */
+export function ensureImport(mod, spec) {
+    const existing = mod.imports.$items.find((imp) => imp.from === spec.from);
+    if (!existing) {
+        if (spec.defaultAs) {
+            mod.imports.$add({ from: spec.from, local: spec.defaultAs, imported: 'default' });
+        }
+        for (const name of spec.named ?? []) {
+            mod.imports.$add({ from: spec.from, imported: name, local: name });
+        }
+        return;
+    }
+    // Add any missing named imports.
+    for (const name of spec.named ?? []) {
+        const has = mod.imports.$items.some((imp) => imp.from === spec.from && imp.imported === name);
+        if (!has) {
+            mod.imports.$add({ from: spec.from, imported: name, local: name });
+        }
+    }
+    if (spec.defaultAs) {
+        const hasDefault = mod.imports.$items.some((imp) => imp.from === spec.from && imp.imported === 'default');
+        if (!hasDefault) {
+            mod.imports.$add({ from: spec.from, local: spec.defaultAs, imported: 'default' });
+        }
+    }
+}
+/**
+ * Remove every named/default import from `from`. Used by uninstall.
+ */
+export function removeImport(mod, from) {
+    const locals = mod.imports.$items.filter((imp) => imp.from === from).map((imp) => imp.local);
+    for (const local of locals) {
+        delete mod.imports[local];
+    }
+}
+//# sourceMappingURL=js-ast.js.map

package/dist/patchers/js-ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-ast.js","sourceRoot":"","sources":["../../src/patchers/js-ast.ts"],"names":[],"mappings":"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"}

package/dist/patchers/json-file.d.ts

@@ -0,0 +1,19 @@
+import { Transaction } from '../transaction/tx.js';
+/**
+ * JSON patching with structure preservation. We re-format with two-space indent
+ * which matches what npm/pnpm/yarn produce. This is intentionally NOT a
+ * comment-preserving JSONC patcher — JSON files we touch are package.json,
+ * app.json, appsettings.json, and composer.json, none of which permit comments.
+ */
+type JsonValue = string | number | boolean | null | JsonObject | JsonArray;
+type JsonObject = {
+    [k: string]: JsonValue;
+};
+type JsonArray = JsonValue[];
+export declare function patchJsonFile(tx: Transaction, filePath: string, mutate: (current: JsonObject) => JsonObject | void): Promise<{
+    changed: boolean;
+}>;
+export declare function ensureDep(pkg: JsonObject, field: 'dependencies' | 'devDependencies' | 'peerDependencies', name: string, version: string): boolean;
+export declare function removeDep(pkg: JsonObject, name: string): boolean;
+export {};
+//# sourceMappingURL=json-file.d.ts.map

package/dist/patchers/json-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.d.ts","sourceRoot":"","sources":["../../src/patchers/json-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;;GAKG;AAEH,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;AAC3E,KAAK,UAAU,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAC7C,KAAK,SAAS,GAAG,SAAS,EAAE,CAAC;AAE7B,wBAAsB,aAAa,CACjC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,UAAU,GAAG,IAAI,GACjD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAsB/B;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,EAC9D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAMT;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUhE"}

package/dist/patchers/json-file.js

@@ -0,0 +1,41 @@
+import { existsSync, readFileSync } from 'node:fs';
+export async function patchJsonFile(tx, filePath, mutate) {
+    const existed = existsSync(filePath);
+    const raw = existed ? readFileSync(filePath, 'utf8') : '{}';
+    let current;
+    try {
+        current = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Cannot patch ${filePath}: existing file is not valid JSON (${err instanceof Error ? err.message : String(err)})`);
+    }
+    const result = mutate(current) ?? current;
+    const next = `${JSON.stringify(result, null, 2)}\n`;
+    if (existed && next === raw) {
+        return { changed: false };
+    }
+    await tx.write(filePath, next, async (_path, content) => {
+        JSON.parse(content); // throws → triggers rollback
+    });
+    return { changed: true };
+}
+export function ensureDep(pkg, field, name, version) {
+    const deps = pkg[field] ?? {};
+    if (deps[name] === version)
+        return false;
+    deps[name] = version;
+    pkg[field] = deps;
+    return true;
+}
+export function removeDep(pkg, name) {
+    let removed = false;
+    for (const field of ['dependencies', 'devDependencies', 'peerDependencies']) {
+        const deps = pkg[field];
+        if (deps && name in deps) {
+            delete deps[name];
+            removed = true;
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=json-file.js.map

package/dist/patchers/json-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.js","sourceRoot":"","sources":["../../src/patchers/json-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAcnD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAe,EACf,QAAgB,EAChB,MAAkD;IAElD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAmB,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gBAAgB,QAAQ,sCACtB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACpD,IAAI,OAAO,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,GAAe,EACf,KAA8D,EAC9D,IAAY,EACZ,OAAe;IAEf,MAAM,IAAI,GAAI,GAAG,CAAC,KAAK,CAA4B,IAAI,EAAE,CAAC;IAC1D,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACrB,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAClB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAe,EAAE,IAAY;IACrD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,CAAU,EAAE,CAAC;QACrF,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAA2B,CAAC;QAClD,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/patchers/markers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Region markers for idempotent patches. The wizard wraps every block of injected
+ * code or config with `BEGIN/END` markers so that we can:
+ *   1. Re-run the wizard without duplicating regions (we replace the existing block).
+ *   2. Cleanly remove regions during `uninstall`.
+ */
+export declare const MARKER_VERSION = "1";
+export declare const HASH_BEGIN = "# >>> allstak-wizard:v1 (do not edit) >>>";
+export declare const HASH_END = "# <<< allstak-wizard:v1 <<<";
+export declare const SLASH_BEGIN = "// >>> allstak-wizard:v1 (do not edit) >>>";
+export declare const SLASH_END = "// <<< allstak-wizard:v1 <<<";
+export type MarkerStyle = 'hash' | 'slash';
+export declare function markerPair(style: MarkerStyle): {
+    begin: string;
+    end: string;
+};
+export declare function hasMarker(content: string): boolean;
+/**
+ * Replace the wizard-managed block with `replacement`, or append it if absent.
+ * `replacement` should NOT include the markers — they are added here.
+ */
+export declare function upsertManagedBlock(content: string, replacement: string, style: MarkerStyle): string;
+/**
+ * Remove the wizard-managed block (used by uninstall). Returns content untouched
+ * if no markers exist.
+ */
+export declare function removeManagedBlock(content: string, style: MarkerStyle): string;
+//# sourceMappingURL=markers.d.ts.map

package/dist/patchers/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../src/patchers/markers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,eAAO,MAAM,UAAU,8CAA8D,CAAC;AACtF,eAAO,MAAM,QAAQ,gCAAgD,CAAC;AAEtE,eAAO,MAAM,WAAW,+CAA+D,CAAC;AACxF,eAAO,MAAM,SAAS,iCAAiD,CAAC;AAExE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAI7E;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,WAAW,GACjB,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAI9E"}

package/dist/patchers/markers.js

@@ -0,0 +1,49 @@
+/**
+ * Region markers for idempotent patches. The wizard wraps every block of injected
+ * code or config with `BEGIN/END` markers so that we can:
+ *   1. Re-run the wizard without duplicating regions (we replace the existing block).
+ *   2. Cleanly remove regions during `uninstall`.
+ */
+export const MARKER_VERSION = '1';
+export const HASH_BEGIN = `# >>> allstak-wizard:v${MARKER_VERSION} (do not edit) >>>`;
+export const HASH_END = `# <<< allstak-wizard:v${MARKER_VERSION} <<<`;
+export const SLASH_BEGIN = `// >>> allstak-wizard:v${MARKER_VERSION} (do not edit) >>>`;
+export const SLASH_END = `// <<< allstak-wizard:v${MARKER_VERSION} <<<`;
+export function markerPair(style) {
+    return style === 'hash'
+        ? { begin: HASH_BEGIN, end: HASH_END }
+        : { begin: SLASH_BEGIN, end: SLASH_END };
+}
+const ANY_BEGIN_RE = /^[#\/]+\s*>>>\s*allstak-wizard:v\d+.*?>>>\s*$/m;
+export function hasMarker(content) {
+    return ANY_BEGIN_RE.test(content);
+}
+/**
+ * Replace the wizard-managed block with `replacement`, or append it if absent.
+ * `replacement` should NOT include the markers — they are added here.
+ */
+export function upsertManagedBlock(content, replacement, style) {
+    const { begin, end } = markerPair(style);
+    const escapedBegin = escapeRegExp(begin);
+    const escapedEnd = escapeRegExp(end);
+    const block = `${begin}\n${replacement.trimEnd()}\n${end}`;
+    const re = new RegExp(`${escapedBegin}[\\s\\S]*?${escapedEnd}`, 'm');
+    if (re.test(content)) {
+        return content.replace(re, block);
+    }
+    const sep = content.length === 0 || content.endsWith('\n') ? '' : '\n';
+    return `${content}${sep}\n${block}\n`;
+}
+/**
+ * Remove the wizard-managed block (used by uninstall). Returns content untouched
+ * if no markers exist.
+ */
+export function removeManagedBlock(content, style) {
+    const { begin, end } = markerPair(style);
+    const re = new RegExp(`\\n?${escapeRegExp(begin)}[\\s\\S]*?${escapeRegExp(end)}\\n?`, 'm');
+    return content.replace(re, '');
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=markers.js.map

package/dist/patchers/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.js","sourceRoot":"","sources":["../../src/patchers/markers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,MAAM,CAAC,MAAM,UAAU,GAAG,yBAAyB,cAAc,oBAAoB,CAAC;AACtF,MAAM,CAAC,MAAM,QAAQ,GAAG,yBAAyB,cAAc,MAAM,CAAC;AAEtE,MAAM,CAAC,MAAM,WAAW,GAAG,0BAA0B,cAAc,oBAAoB,CAAC;AACxF,MAAM,CAAC,MAAM,SAAS,GAAG,0BAA0B,cAAc,MAAM,CAAC;AAIxE,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,KAAK,KAAK,MAAM;QACrB,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE;QACtC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,YAAY,GAAG,gDAAgD,CAAC;AAEtE,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,WAAmB,EACnB,KAAkB;IAElB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,GAAG,KAAK,KAAK,WAAW,CAAC,OAAO,EAAE,KAAK,GAAG,EAAE,CAAC;IAC3D,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,aAAa,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;IACrE,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,OAAO,GAAG,OAAO,GAAG,GAAG,KAAK,KAAK,IAAI,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAkB;IACpE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,aAAa,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3F,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/dist/patchers/source-block.d.ts

@@ -0,0 +1,24 @@
+import { Transaction } from '../transaction/tx.js';
+import { type MarkerStyle } from './markers.js';
+/**
+ * Append (or update) a managed-block region inside a source file.
+ *
+ * Use this for cases where AST patching is risky/insufficient — for example,
+ * appending `AllStak.init({...})` at the top of a Node entry script, where we
+ * don't want to refactor user code, only add ours.
+ *
+ * For JS/TS targets we re-parse the result via magicast to confirm validity.
+ */
+export declare function appendManagedBlock(tx: Transaction, filePath: string, block: string, options: {
+    style: MarkerStyle;
+    /** When true, validate the result parses as a JS/TS module. */
+    validateJs?: boolean;
+    /** Used when file does not yet exist (e.g. instrumentation.ts). */
+    defaultEmpty?: string;
+}): Promise<{
+    changed: boolean;
+}>;
+export declare function removeManagedSourceBlock(tx: Transaction, filePath: string, style: MarkerStyle): Promise<{
+    changed: boolean;
+}>;
+//# sourceMappingURL=source-block.d.ts.map

package/dist/patchers/source-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-block.d.ts","sourceRoot":"","sources":["../../src/patchers/source-block.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAA0C,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAExF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,KAAK,EAAE,WAAW,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAQ/B;AAED,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAW/B"}

package/dist/patchers/source-block.js

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { parseModule } from 'magicast';
+import { upsertManagedBlock, removeManagedBlock } from './markers.js';
+/**
+ * Append (or update) a managed-block region inside a source file.
+ *
+ * Use this for cases where AST patching is risky/insufficient — for example,
+ * appending `AllStak.init({...})` at the top of a Node entry script, where we
+ * don't want to refactor user code, only add ours.
+ *
+ * For JS/TS targets we re-parse the result via magicast to confirm validity.
+ */
+export async function appendManagedBlock(tx, filePath, block, options) {
+    const existed = existsSync(filePath);
+    const current = existed ? readFileSync(filePath, 'utf8') : (options.defaultEmpty ?? '');
+    const next = upsertManagedBlock(current, block, options.style);
+    if (existed && next === current)
+        return { changed: false };
+    await tx.write(filePath, next, options.validateJs ? validateJs : undefined);
+    return { changed: true };
+}
+export async function removeManagedSourceBlock(tx, filePath, style) {
+    if (!existsSync(filePath))
+        return { changed: false };
+    const current = readFileSync(filePath, 'utf8');
+    const next = removeManagedBlock(current, style);
+    if (next === current)
+        return { changed: false };
+    if (next.trim() === '') {
+        await tx.delete(filePath);
+    }
+    else {
+        await tx.write(filePath, next);
+    }
+    return { changed: true };
+}
+async function validateJs(_path, content) {
+    parseModule(content);
+}
+//# sourceMappingURL=source-block.js.map

package/dist/patchers/source-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-block.js","sourceRoot":"","sources":["../../src/patchers/source-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAoB,MAAM,cAAc,CAAC;AAExF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAe,EACf,QAAgB,EAChB,KAAa,EACb,OAMC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,OAAO,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAE3D,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,EAAe,EACf,QAAgB,EAChB,KAAkB;IAElB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAChD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvB,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,KAAa,EAAE,OAAe;IACtD,WAAW,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,5 @@
+export declare function bootstrapRegistry(): void;
+export { registry } from './registry.js';
+export * from './types.js';
+export type { IntegrationManifest, StabilityLevel, Capability, CompatConstraint, FileExpectation, } from './manifest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAkBA,wBAAgB,iBAAiB,IAAI,IAAI,CAoBxC;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,42 @@
+import { registry } from './registry.js';
+import { reactIntegration } from '../integrations/react/index.js';
+import { nextIntegration } from '../integrations/next/index.js';
+import { jsIntegration } from '../integrations/js/index.js';
+import { expoIntegration } from '../integrations/expo.js';
+import { reactNativeIntegration } from '../integrations/react-native.js';
+import { nestjsIntegration } from '../integrations/nestjs.js';
+import { fastifyIntegration } from '../integrations/fastify.js';
+import { otelIntegration } from '../integrations/otel.js';
+import { pythonIntegration } from '../integrations/python.js';
+import { goIntegration } from '../integrations/go.js';
+import { javaIntegration } from '../integrations/java.js';
+import { phpIntegration } from '../integrations/php.js';
+import { rubyIntegration } from '../integrations/ruby.js';
+import { dotnetIntegration } from '../integrations/dotnet.js';
+import { flutterIntegration } from '../integrations/flutter.js';
+let bootstrapped = false;
+export function bootstrapRegistry() {
+    if (bootstrapped)
+        return;
+    // Validated:
+    registry.register(reactIntegration);
+    registry.register(nextIntegration);
+    registry.register(jsIntegration);
+    // Scaffolded (not validated end-to-end):
+    registry.register(expoIntegration);
+    registry.register(reactNativeIntegration);
+    registry.register(nestjsIntegration);
+    registry.register(fastifyIntegration);
+    registry.register(otelIntegration);
+    registry.register(pythonIntegration);
+    registry.register(goIntegration);
+    registry.register(javaIntegration);
+    registry.register(phpIntegration);
+    registry.register(rubyIntegration);
+    registry.register(dotnetIntegration);
+    registry.register(flutterIntegration);
+    bootstrapped = true;
+}
+export { registry } from './registry.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map