@archpilotlabs/archpilot 0.2.2 → 0.2.3

package/dist/core/src/quickFix/quickFixEngine.js

@@ -0,0 +1,132 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildQuickFixPlan = buildQuickFixPlan;
+exports.applyQuickFixPlan = applyQuickFixPlan;
+const path = __importStar(require("node:path"));
+const remediation_1 = require("../remediation");
+function normalizePathForCompare(value) {
+    return value.replace(/\\/g, '/').toLowerCase();
+}
+function isPathInsideWorkspace(workspaceRoot, targetPath) {
+    const workspaceAbsolute = path.resolve(workspaceRoot);
+    const targetAbsolute = path.resolve(workspaceRoot, targetPath);
+    const workspaceNormalized = normalizePathForCompare(workspaceAbsolute);
+    const targetNormalized = normalizePathForCompare(targetAbsolute);
+    if (targetNormalized === workspaceNormalized) {
+        return true;
+    }
+    return targetNormalized.startsWith(`${workspaceNormalized}/`);
+}
+function buildQuickFixPlan(results) {
+    const fixableIssues = [];
+    const nonAutomaticIssues = [];
+    for (const result of results) {
+        if (!result.quickFix || !result.quickFix.available) {
+            continue;
+        }
+        if (result.quickFix.type !== 'create-file') {
+            nonAutomaticIssues.push({
+                ruleId: result.id,
+                reason: `${result.quickFix.type} (suggestion only)`,
+            });
+            continue;
+        }
+        const createFileActions = (result.quickFix.actions ?? []).filter((action) => action.actionType === 'create-file');
+        if (createFileActions.length === 0) {
+            nonAutomaticIssues.push({
+                ruleId: result.id,
+                reason: 'create-file metadata is missing create-file actions',
+            });
+            continue;
+        }
+        fixableIssues.push({
+            ruleId: result.id,
+            description: result.quickFix.description,
+            actions: createFileActions,
+        });
+    }
+    return {
+        fixableIssues,
+        nonAutomaticIssues,
+    };
+}
+async function applyQuickFixPlan(workspaceRoot, plan) {
+    const created = [];
+    const skippedExists = [];
+    const skippedInvalidPath = [];
+    const skippedUnsupported = [];
+    const failed = [];
+    for (const issue of plan.fixableIssues) {
+        for (const action of issue.actions) {
+            if (action.actionType !== 'create-file') {
+                skippedUnsupported.push(action.targetPath);
+                continue;
+            }
+            if (!isPathInsideWorkspace(workspaceRoot, action.targetPath)) {
+                skippedInvalidPath.push(action.targetPath);
+                continue;
+            }
+            const absoluteTargetPath = path.resolve(workspaceRoot, action.targetPath);
+            if (await (0, remediation_1.pathExists)(absoluteTargetPath)) {
+                skippedExists.push(action.targetPath);
+                continue;
+            }
+            try {
+                const createdFile = await (0, remediation_1.createFileIfMissing)(absoluteTargetPath, action.content ?? '');
+                if (createdFile) {
+                    created.push(action.targetPath);
+                }
+                else {
+                    skippedExists.push(action.targetPath);
+                }
+            }
+            catch (error) {
+                failed.push({
+                    targetPath: action.targetPath,
+                    error: error instanceof Error ? error.message : 'Unable to create file.',
+                });
+            }
+        }
+    }
+    return {
+        created,
+        skippedExists,
+        skippedInvalidPath,
+        skippedUnsupported,
+        failed,
+    };
+}
+//# sourceMappingURL=quickFixEngine.js.map

package/dist/core/src/quickFix/quickFixEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickFixEngine.js","sourceRoot":"","sources":["../../../../../core/src/quickFix/quickFixEngine.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,8CAuCC;AAED,8CAkDC;AAlID,gDAAkC;AAGlC,gDAAiE;AAqBjE,SAAS,uBAAuB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,qBAAqB,CAAC,aAAqB,EAAE,UAAkB;IACvE,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IACvE,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;IACjE,IAAI,gBAAgB,KAAK,mBAAmB,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,gBAAgB,CAAC,UAAU,CAAC,GAAG,mBAAmB,GAAG,CAAC,CAAC;AAC/D,CAAC;AAED,SAAgB,iBAAiB,CAAC,OAA+B;IAChE,MAAM,aAAa,GAAoB,EAAE,CAAC;IAC1C,MAAM,kBAAkB,GAA8C,EAAE,CAAC;IAEzE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACpD,SAAS;QACV,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC5C,kBAAkB,CAAC,IAAI,CAAC;gBACvB,MAAM,EAAE,MAAM,CAAC,EAAE;gBACjB,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,oBAAoB;aACnD,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAC/D,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,aAAa,CAC/C,CAAC;QACF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,kBAAkB,CAAC,IAAI,CAAC;gBACvB,MAAM,EAAE,MAAM,CAAC,EAAE;gBACjB,MAAM,EAAE,qDAAqD;aAC7D,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,aAAa,CAAC,IAAI,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC,EAAE;YACjB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;YACxC,OAAO,EAAE,iBAAiB;SAC1B,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,aAAa;QACb,kBAAkB;KAClB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,iBAAiB,CACtC,aAAqB,EACrB,IAAkB;IAElB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,MAAM,GAAiD,EAAE,CAAC;IAEhE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,MAAM,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;gBACzC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC3C,SAAS;YACV,CAAC;YACD,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9D,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC3C,SAAS;YACV,CAAC;YAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YAC1E,IAAI,MAAM,IAAA,wBAAU,EAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC1C,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACtC,SAAS;YACV,CAAC;YAED,IAAI,CAAC;gBACJ,MAAM,WAAW,GAAG,MAAM,IAAA,iCAAmB,EAAC,kBAAkB,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBACxF,IAAI,WAAW,EAAE,CAAC;oBACjB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACP,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACvC,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC;oBACX,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;iBACxE,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO;QACN,OAAO;QACP,aAAa;QACb,kBAAkB;QAClB,kBAAkB;QAClB,MAAM;KACN,CAAC;AACH,CAAC"}

package/dist/core/src/quickFix/quickFixMessaging.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatNoSupportedSafeQuickFixMessage = formatNoSupportedSafeQuickFixMessage;
+const quickFixProviders_1 = require("./quickFixProviders");
+function formatNoSupportedSafeQuickFixMessage() {
+    const catalog = (0, quickFixProviders_1.getQuickFixSupportCatalog)();
+    const safeRules = catalog.createFileRuleIds.join(', ');
+    const suggestionRules = catalog.suggestionOnlyRuleIds.join(', ');
+    return [
+        'No supported safe quick fixes are available for the current validation results.',
+        `Current quick-fix support covers: ${safeRules}`,
+        `Suggestion-only quick-fix support: ${suggestionRules}`,
+    ].join('\n');
+}
+//# sourceMappingURL=quickFixMessaging.js.map

package/dist/core/src/quickFix/quickFixMessaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickFixMessaging.js","sourceRoot":"","sources":["../../../../../core/src/quickFix/quickFixMessaging.ts"],"names":[],"mappings":";;AAEA,oFASC;AAXD,2DAAgE;AAEhE,SAAgB,oCAAoC;IACnD,MAAM,OAAO,GAAG,IAAA,6CAAyB,GAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO;QACN,iFAAiF;QACjF,qCAAqC,SAAS,EAAE;QAChD,sCAAsC,eAAe,EAAE;KACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/core/src/quickFix/quickFixProviders.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildQuickFixForValidationResult = buildQuickFixForValidationResult;
+exports.getQuickFixSupportCatalog = getQuickFixSupportCatalog;
+exports.attachQuickFixMetadataToResults = attachQuickFixMetadataToResults;
+const createFileQuickFixRuleIds = ['AP-API-001', 'AP-ARCH-001'];
+const suggestionOnlyQuickFixRuleIds = ['AP-DEP-005'];
+const minimalOpenApiScaffold = `openapi: 3.0.3
+info:
+  title: Service API
+  version: 0.1.0
+paths: {}
+`;
+function buildQuickFixForApiOpenApiMissing(result) {
+    if (result.id !== 'AP-API-001' ||
+        result.passed ||
+        !result.message.includes('contracts/openapi.yaml is missing')) {
+        return undefined;
+    }
+    return {
+        available: true,
+        type: 'create-file',
+        description: 'Create a minimal OpenAPI scaffold at contracts/openapi.yaml.',
+        actions: [
+            {
+                actionType: 'create-file',
+                targetPath: 'contracts/openapi.yaml',
+                content: minimalOpenApiScaffold,
+            },
+        ],
+    };
+}
+function buildQuickFixForArchModularStructureMissing(result) {
+    if (result.id !== 'AP-ARCH-001' || result.passed) {
+        return undefined;
+    }
+    const configuredRootMatch = result.message.match(/configured module root '([^']+)'/u);
+    const modulesRoot = configuredRootMatch?.[1] ?? 'src/modules';
+    const normalizedModulesRoot = modulesRoot.replace(/\\/g, '/');
+    return {
+        available: true,
+        type: 'create-file',
+        description: `Create a minimal module scaffold under ${normalizedModulesRoot}.`,
+        actions: [
+            {
+                actionType: 'create-file',
+                targetPath: `${normalizedModulesRoot}/README.md`,
+                content: '# Modules\n\nDefine module boundaries here.\n',
+            },
+            {
+                actionType: 'create-file',
+                targetPath: `${normalizedModulesRoot}/placeholder/index.ts`,
+                content: 'export {};\n',
+            },
+        ],
+    };
+}
+function buildQuickFixForDepPublicSurfaceViolation(result) {
+    if (result.id !== 'AP-DEP-005' ||
+        result.passed ||
+        !result.message.includes('imports a non-public path from module')) {
+        return undefined;
+    }
+    return {
+        available: true,
+        type: 'suggestion',
+        description: 'Import from the target module public entrypoint instead of an internal path.',
+    };
+}
+function buildQuickFixForValidationResult(result) {
+    return (buildQuickFixForApiOpenApiMissing(result) ??
+        buildQuickFixForArchModularStructureMissing(result) ??
+        buildQuickFixForDepPublicSurfaceViolation(result));
+}
+function getQuickFixSupportCatalog() {
+    return {
+        createFileRuleIds: createFileQuickFixRuleIds,
+        suggestionOnlyRuleIds: suggestionOnlyQuickFixRuleIds,
+    };
+}
+function attachQuickFixMetadataToResults(results) {
+    return results.map((result) => {
+        const quickFix = buildQuickFixForValidationResult(result);
+        return quickFix ? { ...result, quickFix } : result;
+    });
+}
+//# sourceMappingURL=quickFixProviders.js.map

package/dist/core/src/quickFix/quickFixProviders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickFixProviders.js","sourceRoot":"","sources":["../../../../../core/src/quickFix/quickFixProviders.ts"],"names":[],"mappings":";;AAsFA,4EAQC;AAED,8DAQC;AAED,0EAOC;AA9GD,MAAM,yBAAyB,GAAG,CAAC,YAAY,EAAE,aAAa,CAAU,CAAC;AACzE,MAAM,6BAA6B,GAAG,CAAC,YAAY,CAAU,CAAC;AAE9D,MAAM,sBAAsB,GAAG;;;;;CAK9B,CAAC;AAEF,SAAS,iCAAiC,CACzC,MAA4B;IAE5B,IACC,MAAM,CAAC,EAAE,KAAK,YAAY;QAC1B,MAAM,CAAC,MAAM;QACb,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAC5D,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO;QACN,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8DAA8D;QAC3E,OAAO,EAAE;YACR;gBACC,UAAU,EAAE,aAAa;gBACzB,UAAU,EAAE,wBAAwB;gBACpC,OAAO,EAAE,sBAAsB;aAC/B;SACD;KACD,CAAC;AACH,CAAC;AAED,SAAS,2CAA2C,CACnD,MAA4B;IAE5B,IAAI,MAAM,CAAC,EAAE,KAAK,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtF,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC;IAC9D,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE9D,OAAO;QACN,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,0CAA0C,qBAAqB,GAAG;QAC/E,OAAO,EAAE;YACR;gBACC,UAAU,EAAE,aAAa;gBACzB,UAAU,EAAE,GAAG,qBAAqB,YAAY;gBAChD,OAAO,EAAE,+CAA+C;aACxD;YACD;gBACC,UAAU,EAAE,aAAa;gBACzB,UAAU,EAAE,GAAG,qBAAqB,uBAAuB;gBAC3D,OAAO,EAAE,cAAc;aACvB;SACD;KACD,CAAC;AACH,CAAC;AAED,SAAS,yCAAyC,CACjD,MAA4B;IAE5B,IACC,MAAM,CAAC,EAAE,KAAK,YAAY;QAC1B,MAAM,CAAC,MAAM;QACb,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,uCAAuC,CAAC,EAChE,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO;QACN,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8EAA8E;KAC3F,CAAC;AACH,CAAC;AAED,SAAgB,gCAAgC,CAC/C,MAA4B;IAE5B,OAAO,CACN,iCAAiC,CAAC,MAAM,CAAC;QACzC,2CAA2C,CAAC,MAAM,CAAC;QACnD,yCAAyC,CAAC,MAAM,CAAC,CACjD,CAAC;AACH,CAAC;AAED,SAAgB,yBAAyB;IAIxC,OAAO;QACN,iBAAiB,EAAE,yBAAyB;QAC5C,qBAAqB,EAAE,6BAA6B;KACpD,CAAC;AACH,CAAC;AAED,SAAgB,+BAA+B,CAC9C,OAA+B;IAE/B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACpD,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/src/quickFix/quickFixTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=quickFixTypes.js.map

package/dist/core/src/quickFix/quickFixTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickFixTypes.js","sourceRoot":"","sources":["../../../../../core/src/quickFix/quickFixTypes.ts"],"names":[],"mappings":""}

package/dist/core/src/remediation/fileHelpers.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirectory = ensureDirectory;
+exports.pathExists = pathExists;
+exports.createFileIfMissing = createFileIfMissing;
+exports.writeJsonIfMissing = writeJsonIfMissing;
+exports.appendSectionIfMissing = appendSectionIfMissing;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+async function ensureDirectory(directoryPath) {
+    await node_fs_1.promises.mkdir(directoryPath, { recursive: true });
+}
+async function pathExists(targetPath) {
+    try {
+        await node_fs_1.promises.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function createFileIfMissing(filePath, content) {
+    if (await pathExists(filePath)) {
+        return false;
+    }
+    await ensureDirectory(path.dirname(filePath));
+    await node_fs_1.promises.writeFile(filePath, content, { encoding: 'utf8' });
+    return true;
+}
+async function writeJsonIfMissing(filePath, value) {
+    return createFileIfMissing(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+async function appendSectionIfMissing(filePath, sectionTitle, sectionBody) {
+    const normalizedTitle = sectionTitle.trim();
+    const normalizedBody = sectionBody.trim();
+    const sectionHeader = `## ${normalizedTitle}`;
+    const sectionContent = `${sectionHeader}\n\n${normalizedBody}\n`;
+    if (!(await pathExists(filePath))) {
+        await ensureDirectory(path.dirname(filePath));
+        await node_fs_1.promises.writeFile(filePath, `${sectionContent}\n`, { encoding: 'utf8' });
+        return true;
+    }
+    const existing = await node_fs_1.promises.readFile(filePath, { encoding: 'utf8' });
+    if (existing.includes(sectionHeader)) {
+        return false;
+    }
+    const separator = existing.endsWith('\n') ? '\n' : '\n\n';
+    await node_fs_1.promises.writeFile(filePath, `${existing}${separator}${sectionContent}`, {
+        encoding: 'utf8',
+    });
+    return true;
+}
+//# sourceMappingURL=fileHelpers.js.map

package/dist/core/src/remediation/fileHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileHelpers.js","sourceRoot":"","sources":["../../../../../core/src/remediation/fileHelpers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,0CAEC;AAED,gCAOC;AAED,kDAWC;AAED,gDAKC;AAED,wDA0BC;AA9DD,gDAAkC;AAClC,qCAAyC;AAElC,KAAK,UAAU,eAAe,CAAC,aAAqB;IAC1D,MAAM,kBAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,UAAkB;IAClD,IAAI,CAAC;QACJ,MAAM,kBAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACxC,QAAgB,EAChB,OAAe;IAEf,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC;AACb,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACvC,QAAgB,EAChB,KAAc;IAEd,OAAO,mBAAmB,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC3C,QAAgB,EAChB,YAAoB,EACpB,WAAmB;IAEnB,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,aAAa,GAAG,MAAM,eAAe,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,GAAG,aAAa,OAAO,cAAc,IAAI,CAAC;IAEjE,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9C,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,cAAc,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,EAAE,EAAE;QACxE,QAAQ,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACb,CAAC"}