@mossbear/projections 0.1.0-alpha.26

package/dist/cursor-rules.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect } from 'vitest';
+import { renderCursorRules } from './cursor-rules.js';
+const agent = {
+    id: 'reviewer',
+    name: 'Code Reviewer',
+    description: 'Reviews code for quality issues.',
+    capabilities: ['no trailing whitespace', 'prefer const over let'],
+};
+describe('renderCursorRules', () => {
+    it('renders capabilities as prefixed rule lines', () => {
+        const output = renderCursorRules([agent]);
+        expect(output).toContain('[Code Reviewer] no trailing whitespace');
+        expect(output).toContain('[Code Reviewer] prefer const over let');
+    });
+    it('includes the auto-generated header', () => {
+        const output = renderCursorRules([agent]);
+        expect(output).toContain('Auto-generated by mossbear');
+    });
+    it('does not include attribution by default', () => {
+        const output = renderCursorRules([agent]);
+        expect(output).not.toContain('Guides managed by Mossbear');
+    });
+    it('appends attribution when enabled', () => {
+        const output = renderCursorRules([agent], { includeAttribution: true });
+        expect(output).toContain('# Guides managed by Mossbear (mossbear.io)');
+    });
+    it('uses a custom attribution string when provided', () => {
+        const output = renderCursorRules([agent], {
+            includeAttribution: true,
+            attribution: 'Managed by Mossbear — 94% alignment score',
+        });
+        expect(output).toContain('# Managed by Mossbear — 94% alignment score');
+    });
+    it('returns a valid string for an empty agent list', () => {
+        const output = renderCursorRules([]);
+        expect(typeof output).toBe('string');
+    });
+    it('skips agents with no capabilities', () => {
+        const noCapAgent = { ...agent, capabilities: [] };
+        const output = renderCursorRules([noCapAgent]);
+        expect(output).not.toContain('# Code Reviewer');
+        expect(output).not.toContain('[Code Reviewer]');
+    });
+    it('renders multiple agents in order', () => {
+        const second = {
+            id: 'formatter',
+            name: 'Formatter',
+            description: '',
+            capabilities: ['use 2-space indentation'],
+        };
+        const output = renderCursorRules([agent, second]);
+        const reviewerPos = output.indexOf('# Code Reviewer');
+        const formatterPos = output.indexOf('# Formatter');
+        expect(reviewerPos).toBeLessThan(formatterPos);
+        expect(output).toContain('[Formatter] use 2-space indentation');
+    });
+});
+//# sourceMappingURL=cursor-rules.test.js.map

package/dist/cursor-rules.test.js.map

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

package/dist/detect-format.d.ts

@@ -0,0 +1,15 @@
+import type { GuideFileFormat } from '@mossbear/protocol';
+export declare function detectFormat(path: string): GuideFileFormat | null;
+export declare function isSupportedGuidePath(path: string): boolean;
+/**
+ * True for a path inside a `skills/<name>/` tree that is NOT itself the
+ * SKILL.md — i.e. skill *member* content (scripts, references, assets).
+ * `detectFormat` deliberately returns `null` for these, so a consumer that
+ * resolves a member edit to its owning skill uses this to recognise them
+ * rather than dropping them as unknown. No caller in this repo today: the
+ * incremental re-sync that used it (`rules watch`) was deleted, and the full
+ * discovery scan groups members by walking the tree instead. Kept as part of
+ * this module's path-classification surface, alongside `isSupportedGuidePath`.
+ */
+export declare function isSkillMemberPath(path: string): boolean;
+//# sourceMappingURL=detect-format.d.ts.map

package/dist/detect-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-format.d.ts","sourceRoot":"","sources":["../src/detect-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AA0BzD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA+DjE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,WAEhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,WAG7C"}

package/dist/detect-format.js

@@ -0,0 +1,88 @@
+function normalizeGuidePath(path) {
+    return path.replaceAll('\\', '/').replace(/\/+/g, '/').toLowerCase();
+}
+function isUnderSkillsDir(normalizedPath) {
+    return (normalizedPath.startsWith('.claude/skills/') ||
+        normalizedPath.includes('/.claude/skills/') ||
+        normalizedPath.startsWith('.agents/skills/') ||
+        normalizedPath.includes('/.agents/skills/'));
+}
+function basenameOf(normalizedPath) {
+    return normalizedPath.slice(normalizedPath.lastIndexOf('/') + 1);
+}
+function isUnderCursorRulesDir(normalizedPath) {
+    return (normalizedPath.startsWith('.cursor/rules/') ||
+        normalizedPath.includes('/.cursor/rules/'));
+}
+export function detectFormat(path) {
+    const normalizedPath = normalizeGuidePath(path);
+    // Checked ahead of the generic `.agents/` rule below: a SKILL.md nested
+    // under a `skills/` directory is a distinct artifact (npx-skills / Claude
+    // Code skill installs), not a freeform `.agents/` guide entry. Every other
+    // file in a skills/ tree (scripts, references, assets) is skill *member*
+    // content — imported alongside its SKILL.md by discovery, never as a
+    // standalone guide — so the whole subtree is opaque to the rules below
+    // (previously `.agents/skills/<skill>/scripts/…` leaked through the
+    // `.agents/` catch-all as its own agents-dir guide).
+    if (isUnderSkillsDir(normalizedPath)) {
+        return normalizedPath.endsWith('/skill.md') ? 'skill-md' : null;
+    }
+    if (normalizedPath === 'agents.md' || normalizedPath.endsWith('/agents.md')) {
+        return 'agents-md';
+    }
+    if (normalizedPath === 'claude.md' || normalizedPath.endsWith('/claude.md')) {
+        return 'claude-md';
+    }
+    if (normalizedPath === '.cursorrules' || normalizedPath.endsWith('/.cursorrules')) {
+        return 'cursorrules';
+    }
+    // Dot-files inside a recognised location are tooling scaffolding, not
+    // guidance: `mossbear init` writes `.agents/.gitkeep` so git tracks the
+    // otherwise-empty directory (`commands/init.ts`), and editors and VCS leave
+    // `.DS_Store`/`.gitignore`/`.gitattributes` beside real guides. Importing
+    // them files a guide the user never wrote — an empty card on the guides
+    // screen, an extra head on the run summary's guide count, and a body-less
+    // guide handed to the grader.
+    //
+    // Ordering is load-bearing: this sits *below* the `.cursorrules` branch,
+    // the one dot-file that is a genuine guide and is matched by exact name. A
+    // future dot-named format must be matched above this line too. Same shape
+    // as the skills branch at the top — a recognised location whose contents
+    // still are not, individually, guides.
+    if (basenameOf(normalizedPath).startsWith('.'))
+        return null;
+    // Modern Cursor "Project Rules": a directory of `.mdc` files under
+    // `.cursor/rules/` (project or `~/.cursor/rules/` global), distinct from the
+    // legacy single-file `.cursorrules` above. Cursor only reads `.mdc` files
+    // here, so other files (README.md, assets) fall through to `null`. Nested
+    // rule directories (`.cursor/rules/frontend/*.mdc`) are matched too.
+    if (isUnderCursorRulesDir(normalizedPath) && normalizedPath.endsWith('.mdc')) {
+        return 'cursor-rules';
+    }
+    if (normalizedPath.startsWith('.agents/') || normalizedPath.includes('/.agents/')) {
+        return 'agents-dir';
+    }
+    if (normalizedPath.startsWith('.claude/rules/') ||
+        normalizedPath.includes('/.claude/rules/')) {
+        return 'claude-rules';
+    }
+    return null;
+}
+export function isSupportedGuidePath(path) {
+    return detectFormat(path) !== null;
+}
+/**
+ * True for a path inside a `skills/<name>/` tree that is NOT itself the
+ * SKILL.md — i.e. skill *member* content (scripts, references, assets).
+ * `detectFormat` deliberately returns `null` for these, so a consumer that
+ * resolves a member edit to its owning skill uses this to recognise them
+ * rather than dropping them as unknown. No caller in this repo today: the
+ * incremental re-sync that used it (`rules watch`) was deleted, and the full
+ * discovery scan groups members by walking the tree instead. Kept as part of
+ * this module's path-classification surface, alongside `isSupportedGuidePath`.
+ */
+export function isSkillMemberPath(path) {
+    const normalizedPath = normalizeGuidePath(path);
+    return isUnderSkillsDir(normalizedPath) && !normalizedPath.endsWith('/skill.md');
+}
+//# sourceMappingURL=detect-format.js.map

package/dist/detect-format.js.map

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

package/dist/detect-format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=detect-format.test.d.ts.map

package/dist/detect-format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-format.test.d.ts","sourceRoot":"","sources":["../src/detect-format.test.ts"],"names":[],"mappings":""}

package/dist/detect-format.test.js

@@ -0,0 +1,104 @@
+import { describe, expect, it } from 'vitest';
+import { detectFormat, isSkillMemberPath, isSupportedGuidePath } from './detect-format.js';
+describe('detectFormat', () => {
+    it('detects canonical single-file formats', () => {
+        expect(detectFormat('AGENTS.md')).toBe('agents-md');
+        expect(detectFormat('/repo/CLAUDE.md')).toBe('claude-md');
+        expect(detectFormat('.cursorrules')).toBe('cursorrules');
+    });
+    it('detects directory-backed formats by path only', () => {
+        expect(detectFormat('.agents/reviewer/SKILL.md')).toBe('agents-dir');
+        expect(detectFormat('/repo/.claude/rules/backend.md')).toBe('claude-rules');
+    });
+    it('detects a SKILL.md nested under a skills/ directory as skill-md', () => {
+        expect(detectFormat('.claude/skills/reviewer/SKILL.md')).toBe('skill-md');
+        expect(detectFormat('/repo/.claude/skills/reviewer/SKILL.md')).toBe('skill-md');
+        expect(detectFormat('.agents/skills/reviewer/SKILL.md')).toBe('skill-md');
+        expect(detectFormat('/repo/.agents/skills/reviewer/SKILL.md')).toBe('skill-md');
+    });
+    it('ignores non-SKILL.md files inside a skills/ directory', () => {
+        expect(detectFormat('.claude/skills/reviewer/script.py')).toBeNull();
+        expect(detectFormat('.claude/skills/reviewer/README.md')).toBeNull();
+        // The whole skills/ subtree is opaque: under .agents/skills/ member files
+        // must not leak through the generic .agents/ catch-all as agents-dir
+        // guides — they import with their skill, as members.
+        expect(detectFormat('.agents/skills/reviewer/scripts/lint.py')).toBeNull();
+        expect(detectFormat('.agents/skills/reviewer/references/api.md')).toBeNull();
+        // Even an AGENTS.md nested in a skill directory is skill member content.
+        expect(detectFormat('.claude/skills/reviewer/references/AGENTS.md')).toBeNull();
+    });
+    it('ignores dot-files in every recognised guide location', () => {
+        // `mossbear init` writes .agents/.gitkeep so git tracks the directory; it is
+        // scaffolding, not guidance, and importing it produced an empty guide.
+        expect(detectFormat('.agents/.gitkeep')).toBeNull();
+        expect(detectFormat('/repo/.agents/.gitkeep')).toBeNull();
+        expect(detectFormat('C:\\repo\\.agents\\.gitkeep')).toBeNull();
+        expect(detectFormat('.agents/team/.DS_Store')).toBeNull();
+        expect(detectFormat('.claude/rules/.gitkeep')).toBeNull();
+        expect(detectFormat('.cursor/rules/.gitkeep')).toBeNull();
+        // Even a dot-file carrying a rules-directory extension stays out.
+        expect(detectFormat('.cursor/rules/.hidden.mdc')).toBeNull();
+    });
+    it('still detects .cursorrules, the one dot-file that is a guide', () => {
+        // Guards the ordering: the dot-file rejection must sit below this branch.
+        expect(detectFormat('.cursorrules')).toBe('cursorrules');
+        expect(detectFormat('/repo/.cursorrules')).toBe('cursorrules');
+        expect(detectFormat('C:\\repo\\.cursorrules')).toBe('cursorrules');
+        expect(isSupportedGuidePath('.cursorrules')).toBe(true);
+    });
+    it('detects .mdc files under .cursor/rules/ as cursor-rules', () => {
+        expect(detectFormat('.cursor/rules/backend.mdc')).toBe('cursor-rules');
+        expect(detectFormat('/repo/.cursor/rules/backend.mdc')).toBe('cursor-rules');
+        // Nested rule directories are supported.
+        expect(detectFormat('.cursor/rules/frontend/api.mdc')).toBe('cursor-rules');
+        // Global (~/.cursor/rules/) paths resolve to absolute home paths.
+        expect(detectFormat('/home/user/.cursor/rules/style.mdc')).toBe('cursor-rules');
+    });
+    it('ignores non-.mdc files under .cursor/rules/ and the legacy single file', () => {
+        expect(detectFormat('.cursor/rules/README.md')).toBeNull();
+        expect(detectFormat('.cursor/rules/assets/logo.png')).toBeNull();
+        // The legacy single-file format stays distinct from the directory format.
+        expect(detectFormat('.cursorrules')).toBe('cursorrules');
+    });
+    it('normalizes windows-style paths', () => {
+        expect(detectFormat('C:\\repo\\AGENTS.md')).toBe('agents-md');
+        expect(detectFormat('C:\\repo\\CLAUDE.md')).toBe('claude-md');
+        expect(detectFormat('C:\\repo\\.agents\\reviewer\\SKILL.md')).toBe('agents-dir');
+        expect(detectFormat('C:\\repo\\.claude\\rules\\backend.md')).toBe('claude-rules');
+        expect(detectFormat('C:\\repo\\.claude\\skills\\reviewer\\SKILL.md')).toBe('skill-md');
+        expect(detectFormat('C:\\repo\\.cursor\\rules\\backend.mdc')).toBe('cursor-rules');
+    });
+    it('returns null for unsupported paths', () => {
+        expect(detectFormat('README.md')).toBeNull();
+        expect(detectFormat('.agents')).toBeNull();
+        expect(detectFormat('.claude/settings.json')).toBeNull();
+    });
+});
+describe('isSupportedGuidePath', () => {
+    it('tracks detectFormat support', () => {
+        expect(isSupportedGuidePath('AGENTS.md')).toBe(true);
+        expect(isSupportedGuidePath('docs/guide.md')).toBe(false);
+    });
+});
+describe('isSkillMemberPath', () => {
+    it('is true for member content inside a skills/ tree', () => {
+        expect(isSkillMemberPath('.claude/skills/reviewer/script.py')).toBe(true);
+        expect(isSkillMemberPath('.claude/skills/reviewer/references/api.md')).toBe(true);
+        expect(isSkillMemberPath('/repo/.claude/skills/reviewer/assets/logo.png')).toBe(true);
+        expect(isSkillMemberPath('.agents/skills/reviewer/scripts/lint.py')).toBe(true);
+        // Even a nested AGENTS.md is member content, matching detectFormat.
+        expect(isSkillMemberPath('.claude/skills/reviewer/references/AGENTS.md')).toBe(true);
+    });
+    it('is false for the SKILL.md itself', () => {
+        expect(isSkillMemberPath('.claude/skills/reviewer/SKILL.md')).toBe(false);
+        expect(isSkillMemberPath('/repo/.agents/skills/reviewer/SKILL.md')).toBe(false);
+        expect(isSkillMemberPath('C:\\repo\\.claude\\skills\\reviewer\\SKILL.md')).toBe(false);
+    });
+    it('is false for paths outside a skills/ tree', () => {
+        expect(isSkillMemberPath('AGENTS.md')).toBe(false);
+        expect(isSkillMemberPath('.claude/rules/backend.md')).toBe(false);
+        expect(isSkillMemberPath('.cursor/rules/backend.mdc')).toBe(false);
+        expect(isSkillMemberPath('docs/guide.md')).toBe(false);
+    });
+});
+//# sourceMappingURL=detect-format.test.js.map

package/dist/detect-format.test.js.map

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

package/dist/eval-path.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Where a **plain guide's** evaluation criteria live on disk: the eval shadow
+ * tree at `<scopeRoot>/.mossbear/evals/<the guide's scope-relative path>`
+ * (docs/plans/eval-criteria-on-disk-plan.md → Approach).
+ *
+ * One rule — *the eval file lives with its guide* — expressed two ways, because
+ * the two guide shapes have different structures:
+ *
+ *   - a **skill** is a directory, so its criteria sit inside it as a positional
+ *     `EVAL.md` (already shipped: `skillMemberContentType`,
+ *     `apps/dashboard/src/server/rules/skillMembers.ts`). Nothing here touches
+ *     that half;
+ *   - a **plain guide** is a bare file with nowhere to put a sibling that would
+ *     not clutter — and land inside — a discovery root, so its criteria go in
+ *     the shadow tree, which mirrors the guide's own path.
+ *
+ * Mirroring the path is what removes the mapping table: two guides cannot share
+ * a path, so their shadow entries cannot collide, and the scope root carries the
+ * rest — a `global` guide's criteria land in `~/.mossbear/evals/.claude/CLAUDE.md`
+ * by the same rule that puts a `project` guide's in the repo.
+ *
+ * **The shadow tree is never guidance.** `.mossbear/` is not a discovery root
+ * (`discover.ts`), so nothing under it is imported as a guide — that is the
+ * property `rules-discover.test.ts` and `rules-manifest.test.ts` pin down. But
+ * "not discovered" is not the same as "not classifiable", and `detectFormat` is
+ * path-only: hand it `.mossbear/evals/AGENTS.md` and it answers `agents-md`,
+ * because the path *ends* in `agents.md`. Any future call site that classifies a
+ * local file it did not get from discovery — the reconciler this item unblocks —
+ * must therefore ask `classifyLocalItemPath` rather than `detectFormat`, which
+ * is why the shadow-tree check lives inside it and cannot be forgotten.
+ *
+ * **Why this lives in `projections` rather than the CLI or the protocol.**
+ * The server needs it too: a guide pull has to tell each client where that
+ * guide's criteria belong, and deriving the path on each client instead would
+ * be the per-clone divergence `unified-item-sync` exists to remove. Of the
+ * three homes that could serve both sides, this is the cheapest — the rule is
+ * *about* format and path semantics, which is this package's subject, and it
+ * needs `detectFormat`, which is already here. Putting it in
+ * `@mossbear/protocol` would drag this package into the dependency graph of a
+ * published, deliberately valibot-only contract package; re-expressing the
+ * skill check without `detectFormat` would duplicate the rule this module was
+ * written to keep in one place (Planning Principle 14).
+ */
+import type { GuideFileFormat } from '@mossbear/protocol';
+/** Scope-root-relative POSIX directory holding the eval shadow tree. */
+export declare const EVAL_SHADOW_DIR = ".mossbear/evals";
+/**
+ * The shadow-tree path for a **plain** guide, relative to the same scope root
+ * the guide's own path is relative to. `null` when the guide path could never
+ * have been discovered as a guide in the first place (absolute, escaping,
+ * control characters, over-long, or already inside `.mossbear/`) — and `null` for a
+ * skill, which keeps its criteria positionally.
+ */
+export declare function evalShadowPath(guidePath: string): string | null;
+/**
+ * The inverse: the guide whose criteria a shadow path holds, or `null` when the
+ * path is not in the shadow tree (or names the directory itself).
+ *
+ * A true inverse over the paths `evalShadowPath` accepts, and deliberately no
+ * wider: a remainder this function would recover but that function would never
+ * emit — `.mossbear/evals/.mossbear/evals/AGENTS.md`, `.mossbear/evals/.claude/skills/review/SKILL.md` —
+ * names no guide whose criteria belong here, so it is refused rather than
+ * reported as valid eval content. Without that, the shadow tree could hold an
+ * entry the derivation says is unreachable.
+ */
+export declare function guidePathFromEvalShadow(shadowPath: string): string | null;
+/**
+ * What a scope-relative path on disk *is*, for a caller holding a path rather
+ * than a discovery result.
+ *
+ * `eval` is checked before anything else so no path under `.mossbear/` can come
+ * back as a guide — see this module's header for why `detectFormat` alone gets
+ * that wrong.
+ */
+export type LocalItemClassification = 
+/** Criteria for the guide at `guidePath`, held in the shadow tree. */
+{
+    kind: 'eval';
+    guidePath: string;
+}
+/** A guide file, in the format `detectFormat` recognised. */
+ | {
+    kind: 'guide';
+    format: GuideFileFormat;
+}
+/** Neither: Mossbear's own state, a skill member, an unrelated file. */
+ | {
+    kind: 'other';
+};
+export declare function classifyLocalItemPath(path: string): LocalItemClassification;
+//# sourceMappingURL=eval-path.d.ts.map

package/dist/eval-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval-path.d.ts","sourceRoot":"","sources":["../src/eval-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,wEAAwE;AACxE,eAAO,MAAM,eAAe,oBAAoB,CAAA;AAIhD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYzE;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB;AACjC,sEAAsE;AACpE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AACrC,6DAA6D;GAC3D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE;AAC5C,wEAAwE;GACtE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAErB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAU3E"}

package/dist/eval-path.js

@@ -0,0 +1,110 @@
+/**
+ * Where a **plain guide's** evaluation criteria live on disk: the eval shadow
+ * tree at `<scopeRoot>/.mossbear/evals/<the guide's scope-relative path>`
+ * (docs/plans/eval-criteria-on-disk-plan.md → Approach).
+ *
+ * One rule — *the eval file lives with its guide* — expressed two ways, because
+ * the two guide shapes have different structures:
+ *
+ *   - a **skill** is a directory, so its criteria sit inside it as a positional
+ *     `EVAL.md` (already shipped: `skillMemberContentType`,
+ *     `apps/dashboard/src/server/rules/skillMembers.ts`). Nothing here touches
+ *     that half;
+ *   - a **plain guide** is a bare file with nowhere to put a sibling that would
+ *     not clutter — and land inside — a discovery root, so its criteria go in
+ *     the shadow tree, which mirrors the guide's own path.
+ *
+ * Mirroring the path is what removes the mapping table: two guides cannot share
+ * a path, so their shadow entries cannot collide, and the scope root carries the
+ * rest — a `global` guide's criteria land in `~/.mossbear/evals/.claude/CLAUDE.md`
+ * by the same rule that puts a `project` guide's in the repo.
+ *
+ * **The shadow tree is never guidance.** `.mossbear/` is not a discovery root
+ * (`discover.ts`), so nothing under it is imported as a guide — that is the
+ * property `rules-discover.test.ts` and `rules-manifest.test.ts` pin down. But
+ * "not discovered" is not the same as "not classifiable", and `detectFormat` is
+ * path-only: hand it `.mossbear/evals/AGENTS.md` and it answers `agents-md`,
+ * because the path *ends* in `agents.md`. Any future call site that classifies a
+ * local file it did not get from discovery — the reconciler this item unblocks —
+ * must therefore ask `classifyLocalItemPath` rather than `detectFormat`, which
+ * is why the shadow-tree check lives inside it and cannot be forgotten.
+ *
+ * **Why this lives in `projections` rather than the CLI or the protocol.**
+ * The server needs it too: a guide pull has to tell each client where that
+ * guide's criteria belong, and deriving the path on each client instead would
+ * be the per-clone divergence `unified-item-sync` exists to remove. Of the
+ * three homes that could serve both sides, this is the cheapest — the rule is
+ * *about* format and path semantics, which is this package's subject, and it
+ * needs `detectFormat`, which is already here. Putting it in
+ * `@mossbear/protocol` would drag this package into the dependency graph of a
+ * published, deliberately valibot-only contract package; re-expressing the
+ * skill check without `detectFormat` would duplicate the rule this module was
+ * written to keep in one place (Planning Principle 14).
+ */
+import { detectFormat } from './detect-format.js';
+import { isSafeRelativePath, isSkillGuidePath, isUnderMossbearDir, segmentsOf, toPosix, } from './path-rules.js';
+/** Scope-root-relative POSIX directory holding the eval shadow tree. */
+export const EVAL_SHADOW_DIR = '.mossbear/evals';
+const MOSSBEAR_DIR_SEGMENT = '.mossbear';
+/**
+ * The shadow-tree path for a **plain** guide, relative to the same scope root
+ * the guide's own path is relative to. `null` when the guide path could never
+ * have been discovered as a guide in the first place (absolute, escaping,
+ * control characters, over-long, or already inside `.mossbear/`) — and `null` for a
+ * skill, which keeps its criteria positionally.
+ */
+export function evalShadowPath(guidePath) {
+    const normalized = toPosix(guidePath);
+    if (!isSafeRelativePath(normalized))
+        return null;
+    if (isUnderMossbearDir(normalized))
+        return null;
+    if (isSkillGuidePath(normalized))
+        return null;
+    const shadowPath = `${EVAL_SHADOW_DIR}/${normalized}`;
+    // The shadow path is itself carried in payloads and sidecars, so a guide path
+    // that is safe on its own but pushes the shadow path past the 512-char bound
+    // has no representable home — say so rather than emitting a path that fails
+    // validation one layer later.
+    return isSafeRelativePath(shadowPath) ? shadowPath : null;
+}
+/**
+ * The inverse: the guide whose criteria a shadow path holds, or `null` when the
+ * path is not in the shadow tree (or names the directory itself).
+ *
+ * A true inverse over the paths `evalShadowPath` accepts, and deliberately no
+ * wider: a remainder this function would recover but that function would never
+ * emit — `.mossbear/evals/.mossbear/evals/AGENTS.md`, `.mossbear/evals/.claude/skills/review/SKILL.md` —
+ * names no guide whose criteria belong here, so it is refused rather than
+ * reported as valid eval content. Without that, the shadow tree could hold an
+ * entry the derivation says is unreachable.
+ */
+export function guidePathFromEvalShadow(shadowPath) {
+    const normalized = toPosix(shadowPath);
+    const segments = segmentsOf(normalized);
+    if (segments[0] !== MOSSBEAR_DIR_SEGMENT || segments[1] !== 'evals')
+        return null;
+    // Slice the original (not the lower-cased copy) so the guide path keeps the
+    // casing it was written with — `AGENTS.md` must not come back as `agents.md`.
+    const remainder = normalized.split('/').slice(2).join('/');
+    if (remainder.length === 0)
+        return null;
+    if (!isSafeRelativePath(remainder))
+        return null;
+    if (isUnderMossbearDir(remainder) || isSkillGuidePath(remainder))
+        return null;
+    return remainder;
+}
+export function classifyLocalItemPath(path) {
+    const guidePath = guidePathFromEvalShadow(path);
+    if (guidePath !== null)
+        return { kind: 'eval', guidePath };
+    // Everything else under `.mossbear/` is Mossbear's own state (`docs.json`, the repo
+    // config, pulled `context/`) — and an unusable shadow path (`.mossbear/evals/..`)
+    // lands here too. Never guidance either way.
+    if (isUnderMossbearDir(path))
+        return { kind: 'other' };
+    const format = detectFormat(toPosix(path));
+    return format === null ? { kind: 'other' } : { kind: 'guide', format };
+}
+//# sourceMappingURL=eval-path.js.map

package/dist/eval-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval-path.js","sourceRoot":"","sources":["../src/eval-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,OAAO,GACR,MAAM,iBAAiB,CAAA;AAIxB,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAA;AAEhD,MAAM,oBAAoB,GAAG,WAAW,CAAA;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACrC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAA;IAChD,IAAI,kBAAkB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/C,IAAI,gBAAgB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAA;IAE7C,MAAM,UAAU,GAAG,GAAG,eAAe,IAAI,UAAU,EAAE,CAAA;IACrD,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,8BAA8B;IAC9B,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAA;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IACvC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IAEhF,4EAA4E;IAC5E,8EAA8E;IAC9E,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/C,IAAI,kBAAkB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7E,OAAO,SAAS,CAAA;AAClB,CAAC;AAkBD,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IAC1D,oFAAoF;IACpF,kFAAkF;IAClF,6CAA6C;IAC7C,IAAI,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAEtD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1C,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AACxE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @mossbear/projections
+ *
+ * Pure projection logic for canonical AGENTS.md and .agents/ outputs,
+ * plus compatibility exporters for platform-native formats.
+ * This package must remain importable outside the CLI package.
+ */
+export * from './agents-md.js';
+export * from './eval-path.js';
+export * from './agents-dir.js';
+export * from './claude-md.js';
+export * from './claude-rules.js';
+export * from './compatibility-attribution.js';
+export * from './cursor-rules.js';
+export * from './detect-format.js';
+export * from './skill-member-path.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @mossbear/projections
+ *
+ * Pure projection logic for canonical AGENTS.md and .agents/ outputs,
+ * plus compatibility exporters for platform-native formats.
+ * This package must remain importable outside the CLI package.
+ */
+export * from './agents-md.js';
+export * from './eval-path.js';
+export * from './agents-dir.js';
+export * from './claude-md.js';
+export * from './claude-rules.js';
+export * from './compatibility-attribution.js';
+export * from './cursor-rules.js';
+export * from './detect-format.js';
+export * from './skill-member-path.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}

package/dist/path-rules.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The scope-relative path predicates that both attached-file derivations share.
+ *
+ * A guide's attached files land in two different places depending on the guide's
+ * shape — a plain guide's criteria go to the eval shadow tree (`eval-path.ts`), a
+ * skill's members go inside its own directory (`skill-member-path.ts`) — but both
+ * derivations answer the same safety questions first, and a second copy of those
+ * answers is a second thing to get wrong. They live here so the two derivations
+ * cannot drift on what counts as a safe path or as a skill.
+ */
+export declare function toPosix(path: string): string;
+export declare function isSafeRelativePath(path: string): boolean;
+/**
+ * Split a scope-relative path into its lower-cased segments.
+ *
+ * Lower-cased because recognition and derivation pull in opposite directions:
+ * a shadow path is *written* as exactly `.mossbear/evals/…`, but on a
+ * case-insensitive filesystem `.Mossbear/Evals/AGENTS.md` names the same file, and
+ * the two ways of being wrong about it are not symmetric — classifying eval
+ * criteria as guidance hands a rubric to an agent as instructions, while
+ * classifying a stray capitalised path as eval content merely declines to treat
+ * it as a guide. Recognition therefore leans the safe way.
+ */
+export declare function segmentsOf(path: string): string[];
+/** True when `path` is inside `.mossbear/`, whatever it holds. */
+export declare function isUnderMossbearDir(path: string): boolean;
+/**
+ * True when a path is a skill's own `SKILL.md`.
+ *
+ * The rule is *the attached file lives with its guide*, and a skill's guide is a
+ * directory — so its criteria are the positional `EVAL.md` inside it and its
+ * members are the rest of that directory
+ * (`skillMemberContentType`, `apps/dashboard/src/server/rules/skillMembers.ts:60-66`).
+ * Shadowing a skill as well would put one skill's rubric in two places, split it
+ * out of the directory that makes a skill portable, and hand the next reconciler
+ * two rows to disagree over — the "two shapes of one fact" CLAUDE.md → Simplicity
+ * refuses. `detectFormat` is the same test discovery uses, so what counts as a
+ * skill here cannot drift from what counts as one there.
+ *
+ * This one predicate partitions the two derivations: `evalShadowPath` returns
+ * null exactly where this is true, and `skillMemberPath` returns null exactly
+ * where it is false.
+ */
+export declare function isSkillGuidePath(path: string): boolean;
+//# sourceMappingURL=path-rules.d.ts.map

package/dist/path-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-rules.d.ts","sourceRoot":"","sources":["../src/path-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}