@infinitedusky/indusk-mcp 0.1.0 → 0.3.0

package/dist/bin/cli.js

@@ -13,9 +13,10 @@ program
 program
     .command("init")
     .description("Initialize a project with InDusk dev system")
-    .action(async () => {
+    .option("-f, --force", "Overwrite existing files (except CLAUDE.md and planning/)")
+    .action(async (opts) => {
     const { init } = await import("./commands/init.js");
-    await init(process.cwd());
+    await init(process.cwd(), { force: opts.force ?? false });
 });
 program
     .command("update")

package/dist/bin/commands/init.d.ts

@@ -1 +1,4 @@
-export declare function init(projectRoot: string): Promise<void>;
+export interface InitOptions {
+    force?: boolean;
+}
+export declare function init(projectRoot: string, options?: InitOptions): Promise<void>;

package/dist/bin/commands/init.js

@@ -70,9 +70,10 @@ function createCgcIgnore(projectRoot) {
     ].join("\n"));
     console.info("  create: .cgcignore");
 }
-export async function init(projectRoot) {
+export async function init(projectRoot, options = {}) {
+    const { force = false } = options;
     const projectName = basename(projectRoot);
-    console.info("Initializing InDusk dev system...\n");
+    console.info(`Initializing InDusk dev system...${force ? " (--force)" : ""}\n`);
     // 1. Copy skills
     console.info("[Skills]");
     const skillsSource = join(packageRoot, "skills");
@@ -82,19 +83,21 @@ export async function init(projectRoot) {
         const skillName = file.replace(".md", "");
         const targetDir = join(skillsTarget, skillName);
         const targetFile = join(targetDir, "SKILL.md");
-        if (existsSync(targetFile)) {
+        if (existsSync(targetFile) && !force) {
             console.info(`  skip: .claude/skills/${skillName}/SKILL.md (already exists)`);
             continue;
         }
         mkdirSync(targetDir, { recursive: true });
         cpSync(join(skillsSource, file), targetFile);
-        console.info(`  create: .claude/skills/${skillName}/SKILL.md`);
+        console.info(`  ${existsSync(targetFile) ? "overwrite" : "create"}: .claude/skills/${skillName}/SKILL.md`);
     }
-    // 2. Create CLAUDE.md
+    // 2. Create CLAUDE.md (never overwrite — write CLAUDE-NEW.md if exists)
     console.info("\n[Project files]");
     const claudeMdPath = join(projectRoot, "CLAUDE.md");
     if (existsSync(claudeMdPath)) {
-        console.info("  skip: CLAUDE.md (already exists)");
+        const newPath = join(projectRoot, "CLAUDE-NEW.md");
+        cpSync(join(packageRoot, "templates/CLAUDE.md"), newPath);
+        console.info("  create: CLAUDE-NEW.md (merge manually with existing CLAUDE.md)");
     }
     else {
         cpSync(join(packageRoot, "templates/CLAUDE.md"), claudeMdPath);
@@ -131,17 +134,17 @@ export async function init(projectRoot) {
         const existing = JSON.parse(readFileSync(mcpJsonPath, "utf-8"));
         let updated = false;
         existing.mcpServers = existing.mcpServers || {};
-        if (!existing.mcpServers.indusk) {
+        if (!existing.mcpServers.indusk || force) {
             existing.mcpServers.indusk = induskEntry;
-            console.info("  update: .mcp.json (added indusk entry)");
+            console.info(`  ${existing.mcpServers.indusk ? "overwrite" : "add"}: .mcp.json indusk entry`);
             updated = true;
         }
         else {
             console.info("  skip: .mcp.json indusk entry (already exists)");
         }
-        if (!existing.mcpServers.codegraphcontext) {
+        if (!existing.mcpServers.codegraphcontext || force) {
             existing.mcpServers.codegraphcontext = cgcEntry;
-            console.info(`  update: .mcp.json (added codegraphcontext, graph: ${projectName})`);
+            console.info(`  ${existing.mcpServers.codegraphcontext ? "overwrite" : "add"}: .mcp.json codegraphcontext (graph: ${projectName})`);
             updated = true;
         }
         else {
@@ -164,24 +167,24 @@ export async function init(projectRoot) {
     // 5. Generate .vscode/settings.json
     console.info("\n[Editor]");
     const vscodePath = join(projectRoot, ".vscode/settings.json");
-    if (existsSync(vscodePath)) {
+    if (existsSync(vscodePath) && !force) {
         console.info("  skip: .vscode/settings.json (already exists)");
     }
     else {
         mkdirSync(join(projectRoot, ".vscode"), { recursive: true });
         cpSync(join(packageRoot, "templates/vscode-settings.json"), vscodePath);
-        console.info("  create: .vscode/settings.json");
+        console.info(`  ${existsSync(vscodePath) ? "overwrite" : "create"}: .vscode/settings.json`);
     }
     // 6. Create base biome.json
     const biomePath = join(projectRoot, "biome.json");
-    if (existsSync(biomePath)) {
+    if (existsSync(biomePath) && !force) {
         console.info("  skip: biome.json (already exists)");
     }
     else {
         cpSync(join(packageRoot, "templates/biome.template.json"), biomePath);
-        console.info("  create: biome.json");
+        console.info(`  ${existsSync(biomePath) ? "overwrite" : "create"}: biome.json`);
     }
-    // 7. Create .cgcignore
+    // 7. Create .cgcignore (always overwrite — package-owned)
     createCgcIgnore(projectRoot);
     // 8. Infrastructure: FalkorDB + CGC
     console.info("\n[Infrastructure]");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@infinitedusky/indusk-mcp",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"description": "InDusk development system — skills, MCP tools, and CLI for structured AI-assisted development",
 	"type": "module",
 	"files": [

package/skills/toolbelt.md

@@ -0,0 +1,80 @@
+# InDusk Toolbelt
+
+You have MCP tools from two servers: **indusk** (dev system) and **codegraphcontext** (code graph). This skill tells you when to use them.
+
+## Session Start
+
+When a new session begins:
+
+1. Call `check_health` — verify FalkorDB and CGC are running. If unhealthy, tell the user what's down and how to fix it before proceeding.
+2. Call `list_plans` — understand what plans exist, their stages, and what's in progress.
+3. Call `get_context` — read the project's CLAUDE.md to understand architecture, conventions, and current state.
+
+## Before Modifying Code
+
+Before touching any file:
+
+1. Call `get_plan_status` for the active plan — know which phase you're in and what items remain.
+2. Use CGC's `analyze_code_relationships` on the files you're about to change — understand dependencies and blast radius.
+3. If the blast radius is large (many downstream consumers), flag it to the user before proceeding.
+
+## During Work
+
+While executing impl items:
+
+- After completing verification items, call `quality_check` to confirm Biome passes.
+- After completing context items, call `get_context` to verify CLAUDE.md was updated correctly.
+- After completing document items, call `list_docs` to verify the doc page exists.
+
+## Advancing Phases
+
+When you think a phase is complete:
+
+1. Call `advance_plan` — it will tell you if anything is missing across all four gates (implementation, verification, context, document).
+2. If blocked, work through the missing items before trying again.
+3. Never manually mark a phase complete without calling `advance_plan` first.
+
+## After a Retrospective
+
+1. Call `check_docs_coverage` — flag any completed plans missing decision pages.
+2. Call `get_quality_config` — review if new Biome rules should be added based on lessons learned.
+3. If a new rule is needed, call `suggest_rule` with a description of the mistake to find matching Biome rules.
+
+## Skill and System Management
+
+- Call `get_skill_versions` to check if installed skills are current or outdated.
+- Call `get_system_version` to verify the installed package version.
+
+## Code Graph (CGC Tools)
+
+These come from the codegraphcontext MCP server:
+
+| When | Tool |
+|------|------|
+| Search for code by name | `find_code` |
+| Understand what depends on a file | `analyze_code_relationships` |
+| Find complex functions to refactor | `find_most_complex_functions` |
+| Check for dead code | `find_dead_code` |
+| Scope a plan during research | `analyze_code_relationships` on the target area |
+| Custom graph queries | `execute_cypher_query` |
+
+## Tool Reference
+
+### indusk (14 tools)
+
+| Tool | When to use |
+|------|-------------|
+| `list_plans` | Session start, orientation |
+| `get_plan_status` | Before working on a plan, checking progress |
+| `advance_plan` | End of every phase — validates all gates |
+| `order_plans` | Understanding plan dependencies |
+| `get_context` | Session start, after context updates |
+| `update_context` | Updating CLAUDE.md sections programmatically |
+| `get_quality_config` | Reviewing Biome rules, after retros |
+| `suggest_rule` | Finding Biome rules for new patterns |
+| `quality_check` | After verification items, before advancing |
+| `list_docs` | After document items, checking coverage |
+| `check_docs_coverage` | After retros, finding doc gaps |
+| `get_system_version` | Debugging, version checks |
+| `get_skill_versions` | Checking for outdated skills |
+| `check_health` | Session start, debugging connectivity |