@muggleai/works 5.16.0 → 5.17.0-staging.113

package/scripts/onboarding-backfill.mjs

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+
+/**
+ * Outcome of a backfill attempt.
+ * @typedef {object} BackfillResult
+ * @property {boolean} stamped - Whether a completion stamp was written.
+ * @property {string} reason - Why the attempt ended the way it did.
+ */
+
+/**
+ * Mark an existing installation as having already seen the first-run walkthrough.
+ *
+ * Postinstall runs before any `muggle setup`, so the preferences file exists at this
+ * moment only for someone who has already used Muggle. Stamping them here reserves the
+ * walkthrough for genuinely new installs, which have no file yet.
+ *
+ * @param {string} dataDir - The ~/.muggle-ai directory.
+ * @param {Date} [now] - Stamp timestamp; defaults to the current time.
+ * @returns {BackfillResult} What happened, for the caller to log.
+ */
+export function backfillOnboardingStamp(dataDir, now = new Date()) {
+    const preferencesPath = join(dataDir, "preferences.json");
+
+    if (!existsSync(preferencesPath)) {
+        return { stamped: false, reason: "new installation" };
+    }
+
+    let preferencesFile;
+    try {
+        preferencesFile = JSON.parse(readFileSync(preferencesPath, "utf-8"));
+    } catch (error) {
+        return { stamped: false, reason: `unreadable preferences file: ${error.message}` };
+    }
+
+    if (typeof preferencesFile.onboardingCompletedAt === "string" && preferencesFile.onboardingCompletedAt.length > 0) {
+        return { stamped: false, reason: "already stamped" };
+    }
+
+    preferencesFile.onboardingCompletedAt = now.toISOString();
+
+    try {
+        writeFileSync(preferencesPath, `${JSON.stringify(preferencesFile, null, 2)}\n`, "utf-8");
+    } catch (error) {
+        return { stamped: false, reason: `could not write preferences file: ${error.message}` };
+    }
+
+    return { stamped: true, reason: "existing installation" };
+}

package/scripts/postinstall.mjs

@@ -25,6 +25,7 @@ import { dirname, join } from "path";
 import { pipeline } from "stream/promises";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
+import { backfillOnboardingStamp } from "./onboarding-backfill.mjs";
 import {
     SIGNATURE_BUNDLE_SUFFIX,
     resolveIntegrityPolicy,
@@ -1010,10 +1011,21 @@ function syncClaudePluginCache() {
     }
 }
 
+/**
+ * Run the onboarding backfill and log only when it actually stamps.
+ */
+function logOnboardingBackfill() {
+    const result = backfillOnboardingStamp(join(homedir(), ".muggle-ai"));
+    if (result.stamped) {
+        log("Existing installation: first-run walkthrough marked as already seen.");
+    }
+}
+
 // Run postinstall. The explicit `process.exit` guarantees the script doesn't
 // linger when something below (a hung socket, an EPERM rmSync retry on
 // Windows) keeps the event loop alive — see issue #167.
 initLogFile();
+logOnboardingBackfill();
 removeVersionOverrideFile();
 syncCursorSkills();
 syncClaudePluginCache();

package/dist/src-EHF3T2T2.js

@@ -1 +0,0 @@
-export { DEFAULT_PREFERENCES, ElectronAppReleaseStream, PREFERENCES_FILE_NAME, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_SCHEMA, PREFERENCES_VERSION, PREFERENCE_ALLOWED_VALUES, PreferenceKey, PreferenceValue, ProjectPreferencesReconcileOutcome, RuntimeTarget, WATCHER_LIFETIME_SECONDS, WATCHER_LIFETIME_UNBOUNDED_SECONDS, assertDeviceCodeClientProvisioned, buildElectronAppChecksumsUrl, buildElectronAppReleaseAssetUrl, buildElectronAppReleaseTag, calculateFileChecksum, createApiKeyWithToken, createChildLogger, deleteApiKeyData, deleteCredentials, e2e_exports as e2e, formatPreferencesOneLiner, getActiveElectronAppReleaseStream, getActiveRuntimeTarget, getApiKey, getApiKeyFilePath, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getChecksumForPlatform, getConfig, getCredentialsFilePath, getDataDir, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppReleaseTagPrefix, getElectronAppSignedFromVersion, getElectronAppVersion, getElectronAppVersionSource, getLocalQaTools, getLogger, getPlatformKey, getQaTools, getReleaseSignerIdentityUri, getValidApiKeyData, getValidCredentials, hasApiKey, isElectronAppInstalled, isFirstRun, loadApiKeyData, loadCredentials, local_exports as localQa, mcp_exports as mcp, openBrowserUrl, performLogin, performLogout, pollDeviceCode, e2e_exports as qa, reconcileProjectPreferences, resetConfig, resetLogger, resetPreference, resolveActiveProfile, resolveActiveReleaseStream, resolveActiveReleaseTagPrefix, resolveElectronAppPathOrNull, resolvePreferences, resolveRuntimeTarget, saveApiKey, saveApiKeyData, saveCredentials, startDeviceCodeFlow, toolRequiresAuth, validatePreference, verifyFileChecksum, writePreferences } from './chunk-VQZLKLAY.js';