blun-king-cli 9.1.67 → 9.1.68

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.61
+  npm install -g blun-king-cli@9.1.68
 
 Start
 -----
@@ -98,6 +98,22 @@ Chancen mit Gegenbeleg, Abbruchkriterium und einem direkt nutzbaren
 /idea-Auftrag. Ohne Nische fragt er zuerst genau einmal nach. Schwache Belege
 ergeben weniger Treffer oder no_action, niemals aufgefüllte Vorschläge.
 
+Venture Flywheel: geprüfte Phase-0-Verträge
+--------------------------------------------
+Der Standardskill venture-flywheel enthält reine Verträge für
+Projektidentität, Repository-Trust, Capability-Entscheidungen, versionierte
+Laufzustände und hash-verkettete Prüfereignisse. Phase 0 führt selbst keine
+Befehle, Netzwerkzugriffe oder Deployments aus.
+
+Ein vollständiges CommonJS-Beispiel für alle sieben öffentlichen Funktionen
+liegt hier:
+
+  standard-skills/venture-flywheel/references/BEISPIELE-phase0.md
+
+Es zeigt unter anderem, warum sandbox.execute im Repository abgewiesen, in
+einem isolierten Worktree aber erlaubt wird und wie eine Ereigniskette geprüft
+wird.
+
 Im automatisch angebundenen Telegram-Kanal werden ausschließlich /loop, /goal,
 /idea, /chancenradar, /curiosity, /scout und /befehle als Befehle ausgeführt. Ist der Agent beschäftigt, bleiben
 sie in der Warteschlange. Andere Slash-Eingaben werden aus Sicherheitsgründen

package/README.md

@@ -9,7 +9,7 @@ Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
 installiert:
 
 ```powershell
-npm install -g blun-king-cli@9.1.61
+npm install -g blun-king-cli@9.1.68
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -122,6 +122,19 @@ Der sichtbare Verlauf behält standardmäßig die vollständige laufende und
 wiederhergestellte Sitzung. Das Mausrad kann den Verlauf direkt beim ersten Zug
 öffnen; Editor und Fußzeile bleiben dabei fest sichtbar.
 
+## Venture Flywheel: geprüfte Phase-0-Verträge
+
+Der mitgelieferte Standardskill `venture-flywheel` stellt reine, deterministische
+Verträge für Projektidentität, Repository-Trust, Capability-Entscheidungen,
+versionierte Laufzustände und hash-verkettete Prüfereignisse bereit. Phase 0
+führt selbst keine Befehle, Netzwerkzugriffe oder Deployments aus.
+
+Ein vollständiges CommonJS-Beispiel für alle sieben öffentlichen Funktionen
+liegt unter
+`standard-skills/venture-flywheel/references/BEISPIELE-phase0.md`. Es zeigt
+unter anderem, warum `sandbox.execute` im Repository abgewiesen, in einem
+isolierten Worktree aber erlaubt wird und wie eine Ereigniskette geprüft wird.
+
 Im automatisch angebundenen Telegram-Kanal werden ausschließlich `/loop`,
 `/goal`, `/idea`, `/chancenradar`, `/curiosity`, `/scout` und `/befehle` als Befehle ausgeführt. Ist der Agent
 beschäftigt, bleiben sie in der Warteschlange. Andere Slash-Eingaben werden aus

package/blun.mjs

@@ -417230,7 +417230,6 @@ var TelegramChannelController = class {
 	stopped = false;
 	activeOwner = false;
 	ownershipLost = false;
-	handoffWarningShown = false;
 	ownershipClaimedAt = 0;
 	ownedBridge;
 	stopPromise;
@@ -417367,9 +417366,9 @@ var TelegramChannelController = class {
 			this.activateOwnedChannel();
 			return;
 		}
-		if (!this.handoffWarningShown && Date.now() - this.ownershipClaimedAt >= this.ownershipHandoffWarningMs) {
-			this.handoffWarningShown = true;
-			this.host.warn(uiText("telegramChannel.bridgeStartFailed", { error: "telegram ownership handoff is still pending" }));
+		if (Date.now() - this.ownershipClaimedAt >= this.ownershipHandoffWarningMs) {
+			this.activateOwnedChannel();
+			return;
 		}
 		this.handoffTimer = setTimeout(() => this.tryActivateOwnership(), this.ownershipPollMs);
 		this.handoffTimer.unref();
@@ -514664,6 +514663,7 @@ var BlunTUI = class {
 				});
 				this.syncChannelQueueDeadline();
 				this.channelQueueDeadline.requestDeliveryNow();
+				this.scheduleQueueDrain();
 				this.track("input_queue");
 				this.updateQueueDisplay();
 				this.state.ui.requestRender();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blun-king-cli",
-  "version": "9.1.67",
+  "version": "9.1.68",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {

package/standard-skills/venture-flywheel/SKILL.md

@@ -26,3 +26,7 @@ Read [references/CAPABILITY-MAP.md](references/CAPABILITY-MAP.md) for the build
 order and [references/SPEC-phase0-state-events.md](references/SPEC-phase0-state-events.md)
 plus [references/SPEC-phase0-identity-trust.md](references/SPEC-phase0-identity-trust.md)
 for the currently implemented contracts.
+
+The German usage guide in
+[references/BEISPIELE-phase0.md](references/BEISPIELE-phase0.md) contains one
+complete example covering every public Phase 0 function.

package/standard-skills/venture-flywheel/references/BEISPIELE-phase0.md

@@ -0,0 +1,146 @@
+# Venture Flywheel: Beispiele für Phase 0
+
+Phase 0 stellt ausschließlich reine Verträge bereit. Sie führt keine
+Repository-Befehle aus, verwendet kein Netzwerk und führt weder Deployments
+noch Veröffentlichungen, Käufe oder ausgehende Nachrichten durch.
+
+## Öffentliche Funktionen
+
+- `deriveProjectIdentity` leitet aus Repository-Fakten und einem
+  authentifizierten Konto eine deterministische Projektidentität ab.
+- `createRepositoryTrust` erzeugt den anfänglichen Datensatz mit `UNTRUSTED`.
+- `transitionRepositoryTrust` wendet einen ausdrücklichen, versionierten
+  Trust-Wechsel an.
+- `evaluateCapability` liefert `allow`, `deny` oder `approval_required` und
+  entscheidet bei Unklarheit ablehnend.
+- `transitionRun` führt genau einen zulässigen, optimistisch versionierten
+  Zustandswechsel aus.
+- `createExecutionEvent` erzeugt ein deterministisches, hash-verkettetes
+  Prüfereignis und weist geheimnisverdächtige Felder in Nutzdaten ab.
+- `verifyEventChain` prüft Reihenfolge, Verknüpfungen und Hashes einer
+  vollständigen Ereigniskette.
+
+## Vollständiges Beispiel
+
+Das folgende CommonJS-Beispiel leitet eine Projektidentität ab, erzeugt lokalen
+Trust, vergleicht die Ausführung im Repository mit der Ausführung in einem
+isolierten Worktree, setzt einen Lauf fort, erzeugt zwei verkettete Ereignisse
+und prüft anschließend die Kette.
+
+```js
+const { deriveProjectIdentity } = require('./identity/project-identity.cjs');
+const {
+  CAPABILITIES,
+  createRepositoryTrust,
+  transitionRepositoryTrust,
+} = require('./policy/repository-trust.cjs');
+const { evaluateCapability } = require('./policy/capability-engine.cjs');
+const { transitionRun } = require('./state/task-state-machine.cjs');
+const {
+  createExecutionEvent,
+  verifyEventChain,
+} = require('./state/execution-event.cjs');
+
+const identity = deriveProjectIdentity({
+  repository_host: 'github.com',
+  repository_owner: 'example',
+  repository_name: 'venture',
+  canonical_remote_url: 'git@github.com:example/venture.git',
+  local_repository_root: 'C:/Work/venture',
+  initial_repository_fingerprint: `sha256:${'a'.repeat(64)}`,
+}, { account_id: 'account-123' });
+
+const initialTrust = createRepositoryTrust(identity);
+const localCapabilities = [
+  'network.none',
+  'repo.metadata.read',
+  'repo.read',
+  'sandbox.execute',
+  'workspace.write',
+  'worktree.create',
+];
+const granted = new Set(localCapabilities);
+const localTrust = transitionRepositoryTrust(initialTrust, {
+  event_id: 'evt-trust-local',
+  expected_version: initialTrust.version,
+  from_trust_level: initialTrust.trust_level,
+  to_trust_level: 'TRUSTED_LOCAL',
+  granted_capabilities: [...granted].sort(),
+  denied_capabilities: CAPABILITIES.filter(
+    (capability) => !granted.has(capability),
+  ),
+});
+
+const deniedInRepository = evaluateCapability({
+  project_identity: identity,
+  repository_trust: localTrust,
+  capability: 'sandbox.execute',
+  execution_scope: 'repository',
+});
+const allowedInWorktree = evaluateCapability({
+  project_identity: identity,
+  repository_trust: localTrust,
+  capability: 'sandbox.execute',
+  execution_scope: 'isolated_worktree',
+});
+
+let run = { run_id: 'run-001', state: 'discovered', version: 0 };
+run = transitionRun(run, {
+  event_id: 'evt-profiled',
+  expected_version: 0,
+  from_state: 'discovered',
+  to_state: 'profiled',
+});
+
+const firstEvent = createExecutionEvent({
+  event_id: 'evt-profiled',
+  run_id: run.run_id,
+  project_id: identity.project_id,
+  actor: { type: 'agent', id: 'agent-1', session_id: 'session-1' },
+  event_type: 'run.profiled',
+  occurred_at: '2026-08-24T10:00:00.000Z',
+  payload: {
+    from_state: 'discovered',
+    to_state: 'profiled',
+    version: run.version,
+  },
+});
+const secondEvent = createExecutionEvent({
+  event_id: 'evt-policy',
+  run_id: run.run_id,
+  project_id: identity.project_id,
+  actor: { type: 'agent', id: 'agent-1', session_id: 'session-1' },
+  event_type: 'policy.checked',
+  occurred_at: '2026-08-24T10:01:00.000Z',
+  payload: { decision: allowedInWorktree.decision },
+  previous_event_hash: firstEvent.event_hash,
+});
+
+console.log(deniedInRepository);
+console.log(allowedInWorktree);
+console.log(verifyEventChain([firstEvent, secondEvent]));
+```
+
+Erwartete Entscheidungen: Die Ausführung im Repository wird mit
+`isolated_worktree_required` abgewiesen, die Ausführung im isolierten Worktree
+wird erlaubt und die Kettenprüfung liefert `{ ok: true }`.
+
+## Wichtige Schutzregeln
+
+- Ein Repository beginnt mit `UNTRUSTED`; Trust-Hochstufungen müssen
+  nacheinander erfolgen.
+- Jeder Trust- und Laufwechsel muss die aktuelle `expected_version` verwenden.
+- `workspace.write` und `sandbox.execute` erfordern
+  `execution_scope: 'isolated_worktree'`.
+- Externe oder irreversible Fähigkeiten liefern niemals `allow`, sondern
+  höchstens `approval_required`.
+- `completed` erfordert `final_evidence_id`, `rolled_back` erfordert
+  `rollback_evidence_id` innerhalb von `evidence`.
+- Ereignisnutzdaten mit Feldern wie `token`, `password`, `secret`, `api_key`
+  oder `access_token` werden vor dem Hashen abgewiesen.
+- `no_action` ist ein gültiges Endergebnis.
+
+## Prüfung
+
+Führe `node --test test/venture-flywheel-state.test.js`,
+`node --test test/venture-flywheel-trust.test.js` und `npm test` aus.