@jhizzard/termdeck 0.6.1 → 0.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Browser-based terminal multiplexer with metadata overlays, panel flashback memory recall, and AI-aware session management",
   "bin": {
     "termdeck": "./packages/cli/src/index.js"

package/packages/cli/src/init-mnestra.js

@@ -5,15 +5,23 @@
 //
 // Steps:
 //   1. Collect Supabase URL, service_role key, direct DB URL, OpenAI + Anthropic keys
-//   2. Connect via `pg` using the direct URL
-//   3. Apply the six bundled Mnestra migrations in order
-//   4. Write ~/.termdeck/secrets.env (merge-aware, preserves existing values)
+//      (or reuse the saved set in ~/.termdeck/secrets.env if present)
+//   2. Persist ~/.termdeck/secrets.env immediately — merge-aware, preserves
+//      existing values. Done BEFORE any database work so a later pg connect
+//      or migration failure doesn't lose the user's typed-in keys.
+//   3. Connect via `pg` using the direct URL
+//   4. Apply the six bundled Mnestra migrations in order
 //   5. Update ~/.termdeck/config.yaml to enable RAG + point at ${VAR} refs
+//      (only after migrations apply cleanly — otherwise the server would
+//      try to use an incomplete schema on next startup)
 //   6. Verify with a memory_status_aggregation() call
 //
 // Flags:
 //   --help              Print usage and exit
-//   --yes               Accept defaults, skip confirmations (still prompts for secrets)
+//   --yes               Reuse saved secrets without re-prompting if a complete
+//                       set is already on disk (otherwise the wizard asks
+//                       interactively before reusing)
+//   --reset             Ignore saved secrets and re-prompt for everything
 //   --dry-run           Print what the wizard would do; don't touch the DB or filesystem
 //   --skip-verify       Skip the final memory_status_aggregation() check
 //
@@ -41,15 +49,19 @@ const HELP = [
   '',
   'Flags:',
   '  --help            Print this message and exit',
-  '  --yes             Assume "yes" on confirmations (still prompts for secret values)',
+  '  --yes             Reuse saved secrets without prompting (if a complete',
+  '                    set is already on disk in ~/.termdeck/secrets.env)',
+  '  --reset           Ignore saved secrets and re-prompt for everything',
   '  --dry-run         Print the plan without touching the database or filesystem',
   '  --skip-verify     Skip the final memory_status_aggregation() sanity call',
   '',
   'What this does:',
   '  1. Prompts for Supabase URL, service_role key, direct Postgres connection',
-  '     string, OpenAI API key, and (optional) Anthropic API key.',
-  '  2. Applies the six Mnestra schema + RPC migrations via node-postgres.',
-  '  3. Writes ~/.termdeck/secrets.env (merge-aware, preserves existing values).',
+  '     string, OpenAI API key, and (optional) Anthropic API key — or reuses',
+  '     saved values if a complete set already exists in secrets.env.',
+  '  2. Writes ~/.termdeck/secrets.env IMMEDIATELY (merge-aware) so a later',
+  '     pg connect or migration failure does not lose what you typed in.',
+  '  3. Connects to Postgres and applies the six Mnestra schema + RPC migrations.',
   '  4. Updates ~/.termdeck/config.yaml to enable RAG and reference ${VAR} keys.',
   '  5. Verifies the Mnestra store is reachable via memory_status_aggregation().',
   '',
@@ -58,10 +70,11 @@ const HELP = [
 ].join('\n');
 
 function parseFlags(argv) {
-  const out = { help: false, yes: false, dryRun: false, skipVerify: false };
+  const out = { help: false, yes: false, reset: false, dryRun: false, skipVerify: false };
   for (const a of argv) {
     if (a === '--help' || a === '-h') out.help = true;
     else if (a === '--yes' || a === '-y') out.yes = true;
+    else if (a === '--reset') out.reset = true;
     else if (a === '--dry-run') out.dryRun = true;
     else if (a === '--skip-verify') out.skipVerify = true;
   }
@@ -76,13 +89,18 @@ TermDeck Mnestra Setup
 This wizard configures TermDeck's Tier 2 memory layer (Mnestra) by:
   1. Asking for your Supabase URL and service_role key
   2. Asking for a direct Postgres connection string
-  3. Applying six SQL migrations to the database
-  4. Asking for an OpenAI API key (embeddings)
-  5. Asking for an Anthropic API key (optional, summaries)
-  6. Writing ~/.termdeck/secrets.env
-  7. Updating ~/.termdeck/config.yaml to enable RAG
+  3. Asking for an OpenAI API key (embeddings)
+  4. Asking for an Anthropic API key (optional, summaries)
+  5. Writing ~/.termdeck/secrets.env (before any database work, so a
+     pg failure cannot lose what you typed in)
+  6. Connecting to Postgres + applying six SQL migrations
+  7. Updating ~/.termdeck/config.yaml to enable RAG (only after
+     migrations apply cleanly)
   8. Verifying the connection with a memory_status call
 
+If you already have a complete ~/.termdeck/secrets.env, the wizard will
+offer to reuse it (or pass --yes to skip the prompt and resume directly).
+
 Press Ctrl+C at any time to cancel.
 
 `);
@@ -92,7 +110,59 @@ function step(msg) { process.stdout.write(`→ ${msg}`); }
 function ok(suffix = '') { process.stdout.write(` ✓${suffix ? ' ' + suffix : ''}\n`); }
 function fail(err) { process.stdout.write(` ✗\n    ${err}\n`); }
 
-async function collectInputs({ yes }) {
+// Read whatever secrets are already on disk. Returns hydrated input shape if
+// a complete set is present, or null if the user still needs to be prompted
+// for at least one required value. Anthropic remains optional throughout.
+function loadSavedSecrets() {
+  const saved = dotenv.readSecrets();
+  const required = ['SUPABASE_URL', 'SUPABASE_SERVICE_ROLE_KEY', 'DATABASE_URL', 'OPENAI_API_KEY'];
+  const present = required.filter((k) => saved[k]);
+  if (present.length < required.length) {
+    return { complete: false, present, saved };
+  }
+  const projectUrl = urlHelper.parseProjectUrl(saved.SUPABASE_URL);
+  if (!projectUrl.ok) return { complete: false, present, saved };
+  return {
+    complete: true,
+    present,
+    saved,
+    inputs: {
+      projectUrl,
+      serviceRoleKey: saved.SUPABASE_SERVICE_ROLE_KEY,
+      databaseUrl: saved.DATABASE_URL,
+      openaiKey: saved.OPENAI_API_KEY,
+      anthropicKey: saved.ANTHROPIC_API_KEY || null
+    }
+  };
+}
+
+async function collectInputs({ yes, reset }) {
+  // Resume path — Brad's case at 2026-04-25 17:50 ET ("If it got that far did
+  // it write the correct secret.env? If so, can I manually do the next steps?").
+  // If a complete set of secrets is already on disk, offer to reuse them so a
+  // re-run after a pg connect failure does not require retyping everything.
+  if (!reset) {
+    const found = loadSavedSecrets();
+    if (found.complete) {
+      const ref = found.inputs.projectUrl.projectRef;
+      const masked = urlHelper.maskSecret(found.inputs.databaseUrl);
+      process.stdout.write(
+        `Found saved secrets in ~/.termdeck/secrets.env (project ${ref}, db ${masked}).\n`
+      );
+      const reuse = yes ? true : await prompts.confirm('  Reuse saved secrets?', { defaultYes: true });
+      if (reuse) {
+        process.stdout.write('  Reusing saved secrets. Skipping prompts.\n\n');
+        return found.inputs;
+      }
+      process.stdout.write('  Re-prompting.\n\n');
+    } else if (found.present.length > 0) {
+      process.stdout.write(
+        `Note: ~/.termdeck/secrets.env has ${found.present.length}/4 required keys ` +
+        `(${found.present.join(', ')}). Re-prompting for the rest.\n\n`
+      );
+    }
+  }
+
   const projectUrlStr = await prompts.askRequired(
     '? Supabase Project URL (e.g. https://xyz.supabase.co)',
     {
@@ -129,14 +199,7 @@ async function collectInputs({ yes }) {
     }
   }
 
-  if (!yes) {
-    process.stdout.write('\n');
-    const go = await prompts.confirm(`Proceed with setup for project ${projectUrl.projectRef}?`);
-    if (!go) {
-      process.stdout.write('Cancelled.\n');
-      process.exit(0);
-    }
-  }
+  process.stdout.write('\n');
 
   return {
     projectUrl,
@@ -226,33 +289,39 @@ async function verifyStatus(client) {
   }
 }
 
-function writeLocalConfig(inputs, dryRun) {
+// Persist secrets BEFORE any pg work so a connect/migration failure can't
+// throw away what the user typed in. Brad's 2026-04-25 18:30 ET report
+// ("It's killing before writing the file. Postgrep line not added to my
+// existing file, so it wasn't changed") was caused by writeLocalConfig
+// running AFTER applyMigrations — when migrations or pg connect failed,
+// secrets.env was never updated. Splitting the writes lets secrets land
+// on disk first; config.yaml only flips to rag.enabled=true once the
+// schema is actually in place.
+function writeSecretsFile(inputs, dryRun) {
   step('Writing ~/.termdeck/secrets.env...');
-  if (dryRun) { ok('(dry-run)'); }
-  else {
-    dotenv.writeSecrets({
-      SUPABASE_URL: inputs.projectUrl.url,
-      SUPABASE_SERVICE_ROLE_KEY: inputs.serviceRoleKey,
-      DATABASE_URL: inputs.databaseUrl,
-      OPENAI_API_KEY: inputs.openaiKey,
-      ...(inputs.anthropicKey ? { ANTHROPIC_API_KEY: inputs.anthropicKey } : {})
-    });
-    ok();
-  }
+  if (dryRun) { ok('(dry-run)'); return; }
+  dotenv.writeSecrets({
+    SUPABASE_URL: inputs.projectUrl.url,
+    SUPABASE_SERVICE_ROLE_KEY: inputs.serviceRoleKey,
+    DATABASE_URL: inputs.databaseUrl,
+    OPENAI_API_KEY: inputs.openaiKey,
+    ...(inputs.anthropicKey ? { ANTHROPIC_API_KEY: inputs.anthropicKey } : {})
+  });
+  ok();
+}
 
+function writeYamlConfig(dryRun) {
   step('Updating ~/.termdeck/config.yaml (rag.enabled: true)...');
-  if (dryRun) { ok('(dry-run)'); }
-  else {
-    const r = yaml.updateRagConfig({
-      enabled: true,
-      supabaseUrl: '${SUPABASE_URL}',
-      supabaseKey: '${SUPABASE_SERVICE_ROLE_KEY}',
-      openaiApiKey: '${OPENAI_API_KEY}',
-      anthropicApiKey: '${ANTHROPIC_API_KEY}'
-    });
-    if (r.backup) ok(`(backup: ${path.basename(r.backup)})`);
-    else ok();
-  }
+  if (dryRun) { ok('(dry-run)'); return; }
+  const r = yaml.updateRagConfig({
+    enabled: true,
+    supabaseUrl: '${SUPABASE_URL}',
+    supabaseKey: '${SUPABASE_SERVICE_ROLE_KEY}',
+    openaiApiKey: '${OPENAI_API_KEY}',
+    anthropicApiKey: '${ANTHROPIC_API_KEY}'
+  });
+  if (r.backup) ok(`(backup: ${path.basename(r.backup)})`);
+  else ok();
 }
 
 function printNextSteps() {
@@ -267,6 +336,14 @@ Next steps:
 `);
 }
 
+function printResumeHint() {
+  process.stderr.write(
+    '\nYour secrets are saved at ~/.termdeck/secrets.env.\n' +
+    'To retry just the database step (no need to re-enter keys):\n' +
+    '  termdeck init --mnestra --yes\n'
+  );
+}
+
 async function main(argv) {
   const flags = parseFlags(argv || []);
   if (flags.help) {
@@ -278,18 +355,31 @@ async function main(argv) {
 
   let inputs;
   try {
-    inputs = await collectInputs({ yes: flags.yes });
+    inputs = await collectInputs({ yes: flags.yes, reset: flags.reset });
   } catch (err) {
     process.stderr.write(`\n[init --mnestra] ${err.message}\n`);
     return 2;
   }
 
+  // Persist secrets BEFORE pg work. If the wizard dies past this point
+  // (connect timeout, migration error, Ctrl-C), the saved file lets the
+  // user re-run with --yes and skip straight to the database step.
   process.stdout.write('\n');
+  try {
+    writeSecretsFile(inputs, flags.dryRun);
+  } catch (err) {
+    fail(err.message);
+    process.stderr.write(
+      '\nFailed to write ~/.termdeck/secrets.env. Check the directory is writable.\n'
+    );
+    return 6;
+  }
+
   step('Connecting to Supabase...');
   if (flags.dryRun) {
     ok('(dry-run, skipped)');
     await applyMigrations(null, true);
-    writeLocalConfig(inputs, true);
+    writeYamlConfig(true);
     process.stdout.write('\nDry run complete. No changes were made.\n');
     return 0;
   }
@@ -303,13 +393,14 @@ async function main(argv) {
     process.stderr.write(
       '\nDouble-check the connection string from Supabase → Project Settings → Database → Connection String.\n'
     );
+    printResumeHint();
     return 3;
   }
 
   try {
     await checkExistingStore(client);
     await applyMigrations(client, false);
-    writeLocalConfig(inputs, false);
+    writeYamlConfig(false);
     if (!flags.skipVerify) {
       const verified = await verifyStatus(client);
       if (!verified) {
@@ -323,6 +414,7 @@ async function main(argv) {
     }
   } catch (err) {
     process.stderr.write(`\n[init --mnestra] ${err.message}\n`);
+    printResumeHint();
     return 5;
   } finally {
     try { await client.end(); } catch (_err) { /* ignore */ }