@manehorizons/cadence-core 1.7.0 → 1.8.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/cli/commands/build.d.ts.map +1 -1
- package/dist/cli/commands/build.js +10 -77
- package/dist/cli/commands/build.js.map +1 -1
- package/dist/cli/commands/draft-new.d.ts.map +1 -1
- package/dist/cli/commands/draft-new.js +11 -97
- package/dist/cli/commands/draft-new.js.map +1 -1
- package/dist/cli/commands/draft.d.ts.map +1 -1
- package/dist/cli/commands/draft.js +15 -104
- package/dist/cli/commands/draft.js.map +1 -1
- package/dist/cli/commands/mcp.d.ts +3 -0
- package/dist/cli/commands/mcp.d.ts.map +1 -0
- package/dist/cli/commands/mcp.js +35 -0
- package/dist/cli/commands/mcp.js.map +1 -0
- package/dist/cli/commands/progress.d.ts.map +1 -1
- package/dist/cli/commands/progress.js +5 -13
- package/dist/cli/commands/progress.js.map +1 -1
- package/dist/cli/commands/recommend.d.ts.map +1 -1
- package/dist/cli/commands/recommend.js +5 -15
- package/dist/cli/commands/recommend.js.map +1 -1
- package/dist/cli/commands/settle.d.ts.map +1 -1
- package/dist/cli/commands/settle.js +5 -442
- package/dist/cli/commands/settle.js.map +1 -1
- package/dist/cli/commands/spec.d.ts.map +1 -1
- package/dist/cli/commands/spec.js +19 -197
- package/dist/cli/commands/spec.js.map +1 -1
- package/dist/cli/commands/status.d.ts.map +1 -1
- package/dist/cli/commands/status.js +5 -14
- package/dist/cli/commands/status.js.map +1 -1
- package/dist/cli/register.d.ts.map +1 -1
- package/dist/cli/register.js +2 -0
- package/dist/cli/register.js.map +1 -1
- package/dist/mcp/server.d.ts +12 -0
- package/dist/mcp/server.d.ts.map +1 -0
- package/dist/mcp/server.js +42 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/tools.d.ts +20 -0
- package/dist/mcp/tools.d.ts.map +1 -0
- package/dist/mcp/tools.js +189 -0
- package/dist/mcp/tools.js.map +1 -0
- package/dist/services/build-task.d.ts +12 -0
- package/dist/services/build-task.d.ts.map +1 -0
- package/dist/services/build-task.js +78 -0
- package/dist/services/build-task.js.map +1 -0
- package/dist/services/draft-approve.d.ts +14 -0
- package/dist/services/draft-approve.d.ts.map +1 -0
- package/dist/services/draft-approve.js +74 -0
- package/dist/services/draft-approve.js.map +1 -0
- package/dist/services/draft-check.d.ts +10 -0
- package/dist/services/draft-check.d.ts.map +1 -0
- package/dist/services/draft-check.js +47 -0
- package/dist/services/draft-check.js.map +1 -0
- package/dist/services/draft-new.d.ts +14 -0
- package/dist/services/draft-new.d.ts.map +1 -0
- package/dist/services/draft-new.js +98 -0
- package/dist/services/draft-new.js.map +1 -0
- package/dist/services/io.d.ts +39 -0
- package/dist/services/io.d.ts.map +1 -0
- package/dist/services/io.js +36 -0
- package/dist/services/io.js.map +1 -0
- package/dist/services/progress.d.ts +7 -0
- package/dist/services/progress.d.ts.map +1 -0
- package/dist/services/progress.js +21 -0
- package/dist/services/progress.js.map +1 -0
- package/dist/services/recommend.d.ts +9 -0
- package/dist/services/recommend.d.ts.map +1 -0
- package/dist/services/recommend.js +23 -0
- package/dist/services/recommend.js.map +1 -0
- package/dist/services/settle.d.ts +24 -0
- package/dist/services/settle.d.ts.map +1 -0
- package/dist/services/settle.js +366 -0
- package/dist/services/settle.js.map +1 -0
- package/dist/services/spec-approve.d.ts +11 -0
- package/dist/services/spec-approve.d.ts.map +1 -0
- package/dist/services/spec-approve.js +133 -0
- package/dist/services/spec-approve.js.map +1 -0
- package/dist/services/spec-new.d.ts +9 -0
- package/dist/services/spec-new.d.ts.map +1 -0
- package/dist/services/spec-new.js +62 -0
- package/dist/services/spec-new.js.map +1 -0
- package/dist/services/status.d.ts +9 -0
- package/dist/services/status.d.ts.map +1 -0
- package/dist/services/status.js +22 -0
- package/dist/services/status.js.map +1 -0
- package/package.json +3 -2
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
import { readFile } from 'node:fs/promises';
|
|
2
|
+
import { existsSync } from 'node:fs';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
import { parseSpecMd } from '../parse/spec-parser.js';
|
|
5
|
+
import { SimpleStateBackend } from '../state/simple.js';
|
|
6
|
+
import { atomicWriteText } from '../state/atomic-write.js';
|
|
7
|
+
import { loadConfig } from '../config/loader.js';
|
|
8
|
+
import { selectNotifier } from '../notify/factory.js';
|
|
9
|
+
import { selectSpecReviewVerifier } from '../verify/spec-review-factory.js';
|
|
10
|
+
import { nextConvergence } from '../verify/converge.js';
|
|
11
|
+
import { emitSpecReviewUnconverged } from '../notify/spec-review.js';
|
|
12
|
+
/**
|
|
13
|
+
* `cadence spec approve <phase> <num>` — run the convergent spec-review gate;
|
|
14
|
+
* on pass mark APPROVED and leave the spec stage (SPEC→IDLE).
|
|
15
|
+
*/
|
|
16
|
+
export async function specApproveService(repoRoot, args, io) {
|
|
17
|
+
try {
|
|
18
|
+
const backend = new SimpleStateBackend(repoRoot);
|
|
19
|
+
const state = await backend.readState();
|
|
20
|
+
const padded = args.num.padStart(2, '0');
|
|
21
|
+
const id = `${args.phase.slice(0, 2)}-${padded}`;
|
|
22
|
+
if (state.loopPosition !== 'SPEC') {
|
|
23
|
+
io.err(`spec approve refused: loopPosition is ${state.loopPosition}, not SPEC.\n`);
|
|
24
|
+
return { exitCode: 1 };
|
|
25
|
+
}
|
|
26
|
+
const specPath = join(repoRoot, '.cadence', 'phases', args.phase, `${id}-SPEC.md`);
|
|
27
|
+
if (!existsSync(specPath)) {
|
|
28
|
+
io.err(`spec approve refused: ${specPath} not found.\n`);
|
|
29
|
+
return { exitCode: 1 };
|
|
30
|
+
}
|
|
31
|
+
const rawSpec = await readFile(specPath, 'utf8');
|
|
32
|
+
const spec = parseSpecMd(rawSpec);
|
|
33
|
+
const cfg = await loadConfig(repoRoot).catch(() => null);
|
|
34
|
+
const verifier = selectSpecReviewVerifier(cfg);
|
|
35
|
+
const sidecarPath = join(repoRoot, '.cadence', 'phases', args.phase, `${id}-SPEC-REVIEW.json`);
|
|
36
|
+
let attemptsSoFar = 0;
|
|
37
|
+
let history = [];
|
|
38
|
+
if (existsSync(sidecarPath)) {
|
|
39
|
+
try {
|
|
40
|
+
const prior = JSON.parse(await readFile(sidecarPath, 'utf8'));
|
|
41
|
+
if (typeof prior.attempts === 'number')
|
|
42
|
+
attemptsSoFar = prior.attempts;
|
|
43
|
+
if (Array.isArray(prior.history))
|
|
44
|
+
history = prior.history;
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
/* corrupt/legacy → fresh */
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
const res = await verifier.verify({ spec });
|
|
51
|
+
const maxAttempts = cfg?.convergence?.maxAttempts ?? 3;
|
|
52
|
+
const nv = nextConvergence(res.pass, attemptsSoFar, maxAttempts);
|
|
53
|
+
const now = new Date().toISOString();
|
|
54
|
+
const bypassed = !res.pass && args.allowSpecReviewFailure === true;
|
|
55
|
+
history.push({
|
|
56
|
+
at: now,
|
|
57
|
+
pass: res.pass,
|
|
58
|
+
findingsCount: res.findings.length,
|
|
59
|
+
provider: res.provider,
|
|
60
|
+
...(res.model ? { model: res.model } : {}),
|
|
61
|
+
verdict: nv.verdict,
|
|
62
|
+
...(bypassed ? { bypassed: true } : {}),
|
|
63
|
+
});
|
|
64
|
+
await atomicWriteText(sidecarPath, JSON.stringify({
|
|
65
|
+
specId: id,
|
|
66
|
+
converged: res.pass,
|
|
67
|
+
attempts: nv.verdict === 'pass' ? attemptsSoFar : nv.attempt,
|
|
68
|
+
maxAttempts,
|
|
69
|
+
history,
|
|
70
|
+
pass: res.pass,
|
|
71
|
+
provider: res.provider,
|
|
72
|
+
...(res.model ? { model: res.model } : {}),
|
|
73
|
+
findings: res.findings.length,
|
|
74
|
+
at: now,
|
|
75
|
+
}, null, 2) + '\n');
|
|
76
|
+
if (!res.pass) {
|
|
77
|
+
for (const f of res.findings) {
|
|
78
|
+
io.err(`spec-review: ${f.severity} — ${f.message}\n`);
|
|
79
|
+
if (f.suggestedEdit) {
|
|
80
|
+
io.err(` ↳ suggested: ${f.suggestedEdit}\n`);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
if (args.allowSpecReviewFailure) {
|
|
84
|
+
if (nv.verdict === 'escalate') {
|
|
85
|
+
await emitSpecReviewUnconverged(selectNotifier(cfg), {
|
|
86
|
+
specId: id,
|
|
87
|
+
attempts: nv.attempt,
|
|
88
|
+
maxAttempts,
|
|
89
|
+
findings: res.findings.length,
|
|
90
|
+
provider: res.provider,
|
|
91
|
+
...(res.model ? { model: res.model } : {}),
|
|
92
|
+
bypassed: true,
|
|
93
|
+
});
|
|
94
|
+
}
|
|
95
|
+
io.err(`spec-review: --allow-spec-review-failure set; proceeding past ` +
|
|
96
|
+
`${res.findings.length} finding(s).\n`);
|
|
97
|
+
// fall through to APPROVED + IDLE.
|
|
98
|
+
}
|
|
99
|
+
else if (nv.verdict === 'reloop') {
|
|
100
|
+
io.err(`spec-review: attempt ${nv.attempt}/${maxAttempts} did not pass — ` +
|
|
101
|
+
`fix the SPEC and re-run \`cadence spec approve\`, ` +
|
|
102
|
+
`or pass --allow-spec-review-failure to proceed anyway.\n`);
|
|
103
|
+
return { exitCode: 1 };
|
|
104
|
+
}
|
|
105
|
+
else {
|
|
106
|
+
await emitSpecReviewUnconverged(selectNotifier(cfg), {
|
|
107
|
+
specId: id,
|
|
108
|
+
attempts: nv.attempt,
|
|
109
|
+
maxAttempts,
|
|
110
|
+
findings: res.findings.length,
|
|
111
|
+
provider: res.provider,
|
|
112
|
+
...(res.model ? { model: res.model } : {}),
|
|
113
|
+
});
|
|
114
|
+
io.err(`spec approve refused: spec-review did NOT converge after ` +
|
|
115
|
+
`${maxAttempts} attempts — a human decision is required. ` +
|
|
116
|
+
`Re-scope the spec, or pass --allow-spec-review-failure to proceed anyway.\n`);
|
|
117
|
+
return { exitCode: 1 };
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
// Converged (or bypassed): mark APPROVED, leave the spec stage.
|
|
121
|
+
await atomicWriteText(specPath, rawSpec.replace(/^status: PENDING$/m, 'status: APPROVED'));
|
|
122
|
+
state.loopPosition = 'IDLE';
|
|
123
|
+
state.activeSpec = null;
|
|
124
|
+
await backend.commit(state);
|
|
125
|
+
io.out(`Approved spec ${id}; loopPosition=IDLE\n`);
|
|
126
|
+
return { exitCode: 0, data: { id, approved: true, converged: res.pass, bypassed } };
|
|
127
|
+
}
|
|
128
|
+
catch (err) {
|
|
129
|
+
io.err(`spec approve failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
130
|
+
return { exitCode: 1 };
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
//# sourceMappingURL=spec-approve.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec-approve.js","sourceRoot":"","sources":["../../src/services/spec-approve.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { CommandIO, CommandResult } from './io.js';
|
|
2
|
+
/** `cadence spec new <phase> <num>` — scaffold a SPEC.md (IDLE→SPEC). */
|
|
3
|
+
export declare function specNewService(repoRoot: string, args: {
|
|
4
|
+
phase: string;
|
|
5
|
+
num: string;
|
|
6
|
+
title?: string;
|
|
7
|
+
fromRec?: string;
|
|
8
|
+
}, io: CommandIO): Promise<CommandResult>;
|
|
9
|
+
//# sourceMappingURL=spec-new.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec-new.d.ts","sourceRoot":"","sources":["../../src/services/spec-new.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,yEAAyE;AACzE,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CA2DxB"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { mkdir, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { existsSync } from 'node:fs';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
import { SimpleStateBackend } from '../state/simple.js';
|
|
5
|
+
import { readRecommendationLedger } from '../intelligence/store/io.js';
|
|
6
|
+
import { runRecommendationTransition } from '../intelligence/store/recommendations.js';
|
|
7
|
+
/** `cadence spec new <phase> <num>` — scaffold a SPEC.md (IDLE→SPEC). */
|
|
8
|
+
export async function specNewService(repoRoot, args, io) {
|
|
9
|
+
const title = args.title ?? 'Untitled';
|
|
10
|
+
try {
|
|
11
|
+
const backend = new SimpleStateBackend(repoRoot);
|
|
12
|
+
const state = await backend.readState();
|
|
13
|
+
if (state.loopPosition !== 'IDLE') {
|
|
14
|
+
io.err(`spec new refused: loopPosition is ${state.loopPosition}, not IDLE. ` +
|
|
15
|
+
`Approve/settle/discard the active unit first.\n`);
|
|
16
|
+
return { exitCode: 1 };
|
|
17
|
+
}
|
|
18
|
+
if (args.fromRec !== undefined) {
|
|
19
|
+
const recLedger = await readRecommendationLedger(repoRoot);
|
|
20
|
+
const rec = recLedger.recommendations.find((r) => r.id === args.fromRec);
|
|
21
|
+
if (!rec) {
|
|
22
|
+
io.err(`spec new refused: recommendation ${args.fromRec} not found\n`);
|
|
23
|
+
return { exitCode: 1 };
|
|
24
|
+
}
|
|
25
|
+
if (rec.status !== 'candidate' && rec.status !== 'accepted') {
|
|
26
|
+
io.err(`spec new refused: cannot convert recommendation in status ${rec.status}\n`);
|
|
27
|
+
return { exitCode: 1 };
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
const dir = join(repoRoot, '.cadence', 'phases', args.phase);
|
|
31
|
+
const padded = args.num.padStart(2, '0');
|
|
32
|
+
const id = `${args.phase.slice(0, 2)}-${padded}`;
|
|
33
|
+
const path = join(dir, `${id}-SPEC.md`);
|
|
34
|
+
if (existsSync(path)) {
|
|
35
|
+
io.err(`SPEC already exists: ${path}\n`);
|
|
36
|
+
return { exitCode: 2 };
|
|
37
|
+
}
|
|
38
|
+
await mkdir(dir, { recursive: true });
|
|
39
|
+
const body = `---\nphase: ${args.phase}\nid: ${id}\nstatus: PENDING\n---\n\n# ${id} — ${title}\n\n## Objective\n\n_(one sentence)_\n\n## Acceptance Criteria\n\n### AC-1: _(name)_\nGiven _(precondition)_\nWhen _(action)_\nThen _(outcome)_\n\n## Constraints\n\n- _(constraint)_\n\n## Open Questions\n\n- _(question)_\n`;
|
|
40
|
+
await writeFile(path, body);
|
|
41
|
+
state.activePhase = args.phase;
|
|
42
|
+
state.activeSpec = id;
|
|
43
|
+
state.loopPosition = 'SPEC';
|
|
44
|
+
await backend.commit(state);
|
|
45
|
+
io.out(`Created ${path}\n`);
|
|
46
|
+
if (args.fromRec !== undefined) {
|
|
47
|
+
const convertRes = await runRecommendationTransition(repoRoot, args.fromRec, 'convert', args.phase);
|
|
48
|
+
if (!convertRes.ok) {
|
|
49
|
+
io.err(`spec new: scaffold succeeded but convert failed: ${convertRes.error}. ` +
|
|
50
|
+
`Run \`cadence recommendation convert ${args.fromRec} --to-phase ${args.phase}\` to retry.\n`);
|
|
51
|
+
return { exitCode: 1, data: { path, id, converted: false } };
|
|
52
|
+
}
|
|
53
|
+
io.out(`recommendation ${args.fromRec} → converted (to ${args.phase})\n`);
|
|
54
|
+
}
|
|
55
|
+
return { exitCode: 0, data: { path, id, converted: args.fromRec !== undefined } };
|
|
56
|
+
}
|
|
57
|
+
catch (err) {
|
|
58
|
+
io.err(`spec new failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
59
|
+
return { exitCode: 1 };
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
//# sourceMappingURL=spec-new.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec-new.js","sourceRoot":"","sources":["../../src/services/spec-new.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { CommandIO, CommandResult } from './io.js';
|
|
2
|
+
/**
|
|
3
|
+
* `cadence status` (default action) — full loop context.
|
|
4
|
+
* `json: true` mirrors the `--json` flag. `data` is the status report either way.
|
|
5
|
+
*/
|
|
6
|
+
export declare function statusService(repoRoot: string, args: {
|
|
7
|
+
json?: boolean;
|
|
8
|
+
}, io: CommandIO): Promise<CommandResult>;
|
|
9
|
+
//# sourceMappingURL=status.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/services/status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EACxB,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CAaxB"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { loadStatus, renderStatus } from '../status.js';
|
|
2
|
+
/**
|
|
3
|
+
* `cadence status` (default action) — full loop context.
|
|
4
|
+
* `json: true` mirrors the `--json` flag. `data` is the status report either way.
|
|
5
|
+
*/
|
|
6
|
+
export async function statusService(repoRoot, args, io) {
|
|
7
|
+
try {
|
|
8
|
+
const report = await loadStatus(repoRoot);
|
|
9
|
+
if (args.json) {
|
|
10
|
+
io.out(JSON.stringify(report) + '\n');
|
|
11
|
+
}
|
|
12
|
+
else {
|
|
13
|
+
io.out(renderStatus(report));
|
|
14
|
+
}
|
|
15
|
+
return { exitCode: 0, data: report };
|
|
16
|
+
}
|
|
17
|
+
catch (err) {
|
|
18
|
+
io.err(`status failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
19
|
+
return { exitCode: 1 };
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
//# sourceMappingURL=status.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/services/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,IAAwB,EACxB,EAAa;IAEb,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CAAC,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/E,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@manehorizons/cadence-core",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.8.0",
|
|
4
4
|
"engines": {
|
|
5
5
|
"node": ">=20"
|
|
6
6
|
},
|
|
@@ -48,9 +48,10 @@
|
|
|
48
48
|
},
|
|
49
49
|
"dependencies": {
|
|
50
50
|
"@anthropic-ai/sdk": "^0.96.0",
|
|
51
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
51
52
|
"commander": "^13.0.0",
|
|
52
53
|
"zod": "^4.4.3",
|
|
53
|
-
"@manehorizons/cadence-types": "1.
|
|
54
|
+
"@manehorizons/cadence-types": "1.8.0"
|
|
54
55
|
},
|
|
55
56
|
"devDependencies": {
|
|
56
57
|
"vitest": "^2.1.0",
|