@archpilotlabs/archpilot 0.2.2 → 0.2.3

package/dist/core/src/impactAnalysisEngine.js

@@ -0,0 +1,376 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeImpact = analyzeImpact;
+function sortUnique(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+function normalizePath(value) {
+    return value.replace(/\\/g, '/');
+}
+function deriveChangedModulesFromFiles(changedFiles, modulePaths) {
+    if (changedFiles.length === 0 || modulePaths.length === 0) {
+        return [];
+    }
+    const normalizedFiles = changedFiles.map((filePath) => normalizePath(filePath));
+    const sortedModulePaths = [...modulePaths]
+        .map((entry) => ({ ...entry, modulePath: normalizePath(entry.modulePath) }))
+        .sort((left, right) => {
+        const lenCompare = right.modulePath.length - left.modulePath.length;
+        if (lenCompare !== 0) {
+            return lenCompare;
+        }
+        return left.moduleName.localeCompare(right.moduleName);
+    });
+    const resolved = new Set();
+    for (const changedFile of normalizedFiles) {
+        for (const modulePath of sortedModulePaths) {
+            if (changedFile === modulePath.modulePath ||
+                changedFile.startsWith(`${modulePath.modulePath}/`)) {
+                resolved.add(modulePath.moduleName);
+                break;
+            }
+        }
+    }
+    return sortUnique(resolved);
+}
+function resolveImpactLevel(impactRadiusScore) {
+    if (impactRadiusScore <= 6) {
+        return 'LOW';
+    }
+    if (impactRadiusScore <= 14) {
+        return 'MEDIUM';
+    }
+    return 'HIGH';
+}
+function compareChain(left, right) {
+    const lengthCompare = left.length - right.length;
+    if (lengthCompare !== 0) {
+        return lengthCompare;
+    }
+    return left.join('->').localeCompare(right.join('->'));
+}
+function isBetterChain(candidate, current) {
+    if (!current) {
+        return true;
+    }
+    return compareChain(candidate, current) < 0;
+}
+function formatChain(chain) {
+    return chain.join(' -> ');
+}
+function deriveDependencyChains(inbound, changedModules) {
+    const directChains = new Map();
+    const transitiveChains = new Map();
+    const changedSet = new Set(changedModules);
+    for (const changedModule of changedModules) {
+        const minDepthByModule = new Map();
+        const queue = [[changedModule]];
+        while (queue.length > 0) {
+            const currentChain = queue.shift();
+            if (!currentChain) {
+                continue;
+            }
+            const currentModule = currentChain[currentChain.length - 1];
+            const inboundDependents = sortUnique(inbound.get(currentModule) ?? new Set());
+            for (const dependent of inboundDependents) {
+                if (changedSet.has(dependent) || currentChain.includes(dependent)) {
+                    continue;
+                }
+                const nextChain = [...currentChain, dependent];
+                const depth = nextChain.length - 1;
+                const recordedDepth = minDepthByModule.get(dependent);
+                if (recordedDepth !== undefined && depth > recordedDepth) {
+                    continue;
+                }
+                if (recordedDepth === undefined || depth < recordedDepth) {
+                    minDepthByModule.set(dependent, depth);
+                }
+                if (depth === 1) {
+                    if (isBetterChain(nextChain, directChains.get(dependent))) {
+                        directChains.set(dependent, nextChain);
+                    }
+                }
+                else if (!directChains.has(dependent)) {
+                    if (isBetterChain(nextChain, transitiveChains.get(dependent))) {
+                        transitiveChains.set(dependent, nextChain);
+                    }
+                }
+                queue.push(nextChain);
+            }
+        }
+    }
+    for (const directModule of directChains.keys()) {
+        transitiveChains.delete(directModule);
+    }
+    return { directChains, transitiveChains };
+}
+function buildImpactFactors(input) {
+    const factors = [];
+    const governanceSurfaceCount = input.governanceSurface.impactedContracts.length +
+        input.governanceSurface.impactedPublicEntrypoints.length +
+        input.governanceSurface.impactedAdrs.length +
+        input.governanceSurface.impactedArchitectureArtifacts.length;
+    if (input.changedModules.length > 0) {
+        factors.push({
+            id: 'IAF-001',
+            label: 'Changed modules in scope',
+            description: 'Modules directly changed by this diff scope.',
+            category: 'scope',
+            weight: input.changedModules.length * 2,
+            evidence: input.changedModules,
+        });
+    }
+    if (input.directDependencyChains.length > 0) {
+        factors.push({
+            id: 'IAF-002',
+            label: 'Direct dependents impacted',
+            description: 'Modules directly depending on changed modules.',
+            category: 'dependency',
+            weight: input.directDependencyChains.length * 3,
+            evidence: input.directDependencyChains.map((entry) => formatChain(entry.chain)),
+        });
+    }
+    if (input.transitiveDependencyChains.length > 0) {
+        factors.push({
+            id: 'IAF-003',
+            label: 'Transitive dependents impacted',
+            description: 'Downstream modules impacted through dependent chains.',
+            category: 'dependency',
+            weight: input.transitiveDependencyChains.length * 2,
+            evidence: input.transitiveDependencyChains.map((entry) => formatChain(entry.chain)),
+        });
+    }
+    if (governanceSurfaceCount > 0) {
+        factors.push({
+            id: 'IAF-004',
+            label: 'Governance surface touched',
+            description: 'Contracts, entrypoints, ADRs, or architecture artifacts were touched.',
+            category: 'governance-surface',
+            weight: governanceSurfaceCount * 2,
+            evidence: sortUnique([
+                ...input.governanceSurface.impactedContracts,
+                ...input.governanceSurface.impactedPublicEntrypoints,
+                ...input.governanceSurface.impactedAdrs,
+                ...input.governanceSurface.impactedArchitectureArtifacts,
+            ]),
+        });
+    }
+    return factors.sort((left, right) => left.id.localeCompare(right.id));
+}
+function analyzeImpact(input) {
+    const moduleUniverse = new Set(input.graph.modules);
+    const changedFromInput = input.changedModules ?? [];
+    const changedFromFiles = deriveChangedModulesFromFiles(input.changedFiles ?? [], input.modulePaths ?? []);
+    const changedModules = sortUnique([...changedFromInput, ...changedFromFiles].filter((moduleName) => moduleUniverse.has(moduleName)));
+    const affectedSurface = {
+        changedModules,
+        directlyAffectedModules: [],
+        transitivelyAffectedModules: [],
+        impactedContracts: sortUnique(input.touchedContracts ?? []),
+        impactedPublicEntrypoints: sortUnique(input.touchedPublicEntrypoints ?? []),
+        impactedAdrs: sortUnique(input.touchedAdrs ?? []),
+        impactedArchitectureArtifacts: sortUnique(input.touchedArchitectureArtifacts ?? []),
+    };
+    if (changedModules.length === 0) {
+        const governanceSurfaceCount = affectedSurface.impactedContracts.length +
+            affectedSurface.impactedPublicEntrypoints.length +
+            affectedSurface.impactedAdrs.length +
+            affectedSurface.impactedArchitectureArtifacts.length;
+        const scoring = {
+            modelVersion: 1,
+            formula: 'score = (changed*2) + (direct*3) + (transitive*2) + (governance*2) + max(0, depth-2)',
+            components: {
+                changedModules: 0,
+                directlyAffectedModules: 0,
+                transitivelyAffectedModules: 0,
+                governanceSurfaceItems: governanceSurfaceCount,
+                maxTransitiveChainDepth: 0,
+            },
+            computedScore: governanceSurfaceCount * 2,
+            thresholds: {
+                lowMax: 6,
+                mediumMax: 14,
+                highMin: 15,
+            },
+            rationale: [
+                'No changed modules were resolved; score reflects governance-surface signals only.',
+            ],
+        };
+        return {
+            changedModules: [],
+            directDependents: [],
+            transitiveDependents: [],
+            totalAffectedModules: 0,
+            impactRadiusScore: scoring.computedScore,
+            impactLevel: resolveImpactLevel(scoring.computedScore),
+            summary: governanceSurfaceCount > 0
+                ? `No changed modules resolved; governance surfaces touched: ${governanceSurfaceCount}.`
+                : 'No changed modules or governance surfaces resolved.',
+            affectedSurface,
+            directDependencyChains: [],
+            transitiveDependencyChains: [],
+            factors: buildImpactFactors({
+                changedModules: [],
+                directDependencyChains: [],
+                transitiveDependencyChains: [],
+                governanceSurface: affectedSurface,
+            }),
+            reasoning: [],
+            scoring,
+        };
+    }
+    const inbound = new Map();
+    for (const moduleName of moduleUniverse) {
+        inbound.set(moduleName, new Set());
+    }
+    for (const edge of input.graph.edges) {
+        if (!moduleUniverse.has(edge.source) || !moduleUniverse.has(edge.target)) {
+            continue;
+        }
+        inbound.get(edge.target)?.add(edge.source);
+    }
+    const { directChains, transitiveChains } = deriveDependencyChains(inbound, changedModules);
+    const directDependents = sortUnique(directChains.keys());
+    const transitiveDependents = sortUnique(transitiveChains.keys());
+    const totalAffectedModules = sortUnique([
+        ...directDependents,
+        ...transitiveDependents,
+    ]).length;
+    affectedSurface.directlyAffectedModules = directDependents;
+    affectedSurface.transitivelyAffectedModules = transitiveDependents;
+    const directDependencyChains = directDependents.map((moduleName) => ({
+        module: moduleName,
+        chain: directChains.get(moduleName) ?? [moduleName],
+    }));
+    const transitiveDependencyChains = transitiveDependents.map((moduleName) => ({
+        module: moduleName,
+        chain: transitiveChains.get(moduleName) ?? [moduleName],
+    }));
+    const maxTransitiveChainDepth = transitiveDependencyChains.reduce((maxDepth, entry) => Math.max(maxDepth, entry.chain.length - 1), 0);
+    const governanceSurfaceCount = affectedSurface.impactedContracts.length +
+        affectedSurface.impactedPublicEntrypoints.length +
+        affectedSurface.impactedAdrs.length +
+        affectedSurface.impactedArchitectureArtifacts.length;
+    const factors = buildImpactFactors({
+        changedModules,
+        directDependencyChains,
+        transitiveDependencyChains,
+        governanceSurface: affectedSurface,
+    });
+    const weightedScore = factors.reduce((accumulator, factor) => accumulator + factor.weight, 0) +
+        Math.max(0, maxTransitiveChainDepth - 2);
+    const impactRadiusScore = Math.max(weightedScore, totalAffectedModules);
+    const reasoning = [];
+    let reasoningCounter = 1;
+    for (const moduleName of changedModules) {
+        reasoning.push({
+            id: `IR-${String(reasoningCounter).padStart(3, '0')}`,
+            type: 'changed-scope',
+            targetType: 'module',
+            target: moduleName,
+            evidence: `Changed module: ${moduleName}`,
+        });
+        reasoningCounter += 1;
+    }
+    for (const entry of directDependencyChains) {
+        reasoning.push({
+            id: `IR-${String(reasoningCounter).padStart(3, '0')}`,
+            type: 'direct-impact',
+            targetType: 'module',
+            target: entry.module,
+            evidence: `Direct dependent path: ${formatChain(entry.chain)}`,
+            chain: entry.chain,
+        });
+        reasoningCounter += 1;
+    }
+    for (const entry of transitiveDependencyChains) {
+        reasoning.push({
+            id: `IR-${String(reasoningCounter).padStart(3, '0')}`,
+            type: 'transitive-impact',
+            targetType: 'module',
+            target: entry.module,
+            evidence: `Transitive chain path: ${formatChain(entry.chain)}`,
+            chain: entry.chain,
+        });
+        reasoningCounter += 1;
+    }
+    for (const contractPath of affectedSurface.impactedContracts) {
+        reasoning.push({
+            id: `IR-${String(reasoningCounter).padStart(3, '0')}`,
+            type: 'governance-surface',
+            targetType: 'contract',
+            target: contractPath,
+            evidence: `Touched contract: ${contractPath}`,
+        });
+        reasoningCounter += 1;
+    }
+    for (const entrypointPath of affectedSurface.impactedPublicEntrypoints) {
+        reasoning.push({
+            id: `IR-${String(reasoningCounter).padStart(3, '0')}`,
+            type: 'governance-surface',
+            targetType: 'public-entrypoint',
+            target: entrypointPath,
+            evidence: `Touched public entrypoint: ${entrypointPath}`,
+        });
+        reasoningCounter += 1;
+    }
+    for (const adrPath of affectedSurface.impactedAdrs) {
+        reasoning.push({
+            id: `IR-${String(reasoningCounter).padStart(3, '0')}`,
+            type: 'governance-surface',
+            targetType: 'adr',
+            target: adrPath,
+            evidence: `Touched ADR: ${adrPath}`,
+        });
+        reasoningCounter += 1;
+    }
+    for (const artifactPath of affectedSurface.impactedArchitectureArtifacts) {
+        reasoning.push({
+            id: `IR-${String(reasoningCounter).padStart(3, '0')}`,
+            type: 'governance-surface',
+            targetType: 'architecture-artifact',
+            target: artifactPath,
+            evidence: `Touched architecture artifact: ${artifactPath}`,
+        });
+        reasoningCounter += 1;
+    }
+    const scoring = {
+        modelVersion: 1,
+        formula: 'score = (changed*2) + (direct*3) + (transitive*2) + (governance*2) + max(0, depth-2)',
+        components: {
+            changedModules: changedModules.length,
+            directlyAffectedModules: directDependents.length,
+            transitivelyAffectedModules: transitiveDependents.length,
+            governanceSurfaceItems: governanceSurfaceCount,
+            maxTransitiveChainDepth,
+        },
+        computedScore: impactRadiusScore,
+        thresholds: {
+            lowMax: 6,
+            mediumMax: 14,
+            highMin: 15,
+        },
+        rationale: [
+            'Direct dependents are weighted higher than transitive dependents to prioritize immediate coupling.',
+            'Governance surface touches raise score because contracts, entrypoints, ADRs, and architecture artifacts affect review scope.',
+        ],
+    };
+    const summary = `Changed=${changedModules.length}, Direct=${directDependents.length}, ` +
+        `Transitive=${transitiveDependents.length}, GovernanceSurfaces=${governanceSurfaceCount}.`;
+    return {
+        changedModules,
+        directDependents,
+        transitiveDependents,
+        totalAffectedModules,
+        impactRadiusScore,
+        impactLevel: resolveImpactLevel(impactRadiusScore),
+        summary,
+        affectedSurface,
+        directDependencyChains,
+        transitiveDependencyChains,
+        factors,
+        reasoning,
+        scoring,
+    };
+}
+//# sourceMappingURL=impactAnalysisEngine.js.map

package/dist/core/src/impactAnalysisEngine.js.map

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

package/dist/core/src/initializationState.js

@@ -0,0 +1,99 @@
+"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.getArchitectureConfigPath = getArchitectureConfigPath;
+exports.getArchpilotInitializationState = getArchpilotInitializationState;
+exports.renderInitializationBlockedMessage = renderInitializationBlockedMessage;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+function getArchitectureConfigPath(workspaceRoot) {
+    return path.join(workspaceRoot, '.archpilot', 'architecture.json');
+}
+async function getArchpilotInitializationState(workspaceRoot) {
+    const configPath = getArchitectureConfigPath(workspaceRoot);
+    let content;
+    try {
+        content = await node_fs_1.promises.readFile(configPath, { encoding: 'utf8' });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return { kind: 'not_initialized', configPath };
+        }
+        return {
+            kind: 'invalid',
+            configPath,
+            details: error instanceof Error
+                ? error.message
+                : 'Unable to read .archpilot/architecture.json.',
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return {
+            kind: 'invalid',
+            configPath,
+            details: '.archpilot/architecture.json is invalid JSON.',
+        };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return {
+            kind: 'invalid',
+            configPath,
+            details: '.archpilot/architecture.json must be a JSON object.',
+        };
+    }
+    const projectName = parsed.projectName;
+    if (typeof projectName !== 'string' || projectName.trim().length === 0) {
+        return {
+            kind: 'invalid',
+            configPath,
+            details: '.archpilot/architecture.json is missing required "projectName".',
+        };
+    }
+    return { kind: 'initialized', configPath };
+}
+function renderInitializationBlockedMessage(state) {
+    if (state.kind === 'not_initialized') {
+        return 'ArchPilot is not initialized for this repository. Open the Architecture Inspector and select Initialize Architecture.';
+    }
+    if (state.kind === 'invalid') {
+        return `ArchPilot initialization is blocked because .archpilot/architecture.json is malformed. ${state.details} Fix the file, then initialize from the Architecture Inspector.`;
+    }
+    return 'ArchPilot is already initialized.';
+}
+//# sourceMappingURL=initializationState.js.map

package/dist/core/src/initializationState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializationState.js","sourceRoot":"","sources":["../../../../core/src/initializationState.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,8DAEC;AAED,0EAkDC;AAED,gFAUC;AA1ED,gDAAkC;AAClC,qCAAyC;AAOzC,SAAgB,yBAAyB,CAAC,aAAqB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;AACpE,CAAC;AAEM,KAAK,UAAU,+BAA+B,CACpD,aAAqB;IAErB,MAAM,UAAU,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAC5D,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;QAChD,CAAC;QACD,OAAO;YACN,IAAI,EAAE,SAAS;YACf,UAAU;YACV,OAAO,EACN,KAAK,YAAY,KAAK;gBACrB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,8CAA8C;SAClD,CAAC;IACH,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO;YACN,IAAI,EAAE,SAAS;YACf,UAAU;YACV,OAAO,EAAE,+CAA+C;SACxD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,OAAO;YACN,IAAI,EAAE,SAAS;YACf,UAAU;YACV,OAAO,EAAE,qDAAqD;SAC9D,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAI,MAAoC,CAAC,WAAW,CAAC;IACtE,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO;YACN,IAAI,EAAE,SAAS;YACf,UAAU;YACV,OAAO,EAAE,iEAAiE;SAC1E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AAC5C,CAAC;AAED,SAAgB,kCAAkC,CACjD,KAAmC;IAEnC,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACtC,OAAO,uHAAuH,CAAC;IAChI,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,0FAA0F,KAAK,CAAC,OAAO,iEAAiE,CAAC;IACjL,CAAC;IACD,OAAO,mCAAmC,CAAC;AAC5C,CAAC"}

package/dist/core/src/managedArtifacts.js

@@ -0,0 +1,151 @@
+"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.managedMarkdownMarkerPrefix = void 0;
+exports.buildManagedMetadata = buildManagedMetadata;
+exports.withManagedJsonMetadata = withManagedJsonMetadata;
+exports.withManagedMarkdownMarker = withManagedMarkdownMarker;
+exports.isManagedJsonArtifact = isManagedJsonArtifact;
+exports.isManagedMarkdownArtifact = isManagedMarkdownArtifact;
+exports.classifyManagedArtifact = classifyManagedArtifact;
+exports.writeManagedArtifactIfSafe = writeManagedArtifactIfSafe;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const packageVersion_1 = require("./packageVersion");
+exports.managedMarkdownMarkerPrefix = '<!-- archpilot:managed';
+async function buildManagedMetadata(generator, generatedAt = new Date().toISOString()) {
+    return {
+        managed: true,
+        generatedAt,
+        generator,
+        version: await (0, packageVersion_1.readArchpilotPackageVersion)(),
+    };
+}
+function withManagedJsonMetadata(value, metadata) {
+    return {
+        xArchPilot: metadata,
+        ...value,
+    };
+}
+function withManagedMarkdownMarker(content, metadata) {
+    const marker = `${exports.managedMarkdownMarkerPrefix} generated-by=${metadata.generator} -->`;
+    const normalized = content.replace(new RegExp(`^${escapeRegExp(exports.managedMarkdownMarkerPrefix)}[^\\n]*\\n`, 'u'), '');
+    return `${marker}\n${normalized}`;
+}
+function isManagedJsonArtifact(value, options) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const metadata = value.xArchPilot;
+    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {
+        return false;
+    }
+    const typedMetadata = metadata;
+    if (typedMetadata.managed !== true) {
+        return false;
+    }
+    if (!options?.generator) {
+        return true;
+    }
+    return (typedMetadata.generator === undefined ||
+        typedMetadata.generator === options.generator);
+}
+function isManagedMarkdownArtifact(content) {
+    return content.trimStart().startsWith(exports.managedMarkdownMarkerPrefix);
+}
+async function classifyManagedArtifact(workspaceRoot, relativePath, kind, options) {
+    const absolutePath = path.join(workspaceRoot, ...relativePath.split('/'));
+    let content;
+    try {
+        content = await node_fs_1.promises.readFile(absolutePath, { encoding: 'utf8' });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                relativePath,
+                status: 'create',
+                reason: 'file is missing',
+            };
+        }
+        throw error;
+    }
+    if (kind === 'markdown') {
+        return isManagedMarkdownArtifact(content)
+            ? {
+                relativePath,
+                status: 'update-managed',
+                reason: 'file has ArchPilot managed marker',
+            }
+            : {
+                relativePath,
+                status: 'preserve-user-owned',
+                reason: 'file has no ArchPilot managed marker',
+            };
+    }
+    try {
+        const parsed = JSON.parse(content);
+        return isManagedJsonArtifact(parsed, options)
+            ? {
+                relativePath,
+                status: 'update-managed',
+                reason: 'file has xArchPilot.managed metadata',
+            }
+            : {
+                relativePath,
+                status: 'preserve-user-owned',
+                reason: 'file has no xArchPilot.managed metadata',
+            };
+    }
+    catch {
+        return {
+            relativePath,
+            status: 'preserve-user-owned',
+            reason: 'file is not valid JSON',
+        };
+    }
+}
+async function writeManagedArtifactIfSafe(workspaceRoot, plan, content) {
+    if (plan.status === 'preserve-user-owned') {
+        return false;
+    }
+    const absolutePath = path.join(workspaceRoot, ...plan.relativePath.split('/'));
+    await node_fs_1.promises.mkdir(path.dirname(absolutePath), { recursive: true });
+    await node_fs_1.promises.writeFile(absolutePath, content, { encoding: 'utf8' });
+    return true;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+}
+//# sourceMappingURL=managedArtifacts.js.map

package/dist/core/src/managedArtifacts.js.map

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