mrvn-cli 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,284 @@
+import { SdkMcpToolDefinition, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Command } from 'commander';
+
+interface MarvinUserConfig {
+    apiKey?: string;
+    defaultModel?: string;
+    defaultPersona?: string;
+}
+interface GitConfig {
+    remote?: string;
+}
+interface MarvinProjectConfig {
+    name: string;
+    methodology?: string;
+    personas?: Record<string, PersonaConfigOverride>;
+    documentTypes?: string[];
+    git?: GitConfig;
+    skills?: Record<string, string[]>;
+}
+interface PersonaConfigOverride {
+    enabled?: boolean;
+    extraInstructions?: string;
+}
+interface MergedConfig {
+    apiKey?: string;
+    defaultModel: string;
+    defaultPersona: string;
+    project: MarvinProjectConfig;
+}
+declare function loadUserConfig(): MarvinUserConfig;
+declare function saveUserConfig(config: MarvinUserConfig): void;
+declare function getConfig(marvinDir: string): MergedConfig;
+
+interface MarvinProject {
+    root: string;
+    marvinDir: string;
+    config: MarvinProjectConfig;
+}
+declare function findProjectRoot(from?: string): string;
+declare function isMarvinProject(dir?: string): boolean;
+declare function loadProject(from?: string): MarvinProject;
+
+declare class MarvinError extends Error {
+    constructor(message: string);
+}
+declare class ProjectNotFoundError extends MarvinError {
+    constructor(searchedFrom: string);
+}
+declare class ConfigError extends MarvinError {
+    constructor(message: string);
+}
+declare class ApiKeyMissingError extends MarvinError {
+    constructor();
+}
+
+type DocumentType = string;
+declare const CORE_DOCUMENT_TYPES: readonly ["decision", "action", "question"];
+interface DocumentTypeRegistration {
+    type: string;
+    dirName: string;
+    idPrefix: string;
+}
+interface DocumentFrontmatter {
+    id: string;
+    title: string;
+    type: DocumentType;
+    status: string;
+    created: string;
+    updated: string;
+    owner?: string;
+    priority?: string;
+    tags?: string[];
+    source?: string;
+    [key: string]: unknown;
+}
+interface Document {
+    frontmatter: DocumentFrontmatter;
+    content: string;
+    filePath: string;
+}
+interface DocumentQuery {
+    type?: DocumentType;
+    status?: string;
+    owner?: string;
+    tag?: string;
+}
+
+declare class DocumentStore {
+    private docsDir;
+    private index;
+    private typeDirs;
+    private idPrefixes;
+    constructor(marvinDir: string, registrations?: DocumentTypeRegistration[]);
+    get registeredTypes(): string[];
+    private buildIndex;
+    list(query?: DocumentQuery): Document[];
+    get(id: string): Document | undefined;
+    create(type: DocumentType, frontmatter: Partial<DocumentFrontmatter>, content?: string): Document;
+    importDocument(type: DocumentType, frontmatter: DocumentFrontmatter, content?: string): Document;
+    update(id: string, updates: Partial<DocumentFrontmatter>, content?: string): Document;
+    nextId(type: DocumentType): string;
+    counts(): Record<string, number>;
+}
+
+declare function parseDocument(raw: string, filePath: string): Document;
+declare function serializeDocument(doc: Document): string;
+
+interface PersonaDefinition {
+    id: string;
+    name: string;
+    shortName: string;
+    description: string;
+    systemPrompt: string;
+    focusAreas: string[];
+    documentTypes: string[];
+}
+
+declare function getPersona(idOrShortName: string): PersonaDefinition | undefined;
+declare function listPersonas(): PersonaDefinition[];
+declare function resolvePersonaId(input: string): string;
+
+declare function buildSystemPrompt(persona: PersonaDefinition, projectConfig: MarvinProjectConfig, pluginPromptFragment?: string, skillPromptFragment?: string): string;
+
+interface SessionEntry {
+    id: string;
+    name: string;
+    persona: string;
+    created: string;
+    lastUsed: string;
+    turnCount: number;
+}
+declare class SessionStore {
+    private filePath;
+    constructor(marvinDir: string);
+    list(): SessionEntry[];
+    get(name: string): SessionEntry | undefined;
+    getById(sessionId: string): SessionEntry | undefined;
+    save(entry: SessionEntry): void;
+    delete(name: string): boolean;
+    updateLastUsed(name: string, turnCount: number): void;
+    private load;
+    private write;
+}
+
+type SourceFileStatus = "pending" | "processing" | "completed" | "error";
+interface SourceFileEntry {
+    hash: string;
+    addedAt: string;
+    processedAt: string | null;
+    status: SourceFileStatus;
+    artifacts: string[];
+    error: string | null;
+}
+interface SourceManifest {
+    version: 1;
+    files: Record<string, SourceFileEntry>;
+}
+interface IngestOptions {
+    marvinDir: string;
+    fileName: string;
+    draft: boolean;
+    persona: string;
+}
+interface IngestResult {
+    fileName: string;
+    artifacts: string[];
+    draft: boolean;
+}
+
+declare class SourceManifestManager {
+    private manifest;
+    private manifestPath;
+    readonly sourcesDir: string;
+    constructor(marvinDir: string);
+    private load;
+    save(): void;
+    scan(): {
+        added: string[];
+        changed: string[];
+        removed: string[];
+    };
+    list(status?: SourceFileStatus): Array<{
+        name: string;
+        entry: SourceFileEntry;
+    }>;
+    get(fileName: string): SourceFileEntry | undefined;
+    unprocessed(): string[];
+    markProcessing(fileName: string): void;
+    markCompleted(fileName: string, artifacts: string[]): void;
+    markError(fileName: string, error: string): void;
+    private hashFile;
+}
+
+interface McpServerOptions {
+    manifest?: SourceManifestManager;
+    sourcesDir?: string;
+    sessionStore?: SessionStore;
+    pluginTools?: SdkMcpToolDefinition<any>[];
+    skillTools?: SdkMcpToolDefinition<any>[];
+}
+declare function createMarvinMcpServer(store: DocumentStore, options?: McpServerOptions): McpSdkServerConfigWithInstance;
+
+interface SessionOptions {
+    persona: PersonaDefinition;
+    config: MergedConfig;
+    marvinDir: string;
+    projectRoot: string;
+    initialPrompt?: string;
+    sessionName?: string;
+}
+declare function startSession(options: SessionOptions): Promise<void>;
+
+interface MarvinPlugin {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    /** Additional personas provided by this plugin */
+    personas?: PersonaDefinition[];
+    /** Additional MCP tools provided by this plugin */
+    tools?: (store: DocumentStore, marvinDir?: string) => SdkMcpToolDefinition[];
+    /** Additional document types this plugin handles */
+    documentTypes?: string[];
+    /** Document type registrations for extending the storage layer */
+    documentTypeRegistrations?: DocumentTypeRegistration[];
+    /** Prompt fragments injected per persona. Key is persona ID; "*" applies to all. */
+    promptFragments?: Record<string, string>;
+    /** Lifecycle hook: called when plugin is loaded */
+    onLoad?: () => Promise<void>;
+}
+
+declare function resolvePlugin(methodologyId?: string): MarvinPlugin | undefined;
+declare function getPluginTools(plugin: MarvinPlugin, store: DocumentStore, marvinDir?: string): SdkMcpToolDefinition<any>[];
+declare function getPluginPromptFragment(plugin: MarvinPlugin, personaId: string): string | undefined;
+
+declare const COMMON_REGISTRATIONS: DocumentTypeRegistration[];
+declare function createCommonTools(store: DocumentStore): SdkMcpToolDefinition<any>[];
+
+interface SkillDefinition {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    personas?: string[];
+    tools?: (store: DocumentStore) => SdkMcpToolDefinition<any>[];
+    promptFragments?: Record<string, string>;
+    actions?: SkillAction[];
+}
+interface SkillAction {
+    id: string;
+    name: string;
+    description: string;
+    systemPrompt: string;
+    maxTurns?: number;
+    allowGovernanceTools?: boolean;
+}
+
+declare function loadAllSkills(marvinDir?: string): Map<string, SkillDefinition>;
+declare function resolveSkillsForPersona(personaId: string, skillsConfig: Record<string, string[]> | undefined, allSkills: Map<string, SkillDefinition>): string[];
+declare function getSkillTools(skillIds: string[], allSkills: Map<string, SkillDefinition>, store: DocumentStore): SdkMcpToolDefinition<any>[];
+declare function getSkillPromptFragment(skillIds: string[], allSkills: Map<string, SkillDefinition>, personaId: string): string | undefined;
+
+interface StdioServerOptions {
+    marvinDir: string;
+}
+/**
+ * Collect all governance tool definitions from the existing tool creators.
+ * Reuses the same tool factories as the agent MCP server.
+ */
+declare function collectTools(marvinDir: string): SdkMcpToolDefinition<any>[];
+/**
+ * Register SdkMcpToolDefinition objects onto an McpServer instance.
+ * The adapter is nearly 1:1 since both use Zod raw shapes and CallToolResult.
+ */
+declare function registerSdkTools(server: McpServer, tools: SdkMcpToolDefinition<any>[]): void;
+/**
+ * Create an McpServer with all governance tools and connect it via stdio transport.
+ */
+declare function startStdioServer(options: StdioServerOptions): Promise<void>;
+
+declare function createProgram(): Command;
+
+export { ApiKeyMissingError, COMMON_REGISTRATIONS, CORE_DOCUMENT_TYPES, ConfigError, type Document, type DocumentFrontmatter, type DocumentQuery, DocumentStore, type DocumentType, type DocumentTypeRegistration, type IngestOptions, type IngestResult, MarvinError, type MarvinPlugin, type MarvinProjectConfig, type MarvinUserConfig, type MergedConfig, type PersonaDefinition, ProjectNotFoundError, type SessionEntry, type SessionOptions, SessionStore, type SkillAction, type SkillDefinition, type SourceFileEntry, type SourceFileStatus, type SourceManifest, SourceManifestManager, type StdioServerOptions, buildSystemPrompt, collectTools, createCommonTools, createMarvinMcpServer, createProgram, findProjectRoot, getConfig, getPersona, getPluginPromptFragment, getPluginTools, getSkillPromptFragment, getSkillTools, isMarvinProject, listPersonas, loadAllSkills, loadProject, loadUserConfig, parseDocument, registerSdkTools, resolvePersonaId, resolvePlugin, resolveSkillsForPersona, saveUserConfig, serializeDocument, startSession, startStdioServer };