@balpal4495/quorum 0.4.0 → 0.4.2

package/README.md

@@ -163,11 +163,11 @@ Nothing is indexed without your explicit sign-off.
 
 Commit `.chronicle/committed/` to git. Future sessions — and your teammates' sessions — start with that context.
 
-### Every merged PR creates a Chronicle proposal automatically
+### Every merged PR can create a Chronicle proposal automatically
 
-A GitHub Actions workflow fires when any PR merges to main. It creates a Chronicle proposal capturing the decision, which files changed, and any explicitly deferred items from the PR description. The proposal sits in `proposals/` until you commit it — nothing is auto-indexed.
+Quorum ships a GitHub Actions workflow (`chronicle-on-merge.yml`) that fires when any PR merges to main. It creates a Chronicle proposal capturing the decision, which files changed, and any explicitly deferred items from the PR description. The proposal sits in `proposals/` until you commit it — nothing is auto-indexed.
 
-This means the gap between "PR merged" and "Chronicle knows about it" is now zero.
+To enable this in your project, copy `.github/workflows/chronicle-on-merge.yml` and `scripts/chronicle-pr.js` from the [Quorum repo](https://github.com/balpal4495/Quorum) into your own repo.
 
 ---
 
@@ -358,7 +358,7 @@ quorum sentinel coverage --json       # machine-readable, for scripts
 
 **Drift** — do existing Chronicle entries still accurately describe the code, or have they gone stale? Drift detection requires an LLM; use `sentinelAssertions({ llm })` in your test suite (the CLI surfaces the message and directs you there).
 
-Add `sentinel-pr.yml` (included in `quorum/`) to your GitHub Actions and every PR gets a comment showing a full-project coverage table and a colour-coded heatmap. Changed modules are highlighted. Reviewers see exactly where knowledge is solid and where it goes dark.
+To get a coverage comment on every PR, copy `.github/workflows/sentinel-pr.yml` from the [Quorum repo](https://github.com/balpal4495/Quorum) into your project. Every PR then gets a comment showing a full-project coverage table and a colour-coded heatmap. Changed modules are highlighted. Reviewers see exactly where knowledge is solid and where it goes dark.
 
 ---
 

package/SETUP.md

@@ -31,7 +31,7 @@ Read these files in full before proceeding:
 
 - `quorum/modules/README.md` — module overview and quick-start
 - `quorum/modules/AGENTS.md` — file ownership and invariants
-- `quorum/.github/copilot-instructions.md` — workflow rules for AI agents
+- `.github/copilot-instructions.md` — workflow rules for AI agents (installed at project root by init)
 
 These are your operating instructions for everything that follows.
 
@@ -80,16 +80,20 @@ If the project uses `yarn` or `pnpm`, use the appropriate installer instead.
 
 ### 4a. `.github/copilot-instructions.md`
 
-**If it does not exist:**
-Copy `quorum/.github/copilot-instructions.md` to `.github/copilot-instructions.md`.
+The automated init command (`npx @balpal4495/quorum@latest init`) handles this step automatically — it creates or appends to `.github/copilot-instructions.md` at the project root.
 
-**If it already exists:**
-Append the entire contents of `quorum/.github/copilot-instructions.md` to the existing file, preceded by this separator:
+**If you are completing this step manually:**
+
+Check whether `.github/copilot-instructions.md` already exists.
+
+**If it does not exist:** Fetch the Quorum copilot instructions from the Quorum GitHub repo (`balpal4495/Quorum`) at `.github/copilot-instructions.md` and write it to `.github/copilot-instructions.md` in the project root.
+
+**If it already exists and does not contain `<!-- quorum -->`:** Append the Quorum instructions to the existing file, preceded by:
 
 ```markdown
 ---
 
-<!-- Quorum: appended by setup -->
+<!-- quorum -->
 ```
 
 Do not replace or overwrite existing content.

package/bin/commands/init.js

@@ -55,6 +55,13 @@ async function copyModules(target) {
   log.created("quorum/SETUP.md")
 }
 
+async function copyEvals(target) {
+  const src  = path.join(QUORUM_ROOT, "evals")
+  const dest = path.join(target, "quorum", "evals")
+  await fs.cp(src, dest, { recursive: true })
+  log.created("quorum/evals/")
+}
+
 async function mergeCopilotInstructions(target) {
   log.section("Merging AI instruction files")
   const src     = path.join(QUORUM_ROOT, ".github", "copilot-instructions.md")
@@ -207,6 +214,7 @@ export async function run(PKG_VERSION) {
 
   await guardAlreadyInitialized(target)
   await copyModules(target)
+  await copyEvals(target)
   await mergeCopilotInstructions(target)
   await mergeAgentsMd(target)
   await mergeClaudeMd(target)

package/bin/init.js

@@ -5,7 +5,7 @@
  * Drops Quorum into an existing Node.js project.
  * Run from the target project root:
  *
- *   npx github:balpal4495/Quorum init
+ *   npx @balpal4495/quorum@latest init
  *
  * Zero external dependencies — uses only Node.js built-ins.
  * Requires Node.js 18+.
@@ -104,6 +104,13 @@ async function copyModules() {
   log.created("quorum/SETUP.md")
 }
 
+async function copyEvals() {
+  const src  = path.join(QUORUM_ROOT, "evals")
+  const dest = path.join(TARGET, "quorum", "evals")
+  await fs.cp(src, dest, { recursive: true })
+  log.created("quorum/evals/")
+}
+
 async function mergeCopilotInstructions() {
   log.section("Merging AI instruction files")
 
@@ -309,6 +316,7 @@ async function main() {
 
   await guardAlreadyInitialized()
   await copyModules()
+  await copyEvals()
   await mergeCopilotInstructions()
   await mergeAgentsMd()
   await mergeClaudeMd()

package/modules/council/deliberate.ts

@@ -10,8 +10,6 @@ const DEFAULT_ADVISOR_COUNT = 5
 const DEFAULT_REVIEWER_COUNT = 5
 const LITE_ADVISOR_COUNT = 1
 const LITE_REVIEWER_COUNT = 2
-const JURY_ONLY_ADVISOR_COUNT = 1
-const JURY_ONLY_REVIEWER_COUNT = 1
 
 /**
  * Run the Council deliberation pipeline.
@@ -44,14 +42,26 @@ export async function deliberate(
 
   // Classify risk to determine Council mode and advisor/reviewer counts
   const risk = classifyRisk(input.outcome, input.design, input.evidence)
+
+  if (risk.council_mode === "jury-only") {
+    return {
+      satisfied: true,
+      verdict: "Skipped — low-risk design passed by Jury without Council review.",
+      blockers: [],
+      warnings: [],
+      challenges: [],
+      evidence_cited: [],
+      citation_validation: { valid_ids: [], hallucinated_ids: [] },
+      advisor_split: { proceed: 0, redesign: 0, "investigate-more": 0 },
+      recommendation: "proceed",
+    }
+  }
+
   let defaultAdvisors = DEFAULT_ADVISOR_COUNT
   let defaultReviewers = DEFAULT_REVIEWER_COUNT
   if (risk.council_mode === "lite") {
     defaultAdvisors = LITE_ADVISOR_COUNT
     defaultReviewers = LITE_REVIEWER_COUNT
-  } else if (risk.council_mode === "jury-only") {
-    defaultAdvisors = JURY_ONLY_ADVISOR_COUNT
-    defaultReviewers = JURY_ONLY_REVIEWER_COUNT
   }
   const advisorCount = deps.advisorCount ?? defaultAdvisors
   const reviewerCount = deps.reviewerCount ?? defaultReviewers

package/modules/council/types.ts

@@ -94,7 +94,7 @@ export type RiskLevel = "low" | "medium" | "high" | "critical"
 /**
  * Determines which Council mode to use.
  *   skip        → Oracle query only, no LLM validation
- *   jury-only   → Jury scores, no Council fan-out
+ *   jury-only   → Jury scores, Council skipped entirely (low-risk fast path)
  *   lite        → Jury + 1–2 reviewers (no full advisor fan-out)
  *   full        → Full Council (default 5 advisors + 5 reviewers + Chairman)
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@balpal4495/quorum",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Portable reasoning layer for agentic codebases — Oracle, Jury, Council, Sentinel",
   "type": "module",
   "license": "MIT",