@mycodemap/mycodemap 1.9.0 → 2.7.0

package/dist/cli/init/env-contract-plan.js

@@ -0,0 +1,184 @@
+// [META] since:2026-05-02 | owner:cli-team | stable:false
+// [WHY] Phase 55/58 — generate .mycodemap/env-contract.json from discovery engine.
+// Phase 55 produced env-contract.seed.v1; Phase 58 upgrades to env-contract.v1.
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { discoverProjectEnvironmentContract } from '../env-contract/discovery.js';
+const ASSET_KEY = 'env-contract';
+const ASSET_LABEL = 'env-contract';
+const ASSET_ORIGIN = 'discovery-engine';
+function makeAsset(status, details, options = {}) {
+    return {
+        key: ASSET_KEY,
+        label: ASSET_LABEL,
+        status,
+        ownership: 'tool-owned',
+        origin: ASSET_ORIGIN,
+        path: options.path,
+        details,
+        hash: options.hash,
+        rollbackHint: options.rollbackHint,
+        manualAction: options.manualAction,
+    };
+}
+function normalizeContractForComparison(contract) {
+    const normalized = JSON.parse(JSON.stringify(contract));
+    delete normalized.generatedAt;
+    return JSON.stringify(normalized);
+}
+/**
+ * Check if existing content is a Phase 55 seed contract (env-contract.seed.v1).
+ */
+function isSeedContract(parsed) {
+    return (typeof parsed === 'object' &&
+        parsed !== null &&
+        parsed.schemaVersion === 'env-contract.seed.v1');
+}
+/**
+ * Build an EnvContractPlan describing the env-contract.json decision.
+ *
+ * States:
+ * - file exists + same content          → already-synced
+ * - file exists + seed v1               → migrate + installed (deterministic)
+ * - file exists + different + not seed  → conflict (manual review)
+ * - file missing + preview mode         → skipped
+ * - file missing + apply mode           → installed + write action
+ */
+export function createEnvContractPlan(rootDir, profileName, mode = 'apply', options) {
+    const targetPath = path.join(rootDir, '.mycodemap', 'env-contract.json');
+    const contract = discoverProjectEnvironmentContract(rootDir, {
+        profileName,
+        generatedAt: options?.generatedAt ?? new Date().toISOString(),
+    });
+    const contractJson = JSON.stringify(contract, null, 2);
+    // File already exists — check if content matches
+    if (existsSync(targetPath)) {
+        try {
+            const currentContent = readFileSync(targetPath, 'utf8');
+            // Try to parse existing content
+            let parsed;
+            try {
+                parsed = JSON.parse(currentContent);
+            }
+            catch {
+                // Unparseable — conflict
+                return {
+                    assets: [
+                        makeAsset('conflict', [
+                            '无法解析 .mycodemap/env-contract.json，需手动确认',
+                        ], {
+                            path: targetPath,
+                            manualAction: '手动审阅 .mycodemap/env-contract.json 的内容，确认后可删除该文件再重跑 init',
+                        }),
+                    ],
+                    writes: [],
+                };
+            }
+            if (typeof parsed === 'object' &&
+                parsed !== null &&
+                normalizeContractForComparison(parsed) ===
+                    normalizeContractForComparison(contract)) {
+                return {
+                    assets: [
+                        makeAsset('already-synced', [
+                            'env-contract.json 内容已同步，无需更新',
+                        ], { path: targetPath }),
+                    ],
+                    writes: [],
+                };
+            }
+            // Seed v1 migration — deterministic upgrade
+            if (isSeedContract(parsed)) {
+                return {
+                    assets: [
+                        makeAsset('installed', [
+                            '从 env-contract.seed.v1 迁移至 env-contract.v1',
+                            `发现 ${contract.items.length} 项契约`,
+                            `发现 ${contract.sourceSnapshots.length} 个源快照`,
+                        ], {
+                            path: targetPath,
+                            rollbackHint: '如需回退，可删除 `.mycodemap/env-contract.json`',
+                        }),
+                    ],
+                    writes: [
+                        {
+                            targetPath,
+                            content: contractJson,
+                        },
+                    ],
+                };
+            }
+            // Content differs and is not a recognized seed — conflict
+            return {
+                assets: [
+                    makeAsset('conflict', [
+                        '检测到 .mycodemap/env-contract.json 与当前提取结果不同，本次不会自动覆盖',
+                    ], {
+                        path: targetPath,
+                        manualAction: '手动审阅 .mycodemap/env-contract.json 的内容，确认后可删除该文件再重跑 init',
+                    }),
+                ],
+                writes: [],
+            };
+        }
+        catch {
+            // Read error — treat as conflict
+            return {
+                assets: [
+                    makeAsset('conflict', [
+                        '无法读取 .mycodemap/env-contract.json，需手动确认',
+                    ], {
+                        path: targetPath,
+                        manualAction: '手动审阅 .mycodemap/env-contract.json 的内容，确认后可删除该文件再重跑 init',
+                    }),
+                ],
+                writes: [],
+            };
+        }
+    }
+    // Preview mode — don't write
+    if (mode === 'preview') {
+        return {
+            assets: [
+                makeAsset('skipped', [
+                    `schemaVersion: ${contract.schemaVersion}`,
+                    `projectProfile: ${contract.projectProfile.name}`,
+                    `items: ${contract.items.length} 项`,
+                    `sourceSnapshots: ${contract.sourceSnapshots.length} 个`,
+                    '预览模式不会写入 .mycodemap/env-contract.json；使用 --yes 应用',
+                ]),
+            ],
+            writes: [],
+        };
+    }
+    // Apply mode — write the file
+    return {
+        assets: [
+            makeAsset('installed', [
+                '将生成 .mycodemap/env-contract.json',
+                `发现 ${contract.items.length} 项契约`,
+                `发现 ${contract.sourceSnapshots.length} 个源快照`,
+            ], {
+                path: targetPath,
+                rollbackHint: '如需回退，可删除 `.mycodemap/env-contract.json`',
+            }),
+        ],
+        writes: [
+            {
+                targetPath,
+                content: contractJson,
+            },
+        ],
+    };
+}
+/**
+ * Apply the env-contract plan: write the JSON file to disk.
+ */
+export async function applyEnvContractPlan(plan) {
+    for (const write of plan.writes) {
+        await mkdir(path.dirname(write.targetPath), { recursive: true });
+        await writeFile(write.targetPath, write.content, 'utf8');
+    }
+}
+//# sourceMappingURL=env-contract-plan.js.map

package/dist/cli/init/env-contract-plan.js.map

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

package/dist/cli/init/manifest-extractors.d.ts

@@ -0,0 +1,22 @@
+export interface ManifestItem {
+    category: 'execution' | 'commit' | 'retrieval' | 'validation' | 'style';
+    key: string;
+    value?: string;
+    status?: 'unknown';
+    source: string;
+    confidence: 'high' | 'medium' | 'low' | 'none';
+}
+export interface ManifestFacts {
+    projectType: string;
+    projectSource: string;
+    items: ManifestItem[];
+}
+/**
+ * Extract obvious project facts from manifest files in `rootDir`.
+ *
+ * Reads package.json, pyproject.toml, go.mod, Cargo.toml for basic
+ * project metadata. Returns typed ManifestFacts with items[].
+ * Missing items are represented as status: 'unknown' with source: 'not-detected'.
+ */
+export declare function extractManifestFacts(rootDir: string, profileName?: string): ManifestFacts;
+//# sourceMappingURL=manifest-extractors.d.ts.map

package/dist/cli/init/manifest-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-extractors.d.ts","sourceRoot":"","sources":["../../../src/cli/init/manifest-extractors.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAqKD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAoBf"}

package/dist/cli/init/manifest-extractors.js

@@ -0,0 +1,185 @@
+// [META] since:2026-05-02 | owner:cli-team | stable:false
+// [WHY] Phase 55 — extract obvious project facts from package.json, pyproject.toml,
+// go.mod, Cargo.toml for env-contract seed generation.
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { parse as parseToml } from 'smol-toml';
+function safeReadFile(filePath) {
+    if (!existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        return readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractPackageJson(rootDir, items) {
+    const text = safeReadFile(path.join(rootDir, 'package.json'));
+    if (!text)
+        return;
+    try {
+        const pkg = JSON.parse(text);
+        const scripts = pkg.scripts;
+        if (scripts?.test) {
+            items.push({
+                category: 'execution',
+                key: 'testCommand',
+                value: scripts.test,
+                source: 'package.json:scripts.test',
+                confidence: 'high',
+            });
+        }
+        if (scripts?.build) {
+            items.push({
+                category: 'execution',
+                key: 'buildCommand',
+                value: scripts.build,
+                source: 'package.json:scripts.build',
+                confidence: 'high',
+            });
+        }
+        if (scripts?.lint) {
+            items.push({
+                category: 'execution',
+                key: 'lintCommand',
+                value: scripts.lint,
+                source: 'package.json:scripts.lint',
+                confidence: 'high',
+            });
+        }
+        if (typeof pkg.main === 'string') {
+            items.push({
+                category: 'execution',
+                key: 'entryPoint',
+                value: pkg.main,
+                source: 'package.json:main',
+                confidence: 'medium',
+            });
+        }
+    }
+    catch {
+        // skip malformed package.json
+    }
+}
+function extractPyprojectToml(rootDir, items) {
+    const text = safeReadFile(path.join(rootDir, 'pyproject.toml'));
+    if (!text)
+        return;
+    try {
+        const parsed = parseToml(text);
+        const project = parsed.project;
+        if (project?.name) {
+            items.push({
+                category: 'execution',
+                key: 'projectName',
+                value: String(project.name),
+                source: 'pyproject.toml:project.name',
+                confidence: 'high',
+            });
+        }
+        const tool = parsed.tool;
+        const pytest = tool?.pytest;
+        if (pytest?.ini_options) {
+            items.push({
+                category: 'execution',
+                key: 'testCommand',
+                value: 'pytest',
+                source: 'pyproject.toml:tool.pytest',
+                confidence: 'medium',
+            });
+        }
+    }
+    catch {
+        // skip malformed pyproject.toml
+    }
+}
+function extractGoMod(rootDir, items) {
+    const text = safeReadFile(path.join(rootDir, 'go.mod'));
+    if (!text)
+        return;
+    try {
+        const match = text.match(/^module\s+(.+)$/m);
+        if (match) {
+            items.push({
+                category: 'execution',
+                key: 'moduleName',
+                value: match[1].trim(),
+                source: 'go.mod:module',
+                confidence: 'high',
+            });
+        }
+    }
+    catch {
+        // skip malformed go.mod
+    }
+}
+function extractCargoToml(rootDir, items) {
+    const text = safeReadFile(path.join(rootDir, 'Cargo.toml'));
+    if (!text)
+        return;
+    try {
+        const parsed = parseToml(text);
+        const pkg = parsed.package;
+        if (pkg?.name) {
+            items.push({
+                category: 'execution',
+                key: 'packageName',
+                value: String(pkg.name),
+                source: 'Cargo.toml:package.name',
+                confidence: 'high',
+            });
+        }
+    }
+    catch {
+        // skip malformed Cargo.toml
+    }
+}
+function addMissingDefaults(items) {
+    const keys = new Set(items.map((item) => item.key));
+    if (!keys.has('testCommand')) {
+        items.push({
+            category: 'execution',
+            key: 'testCommand',
+            status: 'unknown',
+            source: 'not-detected',
+            confidence: 'none',
+        });
+    }
+    if (!keys.has('buildCommand')) {
+        items.push({
+            category: 'execution',
+            key: 'buildCommand',
+            status: 'unknown',
+            source: 'not-detected',
+            confidence: 'none',
+        });
+    }
+}
+/**
+ * Extract obvious project facts from manifest files in `rootDir`.
+ *
+ * Reads package.json, pyproject.toml, go.mod, Cargo.toml for basic
+ * project metadata. Returns typed ManifestFacts with items[].
+ * Missing items are represented as status: 'unknown' with source: 'not-detected'.
+ */
+export function extractManifestFacts(rootDir, profileName) {
+    const items = [];
+    extractPackageJson(rootDir, items);
+    extractPyprojectToml(rootDir, items);
+    extractGoMod(rootDir, items);
+    extractCargoToml(rootDir, items);
+    addMissingDefaults(items);
+    // Determine project source from whichever manifest was detected
+    const sourceMap = {
+        nodejs: 'package.json',
+        python: 'pyproject.toml',
+        go: 'go.mod',
+        rust: 'Cargo.toml',
+    };
+    const projectType = profileName ?? 'generic';
+    const projectSource = sourceMap[projectType] ?? 'not-detected';
+    return { projectType, projectSource, items };
+}
+//# sourceMappingURL=manifest-extractors.js.map

package/dist/cli/init/manifest-extractors.js.map

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

package/dist/cli/init/profile-loader.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export declare const bootstrapProfileSchema: z.ZodObject<{
+    parser: z.ZodObject<{
+        include: z.ZodArray<z.ZodString>;
+        extensions: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    ignore: z.ZodArray<z.ZodString>;
+    analysis_depth: z.ZodEnum<{
+        deep: "deep";
+        shallow: "shallow";
+        standard: "standard";
+    }>;
+}, z.core.$strip>;
+export type BootstrapProfile = z.infer<typeof bootstrapProfileSchema>;
+/**
+ * Map `analysis_depth` profile values to the canonical config `mode` field.
+ *
+ * Documented mapping (per RESOLVED open question 2 in 53-RESEARCH.md):
+ *   shallow  -> fast
+ *   standard -> hybrid
+ *   deep     -> smart
+ *
+ * Consumed by `profile-plan.ts` in plan 53-02 when merging profile defaults
+ * into `.mycodemap/config.json`. Kept here so the mapping lives next to the
+ * schema that defines the source enum.
+ */
+export declare const ANALYSIS_DEPTH_TO_MODE: Record<BootstrapProfile['analysis_depth'], 'fast' | 'hybrid' | 'smart'>;
+/**
+ * Resolve the absolute filesystem path for a built-in profile JSON file.
+ *
+ * Throws on unknown names or any name containing path separators / parent-dir
+ * tokens (mitigation for T-53-01 path traversal).
+ */
+export declare function resolveProfilePath(profileName: string): string;
+/**
+ * Load and validate a built-in bootstrap profile by name.
+ *
+ * Errors:
+ *  - Unknown / illegal name → from `resolveProfilePath`
+ *  - File missing on disk   → "Profile 文件未找到" (does NOT include full path
+ *                              in the message body to mitigate T-53-04 info leak;
+ *                              the path is appended only in the trailing detail)
+ *  - JSON parse failure     → re-thrown with profile name context
+ *  - Schema validation fail → flattened ZodError → "Profile 验证失败 [name]: ..."
+ *
+ * Pure: no `process.exit`; callers handle exit codes at CLI entry.
+ */
+export declare function loadProfile(profileName: string): BootstrapProfile;
+//# sourceMappingURL=profile-loader.d.ts.map

package/dist/cli/init/profile-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-loader.d.ts","sourceRoot":"","sources":["../../../src/cli/init/profile-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAOjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAQtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAI1G,CAAC;AAUF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAgCjE"}

package/dist/cli/init/profile-loader.js

@@ -0,0 +1,107 @@
+// [META] since:2026-05-01 | owner:cli-team | stable:false
+// [WHY] Phase 53 profile JSON loader with strict zod validation. Reads built-in
+// bootstrap profiles from the package's `src/cli/init/profiles/` directory and
+// validates them against `bootstrapProfileSchema` before returning a typed result.
+import { z } from 'zod';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const bootstrapProfileSchema = z.object({
+    parser: z.object({
+        include: z.array(z.string()).min(1),
+        extensions: z.array(z.string()).min(1),
+    }),
+    ignore: z.array(z.string()),
+    analysis_depth: z.enum(['shallow', 'standard', 'deep']),
+});
+/**
+ * Allow-list of built-in profile names (security: prevents arbitrary file reads
+ * via `--profile ../../../etc/passwd`-style inputs; threat T-53-01).
+ */
+const ALLOWED_PROFILE_NAMES = new Set(['nodejs', 'python', 'go', 'rust', 'generic']);
+/**
+ * Map `analysis_depth` profile values to the canonical config `mode` field.
+ *
+ * Documented mapping (per RESOLVED open question 2 in 53-RESEARCH.md):
+ *   shallow  -> fast
+ *   standard -> hybrid
+ *   deep     -> smart
+ *
+ * Consumed by `profile-plan.ts` in plan 53-02 when merging profile defaults
+ * into `.mycodemap/config.json`. Kept here so the mapping lives next to the
+ * schema that defines the source enum.
+ */
+export const ANALYSIS_DEPTH_TO_MODE = {
+    shallow: 'fast',
+    standard: 'hybrid',
+    deep: 'smart',
+};
+function resolveProfilesDir() {
+    // Profile JSONs ship next to this loader (in src/ during dev, in dist/ after
+    // build). Resolving relative to `import.meta.url` keeps both layouts in sync
+    // without depending on the package layout above this directory, which is
+    // important because npm `files` only ships `dist/`, not `src/`.
+    return fileURLToPath(new URL('./profiles/', import.meta.url));
+}
+/**
+ * Resolve the absolute filesystem path for a built-in profile JSON file.
+ *
+ * Throws on unknown names or any name containing path separators / parent-dir
+ * tokens (mitigation for T-53-01 path traversal).
+ */
+export function resolveProfilePath(profileName) {
+    if (!ALLOWED_PROFILE_NAMES.has(profileName)) {
+        throw new Error(`未知 profile: ${profileName}`);
+    }
+    if (profileName.includes('/') || profileName.includes('\\') || profileName.includes('..')) {
+        throw new Error(`非法 profile 名称: ${profileName}`);
+    }
+    return path.join(resolveProfilesDir(), `${profileName}.json`);
+}
+/**
+ * Load and validate a built-in bootstrap profile by name.
+ *
+ * Errors:
+ *  - Unknown / illegal name → from `resolveProfilePath`
+ *  - File missing on disk   → "Profile 文件未找到" (does NOT include full path
+ *                              in the message body to mitigate T-53-04 info leak;
+ *                              the path is appended only in the trailing detail)
+ *  - JSON parse failure     → re-thrown with profile name context
+ *  - Schema validation fail → flattened ZodError → "Profile 验证失败 [name]: ..."
+ *
+ * Pure: no `process.exit`; callers handle exit codes at CLI entry.
+ */
+export function loadProfile(profileName) {
+    const filePath = resolveProfilePath(profileName);
+    let text;
+    try {
+        text = readFileSync(filePath, 'utf8');
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === 'ENOENT') {
+            throw new Error(`Profile 文件未找到 [${profileName}]: ${filePath}`);
+        }
+        throw new Error(`无法读取 profile [${profileName}]: ${error.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`Profile JSON 解析失败 [${profileName}]: ${error.message}`);
+    }
+    try {
+        return bootstrapProfileSchema.parse(parsed);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const issues = error.issues
+                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                .join('; ');
+            throw new Error(`Profile 验证失败 [${profileName}]: ${issues}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=profile-loader.js.map

package/dist/cli/init/profile-loader.js.map

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

package/dist/cli/init/profile-plan.d.ts

@@ -0,0 +1,38 @@
+import type { BootstrapProfile } from './profile-loader.js';
+import type { InitAsset } from './reconciler.js';
+interface FileWriteAction {
+    targetPath: string;
+    content: string;
+}
+/**
+ * Minimal scan shape consumed by createProfilePlan.
+ *
+ * Defined locally (not imported from reconciler.ts) to avoid a circular
+ * type import; reconciler.ts's full InitScan structurally satisfies this.
+ */
+export interface ProfilePlanScan {
+    hasCanonicalConfig: boolean;
+    paths: {
+        canonicalConfigPath: string;
+    };
+}
+export interface ProfilePlan {
+    assets: InitAsset[];
+    writes: FileWriteAction[];
+    /** Serialized merged config for preview rendering. */
+    mergedConfigText?: string;
+    /** Profile name for display, when one was selected. */
+    profileName?: string;
+}
+/**
+ * Build a ProfilePlan describing the bootstrap profile decision.
+ *
+ * - profile === null              → skipped (no marker detected, or detection bypassed)
+ * - scan.hasCanonicalConfig       → already-synced (D-16: respect existing config)
+ * - mode === 'preview'            → skipped with merged-config preview text
+ * - mode === 'apply'              → installed; queues canonical config write
+ */
+export declare function createProfilePlan(_rootDir: string, profile: BootstrapProfile | null, scan: ProfilePlanScan, mode: 'preview' | 'apply', profileName?: string): ProfilePlan;
+export declare function applyProfilePlan(plan: ProfilePlan): Promise<void>;
+export {};
+//# sourceMappingURL=profile-plan.d.ts.map

package/dist/cli/init/profile-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-plan.d.ts","sourceRoot":"","sources":["../../../src/cli/init/profile-plan.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,EAAE;QACL,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA0DD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,SAAS,GAAG,OAAO,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,WAAW,CAqEb;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvE"}