@nockdev/awf 6.2.0

package/dist/utils/copy-helpers.d.ts

@@ -0,0 +1,60 @@
+import type { CopyResult, IDEInstallSpec } from "../types/ide-install.js";
+/**
+ * Transform Markdown to Cursor .mdc format
+ * CRITICAL: Cursor uses comma-separated globs, NOT array format
+ * Reference: "globs field is comma-separated, NOT YAML array"
+ */
+export declare function transformMdToMdc(content: string, ruleName: string): string;
+/**
+ * Transform Markdown to Gemini TOML format
+ * Uses triple-quotes for multi-line content (no escaping needed)
+ */
+export declare function transformMdToToml(name: string, content: string): string;
+/**
+ * Transform Markdown to YAML frontmatter format (Windsurf)
+ * Parses title from H1 heading and description from first paragraph
+ */
+export declare function transformMdToYamlFrontmatter(name: string, content: string, options?: {
+    maxTokens?: number;
+}): string;
+/**
+ * Copy directory recursively using Node.js native cpSync
+ * 3-5x faster than manual recursive copy
+ */
+export declare function copyDir(src: string, dest: string, filter?: (path: string) => boolean): void;
+/**
+ * Copy skills from .agent/skills/ to IDE skills directory
+ */
+export declare function copySkills(spec: IDEInstallSpec["skills"], rootDir: string, sourceDir: string): CopyResult;
+/**
+ * Copy workflows from .agent/workflows/ to IDE commands directory
+ */
+export declare function copyWorkflows(spec: IDEInstallSpec["workflows"], rootDir: string, sourceDir: string): CopyResult;
+/**
+ * Copy rules from .agent/rules/ to IDE rules directory
+ * P0 FIX: Now includes constitutional/, SACRED_RULES.xml, data/
+ */
+export declare function copyRules(spec: IDEInstallSpec["rules"], rootDir: string, sourceDir: string): CopyResult;
+/**
+ * Copy personas from .agent/personas/ to IDE personas directory
+ */
+export declare function copyPersonas(spec: IDEInstallSpec["personas"], rootDir: string, sourceDir: string): CopyResult;
+/**
+ * Copy templates from .agent/templates/ to IDE templates directory
+ */
+export declare function copyTemplates(spec: IDEInstallSpec["templates"], rootDir: string, sourceDir: string): CopyResult;
+/**
+ * Copy root config file (e.g., .cursorrules, CLAUDE.md)
+ */
+export declare function copyRootConfig(spec: IDEInstallSpec["rootConfig"], rootDir: string, configsDir: string): boolean;
+/**
+ * Copy essential core engine files from .agent/core/ to IDE core directory
+ * These files define persona routing, context loading, and skill selection
+ */
+export declare function copyCore(spec: IDEInstallSpec["core"], rootDir: string, sourceDir: string): CopyResult;
+/**
+ * Initialize empty memory structure for runtime persistence
+ * Creates placeholder files for session notes, decisions, state
+ */
+export declare function initMemory(spec: IDEInstallSpec["memory"], rootDir: string): CopyResult;
+//# sourceMappingURL=copy-helpers.d.ts.map

package/dist/utils/copy-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/copy-helpers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAiD1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAevE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,MAAM,CA6BR;AAMD;;;GAGG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACjC,IAAI,CAaN;AAMD;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,CAmFZ;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,CAuEZ;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,CAwHZ;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,CA0CZ;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,CAsCZ;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAoBT;AAwBD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,CAuCZ;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC9B,OAAO,EAAE,MAAM,GACd,UAAU,CAqDZ"}

package/dist/utils/copy-helpers.js

@@ -0,0 +1,617 @@
+// packages/plugin-awf/src/utils/copy-helpers.ts
+// AWF Copy Helpers - Functions for copying and transforming agent components
+// Version: 6.2.1 (i18n workflow descriptions)
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, extname, join } from "node:path";
+import YAML from "yaml";
+import { getGlobForRule, isAlwaysApply } from "../constants/cursor-globs.js";
+const AGENT_DIR = ".agent";
+// ============================================================================
+// I18N HELPERS
+// ============================================================================
+/**
+ * Look up localized workflow description from .agent/i18n/{lang}.yaml
+ * Returns null if file missing, key missing, or any error
+ */
+function getI18nDescription(lang, cmdName, sourceDir) {
+    try {
+        const i18nPath = join(sourceDir, AGENT_DIR, "i18n", `${lang}.yaml`);
+        if (!existsSync(i18nPath))
+            return null;
+        const content = readFileSync(i18nPath, "utf-8");
+        const i18n = YAML.parse(content);
+        // Navigate commands.{cmdName}.desc
+        const commands = i18n?.commands;
+        return commands?.[cmdName]?.desc ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Replace description in YAML frontmatter content
+ * Handles both quoted and unquoted description values
+ */
+function replaceDescription(content, newDesc) {
+    const escaped = newDesc.replace(/"/g, '\\"');
+    return content.replace(/^description:\s*"[^"]*"/m, `description: "${escaped}"`);
+}
+// ============================================================================
+// TRANSFORM FUNCTIONS
+// ============================================================================
+/**
+ * Transform Markdown to Cursor .mdc format
+ * CRITICAL: Cursor uses comma-separated globs, NOT array format
+ * Reference: "globs field is comma-separated, NOT YAML array"
+ */
+export function transformMdToMdc(content, ruleName) {
+    const globs = getGlobForRule(ruleName);
+    const alwaysApply = isAlwaysApply(ruleName);
+    // Extract description from first H1 or first paragraph
+    const descMatch = content.match(/^#\s+(.+)$/m);
+    const description = descMatch
+        ? descMatch[1].trim().substring(0, 80)
+        : `AWF Rule: ${ruleName}`;
+    return `---
+description: ${description}
+globs: ${globs}
+alwaysApply: ${alwaysApply}
+---
+
+${content}`;
+}
+/**
+ * Transform Markdown to Gemini TOML format
+ * Uses triple-quotes for multi-line content (no escaping needed)
+ */
+export function transformMdToToml(name, content) {
+    // Extract first paragraph as description
+    const lines = content.trim().split("\n");
+    const firstParagraph = lines.find((l) => l.trim() && !l.startsWith("#"));
+    const description = firstParagraph?.trim().substring(0, 100) || `AWF ${name} command`;
+    return `# AWF Command: ${name}
+# Generated by AWF install
+
+[command]
+description = "${description.replace(/"/g, '\\"')}"
+
+prompt = """
+${content}
+"""`;
+}
+/**
+ * Transform Markdown to YAML frontmatter format (Windsurf)
+ * Parses title from H1 heading and description from first paragraph
+ */
+export function transformMdToYamlFrontmatter(name, content, options) {
+    // Already has frontmatter? Return as-is
+    if (content.startsWith("---"))
+        return content;
+    // Extract title from H1 or create from filename
+    const h1Match = content.match(/^#\s+(.+)$/m);
+    const title = h1Match
+        ? h1Match[1].trim()
+        : name
+            .split("-")
+            .map((w) => w[0].toUpperCase() + w.slice(1))
+            .join(" ");
+    // Extract description from first paragraph
+    const lines = content.split("\n");
+    const firstParagraph = lines.find((l) => l.trim() && !l.startsWith("#") && !l.startsWith("---") && !l.startsWith(">"));
+    const description = firstParagraph?.trim().substring(0, 200) || `AWF ${title} workflow`;
+    const maxTokens = options?.maxTokens || 12000;
+    return `---
+title: "${title}"
+description: "${description.replace(/"/g, '\\"')}"
+max_tokens: ${maxTokens}
+---
+
+${content}`;
+}
+// ============================================================================
+// COPY DIRECTORY HELPER (using native fs.cpSync for performance)
+// ============================================================================
+/**
+ * Copy directory recursively using Node.js native cpSync
+ * 3-5x faster than manual recursive copy
+ */
+export function copyDir(src, dest, filter) {
+    if (!existsSync(src)) {
+        throw new Error(`Source not found: ${src}`);
+    }
+    mkdirSync(dest, { recursive: true });
+    cpSync(src, dest, {
+        recursive: true,
+        filter: filter || (() => true),
+        errorOnExist: false,
+        force: true,
+    });
+}
+// ============================================================================
+// COPY SKILLS
+// ============================================================================
+/**
+ * Copy skills from .agent/skills/ to IDE skills directory
+ */
+export function copySkills(spec, rootDir, sourceDir) {
+    if (!spec.enabled) {
+        return { success: true, count: 0, error: null, skipped: [] };
+    }
+    try {
+        const srcPath = join(sourceDir, AGENT_DIR, "skills");
+        const destPath = join(rootDir, spec.target);
+        if (!existsSync(srcPath)) {
+            return { success: false, count: 0, error: `Source not found: ${srcPath}`, skipped: [] };
+        }
+        mkdirSync(destPath, { recursive: true });
+        let count = 0;
+        const skipped = [];
+        const categories = readdirSync(srcPath, { withFileTypes: true });
+        for (const cat of categories) {
+            // Skip index files and non-directories
+            if (!cat.isDirectory() || cat.name.startsWith("_"))
+                continue;
+            const catPath = join(srcPath, cat.name);
+            const destCatPath = join(destPath, cat.name);
+            if (spec.copySubdirs) {
+                // Copy whole category folder
+                copyDir(catPath, destCatPath);
+                count++;
+            }
+            else {
+                // Copy SKILL.md files + optional folders
+                const skills = readdirSync(catPath, { withFileTypes: true });
+                for (const skill of skills) {
+                    if (!skill.isDirectory())
+                        continue;
+                    const skillPath = join(catPath, skill.name);
+                    const destSkillPath = join(destCatPath, skill.name);
+                    const skillMdPath = join(skillPath, "SKILL.md");
+                    // Skip if no SKILL.md
+                    if (!existsSync(skillMdPath)) {
+                        skipped.push(`${cat.name}/${skill.name}`);
+                        continue;
+                    }
+                    mkdirSync(destSkillPath, { recursive: true });
+                    // Copy SKILL.md
+                    cpSync(skillMdPath, join(destSkillPath, "SKILL.md"));
+                    // Copy META.yaml if exists
+                    const metaPath = join(skillPath, "META.yaml");
+                    if (existsSync(metaPath)) {
+                        cpSync(metaPath, join(destSkillPath, "META.yaml"));
+                    }
+                    // Copy optional folders if enabled
+                    if (spec.copyOptionalFolders) {
+                        const optionalFolders = ["scripts", "references", "assets", "data"];
+                        for (const folder of optionalFolders) {
+                            const folderPath = join(skillPath, folder);
+                            if (existsSync(folderPath)) {
+                                copyDir(folderPath, join(destSkillPath, folder));
+                            }
+                        }
+                    }
+                    count++;
+                }
+            }
+        }
+        return { success: true, count, error: null, skipped };
+    }
+    catch (error) {
+        return {
+            success: false,
+            count: 0,
+            error: error instanceof Error ? error.message : String(error),
+            skipped: [],
+        };
+    }
+}
+// ============================================================================
+// COPY WORKFLOWS
+// ============================================================================
+/**
+ * Copy workflows from .agent/workflows/ to IDE commands directory
+ */
+export function copyWorkflows(spec, rootDir, sourceDir) {
+    if (!spec.enabled) {
+        return { success: true, count: 0, error: null, skipped: [] };
+    }
+    try {
+        const srcPath = join(sourceDir, AGENT_DIR, "workflows");
+        const destPath = join(rootDir, spec.target);
+        if (!existsSync(srcPath)) {
+            return { success: false, count: 0, error: `Source not found: ${srcPath}`, skipped: [] };
+        }
+        mkdirSync(destPath, { recursive: true });
+        let count = 0;
+        const skipped = [];
+        const files = readdirSync(srcPath, { withFileTypes: true });
+        for (const file of files) {
+            if (file.isDirectory() || !file.name.endsWith(".md")) {
+                skipped.push(file.name);
+                continue;
+            }
+            const content = readFileSync(join(srcPath, file.name), "utf-8");
+            const name = basename(file.name, ".md");
+            let output;
+            let ext;
+            if (spec.transform) {
+                switch (spec.format) {
+                    case "toml":
+                        output = transformMdToToml(name, content);
+                        ext = ".toml";
+                        break;
+                    case "yaml-frontmatter":
+                        output = transformMdToYamlFrontmatter(name, content);
+                        ext = ".md";
+                        break;
+                    default:
+                        output = content;
+                        ext = ".md";
+                }
+            }
+            else {
+                output = content;
+                ext = ".md";
+            }
+            // i18n: Replace description with localized version if language is set
+            if (spec.language) {
+                const i18nDesc = getI18nDescription(spec.language, name, sourceDir);
+                if (i18nDesc) {
+                    output = replaceDescription(output, i18nDesc);
+                }
+            }
+            writeFileSync(join(destPath, name + ext), output, "utf-8");
+            count++;
+        }
+        return { success: true, count, error: null, skipped };
+    }
+    catch (error) {
+        return {
+            success: false,
+            count: 0,
+            error: error instanceof Error ? error.message : String(error),
+            skipped: [],
+        };
+    }
+}
+// ============================================================================
+// COPY RULES
+// ============================================================================
+/**
+ * Copy rules from .agent/rules/ to IDE rules directory
+ * P0 FIX: Now includes constitutional/, SACRED_RULES.xml, data/
+ */
+export function copyRules(spec, rootDir, sourceDir) {
+    if (!spec.enabled) {
+        return { success: true, count: 0, error: null, skipped: [] };
+    }
+    try {
+        const srcPath = join(sourceDir, AGENT_DIR, "rules");
+        const destPath = join(rootDir, spec.target);
+        if (!existsSync(srcPath)) {
+            return { success: false, count: 0, error: `Source not found: ${srcPath}`, skipped: [] };
+        }
+        mkdirSync(destPath, { recursive: true });
+        let count = 0;
+        const skipped = [];
+        // P0 FIX: Copy SACRED_RULES.xml (critical for Vietnamese, MCP preference)
+        const sacredRulesPath = join(srcPath, "SACRED_RULES.xml");
+        if (existsSync(sacredRulesPath)) {
+            cpSync(sacredRulesPath, join(destPath, "SACRED_RULES.xml"));
+            count++;
+        }
+        else {
+            skipped.push("SACRED_RULES.xml");
+        }
+        // P0 FIX: Copy constitutional/ directory (tier-0,1,2 rules)
+        const constitutionalPath = join(srcPath, "constitutional");
+        if (existsSync(constitutionalPath)) {
+            const constitutionalDest = join(destPath, "constitutional");
+            mkdirSync(constitutionalDest, { recursive: true });
+            copyDir(constitutionalPath, constitutionalDest);
+            // Count files in constitutional
+            const constFiles = readdirSync(constitutionalPath, { withFileTypes: true });
+            count += constFiles.filter(f => !f.isDirectory()).length;
+        }
+        // P0 FIX: Copy data/ directory (build-systems.yaml, etc.)
+        const dataPath = join(srcPath, "data");
+        if (existsSync(dataPath)) {
+            const dataDest = join(destPath, "data");
+            mkdirSync(dataDest, { recursive: true });
+            copyDir(dataPath, dataDest);
+            const dataFiles = readdirSync(dataPath, { withFileTypes: true });
+            count += dataFiles.filter(f => !f.isDirectory()).length;
+        }
+        // Copy modules
+        if (spec.copyModules) {
+            const modulesPath = join(srcPath, "modules");
+            if (existsSync(modulesPath)) {
+                const modulesDest = join(destPath, "modules");
+                mkdirSync(modulesDest, { recursive: true });
+                const modules = readdirSync(modulesPath, { withFileTypes: true });
+                for (const mod of modules) {
+                    if (mod.isDirectory())
+                        continue;
+                    const modExt = extname(mod.name);
+                    if (modExt !== ".yaml" && modExt !== ".md")
+                        continue;
+                    const content = readFileSync(join(modulesPath, mod.name), "utf-8");
+                    const name = basename(mod.name, modExt);
+                    let output;
+                    if (spec.ext === ".mdc") {
+                        output = transformMdToMdc(content, name);
+                    }
+                    else {
+                        output = content;
+                    }
+                    writeFileSync(join(modulesDest, name + spec.ext), output, "utf-8");
+                    count++;
+                }
+            }
+        }
+        // Copy standalone rules
+        if (spec.copyStandalone) {
+            const standalones = [
+                "project-detection.md",
+                "shell-commands.md",
+                "prompt-injection-guard.md",
+                "validation-framework.md",
+                "duplication-prevention.md",
+                "incremental-changes.md",
+                "README.md",
+            ];
+            for (const file of standalones) {
+                const filePath = join(srcPath, file);
+                if (!existsSync(filePath)) {
+                    skipped.push(file);
+                    continue;
+                }
+                const content = readFileSync(filePath, "utf-8");
+                const name = basename(file, ".md");
+                let output;
+                if (spec.ext === ".mdc") {
+                    output = transformMdToMdc(content, name);
+                }
+                else {
+                    output = content;
+                }
+                writeFileSync(join(destPath, name + spec.ext), output, "utf-8");
+                count++;
+            }
+        }
+        return { success: true, count, error: null, skipped };
+    }
+    catch (error) {
+        return {
+            success: false,
+            count: 0,
+            error: error instanceof Error ? error.message : String(error),
+            skipped: [],
+        };
+    }
+}
+// ============================================================================
+// COPY PERSONAS
+// ============================================================================
+/**
+ * Copy personas from .agent/personas/ to IDE personas directory
+ */
+export function copyPersonas(spec, rootDir, sourceDir) {
+    if (!spec.enabled) {
+        return { success: true, count: 0, error: null, skipped: [] };
+    }
+    try {
+        const srcPath = join(sourceDir, AGENT_DIR, "personas");
+        const destPath = join(rootDir, spec.target);
+        if (!existsSync(srcPath)) {
+            return { success: false, count: 0, error: `Source not found: ${srcPath}`, skipped: [] };
+        }
+        mkdirSync(destPath, { recursive: true });
+        let count = 0;
+        const skipped = [];
+        const files = readdirSync(srcPath, { withFileTypes: true });
+        for (const file of files) {
+            if (file.isDirectory())
+                continue;
+            if (!file.name.endsWith(".md") && !file.name.endsWith(".yaml"))
+                continue;
+            // Skip schema file
+            if (file.name.includes(".schema.")) {
+                skipped.push(file.name);
+                continue;
+            }
+            cpSync(join(srcPath, file.name), join(destPath, file.name));
+            count++;
+        }
+        return { success: true, count, error: null, skipped };
+    }
+    catch (error) {
+        return {
+            success: false,
+            count: 0,
+            error: error instanceof Error ? error.message : String(error),
+            skipped: [],
+        };
+    }
+}
+// ============================================================================
+// COPY TEMPLATES
+// ============================================================================
+/**
+ * Copy templates from .agent/templates/ to IDE templates directory
+ */
+export function copyTemplates(spec, rootDir, sourceDir) {
+    if (!spec.enabled) {
+        return { success: true, count: 0, error: null, skipped: [] };
+    }
+    try {
+        const srcPath = join(sourceDir, AGENT_DIR, "templates");
+        const destPath = join(rootDir, spec.target);
+        if (!existsSync(srcPath)) {
+            return { success: false, count: 0, error: `Source not found: ${srcPath}`, skipped: [] };
+        }
+        copyDir(srcPath, destPath);
+        // Count files
+        const countFiles = (dir) => {
+            let count = 0;
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    count += countFiles(join(dir, entry.name));
+                }
+                else {
+                    count++;
+                }
+            }
+            return count;
+        };
+        return { success: true, count: countFiles(destPath), error: null, skipped: [] };
+    }
+    catch (error) {
+        return {
+            success: false,
+            count: 0,
+            error: error instanceof Error ? error.message : String(error),
+            skipped: [],
+        };
+    }
+}
+// ============================================================================
+// COPY ROOT CONFIG
+// ============================================================================
+/**
+ * Copy root config file (e.g., .cursorrules, CLAUDE.md)
+ */
+export function copyRootConfig(spec, rootDir, configsDir) {
+    if (!spec.source || !spec.target)
+        return false;
+    try {
+        const srcPath = join(configsDir, spec.source);
+        const destPath = join(rootDir, spec.target);
+        if (!existsSync(srcPath)) {
+            // Try fallback to plugin-awf configs directory
+            return false;
+        }
+        // Ensure parent directory exists
+        mkdirSync(dirname(destPath), { recursive: true });
+        cpSync(srcPath, destPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// COPY CORE ENGINE FILES (P0 FIX - Feb 2026)
+// ============================================================================
+/**
+ * Core files essential for IDE agent behavior:
+ * - ROUTER.yaml: Persona routing logic
+ * - CONTEXT_LOADER.yaml: JIT context loading
+ * - MEMORY_ENGINE.yaml: Memory management
+ * - TOKEN_BUDGETS.yaml: Token allocation
+ * - SKILLS_FLOW.yaml: Skill loading mechanism
+ */
+const ESSENTIAL_CORE_FILES = [
+    "ROUTER.yaml",
+    "CONTEXT_LOADER.yaml",
+    "MEMORY_ENGINE.yaml",
+    "TOKEN_BUDGETS.yaml",
+    "SKILLS_FLOW.yaml",
+    "MEMORY_PATHS.yaml",
+    "README.md",
+];
+/**
+ * Copy essential core engine files from .agent/core/ to IDE core directory
+ * These files define persona routing, context loading, and skill selection
+ */
+export function copyCore(spec, rootDir, sourceDir) {
+    if (!spec.enabled) {
+        return { success: true, count: 0, error: null, skipped: [] };
+    }
+    try {
+        const srcPath = join(sourceDir, AGENT_DIR, "core");
+        const destPath = join(rootDir, spec.target);
+        if (!existsSync(srcPath)) {
+            return { success: false, count: 0, error: `Source not found: ${srcPath}`, skipped: [] };
+        }
+        mkdirSync(destPath, { recursive: true });
+        let count = 0;
+        const skipped = [];
+        const filesToCopy = spec.files.length > 0 ? spec.files : ESSENTIAL_CORE_FILES;
+        for (const file of filesToCopy) {
+            const filePath = join(srcPath, file);
+            if (!existsSync(filePath)) {
+                skipped.push(file);
+                continue;
+            }
+            cpSync(filePath, join(destPath, file));
+            count++;
+        }
+        return { success: true, count, error: null, skipped };
+    }
+    catch (error) {
+        return {
+            success: false,
+            count: 0,
+            error: error instanceof Error ? error.message : String(error),
+            skipped: [],
+        };
+    }
+}
+// ============================================================================
+// INITIALIZE MEMORY STRUCTURE (P1 FIX - Feb 2026)
+// ============================================================================
+/**
+ * Initialize empty memory structure for runtime persistence
+ * Creates placeholder files for session notes, decisions, state
+ */
+export function initMemory(spec, rootDir) {
+    if (!spec.enabled) {
+        return { success: true, count: 0, error: null, skipped: [] };
+    }
+    try {
+        const destPath = join(rootDir, spec.target);
+        mkdirSync(destPath, { recursive: true });
+        let count = 0;
+        // Create or merge state.json — preserve existing preferences (e.g., from init wizard)
+        const stateFile = join(destPath, "state.json");
+        let existingPrefs = {};
+        if (existsSync(stateFile)) {
+            try {
+                const existing = JSON.parse(readFileSync(stateFile, "utf-8"));
+                existingPrefs = existing?.preferences ?? {};
+            }
+            catch {
+                // Ignore parse errors, use defaults
+            }
+        }
+        const stateJson = {
+            version: "1.0.0",
+            last_updated: new Date().toISOString(),
+            project: { name: "", stack: [] },
+            context: { current_phase: "", pending_tasks: [] },
+            preferences: { language: "vi", ...existingPrefs },
+        };
+        writeFileSync(stateFile, JSON.stringify(stateJson, null, 2), "utf-8");
+        count++;
+        // Create placeholder markdown files
+        writeFileSync(join(destPath, "session.md"), "# Session Notes\n\n_Created by AWF_\n", "utf-8");
+        count++;
+        writeFileSync(join(destPath, "decisions.md"), "# Decisions\n\n_Log of key decisions made during project work_\n", "utf-8");
+        count++;
+        // Create audit_summary.json placeholder
+        writeFileSync(join(destPath, "audit_summary.json"), JSON.stringify({ audits: [] }, null, 2), "utf-8");
+        count++;
+        return { success: true, count, error: null, skipped: [] };
+    }
+    catch (error) {
+        return {
+            success: false,
+            count: 0,
+            error: error instanceof Error ? error.message : String(error),
+            skipped: [],
+        };
+    }
+}
+//# sourceMappingURL=copy-helpers.js.map