@methiu/raigal 0.2.4 → 0.2.6

package/dist/index.js

@@ -1,4 +1,4 @@
-import { t as APP_VERSION } from "./version-CukuIVX4.js";
+import { t as APP_VERSION } from "./version-DtOeK-2T.js";
 import { a as getEngineLabel, i as ENGINE_INFO, r as scoreImpactForRule, t as summarizeFindingAssessments } from "./finding-assessment-CGpt5YUR.js";
 import { n as isSecretClassRule, r as maskSecrets, t as FIXED_SECRET_DIAGNOSTIC_MESSAGE } from "./mask-secrets-BXn-ZSEh.js";
 import { createRequire, isBuiltin } from "node:module";
@@ -109,10 +109,53 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: actions/setup-node@v4
         with:
           node-version: 22
       - run: npx --yes @methiu/raigal@latest ci .
+        env:
+          RAIGAL_TOKEN: \${{ secrets.RAIGAL_TOKEN }}
+          # RAIGAL_ORG_ID: \${{ vars.RAIGAL_ORG_ID }} # Optional: required if repository owner belongs to multiple Raigal organizations
+`;
+const DEFAULT_GITLAB_CI_FILE = ".gitlab-ci.yml";
+const DEFAULT_GITLAB_CI_YAML = `raigal_quality_gate:
+  image: node:24
+  stage: test
+  script:
+    - if [ -n "$CI_MERGE_REQUEST_IID" ]; then npx --yes @methiu/raigal@latest ci --changes --base "$CI_MERGE_REQUEST_DIFF_BASE_SHA"; else npx --yes @methiu/raigal@latest ci .; fi
+  variables:
+    RAIGAL_TOKEN: $RAIGAL_TOKEN
+    # RAIGAL_ORG_ID: $RAIGAL_ORG_ID # Optional: required if repository owner belongs to multiple Raigal organizations
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+`;
+const DEFAULT_BITBUCKET_FILE = "bitbucket-pipelines.yml";
+const DEFAULT_BITBUCKET_PIPELINES_YAML = `pipelines:
+  default:
+    - step:
+        name: raigal quality gate
+        image: node:24
+        script:
+          - npx --yes @methiu/raigal@latest ci .
+        secrets:
+          - RAIGAL_TOKEN
+          # - RAIGAL_ORG_ID
+  pull-requests:
+    "**":
+      - step:
+          name: raigal quality gate
+          image: node:24
+          clone:
+            depth: full
+          script:
+            - git fetch origin "$BITBUCKET_PR_DESTINATION_BRANCH"
+            - npx --yes @methiu/raigal@latest ci --changes --base FETCH_HEAD
+          secrets:
+            - RAIGAL_TOKEN
+            # - RAIGAL_ORG_ID
 `;
 const DEFAULT_RULES_YAML = `# Architecture rules (BYO)
 # Uncomment and customize to enforce your project's conventions.
@@ -2431,12 +2474,13 @@ const baseRefExists = (cwd, ref) => {
 	return !result.error && result.status === 0;
 };
 const getChangedFiles = (cwd, base) => {
+	const trimmedBase = base?.trim();
 	const diff = spawnSync("git", [
 		"diff",
 		"--no-color",
 		"--name-only",
 		"--diff-filter=ACMR",
-		base ?? "HEAD"
+		trimmedBase && trimmedBase.length > 0 ? trimmedBase : "HEAD"
 	], {
 		cwd,
 		encoding: "utf-8",
@@ -2488,13 +2532,14 @@ const listUntrackedFiles = (cwd) => {
 	return untracked.stdout.split("\n").filter((line) => line.length > 0);
 };
 const getChangedLineMap = (cwd, base) => {
+	const trimmedBase = base?.trim();
 	const diff = spawnSync("git", [
 		"diff",
 		"--no-color",
 		"--no-ext-diff",
 		"-U0",
 		"--diff-filter=ACMR",
-		base ?? "HEAD"
+		trimmedBase && trimmedBase.length > 0 ? trimmedBase : "HEAD"
 	], {
 		cwd,
 		encoding: "utf-8",
@@ -16323,6 +16368,8 @@ const requestApi = async (endpoint, options = {}) => {
 	};
 	if (options.token) headers.Authorization = `Bearer ${options.token}`;
 	if (options.oidcToken) headers["X-GitHub-OIDC"] = options.oidcToken;
+	const orgId = options.orgId || process.env.RAIGAL_ORG_ID;
+	if (orgId) headers["X-Raigal-Org-Id"] = orgId;
 	let body;
 	if (options.body !== void 0) {
 		headers["Content-Type"] = "application/json";
@@ -16354,11 +16401,12 @@ const requestApi = async (endpoint, options = {}) => {
 	}
 	return json;
 };
-const fetchEntitlementFromApi = async (token, oidcToken) => {
+const fetchEntitlementFromApi = async (token, oidcToken, orgId) => {
 	const data = await requestApi("/v1/entitlement", {
 		method: "POST",
 		token: token || void 0,
-		oidcToken
+		oidcToken,
+		orgId
 	});
 	return EntitlementResponse.parse(data);
 };
@@ -16440,7 +16488,7 @@ const verifyEntitlementJwt = (jwt, options = {}) => {
 	const claims = parsed.data;
 	const expectedIssuer = process.env.RAIGAL_ISSUER?.trim() || "https://app.raigal.dev";
 	if (claims.iss !== expectedIssuer) throw new JwtVerificationError(`Untrusted issuer: ${claims.iss}`, "invalid_issuer");
-	if (!isVersionAtLeast("0.2.4", claims.min_cli_version)) throw new JwtVerificationError(`CLI version ${APP_VERSION} is below required minimum ${claims.min_cli_version}. Run "raigal update" or "npm install -g @methiu/raigal@latest".`, "cli_version_unsupported");
+	if (!isVersionAtLeast("0.2.6", claims.min_cli_version)) throw new JwtVerificationError(`CLI version ${APP_VERSION} is below required minimum ${claims.min_cli_version}. Run "raigal update" or "npm install -g @methiu/raigal@latest".`, "cli_version_unsupported");
 	const now = options.nowSeconds ?? Math.floor(Date.now() / 1e3);
 	const grace = options.allowGraceSeconds ?? 0;
 	if (now > claims.exp + grace) {
@@ -16599,7 +16647,9 @@ const getEntitlement = async () => {
 		}
 	} else oidcToken = await fetchGitHubOidcToken();
 	try {
-		const response = await fetchEntitlementFromApi(activeToken?.token ?? "", oidcToken);
+		const tokenToPass = activeToken?.token ?? "";
+		const orgId = process.env.RAIGAL_ORG_ID;
+		const response = await fetchEntitlementFromApi(tokenToPass, oidcToken, orgId);
 		const claims = verifyEntitlementJwt(response.entitlement, { nowSeconds: now });
 		saveCachedEntitlement(response.entitlement, response.refresh_after);
 		return {
@@ -16613,7 +16663,7 @@ const getEntitlement = async () => {
 };
 //#endregion
 //#region src/cloud/owner.ts
-const GITHUB_REMOTE_RE = /^(?:(?:git@|ssh:\/\/(?:git@)?)github\.com(?::(?:\d+\/)?|[:/])|https:\/\/(?:[^@]+@)?github\.com\/)([^/]+)\/([^/\s]+?)(?:\.git)?\s*$/;
+const GENERIC_GIT_REMOTE_RE = /^(?:(?:git@|ssh:\/\/(?:git@)?)[^:/]+(?::(?:\d+\/)?|[:/])|https?:\/\/(?:[^@]+@)?[^/]+\/)([^/]+)\/([^/\s]+?)(?:\.git)?\s*$/;
 const parseGitRemote = (rawUrl) => {
 	if (!rawUrl) return {
 		owner: null,
@@ -16621,18 +16671,19 @@ const parseGitRemote = (rawUrl) => {
 		hasRemote: false,
 		isGitHubRemote: false
 	};
-	const match = rawUrl.match(GITHUB_REMOTE_RE);
+	const match = rawUrl.match(GENERIC_GIT_REMOTE_RE);
 	if (!match || !match[1] || !match[2]) return {
 		owner: null,
 		repo: null,
 		hasRemote: true,
 		isGitHubRemote: false
 	};
+	const isGitHub = rawUrl.includes("github.com");
 	return {
 		owner: match[1].toLowerCase(),
 		repo: match[2].toLowerCase(),
 		hasRemote: true,
-		isGitHubRemote: true
+		isGitHubRemote: isGitHub
 	};
 };
 const readGitConfigRemote = (dir) => {
@@ -16697,6 +16748,27 @@ const detectLocalRepoOwner = (directory) => {
 			isGitHubRemote: true
 		};
 	}
+	const gitlabRepo = process.env.CI_PROJECT_PATH?.trim();
+	if (gitlabRepo && gitlabRepo.includes("/")) {
+		const parts = gitlabRepo.split("/");
+		const repo = parts.pop() ?? "";
+		return {
+			owner: (parts[0] ?? "").toLowerCase(),
+			repo: repo.toLowerCase(),
+			hasRemote: true,
+			isGitHubRemote: false
+		};
+	}
+	const bitbucketRepo = (process.env.BITBUCKET_REPO_FULL_NAME || process.env.BITBUCKET_REPO_SLUG)?.trim();
+	if (bitbucketRepo) {
+		const [owner = process.env.BITBUCKET_WORKSPACE || "", repo = ""] = bitbucketRepo.includes("/") ? bitbucketRepo.split("/") : [process.env.BITBUCKET_WORKSPACE || "", bitbucketRepo];
+		return {
+			owner: owner.toLowerCase(),
+			repo: repo.toLowerCase(),
+			hasRemote: true,
+			isGitHubRemote: false
+		};
+	}
 	const gitRoot = findGitRoot(directory);
 	if (!gitRoot) return {
 		owner: null,
@@ -16708,26 +16780,17 @@ const detectLocalRepoOwner = (directory) => {
 	if (rawUrl !== null) return parseGitRemote(rawUrl);
 	return parseGitRemote(spawnGitRemote(gitRoot));
 };
-const isNonGitHubCi = () => {
-	const env = process.env;
-	if (!(env.CI === "true" || env.CI === "1")) return false;
-	return Boolean(env.GITLAB_CI || env.BITBUCKET_BUILD_NUMBER || env.CIRCLECI && !env.CIRCLE_PROJECT_REPONAME?.includes("/") || env.BUILDKITE || env.TRAVIS || env.JENKINS_URL);
-};
 const checkOwnerAgainstAllowlist = (detected, allowedOwners, tokenKind) => {
-	if (isNonGitHubCi()) return {
-		allowed: false,
-		reason: "Non-GitHub CI environments are unsupported under organization allowlists."
-	};
 	if (!detected.hasRemote) {
 		if (tokenKind === "session") return { allowed: true };
 		return {
 			allowed: false,
-			reason: "Repository has no GitHub remote. CI and API key runs require an origin remote matching an allowed organization."
+			reason: "Repository has no origin remote. CI and API key runs require an origin remote matching an allowed organization."
 		};
 	}
-	if (!detected.isGitHubRemote || !detected.owner) return {
+	if (!detected.owner) return {
 		allowed: false,
-		reason: "Repository remote is not hosted on GitHub or could not be determined."
+		reason: "Repository remote owner could not be determined."
 	};
 	const lowerOwner = detected.owner.toLowerCase();
 	if (!allowedOwners.some((allowed) => allowed.login.toLowerCase() === lowerOwner)) {
@@ -16735,7 +16798,7 @@ const checkOwnerAgainstAllowlist = (detected, allowedOwners, tokenKind) => {
 		return {
 			allowed: false,
 			owner: lowerOwner,
-			reason: `GitHub owner '${detected.owner}' is not on the organization allowlist (${allowedLogins || "none"}).`
+			reason: `Repository owner '${detected.owner}' is not on the organization allowlist (${allowedLogins || "none"}).`
 		};
 	}
 	return {
@@ -17990,10 +18053,13 @@ const isHistoryComparableScan = (options) => !options.staged && !options.changes
 const isFullProjectScan = (options) => isHistoryComparableScan(options) && !options.include?.length && !options.exclude?.length;
 const resolveScanScopeMode = (options) => {
 	if (options.staged) return { kind: "staged" };
-	if (options.changes) return options.base ? {
-		kind: "changes",
-		base: options.base
-	} : { kind: "changes" };
+	if (options.changes) {
+		const base = options.base?.trim();
+		return base ? {
+			kind: "changes",
+			base
+		} : { kind: "changes" };
+	}
 	return { kind: "full" };
 };
 //#endregion
@@ -18001,7 +18067,8 @@ const resolveScanScopeMode = (options) => {
 const scanTargetError = (resolvedDir, options) => {
 	if (!fs.existsSync(resolvedDir)) return `Path does not exist: ${resolvedDir}`;
 	if (!fs.statSync(resolvedDir).isDirectory()) return `Not a directory: ${resolvedDir}`;
-	if (options.changes && options.base && !baseRefExists(resolvedDir, options.base)) return `Could not resolve base ref "${options.base}". Make sure it exists and was fetched (e.g. \`git fetch origin ${options.base}\`).`;
+	const base = options.base?.trim();
+	if (options.changes && base && !baseRefExists(resolvedDir, base)) return `Could not resolve base ref "${base}". Make sure it exists and was fetched (e.g. \`git fetch origin ${base}\`).`;
 	return null;
 };
 //#endregion
@@ -18656,13 +18723,21 @@ const recordFullScanActivity = (history, allowPilotInvitation, telemetryConfig)
 	appendHistory(history);
 	return allowPilotInvitation && !isHistoryDisabled() && !isTelemetryDisabled(telemetryConfig) && recordCompletedFullScan();
 };
-const AISLOP_MD_BODY = `# Raigal - agent instructions
+//#endregion
+//#region src/hooks/assets.ts
+const buildRaigalMdBody = (agent) => {
+	let onEditSection;
+	if (agent === "claude") onEditSection = `A PostToolUse hook runs \`raigal hook claude\` after every Edit, Write, or MultiEdit. It scans the touched files and returns findings as JSON \`additionalContext\` shaped like \`RaigalFeedback\` (score, baseline, delta, regressed, counts, findings, newSinceBaseline, suggestedActions). Act on them the same turn; the \`suggestedActions\` field tells you exactly what to run next.`;
+	else if (agent === "gemini") onEditSection = `An AfterTool hook runs \`raigal hook gemini\` after file modifications. It scans the touched files and returns findings. Act on them the same turn; fix reported issues before completing.`;
+	else if (agent === "cursor") onEditSection = `An afterFileEdit hook runs \`raigal hook cursor\` after file modifications. It scans the touched files and reports quality findings. Fix reported errors and fixable warnings before completing your turn.`;
+	else onEditSection = `Raigal scans changed files and reports code quality, security, and AI pattern findings. Act on reported findings during your turn; fix errors and fixable warnings before completing your response.`;
+	return `# Raigal - agent instructions
 
 [Raigal](https://github.com/meethiu/raigal) is your guardrail for shipping clean, maintainable, production-grade code. It catches the patterns AI coding tools leave behind: dead imports, redundant code, duplicate logic, unsafe any-typed casts, narrative comments, swallowed errors, hidden fallbacks, oversized functions, risky security constructs - and grades the project out of 100 so regressions are visible. Treat its findings as blocking, not advisory: the goal is code a human maintainer would happily inherit.
 
 ## On every edit
 
-A PostToolUse hook runs \`raigal hook claude\` after every Edit, Write, or MultiEdit. It scans the touched files and returns findings as JSON \`additionalContext\` shaped like \`RaigalFeedback\` (score, baseline, delta, regressed, counts, findings, newSinceBaseline, suggestedActions). Act on them the same turn; the \`suggestedActions\` field tells you exactly what to run next.
+${onEditSection}
 
 ## Severity ladder
 
@@ -18682,6 +18757,8 @@ A PostToolUse hook runs \`raigal hook claude\` after every Edit, Write, or Multi
 - If a finding is a false positive, leave it and explain in your reply - do not delete the rule config.
 - The findings payload includes \`nextSteps[]\` - treat those as your plan for the turn.
 `;
+};
+buildRaigalMdBody("claude");
 //#endregion
 //#region src/hooks/io/atomic-write.ts
 const atomicWrite = (targetPath, content) => {
@@ -18712,12 +18789,12 @@ const readIfExists = (targetPath) => {
 //#endregion
 //#region src/hooks/io/sentinel.ts
 const sentinelHash = (content) => `sha256:${crypto.createHash("sha256").update(content).digest("hex").slice(0, 32)}`;
-const BEGIN_RE = /<!--\s*aislop:begin\s+v(\d+)(?:\s+hash=([^\s>]+))?\s*-->/;
-const END_RE = /<!--\s*aislop:end\s+v\d+\s*-->/;
+const BEGIN_RE = /<!--\s*(?:raigal|aislop):begin\s+v(\d+)(?:\s+hash=([^\s>]+))?\s*-->/;
+const END_RE = /<!--\s*(?:raigal|aislop):end\s+v\d+\s*-->/;
 const renderFence = (body, hash) => [
-	`<!-- aislop:begin v1 hash=${hash} -->`,
+	`<!-- raigal:begin v1 hash=${hash} -->`,
 	body.trimEnd(),
-	"<!-- aislop:end v1 -->"
+	"<!-- raigal:end v1 -->"
 ].join("\n");
 const upsertMarkdownFence = (existing, body, hash) => {
 	const fenced = renderFence(body, hash);
@@ -18782,11 +18859,20 @@ const applyRemoval = (result, opts, target, nextContent) => {
 //#region src/hooks/install/rules-only.ts
 const installRulesOnly = (opts, paths, summary) => {
 	const result = emptyResult();
-	const next = upsertMarkdownFence(readIfExists(paths.rules), AISLOP_MD_BODY, sentinelHash(AISLOP_MD_BODY)).nextContent;
+	const body = paths.body ?? buildRaigalMdBody();
+	const next = upsertMarkdownFence(readIfExists(paths.rules) ?? (paths.legacyRules ? readIfExists(paths.legacyRules) : null), body, sentinelHash(body)).nextContent;
 	applyContent(result, opts, paths.rules, next, summary);
+	if (paths.legacyRules && readIfExists(paths.legacyRules) != null) {
+		if (!opts.dryRun) try {
+			fs.rmSync(paths.legacyRules, { force: true });
+		} catch {}
+	}
 	if (paths.host && paths.marker) {
 		const host = readIfExists(paths.host) ?? "";
-		if (!host.includes(paths.marker)) {
+		if (paths.legacyMarker && host.includes(paths.legacyMarker)) {
+			const migrated = host.split("\n").map((l) => l.trim() === paths.legacyMarker ? paths.marker : l).join("\n");
+			applyContent(result, opts, paths.host, migrated, `update ${paths.marker} reference`);
+		} else if (!host.includes(paths.marker)) {
 			const joiner = host.endsWith("\n") || host.length === 0 ? "" : "\n";
 			const prefix = host.length === 0 ? "" : `${host}${joiner}\n`;
 			applyContent(result, opts, paths.host, `${prefix}${paths.marker}\n`, `append ${paths.marker} reference`);
@@ -18799,30 +18885,41 @@ const uninstallRulesOnly = (opts, paths) => {
 		removed: [],
 		skipped: []
 	};
-	if (readIfExists(paths.rules) != null) applyRemoval(result, opts, paths.rules, null);
-	else result.skipped.push(paths.rules);
-	if (paths.host && paths.marker) {
+	let removedRule = false;
+	if (readIfExists(paths.rules) != null) {
+		applyRemoval(result, opts, paths.rules, null);
+		removedRule = true;
+	}
+	if (paths.legacyRules && readIfExists(paths.legacyRules) != null) {
+		applyRemoval(result, opts, paths.legacyRules, null);
+		removedRule = true;
+	}
+	if (!removedRule) result.skipped.push(paths.rules);
+	if (paths.host && (paths.marker || paths.legacyMarker)) {
 		const host = readIfExists(paths.host);
-		if (host?.includes(paths.marker)) {
-			const stripped = host.split("\n").filter((l) => l.trim() !== paths.marker).join("\n").replace(/\n{3,}/g, "\n\n").trim();
+		if (host && (paths.marker && host.includes(paths.marker) || paths.legacyMarker && host.includes(paths.legacyMarker))) {
+			const stripped = host.split("\n").filter((l) => l.trim() !== paths.marker && l.trim() !== paths.legacyMarker).join("\n").replace(/\n{3,}/g, "\n\n").trim();
 			applyRemoval(result, opts, paths.host, stripped.length === 0 ? null : `${stripped}\n`);
-		} else result.skipped.push(paths.host);
+		} else if (paths.host) result.skipped.push(paths.host);
 	}
 	return result;
 };
 //#endregion
 //#region src/hooks/install/antigravity.ts
-const resolveAntigravityPaths = (opts) => ({ rules: path.join(opts.cwd, ".agents", "rules", "antigravity-aislop-rules.md") });
+const resolveAntigravityPaths = (opts) => ({
+	rules: path.join(opts.cwd, ".agents", "rules", "antigravity-raigal-rules.md"),
+	legacyRules: path.join(opts.cwd, ".agents", "rules", "antigravity-aislop-rules.md")
+});
 const installAntigravity = (opts) => {
 	if (opts.scope !== "project") return {
 		wrote: [],
 		skipped: [],
 		planned: [{
-			path: ".agents/rules/antigravity-aislop-rules.md",
+			path: ".agents/rules/antigravity-raigal-rules.md",
 			summary: "Antigravity is project-scope only; pass --project"
 		}]
 	};
-	return installRulesOnly(opts, resolveAntigravityPaths(opts), "write .agents/rules/antigravity-aislop-rules.md");
+	return installRulesOnly(opts, resolveAntigravityPaths(opts), "write .agents/rules/antigravity-raigal-rules.md");
 };
 const uninstallAntigravity = (opts) => {
 	if (opts.scope !== "project") return {
@@ -18831,9 +18928,7 @@ const uninstallAntigravity = (opts) => {
 	};
 	return uninstallRulesOnly(opts, resolveAntigravityPaths(opts));
 };
-//#endregion
-//#region src/hooks/io/json-patch.ts
-const AISLOP_SENTINEL_KEY = "__aislop";
+const RAIGAL_SENTINEL_KEY = "__raigal";
 const isAislopManaged = (x) => typeof x === "object" && x !== null && ("__aislop" in x && x["__aislop"] != null || "__raigal" in x && x["__raigal"] != null);
 const groupIsAislop = (group) => {
 	if (typeof group !== "object" || group === null) return false;
@@ -18883,6 +18978,7 @@ const resolveClaudePaths = (opts) => {
 	const root = opts.scope === "project" ? path.join(opts.cwd, ".claude") : path.join(opts.home, ".claude");
 	return {
 		settings: path.join(root, "settings.json"),
+		raigalMd: path.join(root, "RAIGAL.md"),
 		aislopMd: path.join(root, "AISLOP.md"),
 		claudeMd: path.join(root, "CLAUDE.md")
 	};
@@ -18897,7 +18993,7 @@ const buildHookGroup$1 = () => {
 		hooks: [{
 			type: "command",
 			command: "raigal hook claude",
-			[AISLOP_SENTINEL_KEY]: {
+			[RAIGAL_SENTINEL_KEY]: {
 				v: 1,
 				managed: true,
 				hash: sentinelHash(hashBody)
@@ -18912,7 +19008,7 @@ const buildStopHookGroup = () => {
 		hooks: [{
 			type: "command",
 			command: "raigal hook claude --stop",
-			[AISLOP_SENTINEL_KEY]: {
+			[RAIGAL_SENTINEL_KEY]: {
 				v: 1,
 				managed: true,
 				hash: sentinelHash(hashBody)
@@ -18931,7 +19027,7 @@ const buildFileChangedHookGroup = () => {
 		hooks: [{
 			type: "command",
 			command: "raigal hook claude --on-file-changed",
-			[AISLOP_SENTINEL_KEY]: {
+			[RAIGAL_SENTINEL_KEY]: {
 				v: 1,
 				managed: true,
 				hash: sentinelHash(hashBody)
@@ -18957,15 +19053,25 @@ const installClaude = (opts) => {
 	const result = emptyResult();
 	const nextSettings = renderSettings$1(readIfExists(paths.settings), Boolean(opts.qualityGate));
 	applyContent(result, opts, paths.settings, nextSettings, "register PostToolUse + FileChanged hooks");
-	const mdHash = sentinelHash(AISLOP_MD_BODY);
-	const fenced = upsertMarkdownFence(readIfExists(paths.aislopMd), AISLOP_MD_BODY, mdHash);
-	applyContent(result, opts, paths.aislopMd, fenced.nextContent, "write AISLOP.md rules");
+	const body = buildRaigalMdBody("claude");
+	const mdHash = sentinelHash(body);
+	const fenced = upsertMarkdownFence(readIfExists(paths.raigalMd) ?? readIfExists(paths.aislopMd), body, mdHash);
+	applyContent(result, opts, paths.raigalMd, fenced.nextContent, "write RAIGAL.md rules");
+	if (paths.raigalMd !== paths.aislopMd && readIfExists(paths.aislopMd) != null) {
+		if (!opts.dryRun) try {
+			fs.rmSync(paths.aislopMd, { force: true });
+		} catch {}
+	}
 	const existingClaudeMd = readIfExists(paths.claudeMd) ?? "";
-	const marker = "@AISLOP.md";
-	if (!existingClaudeMd.includes(marker)) {
+	const marker = "@RAIGAL.md";
+	const legacyMarker = "@AISLOP.md";
+	if (existingClaudeMd.includes(legacyMarker)) {
+		const migrated = existingClaudeMd.split("\n").map((line) => line.trim() === legacyMarker ? marker : line).join("\n");
+		applyContent(result, opts, paths.claudeMd, migrated, "update @RAIGAL.md reference");
+	} else if (!existingClaudeMd.includes(marker)) {
 		const joiner = existingClaudeMd.endsWith("\n") || existingClaudeMd.length === 0 ? "" : "\n";
 		const prefix = existingClaudeMd.length === 0 ? "" : `${existingClaudeMd}${joiner}\n`;
-		applyContent(result, opts, paths.claudeMd, `${prefix}${marker}\n`, "append @AISLOP.md reference");
+		applyContent(result, opts, paths.claudeMd, `${prefix}${marker}\n`, "append @RAIGAL.md reference");
 	} else result.skipped.push(paths.claudeMd);
 	return result;
 };
@@ -18994,11 +19100,19 @@ const uninstallClaude = (opts) => {
 		if (!stillHasHooks && otherKeys.length === 0) applyRemoval(result, opts, paths.settings, null);
 		else applyRemoval(result, opts, paths.settings, `${JSON.stringify(stripped, null, 2)}\n`);
 	} else result.skipped.push(paths.settings);
-	if (readIfExists(paths.aislopMd) != null) applyRemoval(result, opts, paths.aislopMd, null);
-	else result.skipped.push(paths.aislopMd);
+	let removedMd = false;
+	if (readIfExists(paths.raigalMd) != null) {
+		applyRemoval(result, opts, paths.raigalMd, null);
+		removedMd = true;
+	}
+	if (readIfExists(paths.aislopMd) != null) {
+		applyRemoval(result, opts, paths.aislopMd, null);
+		removedMd = true;
+	}
+	if (!removedMd) result.skipped.push(paths.raigalMd);
 	const claudeMd = readIfExists(paths.claudeMd);
-	if (claudeMd?.includes("@AISLOP.md")) {
-		const stripped = claudeMd.split("\n").filter((line) => line.trim() !== "@AISLOP.md").join("\n").replace(/\n{3,}/g, "\n\n").trim();
+	if (claudeMd?.includes("@RAIGAL.md") || claudeMd?.includes("@AISLOP.md")) {
+		const stripped = claudeMd.split("\n").filter((line) => line.trim() !== "@RAIGAL.md" && line.trim() !== "@AISLOP.md").join("\n").replace(/\n{3,}/g, "\n\n").trim();
 		applyRemoval(result, opts, paths.claudeMd, stripped.length === 0 ? null : `${stripped}\n`);
 	} else result.skipped.push(paths.claudeMd);
 	return result;
@@ -19006,7 +19120,10 @@ const uninstallClaude = (opts) => {
 //#endregion
 //#region src/hooks/install/cline.ts
 const resolveClinePaths = (opts) => ({ rules: path.join(opts.cwd, ".clinerules") });
-const resolveRooPaths = (opts) => ({ rules: path.join(opts.cwd, ".roo", "rules", "aislop.md") });
+const resolveRooPaths = (opts) => ({
+	rules: path.join(opts.cwd, ".roo", "rules", "raigal.md"),
+	legacyRules: path.join(opts.cwd, ".roo", "rules", "aislop.md")
+});
 const installCline = (opts) => {
 	if (opts.scope !== "project") return {
 		wrote: [],
@@ -19017,7 +19134,7 @@ const installCline = (opts) => {
 		}]
 	};
 	const cline = installRulesOnly(opts, resolveClinePaths(opts), "write .clinerules");
-	const roo = installRulesOnly(opts, resolveRooPaths(opts), "write .roo/rules/aislop.md");
+	const roo = installRulesOnly(opts, resolveRooPaths(opts), "write .roo/rules/raigal.md");
 	return {
 		wrote: [...cline.wrote, ...roo.wrote],
 		skipped: [...cline.skipped, ...roo.skipped],
@@ -19068,7 +19185,8 @@ const resolveCursorPaths = (opts) => {
 	const root = opts.scope === "project" ? path.join(opts.cwd, ".cursor") : path.join(opts.home, ".cursor");
 	return {
 		hooks: path.join(root, "hooks.json"),
-		rules: path.join(opts.cwd, ".cursor", "rules", "aislop.mdc")
+		rules: path.join(opts.cwd, ".cursor", "rules", "raigal.mdc"),
+		legacyRules: path.join(opts.cwd, ".cursor", "rules", "aislop.mdc")
 	};
 };
 const buildHookEntry = () => {
@@ -19080,7 +19198,7 @@ const buildHookEntry = () => {
 		command: "raigal hook cursor",
 		type: "command",
 		timeout: 5e3,
-		[AISLOP_SENTINEL_KEY]: {
+		[RAIGAL_SENTINEL_KEY]: {
 			v: 1,
 			managed: true,
 			hash: sentinelHash(hashBody)
@@ -19104,8 +19222,14 @@ const installCursor = (opts) => {
 	const nextHooks = renderHooksJson(readIfExists(paths.hooks));
 	applyContent(result, opts, paths.hooks, nextHooks, "register afterFileEdit hook");
 	if (opts.scope === "project") {
-		const rules = upsertMarkdownFence(readIfExists(paths.rules), AISLOP_MD_BODY, sentinelHash(AISLOP_MD_BODY)).nextContent;
-		applyContent(result, opts, paths.rules, rules, "write .cursor/rules/aislop.mdc");
+		const body = buildRaigalMdBody("cursor");
+		const rules = upsertMarkdownFence(readIfExists(paths.rules) ?? (paths.legacyRules ? readIfExists(paths.legacyRules) : null), body, sentinelHash(body)).nextContent;
+		applyContent(result, opts, paths.rules, rules, "write .cursor/rules/raigal.mdc");
+		if (paths.legacyRules && readIfExists(paths.legacyRules) != null) {
+			if (!opts.dryRun) try {
+				fs.rmSync(paths.legacyRules, { force: true });
+			} catch {}
+		}
 	}
 	return result;
 };
@@ -19129,7 +19253,18 @@ const uninstallCursor = (opts) => {
 		if (!stillHasHooks && otherKeys.length === 0) applyRemoval(result, opts, paths.hooks, null);
 		else applyRemoval(result, opts, paths.hooks, `${JSON.stringify(stripped, null, 2)}\n`);
 	} else result.skipped.push(paths.hooks);
-	if (opts.scope === "project") applyRemoval(result, opts, paths.rules, null);
+	if (opts.scope === "project") {
+		let removedRule = false;
+		if (readIfExists(paths.rules) != null) {
+			applyRemoval(result, opts, paths.rules, null);
+			removedRule = true;
+		}
+		if (paths.legacyRules && readIfExists(paths.legacyRules) != null) {
+			applyRemoval(result, opts, paths.legacyRules, null);
+			removedRule = true;
+		}
+		if (!removedRule) result.skipped.push(paths.rules);
+	}
 	return result;
 };
 //#endregion
@@ -19138,6 +19273,7 @@ const resolveGeminiPaths = (opts) => {
 	const root = opts.scope === "project" ? path.join(opts.cwd, ".gemini") : path.join(opts.home, ".gemini");
 	return {
 		settings: path.join(root, "settings.json"),
+		raigalMd: path.join(root, "RAIGAL.md"),
 		aislopMd: path.join(root, "AISLOP.md"),
 		geminiMd: path.join(root, "GEMINI.md")
 	};
@@ -19154,7 +19290,7 @@ const buildHookGroup = () => {
 			type: "command",
 			command: "raigal hook gemini",
 			timeout: 5e3,
-			[AISLOP_SENTINEL_KEY]: {
+			[RAIGAL_SENTINEL_KEY]: {
 				v: 1,
 				managed: true,
 				hash: sentinelHash(hashBody)
@@ -19177,14 +19313,25 @@ const installGemini = (opts) => {
 	const result = emptyResult();
 	const next = renderSettings(readIfExists(paths.settings));
 	applyContent(result, opts, paths.settings, next, "register AfterTool hook");
-	const fenced = upsertMarkdownFence(readIfExists(paths.aislopMd), AISLOP_MD_BODY, sentinelHash(AISLOP_MD_BODY)).nextContent;
-	applyContent(result, opts, paths.aislopMd, fenced, "write AISLOP.md rules");
+	const body = buildRaigalMdBody("gemini");
+	const hash = sentinelHash(body);
+	const fenced = upsertMarkdownFence(readIfExists(paths.raigalMd) ?? readIfExists(paths.aislopMd), body, hash).nextContent;
+	applyContent(result, opts, paths.raigalMd, fenced, "write RAIGAL.md rules");
+	if (paths.raigalMd !== paths.aislopMd && readIfExists(paths.aislopMd) != null) {
+		if (!opts.dryRun) try {
+			fs.rmSync(paths.aislopMd, { force: true });
+		} catch {}
+	}
 	const existingGeminiMd = readIfExists(paths.geminiMd) ?? "";
-	const marker = "@AISLOP.md";
-	if (!existingGeminiMd.includes(marker)) {
+	const marker = "@RAIGAL.md";
+	const legacyMarker = "@AISLOP.md";
+	if (existingGeminiMd.includes(legacyMarker)) {
+		const migrated = existingGeminiMd.split("\n").map((l) => l.trim() === legacyMarker ? marker : l).join("\n");
+		applyContent(result, opts, paths.geminiMd, migrated, "update @RAIGAL.md reference");
+	} else if (!existingGeminiMd.includes(marker)) {
 		const joiner = existingGeminiMd.endsWith("\n") || existingGeminiMd.length === 0 ? "" : "\n";
 		const prefix = existingGeminiMd.length === 0 ? "" : `${existingGeminiMd}${joiner}\n`;
-		applyContent(result, opts, paths.geminiMd, `${prefix}${marker}\n`, "append @AISLOP.md reference");
+		applyContent(result, opts, paths.geminiMd, `${prefix}${marker}\n`, "append @RAIGAL.md reference");
 	} else result.skipped.push(paths.geminiMd);
 	return result;
 };
@@ -19208,28 +19355,39 @@ const uninstallGemini = (opts) => {
 		if (!stillHasHooks && otherKeys.length === 0) applyRemoval(result, opts, paths.settings, null);
 		else applyRemoval(result, opts, paths.settings, `${JSON.stringify(stripped, null, 2)}\n`);
 	} else result.skipped.push(paths.settings);
-	if (readIfExists(paths.aislopMd) != null) applyRemoval(result, opts, paths.aislopMd, null);
-	else result.skipped.push(paths.aislopMd);
+	let removedMd = false;
+	if (readIfExists(paths.raigalMd) != null) {
+		applyRemoval(result, opts, paths.raigalMd, null);
+		removedMd = true;
+	}
+	if (readIfExists(paths.aislopMd) != null) {
+		applyRemoval(result, opts, paths.aislopMd, null);
+		removedMd = true;
+	}
+	if (!removedMd) result.skipped.push(paths.raigalMd);
 	const geminiMd = readIfExists(paths.geminiMd);
-	if (geminiMd?.includes("@AISLOP.md")) {
-		const stripped = geminiMd.split("\n").filter((l) => l.trim() !== "@AISLOP.md").join("\n").replace(/\n{3,}/g, "\n\n").trim();
+	if (geminiMd?.includes("@RAIGAL.md") || geminiMd?.includes("@AISLOP.md")) {
+		const stripped = geminiMd.split("\n").filter((l) => l.trim() !== "@RAIGAL.md" && l.trim() !== "@AISLOP.md").join("\n").replace(/\n{3,}/g, "\n\n").trim();
 		applyRemoval(result, opts, paths.geminiMd, stripped.length === 0 ? null : `${stripped}\n`);
 	} else result.skipped.push(paths.geminiMd);
 	return result;
 };
 //#endregion
 //#region src/hooks/install/kilocode.ts
-const resolveKilocodePaths = (opts) => ({ rules: path.join(opts.cwd, ".kilocode", "rules", "aislop-rules.md") });
+const resolveKilocodePaths = (opts) => ({
+	rules: path.join(opts.cwd, ".kilocode", "rules", "raigal-rules.md"),
+	legacyRules: path.join(opts.cwd, ".kilocode", "rules", "aislop-rules.md")
+});
 const installKilocode = (opts) => {
 	if (opts.scope !== "project") return {
 		wrote: [],
 		skipped: [],
 		planned: [{
-			path: ".kilocode/rules/aislop-rules.md",
+			path: ".kilocode/rules/raigal-rules.md",
 			summary: "Kilo Code is project-scope only; pass --project"
 		}]
 	};
-	return installRulesOnly(opts, resolveKilocodePaths(opts), "write .kilocode/rules/aislop-rules.md");
+	return installRulesOnly(opts, resolveKilocodePaths(opts), "write .kilocode/rules/raigal-rules.md");
 };
 const uninstallKilocode = (opts) => {
 	if (opts.scope !== "project") return {
@@ -19383,18 +19541,24 @@ const paths = {
 		const p = resolveClaudePaths(opts);
 		return [
 			p.settings,
+			p.raigalMd,
 			p.aislopMd,
 			p.claudeMd
 		];
 	},
 	cursor: (opts) => {
 		const p = resolveCursorPaths(opts);
-		return opts.scope === "project" ? [p.hooks, p.rules] : [p.hooks];
+		return opts.scope === "project" ? [
+			p.hooks,
+			p.rules,
+			...p.legacyRules ? [p.legacyRules] : []
+		] : [p.hooks];
 	},
 	gemini: (opts) => {
 		const p = resolveGeminiPaths(opts);
 		return [
 			p.settings,
+			p.raigalMd,
 			p.aislopMd,
 			p.geminiMd
 		];
@@ -19402,9 +19566,22 @@ const paths = {
 	pi: (opts) => [resolvePiPaths(opts).extension],
 	codex: (opts) => [resolveCodexPaths(opts).rules],
 	windsurf: (opts) => [resolveWindsurfPaths(opts).rules],
-	cline: (opts) => [resolveClinePaths(opts).rules, resolveRooPaths(opts).rules],
-	kilocode: (opts) => [resolveKilocodePaths(opts).rules],
-	antigravity: (opts) => [resolveAntigravityPaths(opts).rules],
+	cline: (opts) => {
+		const roo = resolveRooPaths(opts);
+		return [
+			resolveClinePaths(opts).rules,
+			roo.rules,
+			...roo.legacyRules ? [roo.legacyRules] : []
+		];
+	},
+	kilocode: (opts) => {
+		const k = resolveKilocodePaths(opts);
+		return [k.rules, ...k.legacyRules ? [k.legacyRules] : []];
+	},
+	antigravity: (opts) => {
+		const a = resolveAntigravityPaths(opts);
+		return [a.rules, ...a.legacyRules ? [a.legacyRules] : []];
+	},
 	copilot: (opts) => [resolveCopilotPaths(opts).rules]
 };
 const REGISTRY = {
@@ -20486,12 +20663,12 @@ const runScanBody = async (resolvedDir, config, options, projectInfo, scanScope,
 		scoreFileCount
 	});
 	if (options.sarif) {
-		const { buildSarifLog } = await import("./sarif-Lt31Ld5t.js");
+		const { buildSarifLog } = await import("./sarif-Cu7Rm1Ma.js");
 		console.log(JSON.stringify(buildSarifLog(results), null, 2));
 		return completion;
 	}
 	if (options.json) {
-		const { buildJsonOutput } = await import("./json-BBZKvm0E.js");
+		const { buildJsonOutput } = await import("./json-DxIA7CCt.js");
 		const jsonOut = buildJsonOutput(results, scoreResult, scoreFileCount, elapsedMs, scanCoverage);
 		console.log(JSON.stringify(jsonOut, null, 2));
 		return completion;
@@ -20810,10 +20987,12 @@ const buildInitSuccessRender = (input) => {
 	}, deps);
 	const writtenCount = input.steps.filter((s) => s.status === "done").length;
 	const footer = writtenCount === 0 ? "Nothing to write" : `Done · wrote ${writtenCount} file${writtenCount === 1 ? "" : "s"}`;
-	return `${header}${renderRail({
+	const rail = renderRail({
 		steps: input.steps,
 		footer
-	}, deps)}\n${renderHintLine(`Try ${input.nextCommand}`, deps)}`;
+	}, deps);
+	const extraHint = input.hint ? `\n${renderHintLine(input.hint, deps)}` : "";
+	return `${header}${rail}\n${renderHintLine(`Try ${input.nextCommand}`, deps)}${extraHint}`;
 };
 const ENGINE_CHOICES = [
 	{
@@ -20864,7 +21043,45 @@ const writeGithubWorkflow = (rootDirectory, enabled) => {
 		relativePath
 	};
 };
-const promptForConfigChoices = async () => {
+const writeGitlabWorkflow = (rootDirectory, enabled) => {
+	const relativePath = DEFAULT_GITLAB_CI_FILE;
+	if (!enabled) return { status: "declined" };
+	const workflowPath = path.join(rootDirectory, DEFAULT_GITLAB_CI_FILE);
+	if (fs.existsSync(workflowPath)) return {
+		status: "skipped-exists",
+		relativePath
+	};
+	fs.writeFileSync(workflowPath, DEFAULT_GITLAB_CI_YAML);
+	return {
+		status: "written",
+		relativePath
+	};
+};
+const writeBitbucketWorkflow = (rootDirectory, enabled) => {
+	const relativePath = DEFAULT_BITBUCKET_FILE;
+	if (!enabled) return { status: "declined" };
+	const workflowPath = path.join(rootDirectory, DEFAULT_BITBUCKET_FILE);
+	if (fs.existsSync(workflowPath)) return {
+		status: "skipped-exists",
+		relativePath
+	};
+	fs.writeFileSync(workflowPath, DEFAULT_BITBUCKET_PIPELINES_YAML);
+	return {
+		status: "written",
+		relativePath
+	};
+};
+const detectDefaultCiProvider = (directory) => {
+	if (fs.existsSync(path.join(directory, ".gitlab-ci.yml"))) return "gitlab";
+	if (fs.existsSync(path.join(directory, "bitbucket-pipelines.yml"))) return "bitbucket";
+	if (fs.existsSync(path.join(directory, ".github/workflows"))) return "github";
+	const detectedOwner = detectLocalRepoOwner(directory);
+	if (detectedOwner.hasRemote) {
+		if (detectedOwner.isGitHubRemote) return "github";
+	}
+	return "github";
+};
+const promptForConfigChoices = async (directory) => {
 	const enginesSelection = await runCancellable(() => multiselect({
 		message: "Which engines should run?",
 		options: ENGINE_CHOICES,
@@ -20894,15 +21111,26 @@ const promptForConfigChoices = async () => {
 	});
 	if (isCancel(telemetryChoice)) return null;
 	const workflowChoice = await select({
-		message: "Add a GitHub Actions workflow to run Raigal on every push and PR?",
-		options: [{
-			value: "yes",
-			label: "Yes — writes .github/workflows/raigal.yml"
-		}, {
-			value: "no",
-			label: "No, I'll wire CI myself"
-		}],
-		initialValue: "yes"
+		message: "Add automated CI quality gate workflow?",
+		options: [
+			{
+				value: "github",
+				label: "GitHub Actions — writes .github/workflows/raigal.yml"
+			},
+			{
+				value: "gitlab",
+				label: "GitLab CI — writes .gitlab-ci.yml"
+			},
+			{
+				value: "bitbucket",
+				label: "Bitbucket Pipelines — writes bitbucket-pipelines.yml"
+			},
+			{
+				value: "none",
+				label: "No, I'll wire CI myself"
+			}
+		],
+		initialValue: detectDefaultCiProvider(directory)
 	});
 	if (isCancel(workflowChoice)) return null;
 	return {
@@ -20910,7 +21138,8 @@ const promptForConfigChoices = async () => {
 		failBelow: Number(failBelowRaw),
 		typecheck: DEFAULT_CONFIG.lint.typecheck,
 		telemetryEnabled: telemetryChoice === "enabled",
-		writeGithubWorkflow: workflowChoice === "yes"
+		writeGithubWorkflow: workflowChoice === "github",
+		ciProvider: workflowChoice
 	};
 };
 const strictChoices = () => ({
@@ -20918,7 +21147,8 @@ const strictChoices = () => ({
 	failBelow: 85,
 	typecheck: true,
 	telemetryEnabled: DEFAULT_CONFIG.telemetry.enabled,
-	writeGithubWorkflow: true
+	writeGithubWorkflow: true,
+	ciProvider: "github"
 });
 const writeAislopConfig = (configDir, configPath, choices) => {
 	const selected = new Set(choices.engines);
@@ -20995,7 +21225,7 @@ const initCommand = async (directory, options = {}) => {
 			return;
 		}
 	}
-	const choices = options.strict ? strictChoices() : await promptForConfigChoices();
+	const choices = options.strict ? strictChoices() : await promptForConfigChoices(resolvedDir);
 	if (!choices) return;
 	writeAislopConfig(configDir, configPath, choices);
 	const steps = [{
@@ -21012,19 +21242,49 @@ const initCommand = async (directory, options = {}) => {
 		status: "skipped",
 		label: `${CONFIG_DIR}/${RULES_FILE} already exists`
 	});
-	const workflowResult = writeGithubWorkflow(resolvedDir, choices.writeGithubWorkflow);
-	if (workflowResult.status === "written") steps.push({
-		status: "done",
-		label: `Wrote ${workflowResult.relativePath}`
-	});
-	else if (workflowResult.status === "skipped-exists") steps.push({
-		status: "skipped",
-		label: `${workflowResult.relativePath} already exists`
-	});
+	let ciHint;
+	if (choices.ciProvider === "gitlab") {
+		const gitlabResult = writeGitlabWorkflow(resolvedDir, true);
+		if (gitlabResult.status === "written") {
+			steps.push({
+				status: "done",
+				label: `Wrote ${gitlabResult.relativePath}`
+			});
+			ciHint = "Set RAIGAL_TOKEN in GitLab CI/CD Variables (Settings > CI/CD > Variables).";
+		} else if (gitlabResult.status === "skipped-exists") steps.push({
+			status: "skipped",
+			label: `${gitlabResult.relativePath} already exists`
+		});
+	} else if (choices.ciProvider === "bitbucket") {
+		const bbResult = writeBitbucketWorkflow(resolvedDir, true);
+		if (bbResult.status === "written") {
+			steps.push({
+				status: "done",
+				label: `Wrote ${bbResult.relativePath}`
+			});
+			ciHint = "Set RAIGAL_TOKEN in Bitbucket Repository Variables (Repository settings > Repository variables).";
+		} else if (bbResult.status === "skipped-exists") steps.push({
+			status: "skipped",
+			label: `${bbResult.relativePath} already exists`
+		});
+	} else if (choices.writeGithubWorkflow || choices.ciProvider === "github") {
+		const workflowResult = writeGithubWorkflow(resolvedDir, true);
+		if (workflowResult.status === "written") {
+			steps.push({
+				status: "done",
+				label: `Wrote ${workflowResult.relativePath}`
+			});
+			ciHint = "GitHub Actions zero-token OIDC enabled (permissions: id-token: write).";
+		} else if (workflowResult.status === "skipped-exists") steps.push({
+			status: "skipped",
+			label: `${workflowResult.relativePath} already exists`
+		});
+	}
 	process.stdout.write(buildInitSuccessRender({
 		steps,
 		nextCommand: `${invocation} scan`,
-		includeHeader: false
+		includeHeader: false,
+		hint: ciHint
 	}));
 };
 //#endregion