Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)
Agent Journal 2.0 is the current Journal line, on main. It is not yet released, and breaking changes are expected before 2.0.0. Checked against markpollack/agent-journal@e161c779, snapshot 2.0.0-20261115.230849-26.
This walkthrough replays a sanitized real Claude Code 2.1.304 stream, kept in the agent-journal repository as a test fixture, into a package, then checks the package against the native input with the independent oracle. It needs no CLI and no account.
1. Resolve the snapshot
2.0 is not on Maven Central. Resolve the timestamped snapshot from the Central snapshot repository, and pin the timestamped version so the result stays reproducible:
See Using development snapshots from main for pinning one build and reading its provenance.Put that in the pom.xml of an empty project, then write the runtime classpath to a file:
fed stream.jsonl: 18 record(s) from native/stream.jsonlwrote out state COMPLETED81 event line(s) in events.jsonl
and exits 0. out/ now holds events.jsonl and run.json; run.json states package kind agent-journal/ocsf-package, layout 1.0.0. Verify prints its summary, ends with acceptance: ACCEPTED, writes the full report to report.json, and exits 0.
Reading the exit code
Only exit 0 is acceptance. Zero defects alone is not:
Exit
Meaning
0
Accepted
2
The reader refused the package (detached events file, unsupported version, pin mismatch); the raw lines are kept and nothing is interpreted
3
The oracle found a defect
4
No defect, but something is unresolved: a mandatory property is UNRESOLVED or UNSUPPORTED, a required check is missing, the package is not finalized, acquisition is not complete, no frozen expected-source manifest was supplied, or an acquired population was waived by a declared exclusion
64
Bad arguments
Next
Reading packages: the same package from Java, with the usage view and the oracle.
Capture: write a package from a live CLI instead of a recording.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Pollack AI Lab","colors":{"primary":"#4fc3f7","light":"#81d4fa","dark":"#0097a7"},"logo":{"light":"https://mintcdn.com/mcpjavasdk/vV_7S-Kh5_jdaxd-/logo/lab-light.svg?fit=max\u0026auto=format\u0026n=vV_7S-Kh5_jdaxd-\u0026q=85\u0026s=a123c4091fc6865b076075083c5b7cc7","dark":"https://mintcdn.com/mcpjavasdk/vV_7S-Kh5_jdaxd-/logo/lab-dark.svg?fit=max\u0026auto=format\u0026n=vV_7S-Kh5_jdaxd-\u0026q=85\u0026s=c3cb0c503d21faaa1f99441042d9173e"},"favicon":"https://mintcdn.com/mcpjavasdk/vV_7S-Kh5_jdaxd-/logo/favicon.svg?fit=max\u0026auto=format\u0026n=vV_7S-Kh5_jdaxd-\u0026q=85\u0026s=132d021cef95efd8a5bb2fc6c6560810","appearance":{"default":"dark"},"background":{"color":{"dark":"#020915"}},"navbar":{"links":[{"href":"https://pollack.ai","label":"pollack.ai"},{"href":"https://github.com/markpollack","type":"github"}],"primary":{"type":"button","label":"Read the Blog","href":"https://blog.pollack.ai"}},"banner":{"content":"[📓 Read the latest on the blog →](https://blog.pollack.ai)","dismissible":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"AgentWorks","icon":"cubes","href":"/projects#agentworks"},{"anchor":"Agento Forge","icon":"hammer","href":"/methodology/forge"},{"anchor":"Experiments","icon":"flask","href":"/experiments"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mcpjavasdk","hasAudioNarration":false,"actualSubdomain":"mcpjavasdk","customDomains":["lab.pollack.ai"],"gitSource":{"type":"github","owner":"markpollack","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afb5f3bdefb47a100b39cbc","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Projects","count":179},{"language":"default","tag":"AgentWorks","count":91},{"language":"default","tag":"Supporting Projects","count":69},{"language":"default","tag":"ACP Java SDK","count":67},{"language":"default","tag":"Tutorial","count":56},{"language":"default","tag":"Agent Client","count":24},{"language":"default","tag":"Agent Eval","count":17},{"language":"default","tag":"Agent Journal","count":15},{"language":"default","tag":"Concepts","count":14},{"language":"default","tag":"Reference","count":13}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 300;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 300;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 300;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 300;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 300;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 300;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\nh1,h2,h3,h4{font-family:'Geist Mono', ui-monospace, monospace!important;letter-spacing:0.02em}h1{font-weight:300!important;letter-spacing:0.06em}h2{font-weight:400!important;letter-spacing:0.04em}::selection{background:rgba(79, 195, 247, 0.25);color:#ffffff}[class*=\"Card\"] a:hover,.dark [class*=\"Card\"] a:hover{border-color:rgba(255, 215, 64, 0.5)!important;background:rgba(255, 215, 64, 0.03)!important}nav [class*=\"group\"]>span,nav [class*=\"Group\"]>span{font-family:'Geist Mono', ui-monospace, monospace!important;letter-spacing:0.12em;text-transform:uppercase;font-size:0.68rem}.dark pre{background:#020915!important;border:1px solid rgba(79, 195, 247, 0.15)}.dark :not(pre)>code{background:rgba(79, 195, 247, 0.08)!important;color:#81d4fa!important;border:1px solid rgba(79, 195, 247, 0.12)}.dark table{border-color:rgba(33, 150, 243, 0.2)}.dark th{font-family:'Geist Mono', ui-monospace, monospace!important;font-size:0.8rem;letter-spacing:0.08em;text-transform:uppercase;color:rgba(79, 195, 247, 0.7);border-bottom:1px solid rgba(79, 195, 247, 0.2)}.dark td{border-bottom:1px solid rgba(33, 150, 243, 0.1)}.dark span[style*=\"background: #22c55e\"],.dark span[style*=\"background: #3b82f6\"],.dark span[style*=\"background: #ffd740\"]{font-family:'Geist Mono', ui-monospace, monospace!important;letter-spacing:0.08em}.dark blockquote{border-left-color:#ffd740!important;background:rgba(255, 215, 64, 0.03)}.dark hr{border:none;height:1px;background:linear-gradient(90deg, rgba(79, 195, 247, 0.3), transparent)}.dark [class*=\"Note\"],.dark [class*=\"note\"]{border-color:rgba(79, 195, 247, 0.3);background:rgba(79, 195, 247, 0.04)}.dark [class*=\"Warning\"],.dark [class*=\"warning\"]{border-color:rgba(255, 215, 64, 0.4);background:rgba(255, 215, 64, 0.04)}.dark [class*=\"Step\"] [class*=\"indicator\"],.dark [class*=\"step\"] [class*=\"indicator\"]{border-color:rgba(79, 195, 247, 0.4)}footer{font-family:'Geist Mono', ui-monospace, monospace!important;letter-spacing:0.1em}.nav-tabs-item:first-child{font-size:0!important;line-height:0}.nav-tabs-item:first-child::after{content:\"Projects\";font-size:0.875rem;line-height:normal}.dark ::-webkit-scrollbar{width:6px}.dark ::-webkit-scrollbar-track{background:#020915}.dark ::-webkit-scrollbar-thumb{background:rgba(79, 195, 247, 0.2);border-radius:3px}.dark ::-webkit-scrollbar-thumb:hover{background:rgba(79, 195, 247, 0.4)}#banner{background:linear-gradient(90deg, rgba(79, 195, 247, 0.18), rgba(255, 215, 64, 0.12))!important;border-bottom:1px solid rgba(79, 195, 247, 0.35)}#banner a{font-family:'Geist Mono', ui-monospace, monospace!important;font-weight:600!important;letter-spacing:0.04em;color:#ffd740!important;text-decoration:none!important}#banner a:hover{color:#ffffff!important}"}]}
{"page":{"pagePath":"docs/agent-journal/v2/getting-started","slug":"/docs/agent-journal/v2/getting-started","pageMetadata":{"title":"Agent Journal 2.0: Getting Started","sidebarTitle":"Getting started","description":"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)","href":"/docs/agent-journal/v2/getting-started"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`Agent Journal 2.0 is the current Journal line, on main. It is not yet released, and breaking changes are expected before 2.0.0. Checked against `,_jsx(_components.code,{children:`markpollack/agent-journal@e161c779`}),`, snapshot `,_jsx(_components.code,{children:`2.0.0-20261115.230849-26`}),`.`]})}),`\n`,_jsx(_components.p,{children:`This walkthrough replays a sanitized real Claude Code 2.1.304 stream, kept in the agent-journal repository as a test fixture, into a package, then checks the package against the native input with the independent oracle. It needs no CLI and no account.`}),`\n`,_jsx(Heading,{level:`2`,id:`1-resolve-the-snapshot`,children:`1. Resolve the snapshot`}),`\n`,_jsx(_components.p,{children:`2.0 is not on Maven Central. Resolve the timestamped snapshot from the Central snapshot repository, and pin the timestamped version so the result stays reproducible:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`20`,language:`xml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`xml`,children:_jsxs(_components.code,{language:`xml`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`repositories`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`repository`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`central-snapshots`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`https://central.sonatype.com/repository/maven-snapshots/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`releases`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`enabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`enabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`releases`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`snapshots`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`enabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`enabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`updatePolicy`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`always`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`updatePolicy`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`snapshots`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`repository`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`repositories`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`dependencies`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`dependency`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`groupId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`io.github.markpollack`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`groupId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`artifactId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`journal-ocsf-writer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`artifactId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`version`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`2.0.0-20261115.230849-26`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`version`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`dependency`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`dependency`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`groupId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`io.github.markpollack`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`groupId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`artifactId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`journal-capture-tck`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`artifactId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`version`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`2.0.0-20261115.230849-26`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`version`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`dependency`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`dependencies`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/docs/development-snapshots`,children:`Using development snapshots from main`}),` for pinning one build and reading its provenance.`]}),`\n`,_jsxs(_components.p,{children:[`Put that in the `,_jsx(_components.code,{children:`pom.xml`}),` of an empty project, then write the runtime classpath to a file:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mvn`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -q`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` dependency:build-classpath`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -Dmdep.outputFile=cp.txt`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -Dmdep.includeScope=runtime`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`CP`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cat`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` cp.txt`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`2-get-the-recording`,children:`2. Get the recording`}),`\n`,_jsxs(_components.p,{children:[`The input is the fixture `,_jsx(_components.a,{href:`https://github.com/markpollack/agent-journal/tree/e161c779/journal-capture-tck/src/test/resources/ocsf/fixtures/claude-live-2.1.304-denial`,children:_jsx(_components.code,{children:`claude-live-2.1.304-denial`})}),`: a spec, the native stream and the frozen expected-source manifest.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`BASE`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`https://raw.githubusercontent.com/markpollack/agent-journal/e161c779/journal-capture-tck/src/test/resources/ocsf/fixtures/claude-live-2.1.304-denial`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mkdir`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -p`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` native`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sO`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` $BASE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/spec.json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` native/stream.jsonl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` $BASE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/native/stream.jsonl`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` native/expected-sources.json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` $BASE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/native/expected-sources.json`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The spec’s source path is a placeholder. Set `,_jsx(_components.code,{children:`sources[0].path`}),` to `,_jsx(_components.code,{children:`native/stream.jsonl`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sed`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -i.bak`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 's#\u003cfixture>/native/claude-live-2.1.304-denial/stream.jsonl#native/stream.jsonl#'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spec.json`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`3-replay-and-verify`,children:`3. Replay and verify`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`java`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -cp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$CP`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` io.github.markpollack.journal.ocsf.writer.OcsfWriterTool`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` replay`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spec.json`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` out`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`java`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -cp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$CP`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` io.github.markpollack.journal.tck.ocsf.OcsfReaderTool`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` verify`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` out`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` native`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` report.json`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --expected`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` native/expected-sources.json`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Replay prints:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`fed stream.jsonl: 18 record(s) from native/stream.jsonl`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`wrote out state COMPLETED`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`81 event line(s) in events.jsonl`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`and exits 0. `,_jsx(_components.code,{children:`out/`}),` now holds `,_jsx(_components.code,{children:`events.jsonl`}),` and `,_jsx(_components.code,{children:`run.json`}),`; `,_jsx(_components.code,{children:`run.json`}),` states package kind `,_jsx(_components.code,{children:`agent-journal/ocsf-package`}),`, layout `,_jsx(_components.code,{children:`1.0.0`}),`. Verify prints its summary, ends with `,_jsx(_components.code,{children:`acceptance: ACCEPTED`}),`, writes the full report to `,_jsx(_components.code,{children:`report.json`}),`, and exits 0.`]}),`\n`,_jsx(Heading,{level:`2`,id:`reading-the-exit-code`,children:`Reading the exit code`}),`\n`,_jsx(_components.p,{children:`Only exit 0 is acceptance. Zero defects alone is not:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Exit`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`0`}),_jsx(_components.td,{children:`Accepted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`2`}),_jsx(_components.td,{children:`The reader refused the package (detached events file, unsupported version, pin mismatch); the raw lines are kept and nothing is interpreted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`3`}),_jsx(_components.td,{children:`The oracle found a defect`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`4`}),_jsx(_components.td,{children:`No defect, but something is unresolved: a mandatory property is UNRESOLVED or UNSUPPORTED, a required check is missing, the package is not finalized, acquisition is not complete, no frozen expected-source manifest was supplied, or an acquired population was waived by a declared exclusion`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`64`}),_jsx(_components.td,{children:`Bad arguments`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`next`,children:`Next`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/agent-journal/v2/reading`,children:`Reading packages`}),`: the same package from Java, with the usage view and the oracle.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/docs/agent-journal/v2/capture`,children:`Capture`}),`: write a package from a live CLI instead of a recording.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent Journal 2.0: Getting Started","sidebarTitle":"Getting started","description":"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)","href":"/docs/agent-journal/v2/getting-started"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"1. Resolve the snapshot","slug":"1-resolve-the-snapshot","depth":2,"children":[]},{"title":"2. Get the recording","slug":"2-get-the-recording","depth":2,"children":[]},{"title":"3. Replay and verify","slug":"3-replay-and-verify","depth":2,"children":[]},{"title":"Reading the exit code","slug":"reading-the-exit-code","depth":2,"children":[]},{"title":"Next","slug":"next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"mcpjavasdk","siteName":"Pollack AI Lab","title":"Agent Journal 2.0: Getting Started - Pollack AI Lab","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T16:51:39.008Z","originalFileLocation":"docs/agent-journal/v2/getting-started.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pollack AI Lab\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent Journal 2.0: Getting Started - Pollack AI Lab\">\u003cmeta data-mint-head property=\"og:description\" content=\"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pollack AI Lab\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mcpjavasdk.mintlify.site/_mintlify/api/og/v2?division=Agent+Journal+2.0\u0026amp;title=Agent+Journal+2.0%3A+Getting+Started\u0026amp;description=Replay+a+real+Claude+Code+recording+into+an+Agent+Journal+2.0+package+and+verify+it+against+the+native+input+%28on+main%29\u0026amp;theme=0456974a4d42811676bca4e8\u0026amp;signature=94da94106222c777d7143cd441e3c950f95da9da9cd650cfebb050b4b6b24045\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Agent Journal 2.0: Getting Started - Pollack AI Lab\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mcpjavasdk.mintlify.site/_mintlify/api/og/v2?division=Agent+Journal+2.0\u0026amp;title=Agent+Journal+2.0%3A+Getting+Started\u0026amp;description=Replay+a+real+Claude+Code+recording+into+an+Agent+Journal+2.0+package+and+verify+it+against+the+native+input+%28on+main%29\u0026amp;theme=0456974a4d42811676bca4e8\u0026amp;signature=94da94106222c777d7143cd441e3c950f95da9da9cd650cfebb050b4b6b24045\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/mcpjavasdk/Mlmb3Lm_XQ1b3nx5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pollack AI Lab\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4fc3f7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/agent-journal/v2/getting-started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://lab.pollack.ai/#organization\",\"name\":\"Pollack AI Lab\",\"url\":\"https://lab.pollack.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mcpjavasdk/vV_7S-Kh5_jdaxd-/logo/lab-light.svg?fit=max\u0026auto=format\u0026n=vV_7S-Kh5_jdaxd-\u0026q=85\u0026s=a123c4091fc6865b076075083c5b7cc7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://lab.pollack.ai#website\",\"name\":\"Pollack AI Lab\",\"url\":\"https://lab.pollack.ai\",\"publisher\":{\"@id\":\"https://lab.pollack.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started#webpage\",\"url\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started\",\"name\":\"Agent Journal 2.0: Getting Started\",\"description\":\"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)\",\"dateModified\":\"2026-11-16T16:51:39.008Z\",\"isPartOf\":{\"@id\":\"https://lab.pollack.ai#website\"},\"breadcrumb\":{\"@id\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AgentWorks\",\"item\":\"https://lab.pollack.ai/projects/agentworks-bom\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent Journal\",\"item\":\"https://lab.pollack.ai/projects/agent-journal\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Agent Journal 2.0\",\"item\":\"https://lab.pollack.ai/docs/agent-journal/v2/overview\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Agent Journal 2.0: Getting Started\",\"item\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started#article\",\"headline\":\"Agent Journal 2.0: Getting Started\",\"name\":\"Agent Journal 2.0: Getting Started\",\"description\":\"Replay a real Claude Code recording into an Agent Journal 2.0 package and verify it against the native input (on main)\",\"url\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started\",\"mainEntityOfPage\":{\"@id\":\"https://lab.pollack.ai/docs/agent-journal/v2/getting-started#webpage\"},\"dateModified\":\"2026-11-16T16:51:39.008Z\",\"publisher\":{\"@id\":\"https://lab.pollack.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://lab.pollack.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pollack AI Lab\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Pollack AI Lab\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/agent-journal/v2/getting-started.md","siteName":"Pollack AI Lab","nav":{"global":{"anchors":[{"anchor":"AgentWorks","icon":"cubes","href":"/projects#agentworks"},{"anchor":"Agento Forge","icon":"hammer","href":"/methodology/forge"},{"anchor":"Experiments","icon":"flask","href":"/experiments"}]},"tabs":[{"tab":"Projects","groups":[{"group":"Projects","pages":[{"title":"Pollack AI Lab","sidebarTitle":"Overview","href":""},{"title":"What's New","sidebarTitle":"What's New","href":"/whats-new"},{"title":"Using development snapshots from main","sidebarTitle":"Development snapshots","href":"/docs/development-snapshots"},{"title":"Projects","href":"/projects/index"},{"group":"Bud","pages":[{"title":"Bud","href":"/projects/bud"}]}]},{"group":"AgentWorks","pages":[{"group":"AgentWorks BOM","pages":[{"title":"AgentWorks BOM","href":"/projects/agentworks-bom"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agentworks-bom/whats-new"},{"title":"Upgrading from org.springaicommunity coordinates","href":"/docs/agentworks-bom/upgrading-from-springaicommunity"}]},{"group":"Agent Workflow","pages":[{"title":"Agent Workflow","href":"/projects/agent-workflow"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-workflow/whats-new"},{"title":"AgentLoop","href":"/docs/agent-workflow/agent-loop"},{"title":"Getting Started with Agent Workflow","href":"/docs/agent-workflow/getting-started"},{"group":"Tutorial","pages":[{"title":"Typed Workflow Tutorial","href":"/docs/agent-workflow/tutorial"},{"title":"Runnable Workflow Examples","href":"/docs/agent-workflow/examples"}]},{"title":"Annotation Model","href":"/docs/agent-workflow/annotation-model"},{"title":"Typed Step Inputs and Constructor Injection","href":"/docs/agent-workflow/parameterization"},{"title":"DSL Primitives","href":"/docs/agent-workflow/choosing-a-pattern"},{"title":"Wiring Complex Pipelines","href":"/docs/agent-workflow/wiring"},{"title":"Agent Workflow API Reference","href":"/docs/agent-workflow/api-reference"},{"title":"Trace Capture","sidebarTitle":"Trace Capture","href":"/docs/agent-workflow/trace-capture"},{"title":"Local Durability and Recovery","href":"/docs/agent-workflow/durability"}]},{"group":"Agent Client","pages":[{"title":"Agent Client","href":"/projects/agent-client"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-client/whats-new"},{"title":"Getting Started","sidebarTitle":"Getting Started","href":"/docs/agent-client/howto/getting-started"},{"group":"Tutorial","pages":[{"title":"Agent Client Tutorial","sidebarTitle":"Tutorial Overview","href":"/docs/agent-client/tutorial/index"},{"title":"Lesson 1: Your First Agent Task","sidebarTitle":"01 - First Task","href":"/docs/agent-client/tutorial/01-first-task"},{"title":"Lesson 2: Multi-Provider","sidebarTitle":"02 - Multi-Provider","href":"/docs/agent-client/tutorial/02-multi-provider"},{"title":"Lesson 3: Read and Transform","sidebarTitle":"03 - Read \u0026 Transform","href":"/docs/agent-client/tutorial/03-read-and-transform"},{"title":"Lesson 4: Git Operations","sidebarTitle":"04 - Git Operations","href":"/docs/agent-client/tutorial/04-git-operations"},{"group":"Async conversations","pages":[{"title":"One server, many conversations","sidebarTitle":"01 - One server, many conversations","href":"/docs/agent-client/tutorial/async/01-one-server-many-conversations"},{"title":"A shared conversation, in arrival order","sidebarTitle":"02 - Shared conversation","href":"/docs/agent-client/tutorial/async/02-shared-conversation-arrival-order"},{"title":"Separate conversations, independently","sidebarTitle":"03 - Separate conversations","href":"/docs/agent-client/tutorial/async/03-separate-conversations"},{"title":"Picking a conversation up later","sidebarTitle":"04 - Picking up later","href":"/docs/agent-client/tutorial/async/04-picking-up-later"}]}]},{"title":"Switching Providers","sidebarTitle":"Switching Providers","href":"/docs/agent-client/howto/switching-providers"},{"title":"Structured Output","sidebarTitle":"Structured Output","href":"/docs/agent-client/howto/structured-output"},{"title":"Give an agent MCP servers","sidebarTitle":"MCP servers","href":"/docs/agent-client/howto/mcp-servers"},{"group":"Reference","pages":[{"title":"Portable Options Reference","sidebarTitle":"Portable Options","href":"/docs/agent-client/reference/portable-options"},{"title":"Claude Reference","sidebarTitle":"Claude Reference","href":"/docs/agent-client/reference/claude-reference"},{"title":"Codex Reference","sidebarTitle":"Codex Reference","href":"/docs/agent-client/reference/codex-reference"},{"title":"Gemini Reference","sidebarTitle":"Gemini Reference","href":"/docs/agent-client/reference/gemini-reference"},{"title":"Grok Reference","sidebarTitle":"Grok Reference","href":"/docs/agent-client/reference/grok-reference"},{"title":"Antigravity Reference","sidebarTitle":"Antigravity Reference","href":"/docs/agent-client/reference/antigravity-reference"},{"title":"Agent Sessions","href":"/docs/agent-client/reference/sessions"},{"title":"Async Lifecycle","sidebarTitle":"Async Lifecycle","href":"/docs/agent-client/reference/async-lifecycle"}]},{"title":"Defaults Philosophy","sidebarTitle":"Defaults Philosophy","href":"/docs/agent-client/explanation/defaults-philosophy"}]},{"group":"Agent Eval","pages":[{"title":"Agent Eval","href":"/projects/agent-judge"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-judge/whats-new"},{"title":"Getting started with Agent Eval","href":"/docs/agent-judge/getting-started"},{"group":"Tutorial","pages":[{"title":"Executable Tutorial","href":"/docs/agent-judge/tutorial"},{"title":"PetClinic: running the specification","href":"/docs/agent-judge/petclinic-case-study"},{"title":"Writing Custom Judges","href":"/docs/agent-judge/custom-judge"}]},{"title":"Configured juries and coverage","href":"/docs/agent-judge/jury-system"},{"title":"Reading and retaining results","href":"/docs/agent-judge/interpreting-verdicts"},{"title":"Built-in Judges","href":"/docs/agent-judge/built-in-judges"},{"title":"Requirements, evidence, and execution","href":"/docs/agent-judge/requirements-judges"},{"title":"Requirement documents: syntax, strict loading and the linter","sidebarTitle":"Requirement documents","href":"/docs/agent-judge/requirement-documents"},{"title":"Prompt size guard","sidebarTitle":"Prompt size guard","href":"/docs/agent-judge/prompt-size-guard"},{"title":"Agent Eval API reference","href":"/docs/agent-judge/api-reference"},{"title":"Migrating to Agent Eval 0.18","sidebarTitle":"Migrating to 0.18","href":"/docs/agent-judge/migration-0.18"},{"title":"Migrating to 0.17","sidebarTitle":"Migrating to 0.17","href":"/docs/agent-judge/migration-0.17"},{"title":"Agent Eval design","href":"/docs/agent-judge/design-philosophy"},{"title":"Research Foundations","href":"/docs/agent-judge/research-foundations"}]},{"group":"Agent Bench","pages":[{"title":"Agent Bench","href":"/projects/agent-bench"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-bench/whats-new"},{"title":"Getting Started with Agent Bench","href":"/docs/agent-bench/getting-started"},{"title":"Agent Configuration","href":"/docs/agent-bench/agent-config"},{"title":"Jury System","href":"/docs/agent-bench/jury-system"},{"title":"CLI Reference","href":"/docs/agent-bench/cli-reference"}]},{"group":"Agent Experiment","pages":[{"title":"Agent Experiment","href":"/projects/agent-experiment"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-experiment/whats-new"},{"title":"Getting Started with Agent Experiment","href":"/docs/agent-experiment/getting-started"},{"title":"Creating Experiments","href":"/docs/agent-experiment/creating-experiments"},{"title":"Sessions and Sweeps","href":"/docs/agent-experiment/sessions-and-sweeps"},{"title":"Building a Jury","href":"/docs/agent-experiment/jury-system"},{"title":"Agent Experiment API Reference","href":"/docs/agent-experiment/api-reference"}]},{"group":"Agent Hooks","pages":[{"title":"Agent Hooks","href":"/projects/agent-hooks"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-hooks/whats-new"}]},{"group":"Agent Memory","pages":[{"title":"Agent Memory","href":"/projects/agent-memory"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-memory/whats-new"}]},{"group":"Agent Journal","pages":[{"title":"Agent Journal","href":"/projects/agent-journal"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-journal/whats-new"},{"title":"Which Journal Do I Need?","sidebarTitle":"Which Journal do I need?","href":"/docs/agent-journal/1x-or-2"},{"group":"Agent Journal 2.0","pages":[{"title":"Agent Journal 2.0 Overview","sidebarTitle":"Overview","description":"Agent Journal 2.0, the current line on main: one portable OCSF events.jsonl per run, checked against the CLI's native output by an independent oracle","href":"/docs/agent-journal/v2/overview"},{"title":"Agent Journal 2.0: Getting Started","sidebarTitle":"Getting started","href":"/docs/agent-journal/v2/getting-started"},{"title":"Agent Journal 2.0: Capture","sidebarTitle":"Capture","description":"Write an Agent Journal 2.0 package by launching a CLI, reading a live stream, replaying a recording, or assembling several sources (on main)","href":"/docs/agent-journal/v2/capture"},{"title":"Agent Journal 2.0: Reading Packages","sidebarTitle":"Reading packages","href":"/docs/agent-journal/v2/reading"},{"title":"Agent Journal 2.0: CLI Support","sidebarTitle":"CLI support","href":"/docs/agent-journal/v2/cli-support"},{"title":"Agent Journal 2.0: Agent Client Recording","sidebarTitle":"Agent Client recording","href":"/docs/agent-journal/v2/agent-client"}]},{"group":"Agent Journal 1.x (released)","pages":[{"title":"Getting Started","href":"/docs/agent-journal/getting-started"},{"title":"Core Concepts","href":"/docs/agent-journal/concepts"},{"group":"Guides","pages":[{"title":"Capture SDK Sessions","href":"/docs/agent-journal/capture-sessions"},{"title":"Sub-agent Capture","href":"/docs/agent-journal/subagent-capture"},{"title":"Analyze Runs with DuckDB","href":"/docs/agent-journal/analyzing-runs"}]},{"title":"API Reference","href":"/docs/agent-journal/api-reference"}]}]},{"group":"Agent Sandbox","pages":[{"title":"Agent Sandbox","href":"/projects/agent-sandbox"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/agent-sandbox/whats-new"}]}]},{"group":"Supporting Projects","pages":[{"group":"Claude Agent SDK","pages":[{"title":"Claude Agent SDK (Java)","href":"/projects/claude-agent-sdk"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/claude-agent-sdk/whats-new"}]},{"group":"ACP Java SDK","pages":[{"title":"ACP Java SDK","href":"/projects/acp-java-sdk"},{"title":"ACP Java SDK","sidebarTitle":"Overview","href":"/docs/acp-java-sdk/index"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/acp-java-sdk/whats-new"},{"title":"What's New 0.81.0","href":"/docs/acp-java-sdk/whats-new-0.81"},{"title":"Migrating to 0.80.0","sidebarTitle":"Migrating to 0.80.0","href":"/docs/acp-java-sdk/migration-0.80"},{"group":"Framework Integrations","pages":[{"title":"ACP Spring Boot Autoconfiguration","sidebarTitle":"Spring Boot Starter","href":"/docs/acp-java-sdk/autoconfig"},{"title":"Micronaut Integration","sidebarTitle":"Micronaut","href":"/docs/acp-java-sdk/micronaut"},{"title":"Quarkus Integration","sidebarTitle":"Quarkus","href":"/docs/acp-java-sdk/quarkus"}]},{"group":"Concepts","pages":[{"title":"Concepts","sidebarTitle":"Concepts","href":"/docs/acp-java-sdk/concepts"},{"title":"Clients and Agents in Java","sidebarTitle":"Clients \u0026 Agents","href":"/docs/acp-java-sdk/clients-and-agents"},{"title":"Session Config Options","sidebarTitle":"Config Options","href":"/docs/acp-java-sdk/config-options"},{"title":"Cancellation","sidebarTitle":"Cancellation","href":"/docs/acp-java-sdk/cancellation"},{"title":"Extension Methods","sidebarTitle":"Extensions","href":"/docs/acp-java-sdk/extensions"},{"title":"Elicitation","sidebarTitle":"Elicitation","href":"/docs/acp-java-sdk/elicitation"},{"title":"Terminal Auth and Logout","sidebarTitle":"Auth \u0026 Logout","href":"/docs/acp-java-sdk/terminal-auth-and-logout"},{"title":"Transports","sidebarTitle":"Transports","href":"/docs/acp-java-sdk/transports"},{"title":"Agent-to-Client Calls","sidebarTitle":"Agent → Client Calls","href":"/docs/acp-java-sdk/agent-to-client-calls"},{"title":"Forward Compatibility","sidebarTitle":"Forward Compat","href":"/docs/acp-java-sdk/forward-compatibility"},{"title":"Errors","sidebarTitle":"Errors","href":"/docs/acp-java-sdk/errors"},{"title":"JSON Mappers","sidebarTitle":"JSON Mappers","href":"/docs/acp-java-sdk/json-mappers"},{"title":"Testing","sidebarTitle":"Testing","href":"/docs/acp-java-sdk/testing"},{"title":"Stable vs Unstable","sidebarTitle":"Stability","href":"/docs/acp-java-sdk/stability"}]},{"group":"Tutorial","pages":[{"title":"Tutorial","sidebarTitle":"Overview","href":"/docs/acp-java-sdk/tutorial/index"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/01-first-contact"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/02-protocol-basics"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/03-sessions"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/04-prompts"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/05-streaming-updates"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/06-update-types"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/07-agent-requests"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/08-permissions"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/09-session-resume"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/10-cancellation"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/11-error-handling"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/12-echo-agent"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/13-agent-handlers"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/14-sending-updates"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/15-agent-requests"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/16-in-memory-testing"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/17-capability-negotiation"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/18-terminal-operations"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/19-mcp-servers"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/20-session-management"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/21-async-client"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/22-async-agent"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/23-spring-boot-agent"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/24-spring-boot-client"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/25-ai-chatbot-agent"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/26-spring-ai-chatbot"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/27-langchain4j-chatbot"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/28-zed-integration"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/29-jetbrains-integration"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/30-vscode-integration"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/31-elicitation"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/32-agent-client"},{"group":"New in 0.80.0","pages":[{"title":null,"href":"/docs/acp-java-sdk/tutorial/33-session-config-options"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/34-extension-methods"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/35-cancellation-timeouts"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/36-terminal-auth-logout"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/37-streamable-http-websocket"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/38-spring-boot-http"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/39-forward-compatibility"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/40-micronaut"},{"title":null,"href":"/docs/acp-java-sdk/tutorial/41-quarkus"}]}]},{"title":"Java API Reference","sidebarTitle":"Java","href":"/docs/acp-java-sdk/reference/java"},{"title":"Cross-SDK Compatibility","sidebarTitle":"Compatibility","href":"/docs/acp-java-sdk/compatibility"},{"title":null,"href":"/docs/acp-java-sdk/resources"}]}]},{"group":"Related Projects","pages":[{"title":"Agent Tools","href":"/projects/agent-tools"},{"title":"Agent Skills","href":"/projects/agent-skills"}]},{"group":"Explorations","pages":[{"title":"Agento University","href":"/product/agento-university"},{"title":"The Bud Family","href":"/product/bud-family"}]},{"group":"Older / Inactive Projects","pages":[{"group":"Loopy","pages":[{"title":"Loopy","href":"/projects/loopy"},{"title":"Getting Started with Loopy","href":"/docs/loopy/getting-started"},{"title":"Extending Loopy","href":"/docs/loopy/extending"},{"title":"Loopy CLI Reference","href":"/docs/loopy/cli-reference"},{"title":"What's New","sidebarTitle":"What's New","href":"/docs/loopy/whats-new"}]}]}]},{"tab":"Agento Forge","pages":[{"title":"Agento Forge","href":"/methodology/forge"}]},{"tab":"Experiments","pages":[{"title":"Experiments","href":"/experiments"}]}]},"basePath":"","title":"Agent Journal 2.0: Getting Started - Pollack AI Lab","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}