@flyingrobots/graft 0.6.1 → 0.7.0

package/dist/contracts/output-schemas.js

@@ -40,6 +40,32 @@ const tripwireSchema = z.object({
     signal: z.string(),
     recommendation: z.string(),
 }).strict();
+const graftEditReasonSchema = z.enum([
+    "NOT_FOUND",
+    "OLD_STRING_NOT_FOUND",
+    "OLD_STRING_AMBIGUOUS",
+    "BINARY",
+    "LOCKFILE",
+    "MINIFIED",
+    "BUILD_OUTPUT",
+    "SECRET",
+    "GRAFTIGNORE",
+]);
+const graftEditDriftWarningSchema = z.object({
+    kind: z.literal("structural_pattern_reintroduced"),
+    severity: z.literal("advisory"),
+    pattern: z.literal("jsdoc_typedef"),
+    basis: z.literal("session_local_graft_edit"),
+    message: z.string(),
+    current: z.object({
+        path: z.string(),
+        direction: z.literal("added"),
+    }).strict(),
+    previous: z.object({
+        path: z.string(),
+        direction: z.literal("removed"),
+    }).strict(),
+}).strict();
 const outlineEntrySchema = z.lazy(() => z.object({
     _brand: z.literal("OutlineEntry").optional(),
     kind: z.string(),
@@ -78,6 +104,7 @@ const diffEntrySchema = z.lazy(() => z.object({
     _brand: z.literal("DiffEntry").optional(),
     name: z.string(),
     kind: z.string(),
+    exported: z.boolean().optional(),
     signature: z.string().optional(),
     oldSignature: z.string().optional(),
     childDiff: outlineDiffSchema.optional(),
@@ -95,6 +122,42 @@ const burdenByKindSchema = z.object({
     state: burdenBucketSchema,
     diagnostic: burdenBucketSchema,
 }).strict();
+const sludgeSignalSchema = z.object({
+    kind: z.enum([
+        "phantom_shape",
+        "cast_density",
+        "homeless_constructor",
+        "free_function_data_behavior",
+        "god_file",
+    ]),
+    severity: z.enum(["low", "medium", "high"]),
+    message: z.string(),
+    line: z.number().int().positive().optional(),
+    symbol: z.string().optional(),
+    evidence: z.string(),
+}).strict();
+const sludgeFileReportSchema = z.object({
+    path: z.string(),
+    score: z.number().int().nonnegative(),
+    metrics: z.object({
+        typedefCount: z.number().int().nonnegative(),
+        typeCastCount: z.number().int().nonnegative(),
+        classCount: z.number().int().nonnegative(),
+        functionCount: z.number().int().nonnegative(),
+        symbolCount: z.number().int().nonnegative(),
+        homelessConstructorCount: z.number().int().nonnegative(),
+        freeFunctionDataBehaviorCount: z.number().int().nonnegative(),
+    }).strict(),
+    signals: z.array(sludgeSignalSchema),
+}).strict();
+const sludgeReportSchema = z.object({
+    scannedFiles: z.number().int().nonnegative(),
+    filesWithSignals: z.number().int().nonnegative(),
+    totalSignals: z.number().int().nonnegative(),
+    score: z.number().int().nonnegative(),
+    files: z.array(sludgeFileReportSchema),
+    summary: z.string(),
+}).strict();
 const receiptSchema = z.object({
     sessionId: z.string(),
     traceId: z.string(),
@@ -143,6 +206,32 @@ const runtimeLocalProvenanceSchema = z.object({
     stability: z.literal("runtime_local"),
     provenanceLevel: z.literal("artifact_history"),
 }).strict();
+const gitGraftEnhanceBodySchema = z.object({
+    range: z.object({
+        since: z.string(),
+        head: z.string(),
+    }).strict(),
+    structural: z.object({
+        changedFiles: z.number().int().nonnegative(),
+        addedSymbols: z.number().int().nonnegative(),
+        removedSymbols: z.number().int().nonnegative(),
+        changedSymbols: z.number().int().nonnegative(),
+        topFilesByChangeCount: z.array(z.object({
+            path: z.string(),
+            status: z.string(),
+            changeCount: z.number().int().nonnegative(),
+            summary: z.string(),
+        }).strict()),
+    }).strict(),
+    exports: z.object({
+        changed: z.boolean(),
+        semverImpact: z.enum(["major", "minor", "patch", "none"]),
+        addedExports: z.number().int().nonnegative(),
+        removedExports: z.number().int().nonnegative(),
+        changedExports: z.number().int().nonnegative(),
+    }).strict(),
+    warnings: z.array(z.string()),
+}).strict();
 const runtimeStagedTargetSchema = z.discriminatedUnion("availability", [
     runtimeLocalProvenanceSchema.extend({
         availability: z.literal("none"),
@@ -465,7 +554,7 @@ const activeCausalWorkspaceSchema = z.object({
     latestReadEvent: readEventSchema.nullable(),
     latestStageEvent: stageEventSchema.nullable(),
     latestTransitionEvent: transitionEventSchema.nullable(),
-    repoConcurrency: repoConcurrencySummarySchema,
+    repoConcurrency: repoConcurrencySummarySchema.nullable(),
     checkoutEpoch: z.number().int().nonnegative(),
     lastTransition: repoTransitionSchema.nullable(),
     semanticTransition: repoSemanticTransitionSchema.nullable(),
@@ -606,7 +695,7 @@ const monitorStatusSchema = z.object({
 }).strict();
 const monitorActionSchema = z.object({
     ok: z.boolean(),
-    action: z.enum(["start", "pause", "resume", "stop"]),
+    action: z.enum(["start", "pause", "resume", "stop", "nudge"]),
     created: z.boolean(),
     changed: z.boolean(),
     status: monitorStatusSchema.optional(),
@@ -711,6 +800,20 @@ const mcpOutputBodySchemas = {
         lastReadAt: z.string().optional(),
         diff: outlineDiffSchema.optional(),
     }).strict(),
+    graft_edit: z.object({
+        path: z.string(),
+        operation: z.literal("replace"),
+        projection: z.enum(["edited", "refused"]),
+        status: z.enum(["edited", "refused"]),
+        changed: z.boolean(),
+        matches: z.number().int().nonnegative(),
+        replacements: z.number().int().nonnegative(),
+        reason: graftEditReasonSchema.optional(),
+        reasonDetail: z.string().optional(),
+        next: z.array(z.string()).optional(),
+        actual: actualSchema.optional(),
+        driftWarnings: z.array(graftEditDriftWarningSchema).optional(),
+    }).strict(),
     file_outline: z.union([
         z.object({
             path: z.string(),
@@ -842,6 +945,7 @@ const mcpOutputBodySchemas = {
     monitor_start: monitorActionSchema,
     monitor_pause: monitorActionSchema,
     monitor_resume: monitorActionSchema,
+    monitor_nudge: monitorActionSchema,
     monitor_stop: monitorActionSchema,
     workspace_authorize: workspaceAuthorizeSchema,
     workspace_authorizations: z.object({
@@ -911,6 +1015,7 @@ const mcpOutputBodySchemas = {
         attribution: attributionSummarySchema,
         persistedLocalHistory: persistedLocalHistorySummarySchema,
         recommendedNextAction: causalSurfaceNextActionSchema,
+        sludge: sludgeReportSchema.optional(),
     }).strict(),
     stats: z.object({
         totalReads: z.number().int().nonnegative(),
@@ -922,9 +1027,169 @@ const mcpOutputBodySchemas = {
         totalNonReadBytesReturned: z.number().int().nonnegative(),
         burdenByKind: burdenByKindSchema,
     }).strict(),
+    graft_churn: z.object({
+        entries: z.array(z.object({
+            symbol: z.string(),
+            filePath: z.string(),
+            kind: z.string(),
+            changeCount: z.number().int().positive(),
+            lastChangedSha: z.string(),
+            lastChangedDate: z.string(),
+        }).strict()),
+        totalSymbols: z.number().int().nonnegative(),
+        totalCommitsAnalyzed: z.number().int().nonnegative(),
+        summary: z.string(),
+    }).strict(),
+    graft_exports: z.object({
+        base: z.string(),
+        head: z.string(),
+        added: z.array(z.object({
+            symbol: z.string(),
+            filePath: z.string(),
+            kind: z.string(),
+            changeType: z.literal("added"),
+            signature: z.string().optional(),
+        }).strict()),
+        removed: z.array(z.object({
+            symbol: z.string(),
+            filePath: z.string(),
+            kind: z.string(),
+            changeType: z.literal("removed"),
+            signature: z.string().optional(),
+        }).strict()),
+        changed: z.array(z.object({
+            symbol: z.string(),
+            filePath: z.string(),
+            kind: z.string(),
+            changeType: z.literal("signature_changed"),
+            signature: z.string().optional(),
+            previousSignature: z.string().optional(),
+        }).strict()),
+        semverImpact: z.enum(["major", "minor", "patch", "none"]),
+        summary: z.string(),
+    }).strict(),
+    graft_log: z.object({
+        entries: z.array(z.object({
+            sha: z.string(),
+            message: z.string(),
+            author: z.string(),
+            date: z.string(),
+            symbols: z.object({
+                added: z.array(z.object({
+                    name: z.string(),
+                    kind: z.string(),
+                    signature: z.string().optional(),
+                    exported: z.boolean(),
+                    filePath: z.string(),
+                }).strict()),
+                removed: z.array(z.object({
+                    name: z.string(),
+                    kind: z.string(),
+                    signature: z.string().optional(),
+                    exported: z.boolean(),
+                    filePath: z.string(),
+                }).strict()),
+                changed: z.array(z.object({
+                    name: z.string(),
+                    kind: z.string(),
+                    signature: z.string().optional(),
+                    exported: z.boolean(),
+                    filePath: z.string(),
+                }).strict()),
+            }).strict(),
+            summary: z.string(),
+        }).strict()),
+        count: z.number().int().nonnegative(),
+        layer: z.literal("commit_worldline"),
+    }).strict(),
+    graft_blame: z.object({
+        symbol: z.string(),
+        filePath: z.string(),
+        changeCount: z.number().int().nonnegative(),
+        createdInCommit: z.string().nullable(),
+        lastSignatureChange: z.string().nullable(),
+        referenceCount: z.number().int().nonnegative(),
+        history: z.array(z.object({
+            sha: z.string(),
+            tick: z.number(),
+            changeKind: z.string(),
+            present: z.boolean(),
+            signature: z.string().nullable(),
+        }).strict()),
+    }).strict(),
+    graft_difficulty: z.object({
+        symbol: z.string(),
+        path: z.string().optional(),
+        entries: z.array(z.object({
+            symbol: z.string(),
+            filePath: z.string(),
+            kind: z.string(),
+            score: z.number().nonnegative(),
+            risk: z.enum(["low", "medium", "high"]),
+            recommendation: z.enum(["refactor_freely", "refactor_with_tests", "plan_before_refactor"]),
+            curvature: z.object({
+                changeCount: z.number().int().nonnegative(),
+                signatureChangeCount: z.number().int().nonnegative(),
+                score: z.number().nonnegative(),
+            }).strict(),
+            friction: z.object({
+                referenceCount: z.number().int().nonnegative(),
+                referencingFiles: z.array(z.string()),
+                score: z.number().nonnegative(),
+            }).strict(),
+        }).strict()),
+        total: z.number().int().nonnegative(),
+        summary: z.string(),
+    }).strict(),
+    graft_review: z.object({
+        base: z.string(),
+        head: z.string(),
+        totalFiles: z.number().int().nonnegative(),
+        categories: z.object({
+            structural: z.number().int().nonnegative(),
+            formatting: z.number().int().nonnegative(),
+            test: z.number().int().nonnegative(),
+            docs: z.number().int().nonnegative(),
+            config: z.number().int().nonnegative(),
+        }).strict(),
+        files: z.array(z.object({
+            path: z.string(),
+            category: z.enum(["structural", "formatting", "test", "docs", "config"]),
+            structuralChanges: z.object({
+                added: z.number().int().nonnegative(),
+                removed: z.number().int().nonnegative(),
+                changed: z.number().int().nonnegative(),
+            }).strict().optional(),
+        }).strict()),
+        breakingChanges: z.array(z.object({
+            symbol: z.string(),
+            kind: z.string(),
+            filePath: z.string(),
+            changeType: z.enum(["removed_export", "signature_changed", "type_changed"]),
+            previousSignature: z.string().optional(),
+            newSignature: z.string().optional(),
+            impactedFiles: z.number().int().nonnegative(),
+            impactedFilePaths: z.array(z.string()),
+        }).strict()),
+        summary: z.string(),
+    }).strict(),
+    knowledge_map: z.object({
+        totalFiles: z.number().int().nonnegative(),
+        totalSymbols: z.number().int().nonnegative(),
+        files: z.array(z.object({
+            path: z.string(),
+            symbols: z.array(z.string()),
+            readCount: z.number().int().positive(),
+            lastReadAt: z.string(),
+            stale: z.boolean(),
+        }).strict()),
+        staleFiles: z.array(z.string()),
+        directoryCoverage: z.record(z.string(), z.number().int().nonnegative()),
+    }).strict(),
 };
 export const MCP_OUTPUT_SCHEMAS = {
     safe_read: withMcpCommon("safe_read", mcpOutputBodySchemas.safe_read),
+    graft_edit: withMcpCommon("graft_edit", mcpOutputBodySchemas.graft_edit),
     file_outline: withMcpCommon("file_outline", mcpOutputBodySchemas.file_outline),
     read_range: withMcpCommon("read_range", mcpOutputBodySchemas.read_range),
     changed_since: withMcpCommon("changed_since", mcpOutputBodySchemas.changed_since),
@@ -941,6 +1206,7 @@ export const MCP_OUTPUT_SCHEMAS = {
     monitor_start: withMcpCommon("monitor_start", mcpOutputBodySchemas.monitor_start),
     monitor_pause: withMcpCommon("monitor_pause", mcpOutputBodySchemas.monitor_pause),
     monitor_resume: withMcpCommon("monitor_resume", mcpOutputBodySchemas.monitor_resume),
+    monitor_nudge: withMcpCommon("monitor_nudge", mcpOutputBodySchemas.monitor_nudge),
     monitor_stop: withMcpCommon("monitor_stop", mcpOutputBodySchemas.monitor_stop),
     workspace_authorize: withMcpCommon("workspace_authorize", mcpOutputBodySchemas.workspace_authorize),
     workspace_authorizations: withMcpCommon("workspace_authorizations", mcpOutputBodySchemas.workspace_authorizations),
@@ -958,6 +1224,13 @@ export const MCP_OUTPUT_SCHEMAS = {
     explain: withMcpCommon("explain", mcpOutputBodySchemas.explain),
     doctor: withMcpCommon("doctor", mcpOutputBodySchemas.doctor),
     stats: withMcpCommon("stats", mcpOutputBodySchemas.stats),
+    graft_churn: withMcpCommon("graft_churn", mcpOutputBodySchemas.graft_churn),
+    graft_exports: withMcpCommon("graft_exports", mcpOutputBodySchemas.graft_exports),
+    graft_log: withMcpCommon("graft_log", mcpOutputBodySchemas.graft_log),
+    graft_blame: withMcpCommon("graft_blame", mcpOutputBodySchemas.graft_blame),
+    graft_difficulty: withMcpCommon("graft_difficulty", mcpOutputBodySchemas.graft_difficulty),
+    graft_review: withMcpCommon("graft_review", mcpOutputBodySchemas.graft_review),
+    knowledge_map: withMcpCommon("knowledge_map", mcpOutputBodySchemas.knowledge_map),
 };
 const initActionSchema = z.object({
     action: z.enum(["exists", "create", "append"]),
@@ -986,7 +1259,16 @@ const suggestedMcpServerSchema = z.object({
     mcpServers: z.object({
         graft: z.object({
             command: z.literal("npx"),
-            args: z.tuple([z.literal("-y"), z.literal("@flyingrobots/graft"), z.literal("serve")]),
+            args: z.union([
+                z.tuple([z.literal("-y"), z.literal("@flyingrobots/graft"), z.literal("serve")]),
+                z.tuple([
+                    z.literal("-y"),
+                    z.literal("@flyingrobots/graft"),
+                    z.literal("serve"),
+                    z.literal("--runtime"),
+                    z.literal("daemon"),
+                ]),
+            ]),
         }).strict(),
     }).strict(),
 }).strict();
@@ -1002,9 +1284,8 @@ export const CLI_OUTPUT_SCHEMAS = {
     index: withCliCommon("index", z.object({
         ok: z.boolean(),
         cwd: z.string(),
-        from: z.string().nullable(),
-        commitsIndexed: z.number().int().nonnegative().optional(),
-        patchesWritten: z.number().int().nonnegative().optional(),
+        filesIndexed: z.number().int().nonnegative().optional(),
+        nodesEmitted: z.number().int().nonnegative().optional(),
         error: z.string().optional(),
     }).strict()),
     read_safe: withCliPeerCommon("read_safe", mcpOutputBodySchemas.safe_read),
@@ -1016,6 +1297,12 @@ export const CLI_OUTPUT_SCHEMAS = {
     struct_map: withCliPeerCommon("struct_map", mcpOutputBodySchemas.graft_map),
     symbol_show: withCliPeerCommon("symbol_show", mcpOutputBodySchemas.code_show),
     symbol_find: withCliPeerCommon("symbol_find", mcpOutputBodySchemas.code_find),
+    struct_churn: withCliPeerCommon("struct_churn", mcpOutputBodySchemas.graft_churn),
+    struct_exports: withCliPeerCommon("struct_exports", mcpOutputBodySchemas.graft_exports),
+    struct_log: withCliPeerCommon("struct_log", mcpOutputBodySchemas.graft_log),
+    symbol_blame: withCliPeerCommon("symbol_blame", mcpOutputBodySchemas.graft_blame),
+    symbol_difficulty: withCliPeerCommon("symbol_difficulty", mcpOutputBodySchemas.graft_difficulty),
+    struct_review: withCliPeerCommon("struct_review", mcpOutputBodySchemas.graft_review),
     diag_doctor: withCliPeerCommon("diag_doctor", mcpOutputBodySchemas.doctor),
     diag_activity: withCliPeerCommon("diag_activity", mcpOutputBodySchemas.activity_view),
     diag_explain: withCliPeerCommon("diag_explain", mcpOutputBodySchemas.explain),
@@ -1052,6 +1339,7 @@ export const CLI_OUTPUT_SCHEMAS = {
         edges: z.array(z.record(z.string(), z.unknown())),
         error: z.string().optional(),
     }).strict()),
+    git_graft_enhance: withCliCommon("git_graft_enhance", gitGraftEnhanceBodySchema),
 };
 export function getMcpOutputSchemaMeta(tool) {
     return mcpOutputSchemaMeta[tool];