@sdt-tools/cli 0.2.0 → 0.2.6

package/dist/extract-VMMVRQVT.js

@@ -0,0 +1,102 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/extract.ts
+import path from "path";
+import { promises as fs } from "fs";
+import { Command } from "commander";
+import { catalog } from "@sdt-tools/core";
+import { getProfile, SnowflakeConnection } from "@sdt-tools/core/connection";
+import { AccountExtractor, defaultExtractors } from "@sdt-tools/core/extract";
+import { writeProjectTree } from "@sdt-tools/core/project";
+function extractCommand() {
+  const cmd = new Command("extract");
+  cmd.description("Extract a Snowflake account/database/schema into a project layout.").requiredOption("-c, --connection <profile>", "Connection profile name").requiredOption(
+    "-o, --output <path>",
+    "Target project directory (must contain a .sdtproj or pass --init)"
+  ).option("--db <database>", "Limit to a single database").option("--schema <schema>", "Limit to a single schema (requires --db)").option("--types <list>", "Comma-separated object types to include (default: all implemented)").option(
+    "--write-catalog-cache",
+    "Also write the extracted model to the EE1 catalog cache (.sdt/cache/<connection>/catalog.msgpack) so subsequent editor sessions have a populated cache without an extra `catalog refresh` round-trip.",
+    false
+  ).option(
+    "--use-catalog-cache",
+    "Read object metadata from the on-disk EE1 catalog cache instead of querying Snowflake. Fast / offline \u2014 no live connection required. Writes a catalog-snapshot.json to the output dir. Requires a prior `sdt catalog refresh` or `sdt extract --write-catalog-cache` run.",
+    false
+  ).action(async (opts) => {
+    if (opts.useCatalogCache) {
+      const out = path.resolve(String(opts.output));
+      await fs.mkdir(out, { recursive: true });
+      const cache = new catalog.CatalogCache({ root: out, connection: String(opts.connection) });
+      const snapshot = await cache.get();
+      if (snapshot.databases.length === 0 && snapshot.fingerprint === null) {
+        logger.error(
+          `No catalog cache found at ${cache.path}. Run "sdt catalog refresh -c ${String(opts.connection)}" or "sdt extract --write-catalog-cache" first.`
+        );
+        process.exitCode = 1;
+        return;
+      }
+      const outPath = path.join(out, ".sdt-cache", "catalog-snapshot.json");
+      await fs.mkdir(path.dirname(outPath), { recursive: true });
+      await fs.writeFile(outPath, JSON.stringify(snapshot, null, 2));
+      const objCount = snapshot.databases.flatMap(
+        (d) => d.schemas.flatMap((s) => s.objects)
+      ).length;
+      logger.success(
+        `Loaded ${objCount} object(s) from catalog cache (${snapshot.databases.length} database(s)) \u2192 ${outPath}`
+      );
+      logger.dim(
+        `Cache was snapshotted at ${snapshot.snapshotAt}. Use "sdt catalog refresh" to update it.`
+      );
+      return;
+    }
+    const profile = await getProfile(String(opts.connection));
+    const conn = new SnowflakeConnection(profile);
+    const include = opts.types ? new Set(
+      String(opts.types).split(",").map((s) => s.trim().toUpperCase())
+    ) : void 0;
+    logger.step(`Connecting to ${profile.account} as ${profile.auth.username}\u2026`);
+    await conn.connect();
+    try {
+      const account = new AccountExtractor(defaultExtractors());
+      const objects = await account.extract(
+        conn,
+        {
+          database: opts.db ? String(opts.db) : void 0,
+          schema: opts.schema ? String(opts.schema) : void 0
+        },
+        { include }
+      );
+      const out = path.resolve(String(opts.output));
+      await fs.mkdir(out, { recursive: true });
+      const dumpPath = path.join(out, ".sdt-cache", "extracted.json");
+      await fs.mkdir(path.dirname(dumpPath), { recursive: true });
+      await fs.writeFile(dumpPath, JSON.stringify(objects, null, 2));
+      const filesCreated = await writeProjectTree(out, objects);
+      logger.success(
+        `Extracted ${objects.length} object(s) \u2192 ${filesCreated} .sql file(s) under ${out} (cache: ${dumpPath}).`
+      );
+      if (opts.writeCatalogCache) {
+        const snapshot = catalog.snapshotFromObjects(objects, {
+          connection: String(opts.connection)
+        });
+        const cache = new catalog.CatalogCache({
+          root: out,
+          connection: String(opts.connection)
+        });
+        await cache.set(snapshot);
+        logger.success(
+          `Wrote catalog cache \u2192 ${cache.path} (${snapshot.databases.length} database(s), ${objects.length} object(s)).`
+        );
+      }
+    } finally {
+      await conn.disconnect();
+    }
+  });
+  return cmd;
+}
+export {
+  extractCommand
+};
+//# sourceMappingURL=extract-VMMVRQVT.js.map

package/dist/extract-VMMVRQVT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/extract.ts"],"sourcesContent":["import path from 'node:path';\nimport { promises as fs } from 'node:fs';\nimport { Command } from 'commander';\nimport { catalog } from '@sdt-tools/core';\nimport { getProfile, SnowflakeConnection } from '@sdt-tools/core/connection';\nimport { AccountExtractor, defaultExtractors } from '@sdt-tools/core/extract';\nimport { writeProjectTree } from '@sdt-tools/core/project';\nimport { logger } from '../util/logger.js';\n\nexport function extractCommand(): Command {\n  const cmd = new Command('extract');\n  cmd\n    .description('Extract a Snowflake account/database/schema into a project layout.')\n    .requiredOption('-c, --connection <profile>', 'Connection profile name')\n    .requiredOption(\n      '-o, --output <path>',\n      'Target project directory (must contain a .sdtproj or pass --init)',\n    )\n    .option('--db <database>', 'Limit to a single database')\n    .option('--schema <schema>', 'Limit to a single schema (requires --db)')\n    .option('--types <list>', 'Comma-separated object types to include (default: all implemented)')\n    .option(\n      '--write-catalog-cache',\n      'Also write the extracted model to the EE1 catalog cache (.sdt/cache/<connection>/catalog.msgpack) so subsequent editor sessions have a populated cache without an extra `catalog refresh` round-trip.',\n      false,\n    )\n    .option(\n      '--use-catalog-cache',\n      'Read object metadata from the on-disk EE1 catalog cache instead of querying Snowflake. Fast / offline — no live connection required. Writes a catalog-snapshot.json to the output dir. Requires a prior `sdt catalog refresh` or `sdt extract --write-catalog-cache` run.',\n      false,\n    )\n    .action(async (opts) => {\n      if (opts.useCatalogCache) {\n        const out = path.resolve(String(opts.output));\n        await fs.mkdir(out, { recursive: true });\n        const cache = new catalog.CatalogCache({ root: out, connection: String(opts.connection) });\n        const snapshot = await cache.get();\n        if (snapshot.databases.length === 0 && snapshot.fingerprint === null) {\n          logger.error(\n            `No catalog cache found at ${cache.path}. Run \"sdt catalog refresh -c ${String(opts.connection)}\" or \"sdt extract --write-catalog-cache\" first.`,\n          );\n          process.exitCode = 1;\n          return;\n        }\n        const outPath = path.join(out, '.sdt-cache', 'catalog-snapshot.json');\n        await fs.mkdir(path.dirname(outPath), { recursive: true });\n        await fs.writeFile(outPath, JSON.stringify(snapshot, null, 2));\n        const objCount = snapshot.databases.flatMap((d) =>\n          d.schemas.flatMap((s) => s.objects),\n        ).length;\n        logger.success(\n          `Loaded ${objCount} object(s) from catalog cache (${snapshot.databases.length} database(s)) → ${outPath}`,\n        );\n        logger.dim(\n          `Cache was snapshotted at ${snapshot.snapshotAt}. Use \"sdt catalog refresh\" to update it.`,\n        );\n        return;\n      }\n\n      const profile = await getProfile(String(opts.connection));\n      const conn = new SnowflakeConnection(profile);\n      const include = opts.types\n        ? new Set(\n            String(opts.types)\n              .split(',')\n              .map((s) => s.trim().toUpperCase()),\n          )\n        : undefined;\n      logger.step(`Connecting to ${profile.account} as ${profile.auth.username}…`);\n      await conn.connect();\n      try {\n        const account = new AccountExtractor(defaultExtractors());\n        const objects = await account.extract(\n          conn,\n          {\n            database: opts.db ? String(opts.db) : undefined,\n            schema: opts.schema ? String(opts.schema) : undefined,\n          },\n          { include },\n        );\n        const out = path.resolve(String(opts.output));\n        await fs.mkdir(out, { recursive: true });\n        const dumpPath = path.join(out, '.sdt-cache', 'extracted.json');\n        await fs.mkdir(path.dirname(dumpPath), { recursive: true });\n        await fs.writeFile(dumpPath, JSON.stringify(objects, null, 2));\n        const filesCreated = await writeProjectTree(out, objects);\n        logger.success(\n          `Extracted ${objects.length} object(s) → ${filesCreated} .sql file(s) under ${out} (cache: ${dumpPath}).`,\n        );\n\n        if (opts.writeCatalogCache) {\n          const snapshot = catalog.snapshotFromObjects(objects, {\n            connection: String(opts.connection),\n          });\n          const cache = new catalog.CatalogCache({\n            root: out,\n            connection: String(opts.connection),\n          });\n          await cache.set(snapshot);\n          logger.success(\n            `Wrote catalog cache → ${cache.path} (${snapshot.databases.length} database(s), ${objects.length} object(s)).`,\n          );\n        }\n      } finally {\n        await conn.disconnect();\n      }\n    });\n  return cmd;\n}\n"],"mappings":"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","names":[]}

package/dist/features-LE6BDZ2S.js

@@ -0,0 +1,59 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/features.ts
+import { Command } from "commander";
+import { features as featuresApi, license as licenseApi } from "@sdt-tools/core";
+function featuresCommand() {
+  const cmd = new Command("features");
+  cmd.description(
+    "Browse SDT features. Free users see paid features too \u2014 with copy explaining what each one does and how to unlock it."
+  );
+  cmd.command("list").description("List every feature with its tier and your current access state.").action(async () => {
+    const license = await licenseApi.loadLicense();
+    const rows = featuresApi.listFeatureAvailability(license);
+    const tierWidth = Math.max(...rows.map((r) => r.feature.tier.length), 4);
+    const nameWidth = Math.max(...rows.map((r) => r.feature.name.length), 4);
+    let lastTier = "";
+    for (const row of rows) {
+      if (row.feature.tier !== lastTier) {
+        if (lastTier !== "") process.stdout.write("\n");
+        process.stdout.write(`\u2500\u2500 ${row.feature.tier.toUpperCase()} \u2500\u2500
+`);
+        lastTier = row.feature.tier;
+      }
+      const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+      process.stdout.write(
+        `  ${pad(row.state, 22)}  ${pad(row.feature.name, nameWidth)}  ${row.feature.summary}
+`
+      );
+    }
+    void tierWidth;
+    process.stdout.write(
+      "\nRun `sdt features show <id>` for the full pitch. `sdt features upgrade` shows the path to the next tier.\n"
+    );
+  });
+  cmd.command("show <id>").description("Print the full pitch + unlock path for one feature.").action(async (id) => {
+    const feature = featuresApi.getFeature(id);
+    if (!feature) {
+      logger.error(`Unknown feature id: "${id}". Run \`sdt features list\` to see all ids.`);
+      process.exitCode = 1;
+      return;
+    }
+    const license = await licenseApi.loadLicense();
+    const available = featuresApi.isFeatureAvailable(feature, license);
+    const body = available ? featuresApi.unlockedFeatureMessage(feature) : featuresApi.lockedFeatureMessage(feature);
+    process.stdout.write(body + "\n");
+  });
+  cmd.command("upgrade").description("Show what each paid tier would unlock for your current license.").action(async () => {
+    const license = await licenseApi.loadLicense();
+    process.stdout.write(featuresApi.upgradeSummary(license) + "\n");
+  });
+  return cmd;
+}
+export {
+  featuresCommand
+};
+//# sourceMappingURL=features-LE6BDZ2S.js.map

package/dist/features-LE6BDZ2S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/features.ts"],"sourcesContent":["/**\n * `sdt features` — browse the SDT feature catalog regardless of tier.\n *\n * The point: every user can see every feature, with copy that explains\n * what it does and exactly what would unlock it. Better UX than silent\n * gates (\"why doesn't `--map-rewrite-strings` work?\") or surprise\n * paywalls at the command line.\n *\n * Subcommands:\n *   sdt features list                Show all features with state (✅ / 🔒 / 🚧).\n *   sdt features show <id>           Full pitch + unlock path for one feature.\n *   sdt features upgrade             What each paid tier would unlock for you.\n */\nimport { Command } from 'commander';\nimport { features as featuresApi, license as licenseApi } from '@sdt-tools/core';\nimport { logger } from '../util/logger.js';\n\nexport function featuresCommand(): Command {\n  const cmd = new Command('features');\n  cmd.description(\n    'Browse SDT features. Free users see paid features too — with copy explaining what each one does and how to unlock it.',\n  );\n\n  cmd\n    .command('list')\n    .description('List every feature with its tier and your current access state.')\n    .action(async () => {\n      const license = await licenseApi.loadLicense();\n      const rows = featuresApi.listFeatureAvailability(license);\n\n      const tierWidth = Math.max(...rows.map((r) => r.feature.tier.length), 4);\n      const nameWidth = Math.max(...rows.map((r) => r.feature.name.length), 4);\n\n      // Group output by tier for readability.\n      let lastTier = '';\n      for (const row of rows) {\n        if (row.feature.tier !== lastTier) {\n          if (lastTier !== '') process.stdout.write('\\n');\n          process.stdout.write(`── ${row.feature.tier.toUpperCase()} ──\\n`);\n          lastTier = row.feature.tier;\n        }\n        const pad = (s: string, w: number): string => s + ' '.repeat(Math.max(0, w - s.length));\n        process.stdout.write(\n          `  ${pad(row.state, 22)}  ${pad(row.feature.name, nameWidth)}  ${row.feature.summary}\\n`,\n        );\n      }\n      void tierWidth;\n      process.stdout.write(\n        '\\nRun `sdt features show <id>` for the full pitch. `sdt features upgrade` shows the path to the next tier.\\n',\n      );\n    });\n\n  cmd\n    .command('show <id>')\n    .description('Print the full pitch + unlock path for one feature.')\n    .action(async (id: string) => {\n      const feature = featuresApi.getFeature(id);\n      if (!feature) {\n        logger.error(`Unknown feature id: \"${id}\". Run \\`sdt features list\\` to see all ids.`);\n        process.exitCode = 1;\n        return;\n      }\n      const license = await licenseApi.loadLicense();\n      const available = featuresApi.isFeatureAvailable(feature, license);\n      const body = available\n        ? featuresApi.unlockedFeatureMessage(feature)\n        : featuresApi.lockedFeatureMessage(feature);\n      process.stdout.write(body + '\\n');\n    });\n\n  cmd\n    .command('upgrade')\n    .description('Show what each paid tier would unlock for your current license.')\n    .action(async () => {\n      const license = await licenseApi.loadLicense();\n      process.stdout.write(featuresApi.upgradeSummary(license) + '\\n');\n    });\n\n  return cmd;\n}\n"],"mappings":";;;;;;AAaA,SAAS,eAAe;AACxB,SAAS,YAAY,aAAa,WAAW,kBAAkB;AAGxD,SAAS,kBAA2B;AACzC,QAAM,MAAM,IAAI,QAAQ,UAAU;AAClC,MAAI;AAAA,IACF;AAAA,EACF;AAEA,MACG,QAAQ,MAAM,EACd,YAAY,iEAAiE,EAC7E,OAAO,YAAY;AAClB,UAAM,UAAU,MAAM,WAAW,YAAY;AAC7C,UAAM,OAAO,YAAY,wBAAwB,OAAO;AAExD,UAAM,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM,EAAE,QAAQ,KAAK,MAAM,GAAG,CAAC;AACvE,UAAM,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM,EAAE,QAAQ,KAAK,MAAM,GAAG,CAAC;AAGvE,QAAI,WAAW;AACf,eAAW,OAAO,MAAM;AACtB,UAAI,IAAI,QAAQ,SAAS,UAAU;AACjC,YAAI,aAAa,GAAI,SAAQ,OAAO,MAAM,IAAI;AAC9C,gBAAQ,OAAO,MAAM,gBAAM,IAAI,QAAQ,KAAK,YAAY,CAAC;AAAA,CAAO;AAChE,mBAAW,IAAI,QAAQ;AAAA,MACzB;AACA,YAAM,MAAM,CAAC,GAAW,MAAsB,IAAI,IAAI,OAAO,KAAK,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC;AACtF,cAAQ,OAAO;AAAA,QACb,KAAK,IAAI,IAAI,OAAO,EAAE,CAAC,KAAK,IAAI,IAAI,QAAQ,MAAM,SAAS,CAAC,KAAK,IAAI,QAAQ,OAAO;AAAA;AAAA,MACtF;AAAA,IACF;AACA,SAAK;AACL,YAAQ,OAAO;AAAA,MACb;AAAA,IACF;AAAA,EACF,CAAC;AAEH,MACG,QAAQ,WAAW,EACnB,YAAY,qDAAqD,EACjE,OAAO,OAAO,OAAe;AAC5B,UAAM,UAAU,YAAY,WAAW,EAAE;AACzC,QAAI,CAAC,SAAS;AACZ,aAAO,MAAM,wBAAwB,EAAE,8CAA8C;AACrF,cAAQ,WAAW;AACnB;AAAA,IACF;AACA,UAAM,UAAU,MAAM,WAAW,YAAY;AAC7C,UAAM,YAAY,YAAY,mBAAmB,SAAS,OAAO;AACjE,UAAM,OAAO,YACT,YAAY,uBAAuB,OAAO,IAC1C,YAAY,qBAAqB,OAAO;AAC5C,YAAQ,OAAO,MAAM,OAAO,IAAI;AAAA,EAClC,CAAC;AAEH,MACG,QAAQ,SAAS,EACjB,YAAY,iEAAiE,EAC7E,OAAO,YAAY;AAClB,UAAM,UAAU,MAAM,WAAW,YAAY;AAC7C,YAAQ,OAAO,MAAM,YAAY,eAAe,OAAO,IAAI,IAAI;AAAA,EACjE,CAAC;AAEH,SAAO;AACT;","names":[]}

package/dist/feedback-M7DM2EQC.js

@@ -0,0 +1,161 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/feedback.ts
+import { promises as fs } from "fs";
+import path from "path";
+import os from "os";
+import { Command } from "commander";
+import { license } from "@sdt-tools/core";
+var DEFAULT_INGEST_URL = process.env.SDT_FEEDBACK_URL ?? "https://sdt-support.sdt-ddt-tools.workers.dev/ingest";
+var OUTBOX_DIR = path.join(os.homedir(), ".sdt", "feedback");
+function feedbackCommand() {
+  const cmd = new Command("feedback");
+  cmd.description("Send a feedback / bug / feature-request ticket to the SDT team.").argument("<message...>", "The feedback body (quote to keep as one arg).").option("--category <kind>", "Category: bug | feature | question | docs | other", "other").option(
+    "--contact <email>",
+    "Reply-to email (optional; otherwise we use the license email if any)."
+  ).option("--no-context", "Skip auto-capture of CLI version / OS / recent commands.").option("--dry-run", "Print the payload without sending or queueing.").option("--url <url>", `Override the ingest endpoint. Default ${DEFAULT_INGEST_URL}.`).action(async (messageParts, opts) => {
+    const body = (messageParts ?? []).join(" ").trim();
+    if (!body) {
+      logger.error("Empty feedback body \u2014 nothing to send.");
+      process.exitCode = 1;
+      return;
+    }
+    const payload = await buildPayload(body, opts);
+    if (opts.dryRun) {
+      console.log(JSON.stringify(payload, null, 2));
+      return;
+    }
+    try {
+      await sendOrQueue(payload, String(opts.url ?? DEFAULT_INGEST_URL));
+      logger.success("Feedback sent. Thank you!");
+      logger.dim("  You should hear back within 1 business day for Pro+ accounts.");
+      if (!payload.licenseEmail) {
+        logger.dim("  Tip: install a license (`sdt license activate`) so we can reach you.");
+      }
+      const extended = await license.extendTrial(1);
+      if (extended) {
+        logger.dim(
+          `  Feedback bonus: +1 trial day (now expires ${extended.expiresAt.slice(0, 10)}).`
+        );
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      logger.warn(`Couldn't reach the ingest endpoint: ${message}`);
+      const queued = await queueLocally(payload);
+      logger.dim(`  Queued locally at ${queued}. Will retry on next \`sdt feedback\` run.`);
+    }
+  });
+  return cmd;
+}
+async function buildPayload(body, opts) {
+  const category = normalizeCategory(opts.category);
+  const payload = {
+    body,
+    product: "sdt",
+    productVersion: await readCliVersion(),
+    os: `${os.platform()} ${os.release()}`,
+    nodeVersion: process.version,
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    category
+  };
+  if (opts.contact) payload.contact = String(opts.contact);
+  if (opts.context !== false) {
+    payload.licenseEmail = await readLicenseEmail();
+    payload.recentCommands = await readRecentCommands();
+  }
+  return payload;
+}
+async function readCliVersion() {
+  try {
+    const pkgPath = path.join(
+      path.dirname(new URL(import.meta.url).pathname),
+      "..",
+      "..",
+      "package.json"
+    );
+    const raw = await fs.readFile(pkgPath, "utf8");
+    const obj = JSON.parse(raw);
+    return obj.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+async function readLicenseEmail() {
+  try {
+    const licensePath = path.join(os.homedir(), ".sdt", "license");
+    const raw = await fs.readFile(licensePath, "utf8");
+    const parts = raw.trim().split(".");
+    if (parts.length < 2) return void 0;
+    const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf8"));
+    if (typeof payload === "object" && payload !== null) {
+      const sub = payload.sub;
+      if (typeof sub === "string") return sub;
+    }
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function readRecentCommands() {
+  try {
+    const logPath = path.join(os.homedir(), ".sdt", "recent.log");
+    const raw = await fs.readFile(logPath, "utf8");
+    return raw.split(/\r?\n/).filter(Boolean).slice(-5);
+  } catch {
+    return void 0;
+  }
+}
+function normalizeCategory(input) {
+  const s = String(input ?? "other").toLowerCase();
+  if (s === "bug" || s === "feature" || s === "question" || s === "docs") return s;
+  return "other";
+}
+async function sendOrQueue(payload, url) {
+  await drainOutbox(url);
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(payload)
+  });
+  if (!res.ok) {
+    throw new Error(`HTTP ${res.status}`);
+  }
+}
+async function queueLocally(payload) {
+  await fs.mkdir(OUTBOX_DIR, { recursive: true });
+  const file = path.join(OUTBOX_DIR, `${Date.now()}-${randomTag()}.json`);
+  await fs.writeFile(file, JSON.stringify(payload, null, 2));
+  return file;
+}
+async function drainOutbox(url) {
+  try {
+    const entries = await fs.readdir(OUTBOX_DIR);
+    for (const entry of entries) {
+      if (!entry.endsWith(".json")) continue;
+      const file = path.join(OUTBOX_DIR, entry);
+      try {
+        const raw = await fs.readFile(file, "utf8");
+        const res = await fetch(url, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: raw
+        });
+        if (res.ok) {
+          await fs.unlink(file);
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
+function randomTag() {
+  return Math.random().toString(36).slice(2, 8);
+}
+export {
+  feedbackCommand
+};
+//# sourceMappingURL=feedback-M7DM2EQC.js.map

package/dist/feedback-M7DM2EQC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/feedback.ts"],"sourcesContent":["/**\n * `sdt feedback \"...\"` — submit a feedback / bug / feature-request\n * ticket from inside the tool.\n *\n * Lowest-friction reporting surface. From any terminal:\n *\n *   $ sdt feedback \"publish --apply takes 45s before doing anything\"\n *   Sent! Reference: #847.\n *\n * Auto-captures (with user consent on first run):\n *   - CLI version\n *   - OS + platform\n *   - License email (if a license is installed)\n *   - Last 5 sdt invocations from ~/.sdt/recent.log (if it exists)\n *\n * Writes to a local outbox first (~/.sdt/feedback/<timestamp>.json)\n * so failures don't lose the report. Drains the outbox in the\n * background. Endpoint is configurable; the default is the\n * project's ingest URL.\n *\n * See `docs/SUPPORT_OPERATIONS.md` for the ingest pipeline.\n */\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\nimport { Command } from 'commander';\nimport { logger } from '../util/logger.js';\nimport { license } from '@sdt-tools/core';\n\nconst DEFAULT_INGEST_URL =\n  process.env.SDT_FEEDBACK_URL ?? 'https://sdt-support.sdt-ddt-tools.workers.dev/ingest';\nconst OUTBOX_DIR = path.join(os.homedir(), '.sdt', 'feedback');\n\ninterface FeedbackPayload {\n  body: string;\n  product: 'sdt' | 'ddt';\n  productVersion: string;\n  os: string;\n  nodeVersion: string;\n  ts: string;\n  contact?: string;\n  licenseEmail?: string;\n  recentCommands?: string[];\n  category?: 'bug' | 'feature' | 'question' | 'docs' | 'other';\n}\n\nexport function feedbackCommand(): Command {\n  const cmd = new Command('feedback');\n  cmd\n    .description('Send a feedback / bug / feature-request ticket to the SDT team.')\n    .argument('<message...>', 'The feedback body (quote to keep as one arg).')\n    .option('--category <kind>', 'Category: bug | feature | question | docs | other', 'other')\n    .option(\n      '--contact <email>',\n      'Reply-to email (optional; otherwise we use the license email if any).',\n    )\n    .option('--no-context', 'Skip auto-capture of CLI version / OS / recent commands.')\n    .option('--dry-run', 'Print the payload without sending or queueing.')\n    .option('--url <url>', `Override the ingest endpoint. Default ${DEFAULT_INGEST_URL}.`)\n    .action(async (messageParts: string[], opts) => {\n      const body = (messageParts ?? []).join(' ').trim();\n      if (!body) {\n        logger.error('Empty feedback body — nothing to send.');\n        process.exitCode = 1;\n        return;\n      }\n      const payload = await buildPayload(body, opts);\n      if (opts.dryRun) {\n        console.log(JSON.stringify(payload, null, 2));\n        return;\n      }\n      try {\n        await sendOrQueue(payload, String(opts.url ?? DEFAULT_INGEST_URL));\n        logger.success('Feedback sent. Thank you!');\n        logger.dim('  You should hear back within 1 business day for Pro+ accounts.');\n        if (!payload.licenseEmail) {\n          logger.dim('  Tip: install a license (`sdt license activate`) so we can reach you.');\n        }\n        const extended = await license.extendTrial(1);\n        if (extended) {\n          logger.dim(\n            `  Feedback bonus: +1 trial day (now expires ${extended.expiresAt.slice(0, 10)}).`,\n          );\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        logger.warn(`Couldn't reach the ingest endpoint: ${message}`);\n        const queued = await queueLocally(payload);\n        logger.dim(`  Queued locally at ${queued}. Will retry on next \\`sdt feedback\\` run.`);\n      }\n    });\n  return cmd;\n}\n\nasync function buildPayload(\n  body: string,\n  opts: { category?: string; contact?: string; context?: boolean },\n): Promise<FeedbackPayload> {\n  const category = normalizeCategory(opts.category);\n  const payload: FeedbackPayload = {\n    body,\n    product: 'sdt',\n    productVersion: await readCliVersion(),\n    os: `${os.platform()} ${os.release()}`,\n    nodeVersion: process.version,\n    ts: new Date().toISOString(),\n    category,\n  };\n  if (opts.contact) payload.contact = String(opts.contact);\n  if (opts.context !== false) {\n    payload.licenseEmail = await readLicenseEmail();\n    payload.recentCommands = await readRecentCommands();\n  }\n  return payload;\n}\n\nasync function readCliVersion(): Promise<string> {\n  try {\n    const pkgPath = path.join(\n      path.dirname(new URL(import.meta.url).pathname),\n      '..',\n      '..',\n      'package.json',\n    );\n    const raw = await fs.readFile(pkgPath, 'utf8');\n    const obj = JSON.parse(raw) as { version?: string };\n    return obj.version ?? 'unknown';\n  } catch {\n    return 'unknown';\n  }\n}\n\nasync function readLicenseEmail(): Promise<string | undefined> {\n  try {\n    const licensePath = path.join(os.homedir(), '.sdt', 'license');\n    const raw = await fs.readFile(licensePath, 'utf8');\n    // License is an Ed25519 JWT — sub claim carries the email. Decode the\n    // payload section without verifying (we just want the bound email for\n    // display).\n    const parts = raw.trim().split('.');\n    if (parts.length < 2) return undefined;\n    const payload: unknown = JSON.parse(Buffer.from(parts[1]!, 'base64url').toString('utf8'));\n    if (typeof payload === 'object' && payload !== null) {\n      const sub = (payload as { sub?: unknown }).sub;\n      if (typeof sub === 'string') return sub;\n    }\n    return undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function readRecentCommands(): Promise<string[] | undefined> {\n  try {\n    const logPath = path.join(os.homedir(), '.sdt', 'recent.log');\n    const raw = await fs.readFile(logPath, 'utf8');\n    return raw.split(/\\r?\\n/).filter(Boolean).slice(-5);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeCategory(input: unknown): FeedbackPayload['category'] {\n  const s = String(input ?? 'other').toLowerCase();\n  if (s === 'bug' || s === 'feature' || s === 'question' || s === 'docs') return s;\n  return 'other';\n}\n\nasync function sendOrQueue(payload: FeedbackPayload, url: string): Promise<void> {\n  // First: drain any previously-queued items (best effort).\n  await drainOutbox(url);\n  // Then send the new one.\n  const res = await fetch(url, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    body: JSON.stringify(payload),\n  });\n  if (!res.ok) {\n    throw new Error(`HTTP ${res.status}`);\n  }\n}\n\nasync function queueLocally(payload: FeedbackPayload): Promise<string> {\n  await fs.mkdir(OUTBOX_DIR, { recursive: true });\n  const file = path.join(OUTBOX_DIR, `${Date.now()}-${randomTag()}.json`);\n  await fs.writeFile(file, JSON.stringify(payload, null, 2));\n  return file;\n}\n\nasync function drainOutbox(url: string): Promise<void> {\n  try {\n    const entries = await fs.readdir(OUTBOX_DIR);\n    for (const entry of entries) {\n      if (!entry.endsWith('.json')) continue;\n      const file = path.join(OUTBOX_DIR, entry);\n      try {\n        const raw = await fs.readFile(file, 'utf8');\n        const res = await fetch(url, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json' },\n          body: raw,\n        });\n        if (res.ok) {\n          await fs.unlink(file);\n        }\n      } catch {\n        // Keep in outbox; will retry next time.\n      }\n    }\n  } catch {\n    // No outbox; nothing to drain.\n  }\n}\n\nfunction randomTag(): string {\n  return Math.random().toString(36).slice(2, 8);\n}\n"],"mappings":"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","names":[]}

package/dist/find-EME2JG2I.js

@@ -0,0 +1,176 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/find.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { homedir } from "os";
+import { Command } from "commander";
+import { features as featuresApi, license as licenseApi } from "@sdt-tools/core";
+import { complete } from "@sdt-tools/core/ai";
+import chalk from "chalk";
+function tierBadge(tier) {
+  switch (tier) {
+    case "free":
+      return chalk.green("Free");
+    case "pro":
+      return chalk.cyan("Pro");
+    case "team":
+      return chalk.yellow("Team");
+    case "enterprise":
+      return chalk.magenta("Enterprise");
+    default:
+      return tier;
+  }
+}
+function findCommand() {
+  const cmd = new Command("find");
+  cmd.description("Search SDT features by keyword \u2014 find what you want to do.").argument("<query...>", 'Keywords to search for (e.g. "drift detection", "multi-team").').option("-n, --limit <n>", "Max results to show.", "5").option("--format <fmt>", "Output format: text | json.", "text").option("--tier <tier>", "Filter by tier: free | pro | team | enterprise.").option("--shipped", "Only include shipped features (exclude roadmap).").option(
+    "--ai",
+    "DSC.4: escalate to the configured AI provider when deterministic search yields low-confidence hits. Costs tokens; default off."
+  ).option(
+    "--ai-threshold <n>",
+    "Confidence below which --ai triggers escalation (0..1, default 0.55).",
+    "0.55"
+  ).option(
+    "--no-ai-cache",
+    "DSC.4-followup: skip the on-disk intent cache and always re-query the AI provider when --ai escalates."
+  ).action(async (queryParts, opts) => {
+    const query = queryParts.join(" ").trim();
+    const limit = Math.max(1, parseInt(String(opts.limit), 10) || 5);
+    const fmt = String(opts.format ?? "text").toLowerCase();
+    const tierFilter = opts.tier;
+    const statusFilter = opts.shipped ? "shipped" : void 0;
+    const licenseObj = await licenseApi.loadLicense();
+    let hits = [];
+    let stage = 1;
+    let tokensUsed = 0;
+    let cacheHit = false;
+    if (opts.ai) {
+      const threshold = Math.max(0, Math.min(1, Number(opts.aiThreshold ?? "0.55")));
+      const cachePath = path.join(homedir(), ".sdt", "intent-cache.json");
+      const useCache = opts.aiCache !== false;
+      let cache = featuresApi.emptyIntentCache();
+      if (useCache) {
+        try {
+          const body = await fs.readFile(cachePath, "utf8");
+          cache = featuresApi.parseIntentCache(body);
+        } catch {
+        }
+        const cached = featuresApi.lookupIntent(cache, query);
+        if (cached) {
+          const idSet = new Set(cached.featureIds);
+          const matchedFeatures = featuresApi.SDT_FEATURE_CATALOG.filter(
+            (f) => idSet.has(f.id)
+          ).sort((a, b) => cached.featureIds.indexOf(a.id) - cached.featureIds.indexOf(b.id));
+          hits = matchedFeatures.slice(0, limit).map((f) => ({
+            feature: f,
+            score: 1,
+            matchedFields: ["ai-intent-cached"]
+          }));
+          stage = 2;
+          tokensUsed = 0;
+          cacheHit = true;
+        }
+      }
+      if (!cacheHit) {
+        const result = await featuresApi.intentMatch(
+          query,
+          featuresApi.SDT_FEATURE_CATALOG,
+          { limit, tier: tierFilter, status: statusFilter, threshold },
+          (messages) => complete(messages, { feature: "find.intent" })
+        );
+        hits = [...result.hits];
+        stage = result.stage;
+        tokensUsed = result.tokensUsed;
+        if (useCache && stage === 2 && hits.length > 0) {
+          const next = featuresApi.evictExpiredIntents(
+            featuresApi.addIntent(
+              cache,
+              query,
+              hits.map((h) => h.feature.id),
+              tokensUsed
+            )
+          );
+          try {
+            await fs.mkdir(path.dirname(cachePath), { recursive: true });
+            await fs.writeFile(cachePath, featuresApi.serializeIntentCache(next), "utf8");
+          } catch {
+          }
+        }
+      }
+    } else {
+      hits = featuresApi.searchFeatures(query, featuresApi.SDT_FEATURE_CATALOG, {
+        limit,
+        tier: tierFilter,
+        status: statusFilter
+      });
+    }
+    if (fmt === "json") {
+      process.stdout.write(
+        JSON.stringify(
+          hits.map((h) => ({
+            id: h.feature.id,
+            name: h.feature.name,
+            tier: h.feature.tier,
+            status: h.feature.status,
+            score: h.score,
+            matchedFields: h.matchedFields,
+            summary: h.feature.summary,
+            unlockHow: h.feature.unlockHow,
+            useCases: h.feature.useCases,
+            relatedFeatures: h.feature.relatedFeatures
+          })),
+          null,
+          2
+        ) + "\n"
+      );
+      return;
+    }
+    if (hits.length === 0) {
+      process.stdout.write(
+        chalk.dim(`  No features found for "${query}".
+`) + chalk.dim(`  Try: sdt features list \xB7 sdt explain <topic>
+`)
+      );
+      return;
+    }
+    process.stdout.write("\n");
+    for (const hit of hits) {
+      const avail = featuresApi.isFeatureAvailable(hit.feature, licenseObj);
+      const statusMark = hit.feature.status === "roadmap" ? chalk.dim("\u{1F6A7} roadmap") : avail ? chalk.green("\u2705 available") : chalk.dim("\u{1F512} locked");
+      process.stdout.write(
+        `  ${chalk.bold(hit.feature.name)} ${tierBadge(hit.feature.tier)}  ${statusMark}
+  ${chalk.dim(hit.feature.summary)}
+`
+      );
+      if (hit.feature.useCases && hit.feature.useCases.length > 0) {
+        process.stdout.write(chalk.dim(`  Use when: ${hit.feature.useCases[0]}
+`));
+      }
+      if (!avail && hit.feature.status === "shipped") {
+        process.stdout.write(chalk.dim(`  Unlock: ${hit.feature.unlockHow}
+`));
+      }
+      if (hit.feature.surfaces && hit.feature.surfaces.length > 0) {
+        process.stdout.write(
+          chalk.dim(`  Surface: ${hit.feature.surfaces.slice(0, 2).join(", ")}
+`)
+        );
+      }
+      process.stdout.write(chalk.dim(`  sdt features show ${hit.feature.id}
+
+`));
+    }
+    const aiNote = stage === 2 ? cacheHit ? " (AI-cached, 0 tokens)" : ` (AI-escalated, ${tokensUsed} tokens)` : "";
+    process.stdout.write(
+      chalk.dim(
+        `  ${hits.length} result${hits.length === 1 ? "" : "s"} for "${query}"${aiNote}. `
+      ) + chalk.dim("sdt features list \xB7 sdt features show <id>\n")
+    );
+  });
+  return cmd;
+}
+export {
+  findCommand
+};
+//# sourceMappingURL=find-EME2JG2I.js.map

package/dist/find-EME2JG2I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/find.ts"],"sourcesContent":["/**\n * `sdt find <query>` — search the SDT feature catalog by keyword.\n *\n * DSC.1: surface any SDT capability by describing what you want to do.\n *\n *   $ sdt find drift\n *   $ sdt find \"multi-team database\"\n *   $ sdt find compare --limit 3 --format json\n *\n * Reads the same catalog as `sdt features list`. Scoring favors exact\n * id/name/synonym matches over summary body matches. Results include\n * the unlock path so Free users know exactly what each feature needs.\n */\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { homedir } from 'node:os';\nimport { Command } from 'commander';\nimport { features as featuresApi, license as licenseApi } from '@sdt-tools/core';\nimport { complete } from '@sdt-tools/core/ai';\nimport chalk from 'chalk';\n\nfunction tierBadge(tier: string): string {\n  switch (tier) {\n    case 'free':\n      return chalk.green('Free');\n    case 'pro':\n      return chalk.cyan('Pro');\n    case 'team':\n      return chalk.yellow('Team');\n    case 'enterprise':\n      return chalk.magenta('Enterprise');\n    default:\n      return tier;\n  }\n}\n\nexport function findCommand(): Command {\n  const cmd = new Command('find');\n  cmd\n    .description('Search SDT features by keyword — find what you want to do.')\n    .argument('<query...>', 'Keywords to search for (e.g. \"drift detection\", \"multi-team\").')\n    .option('-n, --limit <n>', 'Max results to show.', '5')\n    .option('--format <fmt>', 'Output format: text | json.', 'text')\n    .option('--tier <tier>', 'Filter by tier: free | pro | team | enterprise.')\n    .option('--shipped', 'Only include shipped features (exclude roadmap).')\n    .option(\n      '--ai',\n      'DSC.4: escalate to the configured AI provider when deterministic search yields low-confidence hits. Costs tokens; default off.',\n    )\n    .option(\n      '--ai-threshold <n>',\n      'Confidence below which --ai triggers escalation (0..1, default 0.55).',\n      '0.55',\n    )\n    .option(\n      '--no-ai-cache',\n      'DSC.4-followup: skip the on-disk intent cache and always re-query the AI provider when --ai escalates.',\n    )\n    .action(async (queryParts: string[], opts) => {\n      const query = queryParts.join(' ').trim();\n      const limit = Math.max(1, parseInt(String(opts.limit), 10) || 5);\n      const fmt = String(opts.format ?? 'text').toLowerCase();\n      const tierFilter = opts.tier as 'free' | 'pro' | 'team' | 'enterprise' | undefined;\n      const statusFilter = opts.shipped ? ('shipped' as const) : undefined;\n\n      const licenseObj = await licenseApi.loadLicense();\n      let hits: ReturnType<typeof featuresApi.searchFeatures> = [];\n      let stage: 1 | 2 = 1;\n      let tokensUsed = 0;\n      let cacheHit = false;\n      if (opts.ai) {\n        const threshold = Math.max(0, Math.min(1, Number(opts.aiThreshold ?? '0.55')));\n        // DSC.4-followup — 24h-TTL disk cache at ~/.sdt/intent-cache.json.\n        // Skipped entirely when --no-ai-cache is passed; otherwise:\n        // load → check → maybe call → evict stale → save.\n        const cachePath = path.join(homedir(), '.sdt', 'intent-cache.json');\n        const useCache = opts.aiCache !== false;\n        let cache = featuresApi.emptyIntentCache();\n        if (useCache) {\n          try {\n            const body = await fs.readFile(cachePath, 'utf8');\n            cache = featuresApi.parseIntentCache(body);\n          } catch {\n            // No cache yet — start fresh.\n          }\n          const cached = featuresApi.lookupIntent(cache, query);\n          if (cached) {\n            const idSet = new Set(cached.featureIds);\n            const matchedFeatures = featuresApi.SDT_FEATURE_CATALOG.filter((f) =>\n              idSet.has(f.id),\n            ).sort((a, b) => cached.featureIds.indexOf(a.id) - cached.featureIds.indexOf(b.id));\n            hits = matchedFeatures.slice(0, limit).map((f) => ({\n              feature: f,\n              score: 1.0,\n              matchedFields: ['ai-intent-cached'],\n            }));\n            stage = 2;\n            tokensUsed = 0;\n            cacheHit = true;\n          }\n        }\n        if (!cacheHit) {\n          const result = await featuresApi.intentMatch(\n            query,\n            featuresApi.SDT_FEATURE_CATALOG,\n            { limit, tier: tierFilter, status: statusFilter, threshold },\n            (messages) => complete(messages, { feature: 'find.intent' }),\n          );\n          hits = [...result.hits];\n          stage = result.stage;\n          tokensUsed = result.tokensUsed;\n          // Cache only AI-escalated results — Stage 1 deterministic hits\n          // are already fast and don't need a cache round-trip.\n          if (useCache && stage === 2 && hits.length > 0) {\n            const next = featuresApi.evictExpiredIntents(\n              featuresApi.addIntent(\n                cache,\n                query,\n                hits.map((h) => h.feature.id),\n                tokensUsed,\n              ),\n            );\n            try {\n              await fs.mkdir(path.dirname(cachePath), { recursive: true });\n              await fs.writeFile(cachePath, featuresApi.serializeIntentCache(next), 'utf8');\n            } catch {\n              // Best-effort — don't fail the command if disk is full.\n            }\n          }\n        }\n      } else {\n        hits = featuresApi.searchFeatures(query, featuresApi.SDT_FEATURE_CATALOG, {\n          limit,\n          tier: tierFilter,\n          status: statusFilter,\n        });\n      }\n\n      if (fmt === 'json') {\n        process.stdout.write(\n          JSON.stringify(\n            hits.map((h) => ({\n              id: h.feature.id,\n              name: h.feature.name,\n              tier: h.feature.tier,\n              status: h.feature.status,\n              score: h.score,\n              matchedFields: h.matchedFields,\n              summary: h.feature.summary,\n              unlockHow: h.feature.unlockHow,\n              useCases: h.feature.useCases,\n              relatedFeatures: h.feature.relatedFeatures,\n            })),\n            null,\n            2,\n          ) + '\\n',\n        );\n        return;\n      }\n\n      if (hits.length === 0) {\n        process.stdout.write(\n          chalk.dim(`  No features found for \"${query}\".\\n`) +\n            chalk.dim(`  Try: sdt features list · sdt explain <topic>\\n`),\n        );\n        return;\n      }\n\n      process.stdout.write('\\n');\n      for (const hit of hits) {\n        const avail = featuresApi.isFeatureAvailable(hit.feature, licenseObj);\n        const statusMark =\n          hit.feature.status === 'roadmap'\n            ? chalk.dim('🚧 roadmap')\n            : avail\n              ? chalk.green('✅ available')\n              : chalk.dim('🔒 locked');\n\n        process.stdout.write(\n          `  ${chalk.bold(hit.feature.name)} ${tierBadge(hit.feature.tier)}  ${statusMark}\\n` +\n            `  ${chalk.dim(hit.feature.summary)}\\n`,\n        );\n        if (hit.feature.useCases && hit.feature.useCases.length > 0) {\n          process.stdout.write(chalk.dim(`  Use when: ${hit.feature.useCases[0]}\\n`));\n        }\n        if (!avail && hit.feature.status === 'shipped') {\n          process.stdout.write(chalk.dim(`  Unlock: ${hit.feature.unlockHow}\\n`));\n        }\n        if (hit.feature.surfaces && hit.feature.surfaces.length > 0) {\n          process.stdout.write(\n            chalk.dim(`  Surface: ${hit.feature.surfaces.slice(0, 2).join(', ')}\\n`),\n          );\n        }\n        process.stdout.write(chalk.dim(`  sdt features show ${hit.feature.id}\\n\\n`));\n      }\n\n      const aiNote =\n        stage === 2\n          ? cacheHit\n            ? ' (AI-cached, 0 tokens)'\n            : ` (AI-escalated, ${tokensUsed} tokens)`\n          : '';\n      process.stdout.write(\n        chalk.dim(\n          `  ${hits.length} result${hits.length === 1 ? '' : 's'} for \"${query}\"${aiNote}. `,\n        ) + chalk.dim('sdt features list · sdt features show <id>\\n'),\n      );\n    });\n  return cmd;\n}\n"],"mappings":"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","names":[]}