@mycodemap/mycodemap 1.9.0 → 2.7.0

package/dist/cli/commands/env-contract.js

@@ -0,0 +1,221 @@
+// [META] since:2026-05-02 | owner:cli-team | stable:false
+// [WHY] Top-level 'env-contract' command — query the Project Environment Contract for subagent rule retrieval.
+import { Command } from 'commander';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { discoverProjectEnvironmentContract, filterContractForAgent, checkProjectEnvironmentContract, validateProjectEnvironmentContract, } from '../env-contract/index.js';
+import { buildReminderHookCommand, runReminderHookFromStdin, } from '../env-contract/reminder-hook-runner.js';
+import { resolveOutputMode, formatError } from '../output/index.js';
+const CONTRACT_FILE = '.mycodemap/env-contract.json';
+function loadExistingContract(rootDir) {
+    const contractPath = path.join(rootDir, CONTRACT_FILE);
+    if (!existsSync(contractPath))
+        return undefined;
+    try {
+        const raw = readFileSync(contractPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const result = validateProjectEnvironmentContract(parsed);
+        if (result.valid)
+            return parsed;
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeContractFile(rootDir, contract) {
+    const contractPath = path.join(rootDir, CONTRACT_FILE);
+    const dir = path.dirname(contractPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(contractPath, JSON.stringify(contract, null, 2) + '\n', 'utf8');
+}
+function buildHookConfigOutput(agentType) {
+    const hookJson = {
+        hooks: {
+            SubagentStart: [
+                {
+                    matcher: agentType === 'default' ? '*' : agentType.charAt(0).toUpperCase() + agentType.slice(1),
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: buildReminderHookCommand('claude'),
+                        },
+                    ],
+                },
+            ],
+        },
+    };
+    return JSON.stringify(hookJson, null, 2);
+}
+function buildCodexAgentOutput(agentType) {
+    return `name = "${agentType}"
+description = "Execution-focused agent for implementation and fixes"
+# model = "gpt-5.4"
+# model_reasoning_effort = "high"
+# sandbox_mode = "workspace-write"
+developer_instructions = """
+You are a ${agentType} agent responsible for implementing and fixing code.
+
+Enable the delegated-start reminder hook with:
+- ${buildReminderHookCommand('codex')}
+
+When you need the project environment contract:
+- Run: mycodemap env-contract --for ${agentType} --json
+- Or use the MCP tool: codemap_env_contract(agentType="${agentType}")
+
+The contract contains project-specific rules that you MUST follow, including:
+- Shell command wrappers (e.g., rtk)
+- Commit message format
+- Test entry commands
+- Code style requirements
+"""
+`;
+}
+function getExitCodeForCheck(result, contract) {
+    if (result.status === 'error')
+        return 1;
+    if (result.status === 'warn')
+        return 2;
+    // Also check if there are only conflicts (warn-only)
+    if (contract.conflicts.length > 0 && result.status === 'ok')
+        return 2;
+    return 0;
+}
+async function envContractAction(options) {
+    try {
+        const rootDir = process.cwd();
+        const mode = resolveOutputMode({ json: options.json, human: options.human });
+        // Determine agent type for filtering
+        const agentType = options.for ?? 'default';
+        // Load or discover contract
+        let contract = loadExistingContract(rootDir);
+        let discoveredFresh = false;
+        if (!contract) {
+            contract = discoverProjectEnvironmentContract(rootDir);
+            discoveredFresh = true;
+            // Write if --update is specified
+            if (options.update) {
+                writeContractFile(rootDir, contract);
+                discoveredFresh = false;
+            }
+        }
+        else if (options.update) {
+            // Regenerate even if existing
+            contract = discoverProjectEnvironmentContract(rootDir);
+            writeContractFile(rootDir, contract);
+        }
+        // --as-hook-config mode
+        if (options.asHookConfig) {
+            const output = buildHookConfigOutput(agentType);
+            process.stdout.write(output + '\n');
+            return;
+        }
+        // --run-reminder-hook mode
+        if (options.runReminderHook) {
+            const runtime = options.runReminderHook === 'claude' ? 'claude' : options.runReminderHook === 'codex' ? 'codex' : undefined;
+            if (!runtime) {
+                throw new Error(`Unsupported reminder hook runtime: ${options.runReminderHook}`);
+            }
+            const output = await runReminderHookFromStdin(runtime);
+            if (output.length > 0) {
+                process.stdout.write(output + '\n');
+            }
+            return;
+        }
+        // --as-codex-agent mode
+        if (options.asCodexAgent) {
+            const output = buildCodexAgentOutput(agentType);
+            process.stdout.write(output + '\n');
+            return;
+        }
+        // --check mode
+        if (options.check) {
+            const checkResult = checkProjectEnvironmentContract(contract, rootDir);
+            if (mode === 'json') {
+                process.stdout.write(JSON.stringify({
+                    ...checkResult,
+                    contract: {
+                        schemaVersion: contract.schemaVersion,
+                        generatedAt: contract.generatedAt,
+                        itemCount: contract.items.length,
+                        conflictCount: contract.conflicts.length,
+                    },
+                }, null, 2) + '\n');
+            }
+            else {
+                const statusIcon = checkResult.status === 'ok' ? 'OK' : checkResult.status === 'warn' ? 'WARN' : 'ERROR';
+                process.stdout.write(`Contract Status: ${statusIcon}\n`);
+                for (const d of checkResult.diagnostics) {
+                    const icon = d.severity === 'ok' ? '  [OK]' : d.severity === 'warn' ? '  [WARN]' : '  [ERR]';
+                    process.stdout.write(`${icon} ${d.message}\n`);
+                    if (d.remediation) {
+                        process.stdout.write(`         -> ${d.remediation}\n`);
+                    }
+                }
+            }
+            process.exitCode = getExitCodeForCheck(checkResult, contract);
+            return;
+        }
+        // Normal retrieval mode
+        let items = filterContractForAgent(contract, agentType);
+        // Apply optional category filter
+        if (options.category) {
+            const category = options.category;
+            items = items.filter((item) => item.category === category);
+        }
+        // Build output
+        const output = {
+            schemaVersion: contract.schemaVersion,
+            generatedAt: contract.generatedAt,
+            agentType,
+            items,
+            conflicts: contract.conflicts,
+            sourceSnapshots: contract.sourceSnapshots,
+            ...(discoveredFresh ? { _note: 'Contract discovered from current files (not loaded from .mycodemap/env-contract.json). Run with --update to persist.' } : {}),
+        };
+        if (mode === 'json') {
+            process.stdout.write(JSON.stringify(output, null, 2) + '\n');
+        }
+        else {
+            // Human-readable output
+            process.stdout.write(`Project Environment Contract\n`);
+            process.stdout.write(`Schema: ${contract.schemaVersion} | Generated: ${contract.generatedAt}\n`);
+            process.stdout.write(`Agent filter: ${agentType} | Items: ${items.length}\n\n`);
+            for (const item of items) {
+                process.stdout.write(`[${item.severity.toUpperCase()}] ${item.id} (${item.category})\n`);
+                process.stdout.write(`  ${item.content}\n`);
+                for (const src of item.sources) {
+                    process.stdout.write(`  Source: ${src.file}${src.line ? `:${src.line}` : ''} [${src.authority}]\n`);
+                }
+                process.stdout.write('\n');
+            }
+            if (contract.conflicts.length > 0) {
+                process.stdout.write(`\nConflicts (${contract.conflicts.length}):\n`);
+                for (const c of contract.conflicts) {
+                    process.stdout.write(`  [${c.severity.toUpperCase()}] ${c.id}: ${c.description}\n`);
+                    process.stdout.write(`  Recommendation: ${c.recommendation}\n`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        const mode = resolveOutputMode({ json: options.json, human: options.human });
+        process.stdout.write(formatError(error, mode) + '\n');
+        process.exitCode = 1;
+    }
+}
+export const envContractCommand = new Command('env-contract')
+    .description('Query the Project Environment Contract for subagent rule retrieval')
+    .option('-j, --json', 'Output contract as JSON')
+    .option('--human', 'Force human-readable output')
+    .option('--for <agentType>', 'Filter contract items for an agent type (explore|plan|edit|worker|review|verify|default)')
+    .option('--category <category>', 'Filter by contract category (execution|commit|retrieval|validation|style)')
+    .option('--check', 'Check contract freshness and critical coverage')
+    .option('--update', 'Regenerate .mycodemap/env-contract.json')
+    .option('--as-hook-config', 'Print Claude Code SubagentStart hook example')
+    .option('--as-codex-agent', 'Print Codex agent developer_instructions example')
+    .option('--run-reminder-hook <runtime>', 'Run the delegated-start reminder hook for claude or codex')
+    .action(envContractAction);
+//# sourceMappingURL=env-contract.js.map

package/dist/cli/commands/env-contract.js.map

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

package/dist/cli/commands/generate.d.ts

@@ -1,3 +1,4 @@
+import type { IncrementalRefreshStatus, IncrementalRefreshSummary } from '../../interface/types/storage.js';
 export interface GenerateCommandOptionSources {
     mode?: string;
     output?: string;
@@ -9,7 +10,24 @@ export interface GenerateCommandOptions {
     ai?: boolean;
     'ai-context'?: boolean;
     symbolLevel?: boolean;
+    incremental?: boolean;
+    changedFiles?: string[];
+    base?: string;
+    against?: string;
+    json?: boolean;
+    human?: boolean;
+    structured?: boolean;
     __optionSources?: GenerateCommandOptionSources;
 }
-export declare function generateCommand(options: GenerateCommandOptions): Promise<void>;
+interface GenerateCommandResult {
+    status: IncrementalRefreshStatus;
+    mode: 'full' | 'incremental';
+    graph_status: 'complete' | 'partial';
+    generated_at: string;
+    storage_type: string;
+    output_dir: string;
+    refresh?: IncrementalRefreshSummary;
+}
+export declare function generateCommand(options: GenerateCommandOptions): Promise<GenerateCommandResult>;
+export {};
 //# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,4BAA4B,CAAC;CAChD;AA8LD,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,iBAuJpE"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAIV,wBAAwB,EACxB,yBAAyB,EAE1B,MAAM,kCAAkC,CAAC;AAO1C,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,4BAA4B,CAAC;CAChD;AAUD,UAAU,qBAAqB;IAC7B,MAAM,EAAE,wBAAwB,CAAC;IACjC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAC7B,YAAY,EAAE,UAAU,GAAG,SAAS,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC;AA8aD,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,kCA2LpE"}