@bragduck/mcp 1.3.2 → 1.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js
CHANGED
|
@@ -4,6 +4,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
|
|
|
4
4
|
import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from '@modelcontextprotocol/sdk/types.js';
|
|
5
5
|
import { loginTool, handleLogin } from './tools/login.js';
|
|
6
6
|
import { logBragTool, handleLogBrag } from './tools/log-brag.js';
|
|
7
|
+
import { previewBragTool, handlePreviewBrag } from './tools/preview-brag.js';
|
|
7
8
|
import { listBragsTool, handleListBrags } from './tools/list-brags.js';
|
|
8
9
|
import { listObjectivesTool, handleListObjectives } from './tools/list-objectives.js';
|
|
9
10
|
import { linkBragToGoalTool, handleLinkBragToGoal } from './tools/link-brag-to-goal.js';
|
|
@@ -14,14 +15,52 @@ const server = new Server({
|
|
|
14
15
|
capabilities: {
|
|
15
16
|
tools: {},
|
|
16
17
|
},
|
|
17
|
-
instructions: 'BragDuck tracks career achievements ("brags")
|
|
18
|
-
'
|
|
19
|
-
'
|
|
20
|
-
'
|
|
18
|
+
instructions: 'BragDuck tracks career achievements ("brags") that feed into periodic performance reports. ' +
|
|
19
|
+
'A strong brag needs: a concrete accomplishment, measurable or observable impact, and ideally a reference link. ' +
|
|
20
|
+
'\n\n' +
|
|
21
|
+
'RESOLVING "THIS" IN "BRAG WITH THIS"\n' +
|
|
22
|
+
'When the user says "brag with this" (or "brag about this", "log this", etc.) without elaborating, ' +
|
|
23
|
+
'"this" refers to the most recent work visible in the current session: ' +
|
|
24
|
+
'the latest git diff, the last commit message, the most recently discussed code change, or a PR just mentioned. ' +
|
|
25
|
+
'Look for that context first before asking anything. ' +
|
|
26
|
+
'Only start the interview (see below) if no such context exists in the session.\n' +
|
|
27
|
+
'\n' +
|
|
28
|
+
'STEP 1 — ASSESS BRAGABILITY\n' +
|
|
29
|
+
'Before doing anything else, judge whether the subject is worth logging:\n' +
|
|
30
|
+
'- NOT bragable: vague status updates, trivial tasks with no impact, ' +
|
|
31
|
+
' or things a reasonable person would not list on a performance review. ' +
|
|
32
|
+
' Tell the user directly that it is not bragable and explain why in one sentence. ' +
|
|
33
|
+
' Note that brags feed the AI report generator — weak entries dilute the signal.\n' +
|
|
34
|
+
'- POTENTIALLY bragable but thin: start the interview (see below).\n' +
|
|
35
|
+
'- Clearly bragable with full context: skip the interview, go straight to STEP 2.\n' +
|
|
36
|
+
'\n' +
|
|
37
|
+
'THE INTERVIEW\n' +
|
|
38
|
+
'Conduct a short conversational interview to gather what you need. ' +
|
|
39
|
+
'Ask ONE question at a time — do not list multiple questions at once. ' +
|
|
40
|
+
'Each question should follow naturally from the previous answer, like a real conversation. ' +
|
|
41
|
+
'Suggested question order (adapt based on what you already know):\n' +
|
|
42
|
+
' 1. "What did you work on?" (skip if already known)\n' +
|
|
43
|
+
' 2. "What was the outcome or result?"\n' +
|
|
44
|
+
' 3. "Who was affected — just you, the team, or wider?"\n' +
|
|
45
|
+
' 4. "Do you have a link — PR, ticket, commit, or doc?" (skip if already have one)\n' +
|
|
46
|
+
'Stop the interview as soon as you have enough to write a strong brag. ' +
|
|
47
|
+
'Never ask more than 4 questions total.\n' +
|
|
48
|
+
'\n' +
|
|
49
|
+
'STEP 2 — PREVIEW\n' +
|
|
50
|
+
'Compose the brag from all gathered context. ' +
|
|
51
|
+
'Call preview_brag to show the user a formatted draft. Wait for their confirmation.\n' +
|
|
52
|
+
'\n' +
|
|
53
|
+
'STEP 3 — LOG\n' +
|
|
54
|
+
'Only after the user explicitly confirms, call log_brag with the same content.\n' +
|
|
55
|
+
'\n' +
|
|
56
|
+
'GENERAL RULES\n' +
|
|
57
|
+
'- Never fabricate details, metrics, or links. If unsure, ask.\n' +
|
|
58
|
+
'- "Is this bragable?" deserves a direct honest answer — not a tool call.\n' +
|
|
59
|
+
'- Call login first if any tool returns an authentication error.',
|
|
21
60
|
});
|
|
22
61
|
server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
23
62
|
return {
|
|
24
|
-
tools: [loginTool, logBragTool, listBragsTool, listObjectivesTool, linkBragToGoalTool],
|
|
63
|
+
tools: [loginTool, previewBragTool, logBragTool, listBragsTool, listObjectivesTool, linkBragToGoalTool],
|
|
25
64
|
};
|
|
26
65
|
});
|
|
27
66
|
server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
@@ -29,6 +68,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
|
29
68
|
switch (name) {
|
|
30
69
|
case 'login':
|
|
31
70
|
return handleLogin(args);
|
|
71
|
+
case 'preview_brag':
|
|
72
|
+
return handlePreviewBrag(args);
|
|
32
73
|
case 'log_brag':
|
|
33
74
|
return handleLogBrag(args);
|
|
34
75
|
case 'list_brags':
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,sBAAsB,EACtB,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAExF,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;IACD,YAAY,EACV,+
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/tools/log-brag.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { apiRequest } from '../api-client.js';
|
|
2
2
|
export const logBragTool = {
|
|
3
3
|
name: 'log_brag',
|
|
4
|
-
description: '
|
|
5
|
-
'
|
|
4
|
+
description: 'Persist a career achievement (brag) to BragDuck after the user has confirmed the preview. ' +
|
|
5
|
+
'NEVER call this directly — always call preview_brag first and wait for explicit user confirmation.',
|
|
6
6
|
inputSchema: {
|
|
7
7
|
type: 'object',
|
|
8
8
|
properties: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"log-brag.js","sourceRoot":"","sources":["../../src/tools/log-brag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAU;IAChB,WAAW,EACT
|
|
1
|
+
{"version":3,"file":"log-brag.js","sourceRoot":"","sources":["../../src/tools/log-brag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,4FAA4F;QAC5F,oGAAoG;IACtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,EAAE;gBACb,SAAS,EAAE,GAAG;gBACd,WAAW,EAAE,4DAA4D;aAC1E;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,EAAE;gBACb,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,2FAA2F;aACzG;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;gBACtD,QAAQ,EAAE,EAAE;gBACZ,WAAW,EAAE,gIAAgI;aAC9I;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAClB,WAAW,EACT,mCAAmC;oBACnC,+CAA+C;oBAC/C,4DAA4D;oBAC5D,sEAAsE;oBACtE,4EAA4E;aAC/E;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uCAAuC;oBACvC,gEAAgE;oBAChE,wCAAwC;oBACxC,4EAA4E;aAC/E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACJ,UAAU;oBACV,aAAa;oBACb,aAAa;oBACb,SAAS;oBACT,MAAM;oBACN,YAAY;oBACZ,UAAU;oBACV,eAAe;oBACf,WAAW;oBACX,YAAY;oBACZ,SAAS;oBACT,KAAK;oBACL,QAAQ;iBACT;gBACD,WAAW,EAAE,0EAA0E;aACxF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;gBACxC,QAAQ,EAAE,EAAE;gBACZ,WAAW,EACT,oDAAoD;oBACpD,4DAA4D;oBAC5D,uFAAuF;oBACvF,+FAA+F;aAClG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,oBAAoB,CAAC;KACjF;CACF,CAAC;AAcF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5C,UAAU,EAAE,SAAS;SACtB,CAAC;QAEF,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC;QAC5E,IAAI,KAAK,CAAC,kBAAkB;YAAE,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;QACjF,IAAI,KAAK,CAAC,IAAI;YAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;QAC1C,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACzF,IAAI,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAE1C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAyB,WAAW,EAAE;YACrE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;SACvC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,kBAAkB,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG;qBACjF,CAAC;aACH,CAAC;QACJ,CAAC;QAED,8DAA8D;QAC9D,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,+BAA+B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;iBAChE,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,mBAAmB,IAAI,KAAK,CAAC,OAAO,KAAK,eAAe,CAAC,EAAE,CAAC;YAC3G,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sEAAsE;qBAC7E,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACzF,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
export declare const previewBragTool: {
|
|
2
|
+
name: string;
|
|
3
|
+
description: string;
|
|
4
|
+
inputSchema: {
|
|
5
|
+
type: "object";
|
|
6
|
+
properties: {
|
|
7
|
+
title: {
|
|
8
|
+
type: string;
|
|
9
|
+
minLength: number;
|
|
10
|
+
maxLength: number;
|
|
11
|
+
description: string;
|
|
12
|
+
};
|
|
13
|
+
description: {
|
|
14
|
+
type: string;
|
|
15
|
+
minLength: number;
|
|
16
|
+
maxLength: number;
|
|
17
|
+
description: string;
|
|
18
|
+
};
|
|
19
|
+
type: {
|
|
20
|
+
type: string;
|
|
21
|
+
enum: string[];
|
|
22
|
+
description: string;
|
|
23
|
+
};
|
|
24
|
+
impact_level: {
|
|
25
|
+
type: string;
|
|
26
|
+
enum: number[];
|
|
27
|
+
description: string;
|
|
28
|
+
};
|
|
29
|
+
impact_description: {
|
|
30
|
+
type: string;
|
|
31
|
+
description: string;
|
|
32
|
+
};
|
|
33
|
+
tags: {
|
|
34
|
+
type: string;
|
|
35
|
+
items: {
|
|
36
|
+
type: string;
|
|
37
|
+
minLength: number;
|
|
38
|
+
maxLength: number;
|
|
39
|
+
};
|
|
40
|
+
maxItems: number;
|
|
41
|
+
description: string;
|
|
42
|
+
};
|
|
43
|
+
references: {
|
|
44
|
+
type: string;
|
|
45
|
+
items: {
|
|
46
|
+
type: string;
|
|
47
|
+
format: string;
|
|
48
|
+
};
|
|
49
|
+
maxItems: number;
|
|
50
|
+
description: string;
|
|
51
|
+
};
|
|
52
|
+
};
|
|
53
|
+
required: string[];
|
|
54
|
+
};
|
|
55
|
+
};
|
|
56
|
+
interface PreviewBragInput {
|
|
57
|
+
title: string;
|
|
58
|
+
description: string;
|
|
59
|
+
type: string;
|
|
60
|
+
impact_level: number;
|
|
61
|
+
impact_description: string;
|
|
62
|
+
tags?: string[];
|
|
63
|
+
references?: string[];
|
|
64
|
+
}
|
|
65
|
+
export declare function handlePreviewBrag(input: PreviewBragInput): {
|
|
66
|
+
content: Array<{
|
|
67
|
+
type: string;
|
|
68
|
+
text: string;
|
|
69
|
+
}>;
|
|
70
|
+
};
|
|
71
|
+
export {};
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
const IMPACT_LABELS = {
|
|
2
|
+
0: 'None (personal learning / routine)',
|
|
3
|
+
1: 'Low (individual contributor impact)',
|
|
4
|
+
2: 'Medium (team-level impact)',
|
|
5
|
+
3: 'High (organisation-level impact)',
|
|
6
|
+
};
|
|
7
|
+
const TYPE_EMOJIS = {
|
|
8
|
+
progress: '📈',
|
|
9
|
+
achievement: '🏆',
|
|
10
|
+
recognition: '🌟',
|
|
11
|
+
support: '🤝',
|
|
12
|
+
code: '💻',
|
|
13
|
+
leadership: '🧭',
|
|
14
|
+
learning: '📚',
|
|
15
|
+
collaboration: '👥',
|
|
16
|
+
challenge: '⚔️',
|
|
17
|
+
innovation: '💡',
|
|
18
|
+
meeting: '🗣️',
|
|
19
|
+
bug: '🐛',
|
|
20
|
+
others: '📌',
|
|
21
|
+
};
|
|
22
|
+
export const previewBragTool = {
|
|
23
|
+
name: 'preview_brag',
|
|
24
|
+
description: 'Show the user a formatted preview of a proposed brag BEFORE logging it. ' +
|
|
25
|
+
'Only call this when: (1) the user has confirmed they want to log a brag, ' +
|
|
26
|
+
'(2) you have assessed the achievement as bragable, and ' +
|
|
27
|
+
'(3) you have enough concrete detail to fill every required field without fabricating. ' +
|
|
28
|
+
'If any of those conditions are not met, do not call this — ask clarifying questions instead.',
|
|
29
|
+
inputSchema: {
|
|
30
|
+
type: 'object',
|
|
31
|
+
properties: {
|
|
32
|
+
title: {
|
|
33
|
+
type: 'string',
|
|
34
|
+
minLength: 10,
|
|
35
|
+
maxLength: 200,
|
|
36
|
+
description: 'Short title of the achievement (10-200 characters)',
|
|
37
|
+
},
|
|
38
|
+
description: {
|
|
39
|
+
type: 'string',
|
|
40
|
+
minLength: 50,
|
|
41
|
+
maxLength: 2000,
|
|
42
|
+
description: 'Detailed description of what was accomplished and its impact (50-2000 characters)',
|
|
43
|
+
},
|
|
44
|
+
type: {
|
|
45
|
+
type: 'string',
|
|
46
|
+
enum: [
|
|
47
|
+
'progress', 'achievement', 'recognition', 'support', 'code',
|
|
48
|
+
'leadership', 'learning', 'collaboration', 'challenge', 'innovation',
|
|
49
|
+
'meeting', 'bug', 'others',
|
|
50
|
+
],
|
|
51
|
+
description: 'Category that best fits this achievement',
|
|
52
|
+
},
|
|
53
|
+
impact_level: {
|
|
54
|
+
type: 'number',
|
|
55
|
+
enum: [0, 1, 2, 3],
|
|
56
|
+
description: '0=none, 1=low (individual), 2=medium (team), 3=high (org)',
|
|
57
|
+
},
|
|
58
|
+
impact_description: {
|
|
59
|
+
type: 'string',
|
|
60
|
+
description: 'Narrative of the impact. Start with scope (Individual/Team/Organization), ' +
|
|
61
|
+
'then 1-3 measurable outcomes.',
|
|
62
|
+
},
|
|
63
|
+
tags: {
|
|
64
|
+
type: 'array',
|
|
65
|
+
items: { type: 'string', minLength: 2, maxLength: 30 },
|
|
66
|
+
maxItems: 10,
|
|
67
|
+
description: 'Tags to categorise the brag',
|
|
68
|
+
},
|
|
69
|
+
references: {
|
|
70
|
+
type: 'array',
|
|
71
|
+
items: { type: 'string', format: 'uri' },
|
|
72
|
+
maxItems: 10,
|
|
73
|
+
description: 'URLs: PRs, tickets, commits, design docs, etc.',
|
|
74
|
+
},
|
|
75
|
+
},
|
|
76
|
+
required: ['title', 'description', 'type', 'impact_level', 'impact_description'],
|
|
77
|
+
},
|
|
78
|
+
};
|
|
79
|
+
export function handlePreviewBrag(input) {
|
|
80
|
+
const emoji = TYPE_EMOJIS[input.type] ?? '📌';
|
|
81
|
+
const impactLabel = IMPACT_LABELS[input.impact_level] ?? String(input.impact_level);
|
|
82
|
+
const lines = [
|
|
83
|
+
'## BragDuck — Preview',
|
|
84
|
+
'',
|
|
85
|
+
`**${input.title}**`,
|
|
86
|
+
'',
|
|
87
|
+
input.description,
|
|
88
|
+
'',
|
|
89
|
+
'---',
|
|
90
|
+
`${emoji} **Type:** ${input.type}`,
|
|
91
|
+
`⚡ **Impact:** ${impactLabel}`,
|
|
92
|
+
`💬 **Impact details:** ${input.impact_description}`,
|
|
93
|
+
];
|
|
94
|
+
if (input.tags && input.tags.length > 0) {
|
|
95
|
+
lines.push(`🏷️ **Tags:** ${input.tags.join(', ')}`);
|
|
96
|
+
}
|
|
97
|
+
if (input.references && input.references.length > 0) {
|
|
98
|
+
lines.push('🔗 **References:**');
|
|
99
|
+
for (const ref of input.references) {
|
|
100
|
+
lines.push(` - ${ref}`);
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
lines.push('', '---', '_Does this look good? Say **yes** to log it, or tell me what to adjust._');
|
|
104
|
+
return {
|
|
105
|
+
content: [{ type: 'text', text: lines.join('\n') }],
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
//# sourceMappingURL=preview-brag.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"preview-brag.js","sourceRoot":"","sources":["../../src/tools/preview-brag.ts"],"names":[],"mappings":"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"}
|