@schemyx/mcp 0.1.5 → 0.1.7

package/README.md

@@ -89,6 +89,16 @@ The MCP package can also build local-only codebase configs for agents. This does
     items.json
 ```
 
+For generation or editing, start with `schemyx_prepare_task`:
+
+```json
+{
+  "task": "Build this page using Schemyx MCP"
+}
+```
+
+`schemyx_prepare_task` verifies or creates the local scan, resolves the task context pack, includes required source-backed reads through Schemyx, and returns the no-invention policy agents should follow before writing code.
+
 Use `schemyx_scan_codebase` with an explicit scope:
 
 ```json

package/dist/codebase-scanner/index.d.ts

@@ -1,11 +1,165 @@
-import type { ContextPackArgs, FreshnessArgs, GetArgs, GraphArgs, ListArgs, ReadFileArgs, RecipeRecord, ReviewArgs, ScanArgs, SearchArgs } from './types';
+import type { CodebaseProjectType, ContextPackArgs, FreshnessArgs, GetArgs, GraphArgs, GraphEdge, ListArgs, PrepareTaskArgs, ReadFileArgs, RecipeRecord, ReviewArgs, ScanArgs, SearchArgs } from './types';
+export declare function prepareTask(args?: PrepareTaskArgs): Promise<{
+    ok: boolean;
+    schema: string;
+    task: string;
+    rootPath: string;
+    outputDir: string;
+    projectType: CodebaseProjectType;
+    scan: {
+        ran: true;
+        reason: "missing-config" | "stale-config";
+        result: Awaited<ReturnType<typeof scanLocalCodebase>>;
+    } | {
+        ran: false;
+        reason: "existing-config" | "auto-scan-disabled";
+        scanId?: string;
+    };
+    freshness: {
+        ok: boolean;
+        schema: string;
+        scanId: string;
+        status: string;
+        stale: {
+            k: string;
+            path: string;
+            expectedHash?: string;
+            actualHash?: string;
+        }[];
+        missing: {
+            k: string;
+            path: string;
+        }[];
+        changed: {
+            k: string;
+            path: string;
+        }[];
+    } | null;
+    policy: {
+        startHere: string;
+        grounding: string;
+        toolUse: string;
+        rawRepoReads: string;
+    };
+    contextPack: {
+        ok: boolean;
+        schema: string;
+        scanId: string;
+        key: null;
+        status: string;
+        depth: import("./types").ContextDepth;
+        budget: {
+            targetTokens: number;
+            estimatedTokens: number;
+            sourceFilesIncluded: number;
+        };
+        items: never[];
+        review: never[];
+        policy?: undefined;
+        next?: undefined;
+    } | {
+        ok: boolean;
+        schema: string;
+        scanId: string;
+        key: string;
+        status: string;
+        depth: import("./types").ContextDepth;
+        policy: {
+            pageBuild?: boolean | undefined;
+            requiredRoot?: string | undefined;
+            sourceFallback?: string | undefined;
+            grounding: string;
+            rootKind: string;
+        };
+        budget: {
+            targetTokens: number;
+            estimatedTokens: number;
+            sourceFilesIncluded: number;
+        };
+        items: {
+            k: string;
+            why: string;
+            recipe: RecipeRecord | {
+                k: string;
+                g: "file" | "component" | "hook" | "route" | "api" | "controller" | "service" | "module" | "database" | "model" | "style" | "dependency" | "cluster" | "rule";
+                s: string;
+                d: string[];
+                u: string[];
+                p: string | undefined;
+                status: import("./types").RecipeStatus;
+                confidence: import("./types").Confidence;
+                v: Record<string, unknown>;
+            } | {
+                k: string;
+                g: "file" | "component" | "hook" | "route" | "api" | "controller" | "service" | "module" | "database" | "model" | "style" | "dependency" | "cluster" | "rule";
+                s: string;
+                p: string | undefined;
+                status: import("./types").RecipeStatus;
+                confidence: import("./types").Confidence;
+                d?: undefined;
+                u?: undefined;
+                v?: undefined;
+            };
+        }[];
+        review: import("./types").ReviewItem[];
+        next: ({
+            tool: string;
+            arguments: {
+                path: string | undefined;
+                maxBytes: number;
+            };
+        } | {
+            tool: string;
+            arguments: {
+                key: string;
+                depth: string;
+                includeDeps: boolean;
+                maxRelated: number;
+            };
+        })[];
+    };
+    requiredReads: {
+        tool: "schemyx_read_codebase_file";
+        arguments: ReadFileArgs;
+    }[];
+    sourceReads: {
+        tool: "schemyx_read_codebase_file";
+        arguments: ReadFileArgs;
+        result: {
+            ok: boolean;
+            schema: string;
+            scanId: string;
+            localOnly: boolean;
+            path: string;
+            bytes: number;
+            truncated: boolean;
+            content: string;
+        };
+    }[];
+    next: ({
+        tool: string;
+        arguments: {
+            path: string | undefined;
+            maxBytes: number;
+        };
+    } | {
+        tool: string;
+        arguments: {
+            key: string;
+            depth: string;
+            includeDeps: boolean;
+            maxRelated: number;
+        };
+    })[];
+    instructions: string[];
+}>;
 export declare function scanLocalCodebase(args?: ScanArgs): Promise<{
     ok: boolean;
     schema: string;
     scanId: string;
     localOnly: boolean;
     privacy: string;
-    projectType: import("./types").CodebaseProjectType;
+    projectType: CodebaseProjectType;
     rootPath: string;
     outputDir: string;
     dryRun: boolean;
@@ -29,14 +183,16 @@ export declare function scanLocalCodebase(args?: ScanArgs): Promise<{
         arguments: {
             query: string;
             limit: number;
-            status?: undefined;
+            rootPath: string;
+            outputDir: string;
         };
     } | {
         tool: string;
         arguments: {
             status: string;
             limit: number;
-            query?: undefined;
+            rootPath: string;
+            outputDir: string;
         };
     })[];
 }>;
@@ -124,6 +280,8 @@ export declare function getContextPack(args?: ContextPackArgs): Promise<{
     };
     items: never[];
     review: never[];
+    policy?: undefined;
+    next?: undefined;
 } | {
     ok: boolean;
     schema: string;
@@ -131,6 +289,13 @@ export declare function getContextPack(args?: ContextPackArgs): Promise<{
     key: string;
     status: string;
     depth: import("./types").ContextDepth;
+    policy: {
+        pageBuild?: boolean | undefined;
+        requiredRoot?: string | undefined;
+        sourceFallback?: string | undefined;
+        grounding: string;
+        rootKind: string;
+    };
     budget: {
         targetTokens: number;
         estimatedTokens: number;
@@ -162,13 +327,28 @@ export declare function getContextPack(args?: ContextPackArgs): Promise<{
         };
     }[];
     review: import("./types").ReviewItem[];
+    next: ({
+        tool: string;
+        arguments: {
+            path: string | undefined;
+            maxBytes: number;
+        };
+    } | {
+        tool: string;
+        arguments: {
+            key: string;
+            depth: string;
+            includeDeps: boolean;
+            maxRelated: number;
+        };
+    })[];
 }>;
 export declare function getCodebaseGraph(args?: GraphArgs): Promise<{
     ok: boolean;
     schema: string;
     scanId: string;
     nodes: import("./types").GraphNode[];
-    edges: import("./types").GraphEdge[];
+    edges: GraphEdge[];
     page: {
         limitNodes: number;
         limitEdges: number;