crewforth 3.0.0-rc.2 → 3.0.0

package/CHANGELOG.md

@@ -5,7 +5,7 @@ Crewforth was named Claude Starter Kit until 3.0.0.
 Notable changes to this project are recorded here. Format follows [Keep a Changelog](https://keepachangelog.com/en/),
 versioning follows [SemVer](https://semver.org/).
 
-## [Unreleased] — 3.0.0
+## [3.0.0] — 2026-09-28
 
 ### BREAKING — Claude Starter Kit is now Crewforth
 
@@ -141,7 +141,8 @@ One name everywhere: the package, the components, the variables, the payload. **
   - the `.NET` pattern skill the update keeps is not flagged as unvetted in the next session;
   - the 2.x template sentences in `CLAUDE.md` are brought up to date, and your own lines are left alone.
 - **The 2.x package name** says which package it forwards to.
-- **Replies stay in your language** even when a skill's text is English.
+- **Replies stay in your language** even when a skill's text is English, and a Turkish install says so at every session
+  start, so a bare command such as `/crew-doctor` is answered in Turkish too.
 - **`/crew-review`** runs the closing reviewer whenever the audits leave no critical or high finding; medium and low
   findings go into its prompt and the report.
 - **Release asset:** a release candidate's archive carries its own version in the file name.

package/kit/eval/smoke-test.sh

@@ -4028,6 +4028,30 @@ case "$o" in *'"additionalContext"'*SESSION_STATE*) pass "handover present -> in
   *) fail "session-rehydrate did not inject a pointer when SESSION_STATE.md exists" ;; esac
 if [ -n "$JSONQ" ]; then printf '%s' "$o" | json_ok && pass "rehydrate output is valid JSON ($JSONQ)" || fail "rehydrate output is not valid JSON";
     else skip tool "the rehydrate output JSON-validity check (no working jq)"; fi
+# The install language (RC-2 rehearsal: a bare /crew-doctor in a Turkish install came back in English). The hook
+# now runs on startup too and tells the model the install language; the handover is still offered only on a
+# boundary. Six states, each read by what the hook actually printed: a Turkish install gets the language line on
+# startup and on a boundary; an English install gets none; startup never offers the handover, a boundary does.
+# JSON validity is asked of Crewforth's own reader, so it holds on a machine without jq.
+_rh(){ printf '{"hook_event_name":"SessionStart","cwd":"%s","source":"%s"}' "$RHD" "$1" | CLAUDE_PROJECT_DIR= bash "$HOOKS/session-rehydrate.sh" 2>/dev/null; }
+_rk(){ case "$1" in *'handover'*) printf 'H' ;; esac; case "$1" in *'installed in Turkish'*) printf 'L' ;; esac; }
+mkdir -p "$RHD/.claude"
+printf 'lang=tr\n' > "$RHD/.claude/kit.conf"; _o1="$(_rh startup)"; _o2="$(_rh compact)"
+printf 'lang=en\n' > "$RHD/.claude/kit.conf"; _o3="$(_rh startup)"; _o4="$(_rh compact)"
+rm -f "$RHD/docs/SESSION_STATE.md"; _o5="$(_rh startup)"
+printf 'lang=tr\n' > "$RHD/.claude/kit.conf"; _o6="$(_rh clear)"
+_got="$(_rk "$_o1")/$(_rk "$_o2")/$(_rk "$_o3")/$(_rk "$_o4")/$(_rk "$_o5")/$(_rk "$_o6")"
+[ "$_got" = "L/HL//H//L" ] && pass "SessionStart names a Turkish install's language on startup and on a boundary; English adds nothing; startup never offers the handover (6 states)" \
+  || fail "session-rehydrate language/handover states read '$_got', want 'L/HL//H//L' (tr startup · tr compact+handover · en startup · en compact+handover · en startup no handover · tr clear no handover)"
+_rj=0; for _o in "$_o1" "$_o2" "$_o4" "$_o6"; do printf '%s' "$_o" > "$RHD/o.json"; awk -v op=validate -f "$ROOT/eval/lib/settings-json.awk" "$RHD/o.json" 2>/dev/null || _rj=$((_rj+1)); done
+[ "$_rj" = 0 ] && pass "each language/handover output is valid JSON (Crewforth's reader, 4 of 4)" || fail "$_rj session-rehydrate output(s) are not valid JSON"
+# Asked of the entry that carries session-rehydrate, not of the file: skill-trust's entry has the same matcher.
+_rw(){ _n="$(awk -v op=len -v path=hooks.SessionStart -f "$ROOT/eval/lib/settings-json.awk" "$1" 2>/dev/null)"; _i=0
+       while [ "$_i" -lt "${_n:-0}" ]; do _e="$(awk -v op=get -v path="hooks.SessionStart.$_i" -f "$ROOT/eval/lib/settings-json.awk" "$1" 2>/dev/null)"
+         case "$_e" in *session-rehydrate*) case "$_e" in *'"matcher"'*startup*) return 0 ;; esac ;; esac; _i=$((_i+1)); done; return 1; }
+sed 's/"startup|resume|clear|compact|fork"/"compact|clear|resume|fork"/' "$ROOT/settings.json" > "$RHD/s-twin.json"
+if _rw "$ROOT/settings.json" && ! _rw "$RHD/s-twin.json"; then pass "settings.json runs session-rehydrate on startup too; a copy wired as before (no startup) is caught"
+else fail "session-rehydrate is not wired on startup (or the check cannot tell) — a Turkish install's first session would not be told its language"; fi
 rm -rf "$RHD"
 # board-sync builds its JSON with one awk escaper on every machine. The no-jq escaper it replaced handled only the
 # quote, the backslash and the newline, so a TAB in an item title produced JSON the CLI cannot parse and the board

package/kit/hooks/session-rehydrate.sh

@@ -8,8 +8,14 @@
 #   - SessionStart is the right event: its stdout / hookSpecificOutput.additionalContext is injected into the
 #     model's context (docs: "Re-inject context after compaction"). PreCompact is NOT used — it can only block
 #     compaction, not add instructions to the summary, and blocking is not what we want.
-#   - Matched on compact|clear|resume, NOT startup: those three are explicit "continue where I left off" boundaries.
-#     startup fires on every unrelated session open and would keep surfacing a stale handover — that would nag.
+#   - The HANDOVER is offered on compact|clear|resume|fork only, NOT on startup: those are explicit "continue where I
+#     left off" boundaries, while startup fires on every unrelated session open and would keep surfacing a stale
+#     handover — that would nag. The hook itself also runs on startup, for the language line below; it reads the
+#     payload's `source` to tell the two apart (no `source` -> treated as a boundary, the pre-3.0 payload shape).
+#   - THE LANGUAGE LINE. A project installed in Turkish (`lang=tr` in .claude/kit.conf) is told so at every session
+#     start: reply in Turkish unless the user writes in another language. The RC-2 rehearsal typed a bare
+#     `/crew-doctor` in a Turkish install: the doctor printed Turkish and the summary came back in English, because a
+#     bare command has no word to take the language from. An English install adds nothing (English is the default).
 #   - CLAUDE.md itself reloads on /compact and /clear on its own, so this hook does NOT re-inject the discipline —
 #     only the session-specific state the reload can't recover.
 #   - Fails OPEN and SILENT: no handover file, no output. It never blocks the session (always exits 0).
@@ -28,13 +34,26 @@ fi
 # Undo the JSON escaping first (`\\`), then fold any lone separator. Both are no-ops on a POSIX path.
 ROOT="${ROOT//\\\\//}"; ROOT="${ROOT//\\//}"
 
-STATE="$ROOT/docs/SESSION_STATE.md"
-[ -s "$STATE" ] || exit 0   # no (non-empty) handover → nothing to rehydrate, stay silent
+SRC=""
+case "$IN" in *'"source"'*) SRC="${IN#*\"source\"}"; SRC="${SRC#*\"}"; SRC="${SRC%%\"*}" ;; esac
+
+LANGMSG=""
+if [ -f "$ROOT/.claude/kit.conf" ]; then
+  while IFS= read -r _l || [ -n "$_l" ]; do
+    case "${_l%$'\r'}" in lang=tr) LANGMSG="This project was installed in Turkish (lang=tr in .claude/kit.conf). Reply in Turkish unless the user writes in another language, including after a bare command such as /crew-doctor. Commands, paths, file names and identifiers stay as written." ;; esac
+  done < "$ROOT/.claude/kit.conf"
+fi
 
+MSG=""
+STATE="$ROOT/docs/SESSION_STATE.md"
+if [ "$SRC" != startup ] && [ -s "$STATE" ]; then
 MSG="A session handover from before this context boundary exists at docs/SESSION_STATE.md. If the user's request continues that work, read it first — it holds the in-progress task state, open decisions, and the intended next step — and do not restart from scratch. If the request is about something else, do not bring it up."
+fi
+[ -n "$LANGMSG" ] && MSG="${MSG:+$MSG }$LANGMSG"
+[ -n "$MSG" ] || exit 0   # no handover to offer and nothing to say about language -> stay silent
 
 # hookSpecificOutput.additionalContext is the documented channel that injects text into the model's context.
-# ONE PATH, no jq: MSG is a fixed constant with no quote, backslash, control character or newline, so it needs no
+# ONE PATH, no jq: MSG is built from fixed constants with no quote, backslash, control character or newline, so it needs no
 # escaping and every machine emits the same bytes. If you ever make MSG dynamic, escape it the way board-sync.sh
 # does (jq-identical, measured) — a raw quote or tab here makes JSON the CLI silently drops.
 printf '{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"%s"}}\n' "$MSG"

package/kit/settings.json

@@ -93,7 +93,7 @@
     ],
     "SessionStart": [
       {
-        "matcher": "compact|clear|resume|fork",
+        "matcher": "startup|resume|clear|compact|fork",
         "hooks": [
           {
             "type": "command",

package/package.json

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