adr-kit 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenADR 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,150 @@
+<p align="center">
+  <img src="assets/social-preview.png" alt="OpenADR — Open Architecture Decision Records" width="768" />
+</p>
+
+<p align="center">
+  <strong>Open Architecture Decision Records</strong> — a lightweight ADR workflow for humans and agents.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/adr-kit"><img src="https://img.shields.io/npm/v/adr-kit" alt="npm version" /></a>
+  <a href="https://github.com/luochang212/OpenADR/actions/workflows/ci.yml"><img src="https://github.com/luochang212/OpenADR/actions/workflows/ci.yml/badge.svg" alt="ci" /></a>
+  <a href="https://www.npmjs.com/package/adr-kit"><img src="https://img.shields.io/npm/dm/adr-kit" alt="npm downloads" /></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/node/v/adr-kit" alt="node" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/adr-kit" alt="license" /></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.zh.md">中文</a>
+</p>
+
+OpenADR turns architecture decisions into plain Markdown files with a
+machine-checkable lifecycle: **proposed → accepted / rejected / superseded**. It borrows
+the spec-driven spirit of [OpenSpec](https://github.com/Fission-AI/OpenSpec)
+and the decision-record discipline of agent-native codebases: every record
+must say what problem it solves, what it chose, and what it gave up.
+
+```text
+→ fluid not rigid
+→ plain Markdown, no front matter
+→ one decision, one file
+→ built for agents and humans alike
+```
+
+## Quick start
+
+Requires Node.js 20.19 or later.
+
+```bash
+npm install -g adr-kit
+cd your-project
+openadr init
+openadr propose "Use SQLite for session storage"
+```
+
+`openadr init` creates an `adr/` directory:
+
+```text
+adr/
+├── config.yaml      # project context and per-status rules
+├── README.md        # repository conventions
+├── decisions/       # accepted decisions, numbered NNNN
+├── proposed/        # proposals waiting for a decision
+└── rejected/        # rejected proposals, frozen
+```
+
+Fill in the proposal, then:
+
+```bash
+openadr validate
+openadr accept "Use SQLite for session storage"
+openadr list
+```
+
+## Commands
+
+```text
+openadr init [path]                    Initialize an OpenADR repository
+openadr propose <title>                 Create a proposed decision
+openadr decide <title>                  Record an already-accepted decision
+openadr accept <name>                   Accept a proposal (assigns NNNN)
+openadr reject <name> --reason <text>   Reject a proposal
+openadr supersede <name> --by <name>    Mark an accepted decision as superseded
+openadr list [--json]                   List all records
+openadr show <name>                     Show a record
+openadr status [--json]                 Show lifecycle counts and validity
+openadr instructions [--json]           Print the next workflow step
+openadr validate [name] [--all] [--json] Validate one record or the repository
+openadr update [--tools <list>]          Rewrite AI tool integrations
+openadr config [--json]                 Print the current configuration
+openadr completion <bash|zsh|fish>      Print a shell completion script
+openadr version                         Print the version
+```
+
+`<name>` resolves by title, file name, or decision number (`0001`).
+
+## Docs
+
+- [CLI reference](docs/cli.md)
+- [Record format](docs/record-format.md)
+- [Workflow](docs/workflow.md)
+- [Agent skills](skills/README.md)
+
+## Record format
+
+Every record is plain Markdown with a three-line header:
+
+```markdown
+# ADR: Use SQLite for session storage
+
+Status: proposed
+
+## Problem
+...
+```
+
+- **Proposed** records require `Problem`, `Proposal`, `Alternatives
+  considered`, `Acceptance criteria`, and `Risks`.
+- **Accepted** decisions require `Problem`, `Decision`, `Alternatives
+  considered`, and `Consequences`; proposal-era headings are rejected by
+  `validate`.
+- **Rejected** proposals are frozen with the reason on the status line:
+  `Status: rejected — <reason>`.
+- **Superseded** decisions stay in `adr/decisions/` as history, with the
+  replacing decision on the status line: `Status: superseded by NNNN`.
+  `openadr supersede <old> --by <new>` performs the rewrite; `validate`
+  checks that `NNNN` exists and is not itself superseded.
+
+`openadr accept` performs the mechanical rewrite a lifecycle move always
+owed: `## Proposal` becomes `## Decision`, and `Acceptance criteria` plus
+`Risks` are folded into `## Consequences`.
+
+## Philosophy
+
+- **The record is the source of truth.** Code comments rot, docs drift; an
+  ADR that says what was decided and what was given up stays useful.
+- **Alternatives are mandatory.** A decision recorded without what it beat
+  invites re-litigation.
+- **Lifecycle is mechanical, not editorial.** Moving a proposal to
+  accepted or rejected is a command, retiring an accepted decision via
+  supersede is a command, and `validate` enforces the resulting
+  shape.
+- **Agents are first-class users.** The format is plain Markdown, paths are
+  predictable, and every command prints machine-readable output when asked.
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=luochang212/OpenADR&type=Date)](https://www.star-history.com/#luochang212/OpenADR&Date)
+
+## License
+
+[MIT](LICENSE)

package/README.zh.md

@@ -0,0 +1,131 @@
+<p align="center">
+  <img src="assets/social-preview.png" alt="OpenADR — Open Architecture Decision Records" width="768" />
+</p>
+
+<p align="center">
+  <strong>Open Architecture Decision Records</strong> —— 面向人和 agent 的轻量级架构决策记录工作流。
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/adr-kit"><img src="https://img.shields.io/npm/v/adr-kit" alt="npm version" /></a>
+  <a href="https://github.com/luochang212/OpenADR/actions/workflows/ci.yml"><img src="https://github.com/luochang212/OpenADR/actions/workflows/ci.yml/badge.svg" alt="ci" /></a>
+  <a href="https://www.npmjs.com/package/adr-kit"><img src="https://img.shields.io/npm/dm/adr-kit" alt="npm downloads" /></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/node/v/adr-kit" alt="node" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/adr-kit" alt="license" /></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.zh.md">中文</a>
+</p>
+
+OpenADR 把架构决策变成纯 Markdown 文件，并带有机检的生命周期：
+**proposed → accepted / rejected / superseded**。它借鉴了
+[OpenSpec](https://github.com/Fission-AI/OpenSpec) 的 spec-driven 思路，以及
+agent 原生代码库的决策记录纪律：每条记录都必须说明它解决什么问题、选择了什么、
+放弃了什么。
+
+```text
+→ 灵活而不僵化
+→ 纯 Markdown，无 front matter
+→ 一个决策一个文件
+→ 同时服务人类和 agent
+```
+
+## 快速开始
+
+需要 Node.js 20.19 或更高版本。
+
+```bash
+npm install -g adr-kit
+cd your-project
+openadr init
+openadr propose "使用 SQLite 存储会话"
+```
+
+`openadr init` 会创建 `adr/` 目录：
+
+```text
+adr/
+├── config.yaml      # 项目上下文与分状态规则
+├── README.md        # 仓库约定
+├── decisions/       # 已接受决策，按 NNNN 编号
+├── proposed/        # 待决策提案
+└── rejected/        # 已拒绝提案，冻结保存
+```
+
+填写提案内容后：
+
+```bash
+openadr validate
+openadr accept "使用 SQLite 存储会话"
+openadr list
+```
+
+## 命令
+
+```text
+openadr init [path]                   初始化 OpenADR 仓库
+openadr propose <title>                创建提案
+openadr decide <title>                 直接记录已接受的决策
+openadr accept <name>                  接受提案（分配 NNNN 编号）
+openadr reject <name> --reason <text>  拒绝提案
+openadr supersede <name> --by <name>   标记已接受决策被新决策取代
+openadr list [--json]                  列出所有记录
+openadr show <name>                    查看记录
+openadr status [--json]                查看生命周期计数与校验状态
+openadr instructions [--json]          查看下一步该做什么
+openadr validate [name] [--all] [--json] 校验单条记录或整个仓库
+openadr update [--tools <list>]         重写 AI 工具集成文件
+openadr config [--json]                查看当前配置
+openadr completion <bash|zsh|fish>     打印 shell 补全脚本
+openadr version                        查看版本
+```
+
+`<name>` 支持按标题、文件名或决策编号（`0001`）查找。
+
+## 记录格式
+
+每条记录都是纯 Markdown，头部固定三行：
+
+```markdown
+# ADR: 使用 SQLite 存储会话
+
+Status: proposed
+
+## Problem
+...
+```
+
+- **Proposed** 需要 `Problem`、`Proposal`、`Alternatives considered`、
+  `Acceptance criteria`、`Risks`。
+- **Accepted** 需要 `Problem`、`Decision`、`Alternatives considered`、
+  `Consequences`；`validate` 会拒绝提案时代的标题出现在已接受决策中。
+- **Rejected** 冻结提案，拒绝原因写在状态行：`Status: rejected — <reason>`。
+- **Superseded** 决策保留在 `adr/decisions/` 作为历史，状态行指向取代它的决策：
+  `Status: superseded by NNNN`。`openadr supersede <旧> --by <新>` 完成改写；
+  `validate` 校验 `NNNN` 存在且自身未被取代。
+
+`openadr accept` 会自动完成生命周期迁移所要求的改写：`## Proposal` 改为
+`## Decision`，`Acceptance criteria` 与 `Risks` 合并进 `## Consequences`。
+
+## 理念
+
+- **记录是事实来源。** 代码注释会腐化，文档会漂移；一条写明了决定与代价的
+  ADR 会持续有用。
+- **备选方案是强制项。** 没有记录被否决方案的决策，是在邀请未来的重复争论。
+- **生命周期是机械操作，不是编辑操作。** 提案转接受或拒绝、已接受决策被取代，
+  都是一条命令，`validate` 强制检查结果形态。
+- **Agent 是一等用户。** 纯 Markdown、可预测的路径、需要时可输出 JSON。
+
+## 开发
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+## 许可证
+
+[MIT](LICENSE)

package/bin/openadr.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/cli.js').then(({ main }) => main(process.argv.slice(2))).catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function main(argv: string[]): void;
+//# 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":"AA0CA,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA8HzC"}

package/dist/cli.js

@@ -0,0 +1,176 @@
+import { parseArgs } from 'node:util';
+import { pathToFileURL } from 'node:url';
+import { VERSION } from './version.js';
+import { acceptCommand } from './commands/accept.js';
+import { completionCommand } from './commands/completion.js';
+import { configCommand } from './commands/config.js';
+import { decideCommand } from './commands/decide.js';
+import { initCommand } from './commands/init.js';
+import { instructionsCommand } from './commands/instructions.js';
+import { listCommand } from './commands/list.js';
+import { proposeCommand } from './commands/propose.js';
+import { rejectCommand } from './commands/reject.js';
+import { showCommand } from './commands/show.js';
+import { statusCommand } from './commands/status.js';
+import { supersedeCommand } from './commands/supersede.js';
+import { updateCommand } from './commands/update.js';
+import { validateCommand } from './commands/validate.js';
+const HELP = `openadr ${VERSION} — Open Architecture Decision Records
+
+Usage:
+  openadr init [path] [--tools <list>]        Initialize an OpenADR repository
+  openadr propose <title>                     Create a proposed decision
+  openadr decide <title>                      Create an accepted decision draft
+  openadr accept <name>                       Accept a proposal (assigns NNNN)
+  openadr reject <name> --reason <reason>     Reject a proposal
+  openadr supersede <name> --by <name>        Mark an accepted decision as superseded
+  openadr list [--json]                       List all decision records
+  openadr show <name>                         Show a decision record
+  openadr status [--json]                     Show lifecycle counts and validity
+  openadr instructions [--json]               Print the next workflow step
+  openadr validate [name] [--all] [--json]    Validate one record or the whole repo
+  openadr update [--tools <list>]             Rewrite AI tool integrations
+  openadr config [--json]                     Print the current configuration
+  openadr completion <bash|zsh|fish>          Print a shell completion script
+  openadr version                             Print the version
+  openadr -h, --help                          Print this help
+  openadr -V, --version                       Print the version
+
+Run from anywhere inside the project; commands discover the nearest adr/ directory.
+`;
+export function main(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            all: { type: 'boolean', default: false },
+            by: { type: 'string' },
+            json: { type: 'boolean', default: false },
+            reason: { type: 'string' },
+            tools: { type: 'string' },
+            help: { type: 'boolean', short: 'h', default: false },
+            version: { type: 'boolean', short: 'V', default: false },
+        },
+    });
+    if (values.version) {
+        console.log(VERSION);
+        return;
+    }
+    if (values.help) {
+        console.log(HELP);
+        return;
+    }
+    const command = positionals[0] ?? '';
+    const rest = positionals.slice(1);
+    try {
+        switch (command) {
+            case '': {
+                console.error(HELP);
+                process.exitCode = 1;
+                return;
+            }
+            case 'help': {
+                console.log(HELP);
+                return;
+            }
+            case 'version': {
+                console.log(VERSION);
+                return;
+            }
+            case 'init': {
+                const target = rest[0] ?? process.cwd();
+                console.log(initCommand(target, values.tools));
+                return;
+            }
+            case 'propose': {
+                requireTitle(rest, 'propose');
+                console.log(proposeCommand(rest[0], process.cwd()));
+                return;
+            }
+            case 'decide': {
+                requireTitle(rest, 'decide');
+                console.log(decideCommand(rest[0], process.cwd()));
+                return;
+            }
+            case 'accept': {
+                requireTitle(rest, 'accept');
+                console.log(acceptCommand(rest[0], process.cwd()));
+                return;
+            }
+            case 'reject': {
+                requireTitle(rest, 'reject');
+                const reason = values.reason;
+                if (reason === undefined) {
+                    throw new Error('reject requires --reason <reason>');
+                }
+                console.log(rejectCommand(rest[0], reason, process.cwd()));
+                return;
+            }
+            case 'supersede': {
+                requireTitle(rest, 'supersede');
+                const by = values.by;
+                if (by === undefined) {
+                    throw new Error('supersede requires --by <name>');
+                }
+                console.log(supersedeCommand(rest[0], by, process.cwd()));
+                return;
+            }
+            case 'list': {
+                console.log(listCommand(process.cwd(), values.json));
+                return;
+            }
+            case 'show': {
+                requireTitle(rest, 'show');
+                console.log(showCommand(rest[0], process.cwd()));
+                return;
+            }
+            case 'status': {
+                const result = statusCommand(process.cwd(), values.json);
+                console.log(result.output);
+                if (result.valid === false)
+                    process.exitCode = 1;
+                return;
+            }
+            case 'instructions': {
+                console.log(instructionsCommand(process.cwd(), values.json));
+                return;
+            }
+            case 'update': {
+                console.log(updateCommand(process.cwd(), values.tools));
+                return;
+            }
+            case 'config': {
+                console.log(configCommand(process.cwd(), values.json));
+                return;
+            }
+            case 'completion': {
+                const shell = rest[0] ?? '';
+                console.log(completionCommand(shell));
+                return;
+            }
+            case 'validate': {
+                const result = validateCommand(process.cwd(), rest[0], values.json);
+                console.log(result.output);
+                if (result.valid === false)
+                    process.exitCode = 1;
+                return;
+            }
+            default: {
+                throw new Error(`unknown command "${command}"\n\n${HELP}`);
+            }
+        }
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    }
+}
+function requireTitle(rest, command) {
+    if (rest.length === 0 || rest[0].trim().length === 0) {
+        throw new Error(`${command} requires a title or name`);
+    }
+}
+if (process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    main(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/accept.d.ts

@@ -0,0 +1,2 @@
+export declare function acceptCommand(query: string, cwd: string): string;
+//# sourceMappingURL=accept.d.ts.map

package/dist/commands/accept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept.d.ts","sourceRoot":"","sources":["../../src/commands/accept.ts"],"names":[],"mappings":"AAYA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CA4BhE"}

package/dist/commands/accept.js

@@ -0,0 +1,33 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { requireRoot } from '../core/config.js';
+import { nextDecisionNumber, removeRecord, resolveRecord, writeRecord, } from '../core/repository.js';
+import { proposalToDecision } from '../core/templates.js';
+import { formatIssues, validateRecord } from '../core/validate.js';
+export function acceptCommand(query, cwd) {
+    const root = requireRoot(cwd);
+    const record = resolveRecord(root, query);
+    if (record.folder !== 'proposed') {
+        throw new Error(`"${query}" is not a proposal (it is in ${record.folder})`);
+    }
+    if (/^\d{4}\s+/.test(record.title)) {
+        throw new Error('proposal title must not start with a four-digit number; OpenADR assigns decision numbers');
+    }
+    const issues = validateRecord(root, record);
+    if (issues.length > 0) {
+        throw new Error(`proposal is not valid; fix it before accepting:\n${formatIssues(issues)}`);
+    }
+    const number = nextDecisionNumber(root);
+    const padded = String(number).padStart(4, '0');
+    const slug = record.fileName.replace(/^\d{4}-\d{2}-\d{2}-/, '').replace(/\.md$/, '');
+    const fileName = `${padded}-${slug}.md`;
+    const path = join(root, 'adr', 'decisions', fileName);
+    if (existsSync(path)) {
+        throw new Error(`decision already exists: adr/decisions/${fileName}`);
+    }
+    const content = proposalToDecision(record, number);
+    writeRecord(root, 'decisions', fileName, content);
+    removeRecord(record);
+    return `accepted adr/proposed/${record.fileName} as adr/decisions/${fileName}`;
+}
+//# sourceMappingURL=accept.js.map

package/dist/commands/accept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../src/commands/accept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,GAAW;IACtD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,iCAAiC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IAC9G,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,oDAAoD,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,IAAI,KAAK,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,0CAA0C,QAAQ,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,YAAY,CAAC,MAAM,CAAC,CAAC;IACrB,OAAO,yBAAyB,MAAM,CAAC,QAAQ,qBAAqB,QAAQ,EAAE,CAAC;AACjF,CAAC"}

package/dist/commands/completion.d.ts

@@ -0,0 +1,2 @@
+export declare function completionCommand(shell: string): string;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAmBA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBvD"}

package/dist/commands/completion.js

@@ -0,0 +1,40 @@
+const COMMANDS = [
+    'init',
+    'propose',
+    'decide',
+    'accept',
+    'reject',
+    'supersede',
+    'list',
+    'show',
+    'status',
+    'instructions',
+    'validate',
+    'update',
+    'config',
+    'completion',
+    'version',
+    'help',
+];
+export function completionCommand(shell) {
+    const words = COMMANDS.join(' ');
+    switch (shell) {
+        case 'bash':
+            return `_openadr_completion() {
+  local cur
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  COMPREPLY=( $(compgen -W "${words}" -- "$cur") )
+}
+complete -F _openadr_completion openadr
+`;
+        case 'zsh':
+            return `#compdef openadr
+_arguments '1:command:(${words})'
+`;
+        case 'fish':
+            return COMMANDS.map((command) => `complete -c openadr -f -a "${command}"`).join('\n') + '\n';
+        default:
+            throw new Error(`unsupported shell "${shell}". Supported: bash, zsh, fish`);
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG;IACf,MAAM;IACN,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,MAAM;IACN,MAAM;IACN,QAAQ;IACR,cAAc;IACd,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,MAAM;CACP,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO;;;8BAGiB,KAAK;;;CAGlC,CAAC;QACE,KAAK,KAAK;YACR,OAAO;yBACY,KAAK;CAC7B,CAAC;QACE,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC/F;YACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,+BAA+B,CAAC,CAAC;IAChF,CAAC;AACH,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+export declare function configCommand(cwd: string, asJson?: boolean): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAwBjE"}

package/dist/commands/config.js

@@ -0,0 +1,23 @@
+import { configPath, readConfig, requireRoot } from '../core/config.js';
+export function configCommand(cwd, asJson = false) {
+    const root = requireRoot(cwd);
+    const config = readConfig(root);
+    if (asJson) {
+        return JSON.stringify({
+            path: configPath(root),
+            context: config.context ?? '',
+            rules: config.rules ?? {},
+            tools: config.tools ?? [],
+        }, null, 2);
+    }
+    const lines = [`config: ${configPath(root)}`, ''];
+    if (config.context !== undefined && config.context.trim().length > 0) {
+        lines.push('context:', config.context.trim(), '');
+    }
+    if (config.tools !== undefined && config.tools.length > 0) {
+        lines.push(`tools: ${config.tools.join(', ')}`, '');
+    }
+    lines.push(`rules: ${JSON.stringify(config.rules ?? {})}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAAM,GAAG,KAAK;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,SAAS,CACnB;YACE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;YACtB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/decide.d.ts

@@ -0,0 +1,2 @@
+export declare function decideCommand(title: string, cwd: string): string;
+//# sourceMappingURL=decide.d.ts.map

package/dist/commands/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/commands/decide.ts"],"names":[],"mappings":"AAOA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBhE"}