|
|
@@ -0,0 +1,177 @@
|
|
|
+/**
|
|
|
+ * Kiro CLI / IDE target. Writes:
|
|
|
+ *
|
|
|
+ * - MCP server entry to `~/.kiro/settings/mcp.json` (global) or
|
|
|
+ * `./.kiro/settings/mcp.json` (local). Standard `mcpServers.codegraph`
|
|
|
+ * shape, same as Claude / Cursor / Gemini.
|
|
|
+ * - Instructions to `~/.kiro/steering/codegraph.md` (global) or
|
|
|
+ * `./.kiro/steering/codegraph.md` (local). Kiro's "steering" system
|
|
|
+ * loads every `*.md` file in the steering dir as agent context, so
|
|
|
+ * a dedicated `codegraph.md` is the natural surface — we own the
|
|
|
+ * whole file outright (no marker-based merging needed) and delete
|
|
|
+ * it on uninstall.
|
|
|
+ *
|
|
|
+ * No permissions concept — Kiro gates tool invocations through its own
|
|
|
+ * UI prompts rather than an external allowlist. `autoAllow` is silently
|
|
|
+ * ignored.
|
|
|
+ *
|
|
|
+ * Paths are identical on macOS / Linux / Windows because Kiro resolves
|
|
|
+ * its config root from `os.homedir()` on all three (Windows `~` →
|
|
|
+ * `%USERPROFILE%\.kiro`).
|
|
|
+ *
|
|
|
+ * Docs: https://kiro.dev/docs/cli/mcp/
|
|
|
+ * https://kiro.dev/docs/cli/steering/
|
|
|
+ */
|
|
|
+
|
|
|
+import * as fs from 'fs';
|
|
|
+import * as path from 'path';
|
|
|
+import * as os from 'os';
|
|
|
+import {
|
|
|
+ AgentTarget,
|
|
|
+ DetectionResult,
|
|
|
+ InstallOptions,
|
|
|
+ Location,
|
|
|
+ WriteResult,
|
|
|
+} from './types';
|
|
|
+import {
|
|
|
+ atomicWriteFileSync,
|
|
|
+ getMcpServerConfig,
|
|
|
+ jsonDeepEqual,
|
|
|
+ readJsonFile,
|
|
|
+ writeJsonFile,
|
|
|
+} from './shared';
|
|
|
+import { INSTRUCTIONS_TEMPLATE } from '../instructions-template';
|
|
|
+
|
|
|
+function configDir(loc: Location): string {
|
|
|
+ return loc === 'global'
|
|
|
+ ? path.join(os.homedir(), '.kiro')
|
|
|
+ : path.join(process.cwd(), '.kiro');
|
|
|
+}
|
|
|
+function mcpJsonPath(loc: Location): string {
|
|
|
+ return path.join(configDir(loc), 'settings', 'mcp.json');
|
|
|
+}
|
|
|
+function steeringPath(loc: Location): string {
|
|
|
+ return path.join(configDir(loc), 'steering', 'codegraph.md');
|
|
|
+}
|
|
|
+
|
|
|
+class KiroTarget implements AgentTarget {
|
|
|
+ readonly id = 'kiro' as const;
|
|
|
+ readonly displayName = 'Kiro';
|
|
|
+ readonly docsUrl = 'https://kiro.dev/docs/cli/mcp/';
|
|
|
+
|
|
|
+ supportsLocation(_loc: Location): boolean {
|
|
|
+ return true;
|
|
|
+ }
|
|
|
+
|
|
|
+ detect(loc: Location): DetectionResult {
|
|
|
+ const file = mcpJsonPath(loc);
|
|
|
+ const config = readJsonFile(file);
|
|
|
+ const alreadyConfigured = !!config.mcpServers?.codegraph;
|
|
|
+ const installed = loc === 'global'
|
|
|
+ ? fs.existsSync(configDir('global')) || fs.existsSync(file)
|
|
|
+ : fs.existsSync(file) || fs.existsSync(configDir('local'));
|
|
|
+ return { installed, alreadyConfigured, configPath: file };
|
|
|
+ }
|
|
|
+
|
|
|
+ install(loc: Location, _opts: InstallOptions): WriteResult {
|
|
|
+ const files: WriteResult['files'] = [];
|
|
|
+ files.push(writeMcpEntry(loc));
|
|
|
+ files.push(writeSteeringEntry(loc));
|
|
|
+ return {
|
|
|
+ files,
|
|
|
+ notes: ['Restart Kiro for MCP changes to take effect.'],
|
|
|
+ };
|
|
|
+ }
|
|
|
+
|
|
|
+ uninstall(loc: Location): WriteResult {
|
|
|
+ const files: WriteResult['files'] = [];
|
|
|
+
|
|
|
+ const file = mcpJsonPath(loc);
|
|
|
+ const config = readJsonFile(file);
|
|
|
+ if (config.mcpServers?.codegraph) {
|
|
|
+ delete config.mcpServers.codegraph;
|
|
|
+ if (Object.keys(config.mcpServers).length === 0) {
|
|
|
+ delete config.mcpServers;
|
|
|
+ }
|
|
|
+ writeJsonFile(file, config);
|
|
|
+ files.push({ path: file, action: 'removed' });
|
|
|
+ } else {
|
|
|
+ files.push({ path: file, action: 'not-found' });
|
|
|
+ }
|
|
|
+
|
|
|
+ files.push(removeSteeringEntry(loc));
|
|
|
+
|
|
|
+ return { files };
|
|
|
+ }
|
|
|
+
|
|
|
+ printConfig(loc: Location): string {
|
|
|
+ const target = mcpJsonPath(loc);
|
|
|
+ const snippet = JSON.stringify({ mcpServers: { codegraph: getMcpServerConfig() } }, null, 2);
|
|
|
+ return `# Add to ${target}\n\n${snippet}\n`;
|
|
|
+ }
|
|
|
+
|
|
|
+ describePaths(loc: Location): string[] {
|
|
|
+ return [mcpJsonPath(loc), steeringPath(loc)];
|
|
|
+ }
|
|
|
+}
|
|
|
+
|
|
|
+function writeMcpEntry(loc: Location): WriteResult['files'][number] {
|
|
|
+ const file = mcpJsonPath(loc);
|
|
|
+ const dir = path.dirname(file);
|
|
|
+ if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
|
|
|
+
|
|
|
+ const existing = readJsonFile(file);
|
|
|
+ const before = existing.mcpServers?.codegraph;
|
|
|
+ const after = getMcpServerConfig();
|
|
|
+
|
|
|
+ if (jsonDeepEqual(before, after)) {
|
|
|
+ return { path: file, action: 'unchanged' };
|
|
|
+ }
|
|
|
+ const action: 'created' | 'updated' =
|
|
|
+ before ? 'updated' : (fs.existsSync(file) ? 'updated' : 'created');
|
|
|
+ if (!existing.mcpServers) existing.mcpServers = {};
|
|
|
+ existing.mcpServers.codegraph = after;
|
|
|
+ writeJsonFile(file, existing);
|
|
|
+ return { path: file, action };
|
|
|
+}
|
|
|
+
|
|
|
+/**
|
|
|
+ * Write the dedicated steering file. Unlike CLAUDE.md / GEMINI.md
|
|
|
+ * (shared files where codegraph owns a marker-delimited section),
|
|
|
+ * Kiro's steering dir loads every `*.md` as a discrete document — so
|
|
|
+ * `codegraph.md` is ours outright. Byte-equality short-circuits
|
|
|
+ * idempotent re-runs; mismatched content gets a clean rewrite.
|
|
|
+ */
|
|
|
+function writeSteeringEntry(loc: Location): WriteResult['files'][number] {
|
|
|
+ const file = steeringPath(loc);
|
|
|
+ const dir = path.dirname(file);
|
|
|
+ if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
|
|
|
+
|
|
|
+ const body = INSTRUCTIONS_TEMPLATE + '\n';
|
|
|
+
|
|
|
+ if (!fs.existsSync(file)) {
|
|
|
+ atomicWriteFileSync(file, body);
|
|
|
+ return { path: file, action: 'created' };
|
|
|
+ }
|
|
|
+ const existing = fs.readFileSync(file, 'utf-8');
|
|
|
+ if (existing === body) {
|
|
|
+ return { path: file, action: 'unchanged' };
|
|
|
+ }
|
|
|
+ atomicWriteFileSync(file, body);
|
|
|
+ return { path: file, action: 'updated' };
|
|
|
+}
|
|
|
+
|
|
|
+/**
|
|
|
+ * Delete the steering file we own. If a user has hand-edited the file
|
|
|
+ * out of recognition we still remove it — codegraph.md is a name we
|
|
|
+ * claim, and a partial install leaving the file behind is worse than
|
|
|
+ * a clean delete.
|
|
|
+ */
|
|
|
+function removeSteeringEntry(loc: Location): WriteResult['files'][number] {
|
|
|
+ const file = steeringPath(loc);
|
|
|
+ if (!fs.existsSync(file)) return { path: file, action: 'not-found' };
|
|
|
+ try { fs.unlinkSync(file); } catch { /* ignore */ }
|
|
|
+ return { path: file, action: 'removed' };
|
|
|
+}
|
|
|
+
|
|
|
+export const kiroTarget: AgentTarget = new KiroTarget();
|
Colby McHenry