@jjanczur/tyran 0.1.28 → 0.1.29
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/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +70 -0
- package/README.md +64 -26
- package/package.json +1 -1
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
{
|
|
12
12
|
"name": "tyran",
|
|
13
13
|
"description": "A task conductor for Claude Code: multi-agent orchestration with an enforced evidence contract, repo-specific learning, and update-safe local evolution.",
|
|
14
|
-
"version": "0.1.
|
|
14
|
+
"version": "0.1.29",
|
|
15
15
|
"source": "./",
|
|
16
16
|
"author": {
|
|
17
17
|
"name": "Jacek Janczura",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tyran",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.29",
|
|
4
4
|
"description": "A task conductor for Claude Code: multi-agent orchestration with an enforced evidence contract, repo-specific learning, and update-safe local evolution.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Jacek Janczura",
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,75 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.29 — 2026-08-16
|
|
4
|
+
|
|
5
|
+
Tyran has videos. Five cuts, and a page that says which one to send.
|
|
6
|
+
|
|
7
|
+
### The slate
|
|
8
|
+
|
|
9
|
+
A 3:20 explainer, a 3:53 first-session tutorial, and three vertical shorts —
|
|
10
|
+
the mistake, the board, the retrospective. Built with Hyperframes (HTML in,
|
|
11
|
+
deterministic MP4 out) and a Gemini voiceover, with burned-in captions and an
|
|
12
|
+
`.srt` sidecar each.
|
|
13
|
+
|
|
14
|
+
They are not five lengths of one video, which is the point of
|
|
15
|
+
[`docs/videos.md`](docs/videos.md): each answers a different question, and the
|
|
16
|
+
shorts and the tutorial fail at each other's jobs. The explainer argues, the
|
|
17
|
+
tutorial instructs, the board short shows rather than argues, and the retro
|
|
18
|
+
short is the only one whose subject is restraint.
|
|
19
|
+
|
|
20
|
+
### The written surfaces now say what the video says
|
|
21
|
+
|
|
22
|
+
The README and the landing hero were accurate and abstract where the explainer
|
|
23
|
+
is concrete. Both now open on the same sentence it does — your most expensive
|
|
24
|
+
model renaming a variable in the same chat it judged an authentication
|
|
25
|
+
boundary — and carry the manager framing through to the board, the bill and the
|
|
26
|
+
retro. Two descriptions of one product drifting apart is the defect this repo
|
|
27
|
+
calls ADR-21, and the video is now the widest-reach description of Tyran, so it
|
|
28
|
+
is the one the prose should agree with.
|
|
29
|
+
|
|
30
|
+
### The claims in the explainer, checked against the code
|
|
31
|
+
|
|
32
|
+
Every spoken claim was audited (`NOTES-REQUESTS.md` §10). Nine are exact, and
|
|
33
|
+
several turn out to be near-verbatim quotes of the mechanism's own
|
|
34
|
+
documentation: the four-question interview batch, the reviewer that ships with
|
|
35
|
+
no editing tools, the role floor applied after both the risk shift and the
|
|
36
|
+
override, and the three-to-knowledge / five-to-law ladder.
|
|
37
|
+
|
|
38
|
+
Two are not, and are recorded rather than quietly left:
|
|
39
|
+
|
|
40
|
+
- **"cheap tier, read only"** — the scout is granted `Bash`. *"You change
|
|
41
|
+
nothing"* is the first line of its instructions, which is the one form of
|
|
42
|
+
guarantee this project refuses to accept anywhere else. The fix is a
|
|
43
|
+
read-only agent class in the policy gate, not a rewording.
|
|
44
|
+
- **"this is not an estimate, it is the bill"** — the figures are exactly what
|
|
45
|
+
the sandbox board shows (404 requests, 4.53M tokens, 54.9% conductor) and the
|
|
46
|
+
rollup computing them is the real one, but the usage feeding it is authored,
|
|
47
|
+
and the board honestly labels those models `sample-large` / `sample-small`.
|
|
48
|
+
Publishing a real `cost.json` into the sandbox makes the line true and makes
|
|
49
|
+
the sandbox a better artefact than the video.
|
|
50
|
+
|
|
51
|
+
### What is in the repository, and what is not
|
|
52
|
+
|
|
53
|
+
The video *sources* are tracked — compositions, the voiceover pipeline, the
|
|
54
|
+
scripts, the storyboards — because they are text and they are how a cut gets
|
|
55
|
+
rebuilt. The renders are not. They come to roughly 430 MB, and this repository
|
|
56
|
+
is what `/plugin marketplace add jjanczur/tyran` clones, so committing them
|
|
57
|
+
would put marketing video into every install of the plugin. Git LFS was
|
|
58
|
+
considered and rejected on the same ground: a clone without `git-lfs` gets
|
|
59
|
+
pointer files, which breaks both the Pages build and the install.
|
|
60
|
+
|
|
61
|
+
`assets/video/` carries 1.1 MB of poster frames and caption sidecars, which is
|
|
62
|
+
everything the README and the docs page actually reference. The cuts live on
|
|
63
|
+
YouTube, and their IDs live in exactly one file,
|
|
64
|
+
`site/src/data/videos.json`.
|
|
65
|
+
|
|
66
|
+
Tyran's own secrets gate refused the first attempt at that commit — the payload
|
|
67
|
+
was past the 4 MiB it can scan inside its budget, and it refuses rather than
|
|
68
|
+
scanning a prefix, because a partial scan that reports nothing looks exactly
|
|
69
|
+
like a clean one. That is the gate behaving as designed, and it is what forced
|
|
70
|
+
the question of which bytes really needed to be in the tree. Two MP4s turned
|
|
71
|
+
out to be referenced by nothing.
|
|
72
|
+
|
|
3
73
|
## 0.1.28 — 2026-08-15
|
|
4
74
|
|
|
5
75
|
A maintenance release: the documentation site's dependencies, and three
|
package/README.md
CHANGED
|
@@ -14,6 +14,7 @@
|
|
|
14
14
|
<p align="center">
|
|
15
15
|
<b><a href="https://jjanczur.github.io/tyran/">📖 Documentation</a></b> ·
|
|
16
16
|
<a href="https://jjanczur.github.io/tyran/getting-started/">Getting started</a> ·
|
|
17
|
+
<a href="https://jjanczur.github.io/tyran/videos/">Videos</a> ·
|
|
17
18
|
<a href="https://jjanczur.github.io/tyran/architecture/">Architecture</a> ·
|
|
18
19
|
<a href="https://github.com/jjanczur/tyran/releases/latest">Releases</a>
|
|
19
20
|
</p>
|
|
@@ -22,41 +23,53 @@
|
|
|
22
23
|
|
|
23
24
|
## What Tyran is
|
|
24
25
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
rather than something you can check. Start a new session and you start
|
|
28
|
-
explaining from the beginning.
|
|
26
|
+
Your most expensive model just renamed a variable. In the same chat, it judged
|
|
27
|
+
an authentication boundary.
|
|
29
28
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
29
|
+
One chat, one model, every job — that is why the bill is high and the work gets
|
|
30
|
+
worse. The context fills up, the plan is somewhere in the scrollback, and
|
|
31
|
+
*"the tests pass"* is a sentence rather than something you can check.
|
|
32
|
+
|
|
33
|
+
**You didn't install a tool. You hired a manager.** You describe the work once;
|
|
34
|
+
he interviews you until the goal is unambiguous — batches of at most four
|
|
35
|
+
questions, each with his recommendation — turns the plan into tickets on a
|
|
36
|
+
board, and hands each piece to a **dedicated subagent with fresh context and a
|
|
37
|
+
model tier matched to how hard that piece actually is.** A good manager doesn't
|
|
38
|
+
put a principal engineer on a grep: a scout reads the repo on the cheap tier,
|
|
39
|
+
implementers take one story each on their own branch, the reviewer has no
|
|
40
|
+
editing tools at all, and security review always gets the strongest tier — a
|
|
41
|
+
floor no cost profile or flag can lower.
|
|
36
42
|
|
|
37
43
|
That is a cost lever and a quality lever at the same time. The conductor holds
|
|
38
44
|
the plan and never accumulates its agents' transcripts, which is where the
|
|
39
45
|
tokens in a long session actually go; and an agent that never saw the last six
|
|
40
46
|
failed attempts cannot inherit them, so the second opinion is a real one.
|
|
41
47
|
|
|
48
|
+
**Nothing you say is lost.** Remember something halfway through a run and say
|
|
49
|
+
it — it doesn't land in the scrollback, it becomes a ticket. Every decision,
|
|
50
|
+
spawn, report, merge and open question is appended to a journal **committed to
|
|
51
|
+
your repo**, so a restart, a compaction and a colleague on another branch all
|
|
52
|
+
read the same thing.
|
|
53
|
+
|
|
42
54
|
**It learns your repo while it works.** Setup reads how the repo is really
|
|
43
55
|
worked — stack, validation commands, how things get deployed — rather than
|
|
44
|
-
asking you to describe it.
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
Underneath, **
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
56
|
+
asking you to describe it. After every initiative the team runs a retrospective
|
|
57
|
+
on itself, and what it changes is Tyran, never your product code. The same
|
|
58
|
+
failure three times becomes knowledge pasted into every matching handoff; five
|
|
59
|
+
times and it becomes a rule in your `CLAUDE.md`, carrying the dates that earned
|
|
60
|
+
it. Most retros correctly change nothing.
|
|
61
|
+
|
|
62
|
+
All of it lands on one page — a **board**: what every agent is doing right now,
|
|
63
|
+
which questions are waiting on you (answer them there and the run carries on),
|
|
64
|
+
and what the work cost, in the tokens the platform itself reported, per model,
|
|
65
|
+
per agent and per ticket. The conductor gets its own row, so its overhead never
|
|
66
|
+
hides inside the total.
|
|
67
|
+
|
|
68
|
+
Underneath, **a hook decides before the tool ever runs** — none of this is a
|
|
69
|
+
prompt asking nicely. A report with no raw command output is refused: it blocks
|
|
70
|
+
silence, not forgery. Every write is classified against a policy file you own.
|
|
71
|
+
And a commit carrying a secret is refused, even inside a markdown file.
|
|
72
|
+
Mechanisms rather than instructions — which is the whole argument.
|
|
60
73
|
|
|
61
74
|
<p align="center">
|
|
62
75
|
<img src="assets/board-demo.gif" width="100%" alt="The Tyran dashboard, recorded live, moving through four of its tabs: Overview with what is waiting on you and the strip of running agents each showing the time since it last signalled; Board, where selecting a ticket opens its initiative, agents and spend; Waiting on you, the open questions above the commands that answer them; and Spend, toggling the same split between tokens and cost">
|
|
@@ -68,6 +81,31 @@ than instructions — which is the whole argument.
|
|
|
68
81
|
lanes, select a card.
|
|
69
82
|
</p>
|
|
70
83
|
|
|
84
|
+
### Watch it
|
|
85
|
+
|
|
86
|
+
<table>
|
|
87
|
+
<tr>
|
|
88
|
+
<td width="50%" align="center">
|
|
89
|
+
<a href="https://youtu.be/ThulYtbYNXI"><img src="assets/video/a-explainer-16x9.jpg" width="100%" alt="Still from the Tyran explainer: the routing table, with each role resolving to a model tier"></a><br>
|
|
90
|
+
<b><a href="https://youtu.be/ThulYtbYNXI">You Didn't Install a Tool — You Hired a Manager</a></b><br>
|
|
91
|
+
3:20 · the whole argument, end to end
|
|
92
|
+
</td>
|
|
93
|
+
<td width="50%" align="center">
|
|
94
|
+
<a href="https://youtu.be/vr49hKk9G8g"><img src="assets/video/a-onboarding-16x9.jpg" width="100%" alt="Still from the Tyran onboarding video: the install commands typed into a terminal"></a><br>
|
|
95
|
+
<b><a href="https://youtu.be/vr49hKk9G8g">Your First Session</a></b><br>
|
|
96
|
+
3:53 · install, run, read the board
|
|
97
|
+
</td>
|
|
98
|
+
</tr>
|
|
99
|
+
</table>
|
|
100
|
+
|
|
101
|
+
<p align="center">
|
|
102
|
+
Three 60-second cuts too —
|
|
103
|
+
<a href="https://www.youtube.com/shorts/2EgRBR0fVRo">the mistake</a> ·
|
|
104
|
+
<a href="https://www.youtube.com/shorts/HKePDLkYDqA">the board</a> ·
|
|
105
|
+
<a href="https://www.youtube.com/shorts/EMcPJj7c0mk">the retro</a> —
|
|
106
|
+
and <a href="https://jjanczur.github.io/tyran/videos/">which to send when</a>.
|
|
107
|
+
</p>
|
|
108
|
+
|
|
71
109
|
## What it gives you
|
|
72
110
|
|
|
73
111
|
- **Reports that carry evidence, or are refused.** A `SubagentStop` hook
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jjanczur/tyran",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.29",
|
|
4
4
|
"description": "Command-line scripts for the Tyran task conductor (doctor, journal, schema, and repo tooling) for CI and terminals outside Claude Code. Installing this package does NOT install the Claude Code plugin — add that separately with `/plugin marketplace add jjanczur/tyran` inside Claude Code.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"engines": {
|