crewforth 3.1.1 → 3.2.0-rc.10

package/kit/studio/web/viewport.js

@@ -0,0 +1,160 @@
+// A pane that pans and zooms one layer, and cards that can be dragged on it.
+//
+// The graph (canvas.js) and the project map (map.js) both draw cards on a layer the viewer moves around. This is
+// that part, once: a drag on the empty pane pans, the wheel zooms about the pointer (or pans, when it is mostly
+// sideways), Fit puts the whole picture in the pane, and a card dragged more than a few pixels is placed by hand.
+// Where things go and what a card says stay with the view that owns them.
+import { ZOOM, fitZoom } from './graph-plan.js';
+
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+
+export class Viewport {
+  /**
+   * @param pane   the element the pointer works on; its size is the pane's
+   * @param layer  the element moved and scaled: one transform, so a zoom restyles nothing
+   * @param skip   (target) => true when a press on it is not a pan (a card, a control on the pane)
+   * @param onApply  called after every change of the view
+   */
+  constructor(pane, layer, { skip = () => false, onApply = () => {} } = {}) {
+    this.pane = pane;
+    this.layer = layer;
+    this.skip = skip;
+    this.onApply = onApply;
+    this.view = { x: 0, y: 0, k: 1 };
+    this.touched = false;        // the viewer moved the view themselves
+    this.#wire();
+  }
+
+  #wire() {
+    let panning = null;
+    this.pane.addEventListener('pointerdown', (e) => {
+      if (e.button !== 0) return;                 // right/middle must not pan
+      if (this.skip(e.target)) return;
+      panning = { px: e.clientX, py: e.clientY, x: this.view.x, y: this.view.y };
+      this.pane.setPointerCapture(e.pointerId);
+      this.pane.classList.add('cv-panning');
+    });
+    this.pane.addEventListener('pointermove', (e) => {
+      if (!panning) return;
+      this.view.x = panning.x + (e.clientX - panning.px);
+      this.view.y = panning.y + (e.clientY - panning.py);
+      this.touched = true;
+      this.apply();
+    });
+    const endPan = () => { panning = null; this.pane.classList.remove('cv-panning'); };
+    this.pane.addEventListener('pointerup', endPan);
+    this.pane.addEventListener('pointercancel', endPan);
+
+    this.pane.addEventListener('wheel', (e) => {
+      e.preventDefault();
+      const r = this.pane.getBoundingClientRect();
+      const mx = e.clientX - r.left;
+      const my = e.clientY - r.top;
+      // deltaMode 1 is lines and 2 is pages; Firefox reports ~3 where Chrome reports ~100, which made zoom
+      // imperceptible and pan crawl.
+      const unit = e.deltaMode === 1 ? 16 : e.deltaMode === 2 ? r.height : 1;
+      const dY = e.deltaY * unit;
+      const dX = e.deltaX * unit;
+      if (e.ctrlKey || e.metaKey || Math.abs(dY) > Math.abs(dX)) {
+        this.zoomAbout(this.view.k * Math.exp(-dY * 0.0016), mx, my);
+      } else {
+        this.view.x -= dX;
+        this.view.y -= dY;
+      }
+      this.touched = true;
+      this.apply();
+    }, { passive: false });
+  }
+
+  /** Zoom to `k`, keeping the world point under (mx, my) where it is. */
+  zoomAbout(k, mx, my) {
+    const next = clamp(k, ZOOM.min, ZOOM.max);
+    this.view.x = mx - (mx - this.view.x) * (next / this.view.k);
+    this.view.y = my - (my - this.view.y) * (next / this.view.k);
+    this.view.k = next;
+  }
+
+  /** Step the zoom from a toolbar: about the middle of the pane. */
+  zoomBy(factor) { this.zoomTo(this.view.k * factor); }
+
+  zoomTo(k) {
+    const r = this.pane.getBoundingClientRect();
+    this.zoomAbout(k, r.width / 2, r.height / 2);
+    this.touched = true;
+    this.apply();
+  }
+
+  /** Turn `view` into pixels: the single place that does. */
+  apply() {
+    const { x, y, k } = this.view;
+    this.layer.style.transform = `translate(${x}px, ${y}px) scale(${k})`;
+    this.onApply();
+  }
+
+  /** The whole picture (width × height, in the layer's own pixels) in the pane, never above 100%. */
+  /** Fit the picture to the pane; `floor` is a zoom it does not go under (the picture then starts at its top). */
+  fit(width, height, floor = 0) {
+    const r = this.pane.getBoundingClientRect();
+    const k = Math.max(fitZoom(width, height, r.width, r.height), Math.min(floor, ZOOM.fitMax));
+    this.view.k = k;
+    this.view.x = Math.max(ZOOM.pad, (r.width - width * k) / 2);
+    this.view.y = Math.max(ZOOM.pad, (r.height - height * k) / 2);
+    this.touched = false;
+    this.apply();
+  }
+
+  /** Bring a point of the layer to the middle of the pane, at least at `minK`. */
+  centerOn(cx, cy, minK = 1) {
+    const r = this.pane.getBoundingClientRect();
+    this.view.k = clamp(Math.max(this.view.k, minK), ZOOM.min, ZOOM.max);
+    this.view.x = r.width / 2 - cx * this.view.k;
+    this.view.y = r.height / 2 - cy * this.view.k;
+    this.touched = true;
+    this.apply();
+  }
+}
+
+/**
+ * A card that can be placed by hand. A press that moves more than 3 px (at the pane's zoom) is a drag, and the
+ * click that ends it is swallowed: without that, every reposition also toggled the selection.
+ * @param scale  () => the pane's zoom
+ * @param at     () => the card's position { x, y } when the drag starts
+ * @param move   (x, y) => the card is now here
+ * @param end    () => the drag is over (persist the place)
+ * @param ignore (target) => true for a part of the card that answers the press itself
+ */
+export function draggable(el, { scale, at, move, end = () => {}, ignore = () => false }) {
+  let drag = null;
+  el.addEventListener('pointerdown', (e) => {
+    if (e.button !== 0) return;
+    e.stopPropagation();                       // do not pan the pane too
+    if (ignore(e.target)) return;
+    const p = at() ?? { x: 0, y: 0 };
+    drag = { px: e.clientX, py: e.clientY, x: p.x, y: p.y, moved: false };
+    el.setPointerCapture(e.pointerId);
+  });
+  el.addEventListener('pointermove', (e) => {
+    if (!drag) return;
+    const dx = (e.clientX - drag.px) / scale();
+    const dy = (e.clientY - drag.py) / scale();
+    if (!drag.moved && Math.abs(dx) <= 3 && Math.abs(dy) <= 3) return;
+    drag.moved = true;
+    el.classList.add('cv-dragging');
+    move(Math.round(drag.x + dx), Math.round(drag.y + dy));
+  });
+  const stop = () => {
+    if (!drag) return;
+    if (drag.moved) { end(); el.dataset.suppressClick = '1'; }
+    drag = null;
+    el.classList.remove('cv-dragging');
+  };
+  el.addEventListener('pointerup', stop);
+  el.addEventListener('pointercancel', stop);
+}
+
+/** Did a drag just end on this element? Answers once, so the click that ends a drag does nothing. */
+export function swallowClick(el) {
+  if (el.dataset.suppressClick !== '1') return false;
+  el.dataset.suppressClick = '0';
+  return true;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "crewforth",
-  "version": "3.1.1",
-  "description": "Crewforth \u2014 your engineering crew for Claude Code: agents, skills and tool-level gates, in any stack.",
+  "version": "3.2.0-rc.10",
+  "description": "Crewforth — your engineering crew for Claude Code: agents, skills and tool-level gates, in any stack.",
   "bin": {
     "crewforth": "bin/cli.js"
   },
@@ -15,7 +15,8 @@
     "kit/",
     "VERSION",
     "LICENSE",
-    "README.md", "CHANGELOG.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=20"
@@ -42,10 +43,10 @@
     "code-review",
     "git-hooks"
   ],
-  "author": "Bar\u0131\u015f Yerlikaya",
+  "author": "Barış Yerlikaya",
   "homepage": "https://crewforth.com/",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Crewforth/crewforth.git"
+    "url": "git+https://github.com/crewforth/crewforth.git"
   }
 }

package/start.sh

@@ -96,6 +96,8 @@ _mt() {   # $1 = English text (the key); further args fill %s; result in _M
   if [ "$CREW_LANG" = tr ]; then
     case "$s" in
       "Crewforth · setup wizard") s='Crewforth · kurulum' ;;
+      "Status line: Crewforth's (the gate's last word, a standing approval, crew agents, fill, cost).") s="Durum satırı: Crewforth'unki (kapının son sözü, geçerli onay, crew ajanları, doluluk, maliyet)." ;;
+      "Status line: yours is kept; Crewforth's is one command away (see /crew-doctor).") s="Durum satırı: seninki korundu; Crewforth'unki tek komutla açılır (/crew-doctor'a bak)." ;;
       "stack-agnostic") s='her yığınla çalışır' ;;
       "[1/2] Who is this install for?") s='[1/2] Kurulumu kim kullanacak?' ;;
       "Decides whether your teammates get Crewforth's configuration — and what goes into .gitignore.") s="Crewforth ayarlarının ekiple paylaşılıp paylaşılmayacağını ve .gitignore'a nelerin ekleneceğini belirler." ;;
@@ -189,6 +191,8 @@ Crewforth her zaman eksiksiz kurulur: tüm ajanlar ve skill'ler — backend, web
 (CLAUDE.md ## Stack ya da depo). React Native/Expo, hazır isteğe bağlı katmanlardan yalnız biridir.
   --backend | --frontend | --mobile | --fullstack   hâlâ kabul edilir ama etkisi yok (eski komutlar bozulmasın diye)
   --private | --shared   kurulum yalnızca sizin mi, yoksa ekiple paylaşılıp commit'lenecek mi? (varsayılan: private)
+  --preset <ad|dosya>    bir kurum preset'i uygula: kritik yollar, model tabanları, izinli verify komutları
+                         (gelenler: default, strict, solo; ya da kendi .json dosyanız)
   --lang tr|en   kurulum dili (verilmezse sihirbaz sorar)
   --yes, -y      tüm sorulara evet de (gözetimsiz kurulum)
   --version, -v  Crewforth sürümünü yazdırıp çık
@@ -207,6 +211,8 @@ Every install ships everything: all agents, all skills — backend, web and mobi
 (CLAUDE.md ## Stack, or the repo). React Native/Expo is only one of the optional ready-made layers.
   --backend | --frontend | --mobile | --fullstack   accepted, no effect (kept so older commands still run)
   --private | --shared   is the install yours alone, or committed for the team? (default: private)
+  --preset <name|file>   apply an organisation preset: critical paths, model floors, allowed verify commands
+                         (shipped: default, strict, solo; or a .json file of your own)
   --lang tr|en   installer language (asked interactively when not given)
   --yes, -y     answer every question with yes (unattended install)
   --version, -v  print the Crewforth version and exit
@@ -430,9 +436,13 @@ case "$CREW_LANG" in tr|en) ;; *) CREW_LANG=en ;; esac
 # choice made by --lang or the menu above stayed in this shell, and the preflight block printed English.
 export CREW_LANG
 
-STACK="generic"; DOTNET_FLAG=0; LEGACY_FLAGS=""; ASSUME_YES=0; VISIBILITY=""
+STACK="generic"; DOTNET_FLAG=0; LEGACY_FLAGS=""; ASSUME_YES=0; VISIBILITY=""; PRESET=""; _preset_take=0
 for a in "$@"; do
+  # `--preset NAME`: the next word is its value, whatever it looks like (`--preset strict`, `--preset ./org.json`).
+  if [ "$_preset_take" = 1 ]; then _preset_take=0; PRESET="$a"; continue; fi
   case "$a" in
+    --preset=*) PRESET="${a#--preset=}" ;;
+    --preset)   _preset_take=1 ;;
     --lang) ;;                       # value consumed in the language pass above
     --lang=*) ;;
     tr|en) ;;                        # the value of a separated --lang
@@ -446,6 +456,9 @@ for a in "$@"; do
     *) printf '%s\n' "$(m 'Unknown parameter: %s' "$a")"; echo; usage; exit 1 ;;
   esac
 done
+[ "$_preset_take" = 1 ] && { printf '%s\n' "$(m 'Unknown parameter: %s' "--preset (no value)")"; echo; usage; exit 1; }
+# A preset is checked before anything is installed: one that is not valid stops here, with nothing written.
+if [ -n "$PRESET" ]; then bash "$SRC/eval/lib/preset.sh" --check "$PRESET" || exit 1; fi
 
 # ===================== COLOR / STYLE HELPERS =====================
 # Color is emitted ONLY on an interactive TTY + TERM!=dumb + NO_COLOR empty.
@@ -638,6 +651,14 @@ count_showcase .claude/skills
 # studio's gate hook is invoked as `bash <path>` today, so the bit is not load-bearing
 # yet; set it anyway, because a future direct exec would fail silently.
 chmod +x .claude/hooks/*.sh .claude/hooks/pre-commit .claude/hooks/commit-msg .claude/eval/*.sh .claude/studio/server/hooks/*.sh 2>/dev/null || true
+# The status line, only where none is set: a user's own would lose to the project's setting, so it is never
+# replaced. eval/lib/statusline.sh --install decides and writes; this only says what it did.
+if [ -f .claude/eval/lib/statusline.sh ]; then
+  case "$(bash .claude/eval/lib/statusline.sh --install 2>/dev/null)" in
+    installed) _mt "Status line: Crewforth's (the gate's last word, a standing approval, crew agents, fill, cost)."; echo "  ${_M}" ;;
+    kept) _mt "Status line: yours is kept; Crewforth's is one command away (see /crew-doctor)."; echo "  ${_M}" ;;
+  esac
+fi
 
 # §4.2: a vendor line that was armed before this run stays armed (the copy above resets it to a comment); nothing
 # else arms it. Rationale, and the measured failure of "arm it whenever the pattern skill exists", in adopt.sh.
@@ -679,6 +700,8 @@ cp "$SRC/README.md"         .claude/ 2>/dev/null || true
   # as if somebody had chosen it. --lang, CREW_LANG and the menu are choices, and are.
   [ "${_LANG_GUESSED:-0}" = 1 ] || echo "lang=${CREW_LANG:-en}"
 } > .claude/kit.conf
+# The organisation's preset, now that .claude/ is in place (checked above): a block at the top of crew-model-rules.
+if [ -n "$PRESET" ]; then bash .claude/eval/lib/preset.sh --apply "$PRESET" || exit 1; fi
 
 # Discipline (kit-owned, refreshed on every update) vs project section (yours, written once), joined by @import.
 kit_require_sentinel "$SRC/CLAUDE.md"