@mrsf/cli 0.3.0 → 0.3.1

package/dist/bin.js

@@ -49,7 +49,7 @@ function showBanner() {
   ${chalk.cyan.bold("╔╦╗")}${chalk.blue.bold("╦═╗")}${chalk.magenta.bold("╔═╗")}${chalk.yellow.bold("╔═╗")}
   ${chalk.cyan.bold("║║║")}${chalk.blue.bold("╠╦╝")}${chalk.magenta.bold("╚═╗")}${chalk.yellow.bold("╠╣")}
   ${chalk.cyan.bold("╩ ╩")}${chalk.blue.bold("╩╚═")}${chalk.magenta.bold("╚═╝")}${chalk.yellow.bold("╚")}
-  ${chalk.dim("Markdown Review Sidecar Format")}  ${chalk.dim.italic(`v${version}`)}
+  ${chalk.dim("Markdown Review Sidecar Format")}  ${chalk.dim.italic(`v${version} (Node.js)`)}
   ${chalk.dim.underline(repo)}
 `;
     process.stderr.write(banner + "\n");
@@ -59,8 +59,8 @@ showBanner();
 const program = new Command();
 program
     .name("mrsf")
-    .description("Markdown Review Sidecar Format — CLI & toolkit")
-    .version(version)
+    .description("Markdown Review Sidecar Format — CLI & toolkit (Node.js)")
+    .version(`${version} (Node.js)`)
     .option("--cwd <dir>", "Working directory")
     .option("--config <path>", "Path to .mrsf.yaml")
     .option("--no-color", "Disable colour output")

package/dist/commands/validate.js

@@ -42,11 +42,11 @@ export function registerValidate(program) {
                 console.log(`${icon} ${sp}`);
             }
             for (const e of result.errors) {
-                console.log(chalk.red(`  error: ${e.message}${e.path ? ` (${e.path})` : ""}`));
+                console.log(chalk.red(`  ERROR: ${e.message}${e.path ? ` (${e.path})` : ""}`));
             }
             for (const w of result.warnings) {
                 const fn = opts.strict ? chalk.red : chalk.yellow;
-                console.log(fn(`  ${opts.strict ? "error" : "warn"}: ${w.message}${w.path ? ` (${w.path})` : ""}`));
+                console.log(fn(`  ${opts.strict ? "ERROR" : "WARN"}: ${w.message}${w.path ? ` (${w.path})` : ""}`));
             }
             if (verbose) {
                 console.log(chalk.dim(`  ${result.errors.length} error(s), ${result.warnings.length} warning(s)`));

package/dist/commands/watch.js

@@ -66,11 +66,11 @@ function printValidateResults(label, result, strict) {
     const icon = effectiveValid ? chalk.green("✓") : chalk.red("✗");
     console.log(`  ${chalk.cyan("validate")} ${icon} ${label}`);
     for (const e of result.errors) {
-        console.log(chalk.red(`    error: ${e.message}${e.path ? ` (${e.path})` : ""}`));
+        console.log(chalk.red(`    ERROR: ${e.message}${e.path ? ` (${e.path})` : ""}`));
     }
     for (const w of result.warnings) {
         const fn = strict ? chalk.red : chalk.yellow;
-        const tag = strict ? "error" : "warn";
+        const tag = strict ? "ERROR" : "WARN";
         console.log(fn(`    ${tag}: ${w.message}${w.path ? ` (${w.path})` : ""}`));
     }
 }

package/dist/lib/discovery.js

@@ -38,7 +38,7 @@ export async function loadConfig(workspaceRoot, configPath) {
     if (!existsSync(cfgPath))
         return null;
     const raw = await readFile(cfgPath, "utf-8");
-    const parsed = yaml.load(raw);
+    const parsed = yaml.load(raw, { schema: yaml.JSON_SCHEMA });
     if (!parsed || typeof parsed !== "object")
         return null;
     const config = {};

package/dist/lib/parser.js

@@ -32,7 +32,7 @@ export function parseSidecarContent(content, filenameHint) {
     }
     else {
         try {
-            parsed = yaml.load(trimmed);
+            parsed = yaml.load(trimmed, { schema: yaml.JSON_SCHEMA });
         }
         catch (e) {
             throw new Error(`Failed to parse YAML: ${e.message}`);
@@ -74,7 +74,7 @@ export function parseSidecarContentLenient(content, filenameHint) {
     // First, try a normal parse
     let parsed;
     try {
-        parsed = isJson ? JSON.parse(trimmed) : yaml.load(trimmed);
+        parsed = isJson ? JSON.parse(trimmed) : yaml.load(trimmed, { schema: yaml.JSON_SCHEMA });
     }
     catch (e) {
         // Total parse failure — try to salvage what we can from YAML
@@ -143,7 +143,7 @@ function salvageYaml(content) {
             continue;
         // Wrap in a minimal YAML array context and try to parse
         try {
-            const parsed = yaml.load(trimmed);
+            const parsed = yaml.load(trimmed, { schema: yaml.JSON_SCHEMA });
             if (Array.isArray(parsed) && parsed.length > 0) {
                 const c = parsed[0];
                 if (c && typeof c === "object" && typeof c.id === "string") {

package/dist/lib/validator.js

@@ -16,8 +16,11 @@ async function loadSchema() {
     if (_schemaCache)
         return _schemaCache;
     // The schema lives at the repo root, two levels up from dist/lib/
+    // When installed as a package, it's at the package root (cli/)
     const candidates = [
-        path.resolve(__dirname, "../../../mrsf.schema.json"), // from dist/lib/
+        path.resolve(__dirname, "mrsf.schema.json"), // same dir (esbuild bundle, e.g. MCP server)
+        path.resolve(__dirname, "../../mrsf.schema.json"), // from dist/lib/ → cli/ (installed package)
+        path.resolve(__dirname, "../../../mrsf.schema.json"), // from dist/lib/ → repo root (dev)
         path.resolve(__dirname, "../../../../mrsf.schema.json"), // fallback
         path.resolve(process.cwd(), "mrsf.schema.json"), // cwd fallback
     ];

package/dist/lib/writer.js

@@ -107,6 +107,8 @@ const COMMENT_KEY_ORDER = [
  * double-quoted via JSON.stringify, which is always valid YAML.
  */
 function valueToSource(v) {
+    if (v instanceof Date)
+        return JSON.stringify(v.toISOString());
     if (typeof v === "number" || typeof v === "boolean")
         return String(v);
     if (typeof v === "string") {

package/mrsf.schema.json

@@ -0,0 +1,113 @@
+
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/wictorwilen/MRSF/raw/main/mrsf.schema.json",
+  "title": "Markdown Review Sidecar Format (MRSF) v1.0",
+  "description": "Schema for MRSF review sidecar files. See MRSF-v1.0.md for the full specification.",
+  "type": "object",
+  "required": ["mrsf_version", "document", "comments"],
+  "additionalProperties": true,
+  "properties": {
+    "mrsf_version": {
+      "type": "string",
+      "pattern": "^1\\.\\d+$",
+      "description": "MRSF format version. MUST be a supported major.minor version (e.g., 1.0)."
+    },
+    "document": {
+      "type": "string",
+      "description": "Relative path to the Markdown document being reviewed."
+    },
+    "comments": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "author", "timestamp", "text", "resolved"],
+        "additionalProperties": true,
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Globally unique, opaque, collision-resistant identifier for the comment."
+          },
+          "author": {
+            "type": "string",
+            "description": "Creator of the comment. SHOULD follow the convention 'Display Name (identifier)'."
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO 8601 / RFC 3339 timestamp of comment creation; SHOULD include timezone offset."
+          },
+          "text": {
+            "type": "string",
+            "maxLength": 16384,
+            "description": "The content of the review comment. MUST be plain text."
+          },
+          "resolved": {
+            "type": "boolean",
+            "description": "Whether the comment has been resolved."
+          },
+          "commit": {
+            "type": "string",
+            "description": "Git commit hash associated with the comment. SHOULD be the full (long) SHA."
+          },
+          "type": {
+            "type": "string",
+            "description": "Categorization of the comment. Recommended values listed in examples.",
+            "examples": [
+              "suggestion",
+              "issue",
+              "question",
+              "accuracy",
+              "style",
+              "clarity"
+            ]
+          },
+          "severity": {
+            "type": "string",
+            "description": "Importance level of the comment.",
+            "enum": ["low", "medium", "high"]
+          },
+          "reply_to": {
+            "type": "string",
+            "description": "ID of another comment in the same file that this comment replies to."
+          },
+          "line": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Starting line number (1-based) in the target document."
+          },
+          "end_line": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Ending line number (inclusive, 1-based). MUST be >= line."
+          },
+          "start_column": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Starting column index (0-based) within the starting line."
+          },
+          "end_column": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Ending column index. MUST be >= start_column when on the same line."
+          },
+          "selected_text": {
+            "type": "string",
+            "maxLength": 4096,
+            "description": "Exact text selected by the reviewer. SHOULD NOT be modified by re-anchoring tools. SHOULD NOT exceed 4096 characters."
+          },
+          "anchored_text": {
+            "type": "string",
+            "maxLength": 4096,
+            "description": "Text currently found at the resolved anchor position. Populated by re-anchoring tools when the document text differs from selected_text. SHOULD be omitted when identical to selected_text."
+          },
+          "selected_text_hash": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$",
+            "description": "Hex-encoded SHA-256 hash of selected_text. Immutable after creation; used for fast exact-match detection during re-anchoring, integrity verification, and staleness checks. SHOULD NOT be modified by re-anchoring tools unless selected_text is also replaced (opt-in behaviour), in which case it MUST be recomputed."
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrsf/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "CLI and library for the Markdown Review Sidecar Format (MRSF)",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,8 +31,13 @@
     "review",
     "sidecar",
     "mrsf",
+    "sidemark",
     "anchoring",
-    "comments"
+    "comments",
+    "cli",
+    "yaml",
+    "validation",
+    "reanchor"
   ],
   "license": "MIT",
   "author": "Wictor Wilén (https://github.com/wictorwilen)",
@@ -48,6 +53,7 @@
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts",
+    "mrsf.schema.json",
     "README.md",
     "LICENSE"
   ],
@@ -66,6 +72,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.13.10",
     "@types/uuid": "^10.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
     "typescript": "^5.8.2",
     "vitest": "^3.0.9"
   }