nodebb-plugin-unread-category-priority 1.0.0

package/.a5c/cache/compression/ad0b8fb9531f46f8.json

@@ -0,0 +1,7 @@
+{
+  "filePath": "/Users/shlomo/.claude/plugins/cache/a5c-ai/babysitter/4.0.157/skills/babysit/SKILL.md",
+  "compressedContent": "description: Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc. allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS a5c/runs/<runId>/` through iterative execution. SDK_VERSION=$(node -e \"try{console. readFileSync('${CLAUDE_PLUGIN_ROOT}/versions. sdkVersion||'latest')}catch{console. sudo npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION **Alternatively, use the CLI alias:** `CLI=\"npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION\"` make sure you have jq installed and available in the path. babysitter instructions:babysit-skill --harness claude-code --interactive For non-interactive mode (running with `-p` flag or no AskUserQuestion tool): babysitter instructions:babysit-skill --harness claude-code --no-interactive Follow the instructions returned by the command above to orchestrate the run.",
+  "originalTokens": 405,
+  "compressedTokens": 263,
+  "compressedAt": "2026-06-04T14:24:19.264Z"
+}

package/.a5c/logs/babysitter-stop-hook.log

@@ -0,0 +1,28 @@
+[INFO] 2026-06-04T14:28:40.603Z handleHookRunStop started
+[INFO] 2026-06-04T14:28:40.606Z Hook input received
+[INFO] 2026-06-04T14:28:40.606Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Session ID: 3a7a1b56-d654-45b6-8bd4-bd9e1504d32c
+[INFO] 2026-06-04T14:28:40.606Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved pluginRoot: /Users/shlomo/.claude/plugins/cache/a5c-ai/babysitter/4.0.157
+[INFO] 2026-06-04T14:28:40.606Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved stateDir: /Users/shlomo/.a5c/state
+[INFO] 2026-06-04T14:28:40.606Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Checking session file at: /Users/shlomo/.a5c/state/3a7a1b56-d654-45b6-8bd4-bd9e1504d32c.md
+[INFO] 2026-06-04T14:28:40.608Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] No run associated with session — allowing exit
+[INFO] 2026-06-04T14:30:22.442Z handleHookRunStop started
+[INFO] 2026-06-04T14:30:22.445Z Hook input received
+[INFO] 2026-06-04T14:30:22.446Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Session ID: 3a7a1b56-d654-45b6-8bd4-bd9e1504d32c
+[INFO] 2026-06-04T14:30:22.446Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved pluginRoot: /Users/shlomo/.claude/plugins/cache/a5c-ai/babysitter/4.0.157
+[INFO] 2026-06-04T14:30:22.446Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved stateDir: /Users/shlomo/.a5c/state
+[INFO] 2026-06-04T14:30:22.446Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Checking session file at: /Users/shlomo/.a5c/state/3a7a1b56-d654-45b6-8bd4-bd9e1504d32c.md
+[INFO] 2026-06-04T14:30:22.446Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] No active loop found for session 3a7a1b56-d654-45b6-8bd4-bd9e1504d32c — allowing exit
+[INFO] 2026-06-04T14:31:25.162Z handleHookRunStop started
+[INFO] 2026-06-04T14:31:25.165Z Hook input received
+[INFO] 2026-06-04T14:31:25.165Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Session ID: 3a7a1b56-d654-45b6-8bd4-bd9e1504d32c
+[INFO] 2026-06-04T14:31:25.166Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved pluginRoot: /Users/shlomo/.claude/plugins/cache/a5c-ai/babysitter/4.0.157
+[INFO] 2026-06-04T14:31:25.166Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved stateDir: /Users/shlomo/.a5c/state
+[INFO] 2026-06-04T14:31:25.166Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Checking session file at: /Users/shlomo/.a5c/state/3a7a1b56-d654-45b6-8bd4-bd9e1504d32c.md
+[INFO] 2026-06-04T14:31:25.166Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] No active loop found for session 3a7a1b56-d654-45b6-8bd4-bd9e1504d32c — allowing exit
+[INFO] 2026-06-04T14:31:37.374Z handleHookRunStop started
+[INFO] 2026-06-04T14:31:37.377Z Hook input received
+[INFO] 2026-06-04T14:31:37.377Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Session ID: 3a7a1b56-d654-45b6-8bd4-bd9e1504d32c
+[INFO] 2026-06-04T14:31:37.377Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved pluginRoot: /Users/shlomo/.claude/plugins/cache/a5c-ai/babysitter/4.0.157
+[INFO] 2026-06-04T14:31:37.377Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Resolved stateDir: /Users/shlomo/.a5c/state
+[INFO] 2026-06-04T14:31:37.377Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] Checking session file at: /Users/shlomo/.a5c/state/3a7a1b56-d654-45b6-8bd4-bd9e1504d32c.md
+[INFO] 2026-06-04T14:31:37.377Z [session=3a7a1b56-d654-45b6-8bd4-bd9e1504d32c] No active loop found for session 3a7a1b56-d654-45b6-8bd4-bd9e1504d32c — allowing exit

package/README.md

@@ -0,0 +1,36 @@
+# nodebb-plugin-unread-category-priority
+
+Pins unread topics from one or more chosen categories to the **top** of the
+Unread list, while preserving the normal recency order within each group.
+
+No category is prioritized until you configure one in the ACP — the plugin is
+a no-op until then.
+
+## How it works
+
+NodeBB exposes the `filter:topics.getUnreadTids` hook, which fires after the
+unread `tids` have been gathered and sorted by recency. This plugin hooks in,
+looks up the `cid` of each unread topic via `topics.getTopicsFields`, and
+reorders the list so topics in the priority categories appear first. The same
+reordering is applied to every filter bucket (`''`, `new`, `watched`,
+`unreplied`) so the order stays consistent across the Unread tabs.
+
+No topics are added or removed — only reordered.
+
+## Configuration
+
+Go to **ACP → Plugins → Unread Category Priority** and enter a comma-separated
+list of category IDs (e.g. `5` or `5,3,8`). Leave it empty to disable. Settings
+are cached in memory and refreshed automatically when you save.
+
+## Install
+
+```
+npm install nodebb-plugin-unread-category-priority
+```
+
+Then activate it in **ACP → Extend → Plugins** and rebuild/restart.
+
+## License
+
+MIT

package/library.js

@@ -0,0 +1,106 @@
+'use strict';
+
+const topics = require.main.require('./src/topics');
+const meta = require.main.require('./src/meta');
+const routeHelpers = require.main.require('./src/routes/helpers');
+
+const plugin = {};
+
+const SETTINGS_HASH = 'unread-category-priority';
+
+// Empty until an admin configures at least one category; the plugin is a no-op while empty.
+let priorityCids = [];
+
+async function loadSettings() {
+	const settings = await meta.settings.get(SETTINGS_HASH);
+	const raw = (settings && settings.priorityCids) || '';
+	priorityCids = String(raw)
+		.split(',')
+		.map(cid => parseInt(cid.trim(), 10))
+		.filter(cid => !isNaN(cid) && cid > 0);
+}
+
+plugin.init = async function (params) {
+	const { router } = params;
+
+	routeHelpers.setupAdminPageRoute(router, '/admin/plugins/unread-category-priority', [], (req, res) => {
+		res.render('admin/plugins/unread-category-priority', {
+			title: 'Unread Category Priority',
+		});
+	});
+
+	await loadSettings();
+};
+
+plugin.addAdminNavigation = async function (header) {
+	header.plugins.push({
+		route: '/plugins/unread-category-priority',
+		icon: 'fa-arrow-up-wide-short',
+		name: 'Unread Category Priority',
+	});
+	return header;
+};
+
+// Move tids in a priority category to the front, keeping recency order within each group.
+function reorder(tids, cidByTid) {
+	if (!Array.isArray(tids) || !tids.length) {
+		return tids;
+	}
+
+	const prioritySet = new Set(priorityCids);
+	const priority = [];
+	const rest = [];
+
+	tids.forEach((tid) => {
+		if (prioritySet.has(cidByTid[tid])) {
+			priority.push(tid);
+		} else {
+			rest.push(tid);
+		}
+	});
+
+	return priority.concat(rest);
+}
+
+plugin.prioritize = async function (data) {
+	if (!priorityCids.length) {
+		return data;
+	}
+
+	// Collect every tid across data.tids and all tidsByFilter buckets, so one cid
+	// lookup feeds a consistent reorder of all of them.
+	const allTids = new Set(data.tids || []);
+	Object.values(data.tidsByFilter || {}).forEach((list) => {
+		(list || []).forEach(tid => allTids.add(tid));
+	});
+
+	if (!allTids.size) {
+		return data;
+	}
+
+	const tidList = Array.from(allTids);
+	const fields = await topics.getTopicsFields(tidList, ['cid']);
+
+	const cidByTid = {};
+	tidList.forEach((tid, i) => {
+		cidByTid[tid] = parseInt(fields[i] && fields[i].cid, 10);
+	});
+
+	data.tids = reorder(data.tids, cidByTid);
+
+	if (data.tidsByFilter) {
+		Object.keys(data.tidsByFilter).forEach((filter) => {
+			data.tidsByFilter[filter] = reorder(data.tidsByFilter[filter], cidByTid);
+		});
+	}
+
+	return data;
+};
+
+plugin.onSettingsSave = async function (data) {
+	if (data && data.plugin === SETTINGS_HASH) {
+		await loadSettings();
+	}
+};
+
+module.exports = plugin;

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "nodebb-plugin-unread-category-priority",
+  "version": "1.0.0",
+  "description": "Boosts topics from a chosen category to the top of the Unread list",
+  "main": "library.js",
+  "keywords": [
+    "nodebb",
+    "plugin",
+    "unread",
+    "category",
+    "priority"
+  ],
+  "license": "MIT",
+  "nbbpm": {
+    "compatibility": "^3.0.0 || ^4.0.0"
+  }
+}

package/plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "nodebb-plugin-unread-category-priority",
+  "url": "https://github.com/nodebb/nodebb-plugin-unread-category-priority",
+  "library": "./library.js",
+  "hooks": [
+    { "hook": "static:app.load", "method": "init" },
+    { "hook": "filter:topics.getUnreadTids", "method": "prioritize" },
+    { "hook": "filter:admin.header.build", "method": "addAdminNavigation" },
+    { "hook": "action:settings.set", "method": "onSettingsSave" }
+  ],
+  "modules": {
+    "../admin/plugins/unread-category-priority.js": "./static/lib/admin.js"
+  },
+  "templates": "static/templates",
+  "less": []
+}

package/static/lib/admin.js

@@ -0,0 +1,23 @@
+'use strict';
+
+define('admin/plugins/unread-category-priority', ['settings', 'alerts'], function (settings, alerts) {
+	const ACP = {};
+
+	ACP.init = function () {
+		settings.load('unread-category-priority', $('.unread-category-priority-settings'));
+
+		$('#save').on('click', function () {
+			settings.save('unread-category-priority', $('.unread-category-priority-settings'), function () {
+				alerts.alert({
+					type: 'success',
+					alert_id: 'unread-category-priority-saved',
+					title: 'Settings saved',
+					message: 'Reload the page (or any unread view) to see the new priority order.',
+					timeout: 5000,
+				});
+			});
+		});
+	};
+
+	return ACP;
+});

package/static/templates/admin/plugins/unread-category-priority.tpl

@@ -0,0 +1,22 @@
+<div class="acp-page-container">
+	<div class="row m-0">
+		<div class="col-12 col-md-8 px-0">
+			<div class="d-flex border-bottom py-2 m-0 sticky-top acp-page-main-header align-items-center justify-content-between">
+				<h4 class="fw-bold tracking-tight mb-0">Unread Category Priority</h4>
+				<button id="save" class="btn btn-primary btn-sm">[[admin/admin:save-changes]]</button>
+			</div>
+
+			<form role="form" class="unread-category-priority-settings">
+				<div class="mb-3">
+					<label class="form-label" for="priorityCids">Priority category IDs</label>
+					<input type="text" id="priorityCids" name="priorityCids" class="form-control" placeholder="e.g. 5 or 5,3,8" />
+					<p class="form-text">
+						Comma-separated category IDs. Unread topics in these categories are pinned to the
+						top of the Unread list. Recency order is preserved within each group.
+						Leave empty to disable — the plugin does nothing until at least one category is set.
+					</p>
+				</div>
+			</form>
+		</div>
+	</div>
+</div>