@mmnto/mcp 1.14.10 → 1.14.11

package/dist/schemas/describe-project.test.js

@@ -0,0 +1,117 @@
+import { describe, expect, it } from 'vitest';
+import { DescribeProjectInputSchema, DescribeProjectOutputSchema, GitStateSchema, MilestoneStateSchema, RECENT_PRS_COUNT, RichProjectStateSchema, RuleCountsSchema, StrategyPointerSchema, UNCOMMITTED_FILES_CAP, } from './describe-project.js';
+describe('DescribeProjectInputSchema', () => {
+    it('accepts empty input and defaults includeRichState to false', () => {
+        const parsed = DescribeProjectInputSchema.parse({});
+        expect(parsed.includeRichState).toBe(false);
+    });
+    it('accepts explicit includeRichState false', () => {
+        const parsed = DescribeProjectInputSchema.parse({ includeRichState: false });
+        expect(parsed.includeRichState).toBe(false);
+    });
+    it('accepts explicit includeRichState true', () => {
+        const parsed = DescribeProjectInputSchema.parse({ includeRichState: true });
+        expect(parsed.includeRichState).toBe(true);
+    });
+    it('rejects non-boolean includeRichState', () => {
+        expect(() => DescribeProjectInputSchema.parse({ includeRichState: 'yes' })).toThrow();
+    });
+});
+describe('DescribeProjectOutputSchema backward compatibility', () => {
+    const legacyShape = {
+        project: 'test',
+        tier: 'standard',
+        rules: 10,
+        lessons: 5,
+        targets: ['**/*.ts (code/typescript-ast)'],
+        partitions: { core: ['packages/core/'] },
+        hooks: ['pre-push'],
+    };
+    it('accepts legacy shape without richState', () => {
+        const parsed = DescribeProjectOutputSchema.parse(legacyShape);
+        expect(parsed.richState).toBeUndefined();
+    });
+    it('accepts legacy shape with richState populated', () => {
+        const rich = {
+            strategyPointer: { sha: 'abc1234', latestJournal: '2026-04-16-session.md' },
+            gitState: { branch: 'main', uncommittedFiles: [], truncated: false },
+            packageVersions: { '@mmnto/cli': '1.14.10' },
+            ruleCounts: { active: 10, archived: 2, nonCompilable: 3 },
+            lessonCount: 5,
+            testCount: null,
+            milestone: { name: '1.15.0', gateTickets: ['#1479'], bestEffort: true },
+            recentPrs: [{ title: 'feat: foo (#1)', date: '2026-04-16T00:00:00Z', squashSha: 'abcd123' }],
+        };
+        const parsed = DescribeProjectOutputSchema.parse({ ...legacyShape, richState: rich });
+        expect(parsed.richState?.ruleCounts.active).toBe(10);
+    });
+    it('rejects malformed richState', () => {
+        expect(() => DescribeProjectOutputSchema.parse({
+            ...legacyShape,
+            richState: { strategyPointer: 'not an object' },
+        })).toThrow();
+    });
+});
+describe('GitStateSchema', () => {
+    it('accepts null branch (outside git repo)', () => {
+        const parsed = GitStateSchema.parse({ branch: null, uncommittedFiles: [], truncated: false });
+        expect(parsed.branch).toBeNull();
+    });
+    it('accepts branch + files + truncation marker', () => {
+        const parsed = GitStateSchema.parse({
+            branch: 'main',
+            uncommittedFiles: ['a.ts', 'b.ts'],
+            truncated: true,
+        });
+        expect(parsed.truncated).toBe(true);
+    });
+});
+describe('RuleCountsSchema', () => {
+    it('rejects negative counts', () => {
+        expect(() => RuleCountsSchema.parse({ active: -1, archived: 0, nonCompilable: 0 })).toThrow();
+    });
+    it('rejects non-integer counts', () => {
+        expect(() => RuleCountsSchema.parse({ active: 1.5, archived: 0, nonCompilable: 0 })).toThrow();
+    });
+});
+describe('MilestoneStateSchema', () => {
+    it('requires bestEffort literal true', () => {
+        expect(() => MilestoneStateSchema.parse({ name: null, gateTickets: [], bestEffort: false })).toThrow();
+    });
+    it('accepts null name with empty gateTickets', () => {
+        const parsed = MilestoneStateSchema.parse({
+            name: null,
+            gateTickets: [],
+            bestEffort: true,
+        });
+        expect(parsed.name).toBeNull();
+    });
+});
+describe('StrategyPointerSchema', () => {
+    it('allows both fields null (no submodule)', () => {
+        const parsed = StrategyPointerSchema.parse({ sha: null, latestJournal: null });
+        expect(parsed.sha).toBeNull();
+    });
+});
+describe('RichProjectStateSchema', () => {
+    it('allows testCount: null explicitly', () => {
+        const parsed = RichProjectStateSchema.parse({
+            strategyPointer: { sha: null, latestJournal: null },
+            gitState: { branch: null, uncommittedFiles: [], truncated: false },
+            packageVersions: {},
+            ruleCounts: { active: 0, archived: 0, nonCompilable: 0 },
+            lessonCount: 0,
+            testCount: null,
+            milestone: { name: null, gateTickets: [], bestEffort: true },
+            recentPrs: [],
+        });
+        expect(parsed.testCount).toBeNull();
+    });
+});
+describe('constants', () => {
+    it('caps match the design doc', () => {
+        expect(UNCOMMITTED_FILES_CAP).toBe(50);
+        expect(RECENT_PRS_COUNT).toBe(5);
+    });
+});
+//# sourceMappingURL=describe-project.test.js.map

package/dist/schemas/describe-project.test.js.map

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

package/dist/state-extractors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * State extractors for the rich `describe_project` payload.
+ *
+ * Each extractor reads from local git, filesystem, or stored-state files and
+ * returns its schema shape. On missing source files or non-zero git exit,
+ * extractors degrade gracefully (null / 0 / []) rather than throwing, so the
+ * MCP handler can compose a partial payload instead of crashing.
+ *
+ * ADR-090 substrate invariant: no LLM calls, no live npm/github registry
+ * calls. Every function reads only from disk or local git state.
+ */
+import { type GitState, type MilestoneState, type RecentPr, type RuleCounts, type StrategyPointer } from './schemas/describe-project.js';
+export declare function extractGitState(cwd: string): GitState;
+export declare function extractStrategyPointer(cwd: string): StrategyPointer;
+export declare function extractPackageVersions(cwd: string): Record<string, string>;
+export declare function extractRuleCounts(cwd: string, totemDir: string): RuleCounts;
+export declare function extractLessonCount(cwd: string, totemDir: string): number;
+/**
+ * Regex-parse the milestone name and gate-ticket list from active_work.md.
+ * This is explicitly best-effort — the markdown format can drift.
+ * `bestEffort: true` signals to agents that the values are a hint, not a
+ * ground-truth source.
+ */
+export declare function extractMilestoneState(cwd: string): MilestoneState;
+/**
+ * Stored test-count artifact does not exist in v1. Follow-up ticket wires
+ * postmerge to stamp `.totem/store/test-stats.json` after `pnpm test` runs;
+ * until then the endpoint reports null honestly rather than fabricate a
+ * number.
+ */
+export declare function extractTestCount(_cwd: string): number | null;
+/**
+ * Capture squash-merge commits whose subject references a PR number
+ * (`... (#NNNN)`). Skips commits whose message lacks a PR tag so we do not
+ * include non-PR merges like the Version Packages auto-commit in some flows.
+ */
+export declare function extractRecentPrs(cwd: string, limit?: number): RecentPr[];
+//# sourceMappingURL=state-extractors.d.ts.map

package/dist/state-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-extractors.d.ts","sourceRoot":"","sources":["../src/state-extractors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,cAAc,EAEnB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AAYvC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CA+BrD;AAID,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA+BnE;AAID,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkC1E;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAuB3E;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASxE;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAoCjE;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5D;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAmB,GAAG,QAAQ,EAAE,CAyClF"}

package/dist/state-extractors.js

@@ -0,0 +1,259 @@
+/**
+ * State extractors for the rich `describe_project` payload.
+ *
+ * Each extractor reads from local git, filesystem, or stored-state files and
+ * returns its schema shape. On missing source files or non-zero git exit,
+ * extractors degrade gracefully (null / 0 / []) rather than throwing, so the
+ * MCP handler can compose a partial payload instead of crashing.
+ *
+ * ADR-090 substrate invariant: no LLM calls, no live npm/github registry
+ * calls. Every function reads only from disk or local git state.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CompiledRulesFileSchema, readJsonSafe, resolveGitRoot, safeExec } from '@mmnto/totem';
+import { RECENT_PRS_COUNT, UNCOMMITTED_FILES_CAP, } from './schemas/describe-project.js';
+/** Fixed-group package names whose versions show in the briefing. */
+const FIXED_GROUP_PACKAGES = [
+    '@mmnto/totem',
+    '@mmnto/cli',
+    '@mmnto/mcp',
+    '@totem/pack-agent-security',
+];
+// ─── Git state ─────────────────────────────────────────────────────────────
+export function extractGitState(cwd) {
+    if (resolveGitRoot(cwd) === null) {
+        return { branch: null, uncommittedFiles: [], truncated: false };
+    }
+    let branch = null;
+    try {
+        const out = safeExec('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd });
+        branch = out === 'HEAD' ? null : out;
+        // totem-context: ADR-090 substrate graceful degradation — partial payload over crash.
+    }
+    catch {
+        branch = null;
+    }
+    let allFiles = [];
+    try {
+        const porcelain = safeExec('git', ['status', '--porcelain'], { cwd });
+        if (porcelain.length > 0) {
+            allFiles = porcelain
+                .split(/\r?\n/)
+                .map((line) => line.slice(3).trim())
+                .filter((name) => name.length > 0);
+        }
+        // totem-context: ADR-090 substrate graceful degradation — empty file list on git-status failure.
+    }
+    catch {
+        allFiles = [];
+    }
+    const truncated = allFiles.length > UNCOMMITTED_FILES_CAP;
+    const uncommittedFiles = truncated ? allFiles.slice(0, UNCOMMITTED_FILES_CAP) : allFiles;
+    return { branch, uncommittedFiles, truncated };
+}
+// ─── Strategy submodule pointer ────────────────────────────────────────────
+export function extractStrategyPointer(cwd) {
+    const strategyDir = path.join(cwd, '.strategy');
+    if (!fs.existsSync(strategyDir)) {
+        return { sha: null, latestJournal: null };
+    }
+    let sha = null;
+    try {
+        const full = safeExec('git', ['rev-parse', 'HEAD'], { cwd: strategyDir });
+        sha = full.length >= 7 ? full.slice(0, 7) : null;
+        // totem-context: ADR-090 substrate graceful degradation — null sha on uninitialized submodule.
+    }
+    catch {
+        sha = null;
+    }
+    let latestJournal = null;
+    try {
+        const journalDir = path.join(strategyDir, '.journal');
+        if (fs.existsSync(journalDir)) {
+            const entries = fs
+                .readdirSync(journalDir)
+                .filter((f) => f.endsWith('.md'))
+                .sort();
+            latestJournal = entries.length > 0 ? entries[entries.length - 1] : null;
+        }
+        // totem-context: ADR-090 substrate graceful degradation — null when .journal/ unreachable.
+    }
+    catch {
+        latestJournal = null;
+    }
+    return { sha, latestJournal };
+}
+// ─── Package versions (fixed group only) ───────────────────────────────────
+export function extractPackageVersions(cwd) {
+    const result = {};
+    const packagesDir = path.join(cwd, 'packages');
+    if (!fs.existsSync(packagesDir))
+        return result;
+    let subdirs;
+    try {
+        subdirs = fs.readdirSync(packagesDir);
+        // totem-context: ADR-090 substrate graceful degradation — empty map on unreadable packages/.
+    }
+    catch {
+        return result;
+    }
+    for (const subdir of subdirs) {
+        const pkgJson = path.join(packagesDir, subdir, 'package.json');
+        try {
+            const parsed = readJsonSafe(pkgJson);
+            // readJsonSafe types the shape but does not enforce runtime invariants.
+            // A hand-edited package.json with a numeric version or non-string name
+            // would otherwise leak a malformed value into the response (CR catch on
+            // #1506).
+            if (typeof parsed.name === 'string' &&
+                typeof parsed.version === 'string' &&
+                FIXED_GROUP_PACKAGES.includes(parsed.name)) {
+                result[parsed.name] = parsed.version;
+            }
+            // totem-context: ADR-090 substrate graceful degradation — per-package skip on parse failure.
+        }
+        catch {
+            // Missing / unparseable package.json is a non-fatal skip.
+        }
+    }
+    return result;
+}
+// ─── Rule counts from .totem/compiled-rules.json ───────────────────────────
+export function extractRuleCounts(cwd, totemDir) {
+    const rulesPath = path.join(cwd, totemDir, 'compiled-rules.json');
+    if (!fs.existsSync(rulesPath)) {
+        return { active: 0, archived: 0, nonCompilable: 0 };
+    }
+    try {
+        const parsed = readJsonSafe(rulesPath, CompiledRulesFileSchema);
+        let active = 0;
+        let archived = 0;
+        for (const rule of parsed.rules) {
+            if (rule.status === 'archived')
+                archived += 1;
+            else
+                active += 1;
+        }
+        return {
+            active,
+            archived,
+            nonCompilable: parsed.nonCompilable?.length ?? 0,
+        };
+        // totem-context: ADR-090 substrate graceful degradation — zero counts on malformed manifest.
+    }
+    catch {
+        return { active: 0, archived: 0, nonCompilable: 0 };
+    }
+}
+// ─── Lesson count ──────────────────────────────────────────────────────────
+export function extractLessonCount(cwd, totemDir) {
+    const lessonsDir = path.join(cwd, totemDir, 'lessons');
+    if (!fs.existsSync(lessonsDir))
+        return 0;
+    try {
+        return fs.readdirSync(lessonsDir).filter((f) => f.endsWith('.md')).length;
+        // totem-context: ADR-090 substrate graceful degradation — zero count on unreadable lessons/.
+    }
+    catch {
+        return 0;
+    }
+}
+// ─── Milestone + gate tickets from docs/active_work.md ─────────────────────
+/**
+ * Regex-parse the milestone name and gate-ticket list from active_work.md.
+ * This is explicitly best-effort — the markdown format can drift.
+ * `bestEffort: true` signals to agents that the values are a hint, not a
+ * ground-truth source.
+ */
+export function extractMilestoneState(cwd) {
+    // totem-context: ADR-090 + #1497 canonical briefing-source path, not a config omission.
+    const activeWorkPath = path.join(cwd, 'docs', 'active_work.md');
+    if (!fs.existsSync(activeWorkPath)) {
+        return { name: null, gateTickets: [], bestEffort: true };
+    }
+    let content;
+    try {
+        content = fs.readFileSync(activeWorkPath, 'utf-8');
+        // totem-context: ADR-090 substrate graceful degradation + intentional unstaged-disk read.
+    }
+    catch {
+        return { name: null, gateTickets: [], bestEffort: true };
+    }
+    // Milestone: first "### Current: X.Y.Z" heading (the doc has exactly one).
+    let name = null;
+    // totem-context: single-match by design — one Current heading; matchAll would obscure intent.
+    const currentMatch = content.match(/^###\s+Current:\s*(\d+\.\d+\.\d+)/m);
+    if (currentMatch?.[1] !== undefined)
+        name = currentMatch[1];
+    // Gate tickets: unique `#NNNN` refs inside code spans across the doc body.
+    // The lint-rule registry carries lesson hashes with similar `#` prefixes, so
+    // require 3-5 digits and cap at 200 entries to keep the payload tight.
+    const tickets = new Set();
+    const ticketRe = /#(\d{3,5})\b/g;
+    for (const match of content.matchAll(ticketRe)) {
+        tickets.add(`#${match[1]}`);
+        if (tickets.size >= 200)
+            break;
+    }
+    return {
+        name,
+        gateTickets: Array.from(tickets),
+        bestEffort: true,
+    };
+}
+// ─── Test count (v1: always null) ──────────────────────────────────────────
+/**
+ * Stored test-count artifact does not exist in v1. Follow-up ticket wires
+ * postmerge to stamp `.totem/store/test-stats.json` after `pnpm test` runs;
+ * until then the endpoint reports null honestly rather than fabricate a
+ * number.
+ */
+export function extractTestCount(_cwd) {
+    return null;
+}
+// ─── Recent merged PRs from git log ────────────────────────────────────────
+/**
+ * Capture squash-merge commits whose subject references a PR number
+ * (`... (#NNNN)`). Skips commits whose message lacks a PR tag so we do not
+ * include non-PR merges like the Version Packages auto-commit in some flows.
+ */
+export function extractRecentPrs(cwd, limit = RECENT_PRS_COUNT) {
+    if (resolveGitRoot(cwd) === null)
+        return [];
+    // Unit separator (0x1f) is ASCII-reserved for field delimiting and never
+    // appears in commit subjects, unlike `|` which GCA flagged on #1506 as a
+    // correctness risk since commit messages routinely contain pipes.
+    const FIELD_SEP = '\x1f';
+    let raw;
+    try {
+        raw = safeExec('git', [
+            'log',
+            '-n',
+            String(limit * 3),
+            '--grep=#[0-9]\\+',
+            `--format=%s${FIELD_SEP}%cI${FIELD_SEP}%h`,
+        ], { cwd });
+        // totem-context: ADR-090 substrate graceful degradation — empty list on git-log failure.
+    }
+    catch {
+        return [];
+    }
+    if (raw.length === 0)
+        return [];
+    const results = [];
+    for (const line of raw.split(/\r?\n/)) {
+        const [title, date, squashSha] = line.split(FIELD_SEP);
+        if (title === undefined ||
+            date === undefined ||
+            squashSha === undefined ||
+            !/#\d+/.test(title)) {
+            continue;
+        }
+        results.push({ title, date, squashSha });
+        if (results.length >= limit)
+            break;
+    }
+    return results;
+}
+//# sourceMappingURL=state-extractors.js.map

package/dist/state-extractors.js.map

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

package/dist/state-extractors.test.d.ts

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

package/dist/state-extractors.test.d.ts.map

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

package/dist/state-extractors.test.js

@@ -0,0 +1,193 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+// packages/mcp/src -> packages/mcp -> packages -> repo root
+const REPO_ROOT = path.resolve(__dirname, '..', '..', '..');
+import { UNCOMMITTED_FILES_CAP } from './schemas/describe-project.js';
+import { extractGitState, extractLessonCount, extractMilestoneState, extractPackageVersions, extractRecentPrs, extractRuleCounts, extractStrategyPointer, extractTestCount, } from './state-extractors.js';
+describe('extractGitState', () => {
+    it('returns null/empty for a non-git directory', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-nogit-'));
+        try {
+            const state = extractGitState(tmp);
+            expect(state.branch).toBeNull();
+            expect(state.uncommittedFiles).toEqual([]);
+            expect(state.truncated).toBe(false);
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('returns branch (or null on detached HEAD) and staged/unstaged files on the live repo', () => {
+        const state = extractGitState(REPO_ROOT);
+        // GitHub Actions checks out the merge commit in detached HEAD, so branch
+        // legitimately resolves to null there. Locally it is a string. Either is
+        // valid; the important invariant is that the call does not throw.
+        if (state.branch !== null) {
+            expect(state.branch).toBeTypeOf('string');
+            expect(state.branch.length).toBeGreaterThan(0);
+        }
+        expect(state.uncommittedFiles.length).toBeLessThanOrEqual(UNCOMMITTED_FILES_CAP);
+        // If a truncation happened the cap must be hit exactly.
+        if (state.truncated) {
+            expect(state.uncommittedFiles.length).toBe(UNCOMMITTED_FILES_CAP);
+        }
+    });
+});
+describe('extractStrategyPointer', () => {
+    it('returns null/null when .strategy/ is absent', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-nostrat-'));
+        try {
+            const ptr = extractStrategyPointer(tmp);
+            expect(ptr.sha).toBeNull();
+            expect(ptr.latestJournal).toBeNull();
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('returns a 7-char SHA and a journal filename on the live repo', () => {
+        const ptr = extractStrategyPointer(REPO_ROOT);
+        if (ptr.sha !== null) {
+            expect(ptr.sha).toMatch(/^[0-9a-f]{7}$/);
+        }
+        if (ptr.latestJournal !== null) {
+            expect(ptr.latestJournal).toMatch(/\.md$/);
+        }
+    });
+});
+describe('extractPackageVersions', () => {
+    it('returns {} when packages/ is missing', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-nopkg-'));
+        try {
+            expect(extractPackageVersions(tmp)).toEqual({});
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('captures fixed-group versions on the live repo', () => {
+        const versions = extractPackageVersions(REPO_ROOT);
+        // Whichever of the fixed-group packages exist must carry a version string.
+        for (const pkgName of Object.keys(versions)) {
+            expect(versions[pkgName]).toMatch(/^\d+\.\d+\.\d+/);
+        }
+        // At least one of the headline packages must be present on the self-host.
+        expect(versions['@mmnto/cli'] !== undefined || versions['@mmnto/totem'] !== undefined).toBe(true);
+    });
+});
+describe('extractRuleCounts', () => {
+    it('returns zeros when compiled-rules.json is missing', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-norules-'));
+        try {
+            const counts = extractRuleCounts(tmp, '.totem');
+            expect(counts).toEqual({ active: 0, archived: 0, nonCompilable: 0 });
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('returns zeros when compiled-rules.json is malformed', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-badrules-'));
+        try {
+            fs.mkdirSync(path.join(tmp, '.totem'));
+            fs.writeFileSync(path.join(tmp, '.totem', 'compiled-rules.json'), '{ broken json');
+            const counts = extractRuleCounts(tmp, '.totem');
+            expect(counts).toEqual({ active: 0, archived: 0, nonCompilable: 0 });
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('splits active from archived on the live repo', () => {
+        const counts = extractRuleCounts(REPO_ROOT, '.totem');
+        expect(counts.active).toBeGreaterThan(0);
+        expect(counts.archived).toBeGreaterThanOrEqual(0);
+        expect(counts.nonCompilable).toBeGreaterThanOrEqual(0);
+    });
+});
+describe('extractLessonCount', () => {
+    it('returns 0 when lessons/ is missing', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-nolessons-'));
+        try {
+            expect(extractLessonCount(tmp, '.totem')).toBe(0);
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('returns the live lesson count', () => {
+        expect(extractLessonCount(REPO_ROOT, '.totem')).toBeGreaterThan(0);
+    });
+});
+describe('extractMilestoneState', () => {
+    it('returns null/empty with bestEffort=true when active_work.md is missing', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-noactive-'));
+        try {
+            const state = extractMilestoneState(tmp);
+            expect(state).toEqual({ name: null, gateTickets: [], bestEffort: true });
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('parses milestone and tickets on the live repo', () => {
+        const state = extractMilestoneState(REPO_ROOT);
+        expect(state.bestEffort).toBe(true);
+        // Milestone value depends on the current doc; just enforce the shape contract.
+        if (state.name !== null) {
+            expect(state.name).toMatch(/^\d+\.\d+\.\d+$/);
+        }
+        // Ticket list should never include legacy 1-2 digit fragments and should
+        // not explode past the 200-entry safety cap.
+        expect(state.gateTickets.length).toBeLessThanOrEqual(200);
+        for (const ticket of state.gateTickets) {
+            expect(ticket).toMatch(/^#\d{3,5}$/);
+        }
+    });
+});
+describe('extractTestCount', () => {
+    it('always returns null in v1', () => {
+        expect(extractTestCount(REPO_ROOT)).toBeNull();
+    });
+});
+describe('extractRecentPrs', () => {
+    it('returns [] for a non-git directory', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-norecent-'));
+        try {
+            expect(extractRecentPrs(tmp)).toEqual([]);
+        }
+        finally {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it('returns up to the requested limit, newest first on the live repo', () => {
+        const prs = extractRecentPrs(REPO_ROOT, 5);
+        expect(prs.length).toBeLessThanOrEqual(5);
+        for (const pr of prs) {
+            expect(pr.title).toMatch(/#\d+/);
+            expect(pr.squashSha).toMatch(/^[0-9a-f]{7,12}$/);
+            expect(() => new Date(pr.date).toISOString()).not.toThrow();
+        }
+        if (prs.length >= 2) {
+            const t0 = new Date(prs[0].date).getTime();
+            const t1 = new Date(prs[1].date).getTime();
+            expect(t0).toBeGreaterThanOrEqual(t1);
+        }
+    });
+});
+describe('temp dir cleanup safety', () => {
+    // Smoke test: verify rmSync pattern from earlier tests does not leak.
+    let tmp;
+    beforeEach(() => {
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-mcp-cleanup-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmp, { recursive: true, force: true });
+    });
+    it('temp dir exists inside the test', () => {
+        expect(fs.existsSync(tmp)).toBe(true);
+    });
+});
+//# sourceMappingURL=state-extractors.test.js.map