@sirius-mcp/mcp 1.5.2 → 1.6.0

package/dist/installer/instruction-targets.js

@@ -0,0 +1,199 @@
+import path from "node:path";
+import {} from "./types.js";
+import { pJoin, getConfigDir } from "./targets-base.js";
+const CLAUDE_GLOBAL = (env) => pJoin(env.platform, env.homeDir, ".claude", "CLAUDE.md");
+const OPENCODE_GLOBAL = (env) => pJoin(env.platform, getConfigDir(env), "opencode", "AGENTS.md");
+const CODEX_GLOBAL = (env) => pJoin(env.platform, env.homeDir, ".codex", "AGENTS.md");
+export const INSTRUCTION_TARGETS = [
+    {
+        targetId: "claude-code",
+        files: [
+            {
+                path: "CLAUDE.md",
+                verification: "verified",
+                globalPath: CLAUDE_GLOBAL,
+            },
+        ],
+        source: "https://code.claude.com/docs/en/memory (checked 2026-09-11)",
+    },
+    {
+        targetId: "opencode",
+        files: [
+            {
+                path: "AGENTS.md",
+                verification: "verified",
+                globalPath: OPENCODE_GLOBAL,
+            },
+        ],
+        source: "https://opencode.ai/docs/rules/ (checked 2026-09-11)",
+    },
+    {
+        targetId: "codex",
+        files: [
+            {
+                path: "AGENTS.md",
+                verification: "verified",
+                globalPath: CODEX_GLOBAL,
+            },
+        ],
+        source: "https://agents.md/ ; https://developers.openai.com/codex/ (checked 2026-09-11)",
+    },
+    {
+        targetId: "zed",
+        files: [{ path: "AGENTS.md", verification: "verified" }],
+        source: "https://zed.dev/docs/ai/llm-rules (checked 2026-09-11)",
+    },
+    {
+        targetId: "copilot",
+        files: [
+            {
+                path: ".github/copilot-instructions.md",
+                verification: "verified",
+            },
+        ],
+        source: "https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions (checked 2026-09-11)",
+    },
+    {
+        targetId: "roo-code",
+        files: [
+            {
+                path: ".roo/rules/sirius-precedence-contract.md",
+                verification: "verified",
+            },
+        ],
+        source: "https://docs.roocode.com/features/custom-instructions/ (checked 2026-09-11)",
+    },
+    {
+        targetId: "cline",
+        files: [
+            {
+                path: ".clinerules/sirius-precedence-contract.md",
+                verification: "verified",
+            },
+        ],
+        source: "https://docs.cline.bot/features/clinerules (checked 2026-09-11)",
+    },
+    {
+        targetId: "continue",
+        files: [
+            {
+                path: ".continue/rules/sirius-precedence-contract.md",
+                verification: "verified",
+            },
+        ],
+        source: "https://docs.continue.dev/customize/deep-dive/core-concepts/rules (checked 2026-09-11)",
+    },
+    {
+        targetId: "kiro",
+        files: [
+            {
+                path: ".kiro/steering/sirius-precedence-contract.md",
+                verification: "verified",
+            },
+        ],
+        source: "https://kiro.dev/docs/steering/ (checked 2026-09-11)",
+    },
+    {
+        targetId: "windsurf",
+        files: [
+            {
+                path: ".windsurf/rules/sirius-precedence-contract.md",
+                verification: "verified",
+            },
+        ],
+        source: "https://docs.windsurf.com/windsurf/rules (checked 2026-09-11)",
+    },
+    {
+        targetId: "cursor",
+        files: [
+            {
+                path: ".cursor/rules/sirius-precedence-contract.mdc",
+                verification: "unverified",
+            },
+        ],
+        reason: "Convention churn (legacy .cursorrules to .cursor/rules/*.mdc); re-verify .mdc frontmatter handling before release (R-7).",
+    },
+    {
+        targetId: "aider",
+        files: [
+            { path: "CONVENTIONS.md", verification: "unverified" },
+        ],
+        reason: "aider does not auto-read CONVENTIONS.md (opt-in via config read:); no auto-read Markdown convention.",
+    },
+    {
+        targetId: "goose",
+        files: [],
+        reason: "No known repository instruction-file convention.",
+    },
+    {
+        targetId: "antigravity",
+        files: [],
+        reason: "No known repository instruction-file convention.",
+    },
+    {
+        targetId: "devin",
+        files: [],
+        reason: "Cloud-resident agent; no repository instruction file (S-5).",
+    },
+    {
+        targetId: "claude-desktop",
+        files: [],
+        reason: "Does not operate on a repository; no instruction file (S-5).",
+    },
+    {
+        targetId: "jetbrains",
+        files: [],
+        reason: "No single repository instruction-file convention (AI Assistant settings).",
+    },
+];
+export function getInstructionTarget(targetId) {
+    return INSTRUCTION_TARGETS.find((e) => e.targetId === targetId);
+}
+export function resolveInstructionTarget(target, scope, env, repoRoot) {
+    const entry = getInstructionTarget(target.id);
+    if (!entry) {
+        return {
+            targetId: target.id,
+            covered: false,
+            skipReason: "No instruction-file mapping for this target.",
+        };
+    }
+    const file = scope === "global" ? pickGlobalFile(entry, env) : pickWorkspaceFile(entry, repoRoot);
+    const declaredPath = file?.absPath ?? declaredPathFor(entry, scope, env, repoRoot);
+    if (!file) {
+        return {
+            targetId: target.id,
+            covered: false,
+            declaredPath,
+            skipReason: entry.reason ??
+                (scope === "global"
+                    ? "No verified global instruction-file convention."
+                    : "Instruction convention not verified for this target (R-7)."),
+        };
+    }
+    return { targetId: target.id, covered: true, file, declaredPath };
+}
+function declaredPathFor(entry, scope, env, repoRoot) {
+    const first = entry.files[0];
+    if (!first)
+        return undefined;
+    if (scope === "global" && first.globalPath)
+        return first.globalPath(env);
+    return path.resolve(repoRoot, ...first.path.split("/"));
+}
+function pickWorkspaceFile(entry, repoRoot) {
+    const verified = entry.files.find((f) => f.verification === "verified");
+    if (!verified)
+        return undefined;
+    return {
+        absPath: path.resolve(repoRoot, ...verified.path.split("/")),
+        scope: "workspace",
+    };
+}
+function pickGlobalFile(entry, env) {
+    const verified = entry.files.find((f) => f.verification === "verified" && f.globalPath);
+    if (!verified?.globalPath)
+        return undefined;
+    return { absPath: verified.globalPath(env), scope: "global" };
+}
+//# sourceMappingURL=instruction-targets.js.map

package/dist/installer/instruction-targets.js.map

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

package/dist/installer/precedence.d.ts

@@ -0,0 +1,59 @@
+export declare const SNIPPET_MARKER_PREFIX = "sirius:precedence-contract";
+export declare const SNIPPET_END_MARKER = "<!-- /sirius:precedence-contract -->";
+export declare const CANONICAL_MARKER_PREFIX = "sirius:precedence-canonical";
+export declare const CONTRACT_TYPE: "business-rule";
+export declare const CONTRACT_ID = "precedence-contract";
+export declare const CONTRACT_RELATIVE_PATH = ".context/business-rule/precedence-contract.md";
+export declare const CONTRACT_MAX_BODY_BYTES: number;
+export declare const INITIAL_CONTRACT_VERSION = 1;
+export type SnippetLanguage = "en" | "pt";
+export type Eol = "\r\n" | "\n";
+export interface CanonicalTemplate {
+    readonly version: number;
+    readonly language: SnippetLanguage;
+    readonly template: string;
+}
+export declare class PrecedenceError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown>;
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+export declare function todayIso(): string;
+export declare function canonicalDigest(template: string): string;
+export declare function detectDominantEol(content: string): Eol;
+export declare function toEol(text: string, eol: Eol): string;
+export declare function renderSnippetBlock(template: string, version: number, contractPath: string, eol?: Eol): string;
+export declare function extractCanonicalTemplates(body: string): CanonicalTemplate[];
+export declare function chooseSnippetTemplate(templates: CanonicalTemplate[], language: SnippetLanguage): CanonicalTemplate;
+export type BlockLocation = {
+    readonly status: "absent";
+} | {
+    readonly status: "present";
+    readonly startIndex: number;
+    readonly endIndex: number;
+    readonly eol: Eol | "";
+    readonly installedVersion: number | null;
+    readonly installedDigest: string | null;
+    readonly startLine: number;
+    readonly endLine: number;
+} | {
+    readonly status: "corrupt";
+    readonly problems: string[];
+};
+export declare function locateBlock(content: string): BlockLocation;
+export interface BlockApplication {
+    readonly nextContent: string;
+    readonly separatorInserted: boolean;
+}
+export declare function appendBlock(content: string, renderedBlockLf: string): BlockApplication;
+export declare function replaceBlock(content: string, location: BlockLocation & {
+    status: "present";
+}, renderedBlockLf: string): BlockApplication;
+export declare function removeBlock(content: string, location: BlockLocation & {
+    status: "present";
+}): {
+    nextContent: string;
+    generatorCreated: boolean;
+};
+export declare function snippetBodyWordCount(renderedBlock: string): number;
+//# sourceMappingURL=precedence.d.ts.map

package/dist/installer/precedence.d.ts.map

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

package/dist/installer/precedence.js

@@ -0,0 +1,218 @@
+import { createHash } from "node:crypto";
+export const SNIPPET_MARKER_PREFIX = "sirius:precedence-contract";
+export const SNIPPET_END_MARKER = "<!-- /sirius:precedence-contract -->";
+export const CANONICAL_MARKER_PREFIX = "sirius:precedence-canonical";
+export const CONTRACT_TYPE = "business-rule";
+export const CONTRACT_ID = "precedence-contract";
+export const CONTRACT_RELATIVE_PATH = ".context/business-rule/precedence-contract.md";
+export const CONTRACT_MAX_BODY_BYTES = 6 * 1024;
+export const INITIAL_CONTRACT_VERSION = 1;
+export class PrecedenceError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "PrecedenceError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export function todayIso() {
+    return new Date().toISOString().slice(0, 10);
+}
+function scanMarkers(content, pattern) {
+    const fresh = new RegExp(pattern.source, pattern.flags);
+    const matches = [];
+    for (const match of content.matchAll(fresh)) {
+        matches.push({ index: match.index ?? 0, text: match[0] });
+    }
+    return matches;
+}
+function lineAt(content, index) {
+    let line = 1;
+    for (let i = 0; i < index && i < content.length; i++) {
+        if (content.charCodeAt(i) === 10)
+            line++;
+    }
+    return line;
+}
+export function canonicalDigest(template) {
+    return createHash("sha256").update(template, "utf8").digest("hex").slice(0, 8);
+}
+export function detectDominantEol(content) {
+    let crlf = 0;
+    let lf = 0;
+    for (let i = 0; i < content.length; i++) {
+        if (content.charCodeAt(i) === 10) {
+            if (i > 0 && content.charCodeAt(i - 1) === 13)
+                crlf++;
+            else
+                lf++;
+        }
+    }
+    return crlf > lf ? "\r\n" : "\n";
+}
+export function toEol(text, eol) {
+    return eol === "\r\n" ? text.replace(/\r?\n/g, "\r\n") : text.replace(/\r\n/g, "\n");
+}
+export function renderSnippetBlock(template, version, contractPath, eol = "\n") {
+    const digest = canonicalDigest(template);
+    const rendered = template
+        .replaceAll("{VERSION}", String(version))
+        .replaceAll("{DIGEST}", digest)
+        .replaceAll("{CONTRACT_PATH}", contractPath);
+    return toEol(rendered, eol);
+}
+const CANONICAL_START_PATTERN = /<!--\s*sirius:precedence-canonical\s+v(\d+)(?:\s+lang:([a-z-]+))?\s*-->/g;
+const CANONICAL_END_PATTERN = /<!--\s*\/sirius:precedence-canonical\s*-->/g;
+function languageForOrder(index) {
+    return index === 1 ? "pt" : "en";
+}
+function stripBoundingNewlines(text) {
+    return text.replace(/^\r?\n/, "").replace(/\r?\n[ \t]*$/, "");
+}
+export function extractCanonicalTemplates(body) {
+    const starts = scanMarkers(body, CANONICAL_START_PATTERN);
+    const ends = scanMarkers(body, CANONICAL_END_PATTERN);
+    if (starts.length === 0) {
+        throw new PrecedenceError("NO_CANONICAL_BLOCK", "Contract body has no canonical routing snippet (missing sirius:precedence-canonical markers).");
+    }
+    if (starts.length !== ends.length) {
+        throw new PrecedenceError("CORRUPT_BLOCK", `Canonical markers are unbalanced: ${starts.length} start vs ${ends.length} end.`, { startLines: starts.map((s) => lineAt(body, s.index)), endLines: ends.map((e) => lineAt(body, e.index)) });
+    }
+    const versions = new Set(starts.map((s) => /v(\d+)/.exec(s.text)?.[1] ?? ""));
+    if (versions.size > 1) {
+        throw new PrecedenceError("CANONICAL_VERSIONS_DIVERGE", `Canonical blocks declare divergent versions: ${Array.from(versions).join(", ")}. Share one vN across all canonical blocks.`, { versions: Array.from(versions) });
+    }
+    assertNotInterleaved(body, starts, ends);
+    return starts.map((start, i) => {
+        const end = ends[i];
+        const explicit = start.text.match(/lang:([a-z-]+)/)?.[1];
+        const template = stripBoundingNewlines(body.slice(start.index + start.text.length, end.index));
+        return {
+            version: Number(/v(\d+)/.exec(start.text)?.[1] ?? INITIAL_CONTRACT_VERSION),
+            language: explicit ? (explicit === "pt" ? "pt" : "en") : languageForOrder(i),
+            template,
+        };
+    });
+}
+function assertNotInterleaved(body, starts, ends) {
+    for (let i = 0; i < starts.length - 1; i++) {
+        if (starts[i + 1].index < ends[i].index) {
+            throw new PrecedenceError("CORRUPT_BLOCK", `Canonical markers are interleaved: start at line ${lineAt(body, starts[i + 1].index)} opens before the block opened at line ${lineAt(body, starts[i].index)} is closed at line ${lineAt(body, ends[i].index)}.`, {
+                outerStartLine: lineAt(body, starts[i].index),
+                innerStartLine: lineAt(body, starts[i + 1].index),
+                outerEndLine: lineAt(body, ends[i].index),
+            });
+        }
+    }
+}
+export function chooseSnippetTemplate(templates, language) {
+    const explicit = templates.find((t) => t.language === language);
+    if (explicit)
+        return explicit;
+    return templates[0];
+}
+// Inline-tolerant (A-2 migration: anything after the recognized prefix may
+// evolve). The trailing EOL is consumed only when the marker ends its line.
+const BLOCK_START_PATTERN = /<!--[ \t]*sirius:precedence-contract\b[^\n]*?-->[ \t]*(?:\r?\n|$)?/g;
+const BLOCK_END_PATTERN = /<!--[ \t]*\/sirius:precedence-contract[ \t]*-->[ \t]*(?:\r?\n|$)?/g;
+function parseInstalledVersion(text) {
+    return Number(VERSION_IN_MARKER.exec(text)?.[1] ?? NaN) || null;
+}
+const VERSION_IN_MARKER = /\bv(\d+)\b/;
+const DIGEST_IN_MARKER = /digest:\s*([0-9a-fA-F]{8})\b/;
+function describeDuplicates(label, markers, content) {
+    if (markers.length <= 1)
+        return null;
+    return `${markers.length} ${label} markers (lines ${markers
+        .map((m) => lineAt(content, m.index))
+        .join(", ")})`;
+}
+function presentLocation(content, start, end) {
+    return {
+        status: "present",
+        startIndex: start.index,
+        endIndex: end.index + end.text.length,
+        eol: end.text.endsWith("\r\n") ? "\r\n" : end.text.endsWith("\n") ? "\n" : "",
+        installedVersion: parseInstalledVersion(start.text),
+        installedDigest: DIGEST_IN_MARKER.exec(start.text)?.[1] ?? null,
+        startLine: lineAt(content, start.index),
+        endLine: lineAt(content, end.index),
+    };
+}
+function unbalancedProblems(content, starts, ends) {
+    const problems = [];
+    const startDuplicates = describeDuplicates("start", starts, content);
+    const endDuplicates = describeDuplicates("end", ends, content);
+    if (startDuplicates)
+        problems.push(startDuplicates);
+    if (endDuplicates)
+        problems.push(endDuplicates);
+    if (starts.length === 1 && ends.length === 0) {
+        problems.push(`start marker at line ${lineAt(content, starts[0].index)} has no end marker`);
+    }
+    if (starts.length === 0 && ends.length === 1) {
+        problems.push(`end marker at line ${lineAt(content, ends[0].index)} has no start marker`);
+    }
+    if (starts.length === 1 && ends.length === 1) {
+        problems.push(`start marker at line ${lineAt(content, starts[0].index)} appears after end marker at line ${lineAt(content, ends[0].index)}`);
+    }
+    return problems;
+}
+export function locateBlock(content) {
+    const starts = scanMarkers(content, BLOCK_START_PATTERN);
+    const ends = scanMarkers(content, BLOCK_END_PATTERN);
+    if (starts.length === 0 && ends.length === 0) {
+        return { status: "absent" };
+    }
+    if (starts.length === 1 && ends.length === 1 && starts[0].index < ends[0].index) {
+        return presentLocation(content, starts[0], ends[0]);
+    }
+    return { status: "corrupt", problems: unbalancedProblems(content, starts, ends) };
+}
+export function appendBlock(content, renderedBlockLf) {
+    const eol = detectDominantEol(content);
+    const separator = content.length === 0 || content.endsWith("\n") || content.endsWith("\r\n")
+        ? ""
+        : eol;
+    return {
+        nextContent: `${content}${separator}${toEol(renderedBlockLf, eol)}${eol}`,
+        separatorInserted: separator.length > 0,
+    };
+}
+function requireIndex(location, key) {
+    const value = location.status === "present" ? location[key] : undefined;
+    if (typeof value !== "number") {
+        throw new PrecedenceError("CORRUPT_BLOCK", `Refusing to splice the file: block location is missing '${key}'.`);
+    }
+    return value;
+}
+export function replaceBlock(content, location, renderedBlockLf) {
+    const startIndex = requireIndex(location, "startIndex");
+    const endIndex = requireIndex(location, "endIndex");
+    const eol = location.eol === "" ? detectDominantEol(content) : location.eol;
+    const before = content.slice(0, startIndex);
+    const after = content.slice(endIndex);
+    return {
+        nextContent: `${before}${toEol(renderedBlockLf, eol)}${eol}${after}`,
+        separatorInserted: false,
+    };
+}
+export function removeBlock(content, location) {
+    const startIndex = requireIndex(location, "startIndex");
+    const endIndex = requireIndex(location, "endIndex");
+    const before = content.slice(0, startIndex);
+    const after = content.slice(endIndex);
+    return {
+        nextContent: `${before}${after}`,
+        generatorCreated: before.trim() === "" && after.trim() === "",
+    };
+}
+export function snippetBodyWordCount(renderedBlock) {
+    const inner = renderedBlock
+        .replace(/^[^\n]*\n/, "")
+        .replace(/\n[^\n]*$/, "");
+    return inner.split(/\s+/).filter(Boolean).length;
+}
+//# sourceMappingURL=precedence.js.map

package/dist/installer/precedence.js.map

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

package/dist/installer/snippet-context.d.ts

@@ -0,0 +1,49 @@
+import { type McpError } from "../errors.js";
+import { type ClientTargetDefinition } from "./types.js";
+import { type CanonicalTemplate, type SnippetLanguage, todayIso } from "./precedence.js";
+export { todayIso };
+import type { InstallerOptions, PatchAction } from "./types.js";
+export type SnippetMode = "generate" | "remove" | "status";
+export interface SnippetContractContext {
+    readonly contractFile: string;
+    readonly language: SnippetLanguage;
+    readonly contractVersion: number;
+    readonly contractBody: string;
+    readonly expectedBlock: string;
+    readonly expectedDigest: string;
+    readonly chosen: CanonicalTemplate;
+}
+export interface GroupOutcome {
+    readonly action: PatchAction;
+    readonly message: string;
+    readonly backupPath?: string;
+    readonly diff?: string;
+    readonly error?: {
+        code: string;
+        details: string;
+    };
+    readonly reason?: string;
+    readonly createdFile?: boolean;
+    readonly installedVersion?: number | null;
+}
+export interface SnippetTargetGroup {
+    readonly key: string;
+    readonly absPath: string;
+    readonly targets: ClientTargetDefinition[];
+}
+export declare function resolveMode(options: InstallerOptions): SnippetMode;
+export declare function resolveSnippetTargets(options: InstallerOptions): ClientTargetDefinition[];
+export declare function flagConflict(options: InstallerOptions): McpError | null;
+export declare function normalizeLanguage(language: string | undefined): SnippetLanguage;
+export interface SelectedEntry {
+    readonly id: string;
+    readonly target?: ClientTargetDefinition;
+}
+/** Selected targets, keeping unknown --clients ids visible as entries. */
+export declare function selectedEntries(options: InstallerOptions): SelectedEntry[];
+export declare function readFileOrNull(filePath: string): string | null;
+export declare function contractBodyOf(raw: string): string;
+export declare function buildContractContext(contractFile: string, language: SnippetLanguage, raw: string): SnippetContractContext;
+export declare function notInitializedRefusal(): McpError;
+export declare function contractMissingRefusal(): McpError;
+//# sourceMappingURL=snippet-context.d.ts.map

package/dist/installer/snippet-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet-context.d.ts","sourceRoot":"","sources":["../../src/installer/snippet-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAQpB,QAAQ,EACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,EAAE,CAAC;CAC5C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAIlE;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GACxB,sBAAsB,EAAE,CAa1B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,GAAG,IAAI,CAkBvE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAE/E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAW1E;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,MAAM,GACV,sBAAsB,CAsBxB;AAED,wBAAgB,qBAAqB,IAAI,QAAQ,CAOhD;AAED,wBAAgB,sBAAsB,IAAI,QAAQ,CAOjD"}

package/dist/installer/snippet-context.js

@@ -0,0 +1,93 @@
+import fs from "node:fs";
+import { parseDocumentMarkdown } from "../schemas/document.js";
+import { mcpRefusal } from "../errors.js";
+import { ALL_TARGETS, getTargetById } from "./targets.js";
+import {} from "./types.js";
+import { PrecedenceError, CONTRACT_MAX_BODY_BYTES, CONTRACT_RELATIVE_PATH, canonicalDigest, chooseSnippetTemplate, extractCanonicalTemplates, renderSnippetBlock, todayIso, } from "./precedence.js";
+export { todayIso };
+export function resolveMode(options) {
+    if (options.status)
+        return "status";
+    if (options.remove)
+        return "remove";
+    return "generate";
+}
+export function resolveSnippetTargets(options) {
+    if (options.targets && options.targets.length > 0) {
+        return options.targets
+            .map((id) => getTargetById(id))
+            .filter((t) => t !== undefined);
+    }
+    if (options.category === "cli") {
+        return ALL_TARGETS.filter((t) => t.category === "cli");
+    }
+    if (options.category === "ides") {
+        return ALL_TARGETS.filter((t) => t.category === "ide");
+    }
+    return [...ALL_TARGETS];
+}
+export function flagConflict(options) {
+    if (options.status && options.remove) {
+        return mcpRefusal("CONFLICTING_FLAGS", "--status and --remove cannot be combined.", "The flags request mutually exclusive modes.", "Run 'sirius snippet --status' or 'sirius snippet --remove' separately.");
+    }
+    if (options.status && options.dryRun) {
+        return mcpRefusal("CONFLICTING_FLAGS", "--status is strictly read-only; --dry-run does not apply.", "The flags request mutually exclusive modes.", "Drop --dry-run when requesting 'sirius snippet --status'.");
+    }
+    return null;
+}
+export function normalizeLanguage(language) {
+    return language === "pt" ? "pt" : "en";
+}
+/** Selected targets, keeping unknown --clients ids visible as entries. */
+export function selectedEntries(options) {
+    if (options.targets && options.targets.length > 0) {
+        return options.targets.map((id) => ({ id, target: getTargetById(id) }));
+    }
+    if (options.category === "cli") {
+        return ALL_TARGETS.filter((t) => t.category === "cli").map((target) => ({ id: target.id, target }));
+    }
+    if (options.category === "ides") {
+        return ALL_TARGETS.filter((t) => t.category === "ide").map((target) => ({ id: target.id, target }));
+    }
+    return ALL_TARGETS.map((target) => ({ id: target.id, target }));
+}
+export function readFileOrNull(filePath) {
+    try {
+        return fs.readFileSync(filePath, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export function contractBodyOf(raw) {
+    const parsed = parseDocumentMarkdown(raw);
+    return parsed.success ? parsed.data.body : raw;
+}
+export function buildContractContext(contractFile, language, raw) {
+    const templates = extractCanonicalTemplates(raw);
+    const version = templates[0].version;
+    const chosen = chooseSnippetTemplate(templates, language);
+    const contractBody = contractBodyOf(raw);
+    if (Buffer.byteLength(contractBody, "utf8") > CONTRACT_MAX_BODY_BYTES) {
+        throw new PrecedenceError("CONTRACT_TOO_LARGE", `Precedence contract body exceeds ${CONTRACT_MAX_BODY_BYTES} bytes (${Buffer.byteLength(contractBody, "utf8")}).`, { limitBytes: CONTRACT_MAX_BODY_BYTES, actualBytes: Buffer.byteLength(contractBody, "utf8") });
+    }
+    const expectedDigest = canonicalDigest(chosen.template);
+    return {
+        contractFile,
+        language,
+        contractVersion: version,
+        contractBody,
+        expectedDigest,
+        chosen,
+        expectedBlock: renderSnippetBlock(chosen.template, version, CONTRACT_RELATIVE_PATH),
+    };
+}
+export function notInitializedRefusal() {
+    return mcpRefusal("PROJECT_NOT_INITIALIZED", "Project not initialized: context.config.yaml was not found.", "The snippet generator only runs inside an initialized Sirius project.", "Run 'sirius init' (or the project_init tool) in this repository, then re-run 'sirius snippet'.");
+}
+export function contractMissingRefusal() {
+    return mcpRefusal("PRECEDENCE_CONTRACT_MISSING", "The precedence contract was not found in the context store.", "A routing block must point at an existing contract document.", "Run 'sirius snippet' (it seeds the contract) or 'sirius init', then retry.");
+}
+//# sourceMappingURL=snippet-context.js.map