@rigour-labs/cli 6.11.2 → 6.12.0-rc.2

package/dist/cli.js

@@ -403,6 +403,8 @@ program
     .option('--promote <id>', 'Accept a candidate as a lesson (recorded as your decision)')
     .option('--reject <id>', 'Reject a candidate or lesson: the judges are told this team decided against it')
     .option('--why <text>', 'Why, recorded with --promote or --reject')
+    .option('--scope <id>', 'Set how far a lesson reaches, with --to: its file, its folder, or every change (a team standard); recorded as your decision')
+    .option('--to <reach>', 'With --scope: file, folder or repo')
     .option('--use-wording <id>', 'Take the corrected wording a newer version suggests for a lesson you decided (the old wording is kept as evidence)')
     .option('--compile', 'Propose a deterministic check for each verified lesson a template fits, and list the compiled checks')
     .option('--approve-check <id>', 'Approve a compiled check: it runs on every review (a note unless gates.compiled_lessons.block)')

package/dist/commands/learn-reviews.d.ts

@@ -17,6 +17,9 @@ export interface LearnReviewsOptions {
     withdrawCheck?: string;
     /** A person takes the corrected wording a newer version suggested for a lesson they decided. */
     useWording?: string;
+    /** A person sets how far a lesson reaches (`to`: file, folder or repo). */
+    scope?: string;
+    to?: string;
 }
 export declare function learnReviewsCommand(cwd: string, options: LearnReviewsOptions): Promise<void>;
 /** owner/name from the origin remote (https or ssh, any host alias). */

package/dist/commands/learn-reviews.js

@@ -11,7 +11,7 @@ import { execFileSync } from 'child_process';
 import chalk from 'chalk';
 import path from 'path';
 import { personOf } from './git-identity.js';
-import { acceptSuggestedText, branchBase, decideCompiledCheck, decideLesson, defaultExec, proposeCompiledChecks, readCompiledChecks, suspension, githubToken, learnFromReviews, lessonsPath, readLessons, ruleWriterFor, ConfigSchema } from '@rigour-labs/core';
+import { acceptSuggestedText, scopeLesson, branchBase, decideCompiledCheck, decideLesson, defaultExec, proposeCompiledChecks, readCompiledChecks, suspension, githubToken, learnFromReviews, lessonsPath, readLessons, ruleWriterFor, ConfigSchema } from '@rigour-labs/core';
 import { loadConfig } from './review-config.js';
 export async function learnReviewsCommand(cwd, options) {
     if (options.promote)
@@ -22,6 +22,8 @@ export async function learnReviewsCommand(cwd, options) {
         return list(cwd, options.json);
     if (options.useWording)
         return useWording(cwd, options.useWording);
+    if (options.scope)
+        return scope(cwd, options.scope, options.to, options.why);
     if (options.compile)
         return compile(cwd, options.json);
     if (options.approveCheck)
@@ -58,7 +60,7 @@ function list(cwd, json) {
     const label = { verified: chalk.green('lesson   '), candidate: chalk.yellow('candidate'), rejected: chalk.red('rejected ') };
     for (const l of lessons) {
         const prs = [...new Set(l.evidence.map(e => `#${e.pr}`))].join(', ');
-        const by = l.promotedBy ? chalk.dim(` [${l.promotedBy}]`) : '';
+        const by = chalk.dim(`${l.promotedBy ? ` [${l.promotedBy}]` : ''}${l.scope ? ` [${l.scope === 'repo' ? 'every change' : 'its folder'}]` : ''}`);
         console.log(`${label[l.state]} ${chalk.dim(l.id)} ${l.file || '(team standard)'}: ${l.text}${by} ${chalk.dim(`(${prs})`)}`);
         if (l.suggestedText)
             console.log(chalk.cyan(`          corrected wording (${l.suggestedWhy ?? 'reworded'}): ${l.suggestedText}`) + chalk.dim(`  take it: rigour learn-reviews --use-wording ${l.id}`));
@@ -117,6 +119,30 @@ function decideCheckOrThrow(cwd, id, state) {
     }
     console.log(state === 'active' ? chalk.green(`✔ Runs from now on (a note unless gates.compiled_lessons.block): ${check.message}`) : chalk.yellow(`✔ Taken back: ${check.message}`));
 }
+/** A person sets how far a lesson reaches: its file, its folder, or every change (a repository standard). */
+function scope(cwd, id, to, why) {
+    if (to !== 'file' && to !== 'folder' && to !== 'repo') {
+        console.error(chalk.red('--to is file, folder or repo.'));
+        process.exitCode = 1;
+        return;
+    }
+    let lesson;
+    try {
+        lesson = scopeLesson(cwd, id, to, personOf(cwd), why);
+    }
+    catch (e) {
+        console.error(chalk.red(e.message));
+        process.exitCode = 1;
+        return;
+    }
+    if (!lesson) {
+        console.error(chalk.red(`No lesson ${id}.`));
+        process.exitCode = 1;
+        return;
+    }
+    const reach = to === 'repo' ? 'every change, as a team standard' : to === 'folder' ? `every change in ${path.posix.dirname(lesson.file)}/` : `changes to ${lesson.file}`;
+    console.log(chalk.green(`✔ Reaches ${reach}${lesson.state === 'verified' ? '' : ' once it is a lesson (it is a candidate now)'}: ${lesson.text}`));
+}
 /** A person takes the suggested wording of a lesson they decided; the old wording is kept as evidence. */
 function useWording(cwd, id) {
     const lesson = acceptSuggestedText(cwd, id, personOf(cwd));

package/dist/commands/studio-learning.d.ts

@@ -43,6 +43,11 @@ export interface LessonJourney {
         text: string;
         why: string;
     };
+    /** How far a review lesson reaches (core scopeLesson): its file, its folder, or every change; `hasFile` false for a team standard. */
+    reach?: {
+        scope: 'file' | 'folder' | 'repo';
+        hasFile: boolean;
+    };
 }
 export interface StudioLearning {
     lessons: LessonJourney[];

package/dist/commands/studio-learning.js

@@ -7,7 +7,7 @@
  * lesson's subject prefix). Counts that Rigour cannot know here are null, never 0: PR catches
  * recorded on another machine (CI) never reach this one.
  */
-import { acceptSuggestedText, decideCompiledCheck, decideLesson, fixLessonPrefix, proposeCompiledChecks, readCompiledChecks, suspension, localOutcomeMetrics, pendingDecision, listKnowledgeLessons, readLessons } from '@rigour-labs/core';
+import { acceptSuggestedText, scopeLesson, decideCompiledCheck, decideLesson, fixLessonPrefix, proposeCompiledChecks, readCompiledChecks, suspension, localOutcomeMetrics, pendingDecision, listKnowledgeLessons, readLessons } from '@rigour-labs/core';
 import { personOf } from './git-identity.js';
 import { checkoutRoots, eventsAcross, storiesAcross } from './studio-checkouts.js';
 const WEEK_MS = 7 * 24 * 60 * 60 * 1000;
@@ -51,6 +51,7 @@ export function buildLearning(input) {
             reachedPr: null,
             ...decisionFor(l),
             ...(l.suggestedText ? { suggestedText: { text: l.suggestedText, why: l.suggestedWhy ?? 'reworded' } } : {}),
+            reach: { scope: l.scope ?? 'file', hasFile: !!l.file },
         })),
         // Lessons back to a candidate when outcomes stopped promoting come first: a person decides each once.
     ].sort((a, b) => Number(!!b.reclassified) - Number(!!a.reclassified) || b.learnedAt.localeCompare(a.learnedAt))
@@ -88,6 +89,10 @@ function decisionFor(lesson) {
         return { canDecide: true, suggested: { detail: last.detail ?? '', pr: last.pr, at: last.at ?? '' } };
     return { canDecide: false };
 }
+/** The reason a person gave in Studio, else that they decided there. */
+function studioWhy(why) {
+    return typeof why === 'string' && why.trim() ? why.trim() : 'decided in Studio';
+}
 /** A person's decision on a review lesson from Studio, recorded as `rigour learn-reviews --promote / --reject` records it: with their git email, and final. */
 export function decideReviewLesson(cwd, body) {
     const { id, decision, why } = (body ?? {});
@@ -95,9 +100,26 @@ export function decideReviewLesson(cwd, body) {
         throw new Error('a review lesson id (12 hex characters) is required');
     if (decision === 'reworded')
         return rewordFromStudio(cwd, id);
+    if (decision === 'scope')
+        return scopeFromStudio(cwd, id, body.to, why);
     if (decision !== 'accepted' && decision !== 'rejected' && decision !== 'dismissed')
-        throw new Error('decision is accepted, rejected, dismissed or reworded');
-    const lesson = decideLesson(cwd, id, decision, personOf(cwd), typeof why === 'string' && why.trim() ? why.trim() : 'decided in Studio');
+        throw new Error('decision is accepted, rejected, dismissed, reworded or scope');
+    const lesson = decideLesson(cwd, id, decision, personOf(cwd), studioWhy(why));
+    if (!lesson)
+        throw new Error(`no review lesson ${id}`);
+    return { id: lesson.id, state: lesson.state };
+}
+/**
+ * A person sets how far a review lesson reaches from Studio, as `rigour learn-reviews --scope` records it: with their
+ * git email, so with no git email set it is refused, like a compiled check's decision.
+ */
+function scopeFromStudio(cwd, id, to, why) {
+    if (to !== 'file' && to !== 'folder' && to !== 'repo')
+        throw new Error('to is file, folder or repo');
+    const by = personOf(cwd);
+    if (by === 'unknown')
+        throw new Error('no git email is set in this checkout (git config user.email): who decides how far a lesson reaches is recorded with it');
+    const lesson = scopeLesson(cwd, id, to, by, studioWhy(why));
     if (!lesson)
         throw new Error(`no review lesson ${id}`);
     return { id: lesson.id, state: lesson.state };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rigour-labs/cli",
-  "version": "6.11.2",
+  "version": "6.12.0-rc.2",
   "description": "Code review that happens while your agent writes: deterministic checks on the lines it changed, quiet unless it can prove a defect, and learning from your team's fixes and dismissals. Works with Claude Code, Cursor, Codex, Cline and Windsurf.",
   "engines": {
     "node": ">=22.13"
@@ -59,13 +59,13 @@
     "inquirer": "9.2.16",
     "ora": "^8.0.1",
     "yaml": "^2.8.2",
-    "@rigour-labs/core": "6.11.2"
+    "@rigour-labs/core": "6.12.0-rc.2"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "9.0.7",
     "@types/node": "^25.0.3",
-    "@rigour-labs/studio": "6.11.2"
+    "@rigour-labs/studio": "6.12.0-rc.2"
   },
   "scripts": {
     "build": "tsc && pnpm bundle-studio",