+
+
+ {{this.noteHtml}}
+
+ {{#if this.loading}}
+
+
+}
diff --git a/assets/javascripts/discourse/components/mod-private-note.gjs b/assets/javascripts/discourse/components/mod-private-note.gjs
new file mode 100644
index 0000000..7e0ab25
--- /dev/null
+++ b/assets/javascripts/discourse/components/mod-private-note.gjs
@@ -0,0 +1,504 @@
+import Component from "@glimmer/component";
+import { tracked } from "@glimmer/tracking";
+import { fn } from "@ember/helper";
+import { on } from "@ember/modifier";
+import { action } from "@ember/object";
+import didInsert from "@ember/render-modifiers/modifiers/did-insert";
+import didUpdate from "@ember/render-modifiers/modifiers/did-update";
+import { service } from "@ember/service";
+import DButton from "discourse/components/d-button";
+import icon from "discourse/helpers/d-icon";
+import { ajax } from "discourse/lib/ajax";
+import { popupAjaxError } from "discourse/lib/ajax-error";
+import { cook } from "discourse/lib/text";
+import { i18n } from "discourse-i18n";
+import ModTopicMessagesModal from "./mod-topic-messages-modal";
+
+// Short relative-time label ("just now", "5m", "3h", "2d") for a note.
+function timeAgo(iso) {
+ if (!iso) {
+ return "";
+ }
+ const then = new Date(iso).getTime();
+ if (isNaN(then)) {
+ return "";
+ }
+ const seconds = Math.max(0, (Date.now() - then) / 1000);
+ if (seconds < 60) {
+ return i18n("discourse_mod_categories.private_note.just_now");
+ }
+ const minutes = Math.floor(seconds / 60);
+ if (minutes < 60) {
+ return `${minutes}m`;
+ }
+ const hours = Math.floor(minutes / 60);
+ if (hours < 24) {
+ return `${hours}h`;
+ }
+ return `${Math.floor(hours / 24)}d`;
+}
+
+function authorName(author) {
+ return author ? author.name || author.username : null;
+}
+
+function avatarUrl(author) {
+ const template = author?.avatar_template;
+ return template ? template.replace("{size}", "45") : null;
+}
+
+// A staff-only note on a topic — and its thread of staff replies. Shown
+// like posts (avatar, name, relative time). The note is serialized only
+// to staff; this component also renders nothing unless the current user
+// is staff. `@place` is "top" or "bottom".
+//
+// Staff can edit and delete individual entries — each reply, and the
+// note body itself. The hosting plugin-outlet connector is reused across
+// topic navigation, so all per-topic tracked state is re-read whenever
+// `@topic.id` changes (via a `{{did-update}}` modifier).
+export default class ModPrivateNote extends Component {
+ @service appEvents;
+ @service currentUser;
+ @service dialog;
+ @service modal;
+
+ @tracked note = this.args.topic?.mod_topic_private_note || "";
+ @tracked position =
+ this.args.topic?.mod_topic_private_note_position || "bottom";
+ @tracked author = this.args.topic?.mod_topic_private_note_author || null;
+ @tracked createdAt =
+ this.args.topic?.mod_topic_private_note_created_at || null;
+ @tracked replies = this.args.topic?.mod_topic_private_note_replies || [];
+ @tracked replying = false;
+ @tracked replyText = "";
+ @tracked saving = false;
+ @tracked cookedNote = null;
+ @tracked cookedReplies = [];
+ // The id of the reply currently being edited inline, or null.
+ @tracked editingReplyId = null;
+ @tracked editText = "";
+
+ constructor() {
+ super(...arguments);
+ this.appEvents.on("discourse-mod:messages-updated", this, this.refresh);
+ this.cookContent();
+ }
+
+ willDestroy() {
+ super.willDestroy(...arguments);
+ this.appEvents.off("discourse-mod:messages-updated", this, this.refresh);
+ }
+
+ // appEvent handler for live edits within the current topic. The guard
+ // keeps a stale event for another topic from clobbering this one.
+ refresh(topic) {
+ if (!topic || topic.id !== this.args.topic?.id) {
+ return;
+ }
+ this.readTopicState(topic);
+ }
+
+ // Re-read all per-topic state from the current topic. Called on initial
+ // insert and whenever the connector is reused for a different topic.
+ @action
+ refreshOnNavigation() {
+ this.readTopicState(this.args.topic);
+ }
+
+ readTopicState(topic) {
+ this.note = topic?.mod_topic_private_note || "";
+ this.position = topic?.mod_topic_private_note_position || "bottom";
+ this.author = topic?.mod_topic_private_note_author || null;
+ this.createdAt = topic?.mod_topic_private_note_created_at || null;
+ this.replies = topic?.mod_topic_private_note_replies || [];
+ this.replying = false;
+ this.replyText = "";
+ this.editingReplyId = null;
+ this.editText = "";
+ this.cookContent();
+ }
+
+ // Cooks the raw note markdown and each reply body asynchronously. The
+ // stored/edited values stay raw — only the display is cooked.
+ async cookContent() {
+ const note = this.note;
+ if (note && note.trim().length > 0) {
+ const cooked = await cook(note);
+ if (this.note === note) {
+ this.cookedNote = cooked;
+ }
+ } else {
+ this.cookedNote = null;
+ }
+
+ const replies = this.replies || [];
+ const cooked = await Promise.all(
+ replies.map((reply) => cook(reply.raw || ""))
+ );
+ if (this.replies === replies) {
+ this.cookedReplies = cooked;
+ }
+ }
+
+ get visible() {
+ if (!this.currentUser?.staff) {
+ return false;
+ }
+ if (!this.note || this.note.trim().length === 0) {
+ return false;
+ }
+ const place = this.args.place === "top" ? "top" : "bottom";
+ const chosen = this.position === "top" ? "top" : "bottom";
+ return place === chosen;
+ }
+
+ get noteHtml() {
+ return this.cookedNote;
+ }
+
+ get authorName() {
+ return authorName(this.author);
+ }
+
+ get avatarUrl() {
+ return avatarUrl(this.author);
+ }
+
+ get createdAgo() {
+ return timeAgo(this.createdAt);
+ }
+
+ get decoratedReplies() {
+ return (this.replies || []).map((reply, index) => ({
+ id: reply.id,
+ raw: reply.raw,
+ cooked: this.cookedReplies[index] || null,
+ agoLabel: timeAgo(reply.created_at),
+ authorName: authorName(reply.author),
+ avatarUrl: avatarUrl(reply.author),
+ editing: this.editingReplyId === reply.id,
+ }));
+ }
+
+ // Applies a note-thread response (note body + replies) to local state.
+ applyThread(result) {
+ if (result.private_note !== undefined) {
+ this.note = result.private_note || "";
+ this.args.topic.set("mod_topic_private_note", this.note);
+ }
+ if (result.private_note_author !== undefined) {
+ this.author = result.private_note_author || null;
+ this.args.topic.set(
+ "mod_topic_private_note_author",
+ result.private_note_author || null
+ );
+ }
+ if (result.private_note_created_at !== undefined) {
+ this.createdAt = result.private_note_created_at || null;
+ this.args.topic.set(
+ "mod_topic_private_note_created_at",
+ result.private_note_created_at || null
+ );
+ }
+ this.replies = result.replies || [];
+ this.args.topic.set("mod_topic_private_note_replies", this.replies);
+ this.cookContent();
+ this.appEvents.trigger("discourse-mod:messages-updated", this.args.topic);
+ }
+
+ @action
+ toggleReply() {
+ this.replying = !this.replying;
+ }
+
+ @action
+ updateReplyText(event) {
+ this.replyText = event.target.value;
+ }
+
+ @action
+ async submitReply() {
+ const raw = this.replyText.trim();
+ if (!raw) {
+ return;
+ }
+ this.saving = true;
+
+ try {
+ const result = await ajax(
+ `/discourse-mod-categories/topic/${this.args.topic.id}/note-reply`,
+ { type: "POST", data: { raw } }
+ );
+ this.replies = result.replies || [];
+ this.args.topic.set("mod_topic_private_note_replies", this.replies);
+ this.cookContent();
+ this.replyText = "";
+ this.replying = false;
+ this.appEvents.trigger(
+ "discourse-mod:messages-updated",
+ this.args.topic
+ );
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.saving = false;
+ }
+ }
+
+ // ----- per-reply edit / delete -----
+
+ @action
+ startEditReply(reply) {
+ this.editingReplyId = reply.id;
+ this.editText = reply.raw || "";
+ }
+
+ @action
+ cancelEditReply() {
+ this.editingReplyId = null;
+ this.editText = "";
+ }
+
+ @action
+ updateEditText(event) {
+ this.editText = event.target.value;
+ }
+
+ @action
+ async saveEditReply() {
+ const raw = this.editText.trim();
+ const replyId = this.editingReplyId;
+ if (!raw || !replyId) {
+ return;
+ }
+ this.saving = true;
+
+ try {
+ const result = await ajax(
+ `/discourse-mod-categories/topic/${this.args.topic.id}/note-reply`,
+ { type: "PUT", data: { reply_id: replyId, raw } }
+ );
+ this.applyThread(result);
+ this.editingReplyId = null;
+ this.editText = "";
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.saving = false;
+ }
+ }
+
+ @action
+ deleteReply(reply) {
+ this.dialog.confirm({
+ message: i18n(
+ "discourse_mod_categories.private_note.delete_reply_confirm"
+ ),
+ didConfirm: async () => {
+ this.saving = true;
+ try {
+ const result = await ajax(
+ `/discourse-mod-categories/topic/${this.args.topic.id}/note-reply`,
+ { type: "DELETE", data: { reply_id: reply.id } }
+ );
+ this.applyThread(result);
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.saving = false;
+ }
+ },
+ });
+ }
+
+ // ----- note-body edit / delete -----
+
+ @action
+ editNote() {
+ this.modal.show(ModTopicMessagesModal, {
+ model: { topic: this.args.topic },
+ });
+ }
+
+ @action
+ deleteNote() {
+ this.dialog.confirm({
+ message: i18n(
+ "discourse_mod_categories.private_note.delete_note_confirm"
+ ),
+ didConfirm: async () => {
+ this.saving = true;
+ try {
+ const result = await ajax(
+ `/discourse-mod-categories/topic/${this.args.topic.id}/note`,
+ { type: "DELETE" }
+ );
+ this.applyThread(result);
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.saving = false;
+ }
+ },
+ });
+ }
+
+
+
+ {{i18n "discourse_mod_categories.notes_tab.loading"}}
+
+ {{else if this.notes.length}}
+ -
+ {{#each this.notes as |note|}}
+
- + + {{icon "shield-halved"}} + + + {{note.topic_title}} + + {{note.note}} + + + + {{/each}} +
+ {{i18n "discourse_mod_categories.notes_tab.empty"}}
+
+ {{/if}}
+
+ {{#if this.visible}}
+
+
+}
diff --git a/assets/javascripts/discourse/components/mod-topic-messages-modal.gjs b/assets/javascripts/discourse/components/mod-topic-messages-modal.gjs
new file mode 100644
index 0000000..4d7df1b
--- /dev/null
+++ b/assets/javascripts/discourse/components/mod-topic-messages-modal.gjs
@@ -0,0 +1,197 @@
+import Component from "@glimmer/component";
+import { tracked } from "@glimmer/tracking";
+import { action } from "@ember/object";
+import { on } from "@ember/modifier";
+import { service } from "@ember/service";
+import DButton from "discourse/components/d-button";
+import DModal from "discourse/components/d-modal";
+import { ajax } from "discourse/lib/ajax";
+import { popupAjaxError } from "discourse/lib/ajax-error";
+import { i18n } from "discourse-i18n";
+
+// Moderator-facing modal (opened from the topic admin wrench menu) for
+// setting this topic's pinned footer message, require-approval flag, and
+// the private staff note. The per-topic before-reply prompt has moved
+// out of this modal and into the dedicated "Prompt Checklist" entry,
+// which supports both statement and checklist modes.
+export default class ModTopicMessagesModal extends Component {
+ @service appEvents;
+ @service toasts;
+
+ @tracked footerMessage = this.topic.mod_topic_footer_message || "";
+ @tracked requireApproval =
+ this.topic.mod_topic_require_reply_approval || false;
+ @tracked privateNote = this.topic.mod_topic_private_note || "";
+ @tracked notePosition =
+ this.topic.mod_topic_private_note_position || "bottom";
+ @tracked saving = false;
+
+ get topic() {
+ return this.args.model.topic;
+ }
+
+ @action
+ updateFooter(event) {
+ this.footerMessage = event.target.value;
+ }
+
+ @action
+ toggleApproval(event) {
+ this.requireApproval = event.target.checked;
+ }
+
+ @action
+ updateNote(event) {
+ this.privateNote = event.target.value;
+ }
+
+ @action
+ updateNotePosition(event) {
+ this.notePosition = event.target.value;
+ }
+
+ @action
+ async save() {
+ this.saving = true;
+
+ try {
+ const result = await ajax(
+ `/discourse-mod-categories/topic/${this.topic.id}`,
+ {
+ type: "PUT",
+ data: {
+ footer_message: this.footerMessage,
+ require_reply_approval: this.requireApproval,
+ private_note: this.privateNote,
+ private_note_position: this.notePosition,
+ },
+ }
+ );
+
+ this.topic.set("mod_topic_footer_message", result.footer_message);
+ this.topic.set(
+ "mod_topic_require_reply_approval",
+ result.require_reply_approval
+ );
+ this.topic.set("mod_topic_private_note", result.private_note);
+ this.topic.set(
+ "mod_topic_private_note_position",
+ result.private_note_position
+ );
+ this.topic.set(
+ "mod_topic_private_note_author",
+ result.private_note_author
+ );
+ this.appEvents.trigger("discourse-mod:messages-updated", this.topic);
+ this.toasts.success({
+ duration: 3000,
+ data: {
+ message: i18n("discourse_mod_categories.topic_messages.saved_toast"),
+ },
+ });
+ this.args.closeModal();
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.saving = false;
+ }
+ }
+
+
+
+
+}
diff --git a/assets/javascripts/discourse/components/mod-topic-prompt-checklist-modal.gjs b/assets/javascripts/discourse/components/mod-topic-prompt-checklist-modal.gjs
new file mode 100644
index 0000000..bae67fb
--- /dev/null
+++ b/assets/javascripts/discourse/components/mod-topic-prompt-checklist-modal.gjs
@@ -0,0 +1,447 @@
+import Component from "@glimmer/component";
+import { tracked } from "@glimmer/tracking";
+import { fn } from "@ember/helper";
+import { on } from "@ember/modifier";
+import { action } from "@ember/object";
+import { service } from "@ember/service";
+import DButton from "discourse/components/d-button";
+import DModal from "discourse/components/d-modal";
+import { ajax } from "discourse/lib/ajax";
+import { popupAjaxError } from "discourse/lib/ajax-error";
+import { i18n } from "discourse-i18n";
+import ComboBox from "select-kit/components/combo-box";
+import { trustLevelOptions } from "../lib/trust-level-options";
+
+// One editable row in the per-topic prompt checklist. Tracked so editing
+// the label/url in place re-renders without rebuilding the whole list.
+class ChecklistRow {
+ @tracked label;
+ @tracked url;
+
+ constructor(label = "", url = "") {
+ this.label = label;
+ this.url = url;
+ }
+}
+
+// Staff-facing modal opened from the topic admin (wrench) menu's
+// "Prompt Checklist" entry. Lets a moderator add/edit/save the per-topic
+// prompt. Mode picks between a single-message Statement and a multi-item
+// Checklist; frequency picks between "once per user per topic" and "on
+// every reply"; max_tl caps the audience by trust level. Saving bumps
+// the version, re-prompting any user who already accepted an older one.
+export default class ModTopicPromptChecklistModal extends Component {
+ @service toasts;
+
+ @tracked rows = [];
+ @tracked version = 0;
+ @tracked buttonLabel = "";
+ @tracked updatedAt = null;
+ @tracked mode = "checklist";
+ @tracked statement = "";
+ @tracked frequency = "once";
+ @tracked maxTl = "4";
+ @tracked fromLegacy = false;
+ @tracked loading = true;
+ @tracked saving = false;
+
+ modeOptions = [
+ {
+ id: "statement",
+ name: i18n("discourse_mod_categories.topic_prompt_checklist.mode_statement"),
+ },
+ {
+ id: "checklist",
+ name: i18n("discourse_mod_categories.topic_prompt_checklist.mode_checklist"),
+ },
+ ];
+
+ frequencyOptions = [
+ {
+ id: "once",
+ name: i18n("discourse_mod_categories.topic_prompt_checklist.frequency_once"),
+ },
+ {
+ id: "every_reply",
+ name: i18n(
+ "discourse_mod_categories.topic_prompt_checklist.frequency_every_reply"
+ ),
+ },
+ ];
+
+ maxTlOptions = trustLevelOptions(true);
+
+ constructor() {
+ super(...arguments);
+ this.load();
+ }
+
+ get topic() {
+ return this.args.model.topic;
+ }
+
+ get lastRowIndex() {
+ return this.rows.length - 1;
+ }
+
+ get isStatementMode() {
+ return this.mode === "statement";
+ }
+
+ get isChecklistMode() {
+ return this.mode === "checklist";
+ }
+
+ async load() {
+ try {
+ const result = await ajax(
+ `/discourse-mod-categories/topic/${this.topic.id}/prompt-checklist.json`
+ );
+ this.rows = (result.items || []).map(
+ (item) => new ChecklistRow(item.label, item.url)
+ );
+ this.version = result.version || 0;
+ this.buttonLabel = result.button_label || "";
+ this.updatedAt = result.updated_at;
+ this.mode = result.mode === "statement" ? "statement" : "checklist";
+ this.statement = result.statement || "";
+ this.frequency =
+ result.frequency === "every_reply" ? "every_reply" : "once";
+ this.maxTl = String(result.max_tl ?? 4);
+ this.fromLegacy = !!result.from_legacy;
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.loading = false;
+ }
+ }
+
+ @action
+ addRow() {
+ this.rows = [...this.rows, new ChecklistRow()];
+ }
+
+ @action
+ removeRow(row) {
+ this.rows = this.rows.filter((r) => r !== row);
+ }
+
+ @action
+ updateLabel(row, event) {
+ row.label = event.target.value;
+ }
+
+ @action
+ updateUrl(row, event) {
+ row.url = event.target.value;
+ }
+
+ @action
+ updateButtonLabel(event) {
+ this.buttonLabel = event.target.value;
+ }
+
+ @action
+ updateStatement(event) {
+ this.statement = event.target.value;
+ }
+
+ @action
+ updateMode(value) {
+ this.mode = value;
+ }
+
+ @action
+ updateFrequency(value) {
+ this.frequency = value;
+ }
+
+ @action
+ updateMaxTl(value) {
+ this.maxTl = value;
+ }
+
+ @action
+ async save() {
+ this.saving = true;
+ try {
+ const result = await ajax(
+ `/discourse-mod-categories/topic/${this.topic.id}/prompt-checklist.json`,
+ {
+ type: "PUT",
+ data: {
+ mode: this.mode,
+ statement: this.statement,
+ items: this.rows.map((r) => ({ label: r.label, url: r.url })),
+ frequency: this.frequency,
+ max_tl: this.maxTl,
+ button_label: this.buttonLabel,
+ },
+ }
+ );
+ this.version = result.version || 0;
+ this.rows = (result.items || []).map(
+ (item) => new ChecklistRow(item.label, item.url)
+ );
+ this.buttonLabel = result.button_label || "";
+ this.updatedAt = result.updated_at;
+ this.mode = result.mode === "statement" ? "statement" : "checklist";
+ this.statement = result.statement || "";
+ this.frequency =
+ result.frequency === "every_reply" ? "every_reply" : "once";
+ this.maxTl = String(result.max_tl ?? 4);
+ this.fromLegacy = false;
+ this.topic.set("mod_topic_prompt_checklist", {
+ version: this.version,
+ mode: this.mode,
+ statement: this.statement,
+ items: result.items || [],
+ frequency: this.frequency,
+ max_tl: parseInt(this.maxTl, 10) || 4,
+ button_label: this.buttonLabel,
+ updated_at: this.updatedAt,
+ });
+ // The new config supersedes the legacy reply-prompt fields, which
+ // the server has cleared. Reflect that on the in-memory topic too
+ // so the (now-removed) legacy gate stops reading stale data.
+ this.topic.set("mod_topic_reply_prompt", null);
+ this.topic.set("mod_topic_reply_prompt_max_tl", null);
+ this.toasts.success({
+ duration: 3000,
+ data: {
+ message: i18n(
+ "discourse_mod_categories.topic_prompt_checklist.saved_toast"
+ ),
+ },
+ });
+ this.args.closeModal();
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.saving = false;
+ }
+ }
+
+ @action
+ async clear() {
+ this.saving = true;
+ try {
+ await ajax(
+ `/discourse-mod-categories/topic/${this.topic.id}/prompt-checklist.json`,
+ { type: "DELETE" }
+ );
+ this.rows = [];
+ this.version = 0;
+ this.buttonLabel = "";
+ this.updatedAt = null;
+ this.mode = "checklist";
+ this.statement = "";
+ this.frequency = "once";
+ this.maxTl = "4";
+ this.fromLegacy = false;
+ this.topic.set("mod_topic_prompt_checklist", null);
+ this.toasts.success({
+ duration: 3000,
+ data: {
+ message: i18n(
+ "discourse_mod_categories.topic_prompt_checklist.cleared_toast"
+ ),
+ },
+ });
+ this.args.closeModal();
+ } catch (error) {
+ popupAjaxError(error);
+ } finally {
+ this.saving = false;
+ }
+ }
+
+
+
+
+ {{#if this.avatarUrl}}
+ 
+ {{/if}}
+
+
+ {{#each this.decoratedReplies as |reply|}}
+
+ {{#if reply.avatarUrl}}
+ 
+ {{/if}}
+
+ {{/each}}
+
+ {{#if this.replying}}
+
+ {{else}}
+
+ {{/if}}
+
+ {{/if}}
+
+ {{icon "lock"}}
+ {{i18n "discourse_mod_categories.private_note.heading"}}
+
+
+
+
+ {{#if reply.editing}}
+
+
+
+
+ {{else}}
+
+
+ {{reply.cooked}}
+ {{/if}}
+ + {{i18n "discourse_mod_categories.topic_prompt_checklist.intro"}} +
+ + {{#if this.loading}} ++ {{i18n + "discourse_mod_categories.topic_prompt_checklist.loading" + }} +
+ {{else}} + {{#if this.fromLegacy}} +
+ {{i18n
+ "discourse_mod_categories.topic_prompt_checklist.legacy_migration_notice"
+ }}
+
+ {{/if}}
+
+ {{#if this.version}}
+ + {{i18n + "discourse_mod_categories.topic_prompt_checklist.current_version" + count=this.version + }} +
+ {{/if}} + +
+
+
+
+ {{#if this.isStatementMode}}
+
+
+
+
+ {{else}}
+ {{#unless this.rows.length}}
+
+ {{i18n
+ "discourse_mod_categories.topic_prompt_checklist.inactive"
+ }}
+
+ {{/unless}}
+
+ {{#if this.rows.length}}
+
+ {{#each this.rows as |row|}}
+
+ {{/if}}
+ {{/if}}
+
+
+
+
+
+ {{/each}}
+
+
+
+
+
+
+
+
+
+
+
+
+ {{/if}}
+
+
+ <:footer>
+ {{#if this.isChecklistMode}}
+ + {{i18n + "discourse_mod_categories.whisper.add_participant.modal_instructions" + }} +
++ {{i18n "discourse_mod_categories.whisper.modal_instructions"}} +
+
+
+ {{i18n "discourse_mod_categories.category_settings.preview_label"}}
+
+
+ {{/if}}
+
+
+ {{this.previewHtml}}
+
+
+
+ {{#if this.staffOnly}}
+
+ {{i18n "discourse_mod_categories.whisper.armed_pill_staff_only"}}
+
+ {{else}}
+
+ {{i18n "discourse_mod_categories.whisper.armed_pill_prefix"}}
+
+
+ {{#each this.usernames as |name index|}}
+ {{#if index}},
+ {{/if}}@{{name}}
+ {{/each}}
+ {{#each this.groupNames as |name index|}}
+ {{#if (this.needsSep index)}}, {{/if}}{{name}}
+ {{/each}}
+
+ {{/if}}
+
+ {{/if}}
+
+}
diff --git a/assets/javascripts/discourse/connectors/topic-above-posts/mod-private-note.gjs b/assets/javascripts/discourse/connectors/topic-above-posts/mod-private-note.gjs
new file mode 100644
index 0000000..300c039
--- /dev/null
+++ b/assets/javascripts/discourse/connectors/topic-above-posts/mod-private-note.gjs
@@ -0,0 +1,7 @@
+import ModPrivateNote from "../../components/mod-private-note";
+
+// Staff-only moderator note, shown above the posts when the moderator
+// chose the "top" placement.
+
+
+ {{#if this.showPinnedCopy}}
+
+
+}
diff --git a/assets/javascripts/discourse/initializers/mod-checklist-sidebar.js b/assets/javascripts/discourse/initializers/mod-checklist-sidebar.js
new file mode 100644
index 0000000..cc193e3
--- /dev/null
+++ b/assets/javascripts/discourse/initializers/mod-checklist-sidebar.js
@@ -0,0 +1,46 @@
+import { withPluginApi } from "discourse/lib/plugin-api";
+import { i18n } from "discourse-i18n";
+import ModChecklistModal from "../components/mod-checklist-modal";
+
+// Adds a "First-post checklist" link to the sidebar Community section
+// (staff only). The link opens the checklist config in a modal — section
+// links can only navigate, so the link renders with an inert href and a
+// delegated click handler opens the modal instead.
+export default {
+ name: "discourse-mod-checklist-sidebar",
+
+ initialize(container) {
+ const currentUser = container.lookup("service:current-user");
+ if (!currentUser?.staff) {
+ return;
+ }
+
+ withPluginApi("1.0", (api) => {
+ api.addCommunitySectionLink(
+ {
+ name: "mod-checklist",
+ href: "#",
+ title: i18n(
+ "discourse_mod_categories.first_post_checklist.sidebar_title"
+ ),
+ text: i18n(
+ "discourse_mod_categories.first_post_checklist.sidebar_text"
+ ),
+ icon: "list-check",
+ }
+ );
+ });
+
+ const modal = container.lookup("service:modal");
+ document.addEventListener("click", (event) => {
+ const link = event.target.closest(
+ '[data-list-item-name="mod-checklist"]'
+ );
+ if (!link) {
+ return;
+ }
+ event.preventDefault();
+ modal.show(ModChecklistModal);
+ });
+ },
+};
diff --git a/assets/javascripts/discourse/initializers/mod-note-header-indicators.js b/assets/javascripts/discourse/initializers/mod-note-header-indicators.js
new file mode 100644
index 0000000..b89f2f2
--- /dev/null
+++ b/assets/javascripts/discourse/initializers/mod-note-header-indicators.js
@@ -0,0 +1,110 @@
+import { withPluginApi } from "discourse/lib/plugin-api";
+import {
+ applyUnreadPrefix,
+ stripUnreadPrefix,
+} from "../lib/mod-note-unread-title";
+
+// Header-level indicators of unread moderator notes.
+//
+// Two staff-only signals tied to `currentUser.mod_note_unread_count`:
+// 1. A header shield pip + count next to the avatar (rendered by the
+// `before-header-panel` plugin-outlet connector — its own tracked
+// local handles reactivity).
+// 2. A `(N)` prefix on the browser tab title.
+//
+// This initializer owns the title-prefix side-effect. It tracks the
+// authoritative `currentUser.mod_note_unread_count` (a property observer
+// catches the panel zero-ing it; a MessageBus subscription on
+// `/mod-note-unread-count/{user_id}` catches live server bumps + the
+// `reset` published from `notes_feed_seen`) and re-applies the prefix
+// whenever the document title changes (Discourse's `document-title`
+// service rewrites the title on every route transition).
+export default {
+ name: "discourse-mod-note-header-indicators",
+
+ initialize(container) {
+ const currentUser = container.lookup("service:current-user");
+ if (!currentUser?.staff) {
+ return;
+ }
+
+ const messageBus = container.lookup("service:message-bus");
+
+ let lastCount = currentUser.mod_note_unread_count || 0;
+
+ const titleEl = document.querySelector("head > title");
+
+ // Reapply the prefix to the current `document.title` based on `lastCount`.
+ // Guarded so the MutationObserver below doesn't recurse: if the title
+ // is already in its desired state we don't touch it.
+ let applying = false;
+ const reapply = () => {
+ if (applying) {
+ return;
+ }
+ const current = document.title;
+ const next = applyUnreadPrefix(stripUnreadPrefix(current), lastCount);
+ if (next !== current) {
+ applying = true;
+ try {
+ document.title = next;
+ } finally {
+ applying = false;
+ }
+ }
+ };
+
+ // Whenever something (Discourse's document-title service, a route
+ // transition, etc.) rewrites the
+
+ {{#if this.pinnedAvatarUrl}}
+ 
+ {{/if}}
+
+
+ {{/if}}
+ {{#if this.footerMessage}}
+
+ {{/if}}
+
+
+
+
+ {{this.pinnedPost.username}}
+
+
+ {{icon "thumbtack"}}
+ {{i18n "discourse_mod_categories.pin_post.pinned_label"}}
+
+ {{#if this.originalPostUrl}}
+
+ {{icon "arrow-up"}}
+
+ {{/if}}
+
+ {{this.pinnedPostHtml}}
+