opencarly 1.0.0

package/README.md

@@ -0,0 +1,78 @@
+# OpenCarly
+
+**Context Augmentation & Reinforcement Layer for OpenCode**
+
+OpenCarly is an intelligent plugin for [OpenCode](https://github.com/opencode-ai/opencode) that dynamically manages your AI's context window. Instead of dumping all your rules, API guidelines, and project instructions into a single massive prompt, OpenCarly loads rules *only when they are relevant* and seamlessly trims them from the chat history when they aren't.
+
+This saves massive amounts of tokens, dramatically reduces your API costs, and keeps your AI laser-focused on the task at hand without being distracted by irrelevant guidelines.
+
+## 🚀 Features
+
+- **Dynamic Rule Injection:** Automatically injects specific instructions based on the files currently loaded in your context (e.g., injects `React` rules only when a `.tsx` file is open).
+- **Keyword Triggers:** Trigger rule injection simply by typing a keyword in your prompt (e.g., typing "*api" injects your backend API guidelines).
+- **History Trimming:** Aggressively removes injected rules from previous messages in the chat history, ensuring you only pay for the context once.
+- **Cost Estimation & Stats:** Run `*stats` at any time to see exactly how many tokens (and estimated dollars!) OpenCarly has saved you.
+
+## 📦 Installation
+
+To install OpenCarly globally, use npm:
+
+```bash
+npm install -g opencarly
+```
+
+Then, initialize OpenCarly in your project directory:
+
+```bash
+cd your-project-dir
+npx opencarly init
+```
+
+This will create an `.opencarly` configuration directory in your project containing a `config.json` file and a `rules/` folder where you can place your dynamic guidelines.
+
+## ⚙️ Configuration
+
+Open your newly created `.opencarly/config.json` to start adding rules.
+
+A rule consists of:
+- `name`: A descriptive name for the rule.
+- `files`: (Optional) An array of file globs. The rule will automatically inject if any file matching these globs is loaded in OpenCode.
+- `keywords`: (Optional) An array of keywords. The rule will inject if any of these words (prefixed with a `*`, like `*sql`) are typed in your prompt.
+- `content`: The path to the markdown file containing your instructions (relative to the `.opencarly/rules/` directory).
+
+### Example Configuration
+
+```json
+{
+  "rules": [
+    {
+      "name": "React Guidelines",
+      "files": ["**/*.tsx", "**/*.jsx", "components/**/*"],
+      "content": "react.md"
+    },
+    {
+      "name": "Database Schema",
+      "keywords": ["db", "sql", "database"],
+      "content": "schema.md"
+    }
+  ]
+}
+```
+
+With this setup:
+- Editing a `Button.tsx` file will automatically inject the rules from `react.md`.
+- Asking the AI "Please write a *sql query" will automatically inject the rules from `schema.md`.
+
+## 📊 Viewing Token Savings
+
+You can see how many tokens OpenCarly has saved you by using the built-in stats command inside OpenCode:
+
+```text
+user: *stats
+```
+
+OpenCarly will output a detailed report showing total tokens trimmed, prompts processed, and an estimated dollar amount saved based on your current AI model's input token pricing.
+
+## 📝 License
+
+MIT

package/bin/install.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+
+/**
+ * OpenCarly Installer
+ *
+ * Sets up the .opencarly/ configuration directory and registers the plugin
+ * with OpenCode.
+ *
+ * Usage:
+ *   npx opencarly              # Interactive install
+ *   npx opencarly --local      # Install to ./.opencarly/ (non-interactive)
+ *   npx opencarly --global     # Install to ~/.config/opencarly/ (non-interactive)
+ *   npx opencarly --skip-agents-md  # Don't modify AGENTS.md
+ */
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const readline = require("readline");
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+const TEMPLATES_DIR = path.join(PACKAGE_ROOT, "templates", ".opencarly");
+const COMMANDS_DIR = path.join(PACKAGE_ROOT, "commands");
+
+const AGENTS_MD_BLOCK = `
+<!-- OPENCARLY-MANAGED: Do not remove this section -->
+## OpenCarly Integration
+
+Follow all rules in <carly-rules> blocks injected into the system prompt.
+These are dynamically injected based on context and MUST be obeyed.
+They take precedence over general instructions when present.
+<!-- END OPENCARLY-MANAGED -->
+`;
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function ask(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      // Don't overwrite existing files
+      if (!fs.existsSync(destPath)) {
+        fs.copyFileSync(srcPath, destPath);
+        console.log(`  Created: ${destPath}`);
+      } else {
+        console.log(`  Skipped (exists): ${destPath}`);
+      }
+    }
+  }
+}
+
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Plugin registration
+// ---------------------------------------------------------------------------
+
+function registerPlugin(projectDir) {
+  const configPath = path.join(projectDir, "opencode.json");
+
+  let config = {};
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    } catch {
+      console.log("  Warning: Could not parse existing opencode.json, creating new one");
+      config = {};
+    }
+  }
+
+  // Add opencarly to plugin array
+  if (!config.plugin) {
+    config.plugin = [];
+  }
+
+  if (!config.plugin.includes("opencarly")) {
+    config.plugin.push("opencarly");
+  }
+
+  // Ensure $schema is set
+  if (!config.$schema) {
+    config.$schema = "https://opencode.ai/config.json";
+  }
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  console.log(`  Updated: ${configPath}`);
+}
+
+// ---------------------------------------------------------------------------
+// AGENTS.md integration
+// ---------------------------------------------------------------------------
+
+function addAgentsMdBlock(projectDir) {
+  const agentsPath = path.join(projectDir, "AGENTS.md");
+
+  if (fs.existsSync(agentsPath)) {
+    const content = fs.readFileSync(agentsPath, "utf-8");
+
+    // Check if block already exists
+    if (content.includes("OPENCARLY-MANAGED")) {
+      console.log("  Skipped AGENTS.md (OpenCarly block already present)");
+      return;
+    }
+
+    // Insert after first heading, or at the end
+    const firstHeadingMatch = content.match(/^#[^#].+$/m);
+    let newContent;
+    if (firstHeadingMatch) {
+      const insertPos = content.indexOf(firstHeadingMatch[0]) + firstHeadingMatch[0].length;
+      newContent =
+        content.slice(0, insertPos) +
+        "\n" +
+        AGENTS_MD_BLOCK +
+        content.slice(insertPos);
+    } else {
+      newContent = content + "\n" + AGENTS_MD_BLOCK;
+    }
+
+    fs.writeFileSync(agentsPath, newContent, "utf-8");
+    console.log(`  Updated: ${agentsPath}`);
+  } else {
+    // Create AGENTS.md with the block
+    fs.writeFileSync(
+      agentsPath,
+      `# Project Instructions\n${AGENTS_MD_BLOCK}`,
+      "utf-8"
+    );
+    console.log(`  Created: ${agentsPath}`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Install custom commands
+// ---------------------------------------------------------------------------
+
+function installCommands(projectDir) {
+  const destDir = path.join(projectDir, ".opencode", "commands");
+  ensureDir(destDir);
+
+  if (fs.existsSync(COMMANDS_DIR)) {
+    const files = fs.readdirSync(COMMANDS_DIR);
+    for (const file of files) {
+      const srcPath = path.join(COMMANDS_DIR, file);
+      const destPath = path.join(destDir, file);
+
+      if (!fs.existsSync(destPath)) {
+        fs.copyFileSync(srcPath, destPath);
+        console.log(`  Created: ${destPath}`);
+      } else {
+        console.log(`  Skipped (exists): ${destPath}`);
+      }
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  const isGlobal = args.includes("--global") || args.includes("-g");
+  const isLocal = args.includes("--local") || args.includes("-l");
+  const skipAgentsMd = args.includes("--skip-agents-md");
+  const showHelp = args.includes("--help") || args.includes("-h");
+
+  if (showHelp) {
+    console.log(`
+OpenCarly Installer - Dynamic rules for OpenCode
+
+Usage:
+  npx opencarly              Interactive install
+  npx opencarly --local      Install to ./.opencarly/ (non-interactive)
+  npx opencarly --global     Install to ~/.config/opencarly/ (non-interactive)
+
+Options:
+  --local, -l           Install to current project directory
+  --global, -g          Install to global config directory
+  --skip-agents-md      Don't modify AGENTS.md
+  --help, -h            Show this help message
+`);
+    process.exit(0);
+  }
+
+  console.log("");
+  console.log("  OpenCarly - Context Augmentation & Reinforcement Layer for OpenCode");
+  console.log("  Dynamic rules that load when relevant, disappear when not.");
+  console.log("");
+
+  let installScope;
+  let addBlock = !skipAgentsMd;
+
+  if (isGlobal) {
+    installScope = "global";
+  } else if (isLocal) {
+    installScope = "local";
+  } else {
+    // Interactive mode
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    const scopeAnswer = await ask(
+      rl,
+      "  Install location?\n    1) Local (this project only - ./.opencarly/)\n    2) Global (all projects - ~/.config/opencarly/)\n  Choice [1]: "
+    );
+    installScope = scopeAnswer === "2" ? "global" : "local";
+
+    if (!skipAgentsMd) {
+      const agentsAnswer = await ask(
+        rl,
+        "  Add OpenCarly integration block to AGENTS.md? [Y/n]: "
+      );
+      addBlock = agentsAnswer.toLowerCase() !== "n";
+    }
+
+    rl.close();
+  }
+
+  const cwd = process.cwd();
+  const targetDir =
+    installScope === "global"
+      ? path.join(os.homedir(), ".config", "opencarly")
+      : path.join(cwd, ".opencarly");
+
+  console.log("");
+  console.log(`  Installing to: ${targetDir}`);
+  console.log("");
+
+  // 1. Copy templates
+  console.log("  [1/4] Copying configuration templates...");
+  copyDirRecursive(TEMPLATES_DIR, targetDir);
+
+  // 2. Create sessions directory
+  const sessionsDir = path.join(targetDir, "sessions");
+  ensureDir(sessionsDir);
+  const gitkeep = path.join(sessionsDir, ".gitkeep");
+  if (!fs.existsSync(gitkeep)) {
+    fs.writeFileSync(gitkeep, "", "utf-8");
+  }
+
+  // 3. Register plugin in opencode.json
+  console.log("  [2/4] Registering plugin in opencode.json...");
+  registerPlugin(cwd);
+
+  // 4. Add AGENTS.md block
+  if (addBlock) {
+    console.log("  [3/4] Adding integration block to AGENTS.md...");
+    addAgentsMdBlock(cwd);
+  } else {
+    console.log("  [3/4] Skipping AGENTS.md modification");
+  }
+
+  // 5. Install custom commands
+  console.log("  [4/4] Installing custom commands...");
+  installCommands(cwd);
+
+  console.log("");
+  console.log("  OpenCarly installed successfully!");
+  console.log("");
+  console.log("  Configuration: " + targetDir);
+  console.log("  Edit manifest:  " + path.join(targetDir, "manifest.json"));
+  console.log("  Edit commands:  " + path.join(targetDir, "commands.json"));
+  console.log("  Edit brackets:  " + path.join(targetDir, "context.json"));
+  console.log("  Add domains:    " + path.join(targetDir, "domains/"));
+  console.log("");
+  console.log("  Quick start:");
+  console.log("    Type *carly in OpenCode for an interactive guide");
+  console.log("    Type *dev, *brief, *plan, etc. for star-commands");
+  console.log("    Run /carly for domain management");
+  console.log("");
+}
+
+main().catch((err) => {
+  console.error("Installation failed:", err.message);
+  process.exit(1);
+});

package/commands/carly-manager.md

@@ -0,0 +1,69 @@
+---
+description: Manage OpenCarly domains, commands, and settings
+---
+
+You are now acting as the OpenCarly Configuration Manager.
+
+## Your Job
+
+Help the user manage their OpenCarly configuration. OpenCarly is a dynamic rule injection system - it loads rules into the AI's context based on what the user is doing.
+
+## Configuration Files
+
+All config lives in the `.opencarly/` directory:
+- **manifest.json** - Domain registry and global settings
+- **commands.json** - Star-command definitions (*dev, *brief, etc.)
+- **context.json** - Context bracket thresholds and rules
+- **domains/*.md** - Rule files (one per domain, rules as `- bullet points`)
+- **sessions/*.json** - Auto-generated per-session state (don't edit manually)
+
+## What the User Can Ask You To Do
+
+1. **Show status**: Read manifest.json and show all domains, their states, and recall keywords
+2. **Toggle domain**: Change a domain's `state` between "active" and "inactive" in manifest.json
+3. **Create domain**: Create a new .md rule file in domains/ and add the domain entry to manifest.json
+4. **Edit rules**: Add, remove, or modify rules in a domain's .md file
+5. **Toggle DEVMODE**: Set `devmode` to true/false in manifest.json
+6. **Create star-command**: Add a new command to commands.json
+7. **Edit star-command**: Modify rules for an existing command in commands.json
+8. **Edit context brackets**: Modify thresholds or rules in context.json
+9. **Show session info**: Read the current session file from sessions/
+
+## How to Respond
+
+First, read the current `.opencarly/manifest.json` to understand the current configuration.
+
+If the user says "$ARGUMENTS", interpret that as their specific request. If no arguments, show the current status overview:
+- List all domains with state, alwaysOn flag, and recall keywords
+- Show whether DEVMODE is on/off
+- Show whether commands and context systems are active
+- List available star-commands
+
+Always make changes by editing the actual files. Confirm what you changed.
+
+## Domain .md File Format
+
+Rules are bullet points:
+```markdown
+# Domain Name Rules
+
+Optional description text.
+
+- First rule
+- Second rule
+- Third rule
+```
+
+## manifest.json Domain Entry Format
+
+```json
+{
+  "domain-name": {
+    "state": "active",
+    "alwaysOn": false,
+    "recall": ["keyword1", "keyword2"],
+    "exclude": [],
+    "file": "domains/domain-name.md"
+  }
+}
+```

package/dist/config/discovery.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenCarly Config Discovery
+ *
+ * Finds the .opencarly/ configuration directory by:
+ * 1. Walking up from cwd looking for a local .opencarly/ with a manifest.json
+ * 2. Falling back to ~/.config/opencarly/ (global config)
+ */
+export interface DiscoveryResult {
+    /** Absolute path to the .opencarly/ directory */
+    configPath: string;
+    /** Whether this is a local or global config */
+    scope: "local" | "global";
+}
+/**
+ * Discover the .opencarly/ configuration directory.
+ *
+ * Walks up from `startDir` looking for a `.opencarly/manifest.json`.
+ * Falls back to `~/.config/opencarly/manifest.json`.
+ * Returns null if no config found anywhere.
+ */
+export declare function discoverConfig(startDir: string): DiscoveryResult | null;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/config/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/config/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAyBvE"}

package/dist/config/discovery.js

@@ -0,0 +1,43 @@
+/**
+ * OpenCarly Config Discovery
+ *
+ * Finds the .opencarly/ configuration directory by:
+ * 1. Walking up from cwd looking for a local .opencarly/ with a manifest.json
+ * 2. Falling back to ~/.config/opencarly/ (global config)
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const CONFIG_DIR_NAME = ".opencarly";
+const MANIFEST_FILE = "manifest.json";
+const MAX_WALK_DEPTH = 10;
+/**
+ * Discover the .opencarly/ configuration directory.
+ *
+ * Walks up from `startDir` looking for a `.opencarly/manifest.json`.
+ * Falls back to `~/.config/opencarly/manifest.json`.
+ * Returns null if no config found anywhere.
+ */
+export function discoverConfig(startDir) {
+    // 1. Walk up from startDir looking for local .opencarly/
+    let current = path.resolve(startDir);
+    for (let i = 0; i < MAX_WALK_DEPTH; i++) {
+        const candidate = path.join(current, CONFIG_DIR_NAME);
+        const manifestPath = path.join(candidate, MANIFEST_FILE);
+        if (fs.existsSync(manifestPath)) {
+            return { configPath: candidate, scope: "local" };
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break; // reached filesystem root
+        current = parent;
+    }
+    // 2. Check global config
+    const globalConfig = path.join(os.homedir(), ".config", "opencarly");
+    const globalManifest = path.join(globalConfig, MANIFEST_FILE);
+    if (fs.existsSync(globalManifest)) {
+        return { configPath: globalConfig, scope: "global" };
+    }
+    return null;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/config/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/config/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,eAAe,GAAG,YAAY,CAAC;AACrC,MAAM,aAAa,GAAG,eAAe,CAAC;AACtC,MAAM,cAAc,GAAG,EAAE,CAAC;AAU1B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,yDAAyD;IACzD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAEzD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM,CAAC,0BAA0B;QACzD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,yBAAyB;IACzB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAE9D,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Config module exports
+ */
+export { discoverConfig, type DiscoveryResult } from "./discovery";
+export { loadConfig, reloadConfig, parseDomainFile, type CarlyConfig } from "./manifest";
+export { ManifestSchema, DomainConfigSchema, CommandsFileSchema, StarCommandSchema, ContextFileSchema, ContextBracketSchema, TrimmingConfigSchema, StatsConfigSchema, TRIM_THRESHOLDS, TokenStatsSchema, CumulativeStatsSchema, CumulativeSessionSummarySchema, SessionConfigSchema, SessionOverrideSchema, type Manifest, type DomainConfig, type CommandsFile, type StarCommand, type ContextFile, type ContextBracket, type TrimmingConfig, type StatsConfig, type TokenStats, type CumulativeStats, type CumulativeSessionSummary, type SessionConfig, type SessionOverride, type BracketName, } from "./schema";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,7 @@
+/**
+ * Config module exports
+ */
+export { discoverConfig } from "./discovery";
+export { loadConfig, reloadConfig, parseDomainFile } from "./manifest";
+export { ManifestSchema, DomainConfigSchema, CommandsFileSchema, StarCommandSchema, ContextFileSchema, ContextBracketSchema, TrimmingConfigSchema, StatsConfigSchema, TRIM_THRESHOLDS, TokenStatsSchema, CumulativeStatsSchema, CumulativeSessionSummarySchema, SessionConfigSchema, SessionOverrideSchema, } from "./schema";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAwB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAoB,MAAM,YAAY,CAAC;AACzF,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,qBAAqB,GAetB,MAAM,UAAU,CAAC"}

package/dist/config/manifest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 { type Manifest, type CommandsFile, type ContextFile } from "./schema";
+export interface CarlyConfig {
+    /** Parsed and validated manifest */
+    manifest: Manifest;
+    /** Parsed and validated star-commands (empty object if commands.json missing) */
+    commands: CommandsFile;
+    /** Parsed and validated context brackets (defaults if context.json missing) */
+    context: ContextFile;
+    /** Absolute path to the .opencarly/ directory */
+    configPath: string;
+    /** Non-fatal warnings encountered during config loading */
+    warnings: string[];
+}
+/**
+ * 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 declare function loadConfig(configPath: string): CarlyConfig;
+/**
+ * Parse a domain rule file (.md).
+ *
+ * Extracts rules from bullet points (lines starting with "- ").
+ * Ignores headings (#), empty lines, and other markdown.
+ */
+export declare function parseDomainFile(filePath: string): string[];
+/**
+ * Reload config from disk. Used when config might have changed
+ * (e.g., user edited manifest.json via /carly command).
+ */
+export declare function reloadConfig(configPath: string): CarlyConfig;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/config/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/config/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IAEnB,iFAAiF;IACjF,QAAQ,EAAE,YAAY,CAAC;IAEvB,+EAA+E;IAC/E,OAAO,EAAE,WAAW,CAAC;IAErB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IAEnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA0BD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAmF1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAE5D"}