@vyuhlabs/dxkit 2.5.1 → 2.5.2

package/dist/update.d.ts

@@ -1,2 +1,43 @@
+import { Manifest, ManifestInstallFlags } from './types';
+/**
+ * Re-exports the shared type so callers within the update module can
+ * import either name. The canonical declaration lives in `./types` so
+ * the manifest schema is one place.
+ */
+export type InstallFlags = ManifestInstallFlags;
+/**
+ * Workspace-derived flag detection. Used in two cases:
+ *   1. The manifest doesn't carry `installFlags` (pre-2.5.2 manifests
+ *      written by dxkit 2.5.0 / 2.5.1).
+ *   2. Defensive fallback if manifest is corrupt / partial.
+ *
+ * False-positive risk is bounded — the installers themselves are
+ * idempotent and emit sidecars when they detect competing files, so
+ * even spurious detection can't clobber customer state.
+ */
+export declare function detectInstallFlags(cwd: string): InstallFlags;
+/**
+ * Resolves the install flags for an update. Manifest-stored values
+ * take precedence (canonical source of truth, set at init time);
+ * workspace detection is the fallback for legacy manifests.
+ *
+ * Returns the flags plus a `source` field so the caller can decide
+ * whether to self-migrate (write detected flags back to the manifest
+ * so the NEXT update reads them from the canonical source).
+ */
+export declare function resolveInstallFlags(manifest: Manifest, cwd: string): {
+    flags: InstallFlags;
+    source: 'manifest' | 'workspace-derived';
+};
+/**
+ * Patch `installFlags` into the on-disk manifest. Used by init (after
+ * ship-installers complete to record what actually landed) AND by
+ * update's self-migration path on legacy manifests.
+ *
+ * Idempotent: writing the same flags twice is a no-op. Defensive
+ * against a manifest file being deleted mid-flight (returns false in
+ * that case rather than throwing).
+ */
+export declare function writeInstallFlags(cwd: string, flags: InstallFlags): boolean;
 export declare function runUpdate(cwd: string, force: boolean, rescan?: boolean): Promise<void>;
 //# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAOA,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD1F"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAezD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAY5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,CAAA;CAAE,CAKnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAW3E;AAsBD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgI1F"}

package/dist/update.js

@@ -33,12 +33,88 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectInstallFlags = detectInstallFlags;
+exports.resolveInstallFlags = resolveInstallFlags;
+exports.writeInstallFlags = writeInstallFlags;
 exports.runUpdate = runUpdate;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const detect_1 = require("./detect");
 const generator_1 = require("./generator");
+const ship_installers_1 = require("./ship-installers");
 const logger = __importStar(require("./logger"));
+/**
+ * Workspace-derived flag detection. Used in two cases:
+ *   1. The manifest doesn't carry `installFlags` (pre-2.5.2 manifests
+ *      written by dxkit 2.5.0 / 2.5.1).
+ *   2. Defensive fallback if manifest is corrupt / partial.
+ *
+ * False-positive risk is bounded — the installers themselves are
+ * idempotent and emit sidecars when they detect competing files, so
+ * even spurious detection can't clobber customer state.
+ */
+function detectInstallFlags(cwd) {
+    return {
+        withDxkitAgents: fs.existsSync(path.join(cwd, '.claude', 'skills', 'dxkit-learn')),
+        withHooks: fs.existsSync(path.join(cwd, '.githooks', 'pre-push')),
+        withPrecommit: fs.existsSync(path.join(cwd, '.githooks', 'pre-commit')),
+        withDevcontainer: fs.existsSync(path.join(cwd, '.devcontainer', 'devcontainer.json')),
+        withCiGuardrails: fs.existsSync(path.join(cwd, '.github', 'workflows', 'dxkit-guardrails.yml')),
+        withBaselineRefresh: fs.existsSync(path.join(cwd, '.github', 'workflows', 'dxkit-baseline-refresh.yml')),
+        withPrReview: fs.existsSync(path.join(cwd, '.github', 'workflows', 'pr-review.yml')),
+    };
+}
+/**
+ * Resolves the install flags for an update. Manifest-stored values
+ * take precedence (canonical source of truth, set at init time);
+ * workspace detection is the fallback for legacy manifests.
+ *
+ * Returns the flags plus a `source` field so the caller can decide
+ * whether to self-migrate (write detected flags back to the manifest
+ * so the NEXT update reads them from the canonical source).
+ */
+function resolveInstallFlags(manifest, cwd) {
+    if (manifest.installFlags) {
+        return { flags: manifest.installFlags, source: 'manifest' };
+    }
+    return { flags: detectInstallFlags(cwd), source: 'workspace-derived' };
+}
+/**
+ * Patch `installFlags` into the on-disk manifest. Used by init (after
+ * ship-installers complete to record what actually landed) AND by
+ * update's self-migration path on legacy manifests.
+ *
+ * Idempotent: writing the same flags twice is a no-op. Defensive
+ * against a manifest file being deleted mid-flight (returns false in
+ * that case rather than throwing).
+ */
+function writeInstallFlags(cwd, flags) {
+    const manifestPath = path.join(cwd, '.vyuh-dxkit.json');
+    if (!fs.existsSync(manifestPath))
+        return false;
+    try {
+        const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+        manifest.installFlags = flags;
+        fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function mergeShipResult(agg, result) {
+    agg.created.push(...result.installed);
+    agg.skipped.push(...result.skipped);
+    // Sidecars are conflict-reference files written into a `.dxkit-reference/`
+    // subdir when the customer already had a competing file at the target
+    // path. Surface them as notes so the customer knows where to look for
+    // the reference content without conflating them with regular installs.
+    for (const sidecar of result.sidecars) {
+        agg.notes.push(`Sidecar reference: ${sidecar} (your file at the canonical path was preserved)`);
+    }
+    if (result.notes)
+        agg.notes.push(...result.notes);
+}
 async function runUpdate(cwd, force, rescan = false) {
     logger.header('vyuh-dxkit update');
     const manifestPath = path.join(cwd, '.vyuh-dxkit.json');
@@ -55,20 +131,37 @@ async function runUpdate(cwd, force, rescan = false) {
         process.exit(1);
     }
     logger.info(`Previous init: ${manifest.generatedAt} (mode: ${manifest.mode})`);
-    // Re-detect stack
+    const { flags, source } = resolveInstallFlags(manifest, cwd);
+    const flagSummary = Object.entries(flags)
+        .filter(([, v]) => v)
+        .map(([k]) => k)
+        .join(', ');
+    if (flagSummary) {
+        const sourceTag = source === 'manifest' ? 'manifest' : 'detected from workspace';
+        logger.info(`Install surfaces (${sourceTag}): ${flagSummary}`);
+    }
+    // Self-migrate: if the manifest didn't carry installFlags (legacy
+    // pre-2.5.2 manifest), stamp the detected flags back so the NEXT
+    // update reads from the canonical source instead of re-detecting.
+    if (source === 'workspace-derived') {
+        if (writeInstallFlags(cwd, flags)) {
+            logger.dim('  → Stamped install flags into manifest for future updates.');
+        }
+    }
     logger.info('Re-detecting stack...');
     const detected = (0, detect_1.detect)(cwd);
-    // Merge: new detection overrides, but preserve mode and thresholds from manifest
     const config = {
         ...detected,
         coverageThreshold: manifest.config.coverageThreshold,
         claudeCode: manifest.config.claudeCode,
     };
-    // Merge languages: keep enabled if previously enabled OR newly detected
+    // Merge languages: keep enabled if previously enabled OR newly detected.
+    // Preserves customer-pinned active packs even if detection no longer
+    // sees the source files (e.g. mid-refactor).
     for (const lang of Object.keys(config.languages)) {
         config.languages[lang] = config.languages[lang] || manifest.config.languages[lang];
     }
-    // If rescan requested, remove codebase skill so it gets regenerated
+    // --rescan: clear the codebase skill so it gets regenerated fresh.
     if (rescan) {
         const codebasePath = path.join(cwd, '.claude', 'skills', 'codebase');
         if (fs.existsSync(codebasePath)) {
@@ -76,18 +169,64 @@ async function runUpdate(cwd, force, rescan = false) {
             logger.info('Cleared codebase skill for rescan');
         }
     }
-    // Re-generate (noScan=false so codebase gets regenerated if rescan or first time)
-    const result = await (0, generator_1.generate)(cwd, config, manifest.mode, force, false);
-    // Summary
-    console.log('');
+    const aggregate = {
+        created: [],
+        skipped: [],
+        overwritten: [],
+        notes: [],
+    };
+    // ─── Core generation (templates + per-language rules + dxkit skills) ────
+    // Re-run the template-driven generator with the same withDxkitAgents
+    // choice the customer's original init landed on. Pre-this-change the
+    // update CLI always passed `withDxkitAgents=false` so the six dxkit-*
+    // skills never got refreshed — a new dxkit-* skill prose change in a
+    // later dxkit version couldn't reach customers who'd already initialized.
+    const generated = await (0, generator_1.generate)(cwd, config, manifest.mode, force, false, flags.withDxkitAgents);
+    aggregate.created.push(...generated.created);
+    aggregate.skipped.push(...generated.skipped);
+    aggregate.overwritten.push(...generated.overwritten);
+    // ─── Optional ship surfaces (devcontainer / hooks / CI / PR review) ─────
+    // Each installer is idempotent and renders sidecars when the customer
+    // has a conflicting file unless --force is passed. So re-running them
+    // here picks up template changes (e.g. the per-stack devcontainer
+    // extensions from 2.5.1 / Sprint 1.5) without clobbering customer edits.
+    if (flags.withDevcontainer) {
+        mergeShipResult(aggregate, (0, ship_installers_1.installDevcontainer)(cwd, { force }));
+    }
+    if (flags.withHooks) {
+        mergeShipResult(aggregate, (0, ship_installers_1.installHooks)(cwd, { force, withPrecommit: flags.withPrecommit }));
+        // The postinstall hook chain — reinstall in case the customer's
+        // package.json grew its own postinstall after init landed.
+        mergeShipResult(aggregate, (0, ship_installers_1.installHooksPostinstall)(cwd, { force }));
+    }
+    if (flags.withCiGuardrails) {
+        mergeShipResult(aggregate, (0, ship_installers_1.installCiGuardrails)(cwd, { force }));
+    }
+    if (flags.withBaselineRefresh) {
+        mergeShipResult(aggregate, (0, ship_installers_1.installCiBaselineRefresh)(cwd, { force }));
+    }
+    if (flags.withPrReview) {
+        mergeShipResult(aggregate, (0, ship_installers_1.installPrReview)(cwd, { force }));
+    }
+    // Ignore files (.gitignore + .dxkit-ignore) — always refresh because
+    // their content can grow with new dxkit features (e.g. graphify-out/
+    // entry added in 2.5.1).
+    mergeShipResult(aggregate, (0, ship_installers_1.installIgnoreFiles)(cwd, { force }));
+    // ─── Summary ───────────────────────────────────────────────────────────
+    console.log(''); // slop-ok
     logger.header('Update Summary');
-    if (result.created.length)
-        logger.success(`Created: ${result.created.length} new files`);
-    if (result.skipped.length)
-        logger.warn(`Skipped: ${result.skipped.length} files (preserved)`);
-    if (result.overwritten.length)
-        logger.info(`Updated: ${result.overwritten.length} files`);
-    console.log('');
+    if (aggregate.created.length) {
+        logger.success(`Created: ${aggregate.created.length} new file(s)`);
+    }
+    if (aggregate.overwritten.length) {
+        logger.info(`Updated: ${aggregate.overwritten.length} file(s)`);
+    }
+    if (aggregate.skipped.length) {
+        logger.warn(`Skipped: ${aggregate.skipped.length} file(s) (preserved — pass --force to overwrite)`);
+    }
+    for (const note of aggregate.notes)
+        logger.dim(note);
+    console.log(''); // slop-ok
     logger.success('Update complete. Evolved files (gotchas, conventions) preserved.');
 }
 //# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/dist/upgrade.d.ts

@@ -0,0 +1,88 @@
+/**
+ * `vyuh-dxkit upgrade` — combined CLI for the dxkit upgrade flow.
+ *
+ * Two modes, one subcommand:
+ *
+ *   `--plan [--json]` — preview only. Emits UpgradePlan JSON
+ *   (consumed by dxkit-update skill) or text-prose summary. No
+ *   mutations. Used to inspect what an upgrade would do before
+ *   committing.
+ *
+ *   (no flag, or `--yes`) — execute. Runs the three-step upgrade:
+ *     1. `npm install @vyuhlabs/dxkit@<target>`     (binary)
+ *     2. `npx vyuh-dxkit update`                    (scaffold refresh)
+ *     3. `npx vyuh-dxkit doctor`                    (verify)
+ *   Then prints devcontainer-rebuild instructions if .devcontainer/
+ *   was refreshed.
+ *
+ * Architectural mirror of the doctor → dxkit-fix pattern: structured
+ * CLI output (--plan --json) for skill consumption, execution mode
+ * for direct human use. Same shape, different content.
+ */
+export type DeltaKind = 'none' | 'patch' | 'minor' | 'major' | 'downgrade';
+export interface UpgradeStep {
+    /** Shell command to run (verbatim — what gets executed). */
+    command: string;
+    /** One-line purpose shown in plan + before each execution. */
+    purpose: string;
+    /** Optional steps the customer can decline (e.g. devcontainer rebuild). */
+    optional?: boolean;
+}
+export interface UpgradePlan {
+    schema: 'upgrade-plan.v1';
+    generatedAt: string;
+    cwd: string;
+    current: {
+        /** Installed binary version (from `npx vyuh-dxkit --version`). */
+        binary: string | null;
+        /** Scaffold version recorded in manifest. */
+        scaffold: string | null;
+    };
+    /** Target version — `--target=X.Y.Z` or 'latest' from npm. */
+    target: string;
+    delta: DeltaKind;
+    /**
+     * Recommended execution sequence. Each step is independently
+     * idempotent — re-running is safe.
+     */
+    steps: UpgradeStep[];
+    /**
+     * Customer-facing warnings (peer-dep risks, breaking changes,
+     * "devcontainer will need rebuild after"). Empty when nothing
+     * actionable.
+     */
+    warnings: string[];
+    /**
+     * Brief note pointing the customer at the canonical changelog.
+     * Detailed per-version highlight parsing is a future enhancement —
+     * for now we keep this simple and link to the source of truth.
+     */
+    changelogNote: string;
+}
+export interface UpgradeOpts {
+    /** Pin to a specific version. Default: latest from npm. */
+    target?: string;
+    /** Skip interactive confirmations. */
+    yes?: boolean;
+    /** Print commands without executing. */
+    dryRun?: boolean;
+    /** Emit plan only; don't execute. */
+    planOnly?: boolean;
+    /** Emit plan as JSON instead of prose (only meaningful with planOnly). */
+    json?: boolean;
+    /**
+     * Injectable version reads. Useful for tests that need deterministic
+     * plans without subprocess fanout; production code leaves these
+     * undefined and the readers shell out as needed.
+     */
+    _readBinary?: (cwd: string) => string | null;
+    _readLatest?: () => string;
+}
+/**
+ * Classify the delta between two semver-shaped strings. Returns
+ * `'none'` if equal, `'downgrade'` if target < current.
+ */
+export declare function classifyDelta(current: string | null, target: string): DeltaKind;
+export declare function buildUpgradePlan(cwd: string, opts?: UpgradeOpts): UpgradePlan;
+export declare function runUpgrade(cwd: string, opts?: UpgradeOpts): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE;QACP,kEAAkE;QAClE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,6CAA6C;QAC7C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AA4CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAY/E;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,WAAW,CA6FjF;AAyHD,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnF"}