whywhy-mcp 0.1.0

package/dist/schema.d.ts

@@ -0,0 +1,460 @@
+import { z } from "zod";
+/**
+ * Schema definitions for whywhy.
+ *
+ * The Decision Record is the heart of the product. Everything else
+ * (store, index, tools) is built around keeping these records valid,
+ * versioned, and queryable.
+ */
+export declare const SCHEMA_VERSION: 1;
+/** Allowed decision categories (MVP). */
+export declare const CATEGORIES: readonly ["architecture", "infrastructure", "dependency", "api", "data-model", "ui", "product", "security", "performance", "process", "other"];
+export declare const CategorySchema: z.ZodEnum<["architecture", "infrastructure", "dependency", "api", "data-model", "ui", "product", "security", "performance", "process", "other"]>;
+export type Category = z.infer<typeof CategorySchema>;
+/** Lifecycle status of a decision. */
+export declare const STATUSES: readonly ["active", "superseded", "deprecated"];
+export declare const StatusSchema: z.ZodEnum<["active", "superseded", "deprecated"]>;
+export type Status = z.infer<typeof StatusSchema>;
+export declare const AlternativeSchema: z.ZodObject<{
+    option: z.ZodString;
+    reason_rejected: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    option: string;
+    reason_rejected: string;
+}, {
+    option: string;
+    reason_rejected: string;
+}>;
+export type Alternative = z.infer<typeof AlternativeSchema>;
+export declare const ConversationEvidenceSchema: z.ZodObject<{
+    summary: z.ZodString;
+    excerpt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    excerpt?: string | undefined;
+}, {
+    summary: string;
+    excerpt?: string | undefined;
+}>;
+export declare const DiffEvidenceSchema: z.ZodObject<{
+    branch: z.ZodNullable<z.ZodString>;
+    base_commit: z.ZodNullable<z.ZodString>;
+    head_commit: z.ZodNullable<z.ZodString>;
+    files_changed: z.ZodArray<z.ZodString, "many">;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    branch: string | null;
+    base_commit: string | null;
+    head_commit: string | null;
+    files_changed: string[];
+}, {
+    summary: string;
+    branch: string | null;
+    base_commit: string | null;
+    head_commit: string | null;
+    files_changed: string[];
+}>;
+export type DiffEvidence = z.infer<typeof DiffEvidenceSchema>;
+export declare const CodeCommentSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodNumber;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    line: number;
+    text: string;
+}, {
+    file: string;
+    line: number;
+    text: string;
+}>;
+export type CodeComment = z.infer<typeof CodeCommentSchema>;
+export declare const EvidenceSchema: z.ZodObject<{
+    conversation: z.ZodObject<{
+        summary: z.ZodString;
+        excerpt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        excerpt?: string | undefined;
+    }, {
+        summary: string;
+        excerpt?: string | undefined;
+    }>;
+    diff: z.ZodNullable<z.ZodObject<{
+        branch: z.ZodNullable<z.ZodString>;
+        base_commit: z.ZodNullable<z.ZodString>;
+        head_commit: z.ZodNullable<z.ZodString>;
+        files_changed: z.ZodArray<z.ZodString, "many">;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        branch: string | null;
+        base_commit: string | null;
+        head_commit: string | null;
+        files_changed: string[];
+    }, {
+        summary: string;
+        branch: string | null;
+        base_commit: string | null;
+        head_commit: string | null;
+        files_changed: string[];
+    }>>;
+    code_comments: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        line: number;
+        text: string;
+    }, {
+        file: string;
+        line: number;
+        text: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    conversation: {
+        summary: string;
+        excerpt?: string | undefined;
+    };
+    diff: {
+        summary: string;
+        branch: string | null;
+        base_commit: string | null;
+        head_commit: string | null;
+        files_changed: string[];
+    } | null;
+    code_comments: {
+        file: string;
+        line: number;
+        text: string;
+    }[];
+}, {
+    conversation: {
+        summary: string;
+        excerpt?: string | undefined;
+    };
+    diff: {
+        summary: string;
+        branch: string | null;
+        base_commit: string | null;
+        head_commit: string | null;
+        files_changed: string[];
+    } | null;
+    code_comments: {
+        file: string;
+        line: number;
+        text: string;
+    }[];
+}>;
+export type Evidence = z.infer<typeof EvidenceSchema>;
+/** A single, fully-formed decision record (one JSON file on disk). */
+export declare const DecisionRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    schema_version: z.ZodLiteral<1>;
+    title: z.ZodString;
+    category: z.ZodEnum<["architecture", "infrastructure", "dependency", "api", "data-model", "ui", "product", "security", "performance", "process", "other"]>;
+    status: z.ZodEnum<["active", "superseded", "deprecated"]>;
+    decision: z.ZodString;
+    rationale: z.ZodString;
+    alternatives_considered: z.ZodArray<z.ZodObject<{
+        option: z.ZodString;
+        reason_rejected: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        option: string;
+        reason_rejected: string;
+    }, {
+        option: string;
+        reason_rejected: string;
+    }>, "many">;
+    consequences: z.ZodString;
+    tags: z.ZodArray<z.ZodString, "many">;
+    evidence: z.ZodObject<{
+        conversation: z.ZodObject<{
+            summary: z.ZodString;
+            excerpt: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            summary: string;
+            excerpt?: string | undefined;
+        }, {
+            summary: string;
+            excerpt?: string | undefined;
+        }>;
+        diff: z.ZodNullable<z.ZodObject<{
+            branch: z.ZodNullable<z.ZodString>;
+            base_commit: z.ZodNullable<z.ZodString>;
+            head_commit: z.ZodNullable<z.ZodString>;
+            files_changed: z.ZodArray<z.ZodString, "many">;
+            summary: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            summary: string;
+            branch: string | null;
+            base_commit: string | null;
+            head_commit: string | null;
+            files_changed: string[];
+        }, {
+            summary: string;
+            branch: string | null;
+            base_commit: string | null;
+            head_commit: string | null;
+            files_changed: string[];
+        }>>;
+        code_comments: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            line: number;
+            text: string;
+        }, {
+            file: string;
+            line: number;
+            text: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        conversation: {
+            summary: string;
+            excerpt?: string | undefined;
+        };
+        diff: {
+            summary: string;
+            branch: string | null;
+            base_commit: string | null;
+            head_commit: string | null;
+            files_changed: string[];
+        } | null;
+        code_comments: {
+            file: string;
+            line: number;
+            text: string;
+        }[];
+    }, {
+        conversation: {
+            summary: string;
+            excerpt?: string | undefined;
+        };
+        diff: {
+            summary: string;
+            branch: string | null;
+            base_commit: string | null;
+            head_commit: string | null;
+            files_changed: string[];
+        } | null;
+        code_comments: {
+            file: string;
+            line: number;
+            text: string;
+        }[];
+    }>;
+    version: z.ZodNumber;
+    supersedes: z.ZodNullable<z.ZodString>;
+    superseded_by: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodString;
+    session_id: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "superseded" | "deprecated";
+    id: string;
+    schema_version: 1;
+    title: string;
+    category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+    decision: string;
+    rationale: string;
+    alternatives_considered: {
+        option: string;
+        reason_rejected: string;
+    }[];
+    consequences: string;
+    tags: string[];
+    evidence: {
+        conversation: {
+            summary: string;
+            excerpt?: string | undefined;
+        };
+        diff: {
+            summary: string;
+            branch: string | null;
+            base_commit: string | null;
+            head_commit: string | null;
+            files_changed: string[];
+        } | null;
+        code_comments: {
+            file: string;
+            line: number;
+            text: string;
+        }[];
+    };
+    version: number;
+    supersedes: string | null;
+    superseded_by: string | null;
+    created_at: string;
+    updated_at: string;
+    created_by: string;
+    session_id: string | null;
+}, {
+    status: "active" | "superseded" | "deprecated";
+    id: string;
+    schema_version: 1;
+    title: string;
+    category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+    decision: string;
+    rationale: string;
+    alternatives_considered: {
+        option: string;
+        reason_rejected: string;
+    }[];
+    consequences: string;
+    tags: string[];
+    evidence: {
+        conversation: {
+            summary: string;
+            excerpt?: string | undefined;
+        };
+        diff: {
+            summary: string;
+            branch: string | null;
+            base_commit: string | null;
+            head_commit: string | null;
+            files_changed: string[];
+        } | null;
+        code_comments: {
+            file: string;
+            line: number;
+            text: string;
+        }[];
+    };
+    version: number;
+    supersedes: string | null;
+    superseded_by: string | null;
+    created_at: string;
+    updated_at: string;
+    created_by: string;
+    session_id: string | null;
+}>;
+export type DecisionRecord = z.infer<typeof DecisionRecordSchema>;
+/** A lightweight entry kept in index.json for fast listing/search. */
+export declare const IndexEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    category: z.ZodEnum<["architecture", "infrastructure", "dependency", "api", "data-model", "ui", "product", "security", "performance", "process", "other"]>;
+    status: z.ZodEnum<["active", "superseded", "deprecated"]>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "superseded" | "deprecated";
+    id: string;
+    title: string;
+    category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+    tags: string[];
+    updated_at: string;
+}, {
+    status: "active" | "superseded" | "deprecated";
+    id: string;
+    title: string;
+    category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+    tags: string[];
+    updated_at: string;
+}>;
+export type IndexEntry = z.infer<typeof IndexEntrySchema>;
+export declare const IndexSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    next_id: z.ZodNumber;
+    decisions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        category: z.ZodEnum<["architecture", "infrastructure", "dependency", "api", "data-model", "ui", "product", "security", "performance", "process", "other"]>;
+        status: z.ZodEnum<["active", "superseded", "deprecated"]>;
+        tags: z.ZodArray<z.ZodString, "many">;
+        updated_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "active" | "superseded" | "deprecated";
+        id: string;
+        title: string;
+        category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+        tags: string[];
+        updated_at: string;
+    }, {
+        status: "active" | "superseded" | "deprecated";
+        id: string;
+        title: string;
+        category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+        tags: string[];
+        updated_at: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    next_id: number;
+    decisions: {
+        status: "active" | "superseded" | "deprecated";
+        id: string;
+        title: string;
+        category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+        tags: string[];
+        updated_at: string;
+    }[];
+}, {
+    schema_version: 1;
+    next_id: number;
+    decisions: {
+        status: "active" | "superseded" | "deprecated";
+        id: string;
+        title: string;
+        category: "architecture" | "infrastructure" | "dependency" | "api" | "data-model" | "ui" | "product" | "security" | "performance" | "process" | "other";
+        tags: string[];
+        updated_at: string;
+    }[];
+}>;
+export type DecisionIndex = z.infer<typeof IndexSchema>;
+export declare const CaptureModeSchema: z.ZodEnum<["inline", "session-summary"]>;
+export declare const ConfigSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    store_path: z.ZodString;
+    categories: z.ZodArray<z.ZodString, "many">;
+    capture_mode: z.ZodEnum<["inline", "session-summary"]>;
+    /** When false, only conversation summaries are stored (no raw excerpts). */
+    store_excerpts: z.ZodBoolean;
+    /** When false, git evidence capture is skipped. */
+    capture_git: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    store_path: string;
+    categories: string[];
+    capture_mode: "inline" | "session-summary";
+    store_excerpts: boolean;
+    capture_git: boolean;
+}, {
+    schema_version: 1;
+    store_path: string;
+    categories: string[];
+    capture_mode: "inline" | "session-summary";
+    store_excerpts: boolean;
+    capture_git: boolean;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare const DEFAULT_CONFIG: Config;
+/** Fields shared by record_decision and the new record in supersede_decision. */
+export declare const DecisionInputShape: {
+    title: z.ZodString;
+    category: z.ZodEnum<["architecture", "infrastructure", "dependency", "api", "data-model", "ui", "product", "security", "performance", "process", "other"]>;
+    decision: z.ZodString;
+    rationale: z.ZodString;
+    alternatives_considered: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        option: z.ZodString;
+        reason_rejected: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        option: string;
+        reason_rejected: string;
+    }, {
+        option: string;
+        reason_rejected: string;
+    }>, "many">>;
+    consequences: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    conversation_summary: z.ZodOptional<z.ZodString>;
+    conversation_excerpt: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    session_id: z.ZodOptional<z.ZodString>;
+};

package/dist/schema.js

@@ -0,0 +1,139 @@
+import { z } from "zod";
+/**
+ * Schema definitions for whywhy.
+ *
+ * The Decision Record is the heart of the product. Everything else
+ * (store, index, tools) is built around keeping these records valid,
+ * versioned, and queryable.
+ */
+export const SCHEMA_VERSION = 1;
+/** Allowed decision categories (MVP). */
+export const CATEGORIES = [
+    "architecture",
+    "infrastructure",
+    "dependency",
+    "api",
+    "data-model",
+    "ui",
+    "product",
+    "security",
+    "performance",
+    "process",
+    "other",
+];
+export const CategorySchema = z.enum(CATEGORIES);
+/** Lifecycle status of a decision. */
+export const STATUSES = ["active", "superseded", "deprecated"];
+export const StatusSchema = z.enum(STATUSES);
+export const AlternativeSchema = z.object({
+    option: z.string().min(1),
+    reason_rejected: z.string().min(1),
+});
+export const ConversationEvidenceSchema = z.object({
+    summary: z.string(),
+    excerpt: z.string().optional(),
+});
+export const DiffEvidenceSchema = z.object({
+    branch: z.string().nullable(),
+    base_commit: z.string().nullable(),
+    head_commit: z.string().nullable(),
+    files_changed: z.array(z.string()),
+    summary: z.string(),
+});
+export const CodeCommentSchema = z.object({
+    file: z.string(),
+    line: z.number().int().nonnegative(),
+    text: z.string(),
+});
+export const EvidenceSchema = z.object({
+    conversation: ConversationEvidenceSchema,
+    diff: DiffEvidenceSchema.nullable(),
+    code_comments: z.array(CodeCommentSchema),
+});
+/** A single, fully-formed decision record (one JSON file on disk). */
+export const DecisionRecordSchema = z.object({
+    id: z.string().regex(/^DR-\d{4,}$/),
+    schema_version: z.literal(SCHEMA_VERSION),
+    title: z.string().min(1),
+    category: CategorySchema,
+    status: StatusSchema,
+    decision: z.string().min(1),
+    rationale: z.string().min(1),
+    alternatives_considered: z.array(AlternativeSchema),
+    consequences: z.string(),
+    tags: z.array(z.string()),
+    evidence: EvidenceSchema,
+    version: z.number().int().positive(),
+    supersedes: z.string().nullable(),
+    superseded_by: z.string().nullable(),
+    created_at: z.string(),
+    updated_at: z.string(),
+    created_by: z.string(),
+    session_id: z.string().nullable(),
+});
+/** A lightweight entry kept in index.json for fast listing/search. */
+export const IndexEntrySchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    category: CategorySchema,
+    status: StatusSchema,
+    tags: z.array(z.string()),
+    updated_at: z.string(),
+});
+export const IndexSchema = z.object({
+    schema_version: z.literal(SCHEMA_VERSION),
+    next_id: z.number().int().positive(),
+    decisions: z.array(IndexEntrySchema),
+});
+export const CaptureModeSchema = z.enum(["inline", "session-summary"]);
+export const ConfigSchema = z.object({
+    schema_version: z.literal(SCHEMA_VERSION),
+    store_path: z.string(),
+    categories: z.array(z.string()),
+    capture_mode: CaptureModeSchema,
+    /** When false, only conversation summaries are stored (no raw excerpts). */
+    store_excerpts: z.boolean(),
+    /** When false, git evidence capture is skipped. */
+    capture_git: z.boolean(),
+});
+export const DEFAULT_CONFIG = {
+    schema_version: SCHEMA_VERSION,
+    store_path: ".whywhy",
+    categories: [...CATEGORIES],
+    capture_mode: "inline",
+    store_excerpts: false,
+    capture_git: true,
+};
+/* ------------------------------------------------------------------ */
+/* Tool input schemas                                                  */
+/* ------------------------------------------------------------------ */
+/** Fields shared by record_decision and the new record in supersede_decision. */
+export const DecisionInputShape = {
+    title: z.string().min(1).describe("Short, human-readable title for the decision."),
+    category: CategorySchema.describe(`One of: ${CATEGORIES.join(", ")}.`),
+    decision: z.string().min(1).describe("The decision that was made, stated plainly."),
+    rationale: z.string().min(1).describe("Why this decision was made."),
+    alternatives_considered: z
+        .array(AlternativeSchema)
+        .optional()
+        .describe("Other options weighed and why each was rejected."),
+    consequences: z
+        .string()
+        .optional()
+        .describe("Trade-offs, follow-on work, or ops impact this decision introduces."),
+    tags: z.array(z.string()).optional().describe("Free-form tags for filtering/search."),
+    conversation_summary: z
+        .string()
+        .optional()
+        .describe("A 1-3 sentence summary of the conversation that led to this decision."),
+    conversation_excerpt: z
+        .string()
+        .optional()
+        .describe("Optional short verbatim snippet (stored only if config.store_excerpts is true)."),
+    files: z
+        .array(z.string())
+        .optional()
+        .describe("Files relevant to this decision; scanned for related code comments."),
+    session_id: z.string().optional().describe("Identifier grouping decisions from one session."),
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,45 @@
+import { Config, DecisionIndex, DecisionRecord, IndexEntry } from "./schema.js";
+/**
+ * The on-disk decision store.
+ *
+ * Layout (relative to repo root):
+ *   .whywhy/
+ *     config.json
+ *     index.json
+ *     decisions/
+ *       DR-0001.json
+ *       ...
+ *
+ * Records are never deleted. The index is a derived, rolled-up view kept in
+ * sync on every write, but can be rebuilt from the decision files if needed.
+ */
+export declare class DecisionStore {
+    readonly root: string;
+    readonly storeDir: string;
+    readonly decisionsDir: string;
+    readonly indexPath: string;
+    readonly configPath: string;
+    constructor(repoRoot: string, storePath?: string);
+    exists(): Promise<boolean>;
+    /** Create the store directories and seed config/index if missing. */
+    init(config?: Partial<Config>): Promise<Config>;
+    readConfig(): Promise<Config>;
+    writeConfig(config: Config): Promise<void>;
+    readIndex(): Promise<DecisionIndex>;
+    writeIndex(index: DecisionIndex): Promise<void>;
+    recordPath(id: string): string;
+    readRecord(id: string): Promise<DecisionRecord>;
+    tryReadRecord(id: string): Promise<DecisionRecord | null>;
+    writeRecord(record: DecisionRecord): Promise<void>;
+    /** Reserve the next sequential ID, advancing the index counter. */
+    allocateId(): Promise<{
+        id: string;
+        index: DecisionIndex;
+    }>;
+    /** Insert or replace a record's index entry and persist the index. */
+    upsertIndexEntry(record: DecisionRecord): Promise<void>;
+    listEntries(): Promise<IndexEntry[]>;
+    readAllRecords(): Promise<DecisionRecord[]>;
+    /** Rebuild index.json from the decision files on disk. */
+    rebuildIndex(): Promise<DecisionIndex>;
+}