@mickey20/codefy 1.0.2 → 1.1.0

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.
@@ -0,0 +1,240 @@
1
+ import { z } from "zod";
2
+ import * as fs from "node:fs/promises";
3
+ import * as path from "node:path";
4
+ import { validateTarget, triggerScan, getJob, exportJob, cancelJob, listScans, } from "../../services/dast.js";
5
+ import { FAST_DAST_TOOLS, createProgressReporter, errorResult, jsonResult, waitForJob, } from "../helpers.js";
6
+ export function registerDastTools(server) {
7
+ // 1. Validate DAST target URL
8
+ server.registerTool("codefy_dast_validate_target", {
9
+ title: "Validate DAST Target URL",
10
+ description: "Pre-flight validate a target URL against Codefy DNS, SSRF, loopback (127.0.0.1), RFC1918 private subnet, and cloud metadata (169.254.169.254) guardrails before launching a DAST scan.",
11
+ inputSchema: {
12
+ target_url: z.string().url().describe("Target HTTP/HTTPS URL to validate (e.g. https://example.com)."),
13
+ },
14
+ annotations: {
15
+ readOnlyHint: true,
16
+ destructiveHint: false,
17
+ idempotentHint: true,
18
+ openWorldHint: true,
19
+ },
20
+ }, async (args) => {
21
+ try {
22
+ const result = await validateTarget(args.target_url);
23
+ return jsonResult(result);
24
+ }
25
+ catch (err) {
26
+ return errorResult(err, `Failed to validate target URL '${args.target_url}'`);
27
+ }
28
+ });
29
+ // 2. Trigger DAST scan
30
+ server.registerTool("codefy_dast_scan", {
31
+ title: "Run DAST Security Scan",
32
+ description: "Trigger a Dynamic Application Security Testing (DAST) scan against an authorized target URL. Defaults to passive mode with the fast preset (httpx, wafw00f, sslyze, ~5-15s). Only scan targets you own or are explicitly authorized to test.",
33
+ inputSchema: {
34
+ target_url: z.string().url().describe("Authorized target HTTP/HTTPS URL to scan."),
35
+ mode: z
36
+ .enum(["passive", "active"])
37
+ .default("passive")
38
+ .describe("'passive' for safe recon/fingerprinting; 'active' for vulnerability fuzzing/probing (authorized targets only)."),
39
+ fast: z
40
+ .boolean()
41
+ .default(true)
42
+ .describe("Use the fast recon preset (httpx, wafw00f, sslyze). Ignored if 'tools' is explicitly provided."),
43
+ tools: z
44
+ .array(z.string().min(1))
45
+ .optional()
46
+ .describe("Specific DAST tool IDs (e.g. ['httpx', 'katana', 'nuclei']). Call codefy_list_tools(type='dast') to see all 30 engines."),
47
+ crawl_depth: z
48
+ .number()
49
+ .int()
50
+ .min(1)
51
+ .max(10)
52
+ .optional()
53
+ .describe("Optional crawl depth limit for spidering tools."),
54
+ max_hosts: z
55
+ .number()
56
+ .int()
57
+ .min(1)
58
+ .max(100)
59
+ .optional()
60
+ .describe("Optional maximum host count for discovery."),
61
+ custom_headers: z
62
+ .record(z.string(), z.string())
63
+ .optional()
64
+ .describe("Optional custom HTTP headers to send with DAST requests (e.g. auth headers for staging)."),
65
+ target_id: z
66
+ .string()
67
+ .optional()
68
+ .describe("Optional logical target identifier."),
69
+ wait: z
70
+ .boolean()
71
+ .default(true)
72
+ .describe("Wait for scan completion and return findings. Set false for long deep scans and poll with codefy_dast_get_job."),
73
+ timeout_seconds: z
74
+ .number()
75
+ .int()
76
+ .min(10)
77
+ .max(600)
78
+ .default(180)
79
+ .describe("Maximum seconds to wait when wait=true."),
80
+ },
81
+ annotations: {
82
+ readOnlyHint: false,
83
+ destructiveHint: false,
84
+ idempotentHint: false,
85
+ openWorldHint: true,
86
+ },
87
+ }, async (args, extra) => {
88
+ try {
89
+ const selectedTools = args.tools && args.tools.length > 0
90
+ ? args.tools
91
+ : args.fast
92
+ ? FAST_DAST_TOOLS
93
+ : undefined;
94
+ const payload = {
95
+ target_url: args.target_url,
96
+ ...(selectedTools ? { tools: selectedTools } : {}),
97
+ ...(args.crawl_depth !== undefined ? { crawl_depth: args.crawl_depth } : {}),
98
+ ...(args.max_hosts !== undefined ? { max_hosts: args.max_hosts } : {}),
99
+ ...(args.custom_headers ? { custom_headers: args.custom_headers } : {}),
100
+ ...(args.target_id ? { target_id: args.target_id } : {}),
101
+ };
102
+ const queued = await triggerScan(payload, args.mode);
103
+ if (!args.wait) {
104
+ return jsonResult({
105
+ ...queued,
106
+ note: `DAST scan queued. Call codefy_dast_get_job with job_id '${queued.job_id}' to inspect results.`,
107
+ });
108
+ }
109
+ const onProgress = createProgressReporter(extra);
110
+ const { job, timedOut } = await waitForJob({
111
+ fetchJob: () => getJob(queued.job_id),
112
+ timeoutSeconds: args.timeout_seconds,
113
+ signal: extra.signal,
114
+ onProgress,
115
+ });
116
+ return jsonResult({
117
+ ...job,
118
+ ...(timedOut
119
+ ? {
120
+ timed_out: true,
121
+ note: `Job ${job.job_id} is still '${job.status}'. Call codefy_dast_get_job with job_id '${job.job_id}' to check again later.`,
122
+ }
123
+ : {}),
124
+ });
125
+ }
126
+ catch (err) {
127
+ return errorResult(err, `DAST scan failed for '${args.target_url}'`);
128
+ }
129
+ });
130
+ // 3. Get DAST job
131
+ server.registerTool("codefy_dast_get_job", {
132
+ title: "Get DAST Scan Job",
133
+ description: "Fetch status, severity summary, vulnerability findings, and tool errors for a DAST scan job.",
134
+ inputSchema: {
135
+ job_id: z.string().min(1).describe("DAST scan job ID."),
136
+ },
137
+ annotations: {
138
+ readOnlyHint: true,
139
+ destructiveHint: false,
140
+ idempotentHint: true,
141
+ openWorldHint: true,
142
+ },
143
+ }, async (args) => {
144
+ try {
145
+ const job = await getJob(args.job_id);
146
+ return jsonResult(job);
147
+ }
148
+ catch (err) {
149
+ return errorResult(err, `Failed to get DAST job '${args.job_id}'`);
150
+ }
151
+ });
152
+ // 4. List DAST scans
153
+ server.registerTool("codefy_dast_list_scans", {
154
+ title: "List DAST Scans",
155
+ description: "List historical DAST scan jobs with optional pagination and status filter.",
156
+ inputSchema: {
157
+ limit: z.number().int().min(1).max(100).default(20),
158
+ offset: z.number().int().min(0).default(0),
159
+ status: z.string().optional().describe("Filter by status (pending, running, completed, failed)."),
160
+ },
161
+ annotations: {
162
+ readOnlyHint: true,
163
+ destructiveHint: false,
164
+ idempotentHint: true,
165
+ openWorldHint: true,
166
+ },
167
+ }, async (args) => {
168
+ try {
169
+ const res = await listScans({
170
+ limit: args.limit,
171
+ offset: args.offset,
172
+ status: args.status,
173
+ });
174
+ return jsonResult(res);
175
+ }
176
+ catch (err) {
177
+ return errorResult(err, "Failed to list DAST scans");
178
+ }
179
+ });
180
+ // 5. Export DAST scan
181
+ server.registerTool("codefy_dast_export", {
182
+ title: "Export DAST Scan Findings",
183
+ description: "Export DAST scan findings in SARIF or JSON format. Returns the report directly or writes it to output_path if specified.",
184
+ inputSchema: {
185
+ job_id: z.string().min(1).describe("DAST scan job ID."),
186
+ format: z.enum(["sarif", "json"]).default("sarif"),
187
+ output_path: z.string().optional().describe("Optional local file path to save the exported report."),
188
+ },
189
+ annotations: {
190
+ readOnlyHint: false,
191
+ destructiveHint: false,
192
+ idempotentHint: true,
193
+ openWorldHint: true,
194
+ },
195
+ }, async (args) => {
196
+ try {
197
+ const exported = await exportJob(args.job_id, args.format);
198
+ const content = typeof exported === "string" ? exported : JSON.stringify(exported, null, 2);
199
+ if (args.output_path) {
200
+ const resolved = path.resolve(args.output_path);
201
+ await fs.mkdir(path.dirname(resolved), { recursive: true });
202
+ await fs.writeFile(resolved, content, "utf-8");
203
+ return jsonResult({
204
+ job_id: args.job_id,
205
+ format: args.format,
206
+ output_path: resolved,
207
+ bytes_written: Buffer.byteLength(content, "utf-8"),
208
+ message: `Exported ${args.format.toUpperCase()} report to ${resolved}`,
209
+ });
210
+ }
211
+ return jsonResult(exported);
212
+ }
213
+ catch (err) {
214
+ return errorResult(err, `Failed to export DAST job '${args.job_id}'`);
215
+ }
216
+ });
217
+ // 6. Cancel DAST job
218
+ server.registerTool("codefy_dast_cancel_job", {
219
+ title: "Cancel DAST Scan Job",
220
+ description: "Cancel an active DAST scan job or purge its job records.",
221
+ inputSchema: {
222
+ job_id: z.string().min(1).describe("DAST scan job ID to cancel."),
223
+ },
224
+ annotations: {
225
+ readOnlyHint: false,
226
+ destructiveHint: true,
227
+ idempotentHint: true,
228
+ openWorldHint: true,
229
+ },
230
+ }, async (args) => {
231
+ try {
232
+ const res = await cancelJob(args.job_id);
233
+ return jsonResult(res);
234
+ }
235
+ catch (err) {
236
+ return errorResult(err, `Failed to cancel DAST job '${args.job_id}'`);
237
+ }
238
+ });
239
+ }
240
+ //# sourceMappingURL=dast.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dast.js","sourceRoot":"","sources":["../../../src/mcp/tools/dast.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,191 @@
1
+ import { z } from "zod";
2
+ import { listIssues, getIssue, transitionIssue, grantRiskAcceptance, deleteIssue, getMetricsSummary, } from "../../services/issues.js";
3
+ import { errorResult, jsonResult } from "../helpers.js";
4
+ export function registerIssuesTools(server) {
5
+ // 1. List canonical issues
6
+ server.registerTool("codefy_issues_list", {
7
+ title: "List Canonical Security Issues",
8
+ description: "Query and filter canonical security issues across repositories by severity, lifecycle status, vulnerability category, or repo ID.",
9
+ inputSchema: {
10
+ severity: z
11
+ .enum(["critical", "high", "medium", "low", "info"])
12
+ .optional()
13
+ .describe("Filter by severity level."),
14
+ status: z
15
+ .enum(["open", "discovered", "triaged", "verified", "fixed", "risk_accepted", "closed"])
16
+ .optional()
17
+ .describe("Filter by issue lifecycle status."),
18
+ category: z
19
+ .string()
20
+ .optional()
21
+ .describe("Filter by vulnerability category (e.g. SQL_INJECTION, SSRF, XSS)."),
22
+ repo_id: z.string().optional().describe("Filter by repository ID."),
23
+ limit: z.number().int().min(1).max(200).default(50),
24
+ offset: z.number().int().min(0).default(0),
25
+ },
26
+ annotations: {
27
+ readOnlyHint: true,
28
+ destructiveHint: false,
29
+ idempotentHint: true,
30
+ openWorldHint: true,
31
+ },
32
+ }, async (args) => {
33
+ try {
34
+ const res = await listIssues({
35
+ severity: args.severity,
36
+ status: args.status,
37
+ category: args.category,
38
+ repo_id: args.repo_id,
39
+ limit: args.limit,
40
+ offset: args.offset,
41
+ });
42
+ return jsonResult(res);
43
+ }
44
+ catch (err) {
45
+ return errorResult(err, "Failed to list canonical issues");
46
+ }
47
+ });
48
+ // 2. Get issue detail
49
+ server.registerTool("codefy_issues_get", {
50
+ title: "Get Security Issue Details",
51
+ description: "Retrieve full details for a canonical security issue including location anchor (code/url/dependency/secret/infra), reproduction evidence, remediation advice, risk acceptance, and audit timeline.",
52
+ inputSchema: {
53
+ issue_id: z.string().min(1).describe("Canonical issue ID."),
54
+ },
55
+ annotations: {
56
+ readOnlyHint: true,
57
+ destructiveHint: false,
58
+ idempotentHint: true,
59
+ openWorldHint: true,
60
+ },
61
+ }, async (args) => {
62
+ try {
63
+ const res = await getIssue(args.issue_id);
64
+ return jsonResult(res);
65
+ }
66
+ catch (err) {
67
+ return errorResult(err, `Failed to get issue '${args.issue_id}'`);
68
+ }
69
+ });
70
+ // 3. Transition issue status
71
+ server.registerTool("codefy_issues_transition", {
72
+ title: "Transition Security Issue Status",
73
+ description: "Transition a canonical security issue to a new lifecycle state (e.g. triaged, verified, fixed, closed) with an audit reason.",
74
+ inputSchema: {
75
+ issue_id: z.string().min(1).describe("Canonical issue ID."),
76
+ target_status: z
77
+ .enum(["discovered", "triaged", "verified", "fixed", "closed"])
78
+ .describe("Target lifecycle status."),
79
+ reason: z
80
+ .string()
81
+ .optional()
82
+ .describe("Audit justification (e.g. 'Patched in PR #42 with parameterized query')."),
83
+ actor: z
84
+ .string()
85
+ .optional()
86
+ .describe("Identifier of the person or agent performing the transition."),
87
+ },
88
+ annotations: {
89
+ readOnlyHint: false,
90
+ destructiveHint: false,
91
+ idempotentHint: false,
92
+ openWorldHint: true,
93
+ },
94
+ }, async (args) => {
95
+ try {
96
+ const updated = await transitionIssue(args.issue_id, {
97
+ target_status: args.target_status,
98
+ reason: args.reason,
99
+ actor: args.actor,
100
+ });
101
+ return jsonResult(updated);
102
+ }
103
+ catch (err) {
104
+ return errorResult(err, `Failed to transition issue '${args.issue_id}'`);
105
+ }
106
+ });
107
+ // 4. Grant risk acceptance
108
+ server.registerTool("codefy_issues_accept_risk", {
109
+ title: "Grant Risk Acceptance Exemption",
110
+ description: "Grant a formal time-bound risk acceptance exemption (up to 90 days) for a canonical security issue, recorded in the audit log.",
111
+ inputSchema: {
112
+ issue_id: z.string().min(1).describe("Canonical issue ID."),
113
+ accepted_by: z.string().min(1).describe("Name or identity of the approver granting risk acceptance."),
114
+ reason: z.string().min(1).describe("Detailed justification for accepting the risk."),
115
+ expires_days: z
116
+ .number()
117
+ .int()
118
+ .min(1)
119
+ .max(90)
120
+ .default(90)
121
+ .describe("Duration in days before exemption expires (1-90, default 90)."),
122
+ },
123
+ annotations: {
124
+ readOnlyHint: false,
125
+ destructiveHint: false,
126
+ idempotentHint: false,
127
+ openWorldHint: true,
128
+ },
129
+ }, async (args) => {
130
+ try {
131
+ const updated = await grantRiskAcceptance(args.issue_id, {
132
+ accepted_by: args.accepted_by,
133
+ reason: args.reason,
134
+ expires_days: args.expires_days,
135
+ });
136
+ return jsonResult(updated);
137
+ }
138
+ catch (err) {
139
+ return errorResult(err, `Failed to grant risk acceptance for issue '${args.issue_id}'`);
140
+ }
141
+ });
142
+ // 5. Security posture metrics
143
+ server.registerTool("codefy_issues_metrics", {
144
+ title: "Get Security Posture Metrics",
145
+ description: "Get real-time security posture metrics summary: issue counts by severity and lifecycle status, SLA breaches, and top vulnerability categories.",
146
+ inputSchema: {
147
+ repo_id: z.string().optional().describe("Optional repository ID to scope metrics."),
148
+ },
149
+ annotations: {
150
+ readOnlyHint: true,
151
+ destructiveHint: false,
152
+ idempotentHint: true,
153
+ openWorldHint: true,
154
+ },
155
+ }, async (args) => {
156
+ try {
157
+ const metrics = await getMetricsSummary(args.repo_id);
158
+ return jsonResult(metrics);
159
+ }
160
+ catch (err) {
161
+ return errorResult(err, "Failed to retrieve security posture metrics");
162
+ }
163
+ });
164
+ // 6. Delete issue
165
+ server.registerTool("codefy_issues_delete", {
166
+ title: "Delete Canonical Security Issue",
167
+ description: "Permanently delete a canonical security issue and its cascading audit history.",
168
+ inputSchema: {
169
+ issue_id: z.string().min(1).describe("Canonical issue ID to delete."),
170
+ },
171
+ annotations: {
172
+ readOnlyHint: false,
173
+ destructiveHint: true,
174
+ idempotentHint: true,
175
+ openWorldHint: true,
176
+ },
177
+ }, async (args) => {
178
+ try {
179
+ const res = await deleteIssue(args.issue_id);
180
+ return jsonResult({
181
+ issue_id: args.issue_id,
182
+ deleted: true,
183
+ response: res,
184
+ });
185
+ }
186
+ catch (err) {
187
+ return errorResult(err, `Failed to delete issue '${args.issue_id}'`);
188
+ }
189
+ });
190
+ }
191
+ //# sourceMappingURL=issues.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../src/mcp/tools/issues.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,142 @@
1
+ import { z } from "zod";
2
+ import { getConfig } from "../../config/index.js";
3
+ import { getProfile } from "../../services/auth.js";
4
+ import { listAuditEvents, listTools } from "../../services/issues.js";
5
+ import { FAST_DAST_TOOLS, FAST_SAST_TOOLS, errorResult, jsonResult } from "../helpers.js";
6
+ export function registerPlatformTools(server) {
7
+ // 1. List available security scanner tools
8
+ server.registerTool("codefy_list_tools", {
9
+ title: "List Codefy Scanner Engines",
10
+ description: "List integrated security scanner engines (30 DAST + 25 SAST engines) with their IDs, modes, categories, versions, and recommended fast presets.",
11
+ inputSchema: {
12
+ type: z
13
+ .enum(["all", "sast", "dast"])
14
+ .default("all")
15
+ .describe("Filter engines by 'sast', 'dast', or 'all'."),
16
+ },
17
+ annotations: {
18
+ readOnlyHint: true,
19
+ destructiveHint: false,
20
+ idempotentHint: true,
21
+ openWorldHint: true,
22
+ },
23
+ }, async (args) => {
24
+ try {
25
+ const res = await listTools(args.type);
26
+ return jsonResult({
27
+ ...res,
28
+ presets: {
29
+ fast_sast: FAST_SAST_TOOLS,
30
+ fast_dast: FAST_DAST_TOOLS,
31
+ },
32
+ });
33
+ }
34
+ catch (err) {
35
+ return errorResult(err, "Failed to list scanner engines");
36
+ }
37
+ });
38
+ // 2. Security audit trail
39
+ server.registerTool("codefy_audit_events", {
40
+ title: "Query Security Audit Trail",
41
+ description: "Query immutable security audit events across Codefy SAST and/or DAST gateways (scan dispatches, SSRF blocks, token actions, issue transitions).",
42
+ inputSchema: {
43
+ service: z
44
+ .enum(["all", "sast", "dast"])
45
+ .default("all")
46
+ .describe("Which service's audit trail to query ('sast', 'dast', or 'all')."),
47
+ target_id: z.string().optional().describe("Optional filter by target project or repository ID."),
48
+ limit: z.number().int().min(1).max(200).default(50),
49
+ },
50
+ annotations: {
51
+ readOnlyHint: true,
52
+ destructiveHint: false,
53
+ idempotentHint: true,
54
+ openWorldHint: true,
55
+ },
56
+ }, async (args) => {
57
+ try {
58
+ const params = { limit: args.limit };
59
+ if (args.target_id) {
60
+ params.target_id = args.target_id;
61
+ }
62
+ if (args.service === "sast" || args.service === "dast") {
63
+ const res = await listAuditEvents(args.service, params);
64
+ const items = (res.items || []).map((e) => ({ ...e, service: args.service }));
65
+ return jsonResult({ total: res.total ?? items.length, items });
66
+ }
67
+ const [sastRes, dastRes] = await Promise.allSettled([
68
+ listAuditEvents("sast", params),
69
+ listAuditEvents("dast", params),
70
+ ]);
71
+ if (sastRes.status === "rejected" && dastRes.status === "rejected") {
72
+ throw new Error(`SAST audit failed (${String(sastRes.reason)}); DAST audit failed (${String(dastRes.reason)})`);
73
+ }
74
+ const sastEvents = sastRes.status === "fulfilled"
75
+ ? (sastRes.value.items || []).map((e) => ({ ...e, service: "sast" }))
76
+ : [];
77
+ const dastEvents = dastRes.status === "fulfilled"
78
+ ? (dastRes.value.items || []).map((e) => ({ ...e, service: "dast" }))
79
+ : [];
80
+ const combined = [...sastEvents, ...dastEvents]
81
+ .sort((a, b) => new Date(b.timestamp || 0).getTime() - new Date(a.timestamp || 0).getTime())
82
+ .slice(0, args.limit);
83
+ return jsonResult({
84
+ total: combined.length,
85
+ items: combined,
86
+ });
87
+ }
88
+ catch (err) {
89
+ return errorResult(err, "Failed to query security audit events");
90
+ }
91
+ });
92
+ // 3. Read-only authentication & gateway status
93
+ server.registerTool("codefy_auth_status", {
94
+ title: "Check Codefy Authentication Status",
95
+ description: "Inspect the current Codefy authentication mode (authenticated user vs. guest/tester mode), account tier, token expiration, and configured SAST/DAST gateway URLs. Never exposes raw credentials.",
96
+ inputSchema: {},
97
+ annotations: {
98
+ readOnlyHint: true,
99
+ destructiveHint: false,
100
+ idempotentHint: true,
101
+ openWorldHint: true,
102
+ },
103
+ }, async () => {
104
+ try {
105
+ const cfg = getConfig();
106
+ if (!cfg.token) {
107
+ return jsonResult({
108
+ authenticated: false,
109
+ mode: "guest",
110
+ user_id: "tester",
111
+ name: "Guest Tester",
112
+ tier: "free",
113
+ gateways: {
114
+ sast: cfg.sastBaseUrl,
115
+ dast: cfg.dastBaseUrl,
116
+ },
117
+ note: "Guest/tester mode is active (no login required for basic scans). To authenticate with a personal account, set CODEFY_API_TOKEN in MCP env or run 'codefy auth login' in your terminal.",
118
+ });
119
+ }
120
+ const profile = await getProfile();
121
+ return jsonResult({
122
+ authenticated: true,
123
+ mode: "authenticated",
124
+ user_id: profile.user_id,
125
+ name: profile.name,
126
+ email: profile.email,
127
+ tier: profile.tier,
128
+ is_expired: Boolean(profile.isExpired),
129
+ is_offline_verification: Boolean(profile.isOfflineVerification),
130
+ expires_at: profile.exp ? new Date(profile.exp * 1000).toISOString() : undefined,
131
+ gateways: {
132
+ sast: cfg.sastBaseUrl,
133
+ dast: cfg.dastBaseUrl,
134
+ },
135
+ });
136
+ }
137
+ catch (err) {
138
+ return errorResult(err, "Failed to check Codefy auth status");
139
+ }
140
+ });
141
+ }
142
+ //# sourceMappingURL=platform.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"platform.js","sourceRoot":"","sources":["../../../src/mcp/tools/platform.ts"],"names":[],"mappings":"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"}