@securityreviewai/securityreview-kit 0.1.41 → 0.1.43

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/README.md CHANGED
@@ -27,11 +27,11 @@ npx @securityreviewai/securityreview-kit init --switch-project
27
27
 
28
28
  | Target | Flag | MCP Config | Workspace Rule |
29
29
  |---|---|---|---|
30
- | Cursor | `cursor` | `.cursor/mcp.json` | `.cursor/rules/srai-security-review.mdc`, `.cursor/rules/ctm_sync_rule.mdc`, `.cursor/commands/ctm_sync.md`, `.cursor/agents/ctm_sync.md`, `.cursor/commands/create-ide-workflow.md`, `.cursor/commands/srai-profile.md`, `.cursor/skills/threat-modelling/SKILL.md` |
31
- | Claude Code | `claude` | `.mcp.json` | `.claude/CLAUDE.md`, `.claude/settings.json`, `.claude/skills/threat-modelling/SKILL.md`, `.claude/skills/guardrails-profiler/SKILL.md`, `.claude/skills/guardrails-selection/SKILL.md`, `.claude/agents/ctm_sync.md`, `.claude/commands/guardrails-init-profile.md` |
32
- | VS Code Copilot | `vscode` | `.vscode/mcp.json` | `.github/copilot-instructions.md`, `.github/skills/threat-modelling/SKILL.md`, `.github/skills/guardrails-profiler/SKILL.md`, `.github/skills/guardrails-selection/SKILL.md`, `.github/agents/ctm_sync.agent.md`, `.github/hooks/srai-session-policy.json` |
30
+ | Cursor | `cursor` | `.cursor/mcp.json` | `.cursor/rules/srai-security-review.mdc`, `.cursor/rules/guardrails_rule.mdc`, `.cursor/commands/srai-profile.md`, `.cursor/commands/guardrails-init-profile.md`, `.cursor/skills/threat-modelling/SKILL.md`, `.cursor/hooks.json` |
31
+ | Claude Code | `claude` | `.mcp.json` | `.claude/CLAUDE.md`, `.claude/settings.json`, `.claude/skills/threat-modelling/SKILL.md`, `.claude/skills/guardrails-profiler/SKILL.md`, `.claude/skills/guardrails-selection/SKILL.md`, `.claude/commands/guardrails-init-profile.md` |
32
+ | VS Code Copilot | `vscode` | `.vscode/mcp.json` | `.github/copilot-instructions.md`, `.github/skills/threat-modelling/SKILL.md`, `.github/skills/guardrails-profiler/SKILL.md`, `.github/skills/guardrails-selection/SKILL.md`, `.github/hooks/srai-session-policy.json` |
33
33
  | Windsurf | `windsurf` | `.windsurf/mcp_config.json` | `.windsurf/rules/srai-security-review.md` |
34
- | Codex | `codex` | `.codex/config.toml` | `.codex/AGENTS.md`, `.codex/skills/threat-modelling/SKILL.md`, `.codex/skills/guardrails-profiler/SKILL.md`, `.codex/skills/guardrails-selection/SKILL.md`, `.codex/agents/ctm_sync.toml`, `.codex/hooks.json`, `.codex/commands/guardrails-init-profile.md` |
34
+ | Codex | `codex` | `.codex/config.toml` | `.codex/AGENTS.md`, `.codex/skills/threat-modelling/SKILL.md`, `.codex/skills/guardrails-profiler/SKILL.md`, `.codex/skills/guardrails-selection/SKILL.md`, `.codex/hooks.json`, `.codex/commands/guardrails-init-profile.md` |
35
35
  | Gemini CLI | `gemini` | `.gemini/settings.json` | `GEMINI.md` |
36
36
  | Antigravity | `antigravity` | `.gemini/settings.json` | `.agents/rules/srai-security-review.md` |
37
37
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@securityreviewai/securityreview-kit",
3
- "version": "0.1.41",
3
+ "version": "0.1.43",
4
4
  "description": "Bootstrap security-review-mcp for AI IDEs and CLI tools",
5
5
  "author": "Debarshi Das <debarshi.das@we45.com>",
6
6
  "license": "UNLICENSED",
@@ -10,9 +10,9 @@ function getClaudeSessionStartHooks() {
10
10
  '1. Fetch Vibe Guardrails first using .claude/skills/guardrails-selection/SKILL.md.',
11
11
  '2. Run PWNISMS threat modelling using .claude/skills/threat-modelling/SKILL.md.',
12
12
  '3. Implement secure code using the hydrated guardrails and threat findings.',
13
- '4. Invoke the ctm_sync agent using .claude/agents/ctm_sync.md after implementation or threat-model updates.',
13
+ '4. Write a structured .md artifact under vibereview/, validate it, and call sync_ai_ide_markdown directly after implementation or threat-model updates.',
14
14
  '',
15
- 'Do not use project-profile exploration tools during normal coding tasks. No blocking and no deferral: guardrails first, PWNISMS second, implementation third, ctm_sync last.',
15
+ 'Do not use project-profile exploration tools during normal coding tasks. No blocking and no deferral: guardrails first, PWNISMS second, implementation third, VibeReview sync last.',
16
16
  ].join('\n');
17
17
 
18
18
  return [
@@ -19,6 +19,8 @@ test('Claude MCP generator writes .mcp.json, enables the project MCP server, and
19
19
  assert.deepEqual(settings.enabledMcpjsonServers, ['security-review-mcp']);
20
20
  assert.equal(Array.isArray(settings.SessionStart), true);
21
21
  assert.match(settings.SessionStart[0].hooks[0].prompt, /MANDATORY SECURITY GATE/);
22
+ assert.match(settings.SessionStart[0].hooks[0].prompt, /vibereview\//);
23
+ assert.match(settings.SessionStart[0].hooks[0].prompt, /sync_ai_ide_markdown/);
22
24
  });
23
25
 
24
26
  test('Claude MCP generator preserves existing SessionStart hooks', () => {
@@ -1,7 +1,6 @@
1
1
  import { existsSync, unlinkSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
3
  import {
4
- CTM_SYNC_AGENT_REL_PATH,
5
4
  GUARDRAILS_PROFILER_SKILL_REL_DIR,
6
5
  GUARDRAILS_SELECTION_SKILL_REL_DIR,
7
6
  SENTINEL_END,
@@ -10,7 +9,6 @@ import {
10
9
  } from '../../utils/constants.js';
11
10
  import { readText, upsertSentinelBlock, writeText } from '../../utils/fs-helpers.js';
12
11
  import {
13
- getCtmSyncWorkflowContent,
14
12
  getGuardrailsInitProfileContent,
15
13
  getRuleContent,
16
14
  getThreatModellingSkillContent,
@@ -22,25 +20,6 @@ function writeGeneratedText(filePath, content) {
22
20
  return { filePath, action };
23
21
  }
24
22
 
25
- function getAgentBody(content) {
26
- return content.replace(/^---\n[\s\S]*?\n---\n*/, '').trim();
27
- }
28
-
29
- function getClaudeCtmSyncAgentContent(options = {}) {
30
- const body = getAgentBody(getCtmSyncWorkflowContent(options));
31
- return [
32
- '---',
33
- 'name: ctm_sync',
34
- 'description: Use this agent after security-relevant implementation or threat modelling work to synchronize the latest threat model, mitigations, and guardrails to SRAI.',
35
- 'model: inherit',
36
- 'color: blue',
37
- '---',
38
- '',
39
- body,
40
- '',
41
- ].join('\n');
42
- }
43
-
44
23
  /**
45
24
  * Generate Claude Code workspace rule — appends to .claude/CLAUDE.md
46
25
  */
@@ -49,7 +28,6 @@ export function generate(cwd, options = {}) {
49
28
  ...options,
50
29
  guardrailsSelectionSkillDir: GUARDRAILS_SELECTION_SKILL_REL_DIR.claude,
51
30
  threatModellingSkillDir: THREAT_MODELLING_SKILL_REL_DIR.claude,
52
- ctmSyncAgentPath: CTM_SYNC_AGENT_REL_PATH.claude,
53
31
  };
54
32
  const legacyRootPath = join(cwd, 'CLAUDE.md');
55
33
  const filePath = join(cwd, '.claude', 'CLAUDE.md');
@@ -76,11 +54,10 @@ export function generate(cwd, options = {}) {
76
54
  getThreatModellingSkillContent(optionsWithSkillDirs),
77
55
  );
78
56
 
79
- const ctmSyncAgentPath = join(cwd, CTM_SYNC_AGENT_REL_PATH.claude);
80
- const ctmSyncAgent = writeGeneratedText(
81
- ctmSyncAgentPath,
82
- getClaudeCtmSyncAgentContent(optionsWithSkillDirs),
83
- );
57
+ const deletedLegacyAgentPath = join(cwd, '.claude', 'agents', 'ctm_sync.md');
58
+ const deletedLegacyAgent = existsSync(deletedLegacyAgentPath)
59
+ ? (unlinkSync(deletedLegacyAgentPath), { filePath: deletedLegacyAgentPath, action: 'deleted' })
60
+ : null;
84
61
 
85
62
  const guardrailsInitPath = join(cwd, '.claude', 'commands', 'guardrails-init-profile.md');
86
63
  const guardrailsInit = writeGeneratedText(
@@ -94,7 +71,7 @@ export function generate(cwd, options = {}) {
94
71
  return [
95
72
  { filePath, action, kind: 'rule' },
96
73
  { ...threatSkill, kind: 'skill' },
97
- { ...ctmSyncAgent, kind: 'agent' },
98
74
  { ...guardrailsInit, kind: 'command' },
75
+ ...(deletedLegacyAgent ? [{ ...deletedLegacyAgent, kind: 'cleanup' }] : []),
99
76
  ];
100
77
  }
@@ -5,7 +5,7 @@ import { test } from 'node:test';
5
5
  import assert from 'node:assert/strict';
6
6
  import { generate } from './claude.js';
7
7
 
8
- test('Claude generator writes .claude/CLAUDE.md, threat skill, ctm_sync agent, and profiling command', () => {
8
+ test('Claude generator writes .claude/CLAUDE.md, threat skill, and profiling command', () => {
9
9
  const cwd = mkdtempSync(join(tmpdir(), 'securityreview-kit-claude-'));
10
10
 
11
11
  const results = generate(cwd, { projectName: 'SmokeProject' });
@@ -13,7 +13,6 @@ test('Claude generator writes .claude/CLAUDE.md, threat skill, ctm_sync agent, a
13
13
  const expectedPaths = [
14
14
  '.claude/CLAUDE.md',
15
15
  '.claude/skills/threat-modelling/SKILL.md',
16
- '.claude/agents/ctm_sync.md',
17
16
  '.claude/commands/guardrails-init-profile.md',
18
17
  ];
19
18
 
@@ -21,21 +20,18 @@ test('Claude generator writes .claude/CLAUDE.md, threat skill, ctm_sync agent, a
21
20
  assert.equal(existsSync(join(cwd, relPath)), true, `${relPath} should exist`);
22
21
  }
23
22
 
24
- assert.deepEqual(results.map((entry) => entry.kind), ['rule', 'skill', 'agent', 'command']);
23
+ assert.deepEqual(results.map((entry) => entry.kind), ['rule', 'skill', 'command']);
25
24
 
26
25
  const instructions = readFileSync(join(cwd, '.claude/CLAUDE.md'), 'utf8');
27
26
  assert.match(instructions, /\.claude\/skills\/guardrails-selection\/SKILL\.md/);
28
27
  assert.match(instructions, /\.claude\/skills\/threat-modelling\/SKILL\.md/);
29
- assert.match(instructions, /\.claude\/agents\/ctm_sync\.md/);
28
+ assert.match(instructions, /sync_ai_ide_markdown/);
29
+ assert.match(instructions, /vibereview\//);
30
30
 
31
31
  const threatSkill = readFileSync(join(cwd, '.claude/skills/threat-modelling/SKILL.md'), 'utf8');
32
- assert.match(threatSkill, /\.claude\/agents\/ctm_sync\.md/);
32
+ assert.match(threatSkill, /sync_ai_ide_markdown/);
33
+ assert.match(threatSkill, /vibereview\//);
33
34
  assert.doesNotMatch(threatSkill, /get_project_profile_description/);
34
-
35
- const agent = readFileSync(join(cwd, '.claude/agents/ctm_sync.md'), 'utf8');
36
- assert.match(agent, /^---\nname: ctm_sync/m);
37
- assert.match(agent, /model: inherit/);
38
- assert.match(agent, /Configured SRAI project name: `SmokeProject`/);
39
35
  });
40
36
 
41
37
  test('Claude generator migrates the kit-managed root CLAUDE.md block into .claude/CLAUDE.md', () => {
@@ -1,14 +1,12 @@
1
- import { existsSync } from 'node:fs';
1
+ import { existsSync, unlinkSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
3
  import {
4
- CTM_SYNC_AGENT_REL_PATH,
5
4
  GUARDRAILS_PROFILER_SKILL_REL_DIR,
6
5
  GUARDRAILS_SELECTION_SKILL_REL_DIR,
7
6
  THREAT_MODELLING_SKILL_REL_DIR,
8
7
  } from '../../utils/constants.js';
9
8
  import { upsertSentinelBlock, writeText } from '../../utils/fs-helpers.js';
10
9
  import {
11
- getCtmSyncWorkflowContent,
12
10
  getGuardrailsInitProfileContent,
13
11
  getRuleContent,
14
12
  getThreatModellingSkillContent,
@@ -20,6 +18,14 @@ function writeGeneratedText(filePath, content) {
20
18
  return { filePath, action };
21
19
  }
22
20
 
21
+ function removeGeneratedText(filePath) {
22
+ if (existsSync(filePath)) {
23
+ unlinkSync(filePath);
24
+ return { filePath, action: 'deleted' };
25
+ }
26
+ return null;
27
+ }
28
+
23
29
  function getCodexSessionHookContent() {
24
30
  const additionalContext = [
25
31
  '## MANDATORY SECURITY GATE (Session Policy)',
@@ -29,9 +35,9 @@ function getCodexSessionHookContent() {
29
35
  '1. Fetch Vibe Guardrails first using .codex/skills/guardrails-selection/SKILL.md. Resolve the project, call get_guardrails, shortlist relevant guardrails, then call get_guardrail_by_id for the shortlist.',
30
36
  '2. Run PWNISMS threat modelling using .codex/skills/threat-modelling/SKILL.md. Explicitly walk Product, Workload, Network, IAM, Secrets, Monitoring, and Supply Chain.',
31
37
  '3. Implement secure code using both the hydrated guardrails and PWNISMS findings.',
32
- '4. Invoke the ctm_sync subagent using .codex/agents/ctm_sync.toml after threat modelling or guardrail enforcement. Reuse the exact guardrail shortlist; do not re-query guardrails during CTM sync.',
38
+ '4. Write a structured .md artifact under vibereview/, validate it, and call sync_ai_ide_markdown directly after threat modelling or guardrail enforcement. Reuse the exact guardrail shortlist; do not re-query guardrails during the final sync.',
33
39
  '',
34
- 'Do not use project-profile exploration tools during normal coding tasks. No blocking and no deferral: guardrails first, PWNISMS second, implementation third, ctm_sync last.',
40
+ 'Do not use project-profile exploration tools during normal coding tasks. No blocking and no deferral: guardrails first, PWNISMS second, implementation third, VibeReview sync last.',
35
41
  ].join('\n');
36
42
 
37
43
  const sessionStartPayload = JSON.stringify({
@@ -82,22 +88,6 @@ function getCodexSessionHookContent() {
82
88
  ) + '\n';
83
89
  }
84
90
 
85
- function getAgentBody(content) {
86
- return content.replace(/^---\n[\s\S]*?\n---\n*/, '').trim();
87
- }
88
-
89
- function getCodexCtmSyncAgentContent(options = {}) {
90
- const developerInstructions = getAgentBody(getCtmSyncWorkflowContent(options));
91
- return [
92
- 'name = "ctm_sync"',
93
- 'description = "Synchronize threat-model and guardrail data to SRAI after security-relevant work."',
94
- "developer_instructions = '''",
95
- developerInstructions,
96
- "'''",
97
- '',
98
- ].join('\n');
99
- }
100
-
101
91
  /**
102
92
  * Generate Codex workspace rule — appends to AGENTS.md
103
93
  */
@@ -106,7 +96,6 @@ export function generate(cwd, options = {}) {
106
96
  ...options,
107
97
  guardrailsSelectionSkillDir: GUARDRAILS_SELECTION_SKILL_REL_DIR.codex,
108
98
  threatModellingSkillDir: THREAT_MODELLING_SKILL_REL_DIR.codex,
109
- ctmSyncAgentPath: CTM_SYNC_AGENT_REL_PATH.codex,
110
99
  };
111
100
  const filePath = join(cwd, '.codex', 'AGENTS.md');
112
101
  const content = getRuleContent(optionsWithSkillDirs);
@@ -118,11 +107,7 @@ export function generate(cwd, options = {}) {
118
107
  getThreatModellingSkillContent(optionsWithSkillDirs),
119
108
  );
120
109
 
121
- const ctmSyncAgentPath = join(cwd, CTM_SYNC_AGENT_REL_PATH.codex);
122
- const ctmSyncAgent = writeGeneratedText(
123
- ctmSyncAgentPath,
124
- getCodexCtmSyncAgentContent(optionsWithSkillDirs),
125
- );
110
+ const deletedLegacyAgent = removeGeneratedText(join(cwd, '.codex', 'agents', 'ctm_sync.toml'));
126
111
 
127
112
  const hooksPath = join(cwd, '.codex', 'hooks.json');
128
113
  const hooks = writeGeneratedText(hooksPath, getCodexSessionHookContent());
@@ -139,8 +124,8 @@ export function generate(cwd, options = {}) {
139
124
  return [
140
125
  { filePath, action, kind: 'rule' },
141
126
  { ...threatSkill, kind: 'skill' },
142
- { ...ctmSyncAgent, kind: 'agent' },
143
127
  { ...hooks, kind: 'hooks' },
144
128
  { ...guardrailsInit, kind: 'command' },
129
+ ...(deletedLegacyAgent ? [{ ...deletedLegacyAgent, kind: 'cleanup' }] : []),
145
130
  ];
146
131
  }
@@ -5,7 +5,7 @@ import { test } from 'node:test';
5
5
  import assert from 'node:assert/strict';
6
6
  import { generate } from './codex.js';
7
7
 
8
- test('Codex generator writes AGENTS, skills, subagent, hooks, and profiling command', () => {
8
+ test('Codex generator writes AGENTS, skills, hooks, and profiling command', () => {
9
9
  const cwd = mkdtempSync(join(tmpdir(), 'securityreview-kit-codex-'));
10
10
 
11
11
  const results = generate(cwd, { projectName: 'SmokeProject' });
@@ -13,7 +13,6 @@ test('Codex generator writes AGENTS, skills, subagent, hooks, and profiling comm
13
13
  const expectedPaths = [
14
14
  '.codex/AGENTS.md',
15
15
  '.codex/skills/threat-modelling/SKILL.md',
16
- '.codex/agents/ctm_sync.toml',
17
16
  '.codex/hooks.json',
18
17
  '.codex/commands/guardrails-init-profile.md',
19
18
  ];
@@ -22,12 +21,13 @@ test('Codex generator writes AGENTS, skills, subagent, hooks, and profiling comm
22
21
  assert.equal(existsSync(join(cwd, relPath)), true, `${relPath} should exist`);
23
22
  }
24
23
 
25
- assert.deepEqual(results.map((entry) => entry.kind), ['rule', 'skill', 'agent', 'hooks', 'command']);
24
+ assert.deepEqual(results.map((entry) => entry.kind), ['rule', 'skill', 'hooks', 'command']);
26
25
 
27
26
  const instructions = readFileSync(join(cwd, '.codex/AGENTS.md'), 'utf8');
28
27
  assert.match(instructions, /\.codex\/skills\/guardrails-selection\/SKILL\.md/);
29
28
  assert.match(instructions, /\.codex\/skills\/threat-modelling\/SKILL\.md/);
30
- assert.match(instructions, /\.codex\/agents\/ctm_sync\.toml/);
29
+ assert.match(instructions, /sync_ai_ide_markdown/);
30
+ assert.match(instructions, /vibereview\//);
31
31
  assert.doesNotMatch(instructions, /\.cursor/);
32
32
  assert.doesNotMatch(instructions, /\.agents\/skills/);
33
33
 
@@ -35,16 +35,14 @@ test('Codex generator writes AGENTS, skills, subagent, hooks, and profiling comm
35
35
  for (const heading of ['Product', 'Workload', 'Network', 'IAM', 'Secrets', 'Monitoring', 'Supply Chain']) {
36
36
  assert.match(threatSkill, new RegExp(heading));
37
37
  }
38
- assert.match(threatSkill, /\.codex\/agents\/ctm_sync\.toml/);
38
+ assert.match(threatSkill, /sync_ai_ide_markdown/);
39
+ assert.match(threatSkill, /vibereview\//);
39
40
  assert.doesNotMatch(threatSkill, /get_project_profile_description/);
40
41
 
41
- const agent = readFileSync(join(cwd, '.codex/agents/ctm_sync.toml'), 'utf8');
42
- assert.match(agent, /name = "ctm_sync"/);
43
- assert.match(agent, /developer_instructions = '''/);
44
- assert.match(agent, /Configured SRAI project name: `SmokeProject`/);
45
-
46
42
  const hooks = JSON.parse(readFileSync(join(cwd, '.codex/hooks.json'), 'utf8'));
47
43
  assert.equal(hooks.hooks.SessionStart[0].hooks[0].type, 'command');
48
44
  assert.equal(hooks.hooks.UserPromptSubmit[0].hooks[0].type, 'command');
49
45
  assert.match(hooks.hooks.UserPromptSubmit[0].hooks[0].command, /"hookEventName":"UserPromptSubmit"/);
46
+ assert.match(hooks.hooks.UserPromptSubmit[0].hooks[0].command, /vibereview/);
47
+ assert.match(hooks.hooks.UserPromptSubmit[0].hooks[0].command, /sync_ai_ide_markdown/);
50
48
  });
@@ -50,12 +50,6 @@ function readTemplate(templateFileName, options = {}) {
50
50
  '.cursor/skills/threat-modelling',
51
51
  options.threatModellingSkillDir,
52
52
  );
53
- out = injectPathPlaceholder(
54
- out,
55
- '{{CTM_SYNC_AGENT_PATH}}',
56
- '.cursor/agents/ctm_sync.md',
57
- options.ctmSyncAgentPath,
58
- );
59
53
 
60
54
  return out;
61
55
  }
@@ -74,27 +68,6 @@ export function getProfileCommandContent(options = {}) {
74
68
  return readTemplate('srai-profile.md', options);
75
69
  }
76
70
 
77
- /**
78
- * Returns the CTM sync workflow content markdown.
79
- */
80
- export function getCtmSyncWorkflowContent(options = {}) {
81
- return readTemplate('ctm_sync.md', options);
82
- }
83
-
84
- /**
85
- * Returns the Cursor CTM sync trigger rule markdown.
86
- */
87
- export function getCtmSyncTriggerRuleContent(options = {}) {
88
- return readTemplate('ctm_sync_rule.md', options);
89
- }
90
-
91
- /**
92
- * Returns the Cursor create-ide-workflow command markdown.
93
- */
94
- export function getCreateIdeWorkflowCommandContent(options = {}) {
95
- return readTemplate('create-ide-workflow.md', options);
96
- }
97
-
98
71
  /**
99
72
  * Returns the threat-modelling skill markdown.
100
73
  */
@@ -12,7 +12,7 @@ For any task that touches auth, authorization, input handling, secrets, network,
12
12
  - Read and follow `{{GUARDRAILS_SELECTION_SKILL_DIR}}/SKILL.md`.
13
13
  - Resolve the SRAI project with `find_project_by_name` using `name="<SRAI_PROJECT_NAME>"`.
14
14
  - Call `get_guardrails`, shortlist only the relevant project guardrails, then hydrate the exact shortlist with `get_guardrail_by_id`.
15
- - Preserve that exact shortlist in context for implementation and CTM sync.
15
+ - Preserve that exact shortlist in context for implementation and the final VibeReview sync step.
16
16
 
17
17
  2. **Run PWNISMS threat modelling before implementation.**
18
18
  - Read and follow `{{THREAT_MODELLING_SKILL_DIR}}/SKILL.md`.
@@ -26,11 +26,16 @@ For any task that touches auth, authorization, input handling, secrets, network,
26
26
  - Use the PWNISMS findings to guide design, validation, authorization, logging, secrets handling, dependency choices, and abuse controls.
27
27
  - If PWNISMS reveals a recurring security rule that is not covered by existing guardrails, create and apply an `ide_generated` guardrail in context.
28
28
 
29
- 4. **Run CTM sync last.**
30
- - After threat modelling is created or updated, or after guardrails are enforced during implementation, invoke the `ctm_sync` agent/workflow.
31
- - Use `{{CTM_SYNC_AGENT_PATH}}` for the detailed payload contract.
32
- - Pass the current threat model summary, the stable `chat_session_id`, the exact existing guardrails shortlisted earlier, and any `ide_generated` guardrails.
33
- - Do not re-query guardrails during CTM sync; reuse the shortlist selected before implementation.
29
+ 4. **Write and sync the VibeReview markdown last.**
30
+ - After threat modelling is created or updated, or after guardrails are enforced during implementation, the main agent must write or update a structured `.md` artifact under `vibereview/`.
31
+ - Do not delegate markdown authoring to a subagent. The same agent that performed the work should author the artifact so the context stays intact.
32
+ - Use a stable path such as `vibereview/<chat_session_id>-<slugified-title-or-event-name>.md`.
33
+ - Required frontmatter: `chat_session_id`, `summary`, and either `title` or `event_name`. Optional frontmatter: `workflow_name`, `workflow_description`.
34
+ - Required sections: `Best Practices Achieved`, `Threats Mitigated`, `Secure Code Snippets`, `Guardrails Applied`, and `OWASP Top 10 2025 Mappings`.
35
+ - Reuse the exact existing guardrails shortlisted earlier, include any `ide_generated` guardrails, and only include grounded code snippets from actual code.
36
+ - Validate the markdown before sync: do not leave out `chat_session_id`, `summary`, threat metadata, guardrail satisfaction, or exact OWASP IDs/names.
37
+ - Call `sync_ai_ide_markdown` directly with the finished markdown artifact before finalizing the task.
38
+ - If sync fails, keep the file in `vibereview/`, report the failure, and do not pretend synchronization succeeded.
34
39
 
35
40
  ## When To Skip
36
41
 
@@ -42,7 +47,7 @@ If in doubt, run the workflow. A quick PWNISMS pass is better than silently miss
42
47
 
43
48
  Do not call project-profile exploration tools during normal coding tasks. The old profile walkthrough is no longer part of the agent workflow.
44
49
 
45
- The normal coding workflow is guardrails selection, PWNISMS threat modelling, secure implementation, then CTM sync.
50
+ The normal coding workflow is guardrails selection, PWNISMS threat modelling, secure implementation, then VibeReview markdown sync.
46
51
 
47
52
  ## Tool Reference
48
53
 
@@ -50,5 +55,5 @@ The normal coding workflow is guardrails selection, PWNISMS threat modelling, se
50
55
  |---|---|
51
56
  | Project resolution | `find_project_by_name`, `list_projects`, `create_project`, `get_project` |
52
57
  | Guardrails | `get_guardrails`, `get_guardrail_by_id` |
53
- | CTM sync | `create_ai_ide_workflow`, `create_ai_ide_event`, `get_current_user` or equivalent user identity tool |
58
+ | VibeReview sync | `sync_ai_ide_markdown` |
54
59
  | Profiler only | `update_vibe_profile`, `write_default_pack` are used by init-time profiling, not normal coding tasks |
@@ -1,9 +1,8 @@
1
- import { existsSync } from 'node:fs';
1
+ import { existsSync, unlinkSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
3
  import {
4
4
  GUARDRAILS_PROFILER_SKILL_REL_DIR,
5
5
  GUARDRAILS_SELECTION_SKILL_REL_DIR,
6
- CTM_SYNC_AGENT_REL_PATH,
7
6
  MCP_SERVER_NAME,
8
7
  THREAT_MODELLING_SKILL_REL_DIR,
9
8
  } from '../../utils/constants.js';
@@ -11,9 +10,6 @@ import { readJson, writeJson, writeText } from '../../utils/fs-helpers.js';
11
10
  import {
12
11
  getRuleContent,
13
12
  getProfileCommandContent,
14
- getCtmSyncWorkflowContent,
15
- getCtmSyncTriggerRuleContent,
16
- getCreateIdeWorkflowCommandContent,
17
13
  getThreatModellingSkillContent,
18
14
  getGuardrailsRuleContent,
19
15
  getGuardrailsInitProfileContent,
@@ -40,6 +36,14 @@ function writeCursorCommand(filePath, content) {
40
36
  return { filePath, action };
41
37
  }
42
38
 
39
+ function removeGeneratedText(filePath) {
40
+ if (existsSync(filePath)) {
41
+ unlinkSync(filePath);
42
+ return { filePath, action: 'deleted' };
43
+ }
44
+ return null;
45
+ }
46
+
43
47
  /**
44
48
  * Merge `.cursor/cli.json` so Cursor CLI / Agent auto-allows security-review-mcp tools (no MCP approval prompts).
45
49
  * @see https://cursor.com/docs/cli/reference/permissions
@@ -77,24 +81,16 @@ export function generate(cwd, options = {}) {
77
81
  ...options,
78
82
  guardrailsSelectionSkillDir: GUARDRAILS_SELECTION_SKILL_REL_DIR.cursor,
79
83
  threatModellingSkillDir: THREAT_MODELLING_SKILL_REL_DIR.cursor,
80
- ctmSyncAgentPath: CTM_SYNC_AGENT_REL_PATH.cursor,
81
84
  };
82
85
  const baseRulePath = join(cwd, '.cursor', 'rules', 'srai-security-review.mdc');
83
- const ctmSyncTriggerRulePath = join(cwd, '.cursor', 'rules', 'ctm_sync_rule.mdc');
84
86
  const guardrailsRulePath = join(cwd, '.cursor', 'rules', 'guardrails_rule.mdc');
85
- const ctmSyncWorkflowPath = join(cwd, '.cursor', 'commands', 'ctm_sync.md');
86
- const ctmSyncAgentPath = join(cwd, '.cursor', 'agents', 'ctm_sync.md');
87
- const createIdeWorkflowCommandPath = join(cwd, '.cursor', 'commands', 'create-ide-workflow.md');
88
87
  const profileCommandPath = join(cwd, '.cursor', 'commands', 'srai-profile.md');
89
88
  const guardrailsInitProfileCommandPath = join(cwd, '.cursor', 'commands', 'guardrails-init-profile.md');
90
89
  const skillPath = join(cwd, '.cursor', 'skills', 'threat-modelling', 'SKILL.md');
91
90
  const hooksPath = join(cwd, '.cursor', 'hooks.json');
92
91
 
93
92
  const baseRuleContent = getRuleContent(optionsWithSkillDirs);
94
- const ctmSyncTriggerRuleContent = getCtmSyncTriggerRuleContent(optionsWithSkillDirs);
95
93
  const guardrailsRuleContent = getGuardrailsRuleContent(optionsWithSkillDirs);
96
- const ctmSyncWorkflowContent = getCtmSyncWorkflowContent(optionsWithSkillDirs);
97
- const createIdeWorkflowCommandContent = getCreateIdeWorkflowCommandContent(optionsWithSkillDirs);
98
94
  const profileCommandContent = getProfileCommandContent(optionsWithSkillDirs);
99
95
  const guardrailsInitProfileCommandContent = getGuardrailsInitProfileContent({
100
96
  ...optionsWithSkillDirs,
@@ -108,15 +104,17 @@ export function generate(cwd, options = {}) {
108
104
  baseRuleContent,
109
105
  );
110
106
 
111
- const ctmSyncTriggerRule = writeCursorCommand(ctmSyncTriggerRulePath, ctmSyncTriggerRuleContent);
112
107
  const guardrailsRule = writeCursorRule(
113
108
  guardrailsRulePath,
114
109
  'Vibe Guardrails — fetch and enforce project-specific secure coding guardrails from SRAI',
115
110
  guardrailsRuleContent,
116
111
  );
117
- const ctmSyncWorkflow = writeCursorCommand(ctmSyncWorkflowPath, ctmSyncWorkflowContent);
118
- const ctmSyncAgent = writeCursorCommand(ctmSyncAgentPath, ctmSyncWorkflowContent);
119
- const createIdeWorkflowCommand = writeCursorCommand(createIdeWorkflowCommandPath, createIdeWorkflowCommandContent);
112
+ const deletedLegacyRule = removeGeneratedText(join(cwd, '.cursor', 'rules', 'ctm_sync_rule.mdc'));
113
+ const deletedLegacyCommand = removeGeneratedText(join(cwd, '.cursor', 'commands', 'ctm_sync.md'));
114
+ const deletedLegacyAgent = removeGeneratedText(join(cwd, '.cursor', 'agents', 'ctm_sync.md'));
115
+ const deletedLegacyWorkflowCommand = removeGeneratedText(
116
+ join(cwd, '.cursor', 'commands', 'create-ide-workflow.md'),
117
+ );
120
118
 
121
119
  const profileCommand = writeCursorCommand(profileCommandPath, profileCommandContent);
122
120
  const guardrailsInitProfileCommand = writeCursorCommand(
@@ -134,15 +132,15 @@ export function generate(cwd, options = {}) {
134
132
 
135
133
  return [
136
134
  { ...baseRule, kind: 'rule' },
137
- { ...ctmSyncTriggerRule, kind: 'rule' },
138
135
  { ...guardrailsRule, kind: 'rule' },
139
- { ...ctmSyncWorkflow, kind: 'command' },
140
- { ...ctmSyncAgent, kind: 'agent' },
141
- { ...createIdeWorkflowCommand, kind: 'command' },
142
136
  { ...profileCommand, kind: 'command' },
143
137
  { ...guardrailsInitProfileCommand, kind: 'command' },
144
138
  { filePath: skillPath, action: skillAction, kind: 'skill' },
145
139
  { filePath: hooksPath, action: hooksAction, kind: 'hooks' },
146
140
  { ...cliPermissions, kind: 'config' },
141
+ ...(deletedLegacyRule ? [{ ...deletedLegacyRule, kind: 'cleanup' }] : []),
142
+ ...(deletedLegacyCommand ? [{ ...deletedLegacyCommand, kind: 'cleanup' }] : []),
143
+ ...(deletedLegacyAgent ? [{ ...deletedLegacyAgent, kind: 'cleanup' }] : []),
144
+ ...(deletedLegacyWorkflowCommand ? [{ ...deletedLegacyWorkflowCommand, kind: 'cleanup' }] : []),
147
145
  ];
148
146
  }
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: guardrails-selection
3
- description: Analyze the developer request, infer the security categories and likely threats involved, shortlist the most relevant project guardrails, then hydrate the exact guardrails with get_guardrail_by_id before implementation. Use for every security-relevant code task before code is written and preserve the shortlist for CTM sync.
3
+ description: Analyze the developer request, infer the security categories and likely threats involved, shortlist the most relevant project guardrails, then hydrate the exact guardrails with get_guardrail_by_id before implementation. Use for every security-relevant code task before code is written and preserve the shortlist for the final VibeReview sync.
4
4
  ---
5
5
 
6
6
  # Guardrails Selection
@@ -16,7 +16,7 @@ This skill exists to stop the IDE from treating the full `get_guardrails` result
16
16
  3. Predict the threats that might occur for this exact task.
17
17
  4. Shortlist only the guardrails that mitigate those threats.
18
18
  5. Fetch the exact shortlisted guardrails with `get_guardrail_by_id`.
19
- 6. Carry that same shortlist forward into implementation and `ctm_sync`.
19
+ 6. Carry that same shortlist forward into implementation and the final VibeReview markdown sync.
20
20
 
21
21
  Do not skip the analysis step. Do not rely on title-matching alone. Do not dump every guardrail into the final answer.
22
22
 
@@ -160,11 +160,11 @@ Once the shortlist is hydrated:
160
160
 
161
161
  When deciding whether a guardrail applies, prefer security-preserving inclusion over risky omission. If it plausibly mitigates a realistic path to abuse for the current task, keep it in scope.
162
162
 
163
- ## CTM Sync Handoff Contract
163
+ ## VibeReview Sync Contract
164
164
 
165
- `ctm_sync` must reuse the shortlist from this skill. It must not call `get_guardrails` or `get_guardrail_by_id` again.
165
+ The final sync step must reuse the shortlist from this skill. It must not call `get_guardrails` or `get_guardrail_by_id` again.
166
166
 
167
- Before `ctm_sync` is invoked, ensure the parent context clearly contains:
167
+ Before `sync_ai_ide_markdown` is called, ensure the main agent context clearly contains:
168
168
 
169
169
  - the exact existing guardrails shortlisted earlier
170
170
  - which of them were applied
@@ -182,6 +182,6 @@ A good selection does all of the following:
182
182
  - captures adjacent controls that stop bypass chains
183
183
  - avoids irrelevant noise
184
184
  - produces a small, defensible set of guardrails that can actually guide implementation
185
- - leaves `ctm_sync` with an exact list of what the IDE selected and enforced
185
+ - leaves the final VibeReview markdown with an exact list of what the IDE selected and enforced
186
186
 
187
187
  If your shortlist feels generic, it is probably incomplete or over-broad. Re-check the prompt, the code patterns, and the threat map.
@@ -229,4 +229,4 @@ Likely threat families:
229
229
  - Shortlist for exploit chains, not isolated weaknesses.
230
230
  - Logging often matters because poor auditability can turn spoofing, tampering, or privilege abuse into repudiation.
231
231
  - Client-side logic often needs server-side guardrails even if the visible change is in the UI.
232
- - If no existing guardrail covers a realistic recurring threat, create an `ide_generated` guardrail and carry it into `ctm_sync`.
232
+ - If no existing guardrail covers a realistic recurring threat, create an `ide_generated` guardrail and carry it into the final VibeReview markdown sync.
@@ -34,7 +34,7 @@ That skill is mandatory because the IDE must not leave guardrail selection to ch
34
34
  - **Load the broad catalog** — call `get_guardrails` with `project_id`.
35
35
  - **Shortlist intentionally** — choose only the guardrails that mitigate the categories and likely threats for the current task.
36
36
  - **Hydrate the exact shortlist** — call `get_guardrail_by_id` for the shortlisted guardrail ids so implementation uses the exact selected guardrails, not a vague reading of the full catalog.
37
- - **Preserve the shortlist** — keep the selected existing guardrails in context so `ctm_sync` can include the same guardrails later without re-querying.
37
+ - **Preserve the shortlist** — keep the selected existing guardrails in context so the final VibeReview markdown can include the same guardrails later without re-querying.
38
38
 
39
39
  The broad `get_guardrails` result is only the candidate catalog. The active implementation guardrails must come from the shortlisted `get_guardrail_by_id` result.
40
40
 
@@ -63,7 +63,7 @@ Guardrails and PWNISMS are complementary:
63
63
 
64
64
  - Guardrails provide **project-specific, concrete rules** derived from prior threat reviews, compliance requirements, and team decisions.
65
65
  - PWNISMS provides **universal threat-category coverage** to catch gaps that guardrails may not yet cover.
66
- - When PWNISMS analysis reveals a gap not covered by any existing guardrail, **create a new guardrail on the fly** and apply it immediately (marked `source: "ide_generated"` in CTM sync).
66
+ - When PWNISMS analysis reveals a gap not covered by any existing guardrail, **create a new guardrail on the fly** and apply it immediately (marked `source: "ide_generated"` in the VibeReview markdown).
67
67
 
68
68
  ### 4. Report guardrail compliance
69
69
 
@@ -71,7 +71,7 @@ After code generation, include a brief guardrails compliance summary:
71
71
 
72
72
  - List which guardrails were applied (by title), distinguishing existing vs IDE-generated.
73
73
  - Flag any guardrails that could not be fully satisfied and explain why.
74
- - Do not drop shortlisted existing guardrails from session context. `ctm_sync` must receive the same shortlist, including any unsatisfied items with notes.
74
+ - Do not drop shortlisted existing guardrails from session context. The final VibeReview markdown must include the same shortlist, including any unsatisfied items with notes.
75
75
 
76
76
  ---
77
77
 
@@ -79,9 +79,9 @@ After code generation, include a brief guardrails compliance summary:
79
79
 
80
80
  Guardrails are living artifacts. The IDE agent can create, apply, and update them:
81
81
 
82
- - **New guardrail**: When threat modeling or code review reveals a recurring security pattern not yet captured, the IDE agent creates and applies a new guardrail on the fly. These are reported to SRAI via CTM sync with `source: "ide_generated"`.
82
+ - **New guardrail**: When threat modeling or code review reveals a recurring security pattern not yet captured, the IDE agent creates and applies a new guardrail on the fly. These are reported to SRAI in the final VibeReview markdown with `source: "ide_generated"`.
83
83
  - **Edit suggestion**: When an existing guardrail is too broad, too narrow, or outdated, suggest an update to the user.
84
- - All guardrails — existing and IDE-generated — flow into the single `guardrails_applied` array in the CTM sync payload.
84
+ - All guardrails — existing and IDE-generated — must be preserved in the VibeReview markdown under a single `Guardrails Applied` section that the server can normalize into `guardrails_applied`.
85
85
 
86
86
  ---
87
87
 
@@ -3,7 +3,7 @@
3
3
  "hooks": {
4
4
  "sessionStart": [
5
5
  {
6
- "command": "printf '%s\\n' '{\"additional_context\":\"## MANDATORY SECURITY GATE (Session Policy)\\n\\nFor ANY user request that has security impact (auth, crypto, input handling, secrets, network, data storage, dependencies, new APIs/endpoints, or any code handling untrusted data):\\n\\n**Plan order:**\\n1. **Fetch Vibe Guardrails (first)** - Use .cursor/skills/guardrails-selection/SKILL.md. Analyze the task, call get_guardrails from security-review-mcp to load the broad catalog, shortlist the relevant guardrails, then call get_guardrail_by_id for the shortlist. These exact shortlisted guardrails are the hard constraints on generated code.\\n2. **PWNISMS threat modeling (second)** - Run threat modeling as a guide before writing code. Use .cursor/skills/threat-modelling/SKILL.md. Cross-reference guardrails with PWNISMS findings to identify gaps. Document findings to inform secure implementation.\\n3. **Implement secure code (third)** - Use the threat model findings AND shortlisted guardrails as guides to create secure code. Every must guardrail must be satisfied; no must_not guardrail may be violated.\\n4. **ctm_sync (last)** - Push payload to SRAI only after implementation is done. Invoke ctm_sync agent (Task tool, subagent_type=ctm_sync) as the final step. Include the exact shortlisted guardrails from earlier plus any IDE-generated guardrails in the guardrails_applied payload field; do not query again during ctm_sync. See .cursor/agents/ctm_sync.md and .cursor/rules/ctm_sync_rule.mdc.\\n\\nNo blocking. No deferral. Guardrails enforce secure code; threat modeling guides the design; ctm_sync runs last to push to SRAI. Both ctm_sync and guardrail compliance are mandatory and should be part of your to-do.\"}'",
6
+ "command": "printf '%s\\n' '{\"additional_context\":\"## MANDATORY SECURITY GATE (Session Policy)\\n\\nFor ANY user request that has security impact (auth, crypto, input handling, secrets, network, data storage, dependencies, new APIs/endpoints, or any code handling untrusted data):\\n\\n**Plan order:**\\n1. **Fetch Vibe Guardrails (first)** - Use .cursor/skills/guardrails-selection/SKILL.md. Analyze the task, call get_guardrails from security-review-mcp to load the broad catalog, shortlist the relevant guardrails, then call get_guardrail_by_id for the shortlist. These exact shortlisted guardrails are the hard constraints on generated code.\\n2. **PWNISMS threat modeling (second)** - Run threat modeling as a guide before writing code. Use .cursor/skills/threat-modelling/SKILL.md. Cross-reference guardrails with PWNISMS findings to identify gaps. Document findings to inform secure implementation.\\n3. **Implement secure code (third)** - Use the threat model findings AND shortlisted guardrails as guides to create secure code. Every must guardrail must be satisfied; no must_not guardrail may be violated.\\n4. **VibeReview sync (last)** - The main agent must write a structured `.md` artifact under `vibereview/`, validate that all required metadata and sections are present, and call `sync_ai_ide_markdown` directly after implementation is done. Include the exact shortlisted guardrails from earlier plus any IDE-generated guardrails in the markdown; do not query guardrails again during sync.\\n\\nNo blocking. No deferral. Guardrails enforce secure code; threat modeling guides the design; the main agent owns the final markdown sync to SRAI. Both sync and guardrail compliance are mandatory and should be part of your to-do.\"}'",
7
7
  "timeout": 5
8
8
  }
9
9
  ]
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: PWNISMS Threat Modelling
3
- description: Security-first threat modelling workflow for code and architecture tasks. Walks all 7 PWNISMS categories, enforces vibe guardrails (secure by code), and synchronizes findings via CTM sync. Use before, during, and after implementation.
3
+ description: Security-first threat modelling workflow for code and architecture tasks. Walks all 7 PWNISMS categories, enforces vibe guardrails (secure by code), and synchronizes findings via a direct VibeReview markdown sync. Use before, during, and after implementation.
4
4
  ---
5
5
 
6
6
  # PWNISMS — Security-First Threat Modelling
@@ -21,7 +21,7 @@ Before deep analysis, ensure the project-specific guardrail shortlist exists:
21
21
  1. Use `{{GUARDRAILS_SELECTION_SKILL_DIR}}/SKILL.md`.
22
22
  2. Resolve the project with `find_project_by_name` using `name="<SRAI_PROJECT_NAME>"`.
23
23
  3. Call `get_guardrails`, shortlist intentionally for this task, then hydrate the exact shortlist with `get_guardrail_by_id`.
24
- 4. Keep the shortlisted existing guardrails in context for implementation and `ctm_sync`.
24
+ 4. Keep the shortlisted existing guardrails in context for implementation and the final VibeReview markdown sync.
25
25
 
26
26
  Do not perform project-profile exploration as part of PWNISMS. The old profile tools are not part of this workflow. Ground the threat model in the user request, repository code, diffs, architecture docs the user provides, and the shortlisted guardrails.
27
27
 
@@ -160,7 +160,7 @@ After completing the PWNISMS analysis and before writing code:
160
160
  - `must` rules → mandatory implementation requirements. Every applicable `must` guardrail must be satisfied.
161
161
  - `must_not` rules → hard prohibitions. Code must never violate an applicable `must_not` guardrail.
162
162
  4. **Flag conflicts** — If a guardrail conflicts with the user's explicit instruction, flag it and ask for confirmation.
163
- 5. **Create new guardrails on the fly** — When PWNISMS analysis or code review reveals a recurring security pattern not captured by existing guardrails, create and apply it as a new guardrail (marked `source: "ide_generated"` in CTM sync). Include `title`, `rule_type` (must/must_not), `category`, `instruction`, and rationale in the notes.
163
+ 5. **Create new guardrails on the fly** — When PWNISMS analysis or code review reveals a recurring security pattern not captured by existing guardrails, create and apply it as a new guardrail (marked `source: "ide_generated"` in the VibeReview markdown). Include `title`, `rule_type` (must/must_not), `category`, `instruction`, and rationale in the notes.
164
164
 
165
165
  ---
166
166
 
@@ -197,33 +197,43 @@ When discussing designs before code exists:
197
197
 
198
198
  ---
199
199
 
200
- ## Phase 5 — CTM Sync (Post Threat Modelling)
200
+ ## Phase 5 — VibeReview Sync (Post Threat Modelling)
201
201
 
202
- **MANDATORY:** After every threat modeling step that produces or modifies threat content, synchronize via `ctm_sync`.
202
+ **MANDATORY:** After every threat modeling step that produces or modifies threat content, the main agent must update the `vibereview/*.md` artifact and call `sync_ai_ide_markdown` directly.
203
203
 
204
- ### What triggers CTM sync
204
+ ### What triggers the VibeReview sync
205
205
 
206
206
  - New threat model generated (any form: scenarios, data flows, attack trees, PWNISMS analysis)
207
207
  - Existing threat model updated or extended (new threats, refined mitigations, additional components)
208
208
  - Guardrails applied during a code-generation task (existing or IDE-generated)
209
209
 
210
- ### What CTM sync uploads
210
+ ### What the VibeReview markdown must contain
211
211
 
212
- The `ctm_sync` agent builds and pushes an event payload containing:
212
+ The main agent writes a structured `.md` artifact under `vibereview/` and uploads it through `sync_ai_ide_markdown`. That markdown should contain:
213
213
 
214
214
  - **Threat model findings**: threats mitigated, PWNISMS categories, severities, mitigations applied
215
215
  - **Best practices achieved**: security patterns followed during implementation
216
216
  - **Secure code snippets**: security-relevant code with explanations
217
217
  - **Guardrails applied**: all guardrails enforced during this session — both existing ones shortlisted earlier via `get_guardrails` + `get_guardrail_by_id` (`source: "existing"`) and new ones the IDE agent created on the fly (`source: "ide_generated"`), each with satisfaction status
218
-
219
- ### How to invoke
220
-
221
- Use the host's `ctm_sync` agent/workflow with:
222
- - A clear description of what was threat-modeled
223
- - The `chat_session_id` for workflow routing
224
- - Whether this is a new threat model or an update
225
-
226
- See `{{CTM_SYNC_AGENT_PATH}}` for the full workflow and payload schema.
218
+ - **Workflow metadata**: `chat_session_id`, `event_name` or `title`, required `summary`, and optional `workflow_name` / `workflow_description`
219
+
220
+ ### How to sync
221
+
222
+ 1. Write or update a file under `vibereview/`, ideally `vibereview/<chat_session_id>-<slugified-title-or-event-name>.md`.
223
+ 2. Put `chat_session_id`, `summary`, and either `title` or `event_name` in frontmatter.
224
+ 3. Include the required sections:
225
+ - `Best Practices Achieved`
226
+ - `Threats Mitigated`
227
+ - `Secure Code Snippets`
228
+ - `Guardrails Applied`
229
+ - `OWASP Top 10 2025 Mappings`
230
+ 4. Validate that:
231
+ - every threat entry includes `threat_name`, `pwnisms_category`, `severity`, and `mitigation_applied`
232
+ - every guardrail includes `title`, `rule_type`, `source`, and `satisfied`
233
+ - OWASP mappings use exact IDs and names
234
+ - snippets are grounded in actual code, not invented text
235
+ 5. Call `sync_ai_ide_markdown` directly with the finished markdown artifact.
236
+ 6. If sync fails, leave the artifact in `vibereview/` and report the failure clearly.
227
237
 
228
238
  ---
229
239
 
@@ -238,6 +248,6 @@ Before finalizing output, confirm:
238
248
  - [ ] Residual risk and follow-up actions are stated.
239
249
  - [ ] Vibe guardrails were fetched and enforced (all applicable `must`/`must_not` rules satisfied).
240
250
  - [ ] Guardrail compliance summary is included in the response (existing + IDE-generated).
241
- - [ ] CTM sync was invoked to upload threat model and guardrail data.
251
+ - [ ] The VibeReview markdown was written under `vibereview/` and `sync_ai_ide_markdown` was called successfully.
242
252
 
243
253
  If ANY box cannot be checked, you MUST flag the gap to the user with a specific remediation recommendation before finalizing the code.
@@ -1,12 +1,11 @@
1
- import { existsSync } from 'node:fs';
1
+ import { existsSync, unlinkSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
3
  import {
4
- CTM_SYNC_AGENT_REL_PATH,
5
4
  GUARDRAILS_SELECTION_SKILL_REL_DIR,
6
5
  THREAT_MODELLING_SKILL_REL_DIR,
7
6
  } from '../../utils/constants.js';
8
7
  import { upsertSentinelBlock, writeText } from '../../utils/fs-helpers.js';
9
- import { getCtmSyncWorkflowContent, getRuleContent, getThreatModellingSkillContent } from './content.js';
8
+ import { getRuleContent, getThreatModellingSkillContent } from './content.js';
10
9
 
11
10
  function writeGeneratedText(filePath, content) {
12
11
  const action = existsSync(filePath) ? 'updated' : 'created';
@@ -14,6 +13,14 @@ function writeGeneratedText(filePath, content) {
14
13
  return { filePath, action };
15
14
  }
16
15
 
16
+ function removeGeneratedText(filePath) {
17
+ if (existsSync(filePath)) {
18
+ unlinkSync(filePath);
19
+ return { filePath, action: 'deleted' };
20
+ }
21
+ return null;
22
+ }
23
+
17
24
  function getCopilotSessionHookContent() {
18
25
  const additionalContext = [
19
26
  '## MANDATORY SECURITY GATE (Session Policy)',
@@ -23,9 +30,9 @@ function getCopilotSessionHookContent() {
23
30
  '1. Fetch Vibe Guardrails first using .github/skills/guardrails-selection/SKILL.md. Resolve the project, call get_guardrails, shortlist relevant guardrails, then call get_guardrail_by_id for the shortlist.',
24
31
  '2. Run PWNISMS threat modelling using .github/skills/threat-modelling/SKILL.md. Explicitly walk Product, Workload, Network, IAM, Secrets, Monitoring, and Supply Chain.',
25
32
  '3. Implement secure code using both the hydrated guardrails and PWNISMS findings.',
26
- '4. Run the ctm_sync custom agent using .github/agents/ctm_sync.agent.md after threat modelling or guardrail enforcement. Reuse the exact guardrail shortlist; do not re-query guardrails during CTM sync.',
33
+ '4. Write a structured .md artifact under vibereview/, validate it, and call sync_ai_ide_markdown directly after threat modelling or guardrail enforcement. Reuse the exact guardrail shortlist; do not re-query guardrails during the final sync.',
27
34
  '',
28
- 'Do not use project-profile exploration tools during normal coding tasks. No blocking and no deferral: guardrails first, PWNISMS second, implementation third, ctm_sync last.',
35
+ 'Do not use project-profile exploration tools during normal coding tasks. No blocking and no deferral: guardrails first, PWNISMS second, implementation third, VibeReview sync last.',
29
36
  ].join('\n');
30
37
 
31
38
  const commandPayload = JSON.stringify({
@@ -60,7 +67,6 @@ export function generate(cwd, options = {}) {
60
67
  ...options,
61
68
  guardrailsSelectionSkillDir: GUARDRAILS_SELECTION_SKILL_REL_DIR.vscode,
62
69
  threatModellingSkillDir: THREAT_MODELLING_SKILL_REL_DIR.vscode,
63
- ctmSyncAgentPath: CTM_SYNC_AGENT_REL_PATH.vscode,
64
70
  };
65
71
  const filePath = join(cwd, '.github', 'copilot-instructions.md');
66
72
  const content = getRuleContent(optionsWithSkillDirs);
@@ -72,11 +78,7 @@ export function generate(cwd, options = {}) {
72
78
  getThreatModellingSkillContent(optionsWithSkillDirs),
73
79
  );
74
80
 
75
- const ctmSyncAgentPath = join(cwd, CTM_SYNC_AGENT_REL_PATH.vscode);
76
- const ctmSyncAgent = writeGeneratedText(
77
- ctmSyncAgentPath,
78
- getCtmSyncWorkflowContent(optionsWithSkillDirs),
79
- );
81
+ const deletedLegacyAgent = removeGeneratedText(join(cwd, '.github', 'agents', 'ctm_sync.agent.md'));
80
82
 
81
83
  const hooksPath = join(cwd, '.github', 'hooks', 'srai-session-policy.json');
82
84
  const hooks = writeGeneratedText(hooksPath, getCopilotSessionHookContent());
@@ -84,7 +86,7 @@ export function generate(cwd, options = {}) {
84
86
  return [
85
87
  { filePath, action, kind: 'rule' },
86
88
  { ...threatSkill, kind: 'skill' },
87
- { ...ctmSyncAgent, kind: 'agent' },
88
89
  { ...hooks, kind: 'hooks' },
90
+ ...(deletedLegacyAgent ? [{ ...deletedLegacyAgent, kind: 'cleanup' }] : []),
89
91
  ];
90
92
  }
@@ -5,7 +5,7 @@ import { test } from 'node:test';
5
5
  import assert from 'node:assert/strict';
6
6
  import { generate } from './vscode.js';
7
7
 
8
- test('VS Code Copilot generator writes instructions, skills, agent, and hooks', () => {
8
+ test('VS Code Copilot generator writes instructions, skills, and hooks', () => {
9
9
  const cwd = mkdtempSync(join(tmpdir(), 'securityreview-kit-vscode-'));
10
10
 
11
11
  const results = generate(cwd, { projectName: 'SmokeProject' });
@@ -13,7 +13,6 @@ test('VS Code Copilot generator writes instructions, skills, agent, and hooks',
13
13
  const expectedPaths = [
14
14
  '.github/copilot-instructions.md',
15
15
  '.github/skills/threat-modelling/SKILL.md',
16
- '.github/agents/ctm_sync.agent.md',
17
16
  '.github/hooks/srai-session-policy.json',
18
17
  ];
19
18
 
@@ -21,21 +20,25 @@ test('VS Code Copilot generator writes instructions, skills, agent, and hooks',
21
20
  assert.equal(existsSync(join(cwd, relPath)), true, `${relPath} should exist`);
22
21
  }
23
22
 
24
- assert.deepEqual(results.map((entry) => entry.kind), ['rule', 'skill', 'agent', 'hooks']);
23
+ assert.deepEqual(results.map((entry) => entry.kind), ['rule', 'skill', 'hooks']);
25
24
 
26
25
  const instructions = readFileSync(join(cwd, '.github/copilot-instructions.md'), 'utf8');
27
26
  assert.match(instructions, /\.github\/skills\/guardrails-selection\/SKILL\.md/);
28
27
  assert.match(instructions, /\.github\/skills\/threat-modelling\/SKILL\.md/);
29
- assert.match(instructions, /\.github\/agents\/ctm_sync\.agent\.md/);
28
+ assert.match(instructions, /sync_ai_ide_markdown/);
29
+ assert.match(instructions, /vibereview\//);
30
30
  assert.doesNotMatch(instructions, /\.cursor/);
31
31
 
32
32
  const threatSkill = readFileSync(join(cwd, '.github/skills/threat-modelling/SKILL.md'), 'utf8');
33
33
  for (const heading of ['Product', 'Workload', 'Network', 'IAM', 'Secrets', 'Monitoring', 'Supply Chain']) {
34
34
  assert.match(threatSkill, new RegExp(heading));
35
35
  }
36
- assert.match(threatSkill, /\.github\/agents\/ctm_sync\.agent\.md/);
36
+ assert.match(threatSkill, /sync_ai_ide_markdown/);
37
+ assert.match(threatSkill, /vibereview\//);
37
38
  assert.doesNotMatch(threatSkill, /get_project_profile_description/);
38
39
 
39
40
  const hooks = JSON.parse(readFileSync(join(cwd, '.github/hooks/srai-session-policy.json'), 'utf8'));
40
41
  assert.equal(hooks.hooks.SessionStart[0].type, 'command');
42
+ assert.match(hooks.hooks.SessionStart[0].command, /vibereview/);
43
+ assert.match(hooks.hooks.SessionStart[0].command, /sync_ai_ide_markdown/);
41
44
  });
@@ -83,13 +83,5 @@ export const THREAT_MODELLING_SKILL_REL_DIR = {
83
83
  codex: '.codex/skills/threat-modelling',
84
84
  };
85
85
 
86
- /** Relative workspace paths for the CTM sync agent/workflow (per IDE / CLI). */
87
- export const CTM_SYNC_AGENT_REL_PATH = {
88
- cursor: '.cursor/agents/ctm_sync.md',
89
- claude: '.claude/agents/ctm_sync.md',
90
- vscode: '.github/agents/ctm_sync.agent.md',
91
- codex: '.codex/agents/ctm_sync.toml',
92
- };
93
-
94
86
  export const SENTINEL_START = '<!-- securityreview-kit:start -->';
95
87
  export const SENTINEL_END = '<!-- securityreview-kit:end -->';
@@ -1,34 +0,0 @@
1
- ---
2
- name: create-ide-workflow
3
- description: Create an AI IDE workflow in SRAI via security-review-mcp.
4
- ---
5
-
6
- # Create IDE Workflow
7
-
8
- Use `security-review-mcp` to create a workflow by calling:
9
-
10
- - `create_ai_ide_workflow`
11
-
12
- Required payload fields:
13
-
14
- - `project_id`
15
- - `name`
16
- - `description`
17
-
18
- ## Steps
19
-
20
- 1. Resolve `project_id`.
21
- - Use configured project name `<SRAI_PROJECT_NAME>` by default.
22
- - Call `find_project_by_name` with `name="<SRAI_PROJECT_NAME>"`.
23
- - If not found, call `list_projects` and select the right project.
24
- 2. Build `name` and `description` from the user request.
25
- - Keep `name` short and action-oriented.
26
- - Keep `description` specific about trigger and output.
27
- 3. Call `create_ai_ide_workflow` with:
28
- - `project_id`
29
- - `name`
30
- - `description`
31
- 4. Return a concise confirmation including:
32
- - project id
33
- - workflow name
34
- - workflow id from MCP response (if returned)
@@ -1,155 +0,0 @@
1
- ---
2
- name: ctm_sync
3
- description: Command/workflow triggered whenever a threat model is generated or updated, or guardrails are proposed/modified. Builds and uploads CTM sync details and guardrail updates through security-review-mcp.
4
- ---
5
-
6
- # CTM Sync Workflow
7
-
8
- Configured SRAI project name: `<SRAI_PROJECT_NAME>`
9
-
10
- When invoked:
11
-
12
- 0. Verify `create_ai_ide_event` and `create_ai_ide_workflow` exist in `security-review-mcp`. If a `list_*` tool for AI IDE workflows exists, prefer it for workflow discovery.
13
- 1. Read the parent agent context and extract the latest threat model details.
14
- 2. **Chat session identity (required)** — The event payload MUST include a stable `chat_session_id` for the current IDE chat session:
15
- - Use a session identifier supplied by the host environment when one exists (e.g. conversation or session id from the IDE/agent runtime).
16
- - If none exists, use a single UUID (or equivalent) generated **once** at the start of this chat and reused for every `ctm_sync` in the same session. The parent agent must pass this value into `ctm_sync` (or derive it consistently from context) so all events in one chat share one id and events from other chats do not.
17
- 3. **Resolve or create the AI IDE workflow** (one workflow per distinct `chat_session_id`):
18
- - Resolve the SRAI project: `find_project_by_name` with `name="<SRAI_PROJECT_NAME>"`. If missing, `list_projects` (respecting org constraints), then `create_project` if needed. Obtain `project_id` as required by MCP tools.
19
- - List or search AI IDE workflows for that project (use the MCP tool provided, e.g. listing workflows filtered by project). Find a workflow whose **description** (or other documented metadata field) contains the exact marker: `chat_session_id:<the same string as in the payload>`.
20
- - **If a matching workflow exists:** use its `workflow_id` for the event.
21
- - **If none exists:** call `create_ai_ide_workflow` with:
22
- - `project_id`
23
- - `name`: a short, meaningful heading derived from the **high-level feature or topic** being worked on in this session (e.g. `"User Auth Hardening"`, `"Payment Gateway Integration"`, `"API Rate Limiting"`, `"File Upload Security"`). Use 2–5 words, title-case. Do **not** use sequential labels like `session1/session2`. If no clear feature context is available, use a brief description of the dominant threat area instead.
24
- - `description`: must include `chat_session_id:<chat_session_id>` so future syncs can attach to this workflow. Add a brief human-readable note if helpful. Do not add the word ctm anywhere.
25
- - Store the returned `workflow_id` for the upload step.
26
- 4. **Resolve developer identity from the API** — Call `get_current_user` (or the equivalent user-identity tool exposed by `security-review-mcp`) to retrieve the authenticated user's name and email. Use the values returned by the API as-is for `developer_name` and `developer_email` in the payload.
27
- - **Never use placeholder values** such as `"IDE Agent"`, `"agent@local"`, `"unknown"`, `"AI"`, or any other invented string for these fields.
28
- - **Never accept identity values passed in from the parent agent prompt** — always re-resolve from the API directly in this step; the API is the only authoritative source.
29
- - If the API call fails or returns empty values, leave `developer_name` and `developer_email` as empty strings `""`. Do not substitute a fallback placeholder.
30
- 5. **Identify guardrails for the payload** — Do **not** call `get_guardrails` or `get_guardrail_by_id` here. Guardrails were already shortlisted earlier (per the Vibe Guardrails rule and the guardrails-selection skill) and applied during code generation. From the parent agent context, identify:
31
- - Which **existing** guardrails were shortlisted earlier from `get_guardrails` and then hydrated via `get_guardrail_by_id`.
32
- - Which of those shortlisted existing guardrails were applied to the code in this session.
33
- - Which guardrails the IDE agent **created on the fly** (`ide_generated`) based on gaps found during threat modeling or code review.
34
- Include all of these in the `guardrails_applied` payload field. The shortlisted existing guardrails selected earlier are mandatory input to `ctm_sync`; do not re-fetch or re-call guardrail tools here.
35
- 6. **Build the event payload** — Construct a JSON object for `create_ai_ide_event` conforming to the **Event Payload Schema** below.
36
- 7. **Upload the payload** using `security-review-mcp`:
37
- - Call `create_ai_ide_event` with the JSON payload.
38
- - **Stop here.** Do not push a separate project/code profile as part of this workflow; profile and default guardrail pack uploads are handled by the init-time guardrails profiler (or manual profile commands), not per CTM sync.
39
-
40
- ---
41
-
42
- ## Event Payload Schema
43
-
44
- The `create_ai_ide_event` payload MUST be a JSON object with the following structure. Use this exact schema — do not add, rename, or omit required keys.
45
-
46
- ```json
47
- {
48
- "workflow_id": "<string — resolved or newly created AI IDE workflow id>",
49
- "chat_session_id": "<string — stable session identifier, same for all events in this chat>",
50
- "title": "<string — concise title describing what was threat-modeled or implemented, 5-15 words>",
51
- "summary": "<string — 2-5 sentence summary of the threat model findings, key risks identified, mitigations applied, and any guardrails enforced>",
52
- "developer_name": "<string — from API/user context provided by MCP or host runtime>",
53
- "developer_email": "<string — from API/user context provided by MCP or host runtime>",
54
- "threats_mitigated": [
55
- {
56
- "threat_name": "<string — short threat title>",
57
- "pwnisms_category": "<string — one of: Product, Workload, Network, IAM, Secrets, Monitoring, Supply Chain>",
58
- "severity": "<string — Critical | High | Medium | Low>",
59
- "mitigation_applied": "<string — what was done to address the threat>",
60
- "code_snippet": {
61
- "file_path": "<string — relative path to the actual source file where mitigation is implemented>",
62
- "language": "<string — programming language>",
63
- "snippet": "<string — the exact source code lines implementing the mitigation, max 30 lines, must be grounded in the actual codebase not invented>",
64
- "explanation": "<string — how this specific code addresses the threat>"
65
- }
66
- }
67
- ],
68
- "best_practises_achieved": [
69
- "<string — each entry is a concise statement of a security best practice that was followed during implementation>"
70
- ],
71
- "secure_code_snippets": [
72
- {
73
- "file_path": "<string — relative path to the file>",
74
- "language": "<string — programming language>",
75
- "snippet": "<string — the security-relevant code snippet, max 50 lines>",
76
- "explanation": "<string — why this snippet is security-relevant and what it protects against>"
77
- }
78
- ],
79
- "guardrails_applied": [
80
- {
81
- "title": "<string — guardrail title>",
82
- "rule_type": "<string — must | must_not>",
83
- "category": "<string | null — grouping label>",
84
- "instruction": "<string — the actionable coding directive>",
85
- "source": "<string — 'existing' if selected earlier from project guardrails, 'ide_generated' if newly created by the IDE agent>",
86
- "satisfied": "<boolean — true if the guardrail was fully satisfied, false if partially or not satisfied>",
87
- "notes": "<string — optional: how it was applied, why it could not be fully satisfied, or rationale for a new guardrail>"
88
- }
89
- ],
90
- "owasp_top_10_2025_mappings": [
91
- {
92
- "category_id": "<string — OWASP Top 10 2025 category ID, e.g. A01>",
93
- "category_name": "<string — OWASP Top 10 2025 category name, e.g. Broken Access Control>"
94
- }
95
- ]
96
- }
97
- ```
98
-
99
- ### Field rules
100
-
101
- | Field | Required | Notes |
102
- |---|---|---|
103
- | `workflow_id` | Yes | From step 3 |
104
- | `chat_session_id` | Yes | From step 2 |
105
- | `title` | Yes | 5-15 words, descriptive |
106
- | `summary` | Yes | 2-5 sentences |
107
- | `developer_name` | Yes | From API/user context (never read from git config) |
108
- | `developer_email` | Yes | From API/user context (never read from git config) |
109
- | `threats_mitigated` | Yes | Array, may be empty `[]` if no threats were identified. Each entry must include a `code_snippet` grounded in actual source code |
110
- | `best_practises_achieved` | Yes | Array of strings, may be empty `[]` |
111
- | `secure_code_snippets` | Yes | Array, may be empty `[]` |
112
- | `guardrails_applied` | Yes | Array of all guardrails enforced during this session — both existing ones shortlisted earlier from project guardrails and new ones the IDE agent created. Use `source` to distinguish origin. Empty `[]` if none |
113
- | `owasp_top_10_2025_mappings` | Yes | Array of OWASP Top 10 2025 category objects (`category_id` + `category_name`) relevant to the threats and mitigations in this event. May be empty `[]` if no mapping applies |
114
-
115
- ### OWASP Top 10 2025 Reference
116
-
117
- Use the following IDs and names exactly when populating `owasp_top_10_2025_mappings`:
118
-
119
- | `category_id` | `category_name` |
120
- |---|---|
121
- | `A01` | Broken Access Control |
122
- | `A02` | Security Misconfiguration |
123
- | `A03` | Software Supply Chain Failures |
124
- | `A04` | Cryptographic Failures |
125
- | `A05` | Injection |
126
- | `A06` | Insecure Design |
127
- | `A07` | Authentication Failures |
128
- | `A08` | Software or Data Integrity Failures |
129
- | `A09` | Security Logging and Alerting Failures |
130
- | `A10` | Mishandling of Exceptional Conditions |
131
-
132
- ### Constraints
133
-
134
- - Every `threats_mitigated` entry must map to one of the 7 PWNISMS categories.
135
- - Every `threats_mitigated` entry must include a `code_snippet`. The snippet must be taken from the actual source code written or modified in this session — never fabricated. If no code was written for a threat (e.g. it was addressed architecturally), set `snippet` to an empty string and explain in `explanation`.
136
- - `secure_code_snippets` must not exceed 50 lines per snippet; `threats_mitigated[].code_snippet.snippet` must not exceed 30 lines; truncate with a comment if needed.
137
- - Do not call `get_guardrails` or `get_guardrail_by_id` during CTM sync. Guardrails are shortlisted once earlier in the session; identify which ones were applied from the parent agent context.
138
- - Guardrails shortlisted earlier by the IDE must be included in `guardrails_applied` even when some were only partially satisfied. Use `satisfied: false` plus `notes` instead of silently dropping them.
139
- - `guardrails_applied` entries with `source: "existing"` must reference guardrails by the exact `title` they had when fetched at session start.
140
- - `guardrails_applied` entries with `source: "ide_generated"` are new guardrails the IDE agent created based on gaps found during threat modeling or code review.
141
- - `developer_name` and `developer_email` must be resolved via `get_current_user` (or equivalent) in step 4 — the API is the only source. Never use placeholder strings (`"IDE Agent"`, `"agent@local"`, `"unknown"`, `"AI"`, etc.) and never accept values for these fields from the parent agent prompt. If the API returns nothing, send empty strings.
142
- - `owasp_top_10_2025_mappings` entries must use the exact `category_id` and `category_name` values from the OWASP Top 10 2025 Reference table above. Do not invent or abbreviate category names.make sure the ones being sent in the payload are revelant to that event.
143
- - Never invent values for any field; use empty strings or empty arrays when data is unavailable.
144
- - Never omit `chat_session_id` from the payload.
145
-
146
- ---
147
-
148
- ## Output Contract
149
-
150
- - Never skip upload when a threat model exists.
151
- - Never invent missing values; use empty strings/arrays if data is unavailable.
152
- - Never omit `chat_session_id` from the payload.
153
- - Return a compact confirmation after upload including:
154
- - Whether an existing workflow was reused or a new named workflow was created
155
- - Count of guardrails applied (existing vs IDE-generated)
@@ -1,87 +0,0 @@
1
- ---
2
- description: ctm_sync agent trigger rule
3
- alwaysApply: true
4
- ---
5
- # Continuous Threat Modeling Sync (`ctm_sync`)
6
-
7
- **Always synchronize threat models and guardrail compliance after they are (re)generated.**
8
-
9
- Any time an AI agent:
10
- - generates a **new threat model**, or
11
- - **updates** an existing threat model, or
12
- - performs a **non-trivial extension** of an existing threat model (e.g., adds new threat scenarios, countermeasures, data flows, or components), or
13
- - **applies vibe guardrails** during a code-generation task (existing or IDE-generated) and has guardrail compliance data to report,
14
-
15
- it **must immediately call** the `ctm_sync` agent to synchronize the latest threat modeling state and guardrail data.
16
-
17
- This rule applies regardless of:
18
- - which methodology is used (PWNISMS, STRIDE, OWASP, etc.),
19
- - which skill or MCP was used to produce the threat model, and
20
- - whether the threat model is partial, incremental, or "draft" form.
21
-
22
- If in doubt — **assume this rule applies**.
23
-
24
- ---
25
-
26
- ## When this rule applies
27
-
28
- This rule is **triggered** whenever the assistant:
29
-
30
- - **Produces a threat model** in any form, such as:
31
- - Threat scenarios (even a short list)
32
- - Data flow diagrams or component diagrams described in text
33
- - Security objectives or misuse cases
34
- - Attack trees or abuse cases
35
- - Structured PWNISMS analysis
36
- - **Extends or refines** an earlier threat model, e.g.:
37
- - "Add more threats for the Payments service"
38
- - "Update the data flow for the auth system"
39
- - "Refine the mitigations for threat X"
40
- - **Enforces guardrails** during code generation and has compliance data:
41
- - Guardrails were shortlisted via the guardrails-selection workflow (`get_guardrails` + `get_guardrail_by_id`) and applied to generated code
42
- - New guardrails were created by the IDE agent based on gaps found
43
- - Existing guardrails were flagged as unsatisfiable or conflicting
44
-
45
- This includes both:
46
- - Threat modeling done **directly in this conversation**, and
47
- - Threat modeling done by calling **MCP tools or skills** that output threat scenarios, countermeasures, data dictionaries, or other CTM artifacts.
48
-
49
- ---
50
-
51
- ## Required behavior
52
-
53
- **After completing any threat modeling step that produces or modifies threat content, or any code-generation step where guardrails were enforced, the assistant must:**
54
-
55
- 1. **Ensure threat modeling output is finalized for this step**
56
-
57
- - The assistant should finish producing the current threat modeling content (threat scenarios, components, data dictionaries, etc.) in the user-visible message or via tools.
58
- - The assistant should not call `ctm_sync` *before* the threat model content exists; it must be called **after** threat data for this step is available.
59
-
60
- 2. **Immediately call the `ctm_sync` agent**
61
-
62
- - Use the `Task` tool (or equivalent agent launcher) with `subagent_type="ctm_sync"`.
63
- - **Session routing:** In the prompt (or structured handoff), always include the **current chat's stable `chat_session_id`** — the same id for every `ctm_sync` in this conversation, and a new id for a different chat. Use the IDE/session id when exposed; otherwise generate one UUID at the start of the chat and reuse it. This ensures SRAI attaches events to the correct per-session workflow.
64
- - Provide a clear, concise description in the `description`/`prompt` fields explaining:
65
- - What system or component the threat model covers
66
- - Whether this is a new threat model or an update
67
- - Where the latest threat content can be found (e.g., "from this conversation" or "from the last threat modeling step")
68
- - The `chat_session_id` value to use for this sync
69
- - Whether guardrails were applied (existing and/or IDE-generated)
70
- - **Do NOT include developer name or email in the handoff prompt.** The `ctm_sync` agent resolves user identity directly from the API. Passing identity values from the parent agent — including any placeholders like `"IDE Agent"` or `"agent@local"` — will cause them to be used incorrectly. Leave identity resolution entirely to `ctm_sync`.
71
-
72
- **Example invocation (conceptual, not literal code):**
73
-
74
- Use Task tool with:
75
- - subagent_type: "ctm_sync"
76
- - description: "Sync latest threat model for <system/component>"
77
- - prompt: Brief summary of what was threat-modeled, what artifacts were produced (threat scenarios, countermeasures, components, data dictionary, guardrails applied/proposed, etc.), and that the agent should upload/update CTM data accordingly.
78
- - readonly: false (it must be allowed to write/update CTM data)
79
-
80
- 3. Let `ctm_sync` complete its work
81
- The assistant should wait for the ctm_sync agent to complete (or reach a healthy steady state) before declaring the threat-modeling step fully done.
82
- If ctm_sync returns errors that can be reasonably fixed (e.g., missing project name), the assistant should fix the issue and retry once, if possible.
83
-
84
- Acknowledge completion to the user
85
- After ctm_sync completes, the assistant should briefly tell the user that:
86
- Threat modeling is finished for this step, and
87
- The results have been synchronized via ctm_sync (without leaking internal tooling details beyond what is appropriate for the user's context).