openkitt 0.1.2

package/dist/llm/operations.js

@@ -0,0 +1,131 @@
+import { OPERATIONS_SYSTEM_PROMPT } from '../prompts/operations.js';
+import { MAX_RETRIES } from './rate-limiter.js';
+const MAX_TOOL_LOOP_ITERATIONS = MAX_RETRIES * 3 + 1;
+function toLlmTools(tools) {
+    return tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+    }));
+}
+function isToolUseStopReason(stopReason) {
+    return stopReason === 'tool_use' || stopReason === 'tool_calls';
+}
+function formatToolResultContent(result) {
+    if (result.content.length === 0) {
+        return '';
+    }
+    return result.content.map((item) => item.text).join('\n');
+}
+function formatToolError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function toAssistantHistoryEntry(response) {
+    const entry = {
+        role: 'assistant',
+        content: response.content,
+    };
+    if (response.toolCalls.length > 0) {
+        entry.tool_calls = response.toolCalls.map((call) => ({
+            id: call.id,
+            type: 'function',
+            function: {
+                name: call.name,
+                arguments: JSON.stringify(call.arguments),
+            },
+        }));
+    }
+    return entry;
+}
+async function executeToolCall(options) {
+    const { toolCall, mcpClient, projectGuard } = options;
+    try {
+        const result = projectGuard
+            ? await projectGuard.guardedCallTool(mcpClient, toolCall.name, toolCall.arguments)
+            : await mcpClient.callTool(toolCall.name, toolCall.arguments);
+        return {
+            toolCallId: toolCall.id,
+            content: formatToolResultContent(result),
+            ...(result.isError ? { isError: true } : {}),
+        };
+    }
+    catch (error) {
+        return {
+            toolCallId: toolCall.id,
+            content: formatToolError(error),
+            isError: true,
+        };
+    }
+}
+export function buildOperationsContext(command, args, manifest) {
+    const apps = Object.fromEntries(Object.entries(manifest.apps).map(([appName, app]) => [
+        appName,
+        {
+            type: app.type,
+            framework: app.framework,
+            integrations: app.integrations,
+            ...(app.railway ? { railway: app.railway } : {}),
+        },
+    ]));
+    const packages = Object.fromEntries(Object.entries(manifest.packages).map(([packageName, pkg]) => [
+        packageName,
+        {
+            active: pkg.active,
+            consumers: pkg.consumers,
+            ...(pkg.clients ? { clients: pkg.clients } : {}),
+        },
+    ]));
+    return {
+        command,
+        args,
+        workspace: {
+            name: manifest.workspace.name,
+            packageManager: manifest.workspace.packageManager,
+            ...(manifest.workspace.railway ? { railway: manifest.workspace.railway } : {}),
+            apps,
+            packages,
+        },
+    };
+}
+export async function executeOperations(options) {
+    const { llmClient, mcpClient, context, projectGuard } = options;
+    const tools = toLlmTools(await mcpClient.listTools());
+    const userMessage = JSON.stringify(context, null, 2);
+    const conversationHistory = [{ role: 'user', content: userMessage }];
+    let response = await llmClient.sendMessageWithTools({
+        systemPrompt: OPERATIONS_SYSTEM_PROMPT,
+        userMessage,
+        tools,
+    });
+    for (let iteration = 0; iteration < MAX_TOOL_LOOP_ITERATIONS; iteration += 1) {
+        const hasToolCalls = response.toolCalls.length > 0;
+        const expectsToolCalls = isToolUseStopReason(response.stopReason);
+        if (!hasToolCalls && !expectsToolCalls) {
+            return response.content;
+        }
+        if (!hasToolCalls && expectsToolCalls) {
+            return response.content;
+        }
+        conversationHistory.push(toAssistantHistoryEntry(response));
+        const toolResults = [];
+        for (const toolCall of response.toolCalls) {
+            const result = await executeToolCall({
+                toolCall,
+                mcpClient,
+                projectGuard,
+            });
+            toolResults.push(result);
+        }
+        response = await llmClient.sendToolResults({
+            conversationHistory,
+            toolResults,
+            systemPrompt: OPERATIONS_SYSTEM_PROMPT,
+            tools,
+        });
+    }
+    throw new Error(`Operations tool-use loop exceeded maximum iterations (${MAX_TOOL_LOOP_ITERATIONS}).`);
+}
+//# sourceMappingURL=operations.js.map

package/dist/llm/operations.js.map

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

package/dist/llm/rate-limiter.d.ts

@@ -0,0 +1,20 @@
+export declare const MAX_RETRIES = 3;
+export declare const WARN_THRESHOLD = 50;
+export declare const BLOCK_THRESHOLD = 100;
+export type RateLimitCheck = {
+    allowed: boolean;
+    reason?: string;
+    callCount: number;
+};
+export interface RateLimiter {
+    recordCall(estimatedTokens: number): void;
+    canMakeCall(): RateLimitCheck;
+    getCallCount(): number;
+    getEstimatedTokensUsed(): number;
+    shouldWarn(): boolean;
+    isBlocked(): boolean;
+    reset(): void;
+}
+export declare function calculateBackoff(attempt: number): number;
+export declare function estimateTokens(systemPrompt: string, userMessage: string): number;
+export declare function createRateLimiter(): RateLimiter;

package/dist/llm/rate-limiter.js

@@ -0,0 +1,57 @@
+import { warn } from '../utils/display.js';
+export const MAX_RETRIES = 3;
+export const WARN_THRESHOLD = 50;
+export const BLOCK_THRESHOLD = 100;
+const BACKOFF_BASE_MS = 1_000;
+const CHARS_PER_TOKEN = 4;
+export function calculateBackoff(attempt) {
+    const normalizedAttempt = Math.max(1, Math.min(attempt, MAX_RETRIES));
+    return BACKOFF_BASE_MS * 4 ** (normalizedAttempt - 1);
+}
+export function estimateTokens(systemPrompt, userMessage) {
+    const totalChars = systemPrompt.length + userMessage.length;
+    return Math.ceil(totalChars / CHARS_PER_TOKEN);
+}
+export function createRateLimiter() {
+    let callCount = 0;
+    let estimatedTokensUsed = 0;
+    return {
+        recordCall(estimatedTokens) {
+            if (callCount >= BLOCK_THRESHOLD) {
+                return;
+            }
+            callCount += 1;
+            estimatedTokensUsed += Math.max(0, estimatedTokens);
+            if (callCount === WARN_THRESHOLD) {
+                warn('50 LLM API calls made this session. Continue? (y/n)');
+            }
+        },
+        canMakeCall() {
+            if (callCount >= BLOCK_THRESHOLD) {
+                return {
+                    allowed: false,
+                    reason: 'LLM call limit reached for this session. Start a new session to continue.',
+                    callCount,
+                };
+            }
+            return { allowed: true, callCount };
+        },
+        getCallCount() {
+            return callCount;
+        },
+        getEstimatedTokensUsed() {
+            return estimatedTokensUsed;
+        },
+        shouldWarn() {
+            return callCount >= WARN_THRESHOLD && callCount < BLOCK_THRESHOLD;
+        },
+        isBlocked() {
+            return callCount >= BLOCK_THRESHOLD;
+        },
+        reset() {
+            callCount = 0;
+            estimatedTokensUsed = 0;
+        },
+    };
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/llm/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/llm/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,eAAe,GAAG,CAAC,CAAC;AAc1B,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IACtE,OAAO,eAAe,GAAG,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,WAAmB;IACtE,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAE5B,OAAO;QACL,UAAU,CAAC,eAAe;YACxB,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,OAAO;YACT,CAAC;YAED,SAAS,IAAI,CAAC,CAAC;YACf,mBAAmB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YAEpD,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;gBACjC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,WAAW;YACT,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,2EAA2E;oBACnF,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACtC,CAAC;QAED,YAAY;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,sBAAsB;YACpB,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,UAAU;YACR,OAAO,SAAS,IAAI,cAAc,IAAI,SAAS,GAAG,eAAe,CAAC;QACpE,CAAC;QAED,SAAS;YACP,OAAO,SAAS,IAAI,eAAe,CAAC;QACtC,CAAC;QAED,KAAK;YACH,SAAS,GAAG,CAAC,CAAC;YACd,mBAAmB,GAAG,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/llm/scaffolding.d.ts

@@ -0,0 +1,51 @@
+import type { WorkspaceManifest } from '../manifest/types.js';
+import type { LlmClient } from './client.js';
+export interface ScaffoldingContext {
+    appName: string;
+    appType: 'frontend' | 'backend';
+    framework: string;
+    integrations: string[];
+    versions: Record<string, string>;
+    packageManager: 'bun' | 'npm' | 'pnpm' | 'yarn';
+    existingPackages: Record<string, {
+        active: boolean;
+        consumers: string[];
+        clients?: string[];
+    }>;
+    workspaceName: string;
+}
+export interface ScaffoldingResponse {
+    commands: Array<{
+        command: string;
+        purpose: string;
+    }>;
+    newFiles: Array<{
+        path: string;
+        content: string;
+    }>;
+    astTransforms: Array<{
+        path: string;
+        operations: Array<Record<string, unknown>>;
+    }>;
+}
+export interface ScaffoldingDebugInfo {
+    durationMs: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface ScaffoldingResult {
+    scaffolding: ScaffoldingResponse;
+    debug: ScaffoldingDebugInfo;
+}
+interface BuildScaffoldingContextOptions {
+    appName: string;
+    appType: 'frontend' | 'backend';
+    framework: string;
+    integrations: string[];
+    versions: Record<string, string>;
+    manifest: WorkspaceManifest;
+}
+export declare function buildScaffoldingContext(options: BuildScaffoldingContextOptions): ScaffoldingContext;
+export declare function parseScaffoldingResponse(raw: string): ScaffoldingResponse;
+export declare function executeScaffolding(client: LlmClient, context: ScaffoldingContext, onChunk?: (chunkText: string, totalChars: number) => void): Promise<ScaffoldingResult>;
+export {};

package/dist/llm/scaffolding.js

@@ -0,0 +1,118 @@
+import { SCAFFOLDING_SYSTEM_PROMPT } from '../prompts/scaffolding.js';
+import { MAX_RETRIES, calculateBackoff } from './rate-limiter.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isScaffoldingResponse(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    if (!Array.isArray(value.commands) || !Array.isArray(value.newFiles) || !Array.isArray(value.astTransforms)) {
+        return false;
+    }
+    const commandsValid = value.commands.every((command) => {
+        if (!isRecord(command)) {
+            return false;
+        }
+        return typeof command.command === 'string' && typeof command.purpose === 'string';
+    });
+    const newFilesValid = value.newFiles.every((newFile) => {
+        if (!isRecord(newFile)) {
+            return false;
+        }
+        return typeof newFile.path === 'string' && typeof newFile.content === 'string';
+    });
+    const transformsValid = value.astTransforms.every((transform) => {
+        if (!isRecord(transform)) {
+            return false;
+        }
+        return typeof transform.path === 'string' && Array.isArray(transform.operations);
+    });
+    return commandsValid && newFilesValid && transformsValid;
+}
+const ANTHROPIC_SCAFFOLDING_MODEL = 'claude-haiku-4-5';
+const SCAFFOLDING_MAX_TOKENS = 16000;
+const OVERLOAD_RETRY_BASE_MS = 5_000;
+const OVERLOAD_MAX_RETRY_MS = 30_000;
+function createScaffoldingExecutor(client, onChunk) {
+    return {
+        async execute(context) {
+            const payload = {
+                ...context,
+                appName: `<untrusted_user_input>${context.appName}</untrusted_user_input>`,
+            };
+            let lastError;
+            for (let attempt = 1; attempt <= MAX_RETRIES + 1; attempt += 1) {
+                try {
+                    const startMs = Date.now();
+                    const response = await client.sendMessage({
+                        systemPrompt: SCAFFOLDING_SYSTEM_PROMPT,
+                        userMessage: JSON.stringify(payload),
+                        maxTokens: SCAFFOLDING_MAX_TOKENS,
+                        modelOverride: client.getProvider() === 'anthropic' ? ANTHROPIC_SCAFFOLDING_MODEL : undefined,
+                        onChunk,
+                    });
+                    const durationMs = Date.now() - startMs;
+                    return {
+                        scaffolding: parseScaffoldingResponse(response.content),
+                        debug: {
+                            durationMs,
+                            inputTokens: response.usage?.inputTokens ?? 0,
+                            outputTokens: response.usage?.outputTokens ?? 0,
+                        },
+                    };
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error : new Error(String(error));
+                    if (attempt > MAX_RETRIES) {
+                        break;
+                    }
+                    const status = error.status;
+                    const isOverloaded = status === 529;
+                    const NON_RETRIABLE_STATUSES = new Set([400, 401, 403, 404, 422]);
+                    if (status !== undefined && NON_RETRIABLE_STATUSES.has(status)) {
+                        break;
+                    }
+                    const delayMs = isOverloaded
+                        ? Math.min(OVERLOAD_RETRY_BASE_MS * 2 ** (attempt - 1), OVERLOAD_MAX_RETRY_MS) * (0.5 + Math.random() * 0.5)
+                        : calculateBackoff(attempt);
+                    await new Promise((resolve) => {
+                        setTimeout(resolve, delayMs);
+                    });
+                }
+            }
+            throw lastError ?? new Error('Scaffolding request failed after retries.');
+        },
+    };
+}
+export function buildScaffoldingContext(options) {
+    return {
+        appName: options.appName,
+        appType: options.appType,
+        framework: options.framework,
+        integrations: [...options.integrations],
+        versions: { ...options.versions },
+        packageManager: options.manifest.workspace.packageManager,
+        existingPackages: { ...options.manifest.packages },
+        workspaceName: options.manifest.workspace.name,
+    };
+}
+export function parseScaffoldingResponse(raw) {
+    let parsed;
+    const stripped = raw.replace(/^```(?:json)?\s*/i, '').replace(/\s*```\s*$/i, '').trim();
+    try {
+        parsed = JSON.parse(stripped);
+    }
+    catch {
+        throw new Error('Scaffolding response must be valid JSON.');
+    }
+    if (!isScaffoldingResponse(parsed)) {
+        throw new Error('Scaffolding response is missing required fields: commands, newFiles, astTransforms.');
+    }
+    return parsed;
+}
+export async function executeScaffolding(client, context, onChunk) {
+    const scaffoldingExecutor = createScaffoldingExecutor(client, onChunk);
+    return scaffoldingExecutor.execute(context);
+}
+//# sourceMappingURL=scaffolding.js.map

package/dist/llm/scaffolding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolding.js","sourceRoot":"","sources":["../../src/llm/scaffolding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAuClE,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5G,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE;QACrD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE;QACrD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE;QAC9D,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,OAAO,aAAa,IAAI,aAAa,IAAI,eAAe,CAAC;AAC3D,CAAC;AAED,MAAM,2BAA2B,GAAG,kBAAkB,CAAC;AACvD,MAAM,sBAAsB,GAAG,KAAK,CAAC;AACrC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AACrC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC,SAAS,yBAAyB,CAAC,MAAiB,EAAE,OAAyD;IAC7G,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,OAA2B;YACvC,MAAM,OAAO,GAAuB;gBAClC,GAAG,OAAO;gBACV,OAAO,EAAE,yBAAyB,OAAO,CAAC,OAAO,yBAAyB;aAC3E,CAAC;YAEF,IAAI,SAA4B,CAAC;YACjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC/D,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC3B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;wBACxC,YAAY,EAAE,yBAAyB;wBACvC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;wBACpC,SAAS,EAAE,sBAAsB;wBACjC,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,SAAS;wBAC7F,OAAO;qBACR,CAAC,CAAC;oBACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;oBACxC,OAAO;wBACL,WAAW,EAAE,wBAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC;wBACvD,KAAK,EAAE;4BACL,UAAU;4BACV,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC;4BAC7C,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;yBAChD;qBACF,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBACtE,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;wBAC1B,MAAM;oBACR,CAAC;oBACD,MAAM,MAAM,GAAI,KAA6B,CAAC,MAAM,CAAC;oBACrD,MAAM,YAAY,GAAG,MAAM,KAAK,GAAG,CAAC;oBACpC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;oBAClE,IAAI,MAAM,KAAK,SAAS,IAAI,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC/D,MAAM;oBACR,CAAC;oBACD,MAAM,OAAO,GAAG,YAAY;wBAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;wBAC5G,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBAC9B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;wBAClC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC/B,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAuC;IAC7E,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;QACvC,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE;QACjC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,cAAc;QACzD,gBAAgB,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE;QAClD,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,IAAI,MAAe,CAAC;IACpB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAExF,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiB,EACjB,OAA2B,EAC3B,OAAyD;IAEzD,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,OAAO,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/dist/manifest/drift.d.ts

@@ -0,0 +1,6 @@
+import type { WorkspaceManifest } from './types.js';
+export interface DriftReport {
+    orphanedDirectories: string[];
+    missingDirectories: string[];
+}
+export declare function detectDrift(workspaceDir: string, manifest: WorkspaceManifest): DriftReport;

package/dist/manifest/drift.js

@@ -0,0 +1,45 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+function listDirectories(parentDir) {
+    if (!existsSync(parentDir)) {
+        return [];
+    }
+    return readdirSync(parentDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+}
+function detectSegmentDrift(options) {
+    const { workspaceDir, segment, manifestEntries } = options;
+    const segmentDir = join(workspaceDir, segment);
+    const diskDirectories = listDirectories(segmentDir);
+    const diskSet = new Set(diskDirectories);
+    const manifestNames = Object.keys(manifestEntries).sort((left, right) => left.localeCompare(right));
+    const orphanedDirectories = diskDirectories
+        .filter((dirName) => !Object.prototype.hasOwnProperty.call(manifestEntries, dirName))
+        .map((dirName) => `${segment}/${dirName}`);
+    const missingDirectories = manifestNames
+        .filter((entryName) => !diskSet.has(entryName))
+        .map((entryName) => `${segment}/${entryName}`);
+    return {
+        orphanedDirectories,
+        missingDirectories,
+    };
+}
+export function detectDrift(workspaceDir, manifest) {
+    const appsDrift = detectSegmentDrift({
+        workspaceDir,
+        segment: 'apps',
+        manifestEntries: manifest.apps,
+    });
+    const packagesDrift = detectSegmentDrift({
+        workspaceDir,
+        segment: 'packages',
+        manifestEntries: manifest.packages,
+    });
+    return {
+        orphanedDirectories: [...appsDrift.orphanedDirectories, ...packagesDrift.orphanedDirectories],
+        missingDirectories: [...appsDrift.missingDirectories, ...packagesDrift.missingDirectories],
+    };
+}
+//# sourceMappingURL=drift.js.map

package/dist/manifest/drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.js","sourceRoot":"","sources":["../../src/manifest/drift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,SAAS,eAAe,CAAC,SAAiB;IACxC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACnD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,kBAAkB,CAAC,OAI3B;IACC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAEpG,MAAM,mBAAmB,GAAG,eAAe;SACxC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;SACpF,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;IAE7C,MAAM,kBAAkB,GAAG,aAAa;SACrC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;SAC9C,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;IAEjD,OAAO;QACL,mBAAmB;QACnB,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,QAA2B;IAC3E,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACnC,YAAY;QACZ,OAAO,EAAE,MAAM;QACf,eAAe,EAAE,QAAQ,CAAC,IAAI;KAC/B,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,kBAAkB,CAAC;QACvC,YAAY;QACZ,OAAO,EAAE,UAAU;QACnB,eAAe,EAAE,QAAQ,CAAC,QAAQ;KACnC,CAAC,CAAC;IAEH,OAAO;QACL,mBAAmB,EAAE,CAAC,GAAG,SAAS,CAAC,mBAAmB,EAAE,GAAG,aAAa,CAAC,mBAAmB,CAAC;QAC7F,kBAAkB,EAAE,CAAC,GAAG,SAAS,CAAC,kBAAkB,EAAE,GAAG,aAAa,CAAC,kBAAkB,CAAC;KAC3F,CAAC;AACJ,CAAC"}

package/dist/manifest/reader.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceManifest } from "./types.js";
+export declare function getManifestPath(workspaceDir: string): string;
+export declare function isKittWorkspace(dir: string): boolean;
+export declare function findWorkspaceRoot(startDir: string): string | null;
+export declare function readManifest(workspaceDir: string): WorkspaceManifest | null;
+/**
+ * Read the manifest and silently purge any app entries whose `apps/<name>`
+ * directory no longer exists on disk. Writes the cleaned manifest back if
+ * any stale entries were found. Returns the up-to-date manifest, or null
+ * if the manifest could not be read.
+ */
+export declare function reconcileManifest(workspaceDir: string): WorkspaceManifest | null;

package/dist/manifest/reader.js

@@ -0,0 +1,99 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+import { getGlobalWorkspacePath } from '../utils/global-config.js';
+import { removeApp, writeManifest } from './writer.js';
+function isObjectRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isValidWorkspaceManifest(value) {
+    if (!isObjectRecord(value)) {
+        return false;
+    }
+    if (typeof value.version !== "string") {
+        return false;
+    }
+    if (!isObjectRecord(value.workspace)) {
+        return false;
+    }
+    if (typeof value.workspace.name !== "string") {
+        return false;
+    }
+    const packageManager = value.workspace.packageManager;
+    if (packageManager !== "bun" && packageManager !== "npm" && packageManager !== "pnpm" && packageManager !== "yarn") {
+        return false;
+    }
+    if (!isObjectRecord(value.apps)) {
+        return false;
+    }
+    if (!isObjectRecord(value.packages)) {
+        return false;
+    }
+    if (!isObjectRecord(value.settings)) {
+        return false;
+    }
+    return true;
+}
+export function getManifestPath(workspaceDir) {
+    return join(workspaceDir, ".kitt", "manifest.json");
+}
+export function isKittWorkspace(dir) {
+    return existsSync(getManifestPath(dir));
+}
+export function findWorkspaceRoot(startDir) {
+    // Walk up from startDir
+    let current = resolve(startDir);
+    while (true) {
+        if (isKittWorkspace(current))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            break; // reached filesystem root
+        current = parent;
+    }
+    // Fall back to globally registered workspace path
+    const globalPath = getGlobalWorkspacePath();
+    if (globalPath && isKittWorkspace(globalPath))
+        return globalPath;
+    return null;
+}
+export function readManifest(workspaceDir) {
+    const manifestPath = getManifestPath(workspaceDir);
+    if (!existsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(manifestPath, "utf-8").trim();
+        if (raw.length === 0) {
+            return null;
+        }
+        const parsed = JSON.parse(raw);
+        if (!isValidWorkspaceManifest(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the manifest and silently purge any app entries whose `apps/<name>`
+ * directory no longer exists on disk. Writes the cleaned manifest back if
+ * any stale entries were found. Returns the up-to-date manifest, or null
+ * if the manifest could not be read.
+ */
+export function reconcileManifest(workspaceDir) {
+    const manifest = readManifest(workspaceDir);
+    if (!manifest)
+        return null;
+    const staleApps = Object.keys(manifest.apps).filter((name) => !existsSync(join(workspaceDir, 'apps', name)));
+    if (staleApps.length === 0)
+        return manifest;
+    let cleaned = manifest;
+    for (const name of staleApps) {
+        cleaned = removeApp(cleaned, name);
+    }
+    writeManifest(workspaceDir, cleaned);
+    return cleaned;
+}
+//# sourceMappingURL=reader.js.map

package/dist/manifest/reader.js.map

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

package/dist/manifest/types.d.ts

@@ -0,0 +1,31 @@
+export interface RailwayInfo {
+    projectId: string;
+    linkedAt: string;
+}
+export interface AppRailway {
+    serviceId: string;
+    domain?: string;
+}
+export interface AppEntry {
+    type: "frontend" | "backend";
+    framework: string;
+    integrations: string[];
+    railway?: AppRailway;
+    createdAt: string;
+}
+export interface PackageEntry {
+    active: boolean;
+    consumers: string[];
+    clients?: string[];
+}
+export interface WorkspaceManifest {
+    version: string;
+    workspace: {
+        name: string;
+        packageManager: "bun" | "npm" | "pnpm" | "yarn";
+        railway?: RailwayInfo;
+    };
+    settings: Record<string, unknown>;
+    apps: Record<string, AppEntry>;
+    packages: Record<string, PackageEntry>;
+}

package/dist/manifest/types.js

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

package/dist/manifest/types.js.map

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

package/dist/manifest/writer.d.ts

@@ -0,0 +1,9 @@
+import type { AppEntry, PackageEntry, RailwayInfo, WorkspaceManifest } from "./types.js";
+export declare function writeManifest(workspaceDir: string, manifest: WorkspaceManifest): void;
+export declare function createInitialManifest(workspaceName: string, packageManager: "bun" | "npm" | "pnpm" | "yarn", railway?: RailwayInfo): WorkspaceManifest;
+export declare function addApp(manifest: WorkspaceManifest, name: string, app: AppEntry): WorkspaceManifest;
+export declare function removeApp(manifest: WorkspaceManifest, name: string): WorkspaceManifest;
+export declare function addPackage(manifest: WorkspaceManifest, name: string, pkg: PackageEntry): WorkspaceManifest;
+export declare function addConsumer(manifest: WorkspaceManifest, packageName: string, appName: string): WorkspaceManifest;
+export declare function removeConsumer(manifest: WorkspaceManifest, packageName: string, appName: string): WorkspaceManifest;
+export declare function updateSettings(manifest: WorkspaceManifest, key: string, value: unknown): WorkspaceManifest;