@greenarmor/ges-core 1.2.3 → 1.2.5

package/dist/activity-log/index.d.ts

@@ -0,0 +1,20 @@
+import type { ActivityLogEntry, ActivityAction, ActivityStatus } from "../types/index.js";
+export declare function loadActivityLog(projectPath: string): ActivityLogEntry[];
+export declare function appendActivityLog(projectPath: string, entries: ActivityLogEntry[]): void;
+export declare function clearActivityLog(projectPath: string): void;
+export declare function createActivityLogEntry(opts: {
+    source: "cli" | "mcp";
+    action: ActivityAction;
+    title: string;
+    description: string;
+    status?: ActivityStatus;
+    details?: ActivityLogEntry["details"];
+}): ActivityLogEntry;
+export declare function recordActivity(projectPath: string, opts: {
+    source: "cli" | "mcp";
+    action: ActivityAction;
+    title: string;
+    description: string;
+    status?: ActivityStatus;
+    details?: ActivityLogEntry["details"];
+}): void;

package/dist/activity-log/index.js

@@ -0,0 +1,57 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function loadActivityLog(projectPath) {
+    const logPath = path.join(projectPath, ".ges", "activity-log.json");
+    try {
+        const raw = fs.readFileSync(logPath, "utf-8");
+        const data = JSON.parse(raw);
+        return Array.isArray(data) ? data : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function appendActivityLog(projectPath, entries) {
+    if (entries.length === 0)
+        return;
+    const gesDir = path.join(projectPath, ".ges");
+    if (!fs.existsSync(gesDir)) {
+        fs.mkdirSync(gesDir, { recursive: true });
+    }
+    const logPath = path.join(gesDir, "activity-log.json");
+    const existing = loadActivityLog(projectPath);
+    const updated = existing.concat(entries);
+    fs.writeFileSync(logPath, JSON.stringify(updated, null, 2), "utf-8");
+}
+export function clearActivityLog(projectPath) {
+    const logPath = path.join(projectPath, ".ges", "activity-log.json");
+    try {
+        fs.unlinkSync(logPath);
+    }
+    catch {
+        // ignore
+    }
+}
+let activityCounter = 0;
+export function createActivityLogEntry(opts) {
+    activityCounter++;
+    return {
+        id: `activity-${Date.now()}-${activityCounter}`,
+        timestamp: new Date().toISOString(),
+        source: opts.source,
+        action: opts.action,
+        title: opts.title,
+        description: opts.description,
+        status: opts.status || "success",
+        details: opts.details || {},
+    };
+}
+export function recordActivity(projectPath, opts) {
+    const entry = createActivityLogEntry(opts);
+    try {
+        appendActivityLog(projectPath, [entry]);
+    }
+    catch {
+        // ignore persistence errors
+    }
+}

package/dist/controls/index.d.ts

@@ -0,0 +1,9 @@
+import type { Control, ControlOverride, ControlStatus, ProjectConfig } from "../types/index.js";
+export declare function loadControlsFromDisk(projectPath: string): Control[];
+export declare function getInstalledPackIds(projectPath: string): Set<string>;
+export declare function loadControlOverrides(projectPath: string): ControlOverride[];
+export declare function saveControlOverride(projectPath: string, controlId: string, status: ControlStatus, reason: string): void;
+export declare function applyOverridesToControls(controls: Control[], overrides: ControlOverride[]): Control[];
+export declare function loadConfig(projectPath: string): ProjectConfig | null;
+export declare function addFrameworkToConfig(projectPath: string, framework: string): boolean;
+export declare function removeFrameworkFromConfig(projectPath: string, framework: string): boolean;

package/dist/controls/index.js

@@ -0,0 +1,145 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+const GES_DIR = ".ges";
+const CONTROLS_DIR = "controls";
+const CONFIG_FILE = "config.json";
+const OVERRIDES_FILE = "control-overrides.json";
+export function loadControlsFromDisk(projectPath) {
+    const controlsDir = path.join(projectPath, CONTROLS_DIR);
+    const result = [];
+    try {
+        const entries = fs.readdirSync(controlsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const ctrlFile = path.join(controlsDir, entry.name, "controls.json");
+            if (!fs.existsSync(ctrlFile))
+                continue;
+            try {
+                const raw = fs.readFileSync(ctrlFile, "utf-8");
+                const parsed = JSON.parse(raw);
+                if (Array.isArray(parsed)) {
+                    for (const ctrl of parsed) {
+                        if (ctrl && typeof ctrl.id === "string") {
+                            result.push(ctrl);
+                        }
+                    }
+                }
+            }
+            catch {
+                // skip malformed controls.json
+            }
+        }
+    }
+    catch {
+        // controls dir may not exist
+    }
+    return result;
+}
+export function getInstalledPackIds(projectPath) {
+    const ids = new Set();
+    const controlsDir = path.join(projectPath, CONTROLS_DIR);
+    try {
+        const entries = fs.readdirSync(controlsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const ctrlFile = path.join(controlsDir, entry.name, "controls.json");
+                if (fs.existsSync(ctrlFile)) {
+                    ids.add(entry.name);
+                }
+            }
+        }
+    }
+    catch {
+        // controls dir may not exist
+    }
+    return ids;
+}
+export function loadControlOverrides(projectPath) {
+    const overridesPath = path.join(projectPath, GES_DIR, OVERRIDES_FILE);
+    try {
+        const raw = fs.readFileSync(overridesPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function saveControlOverride(projectPath, controlId, status, reason) {
+    const gesDir = path.join(projectPath, GES_DIR);
+    if (!fs.existsSync(gesDir)) {
+        fs.mkdirSync(gesDir, { recursive: true });
+    }
+    const overrides = loadControlOverrides(projectPath);
+    const existingIdx = overrides.findIndex(o => o.control_id === controlId);
+    const entry = { control_id: controlId, status, reason };
+    if (existingIdx >= 0) {
+        overrides[existingIdx] = entry;
+    }
+    else {
+        overrides.push(entry);
+    }
+    const overridesPath = path.join(gesDir, OVERRIDES_FILE);
+    fs.writeFileSync(overridesPath, JSON.stringify(overrides, null, 2), "utf-8");
+}
+export function applyOverridesToControls(controls, overrides) {
+    if (overrides.length === 0)
+        return controls;
+    return controls.map(control => {
+        const override = overrides.find(o => o.control_id === control.id);
+        if (!override)
+            return control;
+        return {
+            ...control,
+            status: override.status,
+            checks: control.checks.map(check => ({ ...check, status: override.status })),
+        };
+    });
+}
+export function loadConfig(projectPath) {
+    const configPath = path.join(projectPath, GES_DIR, CONFIG_FILE);
+    try {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function addFrameworkToConfig(projectPath, framework) {
+    const configPath = path.join(projectPath, GES_DIR, CONFIG_FILE);
+    try {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(raw);
+        if (!config.frameworks)
+            config.frameworks = [];
+        const fwLower = new Set(config.frameworks.map((f) => f.toLowerCase()));
+        if (fwLower.has(framework.toLowerCase()))
+            return false;
+        config.frameworks.push(framework);
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function removeFrameworkFromConfig(projectPath, framework) {
+    const configPath = path.join(projectPath, GES_DIR, CONFIG_FILE);
+    try {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(raw);
+        if (!config.frameworks)
+            return false;
+        const before = config.frameworks.length;
+        config.frameworks = config.frameworks.filter((f) => f.toLowerCase() !== framework.toLowerCase());
+        if (config.frameworks.length === before)
+            return false;
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/index.d.ts

@@ -2,3 +2,5 @@ export * from "./types/index.js";
 export * from "./schemas/index.js";
 export * from "./constants/index.js";
 export * from "./fix-history/index.js";
+export * from "./controls/index.js";
+export * from "./activity-log/index.js";

package/dist/index.js

@@ -2,3 +2,5 @@ export * from "./types/index.js";
 export * from "./schemas/index.js";
 export * from "./constants/index.js";
 export * from "./fix-history/index.js";
+export * from "./controls/index.js";
+export * from "./activity-log/index.js";

package/dist/types/index.d.ts

@@ -190,3 +190,25 @@ export interface FixHistoryEntry {
         severity_resolved: SeverityLevel;
     };
 }
+export type ActivityAction = "init" | "audit" | "fix" | "policy_install" | "policy_remove" | "control_override" | "implement_control" | "score" | "scan" | "validate" | "generate" | "hooks_install" | "hooks_uninstall" | "dashboard_start" | "badge_generate";
+export type ActivityStatus = "success" | "partial" | "failed" | "info";
+export interface ActivityLogEntry {
+    id: string;
+    timestamp: string;
+    source: "cli" | "mcp";
+    action: ActivityAction;
+    title: string;
+    description: string;
+    status: ActivityStatus;
+    details: {
+        packs_affected?: string[];
+        controls_affected?: string[];
+        files_created?: string[];
+        files_modified?: string[];
+        findings_count?: number;
+        fixes_applied?: number;
+        score?: number;
+        frameworks_added?: string[];
+        [key: string]: unknown;
+    };
+}

package/package.json

@@ -24,7 +24,7 @@
   "name": "@greenarmor/ges-core",
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",