@kody-ade/kody-engine 0.4.399 → 0.4.401

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -56,7 +56,7 @@ key. It's built to keep that blast radius small:
56
56
  write. A dedicated `KODY_TOKEN` PAT is optional, only for triggering
57
57
  downstream CI.
58
58
  - **Write allowlist.** The agent commits through `commitAndPush`, which blocks
59
- writes outside an allowlisted set of `.kody/` paths — it can't touch your
59
+ writes to engine runtime or configuration paths — it can't touch your
60
60
  runtime state.
61
61
  - **Locked-toolbox mode.** A job can declare `tools: [...]` to drop `Bash` and
62
62
  shell entirely, running only a fixed set of high-level intents.
@@ -76,7 +76,7 @@ See [SECURITY.md](SECURITY.md) to report a vulnerability.
76
76
  │ bin/kody.ts — entrypoint │
77
77
  │ src/dispatch.ts — capability-driven routing │
78
78
  │ src/executor.ts — runs capability implementations │
79
- .kody/capabilities/<slug>/
79
+ backend capability definition
80
80
  │ profile.json · capability.md · optional skills/scripts │
81
81
  │ src/scripts/*.ts — cross-cutting catalog │
82
82
  └─────────────────────────────────────────────┘
@@ -86,7 +86,7 @@ Every top-level command is an auto-discovered capability action. The router has
86
86
  **zero implementation names hardcoded** - comment dispatch resolves the first token
87
87
  after `@kody` through `config.aliases`, then falls back to
88
88
  `config.defaultImplementation` / `config.defaultPrImplementation` as default
89
- capability actions. Drop a new `.kody/capabilities/<slug>/` directory with
89
+ capability actions. Drop a new `backend capability definition` directory with
90
90
  `profile.json` + `capability.md`.
91
91
 
92
92
  Capability implementation profiles are private implementation units and contain
@@ -134,10 +134,10 @@ kody-engine release-deploy --issue <N> [--dry-run]
134
134
  kody-engine npm-publish [--tag latest] [--access public] [--dry-run]
135
135
 
136
136
  # scheduled capabilities and goals
137
- kody-engine capability-scheduler # fan out due .kody/capabilities/<slug>/ folders plus legacy fallbacks
137
+ kody-engine capability-scheduler # fan out due backend capability definition folders plus legacy fallbacks
138
138
  kody-engine capability-tick --capability <slug> [--force] # one agent tick for one capability
139
139
  kody-engine capability-tick-scripted --capability <slug> [--force] # one deterministic tickScript capability tick
140
- kody-engine goal-scheduler # fan out active goal instances in configured state repo
140
+ kody-engine goal-scheduler # fan out active goal instances in configured backend
141
141
  kody-engine goal-manager --goal <id> # advance one managed goal instance
142
142
 
143
143
  # setup, servers, and utilities
@@ -154,7 +154,7 @@ kody-engine stats # inspect run/even
154
154
 
155
155
  ### Capabilities
156
156
 
157
- A **capability** is a folder at `.kody/capabilities/<slug>/` with
157
+ A **capability** is a folder at `backend capability definition` with
158
158
  `profile.json` metadata (`action`, `capabilityKind`, `agent`, `every`, and
159
159
  related fields) plus human-owned prose in `capability.md`. The scheduler wakes
160
160
  on cron, finds due capabilities, and dispatches either
@@ -173,7 +173,7 @@ without `tools` keep the legacy Bash/gh toolbox.
173
173
  ## Profiles
174
174
 
175
175
  A profile is declarative JSON plus an adjacent markdown body. New public work
176
- should live under `.kody/capabilities/<slug>/` with `capability.md`; legacy
176
+ should live under `backend capability definition` with `capability.md`; legacy
177
177
  implementations under [src/implementations/](src/implementations/) still show the
178
178
  older split profile + prompt shape. Adding a new capability should not require
179
179
  executor, entry, or dispatch changes.