sentinelayer-cli 0.4.4 → 0.6.2

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.
Files changed (149) hide show
  1. package/README.md +996 -998
  2. package/bin/create-sentinelayer.js +5 -5
  3. package/bin/sentinelayer-cli.js +4 -4
  4. package/bin/sl.js +5 -5
  5. package/package.json +63 -63
  6. package/src/agents/jules/config/definition.js +160 -209
  7. package/src/agents/jules/config/system-prompt.js +182 -175
  8. package/src/agents/jules/error-intake.js +51 -51
  9. package/src/agents/jules/fix-cycle.js +17 -377
  10. package/src/agents/jules/loop.js +450 -367
  11. package/src/agents/jules/pulse.js +10 -327
  12. package/src/agents/jules/stream.js +186 -186
  13. package/src/agents/jules/swarm/file-scanner.js +74 -74
  14. package/src/agents/jules/swarm/index.js +11 -11
  15. package/src/agents/jules/swarm/orchestrator.js +362 -362
  16. package/src/agents/jules/swarm/pattern-hunter.js +123 -123
  17. package/src/agents/jules/swarm/sub-agent.js +309 -308
  18. package/src/agents/jules/tools/aidenid-email.js +189 -0
  19. package/src/agents/jules/tools/auth-audit.js +1691 -557
  20. package/src/agents/jules/tools/dispatch.js +335 -327
  21. package/src/agents/jules/tools/file-edit.js +2 -180
  22. package/src/agents/jules/tools/file-read.js +2 -100
  23. package/src/agents/jules/tools/frontend-analyze.js +570 -570
  24. package/src/agents/jules/tools/glob.js +2 -168
  25. package/src/agents/jules/tools/grep.js +2 -228
  26. package/src/agents/jules/tools/index.js +29 -29
  27. package/src/agents/jules/tools/path-guards.js +2 -161
  28. package/src/agents/jules/tools/runtime-audit.js +507 -503
  29. package/src/agents/jules/tools/shell.js +2 -383
  30. package/src/agents/jules/tools/url-policy.js +100 -100
  31. package/src/agents/persona-visuals.js +61 -0
  32. package/src/agents/shared-tools/dispatch-core.js +315 -0
  33. package/src/agents/shared-tools/file-edit.js +180 -0
  34. package/src/agents/shared-tools/file-read.js +100 -0
  35. package/src/agents/shared-tools/glob.js +168 -0
  36. package/src/agents/shared-tools/grep.js +228 -0
  37. package/src/agents/shared-tools/index.js +46 -0
  38. package/src/agents/shared-tools/path-guards.js +161 -0
  39. package/src/agents/shared-tools/shell.js +383 -0
  40. package/src/ai/aidenid.js +1009 -972
  41. package/src/ai/client.js +553 -508
  42. package/src/ai/domain-target-store.js +268 -268
  43. package/src/ai/identity-store.js +270 -270
  44. package/src/ai/proxy.js +137 -0
  45. package/src/ai/site-store.js +145 -145
  46. package/src/audit/agents/architecture.js +180 -180
  47. package/src/audit/agents/compliance.js +179 -179
  48. package/src/audit/agents/documentation.js +165 -165
  49. package/src/audit/agents/performance.js +145 -145
  50. package/src/audit/agents/security.js +215 -215
  51. package/src/audit/agents/testing.js +172 -172
  52. package/src/audit/orchestrator.js +557 -557
  53. package/src/audit/package.js +204 -204
  54. package/src/audit/registry.js +284 -284
  55. package/src/audit/replay.js +103 -103
  56. package/src/auth/gate.js +371 -126
  57. package/src/auth/http.js +611 -270
  58. package/src/auth/service.js +1106 -891
  59. package/src/auth/session-store.js +813 -359
  60. package/src/cli.js +252 -252
  61. package/src/commands/ai/identity-lifecycle.js +1338 -1338
  62. package/src/commands/ai/provision-governance.js +1272 -1272
  63. package/src/commands/ai/shared.js +147 -147
  64. package/src/commands/ai.js +11 -11
  65. package/src/commands/apply.js +12 -12
  66. package/src/commands/audit.js +1166 -1166
  67. package/src/commands/auth.js +419 -375
  68. package/src/commands/chat.js +191 -191
  69. package/src/commands/config.js +184 -184
  70. package/src/commands/cost.js +311 -311
  71. package/src/commands/daemon/core.js +850 -850
  72. package/src/commands/daemon/extended.js +1048 -1048
  73. package/src/commands/daemon/shared.js +213 -213
  74. package/src/commands/daemon.js +11 -11
  75. package/src/commands/guide.js +174 -174
  76. package/src/commands/ingest.js +58 -58
  77. package/src/commands/init.js +55 -55
  78. package/src/commands/legacy-args.js +10 -10
  79. package/src/commands/mcp.js +461 -461
  80. package/src/commands/omargate.js +29 -21
  81. package/src/commands/persona.js +20 -20
  82. package/src/commands/plugin.js +260 -260
  83. package/src/commands/policy.js +132 -132
  84. package/src/commands/prompt.js +238 -238
  85. package/src/commands/review.js +704 -704
  86. package/src/commands/scan.js +872 -866
  87. package/src/commands/spec.js +716 -716
  88. package/src/commands/swarm.js +651 -651
  89. package/src/commands/telemetry.js +202 -202
  90. package/src/commands/watch.js +511 -510
  91. package/src/config/agent-dictionary.js +182 -182
  92. package/src/config/io.js +56 -56
  93. package/src/config/paths.js +18 -18
  94. package/src/config/schema.js +55 -55
  95. package/src/config/service.js +184 -184
  96. package/src/cost/budget.js +235 -235
  97. package/src/cost/history.js +188 -188
  98. package/src/cost/tracker.js +171 -171
  99. package/src/daemon/artifact-lineage.js +534 -534
  100. package/src/daemon/assignment-ledger.js +770 -770
  101. package/src/daemon/ast-parser-layer.js +258 -258
  102. package/src/daemon/budget-governor.js +633 -633
  103. package/src/daemon/callgraph-overlay.js +646 -646
  104. package/src/daemon/error-worker.js +626 -626
  105. package/src/daemon/fix-cycle.js +377 -0
  106. package/src/daemon/hybrid-mapper.js +929 -929
  107. package/src/daemon/jira-lifecycle.js +632 -632
  108. package/src/daemon/operator-control.js +657 -657
  109. package/src/daemon/pulse.js +327 -0
  110. package/src/daemon/reliability-lane.js +471 -471
  111. package/src/daemon/watchdog.js +971 -971
  112. package/src/guide/generator.js +316 -316
  113. package/src/ingest/engine.js +918 -918
  114. package/src/interactive/index.js +97 -95
  115. package/src/legacy-cli.js +2994 -2592
  116. package/src/mcp/registry.js +695 -695
  117. package/src/memory/blackboard.js +301 -301
  118. package/src/memory/retrieval.js +581 -581
  119. package/src/plugin/manifest.js +553 -553
  120. package/src/policy/packs.js +144 -144
  121. package/src/prompt/generator.js +118 -118
  122. package/src/review/ai-review.js +679 -669
  123. package/src/review/local-review.js +1305 -1295
  124. package/src/review/omargate-interactive.js +68 -0
  125. package/src/review/omargate-orchestrator.js +300 -0
  126. package/src/review/persona-prompts.js +296 -0
  127. package/src/review/replay.js +235 -235
  128. package/src/review/report.js +664 -664
  129. package/src/review/scan-modes.js +42 -0
  130. package/src/review/spec-binding.js +487 -487
  131. package/src/scaffold/generator.js +67 -67
  132. package/src/scaffold/templates.js +150 -150
  133. package/src/scan/generator.js +418 -418
  134. package/src/scan/gh-secrets.js +107 -107
  135. package/src/spec/generator.js +519 -519
  136. package/src/spec/regenerate.js +237 -237
  137. package/src/spec/templates.js +91 -91
  138. package/src/swarm/dashboard.js +247 -247
  139. package/src/swarm/factory.js +363 -363
  140. package/src/swarm/pentest.js +934 -934
  141. package/src/swarm/registry.js +419 -419
  142. package/src/swarm/report.js +158 -158
  143. package/src/swarm/runtime.js +576 -576
  144. package/src/swarm/scenario-dsl.js +272 -272
  145. package/src/telemetry/ledger.js +302 -302
  146. package/src/telemetry/session-tracker.js +234 -118
  147. package/src/telemetry/sync.js +203 -199
  148. package/src/ui/command-hints.js +13 -0
  149. package/src/ui/markdown.js +220 -220
@@ -1,144 +1,144 @@
1
- import { loadConfig } from "../config/service.js";
2
- import { listPluginManifests } from "../plugin/manifest.js";
3
-
4
- export const DEFAULT_POLICY_PACK_ID = "community";
5
-
6
- export const BUILTIN_POLICY_PACKS = Object.freeze([
7
- {
8
- id: "community",
9
- name: "Community",
10
- description: "Balanced defaults for everyday repositories.",
11
- source: "builtin",
12
- scanProfile: {},
13
- },
14
- {
15
- id: "strict",
16
- name: "Strict",
17
- description: "Aggressive security gating with stricter severity threshold.",
18
- source: "builtin",
19
- scanProfile: {
20
- scanMode: "deep",
21
- severityGate: "P0",
22
- sbomMode: "audit",
23
- },
24
- },
25
- {
26
- id: "compliance-soc2",
27
- name: "Compliance SOC2",
28
- description: "SOC2-oriented defaults with deep scan and supply-chain auditing.",
29
- source: "builtin",
30
- scanProfile: {
31
- scanMode: "deep",
32
- severityGate: "P1",
33
- sbomMode: "audit",
34
- },
35
- },
36
- {
37
- id: "compliance-hipaa",
38
- name: "Compliance HIPAA",
39
- description: "HIPAA-oriented defaults with strict severity gating.",
40
- source: "builtin",
41
- scanProfile: {
42
- scanMode: "deep",
43
- severityGate: "P0",
44
- sbomMode: "audit",
45
- },
46
- },
47
- ]);
48
-
49
- function normalizePackId(rawValue) {
50
- return String(rawValue || "")
51
- .trim()
52
- .toLowerCase();
53
- }
54
-
55
- function mapCustomPack(pluginEntry) {
56
- return {
57
- id: pluginEntry.id,
58
- name: pluginEntry.name,
59
- description: `Plugin policy pack (${pluginEntry.packType})`,
60
- source: "plugin",
61
- scanProfile: {},
62
- plugin: {
63
- version: pluginEntry.version,
64
- stage: pluginEntry.stage,
65
- path: pluginEntry.path,
66
- policyCount: pluginEntry.policyCount,
67
- },
68
- };
69
- }
70
-
71
- export async function listPolicyPacks({ cwd, outputDir, env } = {}) {
72
- const builtins = BUILTIN_POLICY_PACKS.map((pack) => ({ ...pack }));
73
- const pluginListing = await listPluginManifests({
74
- cwd,
75
- outputDir,
76
- env,
77
- });
78
- const custom = pluginListing.plugins
79
- .filter(
80
- (plugin) =>
81
- plugin.policyCount > 0 && (plugin.packType === "policy_pack" || plugin.packType === "hybrid")
82
- )
83
- .map((plugin) => mapCustomPack(plugin));
84
-
85
- custom.sort((left, right) => left.id.localeCompare(right.id));
86
- const all = [...builtins];
87
- for (const customPack of custom) {
88
- if (!all.some((builtin) => builtin.id === customPack.id)) {
89
- all.push(customPack);
90
- }
91
- }
92
-
93
- return {
94
- packs: all,
95
- builtins,
96
- custom,
97
- pluginsRoot: pluginListing.pluginsRoot,
98
- invalidManifestCount: pluginListing.invalid.length,
99
- };
100
- }
101
-
102
- export async function resolvePolicyPackById({ packId, cwd, outputDir, env } = {}) {
103
- const normalizedPackId = normalizePackId(packId);
104
- const listing = await listPolicyPacks({ cwd, outputDir, env });
105
- const selected = listing.packs.find((pack) => pack.id === normalizedPackId);
106
- return {
107
- ...listing,
108
- packId: normalizedPackId,
109
- selected: selected || null,
110
- };
111
- }
112
-
113
- export async function resolveActivePolicyPack({ cwd, outputDir, env } = {}) {
114
- const config = await loadConfig({ cwd, env });
115
- const configuredId = normalizePackId(config.resolved.defaultPolicyPack) || DEFAULT_POLICY_PACK_ID;
116
- const resolved = await resolvePolicyPackById({
117
- packId: configuredId,
118
- cwd,
119
- outputDir,
120
- env,
121
- });
122
- const fallback =
123
- resolved.selected || resolved.packs.find((pack) => pack.id === DEFAULT_POLICY_PACK_ID) || null;
124
-
125
- return {
126
- configuredId,
127
- selected: fallback,
128
- listing: resolved,
129
- };
130
- }
131
-
132
- export function applyPolicyPackToScanProfile(profile = {}, policyPack = null) {
133
- if (!policyPack || !policyPack.scanProfile) {
134
- return profile;
135
- }
136
- const next = { ...profile };
137
- for (const [key, value] of Object.entries(policyPack.scanProfile)) {
138
- const normalized = String(value || "").trim();
139
- if (normalized) {
140
- next[key] = normalized;
141
- }
142
- }
143
- return next;
144
- }
1
+ import { loadConfig } from "../config/service.js";
2
+ import { listPluginManifests } from "../plugin/manifest.js";
3
+
4
+ export const DEFAULT_POLICY_PACK_ID = "community";
5
+
6
+ export const BUILTIN_POLICY_PACKS = Object.freeze([
7
+ {
8
+ id: "community",
9
+ name: "Community",
10
+ description: "Balanced defaults for everyday repositories.",
11
+ source: "builtin",
12
+ scanProfile: {},
13
+ },
14
+ {
15
+ id: "strict",
16
+ name: "Strict",
17
+ description: "Aggressive security gating with stricter severity threshold.",
18
+ source: "builtin",
19
+ scanProfile: {
20
+ scanMode: "deep",
21
+ severityGate: "P0",
22
+ sbomMode: "audit",
23
+ },
24
+ },
25
+ {
26
+ id: "compliance-soc2",
27
+ name: "Compliance SOC2",
28
+ description: "SOC2-oriented defaults with deep scan and supply-chain auditing.",
29
+ source: "builtin",
30
+ scanProfile: {
31
+ scanMode: "deep",
32
+ severityGate: "P1",
33
+ sbomMode: "audit",
34
+ },
35
+ },
36
+ {
37
+ id: "compliance-hipaa",
38
+ name: "Compliance HIPAA",
39
+ description: "HIPAA-oriented defaults with strict severity gating.",
40
+ source: "builtin",
41
+ scanProfile: {
42
+ scanMode: "deep",
43
+ severityGate: "P0",
44
+ sbomMode: "audit",
45
+ },
46
+ },
47
+ ]);
48
+
49
+ function normalizePackId(rawValue) {
50
+ return String(rawValue || "")
51
+ .trim()
52
+ .toLowerCase();
53
+ }
54
+
55
+ function mapCustomPack(pluginEntry) {
56
+ return {
57
+ id: pluginEntry.id,
58
+ name: pluginEntry.name,
59
+ description: `Plugin policy pack (${pluginEntry.packType})`,
60
+ source: "plugin",
61
+ scanProfile: {},
62
+ plugin: {
63
+ version: pluginEntry.version,
64
+ stage: pluginEntry.stage,
65
+ path: pluginEntry.path,
66
+ policyCount: pluginEntry.policyCount,
67
+ },
68
+ };
69
+ }
70
+
71
+ export async function listPolicyPacks({ cwd, outputDir, env } = {}) {
72
+ const builtins = BUILTIN_POLICY_PACKS.map((pack) => ({ ...pack }));
73
+ const pluginListing = await listPluginManifests({
74
+ cwd,
75
+ outputDir,
76
+ env,
77
+ });
78
+ const custom = pluginListing.plugins
79
+ .filter(
80
+ (plugin) =>
81
+ plugin.policyCount > 0 && (plugin.packType === "policy_pack" || plugin.packType === "hybrid")
82
+ )
83
+ .map((plugin) => mapCustomPack(plugin));
84
+
85
+ custom.sort((left, right) => left.id.localeCompare(right.id));
86
+ const all = [...builtins];
87
+ for (const customPack of custom) {
88
+ if (!all.some((builtin) => builtin.id === customPack.id)) {
89
+ all.push(customPack);
90
+ }
91
+ }
92
+
93
+ return {
94
+ packs: all,
95
+ builtins,
96
+ custom,
97
+ pluginsRoot: pluginListing.pluginsRoot,
98
+ invalidManifestCount: pluginListing.invalid.length,
99
+ };
100
+ }
101
+
102
+ export async function resolvePolicyPackById({ packId, cwd, outputDir, env } = {}) {
103
+ const normalizedPackId = normalizePackId(packId);
104
+ const listing = await listPolicyPacks({ cwd, outputDir, env });
105
+ const selected = listing.packs.find((pack) => pack.id === normalizedPackId);
106
+ return {
107
+ ...listing,
108
+ packId: normalizedPackId,
109
+ selected: selected || null,
110
+ };
111
+ }
112
+
113
+ export async function resolveActivePolicyPack({ cwd, outputDir, env } = {}) {
114
+ const config = await loadConfig({ cwd, env });
115
+ const configuredId = normalizePackId(config.resolved.defaultPolicyPack) || DEFAULT_POLICY_PACK_ID;
116
+ const resolved = await resolvePolicyPackById({
117
+ packId: configuredId,
118
+ cwd,
119
+ outputDir,
120
+ env,
121
+ });
122
+ const fallback =
123
+ resolved.selected || resolved.packs.find((pack) => pack.id === DEFAULT_POLICY_PACK_ID) || null;
124
+
125
+ return {
126
+ configuredId,
127
+ selected: fallback,
128
+ listing: resolved,
129
+ };
130
+ }
131
+
132
+ export function applyPolicyPackToScanProfile(profile = {}, policyPack = null) {
133
+ if (!policyPack || !policyPack.scanProfile) {
134
+ return profile;
135
+ }
136
+ const next = { ...profile };
137
+ for (const [key, value] of Object.entries(policyPack.scanProfile)) {
138
+ const normalized = String(value || "").trim();
139
+ if (normalized) {
140
+ next[key] = normalized;
141
+ }
142
+ }
143
+ return next;
144
+ }
@@ -1,118 +1,118 @@
1
- export const SUPPORTED_PROMPT_TARGETS = Object.freeze([
2
- "claude",
3
- "cursor",
4
- "copilot",
5
- "codex",
6
- "generic",
7
- ]);
8
-
9
- const TARGET_GUIDANCE = Object.freeze({
10
- claude: [
11
- "Use strict PR-scoped execution with explicit plan -> implement -> verify loop.",
12
- "Prioritize deterministic checks before optional AI-dependent steps.",
13
- "Record evidence for every claim in the final report.",
14
- ],
15
- cursor: [
16
- "Apply edits in small, reviewable commits.",
17
- "Keep changes aligned with existing project conventions and tests.",
18
- "Run local verification before proposing follow-up iterations.",
19
- ],
20
- copilot: [
21
- "Generate code with strong type and error-path handling.",
22
- "Avoid introducing implicit behavior changes in existing modules.",
23
- "Include targeted tests for all new logic paths.",
24
- ],
25
- codex: [
26
- "Operate autonomously but keep one PR scope at a time.",
27
- "Use deterministic ingest/spec context as primary source of truth.",
28
- "Fail closed when requirements are ambiguous or unsafe.",
29
- ],
30
- generic: [
31
- "Follow the provided spec exactly.",
32
- "Implement in incremental, verifiable steps.",
33
- "Document assumptions and unresolved risks.",
34
- ],
35
- });
36
-
37
- function normalizeTarget(target) {
38
- const normalized = String(target || "generic").trim().toLowerCase();
39
- if (!SUPPORTED_PROMPT_TARGETS.includes(normalized)) {
40
- throw new Error(
41
- `Unsupported prompt target '${target}'. Use one of: ${SUPPORTED_PROMPT_TARGETS.join(", ")}`
42
- );
43
- }
44
- return normalized;
45
- }
46
-
47
- function buildAgentHeader(target) {
48
- const headers = {
49
- claude: "Claude Code execution prompt",
50
- cursor: "Cursor execution prompt",
51
- copilot: "GitHub Copilot execution prompt",
52
- codex: "Codex execution prompt",
53
- generic: "Generic execution prompt",
54
- };
55
- return headers[target] || headers.generic;
56
- }
57
-
58
- export function resolvePromptTarget(target) {
59
- return normalizeTarget(target);
60
- }
61
-
62
- export function defaultPromptFileName(target) {
63
- const normalized = normalizeTarget(target);
64
- if (normalized === "generic") {
65
- return "PROMPT.md";
66
- }
67
- return `PROMPT_${normalized}.md`;
68
- }
69
-
70
- export function generateExecutionPrompt({
71
- specMarkdown,
72
- target = "generic",
73
- projectPath,
74
- generatedAt = new Date().toISOString(),
75
- } = {}) {
76
- const resolvedTarget = normalizeTarget(target);
77
- const guidance = TARGET_GUIDANCE[resolvedTarget] || TARGET_GUIDANCE.generic;
78
-
79
- const specText = String(specMarkdown || "").trim();
80
- if (!specText) {
81
- throw new Error("Spec content is empty. Generate or provide a spec before creating a prompt.");
82
- }
83
-
84
- const guidanceMarkdown = guidance.map((item, index) => `${index + 1}. ${item}`).join("\n");
85
-
86
- const hasAidenId = specText.toLowerCase().includes("aidenid");
87
- const aidenidGuidance = hasAidenId
88
- ? `
89
- ## AIdenID E2E Testing
90
- - AIdenID credentials are auto-provisioned via \`sl auth login\`. No manual env vars needed.
91
- - Run \`sl auth status\` to confirm AIdenID is provisioned before using identity commands.
92
- - Use \`sl ai provision-email --execute --json\` to create ephemeral test emails.
93
- - Use \`sl ai identity wait-for-otp <identityId> --timeout 30\` to poll for OTP extraction.
94
- - Revoke test identities after verification: \`sl ai identity revoke <identityId>\`.
95
- `
96
- : "";
97
-
98
- return `# ${buildAgentHeader(resolvedTarget)}
99
-
100
- Generated: ${generatedAt}
101
- Agent target: ${resolvedTarget}
102
- Workspace: ${projectPath || "(not provided)"}
103
-
104
- ## Operating Rules
105
- ${guidanceMarkdown}
106
-
107
- ## Execution Workflow
108
- 1. Read the full spec and derive a concrete PR-scoped implementation plan.
109
- 2. Implement only the current scope with deterministic checkpoints.
110
- 3. Run verification commands and capture outcomes.
111
- 4. Report findings first (bugs/regressions), then summarize changes.
112
- ${aidenidGuidance}
113
- ## Source Spec (Authoritative)
114
- \n\`\`\`markdown
115
- ${specText}
116
- \`\`\`
117
- `;
118
- }
1
+ export const SUPPORTED_PROMPT_TARGETS = Object.freeze([
2
+ "claude",
3
+ "cursor",
4
+ "copilot",
5
+ "codex",
6
+ "generic",
7
+ ]);
8
+
9
+ const TARGET_GUIDANCE = Object.freeze({
10
+ claude: [
11
+ "Use strict PR-scoped execution with explicit plan -> implement -> verify loop.",
12
+ "Prioritize deterministic checks before optional AI-dependent steps.",
13
+ "Record evidence for every claim in the final report.",
14
+ ],
15
+ cursor: [
16
+ "Apply edits in small, reviewable commits.",
17
+ "Keep changes aligned with existing project conventions and tests.",
18
+ "Run local verification before proposing follow-up iterations.",
19
+ ],
20
+ copilot: [
21
+ "Generate code with strong type and error-path handling.",
22
+ "Avoid introducing implicit behavior changes in existing modules.",
23
+ "Include targeted tests for all new logic paths.",
24
+ ],
25
+ codex: [
26
+ "Operate autonomously but keep one PR scope at a time.",
27
+ "Use deterministic ingest/spec context as primary source of truth.",
28
+ "Fail closed when requirements are ambiguous or unsafe.",
29
+ ],
30
+ generic: [
31
+ "Follow the provided spec exactly.",
32
+ "Implement in incremental, verifiable steps.",
33
+ "Document assumptions and unresolved risks.",
34
+ ],
35
+ });
36
+
37
+ function normalizeTarget(target) {
38
+ const normalized = String(target || "generic").trim().toLowerCase();
39
+ if (!SUPPORTED_PROMPT_TARGETS.includes(normalized)) {
40
+ throw new Error(
41
+ `Unsupported prompt target '${target}'. Use one of: ${SUPPORTED_PROMPT_TARGETS.join(", ")}`
42
+ );
43
+ }
44
+ return normalized;
45
+ }
46
+
47
+ function buildAgentHeader(target) {
48
+ const headers = {
49
+ claude: "Claude Code execution prompt",
50
+ cursor: "Cursor execution prompt",
51
+ copilot: "GitHub Copilot execution prompt",
52
+ codex: "Codex execution prompt",
53
+ generic: "Generic execution prompt",
54
+ };
55
+ return headers[target] || headers.generic;
56
+ }
57
+
58
+ export function resolvePromptTarget(target) {
59
+ return normalizeTarget(target);
60
+ }
61
+
62
+ export function defaultPromptFileName(target) {
63
+ const normalized = normalizeTarget(target);
64
+ if (normalized === "generic") {
65
+ return "PROMPT.md";
66
+ }
67
+ return `PROMPT_${normalized}.md`;
68
+ }
69
+
70
+ export function generateExecutionPrompt({
71
+ specMarkdown,
72
+ target = "generic",
73
+ projectPath,
74
+ generatedAt = new Date().toISOString(),
75
+ } = {}) {
76
+ const resolvedTarget = normalizeTarget(target);
77
+ const guidance = TARGET_GUIDANCE[resolvedTarget] || TARGET_GUIDANCE.generic;
78
+
79
+ const specText = String(specMarkdown || "").trim();
80
+ if (!specText) {
81
+ throw new Error("Spec content is empty. Generate or provide a spec before creating a prompt.");
82
+ }
83
+
84
+ const guidanceMarkdown = guidance.map((item, index) => `${index + 1}. ${item}`).join("\n");
85
+
86
+ const hasAidenId = specText.toLowerCase().includes("aidenid");
87
+ const aidenidGuidance = hasAidenId
88
+ ? `
89
+ ## AIdenID E2E Testing
90
+ - AIdenID credentials are auto-provisioned via \`sl auth login\`. No manual env vars needed.
91
+ - Run \`sl auth status\` to confirm AIdenID is provisioned before using identity commands.
92
+ - Use \`sl ai provision-email --execute --json\` to create ephemeral test emails.
93
+ - Use \`sl ai identity wait-for-otp <identityId> --timeout 30\` to poll for OTP extraction.
94
+ - Revoke test identities after verification: \`sl ai identity revoke <identityId>\`.
95
+ `
96
+ : "";
97
+
98
+ return `# ${buildAgentHeader(resolvedTarget)}
99
+
100
+ Generated: ${generatedAt}
101
+ Agent target: ${resolvedTarget}
102
+ Workspace: ${projectPath || "(not provided)"}
103
+
104
+ ## Operating Rules
105
+ ${guidanceMarkdown}
106
+
107
+ ## Execution Workflow
108
+ 1. Read the full spec and derive a concrete PR-scoped implementation plan.
109
+ 2. Implement only the current scope with deterministic checkpoints.
110
+ 3. Run verification commands and capture outcomes.
111
+ 4. Report findings first (bugs/regressions), then summarize changes.
112
+ ${aidenidGuidance}
113
+ ## Source Spec (Authoritative)
114
+ \n\`\`\`markdown
115
+ ${specText}
116
+ \`\`\`
117
+ `;
118
+ }