harness-engineer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 harness-engineer contributors
+
+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,176 @@
+# harness-engineer
+
+`harness-engineer` is a Codex-first scaffolding CLI for repository-owned agent orchestration workflows.
+
+It turns the "harness as files" pattern into a reusable npm package: fixed role definitions, durable memory, runbooks, and task lifecycle artifacts can all be generated into a blank repository with one command.
+
+中文说明见 [README.zh-CN.md](./README.zh-CN.md)。
+
+> License: [MIT](./LICENSE)
+
+## What It Creates
+
+- `AGENTS.md` as the short collaboration entrypoint
+- `.codex/config.toml` and fixed role files under `.codex/agents/`
+- durable memory under `.codex/memory/`
+- `docs/index.md` plus runbooks and source-of-truth placeholders
+- task lifecycle folders under `docs/plans/` and `logs/codex/`
+- a machine-readable `harness-engineer.config.json`
+
+## Quick Start
+
+For published package usage:
+
+```bash
+pnpm dlx harness-engineer@latest init . \
+  --preset generic-software \
+  --project-name "Acme Platform" \
+  --yes
+
+harness-engineer task new 2026-04-02-auth-debug --class B
+harness-engineer status
+```
+
+If you are running from this source repository:
+
+```bash
+pnpm install
+pnpm build
+
+node dist/cli.js init . \
+  --preset generic-software \
+  --project-name "Acme Platform" \
+  --yes
+```
+
+## Install From npm
+
+Without cloning this repository, users can initialize a project directly from npm:
+
+```bash
+pnpm dlx harness-engineer@latest init . \
+  --preset generic-software \
+  --project-name "Acme Platform" \
+  --language bilingual \
+  --yes
+```
+
+Or install it into a project first:
+
+```bash
+npm install -D harness-engineer
+npx harness-engineer init . --preset generic-software --project-name "Acme Platform"
+```
+
+## Presets
+
+### `generic-software`
+
+The default preset for Codex-driven software repositories.
+
+Fixed roles:
+
+- `architect-backend`
+- `architect-frontend`
+- `runtime-integrations`
+- `product-ui`
+- `reviewer`
+- `qa-guard`
+
+Truth-source docs live under `docs/source-of-truth/`.
+
+### `agentadmin-codex`
+
+A compatibility preset extracted from the AgentAdmin harness structure.
+
+It keeps the AgentAdmin-specific document layering (`dev-docs/ + spec/`) and the original fixed role names:
+
+- `architect-backend`
+- `architect-frontend`
+- `runtime-executor`
+- `console-ui`
+- `reviewer`
+- `qa-guard`
+
+## CLI
+
+### `init`
+
+```bash
+harness-engineer init [dir] \
+  --preset <preset> \
+  --project-name <name> \
+  [--language en|zh|bilingual] \
+  [--dev-command "<cmd>"] \
+  [--force] \
+  [--yes]
+```
+
+Notes:
+
+- Generates files only when missing by default.
+- Use `--force` to overwrite managed templates.
+- `--dev-command` generates `.codex/environments/environment.toml`.
+- `init` also adds `harness-engineer` to `devDependencies`.
+- `--language bilingual` keeps the base `AGENTS.md` canonical and adds a bilingual `AGENTS.override.md` plus localized core harness docs.
+
+### `task new`
+
+```bash
+harness-engineer task new <slug> --class A|B|C
+```
+
+Creates:
+
+- `docs/plans/active/<slug>.md`
+- `logs/codex/active/<slug>/run.md`
+- `logs/codex/active/<slug>/handoff.md`
+
+### `task archive`
+
+```bash
+harness-engineer task archive <slug>
+```
+
+Moves the task from active to completed and appends completion sections to the plan if needed.
+
+### `status`
+
+```bash
+harness-engineer status
+```
+
+Reports:
+
+- active tasks
+- missing managed files
+- drifted managed files
+- inconsistent task artifacts
+
+## Local Development
+
+```bash
+pnpm install
+pnpm test
+pnpm test:coverage
+pnpm build
+```
+
+The package is intentionally source-first. `dist/`, `coverage/`, and `node_modules/` are generated locally and are not meant to be committed.
+
+## Testing Strategy
+
+- unit tests for rendering, config helpers, and preset selection
+- integration tests for init, task lifecycle, CLI smoke flow, and status drift detection
+- a self-contained AgentAdmin compatibility snapshot test under `tests/integration/agentadmin-golden.test.ts`
+
+## Repository Layout
+
+```text
+src/      source code for the CLI and generators
+tests/    unit, integration, and fixture-backed compatibility tests
+```
+
+## Open-Source Release Notes
+
+Before publishing updates, review [OPEN_SOURCE_RELEASE_CHECKLIST.md](./OPEN_SOURCE_RELEASE_CHECKLIST.md).

package/README.zh-CN.md

@@ -0,0 +1,174 @@
+# harness-engineer
+
+`harness-engineer` 是一个面向 Codex 的仓库协作脚手架 CLI，用来把“harness 作为文件结构”的工作方式封装成可复用 npm 包。
+
+它可以在一个空白仓库里一次性生成固定角色、长期记忆、runbook、任务计划与 handoff 结构，适合团队把 AI 协作流程沉淀为仓库内真源。
+
+> 许可证：[MIT](./LICENSE)
+
+## 它会生成什么
+
+- `AGENTS.md` 作为最短协作入口
+- `.codex/config.toml` 和 `.codex/agents/` 下的固定角色文件
+- `.codex/memory/` 下的长期记忆
+- `docs/index.md`、runbook 和真源文档占位
+- `docs/plans/` 与 `logs/codex/` 下的任务闭环目录
+- 机器可读配置 `harness-engineer.config.json`
+
+## 快速开始
+
+发布后推荐这样使用：
+
+```bash
+pnpm dlx harness-engineer@latest init . \
+  --preset generic-software \
+  --project-name "Acme Platform" \
+  --yes
+
+harness-engineer task new 2026-04-02-auth-debug --class B
+harness-engineer status
+```
+
+如果你是在当前源码仓库里本地运行：
+
+```bash
+pnpm install
+pnpm build
+
+node dist/cli.js init . \
+  --preset generic-software \
+  --project-name "Acme Platform" \
+  --yes
+```
+
+## 直接从 npm 使用
+
+用户不需要 clone 当前仓库，也可以直接从 npm 初始化项目：
+
+```bash
+pnpm dlx harness-engineer@latest init . \
+  --preset generic-software \
+  --project-name "Acme Platform" \
+  --language bilingual \
+  --yes
+```
+
+也可以先安装到项目里：
+
+```bash
+npm install -D harness-engineer
+npx harness-engineer init . --preset generic-software --project-name "Acme Platform"
+```
+
+## 预设
+
+### `generic-software`
+
+默认的通用 Codex 软件仓库预设。
+
+固定角色：
+
+- `architect-backend`
+- `architect-frontend`
+- `runtime-integrations`
+- `product-ui`
+- `reviewer`
+- `qa-guard`
+
+真源文档落在 `docs/source-of-truth/`。
+
+### `agentadmin-codex`
+
+从 AgentAdmin harness 抽取出来的兼容预设。
+
+它保留 AgentAdmin 当前的文档分层方式（`dev-docs/ + spec/`）和固定角色命名：
+
+- `architect-backend`
+- `architect-frontend`
+- `runtime-executor`
+- `console-ui`
+- `reviewer`
+- `qa-guard`
+
+## CLI 命令
+
+### `init`
+
+```bash
+harness-engineer init [dir] \
+  --preset <preset> \
+  --project-name <name> \
+  [--language en|zh|bilingual] \
+  [--dev-command "<cmd>"] \
+  [--force] \
+  [--yes]
+```
+
+说明：
+
+- 默认只生成缺失文件，不覆盖已有模板。
+- 使用 `--force` 可以覆盖受管理模板。
+- 传入 `--dev-command` 时会生成 `.codex/environments/environment.toml`。
+- `init` 会把 `harness-engineer` 自动加入 `devDependencies`。
+- `--language bilingual` 会保留标准 `AGENTS.md`，并额外生成双语版 `AGENTS.override.md` 与本地化核心 harness 文档。
+
+### `task new`
+
+```bash
+harness-engineer task new <slug> --class A|B|C
+```
+
+会创建：
+
+- `docs/plans/active/<slug>.md`
+- `logs/codex/active/<slug>/run.md`
+- `logs/codex/active/<slug>/handoff.md`
+
+### `task archive`
+
+```bash
+harness-engineer task archive <slug>
+```
+
+会把任务从 active 移到 completed，并在 plan 中补齐结果段落。
+
+### `status`
+
+```bash
+harness-engineer status
+```
+
+会报告：
+
+- 当前 active 任务
+- 缺失的受管理文件
+- 漂移的受管理模板
+- 不一致的任务产物
+
+## 本地开发
+
+```bash
+pnpm install
+pnpm test
+pnpm test:coverage
+pnpm build
+```
+
+仓库以源码为主，`dist/`、`coverage/` 和 `node_modules/` 都是本地产物，不应该提交。
+
+## 测试策略
+
+- 单元测试：渲染、配置、预设选择
+- 集成测试：init、任务生命周期、CLI smoke、status 漂移检查
+- 兼容性测试：`tests/integration/agentadmin-golden.test.ts`
+
+## 仓库结构
+
+```text
+src/      CLI 与生成器源码
+tests/    单元、集成与 fixture 兼容性测试
+```
+
+## 开源发布说明
+
+准备发布更新前，请先阅读 [OPEN_SOURCE_RELEASE_CHECKLIST.md](./OPEN_SOURCE_RELEASE_CHECKLIST.md)。

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function runCli(argv: string[], cwd?: string): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAQA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFjF"}

package/dist/cli.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { initProject } from "./init.js";
+import { readOwnPackageVersion } from "./config.js";
+import { getStatus } from "./status.js";
+import { archiveTask, createTask } from "./tasks.js";
+export async function runCli(argv, cwd = process.cwd()) {
+    const [command, ...rest] = argv;
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        writeStdout(buildUsage());
+        return 0;
+    }
+    if (command === "init") {
+        const { positionals, options } = parseArgs(rest);
+        const targetDir = positionals[0] ?? ".";
+        const projectName = asRequiredString(options["project-name"], "--project-name is required.");
+        const preset = asString(options.preset) ?? "generic-software";
+        const languageOption = asString(options.language);
+        const language = languageOption ? parseHarnessLanguage(languageOption) : undefined;
+        const force = Boolean(options.force);
+        const devCommand = asString(options["dev-command"]);
+        const packageVersion = await readOwnPackageVersion(import.meta.url);
+        const result = await initProject({
+            cwd,
+            targetDir,
+            projectName,
+            preset,
+            language,
+            yes: Boolean(options.yes),
+            force,
+            devCommand,
+            packageVersion,
+        });
+        writeStdout(`Initialized ${result.targetDir}`);
+        writeStdout(`Created: ${result.createdFiles.length}`);
+        writeStdout(`Skipped: ${result.skippedFiles.length}`);
+        writeStdout(`Overwritten: ${result.overwrittenFiles.length}`);
+        return 0;
+    }
+    if (command === "task") {
+        const [subcommand, ...taskArgs] = rest;
+        if (subcommand === "new") {
+            const { positionals, options } = parseArgs(taskArgs);
+            const slug = positionals[0];
+            if (!slug) {
+                throw new Error("task new requires a <slug>.");
+            }
+            const taskClass = (asString(options.class) ?? "B");
+            validateTaskClass(taskClass);
+            await createTask({
+                cwd,
+                slug,
+                taskClass,
+            });
+            writeStdout(`Created task "${slug}".`);
+            return 0;
+        }
+        if (subcommand === "archive") {
+            const { positionals } = parseArgs(taskArgs);
+            const slug = positionals[0];
+            if (!slug) {
+                throw new Error("task archive requires a <slug>.");
+            }
+            await archiveTask({ cwd, slug });
+            writeStdout(`Archived task "${slug}".`);
+            return 0;
+        }
+        throw new Error(`Unknown task subcommand "${subcommand ?? ""}".`);
+    }
+    if (command === "status") {
+        const status = await getStatus(cwd);
+        writeStdout(`Config: ${status.configPath}`);
+        writeStdout(`Active tasks: ${status.activeTasks.length === 0 ? "none" : status.activeTasks.join(", ")}`);
+        writeStdout(`Missing managed files: ${status.missingManagedFiles.length}`);
+        writeStdout(`Drifted managed files: ${status.driftedManagedFiles.length}`);
+        writeStdout(`Inconsistent tasks: ${status.inconsistentTasks.length}`);
+        return 0;
+    }
+    throw new Error(`Unknown command "${command}".`);
+}
+function buildUsage() {
+    return [
+        "Usage:",
+        "  harness-engineer init [dir] --preset <preset> --project-name <name> [--yes] [--force] [--dev-command <cmd>] [--language <en|zh|bilingual>]",
+        "  harness-engineer task new <slug> --class <A|B|C>",
+        "  harness-engineer task archive <slug>",
+        "  harness-engineer status",
+    ].join("\n");
+}
+function parseArgs(argv) {
+    const positionals = [];
+    const options = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (!token) {
+            continue;
+        }
+        if (!token.startsWith("--")) {
+            positionals.push(token);
+            continue;
+        }
+        const optionName = token.slice(2);
+        const next = argv[index + 1];
+        if (!next || next.startsWith("--")) {
+            options[optionName] = true;
+            continue;
+        }
+        options[optionName] = next;
+        index += 1;
+    }
+    return { positionals, options };
+}
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function asRequiredString(value, errorMessage) {
+    const stringValue = asString(value);
+    if (!stringValue) {
+        throw new Error(errorMessage);
+    }
+    return stringValue;
+}
+function validateTaskClass(taskClass) {
+    if (!["A", "B", "C"].includes(taskClass)) {
+        throw new Error(`Invalid task class "${taskClass}". Use A, B, or C.`);
+    }
+}
+function parseHarnessLanguage(language) {
+    if (language === "en" || language === "zh" || language === "bilingual") {
+        return language;
+    }
+    throw new Error(`Invalid language "${language}". Use en, zh, or bilingual.`);
+}
+function writeStdout(message) {
+    process.stdout.write(`${message}\n`);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runCli(process.argv.slice(2)).then((exitCode) => {
+        process.exitCode = exitCode;
+    }, (error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGrD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9D,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC/E,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACxC,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC;QAC9D,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAC/B,GAAG;YACH,SAAS;YACT,WAAW;YACX,MAAM;YACN,QAAQ;YACR,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;YACzB,KAAK;YACL,UAAU;YACV,cAAc;SACf,CAAC,CAAC;QAEH,WAAW,CAAC,eAAe,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,WAAW,CAAC,YAAY,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,WAAW,CAAC,YAAY,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,WAAW,CAAC,gBAAgB,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;QACvC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YACzB,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAc,CAAC;YAChE,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM,UAAU,CAAC;gBACf,GAAG;gBACH,IAAI;gBACJ,SAAS;aACV,CAAC,CAAC;YACH,WAAW,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YACjC,WAAW,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC;YACxC,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,IAAI,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACpC,WAAW,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5C,WAAW,CAAC,iBAAiB,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzG,WAAW,CAAC,0BAA0B,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,WAAW,CAAC,0BAA0B,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,WAAW,CAAC,uBAAuB,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;QACL,QAAQ;QACR,8IAA8I;QAC9I,oDAAoD;QACpD,wCAAwC;QACxC,2BAA2B;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAI/B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,OAAO,GAAqC,EAAE,CAAC;IAErD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAC3B,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAmC;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAmC,EAAE,YAAoB;IACjF,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,uBAAuB,SAAS,oBAAoB,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB;IAC5C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,8BAA8B,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAChC,CAAC,QAAQ,EAAE,EAAE;QACX,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+import type { HarnessConfig, HarnessRoleConfig } from "./types.js";
+export declare const HARNESS_CONFIG_FILE = "harness-engineer.config.json";
+export interface BuildConfigOptions {
+    cwd: string;
+    targetDir?: string;
+    projectName: string;
+    presetKey: string;
+    language?: HarnessConfig["language"];
+    devCommand?: string;
+}
+export declare function buildHarnessConfig(options: BuildConfigOptions): HarnessConfig;
+export declare function loadHarnessConfig(cwd: string): Promise<HarnessConfig>;
+export declare function readOwnPackageVersion(moduleUrl: string): Promise<string>;
+export declare function buildHarnessDependencyVersion(version: string): string;
+export declare function createDefaultPackageJson(projectName: string): {
+    name: string;
+    version: string;
+    private: true;
+    devDependencies: Record<string, string>;
+};
+export declare function serializeHarnessConfig(config: HarnessConfig): string;
+export declare function getRoleByKey(config: HarnessConfig, key: string): HarnessRoleConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAInE,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAwB7E;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAO3E;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9E;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,CAOA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEpE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAOlF"}

package/dist/config.js

@@ -0,0 +1,66 @@
+import { readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { getPreset } from "./presets.js";
+import { formatJson, pathExists, readJsonFile, sortPaths, toPackageName } from "./utils.js";
+export const HARNESS_CONFIG_FILE = "harness-engineer.config.json";
+export function buildHarnessConfig(options) {
+    const preset = getPreset(options.presetKey);
+    const targetDir = resolve(options.cwd, options.targetDir ?? ".");
+    const language = options.language ?? preset.defaultLanguage;
+    const roles = preset.roles.map((role) => ({ ...role }));
+    const truthSources = preset.truthSources.map((source) => ({ ...source }));
+    const config = {
+        projectName: options.projectName,
+        preset: preset.key,
+        language,
+        version: 1,
+        devCommand: options.devCommand ?? null,
+        paths: { ...preset.paths },
+        roles,
+        truthSources,
+        managedFiles: [],
+    };
+    config.managedFiles = sortPaths(preset.buildManagedFiles(config).map((entry) => entry.path));
+    void targetDir;
+    return config;
+}
+export async function loadHarnessConfig(cwd) {
+    const configPath = join(cwd, HARNESS_CONFIG_FILE);
+    if (!(await pathExists(configPath))) {
+        throw new Error(`Missing ${HARNESS_CONFIG_FILE} in ${cwd}. Run "harness-engineer init" first.`);
+    }
+    return readJsonFile(configPath);
+}
+export async function readOwnPackageVersion(moduleUrl) {
+    try {
+        const packageJsonUrl = new URL("../package.json", moduleUrl);
+        const contents = await readFile(packageJsonUrl, "utf8");
+        const parsed = JSON.parse(contents);
+        return parsed.version ?? "latest";
+    }
+    catch {
+        return "latest";
+    }
+}
+export function buildHarnessDependencyVersion(version) {
+    return version === "latest" ? "latest" : `^${version}`;
+}
+export function createDefaultPackageJson(projectName) {
+    return {
+        name: toPackageName(projectName),
+        version: "0.0.0",
+        private: true,
+        devDependencies: {},
+    };
+}
+export function serializeHarnessConfig(config) {
+    return formatJson(config);
+}
+export function getRoleByKey(config, key) {
+    const role = config.roles.find((candidate) => candidate.key === key);
+    if (!role) {
+        throw new Error(`Unknown role "${key}" in harness config.`);
+    }
+    return role;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { runCli } from "./cli.js";
+export { initProject } from "./init.js";
+export { getPreset } from "./presets.js";
+export { renderTemplate } from "./render.js";
+export { getStatus } from "./status.js";
+export { archiveTask, createTask } from "./tasks.js";
+export type { HarnessConfig, HarnessLanguage, HarnessPathsConfig, HarnessRoleConfig, InitOptions, InitResult, StatusResult, TaskArchiveOptions, TaskClass, TaskNewOptions, TruthSourceConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACV,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { runCli } from "./cli.js";
+export { initProject } from "./init.js";
+export { getPreset } from "./presets.js";
+export { renderTemplate } from "./render.js";
+export { getStatus } from "./status.js";
+export { archiveTask, createTask } from "./tasks.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,3 @@
+import type { InitOptions, InitResult } from "./types.js";
+export declare function initProject(options: InitOptions): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA4C3E"}