@f5xc-salesdemos/xcsh 18.49.1 → 18.51.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "18.49.1",
+	"version": "18.51.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -48,12 +48,12 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "18.49.1",
-		"@f5xc-salesdemos/pi-agent-core": "18.49.1",
-		"@f5xc-salesdemos/pi-ai": "18.49.1",
-		"@f5xc-salesdemos/pi-natives": "18.49.1",
-		"@f5xc-salesdemos/pi-tui": "18.49.1",
-		"@f5xc-salesdemos/pi-utils": "18.49.1",
+		"@f5xc-salesdemos/xcsh-stats": "18.51.0",
+		"@f5xc-salesdemos/pi-agent-core": "18.51.0",
+		"@f5xc-salesdemos/pi-ai": "18.51.0",
+		"@f5xc-salesdemos/pi-natives": "18.51.0",
+		"@f5xc-salesdemos/pi-tui": "18.51.0",
+		"@f5xc-salesdemos/pi-utils": "18.51.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",

package/src/autoresearch/helpers.ts

@@ -21,6 +21,7 @@ export const AUTORESEARCH_COMMITTABLE_FILES = [
 	"autoresearch.sh",
 	"autoresearch.checks.sh",
 	"autoresearch.ideas.md",
+	"SELF_AWARENESS.md",
 ] as const;
 export const AUTORESEARCH_LOCAL_STATE_FILES = ["autoresearch.jsonl"] as const;
 export const AUTORESEARCH_LOCAL_STATE_DIRECTORIES = [".autoresearch"] as const;

package/src/autoresearch/index.ts

@@ -323,6 +323,7 @@ export const createAutoresearchExtension: ExtensionFactory = api => {
 		const checksPath = path.join(workDir, "autoresearch.checks.sh");
 		const ideasPath = path.join(workDir, "autoresearch.ideas.md");
 		const programPath = path.join(workDir, "autoresearch.program.md");
+		const selfAwarenessPath = path.join(workDir, "SELF_AWARENESS.md");
 		const pendingRun =
 			runtime.lastRunSummary ??
 			(await readPendingRunSummary(workDir, collectLoggedRunNumbers(runtime.state.results)));
@@ -362,6 +363,8 @@ export const createAutoresearchExtension: ExtensionFactory = api => {
 				ideas_path: ideasPath,
 				has_program: fs.existsSync(programPath),
 				program_path: programPath,
+				has_self_awareness: fs.existsSync(selfAwarenessPath),
+				self_awareness_path: selfAwarenessPath,
 				current_segment: runtime.state.currentSegment + 1,
 				current_segment_run_count: currentSegmentResults.length,
 				has_baseline_metric: baselineMetric !== null,

package/src/autoresearch/prompt.md

@@ -27,6 +27,14 @@ You are running an autonomous experiment loop. Keep iterating until the user int
 
 Use it as a repo-local strategy overlay for this session. `autoresearch.md` remains the source of truth for benchmark, scope, and constraints.
 {{/if}}
+{{#if has_self_awareness}}
+
+### Self-Awareness Manifest
+
+`SELF_AWARENESS.md` exists at `{{self_awareness_path}}`.
+
+This document defines xcsh's mission, current capability inventory, evaluation dimensions, and known gaps. When the session goal involves self-evaluation, capability improvement, or SE workflow enhancement, read this document first — it is the ground truth for what xcsh is, what it should become, and how to measure progress.
+{{/if}}
 {{#if has_recent_results}}
 
 ### Current Segment Snapshot
@@ -218,6 +226,19 @@ Before the first benchmark:
 - Optionally add `autoresearch.checks.sh` if correctness or quality needs a hard gate.
 - Call `init_experiment` with arguments that match `autoresearch.md` exactly (benchmark command, metric, unit, direction, scope paths, off limits, constraints).
 - Run and log the baseline.
+{{#if has_self_awareness}}
+
+#### SE Self-Evaluation Sessions
+
+When the goal involves evaluating or improving xcsh's sales engineering capabilities (not runtime code performance):
+
+- Read `SELF_AWARENESS.md` first to understand the current capability inventory and evaluation dimensions
+- Read `autoresearch.program.md` for the SE-specific evaluation strategy
+- Design the benchmark script (`autoresearch.sh`) to test the specific SE capability dimension — product knowledge accuracy, API reliability, prompt effectiveness, or workflow completeness
+- Use quality/accuracy scores as the primary metric (direction: `higher`) rather than timing metrics
+- Focus `Files in Scope` on the prompts, agent definitions, tool descriptions, or service modules relevant to the SE capability being evaluated
+- Record capability status changes in `SELF_AWARENESS.md` when experiments yield durable improvements
+{{/if}}
 
 Until `init_experiment` succeeds, only autoresearch control files (`autoresearch.md`, `autoresearch.sh`, `autoresearch.program.md`, `autoresearch.ideas.md`, `autoresearch.checks.sh`) may be edited; after initialization, respect Files in Scope from the contract.
 

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "18.49.1",
-	"commit": "e8fa2d917ec4476ac2e1bb9f4141992961084755",
-	"shortCommit": "e8fa2d9",
+	"version": "18.51.0",
+	"commit": "26d7bec7de8e9a3619ed4f3219959ff1bc2c206f",
+	"shortCommit": "26d7bec",
 	"branch": "main",
-	"tag": "v18.49.1",
-	"commitDate": "2026-05-08T02:56:04Z",
-	"buildDate": "2026-05-08T03:26:46.079Z",
+	"tag": "v18.51.0",
+	"commitDate": "2026-05-08T23:52:42Z",
+	"buildDate": "2026-05-09T00:19:09.023Z",
 	"dirty": false,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/e8fa2d917ec4476ac2e1bb9f4141992961084755",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.49.1"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/26d7bec7de8e9a3619ed4f3219959ff1bc2c206f",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.51.0"
 };

package/src/internal-urls/salesforce-context.ts

@@ -125,6 +125,10 @@ export interface SalesforceHint {
 	partnerName?: string;
 	/** Partner role label, e.g. 'AE', 'SE', 'CSM' */
 	partnerRole?: string;
+	/** Org alias for SOQL queries, e.g. 'SFDC' */
+	orgAlias?: string;
+	/** Partner Salesforce UserId for AE-owned deal queries */
+	partnerId?: string;
 }
 
 // ---------------------------------------------------------------------------
@@ -483,6 +487,25 @@ export async function seedSalesforceContext(): Promise<SalesforceContext | null>
 }
 
 // ---------------------------------------------------------------------------
+/** Format territory list with a character budget. If joined string exceeds budget, truncate with +N more. */
+function formatTerritoryDisplay(territories: string[] | undefined, budget: number): string | undefined {
+	if (!territories?.length) return undefined;
+	const joined = territories.join(", ");
+	if (joined.length <= budget) return joined;
+	// Include as many territories as fit, leaving room for the "+N more" suffix
+	let result = territories[0];
+	let included = 1;
+	for (let i = 1; i < territories.length; i++) {
+		const candidate = `${result}, ${territories[i]}`;
+		// Reserve ~10 chars for ", +N more" suffix
+		if (candidate.length > budget - 10) break;
+		result = candidate;
+		included++;
+	}
+	const remaining = territories.length - included;
+	if (remaining > 0) result += `, +${remaining} more`;
+	return result;
+}
 // Hint builder
 // ---------------------------------------------------------------------------
 
@@ -506,7 +529,9 @@ export function buildSalesforceHint(
 		: ctx.confirmedTerritories?.length
 			? ctx.confirmedTerritories
 			: ctx.territories?.slice(0, 3);
-	const topTerritories = territorySource?.join(", ");
+	// Display budget: if joined string exceeds 60 chars, truncate with +N more
+	const TERRITORY_CHAR_BUDGET = 60;
+	const topTerritories = formatTerritoryDisplay(territorySource, TERRITORY_CHAR_BUDGET);
 
 	// Forecast breakdown
 	const byForecast = ctx.pipelineSummary.byForecast;
@@ -535,6 +560,8 @@ export function buildSalesforceHint(
 		forecastBreakdown,
 		partnerName,
 		partnerRole,
+		orgAlias: ctx.orgAlias,
+		partnerId: partner?.id,
 	};
 }
 

package/src/pipeline-report/types.ts

@@ -8,12 +8,12 @@ export interface SkuClassification {
 
 /** Default classification — discoverable from actual pipeline data. */
 export const DEFAULT_SKU_CLASSIFICATION: SkuClassification = {
-	platform: ["F5-V-O", "F5-XC", "F5-FAS-WAF", "F5-FAS-API", "F5-UTIL", "F5-CST"],
+	platform: ["F5-V-O", "F5-XC", "F5-FAS-WAF", "F5-FAS-API", "F5-UTIL", "F5-CST", "F5-ELA"],
 	shape: ["F5-SHP", "F5-FAS-BOT", "F5-FAS-DOS"],
 };
 
 /** All SKU prefixes that define the XC/Shape overlay product scope. */
-export const DEFAULT_SKU_PREFIXES = ["F5-V-O", "F5-XC", "F5-FAS", "F5-SHP", "F5-UTIL", "F5-CST"];
+export const DEFAULT_SKU_PREFIXES = ["F5-V-O", "F5-XC", "F5-FAS", "F5-SHP", "F5-UTIL", "F5-CST", "F5-ELA"];
 
 export interface LineItemRecord {
 	opportunityId: string;

package/src/prompts/system/system-prompt.md

@@ -160,7 +160,9 @@ Available F5 XC documentation topics: {{knowledgeTopics}}.
 {{/if}}
 
 {{#if salesforceHint}}
-`xcsh://salesforce`. {{salesforceHint.pipelineTotal}}{{#if salesforceHint.territories}} ({{salesforceHint.territories}}){{/if}}.{{#if salesforceHint.partnerName}} {{salesforceHint.partnerRole}}: {{salesforceHint.partnerName}}.{{/if}}{{#if salesforceHint.forecastBreakdown}} {{salesforceHint.forecastBreakdown}}.{{/if}}
+`xcsh://salesforce`{{#if salesforceHint.orgAlias}} ({{salesforceHint.orgAlias}}){{/if}}. {{salesforceHint.pipelineTotal}}{{#if salesforceHint.territories}} ({{salesforceHint.territories}}){{/if}}.{{#if salesforceHint.partnerName}} {{salesforceHint.partnerRole}}: {{salesforceHint.partnerName}}.{{/if}}{{#if salesforceHint.forecastBreakdown}} {{salesforceHint.forecastBreakdown}}.{{/if}}
+
+Pipeline queries: current fiscal quarter, team-member scoped, Commit/BestCase first. Do NOT dump all-time open pipeline.{{#if salesforceHint.orgAlias}} Always use target_org: {{salesforceHint.orgAlias}}.{{/if}}{{#if salesforceHint.partnerId}} AE UserId: {{salesforceHint.partnerId}}.{{/if}}
 {{/if}}
 
 {{#if contextFiles.length}}

package/src/prompts/tools/sf-query.md

@@ -5,11 +5,38 @@ Use for pipeline reporting, case management, account intelligence, and ad-hoc da
 
 Common query templates (substitute {userId} from user profile — read `xcsh://user` to get identifiers.salesforceId):
 
-Pipeline summary:
-  SELECT StageName, COUNT(Id) TotalDeals, SUM(Amount) TotalAmount FROM Opportunity WHERE IsClosed = false GROUP BY StageName ORDER BY SUM(Amount) DESC LIMIT 50
+In-quarter pipeline (current fiscal quarter, team-scoped):
+  SELECT Account.Name, Name, Amount, StageName, ForecastCategoryName, CloseDate, Owner.Name, LastActivityDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND CloseDate = THIS_FISCAL_QUARTER AND ForecastCategoryName <> 'Omitted' ORDER BY Amount DESC NULLS LAST LIMIT 50
 
-My open deals:
-  SELECT Name, StageName, Amount, CloseDate, Account.Name FROM Opportunity WHERE OwnerId = '{userId}' AND IsClosed = false ORDER BY CloseDate LIMIT 50
+Forecast breakdown (current quarter):
+  SELECT ForecastCategoryName, SUM(Amount) TotalAmount, COUNT(Id) TotalDeals FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND CloseDate = THIS_FISCAL_QUARTER AND ForecastCategoryName <> 'Omitted' GROUP BY ForecastCategoryName ORDER BY SUM(Amount) DESC
+
+Closing within 30 days:
+  SELECT Account.Name, Name, Amount, StageName, ForecastCategoryName, CloseDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND CloseDate = NEXT_N_DAYS:30 ORDER BY CloseDate ASC LIMIT 20
+
+Booked this quarter (closed-won):
+  SELECT Account.Name, Name, Amount, CloseDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsWon = true AND CloseDate = THIS_FISCAL_QUARTER ORDER BY Amount DESC LIMIT 30
+
+Slipped deals (close date in the past but recent — last 6 months):
+  SELECT Account.Name, Name, Amount, StageName, CloseDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND CloseDate < TODAY AND CloseDate = LAST_N_DAYS:180 ORDER BY Amount DESC NULLS LAST LIMIT 20
+
+Commit deals only ("what's my commit"):
+  SELECT Account.Name, Name, Amount, StageName, CloseDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND CloseDate = THIS_FISCAL_QUARTER AND ForecastCategoryName = 'Commit' ORDER BY Amount DESC NULLS LAST LIMIT 20
+
+Account pipeline ("show me [account]"):
+  SELECT Name, Amount, StageName, ForecastCategoryName, CloseDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND Account.Name LIKE '%{account}%' ORDER BY Amount DESC NULLS LAST LIMIT 20
+
+Pipeline by account ("which accounts have the most pipeline"):
+  SELECT Account.Name, COUNT(Id) DealCount, SUM(Amount) TotalAmount FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND ForecastCategoryName <> 'Omitted' GROUP BY Account.Name ORDER BY SUM(Amount) DESC NULLS LAST LIMIT 15
+
+Recently changed in-quarter deals ("what changed this week"):
+  SELECT Account.Name, Name, Amount, StageName, ForecastCategoryName, CloseDate, LastModifiedDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = false AND CloseDate = THIS_FISCAL_QUARTER AND LastModifiedDate = LAST_N_DAYS:7 ORDER BY LastModifiedDate DESC LIMIT 20
+
+Lost/abandoned deals this year:
+  SELECT Account.Name, Name, Amount, StageName, CloseDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsClosed = true AND IsWon = false AND CloseDate = THIS_FISCAL_YEAR ORDER BY CloseDate DESC NULLS LAST LIMIT 20
+
+Last quarter booked (closed-won):
+  SELECT Account.Name, Name, Amount, CloseDate FROM Opportunity WHERE Id IN (SELECT OpportunityId FROM OpportunityTeamMember WHERE UserId = '{userId}') AND IsWon = true AND CloseDate = LAST_FISCAL_QUARTER ORDER BY Amount DESC LIMIT 20
 
 Open cases:
   SELECT CaseNumber, Subject, Status, Priority, Account.Name, CreatedDate FROM Case WHERE IsClosed = false ORDER BY Priority, CreatedDate DESC LIMIT 50
@@ -17,6 +44,27 @@ Open cases:
 Account overview:
   SELECT Name, Industry, AnnualRevenue, Type, Owner.Name FROM Account WHERE Type = 'Customer' ORDER BY AnnualRevenue DESC LIMIT 50
 
+Pipeline report structure — when user asks for "pipeline report", "forecast", or "what's my pipeline":
+1. Run forecast breakdown query first to get the shape of the quarter
+2. Executive summary: in-quarter total, Commit/Best Case/Pipeline split, booked-to-date
+3. Top deals by account within each forecast category (Commit first, then Best Case)
+4. At-risk: slipped deals (CloseDate < TODAY) and early-stage deals closing soon
+5. Booked this quarter — what has already closed
+6. Recommended actions — for each risk, suggest a concrete next step (exec sponsor call, POC timeline, close plan review)
+Focus on in-quarter pipeline. Do NOT include deals closing in future quarters unless user asks.
+Flag deals with close dates in the past — these are slipped and need attention.
+Keep to 5-7 key metrics. A pipeline report is for action, not data inventory.
+
+Audience-aware formatting — adjust output based on who will read it:
+- **Self / AE partner:** Deal-level detail, close dates, stages, next technical actions.
+- **Manager ("report for my manager"):** Lead with commit total + deal-level evidence. Then risks: what slipped, what's stalled, mitigation plan. No technical detail — managers need forecast confidence, not architecture.
+- **Director/VP ("executive summary"):** Territory-level totals only. Commit/Best Case/Pipeline split. Coverage ratio if quota is known. One line per risk. No deal names unless asked.
+
+Scoping: User may be an overlay SE. Use OpportunityTeamMember scoping (not OwnerId) as the primary filter.
+AE-owned deals: SFDC does not allow OR with semi-join subselects. Run a SEPARATE query with OwnerId = '{aeId}' and merge results. Do not combine into one WHERE clause.
+
+Stage-based filtering: Add WHERE StageName clauses to any template when the user asks about deals needing technical engagement, demos, POCs, or specific stages. Early stages: 'Awareness', 'Research and Internal Education', 'Pending Initial Meeting'. Active stages: 'Budget and Timing Determination', 'Solution - Front Runner'. Late stages: 'Negotiation', 'Close - Booked'. Deals in early stages with close dates within 60 days are at-risk (insufficient time to progress).
+
 Results with relationship fields (e.g., Account.Name) are automatically flattened into dot-notation columns.
 If the query returns more than 10,000 records, suggest using sf data export bulk instead.
 Set use_tooling_api to true when querying metadata objects (ApexTrigger, ApexClass, CustomField).

package/src/system-prompt.ts

@@ -490,6 +490,10 @@ export interface BuildSystemPromptOptions {
 		partnerName?: string;
 		/** Partner role abbreviation: 'AE', 'SE', 'other' */
 		partnerRole?: string;
+		/** Org alias for SOQL queries, e.g. 'SFDC' */
+		orgAlias?: string;
+		/** Partner Salesforce UserId for AE-owned deal queries */
+		partnerId?: string;
 	};
 	knowledgeTopics?: string;
 	contextSkillDirs?: string[];