opencarly 1.0.0

package/dist/config/manifest.js

@@ -0,0 +1,139 @@
+/**
+ * OpenCarly Config Loader
+ *
+ * Parses and validates manifest.json, commands.json, and context.json
+ * from the discovered .opencarly/ directory.
+ * Collects warnings for non-fatal issues instead of silently ignoring them.
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { ZodError } from "zod";
+import { ManifestSchema, CommandsFileSchema, ContextFileSchema, } from "./schema";
+/**
+ * Read and parse a JSON file. Returns null if file doesn't exist.
+ * Throws on invalid JSON.
+ */
+function readJsonFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const raw = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+}
+/**
+ * Format Zod errors into human-readable messages.
+ */
+function formatZodErrors(error) {
+    return error.issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+        return `  ${path}: ${issue.message}`;
+    })
+        .join("\n");
+}
+/**
+ * Load all configuration from a .opencarly/ directory.
+ * Validates against Zod schemas. Collects warnings for non-fatal issues.
+ * Throws only when manifest.json is missing entirely.
+ */
+export function loadConfig(configPath) {
+    const warnings = [];
+    // manifest.json (required)
+    const manifestPath = path.join(configPath, "manifest.json");
+    const manifestRaw = readJsonFile(manifestPath);
+    if (manifestRaw === null) {
+        throw new Error(`OpenCarly: manifest.json not found at ${manifestPath}`);
+    }
+    let manifest;
+    try {
+        manifest = ManifestSchema.parse(manifestRaw);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            throw new Error(`OpenCarly: manifest.json validation failed:\n${formatZodErrors(err)}`);
+        }
+        throw err;
+    }
+    // Validate domain file references exist
+    for (const [name, domain] of Object.entries(manifest.domains)) {
+        const domainFilePath = path.join(configPath, domain.file);
+        if (!fs.existsSync(domainFilePath)) {
+            warnings.push(`Domain "${name}" references file "${domain.file}" which does not exist`);
+        }
+    }
+    // commands.json (optional - defaults to empty)
+    const commandsPath = path.join(configPath, "commands.json");
+    let commands = {};
+    const commandsRaw = readJsonFile(commandsPath);
+    if (commandsRaw !== null) {
+        try {
+            commands = CommandsFileSchema.parse(commandsRaw);
+        }
+        catch (err) {
+            if (err instanceof ZodError) {
+                warnings.push(`commands.json has validation errors (using defaults):\n${formatZodErrors(err)}`);
+            }
+            else if (err instanceof SyntaxError) {
+                warnings.push(`commands.json has invalid JSON syntax (using defaults)`);
+            }
+        }
+    }
+    // context.json (optional - defaults to empty with default thresholds)
+    const contextPath = path.join(configPath, "context.json");
+    let context = ContextFileSchema.parse({});
+    const contextRaw = readJsonFile(contextPath);
+    if (contextRaw !== null) {
+        try {
+            context = ContextFileSchema.parse(contextRaw);
+        }
+        catch (err) {
+            if (err instanceof ZodError) {
+                warnings.push(`context.json has validation errors (using defaults):\n${formatZodErrors(err)}`);
+            }
+            else if (err instanceof SyntaxError) {
+                warnings.push(`context.json has invalid JSON syntax (using defaults)`);
+            }
+        }
+    }
+    // Validate context thresholds make sense
+    if (context.thresholds.moderate >= context.thresholds.depleted) {
+        warnings.push(`context.json: moderate threshold (${context.thresholds.moderate}) should be less than depleted (${context.thresholds.depleted})`);
+    }
+    if (context.thresholds.depleted >= context.thresholds.critical) {
+        warnings.push(`context.json: depleted threshold (${context.thresholds.depleted}) should be less than critical (${context.thresholds.critical})`);
+    }
+    return { manifest, commands, context, configPath, warnings };
+}
+/**
+ * Parse a domain rule file (.md).
+ *
+ * Extracts rules from bullet points (lines starting with "- ").
+ * Ignores headings (#), empty lines, and other markdown.
+ */
+export function parseDomainFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const rules = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === "")
+            continue;
+        if (trimmed.startsWith("#"))
+            continue;
+        if (trimmed.startsWith("- ")) {
+            rules.push(trimmed.slice(2).trim());
+        }
+    }
+    return rules;
+}
+/**
+ * Reload config from disk. Used when config might have changed
+ * (e.g., user edited manifest.json via /carly command).
+ */
+export function reloadConfig(configPath) {
+    return loadConfig(configPath);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/config/manifest.js.map

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