@repomem/memory 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nicolás Rickert
+
+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

@@ -1,3 +1,209 @@
-# Temporary Holding Version
+# @repomem/memory
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Your repo's memory, available to every AI tool your team uses.**
+
+> npm package: [`@repomem/memory`](https://www.npmjs.com/package/@repomem/memory) ·
+> CLI command: `repomem-memory`.
+
+`@repomem/memory` is a local [Model Context Protocol](https://modelcontextprotocol.io)
+(MCP) server that turns a `memory/` folder in your repository into searchable,
+shared context for AI assistants. Decisions, conventions, limitations,
+learnings and project context live as reviewable markdown files with structured
+frontmatter, versioned with git and shared through normal pull requests. AI
+tools can search and read them, and propose new entries as drafts that a human
+approves in the same PR as the code change.
+
+## Why it exists
+
+Teams accumulate hard-won context — why a library was chosen, which approach
+failed, what a module is allowed to touch. That knowledge usually lives in
+people's heads, scattered chat logs, or stale wiki pages that no AI tool can
+see. `repomem` keeps it next to the code, in git, where both humans and AI
+assistants can find it.
+
+Design principles:
+
+- **Markdown is the source of truth.** No external database, no derived index
+  committed to git.
+- **The AI proposes, the human accepts.** AI-written entries are always created
+  as `draft` and reviewed in a pull request.
+- **Zero native dependencies**, so `npx` works everywhere.
+- **Tool-agnostic.** Works with Kiro, Claude Code, and any MCP client.
+
+## Quick start
+
+Scaffold a `memory/` folder in your repo (no install needed, `npx` fetches it):
+
+```bash
+npx --package @repomem/memory repomem-memory init
+```
+
+Prefer a pinned local install? Add the package (the CLI bin is `repomem-memory`):
+
+```bash
+npm install -D @repomem/memory
+```
+
+Register the server with your AI tool (see [MCP client config](#mcp-client-config)),
+then ask it to search or propose memory. Before committing, validate:
+
+```bash
+npx --package @repomem/memory repomem-memory validate
+```
+
+`validate` exits non-zero on any problem, so it fits in a pre-commit hook or CI.
+
+## Entry format
+
+Entries live at `memory/<type>s/<slug>.md`. The `id` of an entry is its file
+slug. Each file starts with YAML frontmatter:
+
+```markdown
+---
+type: decision          # decision | convention | limitation | learning | context
+title: Use PostgreSQL as the primary data store
+status: accepted        # draft | accepted | deprecated (default: draft)
+date: 2026-01-15        # ISO date
+scope: project          # project (default, repo-wide) or a module name (db, auth…)
+author: platform-team   # optional
+tags: [database, architecture]
+related_paths:          # globs this entry relates to
+  - "src/db/**"
+  - "migrations/**"
+# supersedes: old-entry-id        # optional
+# last_verified: 2026-02-01       # optional
+---
+
+We chose PostgreSQL because the domain is relational and we rely on
+transactional guarantees across several tables.
+```
+
+| Field           | Required | Notes                                             |
+|-----------------|----------|---------------------------------------------------|
+| `type`          | yes      | One of decision, convention, limitation, learning, context |
+| `title`         | yes      | Human-readable title; the slug is derived from it |
+| `status`        | no       | Defaults to `draft`                               |
+| `date`          | yes      | ISO date (`YYYY-MM-DD`)                            |
+| `scope`         | no       | Free text; defaults to `project`. Use a module name (`db`, `auth`…) for module-specific entries. Complements `related_paths`. |
+| `author`        | no       | Freeform                                          |
+| `tags`          | no       | Defaults to `[]`                                  |
+| `related_paths` | no       | Globs; power `memory_for_path`. Defaults to `[]`  |
+| `supersedes`    | no       | Id of an entry this one replaces                  |
+| `last_verified` | no       | ISO date                                          |
+
+## Tools
+
+| Tool                | What it does                                                                 |
+|---------------------|------------------------------------------------------------------------------|
+| `search_memory`     | Full-text search returning compact summaries (id, type, title, status, snippet). Excludes deprecated by default. Optional `type` and `tags` (OR) filters. |
+| `get_memory`        | Returns the full content of one entry by `id`.                               |
+| `memory_for_path`   | Returns entries whose `related_paths` globs match a file path. Prioritizes accepted over draft; excludes deprecated. |
+| `propose_memory`    | Creates a new entry, **always as `draft`**. Rejects duplicates, never overwrites. |
+| `deprecate_memory`  | Marks an entry `deprecated`, recording a reason and optional `superseded_by`. |
+
+## The propose-then-review workflow
+
+1. While working, an AI assistant proposes an entry with `propose_memory`. It
+   lands on disk as `status: draft`.
+2. The draft shows up in your working tree as a normal file change.
+3. You review it in the **same pull request** as the related code, edit if
+   needed, and flip `status` to `accepted`.
+4. `npx --package @repomem/memory repomem-memory validate` runs in CI to catch
+   malformed entries, dangling `supersedes` references, and accidentally
+   committed secrets.
+
+Nothing becomes "accepted" memory without a human in the loop.
+
+## Root discovery
+
+The memory root is resolved in this order:
+
+1. `--root <dir>` flag
+2. `MEMORY_ROOT` environment variable
+3. `<git root>/.repomem/memory`
+
+The server re-checks file modification times before each search, so a
+`git pull` is picked up without a restart.
+
+## MCP client config
+
+### Kiro — `.kiro/settings/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "repomem": {
+      "command": "npx",
+      "args": ["-y", "--package", "@repomem/memory", "repomem-memory", "serve"],
+      "env": {},
+      "disabled": false,
+      "autoApprove": ["search_memory", "get_memory", "memory_for_path"]
+    }
+  }
+}
+```
+
+Instead of writing this by hand, run the one-step setup:
+
+```bash
+npx --package @repomem/memory repomem-memory setup --agent kiro   # from your repository root
+```
+
+Or configure both repomem servers at once with the installer: `npx @repomem/cli setup`.
+
+It installs a `repomem-memory` skill (how to record and recall memory), a
+`repomem-distill` skill (how to distill a finished plan into durable entries as
+its final step), an `agentSpawn` validate hook, a shared
+`.kiro/agents/repomem.json` agent config, and merges the server into
+`.kiro/settings/mcp.json`. The command is idempotent and never overwrites your
+existing entries (pass `--force` to replace repomem's own entry). Only `kiro` is
+supported today.
+
+### Claude Code — `.mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "repomem": {
+      "command": "npx",
+      "args": ["-y", "--package", "@repomem/memory", "repomem-memory", "serve"]
+    }
+  }
+}
+```
+
+In both cases the server resolves its memory root from the git repository it
+runs in. To point at a specific folder, add `"--root", "/path/to/memory"` to
+`args` or set `MEMORY_ROOT` in `env`.
+
+## CLI
+
+```bash
+repomem-memory serve [--root <dir>]      # start the MCP server over stdio (what agents invoke)
+repomem-memory init [--root <dir>]       # scaffold memory/ with templates and a README
+repomem-memory validate [--root <dir>]   # validate frontmatter, supersedes refs, and scan for secrets
+repomem-memory setup --agent kiro        # install skills, hooks and MCP config for an agent
+```
+
+`validate` returns a non-zero exit code on any error, for use in pre-commit and CI.
+
+`setup` resolves the repository root via `--root` > `REPOMEM_REPO_ROOT` > the
+enclosing git root, and writes under `.kiro/`.
+
+## Development
+
+Requires **Node.js 22+**.
+
+```bash
+npm install
+npm run build      # tsc -> dist/
+npm test           # vitest
+npm run typecheck
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the branching model, commit
+conventions, and the test-driven workflow.
+
+## License
+
+[MIT](./LICENSE)

package/assets/kiro/hooks/repomem-validate.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# repomem-validate.sh — validate the repository's memory folder.
+#
+# Wired as a Kiro `agentSpawn` hook by `repomem setup --agent kiro`. It runs on
+# agent start to surface any invalid memory entries early. The exit code is not
+# used to block (agentSpawn hooks only add stdout to context), so a failure here
+# is informational.
+set -euo pipefail
+
+npx -y repomem validate

package/assets/kiro/skills/repomem-distill/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: repomem-distill
+description: How to distill a finished piece of work into durable repomem entries. Use as the FINAL STEP after executing a plan or completing a substantial task — review what the session produced and propose the decisions, learnings, limitations, and context worth keeping for next time.
+---
+
+# repomem — distilling a session into memory
+
+When you finish executing a plan or a substantial task, the valuable knowledge
+lives only in this session: why you chose an approach, what surprised you, what
+constraints you hit. Once the session ends, it is gone unless you write it down.
+This skill is the final step of a plan: turn that knowledge into a small number
+of durable `repomem` entries.
+
+This is NOT about saving the plan. Do not persist the step-by-step plan, task
+lists, progress logs, or any other ephemeral session state — that noise does not
+belong in memory and the agent's own session already holds it. Distill only
+knowledge that will still matter weeks from now.
+
+## When to run it
+
+- As the explicit final step after completing a plan or a non-trivial task.
+- When the user asks you to "record" or "distill" what was done.
+
+## What to distill
+
+Review the session and identify, if any:
+
+- **decisions** — non-obvious choices and the reasoning behind them.
+- **learnings** — things that surprised you or cost time, worth remembering.
+- **limitations** — new constraints or gotchas you discovered.
+- **context** — project or module-level understanding that changed or is newly
+  worth writing down (what a thing is, why it exists, how it fits together).
+
+If nothing durable came out of the work, propose nothing. A clean "no entries
+needed" is a valid outcome — do not invent memory.
+
+## How to do it
+
+1. Reflect on what the session actually accomplished and changed.
+2. For each durable item, call `propose_memory` once, with:
+   - a clear, specific `title`,
+   - the right `type` (decision / convention / limitation / learning / context),
+   - meaningful `related_paths` so `memory_for_path` can surface it later,
+   - a `scope`: `project` for repo-wide knowledge, or a module name
+     (e.g. `db`, `auth`, `frontend`) for module-specific knowledge.
+3. Keep each entry focused: one decision/learning/limitation/context per file.
+4. **Never** mark an entry `accepted` yourself. Every entry is a `draft` for a
+   human to review and accept in the same pull request as the code.
+5. Remind the user to run `repomem validate` before committing.
+
+## Guidelines
+
+- Prefer a few high-signal entries over many shallow ones.
+- Write for a teammate (human or AI) who was not in this session.
+- Reuse existing entries by proposing a `supersedes` reference when a decision
+  replaces an earlier one, rather than silently contradicting it.

package/assets/kiro/skills/repomem-memory/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: repomem-memory
+description: How to use the repomem MCP server to record and recall a repository's shared memory — decisions, conventions, limitations, and learnings. Use when you make a non-obvious choice worth remembering, when you need prior context before changing code, or when the user asks what the team already decided.
+---
+
+# repomem — the repository's shared memory
+
+repomem turns a `memory/` folder into searchable, git-versioned context served
+over MCP. Entries are markdown files with structured frontmatter, grouped by
+type: `decisions/`, `conventions/`, `limitations/`, `learnings/`.
+
+## When to use it
+
+- **Before changing unfamiliar code**: search memory for related decisions and
+  limitations so you don't contradict an earlier choice.
+- **After making a non-obvious decision**: propose a new entry so the rationale
+  survives beyond the current conversation.
+- **When the user asks "why is it this way?"**: look it up instead of guessing.
+
+## The propose-then-review workflow
+
+AI tools **propose** entries as drafts (`status: draft`). A human reviews and
+**accepts** them in the same pull request as the related change. Never mark an
+entry `accepted` yourself — leave it as a draft for review.
+
+## Tools
+
+- `search_memory` — full-text search across all entries. Start here.
+- `get_memory` — fetch a specific entry by slug.
+- `memory_for_path` — find entries whose `related_paths` match a file you are
+  about to touch.
+- Write tools propose new draft entries; prefer small, specific entries with a
+  clear title and `related_paths`.
+
+## Guidelines
+
+- Keep entries focused: one decision/convention/limitation/learning per file.
+- Always set meaningful `related_paths` so `memory_for_path` can surface the
+  entry later.
+- Run `repomem validate` before committing — it checks frontmatter, supersedes
+  references, and scans for secrets.

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * cli.ts — `repomem-memory` command line.
+ *
+ *   repomem-memory serve [--root <dir>]      start the MCP server over stdio
+ *   repomem-memory init [--root <dir>]       scaffold the memory/ folder + templates
+ *   repomem-memory validate [--root <dir>]   check frontmatter, supersedes refs, secrets
+ *   repomem-memory setup --agent <name>      install skills, hooks and MCP config
+ *
+ * `validate` exits non-zero on any error so it can gate pre-commit and CI.
+ */
+export declare function run(argv?: 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":";AACA;;;;;;;;;GASG;AA8IH,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDjF"}

package/dist/cli.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+/**
+ * cli.ts — `repomem-memory` command line.
+ *
+ *   repomem-memory serve [--root <dir>]      start the MCP server over stdio
+ *   repomem-memory init [--root <dir>]       scaffold the memory/ folder + templates
+ *   repomem-memory validate [--root <dir>]   check frontmatter, supersedes refs, secrets
+ *   repomem-memory setup --agent <name>      install skills, hooks and MCP config
+ *
+ * `validate` exits non-zero on any error so it can gate pre-commit and CI.
+ */
+import { promises as fs } from "node:fs";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { ENTRY_TYPES, TYPE_DIRS } from "./schema.js";
+import { resolveMemoryRoot } from "./store.js";
+import { validateRoot, formatReport } from "./validate.js";
+import { main as startServer } from "./index.js";
+import { runSetup } from "@repomem/core";
+import { repomemSpec } from "./setup/spec.js";
+const here = path.dirname(fileURLToPath(import.meta.url));
+// Templates ship alongside dist/ at the package root: dist/cli.js -> ../templates
+const TEMPLATES_DIR = path.resolve(here, "..", "templates");
+function out(message) {
+    process.stdout.write(message + "\n");
+}
+function err(message) {
+    process.stderr.write(message + "\n");
+}
+function parseFlag(argv, name) {
+    const i = argv.indexOf(name);
+    if (i !== -1 && i + 1 < argv.length)
+        return argv[i + 1];
+    return undefined;
+}
+function hasFlag(argv, name) {
+    return argv.includes(name);
+}
+const MEMORY_README = `# Memory
+
+This folder is your repository's shared memory, read and extended by AI tools
+through the \`repomem\` MCP server.
+
+Each entry is a markdown file with structured frontmatter, organized by type:
+
+- \`decisions/\`   — choices made and why
+- \`conventions/\` — rules the team follows
+- \`limitations/\` — known constraints and gotchas
+- \`learnings/\`   — lessons worth remembering
+- \`contexts/\`    — project and module-level context (what things are and why)
+
+## How it works
+
+AI tools **propose** new entries as drafts (\`status: draft\`). A human reviews
+and **accepts** them in the same pull request as the related change. Entries are
+versioned with git — no external database.
+
+Run \`npx --package @repomem/memory repomem-memory validate\` to check entries before committing.
+
+See \`templates/\` for a starting point for each entry type.
+`;
+async function cmdInit(root) {
+    const created = [];
+    const skipped = [];
+    async function ensureDir(dir) {
+        if (existsSync(dir)) {
+            skipped.push(dir);
+        }
+        else {
+            await fs.mkdir(dir, { recursive: true });
+            created.push(dir);
+        }
+    }
+    await ensureDir(root);
+    for (const type of ENTRY_TYPES) {
+        await ensureDir(path.join(root, TYPE_DIRS[type]));
+    }
+    // README (never overwrite).
+    const readme = path.join(root, "README.md");
+    if (existsSync(readme)) {
+        skipped.push(readme);
+    }
+    else {
+        await fs.writeFile(readme, MEMORY_README, "utf8");
+        created.push(readme);
+    }
+    // Templates (never overwrite individual files).
+    const destTemplates = path.join(root, "templates");
+    await ensureDir(destTemplates);
+    for (const type of ENTRY_TYPES) {
+        const src = path.join(TEMPLATES_DIR, `${type}.md`);
+        const dest = path.join(destTemplates, `${type}.md`);
+        if (existsSync(dest)) {
+            skipped.push(dest);
+            continue;
+        }
+        try {
+            const content = await fs.readFile(src, "utf8");
+            await fs.writeFile(dest, content, "utf8");
+            created.push(dest);
+        }
+        catch {
+            err(`warning: template not found: ${src}`);
+        }
+    }
+    out(`Initialized memory at ${root}`);
+    if (created.length)
+        out(`  created:\n${created.map((c) => `    + ${c}`).join("\n")}`);
+    if (skipped.length)
+        out(`  already present (left untouched):\n${skipped.map((c) => `    = ${c}`).join("\n")}`);
+    return 0;
+}
+async function cmdValidate(root) {
+    if (!existsSync(root)) {
+        err(`No memory folder at ${root}. Run \`repomem-memory init\` first.`);
+        return 1;
+    }
+    const report = await validateRoot(root);
+    const text = formatReport(report, root);
+    if (report.ok) {
+        out(text);
+        return 0;
+    }
+    err(text);
+    return 1;
+}
+function usage() {
+    out([
+        "repomem-memory — your repo's memory for AI tools",
+        "",
+        "Usage:",
+        "  repomem-memory serve [--root <dir>]      Start the MCP server over stdio (default for agents)",
+        "  repomem-memory init [--root <dir>]       Scaffold the memory/ folder and templates",
+        "  repomem-memory validate [--root <dir>]   Validate entries (frontmatter, refs, secrets)",
+        "  repomem-memory setup --agent <name>      Install skills, hooks and MCP config for an agent",
+        "",
+        "Root resolution: --root > MEMORY_ROOT env > <git root>/.repomem/memory",
+        "setup root resolution: --root > REPOMEM_REPO_ROOT env > <git root>",
+    ].join("\n"));
+}
+export async function run(argv = process.argv.slice(2)) {
+    const command = argv[0];
+    if (!command || command === "--help" || command === "-h" || command === "help") {
+        usage();
+        return command ? 0 : 1;
+    }
+    // `setup` resolves the repository root (not the memory root), so handle it
+    // before the memory-root resolution below.
+    if (command === "setup") {
+        return runSetup(repomemSpec, {
+            agent: parseFlag(argv, "--agent"),
+            rootFlag: parseFlag(argv, "--root"),
+            force: hasFlag(argv, "--force"),
+        }, { out, err });
+    }
+    // `serve` starts the MCP server over stdio. This is what agents invoke
+    // through the generated mcp.json. It resolves its own memory root and runs
+    // until the transport closes, so it never returns a non-zero code here.
+    if (command === "serve") {
+        await startServer(argv.slice(1));
+        return 0;
+    }
+    let root;
+    try {
+        root = resolveMemoryRoot({ rootFlag: parseFlag(argv, "--root") });
+    }
+    catch (e) {
+        err(e.message);
+        return 1;
+    }
+    switch (command) {
+        case "init":
+            return cmdInit(root);
+        case "validate":
+            return cmdValidate(root);
+        default:
+            err(`Unknown command: ${command}`);
+            usage();
+            return 1;
+    }
+}
+// Only auto-run when invoked directly (not when imported by tests).
+const invokedDirectly = process.argv[1] !== undefined &&
+    path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+if (invokedDirectly) {
+    run()
+        .then((code) => process.exit(code))
+        .catch((e) => {
+        err(`fatal: ${e.message}`);
+        process.exit(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":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * index.ts — bootstrap. Wires the McpServer to a StdioServerTransport.
+ *
+ * All logging goes to stderr; stdout is reserved for the MCP protocol.
+ */
+export declare function main(argv?: string[]): Promise<void>;
+//# 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;;;;GAIG;AAqBH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhF"}

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * index.ts — bootstrap. Wires the McpServer to a StdioServerTransport.
+ *
+ * All logging goes to stderr; stdout is reserved for the MCP protocol.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveMemoryRoot } from "./store.js";
+import { MemoryIndex } from "./search.js";
+import { registerAllTools, SERVER_INFO } from "./server.js";
+function log(message) {
+    process.stderr.write(`[repomem] ${message}\n`);
+}
+/** Read an optional `--root <path>` from argv. */
+function parseRootFlag(argv) {
+    const i = argv.indexOf("--root");
+    if (i !== -1 && i + 1 < argv.length)
+        return argv[i + 1];
+    return undefined;
+}
+export async function main(argv = process.argv.slice(2)) {
+    const root = resolveMemoryRoot({ rootFlag: parseRootFlag(argv) });
+    log(`memory root: ${root}`);
+    const index = new MemoryIndex(root);
+    const server = new McpServer(SERVER_INFO);
+    registerAllTools(server, root, index);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log("server ready on stdio");
+}
+// Only auto-run when invoked directly (e.g. `node dist/index.js`), not when
+// imported (the CLI imports `main` to implement the `serve` subcommand).
+const invokedDirectly = process.argv[1] !== undefined &&
+    path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+if (invokedDirectly) {
+    main().catch((err) => {
+        log(`fatal: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# 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;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,OAAO,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,kDAAkD;AAClD,SAAS,aAAa,CAAC,IAAc;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAE5B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1C,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC/B,CAAC;AAED,4EAA4E;AAC5E,yEAAyE;AACzE,MAAM,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;IAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEnE,IAAI,eAAe,EAAE,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5B,GAAG,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}