feat: promotion polish — docs UX, CLI hyperlinks, completions auto-install

.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  "chat.tools.terminal.autoApprove": {
+    "/^git checkout -b feat/promotion-polish && git add -A && git diff --cached --stat$/": {
+      "approve": true,
+      "matchCommandLine": true
+    }
+  }
+}

docs/.vitepress/theme/ComparisonTable.vue

@@ -1,19 +1,69 @@
 <script setup lang="ts">
 interface Row {
   feature: string;
+  desc: string;
   gh: boolean;
   gcs: boolean;
+  docLink?: string;
 }
 
 const ROWS: Row[] = [
-  { feature: "Results grouped by repository", gh: false, gcs: true },
-  { feature: "Interactive TUI — navigate, select, filter", gh: false, gcs: true },
-  { feature: "Fine-grained extract selection", gh: false, gcs: true },
-  { feature: "Markdown / JSON output", gh: false, gcs: true },
-  { feature: "Replay / CI command", gh: false, gcs: true },
-  { feature: "Team-prefix grouping", gh: false, gcs: true },
-  { feature: "Syntax highlighting in terminal", gh: false, gcs: true },
-  { feature: "Pagination (up to 1 000 results)", gh: true, gcs: true },
+  {
+    feature: "Results grouped by repository",
+    desc: "One block per repo instead of a flat list — fold or unfold at a glance.",
+    gh: false,
+    gcs: true,
+    docLink: "/github-code-search/usage/interactive-mode",
+  },
+  {
+    feature: "Interactive TUI \u2014 navigate, select, filter",
+    desc: "Arrow-key navigation, path-based filter and live selection without leaving the terminal.",
+    gh: false,
+    gcs: true,
+    docLink: "/github-code-search/usage/interactive-mode",
+  },
+  {
+    feature: "Fine-grained extract selection",
+    desc: "Cherry-pick individual code extracts; deselected items become \u2014exclude flags automatically.",
+    gh: false,
+    gcs: true,
+    docLink: "/github-code-search/usage/interactive-mode",
+  },
+  {
+    feature: "Markdown / JSON output",
+    desc: "Export clean Markdown checklists or machine-readable JSON ready for CI scripts.",
+    gh: false,
+    gcs: true,
+    docLink: "/github-code-search/usage/output-formats",
+  },
+  {
+    feature: "Replay / CI command",
+    desc: "Every session produces a one-liner to reproduce the exact output headlessly in CI.",
+    gh: false,
+    gcs: true,
+    docLink: "/github-code-search/usage/non-interactive-mode",
+  },
+  {
+    feature: "Team-prefix grouping",
+    desc: "Cluster repos by GitHub team prefix (squad-, chapter-) for org-wide triage.",
+    gh: false,
+    gcs: true,
+    docLink: "/github-code-search/usage/team-grouping",
+  },
+  {
+    feature: "Syntax highlighting in terminal",
+    desc: "Language-aware token colouring rendered in the TUI \u2014 no browser needed.",
+    gh: false,
+    gcs: true,
+    docLink: "/github-code-search/usage/interactive-mode",
+  },
+  {
+    feature: "Pagination (up to 1\u202f000 results)",
+    desc: "Both tools auto-paginate the GitHub search API \u2014 up to 1\u202f000 results per query.",
+    gh: true,
+    gcs: true,
+    docLink: "/github-code-search/reference/github-api-limits",
+  },
 ];
 </script>
 
@@ -48,7 +98,39 @@ const ROWS: Row[] = [
         </thead>
         <tbody>
           <tr v-for="row in ROWS" :key="row.feature" class="ct-row">
-            <td class="ct-feature">{{ row.feature }}</td>
+            <td class="ct-feature">
+              <a
+                v-if="row.docLink"
+                :href="row.docLink"
+                target="_blank"
+                rel="noopener noreferrer"
+                class="ct-feature-link"
+              >
+                <span class="ct-feature-title">
+                  {{ row.feature }}
+                  <svg
+                    class="ct-ext-icon"
+                    aria-hidden="true"
+                    width="11"
+                    height="11"
+                    viewBox="0 0 24 24"
+                    fill="none"
+                    stroke="currentColor"
+                    stroke-width="2"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                  >
+                    <line x1="7" y1="17" x2="17" y2="7" />
+                    <polyline points="7 7 17 7 17 17" />
+                  </svg>
+                </span>
+                <span class="ct-feature-desc">{{ row.desc }}</span>
+              </a>
+              <span v-else class="ct-feature-plain">
+                <span class="ct-feature-title">{{ row.feature }}</span>
+                <span class="ct-feature-desc">{{ row.desc }}</span>
+              </span>
+            </td>
             <td class="ct-cell">
               <span v-if="row.gh" class="ct-check">✓</span>
               <span v-else class="ct-cross">✗</span>
@@ -109,7 +191,7 @@ const ROWS: Row[] = [
 .ct-intro {
   margin: 0;
   padding: 20px 24px 18px;
-  font-size: 14px;
+  font-size: 15.5px;
   line-height: 1.7;
   color: var(--vp-c-text-2);
   border-bottom: 1px solid var(--vp-c-divider);
@@ -160,7 +242,7 @@ thead tr {
 }
 
 .ct-tool-name {
-  font-size: 13px;
+  font-size: 14px;
   font-weight: 600;
   white-space: nowrap;
 }
@@ -210,12 +292,55 @@ thead tr {
 }
 
 .ct-feature {
-  padding: 14px 24px;
-  font-size: 14px;
+  padding: 12px 24px;
+  font-size: 15px;
   color: var(--vp-c-text-1);
   line-height: 1.5;
 }
 
+.ct-feature-link,
+.ct-feature-plain {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  color: var(--vp-c-text-1);
+  text-decoration: none;
+}
+
+.ct-feature-link:hover {
+  color: var(--vp-c-text-1);
+}
+
+.ct-feature-title {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  font-size: 15px;
+  font-weight: 600;
+  color: inherit;
+}
+
+.ct-feature-desc {
+  font-size: 13px;
+  font-weight: 400;
+  color: var(--vp-c-text-3);
+  line-height: 1.45;
+}
+
+.ct-feature-link:hover .ct-feature-desc {
+  color: var(--vp-c-text-2);
+}
+
+.ct-ext-icon {
+  opacity: 0.35;
+  flex-shrink: 0;
+  transition: opacity 0.15s;
+}
+
+.ct-feature-link:hover .ct-ext-icon {
+  opacity: 0.75;
+}
+
 .ct-cell {
   padding: 14px 12px;
   text-align: center;

docs/.vitepress/theme/InstallSection.vue

@@ -232,7 +232,7 @@ function copySearch() {
 
 .is-subtitle {
   margin: 0;
-  font-size: 15px;
+  font-size: 16px;
   color: var(--vp-c-text-2);
   line-height: 1.65;
 }
@@ -284,7 +284,7 @@ function copySearch() {
 
 .is-step-label {
   margin: 8px 0 10px;
-  font-size: 15px;
+  font-size: 16px;
   font-weight: 600;
   color: var(--vp-c-text-1);
 }

docs/.vitepress/theme/ProductionCta.vue

@@ -45,7 +45,22 @@
       target="_blank"
       rel="noopener noreferrer"
     >
-      Share your story ↗
+      <span>Share your story</span>
+      <svg
+        class="cta-btn-arrow"
+        aria-hidden="true"
+        xmlns="http://www.w3.org/2000/svg"
+        width="13"
+        height="13"
+        viewBox="0 0 24 24"
+        fill="none"
+        stroke="currentColor"
+        stroke-width="2"
+        stroke-linecap="round"
+        stroke-linejoin="round"
+      >
+        <path d="M7 17L17 7M7 7h10v10" />
+      </svg>
     </a>
   </div>
 </template>
@@ -133,7 +148,7 @@
 
 .cta-text {
   margin: 0;
-  font-size: 15px;
+  font-size: 16px;
   line-height: 1.65;
   color: var(--vp-c-text-2);
 }
@@ -149,7 +164,9 @@
 /* ── Button ────────────────────────────────────────────────────────────── */
 .cta-btn {
   flex-shrink: 0;
-  display: inline-block;
+  display: inline-flex;
+  align-items: center;
+  gap: 7px;
   padding: 10px 22px;
   border-radius: 9999px;
   background: linear-gradient(135deg, #9933ff 0%, #7a1fd4 100%);
@@ -165,6 +182,10 @@
     background 0.2s;
 }
 
+.cta-btn-arrow {
+  flex-shrink: 0;
+}
+
 .cta-btn:hover {
   background: linear-gradient(135deg, #aa44ff 0%, #9933ff 100%);
   box-shadow: 0 6px 28px rgba(153, 51, 255, 0.5);

docs/.vitepress/theme/RichFooter.vue

@@ -108,7 +108,24 @@
             >
           </li>
           <li>
-            <a href="https://fulll.fr" target="_blank" rel="noopener noreferrer"> fulll.fr ↗ </a>
+            <a href="https://fulll.fr" target="_blank" rel="noopener noreferrer">
+              fulll.fr
+              <svg
+                class="rf-ext-arrow"
+                aria-hidden="true"
+                xmlns="http://www.w3.org/2000/svg"
+                width="11"
+                height="11"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                stroke-width="2.2"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+              >
+                <path d="M7 17L17 7M7 7h10v10" />
+              </svg>
+            </a>
           </li>
         </ul>
       </div>
@@ -228,6 +245,11 @@ const year = new Date().getFullYear();
   opacity: 0.7;
 }
 
+.rf-ext-arrow {
+  flex-shrink: 0;
+  opacity: 0.6;
+}
+
 /* ── Responsive ────────────────────────────────────────────────────────── */
 @media (max-width: 840px) {
   .rf-inner {

docs/.vitepress/theme/TestimonialsSection.vue

@@ -44,7 +44,22 @@
           target="_blank"
           rel="noopener noreferrer"
         >
-          Share your story →
+          <span>Share your story</span>
+          <svg
+            class="ts-cta-arrow"
+            aria-hidden="true"
+            xmlns="http://www.w3.org/2000/svg"
+            width="12"
+            height="12"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2.2"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+          >
+            <path d="M7 17L17 7M7 7h10v10" />
+          </svg>
         </a>
       </div>
     </div>
@@ -132,12 +147,19 @@ const testimonials = [
   gap: 20px;
   transition:
     transform 0.18s,
-    box-shadow 0.18s;
+    box-shadow 0.18s,
+    border-color 0.18s;
 }
 
 .ts-card:hover {
   transform: translateY(-2px);
-  box-shadow: 0 6px 24px rgba(153, 51, 255, 0.1);
+  box-shadow: 0 6px 24px rgba(153, 51, 255, 0.14);
+  border-color: rgba(153, 51, 255, 0.32);
+}
+
+.dark .ts-card:hover {
+  border-color: rgba(204, 136, 255, 0.3);
+  box-shadow: 0 6px 28px rgba(153, 51, 255, 0.2);
 }
 
 /* ── Quote ─────────────────────────────────────────────────────────────── */
@@ -226,19 +248,29 @@ const testimonials = [
 }
 
 .ts-cta-btn {
-  display: inline-block;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
   padding: 8px 18px;
   border-radius: 8px;
   background: var(--vp-c-brand-1);
-  color: #fff;
+  color: #fff !important;
   font-size: 13px;
   font-weight: 600;
-  text-decoration: none;
-  transition: background 0.15s;
+  text-decoration: none !important;
+  transition:
+    background 0.15s,
+    box-shadow 0.15s;
 }
 
 .ts-cta-btn:hover {
   background: #7a1fd4;
+  color: #fff !important;
+  box-shadow: 0 4px 16px rgba(153, 51, 255, 0.35);
+}
+
+.ts-cta-arrow {
+  flex-shrink: 0;
 }
 
 /* ── Responsive ────────────────────────────────────────────────────────── */