nubos-pilot 1.0.2 → 1.0.3

package/lib/researcher-swarm.cjs

@@ -11,12 +11,28 @@ const DEFAULT_K = 3;
 const MIN_K = 1;
 const MAX_K = 5;
 
+// Perspectival nudges, NOT thematic preferences. Each entry varies HOW the
+// spawn investigates the same `<task_query>`, never WHAT it should prefer in
+// the answer. Thematic seed_deltas (e.g. "prefer native TypeScript types")
+// silently turn the swarm into a topic-split — three spawns each ranking a
+// different axis, intersection ≈ 0, consensus a fiction. ADR-0011 §Spawn
+// Contract is explicit: identical task_query for every spawn, only the
+// seed_delta varies, and the variation must not change WHICH question is
+// answered or which solution dimension is favoured.
+//
+// Litmus test for adding a new entry: rephrase as "what does this researcher
+// optimise FOR in their final answer?" — if the answer names a concrete
+// solution attribute (TypeScript, smallest deps, latest version), it is
+// thematic and belongs in the planner / architect, not the researcher swarm.
+// Perspectival nudges answer "how does this researcher arrive at the
+// answer?" — methodology, evidence weighting, contrarian stance, breadth vs.
+// depth, gap surfacing.
 const SEED_DELTAS = [
-  'Prefer authoritative sources over training data when they conflict.',
-  'Prefer the smallest dependency surface that satisfies the requirement.',
-  'Prefer libraries that ship native TypeScript types and ESM by default.',
-  'Prefer architectures that compose with the project\'s existing module boundaries over greenfield rewrites.',
-  'Prefer documented, observable failure modes over silent fallbacks.',
+  'Treat training-data recall as a hypothesis to verify against primary documentation; downgrade unverified claims to LOW confidence.',
+  'Survey breadth-first before narrowing — enumerate every viable option you find, even ones that look obviously inferior, before recommending.',
+  'Be contrarian: assume the obvious recommendation is wrong and justify whether it actually is. If it survives the challenge, your confidence is higher.',
+  'Surface unknowns explicitly: anything you cannot verify becomes an Open Question, not an [ASSUMED] filled with a plausible default.',
+  'Stress-test the leading recommendation: name the most plausible failure mode that would make it the wrong choice, then assess how likely that mode is in scope.',
 ];
 
 // Invariant — SEED_DELTAS must cover the full clamp range. The previous

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nubos-pilot",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "AI-driven planning and execution tool for code projects",
   "homepage": "https://github.com/Nubos-AI/nubos-pilot",
   "repository": {