# runtimeTraceJournal

A runtime trace journal record carrying name, entries, nextSequence, taskTransitionCount, tunnelTransitionCount, and related state.

Last updated: 2026-09-09

Package: diagnostics | Status: source-declared

Tags: cpu, diagnostics, method, source-example, thing, yeho

Describe failures, collect runtime traces, and make execution observable.

```yh
external thing runtimeTraceJournal
```

- text name: Stores name as text.
- list of runtimeTraceRecord entries: Stores entries as list of runtimeTraceRecord.
- int nextSequence: Stores next sequence as int.
- int taskTransitionCount: Stores task transition count as int.
- int tunnelTransitionCount: Stores tunnel transition count as int.
- int asyncTransitionCount: Stores async transition count as int.
- int failureTransitionCount: Stores failure transition count as int.
- runtimeTraceJournal(text name): Runtime trace journal.
- Count() returns int: Count.
- TaskTransitionCount() returns int: Task transition count.
- TunnelTransitionCount() returns int: Tunnel transition count.
- AsyncTransitionCount() returns int: Async transition count.
- FailureTransitionCount() returns int: Failure transition count.
- Entries() returns list of runtimeTraceRecord: Entries.
- TaskTransitions() returns list of runtimeTraceRecord: Task transitions.
- TunnelTransitions() returns list of runtimeTraceRecord: Tunnel transitions.
- AsyncTransitions() returns list of runtimeTraceRecord: Async transitions.
- FailureTransitions() returns list of runtimeTraceRecord: Failure transitions.
- RecordTransition(text kind, text subject, text state, text detail, text cause, text nextStep): Record transition.
- RecordTaskTransition(text subject, text state, text detail, text cause, text nextStep): Record task transition.
- RecordTunnelTransition(text subject, text state, text detail, text cause, text nextStep): Record tunnel transition.
- RecordAsyncTransition(text subject, text state, text detail, text cause, text nextStep): Record async transition.
- RecordFailureTransition(text subject, text state, text detail, text cause, text nextStep): Record failure transition.
- Describe() returns text: Describe.
- Render() returns text: Render.

## Use runtimeTraceJournal

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

Verification: type checked

```yh
using diagnostics

// Describe failures, collect runtime traces, and make execution observable.
runtimeTraceJournal sample = runtimeTraceJournal("Nova")
Console.Log(Text.From(sample.name))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.Count

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Count.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
int result = instance.Count()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-Count-8 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.TaskTransitionCount

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Task transition count.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
int result = instance.TaskTransitionCount()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-TaskTransitionCount-9 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.TunnelTransitionCount

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Tunnel transition count.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
int result = instance.TunnelTransitionCount()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-TunnelTransitionCount-10 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.AsyncTransitionCount

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Async transition count.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
int result = instance.AsyncTransitionCount()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-AsyncTransitionCount-11 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.FailureTransitionCount

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Failure transition count.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
int result = instance.FailureTransitionCount()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-FailureTransitionCount-12 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.Entries

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Entries.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
list of runtimeTraceRecord result = instance.Entries()
Console.Log(Text.From(result.count))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-Entries-13 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.TaskTransitions

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Task transitions.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
list of runtimeTraceRecord result = instance.TaskTransitions()
Console.Log(Text.From(result.count))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-TaskTransitions-14 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.TunnelTransitions

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Tunnel transitions.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
list of runtimeTraceRecord result = instance.TunnelTransitions()
Console.Log(Text.From(result.count))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-TunnelTransitions-15 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.AsyncTransitions

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Async transitions.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
list of runtimeTraceRecord result = instance.AsyncTransitions()
Console.Log(Text.From(result.count))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-AsyncTransitions-16 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.FailureTransitions

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Failure transitions.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
list of runtimeTraceRecord result = instance.FailureTransitions()
Console.Log(Text.From(result.count))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-FailureTransitions-17 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.RecordTransition

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Record transition.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
text argument_kind = "argument kind"
text argument_subject = "argument subject"
text argument_state = "argument state"
text argument_detail = "argument detail"
text argument_cause = "argument cause"
text argument_nextStep = "argument next Step"
instance.RecordTransition(argument_kind, argument_subject, argument_state, argument_detail, argument_cause, argument_nextStep)
Console.Log("RecordTransition completed")

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-RecordTransition-18 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.RecordTaskTransition

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Record task transition.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
text argument_subject = "argument subject"
text argument_state = "argument state"
text argument_detail = "argument detail"
text argument_cause = "argument cause"
text argument_nextStep = "argument next Step"
instance.RecordTaskTransition(argument_subject, argument_state, argument_detail, argument_cause, argument_nextStep)
Console.Log("RecordTaskTransition completed")

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-RecordTaskTransition-19 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.RecordTunnelTransition

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Record tunnel transition.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
text argument_subject = "argument subject"
text argument_state = "argument state"
text argument_detail = "argument detail"
text argument_cause = "argument cause"
text argument_nextStep = "argument next Step"
instance.RecordTunnelTransition(argument_subject, argument_state, argument_detail, argument_cause, argument_nextStep)
Console.Log("RecordTunnelTransition completed")

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-RecordTunnelTransition-20 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.RecordAsyncTransition

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Record async transition.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
text argument_subject = "argument subject"
text argument_state = "argument state"
text argument_detail = "argument detail"
text argument_cause = "argument cause"
text argument_nextStep = "argument next Step"
instance.RecordAsyncTransition(argument_subject, argument_state, argument_detail, argument_cause, argument_nextStep)
Console.Log("RecordAsyncTransition completed")

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-RecordAsyncTransition-21 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.RecordFailureTransition

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Record failure transition.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
text argument_subject = "argument subject"
text argument_state = "argument state"
text argument_detail = "argument detail"
text argument_cause = "argument cause"
text argument_nextStep = "argument next Step"
instance.RecordFailureTransition(argument_subject, argument_state, argument_detail, argument_cause, argument_nextStep)
Console.Log("RecordFailureTransition completed")

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-RecordFailureTransition-22 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.Describe

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Describe.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
text result = instance.Describe()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-Describe-23 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## runtimeTraceJournal.Render

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using diagnostics

// Render.
runtimeTraceJournal instance = runtimeTraceJournal("Nova")
text result = instance.Render()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.diagnostics__runtimetracejournal"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "console"
version = "0.1.0"
path = "../../../yeho/packages/console"

[[dependencies]]
package = "diagnostics"
version = "0.1.0"
path = "../../../yeho/packages/diagnostics"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/diagnostics--runtimeTraceJournal/method-Render-24 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

Source: yeho/packages/diagnostics/runtime_trace.yh

AI training permission: https://demonhunterlabs.com/ai-use