karajan-core
v1.3.1
Published
Shared modules for Karajan Code CLI and @karajan/hu-board (atomic-write, paths, RAG store, plan ops, process runner).
Readme
karajan-core
Shared modules for the Karajan Code CLI and @karajan/hu-board. Private
workspace package — not published to npm.
Scope
karajan-core is the extraction destination for code that both the CLI
package (karajan-code) and the HU Board package (@karajan/hu-board)
need. Today it ships the atomic JSON writer; subsequent commits of
KJC-TSK-0511 will land the shared paths, port-check, run-registry,
process runner, plan validation, vector store, and plan/HU ops modules
here.
Exports
| Subpath | Module |
| --- | --- |
| karajan-core/atomic-write | writeJsonAtomic, writeJsonAtomicSync |
| karajan-core/shared-paths | SHARED_DIR_NAME, getSharedRoot, getSharedPlansDir, getSharedHuStoriesDir, isSharedPath |
| karajan-core/port-check | isPortAvailable, findAvailablePort |
| karajan-core/paths | resolveHome, getKarajanHome, getSessionRoot, getSonarComposePath, getOllamaComposePath, getWebperfDir, getRunsDir, getPromptsDir, __resetKjHomeWarningForTests |
| karajan-core/run-registry | runsDir, registerRun, unregisterRun, listActiveRuns |
| karajan-core/vec-store | dbPath, openVecStore, insertChunk, searchSimilar, searchBM25, projectSlug, deleteChunksBySource, findChunkByHash, getEmbeddingsByIds, getLastIndexedCommit, setLastIndexedCommit, countChunks |
| karajan-core/plan-id | generatePlanId, generateHuId, normaliseAlias |
| karajan-core/plan-hu-ops | addHu, removeHu, updateHu, updateHuStatus, setHuOutcome, setPlanOutcome, autoCertifyPendingHus, assertPlanRunnable, computePlanOutcome, certifyAllHus, reorderHus |
| karajan-core/plan-validation | validateBlockedByChange |
| karajan-core/process | runCommand (execa wrapper with output streaming, silence/total timeouts, ENOENT enrichment) |
| karajan-core/hu-snapshot | snapshotRefForHu, createHuSnapshot, hasHuSnapshot, restoreHuSnapshot, removeHuSnapshot |
| karajan-core/standby-store | persistStandby, loadStandby, listPendingStandby, markStandbyDone, acquireStandbyLock, buildStandbyState, standbyDir, standbyDoneDir |
| karajan-core/standby-scheduler | scheduleResume, cancelScheduled, reconcileAll, acquireStandbyLock, markStandbyDone, _resetScheduledForTests |
The root export (karajan-core) re-exports everything via the barrel
in src/index.js, but prefer the subpath form so the bundler can
tree-shake unused modules.
Status
KJC-TSK-0511 PR8 — standby-store + standby-scheduler extracted.
With this PR @karajan/hu-board no longer reaches into ../../../src
from any static or dynamic import. PR9 will re-add
packages/hu-board to the root workspaces array.
