oh-my-oop 0.2.0

package/dist/application/discovery.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { OOP_OPERATIONS } from "../oop/commands.js";
+export const CapabilitiesInputSchema = z.object({}).strict();
+export const DescribeInputSchema = z.object({
+    command: z.enum(["oop", "system"]),
+    operation: z.string().trim().min(1).max(80),
+}).strict();
+const mutating = new Set(["oop_init", "oop_use_case_add", "oop_assign_responsibility", "oop_class_upsert", "oop_collaboration_define", "oop_diagram_generate"]);
+function operations() {
+    return [
+        ...Object.entries(OOP_OPERATIONS).map(([tool, definition]) => ({
+            command: "oop", operation: tool.slice(4), tool, schema: definition.inputSchema,
+            side_effect: mutating.has(tool) ? "local_write" : "none",
+        })),
+        { command: "system", operation: "capabilities", tool: "oop_capabilities", schema: CapabilitiesInputSchema, side_effect: "none" },
+        { command: "system", operation: "describe", tool: "oop_describe", schema: DescribeInputSchema, side_effect: "none" },
+    ];
+}
+function entry(op) {
+    return { command: op.command, operation: op.operation,
+        cli: { argv: ["oh-my-oop", op.command, op.operation, "--input", "-"] },
+        mcp: { tool: op.tool, exposed: true, arguments: "input" }, side_effect: op.side_effect };
+}
+export function capabilities() {
+    return {
+        schema_version: 1, product: "oh-my-oop",
+        model: { required: null, skill_required: false },
+        interfaces: {
+            skill: { installer: "skills", install: "npx skills add <source> --skill oh-my-oop", core_setup: "Build the OOP CLI separately; use oh-my-oop on PATH or an explicitly configured absolute CLI path.", invokes: "cli", mcp_required: false },
+            mcp: { transport: "stdio", argv: ["oh-my-oop", "mcp"], skill_required: false },
+        },
+        operations: operations().map(entry),
+        state: { durable: [".oop"], scope: "Same project root; no conversation or login transfer." },
+        limits: [
+            "Validates saved OOP design models, not implementation ASTs.",
+            "Conformance returns a contract/checklist for host review, not an automated source verdict.",
+            "No worker execution, architecture policies, JEV calls or automatic implementation.",
+            "Findings are advice; input schemas are not authorization.",
+        ],
+    };
+}
+export function describeOperation(input) {
+    const request = DescribeInputSchema.parse(input);
+    const op = operations().find(x => x.command === request.command && x.operation === request.operation);
+    if (!op)
+        throw new Error("Unknown operation; use system capabilities");
+    return { schema_version: 1, ...entry(op),
+        input_schema: zodToJsonSchema(op.schema, { target: "jsonSchema7", $refStrategy: "none", effectStrategy: "input" }),
+        validation: "Input shape only; runtime checks remain authoritative.",
+    };
+}
+export function systemCommand(action, input) {
+    if (action === "capabilities") {
+        CapabilitiesInputSchema.parse(input);
+        return capabilities();
+    }
+    if (action === "describe")
+        return describeOperation(input);
+    throw new Error("Unknown system action; use capabilities or describe");
+}
+//# sourceMappingURL=discovery.js.map

package/dist/application/discovery.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+/** CLI uses the same core as MCP without loading the SDK. */
+export declare function runCli(argv: string[]): Promise<boolean>;

package/dist/cli.js

@@ -0,0 +1,80 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { parseArgs } from "node:util";
+import { resolveConfig } from "./config.js";
+import { oopCommand } from "./oop/commands.js";
+import { systemCommand } from "./application/discovery.js";
+const HELP = `Oh-My-OOP 0.2.0
+No arguments / mcp                  Start MCP stdio
+oop <action> --input FILE           OOP operation without oop_ prefix
+system capabilities                List operations
+system describe --input FILE       Schema for {command, operation}
+--root PATH                        Override OOP_PROJECT_ROOT / cwd
+--input -                          Read JSON object from stdin (max 2 MB)
+OOP validation is advisory. No model calls, app builds or worker execution.
+Architecture/semantic/task commands were extracted into a separate migration archive.
+Skill distribution: npx skills add <source> --skill oh-my-oop
+Install/build the OOP CLI separately; Skill installation does not install the core.
+`;
+async function inputJson(file) {
+    if (!file)
+        return {};
+    let source;
+    if (file === "-") {
+        const parts = [];
+        let bytes = 0;
+        for await (const part of process.stdin) {
+            const buffer = Buffer.from(part);
+            bytes += buffer.length;
+            if (bytes > 2_000_000)
+                throw new Error("JSON input exceeds 2 MB");
+            parts.push(buffer);
+        }
+        source = Buffer.concat(parts).toString("utf8");
+    }
+    else {
+        if ((await fs.stat(file)).size > 2_000_000)
+            throw new Error("JSON input exceeds 2 MB");
+        source = await fs.readFile(file, "utf8");
+    }
+    const input = JSON.parse(source);
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        throw new Error("Input must be a JSON object");
+    if ("action" in input)
+        throw new Error("Specify the action as a CLI argument, not inside input JSON");
+    return input;
+}
+/** CLI uses the same core as MCP without loading the SDK. */
+export async function runCli(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv, allowPositionals: true, strict: true,
+        options: { root: { type: "string" }, input: { type: "string" }, help: { type: "boolean", short: "h" }, version: { type: "boolean", short: "v" } },
+    });
+    if (values.help) {
+        process.stdout.write(HELP);
+        return true;
+    }
+    if (values.version) {
+        process.stdout.write("oh-my-oop 0.2.0\n");
+        return true;
+    }
+    if (!positionals.length || (positionals.length === 1 && positionals[0] === "mcp")) {
+        if (values.root || values.input)
+            throw new Error("Use OOP_PROJECT_ROOT for MCP mode");
+        return false;
+    }
+    const [kind, action] = positionals;
+    if (kind === "skill" && action === "install" && positionals.length === 2) {
+        throw new Error("The built-in Skill installer was removed. Use npx skills add <source> --skill oh-my-oop; prepare the OOP CLI separately. See README.md.");
+    }
+    if (!action || positionals.length !== 2 || !["oop", "system"].includes(kind))
+        throw new Error("Unknown command; see --help");
+    const projectRoot = values.root ? path.resolve(values.root) : resolveConfig().projectRoot;
+    const input = await inputJson(values.input);
+    const output = kind === "oop"
+        ? await oopCommand({ projectRoot, oopDir: path.join(projectRoot, ".oop") }, { ...input, action: `oop_${action}` })
+        : systemCommand(action, input);
+    process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
+    return true;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+export interface OopConfig {
+    projectRoot: string;
+    oopDir: string;
+}
+export declare function resolveConfig(): OopConfig;
+export declare function workspacePaths(config: OopConfig): {
+    root: string;
+    designIndex: string;
+    useCasesDir: string;
+    classesDir: string;
+    collaborationsDir: string;
+    diagramsDir: string;
+    historyDir: string;
+    currentDiagram: string;
+};
+export declare function ensureProjectRootExists(config: OopConfig): void;

package/dist/config.js

@@ -0,0 +1,32 @@
+import * as path from "node:path";
+import * as fs from "node:fs";
+export function resolveConfig() {
+    const envRoot = process.env.OOP_PROJECT_ROOT ?? process.env.ARCH_PROJECT_ROOT;
+    const projectRoot = envRoot
+        ? path.resolve(envRoot)
+        : process.cwd();
+    return {
+        projectRoot,
+        oopDir: path.join(projectRoot, ".oop"),
+    };
+}
+export function workspacePaths(config) {
+    const root = config.oopDir;
+    return {
+        root,
+        designIndex: path.join(root, "design.md"),
+        useCasesDir: path.join(root, "use-cases"),
+        classesDir: path.join(root, "classes"),
+        collaborationsDir: path.join(root, "collaborations"),
+        diagramsDir: path.join(root, "diagrams"),
+        historyDir: path.join(root, "history"),
+        currentDiagram: path.join(root, "diagrams", "current.mmd"),
+    };
+}
+export function ensureProjectRootExists(config) {
+    if (!fs.existsSync(config.projectRoot)) {
+        throw new Error(`Project root does not exist: ${config.projectRoot}. ` +
+            `Set OOP_PROJECT_ROOT or run from a real directory.`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAO9B,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC9E,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACvB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAClB,OAAO;QACL,WAAW;QACX,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QACzC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QACzC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QACtC,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;QACpD,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QACxC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QACtC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,WAAW,IAAI;YACpD,oDAAoD,CACvD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/domain/collaborators.d.ts

@@ -0,0 +1,2 @@
+import type { CrcCard, Collaboration } from "./model.js";
+export declare function deriveCollaborators(classes: CrcCard[], collaborations: ReadonlyArray<Pick<Collaboration, "from" | "to" | "message">>): CrcCard[];

package/dist/domain/collaborators.js

@@ -0,0 +1,26 @@
+// 단일 진실 출처(single source of truth):
+// 의존 관계의 정본은 design.collaborations 다.
+// 각 클래스의 collaborators 는 저장값을 신뢰하지 않고 collaborations 에서 *파생*한다.
+// 이렇게 해야 다이어그램(collaborations 사용)과 검증 룰(collaborators 사용)이
+// 항상 동일한 의존 그래프를 본다. (이전: 두 곳을 조건부·단방향으로 동기화 → 드리프트)
+export function deriveCollaborators(classes, collaborations) {
+    const idToName = new Map(classes.map((c) => [c.id, c.name]));
+    const resolveName = (ref) => idToName.get(ref) ?? ref;
+    return classes.map((card) => {
+        const seen = new Set();
+        const collaborators = [];
+        for (const col of collaborations) {
+            // collaboration.from 이 이 카드(id 또는 name)와 일치하면 이 카드의 협력
+            if (col.from !== card.id && col.from !== card.name)
+                continue;
+            const name = resolveName(col.to);
+            const key = `${name}::${col.message}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            collaborators.push({ name, message: col.message });
+        }
+        return { ...card, collaborators };
+    });
+}
+//# sourceMappingURL=collaborators.js.map

package/dist/domain/collaborators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaborators.js","sourceRoot":"","sources":["../../src/domain/collaborators.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,sCAAsC;AACtC,gEAAgE;AAChE,2DAA2D;AAC3D,qDAAqD;AACrD,MAAM,UAAU,mBAAmB,CACjC,OAAkB,EAClB,cAA6E;IAE7E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAU,CAAC,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IAEtE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,aAAa,GAAsB,EAAE,CAAC;QAC5C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,uDAAuD;YACvD,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;gBAAE,SAAS;YAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/ids.d.ts

@@ -0,0 +1,4 @@
+export declare function toSlug(input: string): string;
+export declare function classIdFromName(name: string): string;
+export declare function collaborationId(from: string, message: string, to: string): string;
+export declare function snapshotFilename(label: string, when?: Date): string;

package/dist/domain/ids.js

@@ -0,0 +1,23 @@
+export function toSlug(input) {
+    return input
+        .normalize("NFC")
+        .replace(/[^a-zA-Z0-9가-힣\s_-]/g, " ")
+        .trim()
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/_+/g, "_")
+        .toLowerCase();
+}
+export function classIdFromName(name) {
+    return toSlug(name);
+}
+const VERB_PARTICLES = /[()\[\]{}.,;:!?]/g;
+export function collaborationId(from, message, to) {
+    const verb = toSlug(message.replace(VERB_PARTICLES, " ")).split("-")[0] || "msg";
+    return `${toSlug(from)}__${verb}__${toSlug(to)}`;
+}
+export function snapshotFilename(label, when = new Date()) {
+    const iso = when.toISOString().replace(/[:.]/g, "-").replace(/Z$/, "Z");
+    return `${iso}__${toSlug(label) || "snapshot"}.mmd`;
+}
+//# sourceMappingURL=ids.js.map

package/dist/domain/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/domain/ids.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,KAAK;SACT,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC;SACpC,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe,EAAE,EAAU;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IACjF,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAa,IAAI,IAAI,EAAE;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxE,OAAO,GAAG,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,UAAU,MAAM,CAAC;AACtD,CAAC"}

package/dist/domain/model.d.ts

@@ -0,0 +1,71 @@
+import type { Stereotype } from "./stereotypes.js";
+export type ResponsibilityKind = "knowing" | "doing";
+export interface Responsibility {
+    kind: ResponsibilityKind;
+    text: string;
+}
+export interface CollaboratorRef {
+    name: string;
+    message: string;
+}
+export interface CrcCard {
+    id: string;
+    name: string;
+    stereotype: Stereotype;
+    responsibilities: {
+        knowing: string[];
+        doing: string[];
+    };
+    collaborators: CollaboratorRef[];
+    provenance: {
+        derived_from_use_cases: string[];
+        created_at: string;
+        updated_at?: string;
+    };
+    notes?: string;
+}
+export interface UseCase {
+    id: string;
+    title: string;
+    actor: string;
+    preconditions: string[];
+    main_flow: string[];
+    postconditions: string[];
+    related_classes: string[];
+    notes?: string;
+}
+export type CollaborationDirection = "send" | "query" | "event";
+export interface Collaboration {
+    id: string;
+    from: string;
+    to: string;
+    message: string;
+    direction: CollaborationDirection;
+    multiplicity?: string;
+    rationale?: string;
+}
+export interface DesignIndex {
+    oop_version: number;
+    project: string;
+    target_language: "kotlin";
+    updated_at: string;
+    use_cases: string[];
+    classes: string[];
+    collaborations: string[];
+    current_diagram: string;
+    thresholds?: Partial<{
+        god_object_responsibilities: number;
+        god_object_collaborators: number;
+        cohesion_min_overlap: number;
+        too_many_collaborators: number;
+        mocking_pressure_max: number;
+        data_duplication_overlap: number;
+    }>;
+    notes?: string;
+}
+export interface Design {
+    index: DesignIndex;
+    use_cases: UseCase[];
+    classes: CrcCard[];
+    collaborations: Collaboration[];
+}

package/dist/domain/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/domain/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/domain/model.ts"],"names":[],"mappings":""}

package/dist/domain/schemas.d.ts

@@ -0,0 +1,213 @@
+import { z } from "zod";
+export declare const StereotypeSchema: z.ZodEnum<["InformationHolder", "ServiceProvider", "Structurer", "Coordinator", "Interfacer"]>;
+export declare const ResponsibilityKindSchema: z.ZodEnum<["knowing", "doing"]>;
+export declare const CollaborationDirectionSchema: z.ZodEnum<["send", "query", "event"]>;
+export declare const CollaboratorRefSchema: z.ZodObject<{
+    name: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    message: string;
+}, {
+    name: string;
+    message: string;
+}>;
+export declare const CrcCardSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    stereotype: z.ZodEnum<["InformationHolder", "ServiceProvider", "Structurer", "Coordinator", "Interfacer"]>;
+    responsibilities: z.ZodObject<{
+        knowing: z.ZodArray<z.ZodString, "many">;
+        doing: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        knowing: string[];
+        doing: string[];
+    }, {
+        knowing: string[];
+        doing: string[];
+    }>;
+    collaborators: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        message: string;
+    }, {
+        name: string;
+        message: string;
+    }>, "many">;
+    provenance: z.ZodObject<{
+        derived_from_use_cases: z.ZodArray<z.ZodString, "many">;
+        created_at: z.ZodString;
+        updated_at: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        derived_from_use_cases: string[];
+        created_at: string;
+        updated_at?: string | undefined;
+    }, {
+        derived_from_use_cases: string[];
+        created_at: string;
+        updated_at?: string | undefined;
+    }>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    stereotype: "InformationHolder" | "ServiceProvider" | "Structurer" | "Coordinator" | "Interfacer";
+    responsibilities: {
+        knowing: string[];
+        doing: string[];
+    };
+    collaborators: {
+        name: string;
+        message: string;
+    }[];
+    provenance: {
+        derived_from_use_cases: string[];
+        created_at: string;
+        updated_at?: string | undefined;
+    };
+    notes?: string | undefined;
+}, {
+    name: string;
+    id: string;
+    stereotype: "InformationHolder" | "ServiceProvider" | "Structurer" | "Coordinator" | "Interfacer";
+    responsibilities: {
+        knowing: string[];
+        doing: string[];
+    };
+    collaborators: {
+        name: string;
+        message: string;
+    }[];
+    provenance: {
+        derived_from_use_cases: string[];
+        created_at: string;
+        updated_at?: string | undefined;
+    };
+    notes?: string | undefined;
+}>;
+export declare const UseCaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    actor: z.ZodString;
+    preconditions: z.ZodArray<z.ZodString, "many">;
+    main_flow: z.ZodArray<z.ZodString, "many">;
+    postconditions: z.ZodArray<z.ZodString, "many">;
+    related_classes: z.ZodArray<z.ZodString, "many">;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    actor: string;
+    preconditions: string[];
+    main_flow: string[];
+    postconditions: string[];
+    related_classes: string[];
+    notes?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    actor: string;
+    preconditions: string[];
+    main_flow: string[];
+    postconditions: string[];
+    related_classes: string[];
+    notes?: string | undefined;
+}>;
+export declare const CollaborationSchema: z.ZodObject<{
+    id: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    message: z.ZodString;
+    direction: z.ZodEnum<["send", "query", "event"]>;
+    multiplicity: z.ZodOptional<z.ZodString>;
+    rationale: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    id: string;
+    from: string;
+    to: string;
+    direction: "send" | "query" | "event";
+    multiplicity?: string | undefined;
+    rationale?: string | undefined;
+}, {
+    message: string;
+    id: string;
+    from: string;
+    to: string;
+    direction: "send" | "query" | "event";
+    multiplicity?: string | undefined;
+    rationale?: string | undefined;
+}>;
+export declare const DesignIndexSchema: z.ZodObject<{
+    oop_version: z.ZodNumber;
+    project: z.ZodString;
+    target_language: z.ZodLiteral<"kotlin">;
+    updated_at: z.ZodString;
+    use_cases: z.ZodArray<z.ZodString, "many">;
+    classes: z.ZodArray<z.ZodString, "many">;
+    collaborations: z.ZodArray<z.ZodString, "many">;
+    current_diagram: z.ZodString;
+    thresholds: z.ZodOptional<z.ZodObject<{
+        god_object_responsibilities: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        god_object_collaborators: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        cohesion_min_overlap: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        too_many_collaborators: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        mocking_pressure_max: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        data_duplication_overlap: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        god_object_responsibilities?: number | undefined;
+        god_object_collaborators?: number | undefined;
+        cohesion_min_overlap?: number | undefined;
+        too_many_collaborators?: number | undefined;
+        mocking_pressure_max?: number | undefined;
+        data_duplication_overlap?: number | undefined;
+    }, {
+        god_object_responsibilities?: number | undefined;
+        god_object_collaborators?: number | undefined;
+        cohesion_min_overlap?: number | undefined;
+        too_many_collaborators?: number | undefined;
+        mocking_pressure_max?: number | undefined;
+        data_duplication_overlap?: number | undefined;
+    }>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    classes: string[];
+    collaborations: string[];
+    updated_at: string;
+    oop_version: number;
+    project: string;
+    target_language: "kotlin";
+    use_cases: string[];
+    current_diagram: string;
+    notes?: string | undefined;
+    thresholds?: {
+        god_object_responsibilities?: number | undefined;
+        god_object_collaborators?: number | undefined;
+        cohesion_min_overlap?: number | undefined;
+        too_many_collaborators?: number | undefined;
+        mocking_pressure_max?: number | undefined;
+        data_duplication_overlap?: number | undefined;
+    } | undefined;
+}, {
+    classes: string[];
+    collaborations: string[];
+    updated_at: string;
+    oop_version: number;
+    project: string;
+    target_language: "kotlin";
+    use_cases: string[];
+    current_diagram: string;
+    notes?: string | undefined;
+    thresholds?: {
+        god_object_responsibilities?: number | undefined;
+        god_object_collaborators?: number | undefined;
+        cohesion_min_overlap?: number | undefined;
+        too_many_collaborators?: number | undefined;
+        mocking_pressure_max?: number | undefined;
+        data_duplication_overlap?: number | undefined;
+    } | undefined;
+}>;
+export declare const TradeoffQuestionSchema: z.ZodEnum<["responsibility_split", "class_split", "collaboration_shape", "stereotype_choice", "value_object_shape", "strategy_or_policy", "error_handling", "collection_shape", "dual_subject_comparison", "free_form"]>;
+export type TradeoffQuestion = z.infer<typeof TradeoffQuestionSchema>;

package/dist/domain/schemas.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { STEREOTYPES } from "./stereotypes.js";
+export const StereotypeSchema = z.enum(STEREOTYPES);
+export const ResponsibilityKindSchema = z.enum(["knowing", "doing"]);
+export const CollaborationDirectionSchema = z.enum(["send", "query", "event"]);
+export const CollaboratorRefSchema = z.object({
+    name: z.string().min(1),
+    message: z.string().min(1),
+});
+export const CrcCardSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    stereotype: StereotypeSchema,
+    responsibilities: z.object({
+        knowing: z.array(z.string()),
+        doing: z.array(z.string()),
+    }),
+    collaborators: z.array(CollaboratorRefSchema),
+    provenance: z.object({
+        derived_from_use_cases: z.array(z.string()),
+        created_at: z.string(),
+        updated_at: z.string().optional(),
+    }),
+    notes: z.string().optional(),
+});
+export const UseCaseSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    actor: z.string().min(1),
+    preconditions: z.array(z.string()),
+    main_flow: z.array(z.string()).min(1),
+    postconditions: z.array(z.string()),
+    related_classes: z.array(z.string()),
+    notes: z.string().optional(),
+});
+export const CollaborationSchema = z.object({
+    id: z.string().min(1),
+    from: z.string().min(1),
+    to: z.string().min(1),
+    message: z.string().min(1),
+    direction: CollaborationDirectionSchema,
+    multiplicity: z.string().optional(),
+    rationale: z.string().optional(),
+});
+export const DesignIndexSchema = z.object({
+    oop_version: z.number().int().positive(),
+    project: z.string(),
+    target_language: z.literal("kotlin"),
+    updated_at: z.string(),
+    use_cases: z.array(z.string()),
+    classes: z.array(z.string()),
+    collaborations: z.array(z.string()),
+    current_diagram: z.string(),
+    thresholds: z
+        .object({
+        god_object_responsibilities: z.number().int().positive().optional(),
+        god_object_collaborators: z.number().int().positive().optional(),
+        cohesion_min_overlap: z.number().min(0).max(1).optional(),
+        too_many_collaborators: z.number().int().positive().optional(),
+        mocking_pressure_max: z.number().int().nonnegative().optional(),
+        data_duplication_overlap: z.number().min(0).max(1).optional(),
+    })
+        .partial()
+        .optional(),
+    notes: z.string().optional(),
+});
+export const TradeoffQuestionSchema = z.enum([
+    "responsibility_split",
+    "class_split",
+    "collaboration_shape",
+    "stereotype_choice",
+    "value_object_shape",
+    "strategy_or_policy",
+    "error_handling",
+    "collection_shape",
+    "dual_subject_comparison",
+    "free_form",
+]);
+//# sourceMappingURL=schemas.js.map