@kynetic-ai/spec 0.1.2 → 0.4.0

package/dist/cli/commands/agents.js

@@ -0,0 +1,377 @@
+/**
+ * Agent instruction generation commands.
+ *
+ * AC: @agent-instruction-gen ac-1 - kspec agents generate creates kspec-agents.md in project root
+ * AC: @agent-instruction-gen ac-2 - output includes Finding Information table with row per skill
+ * AC: @agent-instruction-gen ac-3 - output includes conventions section listing rules by domain
+ * AC: @agent-instruction-gen ac-4 - output contains freshness comment with kspec version and timestamp
+ * AC: @agent-instruction-gen ac-5 - kspec agents status reports stale when not regenerated after meta changes
+ *
+ * AC: @agents-cli ac-1 - kspec agents generate writes kspec-agents.md to project root
+ * AC: @agents-cli ac-2 - kspec agents generate --dry-run prints content without writing
+ * AC: @agents-cli ac-3 - kspec agents status reports up to date when current
+ * AC: @agents-cli ac-4 - kspec agents status reports stale when meta changed
+ *
+ * AC: @agent-templates ac-1 - template sections included in output in defined order
+ * AC: @agent-templates ac-2 - each template section appears in generated output
+ * AC: @agent-templates ac-3 - error if template directory missing or empty
+ */
+import * as crypto from "node:crypto";
+import * as fs from "node:fs/promises";
+import { createRequire } from "node:module";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import chalk from "chalk";
+import { generateConventionsSummary, generateSkillsTable, generateWorkflowsSummary, initContext, loadMetaContext, } from "../../parser/index.js";
+import { errors } from "../../strings/errors.js";
+import { EXIT_CODES } from "../exit-codes.js";
+import { error, output, success } from "../output.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Read version from package.json at runtime
+const require = createRequire(import.meta.url);
+const { version } = require("../../../package.json");
+/**
+ * File name for generated agent instructions
+ */
+const GENERATED_FILE_NAME = "kspec-agents.md";
+/**
+ * Hash file name for tracking freshness
+ */
+const HASH_FILE_NAME = ".kspec-agents-hash";
+/**
+ * Templates directory name relative to package root
+ */
+const TEMPLATES_DIR = "templates/agents-sections";
+/**
+ * Compute SHA256 hash of content
+ */
+function computeHash(content) {
+    return crypto.createHash("sha256").update(content, "utf-8").digest("hex");
+}
+/**
+ * Load template sections from the templates directory.
+ * AC: @agent-templates ac-1 - all template sections included in defined order
+ * AC: @agent-templates ac-3 - error if directory missing or empty
+ */
+export async function loadTemplateSections(packageRoot) {
+    const templatesPath = path.join(packageRoot, TEMPLATES_DIR);
+    // Check if templates directory exists
+    try {
+        await fs.access(templatesPath);
+    }
+    catch {
+        throw new Error(`Templates directory not found at: ${templatesPath}. ` +
+            `Expected templates/agents-sections/ directory with section markdown files.`);
+    }
+    // Read directory contents
+    const entries = await fs.readdir(templatesPath, { withFileTypes: true });
+    const mdFiles = entries
+        .filter((e) => e.isFile() && e.name.endsWith(".md"))
+        .map((e) => e.name)
+        .sort(); // Sort to ensure consistent ordering by filename prefix
+    if (mdFiles.length === 0) {
+        throw new Error(`Templates directory is empty: ${templatesPath}. ` +
+            `Expected markdown files for agent instruction sections.`);
+    }
+    // Load each template in order
+    const sections = [];
+    for (const filename of mdFiles) {
+        const filePath = path.join(templatesPath, filename);
+        const content = await fs.readFile(filePath, "utf-8");
+        sections.push(content.trim());
+    }
+    return sections;
+}
+/**
+ * Get the package root directory (where templates/ is located)
+ */
+export function getPackageRoot() {
+    // Navigate from dist/cli/commands/ to package root
+    return path.resolve(__dirname, "..", "..", "..");
+}
+/**
+ * Generate a hash of the meta content that affects the generated file.
+ * This is used to detect if the generated file is stale.
+ */
+export function computeMetaHash(skills, conventions, workflows, templateSections) {
+    // Create a stable representation of the meta content
+    // AC: @cross-platform-and-version-robustness ac-4 - includes templates for staleness detection
+    const data = {
+        skills: skills.map((s) => ({
+            id: s.id,
+            name: s.name,
+            description: s.description,
+        })),
+        conventions: conventions.map((c) => ({
+            domain: c.domain,
+            rules: c.rules,
+            examples: (c.examples ?? []).map((e) => ({ good: e.good, bad: e.bad })),
+        })),
+        workflows: workflows.map((w) => ({
+            id: w.id,
+            trigger: w.trigger,
+            description: w.description,
+        })),
+    };
+    if (templateSections && templateSections.length > 0) {
+        data.templates = templateSections;
+    }
+    return computeHash(JSON.stringify(data));
+}
+/**
+ * Generate the freshness comment.
+ * AC: @agent-instruction-gen ac-4 - freshness comment with kspec version and timestamp
+ */
+function generateFreshnessComment(timestamp) {
+    return `<!-- Generated by kspec v${version} at ${timestamp} -->\n<!-- Do not edit manually - regenerate with: kspec agents generate -->\n\n`;
+}
+/**
+ * Generate the full kspec-agents.md content
+ * AC: @agent-templates ac-1 - template sections included in output in defined order
+ * AC: @agent-templates ac-2 - each template section appears in generated output
+ */
+export async function generateAgentsContent(skills, conventions, workflows, timestamp, templateSections) {
+    const sections = [];
+    // AC: @agent-instruction-gen ac-4 - freshness comment
+    sections.push(generateFreshnessComment(timestamp));
+    // Header
+    sections.push("# kspec Agent Instructions\n");
+    sections.push("This file is auto-generated from kspec meta. Include it in your AGENTS.md or similar agent instruction file.\n\n");
+    // AC: @agent-instruction-gen ac-2 - Skills table
+    // AC: @agent-instruction-gen ac-3 - Conventions section
+    // Ensure blank line between each data section for valid markdown
+    const dataSections = [
+        generateSkillsTable(skills),
+        generateConventionsSummary(conventions),
+        generateWorkflowsSummary(workflows),
+    ].filter(Boolean);
+    for (const section of dataSections) {
+        // Ensure each section is preceded by a blank line
+        if (!sections[sections.length - 1]?.endsWith("\n\n")) {
+            sections.push("\n");
+        }
+        sections.push(section);
+    }
+    // AC: @agent-templates ac-1, ac-2 - Include template sections in order
+    if (templateSections.length > 0) {
+        sections.push("\n");
+        for (const section of templateSections) {
+            sections.push(section);
+            sections.push("\n\n");
+        }
+    }
+    return sections.join("");
+}
+/**
+ * Check the status of the generated agent file.
+ * AC: @agent-instruction-gen ac-5 - reports stale when meta has changed
+ */
+async function checkAgentStatus(projectRoot, metaHash) {
+    const filePath = path.join(projectRoot, GENERATED_FILE_NAME);
+    const hashPath = path.join(projectRoot, ".kspec", HASH_FILE_NAME);
+    // Check if file exists
+    try {
+        await fs.access(filePath);
+    }
+    catch {
+        return {
+            exists: false,
+            path: filePath,
+            status: "missing",
+            metaHash,
+        };
+    }
+    // Check stored hash
+    let storedHash;
+    let generatedAt;
+    try {
+        const hashContent = await fs.readFile(hashPath, "utf-8");
+        const hashData = JSON.parse(hashContent);
+        storedHash = hashData.metaHash;
+        generatedAt = hashData.generatedAt;
+    }
+    catch {
+        // No hash file, treat as stale
+        return {
+            exists: true,
+            path: filePath,
+            status: "stale",
+            metaHash,
+        };
+    }
+    // Compare hashes
+    const isCurrent = storedHash === metaHash;
+    return {
+        exists: true,
+        path: filePath,
+        status: isCurrent ? "current" : "stale",
+        metaHash,
+        storedHash,
+        generatedAt,
+    };
+}
+/**
+ * Register agent instruction generation commands
+ */
+export function registerAgentsCommands(program) {
+    const agents = program
+        .command("agents")
+        .description("Agent instruction generation commands");
+    // AC: @agent-instruction-gen ac-1 - kspec agents generate
+    // AC: @agent-templates ac-3 - error if template directory missing
+    // AC: @trait-dry-run ac-1 through ac-6 - dry-run support
+    agents
+        .command("generate")
+        .description("Generate kspec-agents.md from meta (skills, conventions, workflows)")
+        .option("--dry-run", "Show what would be generated without writing files")
+        .action(async (options) => {
+        try {
+            const ctx = await initContext();
+            if (!ctx.manifestPath) {
+                error(errors.project.noKspecProject);
+                process.exit(EXIT_CODES.ERROR);
+            }
+            // AC: @agent-templates ac-3 - error if templates missing
+            const packageRoot = getPackageRoot();
+            let templateSections;
+            try {
+                templateSections = await loadTemplateSections(packageRoot);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : "Unknown error loading templates";
+                error(message, {
+                    suggestion: `Verify that ${TEMPLATES_DIR}/ exists with markdown files.`,
+                });
+                process.exit(EXIT_CODES.ERROR);
+            }
+            const metaCtx = await loadMetaContext(ctx);
+            const dryRun = options.dryRun || false;
+            const timestamp = new Date().toISOString();
+            // Generate content - now async due to template loading
+            const content = await generateAgentsContent(metaCtx.skills, metaCtx.conventions, metaCtx.workflows, timestamp, templateSections);
+            // Compute meta hash for freshness tracking (includes templates)
+            const metaHash = computeMetaHash(metaCtx.skills, metaCtx.conventions, metaCtx.workflows, templateSections);
+            const outputPath = path.join(ctx.rootDir, GENERATED_FILE_NAME);
+            const hashPath = path.join(ctx.rootDir, ".kspec", HASH_FILE_NAME);
+            // AC: @agent-instruction-gen ac-6 - skip regeneration when content unchanged
+            if (!dryRun) {
+                const status = await checkAgentStatus(ctx.rootDir, metaHash);
+                if (status.status === "current") {
+                    output({
+                        path: outputPath,
+                        status: "current",
+                        skipped: true,
+                    }, () => {
+                        success(`${GENERATED_FILE_NAME} is already up to date`);
+                    });
+                    return;
+                }
+            }
+            // AC: @trait-dry-run ac-3 - clear indication this is a preview
+            if (dryRun) {
+                output({
+                    dry_run: true,
+                    path: outputPath,
+                    skills: metaCtx.skills.length,
+                    conventions: metaCtx.conventions.length,
+                    workflows: metaCtx.workflows.length,
+                    templates: templateSections.length,
+                    content,
+                }, () => {
+                    console.log(chalk.yellow("DRY RUN - No changes made"));
+                    console.log();
+                    console.log(chalk.gray(`Would write to: ${outputPath}`));
+                    console.log();
+                    console.log(chalk.gray("--- Generated content ---"));
+                    console.log(content);
+                    console.log(chalk.gray("--- End content ---"));
+                    console.log();
+                    console.log(chalk.yellow("No changes were made. Run without --dry-run to apply."));
+                });
+                return;
+            }
+            // AC: @trait-dry-run ac-2 - no files modified in dry run mode
+            // Write the generated file
+            await fs.writeFile(outputPath, content, "utf-8");
+            // Write the hash file for freshness tracking
+            await fs.mkdir(path.dirname(hashPath), { recursive: true });
+            await fs.writeFile(hashPath, JSON.stringify({
+                metaHash,
+                generatedAt: timestamp,
+                version,
+            }, null, 2), "utf-8");
+            output({
+                path: outputPath,
+                skills: metaCtx.skills.length,
+                conventions: metaCtx.conventions.length,
+                workflows: metaCtx.workflows.length,
+                templates: templateSections.length,
+                generatedAt: timestamp,
+            }, () => {
+                success(`Generated ${GENERATED_FILE_NAME}`, {
+                    skills: metaCtx.skills.length,
+                    conventions: metaCtx.conventions.length,
+                    workflows: metaCtx.workflows.length,
+                    templates: templateSections.length,
+                });
+                console.log(chalk.gray(`  Path: ${outputPath}`));
+            });
+        }
+        catch (err) {
+            error("Failed to generate agent instructions", err);
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+    // AC: @agent-instruction-gen ac-5 - kspec agents status
+    agents
+        .command("status")
+        .description("Check if kspec-agents.md is up to date with meta")
+        .action(async () => {
+        try {
+            const ctx = await initContext();
+            if (!ctx.manifestPath) {
+                error(errors.project.noKspecProject);
+                process.exit(EXIT_CODES.ERROR);
+            }
+            const metaCtx = await loadMetaContext(ctx);
+            // Load templates for hash computation
+            let templateSections = [];
+            try {
+                templateSections = await loadTemplateSections(getPackageRoot());
+            }
+            catch (_err) {
+                // Templates may not exist in all environments
+            }
+            // Compute current meta hash (includes templates)
+            const metaHash = computeMetaHash(metaCtx.skills, metaCtx.conventions, metaCtx.workflows, templateSections);
+            const status = await checkAgentStatus(ctx.rootDir, metaHash);
+            output(status, () => {
+                switch (status.status) {
+                    case "missing":
+                        console.log(chalk.yellow(`${GENERATED_FILE_NAME} does not exist`));
+                        console.log();
+                        console.log(chalk.gray("Run 'kspec agents generate' to create it."));
+                        break;
+                    case "stale":
+                        console.log(chalk.yellow(`${GENERATED_FILE_NAME} is stale`));
+                        console.log();
+                        console.log(chalk.gray("Meta has changed since the file was generated."));
+                        console.log(chalk.gray("Run 'kspec agents generate' to regenerate."));
+                        break;
+                    case "current":
+                        console.log(chalk.green(`${GENERATED_FILE_NAME} is up to date`));
+                        if (status.generatedAt) {
+                            console.log(chalk.gray(`  Generated: ${status.generatedAt}`));
+                        }
+                        break;
+                }
+            });
+        }
+        catch (err) {
+            error("Failed to check agent status", err);
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/cli/commands/agents.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * kspec batch — execute multiple CLI commands from a JSON payload.
+ *
+ * Supports atomic mode (default: temp copy, rollback on failure) and
+ * immediate mode (per-command commits, no rollback).
+ */
+import type { Command } from "commander";
+/**
+ * Register the `kspec batch` command group.
+ *
+ * AC: @batch-exec ac-stdin — stdin input
+ * AC: @batch-exec ac-file — file input
+ * AC: @batch-exec ac-inline — inline JSON input
+ * AC: @batch-exec ac-default-atomic — atomic mode by default
+ * AC: @batch-exec ac-no-atomic-flag — immediate mode
+ * AC: @batch-exec ac-continue-implies-immediate — --continue implies --no-atomic
+ * AC: @batch-exec ac-json-mode-field — JSON output includes mode field
+ */
+export declare function registerBatchCommand(program: Command): void;
+//# sourceMappingURL=batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/batch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkFzC;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiK3D"}

package/dist/cli/commands/batch.js

@@ -0,0 +1,214 @@
+/**
+ * kspec batch — execute multiple CLI commands from a JSON payload.
+ *
+ * Supports atomic mode (default: temp copy, rollback on failure) and
+ * immediate mode (per-command commits, no rollback).
+ */
+import chalk from "chalk";
+import { parseBatchInput, BatchParseError, executeBatch, } from "../batch-exec.js";
+import { createBatchCommandFilter } from "../command-annotations.js";
+import { extractCommandTree, flattenCommandTree } from "../introspection.js";
+import { isJsonMode, output } from "../output.js";
+import { EXIT_CODES } from "../exit-codes.js";
+/**
+ * Format a command signature for display.
+ * e.g., "inbox add <text> [--tag <tag...>]"
+ */
+function formatCommandSignature(cmd) {
+    const parts = [cmd.fullPath.slice(1).join(" ")]; // Skip root 'kspec'
+    // Add positional arguments
+    for (const arg of cmd.arguments) {
+        if (arg.required) {
+            parts.push(`<${arg.name}${arg.variadic ? "..." : ""}>`);
+        }
+        else {
+            parts.push(`[${arg.name}${arg.variadic ? "..." : ""}]`);
+        }
+    }
+    // Add options (excluding common ones like --json, --verbose)
+    const skipOptions = new Set(["json", "verbose", "help"]);
+    const significantOptions = cmd.options.filter((opt) => {
+        const match = opt.flags.match(/--([a-zA-Z0-9-]+)/);
+        return match && !skipOptions.has(match[1]);
+    });
+    if (significantOptions.length > 0) {
+        parts.push("[options]");
+    }
+    return parts.join(" ");
+}
+function buildCommandInfo(cmd) {
+    return {
+        command: cmd.fullPath.slice(1).join(" "), // Skip root 'kspec'
+        signature: formatCommandSignature(cmd),
+        description: cmd.description,
+        mutating: cmd.mutating,
+        arguments: cmd.arguments.map((arg) => ({
+            name: arg.name,
+            description: arg.description,
+            required: arg.required,
+            variadic: arg.variadic,
+        })),
+        options: cmd.options.map((opt) => ({
+            flags: opt.flags,
+            description: opt.description,
+            required: opt.mandatory,
+        })),
+    };
+}
+/**
+ * Register the `kspec batch` command group.
+ *
+ * AC: @batch-exec ac-stdin — stdin input
+ * AC: @batch-exec ac-file — file input
+ * AC: @batch-exec ac-inline — inline JSON input
+ * AC: @batch-exec ac-default-atomic — atomic mode by default
+ * AC: @batch-exec ac-no-atomic-flag — immediate mode
+ * AC: @batch-exec ac-continue-implies-immediate — --continue implies --no-atomic
+ * AC: @batch-exec ac-json-mode-field — JSON output includes mode field
+ */
+export function registerBatchCommand(program) {
+    const batchCmd = program
+        .command("batch")
+        .description("Execute multiple commands from a JSON payload")
+        .option("--file <path>", "Read commands from a JSON file")
+        .option("--commands <json>", "Inline JSON command array")
+        .option("--no-atomic", "Immediate mode: per-command commits, no rollback")
+        .option("--continue", "Continue on error (implies --no-atomic)")
+        .option("--dry-run", "Validate without executing")
+        .addHelpText("after", `
+Examples:
+  $ echo '[{"command":"inbox add","args":{"content":"test"}}]' | kspec batch
+  $ kspec batch --file commands.json
+  $ kspec batch --commands '[{"command":"inbox add","args":{"content":"test"}}]'
+  $ kspec batch --no-atomic --commands '[...]'
+  $ kspec batch --continue --commands '[...]'
+  $ kspec batch --dry-run --commands '[...]'
+  $ kspec batch commands           # list allowed commands`)
+        .action(async (options) => {
+        const json = isJsonMode();
+        // --continue implies --no-atomic
+        // AC: ac-continue-implies-immediate
+        let atomic = options.atomic;
+        if (options.continue && atomic) {
+            if (!json) {
+                console.error("Notice: --continue implies immediate mode (--no-atomic)");
+            }
+            atomic = false;
+        }
+        // Determine input source
+        let source;
+        if (options.file) {
+            source = { type: "file", path: options.file };
+        }
+        else if (options.commands) {
+            source = { type: "inline", json: options.commands };
+        }
+        else {
+            source = { type: "stdin" };
+        }
+        // Parse input
+        let commands;
+        try {
+            commands = await parseBatchInput(source);
+        }
+        catch (err) {
+            if (err instanceof BatchParseError) {
+                if (json) {
+                    console.log(JSON.stringify({
+                        success: false,
+                        error: err.message,
+                    }, null, 2));
+                }
+                else {
+                    console.error(`Error: ${err.message}`);
+                }
+                process.exit(EXIT_CODES.ERROR);
+            }
+            throw err;
+        }
+        // Execute
+        const result = await executeBatch(commands, program, {
+            atomic,
+            continueOnError: options.continue ?? false,
+            dryRun: options.dryRun ?? false,
+            json,
+        });
+        // Output
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            // Human-readable output
+            const modeLabel = result.mode === "atomic" ? "atomic" : "immediate";
+            if (result.success) {
+                console.log(`Batch complete (${modeLabel}): ${result.summary.succeeded}/${result.summary.total} succeeded`);
+            }
+            else {
+                console.error(`Batch failed (${modeLabel}): ${result.summary.succeeded}/${result.summary.total} succeeded, ${result.summary.failed} failed`);
+            }
+            // Show per-command results
+            for (const r of result.results) {
+                const label = r.id ?? `#${r.index}`;
+                if (r.success) {
+                    console.log(`  [${label}] ${r.command}: OK`);
+                }
+                else {
+                    let errorLine = `  [${label}] ${r.command}: FAILED — ${r.error}`;
+                    if (r.suggestion) {
+                        errorLine += ` Did you mean: ${r.suggestion}?`;
+                    }
+                    console.error(errorLine);
+                }
+            }
+            // Show helpful hint only for validation failures (not runtime execution failures)
+            if (result.validationFailed) {
+                console.error("");
+                console.error("Run 'kspec batch commands' for a list of available commands.");
+            }
+        }
+        if (!result.success) {
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+    // Register the `batch commands` subcommand
+    batchCmd
+        .command("commands")
+        .description("List commands allowed in batch mode")
+        .action(() => {
+        const json = isJsonMode();
+        const tree = extractCommandTree(program);
+        const allCommands = flattenCommandTree(tree);
+        const commandFilter = createBatchCommandFilter();
+        // Filter to leaf commands (no subcommands) that pass the batch filter
+        const allowedCommands = allCommands.filter((cmd) => {
+            // Must be a leaf command (no subcommands)
+            if (cmd.subcommands.length > 0)
+                return false;
+            // Must pass the batch filter (mutating only)
+            if (!commandFilter(cmd))
+                return false;
+            // Exclude batch itself
+            if (cmd.name === "batch" || cmd.fullPath.includes("batch"))
+                return false;
+            return true;
+        });
+        if (json) {
+            const commandInfos = allowedCommands.map(buildCommandInfo);
+            output({ commands: commandInfos, total: commandInfos.length });
+        }
+        else {
+            console.log(chalk.bold.cyan("Batch-Allowed Commands"));
+            console.log(chalk.gray("─".repeat(60)));
+            console.log(chalk.gray("Only mutating commands can be used in batch mode.\n"));
+            for (const cmd of allowedCommands) {
+                const signature = formatCommandSignature(cmd);
+                console.log(chalk.green(signature));
+                if (cmd.description) {
+                    console.log(chalk.gray(`  ${cmd.description}`));
+                }
+            }
+            console.log(chalk.gray(`\n${allowedCommands.length} command(s) available`));
+        }
+    });
+}
+//# sourceMappingURL=batch.js.map

package/dist/cli/commands/batch.js.map

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

package/dist/cli/commands/clone-for-testing.d.ts

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import type { Command } from "commander";
 /**
  * Register the 'clone-for-testing' command
  */

package/dist/cli/commands/clone-for-testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone-for-testing.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clone-for-testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0IpC;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6DrE"}
+{"version":3,"file":"clone-for-testing.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clone-for-testing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8IzC;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0ErE"}