cc-agent-harness 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KwokJay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,236 @@
+<p align="center"><code>npm install -g cc-agent-harness</code></p>
+<p align="center"><strong>cc-agent-harness</strong> is a vendor-neutral CLI and TypeScript toolkit for AI-assisted development workflows.</p>
+<p align="center"><a href="./README.md">English</a> | <a href="./README.zh-CN.md">简体中文</a></p>
+
+It helps teams standardize project setup, `AGENTS.md` generation, skill discovery, health checks, and verification pipelines without locking into a single model vendor or agent framework.
+
+---
+
+## Quickstart
+
+### Install and run
+
+Install globally with npm:
+
+```shell
+npm install -g cc-agent-harness
+```
+
+Then initialize a project with the `agent-harness` CLI:
+
+```shell
+agent-harness setup
+agent-harness doctor
+agent-harness verify
+```
+
+### Develop from source
+
+This repository targets `Node >=22` and uses `pnpm` for local development.
+
+```shell
+pnpm install
+pnpm build
+pnpm test
+pnpm lint
+```
+
+## What It Does
+
+- Generates a consistent `.harness/` project scaffold and `AGENTS.md` from templates.
+- Loads layered YAML configuration and validates it with Zod.
+- Routes agent/model tiers through vendor-neutral `low` / `medium` / `high` mappings.
+- Discovers, validates, and scaffolds reusable project skills.
+- Detects project type and resolves verification commands for TypeScript, Python, and Rust.
+- Runs project health checks plus configurable verification pipelines like build, test, and lint.
+- Assembles reusable agent context from hierarchical `AGENTS.md`, custom rules, and discovered skills.
+- Exposes lifecycle hooks, audit logging, and feature observability through the main CLI.
+- Exposes the same primitives as a TypeScript library for deeper integration.
+
+## Common Commands
+
+| Command | Description |
+|---------|-------------|
+| `agent-harness setup` | Initialize `.harness/` and generate `AGENTS.md` |
+| `agent-harness update` | Sync templates and configuration |
+| `agent-harness doctor` | Run health checks for the current project |
+| `agent-harness doctor --json` | Output machine-readable health results |
+| `agent-harness verify` | Execute the configured verification pipeline |
+| `agent-harness verify --json` | Output machine-readable verification results |
+| `agent-harness run <task>` | Run a named workflow or adapter command |
+| `agent-harness context build` | Build reusable agent context from project docs and skills |
+| `agent-harness list <resource>` | List `skills`, `agents`, `commands`, `templates`, or `features` |
+| `agent-harness config show` | Print merged configuration |
+| `agent-harness config validate` | Validate config files |
+| `agent-harness schema generate` | Generate JSON Schema for the config |
+| `agent-harness scaffold skill <name>` | Create a new skill scaffold |
+
+## Configuration
+
+Project config lives at `.harness/harness.config.yaml`. Optional user-level defaults can live at `~/.harness/config.yaml`.
+
+```yaml
+project:
+  name: my-project
+  language: typescript
+  description: "My AI-assisted project"
+
+agents:
+  delegation_first: true
+  model_routing:
+    low: low
+    medium: medium
+    high: high
+  providers:
+    low: "gpt-4o-mini"
+    medium: "claude-sonnet-4-20250514"
+    high: "o3"
+  definitions: []
+
+skills:
+  directories:
+    - ".harness/skills"
+  auto_detect: true
+
+workflows:
+  commands:
+    build: "npm run build"
+    test: "npm test"
+    lint: "npm run lint"
+  verification:
+    checks: ["build", "test", "lint"]
+
+templates:
+  agents_md:
+    variant: standard
+    custom_rules: []
+```
+
+### Model Tiers
+
+`cc-agent-harness` keeps model routing vendor-neutral. Agents and workflows use `low`, `medium`, and `high`, while `providers` maps those tiers to concrete model IDs.
+
+```yaml
+agents:
+  providers:
+    low: "gpt-4o-mini"
+    medium: "claude-sonnet-4-20250514"
+    high: "o3"
+```
+
+## Programmatic API
+
+```typescript
+import {
+  HarnessRuntime,
+  loadConfig,
+  AgentRegistry,
+  discoverSkills,
+  routeModel,
+  inferComplexity,
+  runHealthChecks,
+  render,
+} from "cc-agent-harness";
+
+const config = await loadConfig();
+const runtime = await HarnessRuntime.create();
+const registry = new AgentRegistry(config.agents.definitions);
+const agent = registry.get("executor");
+const tier = routeModel(
+  inferComplexity("refactor the auth module"),
+  config.agents.model_routing,
+);
+const skills = await discoverSkills(config.skills.directories);
+const report = await runHealthChecks([]);
+const context = await runtime.buildContext({ tagStyle: "xml" });
+const output = render("Hello {{name}}", { name: "World" });
+```
+
+## Built-in Adapters
+
+Built-in adapters detect the current project and provide default commands and checks.
+
+| Adapter | Detection | Typical commands |
+|---------|-----------|------------------|
+| TypeScript | `tsconfig.json` or `package.json` | `build`, `test`, `lint` |
+| Python | `pyproject.toml`, `setup.py`, or `requirements.txt` | `test`, `lint`, `fmt` |
+| Rust | `Cargo.toml` | `fmt`, `test`, `clippy`, `build` |
+
+## Skills
+
+Skills are directories containing a `SKILL.md` file with YAML frontmatter.
+
+```markdown
+---
+name: my-skill
+description: What this skill does
+---
+
+# My Skill
+
+Usage instructions here.
+```
+
+Create one with:
+
+```shell
+agent-harness scaffold skill my-skill -d "Description of the skill"
+```
+
+## Context Assembly
+
+Build reusable prompt context from hierarchical `AGENTS.md` files, configured custom rules, and discovered skills:
+
+```shell
+agent-harness context build
+agent-harness context build --format xml
+agent-harness context build --output .harness/context.md
+```
+
+This is useful when integrating with IDE agents, external runners, or any workflow that needs a stable context artifact.
+
+## Package And CLI
+
+- npm package: `cc-agent-harness`
+- CLI command: `agent-harness`
+
+## Architecture
+
+Generated project structure:
+
+```text
+.harness/
+  harness.config.yaml
+  skills/
+AGENTS.md
+```
+
+Core source layout:
+
+```text
+src/
+  config/        Schema, defaults, layered config loading
+  agent/         Agent registry and model tier routing
+  adapter/       Project type detection and language adapters
+  skill/         Skill discovery, validation, scaffolding
+  health/        Health checks and reporting
+  template/      Template rendering and file generation
+  hook/          Lifecycle hook discovery and dispatch
+  feature/       Feature registry
+  plugin/        Plugin interface and registry
+  context/       Context assembly pipeline
+  audit/         Append-only audit logging
+  cli/           Command implementations
+```
+
+## Docs
+
+- [`docs/getting-started.md`](./docs/getting-started.md)
+- [`docs/architecture.md`](./docs/architecture.md)
+- [`docs/config-reference.md`](./docs/config-reference.md)
+- [`docs/adapter-guide.md`](./docs/adapter-guide.md)
+- [`docs/plugin-guide.md`](./docs/plugin-guide.md)
+
+## License
+
+Licensed under the [MIT License](./LICENSE).

package/README.zh-CN.md

@@ -0,0 +1,236 @@
+<p align="center"><code>npm install -g cc-agent-harness</code></p>
+<p align="center"><strong>cc-agent-harness</strong> 是一个面向 AI 辅助开发工作流的、厂商中立的 CLI 与 TypeScript 工具包。</p>
+<p align="center"><a href="./README.md">English</a> | <a href="./README.zh-CN.md">简体中文</a></p>
+
+它帮助团队统一项目初始化、`AGENTS.md` 生成、技能发现、健康检查和验证流水线，同时避免被某一家模型供应商或某一种 agent 框架绑定。
+
+---
+
+## 快速开始
+
+### 安装并使用
+
+使用 npm 全局安装：
+
+```shell
+npm install -g cc-agent-harness
+```
+
+安装后使用 `agent-harness` CLI 进入项目初始化：
+
+```shell
+agent-harness setup
+agent-harness doctor
+agent-harness verify
+```
+
+### 从源码开发
+
+本仓库要求 `Node >=22`，本地开发使用 `pnpm`。
+
+```shell
+pnpm install
+pnpm build
+pnpm test
+pnpm lint
+```
+
+## 它能做什么
+
+- 生成统一的 `.harness/` 项目骨架，并按模板产出 `AGENTS.md`。
+- 加载分层 YAML 配置，并通过 Zod 做结构校验。
+- 使用厂商中立的 `low` / `medium` / `high` 档位路由 agent 与模型。
+- 发现、校验并脚手架化可复用技能。
+- 检测当前项目类型，并为 TypeScript、Python、Rust 提供默认验证命令。
+- 执行项目健康检查，以及可配置的 build、test、lint 验证流水线。
+- 基于分层 `AGENTS.md`、自定义规则和本地技能构建可复用上下文。
+- 在主 CLI 中暴露 hooks、审计日志和 feature 可观测能力。
+- 以 TypeScript 库形式暴露同一套能力，便于程序化集成。
+
+## 常用命令
+
+| 命令 | 说明 |
+|------|------|
+| `agent-harness setup` | 初始化 `.harness/` 并生成 `AGENTS.md` |
+| `agent-harness update` | 同步模板和配置 |
+| `agent-harness doctor` | 对当前项目执行健康检查 |
+| `agent-harness doctor --json` | 输出机器可读的健康检查结果 |
+| `agent-harness verify` | 运行配置好的验证流水线 |
+| `agent-harness verify --json` | 输出机器可读的验证结果 |
+| `agent-harness run <task>` | 执行命名工作流或适配器提供的命令 |
+| `agent-harness context build` | 构建可复用的 agent 上下文 |
+| `agent-harness list <resource>` | 列出 `skills`、`agents`、`commands`、`templates` 或 `features` |
+| `agent-harness config show` | 输出合并后的配置 |
+| `agent-harness config validate` | 校验配置文件是否合法 |
+| `agent-harness schema generate` | 生成配置对应的 JSON Schema |
+| `agent-harness scaffold skill <name>` | 创建一个新的 skill 脚手架 |
+
+## 配置
+
+项目级配置位于 `.harness/harness.config.yaml`，可选的用户级默认配置位于 `~/.harness/config.yaml`。
+
+```yaml
+project:
+  name: my-project
+  language: typescript
+  description: "My AI-assisted project"
+
+agents:
+  delegation_first: true
+  model_routing:
+    low: low
+    medium: medium
+    high: high
+  providers:
+    low: "gpt-4o-mini"
+    medium: "claude-sonnet-4-20250514"
+    high: "o3"
+  definitions: []
+
+skills:
+  directories:
+    - ".harness/skills"
+  auto_detect: true
+
+workflows:
+  commands:
+    build: "npm run build"
+    test: "npm test"
+    lint: "npm run lint"
+  verification:
+    checks: ["build", "test", "lint"]
+
+templates:
+  agents_md:
+    variant: standard
+    custom_rules: []
+```
+
+### 模型档位
+
+`cc-agent-harness` 的模型路由是厂商中立的。agent 和工作流只感知 `low`、`medium`、`high` 三个档位，`providers` 负责把这些档位映射到真实模型 ID。
+
+```yaml
+agents:
+  providers:
+    low: "gpt-4o-mini"
+    medium: "claude-sonnet-4-20250514"
+    high: "o3"
+```
+
+## 程序化 API
+
+```typescript
+import {
+  HarnessRuntime,
+  loadConfig,
+  AgentRegistry,
+  discoverSkills,
+  routeModel,
+  inferComplexity,
+  runHealthChecks,
+  render,
+} from "cc-agent-harness";
+
+const config = await loadConfig();
+const runtime = await HarnessRuntime.create();
+const registry = new AgentRegistry(config.agents.definitions);
+const agent = registry.get("executor");
+const tier = routeModel(
+  inferComplexity("refactor the auth module"),
+  config.agents.model_routing,
+);
+const skills = await discoverSkills(config.skills.directories);
+const report = await runHealthChecks([]);
+const context = await runtime.buildContext({ tagStyle: "xml" });
+const output = render("Hello {{name}}", { name: "World" });
+```
+
+## 内置适配器
+
+内置适配器会自动检测项目类型，并提供默认命令和健康检查。
+
+| 适配器 | 检测方式 | 常见命令 |
+|--------|----------|----------|
+| TypeScript | `tsconfig.json` 或 `package.json` | `build`、`test`、`lint` |
+| Python | `pyproject.toml`、`setup.py` 或 `requirements.txt` | `test`、`lint`、`fmt` |
+| Rust | `Cargo.toml` | `fmt`、`test`、`clippy`、`build` |
+
+## Skills
+
+Skill 是一个包含 `SKILL.md` 文件的目录，文件头使用 YAML frontmatter：
+
+```markdown
+---
+name: my-skill
+description: What this skill does
+---
+
+# My Skill
+
+Usage instructions here.
+```
+
+可通过下面的命令快速创建：
+
+```shell
+agent-harness scaffold skill my-skill -d "Description of the skill"
+```
+
+## 上下文构建
+
+你可以基于分层 `AGENTS.md`、配置里的自定义规则和发现到的技能，构建可复用的上下文产物：
+
+```shell
+agent-harness context build
+agent-harness context build --format xml
+agent-harness context build --output .harness/context.md
+```
+
+这对 IDE agent、外部执行器，以及任何需要稳定上下文输入的工作流都很有用。
+
+## 包名与命令名
+
+- npm 包名：`cc-agent-harness`
+- CLI 命令：`agent-harness`
+
+## 架构概览
+
+生成后的项目结构：
+
+```text
+.harness/
+  harness.config.yaml
+  skills/
+AGENTS.md
+```
+
+核心源码结构：
+
+```text
+src/
+  config/        Schema、默认值、分层配置加载
+  agent/         Agent 注册表与模型档位路由
+  adapter/       项目类型检测与语言适配器
+  skill/         Skill 发现、校验、脚手架
+  health/        健康检查与报告
+  template/      模板渲染与文件生成
+  hook/          生命周期 Hook 发现与分发
+  feature/       Feature 注册表
+  plugin/        插件接口与注册表
+  context/       上下文组装流水线
+  audit/         追加写入式审计日志
+  cli/           CLI 命令实现
+```
+
+## 文档
+
+- [`docs/getting-started.md`](./docs/getting-started.md)
+- [`docs/architecture.md`](./docs/architecture.md)
+- [`docs/config-reference.md`](./docs/config-reference.md)
+- [`docs/adapter-guide.md`](./docs/adapter-guide.md)
+- [`docs/plugin-guide.md`](./docs/plugin-guide.md)
+
+## License
+
+基于 [MIT License](./LICENSE) 开源。

package/dist/chunk-3P72TGGQ.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import {
+  harnessConfigSchema
+} from "./chunk-LOE6IDTT.js";
+
+// src/config/loader.ts
+import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { resolve, join } from "path";
+import { homedir } from "os";
+import { parse as parseYaml } from "yaml";
+var PROJECT_CONFIG_PATH = ".harness/harness.config.yaml";
+var USER_CONFIG_PATH = ".harness/config.yaml";
+async function readYamlFile(path) {
+  if (!existsSync(path)) return null;
+  const content = await readFile(path, "utf-8");
+  return parseYaml(content) ?? null;
+}
+function deepMerge(base, override) {
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    const bVal = base[key];
+    const oVal = override[key];
+    if (bVal && oVal && typeof bVal === "object" && typeof oVal === "object" && !Array.isArray(bVal) && !Array.isArray(oVal)) {
+      result[key] = deepMerge(
+        bVal,
+        oVal
+      );
+    } else {
+      result[key] = oVal;
+    }
+  }
+  return result;
+}
+async function loadConfig(opts) {
+  const result = await loadConfigWithLayers(opts);
+  return result.config;
+}
+async function loadConfigWithLayers(opts) {
+  const cwd = opts?.cwd ?? process.cwd();
+  const layers = [];
+  const userPath = join(homedir(), USER_CONFIG_PATH);
+  const userData = await readYamlFile(userPath);
+  layers.push({ name: "user", path: userPath, data: userData });
+  const projectPath = resolve(cwd, PROJECT_CONFIG_PATH);
+  const projectData = await readYamlFile(projectPath);
+  layers.push({ name: "project", path: projectPath, data: projectData });
+  if (opts?.extraLayers) {
+    layers.push(...opts.extraLayers);
+  }
+  let merged = {};
+  for (const layer of layers) {
+    if (layer.data) {
+      merged = deepMerge(merged, layer.data);
+    }
+  }
+  const config = harnessConfigSchema.parse(merged);
+  return { config, layers };
+}
+function configExists(cwd) {
+  return anyConfigExists(cwd);
+}
+function projectConfigExists(cwd) {
+  const dir = cwd ?? process.cwd();
+  return existsSync(resolve(dir, PROJECT_CONFIG_PATH));
+}
+function userConfigExists() {
+  return existsSync(join(homedir(), USER_CONFIG_PATH));
+}
+function anyConfigExists(cwd) {
+  return projectConfigExists(cwd) || userConfigExists();
+}
+
+export {
+  loadConfig,
+  loadConfigWithLayers,
+  configExists,
+  projectConfigExists,
+  userConfigExists,
+  anyConfigExists
+};
+//# sourceMappingURL=chunk-3P72TGGQ.js.map

package/dist/chunk-3P72TGGQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/loader.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { resolve, join } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { parse as parseYaml } from \"yaml\";\nimport { harnessConfigSchema, type HarnessConfig } from \"./schema.js\";\n\nexport type { HarnessConfig };\n\nconst PROJECT_CONFIG_PATH = \".harness/harness.config.yaml\";\nconst USER_CONFIG_PATH = \".harness/config.yaml\";\n\nexport interface ConfigLayer {\n  name: string;\n  path: string;\n  data: Record<string, unknown> | null;\n}\n\nexport interface LoadConfigOptions {\n  cwd?: string;\n  extraLayers?: ConfigLayer[];\n}\n\nexport interface LoadConfigResult {\n  config: HarnessConfig;\n  layers: ConfigLayer[];\n}\n\nasync function readYamlFile(path: string): Promise<Record<string, unknown> | null> {\n  if (!existsSync(path)) return null;\n  const content = await readFile(path, \"utf-8\");\n  return (parseYaml(content) as Record<string, unknown>) ?? null;\n}\n\nfunction deepMerge(\n  base: Record<string, unknown>,\n  override: Record<string, unknown>,\n): Record<string, unknown> {\n  const result = { ...base };\n  for (const key of Object.keys(override)) {\n    const bVal = base[key];\n    const oVal = override[key];\n    if (\n      bVal &&\n      oVal &&\n      typeof bVal === \"object\" &&\n      typeof oVal === \"object\" &&\n      !Array.isArray(bVal) &&\n      !Array.isArray(oVal)\n    ) {\n      result[key] = deepMerge(\n        bVal as Record<string, unknown>,\n        oVal as Record<string, unknown>,\n      );\n    } else {\n      result[key] = oVal;\n    }\n  }\n  return result;\n}\n\n/**\n * Load harness configuration with N-layer merge and source tracking.\n *\n * Default layer order (lowest to highest priority):\n * 1. Built-in defaults (via Zod schema defaults)\n * 2. User-level (~/.harness/config.yaml)\n * 3. Project-level (.harness/harness.config.yaml)\n * 4. Extra layers (programmatic overrides)\n */\nexport async function loadConfig(opts?: LoadConfigOptions): Promise<HarnessConfig> {\n  const result = await loadConfigWithLayers(opts);\n  return result.config;\n}\n\nexport async function loadConfigWithLayers(opts?: LoadConfigOptions): Promise<LoadConfigResult> {\n  const cwd = opts?.cwd ?? process.cwd();\n\n  const layers: ConfigLayer[] = [];\n\n  const userPath = join(homedir(), USER_CONFIG_PATH);\n  const userData = await readYamlFile(userPath);\n  layers.push({ name: \"user\", path: userPath, data: userData });\n\n  const projectPath = resolve(cwd, PROJECT_CONFIG_PATH);\n  const projectData = await readYamlFile(projectPath);\n  layers.push({ name: \"project\", path: projectPath, data: projectData });\n\n  if (opts?.extraLayers) {\n    layers.push(...opts.extraLayers);\n  }\n\n  let merged: Record<string, unknown> = {};\n  for (const layer of layers) {\n    if (layer.data) {\n      merged = deepMerge(merged, layer.data);\n    }\n  }\n\n  const config = harnessConfigSchema.parse(merged);\n  return { config, layers };\n}\n\nexport function configExists(cwd?: string): boolean {\n  return anyConfigExists(cwd);\n}\n\nexport function projectConfigExists(cwd?: string): boolean {\n  const dir = cwd ?? process.cwd();\n  return existsSync(resolve(dir, PROJECT_CONFIG_PATH));\n}\n\nexport function userConfigExists(): boolean {\n  return existsSync(join(homedir(), USER_CONFIG_PATH));\n}\n\nexport function anyConfigExists(cwd?: string): boolean {\n  return projectConfigExists(cwd) || userConfigExists();\n}\n"],"mappings":";;;;;;AAAA,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,SAAS,YAAY;AAC9B,SAAS,eAAe;AACxB,SAAS,SAAS,iBAAiB;AAKnC,IAAM,sBAAsB;AAC5B,IAAM,mBAAmB;AAkBzB,eAAe,aAAa,MAAuD;AACjF,MAAI,CAAC,WAAW,IAAI,EAAG,QAAO;AAC9B,QAAM,UAAU,MAAM,SAAS,MAAM,OAAO;AAC5C,SAAQ,UAAU,OAAO,KAAiC;AAC5D;AAEA,SAAS,UACP,MACA,UACyB;AACzB,QAAM,SAAS,EAAE,GAAG,KAAK;AACzB,aAAW,OAAO,OAAO,KAAK,QAAQ,GAAG;AACvC,UAAM,OAAO,KAAK,GAAG;AACrB,UAAM,OAAO,SAAS,GAAG;AACzB,QACE,QACA,QACA,OAAO,SAAS,YAChB,OAAO,SAAS,YAChB,CAAC,MAAM,QAAQ,IAAI,KACnB,CAAC,MAAM,QAAQ,IAAI,GACnB;AACA,aAAO,GAAG,IAAI;AAAA,QACZ;AAAA,QACA;AAAA,MACF;AAAA,IACF,OAAO;AACL,aAAO,GAAG,IAAI;AAAA,IAChB;AAAA,EACF;AACA,SAAO;AACT;AAWA,eAAsB,WAAW,MAAkD;AACjF,QAAM,SAAS,MAAM,qBAAqB,IAAI;AAC9C,SAAO,OAAO;AAChB;AAEA,eAAsB,qBAAqB,MAAqD;AAC9F,QAAM,MAAM,MAAM,OAAO,QAAQ,IAAI;AAErC,QAAM,SAAwB,CAAC;AAE/B,QAAM,WAAW,KAAK,QAAQ,GAAG,gBAAgB;AACjD,QAAM,WAAW,MAAM,aAAa,QAAQ;AAC5C,SAAO,KAAK,EAAE,MAAM,QAAQ,MAAM,UAAU,MAAM,SAAS,CAAC;AAE5D,QAAM,cAAc,QAAQ,KAAK,mBAAmB;AACpD,QAAM,cAAc,MAAM,aAAa,WAAW;AAClD,SAAO,KAAK,EAAE,MAAM,WAAW,MAAM,aAAa,MAAM,YAAY,CAAC;AAErE,MAAI,MAAM,aAAa;AACrB,WAAO,KAAK,GAAG,KAAK,WAAW;AAAA,EACjC;AAEA,MAAI,SAAkC,CAAC;AACvC,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,MAAM;AACd,eAAS,UAAU,QAAQ,MAAM,IAAI;AAAA,IACvC;AAAA,EACF;AAEA,QAAM,SAAS,oBAAoB,MAAM,MAAM;AAC/C,SAAO,EAAE,QAAQ,OAAO;AAC1B;AAEO,SAAS,aAAa,KAAuB;AAClD,SAAO,gBAAgB,GAAG;AAC5B;AAEO,SAAS,oBAAoB,KAAuB;AACzD,QAAM,MAAM,OAAO,QAAQ,IAAI;AAC/B,SAAO,WAAW,QAAQ,KAAK,mBAAmB,CAAC;AACrD;AAEO,SAAS,mBAA4B;AAC1C,SAAO,WAAW,KAAK,QAAQ,GAAG,gBAAgB,CAAC;AACrD;AAEO,SAAS,gBAAgB,KAAuB;AACrD,SAAO,oBAAoB,GAAG,KAAK,iBAAiB;AACtD;","names":[]}

package/dist/chunk-JKJ3FP6T.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+// src/template/engine.ts
+function render(template, context) {
+  let result = template;
+  result = processEach(result, context);
+  result = processConditionals(result, context);
+  result = interpolateVariables(result, context);
+  return result;
+}
+function processEach(template, context) {
+  const eachRegex = /\{\{#each\s+(\w+)\}\}([\s\S]*?)\{\{\/each\}\}/g;
+  return template.replace(eachRegex, (_match, key, body) => {
+    const value = context[key];
+    if (!Array.isArray(value)) return "";
+    return value.map((item) => body.replace(/\{\{\.\}\}/g, item)).join("");
+  });
+}
+function processConditionals(template, context) {
+  const ifElseRegex = /\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{#else\}\}([\s\S]*?)\{\{\/if\}\}/g;
+  let result = template.replace(
+    ifElseRegex,
+    (_match, key, ifBody, elseBody) => {
+      return isTruthy(context[key]) ? ifBody : elseBody;
+    }
+  );
+  const ifRegex = /\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g;
+  result = result.replace(ifRegex, (_match, key, body) => {
+    return isTruthy(context[key]) ? body : "";
+  });
+  return result;
+}
+function interpolateVariables(template, context) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+    const value = context[key];
+    if (value === void 0) return "";
+    if (typeof value === "boolean") return String(value);
+    if (Array.isArray(value)) return value.join(", ");
+    return value;
+  });
+}
+function isTruthy(value) {
+  if (value === void 0 || value === false || value === "") return false;
+  if (Array.isArray(value)) return value.length > 0;
+  return true;
+}
+
+export {
+  render
+};
+//# sourceMappingURL=chunk-JKJ3FP6T.js.map

package/dist/chunk-JKJ3FP6T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/template/engine.ts"],"sourcesContent":["export interface TemplateContext {\n  [key: string]: string | boolean | string[] | undefined;\n}\n\n/**\n * Lightweight template engine:\n * - {{variable}} — interpolation\n * - {{#if condition}}...{{/if}} — conditional block (truthy check)\n * - {{#if condition}}...{{#else}}...{{/if}} — conditional with else\n * - {{#each items}}...{{/each}} — array iteration (current item as {{.}})\n */\nexport function render(template: string, context: TemplateContext): string {\n  let result = template;\n\n  result = processEach(result, context);\n  result = processConditionals(result, context);\n  result = interpolateVariables(result, context);\n\n  return result;\n}\n\nfunction processEach(template: string, context: TemplateContext): string {\n  const eachRegex = /\\{\\{#each\\s+(\\w+)\\}\\}([\\s\\S]*?)\\{\\{\\/each\\}\\}/g;\n  return template.replace(eachRegex, (_match, key: string, body: string) => {\n    const value = context[key];\n    if (!Array.isArray(value)) return \"\";\n    return value.map((item) => body.replace(/\\{\\{\\.\\}\\}/g, item)).join(\"\");\n  });\n}\n\nfunction processConditionals(template: string, context: TemplateContext): string {\n  const ifElseRegex =\n    /\\{\\{#if\\s+(\\w+)\\}\\}([\\s\\S]*?)\\{\\{#else\\}\\}([\\s\\S]*?)\\{\\{\\/if\\}\\}/g;\n  let result = template.replace(\n    ifElseRegex,\n    (_match, key: string, ifBody: string, elseBody: string) => {\n      return isTruthy(context[key]) ? ifBody : elseBody;\n    },\n  );\n\n  const ifRegex = /\\{\\{#if\\s+(\\w+)\\}\\}([\\s\\S]*?)\\{\\{\\/if\\}\\}/g;\n  result = result.replace(ifRegex, (_match, key: string, body: string) => {\n    return isTruthy(context[key]) ? body : \"\";\n  });\n\n  return result;\n}\n\nfunction interpolateVariables(template: string, context: TemplateContext): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, key: string) => {\n    const value = context[key];\n    if (value === undefined) return \"\";\n    if (typeof value === \"boolean\") return String(value);\n    if (Array.isArray(value)) return value.join(\", \");\n    return value;\n  });\n}\n\nfunction isTruthy(value: string | boolean | string[] | undefined): boolean {\n  if (value === undefined || value === false || value === \"\") return false;\n  if (Array.isArray(value)) return value.length > 0;\n  return true;\n}\n"],"mappings":";;;AAWO,SAAS,OAAO,UAAkB,SAAkC;AACzE,MAAI,SAAS;AAEb,WAAS,YAAY,QAAQ,OAAO;AACpC,WAAS,oBAAoB,QAAQ,OAAO;AAC5C,WAAS,qBAAqB,QAAQ,OAAO;AAE7C,SAAO;AACT;AAEA,SAAS,YAAY,UAAkB,SAAkC;AACvE,QAAM,YAAY;AAClB,SAAO,SAAS,QAAQ,WAAW,CAAC,QAAQ,KAAa,SAAiB;AACxE,UAAM,QAAQ,QAAQ,GAAG;AACzB,QAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO;AAClC,WAAO,MAAM,IAAI,CAAC,SAAS,KAAK,QAAQ,eAAe,IAAI,CAAC,EAAE,KAAK,EAAE;AAAA,EACvE,CAAC;AACH;AAEA,SAAS,oBAAoB,UAAkB,SAAkC;AAC/E,QAAM,cACJ;AACF,MAAI,SAAS,SAAS;AAAA,IACpB;AAAA,IACA,CAAC,QAAQ,KAAa,QAAgB,aAAqB;AACzD,aAAO,SAAS,QAAQ,GAAG,CAAC,IAAI,SAAS;AAAA,IAC3C;AAAA,EACF;AAEA,QAAM,UAAU;AAChB,WAAS,OAAO,QAAQ,SAAS,CAAC,QAAQ,KAAa,SAAiB;AACtE,WAAO,SAAS,QAAQ,GAAG,CAAC,IAAI,OAAO;AAAA,EACzC,CAAC;AAED,SAAO;AACT;AAEA,SAAS,qBAAqB,UAAkB,SAAkC;AAChF,SAAO,SAAS,QAAQ,kBAAkB,CAAC,QAAQ,QAAgB;AACjE,UAAM,QAAQ,QAAQ,GAAG;AACzB,QAAI,UAAU,OAAW,QAAO;AAChC,QAAI,OAAO,UAAU,UAAW,QAAO,OAAO,KAAK;AACnD,QAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,KAAK,IAAI;AAChD,WAAO;AAAA,EACT,CAAC;AACH;AAEA,SAAS,SAAS,OAAyD;AACzE,MAAI,UAAU,UAAa,UAAU,SAAS,UAAU,GAAI,QAAO;AACnE,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,SAAS;AAChD,SAAO;AACT;","names":[]}