fraim 2.0.325 → 2.0.326

package/dist/src/core/fraim-config-schema.generated.js

@@ -627,6 +627,9 @@ exports.FRAIM_CONFIG_SCHEMA = {
                 },
                 "learning_usage": {
                     "kind": "number"
+                },
+                "hub_event_logs": {
+                    "kind": "number"
                 }
             }
         }
@@ -768,5 +771,6 @@ exports.SUPPORTED_FRAIM_CONFIG_PATHS = [
     "artifact_retention_period.evidence",
     "artifact_retention_period.feedback",
     "artifact_retention_period.cleanup_manifests",
-    "artifact_retention_period.learning_usage"
+    "artifact_retention_period.learning_usage",
+    "artifact_retention_period.hub_event_logs"
 ];

package/dist/src/local-mcp-server/artifact-retention-cleanup.js

@@ -8,6 +8,7 @@ exports.resolveArtifactRetentionConfig = resolveArtifactRetentionConfig;
 exports.runArtifactCleanup = runArtifactCleanup;
 exports.planArtifactCleanup = planArtifactCleanup;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_child_process_1 = require("node:child_process");
 const node_path_1 = __importDefault(require("node:path"));
 const project_fraim_paths_1 = require("../core/utils/project-fraim-paths");
@@ -25,6 +26,7 @@ exports.ARTIFACT_RETENTION_CATEGORIES = [
     // deleted. Aggregate counters are never pruned; deleting them would misreport
     // history rather than minimise it.
     'learning_usage',
+    'hub_event_logs',
 ];
 function readWorkspaceConfig(workspaceRoot) {
     try {
@@ -69,7 +71,7 @@ function resolveArtifactRetentionConfig(workspaceRoot) {
     for (const category of exports.ARTIFACT_RETENTION_CATEGORIES) {
         values[category] = category in rawRetention
             ? parseRetentionValue(category, rawRetention[category], defaultValue, invalidValues)
-            : defaultValue;
+            : category === 'hub_event_logs' && !('default' in rawRetention) ? 7 : defaultValue;
     }
     return { values, defaultValue, invalidValues };
 }
@@ -172,7 +174,8 @@ function evidenceEligibilityDate(workspaceRoot, absolutePath, gitDates) {
     const relativePath = normalizeRelative(workspaceRoot, absolutePath);
     return gitDates.get(relativePath) ?? fileMtime(absolutePath);
 }
-function collectCandidates(workspaceRoot, activeUserEmail) {
+function collectCandidates(workspaceRoot, options) {
+    const { activeUserEmail } = options;
     const candidates = [];
     const add = (category, absolutePath, eligible, reason, eligibilityDate) => {
         candidates.push({
@@ -224,8 +227,82 @@ function collectCandidates(workspaceRoot, activeUserEmail) {
         }
         add('evidence', filePath, true, 'Evidence file.', eligibilityDate);
     }
+    // A workspace policy owns only its project bucket. Manager/company archives
+    // and other projects must not inherit whichever project is being cleaned.
+    const logRoot = node_path_1.default.resolve(options.hubEventLogRoot ?? node_path_1.default.join((0, project_fraim_paths_1.getUserFraimDirPath)(), 'ai-hub-event-logs'));
+    // Project archive keys use the resolved path; keep core cleanup independent
+    // of the separately shipped Hub package that also uses this convention.
+    const bucket = node_crypto_1.default.createHash('sha256').update(node_path_1.default.resolve(workspaceRoot)).digest('hex').slice(0, 24);
+    const bucketDir = node_path_1.default.join(logRoot, bucket);
+    try {
+        if (!node_fs_1.default.lstatSync(bucketDir).isDirectory())
+            return candidates;
+    }
+    catch {
+        return candidates;
+    }
+    for (const filePath of listFiles(bucketDir)) {
+        if (!filePath.endsWith('.jsonl'))
+            continue;
+        const state = readHubArchiveState(logRoot, filePath);
+        if (!state)
+            continue;
+        add('hub_event_logs', filePath, state.eligible, state.reason, state.eligibilityDate);
+        Object.assign(candidates[candidates.length - 1], state);
+    }
     return candidates;
 }
+function readHubArchiveState(root, filePath) {
+    if (!isConfinedRegularFile(root, filePath))
+        return null;
+    try {
+        const metaPath = `${filePath}.meta.json`;
+        const hasMeta = isConfinedRegularFile(root, metaPath);
+        let meta = {};
+        if (hasMeta) {
+            try {
+                meta = JSON.parse(node_fs_1.default.readFileSync(metaPath, 'utf8')) ?? {};
+            }
+            catch { /* Crashed or legacy archive: use mtime. */ }
+        }
+        const endedAt = typeof meta.endedAt === 'string' ? parseDate(meta.endedAt) : undefined;
+        const active = !endedAt && isLiveProcess(meta.ownerPid);
+        const stat = node_fs_1.default.statSync(filePath);
+        return {
+            eligible: !active,
+            reason: active ? 'Archive writer is still running.' : endedAt ? 'Run has ended.' : 'Archive has no terminal stamp; using last write.',
+            eligibilityDate: endedAt ?? stat.mtime,
+            sidecarPath: hasMeta ? metaPath : undefined,
+            hubArchive: { root, realPath: node_fs_1.default.realpathSync(filePath), mtimeMs: stat.mtimeMs, size: stat.size },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function isConfinedRegularFile(root, filePath) {
+    try {
+        if (!node_fs_1.default.lstatSync(filePath).isFile())
+            return false;
+        const relative = node_path_1.default.relative(node_fs_1.default.realpathSync(root), node_fs_1.default.realpathSync(filePath));
+        return relative !== '' && !relative.startsWith(`..${node_path_1.default.sep}`) && relative !== '..' && !node_path_1.default.isAbsolute(relative);
+    }
+    catch {
+        return false;
+    }
+}
+function isLiveProcess(pid) {
+    if (typeof pid !== 'number' || !Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // Access denied still means a process exists. PID reuse errs toward retention.
+        return error.code !== 'ESRCH';
+    }
+}
 function daysBetween(from, to) {
     return Math.floor((to.getTime() - from.getTime()) / 86_400_000);
 }
@@ -254,7 +331,7 @@ function incrementCount(report, action) {
 function runArtifactCleanup(workspaceRoot, options) {
     const now = options.now ?? new Date();
     const retention = resolveArtifactRetentionConfig(workspaceRoot);
-    const candidates = collectCandidates(workspaceRoot, options.activeUserEmail);
+    const candidates = collectCandidates(workspaceRoot, options);
     const report = {
         generatedAt: now.toISOString(),
         apply: options.apply,
@@ -265,7 +342,7 @@ function runArtifactCleanup(workspaceRoot, options) {
     };
     for (const candidate of candidates) {
         const retentionValue = retention.values[candidate.category];
-        const decision = shouldDelete(candidate, retentionValue, now);
+        let decision = shouldDelete(candidate, retentionValue, now);
         let action;
         let error;
         if (!candidate.eligible) {
@@ -279,8 +356,31 @@ function runArtifactCleanup(workspaceRoot, options) {
         }
         else {
             try {
-                node_fs_1.default.unlinkSync(candidate.absolutePath);
-                action = 'deleted';
+                if (candidate.category === 'hub_event_logs' && candidate.hubArchive) {
+                    const prior = candidate.hubArchive;
+                    const current = readHubArchiveState(prior.root, candidate.absolutePath);
+                    // A terminal run can resume while other candidates are being collected.
+                    // Revalidate immediately before unlink; a changed archive waits for the
+                    // next cleanup, even when its new retention setting would be immediate.
+                    if (!current || !current.eligible || current.hubArchive?.realPath !== prior.realPath
+                        || current.hubArchive?.mtimeMs !== prior.mtimeMs || current.hubArchive?.size !== prior.size
+                        || current.eligibilityDate?.getTime() !== candidate.eligibilityDate?.getTime()
+                        || current.sidecarPath !== candidate.sidecarPath) {
+                        decision = { delete: false, reason: 'Archive changed or resumed after enumeration; retained for a later cleanup.' };
+                    }
+                    else {
+                        decision = shouldDelete({ ...candidate, ...current }, retentionValue, now);
+                    }
+                }
+                if (!decision.delete) {
+                    action = 'retained';
+                }
+                else {
+                    node_fs_1.default.unlinkSync(candidate.absolutePath);
+                    if (candidate.sidecarPath)
+                        node_fs_1.default.unlinkSync(candidate.sidecarPath);
+                    action = 'deleted';
+                }
             }
             catch (err) {
                 action = 'failed';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.325",
+  "version": "2.0.326",
   "description": "FRAIM core CLI and MCP package.",
   "main": "index.js",
   "bin": {