@modus-ai/modus 0.1.4 → 0.1.6

package/dist/generators/cursor.js

@@ -0,0 +1,220 @@
+import path from 'node:path';
+import { writeFile, readTemplate, fileExists, readFile } from '../utils/file-system.js';
+const RULES_BASE = path.join('.cursor', 'rules');
+const MCP_PATH = path.join('.cursor', 'mcp.json');
+// ---------------------------------------------------------------------------
+// Framework Skills → individual .mdc rules
+// ---------------------------------------------------------------------------
+const SKILL_RULES = [
+    {
+        id: 'modus-init',
+        templatePath: 'skills/modus-init/SKILL.md',
+        description: 'Run /modus:init to scan the codebase and build Business Skills for each domain',
+    },
+    {
+        id: 'modus-vibe',
+        templatePath: 'skills/modus-vibe/SKILL.md',
+        description: 'Run /modus:vibe to start context-aware vibe coding with business Skill preloading',
+    },
+    {
+        id: 'modus-plan',
+        templatePath: 'skills/modus-plan/SKILL.md',
+        description: 'Run /modus:plan to create structured feature proposals with complexity grading',
+    },
+    {
+        id: 'modus-spec',
+        templatePath: 'skills/modus-spec/SKILL.md',
+        description: 'Run /modus:spec for OpenSpec-driven development with delta specs and GIVEN/WHEN/THEN scenarios',
+    },
+    {
+        id: 'modus-auto',
+        templatePath: 'skills/modus-auto/SKILL.md',
+        description: 'Run /modus:auto with a TAPD story URL to get AI-recommended mode (vibe/plan/spec/harness)',
+    },
+    {
+        id: 'modus-harness',
+        templatePath: 'skills/modus-harness/SKILL.md',
+        description: 'Run /modus:harness to execute the full dual-loop multi-agent development pipeline',
+    },
+];
+// Harness sub-agent templates to merge into the single harness rule
+const HARNESS_SUB_AGENT_TEMPLATES = [
+    { id: '00-skills-builder', templatePath: 'skills/modus-harness-agents/00-skills-builder/SKILL.md' },
+    { id: '01-analysis', templatePath: 'skills/modus-harness-agents/01-analysis/SKILL.md' },
+    { id: '02-dev', templatePath: 'skills/modus-harness-agents/02-dev/SKILL.md' },
+    { id: '03-test', templatePath: 'skills/modus-harness-agents/03-test/SKILL.md' },
+    { id: '04-perf', templatePath: 'skills/modus-harness-agents/04-perf/SKILL.md' },
+    { id: '05-security', templatePath: 'skills/modus-harness-agents/05-security/SKILL.md' },
+    { id: '06-review', templatePath: 'skills/modus-harness-agents/06-review/SKILL.md' },
+    { id: '07-deploy', templatePath: 'skills/modus-harness-agents/07-deploy/SKILL.md' },
+];
+// ---------------------------------------------------------------------------
+// Main entry
+// ---------------------------------------------------------------------------
+export function generateCursorFiles(projectRoot, config, _opts = {}) {
+    generateCursorSkillRules(projectRoot, config);
+    generateCursorHarnessRule(projectRoot);
+    generateCursorConstitution(projectRoot, config);
+    generateCursorAutoVibe(projectRoot);
+    generateCursorMcp(projectRoot, config);
+}
+// ---------------------------------------------------------------------------
+// Individual skill rules
+// ---------------------------------------------------------------------------
+function generateCursorSkillRules(projectRoot, config) {
+    const enabled = new Set(config.commands.enabled);
+    for (const skill of SKILL_RULES) {
+        // Only generate command-backed skills if the command is enabled
+        const cmdId = skill.id.replace('modus-', '');
+        if (['init', 'vibe', 'plan', 'spec', 'auto', 'harness'].includes(cmdId) && !enabled.has(cmdId)) {
+            continue;
+        }
+        let body;
+        try {
+            body = readTemplate(skill.templatePath);
+        }
+        catch {
+            continue;
+        }
+        const content = buildMdcFile(skill.description, false, body);
+        writeFile(path.join(projectRoot, RULES_BASE, `${skill.id}.mdc`), content);
+    }
+}
+// ---------------------------------------------------------------------------
+// Harness rule — single-agent degradation
+// ---------------------------------------------------------------------------
+function generateCursorHarnessRule(projectRoot) {
+    const sections = [
+        '# Modus Harness — Single-Agent Mode',
+        '',
+        '> **Note:** Cursor does not support native Sub-Agents. The Harness pipeline runs in',
+        '> single-agent mode: the orchestrator executes each step sequentially within one context.',
+        '> For full parallel Sub-Agent support, use CodeBuddy or Claude Code.',
+        '',
+        '## Pipeline Steps (sequential)',
+        '',
+    ];
+    for (const agent of HARNESS_SUB_AGENT_TEMPLATES) {
+        let body;
+        try {
+            body = readTemplate(agent.templatePath);
+        }
+        catch {
+            continue;
+        }
+        sections.push(`### Step ${agent.id}`, '', body, '', '---', '');
+    }
+    const content = buildMdcFile('Modus Harness orchestration steps (single-agent mode for Cursor)', false, sections.join('\n'));
+    writeFile(path.join(projectRoot, RULES_BASE, 'modus-harness-agents.mdc'), content);
+}
+// ---------------------------------------------------------------------------
+// Constitution rule
+// ---------------------------------------------------------------------------
+function generateCursorConstitution(projectRoot, config) {
+    const any = config;
+    const constitution = any['constitution'] ?? {};
+    const techStack = String(constitution['tech_stack'] ?? config.techStack ?? '');
+    const buildCmd = String(constitution['build_command'] ?? '');
+    const testCmd = String(constitution['test_command'] ?? '');
+    const context = config.context ?? '';
+    const hardRules = Array.isArray(constitution['hard_rules'])
+        ? constitution['hard_rules'].map((r) => `- ${r}`).join('\n')
+        : '';
+    const keyPatterns = Array.isArray(constitution['key_patterns'])
+        ? constitution['key_patterns'].map((p) => `- ${p}`).join('\n')
+        : '';
+    const lines = ['# Modus Project Constitution', ''];
+    if (context) {
+        lines.push(`> ${context}`, '');
+    }
+    if (techStack) {
+        lines.push(`**Tech Stack:** ${techStack}`, '');
+    }
+    if (buildCmd) {
+        lines.push(`**Build Command:** \`${buildCmd}\``, '');
+    }
+    if (testCmd) {
+        lines.push(`**Test Command:** \`${testCmd}\``, '');
+    }
+    if (hardRules) {
+        lines.push('**Hard Rules (must never violate):**', hardRules, '');
+    }
+    if (keyPatterns) {
+        lines.push('**Key Patterns:**', keyPatterns, '');
+    }
+    lines.push('**Modus Commands:** `/modus:init` · `/modus:vibe` · `/modus:plan` · `/modus:spec` · `/modus:auto` · `/modus:harness`');
+    const content = buildMdcFile('Modus project constitution — tech stack, hard rules, and key patterns', true, lines.join('\n'));
+    writeFile(path.join(projectRoot, RULES_BASE, 'modus-constitution.mdc'), content);
+}
+// ---------------------------------------------------------------------------
+// Auto-vibe — always-on rule that activates vibe behavior automatically
+// ---------------------------------------------------------------------------
+function generateCursorAutoVibe(projectRoot) {
+    const body = [
+        '# Modus Auto-Vibe Mode',
+        '',
+        'This project has Modus initialized. **For every conversation, automatically apply',
+        'vibe-mode behavior** — do not wait for the user to type `/modus:vibe`.',
+        '',
+        '## Auto-Vibe Instructions',
+        '',
+        '1. At the start of each conversation, read `modus/knowledge-catalog.md` to understand',
+        '   available Business Skills and their domains.',
+        '2. Based on the user\'s request, identify the relevant business domain(s).',
+        '3. Load the corresponding `.cursor/rules/modus-biz-{domain}.mdc` rule(s) to get',
+        '   business context (entities, rules, pitfalls, key files).',
+        '4. Respond as a developer who deeply understands this project — apply the',
+        '   business rules, naming conventions, and known pitfalls from the loaded Skills.',
+        '5. If the user explicitly triggers `/modus:plan`, `/modus:spec`, or `/modus:harness`,',
+        '   switch to that mode\'s workflow.',
+        '',
+        '## Token Efficiency',
+        '',
+        '- Load Skills **on demand** (only for domains relevant to the current request).',
+        '- Skip loading if the request is clearly out of project scope (e.g. general questions).',
+        '- Re-use already-loaded Skill context within the same conversation.',
+    ].join('\n');
+    const content = buildMdcFile('Auto-apply Modus vibe mode for every conversation — load Business Skills based on user request', true, body);
+    writeFile(path.join(projectRoot, RULES_BASE, 'modus-auto-vibe.mdc'), content);
+}
+// ---------------------------------------------------------------------------
+// MCP config — .cursor/mcp.json
+// ---------------------------------------------------------------------------
+function generateCursorMcp(projectRoot, config) {
+    if (!config.mcpServers || Object.keys(config.mcpServers).length === 0)
+        return;
+    const mcpPath = path.join(projectRoot, MCP_PATH);
+    let existing = {};
+    if (fileExists(mcpPath)) {
+        try {
+            existing = JSON.parse(readFile(mcpPath));
+        }
+        catch {
+            existing = {};
+        }
+    }
+    const existingServers = existing['mcpServers'] ?? {};
+    existing['mcpServers'] = { ...config.mcpServers, ...existingServers };
+    writeFile(mcpPath, JSON.stringify(existing, null, 2) + '\n');
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Wrap markdown body in a Cursor .mdc frontmatter header.
+ */
+function buildMdcFile(description, alwaysApply, body) {
+    return `---\ndescription: "${description.replace(/"/g, '\\"')}"\nalwaysApply: ${alwaysApply}\n---\n\n${body}\n`;
+}
+// ---------------------------------------------------------------------------
+// Business Skill sync
+// ---------------------------------------------------------------------------
+/**
+ * Sync a single business Skill to Cursor format.
+ * Creates a rule at .cursor/rules/modus-biz-{domain}.mdc
+ */
+export function syncBizSkillToCursor(projectRoot, domain, skillContent) {
+    const content = buildMdcFile(`Business rules and conventions for the ${domain} domain`, false, skillContent);
+    writeFile(path.join(projectRoot, RULES_BASE, `modus-biz-${domain}.mdc`), content);
+}
+//# sourceMappingURL=cursor.js.map

package/dist/generators/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/generators/cursor.ts"],"names":[],"mappings":"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"}

package/dist/generators/index.d.ts

@@ -0,0 +1,9 @@
+import { type GenerateOptions } from './codebuddy.js';
+import type { ModusConfig } from '../utils/config.js';
+export type { GenerateOptions };
+/**
+ * Generate configuration files for every platform listed in `config.platforms`.
+ * Defaults to ['codebuddy'] when the field is absent to preserve backward compat.
+ */
+export declare function generateAllPlatformFiles(projectRoot: string, config: ModusConfig, opts?: GenerateOptions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAI9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,eAAoB,GACzB,IAAI,CAeN"}

package/dist/generators/index.js

@@ -0,0 +1,26 @@
+// Platform dispatcher — generates configuration files for all selected AI platforms.
+// Called by `modus init` and `modus update`; replaces direct calls to generateCodeBuddyFiles.
+import { generateCodeBuddyFiles } from './codebuddy.js';
+import { generateClaudeFiles } from './claude.js';
+import { generateCursorFiles } from './cursor.js';
+import { generateCopilotFiles } from './copilot.js';
+/**
+ * Generate configuration files for every platform listed in `config.platforms`.
+ * Defaults to ['codebuddy'] when the field is absent to preserve backward compat.
+ */
+export function generateAllPlatformFiles(projectRoot, config, opts = {}) {
+    const platforms = config.platforms ?? ['codebuddy'];
+    if (platforms.includes('codebuddy')) {
+        generateCodeBuddyFiles(projectRoot, config, opts);
+    }
+    if (platforms.includes('claude')) {
+        generateClaudeFiles(projectRoot, config, opts);
+    }
+    if (platforms.includes('cursor')) {
+        generateCursorFiles(projectRoot, config, opts);
+    }
+    if (platforms.includes('copilot')) {
+        generateCopilotFiles(projectRoot, config, opts);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,8FAA8F;AAC9F,OAAO,EAAE,sBAAsB,EAAwB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKpD;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAAmB,EACnB,MAAmB,EACnB,OAAwB,EAAE;IAE1B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/utils/analytics.d.ts

@@ -0,0 +1,14 @@
+export interface TrackEvent {
+    event_type: string;
+    command?: string;
+    sub_agent?: string;
+    result?: string;
+    payload?: Record<string, unknown>;
+}
+/**
+ * Send a usage event to the Modus Collector API.
+ * Fire-and-forget: errors are silently swallowed so they never block the CLI.
+ * Respects MODUS_ANALYTICS_DISABLED=1 env var.
+ */
+export declare function track(projectRoot: string, event: TrackEvent): void;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/utils/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/utils/analytics.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AA2BD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CA+ClE"}

package/dist/utils/analytics.js

@@ -0,0 +1,81 @@
+import { createHash } from 'node:crypto';
+import { execSync } from 'node:child_process';
+import os from 'node:os';
+import { loadConfig } from './config.js';
+/**
+ * Derive an anonymized user ID from git email or hostname (MD5, not reversible).
+ * Never sends the raw email.
+ */
+function resolveUserId() {
+    try {
+        const email = execSync('git config --global user.email', {
+            timeout: 2000,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString()
+            .trim();
+        if (email)
+            return createHash('md5').update(email).digest('hex').slice(0, 16);
+    }
+    catch {
+        // git not available or no config
+    }
+    return createHash('md5').update(os.hostname()).digest('hex').slice(0, 16);
+}
+let _userId = null;
+function getUserId() {
+    if (!_userId)
+        _userId = resolveUserId();
+    return _userId;
+}
+/**
+ * Send a usage event to the Modus Collector API.
+ * Fire-and-forget: errors are silently swallowed so they never block the CLI.
+ * Respects MODUS_ANALYTICS_DISABLED=1 env var.
+ */
+export function track(projectRoot, event) {
+    // Env-level opt-out
+    if (process.env['MODUS_ANALYTICS_DISABLED'] === '1')
+        return;
+    // Read config lazily; if it fails, just skip
+    let collectorUrl;
+    let token;
+    let projectId;
+    let teamName;
+    try {
+        const config = loadConfig(projectRoot);
+        const analytics = config.analytics;
+        if (analytics?.enabled === false)
+            return;
+        collectorUrl = analytics?.collectorUrl?.trim();
+        token = analytics?.token?.trim();
+        projectId = config.tapdProjectId ?? undefined;
+        teamName = config.teamName ?? undefined;
+    }
+    catch {
+        return;
+    }
+    if (!collectorUrl)
+        return;
+    const body = JSON.stringify({
+        event_type: event.event_type,
+        command: event.command,
+        sub_agent: event.sub_agent,
+        user_id: getUserId(),
+        project_id: projectId,
+        team_name: teamName,
+        result: event.result,
+        payload: event.payload,
+    });
+    // Defer so the main CLI flow is never blocked
+    setImmediate(() => {
+        const url = `${collectorUrl}/track`;
+        const headers = { 'Content-Type': 'application/json' };
+        if (token)
+            headers['Authorization'] = `Bearer ${token}`;
+        fetch(url, { method: 'POST', headers, body, signal: AbortSignal.timeout(3000) }).catch(() => {
+            // Intentionally silent
+        });
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/utils/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/utils/analytics.ts"],"names":[],"mappings":"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"}

package/dist/utils/config.d.ts

@@ -1,3 +1,13 @@
+/** Supported AI platform targets for file generation. */
+export type PlatformId = 'codebuddy' | 'claude' | 'cursor' | 'copilot';
+export interface ModusAnalyticsConfig {
+    /** Whether to send usage events. Defaults to true. */
+    enabled?: boolean;
+    /** URL of the Modus Collector API, e.g. http://43.139.34.70:3456 */
+    collectorUrl?: string;
+    /** Bearer token for the collector API (optional). */
+    token?: string;
+}
 export interface ModusConfig {
     version: string;
     commands: {
@@ -13,6 +23,21 @@ export interface ModusConfig {
     teamName?: string;
     /** MCP server configs collected during `modus init`. Written to .codebuddy/settings.json. */
     mcpServers?: Record<string, unknown>;
+    /** Usage analytics — sends command/subagent events to the Collector API. */
+    analytics?: ModusAnalyticsConfig;
+    /**
+     * AI platforms to generate configuration files for.
+     * Set during `modus init`; refreshed by `modus update`.
+     * Defaults to ['codebuddy'] when omitted.
+     */
+    platforms?: PlatformId[];
+    /**
+     * The modus CLI version that last wrote the platform files.
+     * Written by `modus init` and `modus update`.
+     * The session-start hook compares this against the currently installed version
+     * and auto-runs `modus update` when they differ (silent auto-update).
+     */
+    modusBuildVersion?: string;
 }
 export declare function getConfigPath(projectRoot: string): string;
 /**

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AASD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAK3D;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAIzE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAKA,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IACzB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAK3D;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAIzE"}

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAmBnE,MAAM,cAAc,GAAgB;IAClC,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE;QACR,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;KACrD;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAmB;IACjE,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA8CnE,MAAM,cAAc,GAAgB;IAClC,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE;QACR,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;KACrD;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAmB;IACjE,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modus-ai/modus",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Modus — Business-grounded AI coding accelerator for CodeBuddy IDE",
   "keywords": [
     "ai",

package/templates/commands/auto.md

@@ -0,0 +1,38 @@
+# /modus:auto
+
+Smart mode recommendation. Reads a TAPD Story, scores it across 4 dimensions, recommends the best Modus mode, then launches it after human confirmation.
+
+## Instructions
+
+Read and follow the skill at `.codebuddy/skills/modus-auto/SKILL.md` to execute this command.
+
+## Quick Summary
+
+1. Accept a TAPD Story URL (or prompt for manual input if omitted)
+2. Read Story content via TAPD MCP
+3. Score the story across 4 dimensions: Complexity / Risk / Clarity / Contract Impact
+4. Apply the decision tree → recommend one of: vibe / plan / spec / harness
+5. Show recommendation with reasoning + comparison table of other options
+6. Wait for human mode selection
+7. Show parameter confirmation window (second confirmation step)
+8. Auto-launch the selected mode with TAPD context pre-filled
+
+## Usage
+
+```
+/modus:auto https://tapd.cn/company/stories/view/1234567890
+/modus:auto   (without URL — will prompt for manual Story content)
+```
+
+## Decision Tree (summary)
+
+| Score | Recommended Mode |
+|-------|-----------------|
+| Low complexity + Low risk + No contract change | vibe |
+| Medium complexity + High clarity + No contract change | plan |
+| Any contract change OR High risk OR needs testable acceptance criteria | spec |
+| Low clarity OR High complexity + High risk OR full automation needed | harness |
+
+## When to Use
+
+Use `/modus:auto` when you have a TAPD Story but are unsure which Modus mode fits best. The AI analyzes the story and presents a reasoned recommendation — you still make the final call.

package/templates/commands/modus.md

@@ -10,13 +10,25 @@ Modus — Business-grounded AI coding accelerator.
 | `/modus:vibe` | Context-aware vibe coding with business Skill backing |
 | `/modus:plan` | Plan mode with Skill-backed business context |
 | `/modus:spec` | OpenSpec-style spec-driven development |
+| `/modus:auto` | Smart mode recommendation — reads TAPD Story, scores 4 dimensions, recommends vibe/plan/spec/harness |
 | `/modus:harness` | Full dual-loop multi-agent Harness (analyze → dev → test → review → deploy) |
 
 ## Quick Start
 
 1. Run `/modus:init` once to scan your project and build business Skills
-2. Use `/modus:vibe` for day-to-day coding with project context
-3. Use `/modus:harness` for full-cycle feature delivery from a TAPD Story URL
+2. Use `/modus:auto [tapd-url]` when unsure which mode fits — AI recommends based on story analysis
+3. Use `/modus:vibe` for day-to-day coding with project context
+4. Use `/modus:harness` for full-cycle feature delivery from a TAPD Story URL
+
+## Mode Selection Guide
+
+| Situation | Recommended Command |
+|-----------|-------------------|
+| Not sure which mode to use | `/modus:auto [tapd-url]` |
+| Quick bug fix / small change | `/modus:vibe` |
+| Feature with design docs, no spec needed | `/modus:plan` |
+| Interface contract changes / testable acceptance criteria | `/modus:spec` |
+| Full automation from TAPD story to deployment | `/modus:harness` |
 
 ## Tips