@nightkatana/kronosys-app 1.0.0-beta.2 → 1.0.0-beta.21

package/components/dashboard/SettingsTagsProjectsSection.tsx

@@ -1,11 +1,24 @@
 "use client";
 
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { EyeOff, FolderKanban, Pin, PinOff, Play, Plus, RotateCcw, Save, Tags, Trash2 } from "lucide-react";
+import {
+  EyeOff,
+  FolderKanban,
+  Pin,
+  PinOff,
+  Play,
+  Plus,
+  Pencil,
+  RotateCcw,
+  Save,
+  Tags,
+  Trash2,
+} from "lucide-react";
 import { postKronosysAction } from "@/lib/kronosysApi";
 import type { KronosysUpdatePayload } from "@/lib/kronosysApi";
 import type { Lang } from "@/lib/dashboardCopy";
 import type { SettingsCopy } from "@/lib/settingsCopy";
+import { SettingsTaskTemplatesSection } from "./SettingsTaskTemplatesSection";
 import {
   buildStartTaskFromDraft,
   formatProjectDisplay,
@@ -14,7 +27,10 @@ import {
   normalizeTagKey,
   parseProjectScopedTag,
 } from "@/lib/taskParsing";
-import { DashboardConfirmModal, DashboardTriActionModal } from "./DashboardSimpleModal";
+import {
+  DashboardConfirmModal,
+  DashboardTriActionModal,
+} from "./DashboardSimpleModal";
 import { useDashboardToast } from "@/components/dashboard/DashboardToastProvider";
 import { InlineMetricHelpTrigger } from "./InlineMetricHelpTrigger";
 import {
@@ -44,7 +60,14 @@ const ICON_BTN_SAVE =
 const ICON_BTN_PRIMARY =
   "inline-flex h-8 w-8 shrink-0 items-center justify-center rounded-md border border-violet-500/50 bg-violet-500/10 text-violet-800 shadow-sm transition hover:border-violet-500/75 hover:bg-violet-500/18 disabled:opacity-40 dark:border-violet-400/45 dark:bg-violet-600/20 dark:text-violet-100 dark:hover:border-violet-400/60 dark:hover:bg-violet-600/30";
 
-type LiveActiveTaskShape = { id: string; isDone?: boolean; manualTaskTimerPaused?: boolean };
+const RENAME_IMPACT_CONFIRM_STORAGE_KEY =
+  "kronosys.settings.renameImpactConfirm.dismiss.v1";
+
+type LiveActiveTaskShape = {
+  id: string;
+  isDone?: boolean;
+  manualTaskTimerPaused?: boolean;
+};
 
 type CurrentSessionShape = {
   sessionId?: string;
@@ -52,7 +75,9 @@ type CurrentSessionShape = {
   activeTask?: LiveActiveTaskShape | null;
 };
 
-function runningTrackingTasks(live: CurrentSessionShape | null | undefined): LiveActiveTaskShape[] {
+function runningTrackingTasks(
+  live: CurrentSessionShape | null | undefined,
+): LiveActiveTaskShape[] {
   if (!live) {
     return [];
   }
@@ -60,9 +85,12 @@ function runningTrackingTasks(live: CurrentSessionShape | null | undefined): Liv
     Array.isArray(live.activeTasks) && live.activeTasks.length > 0
       ? live.activeTasks
       : live.activeTask
-        ? [live.activeTask]
-        : [];
-  return raw.filter((t): t is LiveActiveTaskShape => !!t && !t.isDone && !t.manualTaskTimerPaused);
+      ? [live.activeTask]
+      : [];
+  return raw.filter(
+    (t): t is LiveActiveTaskShape =>
+      !!t && !t.isDone && !t.manualTaskTimerPaused,
+  );
 }
 
 type ConfirmState =
@@ -70,7 +98,9 @@ type ConfirmState =
   | { kind: "unpin"; tag: string }
   | { kind: "exclude"; tag: string }
   | { kind: "purgeTag"; tag: string; fromExcludedList?: boolean }
-  | { kind: "purgeProject"; name: string };
+  | { kind: "purgeProject"; name: string }
+  | { kind: "renameTag"; sourceTag: string; targetTag: string }
+  | { kind: "renameProject"; sourceName: string; targetName: string };
 
 type TagEditorRowProps = {
   tag: string;
@@ -82,6 +112,7 @@ type TagEditorRowProps = {
   pinnedKeys: Set<string>;
   post: (body: Record<string, unknown>) => Promise<void>;
   setConfirm: (c: ConfirmState) => void;
+  dismissRenameImpactConfirm: boolean;
   onStartTrackedTask?: () => void;
 };
 
@@ -95,15 +126,76 @@ function SettingsTagEditorRow({
   pinnedKeys,
   post,
   setConfirm,
+  dismissRenameImpactConfirm,
   onStartTrackedTask,
 }: TagEditorRowProps) {
   const tagKey = normalizeTagKey(tag).toLowerCase();
   const isPinned = pinnedKeys.has(tagKey);
+  const [renameOpen, setRenameOpen] = useState(false);
+  const [renameDraft, setRenameDraft] = useState(normalizeTagKey(tag));
+  const canSubmitRename =
+    normalizeTagKey(renameDraft) &&
+    normalizeTagKey(renameDraft).toLowerCase() !==
+      normalizeTagKey(tag).toLowerCase();
+
+  useEffect(() => {
+    setRenameOpen(false);
+    setRenameDraft(normalizeTagKey(tag));
+  }, [tag]);
   return (
     <li className="border-b border-zinc-200 py-3 last:border-b-0 dark:border-zinc-800/90">
       <div className="flex flex-col gap-2.5">
         <div className="flex min-w-0 flex-wrap items-center gap-2">
-          <span className="font-mono text-sm text-zinc-900 dark:text-zinc-100">{formatTagDisplay(tag)}</span>
+          {renameOpen ? (
+            <input
+              type="text"
+              className="min-w-[12rem] flex-1 rounded border border-zinc-300 bg-white px-2 py-1 font-mono text-sm text-zinc-900 outline-none ring-violet-500/30 focus:ring-2 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100"
+              value={renameDraft}
+              onChange={(e) => setRenameDraft(e.target.value)}
+              onKeyDown={(e) => {
+                if (e.key === "Escape") {
+                  e.preventDefault();
+                  setRenameDraft(normalizeTagKey(tag));
+                  setRenameOpen(false);
+                  return;
+                }
+                if (e.key !== "Enter") {
+                  return;
+                }
+                e.preventDefault();
+                const target = normalizeTagKey(renameDraft);
+                if (
+                  !target ||
+                  target.toLowerCase() === normalizeTagKey(tag).toLowerCase()
+                ) {
+                  return;
+                }
+                setRenameOpen(false);
+                if (dismissRenameImpactConfirm) {
+                  void post({
+                    type: "renameTagMetadata",
+                    sourceTag: tag,
+                    targetTag: target,
+                  });
+                  return;
+                }
+                setConfirm({
+                  kind: "renameTag",
+                  sourceTag: tag,
+                  targetTag: target,
+                });
+              }}
+              disabled={disabled}
+              aria-label={s.tagRenamePrompt}
+              placeholder={s.tagRenamePrompt}
+              spellCheck={false}
+              autoComplete="off"
+            />
+          ) : (
+            <span className="font-mono text-sm text-zinc-900 dark:text-zinc-100">
+              {formatTagDisplay(tag)}
+            </span>
+          )}
           {isPinned ? (
             <span className="rounded border border-violet-500/45 bg-violet-500/10 px-1.5 py-0.5 text-[0.65rem] font-semibold uppercase tracking-wide text-violet-800 dark:text-violet-200">
               {s.tagBadgePinned}
@@ -115,7 +207,9 @@ function SettingsTagEditorRow({
           type="text"
           className={INLINE_INPUT_CLASS}
           value={localTagDesc[tagKey] ?? ""}
-          onChange={(e) => setLocalTagDesc((prev) => ({ ...prev, [tagKey]: e.target.value }))}
+          onChange={(e) =>
+            setLocalTagDesc((prev) => ({ ...prev, [tagKey]: e.target.value }))
+          }
           disabled={disabled}
           placeholder={s.tagDescriptionLabel}
           spellCheck
@@ -166,20 +260,81 @@ function SettingsTagEditorRow({
           </button>
           <button
             type="button"
-            className={ICON_BTN_SAVE}
+            className={ICON_BTN}
             disabled={disabled}
-            title={s.descriptionSaveBtn}
-            aria-label={s.descriptionSaveBtn}
-            onClick={() =>
-              void post({
-                type: "setTagDescription",
-                tag,
-                description: localTagDesc[tagKey] ?? "",
-              })
-            }
+            title={s.tagRenameBtn}
+            aria-label={s.tagRenameBtn}
+            onClick={() => {
+              setRenameDraft(normalizeTagKey(tag));
+              setRenameOpen(true);
+            }}
           >
-            <Save size={16} strokeWidth={2} aria-hidden />
+            <Pencil size={16} strokeWidth={2} aria-hidden />
           </button>
+          {renameOpen ? (
+            <>
+              <button
+                type="button"
+                className={ICON_BTN_SAVE}
+                disabled={disabled || !canSubmitRename}
+                title={s.descriptionSaveBtn}
+                aria-label={s.descriptionSaveBtn}
+                onClick={() => {
+                  const target = normalizeTagKey(renameDraft);
+                  if (!target) {
+                    return;
+                  }
+                  setRenameOpen(false);
+                  if (dismissRenameImpactConfirm) {
+                    void post({
+                      type: "renameTagMetadata",
+                      sourceTag: tag,
+                      targetTag: target,
+                    });
+                    return;
+                  }
+                  setConfirm({
+                    kind: "renameTag",
+                    sourceTag: tag,
+                    targetTag: target,
+                  });
+                }}
+              >
+                <Save size={16} strokeWidth={2} aria-hidden />
+              </button>
+              <button
+                type="button"
+                className={ICON_BTN}
+                disabled={disabled}
+                title={s.dialogCancelBtn}
+                aria-label={s.dialogCancelBtn}
+                onClick={() => {
+                  setRenameDraft(normalizeTagKey(tag));
+                  setRenameOpen(false);
+                }}
+              >
+                <RotateCcw size={16} strokeWidth={2} aria-hidden />
+              </button>
+            </>
+          ) : null}
+          {!renameOpen ? (
+            <button
+              type="button"
+              className={ICON_BTN_SAVE}
+              disabled={disabled}
+              title={s.descriptionSaveBtn}
+              aria-label={s.descriptionSaveBtn}
+              onClick={() =>
+                void post({
+                  type: "setTagDescription",
+                  tag,
+                  description: localTagDesc[tagKey] ?? "",
+                })
+              }
+            >
+              <Save size={16} strokeWidth={2} aria-hidden />
+            </button>
+          ) : null}
           {onStartTrackedTask ? (
             <button
               type="button"
@@ -189,7 +344,13 @@ function SettingsTagEditorRow({
               aria-label={s.tagStartTrackedTaskBtn}
               onClick={() => void onStartTrackedTask()}
             >
-              <Play size={16} strokeWidth={2} className="ml-0.5" fill="currentColor" aria-hidden />
+              <Play
+                size={16}
+                strokeWidth={2}
+                className="ml-0.5"
+                fill="currentColor"
+                aria-hidden
+              />
             </button>
           ) : null}
         </div>
@@ -200,7 +361,7 @@ function SettingsTagEditorRow({
 
 export function SettingsTagsProjectsSection({
   s,
-  lang: _lang,
+  lang,
   payload,
   saving,
   refresh,
@@ -210,36 +371,77 @@ export function SettingsTagsProjectsSection({
   lang: Lang;
   payload: KronosysUpdatePayload | null;
   saving: boolean;
-  refresh: (options?: { preserveForm?: boolean; routerInvalidate?: boolean }) => Promise<boolean | void>;
+  refresh: (options?: {
+    preserveForm?: boolean;
+    routerInvalidate?: boolean;
+  }) => Promise<boolean | void>;
   /** `dashboard` : pas de titre de page ni bordure de section (colonne du tableau de bord). */
   variant?: "settings" | "dashboard";
 }) {
-  void _lang;
   const pid = variant === "dashboard" ? "dashboard" : "settings";
   const showPageHeader = variant === "settings";
   const [pinGlobalDraft, setPinGlobalDraft] = useState("");
+  const [projectDraft, setProjectDraft] = useState("");
   /** Brouillon d’épingle Projet#code par clé de projet (minuscules). */
-  const [pinScopedByProject, setPinScopedByProject] = useState<Record<string, string>>({});
+  const [pinScopedByProject, setPinScopedByProject] = useState<
+    Record<string, string>
+  >({});
   const [busy, setBusy] = useState(false);
   const [confirm, setConfirm] = useState<ConfirmState>(null);
   /** Colonne tableau de bord : onglets globaux / projets (paramètres : affichage continu inchangé). */
-  const [dashTagsTab, setDashTagsTab] = useState<"global" | "projects">("global");
-  const pendingStartRef = useRef<{ name: string; tags: string[]; project?: string } | null>(null);
+  const [dashTagsTab, setDashTagsTab] = useState<
+    "global" | "projects" | "templates"
+  >("global");
+  const [scopeSourceTag, setScopeSourceTag] = useState("");
+  const [scopeTargetProjectLower, setScopeTargetProjectLower] = useState("");
+  const pendingStartRef = useRef<{
+    name: string;
+    tags: string[];
+    project?: string;
+  } | null>(null);
   const [trackingConflictOpen, setTrackingConflictOpen] = useState(false);
-  const [rememberConcurrentChoice, setRememberConcurrentChoice] = useState(false);
+  const [rememberConcurrentChoice, setRememberConcurrentChoice] =
+    useState(false);
+  const [dismissRenameImpactConfirm, setDismissRenameImpactConfirm] =
+    useState(false);
   const { pushToast } = useDashboardToast();
 
+  useEffect(() => {
+    try {
+      setDismissRenameImpactConfirm(
+        globalThis.localStorage?.getItem(RENAME_IMPACT_CONFIRM_STORAGE_KEY) ===
+          "1",
+      );
+    } catch {
+      setDismissRenameImpactConfirm(false);
+    }
+  }, []);
+
   const knownTags = (payload?.knownTags ?? []) as string[];
   const knownProjects = (payload?.knownProjects ?? []) as string[];
   const userKnownTags = (payload?.userKnownTags ?? []) as string[];
   const excludedRaw = (payload?.excludedSuggestionTags ?? []) as string[];
-  const tagDescFromPayload = (payload?.tagDescriptions ?? {}) as Record<string, string>;
-  const projectDescFromPayload = (payload?.projectDescriptions ?? {}) as Record<string, string>;
+  const tagDescFromPayload = (payload?.tagDescriptions ?? {}) as Record<
+    string,
+    string
+  >;
+  const projectDescFromPayload = (payload?.projectDescriptions ?? {}) as Record<
+    string,
+    string
+  >;
   const tagDescSerialized = JSON.stringify(tagDescFromPayload);
   const projectDescSerialized = JSON.stringify(projectDescFromPayload);
 
   const [localTagDesc, setLocalTagDesc] = useState<Record<string, string>>({});
-  const [localProjectDesc, setLocalProjectDesc] = useState<Record<string, string>>({});
+  const [localProjectDesc, setLocalProjectDesc] = useState<
+    Record<string, string>
+  >({});
+  const [projectRenameOpenByKey, setProjectRenameOpenByKey] = useState<
+    Record<string, boolean>
+  >({});
+  const [projectRenameDraftByKey, setProjectRenameDraftByKey] = useState<
+    Record<string, string>
+  >({});
 
   useEffect(() => {
     try {
@@ -251,20 +453,35 @@ export function SettingsTagsProjectsSection({
 
   useEffect(() => {
     try {
-      setLocalProjectDesc(JSON.parse(projectDescSerialized) as Record<string, string>);
+      setLocalProjectDesc(
+        JSON.parse(projectDescSerialized) as Record<string, string>,
+      );
     } catch {
       setLocalProjectDesc({});
     }
   }, [projectDescSerialized]);
 
+  useEffect(() => {
+    const nextDraft: Record<string, string> = {};
+    for (const proj of knownProjects) {
+      const pk = normalizeProjectKey(proj).toLowerCase();
+      nextDraft[pk] = normalizeProjectKey(proj);
+    }
+    setProjectRenameDraftByKey(nextDraft);
+    setProjectRenameOpenByKey({});
+  }, [knownProjects]);
+
   const pinnedKeys = useMemo(
     () => new Set(userKnownTags.map((t) => normalizeTagKey(t).toLowerCase())),
-    [userKnownTags]
+    [userKnownTags],
   );
 
   const { globalKnownTags, scopedSections } = useMemo(() => {
     const global: string[] = [];
-    const scopedMap = new Map<string, { tags: string[]; displayProject: string }>();
+    const scopedMap = new Map<
+      string,
+      { tags: string[]; displayProject: string }
+    >();
     for (const tag of knownTags) {
       const nk = normalizeTagKey(tag);
       const scoped = parseProjectScopedTag(nk);
@@ -292,11 +509,15 @@ export function SettingsTagsProjectsSection({
     }
     for (const [, entry] of scopedMap) {
       entry.tags.sort((a, b) =>
-        normalizeTagKey(a).localeCompare(normalizeTagKey(b), undefined, { sensitivity: "base" })
+        normalizeTagKey(a).localeCompare(normalizeTagKey(b), undefined, {
+          sensitivity: "base",
+        }),
       );
     }
     global.sort((a, b) =>
-      normalizeTagKey(a).localeCompare(normalizeTagKey(b), undefined, { sensitivity: "base" })
+      normalizeTagKey(a).localeCompare(normalizeTagKey(b), undefined, {
+        sensitivity: "base",
+      }),
     );
     const projectOrderLower: string[] = [];
     const seen = new Set<string>();
@@ -322,13 +543,34 @@ export function SettingsTagsProjectsSection({
   }, [knownTags, knownProjects]);
 
   const knownProjectLowerSet = useMemo(
-    () => new Set(knownProjects.map((p) => normalizeProjectKey(p).toLowerCase())),
-    [knownProjects]
+    () =>
+      new Set(knownProjects.map((p) => normalizeProjectKey(p).toLowerCase())),
+    [knownProjects],
+  );
+  const knownProjectOptions = useMemo(
+    () =>
+      knownProjects.map((p) => ({
+        lower: normalizeProjectKey(p).toLowerCase(),
+        label: normalizeProjectKey(p),
+      })),
+    [knownProjects],
+  );
+  const allKnownTagsSorted = useMemo(
+    () =>
+      [...knownTags].sort((a, b) =>
+        normalizeTagKey(a).localeCompare(normalizeTagKey(b), undefined, {
+          sensitivity: "base",
+        }),
+      ),
+    [knownTags],
   );
 
   const orphanScopedSections = useMemo(
-    () => scopedSections.filter((sec) => !knownProjectLowerSet.has(sec.projectLower)),
-    [scopedSections, knownProjectLowerSet]
+    () =>
+      scopedSections.filter(
+        (sec) => !knownProjectLowerSet.has(sec.projectLower),
+      ),
+    [scopedSections, knownProjectLowerSet],
   );
 
   const post = async (body: Record<string, unknown>) => {
@@ -336,12 +578,44 @@ export function SettingsTagsProjectsSection({
     try {
       await postKronosysAction(body);
       await refresh({ preserveForm: true });
+    } catch (e: unknown) {
+      const fallback =
+        lang === "fr"
+          ? "Impossible d’enregistrer la modification."
+          : "Failed to save the change.";
+      const detail = e instanceof Error ? e.message.trim() : String(e).trim();
+      pushToast(detail ? `${fallback} ${detail}` : fallback);
     } finally {
       setBusy(false);
     }
   };
 
   const disabled = saving || busy;
+  const sourceScoped = parseProjectScopedTag(normalizeTagKey(scopeSourceTag));
+  const scopeTargetTag = useMemo(() => {
+    const source = normalizeTagKey(scopeSourceTag);
+    if (!source) {
+      return "";
+    }
+    if (!scopeTargetProjectLower) {
+      return sourceScoped ? normalizeTagKey(sourceScoped.localTag) : "";
+    }
+    const targetProject =
+      knownProjectOptions.find((p) => p.lower === scopeTargetProjectLower)
+        ?.label ?? scopeTargetProjectLower;
+    const local = sourceScoped ? sourceScoped.localTag : source;
+    return normalizeTagKey(`${targetProject}#${local}`);
+  }, [
+    knownProjectOptions,
+    scopeSourceTag,
+    scopeTargetProjectLower,
+    sourceScoped,
+  ]);
+  const canRunScopeMigration =
+    normalizeTagKey(scopeSourceTag) &&
+    normalizeTagKey(scopeTargetTag) &&
+    normalizeTagKey(scopeSourceTag).toLowerCase() !==
+      normalizeTagKey(scopeTargetTag).toLowerCase();
 
   const addPinGlobal = async () => {
     const t = pinGlobalDraft.replace(/^#/, "").trim();
@@ -352,15 +626,38 @@ export function SettingsTagsProjectsSection({
     setPinGlobalDraft("");
   };
 
-  const addPinScopedForProject = async (canonicalProject: string, projectLower: string) => {
-    const raw = (pinScopedByProject[projectLower] ?? "").replace(/^#/, "").trim();
+  const addProject = async () => {
+    const project = normalizeProjectKey(projectDraft);
+    if (!project) {
+      return;
+    }
+    if (
+      knownProjects.some(
+        (p) => normalizeProjectKey(p).toLowerCase() === project.toLowerCase(),
+      )
+    ) {
+      return;
+    }
+    await post({ type: "rememberKnownProject", name: project });
+    setProjectDraft("");
+  };
+
+  const addPinScopedForProject = async (
+    canonicalProject: string,
+    projectLower: string,
+  ) => {
+    const raw = (pinScopedByProject[projectLower] ?? "")
+      .replace(/^#/, "")
+      .trim();
     if (!raw) {
       return;
     }
     const parsed = parseProjectScopedTag(raw);
     let tag: string;
     if (parsed) {
-      if (normalizeProjectKey(parsed.projectKey).toLowerCase() !== projectLower) {
+      if (
+        normalizeProjectKey(parsed.projectKey).toLowerCase() !== projectLower
+      ) {
         return;
       }
       tag = `${parsed.projectKey}#${parsed.localTag}`;
@@ -375,13 +672,17 @@ export function SettingsTagsProjectsSection({
   };
 
   const scopedPinDraftIsSubmittable = (projectLower: string) => {
-    const raw = (pinScopedByProject[projectLower] ?? "").replace(/^#/, "").trim();
+    const raw = (pinScopedByProject[projectLower] ?? "")
+      .replace(/^#/, "")
+      .trim();
     if (!raw) {
       return false;
     }
     const parsed = parseProjectScopedTag(raw);
     if (parsed) {
-      return normalizeProjectKey(parsed.projectKey).toLowerCase() === projectLower;
+      return (
+        normalizeProjectKey(parsed.projectKey).toLowerCase() === projectLower
+      );
     }
     return true;
   };
@@ -424,9 +725,17 @@ export function SettingsTagsProjectsSection({
         if (mode !== "parallel") {
           for (const t of running) {
             if (mode === "pause") {
-              await postKronosysAction({ type: "setTaskTimerPaused", taskId: t.id, paused: true });
+              await postKronosysAction({
+                type: "setTaskTimerPaused",
+                taskId: t.id,
+                paused: true,
+              });
             } else {
-              await postKronosysAction({ type: "finishTask", taskId: t.id, shouldCommit: false });
+              await postKronosysAction({
+                type: "finishTask",
+                taskId: t.id,
+                shouldCommit: false,
+              });
             }
           }
         }
@@ -445,7 +754,7 @@ export function SettingsTagsProjectsSection({
         setBusy(false);
       }
     },
-    [payload?.current, refresh]
+    [payload?.current, refresh],
   );
 
   const requestStartTask = useCallback(
@@ -480,7 +789,14 @@ export function SettingsTagsProjectsSection({
         await flushPendingStartTask();
       }
     },
-    [payload?.current, flushPendingStartTask, resolveConflictAndStart, post, pushToast, s.tagStartTaskAutoSessionToast]
+    [
+      payload?.current,
+      flushPendingStartTask,
+      resolveConflictAndStart,
+      post,
+      pushToast,
+      s.tagStartTaskAutoSessionToast,
+    ],
   );
 
   const requestStartFromTag = useCallback(
@@ -491,7 +807,7 @@ export function SettingsTagsProjectsSection({
       const draft = buildStartTaskFromDraft("", [token], projectForPicker);
       void requestStartTask(draft);
     },
-    [requestStartTask]
+    [requestStartTask],
   );
 
   const requestStartFromProject = useCallback(
@@ -499,7 +815,7 @@ export function SettingsTagsProjectsSection({
       const draft = buildStartTaskFromDraft("", [], normalizeProjectKey(proj));
       void requestStartTask(draft);
     },
-    [requestStartTask]
+    [requestStartTask],
   );
 
   const cancelTrackingConflict = useCallback(() => {
@@ -512,24 +828,34 @@ export function SettingsTagsProjectsSection({
     variant === "dashboard"
       ? "space-y-5"
       : "scroll-mt-24 space-y-6 border-b border-zinc-200 pb-10 dark:border-zinc-800";
-  const rootId = pid === "dashboard" ? "dashboard-tags-projects" : "settings-tags-projects";
+  const rootId =
+    pid === "dashboard" ? "dashboard-tags-projects" : "settings-tags-projects";
   const tagsByProjectScrollId =
-    variant === "settings" ? "settings-tags-by-project" : `${pid}-tags-by-project`;
+    variant === "settings"
+      ? "settings-tags-by-project"
+      : `${pid}-tags-by-project`;
 
   const linkedTagsBlock = (
     onStartFromTag: (tag: string) => void,
     sec: { projectLower: string; displayProject: string; tags: string[] },
     anchorSectionId: string | undefined,
     canonicalProject: string,
-    opts?: { omitSectionTitle?: boolean }
+    opts?: { omitSectionTitle?: boolean },
   ) => (
-    <div id={anchorSectionId} className="mt-4 border-t border-zinc-200 pt-4 dark:border-zinc-800">
+    <div
+      id={anchorSectionId}
+      className="mt-4 border-t border-zinc-200 pt-4 dark:border-zinc-800"
+    >
       {!opts?.omitSectionTitle ? (
         <h4 className="text-xs font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
           {s.tocSubTagsByProject}
         </h4>
       ) : null}
-      <div className={`flex max-w-md flex-col gap-2 ${opts?.omitSectionTitle ? "" : "mt-3"}`}>
+      <div
+        className={`flex max-w-md flex-col gap-2 ${
+          opts?.omitSectionTitle ? "" : "mt-3"
+        }`}
+      >
         <label
           className="block text-xs font-medium text-zinc-600 dark:text-zinc-400"
           htmlFor={`${pid}-pin-scoped-${sec.projectLower}`}
@@ -542,7 +868,10 @@ export function SettingsTagsProjectsSection({
           className="w-full rounded-lg border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 outline-none ring-violet-500/30 focus:ring-2 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100"
           value={pinScopedByProject[sec.projectLower] ?? ""}
           onChange={(e) =>
-            setPinScopedByProject((prev) => ({ ...prev, [sec.projectLower]: e.target.value }))
+            setPinScopedByProject((prev) => ({
+              ...prev,
+              [sec.projectLower]: e.target.value,
+            }))
           }
           placeholder={s.tagsPinScopedPlaceholder}
           disabled={disabled}
@@ -559,10 +888,14 @@ export function SettingsTagsProjectsSection({
           <button
             type="button"
             className={ICON_BTN_PRIMARY}
-            disabled={disabled || !scopedPinDraftIsSubmittable(sec.projectLower)}
+            disabled={
+              disabled || !scopedPinDraftIsSubmittable(sec.projectLower)
+            }
             title={s.tagsPinAddBtn}
             aria-label={s.tagsPinAddBtn}
-            onClick={() => void addPinScopedForProject(canonicalProject, sec.projectLower)}
+            onClick={() =>
+              void addPinScopedForProject(canonicalProject, sec.projectLower)
+            }
           >
             <Plus size={20} strokeWidth={2} aria-hidden />
           </button>
@@ -573,11 +906,15 @@ export function SettingsTagsProjectsSection({
       ) : (
         <ul
           className="mt-3"
-          aria-label={`${s.tocSubTagsByProject} — ${formatProjectDisplay(sec.displayProject)}`}
+          aria-label={`${s.tocSubTagsByProject} — ${formatProjectDisplay(
+            sec.displayProject,
+          )}`}
         >
           {sec.tags.map((tag, tagIdx) => (
             <SettingsTagEditorRow
-              key={`s-${sec.projectLower}-${normalizeTagKey(tag).toLowerCase()}`}
+              key={`s-${sec.projectLower}-${normalizeTagKey(
+                tag,
+              ).toLowerCase()}`}
               tag={tag}
               fieldId={`${pid}-scoped-tag-desc-${sec.projectLower}-${tagIdx}`}
               s={s}
@@ -587,6 +924,7 @@ export function SettingsTagsProjectsSection({
               pinnedKeys={pinnedKeys}
               post={post}
               setConfirm={setConfirm}
+              dismissRenameImpactConfirm={dismissRenameImpactConfirm}
               onStartTrackedTask={() => void onStartFromTag(tag)}
             />
           ))}
@@ -600,7 +938,9 @@ export function SettingsTagsProjectsSection({
       {showPageHeader ? (
         <>
           <div className="flex flex-wrap items-center gap-2">
-            <h2 className="text-xs font-semibold uppercase tracking-wide text-zinc-500">{s.sectionTagsProjects}</h2>
+            <h2 className="text-xs font-semibold uppercase tracking-wide text-zinc-500">
+              {s.sectionTagsProjects}
+            </h2>
             <InlineMetricHelpTrigger
               ariaLabel={s.tagsProjectsHelpAria}
               body={s.tagsProjectsHelpBody}
@@ -608,7 +948,9 @@ export function SettingsTagsProjectsSection({
               panelClassName="w-[min(calc(100vw-2rem),26rem)]"
             />
           </div>
-          <p className="text-xs leading-relaxed text-zinc-600 dark:text-zinc-400">{s.tagsProjectsIntro}</p>
+          <p className="text-xs leading-relaxed text-zinc-600 dark:text-zinc-400">
+            {s.tagsProjectsIntro}
+          </p>
         </>
       ) : null}
 
@@ -650,7 +992,29 @@ export function SettingsTagsProjectsSection({
             }`}
             onClick={() => setDashTagsTab("projects")}
           >
-            <FolderKanban size={20} strokeWidth={2} aria-hidden className="shrink-0" />
+            <FolderKanban
+              size={20}
+              strokeWidth={2}
+              aria-hidden
+              className="shrink-0"
+            />
+          </button>
+          <button
+            type="button"
+            role="tab"
+            id={`${pid}-tab-templates`}
+            aria-selected={dashTagsTab === "templates"}
+            aria-controls={`${pid}-tabpanel-templates`}
+            aria-label={s.tagsProjectsTabTemplates}
+            title={s.tagsProjectsTabTemplates}
+            className={`inline-flex min-w-0 flex-1 items-center justify-center rounded-md px-2 py-2 transition sm:px-2.5 ${
+              dashTagsTab === "templates"
+                ? "bg-white text-violet-700 shadow-sm dark:bg-zinc-800 dark:text-violet-300"
+                : "text-zinc-500 hover:bg-zinc-200/80 hover:text-zinc-900 dark:text-zinc-400 dark:hover:bg-zinc-800/80 dark:hover:text-zinc-100"
+            }`}
+            onClick={() => setDashTagsTab("templates")}
+          >
+            <Save size={20} strokeWidth={2} aria-hidden className="shrink-0" />
           </button>
         </div>
       ) : null}
@@ -658,194 +1022,524 @@ export function SettingsTagsProjectsSection({
       <div
         role={variant === "dashboard" ? "tabpanel" : undefined}
         id={variant === "dashboard" ? `${pid}-tabpanel-global` : undefined}
-        aria-labelledby={variant === "dashboard" ? `${pid}-tab-global` : undefined}
+        aria-labelledby={
+          variant === "dashboard" ? `${pid}-tab-global` : undefined
+        }
         hidden={variant === "dashboard" && dashTagsTab !== "global"}
         className={variant === "dashboard" ? "space-y-5" : "contents"}
       >
-      <div id={`${pid}-tags-global`} className={CARD_CLASS}>
-        <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">{s.tagsGlobalHeading}</h3>
-        <p className="mt-1 text-xs text-zinc-600 dark:text-zinc-400">{s.tagsGlobalIntro}</p>
-        <div className="mt-3 flex max-w-md flex-col gap-2">
-          <label className="block text-xs font-medium text-zinc-600 dark:text-zinc-400" htmlFor={`${pid}-pin-global-tag`}>
-            {s.tagsPinFieldLabel}
-          </label>
-          <input
-            id={`${pid}-pin-global-tag`}
-            type="text"
-            className="w-full rounded-lg border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 outline-none ring-violet-500/30 focus:ring-2 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100"
-            value={pinGlobalDraft}
-            onChange={(e) => setPinGlobalDraft(e.target.value)}
-            placeholder={s.tagsPinPlaceholder}
-            disabled={disabled}
-            autoComplete="off"
-            spellCheck={false}
-            onKeyDown={(e) => {
-              if (e.key === "Enter") {
-                e.preventDefault();
-                void addPinGlobal();
-              }
-            }}
-          />
-          <div className="flex">
-            <button
-              type="button"
-              className={ICON_BTN_PRIMARY}
-              disabled={
-                disabled ||
-                !pinGlobalDraft.trim() ||
-                !!parseProjectScopedTag(pinGlobalDraft.replace(/^#/, "").trim())
-              }
-              title={s.tagsPinAddBtn}
-              aria-label={s.tagsPinAddBtn}
-              onClick={() => void addPinGlobal()}
+        <div id={`${pid}-tags-global`} className={CARD_CLASS}>
+          <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">
+            {s.tagsGlobalHeading}
+          </h3>
+          <p className="mt-1 text-xs text-zinc-600 dark:text-zinc-400">
+            {s.tagsGlobalIntro}
+          </p>
+          <div className="mt-3 max-w-md rounded-lg border border-zinc-200 bg-white/60 p-3 dark:border-zinc-700 dark:bg-zinc-900/40">
+            <h4 className="text-xs font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+              {s.tagsScopeToolHeading}
+            </h4>
+            {allKnownTagsSorted.length === 0 ? (
+              <p className="mt-2 text-xs text-zinc-500 dark:text-zinc-400">
+                {s.tagsScopeToolNoTags}
+              </p>
+            ) : (
+              <div className="mt-2 space-y-2">
+                <label className="block text-xs text-zinc-600 dark:text-zinc-400">
+                  <span className="mb-1 block">
+                    {s.tagsScopeToolSourceLabel}
+                  </span>
+                  <select
+                    className="w-full rounded-lg border border-zinc-300 bg-white px-2.5 py-2 text-xs text-zinc-900 dark:border-zinc-600 dark:bg-zinc-950 dark:text-zinc-100"
+                    value={scopeSourceTag}
+                    onChange={(e) => setScopeSourceTag(e.target.value)}
+                    disabled={disabled}
+                  >
+                    <option value="" />
+                    {allKnownTagsSorted.map((tag) => (
+                      <option key={tag} value={tag}>
+                        {formatTagDisplay(tag)}
+                      </option>
+                    ))}
+                  </select>
+                </label>
+                <label className="block text-xs text-zinc-600 dark:text-zinc-400">
+                  <span className="mb-1 block">
+                    {s.tagsScopeToolTargetProjectLabel}
+                  </span>
+                  <select
+                    className="w-full rounded-lg border border-zinc-300 bg-white px-2.5 py-2 text-xs text-zinc-900 dark:border-zinc-600 dark:bg-zinc-950 dark:text-zinc-100"
+                    value={scopeTargetProjectLower}
+                    onChange={(e) => setScopeTargetProjectLower(e.target.value)}
+                    disabled={disabled}
+                  >
+                    <option value="">
+                      {s.tagsScopeToolTargetGlobalOption}
+                    </option>
+                    {knownProjectOptions.map((proj) => (
+                      <option key={proj.lower} value={proj.lower}>
+                        {formatProjectDisplay(proj.label)}
+                      </option>
+                    ))}
+                  </select>
+                </label>
+                <div className="flex flex-wrap gap-1.5">
+                  <button
+                    type="button"
+                    className="rounded-md border border-zinc-300 bg-white px-2.5 py-1.5 text-xs text-zinc-700 hover:bg-zinc-100 disabled:opacity-40 dark:border-zinc-600 dark:bg-zinc-900 dark:text-zinc-200 dark:hover:bg-zinc-800"
+                    disabled={disabled || !canRunScopeMigration}
+                    onClick={() =>
+                      void post({
+                        type: "transformKnownTagScope",
+                        sourceTag: scopeSourceTag,
+                        targetTag: scopeTargetTag,
+                        mode: "copy",
+                      })
+                    }
+                  >
+                    {s.tagsScopeToolCopyBtn}
+                  </button>
+                  <button
+                    type="button"
+                    className="rounded-md border border-violet-500/50 bg-violet-500/10 px-2.5 py-1.5 text-xs text-violet-800 hover:bg-violet-500/20 disabled:opacity-40 dark:border-violet-400/45 dark:bg-violet-600/20 dark:text-violet-100 dark:hover:bg-violet-600/30"
+                    disabled={disabled || !canRunScopeMigration}
+                    onClick={() =>
+                      void post({
+                        type: "transformKnownTagScope",
+                        sourceTag: scopeSourceTag,
+                        targetTag: scopeTargetTag,
+                        mode: "move",
+                      })
+                    }
+                  >
+                    {s.tagsScopeToolMoveBtn}
+                  </button>
+                </div>
+              </div>
+            )}
+          </div>
+          <div className="mt-3 flex max-w-md flex-col gap-2">
+            <label
+              className="block text-xs font-medium text-zinc-600 dark:text-zinc-400"
+              htmlFor={`${pid}-pin-global-tag`}
             >
-              <Plus size={20} strokeWidth={2} aria-hidden />
-            </button>
+              {s.tagsPinFieldLabel}
+            </label>
+            <input
+              id={`${pid}-pin-global-tag`}
+              type="text"
+              className="w-full rounded-lg border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 outline-none ring-violet-500/30 focus:ring-2 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100"
+              value={pinGlobalDraft}
+              onChange={(e) => setPinGlobalDraft(e.target.value)}
+              placeholder={s.tagsPinPlaceholder}
+              disabled={disabled}
+              autoComplete="off"
+              spellCheck={false}
+              onKeyDown={(e) => {
+                if (e.key === "Enter") {
+                  e.preventDefault();
+                  void addPinGlobal();
+                }
+              }}
+            />
+            <div className="flex">
+              <button
+                type="button"
+                className={ICON_BTN_PRIMARY}
+                disabled={
+                  disabled ||
+                  !pinGlobalDraft.trim() ||
+                  !!parseProjectScopedTag(
+                    pinGlobalDraft.replace(/^#/, "").trim(),
+                  )
+                }
+                title={s.tagsPinAddBtn}
+                aria-label={s.tagsPinAddBtn}
+                onClick={() => void addPinGlobal()}
+              >
+                <Plus size={20} strokeWidth={2} aria-hidden />
+              </button>
+            </div>
           </div>
-        </div>
 
-        {globalKnownTags.length === 0 ? (
-          <p className="mt-4 text-sm text-zinc-500">{s.tagsEmptyGlobal}</p>
-        ) : (
-          <ul className="mt-4" aria-label={s.tagsGlobalHeading}>
-            {globalKnownTags.map((tag, tagIdx) => (
-              <SettingsTagEditorRow
-                key={`g-${normalizeTagKey(tag).toLowerCase()}`}
-                tag={tag}
-                fieldId={`${pid}-global-tag-desc-${tagIdx}`}
-                s={s}
-                disabled={disabled}
-                localTagDesc={localTagDesc}
-                setLocalTagDesc={setLocalTagDesc}
-                pinnedKeys={pinnedKeys}
-                post={post}
-                setConfirm={setConfirm}
-                onStartTrackedTask={() => void requestStartFromTag(tag)}
-              />
-            ))}
-          </ul>
-        )}
-      </div>
+          {globalKnownTags.length === 0 ? (
+            <p className="mt-4 text-sm text-zinc-500">{s.tagsEmptyGlobal}</p>
+          ) : (
+            <ul className="mt-4" aria-label={s.tagsGlobalHeading}>
+              {globalKnownTags.map((tag, tagIdx) => (
+                <SettingsTagEditorRow
+                  key={`g-${normalizeTagKey(tag).toLowerCase()}`}
+                  tag={tag}
+                  fieldId={`${pid}-global-tag-desc-${tagIdx}`}
+                  s={s}
+                  disabled={disabled}
+                  localTagDesc={localTagDesc}
+                  setLocalTagDesc={setLocalTagDesc}
+                  pinnedKeys={pinnedKeys}
+                  post={post}
+                  setConfirm={setConfirm}
+                  dismissRenameImpactConfirm={dismissRenameImpactConfirm}
+                  onStartTrackedTask={() => void requestStartFromTag(tag)}
+                />
+              ))}
+            </ul>
+          )}
+        </div>
 
-      <div id={`${pid}-tags-hidden`} className={CARD_CLASS}>
-        <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">{s.tagsHiddenHeading}</h3>
-        {excludedRaw.length === 0 ? (
-          <p className="mt-3 text-sm text-zinc-500">{s.hiddenTagsEmpty}</p>
-        ) : (
-          <ul className="mt-3">
-            {excludedRaw.map((key) => (
-              <li key={key} className="border-b border-zinc-200 py-3 last:border-b-0 dark:border-zinc-800/90">
-                <div className="flex flex-col gap-2">
-                  <span className="font-mono text-sm text-zinc-600 line-through decoration-zinc-500 dark:text-zinc-400">
-                    {formatTagDisplay(key)}
-                  </span>
-                  <div className="flex flex-wrap items-center gap-1.5">
-                    <button
-                      type="button"
-                      className={ICON_BTN}
-                      disabled={disabled}
-                      title={s.tagRestoreBtn}
-                      aria-label={s.tagRestoreBtn}
-                      onClick={() => void post({ type: "includeTagFromSuggestions", tag: key })}
-                    >
-                      <RotateCcw size={16} strokeWidth={2} aria-hidden />
-                    </button>
-                    <button
-                      type="button"
-                      className={ICON_BTN_DANGER}
-                      disabled={disabled}
-                      title={s.tagPurgeHiddenAriaLabel}
-                      aria-label={s.tagPurgeHiddenAriaLabel}
-                      onClick={() => setConfirm({ kind: "purgeTag", tag: key, fromExcludedList: true })}
-                    >
-                      <Trash2 size={16} strokeWidth={2} aria-hidden />
-                    </button>
+        <div id={`${pid}-tags-hidden`} className={CARD_CLASS}>
+          <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">
+            {s.tagsHiddenHeading}
+          </h3>
+          {excludedRaw.length === 0 ? (
+            <p className="mt-3 text-sm text-zinc-500">{s.hiddenTagsEmpty}</p>
+          ) : (
+            <ul className="mt-3">
+              {excludedRaw.map((key) => (
+                <li
+                  key={key}
+                  className="border-b border-zinc-200 py-3 last:border-b-0 dark:border-zinc-800/90"
+                >
+                  <div className="flex flex-col gap-2">
+                    <span className="font-mono text-sm text-zinc-600 line-through decoration-zinc-500 dark:text-zinc-400">
+                      {formatTagDisplay(key)}
+                    </span>
+                    <div className="flex flex-wrap items-center gap-1.5">
+                      <button
+                        type="button"
+                        className={ICON_BTN}
+                        disabled={disabled}
+                        title={s.tagRestoreBtn}
+                        aria-label={s.tagRestoreBtn}
+                        onClick={() =>
+                          void post({
+                            type: "includeTagFromSuggestions",
+                            tag: key,
+                          })
+                        }
+                      >
+                        <RotateCcw size={16} strokeWidth={2} aria-hidden />
+                      </button>
+                      <button
+                        type="button"
+                        className={ICON_BTN_DANGER}
+                        disabled={disabled}
+                        title={s.tagPurgeHiddenAriaLabel}
+                        aria-label={s.tagPurgeHiddenAriaLabel}
+                        onClick={() =>
+                          setConfirm({
+                            kind: "purgeTag",
+                            tag: key,
+                            fromExcludedList: true,
+                          })
+                        }
+                      >
+                        <Trash2 size={16} strokeWidth={2} aria-hidden />
+                      </button>
+                    </div>
                   </div>
-                </div>
-              </li>
-            ))}
-          </ul>
-        )}
-      </div>
+                </li>
+              ))}
+            </ul>
+          )}
+        </div>
       </div>
 
       <div
         role={variant === "dashboard" ? "tabpanel" : undefined}
         id={variant === "dashboard" ? `${pid}-tabpanel-projects` : undefined}
-        aria-labelledby={variant === "dashboard" ? `${pid}-tab-projects` : undefined}
+        aria-labelledby={
+          variant === "dashboard" ? `${pid}-tab-projects` : undefined
+        }
         hidden={variant === "dashboard" && dashTagsTab !== "projects"}
         className={variant === "dashboard" ? "space-y-5" : "contents"}
       >
-      <div id={`${pid}-tags-saved-projects`} className={CARD_CLASS}>
-        <div className="flex flex-wrap items-center gap-2">
-          <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">{s.projectsHeading}</h3>
-          <InlineMetricHelpTrigger
-            ariaLabel={s.projectsHelpAria}
-            body={`${s.projectsIntro}\n\n${s.projectsHelpBody}`}
-            preserveLineBreaks
-            panelClassName="w-[min(calc(100vw-2rem),22rem)]"
-          />
-        </div>
-        {knownProjects.length === 0 && orphanScopedSections.length === 0 ? (
-          <p className="mt-4 text-sm text-zinc-500">{s.projectsEmpty}</p>
-        ) : null}
-        {knownProjects.length > 0 ? (
-          <ul className="mt-4">
-            {knownProjects.map((proj, projIdx) => {
-              const pk = normalizeProjectKey(proj).toLowerCase();
-              const projectDescFieldId = `${pid}-project-desc-${projIdx}`;
-              const sec =
-                scopedSections.find((x) => x.projectLower === pk) ?? {
+        <div id={`${pid}-tags-saved-projects`} className={CARD_CLASS}>
+          <div className="flex flex-wrap items-center gap-2">
+            <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">
+              {s.projectsHeading}
+            </h3>
+            <InlineMetricHelpTrigger
+              ariaLabel={s.projectsHelpAria}
+              body={`${s.projectsIntro}\n\n${s.projectsHelpBody}`}
+              preserveLineBreaks
+              panelClassName="w-[min(calc(100vw-2rem),22rem)]"
+            />
+          </div>
+          <div className="mt-3 flex max-w-md flex-col gap-2">
+            <label
+              className="block text-xs font-medium text-zinc-600 dark:text-zinc-400"
+              htmlFor={`${pid}-add-project`}
+            >
+              {s.projectsAddFieldLabel}
+            </label>
+            <input
+              id={`${pid}-add-project`}
+              type="text"
+              className="w-full rounded-lg border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 outline-none ring-violet-500/30 focus:ring-2 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100"
+              value={projectDraft}
+              onChange={(e) => setProjectDraft(e.target.value)}
+              placeholder={s.projectsAddPlaceholder}
+              disabled={disabled}
+              autoComplete="off"
+              spellCheck={false}
+              onKeyDown={(e) => {
+                if (e.key === "Enter") {
+                  e.preventDefault();
+                  void addProject();
+                }
+              }}
+            />
+            <div className="flex">
+              <button
+                type="button"
+                className={ICON_BTN_PRIMARY}
+                disabled={
+                  disabled ||
+                  !normalizeProjectKey(projectDraft) ||
+                  knownProjects.some(
+                    (p) =>
+                      normalizeProjectKey(p).toLowerCase() ===
+                      normalizeProjectKey(projectDraft).toLowerCase(),
+                  )
+                }
+                title={s.projectsAddBtn}
+                aria-label={s.projectsAddBtn}
+                onClick={() => void addProject()}
+              >
+                <Plus size={20} strokeWidth={2} aria-hidden />
+              </button>
+            </div>
+          </div>
+          {knownProjects.length === 0 && orphanScopedSections.length === 0 ? (
+            <p className="mt-4 text-sm text-zinc-500">{s.projectsEmpty}</p>
+          ) : null}
+          {knownProjects.length > 0 ? (
+            <ul className="mt-4">
+              {knownProjects.map((proj, projIdx) => {
+                const pk = normalizeProjectKey(proj).toLowerCase();
+                const projectDescFieldId = `${pid}-project-desc-${projIdx}`;
+                const sec = scopedSections.find(
+                  (x) => x.projectLower === pk,
+                ) ?? {
                   projectLower: pk,
                   displayProject: proj,
                   tags: [] as string[],
                 };
-              const linkedAnchorId = projIdx === 0 ? tagsByProjectScrollId : undefined;
-              return (
-                <li key={proj} className="border-b border-zinc-200 py-3 last:border-b-0 dark:border-zinc-800/90">
-                  <div className="flex flex-col gap-2.5">
-                    <span className="text-sm font-medium text-zinc-900 dark:text-zinc-100">
-                      {formatProjectDisplay(proj)}
-                    </span>
-                    <input
-                      id={projectDescFieldId}
-                      type="text"
-                      className={INLINE_INPUT_CLASS}
-                      value={localProjectDesc[pk] ?? ""}
-                      onChange={(e) =>
-                        setLocalProjectDesc((prev) => ({ ...prev, [pk]: e.target.value }))
-                      }
-                      disabled={disabled}
-                      placeholder={s.projectDescriptionLabel}
-                      spellCheck
-                    />
-                    <div className="flex flex-wrap items-center gap-1.5">
+                const linkedAnchorId =
+                  projIdx === 0 ? tagsByProjectScrollId : undefined;
+                return (
+                  <li
+                    key={proj}
+                    className="border-b border-zinc-200 py-3 last:border-b-0 dark:border-zinc-800/90"
+                  >
+                    <div className="flex flex-col gap-2.5">
+                      {projectRenameOpenByKey[pk] ? (
+                        <input
+                          type="text"
+                          className="w-full max-w-sm rounded border border-zinc-300 bg-white px-2 py-1 text-sm text-zinc-900 outline-none ring-violet-500/30 focus:ring-2 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100"
+                          value={
+                            projectRenameDraftByKey[pk] ??
+                            normalizeProjectKey(proj)
+                          }
+                          onChange={(e) =>
+                            setProjectRenameDraftByKey((prev) => ({
+                              ...prev,
+                              [pk]: e.target.value,
+                            }))
+                          }
+                          onKeyDown={(e) => {
+                            if (e.key === "Escape") {
+                              e.preventDefault();
+                              setProjectRenameDraftByKey((prev) => ({
+                                ...prev,
+                                [pk]: normalizeProjectKey(proj),
+                              }));
+                              setProjectRenameOpenByKey((prev) => ({
+                                ...prev,
+                                [pk]: false,
+                              }));
+                              return;
+                            }
+                            if (e.key !== "Enter") {
+                              return;
+                            }
+                            e.preventDefault();
+                            const target = normalizeProjectKey(
+                              projectRenameDraftByKey[pk] ?? "",
+                            );
+                            if (
+                              !target ||
+                              target.toLowerCase() ===
+                                normalizeProjectKey(proj).toLowerCase()
+                            ) {
+                              return;
+                            }
+                            if (dismissRenameImpactConfirm) {
+                              setProjectRenameOpenByKey((prev) => ({
+                                ...prev,
+                                [pk]: false,
+                              }));
+                              void post({
+                                type: "renameProjectMetadata",
+                                sourceName: proj,
+                                targetName: target,
+                              });
+                              return;
+                            }
+                            setProjectRenameOpenByKey((prev) => ({
+                              ...prev,
+                              [pk]: false,
+                            }));
+                            setConfirm({
+                              kind: "renameProject",
+                              sourceName: proj,
+                              targetName: target,
+                            });
+                          }}
+                          disabled={disabled}
+                          spellCheck={false}
+                          autoComplete="off"
+                        />
+                      ) : (
+                        <span className="text-sm font-medium text-zinc-900 dark:text-zinc-100">
+                          {formatProjectDisplay(proj)}
+                        </span>
+                      )}
+                      <input
+                        id={projectDescFieldId}
+                        type="text"
+                        className={INLINE_INPUT_CLASS}
+                        value={localProjectDesc[pk] ?? ""}
+                        onChange={(e) =>
+                          setLocalProjectDesc((prev) => ({
+                            ...prev,
+                            [pk]: e.target.value,
+                          }))
+                        }
+                        disabled={disabled}
+                        placeholder={s.projectDescriptionLabel}
+                        spellCheck
+                      />
+                      <div className="flex flex-wrap items-center gap-1.5">
+                        {!projectRenameOpenByKey[pk] ? (
+                          <button
+                            type="button"
+                            className={ICON_BTN_SAVE}
+                            disabled={disabled}
+                            title={s.descriptionSaveBtn}
+                            aria-label={s.descriptionSaveBtn}
+                            onClick={() =>
+                              void post({
+                                type: "setProjectDescription",
+                                name: proj,
+                                description: localProjectDesc[pk] ?? "",
+                              })
+                            }
+                          >
+                            <Save size={16} strokeWidth={2} aria-hidden />
+                          </button>
+                        ) : null}
                         <button
                           type="button"
-                          className={ICON_BTN_SAVE}
+                          className={ICON_BTN_DANGER}
                           disabled={disabled}
-                          title={s.descriptionSaveBtn}
-                          aria-label={s.descriptionSaveBtn}
+                          title={s.projectsRemoveBtn}
+                          aria-label={s.projectsRemoveBtn}
                           onClick={() =>
-                            void post({
-                              type: "setProjectDescription",
-                              name: proj,
-                              description: localProjectDesc[pk] ?? "",
-                            })
+                            setConfirm({ kind: "purgeProject", name: proj })
                           }
                         >
-                          <Save size={16} strokeWidth={2} aria-hidden />
+                          <Trash2 size={16} strokeWidth={2} aria-hidden />
                         </button>
                         <button
                           type="button"
-                          className={ICON_BTN_DANGER}
+                          className={ICON_BTN}
                           disabled={disabled}
-                          title={s.projectsRemoveBtn}
-                          aria-label={s.projectsRemoveBtn}
-                          onClick={() => setConfirm({ kind: "purgeProject", name: proj })}
+                          title={s.projectsRenameBtn}
+                          aria-label={s.projectsRenameBtn}
+                          onClick={() => {
+                            setProjectRenameDraftByKey((prev) => ({
+                              ...prev,
+                              [pk]: normalizeProjectKey(proj),
+                            }));
+                            setProjectRenameOpenByKey((prev) => ({
+                              ...prev,
+                              [pk]: true,
+                            }));
+                          }}
                         >
-                          <Trash2 size={16} strokeWidth={2} aria-hidden />
+                          <Pencil size={16} strokeWidth={2} aria-hidden />
                         </button>
+                        {projectRenameOpenByKey[pk] ? (
+                          <>
+                            <button
+                              type="button"
+                              className={ICON_BTN_SAVE}
+                              disabled={
+                                disabled ||
+                                !normalizeProjectKey(
+                                  projectRenameDraftByKey[pk] ?? "",
+                                ) ||
+                                normalizeProjectKey(
+                                  projectRenameDraftByKey[pk] ?? "",
+                                ).toLowerCase() ===
+                                  normalizeProjectKey(proj).toLowerCase()
+                              }
+                              title={s.descriptionSaveBtn}
+                              aria-label={s.descriptionSaveBtn}
+                              onClick={() => {
+                                const target = normalizeProjectKey(
+                                  projectRenameDraftByKey[pk] ?? "",
+                                );
+                                if (!target) {
+                                  return;
+                                }
+                                setProjectRenameOpenByKey((prev) => ({
+                                  ...prev,
+                                  [pk]: false,
+                                }));
+                                if (dismissRenameImpactConfirm) {
+                                  void post({
+                                    type: "renameProjectMetadata",
+                                    sourceName: proj,
+                                    targetName: target,
+                                  });
+                                  return;
+                                }
+                                setConfirm({
+                                  kind: "renameProject",
+                                  sourceName: proj,
+                                  targetName: target,
+                                });
+                              }}
+                            >
+                              <Save size={16} strokeWidth={2} aria-hidden />
+                            </button>
+                            <button
+                              type="button"
+                              className={ICON_BTN}
+                              disabled={disabled}
+                              title={s.dialogCancelBtn}
+                              aria-label={s.dialogCancelBtn}
+                              onClick={() => {
+                                setProjectRenameDraftByKey((prev) => ({
+                                  ...prev,
+                                  [pk]: normalizeProjectKey(proj),
+                                }));
+                                setProjectRenameOpenByKey((prev) => ({
+                                  ...prev,
+                                  [pk]: false,
+                                }));
+                              }}
+                            >
+                              <RotateCcw
+                                size={16}
+                                strokeWidth={2}
+                                aria-hidden
+                              />
+                            </button>
+                          </>
+                        ) : null}
                         <button
                           type="button"
                           className={ICON_BTN_PRIMARY}
@@ -854,50 +1548,89 @@ export function SettingsTagsProjectsSection({
                           aria-label={s.tagStartTrackedTaskFromProjectBtn}
                           onClick={() => void requestStartFromProject(proj)}
                         >
-                          <Play size={16} strokeWidth={2} className="ml-0.5" fill="currentColor" aria-hidden />
+                          <Play
+                            size={16}
+                            strokeWidth={2}
+                            className="ml-0.5"
+                            fill="currentColor"
+                            aria-hidden
+                          />
                         </button>
+                      </div>
+                      {linkedTagsBlock(
+                        requestStartFromTag,
+                        sec,
+                        linkedAnchorId,
+                        proj,
+                      )}
                     </div>
-                    {linkedTagsBlock(requestStartFromTag, sec, linkedAnchorId, proj)}
+                  </li>
+                );
+              })}
+            </ul>
+          ) : null}
+          {orphanScopedSections.length > 0 ? (
+            <div
+              className={`${
+                knownProjects.length > 0
+                  ? "mt-6 border-t border-zinc-200 pt-6 dark:border-zinc-800"
+                  : "mt-4"
+              }`}
+            >
+              <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
+                <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">
+                  {s.tagsByProjectHeading}
+                </h3>
+                <InlineMetricHelpTrigger
+                  ariaLabel={s.tagsByProjectOrphanHelpAria}
+                  body={s.tagsByProjectOrphanIntro}
+                  panelClassName="w-[min(calc(100vw-2rem),26rem)]"
+                />
+              </div>
+              <div className="mt-4 space-y-6">
+                {orphanScopedSections.map((sec, orIdx) => (
+                  <div
+                    key={sec.projectLower}
+                    className="rounded-lg border border-dashed border-zinc-300/90 bg-white/50 p-3 dark:border-zinc-600/80 dark:bg-zinc-950/35"
+                  >
+                    <h4 className="text-xs font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+                      {formatProjectDisplay(sec.displayProject)}
+                    </h4>
+                    {linkedTagsBlock(
+                      requestStartFromTag,
+                      sec,
+                      knownProjects.length === 0 && orIdx === 0
+                        ? tagsByProjectScrollId
+                        : undefined,
+                      sec.displayProject,
+                      { omitSectionTitle: true },
+                    )}
                   </div>
-                </li>
-              );
-            })}
-          </ul>
-        ) : null}
-        {orphanScopedSections.length > 0 ? (
-          <div
-            className={`${knownProjects.length > 0 ? "mt-6 border-t border-zinc-200 pt-6 dark:border-zinc-800" : "mt-4"}`}
-          >
-            <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
-              <h3 className="text-sm font-medium text-zinc-800 dark:text-zinc-100">{s.tagsByProjectHeading}</h3>
-              <InlineMetricHelpTrigger
-                ariaLabel={s.tagsByProjectOrphanHelpAria}
-                body={s.tagsByProjectOrphanIntro}
-                panelClassName="w-[min(calc(100vw-2rem),26rem)]"
-              />
-            </div>
-            <div className="mt-4 space-y-6">
-              {orphanScopedSections.map((sec, orIdx) => (
-                <div
-                  key={sec.projectLower}
-                  className="rounded-lg border border-dashed border-zinc-300/90 bg-white/50 p-3 dark:border-zinc-600/80 dark:bg-zinc-950/35"
-                >
-                  <h4 className="text-xs font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
-                    {formatProjectDisplay(sec.displayProject)}
-                  </h4>
-                  {linkedTagsBlock(
-                    requestStartFromTag,
-                    sec,
-                    knownProjects.length === 0 && orIdx === 0 ? tagsByProjectScrollId : undefined,
-                    sec.displayProject,
-                    { omitSectionTitle: true }
-                  )}
-                </div>
-              ))}
+                ))}
+              </div>
             </div>
-          </div>
-        ) : null}
+          ) : null}
+        </div>
       </div>
+
+      <div
+        role={variant === "dashboard" ? "tabpanel" : undefined}
+        id={variant === "dashboard" ? `${pid}-tabpanel-templates` : undefined}
+        aria-labelledby={
+          variant === "dashboard" ? `${pid}-tab-templates` : undefined
+        }
+        hidden={variant === "dashboard" && dashTagsTab !== "templates"}
+        className={variant === "dashboard" ? "space-y-5" : "contents"}
+      >
+        {payload ? (
+          <SettingsTaskTemplatesSection
+            s={s}
+            lang={lang}
+            payload={payload}
+            saving={saving || busy}
+            refresh={refresh}
+          />
+        ) : null}
       </div>
 
       <DashboardConfirmModal
@@ -932,7 +1665,9 @@ export function SettingsTagsProjectsSection({
       <DashboardConfirmModal
         open={confirm?.kind === "purgeTag"}
         message={
-          confirm?.kind === "purgeTag" && confirm.fromExcludedList ? s.tagPurgeHiddenConfirm : s.tagPurgeConfirm
+          confirm?.kind === "purgeTag" && confirm.fromExcludedList
+            ? s.tagPurgeHiddenConfirm
+            : s.tagPurgeConfirm
         }
         cancelLabel={s.dialogCancelBtn}
         confirmLabel={s.dialogConfirmBtn}
@@ -954,6 +1689,74 @@ export function SettingsTagsProjectsSection({
           }
         }}
       />
+      <DashboardConfirmModal
+        open={confirm?.kind === "renameTag"}
+        message={s.tagRenameImpactConfirm}
+        cancelLabel={s.dialogCancelBtn}
+        confirmLabel={s.dialogConfirmBtn}
+        confirmVariant="danger"
+        dismissCheckbox={{
+          label: s.renameImpactDontShowAgain,
+          checked: dismissRenameImpactConfirm,
+          onChange: setDismissRenameImpactConfirm,
+        }}
+        onCancel={() => setConfirm(null)}
+        onConfirm={() => {
+          if (confirm?.kind !== "renameTag") {
+            setConfirm(null);
+            return;
+          }
+          const { sourceTag, targetTag } = confirm;
+          if (dismissRenameImpactConfirm) {
+            try {
+              globalThis.localStorage?.setItem(
+                RENAME_IMPACT_CONFIRM_STORAGE_KEY,
+                "1",
+              );
+            } catch {}
+          }
+          setConfirm(null);
+          void post({
+            type: "renameTagMetadata",
+            sourceTag,
+            targetTag,
+          });
+        }}
+      />
+      <DashboardConfirmModal
+        open={confirm?.kind === "renameProject"}
+        message={s.projectRenameImpactConfirm}
+        cancelLabel={s.dialogCancelBtn}
+        confirmLabel={s.dialogConfirmBtn}
+        confirmVariant="danger"
+        dismissCheckbox={{
+          label: s.renameImpactDontShowAgain,
+          checked: dismissRenameImpactConfirm,
+          onChange: setDismissRenameImpactConfirm,
+        }}
+        onCancel={() => setConfirm(null)}
+        onConfirm={() => {
+          if (confirm?.kind !== "renameProject") {
+            setConfirm(null);
+            return;
+          }
+          const { sourceName, targetName } = confirm;
+          if (dismissRenameImpactConfirm) {
+            try {
+              globalThis.localStorage?.setItem(
+                RENAME_IMPACT_CONFIRM_STORAGE_KEY,
+                "1",
+              );
+            } catch {}
+          }
+          setConfirm(null);
+          void post({
+            type: "renameProjectMetadata",
+            sourceName,
+            targetName,
+          });
+        }}
+      />
       <DashboardConfirmModal
         open={confirm?.kind === "purgeProject"}
         message={s.projectRemoveConfirm}
@@ -984,9 +1787,15 @@ export function SettingsTagsProjectsSection({
           onChange: setRememberConcurrentChoice,
         }}
         onDismiss={cancelTrackingConflict}
-        onTertiary={() => void resolveConflictAndStart("parallel", rememberConcurrentChoice)}
-        onSecondary={() => void resolveConflictAndStart("pause", rememberConcurrentChoice)}
-        onPrimary={() => void resolveConflictAndStart("finish", rememberConcurrentChoice)}
+        onTertiary={() =>
+          void resolveConflictAndStart("parallel", rememberConcurrentChoice)
+        }
+        onSecondary={() =>
+          void resolveConflictAndStart("pause", rememberConcurrentChoice)
+        }
+        onPrimary={() =>
+          void resolveConflictAndStart("finish", rememberConcurrentChoice)
+        }
       />
     </section>
   );