npm - @mgeri1993/claude-task-manager - Versions diffs - 1.0.0 - Mend

@mgeri1993/claude-task-manager 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (37) hide show

package/.env.example +2 -0
package/Dockerfile +11 -0
package/LICENSE +21 -0
package/README.hu.md +255 -0
package/README.md +253 -0
package/api/index.php +173 -0
package/bin/add-agent.sh +77 -0
package/bin/ctm +160 -0
package/docker-compose.yml +14 -0
package/engine/check-update.sh +48 -0
package/engine/projects.sh +164 -0
package/engine/task.sh +926 -0
package/favicon.ico +6 -0
package/favicon.svg +6 -0
package/index.html +141 -0
package/install.sh +231 -0
package/js/ApiClient.js +63 -0
package/js/App.js +547 -0
package/js/BoardView.js +205 -0
package/js/ContextPanel.js +47 -0
package/js/ContextStore.js +39 -0
package/js/ProjectStore.js +27 -0
package/js/TaskModal.js +112 -0
package/js/TaskStore.js +73 -0
package/js/UrlState.js +53 -0
package/js/Utils.js +202 -0
package/js/i18n.js +338 -0
package/js/main.js +3 -0
package/package.json +85 -0
package/style.css +396 -0
package/templates/SKILL.md.tmpl +175 -0
package/templates/agents/ctm-backend-developer.md.tmpl +53 -0
package/templates/agents/ctm-code-investigator.md.tmpl +49 -0
package/templates/agents/ctm-frontend-developer.md.tmpl +53 -0
package/templates/hooks/allow-task-sh.sh.tmpl +59 -0
package/templates/hooks/notify-inbox.sh.tmpl +53 -0
package/templates/tm-custom.md.tmpl +54 -0

package/favicon.ico ADDED Viewed

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect x="4" y="4" width="56" height="56" rx="16" fill="#5b8def" fill-opacity="0.16" stroke="#5b8def" stroke-opacity="0.4" stroke-width="2"/>
+  <rect x="16" y="34" width="7" height="18" rx="2" fill="#5b8def"/>
+  <rect x="28" y="22" width="7" height="30" rx="2" fill="#5b8def"/>
+  <rect x="40" y="38" width="7" height="14" rx="2" fill="#5b8def"/>
+</svg>

package/favicon.svg ADDED Viewed

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect x="4" y="4" width="56" height="56" rx="16" fill="#5b8def" fill-opacity="0.16" stroke="#5b8def" stroke-opacity="0.4" stroke-width="2"/>
+  <rect x="16" y="34" width="7" height="18" rx="2" fill="#5b8def"/>
+  <rect x="28" y="22" width="7" height="30" rx="2" fill="#5b8def"/>
+  <rect x="40" y="38" width="7" height="14" rx="2" fill="#5b8def"/>
+</svg>

package/index.html ADDED Viewed

@@ -0,0 +1,141 @@
+<!DOCTYPE html>
+<html lang="en" class="dark">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Claude Task Manager – Kanban board</title>
+<link rel="icon" type="image/svg+xml" href="favicon.svg">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600;700&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+<script src="https://cdn.tailwindcss.com"></script>
+<script>
+  // Tailwind Play CDN – only processes the static markup's utility classes. The actual
+  // component styles (card, column, modal, badges, etc.) live in the separate style.css as
+  // plain CSS (the tokens below are defined there as CSS custom properties) — see the
+  // comment at the top of style.css.
+  tailwind.config = {
+    darkMode: "class",
+    // Preflight (the base reset) would add `button,input,select{padding:0}`, which the CDN
+    // injects AFTER style.css at runtime → it would override our own button/field padding.
+    // Disabled; style.css supplies the base styles, the utility classes still work.
+    corePlugins: { preflight: false },
+    theme: {
+      extend: {
+        colors: {
+          bg: "var(--bg)",
+          panel: "var(--panel)",
+          "panel-2": "var(--panel-2)",
+          "panel-3": "var(--panel-3)",
+          ink: "var(--text)",
+          muted: "var(--muted)",
+          edge: "var(--border)",
+          accent: "var(--accent)",
+          "accent-solid": "var(--accent-solid)",
+          todo: "var(--todo)",
+          inprogress: "var(--in_progress)",
+          blocked: "var(--blocked)",
+          review: "var(--review)",
+          done: "var(--done)",
+        },
+      },
+    },
+  };
+</script>
+<link rel="stylesheet" href="style.css">
+</head>
+<body class="antialiased">
+<header class="shadow-sm dark:shadow-black/40 transition-shadow">
+  <div class="hd-left">
+    <h1 class="tracking-tight"><span class="logo" aria-hidden="true"><i></i><i></i><i></i></span> Task Manager</h1>
+    <div class="status"><span class="dot" id="dot"></span><span id="statusText" data-i18n="app.starting">starting…</span><span class="clock" id="clock"></span></div>
+  </div>
+  <div class="hd-center">
+    <label class="search-box"><svg class="ico" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"></circle><path d="m20 20-3.5-3.5"></path></svg> <input id="q" type="search" data-i18n-placeholder="hd.searchPlaceholder" placeholder="search…" spellcheck="false"></label>
+    <div class="src-box">
+      <span class="lbl" data-i18n="hd.source">Source</span>
+      <span class="src-dot"></span>
+      <select id="srcProject" class="src-select"></select>
+      <input id="src" type="hidden">
+    </div>
+  </div>
+  <div class="hd-right">
+    <label class="ctl" data-i18n-title="hd.poll" title="Poll">Poll
+      <select id="interval">
+        <option value="1000">1s</option><option value="2000" selected>2s</option>
+        <option value="5000">5s</option><option value="10000">10s</option>
+      </select>
+    </label>
+    <label class="ctl" data-i18n-title="hd.asTitle" title="Who the board writes as (task.sh --as). Pick an agent/reviewer, not a fixed &quot;human&quot;."><svg class="ico ico-accent" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="8" r="3.4"></circle><path d="M5.5 20a6.5 6.5 0 0 1 13 0"></path></svg> <span data-i18n="hd.as">As</span> <input id="actor" type="text" list="actorList" data-i18n-placeholder="hd.asPlaceholder" placeholder="e.g. reviewer" spellcheck="false" autocomplete="off"><datalist id="actorList"></datalist></label>
+    <button id="notifyBtn" data-i18n-title="hd.notifyTitle" title="Browser notification on status change (→ review / done)"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9"><path d="M18 8a6 6 0 1 0-12 0c0 7-3 9-3 9h18s-3-2-3-9"></path><path d="M13.7 21a2 2 0 0 1-3.4 0"></path></svg></button>
+    <button id="projectsBtn" data-i18n-title="hd.projectsTitle" title="Registered projects + copy wrapper task.sh"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="4" width="18" height="14" rx="2"></rect><path d="M3 9h18"></path></svg> <span data-i18n="hd.projects">Projects</span></button>
+    <button id="ctxBtn"><svg width="13" height="13" viewBox="0 0 24 24" fill="currentColor"><path d="M9 3.5h6l-1 6 3 3v2h-4.2v5.2l-.8 1.8-.8-1.8V14.5H7v-2l3-3-1-6Z"></path></svg> <span data-i18n="hd.context">Context</span></button>
+    <button id="langBtn" title="Switch language / Nyelv váltása">HU</button>
+    <button id="toggle"><svg width="12" height="12" viewBox="0 0 24 24" fill="currentColor"><rect x="6" y="5" width="4" height="14" rx="1"></rect><rect x="14" y="5" width="4" height="14" rx="1"></rect></svg> <span class="btxt">Pause</span></button>
+    <button id="refresh"><svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M20 11a8 8 0 1 0-.7 3.2"></path><path d="M20 4.5V11h-6.5"></path></svg></button>
+  </div>
+</header>
+<div class="stats" id="stats"></div>
+<div class="controls" id="controls">
+  <span class="lbl" data-i18n="ctrl.sort">Sort</span>
+  <select id="sort">
+    <option value="activity" data-i18n="ctrl.sort.activity">last activity</option>
+    <option value="created" data-i18n="ctrl.sort.created">created</option>
+    <option value="title" data-i18n="ctrl.sort.title">title (A→Z)</option>
+    <option value="team" data-i18n="ctrl.sort.team">Team #</option>
+  </select>
+  <span class="lbl" data-i18n="ctrl.view">View</span>
+  <div class="segmented">
+    <button id="viewBoard" class="on" data-i18n="ctrl.view.board">Kanban</button>
+    <button id="viewSwim" data-i18n="ctrl.view.swim">Swimlane</button>
+    <button id="viewFeed" data-i18n="ctrl.view.feed">Feed</button>
+    <button id="compact" data-i18n="ctrl.view.compact">Compact</button>
+  </div>
+  <span class="sep"></span>
+  <span class="lbl" data-i18n="ctrl.module">Module</span>
+  <select id="moduleFilter">
+    <option value="" data-i18n="ctrl.module.all">— all modules —</option>
+  </select>
+  <span class="sep"></span>
+  <span class="lbl" data-i18n="ctrl.quickFilter">Quick filter</span>
+  <button id="qfReview" class="qf"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M7 4h10M7 20h10M8 4v3l4 5 4-5V4M8 20v-3l4-5 4 5v3"></path></svg> <span data-i18n="ctrl.quick.review">Awaiting you</span></button>
+  <button id="qfActive" class="qf" data-i18n="ctrl.quick.active">Active</button>
+  <button id="qfBlocked" class="qf">Blocked</button>
+  <span class="ro"><svg class="ico" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="5" y="11" width="14" height="9" rx="2"></rect><path d="M8 11V8a4 4 0 0 1 8 0v3"></path></svg> <span data-i18n="ctrl.readonly">read-only view – the file is written by the agent</span></span>
+</div>
+<div class="agents-wrap" id="agentsWrap">
+  <button type="button" class="agents-head" id="agentsHead" aria-expanded="true">
+    <span class="lbl" data-i18n="agents.title">Agent load &amp; filter</span>
+    <span class="count-pill" id="agentsCount">0</span>
+    <svg class="chev" width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="m6 9 6 6 6-6"></path></svg>
+  </button>
+  <div class="agents" id="agents"></div>
+</div>
+<div class="banner" id="banner"></div>
+<div class="board" id="board"></div>
+<div class="overlay backdrop-blur" id="overlay">
+  <div class="modal" role="dialog" aria-modal="true">
+    <header><h2 id="mTitle">–</h2><button class="close" id="mClose" data-i18n="modal.close">✕ Close</button></header>
+    <div class="body" id="mBody"></div>
+  </div>
+</div>
+<div class="overlay backdrop-blur" id="ctxOverlay">
+  <div class="modal" role="dialog" aria-modal="true">
+    <header><h2><span data-i18n="ctx.title">📌 Context</span> <span class="mut" id="ctxUpdated"></span></h2><button class="close" id="ctxClose" data-i18n="modal.close">✕ Close</button></header>
+    <div class="body" id="ctxBody"></div>
+  </div>
+</div>
+<div class="overlay backdrop-blur" id="projectsOverlay">
+  <div class="modal" role="dialog" aria-modal="true">
+    <header><h2 data-i18n="project.modalTitle">📁 Projects</h2><button class="close" id="projectsClose" data-i18n="modal.close">✕ Close</button></header>
+    <div class="body" id="projectsBody"></div>
+  </div>
+</div>
+<script type="module" src="js/main.js"></script>
+</body>
+</html>

package/install.sh ADDED Viewed

@@ -0,0 +1,231 @@
+#!/usr/bin/env bash
+#
+# install.sh — installs the claude-task-manager "client" into an arbitrary project.
+#
+# Run from inside any project, it registers that project with claude-task-manager (data
+# directory + wrapper task.sh generation via engine/projects.sh), then creates in the target
+# project:
+#   - .claude/skills/task-manager/task.sh   — a COPY of the generated wrapper (carries its
+#     own TM_DIR baked in; no docker needed, plain host-bash script)
+#   - .claude/skills/task-manager/SKILL.md  — the Claude Code skill documentation (from this
+#     project's own "SKILL.md" template)
+#   - .claude/agents/ctm-*.md               — generic teammate agent definitions
+#   - .claude/hooks/allow-task-sh.sh + notify-inbox.sh — PreToolUse/PostToolUse hooks
+#     (auto-allow + inbox notification), registered in .claude/settings.json
+# and extends the target project's .claude/settings.local.json Bash allowlist with the
+# task.sh call, so it runs without a permission prompt.
+#
+# The board itself (index.html, port 3333) does NOT get installed into the target project —
+# it runs from claude-task-manager's own docker compose, shared by every installed project
+# (pick your project in the Source selector).
+#
+# Usage:
+#   /Users/mgeri1993/code/projects/claude-task-manager/install.sh [target-dir] [project-id] [label] [--force|-y]
+#
+# target-dir  – defaults to the current directory's git root (or the cwd itself, if no git)
+# project-id  – defaults to the target-dir folder name (A-Za-z0-9_- characters only)
+# label       – defaults to project-id
+# --force/-y  – overwrite existing generated files without prompting (also the default
+#               behavior in a non-interactive/non-tty session, where prompting isn't possible
+#               — pass this explicitly to opt into overwriting there)
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+die() { echo "error: $*" >&2; exit 1; }
+# shellcheck source=engine/check-update.sh
+source "$SCRIPT_DIR/engine/check-update.sh"
+check_for_updates "$SCRIPT_DIR"
+command -v jq >/dev/null 2>&1 || die "jq is not installed (required for this script)."
+# --force/-y/--yes can appear anywhere in the arguments; the rest are positional.
+FORCE=0
+ARGS=()
+for a in "$@"; do
+  case "$a" in
+    --force|-y|--yes) FORCE=1 ;;
+    *) ARGS+=("$a") ;;
+  esac
+done
+set -- ${ARGS[@]+"${ARGS[@]}"}
+TARGET_ARG="${1:-}"
+if [[ -n "$TARGET_ARG" ]]; then
+  TARGET_DIR="$(cd "$TARGET_ARG" && pwd)"
+elif ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"; then
+  TARGET_DIR="$ROOT"
+else
+  TARGET_DIR="$(pwd)"
+fi
+# Two steps (not `basename ... | tr ...` in one): basename's own trailing newline would
+# otherwise be fed into tr and get translated into a stray trailing "-" (tr -c matches it
+# as a "non-allowed" byte too), leaving every directory-derived id with a spurious dash.
+DEFAULT_ID="$(basename "$TARGET_DIR")"
+DEFAULT_ID="$(printf '%s' "$DEFAULT_ID" | tr -c 'A-Za-z0-9_-' '-')"
+PROJECT_ID="${2:-$DEFAULT_ID}"
+LABEL="${3:-$PROJECT_ID}"
+[[ "$PROJECT_ID" =~ ^[A-Za-z0-9_-]+$ ]] || die "invalid project-id (only A-Za-z0-9_- allowed): $PROJECT_ID"
+echo "Install target : $TARGET_DIR"
+echo "Project id     : $PROJECT_ID"
+echo "Label          : $LABEL"
+echo
+# Ask before overwriting an already-generated file. Skips (returns 1) without asking in a
+# non-interactive session — pass --force/-y to overwrite there instead.
+confirm_overwrite() {
+  local path="$1"
+  [[ -e "$path" ]] || return 0
+  if [[ "$FORCE" == "1" ]]; then
+    echo "overwriting (--force): $path"
+    return 0
+  fi
+  if [[ ! -t 0 ]]; then
+    echo "skipped (already exists, non-interactive session — pass --force to overwrite): $path" >&2
+    return 1
+  fi
+  local reply
+  read -r -p "File already exists: $path — overwrite? [y/N] " reply || reply="n"
+  if [[ "$reply" =~ ^[Yy]$ ]]; then
+    return 0
+  fi
+  echo "skipped: $path"
+  return 1
+}
+# 1) Registration + wrapper generation in claude-task-manager (host, no docker).
+"$SCRIPT_DIR/engine/projects.sh" add "$PROJECT_ID" "$LABEL"
+# 2) Target project's .claude/skills/task-manager/ directory.
+SKILL_DIR="$TARGET_DIR/.claude/skills/task-manager"
+mkdir -p "$SKILL_DIR"
+# task.sh — a copy of the generated wrapper in the target project, so the usual
+# ".claude/skills/task-manager/task.sh" relative calling pattern keeps working unchanged.
+if confirm_overwrite "$SKILL_DIR/task.sh"; then
+  cp "$SCRIPT_DIR/wrappers/$PROJECT_ID.sh" "$SKILL_DIR/task.sh"
+  chmod +x "$SKILL_DIR/task.sh"
+fi
+# SKILL.md — fill in the template.
+if confirm_overwrite "$SKILL_DIR/SKILL.md"; then
+  sed \
+    -e "s#__PROJECT_LABEL__#$LABEL#g" \
+    -e "s#__PROJECT_ID__#$PROJECT_ID#g" \
+    -e "s#__TASK_SH_PATH__#$SKILL_DIR/task.sh#g" \
+    "$SCRIPT_DIR/templates/SKILL.md.tmpl" > "$SKILL_DIR/SKILL.md"
+fi
+# 3) Generic ctm-* teammate definitions (.claude/agents/) — NOT project-specific; they read
+# the concrete stack/conventions from the target project's own documentation.
+AGENTS_DIR="$TARGET_DIR/.claude/agents"
+mkdir -p "$AGENTS_DIR"
+installed_agents=()
+for tmpl in "$SCRIPT_DIR"/templates/agents/*.md.tmpl; do
+  [[ -e "$tmpl" ]] || continue
+  name="$(basename "$tmpl" .md.tmpl)"
+  out="$AGENTS_DIR/$name.md"
+  if confirm_overwrite "$out"; then
+    sed \
+      -e "s#__PROJECT_LABEL__#$LABEL#g" \
+      -e "s#__PROJECT_ID__#$PROJECT_ID#g" \
+      -e "s#__TASK_SH_PATH__#$SKILL_DIR/task.sh#g" \
+      "$tmpl" > "$out"
+    installed_agents+=("$name")
+  fi
+done
+# 4) Hooks (.claude/hooks/) — PreToolUse auto-allow + PostToolUse inbox notification for
+# task.sh calls, registered additively in .claude/settings.json.
+HOOKS_DIR="$TARGET_DIR/.claude/hooks"
+mkdir -p "$HOOKS_DIR"
+installed_hooks=()
+for tmpl in "$SCRIPT_DIR"/templates/hooks/*.sh.tmpl; do
+  [[ -e "$tmpl" ]] || continue
+  name="$(basename "$tmpl" .tmpl)"
+  out="$HOOKS_DIR/$name"
+  if confirm_overwrite "$out"; then
+    sed -e "s#__TARGET_DIR__#$TARGET_DIR#g" "$tmpl" > "$out"
+    chmod +x "$out"
+    installed_hooks+=("$name")
+  fi
+done
+SETTINGS_JSON_FILE="$TARGET_DIR/.claude/settings.json"
+[[ -f "$SETTINGS_JSON_FILE" ]] || echo '{"hooks":{}}' > "$SETTINGS_JSON_FILE"
+PRE_CMD="bash \"\$CLAUDE_PROJECT_DIR/.claude/hooks/allow-task-sh.sh\""
+POST_CMD="bash \"\$CLAUDE_PROJECT_DIR/.claude/hooks/notify-inbox.sh\""
+tmp="$(mktemp)"
+jq --arg pre "$PRE_CMD" --arg post "$POST_CMD" '
+  .hooks.PreToolUse //= [] |
+  .hooks.PreToolUse |= (
+    if any(.[]; (.hooks // [])[]?.command == $pre) then .
+    else . + [{matcher:"Bash", hooks:[{type:"command", command:$pre, timeout:10}]}] end
+  ) |
+  .hooks.PostToolUse //= [] |
+  .hooks.PostToolUse |= (
+    if any(.[]; (.hooks // [])[]?.command == $post) then .
+    else . + [{matcher:"Bash", hooks:[{type:"command", command:$post, timeout:10}]}] end
+  )
+' "$SETTINGS_JSON_FILE" > "$tmp" && mv "$tmp" "$SETTINGS_JSON_FILE"
+# 5) Extend .claude/settings.local.json's Bash allowlist (keeps the existing file, only
+# appends — never overwrites other permissions already present).
+SETTINGS_FILE="$TARGET_DIR/.claude/settings.local.json"
+mkdir -p "$TARGET_DIR/.claude"
+ENTRIES_JSON=$(jq -n --arg abs "$SKILL_DIR/task.sh" '
+  [
+    ("Bash(" + $abs + ":*)"),
+    "Bash(.claude/skills/task-manager/task.sh:*)",
+    "Bash(bash .claude/skills/task-manager/task.sh:*)",
+    "Bash(./task.sh:*)",
+    "Bash(bash ./task.sh:*)"
+  ]')
+if [[ -f "$SETTINGS_FILE" ]]; then
+  tmp="$(mktemp)"
+  jq --argjson entries "$ENTRIES_JSON" '
+    .permissions //= {} | .permissions.allow //= [] |
+    .permissions.allow = ((.permissions.allow + $entries) | unique)
+  ' "$SETTINGS_FILE" > "$tmp" && mv "$tmp" "$SETTINGS_FILE"
+else
+  jq -n --argjson entries "$ENTRIES_JSON" '{permissions:{allow:$entries}}' > "$SETTINGS_FILE"
+fi
+# 6) Register the global `ctm` command (if not already on PATH) — so "ctm init"/"ctm
+# list"/"ctm up" are reachable from any project without remembering the absolute
+# install.sh path.
+ensure_ctm_command() {
+  if command -v ctm >/dev/null 2>&1; then
+    return 0
+  fi
+  local target="$SCRIPT_DIR/bin/ctm"
+  local dir candidates=("/usr/local/bin" "$HOME/.local/bin")
+  for dir in "${candidates[@]}"; do
+    if [[ -d "$dir" && -w "$dir" ]]; then
+      ln -sf "$target" "$dir/ctm"
+      echo "ctm command registered: $dir/ctm -> $target"
+      [[ ":$PATH:" == *":$dir:"* ]] || echo "  NOTE: $dir is not on PATH — add it: export PATH=\"$dir:\$PATH\""
+      return 0
+    fi
+  done
+  mkdir -p "$HOME/.local/bin"
+  ln -sf "$target" "$HOME/.local/bin/ctm"
+  echo "ctm command registered: $HOME/.local/bin/ctm -> $target"
+  [[ ":$PATH:" == *":$HOME/.local/bin:"* ]] || echo "  NOTE: $HOME/.local/bin is not on PATH — add it: export PATH=\"$HOME/.local/bin:\$PATH\""
+}
+ensure_ctm_command
+echo
+echo "Done."
+echo "  task.sh   : $SKILL_DIR/task.sh   (host-bash, docker NOT required)"
+echo "  SKILL.md  : $SKILL_DIR/SKILL.md"
+echo "  agents    : ${installed_agents[*]:-(none written)} ($AGENTS_DIR)"
+echo "  hooks     : ${installed_hooks[*]:-(none written)} ($HOOKS_DIR) — registered in $SETTINGS_JSON_FILE"
+echo "  allowlist : $SETTINGS_FILE extended"
+echo "  Board     : ctm up   →  http://localhost:3333/"
+echo "              (pick \"$LABEL\" in the Source selector)"

package/js/ApiClient.js ADDED Viewed

@@ -0,0 +1,63 @@
+import { I18n } from "./i18n.js";
+/**
+ * ApiClient — the board's WRITE client toward the api/index.php bridge.
+ *
+ * Writes go EXCLUSIVELY through `POST api/index.php`, which calls engine/task.sh on the
+ * server (`--as <actor>`, `TM_DIR=<project data dir>`). The browser never writes the JSON
+ * directly → task.sh's sole-writer invariant is preserved (atomic lock, history, events,
+ * inbox). Multi-project: every request states WHICH registered project it targets (the
+ * server allowlists this against data/projects.json).
+ *
+ * Every write also carries the board's current UI language (`lang`). The server persists
+ * it as the project's preferred language (NOT inside any task) — engine/task.sh then prints
+ * a language reminder whenever an agent next runs it, so the agent replies/works in the
+ * language the human was using on the board.
+ */
+export class ApiClient {
+  /**
+   * @param getActor  - () => string : the current actor (agent name) for --as
+   * @param getProject - () => string : the currently selected project id
+   */
+  constructor(getActor, getProject) {
+    this.getActor = getActor;
+    this.getProject = getProject;
+    this.enabled = location.protocol === "http:" || location.protocol === "https:";
+  }
+  /** One task.sh command. args: string[]. Throws on error (the caller shows it in the banner). */
+  cmd(cmd, args = []) {
+    return this.run([{ cmd, args }]);
+  }
+  /**
+   * Multiple task.sh commands in ONE request, in order (e.g. "changes needed" = note + status).
+   * The server stops at the first failing step → no half-applied transition.
+   * @param ops - [{ cmd, args }]
+   */
+  async run(ops) {
+    if (!this.enabled)
+      throw new Error(I18n.t("app.notEnabled"));
+    const as = (this.getActor() || "").trim();
+    if (!as)
+      throw new Error(I18n.t("app.setActorFirst"));
+    const project = (this.getProject() || "").trim();
+    if (!project)
+      throw new Error(I18n.t("app.noProjectSelected"));
+    // Relative path: index.html lives at the project root, so this resolves to
+    // api/index.php (port/host-independent).
+    const res = await fetch("api/index.php", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ as, project, lang: I18n.lang, ops }),
+    });
+    let data = {};
+    try { data = await res.json(); } catch { /* non-JSON response */ }
+    if (!res.ok || !data.ok) {
+      const first = Array.isArray(data.results) ? data.results.find(r => !r.ok) : null;
+      throw new Error((first && (first.err || first.cmd)) || data.error || ("HTTP " + res.status));
+    }
+    return data;
+  }
+}