specky-sdd 1.0.0

package/dist/index.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * Specky MCP Server — Entry Point
+ * Spec-Driven Development engine for AI agents.
+ *
+ * Creator: Paula Silva @paulasilvatech @paulanunes85 | Americas Software GBB
+ * License: MIT
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { randomUUID } from "node:crypto";
+import { VERSION, SERVER_NAME, DEFAULT_HTTP_PORT } from "./constants.js";
+import { FileManager } from "./services/file-manager.js";
+import { StateMachine } from "./services/state-machine.js";
+import { TemplateEngine } from "./services/template-engine.js";
+import { EarsValidator } from "./services/ears-validator.js";
+import { CodebaseScanner } from "./services/codebase-scanner.js";
+import { registerPipelineTools } from "./tools/pipeline.js";
+import { registerAnalysisTools } from "./tools/analysis.js";
+import { registerUtilityTools } from "./tools/utility.js";
+import { registerTranscriptTools } from "./tools/transcript.js";
+import { TranscriptParser } from "./services/transcript-parser.js";
+// Resolve workspace root
+const workspaceRoot = process.env["SDD_WORKSPACE"] || process.cwd();
+console.error(`[specky] Workspace root: ${workspaceRoot}`);
+// Initialize MCP server
+const server = new McpServer({
+    name: SERVER_NAME,
+    version: VERSION,
+});
+// Initialize services
+const fileManager = new FileManager(workspaceRoot);
+const stateMachine = new StateMachine(fileManager);
+const templateEngine = new TemplateEngine(fileManager);
+const earsValidator = new EarsValidator();
+const codebaseScanner = new CodebaseScanner(fileManager);
+const transcriptParser = new TranscriptParser(fileManager);
+// Register all tools (16 total)
+registerPipelineTools(server, fileManager, stateMachine, templateEngine, earsValidator);
+registerAnalysisTools(server, fileManager, stateMachine, templateEngine);
+registerUtilityTools(server, fileManager, stateMachine, templateEngine, codebaseScanner);
+registerTranscriptTools(server, fileManager, stateMachine, templateEngine, earsValidator, transcriptParser);
+// Graceful shutdown
+let isShuttingDown = false;
+function handleShutdown(signal) {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    console.error(`[specky] Received ${signal}, shutting down gracefully...`);
+    server.close().then(() => {
+        console.error("[specky] Server closed.");
+        process.exit(0);
+    }).catch((err) => {
+        console.error("[specky] Error during shutdown:", err);
+        process.exit(1);
+    });
+}
+process.on("SIGINT", () => handleShutdown("SIGINT"));
+process.on("SIGTERM", () => handleShutdown("SIGTERM"));
+// Start server
+async function main() {
+    const args = process.argv.slice(2);
+    const useHttp = args.includes("--http");
+    if (useHttp) {
+        const port = parseInt(process.env["PORT"] || String(DEFAULT_HTTP_PORT), 10);
+        const { StreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/server/streamableHttp.js");
+        const http = await import("node:http");
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+        });
+        await server.connect(transport);
+        const httpServer = http.createServer(async (req, res) => {
+            if (req.url === "/mcp") {
+                await transport.handleRequest(req, res);
+            }
+            else {
+                res.writeHead(404);
+                res.end("Not found");
+            }
+        });
+        httpServer.listen(port, () => {
+            console.error(`[specky] HTTP server listening on port ${port}`);
+        });
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error(`[specky] Server started on stdio (v${VERSION})`);
+    }
+}
+main().catch((err) => {
+    console.error("[specky] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schemas/common.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared Zod schemas used across multiple tools.
+ */
+import { z } from "zod";
+export declare const specDirSchema: z.ZodDefault<z.ZodString>;
+export declare const featureNumberSchema: z.ZodDefault<z.ZodString>;
+export declare const forceSchema: z.ZodDefault<z.ZodBoolean>;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa,2BAGqC,CAAC;AAEhE,eAAO,MAAM,mBAAmB,2BAIuB,CAAC;AAExD,eAAO,MAAM,WAAW,4BAGuB,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,18 @@
+/**
+ * Shared Zod schemas used across multiple tools.
+ */
+import { z } from "zod";
+export const specDirSchema = z
+    .string()
+    .default(".specs")
+    .describe("Spec directory path (relative to workspace root)");
+export const featureNumberSchema = z
+    .string()
+    .regex(/^\d{3}$/, "Feature number must be 3 digits, e.g. '001'")
+    .default("001")
+    .describe("Feature number (zero-padded, e.g. '001')");
+export const forceSchema = z
+    .boolean()
+    .default(false)
+    .describe("Overwrite existing files if true");
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,OAAO,CAAC,QAAQ,CAAC;KACjB,QAAQ,CAAC,kDAAkD,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,KAAK,CAAC,SAAS,EAAE,6CAA6C,CAAC;KAC/D,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CAAC,0CAA0C,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,OAAO,EAAE;KACT,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CAAC,kCAAkC,CAAC,CAAC"}

package/dist/schemas/pipeline.d.ts

@@ -0,0 +1,296 @@
+/**
+ * Zod schemas for all 8 pipeline tool inputs.
+ */
+import { z } from "zod";
+export declare const initInputSchema: z.ZodObject<{
+    project_name: z.ZodString;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    principles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    project_name: string;
+    spec_dir: string;
+    principles?: string[] | undefined;
+    constraints?: string[] | undefined;
+}, {
+    project_name: string;
+    spec_dir?: string | undefined;
+    principles?: string[] | undefined;
+    constraints?: string[] | undefined;
+}>;
+export declare const discoverInputSchema: z.ZodObject<{
+    project_idea: z.ZodString;
+    codebase_summary: z.ZodOptional<z.ZodString>;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    project_idea: string;
+    feature_number: string;
+    codebase_summary?: string | undefined;
+}, {
+    project_idea: string;
+    spec_dir?: string | undefined;
+    codebase_summary?: string | undefined;
+    feature_number?: string | undefined;
+}>;
+export declare const writeSpecInputSchema: z.ZodObject<{
+    feature_name: z.ZodString;
+    feature_number: z.ZodDefault<z.ZodString>;
+    discovery_answers: z.ZodRecord<z.ZodString, z.ZodString>;
+    requirements: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        ears_pattern: z.ZodString;
+        text: z.ZodString;
+        acceptance_criteria: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        ears_pattern: string;
+        text: string;
+        acceptance_criteria: string[];
+    }, {
+        id: string;
+        ears_pattern: string;
+        text: string;
+        acceptance_criteria: string[];
+    }>, "many">;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+    feature_name: string;
+    discovery_answers: Record<string, string>;
+    requirements: {
+        id: string;
+        ears_pattern: string;
+        text: string;
+        acceptance_criteria: string[];
+    }[];
+    force: boolean;
+}, {
+    feature_name: string;
+    discovery_answers: Record<string, string>;
+    requirements: {
+        id: string;
+        ears_pattern: string;
+        text: string;
+        acceptance_criteria: string[];
+    }[];
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+    force?: boolean | undefined;
+}>;
+export declare const clarifyInputSchema: z.ZodObject<{
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+}, {
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+}>;
+export declare const writeDesignInputSchema: z.ZodObject<{
+    architecture_overview: z.ZodString;
+    mermaid_diagrams: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        type: z.ZodString;
+        code: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        type: string;
+        code: string;
+    }, {
+        title: string;
+        type: string;
+        code: string;
+    }>, "many">;
+    adrs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        decision: z.ZodString;
+        rationale: z.ZodString;
+        consequences: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        decision: string;
+        rationale: string;
+        consequences: string;
+    }, {
+        title: string;
+        decision: string;
+        rationale: string;
+        consequences: string;
+    }>, "many">>;
+    api_contracts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        endpoint: z.ZodString;
+        method: z.ZodString;
+        description: z.ZodString;
+        request: z.ZodOptional<z.ZodString>;
+        response: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        endpoint: string;
+        method: string;
+        description: string;
+        request?: string | undefined;
+        response?: string | undefined;
+    }, {
+        endpoint: string;
+        method: string;
+        description: string;
+        request?: string | undefined;
+        response?: string | undefined;
+    }>, "many">>;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+    force: boolean;
+    architecture_overview: string;
+    mermaid_diagrams: {
+        title: string;
+        type: string;
+        code: string;
+    }[];
+    adrs?: {
+        title: string;
+        decision: string;
+        rationale: string;
+        consequences: string;
+    }[] | undefined;
+    api_contracts?: {
+        endpoint: string;
+        method: string;
+        description: string;
+        request?: string | undefined;
+        response?: string | undefined;
+    }[] | undefined;
+}, {
+    architecture_overview: string;
+    mermaid_diagrams: {
+        title: string;
+        type: string;
+        code: string;
+    }[];
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+    force?: boolean | undefined;
+    adrs?: {
+        title: string;
+        decision: string;
+        rationale: string;
+        consequences: string;
+    }[] | undefined;
+    api_contracts?: {
+        endpoint: string;
+        method: string;
+        description: string;
+        request?: string | undefined;
+        response?: string | undefined;
+    }[] | undefined;
+}>;
+export declare const writeTasksInputSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        effort: z.ZodEnum<["S", "M", "L"]>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        parallel: z.ZodDefault<z.ZodBoolean>;
+        traces_to: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        dependencies: string[];
+        id: string;
+        description: string;
+        effort: "S" | "M" | "L";
+        parallel: boolean;
+        traces_to: string[];
+    }, {
+        title: string;
+        id: string;
+        description: string;
+        effort: "S" | "M" | "L";
+        dependencies?: string[] | undefined;
+        parallel?: boolean | undefined;
+        traces_to?: string[] | undefined;
+    }>, "many">;
+    pre_impl_gates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        check: z.ZodString;
+        constitution_article: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        check: string;
+        constitution_article: string;
+    }, {
+        id: string;
+        check: string;
+        constitution_article: string;
+    }>, "many">>;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    tasks: {
+        title: string;
+        dependencies: string[];
+        id: string;
+        description: string;
+        effort: "S" | "M" | "L";
+        parallel: boolean;
+        traces_to: string[];
+    }[];
+    spec_dir: string;
+    feature_number: string;
+    force: boolean;
+    pre_impl_gates: {
+        id: string;
+        check: string;
+        constitution_article: string;
+    }[];
+}, {
+    tasks: {
+        title: string;
+        id: string;
+        description: string;
+        effort: "S" | "M" | "L";
+        dependencies?: string[] | undefined;
+        parallel?: boolean | undefined;
+        traces_to?: string[] | undefined;
+    }[];
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+    force?: boolean | undefined;
+    pre_impl_gates?: {
+        id: string;
+        check: string;
+        constitution_article: string;
+    }[] | undefined;
+}>;
+export declare const runAnalysisInputSchema: z.ZodObject<{
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+    force: boolean;
+}, {
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+    force?: boolean | undefined;
+}>;
+export declare const advancePhaseInputSchema: z.ZodObject<{
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+}, {
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+}>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/schemas/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/schemas/pipeline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAgBjB,CAAC;AAEZ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAYrB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBtB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;;;;;;;;EAGpB,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCxB,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BvB,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIxB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;EAGzB,CAAC"}

package/dist/schemas/pipeline.js

@@ -0,0 +1,132 @@
+/**
+ * Zod schemas for all 8 pipeline tool inputs.
+ */
+import { z } from "zod";
+import { specDirSchema, featureNumberSchema, forceSchema } from "./common.js";
+export const initInputSchema = z.object({
+    project_name: z
+        .string()
+        .min(1)
+        .max(100)
+        .regex(/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/, "Must be kebab-case (lowercase, hyphens)")
+        .describe("Project name in kebab-case"),
+    spec_dir: specDirSchema,
+    principles: z
+        .array(z.string())
+        .optional()
+        .describe("Project guiding principles"),
+    constraints: z
+        .array(z.string())
+        .optional()
+        .describe("Project constraints"),
+}).strict();
+export const discoverInputSchema = z.object({
+    project_idea: z
+        .string()
+        .min(1)
+        .max(5000)
+        .describe("Description of the project idea"),
+    codebase_summary: z
+        .string()
+        .optional()
+        .describe("Output from sdd_scan_codebase for context"),
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+}).strict();
+export const writeSpecInputSchema = z.object({
+    feature_name: z
+        .string()
+        .min(1)
+        .max(200)
+        .describe("Human-readable feature name"),
+    feature_number: featureNumberSchema,
+    discovery_answers: z
+        .record(z.string(), z.string())
+        .describe("Answers to discovery questions (question_id → answer)"),
+    requirements: z
+        .array(z.object({
+        id: z.string().regex(/^REQ-[A-Z]+-\d{3}$/, "Must match REQ-{CAT}-{SEQ} format"),
+        ears_pattern: z.string().describe("EARS pattern name"),
+        text: z.string().min(10).describe("Requirement text in EARS notation"),
+        acceptance_criteria: z.array(z.string()).min(1).describe("Testable acceptance criteria"),
+    }).strict())
+        .min(1)
+        .describe("Requirements in EARS notation"),
+    spec_dir: specDirSchema,
+    force: forceSchema,
+}).strict();
+export const clarifyInputSchema = z.object({
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+}).strict();
+export const writeDesignInputSchema = z.object({
+    architecture_overview: z
+        .string()
+        .min(10)
+        .describe("High-level architecture description"),
+    mermaid_diagrams: z
+        .array(z.object({
+        title: z.string().describe("Diagram title"),
+        type: z.string().describe("Mermaid diagram type (flowchart, sequenceDiagram, etc.)"),
+        code: z.string().describe("Mermaid diagram code"),
+    }).strict())
+        .min(1)
+        .describe("Mermaid diagrams"),
+    adrs: z
+        .array(z.object({
+        title: z.string().describe("ADR title"),
+        decision: z.string().describe("The decision made"),
+        rationale: z.string().describe("Why this decision was made"),
+        consequences: z.string().describe("Consequences of this decision"),
+    }).strict())
+        .optional()
+        .describe("Architecture Decision Records"),
+    api_contracts: z
+        .array(z.object({
+        endpoint: z.string().describe("API endpoint path"),
+        method: z.string().describe("HTTP method"),
+        description: z.string().describe("Endpoint description"),
+        request: z.string().optional().describe("Request body schema"),
+        response: z.string().optional().describe("Response body schema"),
+    }).strict())
+        .optional()
+        .describe("API contracts"),
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+    force: forceSchema,
+}).strict();
+export const writeTasksInputSchema = z.object({
+    tasks: z
+        .array(z.object({
+        id: z.string().regex(/^T-\d{3}$/, "Must match T-{SEQ} format"),
+        title: z.string().describe("Task title"),
+        description: z.string().describe("Task description"),
+        effort: z.enum(["S", "M", "L"]).describe("Effort estimate"),
+        dependencies: z.array(z.string()).default([]).describe("Task IDs this depends on"),
+        parallel: z.boolean().default(false).describe("Can run in parallel with siblings"),
+        traces_to: z.array(z.string()).default([]).describe("Requirement IDs this implements"),
+    }).strict())
+        .min(1)
+        .describe("Implementation tasks"),
+    pre_impl_gates: z
+        .array(z.object({
+        id: z.string().describe("Gate ID"),
+        check: z.string().describe("Gate check description"),
+        constitution_article: z.string().describe("Constitution article reference"),
+    }).strict())
+        .default([])
+        .describe("Pre-implementation gates"),
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+    force: forceSchema,
+}).strict();
+export const runAnalysisInputSchema = z.object({
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+    force: forceSchema,
+}).strict();
+export const advancePhaseInputSchema = z.object({
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+}).strict();
+//# sourceMappingURL=pipeline.js.map

package/dist/schemas/pipeline.js.map

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

package/dist/schemas/transcript.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Zod schemas for transcript automation tools.
+ */
+import { z } from "zod";
+export declare const importTranscriptInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    raw_text: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["vtt", "srt", "txt", "md", "auto"]>>;
+    spec_dir: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    file_path: string;
+    format: "vtt" | "srt" | "txt" | "md" | "auto";
+    raw_text?: string | undefined;
+}, {
+    file_path: string;
+    spec_dir?: string | undefined;
+    raw_text?: string | undefined;
+    format?: "vtt" | "srt" | "txt" | "md" | "auto" | undefined;
+}>;
+export declare const autoPipelineInputSchema: z.ZodObject<{
+    file_path: z.ZodOptional<z.ZodString>;
+    raw_text: z.ZodOptional<z.ZodString>;
+    project_name: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["vtt", "srt", "txt", "md", "auto"]>>;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    principles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    project_name: string;
+    spec_dir: string;
+    force: boolean;
+    format: "vtt" | "srt" | "txt" | "md" | "auto";
+    principles?: string[] | undefined;
+    file_path?: string | undefined;
+    raw_text?: string | undefined;
+}, {
+    project_name: string;
+    spec_dir?: string | undefined;
+    principles?: string[] | undefined;
+    force?: boolean | undefined;
+    file_path?: string | undefined;
+    raw_text?: string | undefined;
+    format?: "vtt" | "srt" | "txt" | "md" | "auto" | undefined;
+}>;
+export declare const batchTranscriptsInputSchema: z.ZodObject<{
+    transcripts_dir: z.ZodString;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    force: boolean;
+    transcripts_dir: string;
+}, {
+    transcripts_dir: string;
+    spec_dir?: string | undefined;
+    force?: boolean | undefined;
+}>;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/schemas/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/schemas/transcript.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAc7B,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;EA4BzB,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAU7B,CAAC"}