@tienne/gestalt 0.1.0

package/dist/src/spec/generator.js.map

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

package/dist/src/spec/passthrough-generator.d.ts

@@ -0,0 +1,34 @@
+import type { InterviewSession, Spec } from '../core/types.js';
+import { AmbiguityThresholdError, SpecGenerationError } from '../core/errors.js';
+import { type Result } from '../core/result.js';
+import { EventStore } from '../events/store.js';
+import type { AgentRegistry } from '../agent/registry.js';
+export interface SpecContext {
+    systemPrompt: string;
+    specPrompt: string;
+    allRounds: {
+        roundNumber: number;
+        question: string;
+        response: string;
+        gestaltFocus: string;
+    }[];
+    activeAgents?: string[];
+}
+export interface ExternalSpec {
+    goal: string;
+    constraints: string[];
+    acceptanceCriteria: string[];
+    ontologySchema: {
+        entities: unknown[];
+        relations: unknown[];
+    };
+    gestaltAnalysis: unknown[];
+}
+export declare class PassthroughSpecGenerator {
+    private eventStore;
+    private agentRegistry?;
+    constructor(eventStore: EventStore, agentRegistry?: AgentRegistry);
+    buildSpecContext(session: InterviewSession): SpecContext;
+    validateAndStore(session: InterviewSession, externalSpec: ExternalSpec, force?: boolean): Result<Spec, SpecGenerationError | AmbiguityThresholdError>;
+}
+//# sourceMappingURL=passthrough-generator.d.ts.map

package/dist/src/spec/passthrough-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough-generator.d.ts","sourceRoot":"","sources":["../../../src/spec/passthrough-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAkB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/F,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAC9D,eAAe,EAAE,OAAO,EAAE,CAAC;CAC5B;AAID,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAElB,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,aAAa;IAIzE,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW;IA4BxD,gBAAgB,CACd,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,YAAY,EAC1B,KAAK,UAAQ,GACZ,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB,CAAC;CA6D/D"}

package/dist/src/spec/passthrough-generator.js

@@ -0,0 +1,86 @@
+import { randomUUID } from 'node:crypto';
+import { AmbiguityThresholdError, SpecGenerationError } from '../core/errors.js';
+import { AMBIGUITY_THRESHOLD } from '../core/constants.js';
+import { ok, err } from '../core/result.js';
+import { specSchema } from './schema.js';
+import { EventType } from '../events/types.js';
+import { INTERVIEW_SYSTEM_PROMPT, buildSpecPrompt } from '../llm/prompts.js';
+import { mergeSystemPrompt, getActiveAgentNames } from '../agent/prompt-resolver.js';
+// ─── Generator ──────────────────────────────────────────────────
+export class PassthroughSpecGenerator {
+    eventStore;
+    agentRegistry;
+    constructor(eventStore, agentRegistry) {
+        this.eventStore = eventStore;
+        this.agentRegistry = agentRegistry;
+    }
+    buildSpecContext(session) {
+        const answeredRounds = session.rounds
+            .filter((r) => r.userResponse !== null)
+            .map((r) => ({
+            question: r.question,
+            response: r.userResponse,
+        }));
+        const specPrompt = buildSpecPrompt(session.topic, answeredRounds, session.projectType);
+        const systemPrompt = mergeSystemPrompt(INTERVIEW_SYSTEM_PROMPT, this.agentRegistry, 'spec');
+        const activeAgents = getActiveAgentNames(this.agentRegistry, 'spec');
+        return {
+            systemPrompt,
+            specPrompt,
+            allRounds: session.rounds
+                .filter((r) => r.userResponse !== null)
+                .map((r) => ({
+                roundNumber: r.roundNumber,
+                question: r.question,
+                response: r.userResponse,
+                gestaltFocus: r.gestaltFocus,
+            })),
+            ...(activeAgents.length > 0 && { activeAgents }),
+        };
+    }
+    validateAndStore(session, externalSpec, force = false) {
+        // Validate ambiguity threshold
+        if (!force) {
+            const ambiguity = session.ambiguityScore?.overall ?? 1.0;
+            if (ambiguity > AMBIGUITY_THRESHOLD) {
+                return err(new AmbiguityThresholdError(ambiguity, AMBIGUITY_THRESHOLD));
+            }
+        }
+        if (session.status !== 'completed') {
+            return err(new SpecGenerationError('Interview session must be completed before generating a spec'));
+        }
+        try {
+            const spec = {
+                version: '1.0.0',
+                goal: externalSpec.goal,
+                constraints: externalSpec.constraints,
+                acceptanceCriteria: externalSpec.acceptanceCriteria,
+                ontologySchema: externalSpec.ontologySchema,
+                gestaltAnalysis: externalSpec.gestaltAnalysis,
+                metadata: {
+                    specId: randomUUID(),
+                    interviewSessionId: session.sessionId,
+                    ambiguityScore: session.ambiguityScore?.overall ?? 1.0,
+                    generatedAt: new Date().toISOString(),
+                },
+            };
+            // Validate against schema
+            const validation = specSchema.safeParse(spec);
+            if (!validation.success) {
+                return err(new SpecGenerationError(`Spec validation failed: ${validation.error.message}`));
+            }
+            this.eventStore.append('spec', spec.metadata.specId, EventType.SPEC_GENERATED, {
+                sessionId: session.sessionId,
+                goal: spec.goal,
+                constraintCount: spec.constraints.length,
+                criteriaCount: spec.acceptanceCriteria.length,
+                source: 'passthrough',
+            });
+            return ok(spec);
+        }
+        catch (e) {
+            return err(new SpecGenerationError(`Failed to validate spec: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+}
+//# sourceMappingURL=passthrough-generator.js.map

package/dist/src/spec/passthrough-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough-generator.js","sourceRoot":"","sources":["../../../src/spec/passthrough-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAe,EAAE,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAmBrF,mEAAmE;AAEnE,MAAM,OAAO,wBAAwB;IAGf;IAFZ,aAAa,CAAiB;IAEtC,YAAoB,UAAsB,EAAE,aAA6B;QAArD,eAAU,GAAV,UAAU,CAAY;QACxC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,gBAAgB,CAAC,OAAyB;QACxC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM;aAClC,MAAM,CAAC,CAAC,CAAC,EAAkD,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC;aACtF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,QAAQ,EAAE,CAAC,CAAC,YAAY;SACzB,CAAC,CAAC,CAAC;QAEN,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAEvF,MAAM,YAAY,GAAG,iBAAiB,CAAC,uBAAuB,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC5F,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAErE,OAAO;YACL,YAAY;YACZ,UAAU;YACV,SAAS,EAAE,OAAO,CAAC,MAAM;iBACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC;iBACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACX,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,YAAa;gBACzB,YAAY,EAAE,CAAC,CAAC,YAAY;aAC7B,CAAC,CAAC;YACL,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,gBAAgB,CACd,OAAyB,EACzB,YAA0B,EAC1B,KAAK,GAAG,KAAK;QAEb,+BAA+B;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,OAAO,IAAI,GAAG,CAAC;YACzD,IAAI,SAAS,GAAG,mBAAmB,EAAE,CAAC;gBACpC,OAAO,GAAG,CAAC,IAAI,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC,IAAI,mBAAmB,CAAC,8DAA8D,CAAC,CAAC,CAAC;QACtG,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAS;gBACjB,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,kBAAkB,EAAE,YAAY,CAAC,kBAAkB;gBACnD,cAAc,EAAE,YAAY,CAAC,cAAwC;gBACrE,eAAe,EAAE,YAAY,CAAC,eAA0C;gBACxE,QAAQ,EAAE;oBACR,MAAM,EAAE,UAAU,EAAE;oBACpB,kBAAkB,EAAE,OAAO,CAAC,SAAS;oBACrC,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,IAAI,GAAG;oBACtD,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACtC;aACF,CAAC;YAEF,0BAA0B;YAC1B,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,GAAG,CACR,IAAI,mBAAmB,CACrB,2BAA2B,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CACtD,CACF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,MAAM,CACpB,MAAM,EACN,IAAI,CAAC,QAAQ,CAAC,MAAM,EACpB,SAAS,CAAC,cAAc,EACxB;gBACE,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;gBACxC,aAAa,EAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM;gBAC7C,MAAM,EAAE,aAAa;aACtB,CACF,CAAC;YAEF,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CACR,IAAI,mBAAmB,CACrB,4BAA4B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACzE,CACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/src/spec/schema.d.ts

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+import { GestaltPrinciple } from '../core/types.js';
+export declare const specSchema: z.ZodObject<{
+    version: z.ZodString;
+    goal: z.ZodString;
+    constraints: z.ZodArray<z.ZodString, "many">;
+    acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
+    ontologySchema: z.ZodObject<{
+        entities: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            attributes: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description: string;
+            attributes: string[];
+        }, {
+            name: string;
+            description: string;
+            attributes: string[];
+        }>, "many">;
+        relations: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            from: string;
+            to: string;
+        }, {
+            type: string;
+            from: string;
+            to: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entities: {
+            name: string;
+            description: string;
+            attributes: string[];
+        }[];
+        relations: {
+            type: string;
+            from: string;
+            to: string;
+        }[];
+    }, {
+        entities: {
+            name: string;
+            description: string;
+            attributes: string[];
+        }[];
+        relations: {
+            type: string;
+            from: string;
+            to: string;
+        }[];
+    }>;
+    gestaltAnalysis: z.ZodArray<z.ZodObject<{
+        principle: z.ZodNativeEnum<typeof GestaltPrinciple>;
+        finding: z.ZodString;
+        confidence: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        principle: GestaltPrinciple;
+        finding: string;
+        confidence: number;
+    }, {
+        principle: GestaltPrinciple;
+        finding: string;
+        confidence: number;
+    }>, "many">;
+    metadata: z.ZodObject<{
+        specId: z.ZodString;
+        interviewSessionId: z.ZodString;
+        ambiguityScore: z.ZodNumber;
+        generatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        specId: string;
+        interviewSessionId: string;
+        ambiguityScore: number;
+        generatedAt: string;
+    }, {
+        specId: string;
+        interviewSessionId: string;
+        ambiguityScore: number;
+        generatedAt: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    goal: string;
+    version: string;
+    constraints: string[];
+    acceptanceCriteria: string[];
+    ontologySchema: {
+        entities: {
+            name: string;
+            description: string;
+            attributes: string[];
+        }[];
+        relations: {
+            type: string;
+            from: string;
+            to: string;
+        }[];
+    };
+    gestaltAnalysis: {
+        principle: GestaltPrinciple;
+        finding: string;
+        confidence: number;
+    }[];
+    metadata: {
+        specId: string;
+        interviewSessionId: string;
+        ambiguityScore: number;
+        generatedAt: string;
+    };
+}, {
+    goal: string;
+    version: string;
+    constraints: string[];
+    acceptanceCriteria: string[];
+    ontologySchema: {
+        entities: {
+            name: string;
+            description: string;
+            attributes: string[];
+        }[];
+        relations: {
+            type: string;
+            from: string;
+            to: string;
+        }[];
+    };
+    gestaltAnalysis: {
+        principle: GestaltPrinciple;
+        finding: string;
+        confidence: number;
+    }[];
+    metadata: {
+        specId: string;
+        interviewSessionId: string;
+        ambiguityScore: number;
+        generatedAt: string;
+    };
+}>;
+export type ValidatedSpec = z.infer<typeof specSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/spec/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAgCpD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQrB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/src/spec/schema.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { GestaltPrinciple } from '../core/types.js';
+const ontologyEntitySchema = z.object({
+    name: z.string().min(1),
+    description: z.string(),
+    attributes: z.array(z.string()),
+});
+const ontologyRelationSchema = z.object({
+    from: z.string().min(1),
+    to: z.string().min(1),
+    type: z.string().min(1),
+});
+const ontologySchemaSchema = z.object({
+    entities: z.array(ontologyEntitySchema),
+    relations: z.array(ontologyRelationSchema),
+});
+const gestaltAnalysisSchema = z.object({
+    principle: z.nativeEnum(GestaltPrinciple),
+    finding: z.string(),
+    confidence: z.number().min(0).max(1),
+});
+const specMetadataSchema = z.object({
+    specId: z.string(),
+    interviewSessionId: z.string(),
+    ambiguityScore: z.number().min(0).max(1),
+    generatedAt: z.string(),
+});
+export const specSchema = z.object({
+    version: z.string(),
+    goal: z.string().min(1),
+    constraints: z.array(z.string()),
+    acceptanceCriteria: z.array(z.string()),
+    ontologySchema: ontologySchemaSchema,
+    gestaltAnalysis: z.array(gestaltAnalysisSchema),
+    metadata: specMetadataSchema,
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/spec/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,cAAc,EAAE,oBAAoB;IACpC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IAC/C,QAAQ,EAAE,kBAAkB;CAC7B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@tienne/gestalt",
+  "version": "0.1.0",
+  "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "gestalt": "./dist/bin/gestalt.js"
+  },
+  "files": [
+    "dist",
+    "agents",
+    "skills",
+    "CLAUDE.md"
+  ],
+  "scripts": {
+    "dev": "tsx bin/gestalt.ts",
+    "build": "tsc",
+    "postbuild": "cp -r agents dist/ && cp -r skills dist/",
+    "prepublishOnly": "pnpm build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "serve": "tsx bin/gestalt.ts serve",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "better-sqlite3": "^11.8.2",
+    "chokidar": "^4.0.3",
+    "commander": "^13.1.0",
+    "gray-matter": "^4.0.3",
+    "openai": "^6.27.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.13.10",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.9"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3",
+      "esbuild"
+    ]
+  }
+}

package/skills/execute/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: execute
+version: "1.0.0"
+description: "Gestalt-driven execution planner that transforms a Spec into a validated ExecutionPlan"
+triggers:
+  - "execute"
+  - "plan execution"
+  - "create execution plan"
+inputs:
+  spec:
+    type: object
+    required: true
+    description: "A validated Spec specification from the spec generation step"
+outputs:
+  - executionPlan
+---
+
+# Execute Skill
+
+This skill transforms a validated Spec specification into a concrete, dependency-aware Execution Plan by applying Gestalt psychology principles as a structured planning framework.
+
+## Process
+
+1. **Figure-Ground** (Step 1): Classify acceptance criteria as essential (figure) or supplementary (ground), assign priority levels
+2. **Closure** (Step 2): Decompose ACs into atomic tasks, identify implicit sub-tasks not explicitly stated
+3. **Proximity** (Step 3): Group related atomic tasks into logical task groups by domain
+4. **Continuity** (Step 4): Validate the dependency DAG — ensure no cycles, no conflicts, clear execution order
+
+## Passthrough Mode
+
+API 키 없이 MCP 서버 실행 시 자동 활성화. LLM 작업을 caller가 직접 수행한다.
+
+### Action별 사용법
+
+**`start`** — 실행 계획 세션 시작
+```json
+{ "action": "start", "spec": { ... } }
+```
+→ `{ status, sessionId, specId, executeContext, message }`
+
+**`plan_step`** — 각 계획 단계 결과 제출
+```json
+{ "action": "plan_step", "sessionId": "...", "stepResult": { "principle": "figure_ground", "classifiedACs": [...] } }
+```
+→ `{ status, sessionId, stepsCompleted, isLastStep, executeContext?, message }`
+
+**`plan_complete`** — 최종 실행 계획 조립
+```json
+{ "action": "plan_complete", "sessionId": "..." }
+```
+→ `{ status, sessionId, executionPlan, message }`
+
+**`status`** — 세션 상태 확인
+```json
+{ "action": "status", "sessionId": "..." }
+```
+
+### ExecuteContext 필드
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| `systemPrompt` | string | 실행 계획 시스템 프롬프트 |
+| `planningPrompt` | string | 현재 단계의 계획 프롬프트 |
+| `currentPrinciple` | string | 현재 적용 중인 게슈탈트 원리 |
+| `principleStrategy` | string | 해당 원리의 전략 설명 |
+| `phase` | string | 현재 단계 (`planning`) |
+| `stepNumber` | number | 현재 스텝 번호 (1-4) |
+| `totalSteps` | number | 전체 스텝 수 (4) |
+| `spec` | Spec | 원본 Spec 스펙 |
+| `previousSteps` | array | 이전 단계 결과들 |
+
+### Planning Principle 순서
+
+1. `figure_ground` → ClassifiedAC 배열
+2. `closure` → AtomicTask 배열
+3. `proximity` → TaskGroup 배열
+4. `continuity` → DAGValidation 객체
+
+### 검증 규칙
+
+- 순서가 강제됨: figure_ground → closure → proximity → continuity
+- 각 단계 결과는 이전 단계 데이터와 교차 검증됨
+- Continuity 단계에서는 서버 측 DAG 검증이 추가로 수행됨
+- 모든 AC가 분류되어야 하고, 모든 Task가 그룹에 포함되어야 함

package/skills/interview/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: interview
+version: "1.0.0"
+description: "Gestalt-driven interview to clarify project requirements"
+triggers:
+  - "interview"
+  - "clarify requirements"
+  - "start interview"
+inputs:
+  topic:
+    type: string
+    required: true
+    description: "The topic or feature to interview about"
+  cwd:
+    type: string
+    required: false
+    description: "Working directory for brownfield detection"
+outputs:
+  - session
+  - ambiguityScore
+---
+
+# Interview Skill
+
+This skill conducts a Gestalt psychology-driven interview to transform vague requirements into clear specifications.
+
+## Process
+
+1. **Start**: Create a session, detect project type (greenfield/brownfield), ask the first question
+2. **Iterate**: Ask questions guided by Gestalt principles (Closure → Proximity → Similarity → Figure-Ground)
+3. **Score**: Continuously assess ambiguity across multiple dimensions
+4. **Complete**: When ambiguity score ≤ 0.2, the interview is ready for spec generation
+
+## Gestalt Principles Applied
+
+- **Closure**: Fill missing requirements
+- **Proximity**: Group related features
+- **Similarity**: Identify patterns
+- **Figure-Ground**: Separate MVP from nice-to-have
+- **Continuity**: Detect contradictions
+
+## Passthrough Mode
+
+API 키 없이 MCP 서버 실행 시 자동 활성화. LLM 작업을 caller가 직접 수행한다.
+
+### 추가 Input 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| `generatedQuestion` | string | respond 시 필수 | caller가 생성한 질문 텍스트 |
+| `ambiguityScore` | object | 선택 | caller가 산출한 모호성 점수 |
+| `ambiguityScore.goalClarity` | number (0-1) | 필수* | 목표 명확도 |
+| `ambiguityScore.constraintClarity` | number (0-1) | 필수* | 제약조건 명확도 |
+| `ambiguityScore.successCriteria` | number (0-1) | 필수* | 성공 기준 명확도 |
+| `ambiguityScore.priorityClarity` | number (0-1) | 필수* | 우선순위 명확도 |
+| `ambiguityScore.contextClarity` | number (0-1) | 선택 | 컨텍스트 명확도 |
+| `ambiguityScore.contradictions` | string[] | 선택 | 발견된 모순 목록 |
+
+\* ambiguityScore 객체를 제공할 경우 필수
+
+### Action별 응답 구조 (Passthrough)
+
+**`start`** → `{ status, sessionId, projectType, detectedFiles, gestaltContext, roundNumber, message }`
+
+**`respond`** → `{ status, sessionId, roundNumber, gestaltContext, ambiguityScore, message }`
+
+**`score`** (점수 미제공 시) → `{ status, ambiguityScore, scoringPrompt, message }`
+**`score`** (점수 제공 시) → `{ status, ambiguityScore }`
+
+**`complete`** → `{ status, sessionId, totalRounds, finalAmbiguityScore, message }`
+
+### GestaltContext 필드
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| `systemPrompt` | string | 인터뷰어 시스템 프롬프트 |
+| `currentPrinciple` | GestaltPrinciple | 현재 적용 중인 게슈탈트 원리 |
+| `principleStrategy` | string | 해당 원리의 질문 전략 설명 |
+| `phase` | string | 현재 인터뷰 단계 라벨 |
+| `questionPrompt` | string | 다음 질문 생성용 프롬프트 |
+| `scoringPrompt` | string? | 모호성 점수 산출용 프롬프트 (respond 후에만 포함) |
+| `roundNumber` | number | 현재 라운드 번호 |

package/skills/spec/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: spec
+version: "1.0.0"
+description: "Generate a Spec specification from a completed interview"
+triggers:
+  - "generate spec"
+  - "create spec"
+  - "build spec"
+inputs:
+  sessionId:
+    type: string
+    required: true
+    description: "The interview session ID to generate a spec from"
+  force:
+    type: boolean
+    required: false
+    description: "Force generation even if ambiguity threshold is not met"
+outputs:
+  - spec
+---
+
+# Spec Generation Skill
+
+This skill transforms completed interview data into a structured project specification (Spec).
+
+## Output Structure
+
+- **Goal**: Clear project objective
+- **Constraints**: Technical and business constraints
+- **Acceptance Criteria**: Measurable success conditions
+- **Ontology Schema**: Entity-relationship model
+- **Gestalt Analysis**: Findings from each principle applied
+
+## Requirements
+
+- Interview session must be in `completed` status
+- Ambiguity score must be ≤ 0.2 (unless `force` is true)
+
+## Passthrough Mode
+
+API 키 없이 MCP 서버 실행 시 자동 활성화. Spec 생성을 caller가 직접 수행한다.
+
+### 추가 Input 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| `spec` | object | 2단계에서 필수 | caller가 생성한 Spec JSON |
+| `spec.goal` | string | 필수 | 프로젝트 목표 |
+| `spec.constraints` | string[] | 필수 | 기술/비즈니스 제약조건 |
+| `spec.acceptanceCriteria` | string[] | 필수 | 수용 기준 |
+| `spec.ontologySchema` | object | 필수 | 엔티티-관계 모델 |
+| `spec.gestaltAnalysis` | array | 필수 | 게슈탈트 분석 결과 |
+
+### 2단계 플로우
+
+**1단계: SpecContext 요청**
+```
+ges_generate_spec({ sessionId: "<id>" })
+```
+→ `{ status: "prompt", specContext, message }` 반환
+
+SpecContext 필드:
+- `systemPrompt`: Spec 생성용 시스템 프롬프트
+- `specPrompt`: 인터뷰 내용 기반 Spec 생성 프롬프트
+- `allRounds[]`: `{ roundNumber, question, response, gestaltFocus }`
+
+**2단계: Spec 제출 및 검증**
+```
+ges_generate_spec({
+  sessionId: "<id>",
+  spec: {
+    goal: "명확한 프로젝트 목표",
+    constraints: ["TypeScript 사용", "REST API"],
+    acceptanceCriteria: ["응답 시간 200ms 이하"],
+    ontologySchema: {
+      entities: [{ name: "User", description: "...", attributes: ["id", "email"] }],
+      relations: [{ from: "User", to: "Order", type: "has_many" }]
+    },
+    gestaltAnalysis: [
+      { principle: "closure", finding: "인증 요구사항 완전히 파악됨", confidence: 0.9 }
+    ]
+  }
+})
+```
+→ `{ status: "generated", spec }` (metadata 자동 생성 포함) 또는 `{ error }` 반환
+
+### Spec 검증 스키마 (Zod)
+
+- `gestaltAnalysis[].principle`: `closure | proximity | similarity | figure_ground | continuity`
+- `gestaltAnalysis[].confidence`: 0.0 ~ 1.0
+- `ontologySchema.entities[]`: `{ name: string(min 1), description: string, attributes: string[] }`
+- `ontologySchema.relations[]`: `{ from: string(min 1), to: string(min 1), type: string(min 1) }`