@martinloop/mcp 0.2.5 → 0.2.7

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 (44) hide show
  1. package/README.md +101 -138
  2. package/dist/discovery-metadata.d.ts +10 -5
  3. package/dist/discovery-metadata.js +95 -5
  4. package/dist/package-version.d.ts +1 -1
  5. package/dist/package-version.js +1 -1
  6. package/dist/prompts.js +93 -1
  7. package/dist/resources.d.ts +8 -0
  8. package/dist/resources.js +245 -14
  9. package/dist/server-validation.d.ts +1 -1
  10. package/dist/server-validation.js +116 -0
  11. package/dist/server.js +361 -3
  12. package/dist/tools/doctor.d.ts +2 -0
  13. package/dist/tools/doctor.js +6 -2
  14. package/dist/tools/eval.d.ts +24 -0
  15. package/dist/tools/eval.js +65 -0
  16. package/dist/tools/get-status.d.ts +8 -0
  17. package/dist/tools/get-status.js +18 -0
  18. package/dist/tools/logs.d.ts +25 -0
  19. package/dist/tools/logs.js +49 -0
  20. package/dist/tools/plan.d.ts +20 -0
  21. package/dist/tools/plan.js +10 -0
  22. package/dist/tools/pr-tools.d.ts +31 -0
  23. package/dist/tools/pr-tools.js +111 -0
  24. package/dist/tools/preflight.d.ts +10 -0
  25. package/dist/tools/preflight.js +11 -2
  26. package/dist/tools/run-controls.d.ts +36 -0
  27. package/dist/tools/run-controls.js +88 -0
  28. package/dist/tools/run-dossier.d.ts +14 -0
  29. package/dist/tools/run-dossier.js +61 -1
  30. package/dist/tools/run-loop.js +21 -2
  31. package/dist/tools/tool-errors.d.ts +1 -1
  32. package/dist/tools/tool-support.js +28 -1
  33. package/dist/tools/workflow-governance.d.ts +133 -0
  34. package/dist/tools/workflow-governance.js +581 -0
  35. package/dist/vendor/adapters/cli-bridge.d.ts +5 -0
  36. package/dist/vendor/adapters/cli-bridge.js +16 -8
  37. package/dist/vendor/adapters/index.d.ts +2 -1
  38. package/dist/vendor/adapters/index.js +2 -0
  39. package/dist/vendor/adapters/openai-compatible.d.ts +47 -0
  40. package/dist/vendor/adapters/openai-compatible.js +242 -0
  41. package/dist/workflow-state.d.ts +25 -0
  42. package/dist/workflow-state.js +102 -0
  43. package/package.json +3 -3
  44. package/server.json +2 -2
@@ -272,18 +272,45 @@ export function buildSuggestedResourceUris(loopId) {
272
272
  "martin://server/health",
273
273
  "martin://runs/recent",
274
274
  "martin://runs/triage",
275
+ "martin://runs/latest",
276
+ "martin://runs/latest/summary",
277
+ "martin://runs/latest/proof-card",
278
+ "martin://runs/latest/budget-status",
279
+ "martin://runs/latest/verifier-evidence",
280
+ "martin://runs/latest/rollback-evidence",
281
+ "martin://policies/current",
282
+ "martin://repo/risk-map",
283
+ "martin://verifiers/results",
284
+ "martin://agent/next-step",
275
285
  `martin://runs/${loopId}`,
286
+ `martin://runs/${loopId}/dossier`,
276
287
  `martin://runs/${loopId}/verification`,
277
288
  "martin://guides/mcp-usage",
289
+ "martin://guides/agent-start",
290
+ "martin://guides/command-map",
291
+ "martin://guides/ide-onboarding",
292
+ "martin://guides/operating-rules",
278
293
  "martin://guides/publish-readiness"
279
294
  ];
280
295
  }
281
296
  export function buildSuggestedPromptNames() {
282
297
  return [
298
+ "martin_start",
299
+ "martin_preflight",
300
+ "martin_triage",
301
+ "martin_resume",
302
+ "martin_prove",
303
+ "martin_release_check",
283
304
  "martin_governed_coding_kickoff",
284
305
  "martin_debug_failed_run",
285
306
  "martin_publish_readiness_review",
286
- "martin_triage_run_store"
307
+ "martin_triage_run_store",
308
+ "safe_bug_fix",
309
+ "write_tests_first",
310
+ "small_refactor",
311
+ "security_review",
312
+ "pr_review",
313
+ "release_check"
287
314
  ];
288
315
  }
289
316
  function countBy(values, key) {
@@ -0,0 +1,133 @@
1
+ import { type RunStoreInspection } from "./tool-support.js";
2
+ export type MartinPolicyPack = "solo-founder" | "startup-team" | "enterprise-strict" | "oss-maintainer" | "security-sensitive";
3
+ export interface RepoGitState {
4
+ available: boolean;
5
+ isRepo: boolean;
6
+ clean: boolean;
7
+ branch?: string;
8
+ upstream?: string;
9
+ ahead?: number;
10
+ behind?: number;
11
+ }
12
+ export interface RepoSignals {
13
+ workingDirectory: string;
14
+ packageManager: "pnpm" | "npm" | "yarn" | "bun" | "unknown";
15
+ languages: string[];
16
+ frameworks: string[];
17
+ verifiers: {
18
+ test: string[];
19
+ lint: string[];
20
+ build: string[];
21
+ defaultPlan: string[];
22
+ };
23
+ packageScripts: Record<string, string>;
24
+ git: RepoGitState;
25
+ sensitivePaths: string[];
26
+ availableHosts: Record<"claude" | "codex" | "cursor" | "gemini", {
27
+ available: boolean;
28
+ detail: string;
29
+ resolvedPath?: string;
30
+ }>;
31
+ }
32
+ export interface MartinRiskAssessment {
33
+ score: number;
34
+ level: "low" | "medium" | "high";
35
+ reasons: string[];
36
+ recommendedAction: "proceed" | "review" | "require_human_approval";
37
+ }
38
+ export interface MartinPolicyPackDefinition {
39
+ name: MartinPolicyPack;
40
+ summary: string;
41
+ defaultVerifiers: string[];
42
+ defaultAllowedPaths: string[];
43
+ defaultBlockedPaths: string[];
44
+ dossierExpectations: string[];
45
+ requireApprovalAtOrAbove: MartinRiskAssessment["level"];
46
+ }
47
+ export interface MartinPlanBudget {
48
+ maxUsd: number;
49
+ softLimitUsd: number;
50
+ maxIterations: number;
51
+ maxTokens: number;
52
+ maxMinutes: number;
53
+ maxFilesChanged: number;
54
+ maxCommands: number;
55
+ }
56
+ export interface MartinRunContract {
57
+ objective: string;
58
+ context?: string;
59
+ allowedPaths: string[];
60
+ blockedPaths: string[];
61
+ budget: MartinPlanBudget;
62
+ verifiers: string[];
63
+ risk: MartinRiskAssessment;
64
+ policyPack: MartinPolicyPack;
65
+ requiresApproval: boolean;
66
+ }
67
+ export interface MartinPlanProposal {
68
+ objective: string;
69
+ implementationSummary: string;
70
+ proposedFileScope: {
71
+ allowedPaths: string[];
72
+ blockedPaths: string[];
73
+ };
74
+ proposedVerifiers: string[];
75
+ estimatedBudget: MartinPlanBudget;
76
+ risk: MartinRiskAssessment;
77
+ approvalRecommendation: "not_required" | "recommended" | "required";
78
+ policyPack: MartinPolicyPackDefinition;
79
+ nextSteps: string[];
80
+ }
81
+ export interface MartinReadinessReport {
82
+ score: number;
83
+ level: "low" | "medium" | "high";
84
+ missingSafeguards: string[];
85
+ repo: {
86
+ git: RepoGitState;
87
+ packageManager: RepoSignals["packageManager"];
88
+ languages: string[];
89
+ frameworks: string[];
90
+ };
91
+ safeguards: {
92
+ verifierDetected: boolean;
93
+ repoScoped: boolean;
94
+ branchSafe: boolean;
95
+ runStoreHealthy: boolean;
96
+ };
97
+ availableHosts: RepoSignals["availableHosts"];
98
+ }
99
+ interface ContractOverrides {
100
+ objective: string;
101
+ context?: string;
102
+ verificationPlan?: string[];
103
+ allowedPaths?: string[];
104
+ deniedPaths?: string[];
105
+ policyPack?: MartinPolicyPack;
106
+ maxUsd?: number;
107
+ maxIterations?: number;
108
+ maxTokens?: number;
109
+ maxMinutes?: number;
110
+ maxFilesChanged?: number;
111
+ maxCommands?: number;
112
+ }
113
+ export declare function inspectRepoSignals(workingDirectory: string): RepoSignals;
114
+ export declare function buildReadinessReport(signals: RepoSignals, runStore: RunStoreInspection): MartinReadinessReport;
115
+ export declare function buildPolicyPackDefinition(policyPack: MartinPolicyPack | undefined, signals: RepoSignals): MartinPolicyPackDefinition;
116
+ export declare function buildPlanProposal(workingDirectory: string, overrides: ContractOverrides): MartinPlanProposal;
117
+ export declare function buildRunContract(workingDirectory: string, overrides: ContractOverrides): MartinRunContract;
118
+ export declare function assessRunRisk(input: {
119
+ objective: string;
120
+ context?: string;
121
+ allowedPaths: string[];
122
+ blockedPaths: string[];
123
+ verifiers: string[];
124
+ signals: RepoSignals;
125
+ }): MartinRiskAssessment;
126
+ export declare function buildRepoRiskMap(signals: RepoSignals): {
127
+ workingDirectory: string;
128
+ packageManager: RepoSignals["packageManager"];
129
+ frameworks: string[];
130
+ sensitivePaths: string[];
131
+ recommendedPolicyPack: MartinPolicyPack;
132
+ };
133
+ export {};