@dotdrelle/wiki-manager 0.12.1 → 0.12.8

package/README.md

@@ -36,6 +36,44 @@ everything — either with the mouse in a browser, or by talking to an assistant
 A **workspace** = a project. Each project is isolated: its documents, settings,
 and results never get mixed up with the others.
 
+## Installation and command modes
+
+The package can be installed either locally in a project or globally. The
+command used afterwards depends on the installation mode.
+
+### Local installation
+
+Use a local installation when the manager should be pinned in a project's
+`package.json`:
+
+```bash
+npm install @dotdrelle/wiki-manager
+npx wiki-manager
+npx wiki-workspace --help
+```
+
+`npm install` does not add `wiki-manager` or `wiki-workspace` to the shell's
+global `PATH`. Run local executables with `npx` (or `npm exec wiki-manager` and
+`npm exec wiki-workspace`). Bun is installed automatically as a package runtime;
+you do not need to add `~/.bun/bin` to `PATH`.
+
+### Global installation
+
+Use a global installation when the commands should be available directly from
+any directory:
+
+```bash
+npm install --global @dotdrelle/wiki-manager
+wiki-manager
+wiki-workspace --help
+```
+
+The global installation also installs the required Bun runtime. A separately
+installed Bun remains supported, but is not required.
+
+In both modes, launch the commands from the directory that should hold the
+manager state (`workspaces/`, `.env`, and `mcp.endpoints.json`).
+
 ## Functional overview
 
 The diagram below shows the whole picture at a glance: how **inputs** (external
@@ -54,14 +92,17 @@ chat** — all on the **shipped example**, with **no external source to
 configure**. External agents (Confluence, mail…) come later, only when you plug
 in real sources.
 
-> **Prerequisites:** Docker running and Node ≥ 22.
+> **Prerequisites:** Docker running and Node ≥ 22. Bun is installed with the npm
+> package.
 
-**1 — Install once, pick a home folder.**
+**1 — Install globally, pick a home folder.**
 The manager keeps its state (workspaces, `.env`, endpoints) in the directory
-where you launch it, so give it a home:
+where you launch it, so give it a home. This quick start uses the global mode;
+see [Installation and command modes](#installation-and-command-modes) for the
+local `npm install` + `npx` mode.
 
 ```bash
-npm i -g @dotdrelle/wiki-manager
+npm install --global @dotdrelle/wiki-manager
 mkdir -p ~/llm-wiki && cd ~/llm-wiki      # all manager state lives here
 ```
 
@@ -151,7 +192,7 @@ wiki-workspace wiki demo build            # or, in the shell: /skills run pipeli
 That's the whole loop. Next: the four ways to use it and how to configure the
 external agents (CME & co.) live in [docs/usage.md](https://raw.githubusercontent.com/dotdrelle/llm-wiki-manager/main/docs/usage.md); the detailed
 story is in [The journey](#the-journey-from-first-launch-to-first-result); and
-installing from source is in [Initial Setup](#initial-setup).
+installing from source is in [Installing from source](#installing-from-source).
 
 ## The journey: from first launch to first result
 
@@ -379,15 +420,15 @@ root `.env`; the wiki's **LLM keys** live in each workspace `.wikirc.yaml`.
 See the full, field-by-field reference in
 **[docs/configuration.md](https://raw.githubusercontent.com/dotdrelle/llm-wiki-manager/main/docs/configuration.md)**.
 
-## Initial Setup
+## Installing from source
 
 ```bash
 corepack enable
 pnpm install
 ```
 
-When installed through `npm`/`npx`/`bun`, `wiki-manager` keeps its state outside
-the package, in the directory where the command is launched:
+Whether installed locally, globally, or from source, `wiki-manager` keeps its
+state outside the package, in the directory where the command is launched:
 
 ```text
 ./workspaces/            # workspace registry

package/bin/wiki-manager

@@ -39,7 +39,26 @@ if [[ -n "$CACERT_PATH" ]]; then
   export CURL_CA_BUNDLE="$CACERT_PATH"
 fi
 
+SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_SOURCE" ]]; do
+  SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+  SCRIPT_TARGET="$(readlink "$SCRIPT_SOURCE")"
+  if [[ "$SCRIPT_TARGET" = /* ]]; then
+    SCRIPT_SOURCE="$SCRIPT_TARGET"
+  else
+    SCRIPT_SOURCE="$SCRIPT_DIR/$SCRIPT_TARGET"
+  fi
+done
+BIN_DIR="$(cd "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+PACKAGE_DIR="$(cd "$BIN_DIR/.." && pwd)"
+
 BUN_BIN="$(command -v bun 2>/dev/null || true)"
+if [[ -z "$BUN_BIN" && -x "$PACKAGE_DIR/node_modules/.bin/bun" ]]; then
+  BUN_BIN="$PACKAGE_DIR/node_modules/.bin/bun"
+fi
+if [[ -z "$BUN_BIN" && -x "$PACKAGE_DIR/../../.bin/bun" ]]; then
+  BUN_BIN="$PACKAGE_DIR/../../.bin/bun"
+fi
 if [[ -z "$BUN_BIN" && -n "${BUN_INSTALL:-}" && -x "$BUN_INSTALL/bin/bun" ]]; then
   BUN_BIN="$BUN_INSTALL/bin/bun"
 fi
@@ -49,20 +68,12 @@ fi
 if [[ -z "$BUN_BIN" ]]; then
   printf '%s\n' \
     'wiki-manager requires Bun >= 1.2.' \
-    'Install Bun from https://bun.sh/docs/installation or add it to PATH.' >&2
+    'Reinstall @dotdrelle/wiki-manager or install Bun from https://bun.sh/docs/installation.' >&2
   exit 127
 fi
 
-SCRIPT_SOURCE="${BASH_SOURCE[0]}"
-while [[ -L "$SCRIPT_SOURCE" ]]; do
-  SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_SOURCE")" && pwd)"
-  SCRIPT_TARGET="$(readlink "$SCRIPT_SOURCE")"
-  if [[ "$SCRIPT_TARGET" = /* ]]; then
-    SCRIPT_SOURCE="$SCRIPT_TARGET"
-  else
-    SCRIPT_SOURCE="$SCRIPT_DIR/$SCRIPT_TARGET"
-  fi
-done
-BIN_DIR="$(cd "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+if [[ ${#ARGS[@]} -eq 0 ]]; then
+  exec "$BUN_BIN" "$BIN_DIR/wiki-manager.js"
+fi
 
 exec "$BUN_BIN" "$BIN_DIR/wiki-manager.js" "${ARGS[@]}"

package/docker-compose.yml

@@ -55,7 +55,6 @@ services:
       - CME_MCP_AUTH_TOKEN
       - DOCUMENTS_MCP_AUTH_TOKEN
       - MAILER_MCP_AUTH_TOKEN
-      - ATLASSIAN_MCP_AUTH_TOKEN
       - WORKSPACE_NAME
       - DOCUMENT_INPUT_DIR=/documents/input
       - DOCUMENT_UPLOADS_DIR=/documents/uploads

package/mcp.endpoints.example.json

@@ -30,12 +30,6 @@
       "headers": {
         "Authorization": "Bearer ${MAILER_MCP_AUTH_TOKEN}"
       }
-    },
-    "atlassian": {
-      "url": "http://host.docker.internal:9000/mcp",
-      "headers": {
-        "Authorization": "Bearer ${ATLASSIAN_MCP_AUTH_TOKEN}"
-      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdrelle/wiki-manager",
-  "version": "0.12.1",
+  "version": "0.12.8",
   "description": "Agentic shell and orchestration cockpit for llm-wiki workspaces.",
   "license": "PolyForm-Noncommercial-1.0.0",
   "author": "dotrelle",
@@ -11,7 +11,7 @@
   },
   "scripts": {
     "start": "bun ./bin/wiki-manager.js",
-    "test": "node --test src/agent/graph.test.js src/contracts/schemas.test.js src/core/activity.test.js src/core/agentEvents.test.js src/core/runtimeLog.test.js src/activity/activityAggregator.test.js src/graph/runGraphProjector.test.js src/core/workflow.test.js src/core/planPatch.test.js src/core/agentLoop.test.js src/core/plan.test.js src/core/mcp.test.js src/core/documentIntake.test.js src/core/dockerCompose.test.js src/core/wikiWorkspace.test.js src/core/wikirc.test.js src/core/modelFetch.test.js src/core/startupCheck.test.js src/core/queueStore.test.js src/orchestrator/agentRegistry.test.js src/orchestrator/capabilityRegistry.test.js src/orchestrator/capabilityResolver.test.js src/orchestrator/planValidator.test.js src/orchestrator/planIntegrator.test.js src/orchestrator/scheduler.test.js src/orchestrator/attemptManager.test.js src/orchestrator/resultAggregator.test.js src/orchestrator/approvalPolicy.test.js src/commands/slash.test.js src/shell/repl.test.js src/runtime/store.test.js src/runtime/controlMessages.test.js src/runtime/recoveryManager.test.js src/runtime/server.test.js src/runtime/supervisor.test.js src/runtime/runner.test.js src/runtime/runner.e2e.test.js src/runtime/donna-contract.test.js src/runtime/auth.test.js",
+    "test": "node --test src/agent/graph.test.js src/contracts/schemas.test.js src/core/activity.test.js src/core/buildInfo.test.js src/core/agentEvents.test.js src/core/runtimeLog.test.js src/activity/activityAggregator.test.js src/graph/runGraphProjector.test.js src/core/workflow.test.js src/core/planPatch.test.js src/core/agentLoop.test.js src/core/plan.test.js src/core/mcp.test.js src/core/documentIntake.test.js src/core/dockerCompose.test.js src/core/wikiWorkspace.test.js src/core/wikirc.test.js src/core/modelFetch.test.js src/core/startupCheck.test.js src/core/queueStore.test.js src/orchestrator/agentRegistry.test.js src/orchestrator/capabilityRegistry.test.js src/orchestrator/capabilityResolver.test.js src/orchestrator/planValidator.test.js src/orchestrator/planIntegrator.test.js src/orchestrator/scheduler.test.js src/orchestrator/attemptManager.test.js src/orchestrator/resultAggregator.test.js src/orchestrator/approvalPolicy.test.js src/commands/slash.test.js src/shell/repl.test.js src/runtime/store.test.js src/runtime/controlMessages.test.js src/runtime/recoveryManager.test.js src/runtime/server.test.js src/runtime/supervisor.test.js src/runtime/runner.test.js src/runtime/runner.e2e.test.js src/runtime/donna-contract.test.js src/runtime/auth.test.js",
     "check-versions": "node scripts/check-versions.js",
     "prepack": "node scripts/check-versions.js",
     "prepublishOnly": "node scripts/check-versions.js",
@@ -49,6 +49,7 @@
     "@langchain/langgraph": "^1.3.2",
     "@opentui/core": "^0.3.2",
     "@opentui/solid": "^0.3.2",
+    "bun": "^1.3.14",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
     "openai": "^6.42.0",

package/src/activity/activityAggregator.js

@@ -10,9 +10,18 @@ export function aggregateActivity(state = {}, events = []) {
   const activities = Array.isArray(state.activities) ? state.activities : [];
   const progress = calculateWeightedProgress(tasks, activities);
   const groups = groupTasks(tasks);
+  const deduped = deduplicateActivities(activities);
+  // Group lines only cover activities attached to plan tasks. An activity
+  // started OUTSIDE the plan (e.g. the agent calls production_start_job
+  // directly after a minimal one-step plan) must still be visible: without
+  // this, the panel showed a done "production_status" step while the actual
+  // ingest ran invisibly at 15%.
   const lines = groups.length > 0
-    ? groups.map((group) => groupLine(group, activities))
-    : deduplicateActivities(activities).map(activityLine);
+    ? [
+      ...groups.map((group) => groupLine(group, activities)),
+      ...unattachedActivities(tasks, deduped).map(activityLine),
+    ]
+    : deduped.map(activityLine);
   return {
     initialSynthesis: initialSynthesisFromState(state, events),
     progress,
@@ -20,6 +29,21 @@ export function aggregateActivity(state = {}, events = []) {
   };
 }
 
+function unattachedActivities(tasks, activities) {
+  const attachedKeys = new Set(tasks
+    .flatMap((task) => [task.activityKey, task.ownerActivityKey, task._activityKey])
+    .filter(Boolean)
+    .map(String));
+  const taskIds = new Set(tasks.map((task) => String(task.id ?? task.step ?? '')).filter(Boolean));
+  return activities.filter((activity) => {
+    const keys = [activity.key, activity.id].filter(Boolean).map(String);
+    if (keys.some((value) => attachedKeys.has(value))) return false;
+    const stepId = String(activity?.progress?.stepId ?? '');
+    if (stepId && taskIds.has(stepId)) return false;
+    return true;
+  });
+}
+
 function groupTasks(tasks) {
   const groups = new Map();
   for (const task of tasks) {
@@ -70,11 +94,18 @@ function groupLine(group, activities) {
     status = `${done}/${total}`;
   }
   const agents = activeAgents > 0 ? ` - ${activeAgents} agent${activeAgents > 1 ? 's' : ''}` : '';
+  // While a task is running, expose ITS live progress as the group percent.
+  // The completion ratio (done/total tasks) said 0% while the label showed
+  // the real activity progress ("— 1 %"), so the TUI badge contradicted the
+  // text. Fall back to the task-completion ratio when nothing is running.
+  const percent = running.length > 0 && activeProgress != null
+    ? Math.round(activeProgress)
+    : (total > 0 ? Math.round((done / total) * 100) : null);
   return {
     id: `group:${group.id}`,
     label: `${icon} ${group.label} - ${status}${agents}`,
     status,
-    progress: { done, total, percent: total > 0 ? Math.round((done / total) * 100) : null },
+    progress: { done, total, percent },
     activeAgents,
   };
 }

package/src/activity/activityAggregator.test.js

@@ -58,3 +58,35 @@ test('aggregateActivity exposes initial synthesis and grouped display lines', ()
   assert.ok(activity.lines.some((line) => /\[\.\.\.\] customer-data\.enrich - 63 %/.test(line.label)));
   assert.ok(activity.lines.some((line) => /\[ \] publish - en attente/.test(line.label)));
 });
+
+test('aggregateActivity keeps activities not attached to any plan task visible', () => {
+  // Regression: a done one-step minimal plan (production_status) masked the
+  // actually-running ingest activity started outside the plan.
+  const state = {
+    plan: [{
+      id: 'status-check',
+      step: 1,
+      description: 'production.production_status',
+      status: 'done',
+      groupId: '1',
+    }],
+    activities: [
+      {
+        key: 'production:prod_192444',
+        id: 'prod_192444',
+        label: 'Ingest b87acaf6-Comite.md',
+        source: 'production',
+        status: 'running',
+        terminal: false,
+        progress: { percent: 15, detail: 'LLM running' },
+      },
+    ],
+  };
+
+  const aggregated = aggregateActivity(state, []);
+  const labels = aggregated.lines.map((line) => line.label).join('\n');
+  assert.match(labels, /\[x\] .* done/, 'the done plan group stays visible');
+  assert.match(labels, /Ingest b87acaf6/, 'the unattached running ingest must appear');
+  const ingestLine = aggregated.lines.find((line) => /Ingest/.test(line.label));
+  assert.equal(ingestLine.status, 'running');
+});