@kylewadegrove/cutline-mcp-cli-staging 0.4.0 → 0.5.0

package/dist/commands/init.d.ts

@@ -1,4 +1,8 @@
 export declare function initCommand(options: {
     projectRoot?: string;
     staging?: boolean;
+    sourceSurface?: string;
+    campaign?: string;
+    queryCluster?: string;
+    hostAgent?: string;
 }): Promise<void>;

package/dist/commands/init.js

@@ -435,8 +435,12 @@ export async function initCommand(options) {
             idToken: auth.idToken,
             staging: options.staging,
             projectRoot,
-            sourceSurface: 'cli_init',
-            hostAgent: 'cutline-mcp-cli',
+            sourceSurface: options.sourceSurface || 'cli_init',
+            hostAgent: options.hostAgent || 'cutline-mcp-cli',
+            campaign: options.campaign,
+            metadata: options.queryCluster
+                ? { query_cluster: options.queryCluster, discovery_flow: 'token_limit' }
+                : undefined,
         });
         if (installId) {
             await trackAgentEvent({
@@ -460,6 +464,19 @@ export async function initCommand(options) {
                     generated_rules: filesWritten.length,
                 },
             });
+            if (options.queryCluster) {
+                await trackAgentEvent({
+                    idToken: auth.idToken,
+                    installId,
+                    eventName: 'agent_token_layer_install_completed',
+                    staging: options.staging,
+                    eventProperties: {
+                        command: 'init',
+                        query_cluster: options.queryCluster,
+                        route: 'cutline_token_layer_install',
+                    },
+                });
+            }
         }
     }
 }

package/dist/commands/setup.d.ts

@@ -4,4 +4,8 @@ export declare function setupCommand(options: {
     projectRoot?: string;
     hideAuditDimension?: string[];
     hideAuditDimensions?: string;
+    sourceSurface?: string;
+    campaign?: string;
+    queryCluster?: string;
+    hostAgent?: string;
 }): Promise<void>;

package/dist/commands/setup.js

@@ -372,14 +372,25 @@ export async function setupCommand(options) {
     }
     // ── 4. Generate IDE rules ────────────────────────────────────────────────
     console.log(chalk.bold('  Generating IDE rules...\n'));
-    await initCommand({ projectRoot: options.projectRoot, staging: options.staging });
+    await initCommand({
+        projectRoot: options.projectRoot,
+        staging: options.staging,
+        sourceSurface: options.sourceSurface,
+        campaign: options.campaign,
+        queryCluster: options.queryCluster,
+        hostAgent: options.hostAgent,
+    });
     if (idToken) {
         const installId = await registerAgentInstall({
             idToken,
             staging: options.staging,
             projectRoot,
-            sourceSurface: 'cli_setup',
-            hostAgent: 'cutline-mcp-cli',
+            sourceSurface: options.sourceSurface || 'cli_setup',
+            hostAgent: options.hostAgent || 'cutline-mcp-cli',
+            campaign: options.campaign,
+            metadata: options.queryCluster
+                ? { query_cluster: options.queryCluster, discovery_flow: 'token_limit' }
+                : undefined,
         });
         if (installId) {
             await trackAgentEvent({
@@ -413,6 +424,19 @@ export async function setupCommand(options) {
                     route: 'testing_rgr',
                 },
             });
+            if (options.queryCluster) {
+                await trackAgentEvent({
+                    idToken,
+                    installId,
+                    eventName: 'agent_token_layer_install_completed',
+                    staging: options.staging,
+                    eventProperties: {
+                        command: 'setup',
+                        query_cluster: options.queryCluster,
+                        route: 'cutline_token_layer_install',
+                    },
+                });
+            }
         }
     }
     // ── 5. Claude Code one-liners ────────────────────────────────────────────

package/dist/index.js

@@ -64,6 +64,10 @@ program
     .option('--staging', 'Use staging environment')
     .option('--skip-login', 'Skip authentication (use existing credentials)')
     .option('--project-root <path>', 'Project root directory for IDE rules (default: cwd)')
+    .option('--source-surface <value>', 'Discovery source surface for install attribution')
+    .option('--campaign <value>', 'Campaign label for install attribution')
+    .option('--query-cluster <value>', 'Query intent cluster (e.g. token_limit_context_overflow)')
+    .option('--host-agent <value>', 'Host agent name for install attribution (default: cutline-mcp-cli)')
     .option('--hide-audit-dimension <name>', 'Hide one audit dimension in surfaced code audit output (repeatable)', (value, prev) => [...prev, value], [])
     .option('--hide-audit-dimensions <csv>', 'Hide multiple audit dimensions (comma-separated: engineering,security,reliability,scalability,compliance)')
     .action((opts) => setupCommand({
@@ -72,13 +76,28 @@ program
     projectRoot: opts.projectRoot,
     hideAuditDimension: opts.hideAuditDimension,
     hideAuditDimensions: opts.hideAuditDimensions,
+    sourceSurface: opts.sourceSurface,
+    campaign: opts.campaign,
+    queryCluster: opts.queryCluster,
+    hostAgent: opts.hostAgent,
 }));
 program
     .command('init')
     .description('Generate IDE rules only (setup runs this automatically)')
     .option('--project-root <path>', 'Project root directory (default: cwd)')
     .option('--staging', 'Use staging environment')
-    .action((opts) => initCommand({ projectRoot: opts.projectRoot, staging: opts.staging }));
+    .option('--source-surface <value>', 'Discovery source surface for install attribution')
+    .option('--campaign <value>', 'Campaign label for install attribution')
+    .option('--query-cluster <value>', 'Query intent cluster (e.g. token_limit_context_overflow)')
+    .option('--host-agent <value>', 'Host agent name for install attribution (default: cutline-mcp-cli)')
+    .action((opts) => initCommand({
+    projectRoot: opts.projectRoot,
+    staging: opts.staging,
+    sourceSurface: opts.sourceSurface,
+    campaign: opts.campaign,
+    queryCluster: opts.queryCluster,
+    hostAgent: opts.hostAgent,
+}));
 program
     .command('policy-init')
     .description('Generate repository cutline.json policy manifest for deterministic safety verification')

package/dist/servers/cutline-server.js

@@ -7618,6 +7618,66 @@ function buildPolicyVerdictResponse(input) {
   };
 }
 
+// ../mcp/dist/mcp/src/shared/discovery-intent.js
+var TESTING_INTENT_REGEX = /\b(test|tests|testing|vitest|jest|coverage|unit test|integration test|e2e|spec file|assertion)\b/i;
+var TOKEN_INTENT_PATTERNS = [
+  { regex: /\b(rate limit|request limit|429|quota exceeded)\b/i, cluster: "rate_limit" },
+  {
+    regex: /\b(prompt (is )?too long|context window|context overflow|too many tokens|token limit)\b/i,
+    cluster: "context_overflow"
+  },
+  {
+    regex: /\b(token burn|burning credits|too expensive|reduce tokens|save tokens|token usage)\b/i,
+    cluster: "token_cost"
+  }
+];
+function isTestingIntentPrompt(prompt) {
+  return TESTING_INTENT_REGEX.test(prompt);
+}
+function detectTokenLimitIntentPrompt(prompt) {
+  for (const pattern of TOKEN_INTENT_PATTERNS) {
+    const match = prompt.match(pattern.regex);
+    if (match) {
+      return {
+        detected: true,
+        cluster: pattern.cluster,
+        matched_pattern: match[0]
+      };
+    }
+  }
+  return { detected: false };
+}
+function buildTestingIntentHintResponse(prompt) {
+  return {
+    detected: true,
+    intent: "testing",
+    route: "cutline_testing_rgr",
+    prompts: [
+      "use cutline to generate tests for this scope increase",
+      "use cutline to run the RGR loop for this change",
+      "use cutline to evaluate merge gates for this test run"
+    ],
+    bootstrap_if_missing: "npx -y @vibekiln/cutline-mcp-cli@latest setup",
+    source_prompt_excerpt: prompt.slice(0, 180)
+  };
+}
+function buildTokenLimitIntentHintResponse(prompt, match) {
+  return {
+    detected: true,
+    intent: "token_limit",
+    route: "cutline_token_layer_install",
+    query_cluster: match.cluster || "context_overflow",
+    matched_pattern: match.matched_pattern || null,
+    prompts: [
+      "use cutline to reduce context window pressure before tool calls",
+      "use cutline to apply token-saving policy and retry this flow",
+      "use cutline to install deterministic context guardrails for this repo"
+    ],
+    bootstrap_if_missing: "npx -y @vibekiln/cutline-mcp-cli@latest setup",
+    source_prompt_excerpt: prompt.slice(0, 180)
+  };
+}
+
 // ../mcp/dist/mcp/src/cutline-server.js
 function mcpAudit(entry) {
   console.error(JSON.stringify({
@@ -7674,25 +7734,9 @@ async function emitAgentEvent(input) {
   } catch {
   }
 }
-function isTestingIntentPrompt(prompt) {
-  return /\b(test|tests|testing|vitest|jest|coverage|unit test|integration test|e2e|spec file|assertion)\b/i.test(prompt);
-}
-function buildTestingIntentHintResponse(prompt) {
-  return {
-    detected: true,
-    intent: "testing",
-    route: "cutline_testing_rgr",
-    prompts: [
-      "use cutline to generate tests for this scope increase",
-      "use cutline to run the RGR loop for this change",
-      "use cutline to evaluate merge gates for this test run"
-    ],
-    bootstrap_if_missing: "npx -y @vibekiln/cutline-mcp-cli@latest setup",
-    source_prompt_excerpt: prompt.slice(0, 180)
-  };
-}
 var DEFAULT_MODEL = process.env.MODEL_ID || "gemini-2.5-pro";
 var GOVERNANCE_ENFORCEMENT = (process.env.CUTLINE_GOVERNANCE_ENFORCEMENT || "advisory").toLowerCase() === "enforced";
+var TOKEN_INTENT_HINT_ENABLED = (process.env.CUTLINE_TOKEN_INTENT_HINT_ENABLED || "false").toLowerCase() === "true";
 function buildGovernanceEnvelope(input) {
   return {
     decision: input.decision,
@@ -9012,6 +9056,7 @@ Why AI: ${idea.whyAI}`
         const { prompt } = trialArgs;
         const text = await cfGenerateTrialRun(prompt);
         const isTestingIntent = isTestingIntentPrompt(prompt);
+        const tokenIntent = TOKEN_INTENT_HINT_ENABLED ? detectTokenLimitIntentPrompt(prompt) : { detected: false };
         const env = process.env.CUTLINE_ENV === "staging" ? "staging" : "production";
         const resolvedInstallId = trialArgs.install_id || getStoredInstallId({ environment: env });
         if (isTestingIntent) {
@@ -9025,12 +9070,35 @@ Why AI: ${idea.whyAI}`
             }
           });
         }
+        if (tokenIntent.detected) {
+          await emitAgentEvent({
+            authToken: trialArgs.auth_token,
+            installId: resolvedInstallId || void 0,
+            eventName: "agent_token_limit_intent_detected",
+            eventProperties: {
+              tool_name: "trial_generate",
+              route: "cutline_token_layer_install",
+              query_cluster: tokenIntent.cluster
+            }
+          });
+          await emitAgentEvent({
+            authToken: trialArgs.auth_token,
+            installId: resolvedInstallId || void 0,
+            eventName: "agent_token_layer_install_prompted",
+            eventProperties: {
+              tool_name: "trial_generate",
+              route: "cutline_token_layer_install",
+              query_cluster: tokenIntent.cluster
+            }
+          });
+        }
         return {
           content: [{
             type: "text",
             text: JSON.stringify({
               text,
-              ...isTestingIntent ? { cutline_testing_route: buildTestingIntentHintResponse(prompt) } : {}
+              ...isTestingIntent ? { cutline_testing_route: buildTestingIntentHintResponse(prompt) } : {},
+              ...tokenIntent.detected ? { cutline_token_route: buildTokenLimitIntentHintResponse(prompt, tokenIntent) } : {}
             })
           }]
         };
@@ -9431,6 +9499,7 @@ Competitive threats: ${competitors}` : ""
           const { prompt, wikiMarkdown } = chatArgs;
           const text = await cfGenerateChatSuggestion(prompt, wikiMarkdown);
           const isTestingIntent = isTestingIntentPrompt(prompt);
+          const tokenIntent = TOKEN_INTENT_HINT_ENABLED ? detectTokenLimitIntentPrompt(prompt) : { detected: false };
           const env = process.env.CUTLINE_ENV === "staging" ? "staging" : "production";
           const resolvedInstallId = chatArgs.install_id || getStoredInstallId({ environment: env });
           if (isTestingIntent) {
@@ -9444,12 +9513,35 @@ Competitive threats: ${competitors}` : ""
               }
             });
           }
+          if (tokenIntent.detected) {
+            await emitAgentEvent({
+              authToken: chatArgs.auth_token,
+              installId: resolvedInstallId || void 0,
+              eventName: "agent_token_limit_intent_detected",
+              eventProperties: {
+                tool_name: "agent_chat",
+                route: "cutline_token_layer_install",
+                query_cluster: tokenIntent.cluster
+              }
+            });
+            await emitAgentEvent({
+              authToken: chatArgs.auth_token,
+              installId: resolvedInstallId || void 0,
+              eventName: "agent_token_layer_install_prompted",
+              eventProperties: {
+                tool_name: "agent_chat",
+                route: "cutline_token_layer_install",
+                query_cluster: tokenIntent.cluster
+              }
+            });
+          }
           return {
             content: [{
               type: "text",
               text: JSON.stringify({
                 text,
-                ...isTestingIntent ? { cutline_testing_route: buildTestingIntentHintResponse(prompt) } : {}
+                ...isTestingIntent ? { cutline_testing_route: buildTestingIntentHintResponse(prompt) } : {},
+                ...tokenIntent.detected ? { cutline_token_route: buildTokenLimitIntentHintResponse(prompt, tokenIntent) } : {}
               })
             }]
           };

package/dist/utils/agent-funnel.d.ts

@@ -1,10 +1,13 @@
-type AgentEventName = 'install_completed' | 'first_tool_call_success' | 'tool_call_failed' | 'heartbeat' | 'policy_gate_passed' | 'policy_gate_blocked' | 'upgrade_clicked' | 'upgrade_completed' | 'agent_test_intent_detected' | 'agent_cutline_install_prompted' | 'agent_cutline_install_completed' | 'agent_first_rgr_test_call_success';
+type AgentEventName = 'install_completed' | 'first_tool_call_success' | 'tool_call_failed' | 'heartbeat' | 'policy_gate_passed' | 'policy_gate_blocked' | 'upgrade_clicked' | 'upgrade_completed' | 'agent_test_intent_detected' | 'agent_cutline_install_prompted' | 'agent_cutline_install_completed' | 'agent_first_rgr_test_call_success' | 'agent_token_limit_intent_detected' | 'agent_token_layer_install_prompted' | 'agent_token_layer_install_completed';
 export declare function registerAgentInstall(input: {
     idToken: string;
     staging?: boolean;
     projectRoot: string;
     sourceSurface: string;
     hostAgent?: string;
+    campaign?: string;
+    referrerUrl?: string;
+    metadata?: Record<string, unknown>;
 }): Promise<string | null>;
 export declare function trackAgentEvent(input: {
     idToken: string;

package/dist/utils/agent-funnel.js

@@ -28,6 +28,9 @@ export async function registerAgentInstall(input) {
                 source_surface: input.sourceSurface,
                 host_agent: input.hostAgent || 'cutline-mcp-cli',
                 workspace_id: workspaceId,
+                ...(input.campaign ? { campaign: input.campaign } : {}),
+                ...(input.referrerUrl ? { referrer_url: input.referrerUrl } : {}),
+                ...(input.metadata ? { metadata: input.metadata } : {}),
             }),
         });
         if (!response.ok)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kylewadegrove/cutline-mcp-cli-staging",
-    "version": "0.4.0",
+    "version": "0.5.0",
     "description": "CLI and MCP servers for Cutline — authenticate, then run constraint-aware MCP servers in Cursor or any MCP client.",
     "type": "module",
     "main": "dist/index.js",