co-maintainer 0.5.0-beta.1 → 0.5.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Murat Kirazkaya
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Murat Kirazkaya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -91,14 +91,14 @@ the PRs are kept as defect-free controls, so precision is measurable too, not
 just recall. Full breakdown, per-PR results, and methodology:
 [`benchmark/core_v3/README.md`](benchmark/core_v3/README.md).
 
-| metric        | value                         | context                     |
-| ------------- | ----------------------------- | --------------------------- |
-| PRs reviewed  | 30 (14 defective, 16 control) | one target repo             |
-| F1            | 0.500                         | against seeded defects only |
-| Precision     | 0.353                         | 1.00 on the control PRs     |
-| Recall        | 0.857                         | 12 of 14 defects found      |
-| Avg cost / PR | $0.0045                       | low and high model together |
-| Avg time / PR | 28.9s                         | sequential, no concurrency  |
+| metric        | value                         | context                            |
+| ------------- | ----------------------------- | ---------------------------------- |
+| PRs reviewed  | 30 (14 defective, 16 control) | one target repo                    |
+| F1            | 0.500                         | against seeded defects only        |
+| Precision     | 0.353                         | 1.00 false positive per control PR |
+| Recall        | 0.857                         | 12 of 14 defects found             |
+| Avg cost / PR | $0.0045                       | low and high model together        |
+| Avg time / PR | 28.9s                         | sequential, no concurrency         |
 
 ## Development
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "co-maintainer",
-    "version": "0.5.0-beta.1",
+    "version": "0.5.0",
     "description": "An imitator of yours, A PR review tool like co-maintainer.",
     "keywords": [
         "ai",

package/dist/src/cli/args.js

@@ -164,7 +164,7 @@ export async function parseArgs(args) {
             arg === "--only-request-changed-pr")
             continue;
         if (arg.startsWith("--") && !known)
-            die(unknownOptionMessage(arg));
+            die(unknownOptionMessage(arg, command));
     }
     const explicitAi = rest.some((arg) => arg.startsWith("--ai="));
     const configuredAiRaw = env("CO_MAINTAINER_AI") ?? repoConfig.ai ?? config.ai;

package/dist/src/cli/commands/registry.d.ts

@@ -46,8 +46,13 @@ export declare function levenshtein(a: string, b: string): number;
 export declare function closest(input: string, candidates: string[], maxDistance?: number): string | undefined;
 /** `prob` becomes `Unknown command: prob. Did you mean probe?`. */
 export declare function unknownCommandMessage(input: string): string;
-/** `--jsno` becomes `Unknown option: --jsno. Did you mean --json?`. */
-export declare function unknownOptionMessage(input: string): string;
+/** `--jsno` becomes `Unknown option: --jsno. Did you mean --json?`.
+ *
+ * When `command` is given the suggestion is drawn only from that command's own
+ * flags, so `review --review-blocking` cannot suggest a flag only `set` takes
+ * (N01, found in the beta run). Without a command the whole surface is fair
+ * game, which is all `view` and generic parsers need. */
+export declare function unknownOptionMessage(input: string, command?: string): string;
 /** The global help: every visible command with its one-line summary. */
 export declare function renderGlobalHelp(): string;
 /** One command's help: usage, flags grouped, examples, docs link. */

package/dist/src/cli/commands/registry.js

@@ -620,10 +620,18 @@ export function unknownCommandMessage(input) {
         ? `Unknown command: ${input}. Did you mean ${suggestion}?`
         : `Unknown command: ${input}`;
 }
-/** `--jsno` becomes `Unknown option: --jsno. Did you mean --json?`. */
-export function unknownOptionMessage(input) {
+/** `--jsno` becomes `Unknown option: --jsno. Did you mean --json?`.
+ *
+ * When `command` is given the suggestion is drawn only from that command's own
+ * flags, so `review --review-blocking` cannot suggest a flag only `set` takes
+ * (N01, found in the beta run). Without a command the whole surface is fair
+ * game, which is all `view` and generic parsers need. */
+export function unknownOptionMessage(input, command) {
     const flag = input.replace(/^--?/, "").split("=")[0] ?? "";
-    const candidates = COMMANDS.flatMap((command) => command.groups.flatMap((group) => group.flags.map((spec) => spec.name)));
+    const scoped = command === undefined ? undefined : findCommand(command);
+    const candidates = scoped
+        ? scoped.groups.flatMap((group) => group.flags.map((spec) => spec.name))
+        : COMMANDS.flatMap((command) => command.groups.flatMap((group) => group.flags.map((spec) => spec.name)));
     const suggestion = closest(flag, [...new Set(candidates)]);
     return suggestion
         ? `Unknown option: ${input}. Did you mean --${suggestion}?`
@@ -679,6 +687,11 @@ export function renderCommandHelp(name) {
     }
     return lines.join("\n");
 }
+/** A Markdown table cell cannot hold a raw `|`, or the column splits. Escaping
+ * it keeps values such as `--auth=gh|pat` in one cell. */
+function cell(text) {
+    return text.replace(/\|/g, "\\|");
+}
 /** The registry as markdown, so CORE-81 can build the command reference from
  * the same data the runtime help uses. */
 export function registryToMarkdown() {
@@ -704,7 +717,7 @@ export function registryToMarkdown() {
                 const flagCell = flag.value
                     ? `--${flag.name}=${flag.value}`
                     : `--${flag.name}`;
-                lines.push(`| \`${flagCell}\` | ${flag.default ?? ""} | ${flag.description} |`);
+                lines.push(`| \`${cell(flagCell)}\` | ${cell(flag.default ?? "")} | ${cell(flag.description)} |`);
             }
         }
         lines.push("");

package/dist/src/cli/commands/view.js

@@ -152,7 +152,7 @@ export async function runView(args) {
     for (const arg of args) {
         if (arg.startsWith("--") &&
             !["--list", "--path", "--remote", "--help", "-h"].includes(arg)) {
-            throw new CliError("usage", unknownOptionMessage(arg));
+            throw new CliError("usage", unknownOptionMessage(arg, "view"));
         }
     }
     // The directory belongs to this machine, so it cannot answer for a server.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "co-maintainer",
-  "version": "0.5.0-beta.1",
+  "version": "0.5.0",
   "description": "An imitator of yours, A PR review tool like co-maintainer.",
   "keywords": [
     "ai",