@moda-ai/cli 1.2.0 → 1.3.0

package/dist/cli.js

@@ -5,7 +5,9 @@ import { callDataAPI, ApiError, getApiRequestCount, resetApiRequestCount, } from
 import { OverviewSchema, ClustersSchema, ClusterConversationsSchema, ConversationsSchema, ContextSchema, FrustrationsSchema, ToolFailuresSchema, ToolFailureDetailSchema, WorkflowsSchema, RunsSchema, RunDetailSchema, LoopsSchema, LoopDetailSchema, } from './schemas.js';
 import { withFrustrationAnchors, withToolFailureAnchors, embeddedWindowSize, asRecord, asString, asNumber } from './transforms.js';
 import { runPromptsCommand } from './prompts.js';
-import { runHooksInstall, runSparkCommand, runWorkspaceCommand } from './workspace.js';
+// Coding-agent capture (shadow workspace / Shadow Spark / trace hooks) is temporarily
+// disabled while the feature is finished — see the commented-out command registrations below.
+// import { runHooksInstall, runSparkCommand, runWorkspaceCommand } from './workspace.js';
 import { runSkillsCommand } from './skills.js';
 import { runHarnessCommand } from './harness.js';
 import { runSyncCommand } from './sync.js';
@@ -154,25 +156,6 @@ Commands:
   prompts sync --watch             Upload again when prompt files change
   prompts promote <key>            Move a dev/staging/prod label
 
-  Shadow workspace:
-  spark status                     Show Shadow Spark workspace state
-  spark explain                    Explain what Shadow Spark captures and posts
-  spark snapshot                   Manual / hook-invoked Shadow Spark snapshot
-  spark snapshot --dry-run         Show file inventory without copy/commit/post
-  spark log                        Show Shadow Spark history
-  spark bundle                     Bundle a shadow commit range for replay
-  spark remove --yes               Delete this repo's local shadow workspace
-  workspace init                   Create shadow workspace for current repo
-  workspace snapshot               Manual / hook-invoked sync + shadow commit
-  workspace status                 Show shadow workspace state
-  workspace explain                Explain shadow workspace behavior
-  workspace log                    Show Moda shadow history (not user git log)
-  workspace bundle                 Bundle a shadow commit range for replay
-  hooks install                    Install Claude Code shadow-workspace hooks
-  hooks install --agent=codex      Install Codex hooks
-  hooks install --agent=cursor     Install Cursor hooks
-  hooks install --agent=all        Install Claude Code, Codex, and Cursor hooks
-
   Skills:
   skills gen                       Kick off tenant-wide skill generation
   skills pull                      Pull tenant-generated skills into .claude/skills (and .cursor/rules)
@@ -207,8 +190,6 @@ Init flags:
                                    Choose harness analyst adapter
   --tui                            Show full-screen analyst dashboard in human TTYs
   --no-tui                         Show raw external analyst output
-  --coding-agent-traces            Install Claude/Codex/Cursor trace hooks
-  --no-coding-agent-traces         Skip Claude/Codex/Cursor trace hook installation
   --sdk-guide                      Write .moda/SDK_INTEGRATION.md
   --no-sdk-guide                   Skip SDK integration guide creation
   --ci-cd                          Create GitHub Actions Moda validation workflow
@@ -241,8 +222,6 @@ Examples:
   moda sync harness --profile=prod
   moda harness scan --json
   moda harness explain --agent=agent_support
-  moda init --coding-agent-traces
-  moda init --no-coding-agent-traces
   moda init --ci-cd
   moda overview --days-back=30
   moda clusters --time-range=7d
@@ -258,11 +237,6 @@ Examples:
   moda prompts status
   moda prompts sync
   moda prompts promote support.triage --label=prod --version=pver_abc123
-  moda spark explain
-  moda spark snapshot --dry-run --json
-  moda workspace snapshot --json
-  moda hooks install
-  moda hooks install --agent=all
   moda skills pull`);
 }
 // --- Command Handlers ---
@@ -870,57 +844,60 @@ export const commandRegistry = createCommandRegistry([
         resetApiRequestCountBeforeRun: true,
         telemetry: 'result-and-error',
     }),
-    {
-        name: 'workspace',
-        description: 'Manage Moda shadow workspace snapshots',
-        examples: ['moda workspace init', 'moda workspace snapshot --json', 'moda workspace explain'],
-        auth: 'none',
-        outputModes: ['human', 'json', 'agent'],
-        mutability: 'write',
-        validateConfigBeforeRun: false,
-        resetApiRequestCountBeforeRun: false,
-        telemetry: 'none',
-        handler: async (context) => ({
-            exitCode: await runWorkspaceCommand({
-                command: context.command,
-                positional: context.positional,
-                positionals: context.positionals,
-                flags: context.flags,
-            }),
-        }),
-    },
-    {
-        name: 'spark',
-        aliases: ['shadow'],
-        description: 'Manage Shadow Spark workspace snapshots',
-        examples: ['moda spark status', 'moda spark explain', 'moda spark snapshot --dry-run --json'],
-        auth: 'none',
-        outputModes: ['human', 'json', 'agent'],
-        mutability: 'write',
-        validateConfigBeforeRun: false,
-        resetApiRequestCountBeforeRun: false,
-        telemetry: 'none',
-        handler: runSparkCommand,
-    },
-    {
-        name: 'hooks',
-        description: 'Install coding-agent trace hooks',
-        examples: ['moda hooks install', 'moda hooks install --agent=all'],
-        auth: 'none',
-        outputModes: ['human', 'json', 'agent'],
-        mutability: 'write',
-        validateConfigBeforeRun: false,
-        resetApiRequestCountBeforeRun: false,
-        telemetry: 'none',
-        handler: async (context) => ({
-            exitCode: await runHooksInstall({
-                command: context.command,
-                positional: context.positional,
-                positionals: context.positionals,
-                flags: context.flags,
-            }),
-        }),
-    },
+    // Coding-agent capture commands disabled until the feature is production-ready.
+    // Re-enable by restoring these registrations, the workspace.js import above, the
+    // "Shadow workspace" help section, the init hooks phase, and the doctor spark/hook checks.
+    // {
+    //   name: 'workspace',
+    //   description: 'Manage Moda shadow workspace snapshots',
+    //   examples: ['moda workspace init', 'moda workspace snapshot --json', 'moda workspace explain'],
+    //   auth: 'none',
+    //   outputModes: ['human', 'json', 'agent'],
+    //   mutability: 'write',
+    //   validateConfigBeforeRun: false,
+    //   resetApiRequestCountBeforeRun: false,
+    //   telemetry: 'none',
+    //   handler: async (context) => ({
+    //     exitCode: await runWorkspaceCommand({
+    //       command: context.command,
+    //       positional: context.positional,
+    //       positionals: context.positionals,
+    //       flags: context.flags,
+    //     }),
+    //   }),
+    // },
+    // {
+    //   name: 'spark',
+    //   aliases: ['shadow'],
+    //   description: 'Manage Shadow Spark workspace snapshots',
+    //   examples: ['moda spark status', 'moda spark explain', 'moda spark snapshot --dry-run --json'],
+    //   auth: 'none',
+    //   outputModes: ['human', 'json', 'agent'],
+    //   mutability: 'write',
+    //   validateConfigBeforeRun: false,
+    //   resetApiRequestCountBeforeRun: false,
+    //   telemetry: 'none',
+    //   handler: runSparkCommand,
+    // },
+    // {
+    //   name: 'hooks',
+    //   description: 'Install coding-agent trace hooks',
+    //   examples: ['moda hooks install', 'moda hooks install --agent=all'],
+    //   auth: 'none',
+    //   outputModes: ['human', 'json', 'agent'],
+    //   mutability: 'write',
+    //   validateConfigBeforeRun: false,
+    //   resetApiRequestCountBeforeRun: false,
+    //   telemetry: 'none',
+    //   handler: async (context) => ({
+    //     exitCode: await runHooksInstall({
+    //       command: context.command,
+    //       positional: context.positional,
+    //       positionals: context.positionals,
+    //       flags: context.flags,
+    //     }),
+    //   }),
+    // },
     {
         name: 'skills',
         description: 'Generate and pull Moda skills',

package/dist/doctor.js

@@ -162,9 +162,12 @@ export async function buildDoctorReport(context, options) {
         '__tests__',
     ]));
     checks.push(sdkInitializationCheck(context.cwd));
-    checks.push(shadowSparkWorkspaceCheck(context.cwd, context.env));
-    checks.push(hookCheck(context.env));
-    checks.push(...hookTelemetryChecks(context.env, ingestUrl));
+    // Coding-agent capture (Shadow Spark + trace hooks) is temporarily disabled, so doctor
+    // must not recommend its commands. `shadowSpark` in the status payload falls back to
+    // 'skipped' via checkStatus.
+    // checks.push(shadowSparkWorkspaceCheck(context.cwd, context.env));
+    // checks.push(hookCheck(context.env));
+    // checks.push(...hookTelemetryChecks(context.env, ingestUrl));
     checks.push(validationEventPathCheck(ingestUrl));
     if (options.offline || !apiKey) {
         checks.push(...offlineCloudChecks(options.offline));
@@ -519,6 +522,8 @@ function sdkInitializationCheck(cwd) {
         nextCommand: 'moda init',
     };
 }
+// Unused while coding-agent capture is disabled; kept for re-enablement.
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 function shadowSparkWorkspaceCheck(cwd, env) {
     const repo = detectGitRepo(cwd);
     if (!repo) {
@@ -552,6 +557,8 @@ function shadowSparkWorkspaceCheck(cwd, env) {
         nextCommand: healthy ? undefined : 'moda spark snapshot --json',
     };
 }
+// Unused while coding-agent capture is disabled; kept for re-enablement.
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 function hookCheck(env) {
     const paths = getModaPaths({ env });
     const hookCandidates = [
@@ -571,6 +578,8 @@ function hookCheck(env) {
         nextCommand: found.length > 0 ? undefined : 'moda hooks install --agent=all',
     };
 }
+// Unused while coding-agent capture is disabled; kept for re-enablement.
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 function hookTelemetryChecks(env, ingestUrl) {
     const configs = agentTelemetryConfigs(env);
     return [

package/dist/init/index.js

@@ -8,7 +8,8 @@ import { detectAgents } from './mcp.js';
 import { installRules } from './rules.js';
 import { initPrompts } from '../prompts.js';
 import { pullSkills } from '../skills.js';
-import { runHooksInstall } from '../workspace.js';
+// Coding-agent capture is temporarily disabled — see the hooks phase below.
+// import { runHooksInstall } from '../workspace.js';
 import { SDK_GUIDE_PATH, writeSdkIntegrationGuide } from './sdk-guide.js';
 import { createCommandContext } from '../command-context.js';
 import { CliInputError } from '../errors.js';
@@ -29,7 +30,9 @@ export async function runInit(flags, options = {}) {
         if (human)
             console.log(message);
     };
-    const warn = (message) => {
+    // `warn` is only used by the temporarily-disabled hooks phase below; keep the
+    // underscore-prefixed binding so re-enabling it is a rename away.
+    const _warn = (message) => {
         if (human)
             console.error(message);
     };
@@ -103,7 +106,9 @@ export async function runInit(flags, options = {}) {
     // Step 5: Setup plan
     log(renderInitStep(5, 7, 'Setup Plan', 'Every write/sync action is explicit before it is applied.'));
     const setupPlan = buildSetupPlan({
-        installHooks: await shouldIngestCodingAgentTraces(flags, yes),
+        // Coding-agent capture is temporarily disabled; never prompt for or install trace hooks.
+        // installHooks: await shouldIngestCodingAgentTraces(flags, yes),
+        installHooks: false,
         installSdkGuide: await shouldCreateSdkGuide(flags, yes),
         configureCiCd: await shouldConfigureCiCd(flags, yes),
     });
@@ -113,25 +118,25 @@ export async function runInit(flags, options = {}) {
     // Step 6: Apply approved setup changes.
     log(renderInitStep(6, 7, 'Apply Approved Changes'));
     emit('apply', 'Applying approved setup changes.');
-    const ingestCodingAgentTraces = setupPlan.find((action) => action.category === 'hooks')?.approved === true;
-    if (ingestCodingAgentTraces) {
-        try {
-            await runHooksInstall({
-                command: 'hooks',
-                positional: 'install',
-                positionals: ['install'],
-                flags: { agent: 'all', ...(human ? {} : { json: 'true' }) },
-            });
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            warn(renderInitNote(`hook/telemetry install failed: ${message}`, 'warning'));
-            warn('  Run `moda hooks install --agent=all` manually to enable traces.');
-        }
-    }
-    else {
-        log(renderInitNote('Skipped coding-agent trace ingestion', 'skipped'));
-    }
+    // Coding-agent capture is temporarily disabled; the hooks phase never runs.
+    // const ingestCodingAgentTraces = setupPlan.find((action) => action.category === 'hooks')?.approved === true;
+    const ingestCodingAgentTraces = false;
+    // if (ingestCodingAgentTraces) {
+    //   try {
+    //     await runHooksInstall({
+    //       command: 'hooks',
+    //       positional: 'install',
+    //       positionals: ['install'],
+    //       flags: { agent: 'all', ...(human ? {} : { json: 'true' }) },
+    //     });
+    //   } catch (err) {
+    //     const message = err instanceof Error ? err.message : String(err);
+    //     warn(renderInitNote(`hook/telemetry install failed: ${message}`, 'warning'));
+    //     warn('  Run `moda hooks install --agent=all` manually to enable traces.');
+    //   }
+    // } else {
+    //   log(renderInitNote('Skipped coding-agent trace ingestion', 'skipped'));
+    // }
     const agents = detectAgents();
     if (agents.length > 0) {
         log(renderInitNote(`Detected coding agents: ${agents.join(', ')}`));
@@ -172,7 +177,7 @@ export async function runInit(flags, options = {}) {
     }
     log(renderInitNote('Reusing approved Step 4 harness report; no second analyst run needed'));
     markApplied(setupPlan, 'harness');
-    markApplied(setupPlan, 'hooks', ingestCodingAgentTraces ? undefined : 'User skipped coding-agent trace hooks.');
+    markApplied(setupPlan, 'hooks', ingestCodingAgentTraces ? undefined : 'Coding-agent trace capture is temporarily unavailable.');
     markApplied(setupPlan, 'prompts');
     markApplied(setupPlan, 'skills');
     emit('apply', 'Approved changes applied.', 'completed');
@@ -226,7 +231,7 @@ function buildSetupPlan(options) {
             approved: options.installHooks,
             files: ['~/.claude/settings.json', '~/.codex/hooks.json', '~/.cursor/hooks.json'],
             command: 'moda hooks install --agent=all',
-            reason: options.installHooks ? undefined : 'Not approved during init.',
+            reason: options.installHooks ? undefined : 'Coding-agent trace capture is temporarily unavailable.',
         },
         {
             category: 'prompts',
@@ -351,19 +356,20 @@ function commandFlags(flags) {
 function stringFlag(value) {
     return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
 }
-async function shouldIngestCodingAgentTraces(flags, yes) {
-    const explicit = parseOptionalBoolean(flagValue(flags, 'coding-agent-traces', 'coding_agent_traces'));
-    if (explicit !== undefined)
-        return explicit;
-    if (isTruthyFlag(flagValue(flags, 'no-coding-agent-traces', 'no_coding_agent_traces')))
-        return false;
-    if (yes)
-        return true;
-    return confirm({
-        message: 'Ingest coding-agent traces for Claude Code, Codex, and Cursor?',
-        default: true,
-    });
-}
+// Coding-agent capture is temporarily disabled; restore this prompt with the hooks phase.
+// async function shouldIngestCodingAgentTraces(
+//   flags: Record<string, unknown>,
+//   yes: boolean,
+// ): Promise<boolean> {
+//   const explicit = parseOptionalBoolean(flagValue(flags, 'coding-agent-traces', 'coding_agent_traces'));
+//   if (explicit !== undefined) return explicit;
+//   if (isTruthyFlag(flagValue(flags, 'no-coding-agent-traces', 'no_coding_agent_traces'))) return false;
+//   if (yes) return true;
+//   return confirm({
+//     message: 'Ingest coding-agent traces for Claude Code, Codex, and Cursor?',
+//     default: true,
+//   });
+// }
 async function shouldConfigureCiCd(flags, yes) {
     const explicit = parseOptionalBoolean(flagValue(flags, 'ci-cd', 'ci_cd', 'ci'));
     if (explicit !== undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "CLI for Moda - AI agent analytics and observability",
   "type": "module",
   "bin": {