<skill_content name="jj-guide">
# Skill: jj-guide

# jj Guide for AI Agents

Jujutsu (jj) is a Git-compatible VCS with mutable commits, automatic snapshotting, no staging area, and first-class conflicts. This skill teaches you how to use it safely from a non-interactive agent environment.

If `.jj/` exists in the repo root, this is a jj repo. **Use `jj` commands, not `git`.** In a colocated repo (`.jj/` *and* `.git/`), git tools can read the state, but mutations should go through `jj` so the operation log stays consistent.

## Critical Rules

- **NEVER** use interactive flags (`-i`, `--interactive`). TUI prompts hang in agent environments. This applies to `jj split -i`, `jj squash -i`, `jj commit -i`, `jj resolve`, `jj diffedit`, etc.
- **ALWAYS** pass `-m "msg"` when describing/committing. Without `-m`, an editor opens and hangs.
- **VERIFY** mutations with `jj st` and `jj log` after `squash`, `abandon`, `rebase`, `restore`, `commit`. ...

<path>/home/byk/Code/opencode-lore-codex-reasoning</path>
<type>directory</type>
<entries>
.craft.yml
.git
.github/
.gitignore
.jj/
.lore.md
.oxfmtrc.json
.oxlintrc.json
AGENTS.md
CHANGELOG.md
codecov.yml
LICENSE
node_modules/
package.json
packages/
patches/
pnpm-lock.yaml
pnpm-workspace.yaml
quality/
README.md
scripts/
stryker.config.mjs
supabase/
tsconfig.base.json
tsconfig.json
vitest.config.ts
vitest.evals.config.ts
vitest.mutation.config.ts

(28 entries)
</entries>

<path>/home/byk/Code/opencode-lore-codex-reasoning/AGENTS.md</path>
<type>file</type>
<content>
1: <!-- This section is maintained by the coding agent via lore (https://github.com/BYK/loreai) -->
2: ## Long-term Knowledge
3: 
4: For long-term knowledge entries managed by [lore](https://github.com/BYK/loreai) (gotchas, patterns, decisions, architecture), see [`.lore.md`](.lore.md) in the project root.
5: <!-- End lore-managed section -->
6: 
7: ## Review
8: 
9: See [`quality/REVIEW.md`](quality/REVIEW.md) for the review heuristics and workflow — regression-test discipline, adversarial-order state setup, fan-out registry coverage, recurring bug-class batteries, and the two-reviewer rule. Every non-trivial PR requires an adversarial correctness review before merge.
10: 
11: # Project Overview
12: 
13: Lore is a **three-tier memory architecture** for AI coding agents. ...

<path>/home/byk/Code/opencode-lore-codex-reasoning/quality/REVIEW.md</path>
<type>file</type>
<content>
1: # Review Heuristics — Lore
2: 
3: This document codifies the review bar for pull requests. It exists because
4: adversarial review has repeatedly caught correctness bugs that a green test
5: suite missed — skip/early-return branches, lifecycle sequences, and fan-out
6: registry gaps. Institutionalizing these patterns so they compound.
7: 
8: The review workflow (§6) is referenced from AGENTS.md.
9: 
10: ---
11: 
12: ## 1. Regression-test discipline
13: 
14: Every adversarial-review finding that surfaces a defect **must** land a
15: deterministic regression test in the same PR. The test:
16: - fails on the base branch (proving it reproduces the bug),
17: - passes on the fix (proving the fix works),
18: - drives the *real* precondition, not an artificially-constructed state (e.g. ...

<path>/home/byk/Code/opencode-lore-codex-reasoning/package.json</path>
<type>file</type>
<content>
1: {
2:   "name": "lore-monorepo",
3:   "private": true,
4:   "type": "module",
5:   "license": "FSL-1.1-Apache-2.0",
6:   "description": "Monorepo root for Lore — three-tier memory architecture",
7:   "main": "./packages/opencode/src/index.ts",
8:   "exports": {
9:     ".": "./packages/opencode/src/index.ts"
10:   },
11:   "packageManager": "pnpm@10.28.0",
12:   "volta": {
13:     "node": "24.16.0",
14:     "pnpm": "10.28.0"
15:   },
16:   "pnpm": {
17:     "onlyBuiltDependencies": [
18:       "esbuild",
19:       "onnxruntime-node",
20:       "sharp"
21:     ],
22:     "overrides": {
23:       "basic-ftp": "5.3.1",
24:       "ip-address": "10.2.0",
25:       "fast-xml-parser": "5.7.3",
26:       "@huggingface/hub": "2.11.0",
27:       "onnxruntime-node": "1.27.0",
28:       "yaml": ">=2.8.3",
29:       "esbuild": ">=0.28.1",
30:       "@opentelemetry/core": ">=2.8.0",
31:       ...

<path>/home/byk/Code/opencode-lore-codex-reasoning/packages/gateway/package.json</path>
<type>file</type>
<content>
1: {
2:   "name": "@loreai/gateway",
3:   "version": "0.40.0",
4:   "type": "module",
5:   "license": "FSL-1.1-Apache-2.0",
6:   "description": "Lore as a transparent LLM proxy — context management for any AI coding client",
7:   "main": "./dist/index.cjs",
8:   "types": "./dist/index.d.cts",
9:   "exports": {
10:     ".": {
11:       "types": "./dist/index.d.cts",
12:       "bun": "./dist/index.bun.js",
13:       "require": "./dist/index.cjs",
14:       "default": "./dist/index.cjs"
15:     }
16:   },
17:   "bin": {
18:     "lore": "./dist/bin.cjs",
19:     "lore-gateway": "./dist/bin.cjs"
20:   },
21:   "scripts": {
22:     "typecheck": "tsc --noEmit",
23:     "build": "tsx script/build.ts",
24:     "bundle": "tsx script/bundle.ts",
25:     "build:binary": "tsx script/build.ts --binary",
26:     "build:binary:sea": "tsx script/build-binary-sea.ts",
27:     "start": ...

<path>/home/byk/Code/opencode-lore-codex-reasoning/packages/gateway/script/bundle.ts</path>
<type>file</type>
<content>
1: /**
2:  * Bundle @loreai/gateway into a self-contained CJS package for npm/npx.
3:  *
4:  * Produces:
5:  *   dist/index.cjs — single CJS bundle (gateway + core + all JS deps)
6:  *   dist/bin.cjs   — thin CLI wrapper with Node.js version check
7:  *
8:  * Everything is bundled except:
9:  *   - node:* built-ins (resolved at runtime)
10:  *
11:  * Source code is pure Node.js — no `Bun.*` polyfill layer is needed.
12:  * (xxHash64 lives in src/xxhash.ts as a standalone module since there is
13:  * no Node.js equivalent of `Bun.hash.xxHash64`.)
14:  *
15:  * Debug IDs are injected into the JS + sourcemap after bundling for Sentry
16:  * source map resolution. When SENTRY_AUTH_TOKEN is set, sourcemaps are
17:  * uploaded to Sentry and then deleted (they shouldn't ship to users). ...

wlpsntppxyyxpvwnnywkpvkskzvtktvp b588d81bfd33e0b30e5040c694c893b3a116e363 parents=rtwyxzrrqnqspzypxtymnolzwmpnnumv/b9feb17a1feb58a72a080cca0e493130427c506f conflict=false empty=false
rtwyxzrrqnqspzypxtymnolzwmpnnumv b9feb17a1feb58a72a080cca0e493130427c506f parents=uyznyvwtuxrkvnppulnwlpryssrywsrt/1ff66d14757b98d3ec7bdb8012104d1f10b292b8 conflict=false empty=false
Working copy changes:
M packages/gateway/src/pipeline.ts
M packages/gateway/test/openai-responses-recall-aware-stream.test.ts
Working copy  (@) : wlpsntpp b588d81b fix(responses): bound Codex reasoning state
Parent commit (@-): rtwyxzrr b9feb17a fix/codex-sparse-reasoning | fix(responses): reject untracked Codex reasoning
Warning: These bookmarks have conflicts:
  fix/responses-private-references
Hint: Use `jj bookmark list` to see details. Use `jj bookmark set <name> -r <rev>` to resolve.
packages/gateway/src/pipeline.ts
packages/gateway/test/openai-responses-recall-aware-stream.test.ts
packages/gateway/src/pipeline.ts       ...

46fe2b3cb450533b2ca2a207311c56e6f19a6532ae7d497663d61eb7b513e8a6  jj diff --git --color never -r @
46fe2b3cb450533b2ca2a207311c56e6f19a6532ae7d497663d61eb7b513e8a6  jj diff --git --color never --from @- --to @
8553e8714cf769789ec17e29f4ae2d3ade02d5cbd8662e1ef33981871dcd15a7  jj diff --color never -r @
8553e8714cf769789ec17e29f4ae2d3ade02d5cbd8662e1ef33981871dcd15a7  jj diff --color never --from @- --to @

No files found

614085 /usr/bin/bash -c pgrep -af 'vitest|pnpm.*test|tsx.*bundle|esbuild' || true

> lore-monorepo@ pretest /home/byk/Code/opencode-lore-codex-reasoning
> pnpm --filter @loreai/gateway run bundle


> @loreai/gateway@0.40.0 bundle /home/byk/Code/opencode-lore-codex-reasoning/packages/gateway
> tsx script/bundle.ts


  dist/index.cjs      16.7mb ⚠️
  dist/index.cjs.map  43.7mb

⚡ Done in 2839ms

  dist/index.bun.js  16.2mb ⚠️

⚡ Done in 2071ms

  dist/embedding-worker.cjs  565.1kb

⚡ Done in 240ms

  dist/embedding-worker.js  564.9kb

⚡ Done in 188ms

  dist/vector-worker.cjs  11.1kb

⚡ Done in 10ms

  dist/vector-worker.js  10.3kb

⚡ Done in 9ms
✓ Debug ID injected: 11beb21b-772f-4798-a06d-97881757267c
  No SENTRY_AUTH_TOKEN — skipping sourcemap upload

✓ @loreai/gateway npm bundle complete (v0.40.0)
  dist/index.cjs            — CJS bundle (Node.js, node:sqlite)
  dist/index.bun.js         — ESM bundle (Bun, bun:sqlite)
  dist/embedding-worker.cjs — embedding worker CJS (Node.js)
  dist/embedding-worker.js  — embedding worker ESM (Bun)
  dist/vector-worker.cjs    — ...

<path>/home/byk/Code/opencode-lore-codex-reasoning/packages/gateway/script/bundle.ts</path>
<type>file</type>
<content>
303: // Ship onnxruntime-web WASM runtime next to the worker bundles
304: // ---------------------------------------------------------------------------
305: // The worker bundles redirect onnxruntime-node → onnxruntime-web (WASM). At
306: // runtime, embedding-worker.ts sets __LORE_NPM_WASM_PATHS__ to these sibling
307: // files so transformers.js loads the WASM locally instead of from the jsdelivr
308: // CDN (wrong variant + requires network). Must stay in sync with the `files`
309: // array in package.json and the runtime block in embedding-worker.ts.
310: //
311: // We ship the UNPATCHED ort-wasm-simd-threaded.mjs (unlike the SEA binary,
312: // which patches its pthread spawn to a no-op). This is safe ONLY because the
313: // worker forces numThreads=1 (embedding-worker.ts), so ort-web takes the
314: // single-thread path and never calls its pthread `new ...

No files found

<path>/home/byk/Code/opencode-lore-codex-reasoning/packages/gateway/dist</path>
<type>directory</type>
<entries>
bin.cjs
embedding-worker.cjs
embedding-worker.js
index.bun.js
index.cjs
index.cjs.map
index.d.cts
ort-wasm-simd-threaded.mjs
ort-wasm-simd-threaded.wasm
vector-worker.cjs
vector-worker.js

(11 entries)
</entries>

<path>/home/byk/Code/opencode-lore-codex-reasoning/packages/gateway/script/debug-id.ts</path>
<type>file</type>
<content>
1: /**
2:  * Debug ID injection for JavaScript sourcemaps.
3:  *
4:  * Injects Sentry debug IDs into JavaScript files and their companion
5:  * sourcemaps for reliable server-side stack trace resolution. Debug IDs
6:  * replace fragile filename/release-based sourcemap matching with a
7:  * deterministic UUID embedded in both the JS file and its sourcemap.
8:  *
9:  * The UUID algorithm and runtime snippet are byte-for-byte compatible
10:  * with `@sentry/bundler-plugin-core`'s `stringToUUID` and
11:  * `getDebugIdSnippet` — see ECMA-426 (Source Map Format) for the spec.
12:  *
13:  * Adapted from the Sentry CLI's own build pipeline
14:  * (getsentry/sentry-cli src/lib/sourcemap/debug-id.ts). ...

ARTIFACT_SET_MATCH=true
ARTIFACT_COUNT=11
ARTIFACT bin.cjs bytes=804 sha256=17fb4c7c81ae02493349a6be7dbf55f2f2ac9bbdbe0ed67423149ab9022e367f
ARTIFACT embedding-worker.cjs bytes=578646 sha256=23e8d7b5a7ce15bfa769fd948d75fb616599a3e13b84cc056932ef0abd9f2393
ARTIFACT embedding-worker.js bytes=578430 sha256=73335bf3711ff7ea9b693206c44b99db734d4e2f2f1f0d962276d28b77790276
ARTIFACT index.bun.js bytes=16966906 sha256=47b7c2a95dadf228a4ad3374117fd49acadbe055f01fcb3a9d7cbec246fd9b82
ARTIFACT index.cjs bytes=17528449 sha256=76bf7d854fbefacd0e87a38c52dce2b6603c6103c87893d3f34e276692b222fa
ARTIFACT index.cjs.map bytes=44138963 sha256=1aefbf10cdc6806885900228624be135b888649c2568561114dcdcacef62b809
ARTIFACT index.d.cts bytes=3000 sha256=4088c397157706b002531581dd770be40200a0b4c2744f527552794057954597
ARTIFACT ort-wasm-simd-threaded.mjs bytes=20856 sha256=43c25054b6b9ac000f786c65545ff83a45f871e0e310e8c2f4d48a363bb66db4
ARTIFACT ort-wasm-simd-threaded.wasm bytes=11133407 ...

=== FINAL IDENTITY ===
wlpsntppxyyxpvwnnywkpvkskzvtktvp b588d81bfd33e0b30e5040c694c893b3a116e363 parents=rtwyxzrrqnqspzypxtymnolzwmpnnumv/b9feb17a1feb58a72a080cca0e493130427c506f conflict=false empty=false
rtwyxzrrqnqspzypxtymnolzwmpnnumv b9feb17a1feb58a72a080cca0e493130427c506f parents=uyznyvwtuxrkvnppulnwlpryssrywsrt/1ff66d14757b98d3ec7bdb8012104d1f10b292b8 conflict=false empty=false
=== FINAL STATUS ===
Working copy changes:
M packages/gateway/src/pipeline.ts
M packages/gateway/test/openai-responses-recall-aware-stream.test.ts
Working copy  (@) : wlpsntpp b588d81b fix(responses): bound Codex reasoning state
Parent commit (@-): rtwyxzrr b9feb17a fix/codex-sparse-reasoning | fix(responses): reject untracked Codex reasoning
Warning: These bookmarks have conflicts:
  fix/responses-private-references
Hint: Use `jj bookmark list` to see details. Use `jj bookmark set <name> -r <rev>` to resolve. ...

TRACKED_ENTRY_COUNT=1072
TRACKED_MISMATCH_COUNT=0
CURRENT_TRACKED_MANIFEST_SHA256=faf6c09bb5cfff23eb7e089f99b9c3431e98fda08614c2e677101cd3531ca019
NONIGNORED_UNTRACKED_COUNT=0