Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion apps/streamdeck/com.cluesmith.codev.sdPlugin/manifest.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"UUID": "com.cluesmith.codev",
"Name": "Codev",
"Version": "3.3.5.0",
"Version": "3.3.6.0",
"Author": "Cluesmith",
"Category": "Codev",
"CategoryIcon": "icons/category",
Expand Down
2 changes: 1 addition & 1 deletion apps/streamdeck/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cluesmith/codev-streamdeck",
"version": "3.3.5",
"version": "3.3.6",
"private": true,
"description": "Codev Stream Deck plugin — a controller that drives Codev via Tower's command relay + overview API.",
"type": "module",
Expand Down
2 changes: 1 addition & 1 deletion apps/vscode/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"publisher": "cluesmith",
"displayName": "Codev for VS Code",
"description": "Codev helps humans and agents co-develop both the context and the code of the project.",
"version": "3.3.5",
"version": "3.3.6",
"license": "Apache-2.0",
"icon": "icons/codev.png",
"pricing": "Free",
Expand Down
58 changes: 58 additions & 0 deletions docs/releases/v3.3.6-luxor.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# v3.3.6 Luxor

Released: 2026-10-19

## Summary

3.3.6 is a one-change patch: the process that goes with the Decisions tab. 3.3.5 shipped
the tab, which turns `codev/state/pending-decisions.md` into cards and writes the owner's
word back into the file, but the agreement behind it, what an item looks like, how an
architect sends one, and what the hub architect does with each ruling, existed only in one
adopter's repository. This release puts that document in the framework, points the architect
role at it, and pins its format to the code with a test.

## The owner decisions process (#1826, PR #1832)

`resources/decision-protocol.md` now ships in the Codev skeleton. It describes the loop end
to end:

- **One file, one hub.** Every ask for the owner's word is one item in
`codev/state/pending-decisions.md`; one architect named `main` is the hub and the only
agent that edits the file. Other architects send items with
`afx send architect:main 'DECISION <name>-<n>: <question> …'`.
- **The item.** A `###` heading of id, time stamp with its zone, and the question; a short
body of labelled lines (Problem, Options, Fix, Testing, Recommendation, Links); and one
`**Your word:**` line whose backticked, `/`-separated words become the card's buttons, the
first one marked as recommended.
- **What the tab reads.** The exact parsing rules: which headings are items, which zones the
stamp converts from, how a bare word takes its description from the `**Options:**` line,
and how a question-and-answer thread shows on the card.
- **What the hub does.** Post, learn of rulings (from the tab, the file or chat), answer
questions, relay `RULING <id>: <word>` to the asking architect with the owner's comment
carried verbatim, record the ruling and its `DONE` line under `## Ruled`, and scan the file
on every resume.

The architect role gained a three-line pointer to the document, and the Tower command
reference links it from its Decisions tab section. A new test runs the document's own
fenced examples through the Decisions tab's parser, splicer, notice builder and stamp
resolver, so the document cannot drift from the code without failing CI.

The document resolves from the installed package: `codev init`, `adopt` and `update` do not
yet copy skeleton reference documents into an adopter's `codev/resources/`. Until #1834
lands, read it in the package under `skeleton/resources/decision-protocol.md`, or on GitHub
at `codev-skeleton/resources/decision-protocol.md`.

## Upgrade

```bash
npm install -g @cluesmith/codev@3.3.6
codev update
```

Nothing changes for a workspace without a decisions file: the tab appears only when the
file exists, and the hub notice goes only to an architect named `main`.

## Contributors

- **M Waleed Kadous (@waleedkadous)** — the decisions process document (PR #1832).
- The AIR builder for #1826.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "cluesmith-codev",
"version": "3.3.5",
"version": "3.3.6",
"private": true,
"packageManager": "pnpm@10.33.0",
"scripts": {
Expand Down
2 changes: 1 addition & 1 deletion packages/artifact-canvas/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cluesmith/codev-artifact-canvas",
"version": "3.3.5",
"version": "3.3.6",
"description": "Reusable React surface for rendering and reviewing Codev markdown artifacts (specs/plans/reviews) across VSCode, the dashboard, and future mobile hosts.",
"type": "module",
"exports": {
Expand Down
2 changes: 1 addition & 1 deletion packages/codev/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cluesmith/codev",
"version": "3.3.5",
"version": "3.3.6",
"description": "Codev CLI - AI-assisted software development framework",
"type": "module",
"bin": {
Expand Down
2 changes: 1 addition & 1 deletion packages/core/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cluesmith/codev-core",
"version": "3.3.5",
"version": "3.3.6",
"description": "Server-side runtime for Codev — local-key issuance and homedir-derived paths. Client-side Tower access lives in @cluesmith/codev-sdk; the two packages never import each other.",
"type": "module",
"exports": {
Expand Down
2 changes: 1 addition & 1 deletion packages/sdk/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cluesmith/codev-sdk",
"version": "3.3.5",
"version": "3.3.6",
"description": "Client SDK for Tower: the single implementation of how anything talks to Tower. Environment-agnostic (browser, Node, React Native); auth and transport arrive as injected adapters.",
"type": "module",
"exports": {
Expand Down
2 changes: 1 addition & 1 deletion packages/types/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cluesmith/codev-types",
"version": "3.3.5",
"version": "3.3.6",
"description": "Shared TypeScript types for Codev — WebSocket protocol, API shapes, SSE events",
"type": "module",
"exports": {
Expand Down
Loading