@mrsf/cli 0.2.0 → 0.2.1

package/dist/commands/reanchor.js

@@ -8,7 +8,7 @@ import { readDocumentLines } from "../lib/parser.js";
 import { sidecarToDocument } from "../lib/discovery.js";
 import { resolveSidecarPaths } from "../lib/resolve-files.js";
 import { writeSidecar } from "../lib/writer.js";
-import { findRepoRoot, getStagedFiles } from "../lib/git.js";
+import { findRepoRoot, getStagedFiles, getCurrentCommit } from "../lib/git.js";
 import { reanchorDocument, applyReanchorResults, } from "../lib/reanchor.js";
 export function registerReanchor(program) {
     program
@@ -20,6 +20,7 @@ export function registerReanchor(program) {
         .option("--no-git", "Disable git integration")
         .option("--from <commit>", "Override from-commit for all comments")
         .option("--update-text", "Also update selected_text to match current document text")
+        .option("-f, --force", "Firmly anchor high-confidence results (update commit to HEAD, clear audit fields)")
         .action(async (files, opts) => {
         const parentOpts = program.opts();
         const cwd = parentOpts.cwd ?? process.cwd();
@@ -70,6 +71,7 @@ export function registerReanchor(program) {
                 const docPath = sidecarToDocument(sp);
                 const lines = await readDocumentLines(docPath);
                 const repoRoot = !noGit ? await findRepoRoot(cwd) : null;
+                const headCommit = repoRoot ? await getCurrentCommit(repoRoot) : undefined;
                 const results = await reanchorDocument(doc, lines, {
                     threshold,
                     noGit,
@@ -82,6 +84,8 @@ export function registerReanchor(program) {
                 if (!opts.dryRun) {
                     const changed = applyReanchorResults(doc, results, {
                         updateText: opts.updateText,
+                        force: opts.force,
+                        headCommit: headCommit ?? undefined,
                     });
                     totalChanged += changed;
                     if (changed > 0) {
@@ -93,6 +97,8 @@ export function registerReanchor(program) {
                     const clone = structuredClone(doc);
                     totalChanged += applyReanchorResults(clone, results, {
                         updateText: opts.updateText,
+                        force: opts.force,
+                        headCommit: headCommit ?? undefined,
                     });
                 }
                 if (!quiet) {

package/dist/lib/reanchor.d.ts

@@ -33,6 +33,8 @@ export declare function reanchorDocument(doc: MrsfDocument, documentLines: strin
  */
 export declare function applyReanchorResults(doc: MrsfDocument, results: ReanchorResult[], opts?: {
     updateText?: boolean;
+    force?: boolean;
+    headCommit?: string;
 }): number;
 /**
  * High-level re-anchor for a single sidecar file path.

package/dist/lib/reanchor.js

@@ -45,8 +45,24 @@ export function reanchorComment(comment, documentLines, opts = {}) {
     // -----------------------------------------------------------------------
     // Step 0: Diff-based shift
     // -----------------------------------------------------------------------
-    if (selectedText && comment.line != null && opts.diffHunks?.length) {
+    if (comment.line != null && opts.diffHunks?.length) {
         const { shift, modified } = getLineShift(opts.diffHunks, comment.line);
+        // For line-only comments (no selected_text), apply the diff shift directly
+        if (!selectedText) {
+            const shiftedLine = comment.line + shift;
+            const lineSpan = comment.end_line != null ? comment.end_line - comment.line : 0;
+            const shiftedEndLine = comment.end_line != null ? shiftedLine + lineSpan : undefined;
+            return {
+                commentId,
+                status: shift === 0 ? "anchored" : "shifted",
+                score: 1.0,
+                newLine: shiftedLine,
+                newEndLine: shiftedEndLine,
+                reason: shift === 0
+                    ? "Line-only comment unchanged (diff confirms position)."
+                    : `Line-only comment shifted by ${shift > 0 ? "+" : ""}${shift} line(s) via diff.`,
+            };
+        }
         if (!modified) {
             const shiftedLine = comment.line + shift;
             const lineSpan = comment.end_line != null ? comment.end_line - comment.line : 0;
@@ -167,13 +183,18 @@ export function reanchorComment(comment, documentLines, opts = {}) {
                 }
             }
             // Pure line fallback
+            // If there's no selected_text, the comment is purely line-anchored.
+            // A commit change alone doesn't make it ambiguous — we accept it as-is.
+            const isLineOnly = !selectedText;
             return {
                 commentId,
-                status: opts.commitIsStale ? "ambiguous" : "anchored",
-                score: opts.commitIsStale ? 0.5 : 0.8,
+                status: isLineOnly ? "anchored" : (opts.commitIsStale ? "ambiguous" : "anchored"),
+                score: isLineOnly ? 1.0 : (opts.commitIsStale ? 0.5 : 0.8),
                 newLine: comment.line,
                 newEndLine: comment.end_line,
-                reason: `Line/column fallback${qualifier}.`,
+                reason: isLineOnly
+                    ? "Line-only comment (no selected_text to verify)."
+                    : `Line/column fallback${qualifier}.`,
             };
         }
     }
@@ -320,6 +341,22 @@ export function applyReanchorResults(doc, results, opts = {}) {
             comment.x_reanchor_status = result.status;
             comment.x_reanchor_score = result.score;
         }
+        // --force: firmly anchor high-confidence results
+        // Update commit to HEAD and clear audit fields so the comment
+        // won't be re-evaluated on the next reanchor run.
+        if (opts.force &&
+            opts.headCommit &&
+            (result.status === "anchored" || result.status === "shifted") &&
+            result.score >= HIGH_THRESHOLD) {
+            comment.commit = opts.headCommit;
+            delete comment.x_reanchor_status;
+            delete comment.x_reanchor_score;
+            // Clear stale anchored_text since anchor is now confirmed
+            if (comment.anchored_text && comment.anchored_text === comment.selected_text) {
+                delete comment.anchored_text;
+            }
+            isChanged = true;
+        }
         if (isChanged)
             changed++;
     }
@@ -333,6 +370,7 @@ export async function reanchorFile(sidecarPath, opts = {}) {
     const docPath = sidecarToDocument(sidecarPath);
     const documentLines = await readDocumentLines(docPath);
     const repoRoot = !opts.noGit ? await findRepoRoot(opts.cwd) : null;
+    const headCommit = repoRoot ? await getCurrentCommit(repoRoot) : undefined;
     const results = await reanchorDocument(doc, documentLines, {
         ...opts,
         documentPath: docPath,
@@ -341,7 +379,11 @@ export async function reanchorFile(sidecarPath, opts = {}) {
     let changed = 0;
     let written = false;
     if (!opts.dryRun) {
-        changed = applyReanchorResults(doc, results, { updateText: opts.updateText });
+        changed = applyReanchorResults(doc, results, {
+            updateText: opts.updateText,
+            force: opts.force,
+            headCommit: headCommit ?? undefined,
+        });
         if (changed > 0 || opts.autoUpdate) {
             await writeSidecar(sidecarPath, doc);
             written = true;

package/dist/lib/types.d.ts

@@ -143,6 +143,8 @@ export interface ReanchorOptions extends BaseOptions {
     fromCommit?: string;
     /** Update selected_text to match anchored_text (opt-in per §6.2). */
     updateText?: boolean;
+    /** Force-anchor: update commit to HEAD and clear audit fields for high-confidence results. */
+    force?: boolean;
 }
 export interface ValidateOptions extends BaseOptions {
     /** Treat warnings as errors. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrsf/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI and library for the Markdown Review Sidecar Format (MRSF)",
   "type": "module",
   "main": "./dist/index.js",