@digi4care/omo-slim-decision-layer 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Engelhard
+
+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,89 @@
-# Temporary Holding Version
+# omo-slim-decision-layer
 
-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.
+An [OpenCode](https://opencode.ai) plugin that adds a **decision layer** to
+AI-assisted development: a typed, git-native decision register that records the
+*why* of a project — requirements, constraints, assumptions and decisions —
+with the same ergonomics that [beads](https://github.com/steveyegge/beads)
+gives work items.
+
+Built as a companion plugin for
+[oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim).
+
+## What it does
+
+- **Typed decision records** — `REQ` (requirement), `CONSTRAINT`
+  (non-negotiable), `ASSUMPTION` (unverified, with `needed_to_close`) and `DEC`
+  (decision with rejected alternatives and consequences).
+- **Single source of truth** — one YAML register at `.decisions/register.yaml`.
+  All writes go through the plugin's tools; the generated markdown view is
+  disposable and never authoritative.
+- **Closed vocabularies** — status is `proposed | accepted | rejected |
+  superseded`. Supersede instead of edit: history stays append-only.
+- **Owner ratification** — agents draft records; only the owner ratifies.
+  This is a convention enforced by discipline, not by a technical gate.
+- **Interview integration** — when oh-my-opencode-slim's `/interview` command
+  runs, the plugin injects a discipline prompt so a closed interview ends as
+  records in the register instead of loose markdown.
+- **Traceability** — typed links (`refines`, `depends_on`, `constrains`,
+  `relates_to`) between records, with queries for orphans and reverse lookup.
+
+## Agent tools
+
+| Tool | Purpose |
+|---|---|
+| `decision-init` | Create the register (idempotent, never overwrites) |
+| `decision-add` | Create a record (status `proposed`) |
+| `decision-ratify` | `proposed` → `accepted` — owner act, never self-invoked |
+| `decision-reject` | `proposed` → `rejected` |
+| `decision-supersede` | Replace a record, preserving history |
+| `decision-list` | List records, filter by status/type |
+| `decision-query` | Orphans, or "what links to this record" |
+| `decision-validate` | Validate the register against the schema |
+| `decision-view` | Regenerate the markdown view |
+
+## Install
+
+Add the plugin to your OpenCode config:
+
+```jsonc
+{
+  "plugin": ["@digi4care/omo-slim-decision-layer@latest"]
+}
+```
+
+OpenCode installs the plugin automatically from npm on the next start. To pin
+a version, replace `@latest` with a specific version (e.g. `@0.2.1`).
+
+**Local development / offline use.** Every release is also packed as a plain
+`.tgz` in the `release/` folder (semver). A named entry only works for packages
+that exist on npm; for a local or private build, reference the built file
+directly instead:
+
+```jsonc
+{
+  "plugin": ["file:///absolute/path/to/node_modules/@digi4care/omo-slim-decision-layer/dist/index.js"]
+}
+```
+
+`dist/index.js` is a single bundle; only `@opencode-ai/plugin` and `zod` are
+external, so the host supplies those.
+
+## Development
+
+```bash
+bun install
+bun test          # bun test
+bun run typecheck # tsc --noEmit
+bun run check     # biome
+bun run release   # build + pack tgz into release/
+```
+
+## Author
+
+**Chris Engelhard** — [chrisengelhard.nl](https://chrisengelhard.nl) —
+[chris@chrisengelhard.nl](mailto:chris@chrisengelhard.nl) —
+[@digi4care](https://github.com/digi4care)
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const ConfigSchema: z.ZodObject<{
+    registerPath: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type DecisionLayerConfig = z.infer<typeof ConfigSchema>;
+export declare function loadConfig(worktree: string): DecisionLayerConfig;

package/dist/hooks/interview-inject.d.ts

@@ -0,0 +1,2 @@
+import type { Hooks } from '@opencode-ai/plugin';
+export declare function createInterviewInjectHook(): NonNullable<Hooks['command.execute.before']>;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin } from '@opencode-ai/plugin';
+declare const _default: {
+    id: string;
+    server: Plugin;
+};
+export default _default;