mrvn-cli 0.1.4 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +16 -2
- package/dist/index.js +343 -117
- package/dist/index.js.map +1 -1
- package/dist/marvin-serve.js +87 -3
- package/dist/marvin-serve.js.map +1 -1
- package/dist/marvin.js +342 -119
- package/dist/marvin.js.map +1 -1
- package/dist/skills/builtin/governance-review/SKILL.md +11 -0
- package/dist/skills/builtin/governance-review/actions.yaml +21 -0
- package/dist/skills/builtin/governance-review/personas/delivery-manager.md +1 -0
- package/dist/skills/builtin/governance-review/personas/product-owner.md +1 -0
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -14902,7 +14902,7 @@ import * as readline from "readline";
|
|
|
14902
14902
|
import chalk from "chalk";
|
|
14903
14903
|
import ora from "ora";
|
|
14904
14904
|
import {
|
|
14905
|
-
query as
|
|
14905
|
+
query as query2
|
|
14906
14906
|
} from "@anthropic-ai/claude-agent-sdk";
|
|
14907
14907
|
|
|
14908
14908
|
// src/storage/session-store.ts
|
|
@@ -16863,7 +16863,9 @@ function getPluginPromptFragment(plugin, personaId) {
|
|
|
16863
16863
|
// src/skills/registry.ts
|
|
16864
16864
|
import * as fs7 from "fs";
|
|
16865
16865
|
import * as path7 from "path";
|
|
16866
|
+
import { fileURLToPath } from "url";
|
|
16866
16867
|
import * as YAML5 from "yaml";
|
|
16868
|
+
import matter2 from "gray-matter";
|
|
16867
16869
|
|
|
16868
16870
|
// src/skills/builtin/governance-review.ts
|
|
16869
16871
|
var governanceReviewSkill = {
|
|
@@ -16871,6 +16873,7 @@ var governanceReviewSkill = {
|
|
|
16871
16873
|
name: "Governance Review",
|
|
16872
16874
|
description: "Review open governance items and generate summaries",
|
|
16873
16875
|
version: "1.0.0",
|
|
16876
|
+
format: "builtin-ts",
|
|
16874
16877
|
personas: ["delivery-manager", "product-owner"],
|
|
16875
16878
|
promptFragments: {
|
|
16876
16879
|
"delivery-manager": `You have the **Governance Review** skill. You can proactively review all open governance items (decisions, actions, questions) and produce structured summaries with recommendations. Use the \`governance-review__summarize\` tool to run a comprehensive review.`,
|
|
@@ -16905,11 +16908,98 @@ Be thorough but concise. Focus on actionable insights.`,
|
|
|
16905
16908
|
var BUILTIN_SKILLS = {
|
|
16906
16909
|
"governance-review": governanceReviewSkill
|
|
16907
16910
|
};
|
|
16911
|
+
var GOVERNANCE_TOOL_NAMES = [
|
|
16912
|
+
"mcp__marvin-governance__list_decisions",
|
|
16913
|
+
"mcp__marvin-governance__get_decision",
|
|
16914
|
+
"mcp__marvin-governance__create_decision",
|
|
16915
|
+
"mcp__marvin-governance__update_decision",
|
|
16916
|
+
"mcp__marvin-governance__list_actions",
|
|
16917
|
+
"mcp__marvin-governance__get_action",
|
|
16918
|
+
"mcp__marvin-governance__create_action",
|
|
16919
|
+
"mcp__marvin-governance__update_action",
|
|
16920
|
+
"mcp__marvin-governance__list_questions",
|
|
16921
|
+
"mcp__marvin-governance__get_question",
|
|
16922
|
+
"mcp__marvin-governance__create_question",
|
|
16923
|
+
"mcp__marvin-governance__update_question",
|
|
16924
|
+
"mcp__marvin-governance__search_documents",
|
|
16925
|
+
"mcp__marvin-governance__read_document",
|
|
16926
|
+
"mcp__marvin-governance__project_summary"
|
|
16927
|
+
];
|
|
16928
|
+
function getBuiltinSkillsDir() {
|
|
16929
|
+
const thisFile = fileURLToPath(import.meta.url);
|
|
16930
|
+
return path7.join(path7.dirname(thisFile), "builtin");
|
|
16931
|
+
}
|
|
16932
|
+
function loadSkillFromDirectory(dirPath) {
|
|
16933
|
+
const skillMdPath = path7.join(dirPath, "SKILL.md");
|
|
16934
|
+
if (!fs7.existsSync(skillMdPath)) return void 0;
|
|
16935
|
+
try {
|
|
16936
|
+
const raw = fs7.readFileSync(skillMdPath, "utf-8");
|
|
16937
|
+
const { data, content } = matter2(raw);
|
|
16938
|
+
if (!data.name || !data.description) return void 0;
|
|
16939
|
+
const metadata = data.metadata ?? {};
|
|
16940
|
+
const version2 = metadata.version ?? "1.0.0";
|
|
16941
|
+
const personas = metadata.personas;
|
|
16942
|
+
const promptFragments = {};
|
|
16943
|
+
const wildcardPrompt = content.trim();
|
|
16944
|
+
if (wildcardPrompt) {
|
|
16945
|
+
promptFragments["*"] = wildcardPrompt;
|
|
16946
|
+
}
|
|
16947
|
+
const personasDir = path7.join(dirPath, "personas");
|
|
16948
|
+
if (fs7.existsSync(personasDir)) {
|
|
16949
|
+
try {
|
|
16950
|
+
for (const file2 of fs7.readdirSync(personasDir)) {
|
|
16951
|
+
if (!file2.endsWith(".md")) continue;
|
|
16952
|
+
const personaId = file2.replace(/\.md$/, "");
|
|
16953
|
+
const personaPrompt = fs7.readFileSync(path7.join(personasDir, file2), "utf-8").trim();
|
|
16954
|
+
if (personaPrompt) {
|
|
16955
|
+
promptFragments[personaId] = personaPrompt;
|
|
16956
|
+
}
|
|
16957
|
+
}
|
|
16958
|
+
} catch {
|
|
16959
|
+
}
|
|
16960
|
+
}
|
|
16961
|
+
let actions;
|
|
16962
|
+
const actionsPath = path7.join(dirPath, "actions.yaml");
|
|
16963
|
+
if (fs7.existsSync(actionsPath)) {
|
|
16964
|
+
try {
|
|
16965
|
+
const actionsRaw = fs7.readFileSync(actionsPath, "utf-8");
|
|
16966
|
+
actions = YAML5.parse(actionsRaw);
|
|
16967
|
+
} catch {
|
|
16968
|
+
}
|
|
16969
|
+
}
|
|
16970
|
+
return {
|
|
16971
|
+
id: data.name,
|
|
16972
|
+
name: data.name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
|
|
16973
|
+
description: data.description,
|
|
16974
|
+
version: version2,
|
|
16975
|
+
format: "skill-md",
|
|
16976
|
+
dirPath,
|
|
16977
|
+
personas,
|
|
16978
|
+
promptFragments: Object.keys(promptFragments).length > 0 ? promptFragments : void 0,
|
|
16979
|
+
actions
|
|
16980
|
+
};
|
|
16981
|
+
} catch {
|
|
16982
|
+
return void 0;
|
|
16983
|
+
}
|
|
16984
|
+
}
|
|
16908
16985
|
function loadAllSkills(marvinDir) {
|
|
16909
16986
|
const skills = /* @__PURE__ */ new Map();
|
|
16910
16987
|
for (const [id, skill] of Object.entries(BUILTIN_SKILLS)) {
|
|
16911
16988
|
skills.set(id, skill);
|
|
16912
16989
|
}
|
|
16990
|
+
try {
|
|
16991
|
+
const builtinDir = getBuiltinSkillsDir();
|
|
16992
|
+
if (fs7.existsSync(builtinDir)) {
|
|
16993
|
+
for (const entry of fs7.readdirSync(builtinDir)) {
|
|
16994
|
+
const entryPath = path7.join(builtinDir, entry);
|
|
16995
|
+
if (!fs7.statSync(entryPath).isDirectory()) continue;
|
|
16996
|
+
if (skills.has(entry)) continue;
|
|
16997
|
+
const skill = loadSkillFromDirectory(entryPath);
|
|
16998
|
+
if (skill) skills.set(skill.id, skill);
|
|
16999
|
+
}
|
|
17000
|
+
}
|
|
17001
|
+
} catch {
|
|
17002
|
+
}
|
|
16913
17003
|
if (marvinDir) {
|
|
16914
17004
|
const skillsDir = path7.join(marvinDir, "skills");
|
|
16915
17005
|
if (fs7.existsSync(skillsDir)) {
|
|
@@ -16919,10 +17009,20 @@ function loadAllSkills(marvinDir) {
|
|
|
16919
17009
|
} catch {
|
|
16920
17010
|
entries = [];
|
|
16921
17011
|
}
|
|
16922
|
-
for (const
|
|
16923
|
-
|
|
17012
|
+
for (const entry of entries) {
|
|
17013
|
+
const entryPath = path7.join(skillsDir, entry);
|
|
17014
|
+
try {
|
|
17015
|
+
if (fs7.statSync(entryPath).isDirectory()) {
|
|
17016
|
+
const skill = loadSkillFromDirectory(entryPath);
|
|
17017
|
+
if (skill) skills.set(skill.id, skill);
|
|
17018
|
+
continue;
|
|
17019
|
+
}
|
|
17020
|
+
} catch {
|
|
17021
|
+
continue;
|
|
17022
|
+
}
|
|
17023
|
+
if (!entry.endsWith(".yaml") && !entry.endsWith(".yml")) continue;
|
|
16924
17024
|
try {
|
|
16925
|
-
const raw = fs7.readFileSync(
|
|
17025
|
+
const raw = fs7.readFileSync(entryPath, "utf-8");
|
|
16926
17026
|
const parsed = YAML5.parse(raw);
|
|
16927
17027
|
if (!parsed?.id || !parsed?.name || !parsed?.version) continue;
|
|
16928
17028
|
const skill = {
|
|
@@ -16930,6 +17030,7 @@ function loadAllSkills(marvinDir) {
|
|
|
16930
17030
|
name: parsed.name,
|
|
16931
17031
|
description: parsed.description ?? "",
|
|
16932
17032
|
version: parsed.version,
|
|
17033
|
+
format: "yaml",
|
|
16933
17034
|
personas: parsed.personas,
|
|
16934
17035
|
promptFragments: parsed.promptFragments,
|
|
16935
17036
|
actions: parsed.actions
|
|
@@ -16992,91 +17093,73 @@ function listAllSkillInfo(allSkills, skillsConfig, personaIds) {
|
|
|
16992
17093
|
name: skill.name,
|
|
16993
17094
|
version: skill.version,
|
|
16994
17095
|
description: skill.description,
|
|
17096
|
+
format: skill.format,
|
|
16995
17097
|
assignedPersonas
|
|
16996
17098
|
});
|
|
16997
17099
|
}
|
|
16998
17100
|
return result;
|
|
16999
17101
|
}
|
|
17000
|
-
|
|
17001
|
-
|
|
17002
|
-
|
|
17003
|
-
|
|
17004
|
-
|
|
17005
|
-
|
|
17006
|
-
|
|
17007
|
-
|
|
17008
|
-
|
|
17009
|
-
|
|
17010
|
-
"mcp__marvin-governance__update_decision",
|
|
17011
|
-
"mcp__marvin-governance__list_actions",
|
|
17012
|
-
"mcp__marvin-governance__get_action",
|
|
17013
|
-
"mcp__marvin-governance__create_action",
|
|
17014
|
-
"mcp__marvin-governance__update_action",
|
|
17015
|
-
"mcp__marvin-governance__list_questions",
|
|
17016
|
-
"mcp__marvin-governance__get_question",
|
|
17017
|
-
"mcp__marvin-governance__create_question",
|
|
17018
|
-
"mcp__marvin-governance__update_question",
|
|
17019
|
-
"mcp__marvin-governance__search_documents",
|
|
17020
|
-
"mcp__marvin-governance__read_document",
|
|
17021
|
-
"mcp__marvin-governance__project_summary"
|
|
17022
|
-
];
|
|
17023
|
-
async function runSkillAction(action, userPrompt, context) {
|
|
17024
|
-
try {
|
|
17025
|
-
const mcpServer = createMarvinMcpServer(context.store);
|
|
17026
|
-
const allowedTools = action.allowGovernanceTools !== false ? GOVERNANCE_TOOL_NAMES : [];
|
|
17027
|
-
const conversation = query2({
|
|
17028
|
-
prompt: userPrompt,
|
|
17029
|
-
options: {
|
|
17030
|
-
systemPrompt: action.systemPrompt,
|
|
17031
|
-
mcpServers: { "marvin-governance": mcpServer },
|
|
17102
|
+
function getSkillAgentDefinitions(skillIds, allSkills) {
|
|
17103
|
+
const agents = {};
|
|
17104
|
+
for (const id of skillIds) {
|
|
17105
|
+
const skill = allSkills.get(id);
|
|
17106
|
+
if (!skill?.actions) continue;
|
|
17107
|
+
for (const action of skill.actions) {
|
|
17108
|
+
const agentKey = `${skill.id}__${action.id}`;
|
|
17109
|
+
agents[agentKey] = {
|
|
17110
|
+
description: action.description,
|
|
17111
|
+
prompt: action.systemPrompt,
|
|
17032
17112
|
maxTurns: action.maxTurns ?? 5,
|
|
17033
|
-
|
|
17034
|
-
|
|
17035
|
-
|
|
17036
|
-
|
|
17037
|
-
|
|
17038
|
-
|
|
17039
|
-
|
|
17040
|
-
|
|
17041
|
-
|
|
17042
|
-
|
|
17043
|
-
|
|
17113
|
+
tools: action.allowGovernanceTools !== false ? GOVERNANCE_TOOL_NAMES : []
|
|
17114
|
+
};
|
|
17115
|
+
}
|
|
17116
|
+
}
|
|
17117
|
+
return agents;
|
|
17118
|
+
}
|
|
17119
|
+
function migrateYamlToSkillMd(yamlPath, outputDir) {
|
|
17120
|
+
const raw = fs7.readFileSync(yamlPath, "utf-8");
|
|
17121
|
+
const parsed = YAML5.parse(raw);
|
|
17122
|
+
if (!parsed?.id || !parsed?.name) {
|
|
17123
|
+
throw new Error(`Invalid skill YAML: missing required fields (id, name)`);
|
|
17124
|
+
}
|
|
17125
|
+
fs7.mkdirSync(outputDir, { recursive: true });
|
|
17126
|
+
const frontmatter = {
|
|
17127
|
+
name: parsed.id,
|
|
17128
|
+
description: parsed.description ?? ""
|
|
17129
|
+
};
|
|
17130
|
+
const metadata = {};
|
|
17131
|
+
if (parsed.version) metadata.version = parsed.version;
|
|
17132
|
+
if (parsed.personas) metadata.personas = parsed.personas;
|
|
17133
|
+
if (Object.keys(metadata).length > 0) frontmatter.metadata = metadata;
|
|
17134
|
+
const promptFragments = parsed.promptFragments;
|
|
17135
|
+
const wildcardPrompt = promptFragments?.["*"] ?? "";
|
|
17136
|
+
const skillMd = matter2.stringify(wildcardPrompt ? `
|
|
17137
|
+
${wildcardPrompt}
|
|
17138
|
+
` : "\n", frontmatter);
|
|
17139
|
+
fs7.writeFileSync(path7.join(outputDir, "SKILL.md"), skillMd, "utf-8");
|
|
17140
|
+
if (promptFragments) {
|
|
17141
|
+
const personaKeys = Object.keys(promptFragments).filter((k) => k !== "*");
|
|
17142
|
+
if (personaKeys.length > 0) {
|
|
17143
|
+
const personasDir = path7.join(outputDir, "personas");
|
|
17144
|
+
fs7.mkdirSync(personasDir, { recursive: true });
|
|
17145
|
+
for (const personaId of personaKeys) {
|
|
17146
|
+
fs7.writeFileSync(
|
|
17147
|
+
path7.join(personasDir, `${personaId}.md`),
|
|
17148
|
+
`${promptFragments[personaId]}
|
|
17149
|
+
`,
|
|
17150
|
+
"utf-8"
|
|
17044
17151
|
);
|
|
17045
|
-
for (const block of textBlocks) {
|
|
17046
|
-
textParts.push(block.text);
|
|
17047
|
-
}
|
|
17048
17152
|
}
|
|
17049
17153
|
}
|
|
17050
|
-
return {
|
|
17051
|
-
content: [{ type: "text", text: textParts.join("\n") || "Action completed with no output." }]
|
|
17052
|
-
};
|
|
17053
|
-
} catch (err) {
|
|
17054
|
-
return {
|
|
17055
|
-
content: [{ type: "text", text: `Skill action failed: ${err}` }],
|
|
17056
|
-
isError: true
|
|
17057
|
-
};
|
|
17058
17154
|
}
|
|
17059
|
-
|
|
17060
|
-
|
|
17061
|
-
|
|
17062
|
-
|
|
17063
|
-
|
|
17064
|
-
|
|
17065
|
-
|
|
17066
|
-
for (const action of skill.actions) {
|
|
17067
|
-
tools.push(
|
|
17068
|
-
tool16(
|
|
17069
|
-
`${skill.id}__${action.id}`,
|
|
17070
|
-
action.description,
|
|
17071
|
-
{
|
|
17072
|
-
prompt: external_exports.string().describe("What you want this action to do")
|
|
17073
|
-
},
|
|
17074
|
-
async (args) => runSkillAction(action, args.prompt, context)
|
|
17075
|
-
)
|
|
17076
|
-
);
|
|
17077
|
-
}
|
|
17155
|
+
const actions = parsed.actions;
|
|
17156
|
+
if (actions && actions.length > 0) {
|
|
17157
|
+
fs7.writeFileSync(
|
|
17158
|
+
path7.join(outputDir, "actions.yaml"),
|
|
17159
|
+
YAML5.stringify(actions),
|
|
17160
|
+
"utf-8"
|
|
17161
|
+
);
|
|
17078
17162
|
}
|
|
17079
|
-
return tools;
|
|
17080
17163
|
}
|
|
17081
17164
|
|
|
17082
17165
|
// src/agent/session.ts
|
|
@@ -17094,15 +17177,14 @@ async function startSession(options) {
|
|
|
17094
17177
|
const allSkills = loadAllSkills(marvinDir);
|
|
17095
17178
|
const skillIds = resolveSkillsForPersona(persona.id, config2.project.skills, allSkills);
|
|
17096
17179
|
const codeSkillTools = getSkillTools(skillIds, allSkills, store);
|
|
17097
|
-
const
|
|
17098
|
-
const actionTools = createSkillActionTools(skillsWithActions, { store, marvinDir, projectRoot });
|
|
17180
|
+
const skillAgents = getSkillAgentDefinitions(skillIds, allSkills);
|
|
17099
17181
|
const skillPromptFragment = getSkillPromptFragment(skillIds, allSkills, persona.id);
|
|
17100
17182
|
const mcpServer = createMarvinMcpServer(store, {
|
|
17101
17183
|
manifest,
|
|
17102
17184
|
sourcesDir: hasSourcesDir ? sourcesDir : void 0,
|
|
17103
17185
|
sessionStore,
|
|
17104
17186
|
pluginTools,
|
|
17105
|
-
skillTools:
|
|
17187
|
+
skillTools: codeSkillTools
|
|
17106
17188
|
});
|
|
17107
17189
|
const systemPrompt = buildSystemPrompt(persona, config2.project, pluginPromptFragment, skillPromptFragment);
|
|
17108
17190
|
let existingSession;
|
|
@@ -17192,14 +17274,16 @@ Marvin \u2014 ${persona.name}
|
|
|
17192
17274
|
"mcp__marvin-governance__get_session",
|
|
17193
17275
|
"mcp__marvin-governance__analyze_meeting",
|
|
17194
17276
|
...pluginTools.map((t) => `mcp__marvin-governance__${t.name}`),
|
|
17195
|
-
...codeSkillTools.map((t) => `mcp__marvin-governance__${t.name}`)
|
|
17196
|
-
...actionTools.map((t) => `mcp__marvin-governance__${t.name}`)
|
|
17277
|
+
...codeSkillTools.map((t) => `mcp__marvin-governance__${t.name}`)
|
|
17197
17278
|
]
|
|
17198
17279
|
};
|
|
17280
|
+
if (Object.keys(skillAgents).length > 0) {
|
|
17281
|
+
queryOptions.agents = skillAgents;
|
|
17282
|
+
}
|
|
17199
17283
|
if (existingSession) {
|
|
17200
17284
|
queryOptions.resume = existingSession.id;
|
|
17201
17285
|
}
|
|
17202
|
-
const conversation =
|
|
17286
|
+
const conversation = query2({
|
|
17203
17287
|
prompt,
|
|
17204
17288
|
options: queryOptions
|
|
17205
17289
|
});
|
|
@@ -17286,6 +17370,89 @@ import * as fs9 from "fs";
|
|
|
17286
17370
|
import * as path9 from "path";
|
|
17287
17371
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
17288
17372
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
17373
|
+
|
|
17374
|
+
// src/skills/action-tools.ts
|
|
17375
|
+
import { tool as tool16 } from "@anthropic-ai/claude-agent-sdk";
|
|
17376
|
+
|
|
17377
|
+
// src/skills/action-runner.ts
|
|
17378
|
+
import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
|
|
17379
|
+
var GOVERNANCE_TOOL_NAMES2 = [
|
|
17380
|
+
"mcp__marvin-governance__list_decisions",
|
|
17381
|
+
"mcp__marvin-governance__get_decision",
|
|
17382
|
+
"mcp__marvin-governance__create_decision",
|
|
17383
|
+
"mcp__marvin-governance__update_decision",
|
|
17384
|
+
"mcp__marvin-governance__list_actions",
|
|
17385
|
+
"mcp__marvin-governance__get_action",
|
|
17386
|
+
"mcp__marvin-governance__create_action",
|
|
17387
|
+
"mcp__marvin-governance__update_action",
|
|
17388
|
+
"mcp__marvin-governance__list_questions",
|
|
17389
|
+
"mcp__marvin-governance__get_question",
|
|
17390
|
+
"mcp__marvin-governance__create_question",
|
|
17391
|
+
"mcp__marvin-governance__update_question",
|
|
17392
|
+
"mcp__marvin-governance__search_documents",
|
|
17393
|
+
"mcp__marvin-governance__read_document",
|
|
17394
|
+
"mcp__marvin-governance__project_summary"
|
|
17395
|
+
];
|
|
17396
|
+
async function runSkillAction(action, userPrompt, context) {
|
|
17397
|
+
try {
|
|
17398
|
+
const mcpServer = createMarvinMcpServer(context.store);
|
|
17399
|
+
const allowedTools = action.allowGovernanceTools !== false ? GOVERNANCE_TOOL_NAMES2 : [];
|
|
17400
|
+
const conversation = query3({
|
|
17401
|
+
prompt: userPrompt,
|
|
17402
|
+
options: {
|
|
17403
|
+
systemPrompt: action.systemPrompt,
|
|
17404
|
+
mcpServers: { "marvin-governance": mcpServer },
|
|
17405
|
+
maxTurns: action.maxTurns ?? 5,
|
|
17406
|
+
allowedTools,
|
|
17407
|
+
cwd: context.projectRoot,
|
|
17408
|
+
tools: [],
|
|
17409
|
+
permissionMode: "acceptEdits"
|
|
17410
|
+
}
|
|
17411
|
+
});
|
|
17412
|
+
const textParts = [];
|
|
17413
|
+
for await (const message of conversation) {
|
|
17414
|
+
if (message.type === "assistant") {
|
|
17415
|
+
const textBlocks = message.message.content.filter(
|
|
17416
|
+
(b) => b.type === "text"
|
|
17417
|
+
);
|
|
17418
|
+
for (const block of textBlocks) {
|
|
17419
|
+
textParts.push(block.text);
|
|
17420
|
+
}
|
|
17421
|
+
}
|
|
17422
|
+
}
|
|
17423
|
+
return {
|
|
17424
|
+
content: [{ type: "text", text: textParts.join("\n") || "Action completed with no output." }]
|
|
17425
|
+
};
|
|
17426
|
+
} catch (err) {
|
|
17427
|
+
return {
|
|
17428
|
+
content: [{ type: "text", text: `Skill action failed: ${err}` }],
|
|
17429
|
+
isError: true
|
|
17430
|
+
};
|
|
17431
|
+
}
|
|
17432
|
+
}
|
|
17433
|
+
|
|
17434
|
+
// src/skills/action-tools.ts
|
|
17435
|
+
function createSkillActionTools(skills, context) {
|
|
17436
|
+
const tools = [];
|
|
17437
|
+
for (const skill of skills) {
|
|
17438
|
+
if (!skill.actions) continue;
|
|
17439
|
+
for (const action of skill.actions) {
|
|
17440
|
+
tools.push(
|
|
17441
|
+
tool16(
|
|
17442
|
+
`${skill.id}__${action.id}`,
|
|
17443
|
+
action.description,
|
|
17444
|
+
{
|
|
17445
|
+
prompt: external_exports.string().describe("What you want this action to do")
|
|
17446
|
+
},
|
|
17447
|
+
async (args) => runSkillAction(action, args.prompt, context)
|
|
17448
|
+
)
|
|
17449
|
+
);
|
|
17450
|
+
}
|
|
17451
|
+
}
|
|
17452
|
+
return tools;
|
|
17453
|
+
}
|
|
17454
|
+
|
|
17455
|
+
// src/mcp/stdio-server.ts
|
|
17289
17456
|
function collectTools(marvinDir) {
|
|
17290
17457
|
const config2 = loadProjectConfig(marvinDir);
|
|
17291
17458
|
const plugin = resolvePlugin(config2.methodology);
|
|
@@ -18064,8 +18231,8 @@ var MarvinGit = class {
|
|
|
18064
18231
|
);
|
|
18065
18232
|
}
|
|
18066
18233
|
await this.git.init();
|
|
18067
|
-
const { writeFileSync:
|
|
18068
|
-
|
|
18234
|
+
const { writeFileSync: writeFileSync9 } = await import("fs");
|
|
18235
|
+
writeFileSync9(
|
|
18069
18236
|
path13.join(this.marvinDir, ".gitignore"),
|
|
18070
18237
|
MARVIN_GITIGNORE,
|
|
18071
18238
|
"utf-8"
|
|
@@ -18375,6 +18542,7 @@ async function serveCommand() {
|
|
|
18375
18542
|
import * as fs13 from "fs";
|
|
18376
18543
|
import * as path14 from "path";
|
|
18377
18544
|
import * as YAML7 from "yaml";
|
|
18545
|
+
import matter3 from "gray-matter";
|
|
18378
18546
|
import chalk10 from "chalk";
|
|
18379
18547
|
async function skillsListCommand() {
|
|
18380
18548
|
const project = loadProject();
|
|
@@ -18388,10 +18556,12 @@ async function skillsListCommand() {
|
|
|
18388
18556
|
}
|
|
18389
18557
|
console.log(chalk10.bold("\nAvailable Skills\n"));
|
|
18390
18558
|
const idWidth = Math.max(5, ...infos.map((s) => s.id.length));
|
|
18559
|
+
const fmtWidth = Math.max(6, ...infos.map((s) => s.format.length));
|
|
18391
18560
|
const verWidth = Math.max(7, ...infos.map((s) => s.version.length));
|
|
18392
18561
|
const descWidth = Math.max(11, ...infos.map((s) => s.description.length));
|
|
18393
18562
|
const header = [
|
|
18394
18563
|
"ID".padEnd(idWidth),
|
|
18564
|
+
"Format".padEnd(fmtWidth),
|
|
18395
18565
|
"Version".padEnd(verWidth),
|
|
18396
18566
|
"Description".padEnd(descWidth),
|
|
18397
18567
|
"Personas"
|
|
@@ -18403,6 +18573,7 @@ async function skillsListCommand() {
|
|
|
18403
18573
|
console.log(
|
|
18404
18574
|
[
|
|
18405
18575
|
info.id.padEnd(idWidth),
|
|
18576
|
+
info.format.padEnd(fmtWidth),
|
|
18406
18577
|
info.version.padEnd(verWidth),
|
|
18407
18578
|
info.description.padEnd(descWidth),
|
|
18408
18579
|
personas
|
|
@@ -18471,33 +18642,82 @@ async function skillsCreateCommand(name) {
|
|
|
18471
18642
|
const project = loadProject();
|
|
18472
18643
|
const skillsDir = path14.join(project.marvinDir, "skills");
|
|
18473
18644
|
fs13.mkdirSync(skillsDir, { recursive: true });
|
|
18474
|
-
const
|
|
18475
|
-
if (fs13.existsSync(
|
|
18476
|
-
console.log(chalk10.yellow(`Skill
|
|
18645
|
+
const skillDir = path14.join(skillsDir, name);
|
|
18646
|
+
if (fs13.existsSync(skillDir)) {
|
|
18647
|
+
console.log(chalk10.yellow(`Skill directory already exists: ${skillDir}`));
|
|
18477
18648
|
return;
|
|
18478
18649
|
}
|
|
18479
|
-
|
|
18480
|
-
|
|
18481
|
-
|
|
18650
|
+
fs13.mkdirSync(skillDir, { recursive: true });
|
|
18651
|
+
const displayName = name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
|
|
18652
|
+
const frontmatter = {
|
|
18653
|
+
name,
|
|
18482
18654
|
description: `Custom skill: ${name}`,
|
|
18483
|
-
|
|
18484
|
-
|
|
18485
|
-
|
|
18486
|
-
|
|
18487
|
-
},
|
|
18488
|
-
actions: [
|
|
18489
|
-
{
|
|
18490
|
-
id: "run",
|
|
18491
|
-
name: `Run ${name}`,
|
|
18492
|
-
description: `Execute the ${name} skill`,
|
|
18493
|
-
systemPrompt: "You are a helpful assistant. Complete the requested task using the available governance tools.",
|
|
18494
|
-
maxTurns: 5
|
|
18495
|
-
}
|
|
18496
|
-
]
|
|
18655
|
+
metadata: {
|
|
18656
|
+
version: "1.0.0",
|
|
18657
|
+
personas: ["product-owner"]
|
|
18658
|
+
}
|
|
18497
18659
|
};
|
|
18498
|
-
|
|
18499
|
-
|
|
18500
|
-
|
|
18660
|
+
const body = `
|
|
18661
|
+
You have the **${displayName}** skill.
|
|
18662
|
+
`;
|
|
18663
|
+
const skillMd = matter3.stringify(body, frontmatter);
|
|
18664
|
+
fs13.writeFileSync(path14.join(skillDir, "SKILL.md"), skillMd, "utf-8");
|
|
18665
|
+
const actions = [
|
|
18666
|
+
{
|
|
18667
|
+
id: "run",
|
|
18668
|
+
name: `Run ${name}`,
|
|
18669
|
+
description: `Execute the ${name} skill`,
|
|
18670
|
+
systemPrompt: "You are a helpful assistant. Complete the requested task using the available governance tools.",
|
|
18671
|
+
maxTurns: 5
|
|
18672
|
+
}
|
|
18673
|
+
];
|
|
18674
|
+
fs13.writeFileSync(path14.join(skillDir, "actions.yaml"), YAML7.stringify(actions), "utf-8");
|
|
18675
|
+
console.log(chalk10.green(`Created skill: ${skillDir}/`));
|
|
18676
|
+
console.log(chalk10.dim(" SKILL.md \u2014 skill definition and prompt"));
|
|
18677
|
+
console.log(chalk10.dim(" actions.yaml \u2014 action definitions"));
|
|
18678
|
+
console.log(chalk10.dim("\nAdd persona-specific prompts in personas/<persona-id>.md"));
|
|
18679
|
+
}
|
|
18680
|
+
async function skillsMigrateCommand() {
|
|
18681
|
+
const project = loadProject();
|
|
18682
|
+
const skillsDir = path14.join(project.marvinDir, "skills");
|
|
18683
|
+
if (!fs13.existsSync(skillsDir)) {
|
|
18684
|
+
console.log(chalk10.dim("No skills directory found."));
|
|
18685
|
+
return;
|
|
18686
|
+
}
|
|
18687
|
+
let entries;
|
|
18688
|
+
try {
|
|
18689
|
+
entries = fs13.readdirSync(skillsDir);
|
|
18690
|
+
} catch {
|
|
18691
|
+
console.log(chalk10.red("Could not read skills directory."));
|
|
18692
|
+
return;
|
|
18693
|
+
}
|
|
18694
|
+
const yamlFiles = entries.filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"));
|
|
18695
|
+
if (yamlFiles.length === 0) {
|
|
18696
|
+
console.log(chalk10.dim("No YAML skill files to migrate."));
|
|
18697
|
+
return;
|
|
18698
|
+
}
|
|
18699
|
+
let migrated = 0;
|
|
18700
|
+
for (const file2 of yamlFiles) {
|
|
18701
|
+
const yamlPath = path14.join(skillsDir, file2);
|
|
18702
|
+
const baseName = file2.replace(/\.(yaml|yml)$/, "");
|
|
18703
|
+
const outputDir = path14.join(skillsDir, baseName);
|
|
18704
|
+
if (fs13.existsSync(outputDir)) {
|
|
18705
|
+
console.log(chalk10.yellow(`Skipping "${file2}" \u2014 directory "${baseName}/" already exists.`));
|
|
18706
|
+
continue;
|
|
18707
|
+
}
|
|
18708
|
+
try {
|
|
18709
|
+
migrateYamlToSkillMd(yamlPath, outputDir);
|
|
18710
|
+
fs13.renameSync(yamlPath, `${yamlPath}.bak`);
|
|
18711
|
+
console.log(chalk10.green(`Migrated "${file2}" \u2192 "${baseName}/"`));
|
|
18712
|
+
migrated++;
|
|
18713
|
+
} catch (err) {
|
|
18714
|
+
console.log(chalk10.red(`Failed to migrate "${file2}": ${err}`));
|
|
18715
|
+
}
|
|
18716
|
+
}
|
|
18717
|
+
if (migrated > 0) {
|
|
18718
|
+
console.log(chalk10.dim(`
|
|
18719
|
+
${migrated} skill(s) migrated. Original files renamed to *.bak`));
|
|
18720
|
+
}
|
|
18501
18721
|
}
|
|
18502
18722
|
|
|
18503
18723
|
// src/cli/commands/import.ts
|
|
@@ -18508,12 +18728,12 @@ import chalk11 from "chalk";
|
|
|
18508
18728
|
// src/import/engine.ts
|
|
18509
18729
|
import * as fs15 from "fs";
|
|
18510
18730
|
import * as path16 from "path";
|
|
18511
|
-
import
|
|
18731
|
+
import matter5 from "gray-matter";
|
|
18512
18732
|
|
|
18513
18733
|
// src/import/classifier.ts
|
|
18514
18734
|
import * as fs14 from "fs";
|
|
18515
18735
|
import * as path15 from "path";
|
|
18516
|
-
import
|
|
18736
|
+
import matter4 from "gray-matter";
|
|
18517
18737
|
var RAW_SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".pdf", ".txt"]);
|
|
18518
18738
|
var CORE_DIR_NAMES = /* @__PURE__ */ new Set(["decisions", "actions", "questions"]);
|
|
18519
18739
|
var ID_PATTERN = /^[A-Z]+-\d{3,}$/;
|
|
@@ -18539,7 +18759,7 @@ function classifyPath(inputPath, knownTypes, knownDirNames) {
|
|
|
18539
18759
|
const hasMarvinDocs = mdFiles.some((f) => {
|
|
18540
18760
|
try {
|
|
18541
18761
|
const raw = fs14.readFileSync(path15.join(resolved, f), "utf-8");
|
|
18542
|
-
const { data } =
|
|
18762
|
+
const { data } = matter4(raw);
|
|
18543
18763
|
return isValidMarvinDocument(data, knownTypes);
|
|
18544
18764
|
} catch {
|
|
18545
18765
|
return false;
|
|
@@ -18560,7 +18780,7 @@ function classifyFile(filePath, knownTypes) {
|
|
|
18560
18780
|
if (ext === ".md") {
|
|
18561
18781
|
try {
|
|
18562
18782
|
const raw = fs14.readFileSync(resolved, "utf-8");
|
|
18563
|
-
const { data } =
|
|
18783
|
+
const { data } = matter4(raw);
|
|
18564
18784
|
if (isValidMarvinDocument(data, knownTypes)) {
|
|
18565
18785
|
return { type: "marvin-document", inputPath: resolved };
|
|
18566
18786
|
}
|
|
@@ -18771,7 +18991,7 @@ function collectMarvinDocs(dir, knownTypes) {
|
|
|
18771
18991
|
const filePath = path16.join(dir, file2);
|
|
18772
18992
|
try {
|
|
18773
18993
|
const raw = fs15.readFileSync(filePath, "utf-8");
|
|
18774
|
-
const { data, content } =
|
|
18994
|
+
const { data, content } = matter5(raw);
|
|
18775
18995
|
if (isValidMarvinDocument(data, knownTypes)) {
|
|
18776
18996
|
docs.push({
|
|
18777
18997
|
frontmatter: data,
|
|
@@ -18865,7 +19085,7 @@ function planFromSingleDocument(classification, store, _marvinDir, options) {
|
|
|
18865
19085
|
const filePath = classification.inputPath;
|
|
18866
19086
|
const knownTypes = store.registeredTypes;
|
|
18867
19087
|
const raw = fs15.readFileSync(filePath, "utf-8");
|
|
18868
|
-
const { data, content } =
|
|
19088
|
+
const { data, content } = matter5(raw);
|
|
18869
19089
|
if (!isValidMarvinDocument(data, knownTypes)) {
|
|
18870
19090
|
return [];
|
|
18871
19091
|
}
|
|
@@ -19262,7 +19482,7 @@ function createProgram() {
|
|
|
19262
19482
|
const program = new Command();
|
|
19263
19483
|
program.name("marvin").description(
|
|
19264
19484
|
"AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
|
|
19265
|
-
).version("0.
|
|
19485
|
+
).version("0.2.0");
|
|
19266
19486
|
program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
|
|
19267
19487
|
await initCommand();
|
|
19268
19488
|
});
|
|
@@ -19323,9 +19543,12 @@ function createProgram() {
|
|
|
19323
19543
|
skillsCmd.command("remove <skill>").description("Unassign a skill from a persona").requiredOption("--as <persona>", "Persona to remove the skill from").action(async (skill, options) => {
|
|
19324
19544
|
await skillsRemoveCommand(skill, options);
|
|
19325
19545
|
});
|
|
19326
|
-
skillsCmd.command("create <name>").description("Create a
|
|
19546
|
+
skillsCmd.command("create <name>").description("Create a new skill in .marvin/skills/ (SKILL.md format)").action(async (name) => {
|
|
19327
19547
|
await skillsCreateCommand(name);
|
|
19328
19548
|
});
|
|
19549
|
+
skillsCmd.command("migrate").description("Migrate YAML skill files to SKILL.md directory format").action(async () => {
|
|
19550
|
+
await skillsMigrateCommand();
|
|
19551
|
+
});
|
|
19329
19552
|
return program;
|
|
19330
19553
|
}
|
|
19331
19554
|
export {
|
|
@@ -19348,13 +19571,16 @@ export {
|
|
|
19348
19571
|
getPersona,
|
|
19349
19572
|
getPluginPromptFragment,
|
|
19350
19573
|
getPluginTools,
|
|
19574
|
+
getSkillAgentDefinitions,
|
|
19351
19575
|
getSkillPromptFragment,
|
|
19352
19576
|
getSkillTools,
|
|
19353
19577
|
isMarvinProject,
|
|
19354
19578
|
listPersonas,
|
|
19355
19579
|
loadAllSkills,
|
|
19356
19580
|
loadProject,
|
|
19581
|
+
loadSkillFromDirectory,
|
|
19357
19582
|
loadUserConfig,
|
|
19583
|
+
migrateYamlToSkillMd,
|
|
19358
19584
|
parseDocument,
|
|
19359
19585
|
registerSdkTools,
|
|
19360
19586
|
resolvePersonaId,
|