@mmnto/mcp 1.14.10 → 1.14.11

package/dist/schemas/describe-project.d.ts

@@ -0,0 +1,533 @@
+/**
+ * Zod schemas for the describe_project MCP tool.
+ *
+ * The legacy slim payload (project, tier, rules, lessons, targets, partitions,
+ * hooks) is preserved byte-identical when `includeRichState` is false or
+ * omitted. Rich state is opt-in via the input parameter and attaches as an
+ * optional `richState` field on the output.
+ *
+ * Implements ADR-090 Deferred Decision #2 (describe_project as substrate:
+ * reports state, self-routing remains the agent's decision).
+ */
+import { z } from 'zod';
+/**
+ * Cap the uncommitted-files list to protect the MCP stdio pipe and the
+ * consuming agent's context window. A dirty tree with thousands of staged
+ * files should still produce a useful briefing payload.
+ */
+export declare const UNCOMMITTED_FILES_CAP = 50;
+/**
+ * Number of recent merged PRs returned in the briefing. Keep small so the
+ * payload stays fast and the agent sees the most relevant history.
+ */
+export declare const RECENT_PRS_COUNT = 5;
+/**
+ * `.default(false)` keeps legacy callers (empty input object) byte-identical
+ * to today's output. Opt-in is the only path that extends the response shape.
+ */
+export declare const DescribeProjectInputSchema: z.ZodObject<{
+    includeRichState: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    includeRichState: boolean;
+}, {
+    includeRichState?: boolean | undefined;
+}>;
+export type DescribeProjectInput = z.infer<typeof DescribeProjectInputSchema>;
+export declare const StrategyPointerSchema: z.ZodObject<{
+    /** Short-form 7-char SHA of the strategy submodule HEAD. Null when no submodule. */
+    sha: z.ZodNullable<z.ZodString>;
+    /** Filename of the most recent `.strategy/.journal/*.md` entry, no path. */
+    latestJournal: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sha: string | null;
+    latestJournal: string | null;
+}, {
+    sha: string | null;
+    latestJournal: string | null;
+}>;
+export type StrategyPointer = z.infer<typeof StrategyPointerSchema>;
+export declare const GitStateSchema: z.ZodObject<{
+    /** Current branch name. Null when running outside a git repo or in detached HEAD. */
+    branch: z.ZodNullable<z.ZodString>;
+    /** Uncommitted files (staged + unstaged). Capped at UNCOMMITTED_FILES_CAP. */
+    uncommittedFiles: z.ZodArray<z.ZodString, "many">;
+    /** True when the real uncommitted count exceeded UNCOMMITTED_FILES_CAP. */
+    truncated: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    branch: string | null;
+    uncommittedFiles: string[];
+    truncated: boolean;
+}, {
+    branch: string | null;
+    uncommittedFiles: string[];
+    truncated: boolean;
+}>;
+export type GitState = z.infer<typeof GitStateSchema>;
+export declare const RecentPrSchema: z.ZodObject<{
+    /** Squash-merge commit title including the `(#NNNN)` PR suffix. */
+    title: z.ZodString;
+    /** ISO-8601 commit date. */
+    date: z.ZodString;
+    /** Short-form 7-char commit SHA. */
+    squashSha: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    date: string;
+    title: string;
+    squashSha: string;
+}, {
+    date: string;
+    title: string;
+    squashSha: string;
+}>;
+export type RecentPr = z.infer<typeof RecentPrSchema>;
+export declare const RuleCountsSchema: z.ZodObject<{
+    active: z.ZodNumber;
+    archived: z.ZodNumber;
+    nonCompilable: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    active: number;
+    archived: number;
+    nonCompilable: number;
+}, {
+    active: number;
+    archived: number;
+    nonCompilable: number;
+}>;
+export type RuleCounts = z.infer<typeof RuleCountsSchema>;
+export declare const MilestoneStateSchema: z.ZodObject<{
+    /** Milestone name (e.g. "1.15.0"). Null when not parseable from active_work.md. */
+    name: z.ZodNullable<z.ZodString>;
+    /** List of ticket references carrying the active gate label (e.g. pre-1.15-review). */
+    gateTickets: z.ZodArray<z.ZodString, "many">;
+    /**
+     * Marks this payload as parsed best-effort from `docs/active_work.md` and
+     * not a cryptographic truth. Agents should treat it as a hint, not a
+     * ground-truth source.
+     */
+    bestEffort: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    name: string | null;
+    gateTickets: string[];
+    bestEffort: true;
+}, {
+    name: string | null;
+    gateTickets: string[];
+    bestEffort: true;
+}>;
+export type MilestoneState = z.infer<typeof MilestoneStateSchema>;
+export declare const RichProjectStateSchema: z.ZodObject<{
+    strategyPointer: z.ZodObject<{
+        /** Short-form 7-char SHA of the strategy submodule HEAD. Null when no submodule. */
+        sha: z.ZodNullable<z.ZodString>;
+        /** Filename of the most recent `.strategy/.journal/*.md` entry, no path. */
+        latestJournal: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        sha: string | null;
+        latestJournal: string | null;
+    }, {
+        sha: string | null;
+        latestJournal: string | null;
+    }>;
+    gitState: z.ZodObject<{
+        /** Current branch name. Null when running outside a git repo or in detached HEAD. */
+        branch: z.ZodNullable<z.ZodString>;
+        /** Uncommitted files (staged + unstaged). Capped at UNCOMMITTED_FILES_CAP. */
+        uncommittedFiles: z.ZodArray<z.ZodString, "many">;
+        /** True when the real uncommitted count exceeded UNCOMMITTED_FILES_CAP. */
+        truncated: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        branch: string | null;
+        uncommittedFiles: string[];
+        truncated: boolean;
+    }, {
+        branch: string | null;
+        uncommittedFiles: string[];
+        truncated: boolean;
+    }>;
+    /** Fixed-group package versions (e.g. `@mmnto/cli`). Entries omit when extraction fails for that package. */
+    packageVersions: z.ZodRecord<z.ZodString, z.ZodString>;
+    ruleCounts: z.ZodObject<{
+        active: z.ZodNumber;
+        archived: z.ZodNumber;
+        nonCompilable: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        active: number;
+        archived: number;
+        nonCompilable: number;
+    }, {
+        active: number;
+        archived: number;
+        nonCompilable: number;
+    }>;
+    /** Count of `.totem/lessons/*.md` files. Zero if the directory is missing. */
+    lessonCount: z.ZodNumber;
+    /**
+     * Test count from stored metadata. Null in v1 — no artifact is stamped
+     * today. Follow-up ticket wires postmerge to produce `.totem/store/test-stats.json`.
+     */
+    testCount: z.ZodNullable<z.ZodNumber>;
+    milestone: z.ZodObject<{
+        /** Milestone name (e.g. "1.15.0"). Null when not parseable from active_work.md. */
+        name: z.ZodNullable<z.ZodString>;
+        /** List of ticket references carrying the active gate label (e.g. pre-1.15-review). */
+        gateTickets: z.ZodArray<z.ZodString, "many">;
+        /**
+         * Marks this payload as parsed best-effort from `docs/active_work.md` and
+         * not a cryptographic truth. Agents should treat it as a hint, not a
+         * ground-truth source.
+         */
+        bestEffort: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        name: string | null;
+        gateTickets: string[];
+        bestEffort: true;
+    }, {
+        name: string | null;
+        gateTickets: string[];
+        bestEffort: true;
+    }>;
+    recentPrs: z.ZodArray<z.ZodObject<{
+        /** Squash-merge commit title including the `(#NNNN)` PR suffix. */
+        title: z.ZodString;
+        /** ISO-8601 commit date. */
+        date: z.ZodString;
+        /** Short-form 7-char commit SHA. */
+        squashSha: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        date: string;
+        title: string;
+        squashSha: string;
+    }, {
+        date: string;
+        title: string;
+        squashSha: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    strategyPointer: {
+        sha: string | null;
+        latestJournal: string | null;
+    };
+    gitState: {
+        branch: string | null;
+        uncommittedFiles: string[];
+        truncated: boolean;
+    };
+    packageVersions: Record<string, string>;
+    ruleCounts: {
+        active: number;
+        archived: number;
+        nonCompilable: number;
+    };
+    lessonCount: number;
+    testCount: number | null;
+    milestone: {
+        name: string | null;
+        gateTickets: string[];
+        bestEffort: true;
+    };
+    recentPrs: {
+        date: string;
+        title: string;
+        squashSha: string;
+    }[];
+}, {
+    strategyPointer: {
+        sha: string | null;
+        latestJournal: string | null;
+    };
+    gitState: {
+        branch: string | null;
+        uncommittedFiles: string[];
+        truncated: boolean;
+    };
+    packageVersions: Record<string, string>;
+    ruleCounts: {
+        active: number;
+        archived: number;
+        nonCompilable: number;
+    };
+    lessonCount: number;
+    testCount: number | null;
+    milestone: {
+        name: string | null;
+        gateTickets: string[];
+        bestEffort: true;
+    };
+    recentPrs: {
+        date: string;
+        title: string;
+        squashSha: string;
+    }[];
+}>;
+export type RichProjectState = z.infer<typeof RichProjectStateSchema>;
+/**
+ * Legacy `ProjectDescription` shape as returned by core `describeProject()`.
+ * Kept in this file for schema co-location; the source of truth is the
+ * `ProjectDescription` interface in `@mmnto/totem`.
+ */
+export declare const LegacyProjectDescriptionSchema: z.ZodObject<{
+    project: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tier: z.ZodEnum<["lite", "standard", "full"]>;
+    rules: z.ZodNumber;
+    lessons: z.ZodNumber;
+    targets: z.ZodArray<z.ZodString, "many">;
+    partitions: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+    hooks: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    lessons: number;
+    project: string;
+    tier: "lite" | "standard" | "full";
+    rules: number;
+    targets: string[];
+    partitions: Record<string, string[]>;
+    hooks: string[];
+    description?: string | undefined;
+}, {
+    lessons: number;
+    project: string;
+    tier: "lite" | "standard" | "full";
+    rules: number;
+    targets: string[];
+    partitions: Record<string, string[]>;
+    hooks: string[];
+    description?: string | undefined;
+}>;
+/**
+ * Output schema: legacy shape + optional rich state. Callers that omit
+ * `includeRichState` (or pass false) get a payload without the `richState`
+ * field at all — the JSON output is byte-identical to today's.
+ */
+export declare const DescribeProjectOutputSchema: z.ZodObject<{
+    project: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tier: z.ZodEnum<["lite", "standard", "full"]>;
+    rules: z.ZodNumber;
+    lessons: z.ZodNumber;
+    targets: z.ZodArray<z.ZodString, "many">;
+    partitions: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+    hooks: z.ZodArray<z.ZodString, "many">;
+} & {
+    richState: z.ZodOptional<z.ZodObject<{
+        strategyPointer: z.ZodObject<{
+            /** Short-form 7-char SHA of the strategy submodule HEAD. Null when no submodule. */
+            sha: z.ZodNullable<z.ZodString>;
+            /** Filename of the most recent `.strategy/.journal/*.md` entry, no path. */
+            latestJournal: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            sha: string | null;
+            latestJournal: string | null;
+        }, {
+            sha: string | null;
+            latestJournal: string | null;
+        }>;
+        gitState: z.ZodObject<{
+            /** Current branch name. Null when running outside a git repo or in detached HEAD. */
+            branch: z.ZodNullable<z.ZodString>;
+            /** Uncommitted files (staged + unstaged). Capped at UNCOMMITTED_FILES_CAP. */
+            uncommittedFiles: z.ZodArray<z.ZodString, "many">;
+            /** True when the real uncommitted count exceeded UNCOMMITTED_FILES_CAP. */
+            truncated: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            branch: string | null;
+            uncommittedFiles: string[];
+            truncated: boolean;
+        }, {
+            branch: string | null;
+            uncommittedFiles: string[];
+            truncated: boolean;
+        }>;
+        /** Fixed-group package versions (e.g. `@mmnto/cli`). Entries omit when extraction fails for that package. */
+        packageVersions: z.ZodRecord<z.ZodString, z.ZodString>;
+        ruleCounts: z.ZodObject<{
+            active: z.ZodNumber;
+            archived: z.ZodNumber;
+            nonCompilable: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            active: number;
+            archived: number;
+            nonCompilable: number;
+        }, {
+            active: number;
+            archived: number;
+            nonCompilable: number;
+        }>;
+        /** Count of `.totem/lessons/*.md` files. Zero if the directory is missing. */
+        lessonCount: z.ZodNumber;
+        /**
+         * Test count from stored metadata. Null in v1 — no artifact is stamped
+         * today. Follow-up ticket wires postmerge to produce `.totem/store/test-stats.json`.
+         */
+        testCount: z.ZodNullable<z.ZodNumber>;
+        milestone: z.ZodObject<{
+            /** Milestone name (e.g. "1.15.0"). Null when not parseable from active_work.md. */
+            name: z.ZodNullable<z.ZodString>;
+            /** List of ticket references carrying the active gate label (e.g. pre-1.15-review). */
+            gateTickets: z.ZodArray<z.ZodString, "many">;
+            /**
+             * Marks this payload as parsed best-effort from `docs/active_work.md` and
+             * not a cryptographic truth. Agents should treat it as a hint, not a
+             * ground-truth source.
+             */
+            bestEffort: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            name: string | null;
+            gateTickets: string[];
+            bestEffort: true;
+        }, {
+            name: string | null;
+            gateTickets: string[];
+            bestEffort: true;
+        }>;
+        recentPrs: z.ZodArray<z.ZodObject<{
+            /** Squash-merge commit title including the `(#NNNN)` PR suffix. */
+            title: z.ZodString;
+            /** ISO-8601 commit date. */
+            date: z.ZodString;
+            /** Short-form 7-char commit SHA. */
+            squashSha: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            date: string;
+            title: string;
+            squashSha: string;
+        }, {
+            date: string;
+            title: string;
+            squashSha: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        strategyPointer: {
+            sha: string | null;
+            latestJournal: string | null;
+        };
+        gitState: {
+            branch: string | null;
+            uncommittedFiles: string[];
+            truncated: boolean;
+        };
+        packageVersions: Record<string, string>;
+        ruleCounts: {
+            active: number;
+            archived: number;
+            nonCompilable: number;
+        };
+        lessonCount: number;
+        testCount: number | null;
+        milestone: {
+            name: string | null;
+            gateTickets: string[];
+            bestEffort: true;
+        };
+        recentPrs: {
+            date: string;
+            title: string;
+            squashSha: string;
+        }[];
+    }, {
+        strategyPointer: {
+            sha: string | null;
+            latestJournal: string | null;
+        };
+        gitState: {
+            branch: string | null;
+            uncommittedFiles: string[];
+            truncated: boolean;
+        };
+        packageVersions: Record<string, string>;
+        ruleCounts: {
+            active: number;
+            archived: number;
+            nonCompilable: number;
+        };
+        lessonCount: number;
+        testCount: number | null;
+        milestone: {
+            name: string | null;
+            gateTickets: string[];
+            bestEffort: true;
+        };
+        recentPrs: {
+            date: string;
+            title: string;
+            squashSha: string;
+        }[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    lessons: number;
+    project: string;
+    tier: "lite" | "standard" | "full";
+    rules: number;
+    targets: string[];
+    partitions: Record<string, string[]>;
+    hooks: string[];
+    description?: string | undefined;
+    richState?: {
+        strategyPointer: {
+            sha: string | null;
+            latestJournal: string | null;
+        };
+        gitState: {
+            branch: string | null;
+            uncommittedFiles: string[];
+            truncated: boolean;
+        };
+        packageVersions: Record<string, string>;
+        ruleCounts: {
+            active: number;
+            archived: number;
+            nonCompilable: number;
+        };
+        lessonCount: number;
+        testCount: number | null;
+        milestone: {
+            name: string | null;
+            gateTickets: string[];
+            bestEffort: true;
+        };
+        recentPrs: {
+            date: string;
+            title: string;
+            squashSha: string;
+        }[];
+    } | undefined;
+}, {
+    lessons: number;
+    project: string;
+    tier: "lite" | "standard" | "full";
+    rules: number;
+    targets: string[];
+    partitions: Record<string, string[]>;
+    hooks: string[];
+    description?: string | undefined;
+    richState?: {
+        strategyPointer: {
+            sha: string | null;
+            latestJournal: string | null;
+        };
+        gitState: {
+            branch: string | null;
+            uncommittedFiles: string[];
+            truncated: boolean;
+        };
+        packageVersions: Record<string, string>;
+        ruleCounts: {
+            active: number;
+            archived: number;
+            nonCompilable: number;
+        };
+        lessonCount: number;
+        testCount: number | null;
+        milestone: {
+            name: string | null;
+            gateTickets: string[];
+            bestEffort: true;
+        };
+        recentPrs: {
+            date: string;
+            title: string;
+            squashSha: string;
+        }[];
+    } | undefined;
+}>;
+export type DescribeProjectOutput = z.infer<typeof DescribeProjectOutputSchema>;
+//# sourceMappingURL=describe-project.d.ts.map

package/dist/schemas/describe-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-project.d.ts","sourceRoot":"","sources":["../../src/schemas/describe-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAIlC;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;EAErC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,eAAO,MAAM,qBAAqB;IAChC,oFAAoF;;IAEpF,4EAA4E;;;;;;;;EAE5E,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,cAAc;IACzB,qFAAqF;;IAErF,8EAA8E;;IAE9E,2EAA2E;;;;;;;;;;EAE3E,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc;IACzB,mEAAmE;;IAEnE,4BAA4B;;IAE5B,oCAAoC;;;;;;;;;;EAEpC,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;IAC/B,mFAAmF;;IAEnF,uFAAuF;;IAEvF;;;;OAIG;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,sBAAsB;;QAhDjC,oFAAoF;;QAEpF,4EAA4E;;;;;;;;;;QAM5E,qFAAqF;;QAErF,8EAA8E;;QAE9E,2EAA2E;;;;;;;;;;;IAuC3E,6GAA6G;;;;;;;;;;;;;;;IAG7G,8EAA8E;;IAE9E;;;OAGG;;;QAxBH,mFAAmF;;QAEnF,uFAAuF;;QAEvF;;;;WAIG;;;;;;;;;;;;QAzBH,mEAAmE;;QAEnE,4BAA4B;;QAE5B,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCpC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;YA1FtC,oFAAoF;;YAEpF,4EAA4E;;;;;;;;;;YAM5E,qFAAqF;;YAErF,8EAA8E;;YAE9E,2EAA2E;;;;;;;;;;;QAuC3E,6GAA6G;;;;;;;;;;;;;;;QAG7G,8EAA8E;;QAE9E;;;WAGG;;;YAxBH,mFAAmF;;YAEnF,uFAAuF;;YAEvF;;;;eAIG;;;;;;;;;;;;YAzBH,mEAAmE;;YAEnE,4BAA4B;;YAE5B,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsEpC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/schemas/describe-project.js

@@ -0,0 +1,112 @@
+/**
+ * Zod schemas for the describe_project MCP tool.
+ *
+ * The legacy slim payload (project, tier, rules, lessons, targets, partitions,
+ * hooks) is preserved byte-identical when `includeRichState` is false or
+ * omitted. Rich state is opt-in via the input parameter and attaches as an
+ * optional `richState` field on the output.
+ *
+ * Implements ADR-090 Deferred Decision #2 (describe_project as substrate:
+ * reports state, self-routing remains the agent's decision).
+ */
+import { z } from 'zod';
+/**
+ * Cap the uncommitted-files list to protect the MCP stdio pipe and the
+ * consuming agent's context window. A dirty tree with thousands of staged
+ * files should still produce a useful briefing payload.
+ */
+export const UNCOMMITTED_FILES_CAP = 50;
+/**
+ * Number of recent merged PRs returned in the briefing. Keep small so the
+ * payload stays fast and the agent sees the most relevant history.
+ */
+export const RECENT_PRS_COUNT = 5;
+// ─── Input ─────────────────────────────────────────────────────────────────
+/**
+ * `.default(false)` keeps legacy callers (empty input object) byte-identical
+ * to today's output. Opt-in is the only path that extends the response shape.
+ */
+export const DescribeProjectInputSchema = z.object({
+    includeRichState: z.boolean().optional().default(false),
+});
+// ─── Rich state sub-schemas ────────────────────────────────────────────────
+export const StrategyPointerSchema = z.object({
+    /** Short-form 7-char SHA of the strategy submodule HEAD. Null when no submodule. */
+    sha: z.string().nullable(),
+    /** Filename of the most recent `.strategy/.journal/*.md` entry, no path. */
+    latestJournal: z.string().nullable(),
+});
+export const GitStateSchema = z.object({
+    /** Current branch name. Null when running outside a git repo or in detached HEAD. */
+    branch: z.string().nullable(),
+    /** Uncommitted files (staged + unstaged). Capped at UNCOMMITTED_FILES_CAP. */
+    uncommittedFiles: z.array(z.string()),
+    /** True when the real uncommitted count exceeded UNCOMMITTED_FILES_CAP. */
+    truncated: z.boolean(),
+});
+export const RecentPrSchema = z.object({
+    /** Squash-merge commit title including the `(#NNNN)` PR suffix. */
+    title: z.string(),
+    /** ISO-8601 commit date. */
+    date: z.string(),
+    /** Short-form 7-char commit SHA. */
+    squashSha: z.string(),
+});
+export const RuleCountsSchema = z.object({
+    active: z.number().int().nonnegative(),
+    archived: z.number().int().nonnegative(),
+    nonCompilable: z.number().int().nonnegative(),
+});
+export const MilestoneStateSchema = z.object({
+    /** Milestone name (e.g. "1.15.0"). Null when not parseable from active_work.md. */
+    name: z.string().nullable(),
+    /** List of ticket references carrying the active gate label (e.g. pre-1.15-review). */
+    gateTickets: z.array(z.string()),
+    /**
+     * Marks this payload as parsed best-effort from `docs/active_work.md` and
+     * not a cryptographic truth. Agents should treat it as a hint, not a
+     * ground-truth source.
+     */
+    bestEffort: z.literal(true),
+});
+export const RichProjectStateSchema = z.object({
+    strategyPointer: StrategyPointerSchema,
+    gitState: GitStateSchema,
+    /** Fixed-group package versions (e.g. `@mmnto/cli`). Entries omit when extraction fails for that package. */
+    packageVersions: z.record(z.string()),
+    ruleCounts: RuleCountsSchema,
+    /** Count of `.totem/lessons/*.md` files. Zero if the directory is missing. */
+    lessonCount: z.number().int().nonnegative(),
+    /**
+     * Test count from stored metadata. Null in v1 — no artifact is stamped
+     * today. Follow-up ticket wires postmerge to produce `.totem/store/test-stats.json`.
+     */
+    testCount: z.number().int().nonnegative().nullable(),
+    milestone: MilestoneStateSchema,
+    recentPrs: z.array(RecentPrSchema),
+});
+// ─── Output ────────────────────────────────────────────────────────────────
+/**
+ * Legacy `ProjectDescription` shape as returned by core `describeProject()`.
+ * Kept in this file for schema co-location; the source of truth is the
+ * `ProjectDescription` interface in `@mmnto/totem`.
+ */
+export const LegacyProjectDescriptionSchema = z.object({
+    project: z.string(),
+    description: z.string().optional(),
+    tier: z.enum(['lite', 'standard', 'full']),
+    rules: z.number(),
+    lessons: z.number(),
+    targets: z.array(z.string()),
+    partitions: z.record(z.array(z.string())),
+    hooks: z.array(z.string()),
+});
+/**
+ * Output schema: legacy shape + optional rich state. Callers that omit
+ * `includeRichState` (or pass false) get a payload without the `richState`
+ * field at all — the JSON output is byte-identical to today's.
+ */
+export const DescribeProjectOutputSchema = LegacyProjectDescriptionSchema.extend({
+    richState: RichProjectStateSchema.optional(),
+});
+//# sourceMappingURL=describe-project.js.map

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

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

package/dist/schemas/describe-project.test.d.ts

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

package/dist/schemas/describe-project.test.d.ts.map

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