@ahmednawaz/crank 0.1.2

package/skills/copy-guidance.md

@@ -0,0 +1,25 @@
+# Crank — product copy guidance
+
+Internal Motive guidance for Glean copy iterations. Keep tone professional and concise.
+
+## Principles
+
+1. Prefer short, scannable labels over marketing fluff.
+2. Use active voice for CTAs (`Save changes`, not `Changes can be saved`).
+3. Match surrounding UI vocabulary; do not invent parallel terms for the same concept.
+4. Preserve meaning when shortening — never drop required legal/safety caveats.
+5. Prefer sentence case for body and buttons unless the surface already uses title case.
+6. Avoid banned fluff: seamless, robust, leverage, utilize, delve, elevate.
+
+## Variant intents Glean should cover
+
+When asked for 3–4 options, aim for distinct intents such as:
+
+1. **Concise** — shorten without losing meaning
+2. **Clearer** — reduce ambiguity for first-time users
+3. **Actionable** — strengthen verbs / CTAs
+4. **On-brand / product tone** — align with Motive product register
+
+## Output shape
+
+For each variant, return updated text for every selected text node (`path` + `text`), not a single blob. The bookmarklet applies node-by-node.

package/team.env

@@ -0,0 +1,4 @@
+GLEAN_BASE_URL=https://motive-prod-be.glean.com
+GLEAN_API_KEY=3ZIlc2VgNezFqr4iuR9PU1pGSZAbEqYOhkI04ec+OeU=
+GLEAN_AGENT_ID=a866095fd53b419ab08338e3559fb7aa
+GLEAN_STUB=false

package/vite.js

@@ -0,0 +1,75 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { env } = require('./lib/env');
+const { readRuntimeManifest } = require('./lib/urls');
+
+/**
+ * Vite / Rolldown-vite / Vitest-compatible plugin.
+ * Injects Crank into the app during `vite` / `npm run dev` — no bookmarklet needed.
+ *
+ *   // vite.config.ts
+ *   import { crank } from 'crank/vite'
+ *   export default { plugins: [crank()] }
+ */
+
+function findProjectRoot(startDir) {
+  let dir = path.resolve(startDir || process.cwd());
+  for (let i = 0; i < 8; i++) {
+    if (fs.existsSync(path.join(dir, '.crank', 'runtime.json'))) {
+      return dir;
+    }
+    if (fs.existsSync(path.join(dir, 'package.json'))) {
+      return dir;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return path.resolve(startDir || process.cwd());
+}
+
+function resolveCompanionLoaderUrl(options = {}) {
+  const projectRoot = options.projectRoot || findProjectRoot(process.cwd());
+  const runtime = readRuntimeManifest(projectRoot);
+  if (runtime?.companion?.devLoader) {
+    return runtime.companion.devLoader;
+  }
+
+  const publicUrl = (
+    options.companionUrl ||
+    env('PUBLIC_URL', '') ||
+    ''
+  ).replace(/\/$/, '');
+
+  const port = String(options.port || env('PORT', '3344')).replace(/[^0-9]/g, '') || '3344';
+  const host = options.host || env('HOST', '127.0.0.1');
+  const base = publicUrl || `http://${host === '0.0.0.0' ? '127.0.0.1' : host}:${port}`;
+  return `${base}/dev-loader.js`;
+}
+
+function crank(options = {}) {
+  const src = resolveCompanionLoaderUrl(options);
+
+  return {
+    name: 'crank-dev-loader',
+    apply: 'serve',
+    transformIndexHtml(html) {
+      if (String(html).includes('/dev-loader.js') || String(html).includes('crank/dev-loader')) {
+        return html;
+      }
+      const tag = `<script src="${src}" defer></script>`;
+      if (html.includes('</head>')) {
+        return html.replace('</head>', `  ${tag}\n</head>`);
+      }
+      return `${tag}\n${html}`;
+    }
+  };
+}
+
+module.exports = {
+  crank,
+  crankDevLoader: crank,
+  resolveCompanionLoaderUrl
+};