@fluentcommerce/ai-skills 0.13.0 → 0.15.0

package/scripts/postinstall.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install nudge — prints a one-time message after `npm install`.
+ * Does NOT auto-execute the install command (that writes to ~/.claude/ and
+ * should always be an explicit user action).
+ *
+ * Safe for CI: exits 0 unconditionally, prints to stderr so it doesn't
+ * pollute piped stdout, and skips entirely when CI env vars are set.
+ */
+
+// Skip in CI — no human to read it
+if (process.env.CI || process.env.CONTINUOUS_INTEGRATION || process.env.BUILD_NUMBER) {
+  process.exit(0);
+}
+
+const YELLOW = "\x1b[33m";
+const CYAN = "\x1b[36m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+
+console.error(`
+${YELLOW}┌──────────────────────────────────────────────────────────────┐
+│                                                              │
+│  ${BOLD}@fluentcommerce/ai-skills${RESET}${YELLOW} installed.                       │
+│                                                              │
+│  To activate skills in your coding assistant, run:           │
+│                                                              │
+│    ${CYAN}npx @fluentcommerce/ai-skills install${YELLOW}                     │
+│                                                              │
+│  First time? Add a Fluent profile for full API access:       │
+│                                                              │
+│    ${CYAN}npx @fluentcommerce/ai-skills install --profile MYPROFILE${YELLOW} │
+│                                                              │
+│  See all options:  ${CYAN}npx @fluentcommerce/ai-skills --help${YELLOW}      │
+│                                                              │
+└──────────────────────────────────────────────────────────────┘${RESET}
+`);

package/{content/dev/skills/fluent-trace/scripts/analyze-event-capture.mjs → tools/event-capture-analyzer.mjs}

@@ -5,7 +5,7 @@ import path from "node:path";
 
 const USAGE = `
 Usage:
-  node scripts/analyze-event-capture.mjs <capture.json> [more.json ...] [options]
+  node fluent-ai-skills/tools/event-capture-analyzer.mjs <capture.json> [more.json ...] [options]
 
 Options:
   --root-ref <ref>      Filter to events in this root entity lineage
@@ -17,8 +17,8 @@ Options:
   --help                Show this help
 
 Examples:
-  node scripts/analyze-event-capture.mjs ORD-1.window.json --root-ref ORD-1
-  node scripts/analyze-event-capture.mjs evt-123.event.json evt-123.window.json --root-ref ORD-1 --from 2026-03-25T10:00:00Z --to 2026-03-25T10:05:00Z --output ORD-1.metrics.json
+  node fluent-ai-skills/tools/event-capture-analyzer.mjs ORD-1.window.json --root-ref ORD-1
+  node fluent-ai-skills/tools/event-capture-analyzer.mjs evt-123.event.json evt-123.window.json --root-ref ORD-1 --from 2026-03-25T10:00:00Z --to 2026-03-25T10:05:00Z --output ORD-1.metrics.json
 `.trim();
 
 function fail(message) {

package/tools/{generate-feature-dashboard.mjs → feature-dashboard.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// fluent-ai-skills/tools/generate-feature-dashboard.mjs
+// fluent-ai-skills/tools/feature-dashboard.mjs
 // Feature Lifecycle HTML Dashboard Generator
 // Zero npm dependencies — uses only Node.js built-ins
 // Reads feature data from accounts/<PROFILE>/features/ and produces a self-contained HTML dashboard
@@ -116,7 +116,7 @@ function checkVendor() {
   const marked = join(VENDOR_DIR, 'marked.min.js');
   const mermaid = join(VENDOR_DIR, 'mermaid.min.js');
   if (!existsSync(marked) || !existsSync(mermaid)) {
-    console.error('Error: Vendor libs missing. Run: node fluent-ai-skills/tools/generate-feature-dashboard.mjs --setup');
+    console.error('Error: Vendor libs missing. Run: node fluent-ai-skills/tools/feature-dashboard.mjs --setup');
     process.exit(1);
   }
   return {

package/tools/manifest-diff.mjs

@@ -33,7 +33,7 @@ const ACCOUNTS_DIR = join(WORKSPACE_ROOT, 'accounts');
 
 const CDN_BASE = 'https://fluent.apps.fluentcommerce.com/_plugins';
 
-// ─── OOTB Component Registry (from fluent-mystique-validate/validator.mjs) ──
+// ─── OOTB Component Registry (from tools/manifest-validator.mjs) ──
 const OOTB_COMPONENTS = new Set([
   // Layout & Container
   'fc.page','fc.page.wizard','fc.page.wizard.summary','fc.page.section',

package/{content/dev/skills/fluent-mystique-assess/validator.mjs → tools/manifest-validator.mjs}

@@ -5,7 +5,7 @@
  * Implements all 66 validation rules from SKILL.md across 6 phases.
  *
  * Usage:
- *   node validator.mjs <manifest.json> [--strict] [--fix-suggestions] [--component <alias>] [--json]
+ *   node fluent-ai-skills/tools/manifest-validator.mjs <manifest.json> [--strict] [--fix-suggestions] [--component <alias>] [--json]
  */
 
 import { readFileSync, readdirSync, statSync, writeFileSync } from 'fs';
@@ -1113,7 +1113,7 @@ const args = process.argv.slice(2);
 if (args.length === 0 || args.includes('--help')) {
   console.log(`Mystique Manifest Validator v1.0
 
-Usage: node validator.mjs <manifest.json|directory> [options]
+Usage: node fluent-ai-skills/tools/manifest-validator.mjs <manifest.json|directory> [options]
 
 Options:
   --strict            Treat MEDIUM/LOW as errors