@agllama/mcp 0.6.27 → 0.7.1

package/dist/tools/notificationRules.d.ts

@@ -27,6 +27,7 @@ export declare const manageNotificationRuleToolSchema: z.ZodObject<{
     projectId?: string | undefined;
     orgSlug?: string | undefined;
     description?: string | undefined;
+    assigneeIds?: string | undefined;
     name?: string | undefined;
     ruleId?: string | undefined;
     integrationId?: string | undefined;
@@ -36,7 +37,6 @@ export declare const manageNotificationRuleToolSchema: z.ZodObject<{
     deliveryConfig?: string | undefined;
     labelTriggers?: string | undefined;
     statusIds?: string | undefined;
-    assigneeIds?: string | undefined;
     issueTypes?: string | undefined;
     priorities?: string | undefined;
     issueIds?: string | undefined;
@@ -47,6 +47,7 @@ export declare const manageNotificationRuleToolSchema: z.ZodObject<{
     projectId?: string | undefined;
     orgSlug?: string | undefined;
     description?: string | undefined;
+    assigneeIds?: string | undefined;
     name?: string | undefined;
     ruleId?: string | undefined;
     integrationId?: string | undefined;
@@ -56,7 +57,6 @@ export declare const manageNotificationRuleToolSchema: z.ZodObject<{
     deliveryConfig?: string | undefined;
     labelTriggers?: string | undefined;
     statusIds?: string | undefined;
-    assigneeIds?: string | undefined;
     issueTypes?: string | undefined;
     priorities?: string | undefined;
     issueIds?: string | undefined;

package/dist/tools/prScorer.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const getPrScorerSchemaToolName = "llama_get_pr_scorer_schema";
+export declare const getPrScorerSchemaToolDescription = "# PR Scorer Rule Language \u2014 Full DSL Reference\n\nPR Scorer rules let you automatically adjust the quality score of a pull\nrequest based on its content, metadata, and linked issues. Each rule is a\nsingle line that conditionally adds or subtracts points and optionally\nattaches a human-readable reason and flag label.\n\n---\n\n## Grammar (EBNF)\n\n```\nruleset   := rule*\nrule      := 'when' expr 'then' SignedInt ( 'reason' STRING )? ( 'flag' STRING )?\nSignedInt := ( '+' | '-' ) INTEGER   // range: [-10, +10] inclusive\nSTRING    := '\"' [^\"]* '\"'\n```\n\nBlank lines and lines beginning with `#` are treated as comments and are\nsilently ignored. Rules are evaluated in order; all matching rules fire\n(scores accumulate \u2014 there is no early-exit).\n\n### Hard limits\n\n| Constraint | Value |\n|---|---|\n| Maximum rules per ruleset | 100 |\n| Maximum nested any() / all() / count(lambda) depth | 8 |\n| Score per rule action | [-10, +10] |\n\n---\n\n## Evaluation Context \u2014 Variables\n\nEvery rule's `expr` can reference the following variables.  All property\naccesses are null-safe: accessing a missing property returns `null` (which\nis falsy).\n\n### Top-level PR fields\n\n| Variable | Type | Description |\n|---|---|---|\n| `pr.id` | number | Pull request id (provider-native, e.g. ADO `pullRequestId`) |\n| `pr.title` | string | Pull request title |\n| `pr.description` | string | PR body / description |\n| `pr.author` | string | Display name (or unique name) of the PR author |\n| `pr.lastUpdated` | ISO-8601 string | Timestamp of last update |\n| `pr.isDraft` | boolean | `true` when the PR is in draft state |\n| `pr.filesChanged` | number | Total count of changed files in the PR |\n| `pr.commitCount` | number | Total count of commits in the PR |\n| `pr.linesAdded` | number \\| null | Aggregate lines added across the PR (null if the provider didn't return it) |\n| `pr.linesRemoved` | number \\| null | Aggregate lines removed across the PR (null if the provider didn't return it) |\n\n> The aggregate fields above are the cheapest signals for \"this PR is large.\"\n> Per-file line counts are not available from ADO, so prefer\n> `pr.filesChanged > 50` or `pr.linesAdded > 1000` over file-level thresholds.\n\n### Files\n\n`files` is an array of file-change objects.\n\n| Property | Type | Description |\n|---|---|---|\n| `path` | string | File path relative to repo root |\n| `additions` | number | Lines added in this file |\n| `deletions` | number | Lines deleted in this file |\n| `isBinary` | boolean | `true` if the file is binary |\n\nUse `files.length` or `files.count()` to count total changed files.\n\n> **Provider caveat (Azure DevOps):** the ADO `/stats` endpoint does not\n> return per-file line counts, so `additions` and `deletions` are `0`\n> for every file and `isBinary` is `false`. Rules should match on\n> `path` for ADO PRs and avoid line-count thresholds.\n\n### Commits\n\n`commits` is an array of commit objects.\n\n| Property | Type | Description |\n|---|---|---|\n| `message` | string | Commit message |\n| `author` | string | Commit author username |\n| `date` | ISO-8601 string | Commit timestamp |\n\nUse `commits.length` or `commits.count()` to count total commits.\n\n> **Provider note (Azure DevOps):** commit messages are fetched for every\n> PR and exposed via `commits[].message`. Per-commit `author` and\n> `date` are populated from the PR author and `pr.lastUpdated`\n> respectively, since ADO does not return per-commit metadata cheaply.\n\n### Labels\n\n`labels` is an array of strings (the label names applied to the PR).\nUse `\"bug\" in labels` to check membership.\n\n### Reviewers\n\n`reviewers` is an array of strings \u2014 the display name (falling back to\nunique name) of each reviewer. To check whether a particular reviewer is\npresent, use `\"alice\" in reviewers` or `reviewers.any(r -> r == \"alice\")`.\n\n> **Note:** reviewer approval state is not currently exposed in the\n> evaluation context. A rule cannot distinguish approved vs. pending\n> reviewers; it can only count or name-match them.\n\n### Issue link fields\n\n| Variable | Type | Description |\n|---|---|---|\n| `hasLinkedIssue` | boolean | `true` when at least one issue is linked |\n| `linkedIssueKeys` | string[] | Array of linked issue keys (e.g. `[\"PROJ-42\"]`) |\n\n---\n\n## Operators\n\n### Comparison\n\n| Operator | Meaning | Example |\n|---|---|---|\n| `==` | Equal | `pr.isDraft == true` |\n| `!=` | Not equal | `pr.author != \"bot\"` |\n| `>` | Greater than | `files.count() > 20` |\n| `>=` | Greater than or equal | `files.count() >= 10` |\n| `<` | Less than | `commits.count() < 3` |\n| `<=` | Less than or equal | `reviewers.count() <= 1` |\n| `in` | Array or substring membership | `\"bug\" in labels` |\n\n### Logical\n\n| Operator | Precedence (lower = binds tighter) |\n|---|---|\n| `!` (unary not) | 1 |\n| `&&` (and) | 2 |\n| `||` (or) | 3 |\n\nParentheses may be used to override precedence: `(a || b) && c`.\n\n---\n\n## Built-in Functions\n\n### Array methods\n\nCalled on an array variable with dot notation. `any`/`all`/`count(lambda)`\ntake a lambda `x -> expr`.\n\n| Method | Signature | Description |\n|---|---|---|\n| `.any()` | `array.any(x -> expr)` | Returns `true` if **any** element satisfies `expr` |\n| `.all()` | `array.all(x -> expr)` | Returns `true` if **all** elements satisfy `expr` |\n| `.count()` | `array.count()` *or* `array.count(x -> expr)` | Element count; with a predicate, counts matching elements |\n| `.length` | `array.length` | Element count (no parens; identical to `.count()`) |\n\n### String methods\n\n| Method | Signature | Description |\n|---|---|---|\n| `.matches(re)` | `str.matches(string)` | Returns `true` if `str` matches the RE2 regex `re`. **RE2 syntax \u2014 not JS regex.** |\n| `.startsWith(prefix)` | `str.startsWith(string)` | Prefix check |\n| `.endsWith(suffix)` | `str.endsWith(string)` | Suffix check |\n| `.length` | `str.length` | Character length |\n\n> **RE2 note:** RE2 does not support lookaheads (`(?=...)`), lookbehinds\n> (`(?<=...)`), or backreferences (`\\1`). Use character classes and\n> quantifiers instead. String contents are passed to RE2 **verbatim** \u2014\n> write a single backslash where you would write one in a regex literal.\n\n### Free functions\n\n| Function | Signature | Description |\n|---|---|---|\n| `pathMatches(path, pattern)` | `pathMatches(string, string)` | Glob match. `**` = recursive dir wildcard, `*` = single-segment wildcard. |\n| `daysAgo(dateStr)` | `daysAgo(string) -> number` | Whole days between `dateStr` (ISO-8601) and now. Returns `Infinity` if unparseable. |\n\n---\n\n## String Interpolation\n\nReason and flag strings support `${...}` interpolation. Only simple dotted\npaths are allowed inside the braces \u2014 no method calls or arithmetic.\n\n```\nwhen files.count() > 4 then +1 reason \"${files.length} files touched\"\nwhen commits.count() > 10 then -1 reason \"noisy: ${commits.length} commits\"\n```\n\n---\n\n## Runnable Examples\n\n### Example 1 \u2014 Reward test coverage, penalise env-file touches\n\n```\n# +1 if the PR includes any test files\nwhen files.any(f -> pathMatches(f.path, \"**/*.test.ts\")) then +1 reason \"has tests\"\n\n# -5 and flag when .env files are touched (security risk)\nwhen files.any(f -> pathMatches(f.path, \"**/.env*\")) then -5 reason \"touches env\" flag \"env-file\"\n```\n\n### Example 2 \u2014 Multi-condition ruleset\n\n```\n# Draft PRs get a small penalty\nwhen pr.isDraft == true then -1 reason \"draft PR\"\n\n# Large PRs are harder to review\nwhen files.count() > 30 then -2 reason \"large diff \u2014 consider splitting\"\n\n# Bonus for linking an issue\nwhen hasLinkedIssue == true then +1 reason \"linked to tracked issue\"\n\n# At least one reviewer assigned\nwhen reviewers.count() > 0 then +1 reason \"has reviewers\"\n\n# Migration SQL is high-risk\nwhen files.count(f -> pathMatches(f.path, \"**/migrations/**/*.sql\")) > 0 then -3 reason \"migration SQL\" flag \"schema-change\"\n\n# Stale PR \u2014 open longer than a week\nwhen daysAgo(pr.lastUpdated) > 7 then -1 reason \"stale PR\"\n\n# Title check \u2014 must not be a bare word (RE2 syntax)\nwhen pr.title.matches(\"^fix$\") then -1 reason \"title too vague\"\n```\n\n---\n\n## Return Type for Parse Errors\n\nWhen `llama_set_pr_scorer_rules` receives a syntactically invalid ruleset,\nit returns a **structured** parse-error array \u2014 not a flattened string \u2014 so\nClaude can identify and fix individual lines:\n\n```json\n{\n  \"success\": false,\n  \"parseErrors\": [\n    { \"line\": 3, \"column\": 12, \"message\": \"Expected 'then' keyword\" },\n    { \"line\": 7, \"column\": 1,  \"message\": \"Score +15 exceeds maximum of +10\" }\n  ]\n}\n```\n\nFix each error by its `line` + `column` and resubmit.\n";
+export declare const getPrScorerSchemaToolSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetPrScorerSchemaToolInput = z.infer<typeof getPrScorerSchemaToolSchema>;
+export declare function executeGetPrScorerSchema(): Promise<string>;
+export declare const getPrScorerRulesToolName = "llama_get_pr_scorer_rules";
+export declare const getPrScorerRulesToolDescription: string;
+export declare const getPrScorerRulesToolSchema: z.ZodObject<{
+    orgSlug: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}, {
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}>;
+export type GetPrScorerRulesToolInput = z.infer<typeof getPrScorerRulesToolSchema>;
+export declare function executeGetPrScorerRules(input: GetPrScorerRulesToolInput): Promise<string>;
+export declare const setPrScorerRulesToolName = "llama_set_pr_scorer_rules";
+export declare const setPrScorerRulesToolDescription: string;
+export declare const setPrScorerRulesToolSchema: z.ZodObject<{
+    orgSlug: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+    source: z.ZodString;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+    enabled?: boolean | undefined;
+}, {
+    source: string;
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+    enabled?: boolean | undefined;
+}>;
+export type SetPrScorerRulesToolInput = z.infer<typeof setPrScorerRulesToolSchema>;
+export declare function executeSetPrScorerRules(input: SetPrScorerRulesToolInput): Promise<string>;
+//# sourceMappingURL=prScorer.d.ts.map

package/dist/tools/prScorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prScorer.d.ts","sourceRoot":"","sources":["../../src/tools/prScorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE,eAAO,MAAM,gCAAgC,soRAA0B,CAAC;AAExE,eAAO,MAAM,2BAA2B,gDAAe,CAAC;AAExD,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAErF,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhE;AAMD,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AAEpE,eAAO,MAAM,+BAA+B,QAGU,CAAC;AAEvD,eAAO,MAAM,0BAA0B;;;;;;;;;EASrC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAcnF,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAsDjB;AAMD,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AAEpE,eAAO,MAAM,+BAA+B,QAKiD,CAAC;AAE9F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAgBrC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAQnF,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAuFjB"}

package/dist/tools/prScorer.js

@@ -0,0 +1,182 @@
+import { z } from 'zod';
+import { getApiClient, LlamaApiError } from '../api-client.js';
+import { getSessionDefaults } from './session.js';
+import { PR_SCORER_DSL_REFERENCE } from './prScorerSchema.js';
+// ============================================
+// llama_get_pr_scorer_schema
+// ============================================
+export const getPrScorerSchemaToolName = 'llama_get_pr_scorer_schema';
+export const getPrScorerSchemaToolDescription = PR_SCORER_DSL_REFERENCE;
+export const getPrScorerSchemaToolSchema = z.object({});
+export async function executeGetPrScorerSchema() {
+    return PR_SCORER_DSL_REFERENCE;
+}
+// ============================================
+// llama_get_pr_scorer_rules
+// ============================================
+export const getPrScorerRulesToolName = 'llama_get_pr_scorer_rules';
+export const getPrScorerRulesToolDescription = 'Get the current PR Scorer ruleset for a project. Returns the DSL source text, ' +
+    'whether scoring is enabled, and metadata. Use llama_get_pr_scorer_schema to understand ' +
+    'the rule language before reading or editing rules.';
+export const getPrScorerRulesToolSchema = z.object({
+    orgSlug: z
+        .string()
+        .optional()
+        .describe('Organization slug (session default)'),
+    projectKey: z
+        .string()
+        .optional()
+        .describe('Project key (session default)'),
+});
+export async function executeGetPrScorerRules(input) {
+    try {
+        const session = await getSessionDefaults();
+        const orgSlug = input.orgSlug ?? session?.orgSlug;
+        const projectKey = input.projectKey ?? session?.projectKey;
+        if (!orgSlug) {
+            return JSON.stringify({
+                success: false,
+                error: 'orgSlug is required. Either provide it or set session context with llama_set_context first.',
+            });
+        }
+        if (!projectKey) {
+            return JSON.stringify({
+                success: false,
+                error: 'projectKey is required. Either provide it or set session context with llama_set_context first.',
+            });
+        }
+        const client = getApiClient();
+        try {
+            await client.recordToolCall('llama_get_pr_scorer_rules', { orgSlug, projectKey });
+        }
+        catch {
+            // Ignore recording errors
+        }
+        const data = await client.get(`/organizations/${orgSlug}/projects/${projectKey}/pr-scorer/rules`);
+        return JSON.stringify({
+            success: true,
+            orgSlug,
+            projectKey,
+            source: data.rules?.source ?? '',
+            enabled: data.enabled,
+            updatedById: data.updatedById ?? null,
+            historyLength: data.history?.length ?? 0,
+        });
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to get PR scorer rules: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+// ============================================
+// llama_set_pr_scorer_rules
+// ============================================
+export const setPrScorerRulesToolName = 'llama_set_pr_scorer_rules';
+export const setPrScorerRulesToolDescription = 'Install or replace the PR Scorer ruleset for a project. Provide DSL source text; ' +
+    'the server validates the syntax before saving. On parse failure the response contains a ' +
+    'structured parseErrors array — NOT a flattened string — so each error can be pinpointed ' +
+    'and fixed by line/column. Call llama_get_pr_scorer_schema to learn the DSL grammar before ' +
+    'authoring rules. Tip: start with the runnable examples in the schema doc, then customise.';
+export const setPrScorerRulesToolSchema = z.object({
+    orgSlug: z
+        .string()
+        .optional()
+        .describe('Organization slug (session default)'),
+    projectKey: z
+        .string()
+        .optional()
+        .describe('Project key (session default)'),
+    source: z
+        .string()
+        .describe('Full PR Scorer ruleset in DSL source text. Must be valid per the grammar returned by llama_get_pr_scorer_schema.'),
+    enabled: z
+        .boolean()
+        .optional()
+        .describe('Whether PR scoring is active for this project. Preserves existing value when not supplied; defaults to false on first save.'),
+});
+export async function executeSetPrScorerRules(input) {
+    try {
+        const session = await getSessionDefaults();
+        const orgSlug = input.orgSlug ?? session?.orgSlug;
+        const projectKey = input.projectKey ?? session?.projectKey;
+        if (!orgSlug) {
+            return JSON.stringify({
+                success: false,
+                error: 'orgSlug is required. Either provide it or set session context with llama_set_context first.',
+            });
+        }
+        if (!projectKey) {
+            return JSON.stringify({
+                success: false,
+                error: 'projectKey is required. Either provide it or set session context with llama_set_context first.',
+            });
+        }
+        const client = getApiClient();
+        try {
+            await client.recordToolCall('llama_set_pr_scorer_rules', {
+                orgSlug,
+                projectKey,
+                sourceLength: input.source.length,
+            });
+        }
+        catch {
+            // Ignore recording errors
+        }
+        const data = await client.put(`/organizations/${orgSlug}/projects/${projectKey}/pr-scorer/rules`, {
+            source: input.source,
+            ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),
+        });
+        return JSON.stringify({
+            success: true,
+            orgSlug,
+            projectKey,
+            source: data.rules?.source ?? '',
+            enabled: data.enabled,
+            updatedById: data.updatedById ?? null,
+            message: 'PR Scorer rules saved successfully.',
+        });
+    }
+    catch (error) {
+        // Surface parse errors as a structured array using err.details (set by api-client
+        // from the raw response body). No JSON.parse of message strings needed.
+        if (error instanceof LlamaApiError && error.statusCode === 400) {
+            if (Array.isArray(error.details)) {
+                const parseErrors = error.details.map((d) => ({
+                    line: typeof d.line === 'number' ? d.line : 0,
+                    column: typeof d.column === 'number' ? d.column : 0,
+                    message: typeof d.message === 'string' ? d.message : String(d.message ?? ''),
+                }));
+                return JSON.stringify({
+                    success: false,
+                    parseErrors,
+                });
+            }
+            return JSON.stringify({
+                success: false,
+                error: `Failed to save PR scorer rules: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to save PR scorer rules: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+//# sourceMappingURL=prScorer.js.map

package/dist/tools/prScorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prScorer.js","sourceRoot":"","sources":["../../src/tools/prScorer.ts"],"names":[],"mappings":"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"}

package/dist/tools/prScorerHistory.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export declare const testPrScorerToolName = "llama_test_pr_scorer";
+export declare const testPrScorerToolDescription: string;
+export declare const testPrScorerToolSchema: z.ZodObject<{
+    orgSlug: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+    source: z.ZodString;
+    prId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    prId: string;
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}, {
+    source: string;
+    prId: string;
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}>;
+export type TestPrScorerToolInput = z.infer<typeof testPrScorerToolSchema>;
+export declare function executeTestPrScorer(input: TestPrScorerToolInput): Promise<string>;
+export declare const listPrScorerHistoryToolName = "llama_list_pr_scorer_history";
+export declare const listPrScorerHistoryToolDescription: string;
+export declare const listPrScorerHistoryToolSchema: z.ZodObject<{
+    orgSlug: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}, {
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}>;
+export type ListPrScorerHistoryToolInput = z.infer<typeof listPrScorerHistoryToolSchema>;
+export declare function executeListPrScorerHistory(input: ListPrScorerHistoryToolInput): Promise<string>;
+export declare const revertPrScorerToolName = "llama_revert_pr_scorer";
+export declare const revertPrScorerToolDescription: string;
+export declare const revertPrScorerToolSchema: z.ZodObject<{
+    orgSlug: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+    historyIndex: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    historyIndex: number;
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}, {
+    historyIndex: number;
+    orgSlug?: string | undefined;
+    projectKey?: string | undefined;
+}>;
+export type RevertPrScorerToolInput = z.infer<typeof revertPrScorerToolSchema>;
+export declare function executeRevertPrScorer(input: RevertPrScorerToolInput): Promise<string>;
+//# sourceMappingURL=prScorerHistory.d.ts.map

package/dist/tools/prScorerHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prScorerHistory.d.ts","sourceRoot":"","sources":["../../src/tools/prScorerHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,eAAO,MAAM,2BAA2B,QAQwF,CAAC;AAEjI,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAoBjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAgB3E,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAqEjB;AAMD,eAAO,MAAM,2BAA2B,iCAAiC,CAAC;AAE1E,eAAO,MAAM,kCAAkC,QAIwC,CAAC;AAExF,eAAO,MAAM,6BAA6B;;;;;;;;;EASxC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAUzF,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAMD,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,eAAO,MAAM,6BAA6B,QAIkD,CAAC;AAE7F,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAgBnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgDjB"}

package/dist/tools/prScorerHistory.js

@@ -0,0 +1,251 @@
+import { z } from 'zod';
+import { getApiClient, LlamaApiError } from '../api-client.js';
+import { getSessionDefaults } from './session.js';
+// ============================================
+// Shared context helper
+// ============================================
+async function resolveContext(orgSlug, projectKey) {
+    const session = await getSessionDefaults();
+    const resolvedOrg = orgSlug ?? session?.orgSlug;
+    const resolvedProject = projectKey ?? session?.projectKey;
+    if (!resolvedOrg) {
+        return {
+            error: 'orgSlug is required. Either provide it or set session context with llama_set_context first.',
+        };
+    }
+    if (!resolvedProject) {
+        return {
+            error: 'projectKey is required. Either provide it or set session context with llama_set_context first.',
+        };
+    }
+    return { orgSlug: resolvedOrg, projectKey: resolvedProject };
+}
+// ============================================
+// llama_test_pr_scorer
+// ============================================
+export const testPrScorerToolName = 'llama_test_pr_scorer';
+export const testPrScorerToolDescription = 'Dry-run a PR Scorer ruleset against a real PR without saving the rules. ' +
+    'Returns the full evaluation result including score, grade, reasons, flags, and a per-rule trace. ' +
+    'Use this to validate new or edited rules before calling llama_set_pr_scorer_rules.\n\n' +
+    'prId format: "<adoRepoId>:<prNumber>" (e.g. "abc123-def-456:42"). ' +
+    'These composite IDs are returned by the GET /pr-scorer/recent-prs endpoint that the editor dry-run pane uses; ' +
+    'they are NOT the DevLink UUID and NOT the bare ADO PR number.\n\n' +
+    'trace[] contains one entry per rule: { ruleIndex, matched, delta, reason?, flag? }. ' +
+    'Use trace to explain why a specific rule fired or did not fire (e.g. delta=0 + matched=false means the condition was false).';
+export const testPrScorerToolSchema = z.object({
+    orgSlug: z
+        .string()
+        .optional()
+        .describe('Organization slug (session default)'),
+    projectKey: z
+        .string()
+        .optional()
+        .describe('Project key (session default)'),
+    source: z
+        .string()
+        .describe('DSL rules to test. May differ from the currently saved ruleset — this is a dry run.'),
+    prId: z
+        .string()
+        .describe('Composite ADO PR id in the format "<adoRepoId>:<prNumber>" (e.g. "abc123-def-456:42"). ' +
+        'Obtain from GET /pr-scorer/recent-prs. NOT the DevLink UUID.'),
+});
+export async function executeTestPrScorer(input) {
+    try {
+        const ctx = await resolveContext(input.orgSlug, input.projectKey);
+        if ('error' in ctx) {
+            return JSON.stringify({ success: false, error: ctx.error });
+        }
+        const client = getApiClient();
+        try {
+            await client.recordToolCall('llama_test_pr_scorer', {
+                orgSlug: ctx.orgSlug,
+                projectKey: ctx.projectKey,
+                prId: input.prId,
+                sourceLength: input.source.length,
+            });
+        }
+        catch {
+            // Ignore recording errors
+        }
+        const data = await client.postPrScorerTest(ctx.orgSlug, ctx.projectKey, input.source, input.prId);
+        return JSON.stringify({
+            success: true,
+            orgSlug: ctx.orgSlug,
+            projectKey: ctx.projectKey,
+            prId: input.prId,
+            score: data.score,
+            grade: data.grade,
+            reasons: data.reasons ?? [],
+            flags: data.flags ?? [],
+            trace: (data.trace ?? []),
+        });
+    }
+    catch (error) {
+        // Surface parse errors the same way as llama_set_pr_scorer_rules
+        if (error instanceof LlamaApiError && error.statusCode === 400) {
+            if (Array.isArray(error.details)) {
+                const parseErrors = error.details.map((d) => ({
+                    line: typeof d.line === 'number' ? d.line : 0,
+                    column: typeof d.column === 'number' ? d.column : 0,
+                    message: typeof d.message === 'string' ? d.message : String(d.message ?? ''),
+                }));
+                return JSON.stringify({ success: false, parseErrors });
+            }
+            return JSON.stringify({
+                success: false,
+                error: `PR scorer test failed: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `PR scorer test failed: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+// ============================================
+// llama_list_pr_scorer_history
+// ============================================
+export const listPrScorerHistoryToolName = 'llama_list_pr_scorer_history';
+export const listPrScorerHistoryToolDescription = 'List the save history for a project\'s PR Scorer ruleset. ' +
+    'Returns metadata only (timestamps + updatedById); full rule bodies are stripped to keep token cost low. ' +
+    'Entries are ordered most-recent-first; the index of each entry corresponds to the historyIndex ' +
+    'accepted by llama_revert_pr_scorer (0 = most recent save before the current state).';
+export const listPrScorerHistoryToolSchema = z.object({
+    orgSlug: z
+        .string()
+        .optional()
+        .describe('Organization slug (session default)'),
+    projectKey: z
+        .string()
+        .optional()
+        .describe('Project key (session default)'),
+});
+export async function executeListPrScorerHistory(input) {
+    try {
+        const ctx = await resolveContext(input.orgSlug, input.projectKey);
+        if ('error' in ctx) {
+            return JSON.stringify({ success: false, error: ctx.error });
+        }
+        const client = getApiClient();
+        try {
+            await client.recordToolCall('llama_list_pr_scorer_history', {
+                orgSlug: ctx.orgSlug,
+                projectKey: ctx.projectKey,
+            });
+        }
+        catch {
+            // Ignore recording errors
+        }
+        const raw = await client.getPrScorerHistory(ctx.orgSlug, ctx.projectKey);
+        // Strip source + ast fields — return metadata only per spec
+        const entries = (raw ?? []).map((entry, index) => {
+            const meta = {
+                index,
+                savedAt: entry.savedAt,
+            };
+            if (entry.updatedById !== undefined) {
+                meta.updatedById = entry.updatedById;
+            }
+            if (typeof entry.source === 'string') {
+                meta.sourceLineCount = entry.source.split('\n').length;
+                meta.sourceLength = entry.source.length;
+            }
+            return meta;
+        });
+        return JSON.stringify({
+            success: true,
+            orgSlug: ctx.orgSlug,
+            projectKey: ctx.projectKey,
+            count: entries.length,
+            entries,
+        });
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to list PR scorer history: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+// ============================================
+// llama_revert_pr_scorer
+// ============================================
+export const revertPrScorerToolName = 'llama_revert_pr_scorer';
+export const revertPrScorerToolDescription = 'Revert the PR Scorer ruleset to a previous saved version. ' +
+    'historyIndex is 0-indexed from most-recent-first (i.e. 0 = the most recent save before the current state). ' +
+    'Call llama_list_pr_scorer_history first to see available indices and their timestamps. ' +
+    'After a successful revert, call llama_get_pr_scorer_rules to confirm the active ruleset.';
+export const revertPrScorerToolSchema = z.object({
+    orgSlug: z
+        .string()
+        .optional()
+        .describe('Organization slug (session default)'),
+    projectKey: z
+        .string()
+        .optional()
+        .describe('Project key (session default)'),
+    historyIndex: z
+        .number()
+        .int()
+        .min(0)
+        .describe('0-indexed position from most-recent-first history. Use llama_list_pr_scorer_history to find available indices.'),
+});
+export async function executeRevertPrScorer(input) {
+    try {
+        const ctx = await resolveContext(input.orgSlug, input.projectKey);
+        if ('error' in ctx) {
+            return JSON.stringify({ success: false, error: ctx.error });
+        }
+        const client = getApiClient();
+        try {
+            await client.recordToolCall('llama_revert_pr_scorer', {
+                orgSlug: ctx.orgSlug,
+                projectKey: ctx.projectKey,
+                historyIndex: input.historyIndex,
+            });
+        }
+        catch {
+            // Ignore recording errors
+        }
+        const data = await client.postPrScorerRevert(ctx.orgSlug, ctx.projectKey, input.historyIndex);
+        return JSON.stringify({
+            success: true,
+            orgSlug: ctx.orgSlug,
+            projectKey: ctx.projectKey,
+            historyIndex: input.historyIndex,
+            source: data?.rules?.source ?? '',
+            enabled: data?.enabled ?? true,
+            updatedById: data?.updatedById ?? null,
+            message: `PR Scorer ruleset reverted to history index ${input.historyIndex}.`,
+        });
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to revert PR scorer: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+//# sourceMappingURL=prScorerHistory.js.map

package/dist/tools/prScorerHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prScorerHistory.js","sourceRoot":"","sources":["../../src/tools/prScorerHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,+CAA+C;AAC/C,wBAAwB;AACxB,+CAA+C;AAE/C,KAAK,UAAU,cAAc,CAC3B,OAAgB,EAChB,UAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,OAAO,IAAI,OAAO,EAAE,OAAO,CAAC;IAChD,MAAM,eAAe,GAAG,UAAU,IAAI,OAAO,EAAE,UAAU,CAAC;IAE1D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,EAAE,6FAA6F;SACrG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,gGAAgG;SACxG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AAC/D,CAAC;AAED,+CAA+C;AAC/C,uBAAuB;AACvB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,MAAM,CAAC,MAAM,2BAA2B,GACtC,0EAA0E;IAC1E,mGAAmG;IACnG,wFAAwF;IACxF,oEAAoE;IACpE,gHAAgH;IAChH,mEAAmE;IACnE,sFAAsF;IACtF,8HAA8H,CAAC;AAEjI,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+BAA+B,CAAC;IAC5C,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CACP,qFAAqF,CACtF;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,yFAAyF;QACvF,8DAA8D,CACjE;CACJ,CAAC,CAAC;AAkBH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,cAAc,CAAC,sBAAsB,EAAE;gBAClD,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;aAClC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,gBAAgB,CACxC,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,UAAU,EACd,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,IAAI,CACX,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAiB;SAC1C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iEAAiE;QACjE,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,MAAM,WAAW,GAAI,KAAK,CAAC,OAA0C,CAAC,GAAG,CACvE,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC;oBAClB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAC7C,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBACnD,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;iBAC7E,CAAC,CACH,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA0B,KAAK,CAAC,OAAO,EAAE;gBAChD,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA0B,KAAK,CAAC,OAAO,EAAE;gBAChD,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,+BAA+B;AAC/B,+CAA+C;AAE/C,MAAM,CAAC,MAAM,2BAA2B,GAAG,8BAA8B,CAAC;AAE1E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,4DAA4D;IAC5D,0GAA0G;IAC1G,iGAAiG;IACjG,qFAAqF,CAAC;AAExF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAYH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAmC;IAEnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,cAAc,CAAC,8BAA8B,EAAE;gBAC1D,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,UAAU;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAEzE,4DAA4D;QAC5D,MAAM,OAAO,GAAkB,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9D,MAAM,IAAI,GAAgB;gBACxB,KAAK;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC;YACF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACpC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;YACvC,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACrC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;gBACvD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YAC1C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,qCAAqC,KAAK,CAAC,OAAO,EAAE;gBAC3D,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,yBAAyB;AACzB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D,MAAM,CAAC,MAAM,6BAA6B,GACxC,4DAA4D;IAC5D,6GAA6G;IAC7G,yFAAyF;IACzF,0FAA0F,CAAC;AAE7F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+BAA+B,CAAC;IAC5C,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,gHAAgH,CACjH;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA8B;IAE9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,cAAc,CAAC,wBAAwB,EAAE;gBACpD,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;aACjC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAC1C,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,UAAU,EACd,KAAK,CAAC,YAAY,CACnB,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE;YACjC,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;YAC9B,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;YACtC,OAAO,EAAE,+CAA+C,KAAK,CAAC,YAAY,GAAG;SAC9E,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,+BAA+B,KAAK,CAAC,OAAO,EAAE;gBACrD,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/tools/prScorerSchema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Full DSL reference for the PR Scorer rule language.
+ * Exported as a string so it can be embedded in the llama_get_pr_scorer_schema
+ * tool description AND returned as the handler response.
+ *
+ * Spec: LLAMA-1283
+ *
+ * IMPORTANT: This file is the canonical, machine-readable DSL reference. It
+ * MUST match the runtime exposed by packages/pr-scorer-dsl (parser allowed
+ * methods, evaluator lookupName(), and the EvalContext shape assembled in
+ * apps/api/src/services/prScorerDispatcher.service.ts). When you change the
+ * DSL, update this file AND apps/web/src/pages/docs/PrScorerDocsPage.tsx.
+ */
+export declare const PR_SCORER_DSL_REFERENCE = "# PR Scorer Rule Language \u2014 Full DSL Reference\n\nPR Scorer rules let you automatically adjust the quality score of a pull\nrequest based on its content, metadata, and linked issues. Each rule is a\nsingle line that conditionally adds or subtracts points and optionally\nattaches a human-readable reason and flag label.\n\n---\n\n## Grammar (EBNF)\n\n```\nruleset   := rule*\nrule      := 'when' expr 'then' SignedInt ( 'reason' STRING )? ( 'flag' STRING )?\nSignedInt := ( '+' | '-' ) INTEGER   // range: [-10, +10] inclusive\nSTRING    := '\"' [^\"]* '\"'\n```\n\nBlank lines and lines beginning with `#` are treated as comments and are\nsilently ignored. Rules are evaluated in order; all matching rules fire\n(scores accumulate \u2014 there is no early-exit).\n\n### Hard limits\n\n| Constraint | Value |\n|---|---|\n| Maximum rules per ruleset | 100 |\n| Maximum nested any() / all() / count(lambda) depth | 8 |\n| Score per rule action | [-10, +10] |\n\n---\n\n## Evaluation Context \u2014 Variables\n\nEvery rule's `expr` can reference the following variables.  All property\naccesses are null-safe: accessing a missing property returns `null` (which\nis falsy).\n\n### Top-level PR fields\n\n| Variable | Type | Description |\n|---|---|---|\n| `pr.id` | number | Pull request id (provider-native, e.g. ADO `pullRequestId`) |\n| `pr.title` | string | Pull request title |\n| `pr.description` | string | PR body / description |\n| `pr.author` | string | Display name (or unique name) of the PR author |\n| `pr.lastUpdated` | ISO-8601 string | Timestamp of last update |\n| `pr.isDraft` | boolean | `true` when the PR is in draft state |\n| `pr.filesChanged` | number | Total count of changed files in the PR |\n| `pr.commitCount` | number | Total count of commits in the PR |\n| `pr.linesAdded` | number \\| null | Aggregate lines added across the PR (null if the provider didn't return it) |\n| `pr.linesRemoved` | number \\| null | Aggregate lines removed across the PR (null if the provider didn't return it) |\n\n> The aggregate fields above are the cheapest signals for \"this PR is large.\"\n> Per-file line counts are not available from ADO, so prefer\n> `pr.filesChanged > 50` or `pr.linesAdded > 1000` over file-level thresholds.\n\n### Files\n\n`files` is an array of file-change objects.\n\n| Property | Type | Description |\n|---|---|---|\n| `path` | string | File path relative to repo root |\n| `additions` | number | Lines added in this file |\n| `deletions` | number | Lines deleted in this file |\n| `isBinary` | boolean | `true` if the file is binary |\n\nUse `files.length` or `files.count()` to count total changed files.\n\n> **Provider caveat (Azure DevOps):** the ADO `/stats` endpoint does not\n> return per-file line counts, so `additions` and `deletions` are `0`\n> for every file and `isBinary` is `false`. Rules should match on\n> `path` for ADO PRs and avoid line-count thresholds.\n\n### Commits\n\n`commits` is an array of commit objects.\n\n| Property | Type | Description |\n|---|---|---|\n| `message` | string | Commit message |\n| `author` | string | Commit author username |\n| `date` | ISO-8601 string | Commit timestamp |\n\nUse `commits.length` or `commits.count()` to count total commits.\n\n> **Provider note (Azure DevOps):** commit messages are fetched for every\n> PR and exposed via `commits[].message`. Per-commit `author` and\n> `date` are populated from the PR author and `pr.lastUpdated`\n> respectively, since ADO does not return per-commit metadata cheaply.\n\n### Labels\n\n`labels` is an array of strings (the label names applied to the PR).\nUse `\"bug\" in labels` to check membership.\n\n### Reviewers\n\n`reviewers` is an array of strings \u2014 the display name (falling back to\nunique name) of each reviewer. To check whether a particular reviewer is\npresent, use `\"alice\" in reviewers` or `reviewers.any(r -> r == \"alice\")`.\n\n> **Note:** reviewer approval state is not currently exposed in the\n> evaluation context. A rule cannot distinguish approved vs. pending\n> reviewers; it can only count or name-match them.\n\n### Issue link fields\n\n| Variable | Type | Description |\n|---|---|---|\n| `hasLinkedIssue` | boolean | `true` when at least one issue is linked |\n| `linkedIssueKeys` | string[] | Array of linked issue keys (e.g. `[\"PROJ-42\"]`) |\n\n---\n\n## Operators\n\n### Comparison\n\n| Operator | Meaning | Example |\n|---|---|---|\n| `==` | Equal | `pr.isDraft == true` |\n| `!=` | Not equal | `pr.author != \"bot\"` |\n| `>` | Greater than | `files.count() > 20` |\n| `>=` | Greater than or equal | `files.count() >= 10` |\n| `<` | Less than | `commits.count() < 3` |\n| `<=` | Less than or equal | `reviewers.count() <= 1` |\n| `in` | Array or substring membership | `\"bug\" in labels` |\n\n### Logical\n\n| Operator | Precedence (lower = binds tighter) |\n|---|---|\n| `!` (unary not) | 1 |\n| `&&` (and) | 2 |\n| `||` (or) | 3 |\n\nParentheses may be used to override precedence: `(a || b) && c`.\n\n---\n\n## Built-in Functions\n\n### Array methods\n\nCalled on an array variable with dot notation. `any`/`all`/`count(lambda)`\ntake a lambda `x -> expr`.\n\n| Method | Signature | Description |\n|---|---|---|\n| `.any()` | `array.any(x -> expr)` | Returns `true` if **any** element satisfies `expr` |\n| `.all()` | `array.all(x -> expr)` | Returns `true` if **all** elements satisfy `expr` |\n| `.count()` | `array.count()` *or* `array.count(x -> expr)` | Element count; with a predicate, counts matching elements |\n| `.length` | `array.length` | Element count (no parens; identical to `.count()`) |\n\n### String methods\n\n| Method | Signature | Description |\n|---|---|---|\n| `.matches(re)` | `str.matches(string)` | Returns `true` if `str` matches the RE2 regex `re`. **RE2 syntax \u2014 not JS regex.** |\n| `.startsWith(prefix)` | `str.startsWith(string)` | Prefix check |\n| `.endsWith(suffix)` | `str.endsWith(string)` | Suffix check |\n| `.length` | `str.length` | Character length |\n\n> **RE2 note:** RE2 does not support lookaheads (`(?=...)`), lookbehinds\n> (`(?<=...)`), or backreferences (`\\1`). Use character classes and\n> quantifiers instead. String contents are passed to RE2 **verbatim** \u2014\n> write a single backslash where you would write one in a regex literal.\n\n### Free functions\n\n| Function | Signature | Description |\n|---|---|---|\n| `pathMatches(path, pattern)` | `pathMatches(string, string)` | Glob match. `**` = recursive dir wildcard, `*` = single-segment wildcard. |\n| `daysAgo(dateStr)` | `daysAgo(string) -> number` | Whole days between `dateStr` (ISO-8601) and now. Returns `Infinity` if unparseable. |\n\n---\n\n## String Interpolation\n\nReason and flag strings support `${...}` interpolation. Only simple dotted\npaths are allowed inside the braces \u2014 no method calls or arithmetic.\n\n```\nwhen files.count() > 4 then +1 reason \"${files.length} files touched\"\nwhen commits.count() > 10 then -1 reason \"noisy: ${commits.length} commits\"\n```\n\n---\n\n## Runnable Examples\n\n### Example 1 \u2014 Reward test coverage, penalise env-file touches\n\n```\n# +1 if the PR includes any test files\nwhen files.any(f -> pathMatches(f.path, \"**/*.test.ts\")) then +1 reason \"has tests\"\n\n# -5 and flag when .env files are touched (security risk)\nwhen files.any(f -> pathMatches(f.path, \"**/.env*\")) then -5 reason \"touches env\" flag \"env-file\"\n```\n\n### Example 2 \u2014 Multi-condition ruleset\n\n```\n# Draft PRs get a small penalty\nwhen pr.isDraft == true then -1 reason \"draft PR\"\n\n# Large PRs are harder to review\nwhen files.count() > 30 then -2 reason \"large diff \u2014 consider splitting\"\n\n# Bonus for linking an issue\nwhen hasLinkedIssue == true then +1 reason \"linked to tracked issue\"\n\n# At least one reviewer assigned\nwhen reviewers.count() > 0 then +1 reason \"has reviewers\"\n\n# Migration SQL is high-risk\nwhen files.count(f -> pathMatches(f.path, \"**/migrations/**/*.sql\")) > 0 then -3 reason \"migration SQL\" flag \"schema-change\"\n\n# Stale PR \u2014 open longer than a week\nwhen daysAgo(pr.lastUpdated) > 7 then -1 reason \"stale PR\"\n\n# Title check \u2014 must not be a bare word (RE2 syntax)\nwhen pr.title.matches(\"^fix$\") then -1 reason \"title too vague\"\n```\n\n---\n\n## Return Type for Parse Errors\n\nWhen `llama_set_pr_scorer_rules` receives a syntactically invalid ruleset,\nit returns a **structured** parse-error array \u2014 not a flattened string \u2014 so\nClaude can identify and fix individual lines:\n\n```json\n{\n  \"success\": false,\n  \"parseErrors\": [\n    { \"line\": 3, \"column\": 12, \"message\": \"Expected 'then' keyword\" },\n    { \"line\": 7, \"column\": 1,  \"message\": \"Score +15 exceeds maximum of +10\" }\n  ]\n}\n```\n\nFix each error by its `line` + `column` and resubmit.\n";
+//# sourceMappingURL=prScorerSchema.d.ts.map

package/dist/tools/prScorerSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prScorerSchema.d.ts","sourceRoot":"","sources":["../../src/tools/prScorerSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,uBAAuB,soRAuPnC,CAAC"}