Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Use core subpath imports throughout the Open Knowledge app (#5549)

Nick Gomez65c20363b613
diff --git a/.changeset/app-core-subpath-imports.md b/.changeset/app-core-subpath-imports.md
new file mode 100644
index 000000000..20f230a04
--- /dev/null
+++ b/.changeset/app-core-subpath-imports.md
@@ -0,0 +1,5 @@
+---
+"@inkeep/open-knowledge": patch
+---
+
+Opening and editing documents remain unchanged with the updated editor loading path.
diff --git a/knip.config.ts b/knip.config.ts
index 65f0e8807..d3638888e 100644
--- a/knip.config.ts
+++ b/knip.config.ts
@@ -147,11 +147,15 @@ export default {
'packages/server': {
entry: ['src/**/*.test.ts', 'src/parse-worker.ts'],
project: 'src/**',
- ignoreDependencies: ['@types/shell-quote'],
+ ignoreDependencies: [
+ '@types/shell-quote',
+ ],
},
'packages/cli': {
entry: ['src/**/*.test.ts', 'scripts/*.ts', 'tests/**/*.ts', 'src/parse-worker.ts'],
- ignoreDependencies: ['yjs'],
+ ignoreDependencies: [
+ 'yjs',
+ ],
},
'packages/desktop': {
entry: [
diff --git a/lint-plugins/ok-rules/README.md b/lint-plugins/ok-rules/README.md
index d77febd77..ceeda73df 100644
--- a/lint-plugins/ok-rules/README.md
+++ b/lint-plugins/ok-rules/README.md
@@ -136,6 +136,22 @@ createPortal(
Rule: [`lint-plugins/ok-rules/rules/no-unportaled-editor-content.mjs`](rules/no-unportaled-editor-content.mjs). Fixture: [`lint-plugins/ok-rules/__fixtures__/no-unportaled-editor-content.fixture.tsx`](__fixtures__/no-unportaled-editor-content.fixture.tsx). Test: [`lint-plugins/ok-rules/tests/no-unportaled-editor-content.uncached.test.mjs`](tests/no-unportaled-editor-content.uncached.test.mjs). See [PRECEDENTS.md #44](../../PRECEDENTS.md) for the H6 cross-doc DOM bleed contract and [PRECEDENTS.md #42](../../PRECEDENTS.md#custom-lint-enforcement-precedent-42) for the custom-rule convention.
+### `no-app-core-barrel-import`
+
+Open Knowledge app production source imports core through package subpaths, never through the bare `@inkeep/open-knowledge-core` barrel. The barrel re-exports every core facility, so one bare import puts all of it into the editor's first-page module graph and into the graph each app test loads. Core exports one subpath per module the app uses (`@inkeep/open-knowledge-core/<module>`, the module path relative to `packages/core/src` without its extension or a terminal `/index`, declared in [`packages/core/package.json`](../../packages/core/package.json) `exports`), and every entry builds into the same emitted runtime, so a subpath and the barrel hand out identical bindings. The fix for a diagnostic is to import each binding from the subpath of the module that exports it; `packages/core/src/index.ts` shows which module that is.
+
+When that module has no subpath yet, register one in four places. Add its `exports` block in `packages/core/package.json`, with the `@inkeep/source`, `development`, `types` and `default` conditions in that order. Add its entry to the shared map in `packages/core/tsdown.config.ts`, keyed by the flat `dist` file name its `default` target names, so both build passes emit it; core's `build` fails in `verify:exports` when a declared target is missing. Import it and add its row to `MODULE_SUBPATHS` in `packages/core/tests/contract/module-subpaths.test.ts`, whose key test fails when a new `exports` key is missing from that map. Re-export its types from `packages/core/tests/contract/subpath-types/consumer.ts`, which core's `typecheck` compiles against source and its `check:dts` compiles against the emitted declarations.
+
+The rule matches module specifiers, not text. It compares each specifier with any `?query` or `#hash` suffix removed, because a bundler resolves `@inkeep/open-knowledge-core?v=1` to the same barrel, so a suffix cannot slip one past the rule; that includes `?raw` of the bare barrel, whose remedy is a subpath too. It fires at the specifier of a static import of any shape (value, `import type`, mixed, namespace, default, side-effect), a TypeScript `import x = require(...)`, a named, type, star or star-as re-export, a `typeof import(...)` or `import(...).Name` type, a dynamic `import()` whose argument is a string or a template literal with no expressions, and a call to the `require` builtin with such an argument. It does NOT fire on a declared subpath, on a sibling package whose name shares the prefix (`@inkeep/open-knowledge`, `@inkeep/open-knowledge-server`, a longer `@inkeep/open-knowledge-core-*` name), on the barrel name inside an ordinary string, template or comment, on a computed `import()` argument, or on a member call such as `loader.require(...)`. Those last two are deliberate holes: the specifier is not knowable from the syntax. Two more are known limitations: the comparison is case-sensitive, so a case variant such as `@Inkeep/open-knowledge-core` does not fire, and a computed specifier built from a variable or a template with expressions does not either.
+
+Other packages (docs, its generator, md-conformance, server, CLI, desktop) keep the barrel, and so do app tests: a test that imports the barrel loads it into its own graph only, and a test mock has to follow the module production imports, which the barrel no longer is. The scope therefore covers app source by extension pattern, so a file added in a new directory is covered without an edit here, and subtracts every suffix the shared test-only classifier [`isTestOnlySourceFile`](../../test-support/test-only-source-file.mjs) recognizes. The self-test fails if that classifier gains a suffix this scope does not exclude. The dev-server adapter `packages/app/src/server/hocuspocus-plugin.ts` is production source and is in scope.
+
+Included: `packages/app/src/**/*.ts`, `packages/app/src/**/*.tsx`, `packages/app/src/**/*.mts`, `packages/app/src/**/*.cts`, `packages/app/src/**/*.js`, `packages/app/src/**/*.jsx`, `packages/app/src/**/*.mjs`, `packages/app/src/**/*.cjs`, `lint-plugins/ok-rules/__fixtures__/no-app-core-barrel-import.fixture.tsx`. Excluded: `**/*.test.ts`, `**/*.test.tsx`, `**/*.test-helper.ts`, `**/*.test-helper.tsx`, `**/*.type-tests.ts`, `**/*.type-tests.tsx`, `**/*.e2e.ts`.
+
+Beyond the fixture positions, the self-test copies the repository's own `oxlint.config.ts`, the `lint-plugins` directory and the files its modules read into a temporary directory outside the repository, plants a bare import in a production-shaped file and a test-only sibling under that copy's `packages/app/src`, and expects exactly one diagnostic, on the production file; the subpath form of the same import must lint clean. The copy keeps the probe files out of the shared source tree, where a concurrent test collection, lint or typecheck would read them.
+
+Rule: [`lint-plugins/ok-rules/rules/no-app-core-barrel-import.mjs`](rules/no-app-core-barrel-import.mjs). Fixture: [`lint-plugins/ok-rules/__fixtures__/no-app-core-barrel-import.fixture.tsx`](__fixtures__/no-app-core-barrel-import.fixture.tsx). Test: [`lint-plugins/ok-rules/tests/no-app-core-barrel-import.uncached.test.mjs`](tests/no-app-core-barrel-import.uncached.test.mjs). See [PRECEDENTS.md #42](../../PRECEDENTS.md#custom-lint-enforcement-precedent-42) for the custom-rule convention.
+
### `no-uninstall-forbidden-import`
"Connects to nothing" first-hop feedback. The self-uninstall window's survey and completion screens render after `ok uninstall --yes` has stopped the local Hocuspocus server and removed `~/.ok`, so the uninstall entry must never reach the editor, the CRDT stack, the provider pool, or the server bootstrap — and must eager-load (no dynamic `import()`) so those screens paint from memory once teardown is under way.
diff --git a/lint-plugins/ok-rules/__fixtures__/no-app-core-barrel-import.fixture.tsx b/lint-plugins/ok-rules/__fixtures__/no-app-core-barrel-import.fixture.tsx
new file mode 100644
index 000000000..9142001a5
--- /dev/null
+++ b/lint-plugins/ok-rules/__fixtures__/no-app-core-barrel-import.fixture.tsx
@@ -0,0 +1,70 @@
+// biome-ignore-all assist/source/organizeImports: each import form is a separate positive or negative case; merging or reordering them would erase cases and shift the asserted positions
+// FIXTURE — drives `no-app-core-barrel-import.uncached.test.mjs` via shell-out to oxlint.
+// Not part of the main lint: `__fixtures__/` is in `oxlint.config.ts#ignorePatterns`, and
+// `__fixtures__/oxlint.fixtures.json` re-enables the rules for the test.
+//
+// Positive cases (one per line, each prefixed `p`): every module-reference form that names
+// the bare core barrel, with or without a `?query` or `#hash` suffix. Negative cases (prefixed `n`): the adjacent shapes the rule must NOT
+// match — declared subpaths, sibling packages sharing the prefix, the barrel name inside a
+// string or a comment, and non-literal or member-call loads.
+
+// === Positive cases — must fire ===
+
+import { sharedExtensions } from '@inkeep/open-knowledge-core'; // p value
+import type { LinterConfig } from '@inkeep/open-knowledge-core'; // p whole-declaration type
+import { THEME_PLUGINS, type ThemePlugin } from '@inkeep/open-knowledge-core'; // p mixed
+import * as coreNamespace from '@inkeep/open-knowledge-core'; // p namespace
+import '@inkeep/open-knowledge-core'; // p side-effect
+import coreDefault from '@inkeep/open-knowledge-core'; // p default
+import coreRequired = require('@inkeep/open-knowledge-core'); // p TS import-equals
+export { FORM_WRITE_ORIGIN } from '@inkeep/open-knowledge-core'; // p named re-export
+export type { ConfigSchema } from '@inkeep/open-knowledge-core'; // p type re-export
+export * from '@inkeep/open-knowledge-core'; // p star re-export
+export * as coreStar from '@inkeep/open-knowledge-core'; // p star-as re-export
+export type CoreModule = typeof import('@inkeep/open-knowledge-core'); // p typeof import type
+export type CoreLinter = import('@inkeep/open-knowledge-core').LinterConfig; // p import type
+export const pDynamic = () => import('@inkeep/open-knowledge-core'); // p literal dynamic import
+export const pTemplate = () => import(`@inkeep/open-knowledge-core`); // p template, no expressions
+export const pRequire = () => require('@inkeep/open-knowledge-core'); // p literal require
+import coreRaw from '@inkeep/open-knowledge-core?raw'; // p query suffix
+import '@inkeep/open-knowledge-core?v=1'; // p cache-busting query on a side-effect import
+export const pHash = () => import('@inkeep/open-knowledge-core#entry'); // p hash suffix
+
+// === Negative cases — must NOT fire ===
+
+import { getGitHubStars } from '@inkeep/open-knowledge-core/utils/github-stars'; // n subpath
+import type { CheckpointKind } from '@inkeep/open-knowledge-core/constants/checkpoint-kinds'; // n type subpath
+import { startServer } from '@inkeep/open-knowledge-core/server'; // n pre-existing subpath
+import { bootServer } from '@inkeep/open-knowledge-server'; // n sibling package
+import { cliMain } from '@inkeep/open-knowledge'; // n prefix of the barrel name
+import { extra } from '@inkeep/open-knowledge-core-extra'; // n longer package sharing the prefix
+export { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core/constants/feature-flags'; // n subpath re-export
+export * from '@inkeep/open-knowledge-core/bridge'; // n subpath star re-export
+export type BridgeModule = typeof import('@inkeep/open-knowledge-core/bridge'); // n subpath import type
+export const nDynamic = () => import('@inkeep/open-knowledge-core/markdown/lint'); // n subpath dynamic import
+export const nRequire = () => require('@inkeep/open-knowledge-core/bridge'); // n subpath require
+import bridgeRaw from '@inkeep/open-knowledge-core/bridge?raw'; // n subpath with a query suffix
+import extraVersioned from '@inkeep/open-knowledge-core-extra?v=1'; // n longer package with a query suffix
+export const nString = '@inkeep/open-knowledge-core'; // n ordinary string literal
+export const nMessage = `install @inkeep/open-knowledge-core`; // n template containing the name
+// n the comment names '@inkeep/open-knowledge-core' and must not fire
+export const nComputed = (suffix: string) => import(`@inkeep/open-knowledge-core${suffix}`); // n computed
+export const nMember = (loader: { require(id: string): unknown }) =>
+ loader.require('@inkeep/open-knowledge-core'); // n member call, not the require builtin
+
+export const used = [
+ sharedExtensions,
+ THEME_PLUGINS,
+ coreNamespace,
+ coreDefault,
+ coreRequired,
+ coreRaw,
+ bridgeRaw,
+ extraVersioned,
+ getGitHubStars,
+ startServer,
+ bootServer,
+ cliMain,
+ extra,
+];
+export type UsedType = LinterConfig | ThemePlugin | CheckpointKind;
diff --git a/lint-plugins/ok-rules/__fixtures__/oxlint.fixtures.json b/lint-plugins/ok-rules/__fixtures__/oxlint.fixtures.json
index 8e65d2025..4046ee974 100644
--- a/lint-plugins/ok-rules/__fixtures__/oxlint.fixtures.json
+++ b/lint-plugins/ok-rules/__fixtures__/oxlint.fixtures.json
@@ -4,6 +4,7 @@
"ok/class-proof-registration-discipline": "error",
"ok/cst-pm-handler-todo-stub": "error",
"ok/microcopy-ellipsis": "error",
+ "ok/no-app-core-barrel-import": "error",
"ok/no-blind-agent-host-fanout": "error",
"ok/no-demoted-dialog-confirm": "error",
"ok/no-hand-rolled-branch-validation": "error",
diff --git a/lint-plugins/ok-rules/index.mjs b/lint-plugins/ok-rules/index.mjs
index 302a04d90..de3aef990 100644
--- a/lint-plugins/ok-rules/index.mjs
+++ b/lint-plugins/ok-rules/index.mjs
@@ -3,6 +3,7 @@ import { fileURLToPath } from 'node:url';
import { classProofRegistrationDiscipline } from './rules/class-proof-registration-discipline.mjs';
import { cstPmHandlerTodoStub } from './rules/cst-pm-handler-todo-stub.mjs';
import { microcopyEllipsis } from './rules/microcopy-ellipsis.mjs';
+import { noAppCoreBarrelImport } from './rules/no-app-core-barrel-import.mjs';
import { noBlindAgentHostFanout } from './rules/no-blind-agent-host-fanout.mjs';
import { noDemotedDialogConfirm } from './rules/no-demoted-dialog-confirm.mjs';
import { noHandRolledBranchValidation } from './rules/no-hand-rolled-branch-validation.mjs';
@@ -36,6 +37,7 @@ const declared = {
'class-proof-registration-discipline': classProofRegistrationDiscipline,
'cst-pm-handler-todo-stub': cstPmHandlerTodoStub,
'microcopy-ellipsis': microcopyEllipsis,
+ 'no-app-core-barrel-import': noAppCoreBarrelImport,
'no-blind-agent-host-fanout': noBlindAgentHostFanout,
'no-demoted-dialog-confirm': noDemotedDialogConfirm,
'no-hand-rolled-branch-validation': noHandRolledBranchValidation,
diff --git a/lint-plugins/ok-rules/rules/no-app-core-barrel-import.mjs b/lint-plugins/ok-rules/rules/no-app-core-barrel-import.mjs
new file mode 100644
index 000000000..895393c60
--- /dev/null
+++ b/lint-plugins/ok-rules/rules/no-app-core-barrel-import.mjs
@@ -0,0 +1,58 @@
+import { docsUrl } from '../docs.mjs';
+
+const URL = docsUrl('no-app-core-barrel-import');
+
+const CORE_BARREL = '@inkeep/open-knowledge-core';
+
+const MESSAGE = `Bare ${CORE_BARREL} import in app production source — it pulls core's whole barrel into the editor's module graph. Import each binding from the core subpath of the module that exports it (${CORE_BARREL}/<module>, declared in packages/core/package.json exports). See ${URL}`;
+
+function stringValue(node) {
+ if (node?.type === 'Literal' && typeof node.value === 'string') return node.value;
+ if (node?.type === 'TemplateLiteral' && node.expressions.length === 0)
+ return node.quasis[0].value.cooked;
+ return undefined;
+}
+
+function withoutQueryOrHash(specifier) {
+ return specifier?.split(/[?#]/, 1)[0];
+}
+
+export const noAppCoreBarrelImport = {
+ meta: {
+ type: 'problem',
+ docs: {
+ description: `App production source may not reference the bare ${CORE_BARREL} barrel; import core subpaths.`,
+ url: URL,
+ },
+ },
+ create(context) {
+ function check(sourceNode) {
+ if (withoutQueryOrHash(stringValue(sourceNode)) !== CORE_BARREL) return;
+ context.report({ node: sourceNode, message: MESSAGE });
+ }
+ return {
+ ImportDeclaration(node) {
+ check(node.source);
+ },
+ ExportNamedDeclaration(node) {
+ check(node.source);
+ },
+ ExportAllDeclaration(node) {
+ check(node.source);
+ },
+ ImportExpression(node) {
+ check(node.source);
+ },
+ TSImportType(node) {
+ check(node.source);
+ },
+ TSExternalModuleReference(node) {
+ check(node.expression);
+ },
+ CallExpression(node) {
+ if (node.callee.type !== 'Identifier' || node.callee.name !== 'require') return;
+ check(node.arguments[0]);
+ },
+ };
+ },
+};
diff --git a/lint-plugins/ok-rules/scope.mjs b/lint-plugins/ok-rules/scope.mjs
index f45c227d1..abf1bab83 100644
--- a/lint-plugins/ok-rules/scope.mjs
+++ b/lint-plugins/ok-rules/scope.mjs
@@ -1,4 +1,5 @@
-import { relative } from 'node:path';
+import { realpathSync } from 'node:fs';
+import { basename, dirname, join, relative } from 'node:path';
import { globToRegExp, normalizeRelativePath } from '../no-comments/scope.mjs';
const CACHE = new Map();
@@ -23,6 +24,24 @@ export const UNSCOPED_RULES = new Set([
]);
export const RULE_SCOPES = {
+ 'no-app-core-barrel-import': [
+ 'packages/app/src/**/*.ts',
+ 'packages/app/src/**/*.tsx',
+ 'packages/app/src/**/*.mts',
+ 'packages/app/src/**/*.cts',
+ 'packages/app/src/**/*.js',
+ 'packages/app/src/**/*.jsx',
+ 'packages/app/src/**/*.mjs',
+ 'packages/app/src/**/*.cjs',
+ '!**/*.test.ts',
+ '!**/*.test.tsx',
+ '!**/*.test-helper.ts',
+ '!**/*.test-helper.tsx',
+ '!**/*.type-tests.ts',
+ '!**/*.type-tests.tsx',
+ '!**/*.e2e.ts',
+ 'lint-plugins/ok-rules/__fixtures__/no-app-core-barrel-import.fixture.tsx',
+ ],
'no-hand-rolled-test-file-suffix': [
'**/*.ts',
'**/*.tsx',
@@ -218,16 +237,28 @@ export function isInScope(ruleName, relPath, table = RULE_SCOPES) {
return included;
}
-function scopedFilename(context, repoRoot) {
- const absolute = context.physicalFilename ?? context.filename;
- return normalizeRelativePath(relative(repoRoot, absolute));
+function canonicalPath(path) {
+ try {
+ return realpathSync.native(path);
+ } catch (error) {
+ if (error.code !== 'ENOENT' && error.code !== 'ENOTDIR') throw error;
+ const parent = dirname(path);
+ if (parent === path) return path;
+ return join(canonicalPath(parent), basename(path));
+ }
+}
+
+function scopedFilename(context, canonicalRoot) {
+ const absolute = canonicalPath(context.physicalFilename ?? context.filename);
+ return normalizeRelativePath(relative(canonicalRoot, absolute));
}
export function scoped(ruleName, rule, repoRoot, table = RULE_SCOPES) {
+ const canonicalRoot = canonicalPath(repoRoot);
return {
...rule,
create(context) {
- if (!isInScope(ruleName, scopedFilename(context, repoRoot), table)) return {};
+ if (!isInScope(ruleName, scopedFilename(context, canonicalRoot), table)) return {};
return rule.create(context);
},
};
diff --git a/lint-plugins/ok-rules/tests/no-app-core-barrel-import.uncached.test.mjs b/lint-plugins/ok-rules/tests/no-app-core-barrel-import.uncached.test.mjs
new file mode 100644
index 000000000..673906f5d
--- /dev/null
+++ b/lint-plugins/ok-rules/tests/no-app-core-barrel-import.uncached.test.mjs
@@ -0,0 +1,219 @@
+import { spawnSync } from 'node:child_process';
+import {
+ cpSync,
+ existsSync,
+ mkdirSync,
+ mkdtempSync,
+ readFileSync,
+ realpathSync,
+ rmSync,
+ symlinkSync,
+ writeFileSync,
+} from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, test } from 'vitest';
+import {
+ lintOkRulesFixture,
+ readEnabledRuleIds,
+ readRegisteredRuleNames,
+ readRuleScope,
+} from '../../../test-support/read-ok-rules-config.test-helper.ts';
+import {
+ isTestOnlySourceFile,
+ TEST_ONLY_SOURCE_SUFFIXES,
+} from '../../../test-support/test-only-source-file.mjs';
+import { TAG_SURFACE_FILENAME } from '../../no-comments/tag-scope.mjs';
+import { rules } from '../index.mjs';
+import { isInScope } from '../scope.mjs';
+
+const ROOT = fileURLToPath(new URL('../../..', import.meta.url));
+const RULE = 'no-app-core-barrel-import';
+const CODE = `ok(${RULE})`;
+const FIXTURE = `lint-plugins/ok-rules/__fixtures__/${RULE}.fixture.tsx`;
+const README = 'lint-plugins/ok-rules/README.md';
+const BARE_IMPORT = "import { sharedExtensions } from '@inkeep/open-knowledge-core';\n";
+const SUBPATH_IMPORT =
+ "import { sharedExtensions } from '@inkeep/open-knowledge-core/extensions/shared';\n";
+const PRODUCTION_SHAPED = [
+ 'packages/app/src/App.tsx',
+ 'packages/app/src/server/hocuspocus-plugin.ts',
+ 'packages/app/src/lib/handoff/targets.ts',
+ 'packages/app/src/a-directory-added-later/nested/module.ts',
+ 'packages/app/src/build/rejection-loop-guard-script.js',
+ 'packages/app/src/workers/new-worker.mjs',
+ 'packages/app/src/types/ambient.d.ts',
+];
+
+const REPO_LINT_INPUTS = [
+ 'oxlint.config.ts',
+ 'tsconfig.json',
+ 'no-comments.config.jsonc',
+ 'PRECEDENTS.md',
+ 'lint-plugins',
+ 'test-support/test-only-source-file.mjs',
+];
+const OPTIONAL_REPO_LINT_INPUTS = [TAG_SURFACE_FILENAME];
+
+function copyRepoLintConfig() {
+ const root = realpathSync(mkdtempSync(join(tmpdir(), 'ok-core-barrel-lint-')));
+ const present = OPTIONAL_REPO_LINT_INPUTS.filter((input) => existsSync(join(ROOT, input)));
+ for (const input of [...REPO_LINT_INPUTS, ...present]) {
+ mkdirSync(dirname(join(root, input)), { recursive: true });
+ cpSync(join(ROOT, input), join(root, input), { recursive: true });
+ }
+ symlinkSync(join(ROOT, 'node_modules'), join(root, 'node_modules'), 'dir');
+ return root;
+}
+
+function lintWithRepoConfig(root, files) {
+ const result = spawnSync(
+ join(ROOT, 'node_modules/.bin/oxlint'),
+ ['-f', 'json', '--max-warnings', '0', ...files],
+ { cwd: root, encoding: 'utf8', windowsHide: true, maxBuffer: 64 * 1024 * 1024 },
+ );
+ expect(result.error).toBeUndefined();
+ expect(typeof result.status).toBe('number');
+ const output = JSON.parse(result.stdout);
+ expect(output.number_of_files).toBe(files.length);
+ return {
+ status: result.status,
+ diagnostics: output.diagnostics.map((diagnostic) => {
+ const span = diagnostic.labels[0]?.span;
+ return `${diagnostic.code} ${diagnostic.filename} ${span?.line}:${span?.column}`;
+ }),
+ };
+}
+
+describe(`${RULE} oxlint rule`, () => {
+ test('fires at the module specifier of each of its 19 positive forms, by its own code, and on no negative', () => {
+ const fires = lintOkRulesFixture(FIXTURE).filter((fire) => fire.code === CODE);
+ expect(fires.map((fire) => fire.position)).toEqual([
+ '13:34',
+ '14:35',
+ '15:49',
+ '16:32',
+ '17:8',
+ '18:25',
+ '19:31',
+ '20:35',
+ '21:35',
+ '22:15',
+ '23:27',
+ '24:40',
+ '25:33',
+ '26:38',
+ '27:39',
+ '28:39',
+ '29:21',
+ '30:8',
+ '31:35',
+ ]);
+ const lines = readFileSync(join(ROOT, FIXTURE), 'utf8').split('\n');
+ const positiveLines = lines.flatMap((line, index) => (/\/\/ p /.test(line) ? [index + 1] : []));
+ expect(fires.map((fire) => Number(fire.position.split(':')[0]))).toEqual(positiveLines);
+ for (const fire of fires) {
+ const [line, column] = fire.position.split(':').map(Number);
+ expect(lines[line - 1].slice(column - 1)).toMatch(
+ /^['`]@inkeep\/open-knowledge-core(?:[?#][^'`]*)?['`]/,
+ );
+ expect(fire.message).toContain('Import each binding from the core subpath');
+ expect(fire.message).toMatch(/https?:\/\/[^\s]+/);
+ expect(fire.message).toContain(`${README}#${RULE}`);
+ }
+ });
+
+ test('rule is registered and enabled at error in oxlint.config.ts', async () => {
+ expect(await readRegisteredRuleNames(ROOT)).toContain(RULE);
+ expect(await readEnabledRuleIds(ROOT)).toContain(`ok/${RULE}`);
+ });
+
+ test('its scope is app production source by pattern, minus every canonical test-only suffix', () => {
+ expect(readRuleScope(ROOT, RULE)).toEqual([
+ 'packages/app/src/**/*.ts',
+ 'packages/app/src/**/*.tsx',
+ 'packages/app/src/**/*.mts',
+ 'packages/app/src/**/*.cts',
+ 'packages/app/src/**/*.js',
+ 'packages/app/src/**/*.jsx',
+ 'packages/app/src/**/*.mjs',
+ 'packages/app/src/**/*.cjs',
+ '!**/*.test.ts',
+ '!**/*.test.tsx',
+ '!**/*.test-helper.ts',
+ '!**/*.test-helper.tsx',
+ '!**/*.type-tests.ts',
+ '!**/*.type-tests.tsx',
+ '!**/*.e2e.ts',
+ FIXTURE,
+ ]);
+ for (const path of PRODUCTION_SHAPED) expect(isInScope(RULE, path), path).toBe(true);
+ expect(TEST_ONLY_SOURCE_SUFFIXES.length).toBeGreaterThan(0);
+ for (const suffix of TEST_ONLY_SOURCE_SUFFIXES) {
+ const path = `packages/app/src/components/Widget${suffix}`;
+ expect(isTestOnlySourceFile(path), path).toBe(true);
+ expect(isInScope(RULE, path), path).toBe(false);
+ }
+ for (const path of [
+ 'packages/app/tests/integration/audit-barrier.test-helper.ts',
+ 'packages/app/tests/stress/_helpers/fixtures.ts',
+ 'packages/server/src/lint/audit.ts',
+ 'packages/desktop/src/main/index.ts',
+ 'docs/src/components/docs-sidebar-item.ts',
+ 'lint-plugins/ok-rules/__fixtures__/no-uninstall-forbidden-import.fixture.tsx',
+ ]) {
+ expect(isInScope(RULE, path), path).toBe(false);
+ }
+ });
+
+ test('the registered scoped wrapper visits production files and skips test-only ones', () => {
+ const rule = rules[RULE];
+ const visitorsFor = (path) =>
+ Object.keys(
+ rule.create({
+ physicalFilename: join(ROOT, path),
+ filename: join(ROOT, path),
+ report() {},
+ }),
+ );
+ expect(visitorsFor('packages/app/src/server/hocuspocus-plugin.ts')).toContain(
+ 'ImportDeclaration',
+ );
+ expect(visitorsFor('packages/app/src/components/HelpPopover.dom.test.tsx')).toEqual([]);
+ expect(visitorsFor('packages/server/src/lint/audit.ts')).toEqual([]);
+ });
+
+ test('a copy of the repository lint configuration rejects a planted app import and accepts its subpath form', () => {
+ const root = copyRepoLintConfig();
+ const production = 'packages/app/src/core-barrel-probe/probe.ts';
+ const testOnly = 'packages/app/src/core-barrel-probe/probe.test.ts';
+ try {
+ mkdirSync(join(root, dirname(production)), { recursive: true });
+ writeFileSync(
+ join(root, production),
+ `${BARE_IMPORT}export const probe = sharedExtensions;\n`,
+ );
+ writeFileSync(join(root, testOnly), `${BARE_IMPORT}export const probe = sharedExtensions;\n`);
+ const positive = lintWithRepoConfig(root, [production, testOnly]);
+ expect(positive.status).toBe(1);
+ expect(positive.diagnostics).toEqual([`${CODE} ${production} 1:34`]);
+ writeFileSync(
+ join(root, production),
+ `${SUBPATH_IMPORT}export const probe = sharedExtensions;\n`,
+ );
+ const negative = lintWithRepoConfig(root, [production]);
+ expect(negative.status).toBe(0);
+ expect(negative.diagnostics).toEqual([]);
+ } finally {
+ rmSync(root, { recursive: true, force: true });
+ }
+ });
+
+ test('the README documents the rule at the anchor its message links to', () => {
+ const prose = readFileSync(join(ROOT, README), 'utf8');
+ expect(prose).toContain(`### \`${RULE}\``);
+ expect(prose).toContain(`rules/${RULE}.mjs`);
+ expect(prose).toContain(`tests/${RULE}.uncached.test.mjs`);
+ });
+});
diff --git a/lint-plugins/ok-rules/tests/ok-rules-scope-partition.uncached.test.mjs b/lint-plugins/ok-rules/tests/ok-rules-scope-partition.uncached.test.mjs
index 0bfcdf419..77f2c4995 100644
--- a/lint-plugins/ok-rules/tests/ok-rules-scope-partition.uncached.test.mjs
+++ b/lint-plugins/ok-rules/tests/ok-rules-scope-partition.uncached.test.mjs
@@ -1,4 +1,6 @@
-import { readdirSync, readFileSync } from 'node:fs';
+import { mkdtempSync, readdirSync, readFileSync, rmSync, symlinkSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
import { fileURLToPath } from 'node:url';
import { describe, expect, test } from 'vitest';
import {
@@ -6,7 +8,8 @@ import {
readJsPluginSpecifiers,
} from '../../../test-support/read-ok-rules-config.test-helper.ts';
import plugin, { rules } from '../index.mjs';
-import { isInScope, RULE_SCOPES, UNSCOPED_RULES } from '../scope.mjs';
+import { noAppCoreBarrelImport } from '../rules/no-app-core-barrel-import.mjs';
+import { isInScope, RULE_SCOPES, scoped, UNSCOPED_RULES } from '../scope.mjs';
const REPO_ROOT = fileURLToPath(new URL('../../..', import.meta.url));
const TESTS_DIR = fileURLToPath(new URL('.', import.meta.url));
@@ -107,6 +110,49 @@ describe('ok-rules scope table', () => {
});
});
+describe('scoped() through a symlinked repository path', () => {
+ const RULE = 'no-app-core-barrel-import';
+
+ function withLinkedRoot(run) {
+ const dir = mkdtempSync(join(tmpdir(), 'ok-rules-linked-root-'));
+ const link = join(dir, 'open-knowledge');
+ try {
+ symlinkSync(REPO_ROOT, link, 'dir');
+ run(link);
+ } finally {
+ rmSync(link, { force: true });
+ rmSync(dir, { recursive: true, force: true });
+ }
+ }
+
+ test.each([
+ ['the linted file path', (link) => ({ root: REPO_ROOT, files: link })],
+ ['the repository root', (link) => ({ root: link, files: REPO_ROOT })],
+ ['both the root and the file path', (link) => ({ root: link, files: link })],
+ ])('scopes a rule by its real location when the link is on %s', (_name, layout) => {
+ withLinkedRoot((link) => {
+ const { root, files } = layout(link);
+ const rule = scoped(RULE, noAppCoreBarrelImport, root);
+ const visitorsFor = (path) =>
+ Object.keys(
+ rule.create({
+ physicalFilename: join(files, path),
+ filename: join(files, path),
+ report() {},
+ }),
+ );
+ expect(visitorsFor('packages/app/src/server/hocuspocus-plugin.ts')).toContain(
+ 'ImportDeclaration',
+ );
+ expect(visitorsFor('packages/app/src/a-directory-added-later/module.ts')).toContain(
+ 'ImportDeclaration',
+ );
+ expect(visitorsFor('packages/app/src/components/HelpPopover.dom.test.tsx')).toEqual([]);
+ expect(visitorsFor('packages/server/src/lint/audit.ts')).toEqual([]);
+ });
+ });
+});
+
describe('ok-rules fixture tests', () => {
test('every file in the tests directory runs in the uncached tier or is a helper', () => {
const misplaced = readdirSync(TESTS_DIR).filter(
diff --git a/oxlint.config.ts b/oxlint.config.ts
index b52de61ab..d74643d97 100644
--- a/oxlint.config.ts
+++ b/oxlint.config.ts
@@ -52,6 +52,7 @@ export default defineConfig({
'ok/class-proof-registration-discipline': 'error',
'ok/cst-pm-handler-todo-stub': 'error',
'ok/microcopy-ellipsis': 'error',
+ 'ok/no-app-core-barrel-import': 'error',
'ok/no-blind-agent-host-fanout': 'error',
'ok/no-demoted-dialog-confirm': 'error',
'ok/no-hand-rolled-branch-validation': 'error',
diff --git a/packages/app/src/App.tsx b/packages/app/src/App.tsx
index 7fd23cefd..bbca89b07 100644
--- a/packages/app/src/App.tsx
+++ b/packages/app/src/App.tsx
@@ -1,4 +1,5 @@
-import { mediaKindForSidebarAssetExtension, SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core';
+import { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core/constants/feature-flags';
+import { mediaKindForSidebarAssetExtension } from '@inkeep/open-knowledge-core/constants/upload';
import { lazy, type ReactNode, Suspense, useEffect, useRef, useState } from 'react';
import { toast } from 'sonner';
import { CommentQueueShortcut } from '@/comments/CommentQueueShortcut';
diff --git a/packages/app/src/comments/CommentSelectionAffordance.tsx b/packages/app/src/comments/CommentSelectionAffordance.tsx
index a7dafb65a..f695b6168 100644
--- a/packages/app/src/comments/CommentSelectionAffordance.tsx
+++ b/packages/app/src/comments/CommentSelectionAffordance.tsx
@@ -1,7 +1,7 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
import { autoUpdate, computePosition, flip, offset, shift, size } from '@floating-ui/dom';
-import { commentQuoteText } from '@inkeep/open-knowledge-core';
+import { commentQuoteText } from '@inkeep/open-knowledge-core/comments/leaf-text';
import { Trans, useLingui } from '@lingui/react/macro';
import { posToDOMRect } from '@tiptap/core';
import type { Editor } from '@tiptap/react';
diff --git a/packages/app/src/comments/anchor-search.ts b/packages/app/src/comments/anchor-search.ts
index a4b86679b..9649ba838 100644
--- a/packages/app/src/comments/anchor-search.ts
+++ b/packages/app/src/comments/anchor-search.ts
@@ -1,12 +1,11 @@
+import { commentLeafText, commentQuoteText } from '@inkeep/open-knowledge-core/comments/leaf-text';
import {
- commentLeafText,
- commentQuoteText,
contextEvidenceFloor,
contextMatchScore,
findAllPassages,
type PassageMatch,
rewriteCeiling,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/comments/passage-match';
import type { Node as PMNode } from '@tiptap/pm/model';
interface TextIndex {
diff --git a/packages/app/src/comments/comments-client.ts b/packages/app/src/comments/comments-client.ts
index 316ed45eb..d8a1c77e5 100644
--- a/packages/app/src/comments/comments-client.ts
+++ b/packages/app/src/comments/comments-client.ts
@@ -7,7 +7,7 @@ import {
PrepareBatchSuccessSchema,
ProblemDetailsSchema,
QueueSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
export type { CommentThreadMeta, DispatchPayload };
diff --git a/packages/app/src/components/AgentDiffPane.tsx b/packages/app/src/components/AgentDiffPane.tsx
index 0ed9a20d2..8fe6aad5d 100644
--- a/packages/app/src/components/AgentDiffPane.tsx
+++ b/packages/app/src/components/AgentDiffPane.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import type { FrontmatterDelta } from '@inkeep/open-knowledge-core';
+import type { FrontmatterDelta } from '@inkeep/open-knowledge-core/frontmatter-diff';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { PanelRightClose, PanelRightOpen, X } from 'lucide-react';
import { lazy, Suspense, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/AgentIconCluster.tsx b/packages/app/src/components/AgentIconCluster.tsx
index af33dc5a0..a90d2bc04 100644
--- a/packages/app/src/components/AgentIconCluster.tsx
+++ b/packages/app/src/components/AgentIconCluster.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { EDITOR_LABELS } from '@inkeep/open-knowledge-core';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
import { Folder, Sparkles } from 'lucide-react';
import type { SVGProps } from 'react';
import { TargetIcon } from '@/components/handoff/OpenInAgentMenuItem';
diff --git a/packages/app/src/components/ArrayOfObjectsWidget.tsx b/packages/app/src/components/ArrayOfObjectsWidget.tsx
index 0c911e375..78354b437 100644
--- a/packages/app/src/components/ArrayOfObjectsWidget.tsx
+++ b/packages/app/src/components/ArrayOfObjectsWidget.tsx
@@ -16,7 +16,7 @@ import {
verticalListSortingStrategy,
} from '@dnd-kit/sortable';
import { CSS } from '@dnd-kit/utilities';
-import type { FrontmatterValue } from '@inkeep/open-knowledge-core';
+import type { FrontmatterValue } from '@inkeep/open-knowledge-core/frontmatter/schema';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ChevronRight, GripVertical, Plus, Trash2 } from 'lucide-react';
import { type CSSProperties, useState } from 'react';
diff --git a/packages/app/src/components/AssetPreview.tsx b/packages/app/src/components/AssetPreview.tsx
index 5e193d891..ef333d650 100644
--- a/packages/app/src/components/AssetPreview.tsx
+++ b/packages/app/src/components/AssetPreview.tsx
@@ -1,4 +1,5 @@
-import { type InlineAssetMediaKind, toDesktopAssetHref } from '@inkeep/open-knowledge-core';
+import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core/constants/upload';
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
import { Trans } from '@lingui/react/macro';
import { useState } from 'react';
import { MermaidFileViewer } from '@/components/MermaidFileViewer';
diff --git a/packages/app/src/components/BottomComposer.tsx b/packages/app/src/components/BottomComposer.tsx
index b495bbb53..80e203702 100644
--- a/packages/app/src/components/BottomComposer.tsx
+++ b/packages/app/src/components/BottomComposer.tsx
@@ -1,6 +1,10 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { type TargetData, TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core';
+import {
+ type TargetData,
+ TERMINAL_CLIS,
+ type TerminalCli,
+} from '@inkeep/open-knowledge-core/handoff';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, ChevronDown, TextQuote, X } from 'lucide-react';
import { useEffect, useEffectEvent, useRef, useState } from 'react';
diff --git a/packages/app/src/components/BugReportHistory.tsx b/packages/app/src/components/BugReportHistory.tsx
index fd437028e..3a4cf2090 100644
--- a/packages/app/src/components/BugReportHistory.tsx
+++ b/packages/app/src/components/BugReportHistory.tsx
@@ -1,4 +1,4 @@
-import type { OkBugReportListRow } from '@inkeep/open-knowledge-core';
+import type { OkBugReportListRow } from '@inkeep/open-knowledge-core/logger-types';
import { Trans, useLingui } from '@lingui/react/macro';
import { ChevronDownIcon, FolderOpenIcon, MailIcon, RotateCwIcon, Trash2Icon } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/CommandPalette.tsx b/packages/app/src/components/CommandPalette.tsx
index f787db22e..f4166dbb5 100644
--- a/packages/app/src/components/CommandPalette.tsx
+++ b/packages/app/src/components/CommandPalette.tsx
@@ -2,13 +2,13 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import type { WorktreeSelectorEntry } from '@inkeep/open-knowledge-core/git/worktree-selector-model';
import {
assertNeverSemanticQueryOutcome,
classifySemanticProviderError,
isSemanticSearchOffered,
semanticProviderErrorBlocks,
- type WorktreeSelectorEntry,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { Check, FileText, Folder, GitBranch, Hash, Sparkles } from 'lucide-react';
import {
diff --git a/packages/app/src/components/ConflictView.tsx b/packages/app/src/components/ConflictView.tsx
index f1daddcfa..cbf608302 100644
--- a/packages/app/src/components/ConflictView.tsx
+++ b/packages/app/src/components/ConflictView.tsx
@@ -1,8 +1,8 @@
import {
- type SyncConflictContentSuccess,
type SynthesisedConflictRegion,
synthesiseConflictMarkersWithRegions,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/bridge';
+import type { SyncConflictContentSuccess } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import type {
FileDiffMetadata,
diff --git a/packages/app/src/components/ConsentDialogBody.tsx b/packages/app/src/components/ConsentDialogBody.tsx
index 6686d715f..d145a0135 100644
--- a/packages/app/src/components/ConsentDialogBody.tsx
+++ b/packages/app/src/components/ConsentDialogBody.tsx
@@ -2,7 +2,7 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { receivesProjectIntegrationWrite } from '@inkeep/open-knowledge-core';
+import { receivesProjectIntegrationWrite } from '@inkeep/open-knowledge-core/constants/editors';
import type { MessageDescriptor } from '@lingui/core';
import { msg } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
diff --git a/packages/app/src/components/CreateProjectDialog.tsx b/packages/app/src/components/CreateProjectDialog.tsx
index 54921cc3d..fdde0c897 100644
--- a/packages/app/src/components/CreateProjectDialog.tsx
+++ b/packages/app/src/components/CreateProjectDialog.tsx
@@ -1,10 +1,10 @@
+import type { CreateNewBannerKind } from '@inkeep/open-knowledge-core/constants/create-new-banner';
import {
CREATE_NEW_PROJECT_FAILURE_REASONS,
- type CreateNewBannerKind,
type CreateNewProjectFailureReason,
- receivesProjectIntegrationWrite,
- sanitizeFolderName,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/create-new-project-reason';
+import { receivesProjectIntegrationWrite } from '@inkeep/open-knowledge-core/constants/editors';
+import { sanitizeFolderName } from '@inkeep/open-knowledge-core/utils/sanitize-folder-name';
import type { MessageDescriptor } from '@lingui/core';
import { msg } from '@lingui/core/macro';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
diff --git a/packages/app/src/components/CreatedItemsList.tsx b/packages/app/src/components/CreatedItemsList.tsx
index 79c4a53ba..0dbe1c078 100644
--- a/packages/app/src/components/CreatedItemsList.tsx
+++ b/packages/app/src/components/CreatedItemsList.tsx
@@ -1,4 +1,4 @@
-import type { LintPluginId } from '@inkeep/open-knowledge-core';
+import type { LintPluginId } from '@inkeep/open-knowledge-core/markdown/lint';
import { plural } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { File, Folder, Hexagon, type LucideIcon, Puzzle } from 'lucide-react';
diff --git a/packages/app/src/components/DiffViewBoundary.tsx b/packages/app/src/components/DiffViewBoundary.tsx
index 0c283d475..8efee9b84 100644
--- a/packages/app/src/components/DiffViewBoundary.tsx
+++ b/packages/app/src/components/DiffViewBoundary.tsx
@@ -3,7 +3,7 @@ import {
type ResolveStrategyWire,
type SyncConflictContentSuccess,
SyncConflictContentSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/EditorActivityPool.tsx b/packages/app/src/components/EditorActivityPool.tsx
index 525cd6bf7..4ac4774bc 100644
--- a/packages/app/src/components/EditorActivityPool.tsx
+++ b/packages/app/src/components/EditorActivityPool.tsx
@@ -1,12 +1,14 @@
import {
- isEditableTextDocFile,
- isExcalidrawDocFile,
isManagedArtifactDocName,
+ parseTemplateContentDocName,
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
+import {
+ isExcalidrawDocFile,
isMarkdownDocFile,
isMermaidDocFile,
- parseTemplateContentDocName,
- randomUUID,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/upload';
+import { randomUUID } from '@inkeep/open-knowledge-core/utils/random-uuid';
import { t } from '@lingui/core/macro';
import { RefreshCw } from 'lucide-react';
import {
diff --git a/packages/app/src/components/EditorArea.tsx b/packages/app/src/components/EditorArea.tsx
index e8ec40476..4680c883e 100644
--- a/packages/app/src/components/EditorArea.tsx
+++ b/packages/app/src/components/EditorArea.tsx
@@ -1,14 +1,16 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
import type { HocuspocusProvider } from '@hocuspocus/provider';
+import { parseExternalSkillDocName } from '@inkeep/open-knowledge-core/constants/cc1';
+import { detectEmbeddedHostFromBrowser } from '@inkeep/open-knowledge-core/constants/embedded-host';
import {
- detectEmbeddedHostFromBrowser,
isFrontmatterSchemaAsset,
isMarkdownlintJsonConfig,
+} from '@inkeep/open-knowledge-core/markdown/lint';
+import {
PREFERRED_TERMINAL_RIGHT_WIDTH,
- parseExternalSkillDocName,
type TerminalPlacement,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/terminal-layout';
import { Trans, useLingui } from '@lingui/react/macro';
import {
lazy,
diff --git a/packages/app/src/components/EditorBreadcrumb.tsx b/packages/app/src/components/EditorBreadcrumb.tsx
index e7a0564cb..1c451162f 100644
--- a/packages/app/src/components/EditorBreadcrumb.tsx
+++ b/packages/app/src/components/EditorBreadcrumb.tsx
@@ -1,4 +1,7 @@
-import { parseManagedArtifactName, parseTemplateContentDocName } from '@inkeep/open-knowledge-core';
+import {
+ parseManagedArtifactName,
+ parseTemplateContentDocName,
+} from '@inkeep/open-knowledge-core/constants/cc1';
import { MoreHorizontalIcon } from 'lucide-react';
import { Fragment } from 'react';
import { UserText } from '@/components/UserText';
diff --git a/packages/app/src/components/EditorHeader.tsx b/packages/app/src/components/EditorHeader.tsx
index c22dd1ae2..7d4be4b77 100644
--- a/packages/app/src/components/EditorHeader.tsx
+++ b/packages/app/src/components/EditorHeader.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { parseManagedArtifactName } from '@inkeep/open-knowledge-core';
+import { parseManagedArtifactName } from '@inkeep/open-knowledge-core/constants/cc1';
import { useLingui } from '@lingui/react/macro';
import { MoreHorizontalIcon, Search } from 'lucide-react';
import { lazy, type ReactNode, Suspense, useLayoutEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/EditorPane.tsx b/packages/app/src/components/EditorPane.tsx
index b542f54b0..52629e33b 100644
--- a/packages/app/src/components/EditorPane.tsx
+++ b/packages/app/src/components/EditorPane.tsx
@@ -1,11 +1,8 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import {
- isEditableTextDocFile,
- type TerminalCli,
- type TerminalLaunchCommand,
- type TerminalPlacement,
-} from '@inkeep/open-knowledge-core';
import type { AttachmentPart } from '@inkeep/open-knowledge-core/acp/thread-protocol';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
+import type { TerminalCli, TerminalLaunchCommand } from '@inkeep/open-knowledge-core/handoff';
+import type { TerminalPlacement } from '@inkeep/open-knowledge-core/terminal-layout';
import {
lazy,
Suspense,
diff --git a/packages/app/src/components/EditorTabs.tsx b/packages/app/src/components/EditorTabs.tsx
index 34b29d2a8..c6e941dcd 100644
--- a/packages/app/src/components/EditorTabs.tsx
+++ b/packages/app/src/components/EditorTabs.tsx
@@ -4,7 +4,7 @@
import { useDndContext } from '@dnd-kit/core';
import { horizontalListSortingStrategy, SortableContext, useSortable } from '@dnd-kit/sortable';
-import { isEditableTextDocFile } from '@inkeep/open-knowledge-core';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
import { Trans, useLingui } from '@lingui/react/macro';
import {
AlertTriangle,
diff --git a/packages/app/src/components/EditorToolbar.tsx b/packages/app/src/components/EditorToolbar.tsx
index a6a0fc224..c9c3f1539 100644
--- a/packages/app/src/components/EditorToolbar.tsx
+++ b/packages/app/src/components/EditorToolbar.tsx
@@ -2,13 +2,13 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
import {
- isEditableTextDocFile,
- isExcalidrawDocFile,
- type LintDiagnostic,
parseExternalSkillDocName,
parseManagedArtifactName,
- type SkillScope,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
+import { isExcalidrawDocFile } from '@inkeep/open-knowledge-core/constants/upload';
+import type { LintDiagnostic } from '@inkeep/open-knowledge-core/markdown/lint';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { PanelRightClose, PanelRightOpen } from 'lucide-react';
import { lazy, Suspense } from 'react';
diff --git a/packages/app/src/components/EmptyEditorState.tsx b/packages/app/src/components/EmptyEditorState.tsx
index a0b0fe557..a8645a25f 100644
--- a/packages/app/src/components/EmptyEditorState.tsx
+++ b/packages/app/src/components/EmptyEditorState.tsx
@@ -1,4 +1,7 @@
-import { DocumentListSuccessSchema, type TemplatesListEntry } from '@inkeep/open-knowledge-core';
+import {
+ DocumentListSuccessSchema,
+ type TemplatesListEntry,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { Info } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/ExploreSkills.tsx b/packages/app/src/components/ExploreSkills.tsx
index 7c5a6b76e..fb3246a3c 100644
--- a/packages/app/src/components/ExploreSkills.tsx
+++ b/packages/app/src/components/ExploreSkills.tsx
@@ -1,4 +1,5 @@
-import type { SkillScope, SkillSearchResult } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillSearchResult } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { msg } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { Search } from 'lucide-react';
diff --git a/packages/app/src/components/FileSidebar.tsx b/packages/app/src/components/FileSidebar.tsx
index e07099a59..4d0a5e891 100644
--- a/packages/app/src/components/FileSidebar.tsx
+++ b/packages/app/src/components/FileSidebar.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { humanFormat } from '@inkeep/open-knowledge-core';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import { Trans, useLingui } from '@lingui/react/macro';
import {
ChevronRight,
diff --git a/packages/app/src/components/FileTree.tsx b/packages/app/src/components/FileTree.tsx
index cb61306e5..32631f798 100644
--- a/packages/app/src/components/FileTree.tsx
+++ b/packages/app/src/components/FileTree.tsx
@@ -1,20 +1,22 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import type { OkignoreBinding } from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
+import { isDocumentOverOpenByteLimit } from '@inkeep/open-knowledge-core/constants/document-open';
+import type {
+ HandoffOutcome,
+ HandoffTarget,
+ InstallState,
+} from '@inkeep/open-knowledge-core/handoff';
import {
CreateFolderSuccessSchema,
CreatePageSuccessSchema,
DeletePathSuccessSchema,
DuplicatePathSuccessSchema,
- type HandoffOutcome,
- type HandoffTarget,
- type InstallState,
- isDocumentOverOpenByteLimit,
- type OkignoreBinding,
RenamePathSuccessSchema,
TrashCleanupSuccessSchema,
UploadAssetSuccessSchema,
WorkspaceSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { plural, t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import {
diff --git a/packages/app/src/components/FileTreeFilteredToZeroNotice.tsx b/packages/app/src/components/FileTreeFilteredToZeroNotice.tsx
index 0858fe2a9..62af1c51b 100644
--- a/packages/app/src/components/FileTreeFilteredToZeroNotice.tsx
+++ b/packages/app/src/components/FileTreeFilteredToZeroNotice.tsx
@@ -1,4 +1,4 @@
-import { humanFormat } from '@inkeep/open-knowledge-core';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import { useLingui } from '@lingui/react/macro';
import { useId } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/FolderPropertiesCard.tsx b/packages/app/src/components/FolderPropertiesCard.tsx
index cdf74df7a..7a5220e39 100644
--- a/packages/app/src/components/FolderPropertiesCard.tsx
+++ b/packages/app/src/components/FolderPropertiesCard.tsx
@@ -3,7 +3,7 @@ import {
type FrontmatterValue,
inferType,
isFrontmatterValueEmpty,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/frontmatter/schema';
import { Trans, useLingui } from '@lingui/react/macro';
import { ChevronRight, FolderCog, Plus } from 'lucide-react';
import { useState } from 'react';
diff --git a/packages/app/src/components/FolderTimelineCard.tsx b/packages/app/src/components/FolderTimelineCard.tsx
index 9acb77b06..fa3330530 100644
--- a/packages/app/src/components/FolderTimelineCard.tsx
+++ b/packages/app/src/components/FolderTimelineCard.tsx
@@ -1,6 +1,7 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { ProblemDetailsSchema, type TimelineEntry } from '@inkeep/open-knowledge-core';
+import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core/schemas/api';
+import type { TimelineEntry } from '@inkeep/open-knowledge-core/types/timeline';
import { t } from '@lingui/core/macro';
import { Trans } from '@lingui/react/macro';
import {
diff --git a/packages/app/src/components/FrontmatterBindingContext.tsx b/packages/app/src/components/FrontmatterBindingContext.tsx
index 683a5f11c..7161cbaa6 100644
--- a/packages/app/src/components/FrontmatterBindingContext.tsx
+++ b/packages/app/src/components/FrontmatterBindingContext.tsx
@@ -1,4 +1,4 @@
-import type { FrontmatterBinding } from '@inkeep/open-knowledge-core';
+import type { FrontmatterBinding } from '@inkeep/open-knowledge-core/bridge';
import { createContext, type ReactNode, use } from 'react';
const FrontmatterBindingContext = createContext<FrontmatterBinding | null>(null);
diff --git a/packages/app/src/components/FrontmatterRow.tsx b/packages/app/src/components/FrontmatterRow.tsx
index e0c8591ac..96f5622e0 100644
--- a/packages/app/src/components/FrontmatterRow.tsx
+++ b/packages/app/src/components/FrontmatterRow.tsx
@@ -6,7 +6,7 @@ import {
type FrontmatterType,
type FrontmatterValue,
isFrontmatterValueEmpty,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/frontmatter/schema';
import { Trans, useLingui } from '@lingui/react/macro';
import { AlertTriangle, GripVertical, Trash2, X } from 'lucide-react';
import type { CSSProperties, ReactNode } from 'react';
diff --git a/packages/app/src/components/GraphPanel.tsx b/packages/app/src/components/GraphPanel.tsx
index 97b712a52..9e8be459a 100644
--- a/packages/app/src/components/GraphPanel.tsx
+++ b/packages/app/src/components/GraphPanel.tsx
@@ -1,17 +1,22 @@
// oxlint-disable ok/no-raw-html-interactive-element -- pre-rule backlog — file uses raw <button>/<input>/<textarea> awaiting shadcn migration; tracked at https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-raw-html-interactive-element
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+
+import {
+ parseGlobalSkillBundleDoc,
+ parseProjectSkillBundleDoc,
+} from '@inkeep/open-knowledge-core/constants/cc1';
import {
- type HubEntry,
- HubsSuccessSchema,
isOrphanMode,
ORPHAN_MODES,
- type OrphanEntry,
type OrphanMode,
+} from '@inkeep/open-knowledge-core/constants/graph';
+import {
+ type HubEntry,
+ HubsSuccessSchema,
+ type OrphanEntry,
OrphansSuccessSchema,
ProblemDetailsSchema,
- parseGlobalSkillBundleDoc,
- parseProjectSkillBundleDoc,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { useQuery } from '@tanstack/react-query';
diff --git a/packages/app/src/components/GraphView.tsx b/packages/app/src/components/GraphView.tsx
index 198ca0c64..b50c505b4 100644
--- a/packages/app/src/components/GraphView.tsx
+++ b/packages/app/src/components/GraphView.tsx
@@ -1,4 +1,7 @@
-import { LinkGraphSuccessSchema, ProblemDetailsSchema } from '@inkeep/open-knowledge-core';
+import {
+ LinkGraphSuccessSchema,
+ ProblemDetailsSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { useTheme } from 'next-themes';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/HelpPopover.dom.test.tsx b/packages/app/src/components/HelpPopover.dom.test.tsx
index 995c00d87..6ac54d64c 100644
--- a/packages/app/src/components/HelpPopover.dom.test.tsx
+++ b/packages/app/src/components/HelpPopover.dom.test.tsx
@@ -5,6 +5,7 @@ import type { ReactNode } from 'react';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
import { TooltipProvider } from '@/components/ui/tooltip';
import { renderLinguiTemplate } from '@/test-utils/lingui-mock';
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
vi.doMock('@lingui/core/macro', () => ({ ...actualLinguiMacro, msg: renderLinguiTemplate }));
@@ -14,10 +15,14 @@ vi.doMock('@lingui/react/macro', () => ({
useLingui: () => ({ t: renderLinguiTemplate }),
}));
-vi.doMock('@inkeep/open-knowledge-core', async (importActual) => ({
- ...(await importActual<typeof import('@inkeep/open-knowledge-core')>()),
- getGitHubStars: async () => 1234,
-}));
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/utils/github-stars', async (importActual) =>
+ servedCore.serve('@inkeep/open-knowledge-core/utils/github-stars', {
+ ...(await importActual<typeof import('@inkeep/open-knowledge-core/utils/github-stars')>()),
+ getGitHubStars: async () => 1234,
+ }),
+);
vi.doMock('@/lib/external-link', () => ({
dispatchExternalLinkClick: () => {},
@@ -205,3 +210,21 @@ describe('HelpPopover with the desktop bridge present', () => {
);
});
});
+
+describe('HelpPopover core replacement liveness', () => {
+ test('the star count HelpPopover renders is the one the github-stars replacement serves', async () => {
+ const since = servedCore.mark();
+ await renderOpenHelpPopover();
+
+ const nav = screen.getByRole('navigation', { name: 'Community' });
+ const githubLink = within(nav).getByRole('link', { name: /GitHub/ });
+ await waitFor(() => expect(within(githubLink).getByText('1.2k')).not.toBeNull());
+ expect(
+ servedCore.readersOf(
+ '@inkeep/open-knowledge-core/utils/github-stars',
+ 'getGitHubStars',
+ since,
+ ),
+ ).toEqual(['components/HelpPopover.tsx']);
+ });
+});
diff --git a/packages/app/src/components/HelpPopover.tsx b/packages/app/src/components/HelpPopover.tsx
index 1ccdb479d..ff47169ff 100644
--- a/packages/app/src/components/HelpPopover.tsx
+++ b/packages/app/src/components/HelpPopover.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { getGitHubStars } from '@inkeep/open-knowledge-core';
+import { getGitHubStars } from '@inkeep/open-knowledge-core/utils/github-stars';
import type { MessageDescriptor } from '@lingui/core';
import { msg } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
diff --git a/packages/app/src/components/ImportSkillDialog.tsx b/packages/app/src/components/ImportSkillDialog.tsx
index 7910915ee..01cad3e48 100644
--- a/packages/app/src/components/ImportSkillDialog.tsx
+++ b/packages/app/src/components/ImportSkillDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans } from '@lingui/react/macro';
import { ExploreSkills } from '@/components/ExploreSkills';
import { ImportSkillForm } from '@/components/ImportSkillForm';
diff --git a/packages/app/src/components/ImportSkillForm.tsx b/packages/app/src/components/ImportSkillForm.tsx
index e9f9f3a0c..f4ef091de 100644
--- a/packages/app/src/components/ImportSkillForm.tsx
+++ b/packages/app/src/components/ImportSkillForm.tsx
@@ -1,6 +1,7 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import type { SkillDiscover, SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillDiscover } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { Trans, useLingui } from '@lingui/react/macro';
import { FileArchive, Folder, GitBranch } from 'lucide-react';
import { useEffect, useId, useRef, useState } from 'react';
diff --git a/packages/app/src/components/LargeFileEditorState.tsx b/packages/app/src/components/LargeFileEditorState.tsx
index 8fa23f206..f091bcc57 100644
--- a/packages/app/src/components/LargeFileEditorState.tsx
+++ b/packages/app/src/components/LargeFileEditorState.tsx
@@ -1,4 +1,4 @@
-import { formatFileSize } from '@inkeep/open-knowledge-core';
+import { formatFileSize } from '@inkeep/open-knowledge-core/utils/file-size';
import { Trans } from '@lingui/react/macro';
import { ArrowLeft, FileWarning } from 'lucide-react';
import { useEffect, useId, useRef } from 'react';
diff --git a/packages/app/src/components/LinksPanel.tsx b/packages/app/src/components/LinksPanel.tsx
index d06d78b1f..863c69ca3 100644
--- a/packages/app/src/components/LinksPanel.tsx
+++ b/packages/app/src/components/LinksPanel.tsx
@@ -8,7 +8,7 @@ import {
type ForwardLinksSuccess,
ForwardLinksSuccessSchema,
ProblemDetailsSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { useQuery } from '@tanstack/react-query';
diff --git a/packages/app/src/components/ManagedArtifactProperties.tsx b/packages/app/src/components/ManagedArtifactProperties.tsx
index 645da2425..abf5c0a05 100644
--- a/packages/app/src/components/ManagedArtifactProperties.tsx
+++ b/packages/app/src/components/ManagedArtifactProperties.tsx
@@ -3,9 +3,9 @@ import {
isExternalSkillDocName,
parseManagedArtifactName,
parseTemplateContentDocName,
- type SkillScope,
templateContentDocName,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/NewSkillDialog.tsx b/packages/app/src/components/NewSkillDialog.tsx
index 17f079a1e..589d9b3ae 100644
--- a/packages/app/src/components/NewSkillDialog.tsx
+++ b/packages/app/src/components/NewSkillDialog.tsx
@@ -1,4 +1,4 @@
-import { SKILL_NAME_REGEX, type SkillScope } from '@inkeep/open-knowledge-core';
+import { SKILL_NAME_REGEX, type SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useId, useRef, useState } from 'react';
import { Button } from '@/components/ui/button';
diff --git a/packages/app/src/components/NewWorktreeDialog.tsx b/packages/app/src/components/NewWorktreeDialog.tsx
index f02ee9fbe..da45a0f33 100644
--- a/packages/app/src/components/NewWorktreeDialog.tsx
+++ b/packages/app/src/components/NewWorktreeDialog.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { stripRemotePrefix } from '@inkeep/open-knowledge-core';
+import { stripRemotePrefix } from '@inkeep/open-knowledge-core/git/worktree-selector-model';
import type { MessageDescriptor } from '@lingui/core';
import { Trans, useLingui } from '@lingui/react/macro';
import { Check, ChevronsUpDown, Cloud, FolderOpen, GitBranch, Plus, Search } from 'lucide-react';
diff --git a/packages/app/src/components/NotInSidebarIndicator.tsx b/packages/app/src/components/NotInSidebarIndicator.tsx
index c3fa15b71..b97a7b8f2 100644
--- a/packages/app/src/components/NotInSidebarIndicator.tsx
+++ b/packages/app/src/components/NotInSidebarIndicator.tsx
@@ -1,4 +1,4 @@
-import { humanFormat } from '@inkeep/open-knowledge-core';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import { useLingui } from '@lingui/react/macro';
import { EyeOff } from 'lucide-react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/ObjectWidget.tsx b/packages/app/src/components/ObjectWidget.tsx
index 093d8b271..8e6bf80c6 100644
--- a/packages/app/src/components/ObjectWidget.tsx
+++ b/packages/app/src/components/ObjectWidget.tsx
@@ -20,7 +20,7 @@ import {
frontmatterValuesEqual,
inferType,
RESERVED_FRONTMATTER_KEY,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/frontmatter/schema';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ChevronRight, Plus } from 'lucide-react';
import { useState } from 'react';
diff --git a/packages/app/src/components/OutlinePanel.tsx b/packages/app/src/components/OutlinePanel.tsx
index 207ad196c..0dd58344c 100644
--- a/packages/app/src/components/OutlinePanel.tsx
+++ b/packages/app/src/components/OutlinePanel.tsx
@@ -1,10 +1,11 @@
// oxlint-disable ok/no-raw-html-interactive-element -- pre-rule backlog — file uses raw <button>/<input>/<textarea> awaiting shadcn migration; tracked at https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-raw-html-interactive-element
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+
import {
- type HeadingEntry,
PageHeadingsSuccessSchema,
ProblemDetailsSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
+import type { HeadingEntry } from '@inkeep/open-knowledge-core/utils/slug';
import { t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { useQuery, useQueryClient } from '@tanstack/react-query';
diff --git a/packages/app/src/components/PageHeader.tsx b/packages/app/src/components/PageHeader.tsx
index 0e77a510d..9267d1652 100644
--- a/packages/app/src/components/PageHeader.tsx
+++ b/packages/app/src/components/PageHeader.tsx
@@ -11,7 +11,7 @@ import {
type FrontmatterSnapshot,
readFmKeys,
readFmRegionWithError,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/bridge';
import { useLingui } from '@lingui/react/macro';
import { useEffect, useRef, useState } from 'react';
import {
diff --git a/packages/app/src/components/PageHeaderWidgets.tsx b/packages/app/src/components/PageHeaderWidgets.tsx
index df21ec93b..6b114be15 100644
--- a/packages/app/src/components/PageHeaderWidgets.tsx
+++ b/packages/app/src/components/PageHeaderWidgets.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-raw-html-interactive-element -- matches the existing PropertyWidgets.tsx posture — raw `<input>` is the typed-input affordance shared across every frontmatter widget; migrating to shadcn `<Input>` is the file-wide pre-rule backlog described in PropertyWidgets.tsx's top-of-file ignore comment.
-import { ALLOWED_IMAGE_MIME_TYPES } from '@inkeep/open-knowledge-core';
+import { ALLOWED_IMAGE_MIME_TYPES } from '@inkeep/open-knowledge-core/constants/upload';
import { useLingui } from '@lingui/react/macro';
import { ImagePlus, Smile, Upload, X } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/PageListContext.tsx b/packages/app/src/components/PageListContext.tsx
index ad67b2777..2f6c30db6 100644
--- a/packages/app/src/components/PageListContext.tsx
+++ b/packages/app/src/components/PageListContext.tsx
@@ -1,4 +1,4 @@
-import { toWikiLinkSlug } from '@inkeep/open-knowledge-core';
+import { toWikiLinkSlug } from '@inkeep/open-knowledge-core/utils/slug';
import { t } from '@lingui/core/macro';
import { createContext, type ReactNode, use, useEffect, useRef, useState } from 'react';
import {
diff --git a/packages/app/src/components/ProblemsPanel.tsx b/packages/app/src/components/ProblemsPanel.tsx
index 99f5c4b79..92bbf1f95 100644
--- a/packages/app/src/components/ProblemsPanel.tsx
+++ b/packages/app/src/components/ProblemsPanel.tsx
@@ -1,13 +1,14 @@
// oxlint-disable ok/no-raw-html-interactive-element -- matches sibling OutlinePanel — positional list of <button> rows awaiting a shared shadcn list primitive; tracked at https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-raw-html-interactive-element
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
import {
- type BrokenLinkSuppression,
type FrontmatterScope,
isAuditEmptyScopeWarning,
- isEditableTextDocFile,
type ValidationAuditResponse,
type ValidationDocResult,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
+import type { BrokenLinkSuppression } from '@inkeep/open-knowledge-core/schemas/api';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import {
AlertCircle,
diff --git a/packages/app/src/components/ProjectAiToolsField.tsx b/packages/app/src/components/ProjectAiToolsField.tsx
index 8250a32ba..ad49bae8e 100644
--- a/packages/app/src/components/ProjectAiToolsField.tsx
+++ b/packages/app/src/components/ProjectAiToolsField.tsx
@@ -4,7 +4,7 @@ import {
type EditorId,
RESERVED_PROJECT_SKILL_NAME,
STABLE_EDITOR_PROJECT_CONFIG_PATH,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/editors';
import { i18n } from '@lingui/core';
import { Trans, useLingui } from '@lingui/react/macro';
import { useId } from 'react';
diff --git a/packages/app/src/components/PropertyDiffBlock.tsx b/packages/app/src/components/PropertyDiffBlock.tsx
index 7fef64b60..2981fed65 100644
--- a/packages/app/src/components/PropertyDiffBlock.tsx
+++ b/packages/app/src/components/PropertyDiffBlock.tsx
@@ -1,9 +1,8 @@
-import {
- type FrontmatterDelta,
- type FrontmatterValue,
- inferType,
- type PropertyChange,
-} from '@inkeep/open-knowledge-core';
+import { type FrontmatterValue, inferType } from '@inkeep/open-knowledge-core/frontmatter/schema';
+import type {
+ FrontmatterDelta,
+ PropertyChange,
+} from '@inkeep/open-knowledge-core/frontmatter-diff';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { Minus, Pencil, Plus } from 'lucide-react';
import type { ReactNode } from 'react';
diff --git a/packages/app/src/components/PropertyPanel.tsx b/packages/app/src/components/PropertyPanel.tsx
index 829a409db..f2c521bac 100644
--- a/packages/app/src/components/PropertyPanel.tsx
+++ b/packages/app/src/components/PropertyPanel.tsx
@@ -16,17 +16,19 @@ import type { HocuspocusProvider } from '@hocuspocus/provider';
import {
bindFrontmatterDoc,
type FrontmatterBinding,
- type FrontmatterPatch,
type FrontmatterSnapshot,
+ readFmKeys,
+ readFmRegionWithError,
+} from '@inkeep/open-knowledge-core/bridge';
+import { fieldErrorsFromError } from '@inkeep/open-knowledge-core/frontmatter/errors';
+import {
+ type FrontmatterPatch,
type FrontmatterType,
type FrontmatterValue,
- fieldErrorsFromError,
frontmatterValuesEqual,
inferType,
isFrontmatterValueEmpty,
- readFmKeys,
- readFmRegionWithError,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/frontmatter/schema';
import { Trans, useLingui } from '@lingui/react/macro';
import { AlertTriangle, Plus } from 'lucide-react';
import { type ReactNode, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/PropertyWidgets.tsx b/packages/app/src/components/PropertyWidgets.tsx
index 49bfd7ad5..2965be374 100644
--- a/packages/app/src/components/PropertyWidgets.tsx
+++ b/packages/app/src/components/PropertyWidgets.tsx
@@ -2,13 +2,15 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import type {
+ FrontmatterType,
+ FrontmatterValue,
+} from '@inkeep/open-knowledge-core/frontmatter/schema';
import {
FRONTMATTER_TAG_GRAMMAR_HINT,
FRONTMATTER_TAG_VALUE_RE,
- type FrontmatterType,
- type FrontmatterValue,
isValidFrontmatterTagValue,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/frontmatter/tags';
import type { MessageDescriptor } from '@lingui/core';
import { msg } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
diff --git a/packages/app/src/components/PublishToGitHubDialog.tsx b/packages/app/src/components/PublishToGitHubDialog.tsx
index ef2df85f6..44444fa25 100644
--- a/packages/app/src/components/PublishToGitHubDialog.tsx
+++ b/packages/app/src/components/PublishToGitHubDialog.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import type { SharePublishOwner } from '@inkeep/open-knowledge-core';
+import type { SharePublishOwner } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { CheckCircle2, Copy, ExternalLink, XCircle } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/ReadonlyPropertyPanel.tsx b/packages/app/src/components/ReadonlyPropertyPanel.tsx
index 54dad5982..cca2ca4f3 100644
--- a/packages/app/src/components/ReadonlyPropertyPanel.tsx
+++ b/packages/app/src/components/ReadonlyPropertyPanel.tsx
@@ -1,9 +1,5 @@
-import {
- type FrontmatterValue,
- inferType,
- readFmKeys,
- readFmRegionWithError,
-} from '@inkeep/open-knowledge-core';
+import { readFmKeys, readFmRegionWithError } from '@inkeep/open-knowledge-core/bridge';
+import { type FrontmatterValue, inferType } from '@inkeep/open-knowledge-core/frontmatter/schema';
import { Trans } from '@lingui/react/macro';
import { PropertyDisclosure } from '@/components/PropertyDisclosure';
import { PropertyDisplayRow } from '@/components/PropertyDisplayRow';
diff --git a/packages/app/src/components/RecentProjectsMenu.tsx b/packages/app/src/components/RecentProjectsMenu.tsx
index ab8a19074..36e0e72e7 100644
--- a/packages/app/src/components/RecentProjectsMenu.tsx
+++ b/packages/app/src/components/RecentProjectsMenu.tsx
@@ -1,10 +1,10 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import type { WorktreeInventoryModel } from '@inkeep/open-knowledge-core/git/worktree-inventory-model';
import type {
- WorktreeInventoryModel,
WorktreeSelectorEntry,
WorktreeSelectorModel,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/git/worktree-selector-model';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { Check, GitBranch, Plus, Search } from 'lucide-react';
import type * as React from 'react';
diff --git a/packages/app/src/components/ReportBugDialog.tsx b/packages/app/src/components/ReportBugDialog.tsx
index cc65db07e..31764859e 100644
--- a/packages/app/src/components/ReportBugDialog.tsx
+++ b/packages/app/src/components/ReportBugDialog.tsx
@@ -1,4 +1,4 @@
-import type { OkBugReportScreenshot } from '@inkeep/open-knowledge-core';
+import type { OkBugReportScreenshot } from '@inkeep/open-knowledge-core/logger-types';
import { lazy, Suspense, useEffect, useRef, useState } from 'react';
import { getLastPointerPosition } from '@/lib/pointer-position';
import type { ReportBugDialogProps } from './ReportBugDialogBody';
diff --git a/packages/app/src/components/ReportBugDialogBody.tsx b/packages/app/src/components/ReportBugDialogBody.tsx
index 5d65b0a4b..50ba63a1d 100644
--- a/packages/app/src/components/ReportBugDialogBody.tsx
+++ b/packages/app/src/components/ReportBugDialogBody.tsx
@@ -2,14 +2,14 @@ import type {
OkBugReportCrashDetectedEvent,
OkBugReportScreenshot,
ReportBundleSummary,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/logger-types';
import {
BUG_REPORT_SCREENSHOT_ZIP_ENTRY,
- formatRelativeAge,
isBugReportAgentChatEntry,
isBugReportAttachmentEntry,
isBugReportCrashDumpEntry,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/logger-types';
+import { formatRelativeAge } from '@inkeep/open-knowledge-core/utils/relative-time';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import {
AlertCircleIcon,
diff --git a/packages/app/src/components/SeedDialog.tsx b/packages/app/src/components/SeedDialog.tsx
index 6be191a79..b85ea8ca3 100644
--- a/packages/app/src/components/SeedDialog.tsx
+++ b/packages/app/src/components/SeedDialog.tsx
@@ -1,4 +1,4 @@
-import { planHasOutstandingWork } from '@inkeep/open-knowledge-core';
+import { planHasOutstandingWork } from '@inkeep/open-knowledge-core/seed-plan-work';
import { plural } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowLeft } from 'lucide-react';
diff --git a/packages/app/src/components/SessionsHost.tsx b/packages/app/src/components/SessionsHost.tsx
index 150389081..cf4a1be06 100644
--- a/packages/app/src/components/SessionsHost.tsx
+++ b/packages/app/src/components/SessionsHost.tsx
@@ -1,11 +1,8 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import {
- TERMINAL_CLIS,
- type TerminalCli,
- type TerminalPlacement,
-} from '@inkeep/open-knowledge-core';
import type { AttachmentPart, ThreadInfo } from '@inkeep/open-knowledge-core/acp/thread-protocol';
+import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core/handoff';
+import type { TerminalPlacement } from '@inkeep/open-knowledge-core/terminal-layout';
import { useLingui } from '@lingui/react/macro';
import { SquareTerminalIcon } from 'lucide-react';
import {
diff --git a/packages/app/src/components/ShareBranchSwitchDialog.tsx b/packages/app/src/components/ShareBranchSwitchDialog.tsx
index a5d2f0685..5f43ec900 100644
--- a/packages/app/src/components/ShareBranchSwitchDialog.tsx
+++ b/packages/app/src/components/ShareBranchSwitchDialog.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import type { WorktreeCreateResult } from '@inkeep/open-knowledge-core';
+import type { WorktreeCreateResult } from '@inkeep/open-knowledge-core/git/worktree-selector-model';
import { i18n } from '@lingui/core';
import { plural } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
diff --git a/packages/app/src/components/ShareButton.tsx b/packages/app/src/components/ShareButton.tsx
index 8e39295a0..b8cb4e96a 100644
--- a/packages/app/src/components/ShareButton.tsx
+++ b/packages/app/src/components/ShareButton.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import type { ShareFreshness } from '@inkeep/open-knowledge-core';
+import type { ShareFreshness } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { CircleHelp, Share2 } from 'lucide-react';
import { type Ref, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/ShareFreshnessWarning.tsx b/packages/app/src/components/ShareFreshnessWarning.tsx
index 481297a77..954845783 100644
--- a/packages/app/src/components/ShareFreshnessWarning.tsx
+++ b/packages/app/src/components/ShareFreshnessWarning.tsx
@@ -1,4 +1,4 @@
-import type { ShareFreshness } from '@inkeep/open-knowledge-core';
+import type { ShareFreshness } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, Check, Info, RefreshCw, TriangleAlert } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/ShareReceiveDialog.tsx b/packages/app/src/components/ShareReceiveDialog.tsx
index a08f907de..09e914025 100644
--- a/packages/app/src/components/ShareReceiveDialog.tsx
+++ b/packages/app/src/components/ShareReceiveDialog.tsx
@@ -2,7 +2,7 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { classifyBranchMatch } from '@inkeep/open-knowledge-core';
+import { classifyBranchMatch } from '@inkeep/open-knowledge-core/sharing';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/SidebarSearchBar.tsx b/packages/app/src/components/SidebarSearchBar.tsx
index 714df5ba0..58b06c638 100644
--- a/packages/app/src/components/SidebarSearchBar.tsx
+++ b/packages/app/src/components/SidebarSearchBar.tsx
@@ -1,4 +1,4 @@
-import { incrementJsxRenderFailure } from '@inkeep/open-knowledge-core';
+import { incrementJsxRenderFailure } from '@inkeep/open-knowledge-core/metrics/parse-health';
import { useLingui } from '@lingui/react/macro';
import { Search } from 'lucide-react';
import type { ErrorInfo } from 'react';
diff --git a/packages/app/src/components/SkillBulkDeleteDialog.tsx b/packages/app/src/components/SkillBulkDeleteDialog.tsx
index 8a3d305d0..4c4d757d8 100644
--- a/packages/app/src/components/SkillBulkDeleteDialog.tsx
+++ b/packages/app/src/components/SkillBulkDeleteDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/SkillBundlePreview.tsx b/packages/app/src/components/SkillBundlePreview.tsx
index 94dff9168..15d6c5660 100644
--- a/packages/app/src/components/SkillBundlePreview.tsx
+++ b/packages/app/src/components/SkillBundlePreview.tsx
@@ -1,12 +1,12 @@
-import type { SkillPreview as SkillPreviewData, SkillScope } from '@inkeep/open-knowledge-core';
+import { skillFileLiveDocName, skillLiveDocName } from '@inkeep/open-knowledge-core/constants/cc1';
import {
- estimateSkillCost,
- extractFrontmatterTags,
- skillFileLiveDocName,
- skillLiveDocName,
stripFrontmatter,
unwrapFrontmatterFences,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/extensions/frontmatter';
+import { extractFrontmatterTags } from '@inkeep/open-knowledge-core/frontmatter/tags';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillPreview as SkillPreviewData } from '@inkeep/open-knowledge-core/skills-catalog/schema';
+import { estimateSkillCost } from '@inkeep/open-knowledge-core/skills-catalog/skill-cost';
import { Trans, useLingui } from '@lingui/react/macro';
import { AlignLeft, Eye, Gauge, Tag, Type } from 'lucide-react';
import { type ReactNode, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/SkillCostValue.tsx b/packages/app/src/components/SkillCostValue.tsx
index 35de60d46..3addca42b 100644
--- a/packages/app/src/components/SkillCostValue.tsx
+++ b/packages/app/src/components/SkillCostValue.tsx
@@ -2,7 +2,7 @@ import {
ALWAYS_ON_TOKEN_BUDGET,
ON_TRIGGER_TOKEN_BUDGET,
type SkillCostTiers,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/skills-catalog/skill-cost';
import { Trans, useLingui } from '@lingui/react/macro';
import { AlertTriangle } from 'lucide-react';
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '@/components/ui/tooltip';
diff --git a/packages/app/src/components/SkillDeleteDialog.tsx b/packages/app/src/components/SkillDeleteDialog.tsx
index ec70b8150..0f41394a9 100644
--- a/packages/app/src/components/SkillDeleteDialog.tsx
+++ b/packages/app/src/components/SkillDeleteDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/SkillDirectoryGrid.tsx b/packages/app/src/components/SkillDirectoryGrid.tsx
index e18140ea0..d08624bec 100644
--- a/packages/app/src/components/SkillDirectoryGrid.tsx
+++ b/packages/app/src/components/SkillDirectoryGrid.tsx
@@ -1,4 +1,5 @@
-import type { SkillScope, SkillSearchResult } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillSearchResult } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import type { ReactNode } from 'react';
import { SkillDirectoryResult } from '@/components/SkillDirectoryResult';
import { Skeleton } from '@/components/ui/skeleton';
diff --git a/packages/app/src/components/SkillDirectoryResult.tsx b/packages/app/src/components/SkillDirectoryResult.tsx
index 93c882492..9759e89ad 100644
--- a/packages/app/src/components/SkillDirectoryResult.tsx
+++ b/packages/app/src/components/SkillDirectoryResult.tsx
@@ -1,8 +1,6 @@
-import type {
- SkillCostTiers,
- SkillSearchResult,
- SkillsListEntry,
-} from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillSearchResult } from '@inkeep/open-knowledge-core/skills-catalog/schema';
+import type { SkillCostTiers } from '@inkeep/open-knowledge-core/skills-catalog/skill-cost';
import { Trans, useLingui } from '@lingui/react/macro';
import { Check, Package } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/SkillEditorActions.tsx b/packages/app/src/components/SkillEditorActions.tsx
index 2614e5bb5..45f47401f 100644
--- a/packages/app/src/components/SkillEditorActions.tsx
+++ b/packages/app/src/components/SkillEditorActions.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope, SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillScope, SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ChevronDown, FilePlus } from 'lucide-react';
import { useState } from 'react';
diff --git a/packages/app/src/components/SkillFileCreateDialog.tsx b/packages/app/src/components/SkillFileCreateDialog.tsx
index b1deee4bd..e052f7e83 100644
--- a/packages/app/src/components/SkillFileCreateDialog.tsx
+++ b/packages/app/src/components/SkillFileCreateDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useId, useState } from 'react';
diff --git a/packages/app/src/components/SkillFileDeleteDialog.tsx b/packages/app/src/components/SkillFileDeleteDialog.tsx
index 2b91a4b54..18b0e284e 100644
--- a/packages/app/src/components/SkillFileDeleteDialog.tsx
+++ b/packages/app/src/components/SkillFileDeleteDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/SkillFileRenameDialog.tsx b/packages/app/src/components/SkillFileRenameDialog.tsx
index 3affcae59..e11e76774 100644
--- a/packages/app/src/components/SkillFileRenameDialog.tsx
+++ b/packages/app/src/components/SkillFileRenameDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useId, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/SkillFileViewer.tsx b/packages/app/src/components/SkillFileViewer.tsx
index dd79c2d47..7fb9e5ee3 100644
--- a/packages/app/src/components/SkillFileViewer.tsx
+++ b/packages/app/src/components/SkillFileViewer.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { Eye } from 'lucide-react';
import { useRef } from 'react';
diff --git a/packages/app/src/components/SkillForkDialog.tsx b/packages/app/src/components/SkillForkDialog.tsx
index 4a2515a11..8917f5380 100644
--- a/packages/app/src/components/SkillForkDialog.tsx
+++ b/packages/app/src/components/SkillForkDialog.tsx
@@ -1,4 +1,4 @@
-import { SKILL_NAME_REGEX, type SkillsListEntry } from '@inkeep/open-knowledge-core';
+import { SKILL_NAME_REGEX, type SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { MultiFileDiff } from '@pierre/diffs/react';
import { useEffect, useId, useState } from 'react';
diff --git a/packages/app/src/components/SkillInstallMenu.tsx b/packages/app/src/components/SkillInstallMenu.tsx
index 7f6c23f5c..818d39548 100644
--- a/packages/app/src/components/SkillInstallMenu.tsx
+++ b/packages/app/src/components/SkillInstallMenu.tsx
@@ -1,9 +1,8 @@
-import type { SkillInstallTarget, SkillsListEntry } from '@inkeep/open-knowledge-core';
-import {
- AGENTS_SKILLS_ROOT,
- EDITOR_LABELS,
- isSkillInstallTarget,
-} from '@inkeep/open-knowledge-core';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
+import { AGENTS_SKILLS_ROOT } from '@inkeep/open-knowledge-core/constants/skills';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillInstallTarget } from '@inkeep/open-knowledge-core/skill-targets/schema';
+import { isSkillInstallTarget } from '@inkeep/open-knowledge-core/skill-targets/schema';
import { Trans, useLingui } from '@lingui/react/macro';
import { Folder, Settings as SettingsIcon } from 'lucide-react';
import { type ReactElement, useEffect, useRef, useState, useSyncExternalStore } from 'react';
diff --git a/packages/app/src/components/SkillLevelSelect.tsx b/packages/app/src/components/SkillLevelSelect.tsx
index b0fc19b08..375be9da8 100644
--- a/packages/app/src/components/SkillLevelSelect.tsx
+++ b/packages/app/src/components/SkillLevelSelect.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import {
Select,
diff --git a/packages/app/src/components/SkillMarkdownLoader.tsx b/packages/app/src/components/SkillMarkdownLoader.tsx
index ded3437d3..132c2a64b 100644
--- a/packages/app/src/components/SkillMarkdownLoader.tsx
+++ b/packages/app/src/components/SkillMarkdownLoader.tsx
@@ -1,8 +1,5 @@
-import {
- type SkillScope,
- skillFileLiveDocName,
- skillLiveDocName,
-} from '@inkeep/open-knowledge-core';
+import { skillFileLiveDocName, skillLiveDocName } from '@inkeep/open-knowledge-core/constants/cc1';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { SkillMarkdownViewer } from '@/components/SkillMarkdownViewer';
import { ViewerErrorPane, ViewerLoadingPane } from '@/components/ViewerStatusPane';
import { loadSkillFileText } from '@/lib/skills-api';
diff --git a/packages/app/src/components/SkillMarkdownViewer.tsx b/packages/app/src/components/SkillMarkdownViewer.tsx
index be1dfcb27..9200ecae2 100644
--- a/packages/app/src/components/SkillMarkdownViewer.tsx
+++ b/packages/app/src/components/SkillMarkdownViewer.tsx
@@ -1,4 +1,4 @@
-import { stripFrontmatter } from '@inkeep/open-knowledge-core';
+import { stripFrontmatter } from '@inkeep/open-knowledge-core/extensions/frontmatter';
import { EditorContent, useEditor } from '@tiptap/react';
import { useLayoutEffect, useRef, useState } from 'react';
import { createPortal } from 'react-dom';
diff --git a/packages/app/src/components/SkillOriginInline.tsx b/packages/app/src/components/SkillOriginInline.tsx
index 46f2731d4..99c109736 100644
--- a/packages/app/src/components/SkillOriginInline.tsx
+++ b/packages/app/src/components/SkillOriginInline.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, RefreshCw, Undo2 } from 'lucide-react';
import { lazy, Suspense, useState } from 'react';
diff --git a/packages/app/src/components/SkillPluginBundleBanner.tsx b/packages/app/src/components/SkillPluginBundleBanner.tsx
index 836729dc8..01d32a4b6 100644
--- a/packages/app/src/components/SkillPluginBundleBanner.tsx
+++ b/packages/app/src/components/SkillPluginBundleBanner.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRightIcon, PackageIcon } from 'lucide-react';
import { useState } from 'react';
diff --git a/packages/app/src/components/SkillPluginBundleDialog.tsx b/packages/app/src/components/SkillPluginBundleDialog.tsx
index c03300762..749174078 100644
--- a/packages/app/src/components/SkillPluginBundleDialog.tsx
+++ b/packages/app/src/components/SkillPluginBundleDialog.tsx
@@ -1,9 +1,7 @@
-import {
- EDITOR_LABELS,
- type PluginBundleMetadata,
- type SkillScope,
- type SkillTargetEditor,
-} from '@inkeep/open-knowledge-core';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillTargetEditor } from '@inkeep/open-knowledge-core/skill-targets/schema';
+import type { PluginBundleMetadata } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useId, useState } from 'react';
diff --git a/packages/app/src/components/SkillPreviewTab.tsx b/packages/app/src/components/SkillPreviewTab.tsx
index 3ed1df01a..5ac8f02d1 100644
--- a/packages/app/src/components/SkillPreviewTab.tsx
+++ b/packages/app/src/components/SkillPreviewTab.tsx
@@ -1,10 +1,10 @@
-import {
- type PluginBundleMetadata,
- type PluginSourceMetadata,
- type SkillDetail,
- type SkillScope,
- skillsShSkillLinks,
-} from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import type {
+ PluginBundleMetadata,
+ PluginSourceMetadata,
+ SkillDetail,
+} from '@inkeep/open-knowledge-core/skills-catalog/schema';
+import { skillsShSkillLinks } from '@inkeep/open-knowledge-core/skills-catalog/source-fields';
import { Trans } from '@lingui/react/macro';
import { ArrowUpRightIcon, ChevronDown } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/SkillProperties.tsx b/packages/app/src/components/SkillProperties.tsx
index e7b0d6d70..86cbde93b 100644
--- a/packages/app/src/components/SkillProperties.tsx
+++ b/packages/app/src/components/SkillProperties.tsx
@@ -1,5 +1,5 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import { SKILL_NAME_REGEX, type SkillScope } from '@inkeep/open-knowledge-core';
+import { SKILL_NAME_REGEX, type SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { Gauge, Type } from 'lucide-react';
import { useEffect, useId, useState } from 'react';
diff --git a/packages/app/src/components/SkillRenameDialog.tsx b/packages/app/src/components/SkillRenameDialog.tsx
index 7b1ff3c0e..ef841e5e7 100644
--- a/packages/app/src/components/SkillRenameDialog.tsx
+++ b/packages/app/src/components/SkillRenameDialog.tsx
@@ -1,4 +1,4 @@
-import { SKILL_NAME_REGEX, type SkillsListEntry } from '@inkeep/open-knowledge-core';
+import { SKILL_NAME_REGEX, type SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans } from '@lingui/react/macro';
import { useEffect, useId, useState } from 'react';
import { useRenameSkill } from '@/components/ManagedArtifactProperties';
diff --git a/packages/app/src/components/SkillScopeMoveDialog.tsx b/packages/app/src/components/SkillScopeMoveDialog.tsx
index cfadbc21c..36e70d81c 100644
--- a/packages/app/src/components/SkillScopeMoveDialog.tsx
+++ b/packages/app/src/components/SkillScopeMoveDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans } from '@lingui/react/macro';
import { useState } from 'react';
import { Button } from '@/components/ui/button';
diff --git a/packages/app/src/components/SkillScopeSegment.tsx b/packages/app/src/components/SkillScopeSegment.tsx
index edabdb230..ebb78a40d 100644
--- a/packages/app/src/components/SkillScopeSegment.tsx
+++ b/packages/app/src/components/SkillScopeSegment.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans } from '@lingui/react/macro';
import { useId } from 'react';
import {
diff --git a/packages/app/src/components/SkillToolbarControls.tsx b/packages/app/src/components/SkillToolbarControls.tsx
index a7b65d9eb..4aeeae06b 100644
--- a/packages/app/src/components/SkillToolbarControls.tsx
+++ b/packages/app/src/components/SkillToolbarControls.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ListPlus, MoreVertical } from 'lucide-react';
import { AddPropertiesButton } from '@/components/AddPropertiesButton';
diff --git a/packages/app/src/components/SkillsSidebarSection.tsx b/packages/app/src/components/SkillsSidebarSection.tsx
index 0d890f055..f02387366 100644
--- a/packages/app/src/components/SkillsSidebarSection.tsx
+++ b/packages/app/src/components/SkillsSidebarSection.tsx
@@ -1,12 +1,9 @@
-import {
- type CatalogSkill,
- type ConfigBinding,
- catalogRawScopeToOkScope,
- externalSkillLiveDocName,
- humanFormat,
- type SkillScope,
- type SkillsListEntry,
-} from '@inkeep/open-knowledge-core';
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
+import { externalSkillLiveDocName } from '@inkeep/open-knowledge-core/constants/cc1';
+import type { SkillScope, SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
+import type { CatalogSkill } from '@inkeep/open-knowledge-core/skills-catalog/schema';
+import { catalogRawScopeToOkScope } from '@inkeep/open-knowledge-core/skills-catalog/scope';
import { Trans, useLingui } from '@lingui/react/macro';
import { lazy, Suspense, useEffect, useLayoutEffect, useRef, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/SkillsTree.tsx b/packages/app/src/components/SkillsTree.tsx
index 98fdfc8ed..f3219b26c 100644
--- a/packages/app/src/components/SkillsTree.tsx
+++ b/packages/app/src/components/SkillsTree.tsx
@@ -1,9 +1,9 @@
import type {
- CatalogSkill,
SkillMoveFailureOutcome,
SkillScope,
SkillsListEntry,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
+import type { CatalogSkill } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { Trans, useLingui } from '@lingui/react/macro';
import { FILE_TREE_TAG_NAME, type FileTreeSortComparator } from '@pierre/trees';
import { useFileTree } from '@pierre/trees/react';
diff --git a/packages/app/src/components/SyncStatusBadge.tsx b/packages/app/src/components/SyncStatusBadge.tsx
index c44e2727d..6cfc6f0a5 100644
--- a/packages/app/src/components/SyncStatusBadge.tsx
+++ b/packages/app/src/components/SyncStatusBadge.tsx
@@ -1,14 +1,14 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import {
- type GitStatusCode,
- type GitWorktreeEntry,
- type GitWorktreeOpenTarget,
- isSyncMode,
- type PushPermissionWire,
- type SyncErrorCode,
- type SyncPausedReason,
-} from '@inkeep/open-knowledge-core';
+import { isSyncMode } from '@inkeep/open-knowledge-core/config/auto-sync-mode';
+import type {
+ GitStatusCode,
+ GitWorktreeEntry,
+ GitWorktreeOpenTarget,
+ PushPermissionWire,
+ SyncErrorCode,
+} from '@inkeep/open-knowledge-core/schemas/api';
+import type { SyncPausedReason } from '@inkeep/open-knowledge-core/sync-paused-reason';
import type { MessageDescriptor } from '@lingui/core';
import { msg, plural, t } from '@lingui/core/macro';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
diff --git a/packages/app/src/components/TemplateForm.tsx b/packages/app/src/components/TemplateForm.tsx
index 7319052f2..991c563ad 100644
--- a/packages/app/src/components/TemplateForm.tsx
+++ b/packages/app/src/components/TemplateForm.tsx
@@ -1,4 +1,7 @@
-import { stripFrontmatter, unwrapFrontmatterFences } from '@inkeep/open-knowledge-core';
+import {
+ stripFrontmatter,
+ unwrapFrontmatterFences,
+} from '@inkeep/open-knowledge-core/extensions/frontmatter';
import { t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { X } from 'lucide-react';
diff --git a/packages/app/src/components/TemplateProperties.tsx b/packages/app/src/components/TemplateProperties.tsx
index 614d5186c..42d70b7a4 100644
--- a/packages/app/src/components/TemplateProperties.tsx
+++ b/packages/app/src/components/TemplateProperties.tsx
@@ -1,5 +1,5 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import { TEMPLATE_NAME_REGEX } from '@inkeep/open-knowledge-core';
+import { TEMPLATE_NAME_REGEX } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { FolderGit2, Type } from 'lucide-react';
import { useEffect, useId, useState } from 'react';
diff --git a/packages/app/src/components/TemplatesCard.tsx b/packages/app/src/components/TemplatesCard.tsx
index 2526adc0e..193a47467 100644
--- a/packages/app/src/components/TemplatesCard.tsx
+++ b/packages/app/src/components/TemplatesCard.tsx
@@ -1,4 +1,4 @@
-import { templateContentDocName } from '@inkeep/open-knowledge-core';
+import { templateContentDocName } from '@inkeep/open-knowledge-core/constants/cc1';
import { Trans } from '@lingui/react/macro';
import { Plus } from 'lucide-react';
import { useState } from 'react';
diff --git a/packages/app/src/components/TerminalAgentConnectionBanner.tsx b/packages/app/src/components/TerminalAgentConnectionBanner.tsx
index 80e0b8e4a..4550bc5eb 100644
--- a/packages/app/src/components/TerminalAgentConnectionBanner.tsx
+++ b/packages/app/src/components/TerminalAgentConnectionBanner.tsx
@@ -2,9 +2,8 @@ import {
agentIdForTerminalCli,
getAgentRecord,
type HostSnapshot,
- TERMINAL_CLIS,
- type TerminalCli,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/agent-registry';
+import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { useLingui } from '@lingui/react/macro';
import { TriangleAlert } from 'lucide-react';
import { useEffect, useEffectEvent, useRef, useState } from 'react';
diff --git a/packages/app/src/components/TerminalCliMissingBanner.tsx b/packages/app/src/components/TerminalCliMissingBanner.tsx
index fb28db038..7b4d99b93 100644
--- a/packages/app/src/components/TerminalCliMissingBanner.tsx
+++ b/packages/app/src/components/TerminalCliMissingBanner.tsx
@@ -1,4 +1,4 @@
-import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core';
+import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { useLingui } from '@lingui/react/macro';
import { Button } from '@/components/ui/button';
import type { OkDesktopBridge } from '@/lib/desktop-bridge-types';
diff --git a/packages/app/src/components/TerminalCliUnverifiedBanner.tsx b/packages/app/src/components/TerminalCliUnverifiedBanner.tsx
index 2ad446633..da058a601 100644
--- a/packages/app/src/components/TerminalCliUnverifiedBanner.tsx
+++ b/packages/app/src/components/TerminalCliUnverifiedBanner.tsx
@@ -1,4 +1,4 @@
-import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core';
+import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { useLingui } from '@lingui/react/macro';
import { TerminalNoticeBanner } from './TerminalNoticeBanner';
diff --git a/packages/app/src/components/TerminalDock.tsx b/packages/app/src/components/TerminalDock.tsx
index 13625966a..17ffca92a 100644
--- a/packages/app/src/components/TerminalDock.tsx
+++ b/packages/app/src/components/TerminalDock.tsx
@@ -1,4 +1,4 @@
-import type { TerminalPlacement } from '@inkeep/open-knowledge-core';
+import type { TerminalPlacement } from '@inkeep/open-knowledge-core/terminal-layout';
import { useTheme } from 'next-themes';
import { type ReactNode, useEffect, useRef, useState } from 'react';
import { usePanelRef } from 'react-resizable-panels';
diff --git a/packages/app/src/components/TerminalNewChatButton.tsx b/packages/app/src/components/TerminalNewChatButton.tsx
index d0e45002d..3e784f923 100644
--- a/packages/app/src/components/TerminalNewChatButton.tsx
+++ b/packages/app/src/components/TerminalNewChatButton.tsx
@@ -1,4 +1,4 @@
-import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core';
+import { TERMINAL_CLIS, type TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { Trans, useLingui } from '@lingui/react/macro';
import {
Bot,
diff --git a/packages/app/src/components/TerminalPanel.tsx b/packages/app/src/components/TerminalPanel.tsx
index e003ce150..a5bd157c5 100644
--- a/packages/app/src/components/TerminalPanel.tsx
+++ b/packages/app/src/components/TerminalPanel.tsx
@@ -1,5 +1,9 @@
import '@xterm/xterm/css/xterm.css';
+import {
+ assertNeverPtyAdoptReason,
+ assertNeverPtyCreateReason,
+} from '@inkeep/open-knowledge-core/desktop-bridge';
import {
buildCliLaunchArgString,
buildStartupInjectionBytes,
@@ -10,11 +14,7 @@ import {
type TerminalCli,
type TerminalLaunchCommand,
type WindowsShellFamily,
-} from '@inkeep/open-knowledge-core';
-import {
- assertNeverPtyAdoptReason,
- assertNeverPtyCreateReason,
-} from '@inkeep/open-knowledge-core/desktop-bridge';
+} from '@inkeep/open-knowledge-core/handoff';
import { useLingui } from '@lingui/react/macro';
import { FitAddon } from '@xterm/addon-fit';
import { Unicode11Addon } from '@xterm/addon-unicode11';
diff --git a/packages/app/src/components/TextDocEditor.tsx b/packages/app/src/components/TextDocEditor.tsx
index f13913137..4d5d7d006 100644
--- a/packages/app/src/components/TextDocEditor.tsx
+++ b/packages/app/src/components/TextDocEditor.tsx
@@ -10,8 +10,8 @@ import type { HocuspocusProvider } from '@hocuspocus/provider';
import {
codeLanguageForExtension,
EDITABLE_TEXT_EXTRA_LANGUAGE,
- extensionOf,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/code-languages';
+import { extensionOf } from '@inkeep/open-knowledge-core/utils/extension';
import { useLingui } from '@lingui/react/macro';
import { basicSetup } from 'codemirror';
import { useTheme } from 'next-themes';
diff --git a/packages/app/src/components/TextViewer.tsx b/packages/app/src/components/TextViewer.tsx
index 1315b39a9..41a6f3860 100644
--- a/packages/app/src/components/TextViewer.tsx
+++ b/packages/app/src/components/TextViewer.tsx
@@ -1,6 +1,6 @@
import { EditorState } from '@codemirror/state';
import { EditorView } from '@codemirror/view';
-import { codeLanguageForExtension } from '@inkeep/open-knowledge-core';
+import { codeLanguageForExtension } from '@inkeep/open-knowledge-core/constants/code-languages';
import { basicSetup } from 'codemirror';
import { useTheme } from 'next-themes';
import { useEffect, useRef } from 'react';
diff --git a/packages/app/src/components/TimelineDiffPane.tsx b/packages/app/src/components/TimelineDiffPane.tsx
index 0cf238656..8b67ec44d 100644
--- a/packages/app/src/components/TimelineDiffPane.tsx
+++ b/packages/app/src/components/TimelineDiffPane.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core';
+import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ChevronDown, ChevronUp, PanelRightClose, PanelRightOpen, Undo2, X } from 'lucide-react';
import { lazy, Suspense, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/TimelinePanel.tsx b/packages/app/src/components/TimelinePanel.tsx
index 5b3f2d3a6..bf3a2532c 100644
--- a/packages/app/src/components/TimelinePanel.tsx
+++ b/packages/app/src/components/TimelinePanel.tsx
@@ -1,16 +1,16 @@
// oxlint-disable ok/no-raw-html-interactive-element -- pre-rule backlog — file uses raw <button>/<input>/<textarea> awaiting shadcn migration; tracked at https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-raw-html-interactive-element
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import { isSurfacedCheckpointKind } from '@inkeep/open-knowledge-core/checkpoint-kinds';
+import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core/schemas/api';
+import type { TimelineEntry } from '@inkeep/open-knowledge-core/types/timeline';
import {
AGENT_ICON_COLORS,
AGENT_ICON_COLORS_DARK,
colorFromSeed,
iconFromClientName,
- isSurfacedCheckpointKind,
- ProblemDetailsSchema,
SYSTEM_WRITER_DISPLAY_NAMES,
- type TimelineEntry,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/identity';
import { plural, t } from '@lingui/core/macro';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import {
diff --git a/packages/app/src/components/UpdateNotices.shared.ts b/packages/app/src/components/UpdateNotices.shared.ts
index dc208cac5..f4c2482ae 100644
--- a/packages/app/src/components/UpdateNotices.shared.ts
+++ b/packages/app/src/components/UpdateNotices.shared.ts
@@ -1,4 +1,4 @@
-import { MANUAL_CHECK_NOTICE_EXPIRY_MS } from '@inkeep/open-knowledge-core';
+import { MANUAL_CHECK_NOTICE_EXPIRY_MS } from '@inkeep/open-knowledge-core/constants/manual-update-check';
import { t } from '@lingui/core/macro';
import type { OkDesktopBridge } from '@/lib/desktop-bridge-types';
diff --git a/packages/app/src/components/acp/GitHubReferenceCard.tsx b/packages/app/src/components/acp/GitHubReferenceCard.tsx
index 53c44b3a1..559708da4 100644
--- a/packages/app/src/components/acp/GitHubReferenceCard.tsx
+++ b/packages/app/src/components/acp/GitHubReferenceCard.tsx
@@ -1,4 +1,4 @@
-import type { GitHubReferencePreview } from '@inkeep/open-knowledge-core';
+import type { GitHubReferencePreview } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import {
CircleCheck,
diff --git a/packages/app/src/components/acp/doc-path-links.ts b/packages/app/src/components/acp/doc-path-links.ts
index f922f380f..ae79cc78b 100644
--- a/packages/app/src/components/acp/doc-path-links.ts
+++ b/packages/app/src/components/acp/doc-path-links.ts
@@ -1,4 +1,8 @@
-import { decodeHrefPath, isExternalHref, resolveInternalHref } from '@inkeep/open-knowledge-core';
+import { isExternalHref } from '@inkeep/open-knowledge-core/utils/link-targets';
+import {
+ decodeHrefPath,
+ resolveInternalHref,
+} from '@inkeep/open-knowledge-core/utils/resolve-internal-href';
import { docNameFromAbsolutePath } from '@/components/acp/follow-file';
import { hashFromDocName } from '@/lib/doc-hash';
import type { Workspace } from '@/lib/workspace-paths';
diff --git a/packages/app/src/components/acp/follow-file.ts b/packages/app/src/components/acp/follow-file.ts
index 29a8420b7..c0976abe3 100644
--- a/packages/app/src/components/acp/follow-file.ts
+++ b/packages/app/src/components/acp/follow-file.ts
@@ -1,5 +1,5 @@
-import { OPEN_KNOWLEDGE_MCP_WRITE_TOOLS } from '@inkeep/open-knowledge-core';
import { stringField, unwrapMcpInput } from '@inkeep/open-knowledge-core/acp/tool-call-input';
+import { OPEN_KNOWLEDGE_MCP_WRITE_TOOLS } from '@inkeep/open-knowledge-core/constants/mcp';
import type { RenderedToolCall } from '@/lib/acp/thread-event-model';
import type { Workspace } from '@/lib/workspace-paths';
diff --git a/packages/app/src/components/acp/github-reference.ts b/packages/app/src/components/acp/github-reference.ts
index 124f57316..beac28e1a 100644
--- a/packages/app/src/components/acp/github-reference.ts
+++ b/packages/app/src/components/acp/github-reference.ts
@@ -1,7 +1,7 @@
import {
type GitHubReferencePreview,
GitHubReferenceResponseSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useState } from 'react';
const REFERENCE_PATH =
diff --git a/packages/app/src/components/acp/presence-follow.ts b/packages/app/src/components/acp/presence-follow.ts
index 0a9f37e66..265d04522 100644
--- a/packages/app/src/components/acp/presence-follow.ts
+++ b/packages/app/src/components/acp/presence-follow.ts
@@ -1,4 +1,4 @@
-import { isPresenceSentinelDocName } from '@inkeep/open-knowledge-core';
+import { isPresenceSentinelDocName } from '@inkeep/open-knowledge-core/types/awareness';
import { AGENT_PRESENCE_STALE_MS, hasAgentPresenceShape } from '@/lib/agent-presence';
import { sanitizeDocName } from './follow-file';
diff --git a/packages/app/src/components/acp/reference-status.ts b/packages/app/src/components/acp/reference-status.ts
index f02c60ed1..12d8ccde7 100644
--- a/packages/app/src/components/acp/reference-status.ts
+++ b/packages/app/src/components/acp/reference-status.ts
@@ -1,4 +1,4 @@
-import type { GitHubReferencePreview } from '@inkeep/open-knowledge-core';
+import type { GitHubReferencePreview } from '@inkeep/open-knowledge-core/schemas/api';
export type ReferenceStatusTone = 'success' | 'attention' | 'severe' | 'danger';
diff --git a/packages/app/src/components/acp/thread-auth-offer.ts b/packages/app/src/components/acp/thread-auth-offer.ts
index 3397934c0..4b9082ab3 100644
--- a/packages/app/src/components/acp/thread-auth-offer.ts
+++ b/packages/app/src/components/acp/thread-auth-offer.ts
@@ -1,9 +1,9 @@
-import type { TerminalCli } from '@inkeep/open-knowledge-core';
import type {
ThreadAuthMethod,
ThreadInfo,
ThreadStatus,
} from '@inkeep/open-knowledge-core/acp/thread-protocol';
+import type { TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { t } from '@lingui/core/macro';
export type ThreadAuthActionKind = 'resume' | 'retry' | 'new-chat' | 'terminal-sign-in';
diff --git a/packages/app/src/components/auto-sync-onboarding-gate.ts b/packages/app/src/components/auto-sync-onboarding-gate.ts
index ae3ff1521..f84e772aa 100644
--- a/packages/app/src/components/auto-sync-onboarding-gate.ts
+++ b/packages/app/src/components/auto-sync-onboarding-gate.ts
@@ -2,7 +2,7 @@ import {
modeFromCommittedDefault,
resolveLocalAutoSyncMode,
type StoredSyncMode,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/config/auto-sync-mode';
export type AutoSyncOnboardingVariant = 'full' | 'follow';
diff --git a/packages/app/src/components/command-palette-commands.ts b/packages/app/src/components/command-palette-commands.ts
index b4855b825..92e733064 100644
--- a/packages/app/src/components/command-palette-commands.ts
+++ b/packages/app/src/components/command-palette-commands.ts
@@ -3,9 +3,9 @@ import {
type CommandContext,
type CommandIdentity,
evaluateCommandAvailability,
- OPEN_KNOWLEDGE_GITHUB_URL,
- SHOW_INSTALL_SKILL,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/commands/command-identity';
+import { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core/constants/feature-flags';
+import { OPEN_KNOWLEDGE_GITHUB_URL } from '@inkeep/open-knowledge-core/constants/menu-labels';
import type { MessageDescriptor } from '@lingui/core';
import { msg, t } from '@lingui/core/macro';
import {
diff --git a/packages/app/src/components/command-palette-search.ts b/packages/app/src/components/command-palette-search.ts
index 7f2f994c7..172a59a2f 100644
--- a/packages/app/src/components/command-palette-search.ts
+++ b/packages/app/src/components/command-palette-search.ts
@@ -1,13 +1,15 @@
import {
- createWorkspaceSearchCorpus,
- createWorkspaceSearchDocument,
type SearchSemanticStatus,
SearchSemanticStatusSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
+import {
+ createWorkspaceSearchCorpus,
+ createWorkspaceSearchDocument,
searchWorkspaceCorpus,
type WorkspaceSearchCorpus,
type WorkspaceSearchDocument,
workspaceSearchBasename,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/search/workspace-search';
import { parseApiError } from '@/lib/parse-api-error';
import type { PageMeta } from './PageListContext';
diff --git a/packages/app/src/components/empty-state/CreatePromptComposer.tsx b/packages/app/src/components/empty-state/CreatePromptComposer.tsx
index b95efa722..408a9e7b4 100644
--- a/packages/app/src/components/empty-state/CreatePromptComposer.tsx
+++ b/packages/app/src/components/empty-state/CreatePromptComposer.tsx
@@ -3,7 +3,7 @@ import {
type TargetData,
TERMINAL_CLIS,
type TerminalCli,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, Check, ChevronDown, SlidersHorizontal, Sparkles } from 'lucide-react';
import { useRef, useState } from 'react';
diff --git a/packages/app/src/components/empty-state/CreateView.tsx b/packages/app/src/components/empty-state/CreateView.tsx
index 31991b96e..1f78da00d 100644
--- a/packages/app/src/components/empty-state/CreateView.tsx
+++ b/packages/app/src/components/empty-state/CreateView.tsx
@@ -1,4 +1,4 @@
-import type { TemplatesListEntry } from '@inkeep/open-knowledge-core';
+import type { TemplatesListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowRightIcon, Plus } from 'lucide-react';
import { CopyablePromptList } from '@/components/empty-state/CopyablePromptList';
diff --git a/packages/app/src/components/empty-state/use-create-suggestions.ts b/packages/app/src/components/empty-state/use-create-suggestions.ts
index 6d3d1aed4..c577d8542 100644
--- a/packages/app/src/components/empty-state/use-create-suggestions.ts
+++ b/packages/app/src/components/empty-state/use-create-suggestions.ts
@@ -1,4 +1,4 @@
-import type { CreateScenario } from '@inkeep/open-knowledge-core';
+import type { CreateScenario } from '@inkeep/open-knowledge-core/handoff';
import { useLingui } from '@lingui/react/macro';
import { Bird, FileCode2, ListTree, Network, Telescope } from 'lucide-react';
import type { ComponentType } from 'react';
diff --git a/packages/app/src/components/file-entry-icon.tsx b/packages/app/src/components/file-entry-icon.tsx
index 658697f94..552eed0e1 100644
--- a/packages/app/src/components/file-entry-icon.tsx
+++ b/packages/app/src/components/file-entry-icon.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { mediaKindForSidebarAssetExtension } from '@inkeep/open-knowledge-core';
+import { mediaKindForSidebarAssetExtension } from '@inkeep/open-knowledge-core/constants/upload';
import { File, Film, FolderOpen, ImageIcon, Volume2 } from 'lucide-react';
import type { ComponentProps } from 'react';
import { getFileExtension } from '@/components/file-tree-rename-validation';
diff --git a/packages/app/src/components/file-tree-adapter.ts b/packages/app/src/components/file-tree-adapter.ts
index 9bf157751..d1cf82980 100644
--- a/packages/app/src/components/file-tree-adapter.ts
+++ b/packages/app/src/components/file-tree-adapter.ts
@@ -1,10 +1,10 @@
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
import {
- isEditableTextDocFile,
isExcalidrawDocFile,
isMermaidDocFile,
mediaKindForSidebarAssetExtension,
- type UploadAssetSuccess,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/upload';
+import type { UploadAssetSuccess } from '@inkeep/open-knowledge-core/schemas/api';
import type { ContextMenuItem, FileTreeDropTarget } from '@pierre/trees';
import { getFileExtension } from '@/components/file-tree-rename-validation';
import {
diff --git a/packages/app/src/components/file-tree-listing-transport.ts b/packages/app/src/components/file-tree-listing-transport.ts
index a890ae896..b20a1dfce 100644
--- a/packages/app/src/components/file-tree-listing-transport.ts
+++ b/packages/app/src/components/file-tree-listing-transport.ts
@@ -1,4 +1,4 @@
-import { DocumentListSuccessSchema } from '@inkeep/open-knowledge-core';
+import { DocumentListSuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { parseServerResponse } from '@/lib/parse-server-response';
import {
consumeShowAllStream,
diff --git a/packages/app/src/components/file-tree-operations.ts b/packages/app/src/components/file-tree-operations.ts
index 7a526797e..7ac566b6b 100644
--- a/packages/app/src/components/file-tree-operations.ts
+++ b/packages/app/src/components/file-tree-operations.ts
@@ -1,9 +1,9 @@
+import { mediaKindForSidebarAssetExtension } from '@inkeep/open-knowledge-core/constants/upload';
import type {
DuplicatePathSuccess,
RenamedAssetMapping,
RenamedDocMapping,
-} from '@inkeep/open-knowledge-core';
-import { mediaKindForSidebarAssetExtension } from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import {
docNameToTreePath,
resolveExtensionlessAssetPath,
diff --git a/packages/app/src/components/file-tree-selection.ts b/packages/app/src/components/file-tree-selection.ts
index 398afd22f..9d283eab0 100644
--- a/packages/app/src/components/file-tree-selection.ts
+++ b/packages/app/src/components/file-tree-selection.ts
@@ -1,9 +1,9 @@
-import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
import {
isDocumentOverOpenByteLimit,
- isEditableTextDocFile,
TEXT_DOC_OPEN_BYTE_LIMIT,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/document-open';
+import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core/constants/upload';
import { assetTabId, docTabId } from '@/editor/editor-tabs';
import { hashFromAssetPath } from '@/lib/doc-hash';
import {
diff --git a/packages/app/src/components/file-tree-utils.ts b/packages/app/src/components/file-tree-utils.ts
index d2294d351..2b2b71930 100644
--- a/packages/app/src/components/file-tree-utils.ts
+++ b/packages/app/src/components/file-tree-utils.ts
@@ -1,10 +1,10 @@
+import { isManagedArtifactDocName } from '@inkeep/open-knowledge-core/constants/cc1';
+import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core/constants/upload';
+import type { DocumentListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import {
- type DocumentListEntry,
- type InlineAssetMediaKind,
isHiddenDocName,
- isManagedArtifactDocName,
isProjectSkillBundlePath,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/util/doc-name';
export interface DocumentEntry {
kind: 'document';
diff --git a/packages/app/src/components/frontmatter-error-utils.ts b/packages/app/src/components/frontmatter-error-utils.ts
index 2af0c6534..d35e3eefa 100644
--- a/packages/app/src/components/frontmatter-error-utils.ts
+++ b/packages/app/src/components/frontmatter-error-utils.ts
@@ -1,4 +1,7 @@
-import { type FrontmatterValidationError, fieldErrorsFromError } from '@inkeep/open-knowledge-core';
+import {
+ type FrontmatterValidationError,
+ fieldErrorsFromError,
+} from '@inkeep/open-knowledge-core/frontmatter/errors';
export function describeError(
error: FrontmatterValidationError,
diff --git a/packages/app/src/components/graph-skill-filter.ts b/packages/app/src/components/graph-skill-filter.ts
index cecdff157..9d5a424c4 100644
--- a/packages/app/src/components/graph-skill-filter.ts
+++ b/packages/app/src/components/graph-skill-filter.ts
@@ -1,4 +1,7 @@
-import { parseGlobalSkillBundleDoc, parseProjectSkillBundleDoc } from '@inkeep/open-knowledge-core';
+import {
+ parseGlobalSkillBundleDoc,
+ parseProjectSkillBundleDoc,
+} from '@inkeep/open-knowledge-core/constants/cc1';
import { type GraphData, getGraphLinkEndpointId } from './graph-view-utils';
export type GraphSkillVisibility = 'all' | 'hide-builtins' | 'none';
diff --git a/packages/app/src/components/handoff/AgentSplitButton.tsx b/packages/app/src/components/handoff/AgentSplitButton.tsx
index 31f4f4efd..06a1b4ca9 100644
--- a/packages/app/src/components/handoff/AgentSplitButton.tsx
+++ b/packages/app/src/components/handoff/AgentSplitButton.tsx
@@ -1,4 +1,4 @@
-import type { HandoffTarget, TargetData, TerminalCli } from '@inkeep/open-knowledge-core';
+import type { HandoffTarget, TargetData, TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, Check, ChevronDown, SlidersHorizontal } from 'lucide-react';
import type { ReactNode } from 'react';
diff --git a/packages/app/src/components/handoff/ExternalHandoffGate.tsx b/packages/app/src/components/handoff/ExternalHandoffGate.tsx
index a8e495944..e15a2b844 100644
--- a/packages/app/src/components/handoff/ExternalHandoffGate.tsx
+++ b/packages/app/src/components/handoff/ExternalHandoffGate.tsx
@@ -1,10 +1,9 @@
import {
type AgentId,
agentIdForHandoffTarget,
- type HandoffOutcome,
- type HandoffTarget,
KNOWN_HANDOFF_TARGETS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/agent-registry';
+import type { HandoffOutcome, HandoffTarget } from '@inkeep/open-knowledge-core/handoff';
import { useLingui } from '@lingui/react/macro';
import { createContext, type ReactNode, use, useEffect, useRef, useState } from 'react';
import {
diff --git a/packages/app/src/components/handoff/OpenInAgentContextSubmenu.tsx b/packages/app/src/components/handoff/OpenInAgentContextSubmenu.tsx
index 6b5e92153..c610e36cd 100644
--- a/packages/app/src/components/handoff/OpenInAgentContextSubmenu.tsx
+++ b/packages/app/src/components/handoff/OpenInAgentContextSubmenu.tsx
@@ -6,7 +6,7 @@ import {
type InstallState,
TERMINAL_CLI_IDS,
TERMINAL_CLIS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
import { t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, SlidersHorizontal, Sparkles } from 'lucide-react';
diff --git a/packages/app/src/components/handoff/OpenInAgentEmptySpaceSubmenu.tsx b/packages/app/src/components/handoff/OpenInAgentEmptySpaceSubmenu.tsx
index c45b5cc5b..523d741cd 100644
--- a/packages/app/src/components/handoff/OpenInAgentEmptySpaceSubmenu.tsx
+++ b/packages/app/src/components/handoff/OpenInAgentEmptySpaceSubmenu.tsx
@@ -6,7 +6,7 @@ import {
type InstallState,
TERMINAL_CLI_IDS,
TERMINAL_CLIS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
import { t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, SlidersHorizontal, Sparkles } from 'lucide-react';
diff --git a/packages/app/src/components/handoff/OpenInAgentMenuItem.tsx b/packages/app/src/components/handoff/OpenInAgentMenuItem.tsx
index 17d9722b6..808ac7fc7 100644
--- a/packages/app/src/components/handoff/OpenInAgentMenuItem.tsx
+++ b/packages/app/src/components/handoff/OpenInAgentMenuItem.tsx
@@ -1,11 +1,10 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import type { InstallState, TargetData } from '@inkeep/open-knowledge-core/handoff';
import {
AGENT_ICON_COLORS,
AGENT_ICON_COLORS_DARK,
- type InstallState,
- type TargetData,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/identity';
import { t } from '@lingui/core/macro';
import { useLingui } from '@lingui/react/macro';
import { useTheme } from 'next-themes';
diff --git a/packages/app/src/components/handoff/TerminalLaunchContext.tsx b/packages/app/src/components/handoff/TerminalLaunchContext.tsx
index 5673821af..19ac84810 100644
--- a/packages/app/src/components/handoff/TerminalLaunchContext.tsx
+++ b/packages/app/src/components/handoff/TerminalLaunchContext.tsx
@@ -1,4 +1,4 @@
-import type { TerminalCli } from '@inkeep/open-knowledge-core';
+import type { TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { createContext, type ReactNode, use } from 'react';
import type { HandoffDispatchInput } from './useHandoffDispatch';
diff --git a/packages/app/src/components/handoff/compose-lint-fix-prompt.ts b/packages/app/src/components/handoff/compose-lint-fix-prompt.ts
index b69c58562..40d2b49f2 100644
--- a/packages/app/src/components/handoff/compose-lint-fix-prompt.ts
+++ b/packages/app/src/components/handoff/compose-lint-fix-prompt.ts
@@ -1,9 +1,11 @@
import {
composeFixAllProblemsPrompt,
composeLintFixPrompt,
+} from '@inkeep/open-knowledge-core/handoff';
+import {
type LintDiagnostic,
MARKDOWNLINT_RULE_CATALOG,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { docNameToRelativePath } from '@/lib/workspace-paths';
const ALIAS_BY_CODE = new Map(MARKDOWNLINT_RULE_CATALOG.map((rule) => [rule.id, rule.alias]));
diff --git a/packages/app/src/components/handoff/compose-terminal-selection.ts b/packages/app/src/components/handoff/compose-terminal-selection.ts
index b47437a01..5e76cce4e 100644
--- a/packages/app/src/components/handoff/compose-terminal-selection.ts
+++ b/packages/app/src/components/handoff/compose-terminal-selection.ts
@@ -1,4 +1,4 @@
-import { composeSelectionPrompt } from '@inkeep/open-knowledge-core';
+import { composeSelectionPrompt } from '@inkeep/open-knowledge-core/handoff';
import { docNameToRelativePath } from '@/lib/workspace-paths';
export function composeTerminalSelectionPaste(docName: string, selectionMarkdown: string): string {
diff --git a/packages/app/src/components/handoff/terminal-cli-display.ts b/packages/app/src/components/handoff/terminal-cli-display.ts
index d4ba8de99..f1df1f338 100644
--- a/packages/app/src/components/handoff/terminal-cli-display.ts
+++ b/packages/app/src/components/handoff/terminal-cli-display.ts
@@ -3,7 +3,7 @@ import {
TERMINAL_CLI_IDS,
TERMINAL_CLIS,
type TerminalCli,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
export const VISIBLE_CLIS: readonly TerminalCli[] = TERMINAL_CLI_IDS;
diff --git a/packages/app/src/components/handoff/terminal-command-events.ts b/packages/app/src/components/handoff/terminal-command-events.ts
index ea0055585..e65761e77 100644
--- a/packages/app/src/components/handoff/terminal-command-events.ts
+++ b/packages/app/src/components/handoff/terminal-command-events.ts
@@ -1,4 +1,4 @@
-import { shellSingleQuote, type TerminalLaunchCommand } from '@inkeep/open-knowledge-core';
+import { shellSingleQuote, type TerminalLaunchCommand } from '@inkeep/open-knowledge-core/handoff';
export type TerminalCommandId = 'install-slidev' | 'git-status';
diff --git a/packages/app/src/components/handoff/terminal-launch-events.ts b/packages/app/src/components/handoff/terminal-launch-events.ts
index f0aee15ad..5c4f3a6fa 100644
--- a/packages/app/src/components/handoff/terminal-launch-events.ts
+++ b/packages/app/src/components/handoff/terminal-launch-events.ts
@@ -1,4 +1,4 @@
-import type { TerminalCli, TerminalLaunchCommand } from '@inkeep/open-knowledge-core';
+import type { TerminalCli, TerminalLaunchCommand } from '@inkeep/open-knowledge-core/handoff';
import { routeNoteWindowActionToMain } from '@/lib/note-window-main-actions';
const TERMINAL_LAUNCH_EVENT = 'open-knowledge:terminal-launch';
diff --git a/packages/app/src/components/handoff/useHandoffDispatch.ts b/packages/app/src/components/handoff/useHandoffDispatch.ts
index d647ada9e..ea683a664 100644
--- a/packages/app/src/components/handoff/useHandoffDispatch.ts
+++ b/packages/app/src/components/handoff/useHandoffDispatch.ts
@@ -1,3 +1,4 @@
+import type { AttachmentPart } from '@inkeep/open-knowledge-core/acp/thread-protocol';
import {
type AssembleHandoffPromptInput,
assembleHandoffPrompt,
@@ -21,13 +22,12 @@ import {
OK_TERMINAL_SURFACE_PREAMBLE,
OK_THREAD_SURFACE_PREAMBLE,
type PromptTransport,
- type SkillScope,
type TargetData,
TERMINAL_CLIS,
type TerminalCli,
withSkillPointer,
-} from '@inkeep/open-knowledge-core';
-import type { AttachmentPart } from '@inkeep/open-knowledge-core/acp/thread-protocol';
+} from '@inkeep/open-knowledge-core/handoff';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { toast as sonnerToast } from 'sonner';
import { useConfigContext } from '@/lib/config-context';
diff --git a/packages/app/src/components/handoff/useInstalledAgents.ts b/packages/app/src/components/handoff/useInstalledAgents.ts
index 2c757b7ac..74cf51511 100644
--- a/packages/app/src/components/handoff/useInstalledAgents.ts
+++ b/packages/app/src/components/handoff/useInstalledAgents.ts
@@ -1,4 +1,4 @@
-import type { HandoffTarget, InstallState } from '@inkeep/open-knowledge-core';
+import type { HandoffTarget, InstallState } from '@inkeep/open-knowledge-core/handoff';
import { useEffect, useRef, useState } from 'react';
import {
createProbeCoordinator,
diff --git a/packages/app/src/components/navigation-targets.ts b/packages/app/src/components/navigation-targets.ts
index 4cc2ce0d1..925a06e60 100644
--- a/packages/app/src/components/navigation-targets.ts
+++ b/packages/app/src/components/navigation-targets.ts
@@ -1,20 +1,24 @@
import {
- DOCUMENT_OPEN_BYTE_LIMIT,
- type InlineAssetMediaKind,
- isDocumentOverOpenByteLimit,
- isEditableTextDocFile,
- isExcalidrawDocFile,
isManagedArtifactDocName,
- isMermaidDocFile,
- mediaKindForSidebarAssetExtension,
parseLegacyTemplateDocName,
parseManagedArtifactName,
parseTemplateContentDocName,
projectSkillContentDocName,
- resolveWikiLinkTargetDocName,
- type SkillScope,
templateContentDocName,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
+import {
+ DOCUMENT_OPEN_BYTE_LIMIT,
+ isDocumentOverOpenByteLimit,
+} from '@inkeep/open-knowledge-core/constants/document-open';
+import {
+ type InlineAssetMediaKind,
+ isExcalidrawDocFile,
+ isMermaidDocFile,
+ mediaKindForSidebarAssetExtension,
+} from '@inkeep/open-knowledge-core/constants/upload';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import { resolveWikiLinkTargetDocName } from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
import type { SkillPreviewFlavor } from '@/lib/doc-hash';
import { normalizeDocNameInput } from '@/lib/doc-paths';
import { parseProjectSkillContentDocName } from '@/lib/managed-artifact-doc-name';
diff --git a/packages/app/src/components/page-header-utils.ts b/packages/app/src/components/page-header-utils.ts
index 8d73704ef..6cf7e62f4 100644
--- a/packages/app/src/components/page-header-utils.ts
+++ b/packages/app/src/components/page-header-utils.ts
@@ -1,9 +1,7 @@
-import {
- IMAGE_EXTENSIONS,
- isSafeUrl,
- parseWikiLink,
- toDesktopAssetHref,
-} from '@inkeep/open-knowledge-core';
+import { IMAGE_EXTENSIONS } from '@inkeep/open-knowledge-core/constants/upload';
+import { parseWikiLink } from '@inkeep/open-knowledge-core/extensions/wiki-link';
+import { isSafeUrl } from '@inkeep/open-knowledge-core/markdown/safe-url';
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
const MAX_VALUE_LENGTH = 2048;
diff --git a/packages/app/src/components/page-membership.ts b/packages/app/src/components/page-membership.ts
index ea05bd169..d619e4fe9 100644
--- a/packages/app/src/components/page-membership.ts
+++ b/packages/app/src/components/page-membership.ts
@@ -1,4 +1,4 @@
-import { isManagedArtifactDocName } from '@inkeep/open-knowledge-core';
+import { isManagedArtifactDocName } from '@inkeep/open-knowledge-core/constants/cc1';
export function isKnownPageDocName(pages: ReadonlySet<string>, docName: string): boolean {
return pages.has(docName) || isManagedArtifactDocName(docName);
diff --git a/packages/app/src/components/problems-sweep.ts b/packages/app/src/components/problems-sweep.ts
index 4387da107..42df961d8 100644
--- a/packages/app/src/components/problems-sweep.ts
+++ b/packages/app/src/components/problems-sweep.ts
@@ -1,4 +1,4 @@
-import type { ProblemType } from '@inkeep/open-knowledge-core';
+import type { ProblemType } from '@inkeep/open-knowledge-core/schemas/api';
export const SWEEP_PROGRESS_CHUNK = 50;
diff --git a/packages/app/src/components/project-switcher-recents.ts b/packages/app/src/components/project-switcher-recents.ts
index b8ccd523a..388407799 100644
--- a/packages/app/src/components/project-switcher-recents.ts
+++ b/packages/app/src/components/project-switcher-recents.ts
@@ -3,8 +3,8 @@ import type {
WorktreeInventoryLocation,
WorktreeInventoryModel,
WorktreeInventoryOpenRequest,
- WorktreeSelectorModel,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/git/worktree-inventory-model';
+import type { WorktreeSelectorModel } from '@inkeep/open-knowledge-core/git/worktree-selector-model';
import type { RecentProjectEntry } from '@/lib/desktop-bridge-types';
export interface RecentRepoGroup {
diff --git a/packages/app/src/components/property-inline-link-tokens.ts b/packages/app/src/components/property-inline-link-tokens.ts
index c1d506a3a..cbd7e1c5c 100644
--- a/packages/app/src/components/property-inline-link-tokens.ts
+++ b/packages/app/src/components/property-inline-link-tokens.ts
@@ -1,4 +1,4 @@
-import { parseWikiLink } from '@inkeep/open-knowledge-core';
+import { parseWikiLink } from '@inkeep/open-knowledge-core/extensions/wiki-link';
export type PropertyInlineSegment =
| { type: 'text'; value: string }
diff --git a/packages/app/src/components/resolve-conflict-dispatch.ts b/packages/app/src/components/resolve-conflict-dispatch.ts
index 9155ae6de..8fd3dbb38 100644
--- a/packages/app/src/components/resolve-conflict-dispatch.ts
+++ b/packages/app/src/components/resolve-conflict-dispatch.ts
@@ -1,4 +1,4 @@
-import { ProblemDetailsSchema, type ProblemType } from '@inkeep/open-knowledge-core';
+import { ProblemDetailsSchema, type ProblemType } from '@inkeep/open-knowledge-core/schemas/api';
type ResolveStrategy = 'mine' | 'theirs' | 'content' | 'delete';
diff --git a/packages/app/src/components/reusable-session-store.ts b/packages/app/src/components/reusable-session-store.ts
index 372b6fb94..62f68c221 100644
--- a/packages/app/src/components/reusable-session-store.ts
+++ b/packages/app/src/components/reusable-session-store.ts
@@ -1,4 +1,4 @@
-import type { TerminalCli } from '@inkeep/open-knowledge-core';
+import type { TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { useSyncExternalStore } from 'react';
export type ReusableSession =
diff --git a/packages/app/src/components/right-rail-admission.ts b/packages/app/src/components/right-rail-admission.ts
index fec8221ca..63b4aeb16 100644
--- a/packages/app/src/components/right-rail-admission.ts
+++ b/packages/app/src/components/right-rail-admission.ts
@@ -1,4 +1,4 @@
-import { MIN_TERMINAL_RIGHT_WIDTH } from '@inkeep/open-knowledge-core';
+import { MIN_TERMINAL_RIGHT_WIDTH } from '@inkeep/open-knowledge-core/terminal-layout';
export const MIN_USABLE_RIGHT_TERMINAL_WIDTH_PX = MIN_TERMINAL_RIGHT_WIDTH;
diff --git a/packages/app/src/components/settings/AccountSection.tsx b/packages/app/src/components/settings/AccountSection.tsx
index 1b2d96d82..1ebca5eeb 100644
--- a/packages/app/src/components/settings/AccountSection.tsx
+++ b/packages/app/src/components/settings/AccountSection.tsx
@@ -1,4 +1,4 @@
-import type { ConfigBinding } from '@inkeep/open-knowledge-core';
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useRef, useState } from 'react';
import { AuthModal } from '@/components/AuthModal';
diff --git a/packages/app/src/components/settings/AgentConnectionDialogs.tsx b/packages/app/src/components/settings/AgentConnectionDialogs.tsx
index e04552c26..20df85ca4 100644
--- a/packages/app/src/components/settings/AgentConnectionDialogs.tsx
+++ b/packages/app/src/components/settings/AgentConnectionDialogs.tsx
@@ -7,7 +7,6 @@ import {
buildConnectionsView,
CONNECTION_ROW_AGENT_IDS,
type ConnectionCell,
- EDITOR_LABELS,
type GuidanceId,
type HostSnapshot,
type PlanConflict,
@@ -15,9 +14,10 @@ import {
requiresExplicitConsent,
type SatisfierId,
type SurfaceState,
- TERMINAL_CLI_IDS,
VISIBLE_HANDOFF_TARGETS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/agent-registry';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
+import { TERMINAL_CLI_IDS } from '@inkeep/open-knowledge-core/handoff';
import { plural } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import { Folder, Info, Monitor, Sparkles, TriangleAlert, X } from 'lucide-react';
diff --git a/packages/app/src/components/settings/AgentConnectionsSection.tsx b/packages/app/src/components/settings/AgentConnectionsSection.tsx
index be77783e0..e62884d45 100644
--- a/packages/app/src/components/settings/AgentConnectionsSection.tsx
+++ b/packages/app/src/components/settings/AgentConnectionsSection.tsx
@@ -6,12 +6,14 @@ import {
agentIdForHandoffTarget,
agentIdForTerminalCli,
CONNECTION_ROW_AGENT_IDS,
- type HandoffTarget,
type HostSnapshot,
+} from '@inkeep/open-knowledge-core/agent-registry';
+import {
+ type HandoffTarget,
TERMINAL_CLI_IDS,
TERMINAL_CLIS,
type TerminalCli,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
import { useLingui } from '@lingui/react/macro';
import { useQuery } from '@tanstack/react-query';
import { ArrowUpRight, Check, Search, TriangleAlert, WifiOff } from 'lucide-react';
diff --git a/packages/app/src/components/settings/AttachmentsSection.tsx b/packages/app/src/components/settings/AttachmentsSection.tsx
index 61dd40fe6..6dc34183e 100644
--- a/packages/app/src/components/settings/AttachmentsSection.tsx
+++ b/packages/app/src/components/settings/AttachmentsSection.tsx
@@ -1,10 +1,8 @@
-import {
- CONFIG_DOC_NAME_PROJECT,
- type ConfigBinding,
- DEFAULT_ATTACHMENT_FOLDER_PATH,
- humanFormat,
- normalizeAttachmentFolderPath,
-} from '@inkeep/open-knowledge-core';
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
+import { normalizeAttachmentFolderPath } from '@inkeep/open-knowledge-core/config/schema';
+import { CONFIG_DOC_NAME_PROJECT } from '@inkeep/open-knowledge-core/constants/cc1';
+import { DEFAULT_ATTACHMENT_FOLDER_PATH } from '@inkeep/open-knowledge-core/constants/upload';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useRef, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/settings/ContentRulesSection.tsx b/packages/app/src/components/settings/ContentRulesSection.tsx
index 2d76726d6..ea113428d 100644
--- a/packages/app/src/components/settings/ContentRulesSection.tsx
+++ b/packages/app/src/components/settings/ContentRulesSection.tsx
@@ -1,9 +1,9 @@
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import {
DEFAULT_LINKS_VALIDATION,
DEFAULT_SUPPRESS_LOG_LINK_ADVISORIES,
- humanFormat,
type LinksValidationSetting,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { Trans, useLingui } from '@lingui/react/macro';
import { toast } from 'sonner';
import { Label } from '@/components/ui/label';
diff --git a/packages/app/src/components/settings/CustomThemeEditor.tsx b/packages/app/src/components/settings/CustomThemeEditor.tsx
index 10f8ddadd..404d216a7 100644
--- a/packages/app/src/components/settings/CustomThemeEditor.tsx
+++ b/packages/app/src/components/settings/CustomThemeEditor.tsx
@@ -1,5 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
import {
BASE16_SLOT_ROLES,
BASE16_SLOTS,
@@ -7,9 +8,8 @@ import {
type Base16Scheme,
type Base16Slot,
base16ToYaml,
- type ConfigBinding,
parseBase16Scheme,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/theme/base16';
import { useLingui } from '@lingui/react/macro';
import { ArrowUpRight } from 'lucide-react';
import { useTheme } from 'next-themes';
diff --git a/packages/app/src/components/settings/EnterpriseHostsSection.tsx b/packages/app/src/components/settings/EnterpriseHostsSection.tsx
index 1327d391a..99b441fc5 100644
--- a/packages/app/src/components/settings/EnterpriseHostsSection.tsx
+++ b/packages/app/src/components/settings/EnterpriseHostsSection.tsx
@@ -1,4 +1,6 @@
-import { type ConfigBinding, humanFormat, normalizeGitHostname } from '@inkeep/open-knowledge-core';
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
+import { normalizeGitHostname } from '@inkeep/open-knowledge-core/constants/github';
import { Trans, useLingui } from '@lingui/react/macro';
import { Trash2 } from 'lucide-react';
import { type SubmitEvent, useEffect, useId, useRef, useState } from 'react';
diff --git a/packages/app/src/components/settings/IntegrationsSection.tsx b/packages/app/src/components/settings/IntegrationsSection.tsx
index 1dc908dbb..08a6389b0 100644
--- a/packages/app/src/components/settings/IntegrationsSection.tsx
+++ b/packages/app/src/components/settings/IntegrationsSection.tsx
@@ -1,4 +1,4 @@
-import { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core';
+import { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core/constants/feature-flags';
import { Trans } from '@lingui/react/macro';
import { useState } from 'react';
import { InstallInClaudeDesktopDialog } from '@/components/InstallInClaudeDesktopDialog';
diff --git a/packages/app/src/components/settings/LanguageSelect.tsx b/packages/app/src/components/settings/LanguageSelect.tsx
index 1f7870946..6d44b9a20 100644
--- a/packages/app/src/components/settings/LanguageSelect.tsx
+++ b/packages/app/src/components/settings/LanguageSelect.tsx
@@ -2,7 +2,7 @@ import {
PICKER_LOCALES,
SUPPORTED_LOCALES,
type SupportedLocale,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/i18n/locales';
import { Trans } from '@lingui/react/macro';
import type { Ref } from 'react';
import {
diff --git a/packages/app/src/components/settings/LinkPreviewsSection.tsx b/packages/app/src/components/settings/LinkPreviewsSection.tsx
index f10d7267f..0f825dfa4 100644
--- a/packages/app/src/components/settings/LinkPreviewsSection.tsx
+++ b/packages/app/src/components/settings/LinkPreviewsSection.tsx
@@ -1,6 +1,6 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { humanFormat } from '@inkeep/open-knowledge-core';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import { Trans, useLingui } from '@lingui/react/macro';
import { type RefObject, useRef, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/settings/LintingSection.tsx b/packages/app/src/components/settings/LintingSection.tsx
index 637e113d7..74bfea2d4 100644
--- a/packages/app/src/components/settings/LintingSection.tsx
+++ b/packages/app/src/components/settings/LintingSection.tsx
@@ -1,12 +1,13 @@
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
+import type { ConfigPatch } from '@inkeep/open-knowledge-core/config/schema';
+import { OPENKNOWLEDGE_SKILLS_REPO } from '@inkeep/open-knowledge-core/constants/skills';
import {
type AppliesToPatternSummary,
assertNeverOkfRuleGroupId,
assertNeverOkfRuleId,
- type ConfigBinding,
- type ConfigPatch,
type FrontmatterSchemaMapping,
findZeroMatchAppliesToPatterns,
- humanFormat,
isFrontmatterSchemaAsset,
isOkfRuleEnabled,
type LintPluginId,
@@ -14,9 +15,8 @@ import {
OKF_RULE_IDS,
type OkfRuleGroupId,
type OkfRuleId,
- OPENKNOWLEDGE_SKILLS_REPO,
summarizeAppliesTo,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import {
ArrowUpRight,
diff --git a/packages/app/src/components/settings/NetworkAccessSection.tsx b/packages/app/src/components/settings/NetworkAccessSection.tsx
index d0845ee7a..0db196f91 100644
--- a/packages/app/src/components/settings/NetworkAccessSection.tsx
+++ b/packages/app/src/components/settings/NetworkAccessSection.tsx
@@ -1,4 +1,5 @@
-import { DEFAULT_TUNNEL_PORT, humanFormat } from '@inkeep/open-knowledge-core';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
+import { DEFAULT_TUNNEL_PORT } from '@inkeep/open-knowledge-core/config/schema';
import { useLingui } from '@lingui/react/macro';
import { useEffect, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/settings/OkignoreSection.tsx b/packages/app/src/components/settings/OkignoreSection.tsx
index 95ccec96a..95aa4b2fd 100644
--- a/packages/app/src/components/settings/OkignoreSection.tsx
+++ b/packages/app/src/components/settings/OkignoreSection.tsx
@@ -18,13 +18,13 @@ import {
verticalListSortingStrategy,
} from '@dnd-kit/sortable';
import { CSS } from '@dnd-kit/utilities';
+import type { OkignoreBinding } from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
import {
- CONFIG_DOC_NAME_OKIGNORE,
type ConfigValidationError,
humanFormat,
isKnownConfigError,
- type OkignoreBinding,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/config/errors';
+import { CONFIG_DOC_NAME_OKIGNORE } from '@inkeep/open-knowledge-core/constants/cc1';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { AlertTriangle, Check, GripVertical, X } from 'lucide-react';
import { type CSSProperties, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/settings/SavedThemesTiles.tsx b/packages/app/src/components/settings/SavedThemesTiles.tsx
index e065dd75d..9ef444fbf 100644
--- a/packages/app/src/components/settings/SavedThemesTiles.tsx
+++ b/packages/app/src/components/settings/SavedThemesTiles.tsx
@@ -1,4 +1,7 @@
-import { deriveSavedThemeName, parseSavedThemeId } from '@inkeep/open-knowledge-core';
+import {
+ deriveSavedThemeName,
+ parseSavedThemeId,
+} from '@inkeep/open-knowledge-core/theme/theme-plugins';
import { useLingui } from '@lingui/react/macro';
import { TriangleAlert } from 'lucide-react';
import { type SyntheticEvent, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/settings/SearchSection.tsx b/packages/app/src/components/settings/SearchSection.tsx
index 9fe4727f8..04167e6e6 100644
--- a/packages/app/src/components/settings/SearchSection.tsx
+++ b/packages/app/src/components/settings/SearchSection.tsx
@@ -1,25 +1,27 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import {
- type ConfigBinding,
checkEmbeddingsBaseUrl,
- classifySemanticProviderError,
DEFAULT_EMBEDDINGS_BASE_URL,
DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
DEFAULT_EMBEDDINGS_MODEL,
- humanFormat,
- isSemanticSearchOffered,
- type LocalOpEmbeddingsTestResponse,
MAX_EMBEDDINGS_DOC_TIMEOUT_MS,
MAX_EMBEDDINGS_MAX_BATCH_CHARS,
MAX_EMBEDDINGS_MAX_BATCH_SIZE,
MIN_EMBEDDINGS_DOC_TIMEOUT_MS,
MIN_EMBEDDINGS_MAX_BATCH_CHARS,
MIN_EMBEDDINGS_MAX_BATCH_SIZE,
+} from '@inkeep/open-knowledge-core/config/schema';
+import {
+ classifySemanticProviderError,
+ isSemanticSearchOffered,
+ type LocalOpEmbeddingsTestResponse,
type SemanticIndexStatus,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ChevronRight } from 'lucide-react';
import { type ReactNode, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsx
index a7cf09cd8..d67cd4218 100644
--- a/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsx
@@ -53,14 +53,19 @@ let publishDialogProps: Array<{ open: boolean }> = [];
let claudeRefreshCalls = 0;
let claudeSkillInstalled = false;
-const actualCore = await import('@inkeep/open-knowledge-core');
+const actualFeatureFlags = await import('@inkeep/open-knowledge-core/constants/feature-flags');
import * as actualLinguiMacro from '@lingui/react/macro';
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
-vi.doMock('@inkeep/open-knowledge-core', () => ({
- ...actualCore,
- SHOW_INSTALL_SKILL: true,
-}));
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/constants/feature-flags', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/constants/feature-flags', {
+ ...actualFeatureFlags,
+ SHOW_INSTALL_SKILL: true,
+ }),
+);
vi.doMock('@lingui/react/macro', () => ({
...actualLinguiMacro,
@@ -1010,6 +1015,21 @@ describe('SettingsDialogBody section runtime dispatch', () => {
expect(screen.getByTestId('settings-install-claude-desktop').textContent).toBe('Reinstall');
expect(screen.getByTestId('install-claude-dialog').getAttribute('data-reinstall')).toBe('true');
});
+ test('the Integrations section renders because the feature-flag replacement serves the install-skill flag on', async () => {
+ claudeSkillInstalled = false;
+ const since = servedCore.mark();
+ await renderBody({ activeId: 'claude-desktop' });
+
+ expect(screen.getByText('Install in Claude Desktop')).not.toBeNull();
+ expect(
+ servedCore.readersOf(
+ '@inkeep/open-knowledge-core/constants/feature-flags',
+ 'SHOW_INSTALL_SKILL',
+ since,
+ ),
+ ).toEqual(['components/settings/IntegrationsSection.tsx']);
+ });
+
test('dispatches every lint plugin id built by pluginSettingsSectionId', async () => {
const { pluginSettingsSectionId } = await import('@/lib/use-settings-route');
const { LINT_PLUGIN_META } = await import('./lint-plugin-meta');
diff --git a/packages/app/src/components/settings/SettingsDialogBody.tsx b/packages/app/src/components/settings/SettingsDialogBody.tsx
index 608bee990..0811e0d4f 100644
--- a/packages/app/src/components/settings/SettingsDialogBody.tsx
+++ b/packages/app/src/components/settings/SettingsDialogBody.tsx
@@ -1,4 +1,5 @@
-import type { ConfigBinding, OkignoreBinding } from '@inkeep/open-knowledge-core';
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import type { OkignoreBinding } from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
import { Trans, useLingui } from '@lingui/react/macro';
import { type ComponentType, lazy } from 'react';
import { lazyWithPreload } from '@/lib/lazy-with-preload';
diff --git a/packages/app/src/components/settings/SettingsDialogShell.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.dom.test.tsx
index 8f696bb60..88603311f 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.dom.test.tsx
@@ -1,7 +1,8 @@
import type { ConfigBinding, OkignoreBinding } from '@inkeep/open-knowledge-core';
-import { act, cleanup, render, screen } from '@testing-library/react';
+import { act, cleanup, render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
import {
expectVisualClassTokens,
expectVisualClassTokensAbsent,
@@ -64,12 +65,21 @@ let mockShowInstallSkill = true;
let mockProjectConfig: unknown = { contentRules: { markdownlint: { enabled: true } } };
let mockMerged: unknown = null;
-vi.doMock('@inkeep/open-knowledge-core', () => ({
- get SHOW_INSTALL_SKILL() {
- return mockShowInstallSkill;
- },
- MARKDOWNLINT_RULE_CATALOG: [],
-}));
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/constants/feature-flags', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/constants/feature-flags', {
+ get SHOW_INSTALL_SKILL() {
+ return mockShowInstallSkill;
+ },
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/markdown/lint', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/markdown/lint', {
+ MARKDOWNLINT_RULE_CATALOG: [],
+ }),
+);
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: (props: BodyProps) => {
@@ -367,4 +377,39 @@ describe('SettingsDialogShell userBinding gating (Tier-3 mount)', () => {
vi.unstubAllGlobals();
}
});
+
+ test('the Claude Desktop sidebar item appears because the feature-flag replacement serves the install-skill flag on', () => {
+ mockDesktopPresent = true;
+ const since = servedCore.mark();
+ render(<SettingsDialogShell open={true} onOpenChange={() => {}} />);
+
+ expect(screen.getByTestId('settings-sidebar-item-claude-desktop')).toBeTruthy();
+ expect(
+ servedCore.readersOf(
+ '@inkeep/open-knowledge-core/constants/feature-flags',
+ 'SHOW_INSTALL_SKILL',
+ since,
+ ),
+ ).toEqual(['components/settings/SettingsDialogShell.tsx']);
+ });
+
+ test('settings search finds no markdownlint rule because the lint replacement serves an empty catalog', async () => {
+ const user = userEvent.setup();
+ const since = servedCore.mark();
+ render(<SettingsDialogShell open={true} onOpenChange={() => {}} />);
+ expect(screen.getByTestId('settings-sidebar-item-plugin:markdownlint')).toBeTruthy();
+
+ await user.type(screen.getByTestId('settings-search-input'), 'MD013');
+ await waitFor(() => {
+ expect(screen.getByTestId('settings-search-empty')).toBeDefined();
+ });
+ expect(screen.queryByTestId('settings-search-result-rule:MD013')).toBeNull();
+ expect(
+ servedCore.readersOf(
+ '@inkeep/open-knowledge-core/markdown/lint',
+ 'MARKDOWNLINT_RULE_CATALOG',
+ since,
+ ),
+ ).toEqual(['components/settings/settings-search-index.ts']);
+ });
});
diff --git a/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx
index f5de71098..06319f965 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx
@@ -1,11 +1,15 @@
import { cleanup, render, screen } from '@testing-library/react';
import type { ReactNode } from 'react';
import { afterEach, describe, expect, test, vi } from 'vitest';
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
-vi.doMock('@inkeep/open-knowledge-core', () => ({
- SHOW_INSTALL_SKILL: false,
- MARKDOWNLINT_RULE_CATALOG: [],
-}));
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/constants/feature-flags', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/constants/feature-flags', {
+ SHOW_INSTALL_SKILL: false,
+ }),
+);
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: () => <div data-testid="settings-body-probe" />,
@@ -59,4 +63,19 @@ describe('SettingsDialogShell install-skill feature gate', () => {
expect(screen.queryByTestId('settings-sidebar-item-claude-desktop')).toBeNull();
expect(screen.queryByText('Integrations')).toBeNull();
});
+
+ test('the Claude Desktop integration is hidden because the feature-flag replacement serves the install-skill flag off', () => {
+ const since = servedCore.mark();
+ render(<SettingsDialogShell open={true} onOpenChange={() => {}} />);
+
+ expect(screen.getByTestId('settings-sidebar-item-preferences')).toBeTruthy();
+ expect(screen.queryByTestId('settings-sidebar-item-claude-desktop')).toBeNull();
+ expect(
+ servedCore.readersOf(
+ '@inkeep/open-knowledge-core/constants/feature-flags',
+ 'SHOW_INSTALL_SKILL',
+ since,
+ ),
+ ).toEqual(['components/settings/SettingsDialogShell.tsx']);
+ });
});
diff --git a/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx
index a2fa076fe..9248168af 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx
@@ -8,11 +8,6 @@ vi.doMock('@/lib/file-protocol-page', () => ({
isFileProtocolPage: () => fileProtocolPage,
}));
-vi.doMock('@inkeep/open-knowledge-core', () => ({
- SHOW_INSTALL_SKILL: false,
- MARKDOWNLINT_RULE_CATALOG: [],
-}));
-
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: () => <div data-testid="settings-body-probe" />,
}));
diff --git a/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx
index 54b1f5838..e5aba1725 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx
@@ -2,6 +2,7 @@ import type { ConfigBinding, OkignoreBinding } from '@inkeep/open-knowledge-core
import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
type WindowGlobals = { MutationObserver?: typeof MutationObserver; NodeFilter?: typeof NodeFilter };
type GlobalWithDomShims = typeof globalThis &
@@ -76,15 +77,16 @@ const SEMANTIC_STATUS_RESPONSE = {
total: 0,
};
-vi.doMock('@inkeep/open-knowledge-core', async () => ({
- ...(await vi.importActual<typeof import('@inkeep/open-knowledge-core')>(
- '@inkeep/open-knowledge-core',
- )),
- get SHOW_INSTALL_SKILL() {
- return true;
- },
- MARKDOWNLINT_RULE_CATALOG: FAKE_RULE_CATALOG,
-}));
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/markdown/lint', async () =>
+ servedCore.serve('@inkeep/open-knowledge-core/markdown/lint', {
+ ...(await vi.importActual<typeof import('@inkeep/open-knowledge-core/markdown/lint')>(
+ '@inkeep/open-knowledge-core/markdown/lint',
+ )),
+ MARKDOWNLINT_RULE_CATALOG: FAKE_RULE_CATALOG,
+ }),
+);
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: (props: BodyProps) => {
@@ -208,6 +210,30 @@ describe('settings dialog search', () => {
expect(screen.queryByTestId('settings-search-result-rule:MD013')).toBeNull();
});
+ test('rule search results come from the catalog the lint replacement serves', async () => {
+ const user = userEvent.setup();
+ const since = servedCore.mark();
+ render(<SettingsDialogShell open={true} onOpenChange={() => {}} />);
+ const input = screen.getByTestId('settings-search-input');
+
+ await user.type(input, 'MD001');
+ expect(await screen.findByTestId('settings-search-result-rule:MD001')).toBeTruthy();
+
+ await user.clear(input);
+ await user.type(input, 'MD009');
+ await waitFor(() => {
+ expect(screen.getByTestId('settings-search-empty')).toBeDefined();
+ });
+ expect(screen.queryByTestId('settings-search-result-rule:MD009')).toBeNull();
+ expect(
+ servedCore.readersOf(
+ '@inkeep/open-knowledge-core/markdown/lint',
+ 'MARKDOWNLINT_RULE_CATALOG',
+ since,
+ ),
+ ).toEqual(['components/settings/settings-search-index.ts']);
+ });
+
test('a no-match query renders the empty state', async () => {
const user = userEvent.setup();
render(<SettingsDialogShell open={true} onOpenChange={() => {}} />);
diff --git a/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx
index 79414949e..6f6c86850 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx
@@ -31,11 +31,6 @@ if (typeof HTMLElement.prototype.scrollIntoView !== 'function') {
HTMLElement.prototype.scrollIntoView = () => {};
}
-vi.doMock('@inkeep/open-knowledge-core', () => ({
- SHOW_INSTALL_SKILL: false,
- MARKDOWNLINT_RULE_CATALOG: [],
-}));
-
const probeActiveIds: string[] = [];
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: ({ activeId }: { activeId: string }) => {
diff --git a/packages/app/src/components/settings/SettingsDialogShell.tsx b/packages/app/src/components/settings/SettingsDialogShell.tsx
index 309c5f91d..0149ff770 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.tsx
@@ -2,7 +2,7 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core';
+import { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core/constants/feature-flags';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight } from 'lucide-react';
import { Suspense, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/settings/SkillFolderLinkConfirmDialog.tsx b/packages/app/src/components/settings/SkillFolderLinkConfirmDialog.tsx
index 988c0ac52..1e68d52f4 100644
--- a/packages/app/src/components/settings/SkillFolderLinkConfirmDialog.tsx
+++ b/packages/app/src/components/settings/SkillFolderLinkConfirmDialog.tsx
@@ -1,4 +1,4 @@
-import type { SkillFolderLinkPreview } from '@inkeep/open-knowledge-core';
+import type { SkillFolderLinkPreview } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowRight, Copy, Trash2, Unlink } from 'lucide-react';
import {
diff --git a/packages/app/src/components/settings/SkillTargetsPicker.tsx b/packages/app/src/components/settings/SkillTargetsPicker.tsx
index eea53b0f7..567822402 100644
--- a/packages/app/src/components/settings/SkillTargetsPicker.tsx
+++ b/packages/app/src/components/settings/SkillTargetsPicker.tsx
@@ -1,10 +1,7 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
-import {
- AGENTS_SKILLS_ROOT,
- type SkillFolderLinkPreview,
- type SkillScope,
-} from '@inkeep/open-knowledge-core';
+import { AGENTS_SKILLS_ROOT } from '@inkeep/open-knowledge-core/constants/skills';
+import type { SkillFolderLinkPreview, SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/settings/SkillsManagerSection.tsx b/packages/app/src/components/settings/SkillsManagerSection.tsx
index 2ecf26ec3..d5e196908 100644
--- a/packages/app/src/components/settings/SkillsManagerSection.tsx
+++ b/packages/app/src/components/settings/SkillsManagerSection.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans } from '@lingui/react/macro';
import { SkillTargetsPicker } from '@/components/settings/SkillTargetsPicker';
import { BuiltInSkillsSection } from './BuiltInSkillsSection';
diff --git a/packages/app/src/components/settings/SyncSection.tsx b/packages/app/src/components/settings/SyncSection.tsx
index c20998dd3..6772dd964 100644
--- a/packages/app/src/components/settings/SyncSection.tsx
+++ b/packages/app/src/components/settings/SyncSection.tsx
@@ -5,7 +5,7 @@ import {
resolveLocalAutoSyncMode,
SYNC_INTERVAL_PRESET_SECONDS,
type SyncMode,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/config/auto-sync-mode';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, ChevronRight } from 'lucide-react';
import { type Ref, useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/components/settings/TemplatesManagerSection.tsx b/packages/app/src/components/settings/TemplatesManagerSection.tsx
index 97f6be5d2..ae1e9ec32 100644
--- a/packages/app/src/components/settings/TemplatesManagerSection.tsx
+++ b/packages/app/src/components/settings/TemplatesManagerSection.tsx
@@ -1,4 +1,4 @@
-import { templateContentDocName } from '@inkeep/open-knowledge-core';
+import { templateContentDocName } from '@inkeep/open-knowledge-core/constants/cc1';
import { Trans } from '@lingui/react/macro';
import { Plus } from 'lucide-react';
import { type ReactNode, useState } from 'react';
diff --git a/packages/app/src/components/settings/TerminalSection.tsx b/packages/app/src/components/settings/TerminalSection.tsx
index fe4f98e23..0b92ad1c5 100644
--- a/packages/app/src/components/settings/TerminalSection.tsx
+++ b/packages/app/src/components/settings/TerminalSection.tsx
@@ -1,4 +1,4 @@
-import { humanFormat } from '@inkeep/open-knowledge-core';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import { useLingui } from '@lingui/react/macro';
import { useEffect, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/settings/ThemePluginSection.tsx b/packages/app/src/components/settings/ThemePluginSection.tsx
index 3b4c1c355..701126092 100644
--- a/packages/app/src/components/settings/ThemePluginSection.tsx
+++ b/packages/app/src/components/settings/ThemePluginSection.tsx
@@ -1,4 +1,4 @@
-import type { ConfigBinding } from '@inkeep/open-knowledge-core';
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
import { useLingui } from '@lingui/react/macro';
import { useEffect } from 'react';
import { useSavedThemes } from '@/lib/saved-themes-client';
diff --git a/packages/app/src/components/settings/ThemePreviewCanvas.tsx b/packages/app/src/components/settings/ThemePreviewCanvas.tsx
index f7a8a653e..3179ab840 100644
--- a/packages/app/src/components/settings/ThemePreviewCanvas.tsx
+++ b/packages/app/src/components/settings/ThemePreviewCanvas.tsx
@@ -1,5 +1,5 @@
-import type { Base16Scheme, Base16Slot } from '@inkeep/open-knowledge-core';
-import { base16ToTokens } from '@inkeep/open-knowledge-core';
+import type { Base16Scheme, Base16Slot } from '@inkeep/open-knowledge-core/theme/base16';
+import { base16ToTokens } from '@inkeep/open-knowledge-core/theme/base16';
import { useLingui } from '@lingui/react/macro';
import { cn } from '@/lib/utils';
diff --git a/packages/app/src/components/settings/agent-connection-status.ts b/packages/app/src/components/settings/agent-connection-status.ts
index 813ee0828..8aeeb1220 100644
--- a/packages/app/src/components/settings/agent-connection-status.ts
+++ b/packages/app/src/components/settings/agent-connection-status.ts
@@ -8,7 +8,7 @@ import {
type HostSnapshot,
isAgentDetected,
type RequirementAssessment,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/agent-registry';
export type RowConnectionStatus = 'not-installed' | 'no-status' | 'not-connected' | 'connected';
diff --git a/packages/app/src/components/settings/applies-to-folder-globs.ts b/packages/app/src/components/settings/applies-to-folder-globs.ts
index d1a78dfc6..7701bf10c 100644
--- a/packages/app/src/components/settings/applies-to-folder-globs.ts
+++ b/packages/app/src/components/settings/applies-to-folder-globs.ts
@@ -1,4 +1,4 @@
-import { compileAppliesTo, summarizeAppliesTo } from '@inkeep/open-knowledge-core';
+import { compileAppliesTo, summarizeAppliesTo } from '@inkeep/open-knowledge-core/markdown/lint';
export function folderRecursiveGlob(folder: string): string {
return `${folder}/**`;
diff --git a/packages/app/src/components/settings/enterprise-host-input.ts b/packages/app/src/components/settings/enterprise-host-input.ts
index 602e7a403..335c1f202 100644
--- a/packages/app/src/components/settings/enterprise-host-input.ts
+++ b/packages/app/src/components/settings/enterprise-host-input.ts
@@ -1,4 +1,5 @@
-import { type Config, normalizeGitHostname } from '@inkeep/open-knowledge-core';
+import type { Config } from '@inkeep/open-knowledge-core/config/schema';
+import { normalizeGitHostname } from '@inkeep/open-knowledge-core/constants/github';
export type EnterpriseHostInputResult =
| { ok: true; host: string }
diff --git a/packages/app/src/components/settings/field-controls.tsx b/packages/app/src/components/settings/field-controls.tsx
index 46674cf25..b1dcc14f7 100644
--- a/packages/app/src/components/settings/field-controls.tsx
+++ b/packages/app/src/components/settings/field-controls.tsx
@@ -1,10 +1,9 @@
import {
- type Config,
- ConfigSchema,
type ConfigValidationError,
- getFieldMeta,
isKnownConfigError,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/config/errors';
+import { getFieldMeta } from '@inkeep/open-knowledge-core/config/field-registry';
+import { type Config, ConfigSchema } from '@inkeep/open-knowledge-core/config/schema';
import { Trans, useLingui } from '@lingui/react/macro';
import { Check, RotateCcw } from 'lucide-react';
import { useTheme } from 'next-themes';
diff --git a/packages/app/src/components/settings/frontmatter-schema-field-editor.tsx b/packages/app/src/components/settings/frontmatter-schema-field-editor.tsx
index 35d80317c..6795a7ae7 100644
--- a/packages/app/src/components/settings/frontmatter-schema-field-editor.tsx
+++ b/packages/app/src/components/settings/frontmatter-schema-field-editor.tsx
@@ -3,7 +3,7 @@
import type {
FrontmatterFieldConstraint,
SchemaParentPathSegment,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { Trans, useLingui } from '@lingui/react/macro';
import {
Braces,
diff --git a/packages/app/src/components/settings/lint-plugin-meta.ts b/packages/app/src/components/settings/lint-plugin-meta.ts
index ba3b6ada7..4e6bb2eeb 100644
--- a/packages/app/src/components/settings/lint-plugin-meta.ts
+++ b/packages/app/src/components/settings/lint-plugin-meta.ts
@@ -1,4 +1,4 @@
-import type { LintPluginId } from '@inkeep/open-knowledge-core';
+import type { LintPluginId } from '@inkeep/open-knowledge-core/markdown/lint';
export interface LintPluginMeta {
id: LintPluginId;
diff --git a/packages/app/src/components/settings/markdownlint-rule-browser.tsx b/packages/app/src/components/settings/markdownlint-rule-browser.tsx
index 706b5e10b..75d261745 100644
--- a/packages/app/src/components/settings/markdownlint-rule-browser.tsx
+++ b/packages/app/src/components/settings/markdownlint-rule-browser.tsx
@@ -8,7 +8,7 @@ import {
RULE_DISPLAY_CATEGORIES,
type RuleCatalogEntry,
type RuleDisplayCategory,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, ChevronRight, Info, RotateCcw } from 'lucide-react';
import { useEffect, useState } from 'react';
diff --git a/packages/app/src/components/settings/rule-option-field.tsx b/packages/app/src/components/settings/rule-option-field.tsx
index 6c339881c..fff29b888 100644
--- a/packages/app/src/components/settings/rule-option-field.tsx
+++ b/packages/app/src/components/settings/rule-option-field.tsx
@@ -1,4 +1,4 @@
-import type { RuleOptionSpec } from '@inkeep/open-knowledge-core';
+import type { RuleOptionSpec } from '@inkeep/open-knowledge-core/markdown/lint';
import { Trans } from '@lingui/react/macro';
import { type ComponentType, type ReactNode, useEffect, useRef, useState } from 'react';
import { Badge } from '@/components/ui/badge';
diff --git a/packages/app/src/components/settings/schema-section.tsx b/packages/app/src/components/settings/schema-section.tsx
index c0a7fc4e6..94171cd85 100644
--- a/packages/app/src/components/settings/schema-section.tsx
+++ b/packages/app/src/components/settings/schema-section.tsx
@@ -1,10 +1,10 @@
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
+import type { Config } from '@inkeep/open-knowledge-core/config/schema';
import {
CONFIG_DOC_NAME_PROJECT,
CONFIG_DOC_NAME_USER,
- type Config,
- type ConfigBinding,
- humanFormat,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
import { Fragment, type ReactNode, useEffect, useRef, useState } from 'react';
import type { FieldPath } from 'react-hook-form';
import { toast } from 'sonner';
diff --git a/packages/app/src/components/settings/schema-walker.ts b/packages/app/src/components/settings/schema-walker.ts
index b724bf72f..935587815 100644
--- a/packages/app/src/components/settings/schema-walker.ts
+++ b/packages/app/src/components/settings/schema-walker.ts
@@ -1,4 +1,4 @@
-import { resolveLeafSchema } from '@inkeep/open-knowledge-core';
+import { resolveLeafSchema } from '@inkeep/open-knowledge-core/config/schema-leaf';
import type { z } from 'zod';
export { resolveLeafSchema };
diff --git a/packages/app/src/components/settings/settings-search-index.ts b/packages/app/src/components/settings/settings-search-index.ts
index c37c95d6f..86062c47a 100644
--- a/packages/app/src/components/settings/settings-search-index.ts
+++ b/packages/app/src/components/settings/settings-search-index.ts
@@ -1,4 +1,4 @@
-import { MARKDOWNLINT_RULE_CATALOG } from '@inkeep/open-knowledge-core';
+import { MARKDOWNLINT_RULE_CATALOG } from '@inkeep/open-knowledge-core/markdown/lint';
import type { MessageDescriptor } from '@lingui/core';
import { INDEXED_FIELD_GROUPS } from './settings-fields';
import type { SidebarGroup } from './settings-sidebar-types';
diff --git a/packages/app/src/components/settings/use-config-form.ts b/packages/app/src/components/settings/use-config-form.ts
index d2079c131..5d63d2c14 100644
--- a/packages/app/src/components/settings/use-config-form.ts
+++ b/packages/app/src/components/settings/use-config-form.ts
@@ -1,13 +1,14 @@
+import type {
+ ConfigBinding,
+ ConfigBindingPatchResult,
+} from '@inkeep/open-knowledge-core/config/bind-config-doc';
import {
- type Config,
- type ConfigBinding,
- type ConfigBindingPatchResult,
type ConfigIssue,
- type ConfigPatch,
type ConfigValidationError,
humanFormat,
isKnownConfigError,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/config/errors';
+import type { Config, ConfigPatch } from '@inkeep/open-knowledge-core/config/schema';
import { useEffect } from 'react';
import { type FieldPath, type UseFormReturn, useForm } from 'react-hook-form';
import { buildPatch } from './schema-walker';
diff --git a/packages/app/src/components/share-receive-miss-content.tsx b/packages/app/src/components/share-receive-miss-content.tsx
index 373898528..0894b74e0 100644
--- a/packages/app/src/components/share-receive-miss-content.tsx
+++ b/packages/app/src/components/share-receive-miss-content.tsx
@@ -1,4 +1,7 @@
-import type { PullOutcome, ShareTargetStatusResponse } from '@inkeep/open-knowledge-core';
+import type {
+ PullOutcome,
+ ShareTargetStatusResponse,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import {
ArrowDownToLine,
diff --git a/packages/app/src/components/skill-actions.tsx b/packages/app/src/components/skill-actions.tsx
index 195b6d91b..d99ea7396 100644
--- a/packages/app/src/components/skill-actions.tsx
+++ b/packages/app/src/components/skill-actions.tsx
@@ -1,9 +1,9 @@
-import {
- EDITOR_LABELS,
- type SkillInstallWarningCode,
- type SkillScope,
- type SkillsListEntry,
-} from '@inkeep/open-knowledge-core';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
+import type {
+ SkillInstallWarningCode,
+ SkillScope,
+ SkillsListEntry,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import {
ArrowLeftRight,
diff --git a/packages/app/src/components/sync-worktree-grouping.ts b/packages/app/src/components/sync-worktree-grouping.ts
index 635ca6438..7a3660cc0 100644
--- a/packages/app/src/components/sync-worktree-grouping.ts
+++ b/packages/app/src/components/sync-worktree-grouping.ts
@@ -1,4 +1,4 @@
-import type { GitWorktreeEntry } from '@inkeep/open-knowledge-core';
+import type { GitWorktreeEntry } from '@inkeep/open-knowledge-core/schemas/api';
export const MAX_WORKTREE_GROUPS = 8;
diff --git a/packages/app/src/components/terminal-session-registry.ts b/packages/app/src/components/terminal-session-registry.ts
index 9d036bed9..65b69740f 100644
--- a/packages/app/src/components/terminal-session-registry.ts
+++ b/packages/app/src/components/terminal-session-registry.ts
@@ -1,4 +1,4 @@
-import type { TerminalCli } from '@inkeep/open-knowledge-core';
+import type { TerminalCli } from '@inkeep/open-knowledge-core/handoff';
export const IDLE_QUIET_MS = 1200;
diff --git a/packages/app/src/components/terminal-theme.ts b/packages/app/src/components/terminal-theme.ts
index da6e3fae7..2ca04d5f6 100644
--- a/packages/app/src/components/terminal-theme.ts
+++ b/packages/app/src/components/terminal-theme.ts
@@ -1,4 +1,4 @@
-import type { AnsiSlotName } from '@inkeep/open-knowledge-core';
+import type { AnsiSlotName } from '@inkeep/open-knowledge-core/theme/base16';
import type { ITheme } from '@xterm/xterm';
import { cssColorToHex } from '@/lib/css-color-to-hex';
diff --git a/packages/app/src/components/ui/sidebar.tsx b/packages/app/src/components/ui/sidebar.tsx
index 8d6c112a8..9decf926c 100644
--- a/packages/app/src/components/ui/sidebar.tsx
+++ b/packages/app/src/components/ui/sidebar.tsx
@@ -1,4 +1,4 @@
-import { detectEmbeddedHostFromBrowser } from '@inkeep/open-knowledge-core';
+import { detectEmbeddedHostFromBrowser } from '@inkeep/open-knowledge-core/constants/embedded-host';
import { useLingui } from '@lingui/react/macro';
import { cva, type VariantProps } from 'class-variance-authority';
import { PanelLeft, PanelLeftOpen } from 'lucide-react';
diff --git a/packages/app/src/components/ui/tag-pill-input.tsx b/packages/app/src/components/ui/tag-pill-input.tsx
index f7be65f84..42ad125ef 100644
--- a/packages/app/src/components/ui/tag-pill-input.tsx
+++ b/packages/app/src/components/ui/tag-pill-input.tsx
@@ -3,7 +3,7 @@
import {
FRONTMATTER_TAG_GRAMMAR_HINT,
isValidFrontmatterTagValue,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/frontmatter/tags';
import { useLingui } from '@lingui/react/macro';
import { XIcon } from 'lucide-react';
import { type Ref, useEffect, useId, useRef, useState } from 'react';
diff --git a/packages/app/src/components/viewer-open-file.ts b/packages/app/src/components/viewer-open-file.ts
index c362993cd..5a44a2f83 100644
--- a/packages/app/src/components/viewer-open-file.ts
+++ b/packages/app/src/components/viewer-open-file.ts
@@ -1,4 +1,5 @@
-import { ASSET_EXTENSIONS, toDesktopAssetHref } from '@inkeep/open-knowledge-core';
+import { ASSET_EXTENSIONS } from '@inkeep/open-knowledge-core/constants/upload';
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
export interface ViewerOpenFileTarget {
readonly projectRelPath: string;
diff --git a/packages/app/src/editor/DocumentContext.tsx b/packages/app/src/editor/DocumentContext.tsx
index f26da7826..5a373a364 100644
--- a/packages/app/src/editor/DocumentContext.tsx
+++ b/packages/app/src/editor/DocumentContext.tsx
@@ -1,9 +1,7 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import type { Principal } from '@inkeep/open-knowledge-core';
-import {
- mediaKindForSidebarAssetExtension,
- PrincipalSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+import { mediaKindForSidebarAssetExtension } from '@inkeep/open-knowledge-core/constants/upload';
+import { PrincipalSuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
+import type { Principal } from '@inkeep/open-knowledge-core/types/principal';
import { createContext, type ReactNode, use, useEffect, useRef, useState } from 'react';
import type { ResolvedNavigationTarget } from '@/components/navigation-targets';
import { docNameForNavigationTarget } from '@/components/navigation-targets';
diff --git a/packages/app/src/editor/SourceEditor.tsx b/packages/app/src/editor/SourceEditor.tsx
index 0e8efa211..b7069773e 100644
--- a/packages/app/src/editor/SourceEditor.tsx
+++ b/packages/app/src/editor/SourceEditor.tsx
@@ -7,7 +7,7 @@ import {
DEFAULT_LINTER_CONFIG,
type PersistedLinterConfig,
toEffectiveBase,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { useTheme } from 'next-themes';
import { useEffect, useRef, useState } from 'react';
import { yCollab, yUndoManagerKeymap } from 'y-codemirror.next';
diff --git a/packages/app/src/editor/TiptapEditor.tsx b/packages/app/src/editor/TiptapEditor.tsx
index 0d7a852b7..24505a70d 100644
--- a/packages/app/src/editor/TiptapEditor.tsx
+++ b/packages/app/src/editor/TiptapEditor.tsx
@@ -1,15 +1,15 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
import {
- type AgentFlashEntry,
- sharedExtensions as coreExtensions,
- deriveIconColor,
evictStaleEntries,
FLASH_DEBOUNCE_MS,
FLASH_DURATION_MS,
hasNewEntries,
- MarkdownManager,
- randomUUID,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/activity';
+import { sharedExtensions as coreExtensions } from '@inkeep/open-knowledge-core/extensions/shared';
+import { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
+import type { AgentFlashEntry } from '@inkeep/open-knowledge-core/types/awareness';
+import { deriveIconColor } from '@inkeep/open-knowledge-core/utils/identity';
+import { randomUUID } from '@inkeep/open-knowledge-core/utils/random-uuid';
import { t } from '@lingui/core/macro';
import { type AnyExtension, Editor, type EditorOptions, Extension } from '@tiptap/core';
import Collaboration from '@tiptap/extension-collaboration';
diff --git a/packages/app/src/editor/apply-lint-fix.ts b/packages/app/src/editor/apply-lint-fix.ts
index 30d9a214d..b30313bf9 100644
--- a/packages/app/src/editor/apply-lint-fix.ts
+++ b/packages/app/src/editor/apply-lint-fix.ts
@@ -1,4 +1,8 @@
-import type { LintDiagnostic, LintPosition, LintTextEdit } from '@inkeep/open-knowledge-core';
+import type {
+ LintDiagnostic,
+ LintPosition,
+ LintTextEdit,
+} from '@inkeep/open-knowledge-core/markdown/lint';
import type * as Y from 'yjs';
import { requestPreviewTabPromotion } from './preview-tab-promotion';
diff --git a/packages/app/src/editor/awareness-user.ts b/packages/app/src/editor/awareness-user.ts
index 2dcb6e072..d2b6b3fde 100644
--- a/packages/app/src/editor/awareness-user.ts
+++ b/packages/app/src/editor/awareness-user.ts
@@ -1,11 +1,11 @@
+import type { AwarenessUser } from '@inkeep/open-knowledge-core/types/awareness';
+import type { Identity } from '@inkeep/open-knowledge-core/types/identity';
+import type { Principal } from '@inkeep/open-knowledge-core/types/principal';
import {
- type AwarenessUser,
colorFromSeed,
formatPresenceLabel,
HUMAN_COLORS,
- type Identity,
- type Principal,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/identity';
type AwarenessUserPayload = AwarenessUser & { type: 'human' };
diff --git a/packages/app/src/editor/block-spans.ts b/packages/app/src/editor/block-spans.ts
index fe2a7af98..4a86f5afe 100644
--- a/packages/app/src/editor/block-spans.ts
+++ b/packages/app/src/editor/block-spans.ts
@@ -1,4 +1,5 @@
-import { type MarkdownManager, stripFrontmatter } from '@inkeep/open-knowledge-core';
+import { stripFrontmatter } from '@inkeep/open-knowledge-core/extensions/frontmatter';
+import type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
import type { Node as PmNode } from '@tiptap/pm/model';
export interface SourceBlockSpans {
diff --git a/packages/app/src/editor/block-ux/keyboard-nav.ts b/packages/app/src/editor/block-ux/keyboard-nav.ts
index a6534fbf8..eb48334af 100644
--- a/packages/app/src/editor/block-ux/keyboard-nav.ts
+++ b/packages/app/src/editor/block-ux/keyboard-nav.ts
@@ -1,4 +1,4 @@
-import { incrementJsxArrowNodeSelectFailed } from '@inkeep/open-knowledge-core';
+import { incrementJsxArrowNodeSelectFailed } from '@inkeep/open-knowledge-core/metrics/parse-health';
import type { Editor } from '@tiptap/core';
import { Extension } from '@tiptap/core';
import { NodeSelection, Selection, TextSelection } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/bubble-menu/FootnoteBubbleButton.tsx b/packages/app/src/editor/bubble-menu/FootnoteBubbleButton.tsx
index 7b350047d..ccf6ab527 100644
--- a/packages/app/src/editor/bubble-menu/FootnoteBubbleButton.tsx
+++ b/packages/app/src/editor/bubble-menu/FootnoteBubbleButton.tsx
@@ -2,7 +2,7 @@ import {
collectFootnoteIdentifiers,
findFootnoteDefinitionInsertPos,
nextFootnoteIdentifier,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/extensions/footnote-reference';
import { useLingui } from '@lingui/react/macro';
import type { Editor } from '@tiptap/react';
import { useEditorState } from '@tiptap/react';
diff --git a/packages/app/src/editor/bubble-menu/bubble-menu-state.ts b/packages/app/src/editor/bubble-menu/bubble-menu-state.ts
index 0da243f7e..2db747988 100644
--- a/packages/app/src/editor/bubble-menu/bubble-menu-state.ts
+++ b/packages/app/src/editor/bubble-menu/bubble-menu-state.ts
@@ -1,4 +1,4 @@
-import { commentQuoteText } from '@inkeep/open-knowledge-core';
+import { commentQuoteText } from '@inkeep/open-knowledge-core/comments/leaf-text';
import type { EditorView } from '@tiptap/pm/view';
import type { Editor } from '@tiptap/react';
import { findMarkIdAt } from '../extensions/mark-identity';
diff --git a/packages/app/src/editor/client-persistence.ts b/packages/app/src/editor/client-persistence.ts
index cdbbb30bc..d0657d07f 100644
--- a/packages/app/src/editor/client-persistence.ts
+++ b/packages/app/src/editor/client-persistence.ts
@@ -1,4 +1,4 @@
-import { LINEAGE_EPOCH_KEY } from '@inkeep/open-knowledge-core';
+import { LINEAGE_EPOCH_KEY } from '@inkeep/open-knowledge-core/constants/doc-lifecycle';
import { IndexeddbPersistence } from 'y-indexeddb';
import * as Y from 'yjs';
import { mark } from '@/lib/perf';
diff --git a/packages/app/src/editor/client-removal-reconciliation.ts b/packages/app/src/editor/client-removal-reconciliation.ts
index 03446c0a4..9193d3242 100644
--- a/packages/app/src/editor/client-removal-reconciliation.ts
+++ b/packages/app/src/editor/client-removal-reconciliation.ts
@@ -1,4 +1,7 @@
-import type { RenamedAssetMapping, RenamedDocMapping } from '@inkeep/open-knowledge-core';
+import type {
+ RenamedAssetMapping,
+ RenamedDocMapping,
+} from '@inkeep/open-knowledge-core/schemas/api';
import type { RenamedFolderMapping } from './editor-tabs';
export interface LocalRenameReconciliation {
diff --git a/packages/app/src/editor/clipboard/clipboard-sanitize.ts b/packages/app/src/editor/clipboard/clipboard-sanitize.ts
index 603144215..3ab4bb8a6 100644
--- a/packages/app/src/editor/clipboard/clipboard-sanitize.ts
+++ b/packages/app/src/editor/clipboard/clipboard-sanitize.ts
@@ -1,4 +1,4 @@
-import { isRelativeUrl, SAFE_URL_SCHEME_RE } from '@inkeep/open-knowledge-core';
+import { isRelativeUrl, SAFE_URL_SCHEME_RE } from '@inkeep/open-knowledge-core/markdown/safe-url';
import * as ipaddr from 'ipaddr.js';
export const URL_SCHEME_ATTRS: ReadonlySet<string> = new Set([
diff --git a/packages/app/src/editor/clipboard/clipboard-walker.ts b/packages/app/src/editor/clipboard/clipboard-walker.ts
index 9da9c20ff..a2be03b28 100644
--- a/packages/app/src/editor/clipboard/clipboard-walker.ts
+++ b/packages/app/src/editor/clipboard/clipboard-walker.ts
@@ -1,4 +1,5 @@
-import { normalizeNullableString, wikiLinkHref } from '@inkeep/open-knowledge-core';
+import { normalizeNullableString } from '@inkeep/open-knowledge-core/extensions/wiki-link';
+import { wikiLinkHref } from '@inkeep/open-knowledge-core/utils/slug';
import type { Node as PmNode, Slice } from '@tiptap/pm/model';
import type { EditorView } from '@tiptap/pm/view';
import {
diff --git a/packages/app/src/editor/clipboard/handle-copy.ts b/packages/app/src/editor/clipboard/handle-copy.ts
index 22b60ab09..71988cfac 100644
--- a/packages/app/src/editor/clipboard/handle-copy.ts
+++ b/packages/app/src/editor/clipboard/handle-copy.ts
@@ -1,4 +1,4 @@
-import type { MarkdownManager } from '@inkeep/open-knowledge-core';
+import type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
import { TextSelection } from '@tiptap/pm/state';
import { CellSelection } from '@tiptap/pm/tables';
import type { EditorView } from '@tiptap/pm/view';
diff --git a/packages/app/src/editor/clipboard/handle-drop.test.ts b/packages/app/src/editor/clipboard/handle-drop.test.ts
index cbccdf0b2..0a4b75d9c 100644
--- a/packages/app/src/editor/clipboard/handle-drop.test.ts
+++ b/packages/app/src/editor/clipboard/handle-drop.test.ts
@@ -1,13 +1,16 @@
-import * as actualCore from '@inkeep/open-knowledge-core';
+import * as actualHtmlToMdast from '@inkeep/open-knowledge-core/markdown/html-to-mdast';
import * as actualSonner from 'sonner';
import { afterEach, beforeAll, beforeEach, describe, expect, test, vi } from 'vitest';
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
-vi.doMock('@inkeep/open-knowledge-core', () => {
- return {
- ...actualCore,
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/markdown/html-to-mdast', () => {
+ return servedCore.serve('@inkeep/open-knowledge-core/markdown/html-to-mdast', {
+ ...actualHtmlToMdast,
htmlToMdast: vi.fn((_html: string) => ({ type: 'root', children: [] })),
mdastToMarkdown: vi.fn((_tree: unknown) => '**bold**'),
- };
+ });
});
vi.doMock('sonner', () => ({ ...actualSonner, toast: { error: vi.fn(() => {}) } }));
@@ -338,3 +341,28 @@ describe('WYSIWYG drop dispatcher — paste/drop parity on canonical inputs', ()
expect(view.state.tr.replaceSelectionWith).toHaveBeenCalled();
});
});
+
+describe('WYSIWYG drop dispatcher — core replacement liveness', () => {
+ test('a generic HTML drop parses the markdown the html-to-mdast replacement serves', () => {
+ const since = servedCore.mark();
+ const md = fakeMdManager();
+ const drop = createHandleDrop({
+ // biome-ignore lint/suspicious/noExplicitAny: narrow fake md manager
+ mdManager: md as any,
+ });
+ const evt = fakeDropEvent({
+ data: {
+ 'text/plain': 'plain prose no signals',
+ 'text/html': '<p>rich <b>html</b></p>',
+ },
+ });
+
+ expect(drop(fakeView(), evt)).toBe(true);
+ expect(md.parse).toHaveBeenCalledWith('**bold**');
+ for (const member of ['htmlToMdast', 'mdastToMarkdown']) {
+ expect(
+ servedCore.readersOf('@inkeep/open-knowledge-core/markdown/html-to-mdast', member, since),
+ ).toEqual(['editor/clipboard/handle-paste.ts']);
+ }
+ });
+});
diff --git a/packages/app/src/editor/clipboard/handle-paste.test.ts b/packages/app/src/editor/clipboard/handle-paste.test.ts
index f4c15d3a9..7d6954507 100644
--- a/packages/app/src/editor/clipboard/handle-paste.test.ts
+++ b/packages/app/src/editor/clipboard/handle-paste.test.ts
@@ -1,19 +1,21 @@
-import * as actualCore from '@inkeep/open-knowledge-core';
import { LinkFidelity, MarkdownManager, sharedExtensions } from '@inkeep/open-knowledge-core';
+import * as actualHtmlToMdast from '@inkeep/open-knowledge-core/markdown/html-to-mdast';
import { Editor, type Extensions } from '@tiptap/core';
import StarterKit from '@tiptap/starter-kit';
import * as actualSonner from 'sonner';
import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, test, vi } from 'vitest';
-
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
import { GfmAutolink } from '../gfm-autolink-plugin.ts';
import { flushMicrotasksAndTimers, installDomGlobals } from '../walk-currency-test-harness.ts';
-vi.doMock('@inkeep/open-knowledge-core', () => {
- return {
- ...actualCore,
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/markdown/html-to-mdast', () => {
+ return servedCore.serve('@inkeep/open-knowledge-core/markdown/html-to-mdast', {
+ ...actualHtmlToMdast,
htmlToMdast: vi.fn((_html: string) => ({ type: 'root', children: [] })),
mdastToMarkdown: vi.fn((_tree: unknown) => '**bold**'),
- };
+ });
});
vi.doMock('sonner', () => ({ ...actualSonner, toast: { error: vi.fn(() => {}) } }));
@@ -297,6 +299,29 @@ describe('WYSIWYG paste dispatcher — branch routing', () => {
});
});
+describe('WYSIWYG paste dispatcher — core replacement liveness', () => {
+ test('a generic HTML paste parses the markdown the html-to-mdast replacement serves', () => {
+ const since = servedCore.mark();
+ const md = fakeMdManager();
+ const paste = createHandlePaste({
+ // biome-ignore lint/suspicious/noExplicitAny: narrow fake md manager
+ mdManager: md as any,
+ });
+ const evt = fakeDT({
+ 'text/plain': 'plain prose no signals',
+ 'text/html': '<p>rich <b>html</b></p>',
+ });
+
+ expect(paste(fakeView(), evt)).toBe(true);
+ expect(md.parse).toHaveBeenCalledWith('**bold**');
+ for (const member of ['htmlToMdast', 'mdastToMarkdown']) {
+ expect(
+ servedCore.readersOf('@inkeep/open-knowledge-core/markdown/html-to-mdast', member, since),
+ ).toEqual(['editor/clipboard/handle-paste.ts']);
+ }
+ });
+});
+
describe('WYSIWYG paste dispatcher — markdown-first tiebreak ordering (D5/D13)', () => {
test('OK→OK <img/> JSX paste: markdown-first wins over Branch C data-pm-slice', () => {
const md = fakeMdManager();
diff --git a/packages/app/src/editor/clipboard/handle-paste.ts b/packages/app/src/editor/clipboard/handle-paste.ts
index 04f2eeacc..3545eeffc 100644
--- a/packages/app/src/editor/clipboard/handle-paste.ts
+++ b/packages/app/src/editor/clipboard/handle-paste.ts
@@ -1,7 +1,7 @@
/** WYSIWYG paste/drop dispatcher — 5-branch router per precedent #19(b). */
-import type { MarkdownManager } from '@inkeep/open-knowledge-core';
-import { htmlToMdast, mdastToMarkdown } from '@inkeep/open-knowledge-core';
+import type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
+import { htmlToMdast, mdastToMarkdown } from '@inkeep/open-knowledge-core/markdown/html-to-mdast';
import type { JSONContent } from '@tiptap/core';
import { Fragment, type Node as ProseMirrorNode } from '@tiptap/pm/model';
import { type EditorState, TextSelection, type Transaction } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/clipboard/instrument.ts b/packages/app/src/editor/clipboard/instrument.ts
index 811aa1d03..ef126bdb3 100644
--- a/packages/app/src/editor/clipboard/instrument.ts
+++ b/packages/app/src/editor/clipboard/instrument.ts
@@ -1,4 +1,5 @@
-import { ChunkedInsertError, HtmlPayloadTooLargeError } from '@inkeep/open-knowledge-core';
+import { HtmlPayloadTooLargeError } from '@inkeep/open-knowledge-core/markdown/html-to-mdast';
+import { ChunkedInsertError } from '@inkeep/open-knowledge-core/utils/chunked-insert';
import type { UrlPortabilityReason } from './clipboard-sanitize.ts';
import type { ClipboardSource } from './detect-source.ts';
diff --git a/packages/app/src/editor/clipboard/lone-url.ts b/packages/app/src/editor/clipboard/lone-url.ts
index b4130bb86..0c2282ad1 100644
--- a/packages/app/src/editor/clipboard/lone-url.ts
+++ b/packages/app/src/editor/clipboard/lone-url.ts
@@ -1,4 +1,4 @@
-import { isAllowedLinkUri } from '@inkeep/open-knowledge-core';
+import { isAllowedLinkUri } from '@inkeep/open-knowledge-core/extensions/link-fidelity';
import { detectGfmLinkToken } from '../gfm-link-detector.ts';
const EXPLICIT_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
diff --git a/packages/app/src/editor/clipboard/non-portable-render-source-fallback.ts b/packages/app/src/editor/clipboard/non-portable-render-source-fallback.ts
index 43dc84f80..be364f990 100644
--- a/packages/app/src/editor/clipboard/non-portable-render-source-fallback.ts
+++ b/packages/app/src/editor/clipboard/non-portable-render-source-fallback.ts
@@ -1,4 +1,4 @@
-import { selectFenceChar, widenFenceLength } from '@inkeep/open-knowledge-core';
+import { selectFenceChar, widenFenceLength } from '@inkeep/open-knowledge-core/markdown/code-fence';
import type { Node as PmNode } from '@tiptap/pm/model';
import { normalizeCodeLanguage } from '../extensions/code-block-languages.ts';
import { shouldShowPreview } from '../extensions/code-block-meta.ts';
diff --git a/packages/app/src/editor/clipboard/serialize.ts b/packages/app/src/editor/clipboard/serialize.ts
index 137b1895c..63b58b894 100644
--- a/packages/app/src/editor/clipboard/serialize.ts
+++ b/packages/app/src/editor/clipboard/serialize.ts
@@ -1,5 +1,5 @@
-import type { MarkdownManager } from '@inkeep/open-knowledge-core';
-import { markdownToHtml } from '@inkeep/open-knowledge-core';
+import type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
+import { markdownToHtml } from '@inkeep/open-knowledge-core/markdown/mdast-to-html';
import type { JSONContent } from '@tiptap/core';
import type { Node, ResolvedPos, Schema, Slice } from '@tiptap/pm/model';
import { DOMSerializer, Fragment, Slice as SliceCtor } from '@tiptap/pm/model';
diff --git a/packages/app/src/editor/clipboard/source-clipboard.ts b/packages/app/src/editor/clipboard/source-clipboard.ts
index f3bd2721a..14969aa86 100644
--- a/packages/app/src/editor/clipboard/source-clipboard.ts
+++ b/packages/app/src/editor/clipboard/source-clipboard.ts
@@ -6,12 +6,11 @@
import type { Extension } from '@codemirror/state';
import { EditorView } from '@codemirror/view';
+import { htmlToMdast, mdastToMarkdown } from '@inkeep/open-knowledge-core/markdown/html-to-mdast';
import {
ChunkedInsertError,
chunkedYTextInsert,
- htmlToMdast,
- mdastToMarkdown,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/chunked-insert';
import { t } from '@lingui/core/macro';
import { toast } from 'sonner';
import * as Y from 'yjs';
diff --git a/packages/app/src/editor/components/Audio.tsx b/packages/app/src/editor/components/Audio.tsx
index 9d5a734d5..0cce8b6b2 100644
--- a/packages/app/src/editor/components/Audio.tsx
+++ b/packages/app/src/editor/components/Audio.tsx
@@ -1,4 +1,4 @@
-import { toDesktopAssetHref } from '@inkeep/open-knowledge-core';
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
interface AudioProps {
src?: string;
diff --git a/packages/app/src/editor/components/CodeMirrorPropInput.tsx b/packages/app/src/editor/components/CodeMirrorPropInput.tsx
index cba1d5821..78520079d 100644
--- a/packages/app/src/editor/components/CodeMirrorPropInput.tsx
+++ b/packages/app/src/editor/components/CodeMirrorPropInput.tsx
@@ -15,7 +15,7 @@ import {
import { stex } from '@codemirror/legacy-modes/mode/stex';
import { Compartment, EditorState, type Extension } from '@codemirror/state';
import { EditorView, keymap, lineNumbers } from '@codemirror/view';
-import type { PropDefString } from '@inkeep/open-knowledge-core';
+import type { PropDefString } from '@inkeep/open-knowledge-core/registry/types';
import { tags } from '@lezer/highlight';
import { mermaid } from 'codemirror-lang-mermaid';
import { useEffect, useRef } from 'react';
diff --git a/packages/app/src/editor/components/Embed.tsx b/packages/app/src/editor/components/Embed.tsx
index 7556830f4..386dd38d5 100644
--- a/packages/app/src/editor/components/Embed.tsx
+++ b/packages/app/src/editor/components/Embed.tsx
@@ -1,4 +1,4 @@
-import { rewriteEmbedUrl } from '@inkeep/open-knowledge-core';
+import { rewriteEmbedUrl } from '@inkeep/open-knowledge-core/utils/embed-url-rewrite';
import { useEffect, useRef } from 'react';
import { useJsxComponentHost } from './jsx-host-context.tsx';
import { ResizeHandles } from './ResizeHandles.tsx';
diff --git a/packages/app/src/editor/components/ExcalidrawEmbed.tsx b/packages/app/src/editor/components/ExcalidrawEmbed.tsx
index 0d6450e87..97c1cecd1 100644
--- a/packages/app/src/editor/components/ExcalidrawEmbed.tsx
+++ b/packages/app/src/editor/components/ExcalidrawEmbed.tsx
@@ -1,4 +1,4 @@
-import { isExcalidrawDocFile } from '@inkeep/open-knowledge-core';
+import { isExcalidrawDocFile } from '@inkeep/open-knowledge-core/constants/upload';
import { Trans, useLingui } from '@lingui/react/macro';
import type { PanzoomObject } from '@panzoom/panzoom';
import { AlertTriangle, ExternalLink } from 'lucide-react';
diff --git a/packages/app/src/editor/components/File.tsx b/packages/app/src/editor/components/File.tsx
index e73a77d5a..96dbd7194 100644
--- a/packages/app/src/editor/components/File.tsx
+++ b/packages/app/src/editor/components/File.tsx
@@ -1,4 +1,4 @@
-import { toDesktopAssetHref } from '@inkeep/open-knowledge-core';
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
import { FileUp } from 'lucide-react';
interface FileProps {
diff --git a/packages/app/src/editor/components/Image.tsx b/packages/app/src/editor/components/Image.tsx
index fb11de7be..0a37de560 100644
--- a/packages/app/src/editor/components/Image.tsx
+++ b/packages/app/src/editor/components/Image.tsx
@@ -1,4 +1,4 @@
-import { toDesktopAssetHref } from '@inkeep/open-knowledge-core';
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
import type { ImgHTMLAttributes } from 'react';
import Zoom from 'react-medium-image-zoom';
import { LoadingImage } from '@/components/ui/loading-image';
diff --git a/packages/app/src/editor/components/Pdf.tsx b/packages/app/src/editor/components/Pdf.tsx
index 36affe813..cad2b5f35 100644
--- a/packages/app/src/editor/components/Pdf.tsx
+++ b/packages/app/src/editor/components/Pdf.tsx
@@ -1,4 +1,5 @@
-import { parsePdfAnchor, toDesktopAssetHref } from '@inkeep/open-knowledge-core';
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
+import { parsePdfAnchor } from '@inkeep/open-knowledge-core/utils/pdf-anchor';
import { Trans, useLingui } from '@lingui/react/macro';
import { Check, ChevronDown, PanelLeft, ZoomIn, ZoomOut } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
diff --git a/packages/app/src/editor/components/PropPanel.tsx b/packages/app/src/editor/components/PropPanel.tsx
index 73722ab9f..368898b8c 100644
--- a/packages/app/src/editor/components/PropPanel.tsx
+++ b/packages/app/src/editor/components/PropPanel.tsx
@@ -1,4 +1,4 @@
-import type { PropDef } from '@inkeep/open-knowledge-core';
+import type { PropDef } from '@inkeep/open-knowledge-core/registry/types';
import { t } from '@lingui/core/macro';
import { Trans } from '@lingui/react/macro';
import { ChevronDown, Upload } from 'lucide-react';
diff --git a/packages/app/src/editor/components/SrcAutocomplete.tsx b/packages/app/src/editor/components/SrcAutocomplete.tsx
index d4860937e..ea1332fdb 100644
--- a/packages/app/src/editor/components/SrcAutocomplete.tsx
+++ b/packages/app/src/editor/components/SrcAutocomplete.tsx
@@ -3,7 +3,7 @@ import {
createWorkspaceSearchDocument,
searchWorkspaceCorpus,
type WorkspaceSearchCorpus,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/search/workspace-search';
import { useLingui } from '@lingui/react/macro';
import type { ReactNode } from 'react';
import { useEffect, useId, useRef, useState } from 'react';
diff --git a/packages/app/src/editor/components/TagView.tsx b/packages/app/src/editor/components/TagView.tsx
index 107eb1d97..0bb37da08 100644
--- a/packages/app/src/editor/components/TagView.tsx
+++ b/packages/app/src/editor/components/TagView.tsx
@@ -1,4 +1,4 @@
-import { INLINE_TAG_VALUE_RE } from '@inkeep/open-knowledge-core';
+import { INLINE_TAG_VALUE_RE } from '@inkeep/open-knowledge-core/markdown/tag-promotion';
import { useLingui } from '@lingui/react/macro';
import type { NodeViewProps } from '@tiptap/core';
import { TextSelection } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/components/Video.tsx b/packages/app/src/editor/components/Video.tsx
index a95ce3362..e200fb39b 100644
--- a/packages/app/src/editor/components/Video.tsx
+++ b/packages/app/src/editor/components/Video.tsx
@@ -1,11 +1,10 @@
+import { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
+import { isLoomUrl, parseLoomUrl } from '@inkeep/open-knowledge-core/utils/loom-embed';
+import { isVimeoUrl } from '@inkeep/open-knowledge-core/utils/vimeo-embed';
import {
- isLoomUrl,
- isVimeoUrl,
type ParsedYouTubeUrl,
- parseLoomUrl,
parseYouTubeUrl,
- toDesktopAssetHref,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/youtube-embed';
import Vimeo from '@u-wave/react-vimeo';
import { type CSSProperties, useEffect, useRef } from 'react';
import LiteYouTubeEmbed from 'react-lite-youtube-embed';
diff --git a/packages/app/src/editor/components/image-target-existence.ts b/packages/app/src/editor/components/image-target-existence.ts
index bb89c72dd..3e266fb44 100644
--- a/packages/app/src/editor/components/image-target-existence.ts
+++ b/packages/app/src/editor/components/image-target-existence.ts
@@ -1,4 +1,4 @@
-import { resolveAssetProjectPath } from '@inkeep/open-knowledge-core';
+import { resolveAssetProjectPath } from '@inkeep/open-knowledge-core/utils/link-targets';
import { useOptionalPageList } from '../../components/PageListContext';
import { isResolvedAssetHref } from '../extensions/link-resolution';
diff --git a/packages/app/src/editor/components/use-mirror-source.ts b/packages/app/src/editor/components/use-mirror-source.ts
index 13e3b70e4..27c8856ce 100644
--- a/packages/app/src/editor/components/use-mirror-source.ts
+++ b/packages/app/src/editor/components/use-mirror-source.ts
@@ -1,4 +1,4 @@
-import { mdastToHtml } from '@inkeep/open-knowledge-core';
+import { mdastToHtml } from '@inkeep/open-knowledge-core/markdown/mdast-to-html';
import { useEffect, useRef, useState } from 'react';
import { useCollabUrl } from '@/lib/use-collab-url';
import { getSharedMarkdownManager } from '../utils/md-singleton.ts';
diff --git a/packages/app/src/editor/editor-cache.ts b/packages/app/src/editor/editor-cache.ts
index e345bd386..daf2231fa 100644
--- a/packages/app/src/editor/editor-cache.ts
+++ b/packages/app/src/editor/editor-cache.ts
@@ -14,8 +14,8 @@
import type { Compartment } from '@codemirror/state';
import type { EditorView } from '@codemirror/view';
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import type { RenamedDocMapping } from '@inkeep/open-knowledge-core';
-import { isMarkdownDocFile } from '@inkeep/open-knowledge-core';
+import { isMarkdownDocFile } from '@inkeep/open-knowledge-core/constants/upload';
+import type { RenamedDocMapping } from '@inkeep/open-knowledge-core/schemas/api';
import type { Editor } from '@tiptap/core';
import { NodeSelection, TextSelection } from '@tiptap/pm/state';
import { yUndoPluginKey } from '@tiptap/y-tiptap';
diff --git a/packages/app/src/editor/editor-tabs.ts b/packages/app/src/editor/editor-tabs.ts
index 4fb372afd..447f38ea5 100644
--- a/packages/app/src/editor/editor-tabs.ts
+++ b/packages/app/src/editor/editor-tabs.ts
@@ -1,14 +1,13 @@
import {
- isExcalidrawDocFile,
isManagedArtifactDocName,
MANAGED_ARTIFACT_SCOPES,
parseExternalSkillDocName,
parseManagedArtifactName,
parseProjectSkillBundleDoc,
parseTemplateContentDocName,
- type RenamedAssetMapping,
- type SkillScope,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import { isExcalidrawDocFile } from '@inkeep/open-knowledge-core/constants/upload';
+import type { RenamedAssetMapping, SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import {
decodeSkillPreviewSegments,
encodeSkillPreviewSegments,
diff --git a/packages/app/src/editor/extensions/ImageInlineZoomView.tsx b/packages/app/src/editor/extensions/ImageInlineZoomView.tsx
index 4d2d8bd15..53f579e1d 100644
--- a/packages/app/src/editor/extensions/ImageInlineZoomView.tsx
+++ b/packages/app/src/editor/extensions/ImageInlineZoomView.tsx
@@ -1,4 +1,4 @@
-import { normalizeDocRelativeAssetUrl } from '@inkeep/open-knowledge-core';
+import { normalizeDocRelativeAssetUrl } from '@inkeep/open-knowledge-core/markdown/resolve-image-url';
import type { NodeViewProps } from '@tiptap/core';
import { NodeViewWrapper } from '@tiptap/react';
import Zoom from 'react-medium-image-zoom';
diff --git a/packages/app/src/editor/extensions/ImageReferenceView.tsx b/packages/app/src/editor/extensions/ImageReferenceView.tsx
index c5fb7edfa..ad4ce50e9 100644
--- a/packages/app/src/editor/extensions/ImageReferenceView.tsx
+++ b/packages/app/src/editor/extensions/ImageReferenceView.tsx
@@ -1,4 +1,5 @@
-import { normalizeDocRelativeAssetUrl, normalizeReferenceLabel } from '@inkeep/open-knowledge-core';
+import { normalizeReferenceLabel } from '@inkeep/open-knowledge-core/markdown/reference-label';
+import { normalizeDocRelativeAssetUrl } from '@inkeep/open-knowledge-core/markdown/resolve-image-url';
import type { NodeViewProps } from '@tiptap/core';
import type { Node as ProseMirrorNode } from '@tiptap/pm/model';
import { NodeViewWrapper, useEditorState } from '@tiptap/react';
diff --git a/packages/app/src/editor/extensions/InternalLinkPropPanel.tsx b/packages/app/src/editor/extensions/InternalLinkPropPanel.tsx
index fdab9ad8e..d33c2700a 100644
--- a/packages/app/src/editor/extensions/InternalLinkPropPanel.tsx
+++ b/packages/app/src/editor/extensions/InternalLinkPropPanel.tsx
@@ -2,7 +2,7 @@ import {
type ClassifiedLinkTarget,
classifyMarkdownHref,
isExternalHref,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/link-targets';
import { Trans, useLingui } from '@lingui/react/macro';
import type { Editor } from '@tiptap/core';
import { posToDOMRect } from '@tiptap/core';
diff --git a/packages/app/src/editor/extensions/JsxComponentView.tsx b/packages/app/src/editor/extensions/JsxComponentView.tsx
index 79a2365c1..408b9076e 100644
--- a/packages/app/src/editor/extensions/JsxComponentView.tsx
+++ b/packages/app/src/editor/extensions/JsxComponentView.tsx
@@ -4,8 +4,8 @@
* NodeViewContent is always rendered rather than hidden (precedent #30).
*/
+import { commentLeafText } from '@inkeep/open-knowledge-core/comments/leaf-text';
import {
- commentLeafText,
incrementJsxActionAborted,
incrementJsxAutoConvertFailed,
incrementJsxAutoConvertSucceeded,
@@ -17,7 +17,7 @@ import {
incrementJsxStuckCopyFailed,
incrementJsxStuckDeleteFailed,
type JsxNodeAction,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/metrics/parse-health';
import { Trans, useLingui } from '@lingui/react/macro';
import type { NodeViewProps } from '@tiptap/core';
import { NodeViewContent, NodeViewWrapper } from '@tiptap/react';
diff --git a/packages/app/src/editor/extensions/JsxInlineView.tsx b/packages/app/src/editor/extensions/JsxInlineView.tsx
index 37ab97e60..17cacda68 100644
--- a/packages/app/src/editor/extensions/JsxInlineView.tsx
+++ b/packages/app/src/editor/extensions/JsxInlineView.tsx
@@ -1,4 +1,4 @@
-import { incrementJsxRenderFailure } from '@inkeep/open-knowledge-core';
+import { incrementJsxRenderFailure } from '@inkeep/open-knowledge-core/metrics/parse-health';
import { Trans } from '@lingui/react/macro';
import type { NodeViewProps } from '@tiptap/core';
import { NodeSelection, TextSelection } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/extensions/MathInlineView.tsx b/packages/app/src/editor/extensions/MathInlineView.tsx
index e487cb213..c5f582048 100644
--- a/packages/app/src/editor/extensions/MathInlineView.tsx
+++ b/packages/app/src/editor/extensions/MathInlineView.tsx
@@ -1,4 +1,4 @@
-import { incrementJsxRenderFailure } from '@inkeep/open-knowledge-core';
+import { incrementJsxRenderFailure } from '@inkeep/open-knowledge-core/metrics/parse-health';
import { Trans } from '@lingui/react/macro';
import type { NodeViewProps } from '@tiptap/core';
import { NodeSelection, TextSelection } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/extensions/WikiLinkPropPanel.tsx b/packages/app/src/editor/extensions/WikiLinkPropPanel.tsx
index dc45fab32..786450676 100644
--- a/packages/app/src/editor/extensions/WikiLinkPropPanel.tsx
+++ b/packages/app/src/editor/extensions/WikiLinkPropPanel.tsx
@@ -1,8 +1,8 @@
import {
getWikiLinkText,
normalizeNullableString,
- resolveWikiLinkTarget,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/extensions/wiki-link';
+import { resolveWikiLinkTarget } from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
import { Trans, useLingui } from '@lingui/react/macro';
import type { Editor } from '@tiptap/core';
import { posToDOMRect } from '@tiptap/core';
diff --git a/packages/app/src/editor/extensions/bare-html-image-decoration.tsx b/packages/app/src/editor/extensions/bare-html-image-decoration.tsx
index edbd5a051..f6402876f 100644
--- a/packages/app/src/editor/extensions/bare-html-image-decoration.tsx
+++ b/packages/app/src/editor/extensions/bare-html-image-decoration.tsx
@@ -1,4 +1,5 @@
-import { normalizeDocRelativeAssetUrl, resolveAssetProjectPath } from '@inkeep/open-knowledge-core';
+import { normalizeDocRelativeAssetUrl } from '@inkeep/open-knowledge-core/markdown/resolve-image-url';
+import { resolveAssetProjectPath } from '@inkeep/open-knowledge-core/utils/link-targets';
import { type Editor, Extension } from '@tiptap/core';
import type { Node as ProseMirrorNode } from '@tiptap/pm/model';
import { Plugin, PluginKey } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/extensions/code-block.ts b/packages/app/src/editor/extensions/code-block.ts
index b57a0a902..b823c5a52 100644
--- a/packages/app/src/editor/extensions/code-block.ts
+++ b/packages/app/src/editor/extensions/code-block.ts
@@ -1,4 +1,4 @@
-import { CodeBlockFidelity as BaseCodeBlockFidelity } from '@inkeep/open-knowledge-core';
+import { CodeBlockFidelity as BaseCodeBlockFidelity } from '@inkeep/open-knowledge-core/extensions/code-block-fidelity';
import { textblockTypeInputRule } from '@tiptap/core';
import { ReactNodeViewRenderer } from '@tiptap/react';
import gherkinGrammar from 'highlight.js/lib/languages/gherkin';
diff --git a/packages/app/src/editor/extensions/drag-handle.ts b/packages/app/src/editor/extensions/drag-handle.ts
index 83cb1eecb..da5aa3593 100644
--- a/packages/app/src/editor/extensions/drag-handle.ts
+++ b/packages/app/src/editor/extensions/drag-handle.ts
@@ -1,5 +1,5 @@
import { offset } from '@floating-ui/dom';
-import { incrementBlockGripClickSelectFailed } from '@inkeep/open-knowledge-core';
+import { incrementBlockGripClickSelectFailed } from '@inkeep/open-knowledge-core/metrics/parse-health';
import { t } from '@lingui/core/macro';
import { type Editor, Extension } from '@tiptap/core';
import { DragHandlePlugin, normalizeNestedOptions } from '@tiptap/extension-drag-handle';
diff --git a/packages/app/src/editor/extensions/image-inline-zoom.ts b/packages/app/src/editor/extensions/image-inline-zoom.ts
index 3c6f9ac68..9d7b55f81 100644
--- a/packages/app/src/editor/extensions/image-inline-zoom.ts
+++ b/packages/app/src/editor/extensions/image-inline-zoom.ts
@@ -1,4 +1,4 @@
-import { ImageSrcFidelity } from '@inkeep/open-knowledge-core';
+import { ImageSrcFidelity } from '@inkeep/open-knowledge-core/extensions/image-src-fidelity';
import { ReactNodeViewRenderer } from '@tiptap/react';
import { ImageInlineZoomView } from './ImageInlineZoomView';
diff --git a/packages/app/src/editor/extensions/image-reference.ts b/packages/app/src/editor/extensions/image-reference.ts
index 28cd2ede8..53eb2888b 100644
--- a/packages/app/src/editor/extensions/image-reference.ts
+++ b/packages/app/src/editor/extensions/image-reference.ts
@@ -1,4 +1,4 @@
-import { ImageReferenceFidelity } from '@inkeep/open-knowledge-core';
+import { ImageReferenceFidelity } from '@inkeep/open-knowledge-core/extensions/image-reference-fidelity';
import { ReactNodeViewRenderer } from '@tiptap/react';
import { ImageReferenceView } from './ImageReferenceView';
diff --git a/packages/app/src/editor/extensions/internal-link.ts b/packages/app/src/editor/extensions/internal-link.ts
index 678b0942c..562d3cd32 100644
--- a/packages/app/src/editor/extensions/internal-link.ts
+++ b/packages/app/src/editor/extensions/internal-link.ts
@@ -1,11 +1,12 @@
/** Schema unchanged (precedent #9 add-only). */
+
+import { LinkFidelity } from '@inkeep/open-knowledge-core/extensions/link-fidelity';
import {
assertNeverLinkTarget,
classifyMarkdownHref,
extractAssetExtension,
- LinkFidelity,
resolveAssetProjectPath,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/link-targets';
import { type Editor, mergeAttributes } from '@tiptap/core';
import { createElement } from 'react';
import { openExternalUrl } from '@/lib/external-link';
diff --git a/packages/app/src/editor/extensions/jsx-component.ts b/packages/app/src/editor/extensions/jsx-component.ts
index 329743fd5..315114694 100644
--- a/packages/app/src/editor/extensions/jsx-component.ts
+++ b/packages/app/src/editor/extensions/jsx-component.ts
@@ -1,4 +1,4 @@
-import { JsxComponent as BaseJsxComponent } from '@inkeep/open-knowledge-core';
+import { JsxComponent as BaseJsxComponent } from '@inkeep/open-knowledge-core/extensions/jsx-component';
import { ReactNodeViewRenderer } from '@tiptap/react';
import { JsxComponentView } from './JsxComponentView';
diff --git a/packages/app/src/editor/extensions/jsx-inline.ts b/packages/app/src/editor/extensions/jsx-inline.ts
index 55d3d4dc4..ff5b711d7 100644
--- a/packages/app/src/editor/extensions/jsx-inline.ts
+++ b/packages/app/src/editor/extensions/jsx-inline.ts
@@ -1,4 +1,4 @@
-import { JsxInline as BaseJsxInline } from '@inkeep/open-knowledge-core';
+import { JsxInline as BaseJsxInline } from '@inkeep/open-knowledge-core/extensions/jsx-inline';
import { NodeSelection, Plugin } from '@tiptap/pm/state';
import { ReactNodeViewRenderer } from '@tiptap/react';
import { JsxInlineView } from './JsxInlineView';
diff --git a/packages/app/src/editor/extensions/link-resolution.ts b/packages/app/src/editor/extensions/link-resolution.ts
index cc2271e8f..c6b9f4953 100644
--- a/packages/app/src/editor/extensions/link-resolution.ts
+++ b/packages/app/src/editor/extensions/link-resolution.ts
@@ -1,4 +1,7 @@
-import { classifyMarkdownHref, resolveAssetProjectPath } from '@inkeep/open-knowledge-core';
+import {
+ classifyMarkdownHref,
+ resolveAssetProjectPath,
+} from '@inkeep/open-knowledge-core/utils/link-targets';
import { resolveLinkTargetIntent } from '../../components/link-target-intent';
import { isLinkValidationVisible } from '../link-validation-policy';
import type { PageListCacheSnapshot } from '../page-list-cache';
diff --git a/packages/app/src/editor/extensions/markdown-lint-decorations.ts b/packages/app/src/editor/extensions/markdown-lint-decorations.ts
index eca7d7b42..d91361d36 100644
--- a/packages/app/src/editor/extensions/markdown-lint-decorations.ts
+++ b/packages/app/src/editor/extensions/markdown-lint-decorations.ts
@@ -1,13 +1,13 @@
import { autoUpdate, computePosition, flip, offset, shift, size } from '@floating-ui/dom';
+import { sharedExtensions as coreExtensions } from '@inkeep/open-knowledge-core/extensions/shared';
+import { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
import {
- sharedExtensions as coreExtensions,
isFrontmatterScoped,
type LintDiagnostic,
type LinterConfig,
type LintTextEdit,
lintDocument,
- MarkdownManager,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { t } from '@lingui/core/macro';
import { type Editor, Extension } from '@tiptap/core';
import type { Node as PmNode } from '@tiptap/pm/model';
diff --git a/packages/app/src/editor/extensions/math-inline.ts b/packages/app/src/editor/extensions/math-inline.ts
index 55ee0665f..6e9747839 100644
--- a/packages/app/src/editor/extensions/math-inline.ts
+++ b/packages/app/src/editor/extensions/math-inline.ts
@@ -1,4 +1,4 @@
-import { MathInline as BaseMathInline } from '@inkeep/open-knowledge-core';
+import { MathInline as BaseMathInline } from '@inkeep/open-knowledge-core/extensions/math-inline';
import { ReactNodeViewRenderer } from '@tiptap/react';
import { MathInlineView } from './MathInlineView';
diff --git a/packages/app/src/editor/extensions/media-render-props.ts b/packages/app/src/editor/extensions/media-render-props.ts
index d2039f620..7b665b0ba 100644
--- a/packages/app/src/editor/extensions/media-render-props.ts
+++ b/packages/app/src/editor/extensions/media-render-props.ts
@@ -1,4 +1,4 @@
-import { normalizeDocRelativeAssetUrl } from '@inkeep/open-knowledge-core';
+import { normalizeDocRelativeAssetUrl } from '@inkeep/open-knowledge-core/markdown/resolve-image-url';
export const DOC_RELATIVE_SRC_COMPONENTS = new Set([
'img',
diff --git a/packages/app/src/editor/extensions/preview-iframe-header.ts b/packages/app/src/editor/extensions/preview-iframe-header.ts
index 9cde8f808..019e77a05 100644
--- a/packages/app/src/editor/extensions/preview-iframe-header.ts
+++ b/packages/app/src/editor/extensions/preview-iframe-header.ts
@@ -1,4 +1,4 @@
-import { PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core';
+import { PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core/constants/preview-theme-tokens';
import {
domPreviewTokenEnv,
type PreviewTokenEnv,
diff --git a/packages/app/src/editor/extensions/preview-live-tokens.ts b/packages/app/src/editor/extensions/preview-live-tokens.ts
index d17e155d8..3e1fbb7cd 100644
--- a/packages/app/src/editor/extensions/preview-live-tokens.ts
+++ b/packages/app/src/editor/extensions/preview-live-tokens.ts
@@ -1,4 +1,4 @@
-import { PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core';
+import { PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core/constants/preview-theme-tokens';
import { THEME_COLOR_PROPERTIES } from '@/lib/theme-color-properties';
import { themeColorTransitionsActive } from '@/lib/theme-color-transitions';
import { COLOR_THEME_ATTRIBUTE } from '@/lib/use-apply-config-color-theme';
diff --git a/packages/app/src/editor/extensions/raw-mdx-fallback.ts b/packages/app/src/editor/extensions/raw-mdx-fallback.ts
index 4564bb158..7d4d4731e 100644
--- a/packages/app/src/editor/extensions/raw-mdx-fallback.ts
+++ b/packages/app/src/editor/extensions/raw-mdx-fallback.ts
@@ -2,7 +2,7 @@
* Direct PM dispatch pattern (Precedent #28), NOT y-codemirror.next. The RawMdxFallbackView's
* selectionUpdate effect (Precedent #31) then forwards focus + caret into the nested CM.
*/
-import { RawMdxFallback as BaseRawMdxFallback } from '@inkeep/open-knowledge-core';
+import { RawMdxFallback as BaseRawMdxFallback } from '@inkeep/open-knowledge-core/extensions/raw-mdx-fallback';
import type { Editor } from '@tiptap/core';
import type { EditorState } from '@tiptap/pm/state';
import { Selection } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/extensions/shared.ts b/packages/app/src/editor/extensions/shared.ts
index 52e3d785e..1d28a6e24 100644
--- a/packages/app/src/editor/extensions/shared.ts
+++ b/packages/app/src/editor/extensions/shared.ts
@@ -1,4 +1,4 @@
-import { sharedExtensions as coreExtensions } from '@inkeep/open-knowledge-core';
+import { sharedExtensions as coreExtensions } from '@inkeep/open-knowledge-core/extensions/shared';
import { Extension } from '@tiptap/core';
import FileHandler from '@tiptap/extension-file-handler';
import { KeyboardNav } from '../block-ux/keyboard-nav';
diff --git a/packages/app/src/editor/extensions/skill-path-links.ts b/packages/app/src/editor/extensions/skill-path-links.ts
index 974cd1a39..5fb83cb55 100644
--- a/packages/app/src/editor/extensions/skill-path-links.ts
+++ b/packages/app/src/editor/extensions/skill-path-links.ts
@@ -1,11 +1,10 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
import {
- isSkillRefCandidate,
parseManagedArtifactName,
parseProjectSkillBundleDoc,
- RESERVED_PROJECT_SKILL_NAME,
- SKILL_REF_RE,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import { RESERVED_PROJECT_SKILL_NAME } from '@inkeep/open-knowledge-core/constants/editors';
+import { isSkillRefCandidate, SKILL_REF_RE } from '@inkeep/open-knowledge-core/constants/skills';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Extension } from '@tiptap/core';
import type { Node as PMNode } from '@tiptap/pm/model';
import { Plugin, PluginKey } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/extensions/tag-view.ts b/packages/app/src/editor/extensions/tag-view.ts
index 81758b013..2e62284c7 100644
--- a/packages/app/src/editor/extensions/tag-view.ts
+++ b/packages/app/src/editor/extensions/tag-view.ts
@@ -1,4 +1,4 @@
-import { Tag as BaseTag } from '@inkeep/open-knowledge-core';
+import { Tag as BaseTag } from '@inkeep/open-knowledge-core/extensions/tag';
import { ReactNodeViewRenderer } from '@tiptap/react';
import { TagView } from '../components/TagView.tsx';
import { configureTagSuggestion, tagSuggestionKey } from './tag-suggestion.ts';
diff --git a/packages/app/src/editor/extensions/use-headings.ts b/packages/app/src/editor/extensions/use-headings.ts
index e9c8ef4c2..9a0398365 100644
--- a/packages/app/src/editor/extensions/use-headings.ts
+++ b/packages/app/src/editor/extensions/use-headings.ts
@@ -1,4 +1,4 @@
-import type { HeadingEntry } from '@inkeep/open-knowledge-core';
+import type { HeadingEntry } from '@inkeep/open-knowledge-core/utils/slug';
import { useEffect, useState } from 'react';
import { fetchHeadings } from './wiki-link-suggestion';
diff --git a/packages/app/src/editor/extensions/wiki-link-embed.ts b/packages/app/src/editor/extensions/wiki-link-embed.ts
index 09ebf4793..685556334 100644
--- a/packages/app/src/editor/extensions/wiki-link-embed.ts
+++ b/packages/app/src/editor/extensions/wiki-link-embed.ts
@@ -1,9 +1,9 @@
+import { IMAGE_EXTENSIONS } from '@inkeep/open-knowledge-core/constants/upload';
+import { WikiLinkEmbed as BaseWikiLinkEmbed } from '@inkeep/open-knowledge-core/extensions/wiki-link-embed';
import {
- WikiLinkEmbed as BaseWikiLinkEmbed,
extractAssetExtension,
- IMAGE_EXTENSIONS,
resolveAssetProjectPath,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/link-targets';
import { ReactRenderer } from '@tiptap/react';
import { getInteractionLayer } from '../interaction-layer-host';
import { activateAssetLink } from '../internal-link-helpers';
diff --git a/packages/app/src/editor/extensions/wiki-link-helpers.ts b/packages/app/src/editor/extensions/wiki-link-helpers.ts
index 68902b509..008a08dc9 100644
--- a/packages/app/src/editor/extensions/wiki-link-helpers.ts
+++ b/packages/app/src/editor/extensions/wiki-link-helpers.ts
@@ -1,11 +1,10 @@
+import { getHeadingSlug, toWikiLinkSlug } from '@inkeep/open-knowledge-core/utils/slug';
import {
- getHeadingSlug,
getWikiLinkResolutionCandidates,
isResolvedWikiLinkTarget,
resolveWikiLinkAssetTarget,
resolveWikiLinkTargetDocName,
- toWikiLinkSlug,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
export {
getHeadingSlug,
diff --git a/packages/app/src/editor/extensions/wiki-link-suggestion.ts b/packages/app/src/editor/extensions/wiki-link-suggestion.ts
index 6089bf657..f87721450 100644
--- a/packages/app/src/editor/extensions/wiki-link-suggestion.ts
+++ b/packages/app/src/editor/extensions/wiki-link-suggestion.ts
@@ -1,18 +1,20 @@
import {
BacklinksSuccessSchema,
- createWorkspaceSearchCorpus,
- createWorkspaceSearchDocument,
ForwardLinksSuccessSchema,
- type HeadingEntry,
- isHiddenDocName,
- MAX_WORKSPACE_SEARCH_LIMIT,
PageHeadingsSuccessSchema,
PagesSuccessSchema,
ProblemDetailsSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
+import {
+ createWorkspaceSearchCorpus,
+ createWorkspaceSearchDocument,
+ MAX_WORKSPACE_SEARCH_LIMIT,
searchWorkspaceCorpus,
type WorkspaceSearchCorpus,
type WorkspaceSearchKind,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/search/workspace-search';
+import { isHiddenDocName } from '@inkeep/open-knowledge-core/util/doc-name';
+import type { HeadingEntry } from '@inkeep/open-knowledge-core/utils/slug';
import type { Editor } from '@tiptap/core';
import type { ResolvedPos } from '@tiptap/pm/model';
import { PluginKey } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/extensions/wiki-link.ts b/packages/app/src/editor/extensions/wiki-link.ts
index 8ce9298b1..0a8d96861 100644
--- a/packages/app/src/editor/extensions/wiki-link.ts
+++ b/packages/app/src/editor/extensions/wiki-link.ts
@@ -1,4 +1,5 @@
-import { WikiLink as BaseWikiLink, resolveWikiLinkTarget } from '@inkeep/open-knowledge-core';
+import { WikiLink as BaseWikiLink } from '@inkeep/open-knowledge-core/extensions/wiki-link';
+import { resolveWikiLinkTarget } from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
import { createElement } from 'react';
import { openExternalUrl } from '@/lib/external-link';
import { resolveLinkTargetIntent } from '../../components/link-target-intent';
diff --git a/packages/app/src/editor/gfm-autolink-plugin.ts b/packages/app/src/editor/gfm-autolink-plugin.ts
index cb0ebed50..1faa26961 100644
--- a/packages/app/src/editor/gfm-autolink-plugin.ts
+++ b/packages/app/src/editor/gfm-autolink-plugin.ts
@@ -1,4 +1,4 @@
-import type { LinkStyle } from '@inkeep/open-knowledge-core';
+import type { LinkStyle } from '@inkeep/open-knowledge-core/extensions/link-fidelity';
import {
combineTransactionSteps,
Extension,
diff --git a/packages/app/src/editor/gfm-link-detector.ts b/packages/app/src/editor/gfm-link-detector.ts
index 8c77c437b..0a0226a40 100644
--- a/packages/app/src/editor/gfm-link-detector.ts
+++ b/packages/app/src/editor/gfm-link-detector.ts
@@ -1,4 +1,4 @@
-import { SAFE_URL_SCHEMES } from '@inkeep/open-knowledge-core';
+import { SAFE_URL_SCHEMES } from '@inkeep/open-knowledge-core/markdown/safe-url';
export type GfmLinkToken = {
href: string;
diff --git a/packages/app/src/editor/image-upload/index.ts b/packages/app/src/editor/image-upload/index.ts
index 1793e37b9..4557218e2 100644
--- a/packages/app/src/editor/image-upload/index.ts
+++ b/packages/app/src/editor/image-upload/index.ts
@@ -2,17 +2,19 @@ import {
AUDIO_EXTENSIONS,
DEFAULT_DEDUP_UI,
DEFAULT_EMIT_FORMAT,
- extensionOf,
FILE_ATTACHMENT_EXTENSIONS,
- formatFileSize,
IMAGE_EXTENSIONS,
+ VIDEO_EXTENSIONS,
+ WIKI_EMBED_EXTENSIONS,
+} from '@inkeep/open-knowledge-core/constants/upload';
+import {
ProblemDetailsSchema,
- randomUUID,
type UploadAssetSuccess,
UploadAssetSuccessSchema,
- VIDEO_EXTENSIONS,
- WIKI_EMBED_EXTENSIONS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
+import { extensionOf } from '@inkeep/open-knowledge-core/utils/extension';
+import { formatFileSize } from '@inkeep/open-knowledge-core/utils/file-size';
+import { randomUUID } from '@inkeep/open-knowledge-core/utils/random-uuid';
import { t } from '@lingui/core/macro';
import type { Editor } from '@tiptap/core';
import { NodeSelection, Plugin, PluginKey } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/image-upload/upload-file.ts b/packages/app/src/editor/image-upload/upload-file.ts
index b4fa18287..25b1f3f43 100644
--- a/packages/app/src/editor/image-upload/upload-file.ts
+++ b/packages/app/src/editor/image-upload/upload-file.ts
@@ -1,4 +1,7 @@
-import { ProblemDetailsSchema, UploadAssetSuccessSchema } from '@inkeep/open-knowledge-core';
+import {
+ ProblemDetailsSchema,
+ UploadAssetSuccessSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { HttpResponseParseError } from '../http-client.ts';
import { getCurrentDocName } from './current-doc-name.ts';
import {
diff --git a/packages/app/src/editor/inline-link-input-rule.ts b/packages/app/src/editor/inline-link-input-rule.ts
index d14738d16..7a40f5fb0 100644
--- a/packages/app/src/editor/inline-link-input-rule.ts
+++ b/packages/app/src/editor/inline-link-input-rule.ts
@@ -1,4 +1,4 @@
-import { isAllowedLinkUri } from '@inkeep/open-knowledge-core';
+import { isAllowedLinkUri } from '@inkeep/open-knowledge-core/extensions/link-fidelity';
import { Extension, InputRule } from '@tiptap/core';
import type { EditorView } from '@tiptap/pm/view';
import { dispatchAsOwnUndoStep } from './undo-isolation';
diff --git a/packages/app/src/editor/internal-link-helpers.ts b/packages/app/src/editor/internal-link-helpers.ts
index 9a5b2a8ed..397a0b6bb 100644
--- a/packages/app/src/editor/internal-link-helpers.ts
+++ b/packages/app/src/editor/internal-link-helpers.ts
@@ -1,10 +1,10 @@
+import { mediaKindForSidebarAssetExtension } from '@inkeep/open-knowledge-core/constants/upload';
import {
buildRelativeMarkdownHref,
type ClassifiedLinkTarget,
classifyMarkdownHref,
type DocLinkTarget,
- mediaKindForSidebarAssetExtension,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/link-targets';
import { hashFromAssetPath, hashFromDocName } from '../lib/doc-hash';
import { openExternalUrl } from '../lib/external-link';
import { dispatchAssetClick } from './asset-dispatch';
diff --git a/packages/app/src/editor/is-system-doc.ts b/packages/app/src/editor/is-system-doc.ts
index a99081acd..5f48ac25c 100644
--- a/packages/app/src/editor/is-system-doc.ts
+++ b/packages/app/src/editor/is-system-doc.ts
@@ -1,4 +1,4 @@
-import { CONFIG_DOC_NAMES, SYSTEM_DOC_NAME } from '@inkeep/open-knowledge-core';
+import { CONFIG_DOC_NAMES, SYSTEM_DOC_NAME } from '@inkeep/open-knowledge-core/constants/cc1';
export function isSystemDoc(docName: string): boolean {
return docName === SYSTEM_DOC_NAME;
diff --git a/packages/app/src/editor/link-path-suggestions.tsx b/packages/app/src/editor/link-path-suggestions.tsx
index c5b2c999c..5a1cf2466 100644
--- a/packages/app/src/editor/link-path-suggestions.tsx
+++ b/packages/app/src/editor/link-path-suggestions.tsx
@@ -1,5 +1,5 @@
import { autoUpdate, computePosition, flip, offset, shift, size } from '@floating-ui/dom';
-import { isExternalHref } from '@inkeep/open-knowledge-core';
+import { isExternalHref } from '@inkeep/open-knowledge-core/utils/link-targets';
import { useLingui } from '@lingui/react/macro';
import {
type ComponentProps,
diff --git a/packages/app/src/editor/link-preview/ExternalLinkPreviewCard.tsx b/packages/app/src/editor/link-preview/ExternalLinkPreviewCard.tsx
index 96e3b92dd..fb2f858a6 100644
--- a/packages/app/src/editor/link-preview/ExternalLinkPreviewCard.tsx
+++ b/packages/app/src/editor/link-preview/ExternalLinkPreviewCard.tsx
@@ -1,4 +1,4 @@
-import type { LinkPreviewMetadata } from '@inkeep/open-knowledge-core';
+import type { LinkPreviewMetadata } from '@inkeep/open-knowledge-core/schemas/api';
export function ExternalLinkPreviewCard({ metadata }: { metadata: LinkPreviewMetadata }) {
const faviconSrc = metadata.faviconDataUri?.startsWith('data:image/')
diff --git a/packages/app/src/editor/link-preview/doc-excerpt.ts b/packages/app/src/editor/link-preview/doc-excerpt.ts
index 0de8bc717..ed697280b 100644
--- a/packages/app/src/editor/link-preview/doc-excerpt.ts
+++ b/packages/app/src/editor/link-preview/doc-excerpt.ts
@@ -1,9 +1,6 @@
-import {
- createCodeFenceTracker,
- getHeadingSlug,
- stripFrontmatter,
- toWikiLinkSlug,
-} from '@inkeep/open-knowledge-core';
+import { stripFrontmatter } from '@inkeep/open-knowledge-core/extensions/frontmatter';
+import { createCodeFenceTracker } from '@inkeep/open-knowledge-core/utils/code-fence-tracker';
+import { getHeadingSlug, toWikiLinkSlug } from '@inkeep/open-knowledge-core/utils/slug';
export interface DocExcerptOptions {
anchor?: string | null;
diff --git a/packages/app/src/editor/link-preview/external-link-preview.ts b/packages/app/src/editor/link-preview/external-link-preview.ts
index c7456b69d..106fcc31f 100644
--- a/packages/app/src/editor/link-preview/external-link-preview.ts
+++ b/packages/app/src/editor/link-preview/external-link-preview.ts
@@ -1,4 +1,7 @@
-import { type LinkPreviewMetadata, LinkPreviewResponseSchema } from '@inkeep/open-knowledge-core';
+import {
+ type LinkPreviewMetadata,
+ LinkPreviewResponseSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
export const SUCCESS_CACHE_MAX_ENTRIES = 128;
diff --git a/packages/app/src/editor/link-preview/internal-doc-preview.ts b/packages/app/src/editor/link-preview/internal-doc-preview.ts
index 1f82ddc39..480d80209 100644
--- a/packages/app/src/editor/link-preview/internal-doc-preview.ts
+++ b/packages/app/src/editor/link-preview/internal-doc-preview.ts
@@ -1,10 +1,12 @@
import {
- BacklinkCountsSuccessSchema,
- DocumentReadSuccessSchema,
- extractFrontmatterTags,
stripFrontmatter,
unwrapFrontmatterFences,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/extensions/frontmatter';
+import { extractFrontmatterTags } from '@inkeep/open-knowledge-core/frontmatter/tags';
+import {
+ BacklinkCountsSuccessSchema,
+ DocumentReadSuccessSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { extractDocExcerpt } from './doc-excerpt.ts';
export interface InternalDocPreview {
diff --git a/packages/app/src/editor/link-preview/use-external-link-preview.ts b/packages/app/src/editor/link-preview/use-external-link-preview.ts
index 37e735a9b..5e1e90047 100644
--- a/packages/app/src/editor/link-preview/use-external-link-preview.ts
+++ b/packages/app/src/editor/link-preview/use-external-link-preview.ts
@@ -1,4 +1,4 @@
-import type { LinkPreviewMetadata } from '@inkeep/open-knowledge-core';
+import type { LinkPreviewMetadata } from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useState } from 'react';
import { loadLinkPreview } from './external-link-preview.ts';
diff --git a/packages/app/src/editor/lint-config-client.ts b/packages/app/src/editor/lint-config-client.ts
index 199cddbd2..66fbc61b9 100644
--- a/packages/app/src/editor/lint-config-client.ts
+++ b/packages/app/src/editor/lint-config-client.ts
@@ -8,7 +8,7 @@ import {
LintFixResultSchema,
type MarkdownlintRuleWriteValue,
type SchemaParentPathSegment,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { useEffect, useState } from 'react';
const LINT_CONFIG_CHANGED_EVENT = 'open-knowledge:lint-config-changed';
diff --git a/packages/app/src/editor/localized-validation-message.ts b/packages/app/src/editor/localized-validation-message.ts
index 798c0a24b..d5d3e1466 100644
--- a/packages/app/src/editor/localized-validation-message.ts
+++ b/packages/app/src/editor/localized-validation-message.ts
@@ -1,4 +1,4 @@
-import type { ValidationDocResult } from '@inkeep/open-knowledge-core';
+import type { ValidationDocResult } from '@inkeep/open-knowledge-core/markdown/lint';
import { t } from '@lingui/core/macro';
type Diagnostic = ValidationDocResult['diagnostics'][number];
diff --git a/packages/app/src/editor/mode-switch-position-resolver.ts b/packages/app/src/editor/mode-switch-position-resolver.ts
index 49b8054d4..5231f0526 100644
--- a/packages/app/src/editor/mode-switch-position-resolver.ts
+++ b/packages/app/src/editor/mode-switch-position-resolver.ts
@@ -1,4 +1,4 @@
-import type { MarkdownManager } from '@inkeep/open-knowledge-core';
+import type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
import type { Node as PmNode } from '@tiptap/pm/model';
import {
blockIndexForLine,
diff --git a/packages/app/src/editor/observers.ts b/packages/app/src/editor/observers.ts
index c976ba054..317de91c9 100644
--- a/packages/app/src/editor/observers.ts
+++ b/packages/app/src/editor/observers.ts
@@ -5,7 +5,7 @@
*/
import type { LocalTransactionOrigin } from '@hocuspocus/server';
-import type { MarkdownManager } from '@inkeep/open-knowledge-core';
+import type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
import type { Schema } from '@tiptap/pm/model';
import type * as Y from 'yjs';
diff --git a/packages/app/src/editor/page-list-cache.ts b/packages/app/src/editor/page-list-cache.ts
index f94dca1fa..468b6aa6d 100644
--- a/packages/app/src/editor/page-list-cache.ts
+++ b/packages/app/src/editor/page-list-cache.ts
@@ -4,7 +4,10 @@
* DEV-gated test-hook convention — precedent #20(b)).
*/
-import { buildPagesByBasenameIndex, buildPagesBySlugIndex } from '@inkeep/open-knowledge-core';
+import {
+ buildPagesByBasenameIndex,
+ buildPagesBySlugIndex,
+} from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
export { buildPagesByBasenameIndex, buildPagesBySlugIndex };
diff --git a/packages/app/src/editor/plugins/asset-context-menu.ts b/packages/app/src/editor/plugins/asset-context-menu.ts
index 5cfc2b46d..896e04c52 100644
--- a/packages/app/src/editor/plugins/asset-context-menu.ts
+++ b/packages/app/src/editor/plugins/asset-context-menu.ts
@@ -1,4 +1,7 @@
-import { classifyMarkdownHref, resolveAssetProjectPath } from '@inkeep/open-knowledge-core';
+import {
+ classifyMarkdownHref,
+ resolveAssetProjectPath,
+} from '@inkeep/open-knowledge-core/utils/link-targets';
import { Plugin, PluginKey } from '@tiptap/pm/state';
import type { EditorView } from '@tiptap/pm/view';
diff --git a/packages/app/src/editor/plugins/flash-shared.ts b/packages/app/src/editor/plugins/flash-shared.ts
index fab9b5118..6489339cb 100644
--- a/packages/app/src/editor/plugins/flash-shared.ts
+++ b/packages/app/src/editor/plugins/flash-shared.ts
@@ -3,4 +3,4 @@ export {
FLASH_DEBOUNCE_MS,
FLASH_DURATION_MS,
hasNewEntries,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/activity';
diff --git a/packages/app/src/editor/plugins/wiki-link-source.ts b/packages/app/src/editor/plugins/wiki-link-source.ts
index f04dfc2e7..9233ed78d 100644
--- a/packages/app/src/editor/plugins/wiki-link-source.ts
+++ b/packages/app/src/editor/plugins/wiki-link-source.ts
@@ -8,16 +8,16 @@ import {
ViewPlugin,
type ViewUpdate,
} from '@codemirror/view';
+import type { HeadingEntry } from '@inkeep/open-knowledge-core/utils/slug';
import {
buildPagesByBasenameIndex,
buildPagesBySlugIndex,
buildWikiLinkAssetTargetKeys,
- type HeadingEntry,
isResolvedWikiLinkTarget,
resolveWikiLinkTarget,
resolveWikiLinkTargetDocName,
type WikiLinkLookupIndex,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
import { openExternalUrl } from '@/lib/external-link';
import { hashFromAssetPath, hashFromDocName } from '../../lib/doc-hash';
import { resolveWikiLinkAssetTarget, toWikiLinkSlug } from '../extensions/wiki-link-helpers';
diff --git a/packages/app/src/editor/preview-tab-promotion.ts b/packages/app/src/editor/preview-tab-promotion.ts
index e2cd7f758..375644490 100644
--- a/packages/app/src/editor/preview-tab-promotion.ts
+++ b/packages/app/src/editor/preview-tab-promotion.ts
@@ -1,6 +1,6 @@
import { Transaction as CMTransaction } from '@codemirror/state';
import type { ViewUpdate } from '@codemirror/view';
-import type { FrontmatterBinding } from '@inkeep/open-knowledge-core';
+import type { FrontmatterBinding } from '@inkeep/open-knowledge-core/bridge';
import type { Transaction as PMTransaction } from '@tiptap/pm/state';
import { docTabId } from './editor-tabs';
import { isUserIntentOrigin } from './extensions/autonomous-fragment-edit';
diff --git a/packages/app/src/editor/provider-pool.ts b/packages/app/src/editor/provider-pool.ts
index d5a66199a..46c5325f3 100644
--- a/packages/app/src/editor/provider-pool.ts
+++ b/packages/app/src/editor/provider-pool.ts
@@ -2,12 +2,12 @@ import { HocuspocusProvider } from '@hocuspocus/provider';
import {
addsBlankLines,
composeWithDerivedBody,
- LINEAGE_EPOCH_KEY,
- MarkdownManager,
normalizeBridge,
- randomUUID,
- stripFrontmatter,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/bridge';
+import { LINEAGE_EPOCH_KEY } from '@inkeep/open-knowledge-core/constants/doc-lifecycle';
+import { stripFrontmatter } from '@inkeep/open-knowledge-core/extensions/frontmatter';
+import { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
+import { randomUUID } from '@inkeep/open-knowledge-core/utils/random-uuid';
import type { HocuspocusAuthRejectionReason } from '@inkeep/open-knowledge-server';
import { getSchema } from '@tiptap/core';
import { yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
diff --git a/packages/app/src/editor/registry/file-icons.ts b/packages/app/src/editor/registry/file-icons.ts
index 1207d878a..ba9c26b3c 100644
--- a/packages/app/src/editor/registry/file-icons.ts
+++ b/packages/app/src/editor/registry/file-icons.ts
@@ -1,4 +1,4 @@
-import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core';
+import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core/constants/upload';
import { FileText, Film, FolderOpen, Image, type LucideIcon, Volume2 } from 'lucide-react';
export interface FileIconDescriptor {
diff --git a/packages/app/src/editor/registry/index.ts b/packages/app/src/editor/registry/index.ts
index f348eb135..55a3b7579 100644
--- a/packages/app/src/editor/registry/index.ts
+++ b/packages/app/src/editor/registry/index.ts
@@ -2,7 +2,8 @@
* Either path is greenfield-compatible with the precedent #9 schema-add-only contract; the choice
* depends on whether the extension surface lands as a host-API (b) or in-product (a).
*/
-import { createRegistry, type JsxComponentMeta, type PropDef } from '@inkeep/open-knowledge-core';
+import { createRegistry } from '@inkeep/open-knowledge-core/registry';
+import type { JsxComponentMeta, PropDef } from '@inkeep/open-knowledge-core/registry/types';
import { componentMap } from '../components/componentMap.tsx';
import type { JsxComponentDescriptor } from './types.ts';
diff --git a/packages/app/src/editor/registry/types.ts b/packages/app/src/editor/registry/types.ts
index 79a4dda98..e60bf908a 100644
--- a/packages/app/src/editor/registry/types.ts
+++ b/packages/app/src/editor/registry/types.ts
@@ -1,4 +1,4 @@
-import type { JsxComponentMeta } from '@inkeep/open-knowledge-core';
+import type { JsxComponentMeta } from '@inkeep/open-knowledge-core/registry/types';
interface JsxComponentDecoration {
// biome-ignore lint/suspicious/noExplicitAny: Component props are heterogeneous across 18+ built-ins; no single prop type covers all
diff --git a/packages/app/src/editor/selection-context.ts b/packages/app/src/editor/selection-context.ts
index 183e7e9e8..d0eb40b18 100644
--- a/packages/app/src/editor/selection-context.ts
+++ b/packages/app/src/editor/selection-context.ts
@@ -1,5 +1,5 @@
import type { EditorView } from '@codemirror/view';
-import type { ComposeSelection } from '@inkeep/open-knowledge-core';
+import type { ComposeSelection } from '@inkeep/open-knowledge-core/handoff';
import type { Editor } from '@tiptap/core';
import { serializeWysiwygSelection } from './edit-with-ai-selection';
import type { EditorSurface } from './selection-stats';
diff --git a/packages/app/src/editor/selection-stats.ts b/packages/app/src/editor/selection-stats.ts
index 437899974..3d4127cd6 100644
--- a/packages/app/src/editor/selection-stats.ts
+++ b/packages/app/src/editor/selection-stats.ts
@@ -1,5 +1,5 @@
import type { EditorView } from '@codemirror/view';
-import { isEditableTextDocFile } from '@inkeep/open-knowledge-core';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
import type { Editor } from '@tiptap/core';
import { computeSelectionStats, type DocumentStats } from '@/lib/document-stats';
import type { EditorModeValue } from './use-editor-mode';
diff --git a/packages/app/src/editor/slash-command/embed-starter-items.tsx b/packages/app/src/editor/slash-command/embed-starter-items.tsx
index 9f7ec3d7b..d48e1adef 100644
--- a/packages/app/src/editor/slash-command/embed-starter-items.tsx
+++ b/packages/app/src/editor/slash-command/embed-starter-items.tsx
@@ -1,4 +1,7 @@
-import { PREVIEW_EMBED_STARTERS, type PreviewEmbedStarter } from '@inkeep/open-knowledge-core';
+import {
+ PREVIEW_EMBED_STARTERS,
+ type PreviewEmbedStarter,
+} from '@inkeep/open-knowledge-core/constants/preview-embed-starters';
import { t } from '@lingui/core/macro';
import { Trans } from '@lingui/react/macro';
import { BarChart3, Code, LayoutGrid, Shapes, SlidersHorizontal } from 'lucide-react';
diff --git a/packages/app/src/editor/slash-command/items.tsx b/packages/app/src/editor/slash-command/items.tsx
index 7e44e9fc0..1db952905 100644
--- a/packages/app/src/editor/slash-command/items.tsx
+++ b/packages/app/src/editor/slash-command/items.tsx
@@ -2,7 +2,7 @@ import {
collectFootnoteIdentifiers,
findFootnoteDefinitionInsertPos,
nextFootnoteIdentifier,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/extensions/footnote-reference';
import { t } from '@lingui/core/macro';
import { Trans } from '@lingui/react/macro';
import type { EditorState } from '@tiptap/pm/state';
diff --git a/packages/app/src/editor/source-heading-lines.ts b/packages/app/src/editor/source-heading-lines.ts
index 54ecc066f..b29581bda 100644
--- a/packages/app/src/editor/source-heading-lines.ts
+++ b/packages/app/src/editor/source-heading-lines.ts
@@ -1,9 +1,7 @@
import type { Text } from '@codemirror/state';
-import {
- createCodeFenceTracker,
- FM_FENCE_LINE_RE,
- scanHeadingLine,
-} from '@inkeep/open-knowledge-core';
+import { FM_FENCE_LINE_RE } from '@inkeep/open-knowledge-core/extensions/frontmatter';
+import { createCodeFenceTracker } from '@inkeep/open-knowledge-core/utils/code-fence-tracker';
+import { scanHeadingLine } from '@inkeep/open-knowledge-core/utils/heading-scan';
export interface SourceHeadingLine {
slug: string;
diff --git a/packages/app/src/editor/source-lint/local-target-diagnostics.ts b/packages/app/src/editor/source-lint/local-target-diagnostics.ts
index 109026687..11599fcb1 100644
--- a/packages/app/src/editor/source-lint/local-target-diagnostics.ts
+++ b/packages/app/src/editor/source-lint/local-target-diagnostics.ts
@@ -2,7 +2,7 @@ import { ensureSyntaxTree } from '@codemirror/language';
import { type Diagnostic, forceLinting, linter } from '@codemirror/lint';
import { type EditorState, type Extension, StateEffect, type Text } from '@codemirror/state';
import { ViewPlugin } from '@codemirror/view';
-import type { LintPosition, ValidationDocResult } from '@inkeep/open-knowledge-core';
+import type { LintPosition, ValidationDocResult } from '@inkeep/open-knowledge-core/markdown/lint';
import {
isLinkValidationVisible,
subscribeToLinkValidationPolicy,
diff --git a/packages/app/src/editor/source-lint/markdown-lint-source.ts b/packages/app/src/editor/source-lint/markdown-lint-source.ts
index e934cda23..97f51c5c0 100644
--- a/packages/app/src/editor/source-lint/markdown-lint-source.ts
+++ b/packages/app/src/editor/source-lint/markdown-lint-source.ts
@@ -1,7 +1,11 @@
import { type Action, type Diagnostic, linter, lintGutter } from '@codemirror/lint';
import type { Extension, Text } from '@codemirror/state';
-import type { LintDiagnostic, LinterConfig, LintPosition } from '@inkeep/open-knowledge-core';
-import { lintDocument } from '@inkeep/open-knowledge-core';
+import type {
+ LintDiagnostic,
+ LinterConfig,
+ LintPosition,
+} from '@inkeep/open-knowledge-core/markdown/lint';
+import { lintDocument } from '@inkeep/open-knowledge-core/markdown/lint';
export function createMarkdownLintExtension(config: LinterConfig, docName?: string): Extension {
if (!config.enabled) return [];
diff --git a/packages/app/src/editor/source-polish/view-plugin.ts b/packages/app/src/editor/source-polish/view-plugin.ts
index f1ac3ebfb..7b2e73a18 100644
--- a/packages/app/src/editor/source-polish/view-plugin.ts
+++ b/packages/app/src/editor/source-polish/view-plugin.ts
@@ -31,7 +31,7 @@ function countLeadingIndent(text: string): number {
return indent;
}
-import { FM_FENCE_LINE_RE } from '@inkeep/open-knowledge-core';
+import { FM_FENCE_LINE_RE } from '@inkeep/open-knowledge-core/extensions/frontmatter';
function frontmatterRange(state: EditorState): { from: number; to: number } | null {
if (state.doc.lines < 2) return null;
diff --git a/packages/app/src/editor/tab-identity.ts b/packages/app/src/editor/tab-identity.ts
index 79282e92c..e83aec5a9 100644
--- a/packages/app/src/editor/tab-identity.ts
+++ b/packages/app/src/editor/tab-identity.ts
@@ -1,3 +1,3 @@
-import { randomUUID } from '@inkeep/open-knowledge-core';
+import { randomUUID } from '@inkeep/open-knowledge-core/utils/random-uuid';
export const tabSessionId: string = randomUUID();
diff --git a/packages/app/src/editor/useDocDiagnostics.ts b/packages/app/src/editor/useDocDiagnostics.ts
index 3c03ce5e6..a202c9464 100644
--- a/packages/app/src/editor/useDocDiagnostics.ts
+++ b/packages/app/src/editor/useDocDiagnostics.ts
@@ -1,10 +1,10 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
import {
- isEditableTextDocFile,
type LintDiagnostic,
type LinterConfig,
lintDocument,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { useEffect, useState } from 'react';
const RELINT_DEBOUNCE_MS = 300;
diff --git a/packages/app/src/editor/useFrontmatterDiagnostics.ts b/packages/app/src/editor/useFrontmatterDiagnostics.ts
index 9c6f79dd5..93234e7e0 100644
--- a/packages/app/src/editor/useFrontmatterDiagnostics.ts
+++ b/packages/app/src/editor/useFrontmatterDiagnostics.ts
@@ -5,7 +5,7 @@ import {
type LintDiagnostic,
type LinterConfig,
selectFrontmatterOnlyConfig,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { useDocDiagnostics } from './useDocDiagnostics.ts';
export function partitionFrontmatterProblems(diagnostics: readonly LintDiagnostic[]): {
diff --git a/packages/app/src/editor/utils/editor-strings.ts b/packages/app/src/editor/utils/editor-strings.ts
index bafcbc80d..be017c77a 100644
--- a/packages/app/src/editor/utils/editor-strings.ts
+++ b/packages/app/src/editor/utils/editor-strings.ts
@@ -1,4 +1,4 @@
-import type { PropDef } from '@inkeep/open-knowledge-core';
+import type { PropDef } from '@inkeep/open-knowledge-core/registry/types';
import { plural, t } from '@lingui/core/macro';
export function formatContainerAriaLabel(
diff --git a/packages/app/src/editor/utils/filter-assets-by-accept.ts b/packages/app/src/editor/utils/filter-assets-by-accept.ts
index 92c156ceb..66001f871 100644
--- a/packages/app/src/editor/utils/filter-assets-by-accept.ts
+++ b/packages/app/src/editor/utils/filter-assets-by-accept.ts
@@ -1,7 +1,7 @@
import {
type InlineAssetMediaKind,
mediaKindForSidebarAssetExtension,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/upload';
function mediaKindForMime(mime: string): InlineAssetMediaKind | null {
const [type] = mime.split('/');
diff --git a/packages/app/src/editor/utils/md-singleton.ts b/packages/app/src/editor/utils/md-singleton.ts
index 19b4988bb..588956aef 100644
--- a/packages/app/src/editor/utils/md-singleton.ts
+++ b/packages/app/src/editor/utils/md-singleton.ts
@@ -2,7 +2,9 @@
* Per precedent #15, the underlying remark plugins are idempotent under re-entry, so one manager
* safely serves every call.
*/
-import { MarkdownManager, sharedExtensions } from '@inkeep/open-knowledge-core';
+
+import { sharedExtensions } from '@inkeep/open-knowledge-core/extensions/shared';
+import { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
let manager: MarkdownManager | null = null;
diff --git a/packages/app/src/editor/utils/sanitize-url.ts b/packages/app/src/editor/utils/sanitize-url.ts
index 6de3b226c..ee6e5b3fb 100644
--- a/packages/app/src/editor/utils/sanitize-url.ts
+++ b/packages/app/src/editor/utils/sanitize-url.ts
@@ -1,8 +1,5 @@
-import {
- incrementJsxPropDropped,
- isRelativeUrl,
- SAFE_URL_SCHEMES,
-} from '@inkeep/open-knowledge-core';
+import { isRelativeUrl, SAFE_URL_SCHEMES } from '@inkeep/open-knowledge-core/markdown/safe-url';
+import { incrementJsxPropDropped } from '@inkeep/open-knowledge-core/metrics/parse-health';
const URL_SCHEME_ALLOWLIST = new Set(SAFE_URL_SCHEMES.map((s) => `${s}:`));
diff --git a/packages/app/src/editor/utils/validate-media-url.ts b/packages/app/src/editor/utils/validate-media-url.ts
index ca2114070..a7cfa8a16 100644
--- a/packages/app/src/editor/utils/validate-media-url.ts
+++ b/packages/app/src/editor/utils/validate-media-url.ts
@@ -1,11 +1,11 @@
import {
AUDIO_EXTENSIONS,
IMAGE_EXTENSIONS,
- isLoomUrl,
- isVimeoUrl,
- parseYouTubeUrl,
VIDEO_EXTENSIONS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/upload';
+import { isLoomUrl } from '@inkeep/open-knowledge-core/utils/loom-embed';
+import { isVimeoUrl } from '@inkeep/open-knowledge-core/utils/vimeo-embed';
+import { parseYouTubeUrl } from '@inkeep/open-knowledge-core/utils/youtube-embed';
type MediaKind = 'video' | 'audio' | 'image';
diff --git a/packages/app/src/editor/validation-audit-client.ts b/packages/app/src/editor/validation-audit-client.ts
index 7faff8406..59e78757f 100644
--- a/packages/app/src/editor/validation-audit-client.ts
+++ b/packages/app/src/editor/validation-audit-client.ts
@@ -1,11 +1,11 @@
import {
- type BrokenLinkSuppression,
type ValidationAuditCountsResponse,
ValidationAuditCountsResponseSchema,
type ValidationAuditResponse,
ValidationAuditResponseSchema,
type ValidationDocResult,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
+import type { BrokenLinkSuppression } from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useState } from 'react';
import type { z } from 'zod';
import { invalidatesLocalTargetAudit, subscribeToDocumentsChanged } from '@/lib/documents-events';
diff --git a/packages/app/src/hooks/use-conflicts.tsx b/packages/app/src/hooks/use-conflicts.tsx
index cd0a5f027..521f0bc29 100644
--- a/packages/app/src/hooks/use-conflicts.tsx
+++ b/packages/app/src/hooks/use-conflicts.tsx
@@ -1,4 +1,7 @@
-import { type ConflictEntryWire, SyncConflictsSuccessSchema } from '@inkeep/open-knowledge-core';
+import {
+ type ConflictEntryWire,
+ SyncConflictsSuccessSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { createContext, type ReactNode, use, useEffect, useRef, useState } from 'react';
import { subscribeToDocumentsChanged } from '@/lib/documents-events';
diff --git a/packages/app/src/hooks/use-create-blank-skill.ts b/packages/app/src/hooks/use-create-blank-skill.ts
index d083618c8..cc7214496 100644
--- a/packages/app/src/hooks/use-create-blank-skill.ts
+++ b/packages/app/src/hooks/use-create-blank-skill.ts
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/hooks/use-document-stats.ts b/packages/app/src/hooks/use-document-stats.ts
index 6ecdd159e..777e4e0c7 100644
--- a/packages/app/src/hooks/use-document-stats.ts
+++ b/packages/app/src/hooks/use-document-stats.ts
@@ -1,5 +1,5 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import { isEditableTextDocFile } from '@inkeep/open-knowledge-core';
+import { isEditableTextDocFile } from '@inkeep/open-knowledge-core/constants/code-languages';
import { useEffect, useState } from 'react';
import {
computeBodyStats,
diff --git a/packages/app/src/hooks/use-enable-sync-with-confirm.ts b/packages/app/src/hooks/use-enable-sync-with-confirm.ts
index 2f4a7e796..005bead74 100644
--- a/packages/app/src/hooks/use-enable-sync-with-confirm.ts
+++ b/packages/app/src/hooks/use-enable-sync-with-confirm.ts
@@ -1,11 +1,11 @@
import {
- humanFormat,
resolveLocalAutoSyncMode,
type StoredSyncActiveMode,
type StoredSyncMode,
type SyncActiveMode,
type SyncMode,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/config/auto-sync-mode';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import { useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/hooks/use-explore-preview-install.ts b/packages/app/src/hooks/use-explore-preview-install.ts
index e3875342e..dd3416f0e 100644
--- a/packages/app/src/hooks/use-explore-preview-install.ts
+++ b/packages/app/src/hooks/use-explore-preview-install.ts
@@ -1,8 +1,6 @@
-import {
- AGENTS_SKILLS_ROOT,
- isSkillInstallTarget,
- type SkillScope,
-} from '@inkeep/open-knowledge-core';
+import { AGENTS_SKILLS_ROOT } from '@inkeep/open-knowledge-core/constants/skills';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import { isSkillInstallTarget } from '@inkeep/open-knowledge-core/skill-targets/schema';
import { useLingui } from '@lingui/react/macro';
import { useRef, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/hooks/use-folder-config.ts b/packages/app/src/hooks/use-folder-config.ts
index 2eb16cf5a..74be3c18a 100644
--- a/packages/app/src/hooks/use-folder-config.ts
+++ b/packages/app/src/hooks/use-folder-config.ts
@@ -2,7 +2,7 @@ import {
type FolderConfigWarningCode,
type TemplatesListEntry,
TemplatesListSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { useEffect, useState } from 'react';
import { subscribeToTemplatesChanged } from '@/lib/documents-events';
diff --git a/packages/app/src/hooks/use-git-sync-status.ts b/packages/app/src/hooks/use-git-sync-status.ts
index b5c7598b3..3e1fefff3 100644
--- a/packages/app/src/hooks/use-git-sync-status.ts
+++ b/packages/app/src/hooks/use-git-sync-status.ts
@@ -1,10 +1,10 @@
+import type { SyncMode } from '@inkeep/open-knowledge-core/config/auto-sync-mode';
import type {
PushPermissionWire as GitPushPermission,
PullOutcome,
SyncErrorCode,
- SyncMode,
SyncStatusSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useState } from 'react';
import { subscribeToDocumentsChanged } from '@/lib/documents-events';
diff --git a/packages/app/src/hooks/use-git-worktree-status.ts b/packages/app/src/hooks/use-git-worktree-status.ts
index 4f46a4085..97621bfdf 100644
--- a/packages/app/src/hooks/use-git-worktree-status.ts
+++ b/packages/app/src/hooks/use-git-worktree-status.ts
@@ -1,4 +1,4 @@
-import type { GitWorktreeStatusSuccess } from '@inkeep/open-knowledge-core';
+import type { GitWorktreeStatusSuccess } from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useState } from 'react';
import { subscribeToDocumentsChanged } from '@/lib/documents-events';
import { triggerSync } from '@/lib/trigger-sync';
diff --git a/packages/app/src/hooks/use-installed-clis.ts b/packages/app/src/hooks/use-installed-clis.ts
index 2c7b12287..3c9702280 100644
--- a/packages/app/src/hooks/use-installed-clis.ts
+++ b/packages/app/src/hooks/use-installed-clis.ts
@@ -1,4 +1,4 @@
-import type { TerminalCli } from '@inkeep/open-knowledge-core';
+import type { TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { useEffect, useState } from 'react';
export function useInstalledClis(): Partial<Record<TerminalCli, boolean>> {
diff --git a/packages/app/src/hooks/use-is-embedded.ts b/packages/app/src/hooks/use-is-embedded.ts
index f68720d85..8510f9b20 100644
--- a/packages/app/src/hooks/use-is-embedded.ts
+++ b/packages/app/src/hooks/use-is-embedded.ts
@@ -1,4 +1,4 @@
-import { detectEmbeddedHostFromBrowser } from '@inkeep/open-knowledge-core';
+import { detectEmbeddedHostFromBrowser } from '@inkeep/open-knowledge-core/constants/embedded-host';
import { useState } from 'react';
export function useIsEmbedded(): boolean {
diff --git a/packages/app/src/hooks/use-language-bridge.ts b/packages/app/src/hooks/use-language-bridge.ts
index 734015a98..59f0ef959 100644
--- a/packages/app/src/hooks/use-language-bridge.ts
+++ b/packages/app/src/hooks/use-language-bridge.ts
@@ -1,4 +1,4 @@
-import type { LanguagePreference } from '@inkeep/open-knowledge-core';
+import type { LanguagePreference } from '@inkeep/open-knowledge-core/i18n/locales';
import { useEffect } from 'react';
import type { OkDesktopBridge } from '@/lib/desktop-bridge-types';
diff --git a/packages/app/src/hooks/use-move-skill-scope.ts b/packages/app/src/hooks/use-move-skill-scope.ts
index 459c48326..464794ae2 100644
--- a/packages/app/src/hooks/use-move-skill-scope.ts
+++ b/packages/app/src/hooks/use-move-skill-scope.ts
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { useLingui } from '@lingui/react/macro';
import { toast } from 'sonner';
import { useManagedArtifactRetarget } from '@/components/ManagedArtifactProperties';
diff --git a/packages/app/src/hooks/use-open-skill-for-edit.ts b/packages/app/src/hooks/use-open-skill-for-edit.ts
index 5626f5b48..c93719ccf 100644
--- a/packages/app/src/hooks/use-open-skill-for-edit.ts
+++ b/packages/app/src/hooks/use-open-skill-for-edit.ts
@@ -1,4 +1,4 @@
-import { externalSkillFileLiveDocName } from '@inkeep/open-knowledge-core';
+import { externalSkillFileLiveDocName } from '@inkeep/open-knowledge-core/constants/cc1';
import { useDocumentContext } from '@/editor/DocumentContext';
import { hashFromDocName, replaceHashWithoutNavigation } from '@/lib/doc-hash';
import { editExternalSkill } from '@/lib/skills-api';
diff --git a/packages/app/src/hooks/use-open-skill.ts b/packages/app/src/hooks/use-open-skill.ts
index 8581b3192..074c453c2 100644
--- a/packages/app/src/hooks/use-open-skill.ts
+++ b/packages/app/src/hooks/use-open-skill.ts
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { toast } from 'sonner';
import { useDocumentContext } from '@/editor/DocumentContext';
diff --git a/packages/app/src/hooks/use-openknowledge-skills.ts b/packages/app/src/hooks/use-openknowledge-skills.ts
index 2362be797..9453bbdad 100644
--- a/packages/app/src/hooks/use-openknowledge-skills.ts
+++ b/packages/app/src/hooks/use-openknowledge-skills.ts
@@ -1,5 +1,5 @@
-import type { SkillSearchResult } from '@inkeep/open-knowledge-core';
-import { OPENKNOWLEDGE_SKILLS_REPO } from '@inkeep/open-knowledge-core';
+import { OPENKNOWLEDGE_SKILLS_REPO } from '@inkeep/open-knowledge-core/constants/skills';
+import type { SkillSearchResult } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { useQuery } from '@tanstack/react-query';
import { discoverSkillsInSource, fetchPublisherSkills } from '@/lib/skills-api';
diff --git a/packages/app/src/hooks/use-popular-skills.ts b/packages/app/src/hooks/use-popular-skills.ts
index dbb2cc740..13526f09f 100644
--- a/packages/app/src/hooks/use-popular-skills.ts
+++ b/packages/app/src/hooks/use-popular-skills.ts
@@ -1,4 +1,4 @@
-import type { SkillSearchResult } from '@inkeep/open-knowledge-core';
+import type { SkillSearchResult } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { useQuery } from '@tanstack/react-query';
import { fetchPopularSkills } from '@/lib/skills-api';
diff --git a/packages/app/src/hooks/use-reconcile-skill-tabs.ts b/packages/app/src/hooks/use-reconcile-skill-tabs.ts
index 8839c5cfc..143f190dd 100644
--- a/packages/app/src/hooks/use-reconcile-skill-tabs.ts
+++ b/packages/app/src/hooks/use-reconcile-skill-tabs.ts
@@ -3,8 +3,8 @@ import {
parseGlobalSkillBundleDoc,
parseManagedArtifactName,
parseProjectSkillBundleDoc,
- type SkillsListEntry,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useRef } from 'react';
import { useManagedArtifactRetarget } from '@/components/ManagedArtifactProperties';
import { useDocumentContext } from '@/editor/DocumentContext';
diff --git a/packages/app/src/hooks/use-semantic-search-status.ts b/packages/app/src/hooks/use-semantic-search-status.ts
index 23cd052e0..6ff84e1fc 100644
--- a/packages/app/src/hooks/use-semantic-search-status.ts
+++ b/packages/app/src/hooks/use-semantic-search-status.ts
@@ -1,4 +1,7 @@
-import { type SemanticIndexStatus, SemanticIndexStatusSchema } from '@inkeep/open-knowledge-core';
+import {
+ type SemanticIndexStatus,
+ SemanticIndexStatusSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useReducer, useRef } from 'react';
import { COMMAND_PALETTE_SEARCH_TIMEOUT_MS } from '@/components/command-palette-semantic';
import { subscribeToDocumentsChanged } from '@/lib/documents-events';
diff --git a/packages/app/src/hooks/use-skill-directory.ts b/packages/app/src/hooks/use-skill-directory.ts
index dd9d679d8..3df940e65 100644
--- a/packages/app/src/hooks/use-skill-directory.ts
+++ b/packages/app/src/hooks/use-skill-directory.ts
@@ -1,4 +1,5 @@
-import type { SkillScope, SkillSearchResult, SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillScope, SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
+import type { SkillSearchResult } from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { useOpenSkill } from '@/hooks/use-open-skill';
import { useSkills } from '@/hooks/use-skills';
import { openSkillPreviewTab } from '@/lib/open-managed-artifact-tab';
diff --git a/packages/app/src/hooks/use-skill-origin.ts b/packages/app/src/hooks/use-skill-origin.ts
index 7808076f1..ac9ba2d33 100644
--- a/packages/app/src/hooks/use-skill-origin.ts
+++ b/packages/app/src/hooks/use-skill-origin.ts
@@ -1,9 +1,8 @@
+import type { SkillOrigin, SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import {
isLocalSkillSource,
- type SkillOrigin,
- type SkillScope,
skillsShSkillLinks,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/skills-catalog/source-fields';
import { useLingui } from '@lingui/react/macro';
import { useEffect, useState } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/hooks/use-skill-scope-move.tsx b/packages/app/src/hooks/use-skill-scope-move.tsx
index 1b9eae96f..0611103b9 100644
--- a/packages/app/src/hooks/use-skill-scope-move.tsx
+++ b/packages/app/src/hooks/use-skill-scope-move.tsx
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { type ReactNode, useState } from 'react';
import { SkillScopeMoveDialog } from '@/components/SkillScopeMoveDialog';
diff --git a/packages/app/src/hooks/use-skill-targets.ts b/packages/app/src/hooks/use-skill-targets.ts
index ec2dccab4..cbd2ac1fa 100644
--- a/packages/app/src/hooks/use-skill-targets.ts
+++ b/packages/app/src/hooks/use-skill-targets.ts
@@ -3,7 +3,7 @@ import {
type SkillScope,
type SkillTargetsGetSuccess,
SkillTargetsGetSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { useEffect, useState } from 'react';
import { emitSkillsChanged } from '@/lib/documents-events';
diff --git a/packages/app/src/hooks/use-skill-update-available.ts b/packages/app/src/hooks/use-skill-update-available.ts
index 37a022aa1..cd5e03b59 100644
--- a/packages/app/src/hooks/use-skill-update-available.ts
+++ b/packages/app/src/hooks/use-skill-update-available.ts
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useState } from 'react';
import { reimportSkill } from '@/lib/skills-api';
diff --git a/packages/app/src/hooks/use-skills.ts b/packages/app/src/hooks/use-skills.ts
index ce1b7ee69..c0a28d870 100644
--- a/packages/app/src/hooks/use-skills.ts
+++ b/packages/app/src/hooks/use-skills.ts
@@ -1,4 +1,7 @@
-import { type SkillsListEntry, SkillsListSuccessSchema } from '@inkeep/open-knowledge-core';
+import {
+ type SkillsListEntry,
+ SkillsListSuccessSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { useEffect, useState } from 'react';
import {
diff --git a/packages/app/src/hooks/use-terminal-enabled.ts b/packages/app/src/hooks/use-terminal-enabled.ts
index bc5474177..5c0d1e1a5 100644
--- a/packages/app/src/hooks/use-terminal-enabled.ts
+++ b/packages/app/src/hooks/use-terminal-enabled.ts
@@ -1,4 +1,4 @@
-import { humanFormat } from '@inkeep/open-knowledge-core';
+import { humanFormat } from '@inkeep/open-knowledge-core/config/errors';
import { useConfigContext } from '@/lib/config-provider';
import { recordShellConsentGranted } from '@/lib/terminal-telemetry';
diff --git a/packages/app/src/hooks/use-worktree-autosync-notice.tsx b/packages/app/src/hooks/use-worktree-autosync-notice.tsx
index a6c8ebb56..a330d5f72 100644
--- a/packages/app/src/hooks/use-worktree-autosync-notice.tsx
+++ b/packages/app/src/hooks/use-worktree-autosync-notice.tsx
@@ -1,4 +1,7 @@
-import { resolveLocalAutoSyncMode, type SyncMode } from '@inkeep/open-knowledge-core';
+import {
+ resolveLocalAutoSyncMode,
+ type SyncMode,
+} from '@inkeep/open-knowledge-core/config/auto-sync-mode';
import { Trans } from '@lingui/react/macro';
import { useEffect, useRef } from 'react';
import { toast } from 'sonner';
diff --git a/packages/app/src/lib/acp/agent-visibility.ts b/packages/app/src/lib/acp/agent-visibility.ts
index 42f488cdc..33dc46c9c 100644
--- a/packages/app/src/lib/acp/agent-visibility.ts
+++ b/packages/app/src/lib/acp/agent-visibility.ts
@@ -1,4 +1,4 @@
-import type { HandoffTarget, TerminalCli } from '@inkeep/open-knowledge-core';
+import type { HandoffTarget, TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import {
desktopEnabledKey,
type EnabledOverrides,
diff --git a/packages/app/src/lib/acp/harness-terminal-cli.ts b/packages/app/src/lib/acp/harness-terminal-cli.ts
index d6cfaabc0..dec415ae6 100644
--- a/packages/app/src/lib/acp/harness-terminal-cli.ts
+++ b/packages/app/src/lib/acp/harness-terminal-cli.ts
@@ -1,8 +1,5 @@
-import {
- ACP_AGENT_HARNESS_CLI_MAP,
- TERMINAL_CLI_IDS,
- type TerminalCli,
-} from '@inkeep/open-knowledge-core';
+import { ACP_AGENT_HARNESS_CLI_MAP } from '@inkeep/open-knowledge-core/agent-registry';
+import { TERMINAL_CLI_IDS, type TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import { useInstalledClis } from '@/hooks/use-installed-clis';
import { isNoteWindow } from '@/lib/note-window-mode';
diff --git a/packages/app/src/lib/acp/launcher-selection.ts b/packages/app/src/lib/acp/launcher-selection.ts
index 75b8c1130..cac1fb24e 100644
--- a/packages/app/src/lib/acp/launcher-selection.ts
+++ b/packages/app/src/lib/acp/launcher-selection.ts
@@ -1,5 +1,5 @@
-import type { HandoffTarget, InstallState, TerminalCli } from '@inkeep/open-knowledge-core';
-import { TERMINAL_CLI_IDS } from '@inkeep/open-knowledge-core';
+import type { HandoffTarget, InstallState, TerminalCli } from '@inkeep/open-knowledge-core/handoff';
+import { TERMINAL_CLI_IDS } from '@inkeep/open-knowledge-core/handoff';
import { VISIBLE_TARGETS } from '@/lib/handoff/targets';
import { parseStickyCliId, parseStickyThreadAgent } from '../unified-agent-store';
import {
diff --git a/packages/app/src/lib/acp/thought-preview.ts b/packages/app/src/lib/acp/thought-preview.ts
index 1791c8f75..84bc503a1 100644
--- a/packages/app/src/lib/acp/thought-preview.ts
+++ b/packages/app/src/lib/acp/thought-preview.ts
@@ -1,4 +1,5 @@
-import { createCodeFenceTracker, markdownToPlainText } from '@inkeep/open-knowledge-core';
+import { markdownToPlainText } from '@inkeep/open-knowledge-core/markdown/plain-text';
+import { createCodeFenceTracker } from '@inkeep/open-knowledge-core/utils/code-fence-tracker';
function plainLines(markdown: string, toPlainText: (markdown: string) => string): string[] {
return toPlainText(markdown)
diff --git a/packages/app/src/lib/acp/tool-failure-hint.ts b/packages/app/src/lib/acp/tool-failure-hint.ts
index c20da9225..3ba7deaf5 100644
--- a/packages/app/src/lib/acp/tool-failure-hint.ts
+++ b/packages/app/src/lib/acp/tool-failure-hint.ts
@@ -1,9 +1,9 @@
+import { openKnowledgeToolName } from '@inkeep/open-knowledge-core/acp/tool-call-input';
import {
OPEN_KNOWLEDGE_MCP_WRITE_TOOLS,
SERVER_TIMEOUT_ERROR_PREFIX,
SERVER_UNREACHABLE_ERROR_PREFIX,
-} from '@inkeep/open-knowledge-core';
-import { openKnowledgeToolName } from '@inkeep/open-knowledge-core/acp/tool-call-input';
+} from '@inkeep/open-knowledge-core/constants/mcp';
import { t } from '@lingui/core/macro';
import {
type RenderedPermission,
diff --git a/packages/app/src/lib/acp/tool-output-format.ts b/packages/app/src/lib/acp/tool-output-format.ts
index a1420459d..ad751acaa 100644
--- a/packages/app/src/lib/acp/tool-output-format.ts
+++ b/packages/app/src/lib/acp/tool-output-format.ts
@@ -1,4 +1,4 @@
-import { widenFenceLength } from '@inkeep/open-knowledge-core';
+import { widenFenceLength } from '@inkeep/open-knowledge-core/markdown/code-fence';
const FENCE_LINE = /^\s{0,3}(?:`{3,}|~{3,})/;
const HEADING = /^#{1,6}\s+\S/m;
diff --git a/packages/app/src/lib/activate-locale.ts b/packages/app/src/lib/activate-locale.ts
index a5407d009..4eac19a33 100644
--- a/packages/app/src/lib/activate-locale.ts
+++ b/packages/app/src/lib/activate-locale.ts
@@ -1,4 +1,5 @@
-import { FALLBACK_LOCALE, type SupportedLocale } from '@inkeep/open-knowledge-core';
+import type { SupportedLocale } from '@inkeep/open-knowledge-core/i18n/locales';
+import { FALLBACK_LOCALE } from '@inkeep/open-knowledge-core/i18n/resolve-locale';
import type { Messages } from '@lingui/core';
import { i18n } from './i18n';
diff --git a/packages/app/src/lib/agent-connection-paths.ts b/packages/app/src/lib/agent-connection-paths.ts
index df345987d..cdba49f87 100644
--- a/packages/app/src/lib/agent-connection-paths.ts
+++ b/packages/app/src/lib/agent-connection-paths.ts
@@ -1,11 +1,11 @@
+import { parsePathId } from '@inkeep/open-knowledge-core/agent-registry';
import {
- AGENTS_SKILLS_ROOT,
EDITOR_PROJECT_SKILL_ROOT,
EDITOR_USER_SKILL_ROOT,
- parsePathId,
RESERVED_PROJECT_SKILL_NAME,
STABLE_EDITOR_PROJECT_CONFIG_PATH,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/editors';
+import { AGENTS_SKILLS_ROOT } from '@inkeep/open-knowledge-core/constants/skills';
export function connectionPathDisplay(pathId: string | undefined): string | null {
if (pathId === undefined) return null;
diff --git a/packages/app/src/lib/agent-connections.ts b/packages/app/src/lib/agent-connections.ts
index 54fcb6200..1ff1279ad 100644
--- a/packages/app/src/lib/agent-connections.ts
+++ b/packages/app/src/lib/agent-connections.ts
@@ -1,9 +1,9 @@
-import {
- AgentIntegrationsApplySuccessSchema,
- type ApplyIntent,
- type ApplyReport,
- type HostSnapshot,
-} from '@inkeep/open-knowledge-core';
+import type {
+ ApplyIntent,
+ ApplyReport,
+ HostSnapshot,
+} from '@inkeep/open-knowledge-core/agent-registry';
+import { AgentIntegrationsApplySuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
export interface ApplyAgentConnectionsResult {
readonly ok: boolean;
diff --git a/packages/app/src/lib/agent-followup-hint.ts b/packages/app/src/lib/agent-followup-hint.ts
index f1496f39e..a2455d51f 100644
--- a/packages/app/src/lib/agent-followup-hint.ts
+++ b/packages/app/src/lib/agent-followup-hint.ts
@@ -1,4 +1,5 @@
-import { EDITOR_LABELS, type GuidanceRef } from '@inkeep/open-knowledge-core';
+import type { GuidanceRef } from '@inkeep/open-knowledge-core/agent-registry';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
import { t } from '@lingui/core/macro';
export function followupHintText(ref: GuidanceRef | undefined): string | null {
diff --git a/packages/app/src/lib/agent-guidance-copy.ts b/packages/app/src/lib/agent-guidance-copy.ts
index fb74f4ec0..10a9471d5 100644
--- a/packages/app/src/lib/agent-guidance-copy.ts
+++ b/packages/app/src/lib/agent-guidance-copy.ts
@@ -1,4 +1,6 @@
-import { DESKTOP_PRODUCTS, EDITOR_LABELS, type GuidanceRef } from '@inkeep/open-knowledge-core';
+import type { GuidanceRef } from '@inkeep/open-knowledge-core/agent-registry';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
+import { DESKTOP_PRODUCTS } from '@inkeep/open-knowledge-core/constants/product';
import { t } from '@lingui/core/macro';
function desktopMcpServerName(): string | null {
diff --git a/packages/app/src/lib/agent-presence.ts b/packages/app/src/lib/agent-presence.ts
index cc7b5852f..618d09025 100644
--- a/packages/app/src/lib/agent-presence.ts
+++ b/packages/app/src/lib/agent-presence.ts
@@ -1,4 +1,4 @@
-import type { AgentPresenceEntry } from '@inkeep/open-knowledge-core';
+import type { AgentPresenceEntry } from '@inkeep/open-knowledge-core/types/awareness';
export const AGENT_PRESENCE_STALE_MS = 5_000;
diff --git a/packages/app/src/lib/bug-report-send-manager.ts b/packages/app/src/lib/bug-report-send-manager.ts
index a2b77d963..18f1a2064 100644
--- a/packages/app/src/lib/bug-report-send-manager.ts
+++ b/packages/app/src/lib/bug-report-send-manager.ts
@@ -3,7 +3,7 @@ import type {
OkBugReportSendMetadata,
OkBugReportSendResult,
ReportBundleSummary,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/logger-types';
import {
type BugReportSendSpan,
beginBugReportSendSpan,
diff --git a/packages/app/src/lib/bug-report-support.ts b/packages/app/src/lib/bug-report-support.ts
index ea2bcdf4c..6175e5594 100644
--- a/packages/app/src/lib/bug-report-support.ts
+++ b/packages/app/src/lib/bug-report-support.ts
@@ -2,7 +2,7 @@ import {
clampToCodeUnits,
mapControlCharactersToSpace,
stripInvisibleCharacters,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/bug-report-sidecar/note-content';
const SUPPORT_EMAIL = '[email protected]';
diff --git a/packages/app/src/lib/cc1.ts b/packages/app/src/lib/cc1.ts
index dd2600f26..53dc29159 100644
--- a/packages/app/src/lib/cc1.ts
+++ b/packages/app/src/lib/cc1.ts
@@ -1,9 +1,9 @@
+import { CC1_CONTRACT_VERSION, SYSTEM_DOC_NAME } from '@inkeep/open-knowledge-core/constants/cc1';
import {
CC1_CHANNEL_BRANCH_SWITCHED,
CC1_CHANNEL_CONFIG_IGNORE_NESTED_ERROR,
CC1_CHANNEL_CONFIG_VALIDATION_REJECTED,
CC1_CHANNEL_DISK_ACK,
- CC1_CONTRACT_VERSION,
type CC1BranchSwitchedPayload,
CC1BranchSwitchedPayloadSchema,
type CC1ConfigIgnoreNestedErrorPayload,
@@ -16,8 +16,7 @@ import {
type CC1ServerInfoPayload,
CC1ServerInfoPayloadSchema,
type DerivedViewChannel,
- SYSTEM_DOC_NAME,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/cc1';
import type { z } from 'zod';
export {
diff --git a/packages/app/src/lib/client-version.ts b/packages/app/src/lib/client-version.ts
index 95008a59c..0dd49414f 100644
--- a/packages/app/src/lib/client-version.ts
+++ b/packages/app/src/lib/client-version.ts
@@ -3,7 +3,7 @@ import {
type ClientVersionTokenFields,
clientVersionHeaders,
clientVersionTokenFields,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/client-version';
const importMetaEnv = (import.meta as unknown as { env?: Record<string, string | undefined> }).env;
diff --git a/packages/app/src/lib/color-themes.ts b/packages/app/src/lib/color-themes.ts
index bceffd16e..dc7f30eb7 100644
--- a/packages/app/src/lib/color-themes.ts
+++ b/packages/app/src/lib/color-themes.ts
@@ -1,25 +1,26 @@
+import { CHROME_BG_DARK, CHROME_BG_LIGHT } from '@inkeep/open-knowledge-core/constants/chrome';
+import { PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core/constants/preview-theme-tokens';
import {
BASE16_SLOTS,
type Base16Palette,
type Base16Scheme,
base16ToTokens,
- CHROME_BG_DARK,
- CHROME_BG_LIGHT,
+ isBase16Hex,
+ mixHex,
+ relativeLuminance,
+} from '@inkeep/open-knowledge-core/theme/base16';
+import {
type ColorThemeSelection,
type ColorThemeSelectionInput,
generateColorThemesCss,
- isBase16Hex,
isDarkTheme,
- mixHex,
- PREVIEW_THEME_TOKENS,
- relativeLuminance,
renderThemeBlock,
resolveColorThemeSelection,
resolveModePreference,
resolveThemePlugin,
THEME_PLUGINS,
type ThemePlugin,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/theme/theme-plugins';
export type { Base16Scheme, ColorThemeSelection, ColorThemeSelectionInput };
export {
diff --git a/packages/app/src/lib/config-context.ts b/packages/app/src/lib/config-context.ts
index 3e2b45707..4a5218845 100644
--- a/packages/app/src/lib/config-context.ts
+++ b/packages/app/src/lib/config-context.ts
@@ -1,4 +1,6 @@
-import type { Config, ConfigBinding, OkignoreBinding } from '@inkeep/open-knowledge-core';
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import type { OkignoreBinding } from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
+import type { Config } from '@inkeep/open-knowledge-core/config/schema';
import { useLingui } from '@lingui/react/macro';
import { createContext, use } from 'react';
diff --git a/packages/app/src/lib/config-ignore-nested-error-events.ts b/packages/app/src/lib/config-ignore-nested-error-events.ts
index 041104743..21dc78bbc 100644
--- a/packages/app/src/lib/config-ignore-nested-error-events.ts
+++ b/packages/app/src/lib/config-ignore-nested-error-events.ts
@@ -1,4 +1,4 @@
-import type { CC1ConfigIgnoreNestedErrorPayload } from '@inkeep/open-knowledge-core';
+import type { CC1ConfigIgnoreNestedErrorPayload } from '@inkeep/open-knowledge-core/schemas/cc1';
type Listener = (event: CC1ConfigIgnoreNestedErrorPayload) => void;
diff --git a/packages/app/src/lib/config-provider.tsx b/packages/app/src/lib/config-provider.tsx
index c7ecd7670..ffd5701ef 100644
--- a/packages/app/src/lib/config-provider.tsx
+++ b/packages/app/src/lib/config-provider.tsx
@@ -1,17 +1,21 @@
import { HocuspocusProvider } from '@hocuspocus/provider';
import {
bindConfigDoc,
+ type ConfigBinding,
+} from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import {
bindOkignoreDoc,
+ type OkignoreBinding,
+} from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
+import type { WriteScope } from '@inkeep/open-knowledge-core/config/errors';
+import { mergeLayered } from '@inkeep/open-knowledge-core/config/merge-layered';
+import type { Config } from '@inkeep/open-knowledge-core/config/schema';
+import {
CONFIG_DOC_NAME_OKIGNORE,
CONFIG_DOC_NAME_PROJECT,
CONFIG_DOC_NAME_PROJECT_LOCAL,
CONFIG_DOC_NAME_USER,
- type Config,
- type ConfigBinding,
- mergeLayered,
- type OkignoreBinding,
- type WriteScope,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
import { useTheme } from 'next-themes';
import { type ReactNode, useEffect, useState } from 'react';
import * as Y from 'yjs';
diff --git a/packages/app/src/lib/config-provider.user-synced.dom.test.tsx b/packages/app/src/lib/config-provider.user-synced.dom.test.tsx
index 69b26d787..230057ece 100644
--- a/packages/app/src/lib/config-provider.user-synced.dom.test.tsx
+++ b/packages/app/src/lib/config-provider.user-synced.dom.test.tsx
@@ -1,6 +1,7 @@
import type { ConfigBinding, OkignoreBinding, WriteScope } from '@inkeep/open-knowledge-core';
import { act, cleanup, render, screen, waitFor } from '@testing-library/react';
import { afterEach, beforeAll, beforeEach, describe, expect, test, vi } from 'vitest';
+import { createServedBindingLog } from '@/test-utils/served-binding.test-helper';
import { dynamicActivate } from './activate-locale';
import { i18n } from './i18n';
import { __resetServerInstanceStoreForTests, setServerInstanceId } from './server-instance-store';
@@ -40,6 +41,7 @@ let useThemeBridgeCalls: Array<[unknown, string | undefined, string | undefined]
let useLanguageBridgeCalls: Array<[unknown, unknown, boolean]> = [];
let setThemeCalls: string[] = [];
let systemTheme: 'light' | 'dark' = 'light';
+let browserLanguages: readonly string[] = [];
const buildAuthTokenCalls: Array<readonly unknown[]> = [];
const originalFetch = globalThis.fetch;
@@ -54,6 +56,7 @@ function resetCaptures() {
useLanguageBridgeCalls = [];
setThemeCalls = [];
systemTheme = 'light';
+ browserLanguages = [];
buildAuthTokenCalls.length = 0;
}
@@ -150,71 +153,107 @@ vi.doMock('@/lib/auth-token', () => ({
},
}));
-vi.doMock('@inkeep/open-knowledge-core', () => ({
- bindConfigDoc: (_provider: unknown, scope: WriteScope) =>
- makeFakeConfigBinding(scope, scope === 'user' ? userHasSyncedSeed : false),
- bindOkignoreDoc: () => makeFakeOkignoreBinding(),
- CONFIG_DOC_NAME_USER: '__user__/config.yml',
- CONFIG_DOC_NAME_PROJECT: '__config__/project',
- CONFIG_DOC_NAME_PROJECT_LOCAL: '__local__/project',
- CONFIG_DOC_NAME_OKIGNORE: '__config__/okignore',
- mergeLayered: (user: unknown, project: unknown, projectLocal: unknown) => {
- mergeLayeredCalls.push([user, project, projectLocal]);
- return mergedConfig;
- },
- resolveLocale: ({ storedPreference }: { storedPreference?: string }) => ({
- locale: storedPreference && storedPreference !== 'system' ? storedPreference : 'en',
- source: storedPreference && storedPreference !== 'system' ? 'explicit' : 'fallback',
+const servedCore = createServedBindingLog();
+
+vi.doMock('@inkeep/open-knowledge-core/config/bind-config-doc', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/config/bind-config-doc', {
+ bindConfigDoc: (_provider: unknown, scope: WriteScope) =>
+ makeFakeConfigBinding(scope, scope === 'user' ? userHasSyncedSeed : false),
}),
- readBrowserLanguages: () => [],
- localeDirection: (locale: string) => (locale === 'ar' || locale === 'ur' ? 'rtl' : 'ltr'),
- SUPPORTED_LOCALES: ['en', 'es'],
- AUTO_DETECTABLE_LOCALES: ['en', 'es'],
- colorThemeMode: (
- id?: string,
- themes?: readonly { id: string; kind: 'light' | 'dark' | 'system' }[],
- ) => {
- const kind = themes?.find((theme) => theme.id === id)?.kind;
- if (kind) return kind === 'system' ? undefined : kind;
- return id && id !== 'default' && id !== 'custom' ? 'dark' : undefined;
- },
- resolveColorThemeSelection: (
- appearance?: { colorTheme?: string; colorThemeLight?: string; colorThemeDark?: string },
- themes: readonly { id: string }[] = [],
- ) => {
- const ids = new Set(themes.map((theme) => theme.id));
- const legacy = appearance?.colorTheme;
- const fallback = legacy && ids.has(legacy) ? legacy : 'default';
- const pick = (value: string | undefined) =>
- value === undefined ? fallback : ids.has(value) ? value : 'default';
- return {
- light: pick(appearance?.colorThemeLight),
- dark: pick(appearance?.colorThemeDark),
- };
- },
- SavedThemesListSuccessSchema: {
- safeParse: (value: unknown) => ({ success: true, data: value }),
- },
- base16ToTokens: () => ({}),
- renderThemeBlock: () => '',
- resolveModePreference: (preference?: string, prefersDark?: boolean) =>
- preference === 'light' || preference === 'dark' ? preference : prefersDark ? 'dark' : 'light',
- expandPalette: () => ({}),
- generateColorThemesCss: () => '',
- isDarkTheme: (id?: string) => Boolean(id) && id !== 'default' && id !== 'custom',
- resolveThemePlugin: (id?: string) => ({ id: id ?? 'default', label: 'Default', kind: 'system' }),
- THEME_PLUGINS: [],
- CHROME_BG_LIGHT: '#fafafa',
- CHROME_BG_DARK: '#171717',
- PREVIEW_THEME_TOKENS: [
- { name: '--background', light: '#ffffff', dark: '#0a0a0a' },
- { name: '--primary', light: '#2563eb', dark: '#69a3ff' },
- { name: '--border', light: '#e5e5e5', dark: '#2a2a2a' },
- { name: '--chart-2', light: '#16a34a', dark: '#4ade80' },
- { name: '--chart-3', light: '#ca8a04', dark: '#facc15' },
- { name: '--chart-4', light: '#7c3aed', dark: '#a78bfa' },
- ],
-}));
+);
+
+vi.doMock('@inkeep/open-knowledge-core/config/bind-okignore-doc', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/config/bind-okignore-doc', {
+ bindOkignoreDoc: () => makeFakeOkignoreBinding(),
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/constants/cc1', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/constants/cc1', {
+ CONFIG_DOC_NAME_USER: '__user__/config.yml',
+ CONFIG_DOC_NAME_PROJECT: '__config__/project',
+ CONFIG_DOC_NAME_PROJECT_LOCAL: '__local__/project',
+ CONFIG_DOC_NAME_OKIGNORE: '__config__/okignore',
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/config/merge-layered', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/config/merge-layered', {
+ mergeLayered: (user: unknown, project: unknown, projectLocal: unknown) => {
+ mergeLayeredCalls.push([user, project, projectLocal]);
+ return mergedConfig;
+ },
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/i18n/browser-locale-provider', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/i18n/browser-locale-provider', {
+ readBrowserLanguages: () => browserLanguages,
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/i18n/direction', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/i18n/direction', {
+ localeDirection: (locale: string) => (locale === 'ar' || locale === 'ur' ? 'rtl' : 'ltr'),
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/i18n/locales', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/i18n/locales', {
+ SUPPORTED_LOCALES: ['en', 'es'],
+ AUTO_DETECTABLE_LOCALES: ['en', 'es'],
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/theme/theme-plugins', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/theme/theme-plugins', {
+ resolveColorThemeSelection: (
+ appearance?: { colorTheme?: string; colorThemeLight?: string; colorThemeDark?: string },
+ themes: readonly { id: string }[] = [],
+ ) => {
+ const ids = new Set(themes.map((theme) => theme.id));
+ const legacy = appearance?.colorTheme;
+ const fallback = legacy && ids.has(legacy) ? legacy : 'default';
+ const pick = (value: string | undefined) =>
+ value === undefined ? fallback : ids.has(value) ? value : 'default';
+ return {
+ light: pick(appearance?.colorThemeLight),
+ dark: pick(appearance?.colorThemeDark),
+ };
+ },
+ renderThemeBlock: (selector: string, variant: string, tokens: Record<string, string>) =>
+ `${selector}{color-scheme:${variant};${Object.entries(tokens)
+ .map(([name, value]) => `--${name}:${value}`)
+ .join(';')}}`,
+ resolveModePreference: (preference?: string, prefersDark?: boolean) =>
+ preference === 'light' || preference === 'dark' ? preference : prefersDark ? 'dark' : 'light',
+ generateColorThemesCss: () => '',
+ isDarkTheme: (id?: string) => Boolean(id) && id !== 'default' && id !== 'custom',
+ resolveThemePlugin: (id?: string) => ({
+ id: id ?? 'default',
+ label: 'Default',
+ kind: 'system',
+ }),
+ THEME_PLUGINS: [{ id: 'builtin-dusk', label: 'Dusk', kind: 'dark' }],
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/schemas/api', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/schemas/api', {
+ SavedThemesListSuccessSchema: {
+ safeParse: (value: unknown) => ({ success: true, data: value }),
+ },
+ }),
+);
+
+vi.doMock('@inkeep/open-knowledge-core/theme/base16', () =>
+ servedCore.serve('@inkeep/open-knowledge-core/theme/base16', {
+ base16ToTokens: (scheme: { palette: Record<string, string> }) => ({
+ background: scheme.palette.base00,
+ foreground: scheme.palette.base05,
+ }),
+ }),
+);
let userHasSyncedSeed = false;
@@ -715,4 +754,208 @@ describe('ConfigProvider — userSynced behavioral wiring (Tier-3)', () => {
consoleWarnSpy.mockRestore();
});
+
+ test('config bindings, CC1 doc names and the layer merge come from the core replacements', async () => {
+ const since = servedCore.mark();
+ const { unmount } = render(
+ <ConfigProvider collabUrl="ws://test.invalid">
+ <ConfigContextProbe />
+ </ConfigProvider>,
+ );
+
+ await waitFor(() => {
+ expect(screen.getByTestId('has-project-local-binding').textContent).toBe('true');
+ });
+ expect(providerRecords.map((record) => record.name)).toEqual([
+ '__user__/config.yml',
+ '__config__/project',
+ '__local__/project',
+ '__config__/okignore',
+ ]);
+ expect([...captures.keys()]).toEqual(['user', 'project', 'project-local']);
+ expect(lastContext?.merged).toBe(mergedConfig);
+ unmount();
+ expect(okignoreDisposed).toBe(true);
+
+ for (const [specifier, member] of [
+ ['@inkeep/open-knowledge-core/config/bind-config-doc', 'bindConfigDoc'],
+ ['@inkeep/open-knowledge-core/config/bind-okignore-doc', 'bindOkignoreDoc'],
+ ['@inkeep/open-knowledge-core/config/merge-layered', 'mergeLayered'],
+ ['@inkeep/open-knowledge-core/constants/cc1', 'CONFIG_DOC_NAME_USER'],
+ ['@inkeep/open-knowledge-core/constants/cc1', 'CONFIG_DOC_NAME_PROJECT'],
+ ['@inkeep/open-knowledge-core/constants/cc1', 'CONFIG_DOC_NAME_PROJECT_LOCAL'],
+ ['@inkeep/open-knowledge-core/constants/cc1', 'CONFIG_DOC_NAME_OKIGNORE'],
+ ] as const) {
+ expect(servedCore.readersOf(specifier, member, since)).toEqual(['lib/config-provider.tsx']);
+ }
+ });
+
+ test('the interface language is resolved and applied through the core i18n replacements', async () => {
+ document.documentElement.removeAttribute('lang');
+ document.documentElement.removeAttribute('dir');
+ mergedConfig = { appearance: { language: 'es' } };
+ const since = servedCore.mark();
+ render(
+ <ConfigProvider collabUrl="ws://test.invalid">
+ <ConfigContextProbe />
+ </ConfigProvider>,
+ );
+
+ await waitFor(() => {
+ expect(mergeLayeredCalls.length).toBeGreaterThan(0);
+ });
+ act(() => {
+ captures.get('user')?.syncedListener?.();
+ });
+
+ expect(i18n.locale).toBe('es');
+ await waitFor(() => {
+ expect(document.documentElement.lang).toBe('es');
+ });
+ expect(document.documentElement.dir).toBe('ltr');
+ for (const [specifier, member] of [
+ ['@inkeep/open-knowledge-core/i18n/direction', 'localeDirection'],
+ ['@inkeep/open-knowledge-core/i18n/browser-locale-provider', 'readBrowserLanguages'],
+ ['@inkeep/open-knowledge-core/i18n/locales', 'SUPPORTED_LOCALES'],
+ ['@inkeep/open-knowledge-core/i18n/locales', 'AUTO_DETECTABLE_LOCALES'],
+ ] as const) {
+ expect(servedCore.readersOf(specifier, member, since)).toEqual([
+ 'lib/use-apply-config-language.ts',
+ ]);
+ }
+ });
+
+ test('a saved color theme is listed, selected and painted through the core theme replacements', async () => {
+ systemTheme = 'dark';
+ const bridge = { nativeTheme: {} };
+ Object.defineProperty(window, 'okDesktop', { configurable: true, value: bridge });
+ const palette = Object.fromEntries(
+ Array.from({ length: 16 }, (_, index) => [
+ `base${index.toString(16).toUpperCase().padStart(2, '0')}`,
+ '#111111',
+ ]),
+ );
+ palette.base05 = '#eeeeee';
+ globalThis.fetch = vi.fn(async () =>
+ Response.json({
+ themes: [
+ {
+ ok: true,
+ id: 'saved-cross-kind',
+ filename: 'cross-kind.yaml',
+ scheme: { name: 'Cross kind', variant: 'dark', palette },
+ },
+ ],
+ truncated: false,
+ }),
+ );
+ mergedConfig = {
+ appearance: {
+ theme: 'light',
+ colorThemeLight: 'saved-cross-kind',
+ colorThemeDark: 'default',
+ },
+ };
+ const since = servedCore.mark();
+ render(
+ <ConfigProvider collabUrl="ws://test.invalid">
+ <ConfigContextProbe />
+ </ConfigProvider>,
+ );
+ syncAllConfigBindings();
+
+ await waitFor(() => {
+ expect(document.documentElement.getAttribute('data-color-theme')).toBe('saved-cross-kind');
+ });
+ expect(setThemeCalls.at(-1)).toBe('dark');
+ expect(useThemeBridgeCalls.at(-1)?.slice(0, 2)).toEqual([bridge, 'light']);
+ expect(document.getElementById(SAVED_THEME_STYLE_ID)?.textContent).toBe(
+ 'html[data-color-theme]{color-scheme:dark;--background:#111111;--foreground:#eeeeee}',
+ );
+
+ const readers = (specifier: string, member: string) =>
+ servedCore.readersOf(specifier, member, since);
+ expect(
+ readers('@inkeep/open-knowledge-core/schemas/api', 'SavedThemesListSuccessSchema'),
+ ).toEqual(['lib/saved-themes-client.ts']);
+ for (const member of [
+ 'THEME_PLUGINS',
+ 'resolveColorThemeSelection',
+ 'resolveModePreference',
+ 'resolveThemePlugin',
+ ]) {
+ expect(readers('@inkeep/open-knowledge-core/theme/theme-plugins', member)).toEqual([
+ 'lib/color-themes.ts',
+ ]);
+ }
+ expect(readers('@inkeep/open-knowledge-core/theme/theme-plugins', 'renderThemeBlock')).toEqual([
+ 'lib/use-apply-config-color-theme.ts',
+ ]);
+ expect(readers('@inkeep/open-knowledge-core/theme/base16', 'base16ToTokens')).toEqual([
+ 'lib/color-themes.ts',
+ ]);
+ });
+
+ test('a system language preference follows the browser languages the core i18n replacements serve', async () => {
+ document.documentElement.removeAttribute('lang');
+ browserLanguages = ['es-MX'];
+ mergedConfig = { appearance: { language: 'system' } };
+ const since = servedCore.mark();
+ render(
+ <ConfigProvider collabUrl="ws://test.invalid">
+ <ConfigContextProbe />
+ </ConfigProvider>,
+ );
+
+ await waitFor(() => {
+ expect(mergeLayeredCalls.length).toBeGreaterThan(0);
+ });
+ act(() => {
+ captures.get('user')?.syncedListener?.();
+ });
+
+ expect(i18n.locale).toBe('es');
+ await waitFor(() => {
+ expect(document.documentElement.lang).toBe('es');
+ });
+ for (const [specifier, member] of [
+ ['@inkeep/open-knowledge-core/i18n/browser-locale-provider', 'readBrowserLanguages'],
+ ['@inkeep/open-knowledge-core/i18n/locales', 'AUTO_DETECTABLE_LOCALES'],
+ ] as const) {
+ expect(servedCore.readersOf(specifier, member, since)).toEqual([
+ 'lib/use-apply-config-language.ts',
+ ]);
+ }
+ });
+
+ test('a built-in color theme from the core plugin replacement sets its own mode without a saved stylesheet', async () => {
+ globalThis.fetch = vi.fn(async () => Response.json({ themes: [], truncated: false }));
+ mergedConfig = {
+ appearance: {
+ theme: 'light',
+ colorThemeLight: 'builtin-dusk',
+ colorThemeDark: 'default',
+ },
+ };
+ const since = servedCore.mark();
+ render(
+ <ConfigProvider collabUrl="ws://test.invalid">
+ <ConfigContextProbe />
+ </ConfigProvider>,
+ );
+ syncAllConfigBindings();
+
+ await waitFor(() => {
+ expect(document.documentElement.getAttribute('data-color-theme')).toBe('builtin-dusk');
+ });
+ expect(setThemeCalls.at(-1)).toBe('dark');
+ expect(document.getElementById(SAVED_THEME_STYLE_ID)).toBeNull();
+ expect(
+ servedCore.readersOf(
+ '@inkeep/open-knowledge-core/theme/theme-plugins',
+ 'THEME_PLUGINS',
+ since,
+ ),
+ ).toEqual(['lib/color-themes.ts']);
+ });
});
diff --git a/packages/app/src/lib/config-validation-events.ts b/packages/app/src/lib/config-validation-events.ts
index cf3bb7fb2..07b7c27be 100644
--- a/packages/app/src/lib/config-validation-events.ts
+++ b/packages/app/src/lib/config-validation-events.ts
@@ -1,4 +1,4 @@
-import type { CC1ConfigValidationRejectedPayload } from '@inkeep/open-knowledge-core';
+import type { CC1ConfigValidationRejectedPayload } from '@inkeep/open-knowledge-core/schemas/cc1';
type Listener = (event: CC1ConfigValidationRejectedPayload) => void;
diff --git a/packages/app/src/lib/crash-invite-store.ts b/packages/app/src/lib/crash-invite-store.ts
index ae22bdfe5..f83068e0f 100644
--- a/packages/app/src/lib/crash-invite-store.ts
+++ b/packages/app/src/lib/crash-invite-store.ts
@@ -1,4 +1,4 @@
-import type { OkBugReportCrashDetectedEvent } from '@inkeep/open-knowledge-core';
+import type { OkBugReportCrashDetectedEvent } from '@inkeep/open-knowledge-core/logger-types';
import type { OkDesktopBridge } from '@/lib/desktop-bridge-types';
export interface CrashInviteStore {
diff --git a/packages/app/src/lib/create-page-request.ts b/packages/app/src/lib/create-page-request.ts
index 2bdc79479..d27849d58 100644
--- a/packages/app/src/lib/create-page-request.ts
+++ b/packages/app/src/lib/create-page-request.ts
@@ -1,4 +1,4 @@
-import { CreatePageSuccessSchema } from '@inkeep/open-knowledge-core';
+import { CreatePageSuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { emitDocumentsChanged } from '@/lib/documents-events';
import { parseServerResponse } from '@/lib/parse-server-response';
diff --git a/packages/app/src/lib/create-page.ts b/packages/app/src/lib/create-page.ts
index a6c1dab5a..ac396fce8 100644
--- a/packages/app/src/lib/create-page.ts
+++ b/packages/app/src/lib/create-page.ts
@@ -1,4 +1,4 @@
-import { CreatePageSuccessSchema } from '@inkeep/open-knowledge-core';
+import { CreatePageSuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { emitDocumentsChanged } from './documents-events';
import { parseServerResponse, parseSuccessOrWarn } from './parse-server-response';
diff --git a/packages/app/src/lib/current-branch-store.ts b/packages/app/src/lib/current-branch-store.ts
index 5618a70bd..5d7c98233 100644
--- a/packages/app/src/lib/current-branch-store.ts
+++ b/packages/app/src/lib/current-branch-store.ts
@@ -1,4 +1,4 @@
-import { ServerInfoSuccessSchema } from '@inkeep/open-knowledge-core';
+import { ServerInfoSuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { subscribeToBranchChanged } from '@/lib/documents-events';
export interface BranchStore {
diff --git a/packages/app/src/lib/diagnostic-breadcrumb.ts b/packages/app/src/lib/diagnostic-breadcrumb.ts
index 3b7ce152c..e4fc41dc5 100644
--- a/packages/app/src/lib/diagnostic-breadcrumb.ts
+++ b/packages/app/src/lib/diagnostic-breadcrumb.ts
@@ -1,4 +1,4 @@
-import { LOGGER_OWNED_FIELDS } from '@inkeep/open-knowledge-core';
+import { LOGGER_OWNED_FIELDS } from '@inkeep/open-knowledge-core/logging/renderer-log';
export const MAX_BREADCRUMB_CHARS = 4096;
diff --git a/packages/app/src/lib/doc-hash.ts b/packages/app/src/lib/doc-hash.ts
index 513ee4cd5..9bdb04e08 100644
--- a/packages/app/src/lib/doc-hash.ts
+++ b/packages/app/src/lib/doc-hash.ts
@@ -1,4 +1,5 @@
-import { MANAGED_ARTIFACT_SCOPES, type SkillScope } from '@inkeep/open-knowledge-core';
+import { MANAGED_ARTIFACT_SCOPES } from '@inkeep/open-knowledge-core/constants/cc1';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
function isSkillScope(value: string): value is SkillScope {
return (MANAGED_ARTIFACT_SCOPES as readonly string[]).includes(value);
diff --git a/packages/app/src/lib/document-stats.ts b/packages/app/src/lib/document-stats.ts
index 39c634fb4..7076311b1 100644
--- a/packages/app/src/lib/document-stats.ts
+++ b/packages/app/src/lib/document-stats.ts
@@ -1,4 +1,4 @@
-import { stripFrontmatter } from '@inkeep/open-knowledge-core';
+import { stripFrontmatter } from '@inkeep/open-knowledge-core/extensions/frontmatter';
import { getSharedMarkdownManager } from '@/editor/utils/md-singleton';
export interface DocumentStats {
diff --git a/packages/app/src/lib/documents-events.ts b/packages/app/src/lib/documents-events.ts
index fe2ffe9ac..fbf56b0d5 100644
--- a/packages/app/src/lib/documents-events.ts
+++ b/packages/app/src/lib/documents-events.ts
@@ -1,5 +1,5 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
-import { DerivedViewChannelSchema } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
+import { DerivedViewChannelSchema } from '@inkeep/open-knowledge-core/schemas/cc1';
import type { DerivedViewChannel } from '@/lib/cc1';
const DOCUMENTS_CHANGED_EVENT = 'open-knowledge:documents-changed';
diff --git a/packages/app/src/lib/excalidraw-lang.ts b/packages/app/src/lib/excalidraw-lang.ts
index 82e4ab53e..09ddf1166 100644
--- a/packages/app/src/lib/excalidraw-lang.ts
+++ b/packages/app/src/lib/excalidraw-lang.ts
@@ -1,4 +1,4 @@
-import { SUPPORTED_LOCALES, type SupportedLocale } from '@inkeep/open-knowledge-core';
+import { SUPPORTED_LOCALES, type SupportedLocale } from '@inkeep/open-knowledge-core/i18n/locales';
export const EXCALIDRAW_FALLBACK_LANG_CODE = 'en';
diff --git a/packages/app/src/lib/frontmatter-enum-constraints.ts b/packages/app/src/lib/frontmatter-enum-constraints.ts
index 8bbee9b0a..effb61521 100644
--- a/packages/app/src/lib/frontmatter-enum-constraints.ts
+++ b/packages/app/src/lib/frontmatter-enum-constraints.ts
@@ -1,4 +1,7 @@
-import { type LinterConfig, selectGoverningFrontmatterSchemas } from '@inkeep/open-knowledge-core';
+import {
+ type LinterConfig,
+ selectGoverningFrontmatterSchemas,
+} from '@inkeep/open-knowledge-core/markdown/lint';
export interface FieldEnumConstraint {
values: string[];
diff --git a/packages/app/src/lib/frontmatter-schema-fields.ts b/packages/app/src/lib/frontmatter-schema-fields.ts
index def93a8e0..7b58dc97d 100644
--- a/packages/app/src/lib/frontmatter-schema-fields.ts
+++ b/packages/app/src/lib/frontmatter-schema-fields.ts
@@ -1,8 +1,8 @@
+import type { FrontmatterType } from '@inkeep/open-knowledge-core/frontmatter/schema';
import {
- type FrontmatterType,
type LinterConfig,
selectGoverningFrontmatterSchemas,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
export interface SchemaField {
type: FrontmatterType;
diff --git a/packages/app/src/lib/handoff/dispatch.ts b/packages/app/src/lib/handoff/dispatch.ts
index 809cad99a..6c09f89f2 100644
--- a/packages/app/src/lib/handoff/dispatch.ts
+++ b/packages/app/src/lib/handoff/dispatch.ts
@@ -5,7 +5,7 @@ import {
type HandoffOutcome,
type HandoffPayload,
type HandoffTarget,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
interface DispatchHandoffDeps {
readonly fetch?: typeof globalThis.fetch;
diff --git a/packages/app/src/lib/handoff/install-detect.ts b/packages/app/src/lib/handoff/install-detect.ts
index bfbc10784..5ec34f54e 100644
--- a/packages/app/src/lib/handoff/install-detect.ts
+++ b/packages/app/src/lib/handoff/install-detect.ts
@@ -1,4 +1,4 @@
-import type { HandoffTarget, InstallState } from '@inkeep/open-knowledge-core';
+import type { HandoffTarget, InstallState } from '@inkeep/open-knowledge-core/handoff';
import { KNOWN_TARGETS } from './targets.ts';
export const UNIQUE_SCHEMES: ReadonlyArray<string> = [
diff --git a/packages/app/src/lib/handoff/open-external.ts b/packages/app/src/lib/handoff/open-external.ts
index 0d582451b..14a03f449 100644
--- a/packages/app/src/lib/handoff/open-external.ts
+++ b/packages/app/src/lib/handoff/open-external.ts
@@ -1,4 +1,4 @@
-import type { HandoffOutcome } from '@inkeep/open-knowledge-core';
+import type { HandoffOutcome } from '@inkeep/open-knowledge-core/handoff';
interface OpenExternalDeps {
readonly okDesktop?: { shell: { openExternal(url: string): Promise<void> } };
diff --git a/packages/app/src/lib/handoff/targets.ts b/packages/app/src/lib/handoff/targets.ts
index a74c118c9..b4cb68d69 100644
--- a/packages/app/src/lib/handoff/targets.ts
+++ b/packages/app/src/lib/handoff/targets.ts
@@ -1,4 +1,4 @@
export {
KNOWN_HANDOFF_TARGETS as KNOWN_TARGETS,
VISIBLE_HANDOFF_TARGETS as VISIBLE_TARGETS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/agent-registry';
diff --git a/packages/app/src/lib/handoff/telemetry.ts b/packages/app/src/lib/handoff/telemetry.ts
index b6781279c..333598504 100644
--- a/packages/app/src/lib/handoff/telemetry.ts
+++ b/packages/app/src/lib/handoff/telemetry.ts
@@ -2,7 +2,7 @@ import type {
HandoffFailureReason,
HandoffScope,
HandoffTarget,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
export type HandoffHost = 'electron' | 'web';
diff --git a/packages/app/src/lib/i18n.ts b/packages/app/src/lib/i18n.ts
index c6de58765..6df0b5083 100644
--- a/packages/app/src/lib/i18n.ts
+++ b/packages/app/src/lib/i18n.ts
@@ -1,4 +1,4 @@
-import { FALLBACK_LOCALE } from '@inkeep/open-knowledge-core';
+import { FALLBACK_LOCALE } from '@inkeep/open-knowledge-core/i18n/resolve-locale';
import type { Messages } from '@lingui/core';
import { i18n } from '@lingui/core';
import catalog from '@/locales/en/messages.json';
diff --git a/packages/app/src/lib/image-attachments.ts b/packages/app/src/lib/image-attachments.ts
index 7c74a4a68..5e160313a 100644
--- a/packages/app/src/lib/image-attachments.ts
+++ b/packages/app/src/lib/image-attachments.ts
@@ -4,7 +4,7 @@ import {
MAX_BUG_REPORT_ATTACHMENTS,
MAX_BUG_REPORT_ATTACHMENTS_TOTAL_BYTES,
type OkImageAttachmentContentType,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/logger-types';
export const MAX_IMAGE_ATTACHMENTS = MAX_BUG_REPORT_ATTACHMENTS;
diff --git a/packages/app/src/lib/install-client-log-forwarder.ts b/packages/app/src/lib/install-client-log-forwarder.ts
index f3ad99035..38baf6378 100644
--- a/packages/app/src/lib/install-client-log-forwarder.ts
+++ b/packages/app/src/lib/install-client-log-forwarder.ts
@@ -1,12 +1,12 @@
import {
- type ClientLogEntry,
parseStructuredConsoleMessage,
RENDERER_LOG_MAX_BATCH_BYTES,
RENDERER_LOG_MAX_ENTRIES,
RENDERER_LOG_MAX_MESSAGE_BYTES,
- scrubSecrets,
truncateLogMessage,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/logging/renderer-log';
+import { scrubSecrets } from '@inkeep/open-knowledge-core/logging/secret-scrub';
+import type { ClientLogEntry } from '@inkeep/open-knowledge-core/schemas/api';
const FORWARDER_MARKER = Symbol.for('ok.client.logForwarder');
diff --git a/packages/app/src/lib/install-onboarding-toast.ts b/packages/app/src/lib/install-onboarding-toast.ts
index f08d42898..054a94a07 100644
--- a/packages/app/src/lib/install-onboarding-toast.ts
+++ b/packages/app/src/lib/install-onboarding-toast.ts
@@ -1,4 +1,4 @@
-import { EDITOR_LABELS } from '@inkeep/open-knowledge-core';
+import { EDITOR_LABELS } from '@inkeep/open-knowledge-core/constants/editors';
import { plural, t } from '@lingui/core/macro';
import { toast as sonnerToast } from 'sonner';
import type { OkDesktopBridge } from '@/lib/desktop-bridge-types';
diff --git a/packages/app/src/lib/known-skill-dirs.ts b/packages/app/src/lib/known-skill-dirs.ts
index 820508128..701529150 100644
--- a/packages/app/src/lib/known-skill-dirs.ts
+++ b/packages/app/src/lib/known-skill-dirs.ts
@@ -1,4 +1,4 @@
-import type { SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
let knownDirs: ReadonlySet<string> = new Set();
diff --git a/packages/app/src/lib/language-telemetry.ts b/packages/app/src/lib/language-telemetry.ts
index ea29b6b52..503d0a687 100644
--- a/packages/app/src/lib/language-telemetry.ts
+++ b/packages/app/src/lib/language-telemetry.ts
@@ -1,4 +1,4 @@
-import type { LanguagePreference } from '@inkeep/open-knowledge-core';
+import type { LanguagePreference } from '@inkeep/open-knowledge-core/i18n/locales';
import { trace } from '@opentelemetry/api';
const TRACER_NAME = 'open-knowledge-app';
diff --git a/packages/app/src/lib/locale-load-failure-notice.ts b/packages/app/src/lib/locale-load-failure-notice.ts
index ccba2c2fd..f60c10a91 100644
--- a/packages/app/src/lib/locale-load-failure-notice.ts
+++ b/packages/app/src/lib/locale-load-failure-notice.ts
@@ -1,4 +1,4 @@
-import type { SupportedLocale } from '@inkeep/open-knowledge-core';
+import type { SupportedLocale } from '@inkeep/open-knowledge-core/i18n/locales';
import { t } from '@lingui/core/macro';
import { toast } from 'sonner';
import { i18n } from './i18n';
diff --git a/packages/app/src/lib/managed-artifact-doc-name.ts b/packages/app/src/lib/managed-artifact-doc-name.ts
index 6fc0fa61e..449ab45c8 100644
--- a/packages/app/src/lib/managed-artifact-doc-name.ts
+++ b/packages/app/src/lib/managed-artifact-doc-name.ts
@@ -1,10 +1,10 @@
import {
parseProjectSkillBundleDoc,
- type SkillsListEntry,
skillFileLiveDocName,
skillLiveDocName,
stripMdExt,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
export { skillLiveDocName };
diff --git a/packages/app/src/lib/native-menu-catalog.ts b/packages/app/src/lib/native-menu-catalog.ts
index e1f2066b6..9d08af9c3 100644
--- a/packages/app/src/lib/native-menu-catalog.ts
+++ b/packages/app/src/lib/native-menu-catalog.ts
@@ -1,4 +1,4 @@
-import type { NativeMenuLabelKey } from '@inkeep/open-knowledge-core';
+import type { NativeMenuLabelKey } from '@inkeep/open-knowledge-core/constants/native-menu-labels';
import type { MessageDescriptor } from '@lingui/core';
import { msg } from '@lingui/core/macro';
diff --git a/packages/app/src/lib/new-session-choice.ts b/packages/app/src/lib/new-session-choice.ts
index e66dbac24..38fa4ea5b 100644
--- a/packages/app/src/lib/new-session-choice.ts
+++ b/packages/app/src/lib/new-session-choice.ts
@@ -1,4 +1,4 @@
-import type { TerminalCli } from '@inkeep/open-knowledge-core';
+import type { TerminalCli } from '@inkeep/open-knowledge-core/handoff';
import type { RegisteredAgent } from '@/lib/acp/registered-agents';
export type NewSessionChoice =
diff --git a/packages/app/src/lib/onboarding-document-count.ts b/packages/app/src/lib/onboarding-document-count.ts
index e8c86fafa..18251fd78 100644
--- a/packages/app/src/lib/onboarding-document-count.ts
+++ b/packages/app/src/lib/onboarding-document-count.ts
@@ -1,4 +1,7 @@
-import { type DocumentListSuccess, DocumentListSuccessSchema } from '@inkeep/open-knowledge-core';
+import {
+ type DocumentListSuccess,
+ DocumentListSuccessSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
import { filterVisibleEntries } from '@/components/file-tree-utils';
export function countVisibleEntries(documents: DocumentListSuccess['documents']): number {
diff --git a/packages/app/src/lib/preferred-agent-store.ts b/packages/app/src/lib/preferred-agent-store.ts
index 6f8d77806..98c8e6905 100644
--- a/packages/app/src/lib/preferred-agent-store.ts
+++ b/packages/app/src/lib/preferred-agent-store.ts
@@ -1,4 +1,4 @@
-import type { HandoffTarget, InstallState } from '@inkeep/open-knowledge-core';
+import type { HandoffTarget, InstallState } from '@inkeep/open-knowledge-core/handoff';
import { VISIBLE_TARGETS } from '@/lib/handoff/targets';
import {
loadStickyAgent,
diff --git a/packages/app/src/lib/rendered-diff/build-rendered-diff.ts b/packages/app/src/lib/rendered-diff/build-rendered-diff.ts
index 5e4c53ca9..2d0983ec7 100644
--- a/packages/app/src/lib/rendered-diff/build-rendered-diff.ts
+++ b/packages/app/src/lib/rendered-diff/build-rendered-diff.ts
@@ -1,5 +1,5 @@
import { recreateTransform } from '@fellow/prosemirror-recreate-transform';
-import type { MarkdownManager } from '@inkeep/open-knowledge-core';
+import type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
import type { Node as PMNode, Schema } from '@tiptap/pm/model';
import { AddMarkStep, RemoveMarkStep, type Transform } from '@tiptap/pm/transform';
import { buildBlockChanges, type SpanChange } from './block-diff';
diff --git a/packages/app/src/lib/rendered-diff/diff-extensions.ts b/packages/app/src/lib/rendered-diff/diff-extensions.ts
index 7bb8b208f..7a273bb3b 100644
--- a/packages/app/src/lib/rendered-diff/diff-extensions.ts
+++ b/packages/app/src/lib/rendered-diff/diff-extensions.ts
@@ -1,4 +1,4 @@
-import { JsxComponent as CoreJsxComponent } from '@inkeep/open-knowledge-core';
+import { JsxComponent as CoreJsxComponent } from '@inkeep/open-knowledge-core/extensions/jsx-component';
import type { Extensions } from '@tiptap/core';
import { sharedExtensions } from '@/editor/extensions/shared';
diff --git a/packages/app/src/lib/reserved-property-keys.ts b/packages/app/src/lib/reserved-property-keys.ts
index 413b56ff1..6fdfd1da7 100644
--- a/packages/app/src/lib/reserved-property-keys.ts
+++ b/packages/app/src/lib/reserved-property-keys.ts
@@ -1,4 +1,4 @@
-import type { LintDiagnostic } from '@inkeep/open-knowledge-core';
+import type { LintDiagnostic } from '@inkeep/open-knowledge-core/markdown/lint';
export const SKILL_RESERVED_KEYS = ['name'] as const;
diff --git a/packages/app/src/lib/restart-collab-server.ts b/packages/app/src/lib/restart-collab-server.ts
index f71613430..5be04462d 100644
--- a/packages/app/src/lib/restart-collab-server.ts
+++ b/packages/app/src/lib/restart-collab-server.ts
@@ -1,4 +1,4 @@
-import { desktopChannelLabel } from '@inkeep/open-knowledge-core';
+import { desktopChannelLabel } from '@inkeep/open-knowledge-core/constants/product';
import { t } from '@lingui/core/macro';
import type { OkDesktopBridge, OkServerRestartFailure } from '@/lib/desktop-bridge-types';
diff --git a/packages/app/src/lib/saved-themes-client.ts b/packages/app/src/lib/saved-themes-client.ts
index c1fa4ff44..583f20532 100644
--- a/packages/app/src/lib/saved-themes-client.ts
+++ b/packages/app/src/lib/saved-themes-client.ts
@@ -1,8 +1,6 @@
import {
- type Base16Scheme,
type ProblemDetails,
ProblemDetailsSchema,
- parseSavedThemeId,
SavedThemeDeleteSuccessSchema,
type SavedThemeListEntry,
type SavedThemeSaveRequest,
@@ -13,7 +11,9 @@ import {
SavedThemesListSuccessSchema,
SavedThemeUpdateRequestSchema,
SavedThemeUpdateSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
+import type { Base16Scheme } from '@inkeep/open-knowledge-core/theme/base16';
+import { parseSavedThemeId } from '@inkeep/open-knowledge-core/theme/theme-plugins';
import {
createContext,
createElement,
diff --git a/packages/app/src/lib/seed-client.ts b/packages/app/src/lib/seed-client.ts
index bcef80612..9376c28de 100644
--- a/packages/app/src/lib/seed-client.ts
+++ b/packages/app/src/lib/seed-client.ts
@@ -1,4 +1,4 @@
-import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core';
+import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import type {
OkPackId,
diff --git a/packages/app/src/lib/server-info-refresh.ts b/packages/app/src/lib/server-info-refresh.ts
index 99d7d7cb0..95c668180 100644
--- a/packages/app/src/lib/server-info-refresh.ts
+++ b/packages/app/src/lib/server-info-refresh.ts
@@ -1,4 +1,4 @@
-import { ServerInfoSuccessSchema } from '@inkeep/open-knowledge-core';
+import { ServerInfoSuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { handleBranchSwitched } from '../editor/branch-invalidation';
import type { ProviderPool } from '../editor/provider-pool';
import { emitBranchChanged } from './documents-events';
diff --git a/packages/app/src/lib/share/branch-switch-flow.ts b/packages/app/src/lib/share/branch-switch-flow.ts
index a88f57584..63f26461c 100644
--- a/packages/app/src/lib/share/branch-switch-flow.ts
+++ b/packages/app/src/lib/share/branch-switch-flow.ts
@@ -1,9 +1,9 @@
+import type { WorktreeCreateResult } from '@inkeep/open-knowledge-core/git/worktree-selector-model';
import type {
BranchInfoResponse,
CheckoutResponse,
ShareTargetStatusResponse,
- WorktreeCreateResult,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
export type BranchSwitchVariant =
| {
diff --git a/packages/app/src/lib/share/publish-wizard.ts b/packages/app/src/lib/share/publish-wizard.ts
index 96c1134bc..df14474a2 100644
--- a/packages/app/src/lib/share/publish-wizard.ts
+++ b/packages/app/src/lib/share/publish-wizard.ts
@@ -6,12 +6,12 @@ import type {
SharePublishRequest,
SharePublishResponse,
SharePublishVisibility,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import {
SharePublishNameCheckResponseSchema,
SharePublishOwnersResponseSchema,
SharePublishResponseSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
const SHARE_PUBLISH_OWNERS_PATH = '/api/share/publish/owners';
diff --git a/packages/app/src/lib/share/receive-flow.ts b/packages/app/src/lib/share/receive-flow.ts
index 2dda6d6b0..ee7f90f0f 100644
--- a/packages/app/src/lib/share/receive-flow.ts
+++ b/packages/app/src/lib/share/receive-flow.ts
@@ -1,7 +1,7 @@
import {
canonicalGitHubRemoteUrl as _canonicalGitHubRemoteUrl,
type ExpectedShareRepo,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/sharing';
import { t } from '@lingui/core/macro';
import type {
CheckTargetExistsResult,
@@ -14,7 +14,7 @@ export {
type BranchMatchOutcome,
canonicalGitHubRemoteUrl,
type ExpectedShareRepo,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/sharing';
export function buildCloneUrl(expected: ExpectedShareRepo): string {
return _canonicalGitHubRemoteUrl(expected);
diff --git a/packages/app/src/lib/share/run-share-action.ts b/packages/app/src/lib/share/run-share-action.ts
index fc0f86819..83b12a036 100644
--- a/packages/app/src/lib/share/run-share-action.ts
+++ b/packages/app/src/lib/share/run-share-action.ts
@@ -3,8 +3,8 @@ import type {
ShareConstructUrlRequest,
ShareConstructUrlResponse,
ShareFreshness,
-} from '@inkeep/open-knowledge-core';
-import { ShareConstructUrlResponseSchema } from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
+import { ShareConstructUrlResponseSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { docNameToMarkdownPath } from '@/lib/doc-paths';
diff --git a/packages/app/src/lib/show-all-stream.ts b/packages/app/src/lib/show-all-stream.ts
index 9af11d325..ace4dfdcb 100644
--- a/packages/app/src/lib/show-all-stream.ts
+++ b/packages/app/src/lib/show-all-stream.ts
@@ -1,4 +1,7 @@
-import { type DocumentListEntry, DocumentListEntrySchema } from '@inkeep/open-knowledge-core';
+import {
+ type DocumentListEntry,
+ DocumentListEntrySchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
export const SHOW_ALL_NDJSON_ACCEPT = { Accept: 'application/x-ndjson, application/json' } as const;
diff --git a/packages/app/src/lib/sidebar-drag.ts b/packages/app/src/lib/sidebar-drag.ts
index 2491f099d..7c2315b01 100644
--- a/packages/app/src/lib/sidebar-drag.ts
+++ b/packages/app/src/lib/sidebar-drag.ts
@@ -1,4 +1,4 @@
-import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core';
+import type { InlineAssetMediaKind } from '@inkeep/open-knowledge-core/constants/upload';
import {
largeFileNavigationTarget,
type ResolvedNavigationTarget,
diff --git a/packages/app/src/lib/sidebar-partition.ts b/packages/app/src/lib/sidebar-partition.ts
index 3769ea80e..905506ca0 100644
--- a/packages/app/src/lib/sidebar-partition.ts
+++ b/packages/app/src/lib/sidebar-partition.ts
@@ -1,4 +1,4 @@
-import type { EmbeddedHost } from '@inkeep/open-knowledge-core';
+import type { EmbeddedHost } from '@inkeep/open-knowledge-core/constants/embedded-host';
export type Partition = 'above' | 'below' | 'embedded';
export type SidebarState = 'open' | 'collapsed';
diff --git a/packages/app/src/lib/skill-card-cost.ts b/packages/app/src/lib/skill-card-cost.ts
index 55e87d3b9..d9efefde1 100644
--- a/packages/app/src/lib/skill-card-cost.ts
+++ b/packages/app/src/lib/skill-card-cost.ts
@@ -1,4 +1,7 @@
-import { estimateSkillCost, type SkillCostTiers } from '@inkeep/open-knowledge-core';
+import {
+ estimateSkillCost,
+ type SkillCostTiers,
+} from '@inkeep/open-knowledge-core/skills-catalog/skill-cost';
import { fetchSkillPreview } from '@/lib/skills-api';
const cache = new Map<string, SkillCostTiers | null>();
diff --git a/packages/app/src/lib/skill-group-update.ts b/packages/app/src/lib/skill-group-update.ts
index 619d792f7..b4097f344 100644
--- a/packages/app/src/lib/skill-group-update.ts
+++ b/packages/app/src/lib/skill-group-update.ts
@@ -1,4 +1,4 @@
-import type { SkillsListEntry } from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import type { ProvenanceBucket } from '@/lib/skill-provenance-bucket';
export function groupUpdatableSkills(input: {
diff --git a/packages/app/src/lib/skill-install-rows.ts b/packages/app/src/lib/skill-install-rows.ts
index b3f41e606..ca12bb565 100644
--- a/packages/app/src/lib/skill-install-rows.ts
+++ b/packages/app/src/lib/skill-install-rows.ts
@@ -1,10 +1,13 @@
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
import type {
SkillInstallTarget,
- SkillsListEntry,
SkillTargetEditor,
SkillUserTargetEditor,
-} from '@inkeep/open-knowledge-core';
-import { SkillTargetEditorSchema, SkillUserTargetEditorSchema } from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/skill-targets/schema';
+import {
+ SkillTargetEditorSchema,
+ SkillUserTargetEditorSchema,
+} from '@inkeep/open-knowledge-core/skill-targets/schema';
import { customPlacementRoot, pluginCoverageOf, skillHostRootDir } from '@/lib/skill-scope';
export const INSTALL_EDITORS: readonly SkillTargetEditor[] = SkillTargetEditorSchema.options;
diff --git a/packages/app/src/lib/skill-name-set.ts b/packages/app/src/lib/skill-name-set.ts
index bbe015790..c8fcab69a 100644
--- a/packages/app/src/lib/skill-name-set.ts
+++ b/packages/app/src/lib/skill-name-set.ts
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { hashFromDocName, hashFromSkillPreview } from '@/lib/doc-hash';
import { subscribeToSkillsChanged } from '@/lib/documents-events';
import { skillEntryLiveDocName } from '@/lib/managed-artifact-doc-name';
diff --git a/packages/app/src/lib/skill-pins.ts b/packages/app/src/lib/skill-pins.ts
index 722e362f1..5920544c7 100644
--- a/packages/app/src/lib/skill-pins.ts
+++ b/packages/app/src/lib/skill-pins.ts
@@ -1,4 +1,5 @@
-import type { Config, SkillScope } from '@inkeep/open-knowledge-core';
+import type { Config } from '@inkeep/open-knowledge-core/config/schema';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
export const PIN_FIELD = { project: 'pinnedProjectSkills', global: 'pinnedGlobalSkills' } as const;
diff --git a/packages/app/src/lib/skill-provenance-bucket.ts b/packages/app/src/lib/skill-provenance-bucket.ts
index f11ae82bc..ceec050f9 100644
--- a/packages/app/src/lib/skill-provenance-bucket.ts
+++ b/packages/app/src/lib/skill-provenance-bucket.ts
@@ -1,8 +1,6 @@
-import {
- type CatalogSkill,
- parseSkillsShCatalogSource,
- type SkillsListEntry,
-} from '@inkeep/open-knowledge-core';
+import type { SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
+import type { CatalogSkill } from '@inkeep/open-knowledge-core/skills-catalog/schema';
+import { parseSkillsShCatalogSource } from '@inkeep/open-knowledge-core/skills-catalog/source-fields';
export interface ProvenanceBucket {
readonly kind: 'source' | 'plugin';
diff --git a/packages/app/src/lib/skill-scope.ts b/packages/app/src/lib/skill-scope.ts
index cdc96e3ef..465691067 100644
--- a/packages/app/src/lib/skill-scope.ts
+++ b/packages/app/src/lib/skill-scope.ts
@@ -1,12 +1,13 @@
import {
- AGENTS_SKILLS_ROOT,
EDITOR_PROJECT_SKILL_ROOT,
EDITOR_USER_SKILL_ROOT,
+} from '@inkeep/open-knowledge-core/constants/editors';
+import {
+ AGENTS_SKILLS_ROOT,
PACK_SKILL_PREFIX,
- type SkillScope,
- type SkillsListEntry,
- SkillUserTargetEditorSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/skills';
+import type { SkillScope, SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
+import { SkillUserTargetEditorSchema } from '@inkeep/open-knowledge-core/skill-targets/schema';
import { useLingui } from '@lingui/react/macro';
export function customPlacementRoot(placement: { path: string }): string {
diff --git a/packages/app/src/lib/skill-sort.ts b/packages/app/src/lib/skill-sort.ts
index e2bf76cc7..2c29898a6 100644
--- a/packages/app/src/lib/skill-sort.ts
+++ b/packages/app/src/lib/skill-sort.ts
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import type { FileTreeSortComparator } from '@pierre/trees';
import { SKILL_SCOPE_ORDER } from '@/lib/skill-scope';
diff --git a/packages/app/src/lib/skill-track-prompt-store.ts b/packages/app/src/lib/skill-track-prompt-store.ts
index ac74c4496..74ec806fc 100644
--- a/packages/app/src/lib/skill-track-prompt-store.ts
+++ b/packages/app/src/lib/skill-track-prompt-store.ts
@@ -1,4 +1,4 @@
-import type { SkillScope } from '@inkeep/open-knowledge-core';
+import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
export interface SkillTrackPrompt {
scope: SkillScope;
diff --git a/packages/app/src/lib/skills-api.ts b/packages/app/src/lib/skills-api.ts
index 8ba8ea3ba..b80e9e05b 100644
--- a/packages/app/src/lib/skills-api.ts
+++ b/packages/app/src/lib/skills-api.ts
@@ -1,27 +1,29 @@
import type {
SeedInstallPackSkillSuccess,
- SkillDetail,
- SkillDiscover,
SkillFolderLinkPreview,
SkillFrontmatter,
SkillInstallWarningCode,
SkillMoveFailureOutcome,
- SkillPreview,
- SkillRefResolution,
SkillScope,
SkillsImportBulkSuccess,
- SkillsInstalledSuccess,
SkillsListEntry,
SkillsReimportBulkSuccess,
- SkillsSearchSuccess,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import {
interpretSkillMoveFailure,
isSkillMoveRetainedDestinationCode,
normalizeApiWarnings,
SkillFolderLinkPreviewSchema,
SkillsListSuccessSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
+import type {
+ SkillDetail,
+ SkillDiscover,
+ SkillPreview,
+ SkillRefResolution,
+ SkillsInstalledSuccess,
+ SkillsSearchSuccess,
+} from '@inkeep/open-knowledge-core/skills-catalog/schema';
import { t } from '@lingui/core/macro';
import { toast } from 'sonner';
import { emitSkillScopeMoved, emitSkillsChanged } from '@/lib/documents-events';
diff --git a/packages/app/src/lib/skills-tree-paths.ts b/packages/app/src/lib/skills-tree-paths.ts
index a67d52400..0007ee613 100644
--- a/packages/app/src/lib/skills-tree-paths.ts
+++ b/packages/app/src/lib/skills-tree-paths.ts
@@ -1,9 +1,6 @@
-import {
- type CatalogSkill,
- catalogRawScopeToOkScope,
- type SkillScope,
- type SkillsListEntry,
-} from '@inkeep/open-knowledge-core';
+import type { SkillScope, SkillsListEntry } from '@inkeep/open-knowledge-core/schemas/api';
+import type { CatalogSkill } from '@inkeep/open-knowledge-core/skills-catalog/schema';
+import { catalogRawScopeToOkScope } from '@inkeep/open-knowledge-core/skills-catalog/scope';
import {
bucketForDetected,
bucketForSkill,
diff --git a/packages/app/src/lib/storage-scope.ts b/packages/app/src/lib/storage-scope.ts
index 17afdb677..de794ac32 100644
--- a/packages/app/src/lib/storage-scope.ts
+++ b/packages/app/src/lib/storage-scope.ts
@@ -3,7 +3,7 @@
* precedent #59: every client storage surface adopts it here instead of rediscovering the
* collision `provider-pool.ts` used to own privately.
*/
-import { fnv1aDigest } from '@inkeep/open-knowledge-core';
+import { fnv1aDigest } from '@inkeep/open-knowledge-core/bridge';
export function scopedStorageKey(baseKey: string, namespace: string | null): string {
if (namespace === null) return baseKey;
diff --git a/packages/app/src/lib/terminal-placement-store.ts b/packages/app/src/lib/terminal-placement-store.ts
index 112e615d0..d536d6d12 100644
--- a/packages/app/src/lib/terminal-placement-store.ts
+++ b/packages/app/src/lib/terminal-placement-store.ts
@@ -2,10 +2,10 @@ import {
DEFAULT_TERMINAL_PLACEMENT,
normalizeTerminalPlacement,
type TerminalPlacement,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/terminal-layout';
-export type { TerminalPlacement } from '@inkeep/open-knowledge-core';
-export { DEFAULT_TERMINAL_PLACEMENT } from '@inkeep/open-knowledge-core';
+export type { TerminalPlacement } from '@inkeep/open-knowledge-core/terminal-layout';
+export { DEFAULT_TERMINAL_PLACEMENT } from '@inkeep/open-knowledge-core/terminal-layout';
export const TERMINAL_PLACEMENT_KEY = 'ok-terminal-placement-v1';
diff --git a/packages/app/src/lib/terminal-right-width-store.ts b/packages/app/src/lib/terminal-right-width-store.ts
index 4800b9bb4..29d9f9e01 100644
--- a/packages/app/src/lib/terminal-right-width-store.ts
+++ b/packages/app/src/lib/terminal-right-width-store.ts
@@ -1,12 +1,12 @@
import {
normalizeTerminalRightWidth,
PREFERRED_TERMINAL_RIGHT_WIDTH,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/terminal-layout';
export {
MIN_TERMINAL_RIGHT_WIDTH,
PREFERRED_TERMINAL_RIGHT_WIDTH,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/terminal-layout';
export const TERMINAL_RIGHT_WIDTH_KEY = 'ok-terminal-right-width-v1';
diff --git a/packages/app/src/lib/theme-color-properties.ts b/packages/app/src/lib/theme-color-properties.ts
index c55b1d33c..9d31379f4 100644
--- a/packages/app/src/lib/theme-color-properties.ts
+++ b/packages/app/src/lib/theme-color-properties.ts
@@ -1,4 +1,5 @@
-import { base16ToTokens, PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core';
+import { PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core/constants/preview-theme-tokens';
+import { base16ToTokens } from '@inkeep/open-knowledge-core/theme/base16';
import { DEFAULT_CUSTOM_SCHEME } from './color-themes';
const PALETTE_THEME_COLOR_PROPERTIES = Object.keys(base16ToTokens(DEFAULT_CUSTOM_SCHEME)).map(
diff --git a/packages/app/src/lib/transports/auth-query-transport.ts b/packages/app/src/lib/transports/auth-query-transport.ts
index 725bfd806..4d87dfa77 100644
--- a/packages/app/src/lib/transports/auth-query-transport.ts
+++ b/packages/app/src/lib/transports/auth-query-transport.ts
@@ -1,4 +1,4 @@
-import { type ProblemDetails, ProblemDetailsSchema } from '@inkeep/open-knowledge-core';
+import { type ProblemDetails, ProblemDetailsSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { z } from 'zod';
import type {
diff --git a/packages/app/src/lib/transports/auth-transport.ts b/packages/app/src/lib/transports/auth-transport.ts
index cf3928d7e..f126b1deb 100644
--- a/packages/app/src/lib/transports/auth-transport.ts
+++ b/packages/app/src/lib/transports/auth-transport.ts
@@ -1,4 +1,4 @@
-import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core';
+import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { consumeAuthEventStream } from '@/components/auth-event-stream';
import type { OkDesktopBridge, OkLocalOpAuthEvent } from '@/lib/desktop-bridge-types';
diff --git a/packages/app/src/lib/transports/clone-transport.ts b/packages/app/src/lib/transports/clone-transport.ts
index e549645cb..8a30b97d3 100644
--- a/packages/app/src/lib/transports/clone-transport.ts
+++ b/packages/app/src/lib/transports/clone-transport.ts
@@ -1,4 +1,4 @@
-import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core';
+import { ProblemDetailsSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import type { OkDesktopBridge, OkLocalOpCloneEvent } from '@/lib/desktop-bridge-types';
import { createBufferedAsyncStream } from './buffered-async-stream';
diff --git a/packages/app/src/lib/transports/embeddings-key-transport.ts b/packages/app/src/lib/transports/embeddings-key-transport.ts
index e7e87e499..dd4965d2e 100644
--- a/packages/app/src/lib/transports/embeddings-key-transport.ts
+++ b/packages/app/src/lib/transports/embeddings-key-transport.ts
@@ -2,7 +2,7 @@ import {
type LocalOpEmbeddingsTestResponse,
LocalOpEmbeddingsTestResponseSchema,
ProblemDetailsSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
export interface EmbeddingsKeyTransport {
setKey(key: string): Promise<{ ok: true } | { ok: false; error?: string }>;
diff --git a/packages/app/src/lib/unified-agent-store.ts b/packages/app/src/lib/unified-agent-store.ts
index e775b2bc3..4887c7bb4 100644
--- a/packages/app/src/lib/unified-agent-store.ts
+++ b/packages/app/src/lib/unified-agent-store.ts
@@ -4,7 +4,7 @@ import {
type TargetData,
TERMINAL_CLI_IDS,
type TerminalCli,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/handoff';
import { useSyncExternalStore } from 'react';
import { VISIBLE_TARGETS } from '@/lib/handoff/targets';
diff --git a/packages/app/src/lib/use-activity-panel.ts b/packages/app/src/lib/use-activity-panel.ts
index 2f6a05b04..a2b2ebe12 100644
--- a/packages/app/src/lib/use-activity-panel.ts
+++ b/packages/app/src/lib/use-activity-panel.ts
@@ -1,12 +1,12 @@
+import type { FrontmatterDelta } from '@inkeep/open-knowledge-core/frontmatter-diff';
import {
type ActivityAgentHeader,
type ActivityBurst,
type ActivityFile,
AgentActivitySuccessSchema,
AgentBurstDiffSuccessSchema,
- type FrontmatterDelta,
ProblemDetailsSchema,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useRef, useState } from 'react';
import { useDocumentContext } from '@/editor/DocumentContext';
import { HttpResponseParseError } from '@/editor/http-client';
diff --git a/packages/app/src/lib/use-apply-config-color-theme.ts b/packages/app/src/lib/use-apply-config-color-theme.ts
index 167afe8d9..945c086a9 100644
--- a/packages/app/src/lib/use-apply-config-color-theme.ts
+++ b/packages/app/src/lib/use-apply-config-color-theme.ts
@@ -1,4 +1,4 @@
-import { renderThemeBlock } from '@inkeep/open-knowledge-core';
+import { renderThemeBlock } from '@inkeep/open-knowledge-core/theme/theme-plugins';
import { useEffect } from 'react';
import {
base16ToTokens,
diff --git a/packages/app/src/lib/use-apply-config-language.ts b/packages/app/src/lib/use-apply-config-language.ts
index 72977f385..d2e993c89 100644
--- a/packages/app/src/lib/use-apply-config-language.ts
+++ b/packages/app/src/lib/use-apply-config-language.ts
@@ -1,12 +1,12 @@
+import { readBrowserLanguages } from '@inkeep/open-knowledge-core/i18n/browser-locale-provider';
+import { localeDirection } from '@inkeep/open-knowledge-core/i18n/direction';
import {
AUTO_DETECTABLE_LOCALES,
type LanguagePreference,
- localeDirection,
- readBrowserLanguages,
- resolveLocale,
SUPPORTED_LOCALES,
type SupportedLocale,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/i18n/locales';
+import { resolveLocale } from '@inkeep/open-knowledge-core/i18n/resolve-locale';
import { useEffect } from 'react';
import { dynamicActivate } from './activate-locale';
import { activatePseudoLocale, isPseudoLocaleRequested } from './dev-pseudo-locale';
diff --git a/packages/app/src/lib/use-boolean-frontmatter-field.ts b/packages/app/src/lib/use-boolean-frontmatter-field.ts
index 0588568c6..037d6ebf0 100644
--- a/packages/app/src/lib/use-boolean-frontmatter-field.ts
+++ b/packages/app/src/lib/use-boolean-frontmatter-field.ts
@@ -5,7 +5,8 @@
*/
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import { bindFrontmatterDoc, type FrontmatterMap } from '@inkeep/open-knowledge-core';
+import { bindFrontmatterDoc } from '@inkeep/open-knowledge-core/bridge';
+import type { FrontmatterMap } from '@inkeep/open-knowledge-core/frontmatter/schema';
import { useEffect, useState } from 'react';
function isFlagEnabled(map: FrontmatterMap, key: string): boolean {
diff --git a/packages/app/src/lib/use-frontmatter-field.ts b/packages/app/src/lib/use-frontmatter-field.ts
index e96d4eb83..76b946726 100644
--- a/packages/app/src/lib/use-frontmatter-field.ts
+++ b/packages/app/src/lib/use-frontmatter-field.ts
@@ -1,5 +1,5 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import { bindFrontmatterDoc } from '@inkeep/open-knowledge-core';
+import { bindFrontmatterDoc } from '@inkeep/open-knowledge-core/bridge';
import { useEffect, useRef, useState } from 'react';
import { withPreviewTabPromotion } from '@/editor/preview-tab-promotion';
diff --git a/packages/app/src/lib/use-timeline-entry-diff.ts b/packages/app/src/lib/use-timeline-entry-diff.ts
index e36a579b1..250b91050 100644
--- a/packages/app/src/lib/use-timeline-entry-diff.ts
+++ b/packages/app/src/lib/use-timeline-entry-diff.ts
@@ -1,8 +1,8 @@
+import { stripFrontmatter } from '@inkeep/open-knowledge-core/extensions/frontmatter';
import {
diffFrontmatter,
type FrontmatterDelta,
- stripFrontmatter,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/frontmatter-diff';
import { createPatch } from 'diff';
import { useEffect, useRef, useState } from 'react';
import { useDocumentContext } from '@/editor/DocumentContext';
diff --git a/packages/app/src/lib/use-workspace.ts b/packages/app/src/lib/use-workspace.ts
index 7fc9eac97..91f015d11 100644
--- a/packages/app/src/lib/use-workspace.ts
+++ b/packages/app/src/lib/use-workspace.ts
@@ -1,4 +1,4 @@
-import { WorkspaceSuccessSchema } from '@inkeep/open-knowledge-core';
+import { WorkspaceSuccessSchema } from '@inkeep/open-knowledge-core/schemas/api';
import { useEffect, useState } from 'react';
import type { Workspace } from './workspace-paths';
diff --git a/packages/app/src/lib/validation-store.ts b/packages/app/src/lib/validation-store.ts
index 2c312b6fd..005365b0e 100644
--- a/packages/app/src/lib/validation-store.ts
+++ b/packages/app/src/lib/validation-store.ts
@@ -3,7 +3,7 @@ import {
type ValidationDocCounts,
type ValidationSourceCounts,
type ValidationSourceKey,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/markdown/lint';
import { filePathToDocName } from '@/lib/doc-hash';
export type DocProblemCounts = ValidationSourceCounts;
diff --git a/packages/app/src/lib/worktree-create-error.ts b/packages/app/src/lib/worktree-create-error.ts
index af678fb4a..11ac62413 100644
--- a/packages/app/src/lib/worktree-create-error.ts
+++ b/packages/app/src/lib/worktree-create-error.ts
@@ -1,4 +1,4 @@
-import type { WorktreeCreateResult } from '@inkeep/open-knowledge-core';
+import type { WorktreeCreateResult } from '@inkeep/open-knowledge-core/git/worktree-selector-model';
import type { MessageDescriptor } from '@lingui/core';
import { msg } from '@lingui/core/macro';
diff --git a/packages/app/src/lib/worktree-store.ts b/packages/app/src/lib/worktree-store.ts
index 21520dcfb..e2f51d869 100644
--- a/packages/app/src/lib/worktree-store.ts
+++ b/packages/app/src/lib/worktree-store.ts
@@ -1,4 +1,4 @@
-import type { WorktreeSelectorModel } from '@inkeep/open-knowledge-core';
+import type { WorktreeSelectorModel } from '@inkeep/open-knowledge-core/git/worktree-selector-model';
export interface WorktreeStore {
getSnapshot(): WorktreeSelectorModel | null;
diff --git a/packages/app/src/presence/PresenceBar.tsx b/packages/app/src/presence/PresenceBar.tsx
index 1073ea3fd..1864af53d 100644
--- a/packages/app/src/presence/PresenceBar.tsx
+++ b/packages/app/src/presence/PresenceBar.tsx
@@ -2,10 +2,9 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
import {
type AgentPresenceEntry,
- computeInitials,
- deriveIconColor,
isPresenceSentinelDocName,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/types/awareness';
+import { computeInitials, deriveIconColor } from '@inkeep/open-knowledge-core/utils/identity';
import { plural, t } from '@lingui/core/macro';
import { Trans, useLingui } from '@lingui/react/macro';
import {
diff --git a/packages/app/src/presence/identity.ts b/packages/app/src/presence/identity.ts
index 613b5d4d0..58aaae6a8 100644
--- a/packages/app/src/presence/identity.ts
+++ b/packages/app/src/presence/identity.ts
@@ -1,9 +1,6 @@
-import {
- type AwarenessState,
- type AwarenessUser,
- getIdentity,
- type Identity,
-} from '@inkeep/open-knowledge-core';
+import type { AwarenessState, AwarenessUser } from '@inkeep/open-knowledge-core/types/awareness';
+import type { Identity } from '@inkeep/open-knowledge-core/types/identity';
+import { getIdentity } from '@inkeep/open-knowledge-core/utils/identity';
import { useState } from 'react';
export type { AwarenessState, AwarenessUser };
diff --git a/packages/app/src/presence/participant-model.ts b/packages/app/src/presence/participant-model.ts
index 5c746cf06..a8a645b26 100644
--- a/packages/app/src/presence/participant-model.ts
+++ b/packages/app/src/presence/participant-model.ts
@@ -1,4 +1,4 @@
-import type { AgentPresenceEntry } from '@inkeep/open-knowledge-core';
+import type { AgentPresenceEntry } from '@inkeep/open-knowledge-core/types/awareness';
import type { AwarenessState, AwarenessUser } from './identity.ts';
export interface HumanParticipant {
diff --git a/packages/app/src/presence/use-presence.ts b/packages/app/src/presence/use-presence.ts
index b2798f76d..e5b05e8a1 100644
--- a/packages/app/src/presence/use-presence.ts
+++ b/packages/app/src/presence/use-presence.ts
@@ -1,5 +1,5 @@
import type { HocuspocusProvider } from '@hocuspocus/provider';
-import type { AgentPresenceEntry } from '@inkeep/open-knowledge-core';
+import type { AgentPresenceEntry } from '@inkeep/open-knowledge-core/types/awareness';
import { useEffect, useState } from 'react';
import {
type AgentPresenceAwareness,
diff --git a/packages/app/src/server/hocuspocus-plugin.ts b/packages/app/src/server/hocuspocus-plugin.ts
index 349609f4a..e1706e677 100644
--- a/packages/app/src/server/hocuspocus-plugin.ts
+++ b/packages/app/src/server/hocuspocus-plugin.ts
@@ -4,7 +4,7 @@ import {
ASSET_EXTENSIONS,
EXECUTABLE_BLOCKLIST_EXTENSIONS,
INLINE_RENDERABLE_EXTENSIONS,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/upload';
import { okUserHomeDir } from '@inkeep/open-knowledge-core/server';
import {
AcpThreadManager,
diff --git a/packages/app/src/test-utils/served-binding.test-helper.test.ts b/packages/app/src/test-utils/served-binding.test-helper.test.ts
new file mode 100644
index 000000000..eebcf0602
--- /dev/null
+++ b/packages/app/src/test-utils/served-binding.test-helper.test.ts
@@ -0,0 +1,52 @@
+import { describe, expect, test } from 'vitest';
+import { createServedBindingLog } from './served-binding.test-helper';
+
+const SPECIFIER = 'fixture-module';
+const THIS_FILE = 'test-utils/served-binding.test-helper.test.ts';
+
+describe('served-binding log', () => {
+ test('a served member reads through to the live value of the original export', () => {
+ let flag = false;
+ const log = createServedBindingLog();
+ const served = log.serve(SPECIFIER, {
+ get FLAG() {
+ return flag;
+ },
+ });
+
+ expect(served.FLAG).toBe(false);
+ flag = true;
+ expect(served.FLAG).toBe(true);
+ });
+
+ test('a read is attributed to the source file that performed it, not to the log', () => {
+ const log = createServedBindingLog();
+ const served = log.serve(SPECIFIER, { value: 1 });
+
+ expect([served].map((exports) => exports.value)).toEqual([1]);
+ expect(log.readersOf(SPECIFIER, 'value')).toEqual([THIS_FILE]);
+ });
+
+ test('readers are counted per member and only after the given mark', () => {
+ const log = createServedBindingLog();
+ const served = log.serve(SPECIFIER, { early: 1, late: 2, unread: 3 });
+
+ expect(served.early).toBe(1);
+ const since = log.mark();
+ expect(served.late).toBe(2);
+
+ expect(log.readersOf(SPECIFIER, 'early')).toEqual([THIS_FILE]);
+ expect(log.readersOf(SPECIFIER, 'early', since)).toEqual([]);
+ expect(log.readersOf(SPECIFIER, 'late', since)).toEqual([THIS_FILE]);
+ expect(log.readersOf(SPECIFIER, 'unread')).toEqual([]);
+ expect(log.readersOf('another-module', 'late')).toEqual([]);
+ });
+
+ test('serving a module reads none of its members', () => {
+ const log = createServedBindingLog();
+ const served = log.serve(SPECIFIER, { value: 1 });
+
+ expect(Object.keys(served)).toEqual(['value']);
+ expect(log.readersOf(SPECIFIER, 'value')).toEqual([]);
+ });
+});
diff --git a/packages/app/src/test-utils/served-binding.test-helper.ts b/packages/app/src/test-utils/served-binding.test-helper.ts
new file mode 100644
index 000000000..3549c857b
--- /dev/null
+++ b/packages/app/src/test-utils/served-binding.test-helper.ts
@@ -0,0 +1,73 @@
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+interface ServedRead {
+ readonly specifier: string;
+ readonly member: string;
+ readonly reader: string;
+}
+
+interface ServedBindingLog {
+ serve<T extends object>(specifier: string, exports: T): T;
+ mark(): number;
+ readersOf(specifier: string, member: string, since?: number): string[];
+}
+
+const HELPER_FILE = fileURLToPath(import.meta.url);
+const APP_SOURCE_ROOT = dirname(dirname(HELPER_FILE));
+const UNKNOWN_READER = '<unknown>';
+const STACK_DEPTH = 64;
+
+function frameLocation(frame: string): string | undefined {
+ const trimmed = frame.trim();
+ if (!trimmed.startsWith('at ')) return undefined;
+ const inParens = /\((.+)\)$/.exec(trimmed);
+ const location = inParens?.[1] ?? trimmed.slice('at '.length);
+ const file = location.replace(/:\d+:\d+$/, '');
+ if (file === location) return undefined;
+ const path = file.startsWith('file://') ? fileURLToPath(file) : file;
+ return isAbsolute(path) ? resolve(path) : undefined;
+}
+
+function readerFrom(stack: string | undefined): string {
+ for (const frame of (stack ?? '').split('\n').slice(1)) {
+ const file = frameLocation(frame);
+ if (file === undefined || file === HELPER_FILE) continue;
+ if (file.split(/[\\/]/).includes('node_modules')) continue;
+ return relative(APP_SOURCE_ROOT, file).split(sep).join('/');
+ }
+ return UNKNOWN_READER;
+}
+
+export function createServedBindingLog(): ServedBindingLog {
+ const log: ServedRead[] = [];
+ return {
+ serve<T extends object>(specifier: string, exports: T): T {
+ const served = {};
+ for (const member of Object.keys(exports)) {
+ Object.defineProperty(served, member, {
+ enumerable: true,
+ get() {
+ const limit = Error.stackTraceLimit;
+ Error.stackTraceLimit = STACK_DEPTH;
+ const stack = new Error().stack;
+ Error.stackTraceLimit = limit;
+ log.push({ specifier, member, reader: readerFrom(stack) });
+ return Reflect.get(exports, member);
+ },
+ });
+ }
+ return served as T;
+ },
+ mark() {
+ return log.length;
+ },
+ readersOf(specifier, member, since = 0) {
+ const readers = log
+ .slice(since)
+ .filter((read) => read.specifier === specifier && read.member === member)
+ .map((read) => read.reader);
+ return [...new Set(readers)].sort();
+ },
+ };
+}
diff --git a/packages/app/src/uninstall/UninstallApp.tsx b/packages/app/src/uninstall/UninstallApp.tsx
index da35be02e..e2231d745 100644
--- a/packages/app/src/uninstall/UninstallApp.tsx
+++ b/packages/app/src/uninstall/UninstallApp.tsx
@@ -1,7 +1,7 @@
import {
UNINSTALL_RESULT_WAIT_TIMEOUT_MS,
type UninstallScreenSpec,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/uninstall-bridge';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useState } from 'react';
import {
diff --git a/packages/app/src/uninstall/UninstallNoticeScreen.tsx b/packages/app/src/uninstall/UninstallNoticeScreen.tsx
index 470e88df1..3dc2fae5c 100644
--- a/packages/app/src/uninstall/UninstallNoticeScreen.tsx
+++ b/packages/app/src/uninstall/UninstallNoticeScreen.tsx
@@ -1,7 +1,7 @@
import type {
UninstallNoticeChecklistItem,
UninstallNoticeScreen as UninstallNoticeSpec,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/uninstall-bridge';
import { Trans, useLingui } from '@lingui/react/macro';
import { Check } from 'lucide-react';
import { useEffect, useId, useRef } from 'react';
diff --git a/packages/app/src/uninstall/UninstallPickerScreen.tsx b/packages/app/src/uninstall/UninstallPickerScreen.tsx
index a722cd3be..f9bbb13e2 100644
--- a/packages/app/src/uninstall/UninstallPickerScreen.tsx
+++ b/packages/app/src/uninstall/UninstallPickerScreen.tsx
@@ -1,4 +1,4 @@
-import type { UninstallProjectRow } from '@inkeep/open-knowledge-core';
+import type { UninstallProjectRow } from '@inkeep/open-knowledge-core/uninstall-bridge';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useId, useState } from 'react';
import { Badge } from '@/components/ui/badge';
diff --git a/packages/app/src/uninstall/UninstallResultScreen.tsx b/packages/app/src/uninstall/UninstallResultScreen.tsx
index f8daad2e5..af91fd007 100644
--- a/packages/app/src/uninstall/UninstallResultScreen.tsx
+++ b/packages/app/src/uninstall/UninstallResultScreen.tsx
@@ -1,4 +1,4 @@
-import type { UninstallNoticeScreen as UninstallNoticeSpec } from '@inkeep/open-knowledge-core';
+import type { UninstallNoticeScreen as UninstallNoticeSpec } from '@inkeep/open-knowledge-core/uninstall-bridge';
import { useLingui } from '@lingui/react/macro';
import { UninstallNoticeScreen } from './UninstallNoticeScreen';
diff --git a/packages/app/src/uninstall/UninstallSurveyScreen.tsx b/packages/app/src/uninstall/UninstallSurveyScreen.tsx
index 23d9bf71e..ccbd433a5 100644
--- a/packages/app/src/uninstall/UninstallSurveyScreen.tsx
+++ b/packages/app/src/uninstall/UninstallSurveyScreen.tsx
@@ -3,7 +3,7 @@ import {
UNINSTALL_FEEDBACK_NOTE_MAX_LEN,
UNINSTALL_FEEDBACK_REASONS,
type UninstallFeedbackReason,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/constants/uninstall-feedback';
import { Trans, useLingui } from '@lingui/react/macro';
import { useEffect, useId, useRef, useState } from 'react';
import { Button } from '@/components/ui/button';
diff --git a/packages/app/src/uninstall/bridge.ts b/packages/app/src/uninstall/bridge.ts
index 0a694b295..0142e038c 100644
--- a/packages/app/src/uninstall/bridge.ts
+++ b/packages/app/src/uninstall/bridge.ts
@@ -2,7 +2,7 @@ import type {
OkUninstallBridge,
UninstallDispatchResult,
UninstallIntent,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/uninstall-bridge';
declare global {
interface Window {
diff --git a/packages/app/src/uninstall/locale.ts b/packages/app/src/uninstall/locale.ts
index 005b89c06..4cca9bb5f 100644
--- a/packages/app/src/uninstall/locale.ts
+++ b/packages/app/src/uninstall/locale.ts
@@ -1,9 +1,9 @@
+import { readBrowserLanguages } from '@inkeep/open-knowledge-core/i18n/browser-locale-provider';
import {
AUTO_DETECTABLE_LOCALES,
- readBrowserLanguages,
- resolveLocale,
SUPPORTED_LOCALES,
-} from '@inkeep/open-knowledge-core';
+} from '@inkeep/open-knowledge-core/i18n/locales';
+import { resolveLocale } from '@inkeep/open-knowledge-core/i18n/resolve-locale';
import { dynamicActivate } from '@/lib/activate-locale';
import {
applyLanguageToDom,
diff --git a/packages/app/tests/integration/bug3-source-mode-writeback.test.ts b/packages/app/tests/integration/bug3-source-mode-writeback.test.ts
index 8a60e5826..a28cc2b18 100644
--- a/packages/app/tests/integration/bug3-source-mode-writeback.test.ts
+++ b/packages/app/tests/integration/bug3-source-mode-writeback.test.ts
@@ -1,3 +1,4 @@
+
import { readFileSync } from 'node:fs';
import { join } from 'node:path';
import { setTimeout as wait } from 'node:timers/promises';
diff --git a/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts b/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts
index 6fcdc23f2..4fc2c11f9 100644
--- a/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts
+++ b/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { normalizeBridge } from '@inkeep/open-knowledge-core';
import { updateYFragment } from '@tiptap/y-tiptap';
diff --git a/packages/app/tests/integration/interior-edit-freshness.test.ts b/packages/app/tests/integration/interior-edit-freshness.test.ts
index 40b5cdfd6..9f2f6feb6 100644
--- a/packages/app/tests/integration/interior-edit-freshness.test.ts
+++ b/packages/app/tests/integration/interior-edit-freshness.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
diff --git a/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts b/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts
index 93666af70..2a085742b 100644
--- a/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts
+++ b/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
diff --git a/packages/app/tests/integration/producer-guard-wiring.test.ts b/packages/app/tests/integration/producer-guard-wiring.test.ts
index 867598d34..878d5196b 100644
--- a/packages/app/tests/integration/producer-guard-wiring.test.ts
+++ b/packages/app/tests/integration/producer-guard-wiring.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
diff --git a/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts b/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts
index 0970ac12f..4ada3cf26 100644
--- a/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts
+++ b/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts
@@ -1,3 +1,4 @@
+
import { randomUUID } from 'node:crypto';
import { afterEach, describe, expect, test } from 'vitest';
import { agentWriteMd, createTestServer, type TestServer } from './test-harness';
diff --git a/packages/app/tests/integration/qa-045-restore-after-gc.test.ts b/packages/app/tests/integration/qa-045-restore-after-gc.test.ts
index b632185e1..cbe2b705f 100644
--- a/packages/app/tests/integration/qa-045-restore-after-gc.test.ts
+++ b/packages/app/tests/integration/qa-045-restore-after-gc.test.ts
@@ -1,3 +1,4 @@
+
import { execFileSync } from 'node:child_process';
import { randomUUID } from 'node:crypto';
import { join } from 'node:path';
diff --git a/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts b/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts
index c530ce4ba..89bc9b4d9 100644
--- a/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts
+++ b/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts
@@ -1,3 +1,4 @@
+
import { randomUUID } from 'node:crypto';
import { afterAll, afterEach, beforeAll, describe, expect, test } from 'vitest';
import type * as Y from 'yjs';
diff --git a/packages/app/tests/integration/undo-after-rollback.test.ts b/packages/app/tests/integration/undo-after-rollback.test.ts
index d3767adc9..a78aeb0e4 100644
--- a/packages/app/tests/integration/undo-after-rollback.test.ts
+++ b/packages/app/tests/integration/undo-after-rollback.test.ts
@@ -1,3 +1,4 @@
+
import { ROLLBACK_ORIGIN } from '@inkeep/open-knowledge-server';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
import * as Y from 'yjs';
diff --git a/packages/app/tests/integration/undo-recycle-reset.test.ts b/packages/app/tests/integration/undo-recycle-reset.test.ts
index b076f955c..e7cc69c3f 100644
--- a/packages/app/tests/integration/undo-recycle-reset.test.ts
+++ b/packages/app/tests/integration/undo-recycle-reset.test.ts
@@ -1,3 +1,4 @@
+
import { writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { setTimeout as wait } from 'node:timers/promises';
diff --git a/packages/app/tests/integration/undo-rederive-survival.test.ts b/packages/app/tests/integration/undo-rederive-survival.test.ts
index 7935e35f8..9ddcd0730 100644
--- a/packages/app/tests/integration/undo-rederive-survival.test.ts
+++ b/packages/app/tests/integration/undo-rederive-survival.test.ts
@@ -1,3 +1,4 @@
+
import { prependFrontmatter } from '@inkeep/open-knowledge-core';
import { Plugin, PluginKey } from '@tiptap/pm/state';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
diff --git a/packages/app/tests/measure/first-load.config.ts b/packages/app/tests/measure/first-load.config.ts
new file mode 100644
index 000000000..71342e17f
--- /dev/null
+++ b/packages/app/tests/measure/first-load.config.ts
@@ -0,0 +1,18 @@
+import { defineConfig } from '@playwright/test';
+import suiteConfig from '../../playwright.config.ts';
+
+export default defineConfig({
+ testDir: '.',
+ testMatch: /first-load\.measure\.ts$/,
+ globalSetup: [
+ '../stress/_helpers/i18n-catalog-freshness.ts',
+ '../stress/_helpers/global-warm-cache.ts',
+ ],
+ timeout: 300_000,
+ retries: 0,
+ workers: 1,
+ fullyParallel: false,
+ forbidOnly: true,
+ reporter: [['list']],
+ use: suiteConfig.use,
+});
diff --git a/packages/app/tests/measure/first-load.measure.ts b/packages/app/tests/measure/first-load.measure.ts
new file mode 100644
index 000000000..0167e8351
--- /dev/null
+++ b/packages/app/tests/measure/first-load.measure.ts
@@ -0,0 +1,144 @@
+import { writeFileSync } from 'node:fs';
+import { performance } from 'node:perf_hooks';
+import {
+ type Browser,
+ type BrowserContext,
+ expect,
+ type Locator,
+ type Page,
+} from '@playwright/test';
+import { test as base } from '../stress/_helpers/fixtures.ts';
+
+interface FirstLoadMarks {
+ workerSetupStart?: number;
+ contextStart?: number;
+ pageReady?: number;
+ navigationStart?: number;
+ navigationSettled?: number;
+ navigationOk?: boolean;
+ treeVisibleAt?: number;
+ treeVisible?: boolean;
+ workerSetupEnd?: number;
+}
+
+interface RendererRequest {
+ url: string;
+ resourceType: string;
+ at: number;
+}
+
+interface FirstLoadObservation {
+ schema: 1;
+ baseURL: string;
+ marks: FirstLoadMarks;
+ requests: RendererRequest[];
+}
+
+const marks: FirstLoadMarks = {};
+const requests: RendererRequest[] = [];
+
+function observeThrough<T extends object>(target: T, overrides: Record<PropertyKey, unknown>): T {
+ return new Proxy(target, {
+ get(subject, property) {
+ if (Object.hasOwn(overrides, property)) return overrides[property];
+ const value: unknown = Reflect.get(subject, property, subject);
+ return typeof value === 'function' ? value.bind(subject) : value;
+ },
+ });
+}
+
+function observeLocator(locator: Locator): Locator {
+ return observeThrough(locator, {
+ waitFor: async (...args: Parameters<Locator['waitFor']>) => {
+ await locator.waitFor(...args);
+ if (marks.treeVisibleAt === undefined && marks.navigationStart !== undefined) {
+ marks.treeVisibleAt = performance.now();
+ marks.treeVisible = true;
+ }
+ },
+ });
+}
+
+function observePage(page: Page): Page {
+ page.on('request', (request) => {
+ requests.push({
+ url: request.url(),
+ resourceType: request.resourceType(),
+ at: performance.now(),
+ });
+ });
+ return observeThrough(page, {
+ goto: (...args: Parameters<Page['goto']>) => {
+ if (marks.navigationStart !== undefined) return page.goto(...args);
+ marks.navigationStart = performance.now();
+ const navigation = page.goto(...args);
+ navigation.then(
+ () => {
+ marks.navigationSettled = performance.now();
+ marks.navigationOk = true;
+ },
+ () => {
+ marks.navigationSettled = performance.now();
+ marks.navigationOk = false;
+ },
+ );
+ return navigation;
+ },
+ getByRole: (...args: Parameters<Page['getByRole']>) => observeLocator(page.getByRole(...args)),
+ });
+}
+
+function observeContext(context: BrowserContext): BrowserContext {
+ return observeThrough(context, {
+ newPage: async () => {
+ const page = await context.newPage();
+ marks.pageReady ??= performance.now();
+ return observePage(page);
+ },
+ });
+}
+
+function observeBrowser(browser: Browser): Browser {
+ return observeThrough(browser, {
+ newContext: async (...args: Parameters<Browser['newContext']>) => {
+ marks.contextStart ??= performance.now();
+ return observeContext(await browser.newContext(...args));
+ },
+ });
+}
+
+const test = base.extend<object, { firstLoadObservation: FirstLoadObservation }>({
+ browser: [
+ async ({ browser }, use) => {
+ marks.workerSetupStart = performance.now();
+ await use(observeBrowser(browser));
+ },
+ { scope: 'worker' },
+ ],
+ firstLoadObservation: [
+ async ({ workerServer }, use) => {
+ marks.workerSetupEnd = performance.now();
+ const observation: FirstLoadObservation = {
+ schema: 1,
+ baseURL: workerServer.baseURL,
+ marks: { ...marks },
+ requests: [...requests],
+ };
+ const out = process.env.OK_MEASURE_OBSERVATION_OUT;
+ if (!out) {
+ throw new Error(
+ 'OK_MEASURE_OBSERVATION_OUT must name the file this observation is written to',
+ );
+ }
+ writeFileSync(out, `${JSON.stringify(observation)}\n`);
+ await use(observation);
+ },
+ { scope: 'worker' },
+ ],
+});
+
+test('the worker warm-up loads the app and shows the required tree item', ({
+ firstLoadObservation,
+}) => {
+ expect(firstLoadObservation.marks).toMatchObject({ navigationOk: true, treeVisible: true });
+});
diff --git a/packages/core/package.json b/packages/core/package.json
index 8915a9286..fd900bba5 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -88,6 +88,726 @@
"development": "./src/desktop-bridge.ts",
"types": "./dist/desktop-bridge.d.mts",
"default": "./dist/desktop-bridge.mjs"
+ },
+ "./agent-registry": {
+ "@inkeep/source": "./src/agent-registry/index.ts",
+ "development": "./src/agent-registry/index.ts",
+ "types": "./dist/agent-registry.d.mts",
+ "default": "./dist/agent-registry.mjs"
+ },
+ "./bridge": {
+ "@inkeep/source": "./src/bridge/index.ts",
+ "development": "./src/bridge/index.ts",
+ "types": "./dist/bridge.d.mts",
+ "default": "./dist/bridge.mjs"
+ },
+ "./bug-report-sidecar/note-content": {
+ "@inkeep/source": "./src/bug-report-sidecar/note-content.ts",
+ "development": "./src/bug-report-sidecar/note-content.ts",
+ "types": "./dist/bug-report-sidecar-note-content.d.mts",
+ "default": "./dist/bug-report-sidecar-note-content.mjs"
+ },
+ "./checkpoint-kinds": {
+ "@inkeep/source": "./src/checkpoint-kinds.ts",
+ "development": "./src/checkpoint-kinds.ts",
+ "types": "./dist/checkpoint-kinds.d.mts",
+ "default": "./dist/checkpoint-kinds.mjs"
+ },
+ "./client-version": {
+ "@inkeep/source": "./src/client-version.ts",
+ "development": "./src/client-version.ts",
+ "types": "./dist/client-version.d.mts",
+ "default": "./dist/client-version.mjs"
+ },
+ "./commands/command-identity": {
+ "@inkeep/source": "./src/commands/command-identity.ts",
+ "development": "./src/commands/command-identity.ts",
+ "types": "./dist/commands-command-identity.d.mts",
+ "default": "./dist/commands-command-identity.mjs"
+ },
+ "./comments/leaf-text": {
+ "@inkeep/source": "./src/comments/leaf-text.ts",
+ "development": "./src/comments/leaf-text.ts",
+ "types": "./dist/comments-leaf-text.d.mts",
+ "default": "./dist/comments-leaf-text.mjs"
+ },
+ "./comments/passage-match": {
+ "@inkeep/source": "./src/comments/passage-match.ts",
+ "development": "./src/comments/passage-match.ts",
+ "types": "./dist/comments-passage-match.d.mts",
+ "default": "./dist/comments-passage-match.mjs"
+ },
+ "./config/auto-sync-mode": {
+ "@inkeep/source": "./src/config/auto-sync-mode.ts",
+ "development": "./src/config/auto-sync-mode.ts",
+ "types": "./dist/config-auto-sync-mode.d.mts",
+ "default": "./dist/config-auto-sync-mode.mjs"
+ },
+ "./config/bind-config-doc": {
+ "@inkeep/source": "./src/config/bind-config-doc.ts",
+ "development": "./src/config/bind-config-doc.ts",
+ "types": "./dist/config-bind-config-doc.d.mts",
+ "default": "./dist/config-bind-config-doc.mjs"
+ },
+ "./config/bind-okignore-doc": {
+ "@inkeep/source": "./src/config/bind-okignore-doc.ts",
+ "development": "./src/config/bind-okignore-doc.ts",
+ "types": "./dist/config-bind-okignore-doc.d.mts",
+ "default": "./dist/config-bind-okignore-doc.mjs"
+ },
+ "./config/errors": {
+ "@inkeep/source": "./src/config/errors.ts",
+ "development": "./src/config/errors.ts",
+ "types": "./dist/config-errors.d.mts",
+ "default": "./dist/config-errors.mjs"
+ },
+ "./config/field-registry": {
+ "@inkeep/source": "./src/config/field-registry.ts",
+ "development": "./src/config/field-registry.ts",
+ "types": "./dist/config-field-registry.d.mts",
+ "default": "./dist/config-field-registry.mjs"
+ },
+ "./config/merge-layered": {
+ "@inkeep/source": "./src/config/merge-layered.ts",
+ "development": "./src/config/merge-layered.ts",
+ "types": "./dist/config-merge-layered.d.mts",
+ "default": "./dist/config-merge-layered.mjs"
+ },
+ "./config/schema": {
+ "@inkeep/source": "./src/config/schema.ts",
+ "development": "./src/config/schema.ts",
+ "types": "./dist/config-schema.d.mts",
+ "default": "./dist/config-schema.mjs"
+ },
+ "./config/schema-leaf": {
+ "@inkeep/source": "./src/config/schema-leaf.ts",
+ "development": "./src/config/schema-leaf.ts",
+ "types": "./dist/config-schema-leaf.d.mts",
+ "default": "./dist/config-schema-leaf.mjs"
+ },
+ "./constants/activity": {
+ "@inkeep/source": "./src/constants/activity.ts",
+ "development": "./src/constants/activity.ts",
+ "types": "./dist/constants-activity.d.mts",
+ "default": "./dist/constants-activity.mjs"
+ },
+ "./constants/cc1": {
+ "@inkeep/source": "./src/constants/cc1.ts",
+ "development": "./src/constants/cc1.ts",
+ "types": "./dist/constants-cc1.d.mts",
+ "default": "./dist/constants-cc1.mjs"
+ },
+ "./constants/chrome": {
+ "@inkeep/source": "./src/constants/chrome.ts",
+ "development": "./src/constants/chrome.ts",
+ "types": "./dist/constants-chrome.d.mts",
+ "default": "./dist/constants-chrome.mjs"
+ },
+ "./constants/code-languages": {
+ "@inkeep/source": "./src/constants/code-languages.ts",
+ "development": "./src/constants/code-languages.ts",
+ "types": "./dist/constants-code-languages.d.mts",
+ "default": "./dist/constants-code-languages.mjs"
+ },
+ "./constants/create-new-banner": {
+ "@inkeep/source": "./src/constants/create-new-banner.ts",
+ "development": "./src/constants/create-new-banner.ts",
+ "types": "./dist/constants-create-new-banner.d.mts",
+ "default": "./dist/constants-create-new-banner.mjs"
+ },
+ "./constants/create-new-project-reason": {
+ "@inkeep/source": "./src/constants/create-new-project-reason.ts",
+ "development": "./src/constants/create-new-project-reason.ts",
+ "types": "./dist/constants-create-new-project-reason.d.mts",
+ "default": "./dist/constants-create-new-project-reason.mjs"
+ },
+ "./constants/doc-lifecycle": {
+ "@inkeep/source": "./src/constants/doc-lifecycle.ts",
+ "development": "./src/constants/doc-lifecycle.ts",
+ "types": "./dist/constants-doc-lifecycle.d.mts",
+ "default": "./dist/constants-doc-lifecycle.mjs"
+ },
+ "./constants/document-open": {
+ "@inkeep/source": "./src/constants/document-open.ts",
+ "development": "./src/constants/document-open.ts",
+ "types": "./dist/constants-document-open.d.mts",
+ "default": "./dist/constants-document-open.mjs"
+ },
+ "./constants/editors": {
+ "@inkeep/source": "./src/constants/editors.ts",
+ "development": "./src/constants/editors.ts",
+ "types": "./dist/constants-editors.d.mts",
+ "default": "./dist/constants-editors.mjs"
+ },
+ "./constants/embedded-host": {
+ "@inkeep/source": "./src/constants/embedded-host.ts",
+ "development": "./src/constants/embedded-host.ts",
+ "types": "./dist/constants-embedded-host.d.mts",
+ "default": "./dist/constants-embedded-host.mjs"
+ },
+ "./constants/feature-flags": {
+ "@inkeep/source": "./src/constants/feature-flags.ts",
+ "development": "./src/constants/feature-flags.ts",
+ "types": "./dist/constants-feature-flags.d.mts",
+ "default": "./dist/constants-feature-flags.mjs"
+ },
+ "./constants/github": {
+ "@inkeep/source": "./src/constants/github.ts",
+ "development": "./src/constants/github.ts",
+ "types": "./dist/constants-github.d.mts",
+ "default": "./dist/constants-github.mjs"
+ },
+ "./constants/graph": {
+ "@inkeep/source": "./src/constants/graph.ts",
+ "development": "./src/constants/graph.ts",
+ "types": "./dist/constants-graph.d.mts",
+ "default": "./dist/constants-graph.mjs"
+ },
+ "./constants/manual-update-check": {
+ "@inkeep/source": "./src/constants/manual-update-check.ts",
+ "development": "./src/constants/manual-update-check.ts",
+ "types": "./dist/constants-manual-update-check.d.mts",
+ "default": "./dist/constants-manual-update-check.mjs"
+ },
+ "./constants/mcp": {
+ "@inkeep/source": "./src/constants/mcp.ts",
+ "development": "./src/constants/mcp.ts",
+ "types": "./dist/constants-mcp.d.mts",
+ "default": "./dist/constants-mcp.mjs"
+ },
+ "./constants/menu-labels": {
+ "@inkeep/source": "./src/constants/menu-labels.ts",
+ "development": "./src/constants/menu-labels.ts",
+ "types": "./dist/constants-menu-labels.d.mts",
+ "default": "./dist/constants-menu-labels.mjs"
+ },
+ "./constants/native-menu-labels": {
+ "@inkeep/source": "./src/constants/native-menu-labels.ts",
+ "development": "./src/constants/native-menu-labels.ts",
+ "types": "./dist/constants-native-menu-labels.d.mts",
+ "default": "./dist/constants-native-menu-labels.mjs"
+ },
+ "./constants/preview-embed-starters": {
+ "@inkeep/source": "./src/constants/preview-embed-starters.ts",
+ "development": "./src/constants/preview-embed-starters.ts",
+ "types": "./dist/constants-preview-embed-starters.d.mts",
+ "default": "./dist/constants-preview-embed-starters.mjs"
+ },
+ "./constants/preview-theme-tokens": {
+ "@inkeep/source": "./src/constants/preview-theme-tokens.ts",
+ "development": "./src/constants/preview-theme-tokens.ts",
+ "types": "./dist/constants-preview-theme-tokens.d.mts",
+ "default": "./dist/constants-preview-theme-tokens.mjs"
+ },
+ "./constants/product": {
+ "@inkeep/source": "./src/constants/product.ts",
+ "development": "./src/constants/product.ts",
+ "types": "./dist/constants-product.d.mts",
+ "default": "./dist/constants-product.mjs"
+ },
+ "./constants/skills": {
+ "@inkeep/source": "./src/constants/skills.ts",
+ "development": "./src/constants/skills.ts",
+ "types": "./dist/constants-skills.d.mts",
+ "default": "./dist/constants-skills.mjs"
+ },
+ "./constants/uninstall-feedback": {
+ "@inkeep/source": "./src/constants/uninstall-feedback.ts",
+ "development": "./src/constants/uninstall-feedback.ts",
+ "types": "./dist/constants-uninstall-feedback.d.mts",
+ "default": "./dist/constants-uninstall-feedback.mjs"
+ },
+ "./constants/upload": {
+ "@inkeep/source": "./src/constants/upload.ts",
+ "development": "./src/constants/upload.ts",
+ "types": "./dist/constants-upload.d.mts",
+ "default": "./dist/constants-upload.mjs"
+ },
+ "./extensions/code-block-fidelity": {
+ "@inkeep/source": "./src/extensions/code-block-fidelity.ts",
+ "development": "./src/extensions/code-block-fidelity.ts",
+ "types": "./dist/extensions-code-block-fidelity.d.mts",
+ "default": "./dist/extensions-code-block-fidelity.mjs"
+ },
+ "./extensions/footnote-reference": {
+ "@inkeep/source": "./src/extensions/footnote-reference.ts",
+ "development": "./src/extensions/footnote-reference.ts",
+ "types": "./dist/extensions-footnote-reference.d.mts",
+ "default": "./dist/extensions-footnote-reference.mjs"
+ },
+ "./extensions/frontmatter": {
+ "@inkeep/source": "./src/extensions/frontmatter.ts",
+ "development": "./src/extensions/frontmatter.ts",
+ "types": "./dist/extensions-frontmatter.d.mts",
+ "default": "./dist/extensions-frontmatter.mjs"
+ },
+ "./extensions/image-reference-fidelity": {
+ "@inkeep/source": "./src/extensions/image-reference-fidelity.ts",
+ "development": "./src/extensions/image-reference-fidelity.ts",
+ "types": "./dist/extensions-image-reference-fidelity.d.mts",
+ "default": "./dist/extensions-image-reference-fidelity.mjs"
+ },
+ "./extensions/image-src-fidelity": {
+ "@inkeep/source": "./src/extensions/image-src-fidelity.ts",
+ "development": "./src/extensions/image-src-fidelity.ts",
+ "types": "./dist/extensions-image-src-fidelity.d.mts",
+ "default": "./dist/extensions-image-src-fidelity.mjs"
+ },
+ "./extensions/jsx-component": {
+ "@inkeep/source": "./src/extensions/jsx-component.ts",
+ "development": "./src/extensions/jsx-component.ts",
+ "types": "./dist/extensions-jsx-component.d.mts",
+ "default": "./dist/extensions-jsx-component.mjs"
+ },
+ "./extensions/jsx-inline": {
+ "@inkeep/source": "./src/extensions/jsx-inline.ts",
+ "development": "./src/extensions/jsx-inline.ts",
+ "types": "./dist/extensions-jsx-inline.d.mts",
+ "default": "./dist/extensions-jsx-inline.mjs"
+ },
+ "./extensions/link-fidelity": {
+ "@inkeep/source": "./src/extensions/link-fidelity.ts",
+ "development": "./src/extensions/link-fidelity.ts",
+ "types": "./dist/extensions-link-fidelity.d.mts",
+ "default": "./dist/extensions-link-fidelity.mjs"
+ },
+ "./extensions/math-inline": {
+ "@inkeep/source": "./src/extensions/math-inline.ts",
+ "development": "./src/extensions/math-inline.ts",
+ "types": "./dist/extensions-math-inline.d.mts",
+ "default": "./dist/extensions-math-inline.mjs"
+ },
+ "./extensions/raw-mdx-fallback": {
+ "@inkeep/source": "./src/extensions/raw-mdx-fallback.ts",
+ "development": "./src/extensions/raw-mdx-fallback.ts",
+ "types": "./dist/extensions-raw-mdx-fallback.d.mts",
+ "default": "./dist/extensions-raw-mdx-fallback.mjs"
+ },
+ "./extensions/shared": {
+ "@inkeep/source": "./src/extensions/shared.ts",
+ "development": "./src/extensions/shared.ts",
+ "types": "./dist/extensions-shared.d.mts",
+ "default": "./dist/extensions-shared.mjs"
+ },
+ "./extensions/tag": {
+ "@inkeep/source": "./src/extensions/tag.ts",
+ "development": "./src/extensions/tag.ts",
+ "types": "./dist/extensions-tag.d.mts",
+ "default": "./dist/extensions-tag.mjs"
+ },
+ "./extensions/wiki-link": {
+ "@inkeep/source": "./src/extensions/wiki-link.ts",
+ "development": "./src/extensions/wiki-link.ts",
+ "types": "./dist/extensions-wiki-link.d.mts",
+ "default": "./dist/extensions-wiki-link.mjs"
+ },
+ "./extensions/wiki-link-embed": {
+ "@inkeep/source": "./src/extensions/wiki-link-embed.ts",
+ "development": "./src/extensions/wiki-link-embed.ts",
+ "types": "./dist/extensions-wiki-link-embed.d.mts",
+ "default": "./dist/extensions-wiki-link-embed.mjs"
+ },
+ "./frontmatter-diff": {
+ "@inkeep/source": "./src/frontmatter-diff.ts",
+ "development": "./src/frontmatter-diff.ts",
+ "types": "./dist/frontmatter-diff.d.mts",
+ "default": "./dist/frontmatter-diff.mjs"
+ },
+ "./frontmatter/errors": {
+ "@inkeep/source": "./src/frontmatter/errors.ts",
+ "development": "./src/frontmatter/errors.ts",
+ "types": "./dist/frontmatter-errors.d.mts",
+ "default": "./dist/frontmatter-errors.mjs"
+ },
+ "./frontmatter/schema": {
+ "@inkeep/source": "./src/frontmatter/schema.ts",
+ "development": "./src/frontmatter/schema.ts",
+ "types": "./dist/frontmatter-schema.d.mts",
+ "default": "./dist/frontmatter-schema.mjs"
+ },
+ "./frontmatter/tags": {
+ "@inkeep/source": "./src/frontmatter/tags.ts",
+ "development": "./src/frontmatter/tags.ts",
+ "types": "./dist/frontmatter-tags.d.mts",
+ "default": "./dist/frontmatter-tags.mjs"
+ },
+ "./git/worktree-inventory-model": {
+ "@inkeep/source": "./src/git/worktree-inventory-model.ts",
+ "development": "./src/git/worktree-inventory-model.ts",
+ "types": "./dist/git-worktree-inventory-model.d.mts",
+ "default": "./dist/git-worktree-inventory-model.mjs"
+ },
+ "./git/worktree-selector-model": {
+ "@inkeep/source": "./src/git/worktree-selector-model.ts",
+ "development": "./src/git/worktree-selector-model.ts",
+ "types": "./dist/git-worktree-selector-model.d.mts",
+ "default": "./dist/git-worktree-selector-model.mjs"
+ },
+ "./handoff": {
+ "@inkeep/source": "./src/handoff/index.ts",
+ "development": "./src/handoff/index.ts",
+ "types": "./dist/handoff.d.mts",
+ "default": "./dist/handoff.mjs"
+ },
+ "./i18n/browser-locale-provider": {
+ "@inkeep/source": "./src/i18n/browser-locale-provider.ts",
+ "development": "./src/i18n/browser-locale-provider.ts",
+ "types": "./dist/i18n-browser-locale-provider.d.mts",
+ "default": "./dist/i18n-browser-locale-provider.mjs"
+ },
+ "./i18n/direction": {
+ "@inkeep/source": "./src/i18n/direction.ts",
+ "development": "./src/i18n/direction.ts",
+ "types": "./dist/i18n-direction.d.mts",
+ "default": "./dist/i18n-direction.mjs"
+ },
+ "./i18n/locales": {
+ "@inkeep/source": "./src/i18n/locales.ts",
+ "development": "./src/i18n/locales.ts",
+ "types": "./dist/i18n-locales.d.mts",
+ "default": "./dist/i18n-locales.mjs"
+ },
+ "./i18n/resolve-locale": {
+ "@inkeep/source": "./src/i18n/resolve-locale.ts",
+ "development": "./src/i18n/resolve-locale.ts",
+ "types": "./dist/i18n-resolve-locale.d.mts",
+ "default": "./dist/i18n-resolve-locale.mjs"
+ },
+ "./logger-types": {
+ "@inkeep/source": "./src/logger-types.ts",
+ "development": "./src/logger-types.ts",
+ "types": "./dist/logger-types.d.mts",
+ "default": "./dist/logger-types.mjs"
+ },
+ "./logging/renderer-log": {
+ "@inkeep/source": "./src/logging/renderer-log.ts",
+ "development": "./src/logging/renderer-log.ts",
+ "types": "./dist/logging-renderer-log.d.mts",
+ "default": "./dist/logging-renderer-log.mjs"
+ },
+ "./logging/secret-scrub": {
+ "@inkeep/source": "./src/logging/secret-scrub.ts",
+ "development": "./src/logging/secret-scrub.ts",
+ "types": "./dist/logging-secret-scrub.d.mts",
+ "default": "./dist/logging-secret-scrub.mjs"
+ },
+ "./markdown": {
+ "@inkeep/source": "./src/markdown/index.ts",
+ "development": "./src/markdown/index.ts",
+ "types": "./dist/markdown.d.mts",
+ "default": "./dist/markdown.mjs"
+ },
+ "./markdown/code-fence": {
+ "@inkeep/source": "./src/markdown/code-fence.ts",
+ "development": "./src/markdown/code-fence.ts",
+ "types": "./dist/markdown-code-fence.d.mts",
+ "default": "./dist/markdown-code-fence.mjs"
+ },
+ "./markdown/html-to-mdast": {
+ "@inkeep/source": "./src/markdown/html-to-mdast.ts",
+ "development": "./src/markdown/html-to-mdast.ts",
+ "types": "./dist/markdown-html-to-mdast.d.mts",
+ "default": "./dist/markdown-html-to-mdast.mjs"
+ },
+ "./markdown/lint": {
+ "@inkeep/source": "./src/markdown/lint/index.ts",
+ "development": "./src/markdown/lint/index.ts",
+ "types": "./dist/markdown-lint.d.mts",
+ "default": "./dist/markdown-lint.mjs"
+ },
+ "./markdown/mdast-to-html": {
+ "@inkeep/source": "./src/markdown/mdast-to-html.ts",
+ "development": "./src/markdown/mdast-to-html.ts",
+ "types": "./dist/markdown-mdast-to-html.d.mts",
+ "default": "./dist/markdown-mdast-to-html.mjs"
+ },
+ "./markdown/plain-text": {
+ "@inkeep/source": "./src/markdown/plain-text.ts",
+ "development": "./src/markdown/plain-text.ts",
+ "types": "./dist/markdown-plain-text.d.mts",
+ "default": "./dist/markdown-plain-text.mjs"
+ },
+ "./markdown/reference-label": {
+ "@inkeep/source": "./src/markdown/reference-label.ts",
+ "development": "./src/markdown/reference-label.ts",
+ "types": "./dist/markdown-reference-label.d.mts",
+ "default": "./dist/markdown-reference-label.mjs"
+ },
+ "./markdown/resolve-image-url": {
+ "@inkeep/source": "./src/markdown/resolve-image-url.ts",
+ "development": "./src/markdown/resolve-image-url.ts",
+ "types": "./dist/markdown-resolve-image-url.d.mts",
+ "default": "./dist/markdown-resolve-image-url.mjs"
+ },
+ "./markdown/safe-url": {
+ "@inkeep/source": "./src/markdown/safe-url.ts",
+ "development": "./src/markdown/safe-url.ts",
+ "types": "./dist/markdown-safe-url.d.mts",
+ "default": "./dist/markdown-safe-url.mjs"
+ },
+ "./markdown/tag-promotion": {
+ "@inkeep/source": "./src/markdown/tag-promotion.ts",
+ "development": "./src/markdown/tag-promotion.ts",
+ "types": "./dist/markdown-tag-promotion.d.mts",
+ "default": "./dist/markdown-tag-promotion.mjs"
+ },
+ "./metrics/parse-health": {
+ "@inkeep/source": "./src/metrics/parse-health.ts",
+ "development": "./src/metrics/parse-health.ts",
+ "types": "./dist/metrics-parse-health.d.mts",
+ "default": "./dist/metrics-parse-health.mjs"
+ },
+ "./registry": {
+ "@inkeep/source": "./src/registry/index.ts",
+ "development": "./src/registry/index.ts",
+ "types": "./dist/registry.d.mts",
+ "default": "./dist/registry.mjs"
+ },
+ "./registry/types": {
+ "@inkeep/source": "./src/registry/types.ts",
+ "development": "./src/registry/types.ts",
+ "types": "./dist/registry-types.d.mts",
+ "default": "./dist/registry-types.mjs"
+ },
+ "./schemas/api": {
+ "@inkeep/source": "./src/schemas/api/index.ts",
+ "development": "./src/schemas/api/index.ts",
+ "types": "./dist/schemas-api.d.mts",
+ "default": "./dist/schemas-api.mjs"
+ },
+ "./schemas/cc1": {
+ "@inkeep/source": "./src/schemas/cc1.ts",
+ "development": "./src/schemas/cc1.ts",
+ "types": "./dist/schemas-cc1.d.mts",
+ "default": "./dist/schemas-cc1.mjs"
+ },
+ "./search/workspace-search": {
+ "@inkeep/source": "./src/search/workspace-search.ts",
+ "development": "./src/search/workspace-search.ts",
+ "types": "./dist/search-workspace-search.d.mts",
+ "default": "./dist/search-workspace-search.mjs"
+ },
+ "./seed-plan-work": {
+ "@inkeep/source": "./src/seed-plan-work.ts",
+ "development": "./src/seed-plan-work.ts",
+ "types": "./dist/seed-plan-work.d.mts",
+ "default": "./dist/seed-plan-work.mjs"
+ },
+ "./sharing": {
+ "@inkeep/source": "./src/sharing/index.ts",
+ "development": "./src/sharing/index.ts",
+ "types": "./dist/sharing.d.mts",
+ "default": "./dist/sharing.mjs"
+ },
+ "./skill-targets/schema": {
+ "@inkeep/source": "./src/skill-targets/schema.ts",
+ "development": "./src/skill-targets/schema.ts",
+ "types": "./dist/skill-targets-schema.d.mts",
+ "default": "./dist/skill-targets-schema.mjs"
+ },
+ "./skills-catalog/schema": {
+ "@inkeep/source": "./src/skills-catalog/schema.ts",
+ "development": "./src/skills-catalog/schema.ts",
+ "types": "./dist/skills-catalog-schema.d.mts",
+ "default": "./dist/skills-catalog-schema.mjs"
+ },
+ "./skills-catalog/scope": {
+ "@inkeep/source": "./src/skills-catalog/scope.ts",
+ "development": "./src/skills-catalog/scope.ts",
+ "types": "./dist/skills-catalog-scope.d.mts",
+ "default": "./dist/skills-catalog-scope.mjs"
+ },
+ "./skills-catalog/skill-cost": {
+ "@inkeep/source": "./src/skills-catalog/skill-cost.ts",
+ "development": "./src/skills-catalog/skill-cost.ts",
+ "types": "./dist/skills-catalog-skill-cost.d.mts",
+ "default": "./dist/skills-catalog-skill-cost.mjs"
+ },
+ "./skills-catalog/source-fields": {
+ "@inkeep/source": "./src/skills-catalog/source-fields.ts",
+ "development": "./src/skills-catalog/source-fields.ts",
+ "types": "./dist/skills-catalog-source-fields.d.mts",
+ "default": "./dist/skills-catalog-source-fields.mjs"
+ },
+ "./sync-paused-reason": {
+ "@inkeep/source": "./src/sync-paused-reason.ts",
+ "development": "./src/sync-paused-reason.ts",
+ "types": "./dist/sync-paused-reason.d.mts",
+ "default": "./dist/sync-paused-reason.mjs"
+ },
+ "./terminal-layout": {
+ "@inkeep/source": "./src/terminal-layout.ts",
+ "development": "./src/terminal-layout.ts",
+ "types": "./dist/terminal-layout.d.mts",
+ "default": "./dist/terminal-layout.mjs"
+ },
+ "./theme/base16": {
+ "@inkeep/source": "./src/theme/base16.ts",
+ "development": "./src/theme/base16.ts",
+ "types": "./dist/theme-base16.d.mts",
+ "default": "./dist/theme-base16.mjs"
+ },
+ "./theme/theme-plugins": {
+ "@inkeep/source": "./src/theme/theme-plugins.ts",
+ "development": "./src/theme/theme-plugins.ts",
+ "types": "./dist/theme-theme-plugins.d.mts",
+ "default": "./dist/theme-theme-plugins.mjs"
+ },
+ "./types/awareness": {
+ "@inkeep/source": "./src/types/awareness.ts",
+ "development": "./src/types/awareness.ts",
+ "types": "./dist/types-awareness.d.mts",
+ "default": "./dist/types-awareness.mjs"
+ },
+ "./types/identity": {
+ "@inkeep/source": "./src/types/identity.ts",
+ "development": "./src/types/identity.ts",
+ "types": "./dist/types-identity.d.mts",
+ "default": "./dist/types-identity.mjs"
+ },
+ "./types/principal": {
+ "@inkeep/source": "./src/types/principal.ts",
+ "development": "./src/types/principal.ts",
+ "types": "./dist/types-principal.d.mts",
+ "default": "./dist/types-principal.mjs"
+ },
+ "./types/timeline": {
+ "@inkeep/source": "./src/types/timeline.ts",
+ "development": "./src/types/timeline.ts",
+ "types": "./dist/types-timeline.d.mts",
+ "default": "./dist/types-timeline.mjs"
+ },
+ "./uninstall-bridge": {
+ "@inkeep/source": "./src/uninstall-bridge.ts",
+ "development": "./src/uninstall-bridge.ts",
+ "types": "./dist/uninstall-bridge.d.mts",
+ "default": "./dist/uninstall-bridge.mjs"
+ },
+ "./util/doc-name": {
+ "@inkeep/source": "./src/util/doc-name.ts",
+ "development": "./src/util/doc-name.ts",
+ "types": "./dist/util-doc-name.d.mts",
+ "default": "./dist/util-doc-name.mjs"
+ },
+ "./utils/asset-href": {
+ "@inkeep/source": "./src/utils/asset-href.ts",
+ "development": "./src/utils/asset-href.ts",
+ "types": "./dist/utils-asset-href.d.mts",
+ "default": "./dist/utils-asset-href.mjs"
+ },
+ "./utils/chunked-insert": {
+ "@inkeep/source": "./src/utils/chunked-insert.ts",
+ "development": "./src/utils/chunked-insert.ts",
+ "types": "./dist/utils-chunked-insert.d.mts",
+ "default": "./dist/utils-chunked-insert.mjs"
+ },
+ "./utils/code-fence-tracker": {
+ "@inkeep/source": "./src/utils/code-fence-tracker.ts",
+ "development": "./src/utils/code-fence-tracker.ts",
+ "types": "./dist/utils-code-fence-tracker.d.mts",
+ "default": "./dist/utils-code-fence-tracker.mjs"
+ },
+ "./utils/embed-url-rewrite": {
+ "@inkeep/source": "./src/utils/embed-url-rewrite.ts",
+ "development": "./src/utils/embed-url-rewrite.ts",
+ "types": "./dist/utils-embed-url-rewrite.d.mts",
+ "default": "./dist/utils-embed-url-rewrite.mjs"
+ },
+ "./utils/extension": {
+ "@inkeep/source": "./src/utils/extension.ts",
+ "development": "./src/utils/extension.ts",
+ "types": "./dist/utils-extension.d.mts",
+ "default": "./dist/utils-extension.mjs"
+ },
+ "./utils/file-size": {
+ "@inkeep/source": "./src/utils/file-size.ts",
+ "development": "./src/utils/file-size.ts",
+ "types": "./dist/utils-file-size.d.mts",
+ "default": "./dist/utils-file-size.mjs"
+ },
+ "./utils/github-stars": {
+ "@inkeep/source": "./src/utils/github-stars.ts",
+ "development": "./src/utils/github-stars.ts",
+ "types": "./dist/utils-github-stars.d.mts",
+ "default": "./dist/utils-github-stars.mjs"
+ },
+ "./utils/heading-scan": {
+ "@inkeep/source": "./src/utils/heading-scan.ts",
+ "development": "./src/utils/heading-scan.ts",
+ "types": "./dist/utils-heading-scan.d.mts",
+ "default": "./dist/utils-heading-scan.mjs"
+ },
+ "./utils/identity": {
+ "@inkeep/source": "./src/utils/identity.ts",
+ "development": "./src/utils/identity.ts",
+ "types": "./dist/utils-identity.d.mts",
+ "default": "./dist/utils-identity.mjs"
+ },
+ "./utils/link-targets": {
+ "@inkeep/source": "./src/utils/link-targets.ts",
+ "development": "./src/utils/link-targets.ts",
+ "types": "./dist/utils-link-targets.d.mts",
+ "default": "./dist/utils-link-targets.mjs"
+ },
+ "./utils/loom-embed": {
+ "@inkeep/source": "./src/utils/loom-embed.ts",
+ "development": "./src/utils/loom-embed.ts",
+ "types": "./dist/utils-loom-embed.d.mts",
+ "default": "./dist/utils-loom-embed.mjs"
+ },
+ "./utils/pdf-anchor": {
+ "@inkeep/source": "./src/utils/pdf-anchor.ts",
+ "development": "./src/utils/pdf-anchor.ts",
+ "types": "./dist/utils-pdf-anchor.d.mts",
+ "default": "./dist/utils-pdf-anchor.mjs"
+ },
+ "./utils/random-uuid": {
+ "@inkeep/source": "./src/utils/random-uuid.ts",
+ "development": "./src/utils/random-uuid.ts",
+ "types": "./dist/utils-random-uuid.d.mts",
+ "default": "./dist/utils-random-uuid.mjs"
+ },
+ "./utils/relative-time": {
+ "@inkeep/source": "./src/utils/relative-time.ts",
+ "development": "./src/utils/relative-time.ts",
+ "types": "./dist/utils-relative-time.d.mts",
+ "default": "./dist/utils-relative-time.mjs"
+ },
+ "./utils/resolve-internal-href": {
+ "@inkeep/source": "./src/utils/resolve-internal-href.ts",
+ "development": "./src/utils/resolve-internal-href.ts",
+ "types": "./dist/utils-resolve-internal-href.d.mts",
+ "default": "./dist/utils-resolve-internal-href.mjs"
+ },
+ "./utils/sanitize-folder-name": {
+ "@inkeep/source": "./src/utils/sanitize-folder-name.ts",
+ "development": "./src/utils/sanitize-folder-name.ts",
+ "types": "./dist/utils-sanitize-folder-name.d.mts",
+ "default": "./dist/utils-sanitize-folder-name.mjs"
+ },
+ "./utils/slug": {
+ "@inkeep/source": "./src/utils/slug.ts",
+ "development": "./src/utils/slug.ts",
+ "types": "./dist/utils-slug.d.mts",
+ "default": "./dist/utils-slug.mjs"
+ },
+ "./utils/vimeo-embed": {
+ "@inkeep/source": "./src/utils/vimeo-embed.ts",
+ "development": "./src/utils/vimeo-embed.ts",
+ "types": "./dist/utils-vimeo-embed.d.mts",
+ "default": "./dist/utils-vimeo-embed.mjs"
+ },
+ "./utils/wiki-link-resolve": {
+ "@inkeep/source": "./src/utils/wiki-link-resolve.ts",
+ "development": "./src/utils/wiki-link-resolve.ts",
+ "types": "./dist/utils-wiki-link-resolve.d.mts",
+ "default": "./dist/utils-wiki-link-resolve.mjs"
+ },
+ "./utils/youtube-embed": {
+ "@inkeep/source": "./src/utils/youtube-embed.ts",
+ "development": "./src/utils/youtube-embed.ts",
+ "types": "./dist/utils-youtube-embed.d.mts",
+ "default": "./dist/utils-youtube-embed.mjs"
}
},
"files": [
@@ -158,7 +878,8 @@
"scripts": {
"build": "node scripts/build-output.mjs build",
"verify:exports": "node scripts/verify-exports-targets.mjs",
- "typecheck": "tsc --noEmit && tsc -p tsconfig.perf.json --noEmit",
+ "typecheck": "tsc --noEmit && tsc -p tsconfig.perf.json --noEmit && tsc -p tests/contract/subpath-types/tsconfig.json --noEmit",
+ "check:dts": "tsc -p tsconfig.check.json --noEmit",
"test": "vitest run src/ tests/contract/ scripts/",
"test:perf:bench": "NODE_OPTIONS=\"${NODE_OPTIONS:-} --expose-gc\" RUN_BENCH=1 vitest run tests/perf/markdown-bench.test.ts",
"test:perf:regression:unit": "vitest run tests/perf/regression-gate.test.ts",
diff --git a/packages/core/src/bridge/compose.ts b/packages/core/src/bridge/compose.ts
index f4cc8a286..2a597ec3d 100644
--- a/packages/core/src/bridge/compose.ts
+++ b/packages/core/src/bridge/compose.ts
@@ -1,3 +1,4 @@
+
import { prependFrontmatter, stripFrontmatter } from '../extensions/frontmatter.ts';
export type ComposeAdjustment = 'none' | 'body' | 'frontmatter' | 'unresolved';
diff --git a/packages/core/src/bridge/doc-boundary-space.ts b/packages/core/src/bridge/doc-boundary-space.ts
index 8fb428b90..01ef76a9f 100644
--- a/packages/core/src/bridge/doc-boundary-space.ts
+++ b/packages/core/src/bridge/doc-boundary-space.ts
@@ -1,3 +1,4 @@
+
import { FRONTMATTER_RE, stripFrontmatter } from '../extensions/frontmatter.ts';
import { carriedEdgeEmpties, type DocEdgeEmpties } from '../markdown/doc-edge-blank-runs.ts';
diff --git a/packages/core/src/handoff/terminal-launch.ts b/packages/core/src/handoff/terminal-launch.ts
index 94e38984c..4e6293f83 100644
--- a/packages/core/src/handoff/terminal-launch.ts
+++ b/packages/core/src/handoff/terminal-launch.ts
@@ -54,7 +54,7 @@ function encodeUtf8Base64(value: string): string {
const TERMINAL_LAUNCH_ENV_SLOT_PREFIX = 'OK_TERMINAL_LAUNCH_ENV_';
-export interface TerminalLaunchEnvSlot {
+interface TerminalLaunchEnvSlot {
readonly name: string;
readonly slot: string;
readonly value: string;
diff --git a/packages/core/src/markdown/comment-promoter.ts b/packages/core/src/markdown/comment-promoter.ts
index fc267cbea..fb0ba5a7c 100644
--- a/packages/core/src/markdown/comment-promoter.ts
+++ b/packages/core/src/markdown/comment-promoter.ts
@@ -1,3 +1,4 @@
+
import type { Nodes, Paragraph, PhrasingContent, Root, RootContent, Text } from 'mdast';
import { SKIP, visit } from 'unist-util-visit';
import type { VFile } from 'vfile';
diff --git a/packages/core/src/markdown/merged-walker.ts b/packages/core/src/markdown/merged-walker.ts
index bfd7e3109..fa3cfcd86 100644
--- a/packages/core/src/markdown/merged-walker.ts
+++ b/packages/core/src/markdown/merged-walker.ts
@@ -1,3 +1,4 @@
+
import type { Nodes, Parent, Root } from 'mdast';
import { SKIP, visit } from 'unist-util-visit';
import type { VFile } from 'vfile';
diff --git a/packages/core/src/markdown/safe-url.ts b/packages/core/src/markdown/safe-url.ts
index 4d3250d3a..8be632ba4 100644
--- a/packages/core/src/markdown/safe-url.ts
+++ b/packages/core/src/markdown/safe-url.ts
@@ -1,3 +1,4 @@
+
export const SAFE_URL_SCHEMES = ['https', 'http', 'mailto', 'tel', 'ftp', 'sms'] as const;
const SCHEME_ALT = SAFE_URL_SCHEMES.map((s) => `${s}:`).join('|');
diff --git a/packages/core/tests/contract/built-subpath-identity.uncached.test.ts b/packages/core/tests/contract/built-subpath-identity.uncached.test.ts
new file mode 100644
index 000000000..1d8ba3889
--- /dev/null
+++ b/packages/core/tests/contract/built-subpath-identity.uncached.test.ts
@@ -0,0 +1,115 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { describe, expect, test } from 'vitest';
+
+const PACKAGE_ROOT = realpathSync(fileURLToPath(new URL('../../', import.meta.url)));
+const PACKAGE_URL = pathToFileURL(`${PACKAGE_ROOT}/`);
+const PACKAGE_NAME = '@inkeep/open-knowledge-core';
+
+const STATEFUL_SUBPATHS = {
+ fieldRegistry: 'config/field-registry',
+ ConfigSchema: 'config/schema',
+ sharedExtensions: 'extensions/shared',
+ FORM_WRITE_ORIGIN: 'bridge',
+} as const;
+
+type StatefulBinding = keyof typeof STATEFUL_SUBPATHS;
+type ImportOrder = 'barrel-first' | 'subpaths-first';
+
+interface ProbeReport {
+ resolved: Record<string, string>;
+ identical: Record<StatefulBinding, boolean>;
+ metaThroughSubpathRegistry: { scope: string; reload: string } | null;
+ metaThroughBarrelRegistry: { scope: string; reload: string } | null;
+}
+
+const packageJson: { exports: Record<string, { default: string }> } = JSON.parse(
+ readFileSync(new URL('../../package.json', import.meta.url), 'utf8'),
+);
+
+function builtTarget(subpath: string): URL {
+ const key = subpath === '' ? '.' : `./${subpath}`;
+ const target = packageJson.exports[key]?.default;
+ if (target === undefined)
+ throw new Error(`${PACKAGE_NAME} declares no default export for ${key}`);
+ return new URL(target, PACKAGE_URL);
+}
+
+function probeScript(order: ImportOrder): string {
+ const subpaths = Object.entries(STATEFUL_SUBPATHS).map(([binding, subpath]) => [
+ binding,
+ `${PACKAGE_NAME}/${subpath}`,
+ ]);
+ return `
+const barrelSpecifier = ${JSON.stringify(PACKAGE_NAME)};
+const subpaths = ${JSON.stringify(subpaths)};
+const order = ${JSON.stringify(order)};
+const viaSubpath = {};
+let barrel;
+if (order === 'barrel-first') barrel = await import(barrelSpecifier);
+for (const [binding, specifier] of subpaths) viaSubpath[binding] = await import(specifier);
+if (order === 'subpaths-first') barrel = await import(barrelSpecifier);
+const leafPath = ['content', 'dir'];
+const pick = (meta) => (meta ? { scope: meta.scope, reload: meta.reload } : null);
+const report = {
+ resolved: Object.fromEntries(
+ [['barrel', barrelSpecifier], ...subpaths].map(([name, specifier]) => [name, import.meta.resolve(specifier)]),
+ ),
+ identical: Object.fromEntries(
+ subpaths.map(([binding]) => [binding, viaSubpath[binding][binding] === barrel[binding]]),
+ ),
+ metaThroughSubpathRegistry: pick(
+ viaSubpath.fieldRegistry.getFieldMeta(barrel.resolveLeafSchema(barrel.ConfigSchema, leafPath)),
+ ),
+ metaThroughBarrelRegistry: pick(
+ barrel.getFieldMeta(barrel.resolveLeafSchema(viaSubpath.ConfigSchema.ConfigSchema, leafPath)),
+ ),
+};
+process.stdout.write(JSON.stringify(report));
+`;
+}
+
+function runFreshProcess(order: ImportOrder): ProbeReport {
+ const env = Object.fromEntries(
+ Object.entries(process.env).filter(([name]) => name !== 'NODE_OPTIONS'),
+ );
+ const stdout = execFileSync(
+ process.execPath,
+ ['--input-type=module', '--eval', probeScript(order)],
+ { cwd: PACKAGE_ROOT, env, encoding: 'utf8' },
+ );
+ return JSON.parse(stdout);
+}
+
+describe('built core entries share one runtime across the barrel and its subpaths', () => {
+ test('the emitted entries this check imports exist', () => {
+ for (const subpath of ['', ...Object.values(STATEFUL_SUBPATHS)]) {
+ const target = builtTarget(subpath);
+ expect(
+ existsSync(target),
+ `${fileURLToPath(target)} is missing; build core first (pnpm --filter @inkeep/open-knowledge-core build)`,
+ ).toBe(true);
+ }
+ });
+
+ test.each<ImportOrder>(['barrel-first', 'subpaths-first'])(
+ 'a fresh process importing %s sees identical stateful bindings and shared schema metadata',
+ (order) => {
+ const report = runFreshProcess(order);
+
+ expect(report.resolved.barrel).toBe(builtTarget('').href);
+ for (const [binding, subpath] of Object.entries(STATEFUL_SUBPATHS)) {
+ expect(report.resolved[binding], binding).toBe(builtTarget(subpath).href);
+ }
+ expect(report.identical).toEqual({
+ fieldRegistry: true,
+ ConfigSchema: true,
+ sharedExtensions: true,
+ FORM_WRITE_ORIGIN: true,
+ });
+ expect(report.metaThroughSubpathRegistry).toEqual({ scope: 'project', reload: 'boot' });
+ expect(report.metaThroughBarrelRegistry).toEqual({ scope: 'project', reload: 'boot' });
+ },
+ );
+});
diff --git a/packages/core/tests/contract/module-subpaths.test.ts b/packages/core/tests/contract/module-subpaths.test.ts
new file mode 100644
index 000000000..599d0fafb
--- /dev/null
+++ b/packages/core/tests/contract/module-subpaths.test.ts
@@ -0,0 +1,309 @@
+import { readFileSync } from 'node:fs';
+import * as root from '@inkeep/open-knowledge-core';
+import * as agentRegistrySubpath from '@inkeep/open-knowledge-core/agent-registry';
+import * as bridgeSubpath from '@inkeep/open-knowledge-core/bridge';
+import * as bugReportSidecarNoteContentSubpath from '@inkeep/open-knowledge-core/bug-report-sidecar/note-content';
+import * as checkpointKindsSubpath from '@inkeep/open-knowledge-core/checkpoint-kinds';
+import * as clientVersionSubpath from '@inkeep/open-knowledge-core/client-version';
+import * as commandsCommandIdentitySubpath from '@inkeep/open-knowledge-core/commands/command-identity';
+import * as commentsLeafTextSubpath from '@inkeep/open-knowledge-core/comments/leaf-text';
+import * as commentsPassageMatchSubpath from '@inkeep/open-knowledge-core/comments/passage-match';
+import * as configAutoSyncModeSubpath from '@inkeep/open-knowledge-core/config/auto-sync-mode';
+import * as configBindConfigDocSubpath from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import * as configBindOkignoreDocSubpath from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
+import * as configErrorsSubpath from '@inkeep/open-knowledge-core/config/errors';
+import * as configFieldRegistrySubpath from '@inkeep/open-knowledge-core/config/field-registry';
+import * as configMergeLayeredSubpath from '@inkeep/open-knowledge-core/config/merge-layered';
+import * as configSchemaSubpath from '@inkeep/open-knowledge-core/config/schema';
+import * as configSchemaLeafSubpath from '@inkeep/open-knowledge-core/config/schema-leaf';
+import * as constantsActivitySubpath from '@inkeep/open-knowledge-core/constants/activity';
+import * as constantsCc1Subpath from '@inkeep/open-knowledge-core/constants/cc1';
+import * as constantsChromeSubpath from '@inkeep/open-knowledge-core/constants/chrome';
+import * as constantsCodeLanguagesSubpath from '@inkeep/open-knowledge-core/constants/code-languages';
+import * as constantsCreateNewBannerSubpath from '@inkeep/open-knowledge-core/constants/create-new-banner';
+import * as constantsCreateNewProjectReasonSubpath from '@inkeep/open-knowledge-core/constants/create-new-project-reason';
+import * as constantsDocLifecycleSubpath from '@inkeep/open-knowledge-core/constants/doc-lifecycle';
+import * as constantsDocumentOpenSubpath from '@inkeep/open-knowledge-core/constants/document-open';
+import * as constantsEditorsSubpath from '@inkeep/open-knowledge-core/constants/editors';
+import * as constantsEmbeddedHostSubpath from '@inkeep/open-knowledge-core/constants/embedded-host';
+import * as constantsFeatureFlagsSubpath from '@inkeep/open-knowledge-core/constants/feature-flags';
+import * as constantsGithubSubpath from '@inkeep/open-knowledge-core/constants/github';
+import * as constantsGraphSubpath from '@inkeep/open-knowledge-core/constants/graph';
+import * as constantsManualUpdateCheckSubpath from '@inkeep/open-knowledge-core/constants/manual-update-check';
+import * as constantsMcpSubpath from '@inkeep/open-knowledge-core/constants/mcp';
+import * as constantsMenuLabelsSubpath from '@inkeep/open-knowledge-core/constants/menu-labels';
+import * as constantsNativeMenuLabelsSubpath from '@inkeep/open-knowledge-core/constants/native-menu-labels';
+import * as constantsPreviewEmbedStartersSubpath from '@inkeep/open-knowledge-core/constants/preview-embed-starters';
+import * as constantsPreviewThemeTokensSubpath from '@inkeep/open-knowledge-core/constants/preview-theme-tokens';
+import * as constantsProductSubpath from '@inkeep/open-knowledge-core/constants/product';
+import * as constantsSkillsSubpath from '@inkeep/open-knowledge-core/constants/skills';
+import * as constantsUninstallFeedbackSubpath from '@inkeep/open-knowledge-core/constants/uninstall-feedback';
+import * as constantsUploadSubpath from '@inkeep/open-knowledge-core/constants/upload';
+import * as extensionsCodeBlockFidelitySubpath from '@inkeep/open-knowledge-core/extensions/code-block-fidelity';
+import * as extensionsFootnoteReferenceSubpath from '@inkeep/open-knowledge-core/extensions/footnote-reference';
+import * as extensionsFrontmatterSubpath from '@inkeep/open-knowledge-core/extensions/frontmatter';
+import * as extensionsImageReferenceFidelitySubpath from '@inkeep/open-knowledge-core/extensions/image-reference-fidelity';
+import * as extensionsImageSrcFidelitySubpath from '@inkeep/open-knowledge-core/extensions/image-src-fidelity';
+import * as extensionsJsxComponentSubpath from '@inkeep/open-knowledge-core/extensions/jsx-component';
+import * as extensionsJsxInlineSubpath from '@inkeep/open-knowledge-core/extensions/jsx-inline';
+import * as extensionsLinkFidelitySubpath from '@inkeep/open-knowledge-core/extensions/link-fidelity';
+import * as extensionsMathInlineSubpath from '@inkeep/open-knowledge-core/extensions/math-inline';
+import * as extensionsRawMdxFallbackSubpath from '@inkeep/open-knowledge-core/extensions/raw-mdx-fallback';
+import * as extensionsSharedSubpath from '@inkeep/open-knowledge-core/extensions/shared';
+import * as extensionsTagSubpath from '@inkeep/open-knowledge-core/extensions/tag';
+import * as extensionsWikiLinkSubpath from '@inkeep/open-knowledge-core/extensions/wiki-link';
+import * as extensionsWikiLinkEmbedSubpath from '@inkeep/open-knowledge-core/extensions/wiki-link-embed';
+import * as frontmatterErrorsSubpath from '@inkeep/open-knowledge-core/frontmatter/errors';
+import * as frontmatterSchemaSubpath from '@inkeep/open-knowledge-core/frontmatter/schema';
+import * as frontmatterTagsSubpath from '@inkeep/open-knowledge-core/frontmatter/tags';
+import * as frontmatterDiffSubpath from '@inkeep/open-knowledge-core/frontmatter-diff';
+import * as gitWorktreeInventoryModelSubpath from '@inkeep/open-knowledge-core/git/worktree-inventory-model';
+import * as gitWorktreeSelectorModelSubpath from '@inkeep/open-knowledge-core/git/worktree-selector-model';
+import * as handoffSubpath from '@inkeep/open-knowledge-core/handoff';
+import * as i18nBrowserLocaleProviderSubpath from '@inkeep/open-knowledge-core/i18n/browser-locale-provider';
+import * as i18nDirectionSubpath from '@inkeep/open-knowledge-core/i18n/direction';
+import * as i18nLocalesSubpath from '@inkeep/open-knowledge-core/i18n/locales';
+import * as i18nResolveLocaleSubpath from '@inkeep/open-knowledge-core/i18n/resolve-locale';
+import * as loggerTypesSubpath from '@inkeep/open-knowledge-core/logger-types';
+import * as loggingRendererLogSubpath from '@inkeep/open-knowledge-core/logging/renderer-log';
+import * as loggingSecretScrubSubpath from '@inkeep/open-knowledge-core/logging/secret-scrub';
+import * as markdownSubpath from '@inkeep/open-knowledge-core/markdown';
+import * as markdownCodeFenceSubpath from '@inkeep/open-knowledge-core/markdown/code-fence';
+import * as markdownHtmlToMdastSubpath from '@inkeep/open-knowledge-core/markdown/html-to-mdast';
+import * as markdownLintSubpath from '@inkeep/open-knowledge-core/markdown/lint';
+import * as markdownMdastToHtmlSubpath from '@inkeep/open-knowledge-core/markdown/mdast-to-html';
+import * as markdownPlainTextSubpath from '@inkeep/open-knowledge-core/markdown/plain-text';
+import * as markdownReferenceLabelSubpath from '@inkeep/open-knowledge-core/markdown/reference-label';
+import * as markdownResolveImageUrlSubpath from '@inkeep/open-knowledge-core/markdown/resolve-image-url';
+import * as markdownSafeUrlSubpath from '@inkeep/open-knowledge-core/markdown/safe-url';
+import * as markdownTagPromotionSubpath from '@inkeep/open-knowledge-core/markdown/tag-promotion';
+import * as metricsParseHealthSubpath from '@inkeep/open-knowledge-core/metrics/parse-health';
+import * as registrySubpath from '@inkeep/open-knowledge-core/registry';
+import * as registryTypesSubpath from '@inkeep/open-knowledge-core/registry/types';
+import * as schemasApiSubpath from '@inkeep/open-knowledge-core/schemas/api';
+import * as schemasCc1Subpath from '@inkeep/open-knowledge-core/schemas/cc1';
+import * as searchWorkspaceSearchSubpath from '@inkeep/open-knowledge-core/search/workspace-search';
+import * as seedPlanWorkSubpath from '@inkeep/open-knowledge-core/seed-plan-work';
+import * as sharingSubpath from '@inkeep/open-knowledge-core/sharing';
+import * as skillTargetsSchemaSubpath from '@inkeep/open-knowledge-core/skill-targets/schema';
+import * as skillsCatalogSchemaSubpath from '@inkeep/open-knowledge-core/skills-catalog/schema';
+import * as skillsCatalogScopeSubpath from '@inkeep/open-knowledge-core/skills-catalog/scope';
+import * as skillsCatalogSkillCostSubpath from '@inkeep/open-knowledge-core/skills-catalog/skill-cost';
+import * as skillsCatalogSourceFieldsSubpath from '@inkeep/open-knowledge-core/skills-catalog/source-fields';
+import * as syncPausedReasonSubpath from '@inkeep/open-knowledge-core/sync-paused-reason';
+import * as terminalLayoutSubpath from '@inkeep/open-knowledge-core/terminal-layout';
+import * as themeBase16Subpath from '@inkeep/open-knowledge-core/theme/base16';
+import * as themeThemePluginsSubpath from '@inkeep/open-knowledge-core/theme/theme-plugins';
+import * as typesAwarenessSubpath from '@inkeep/open-knowledge-core/types/awareness';
+import * as typesIdentitySubpath from '@inkeep/open-knowledge-core/types/identity';
+import * as typesPrincipalSubpath from '@inkeep/open-knowledge-core/types/principal';
+import * as typesTimelineSubpath from '@inkeep/open-knowledge-core/types/timeline';
+import * as uninstallBridgeSubpath from '@inkeep/open-knowledge-core/uninstall-bridge';
+import * as utilDocNameSubpath from '@inkeep/open-knowledge-core/util/doc-name';
+import * as utilsAssetHrefSubpath from '@inkeep/open-knowledge-core/utils/asset-href';
+import * as utilsChunkedInsertSubpath from '@inkeep/open-knowledge-core/utils/chunked-insert';
+import * as utilsCodeFenceTrackerSubpath from '@inkeep/open-knowledge-core/utils/code-fence-tracker';
+import * as utilsEmbedUrlRewriteSubpath from '@inkeep/open-knowledge-core/utils/embed-url-rewrite';
+import * as utilsExtensionSubpath from '@inkeep/open-knowledge-core/utils/extension';
+import * as utilsFileSizeSubpath from '@inkeep/open-knowledge-core/utils/file-size';
+import * as utilsGithubStarsSubpath from '@inkeep/open-knowledge-core/utils/github-stars';
+import * as utilsHeadingScanSubpath from '@inkeep/open-knowledge-core/utils/heading-scan';
+import * as utilsIdentitySubpath from '@inkeep/open-knowledge-core/utils/identity';
+import * as utilsLinkTargetsSubpath from '@inkeep/open-knowledge-core/utils/link-targets';
+import * as utilsLoomEmbedSubpath from '@inkeep/open-knowledge-core/utils/loom-embed';
+import * as utilsPdfAnchorSubpath from '@inkeep/open-knowledge-core/utils/pdf-anchor';
+import * as utilsRandomUuidSubpath from '@inkeep/open-knowledge-core/utils/random-uuid';
+import * as utilsRelativeTimeSubpath from '@inkeep/open-knowledge-core/utils/relative-time';
+import * as utilsResolveInternalHrefSubpath from '@inkeep/open-knowledge-core/utils/resolve-internal-href';
+import * as utilsSanitizeFolderNameSubpath from '@inkeep/open-knowledge-core/utils/sanitize-folder-name';
+import * as utilsSlugSubpath from '@inkeep/open-knowledge-core/utils/slug';
+import * as utilsVimeoEmbedSubpath from '@inkeep/open-knowledge-core/utils/vimeo-embed';
+import * as utilsWikiLinkResolveSubpath from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
+import * as utilsYoutubeEmbedSubpath from '@inkeep/open-knowledge-core/utils/youtube-embed';
+import { describe, expect, test } from 'vitest';
+
+const PRE_EXISTING_KEYS = [
+ '.',
+ './shadow-repo-layout',
+ './skill-folder-state',
+ './git-repository',
+ './server',
+ './keepalive',
+ './helper-bundle',
+ './skills-catalog',
+ './acp/thread-protocol',
+ './acp/agent-posture',
+ './acp/permissive-mode',
+ './acp/codex-legacy-notice',
+ './acp/tool-call-input',
+ './desktop-bridge',
+];
+
+const MODULE_SUBPATHS: Record<string, object> = {
+ './agent-registry': agentRegistrySubpath,
+ './bridge': bridgeSubpath,
+ './bug-report-sidecar/note-content': bugReportSidecarNoteContentSubpath,
+ './checkpoint-kinds': checkpointKindsSubpath,
+ './client-version': clientVersionSubpath,
+ './commands/command-identity': commandsCommandIdentitySubpath,
+ './comments/leaf-text': commentsLeafTextSubpath,
+ './comments/passage-match': commentsPassageMatchSubpath,
+ './config/auto-sync-mode': configAutoSyncModeSubpath,
+ './config/bind-config-doc': configBindConfigDocSubpath,
+ './config/bind-okignore-doc': configBindOkignoreDocSubpath,
+ './config/errors': configErrorsSubpath,
+ './config/field-registry': configFieldRegistrySubpath,
+ './config/merge-layered': configMergeLayeredSubpath,
+ './config/schema': configSchemaSubpath,
+ './config/schema-leaf': configSchemaLeafSubpath,
+ './constants/activity': constantsActivitySubpath,
+ './constants/cc1': constantsCc1Subpath,
+ './constants/chrome': constantsChromeSubpath,
+ './constants/code-languages': constantsCodeLanguagesSubpath,
+ './constants/create-new-banner': constantsCreateNewBannerSubpath,
+ './constants/create-new-project-reason': constantsCreateNewProjectReasonSubpath,
+ './constants/doc-lifecycle': constantsDocLifecycleSubpath,
+ './constants/document-open': constantsDocumentOpenSubpath,
+ './constants/editors': constantsEditorsSubpath,
+ './constants/embedded-host': constantsEmbeddedHostSubpath,
+ './constants/feature-flags': constantsFeatureFlagsSubpath,
+ './constants/github': constantsGithubSubpath,
+ './constants/graph': constantsGraphSubpath,
+ './constants/manual-update-check': constantsManualUpdateCheckSubpath,
+ './constants/mcp': constantsMcpSubpath,
+ './constants/menu-labels': constantsMenuLabelsSubpath,
+ './constants/native-menu-labels': constantsNativeMenuLabelsSubpath,
+ './constants/preview-embed-starters': constantsPreviewEmbedStartersSubpath,
+ './constants/preview-theme-tokens': constantsPreviewThemeTokensSubpath,
+ './constants/product': constantsProductSubpath,
+ './constants/skills': constantsSkillsSubpath,
+ './constants/uninstall-feedback': constantsUninstallFeedbackSubpath,
+ './constants/upload': constantsUploadSubpath,
+ './extensions/code-block-fidelity': extensionsCodeBlockFidelitySubpath,
+ './extensions/footnote-reference': extensionsFootnoteReferenceSubpath,
+ './extensions/frontmatter': extensionsFrontmatterSubpath,
+ './extensions/image-reference-fidelity': extensionsImageReferenceFidelitySubpath,
+ './extensions/image-src-fidelity': extensionsImageSrcFidelitySubpath,
+ './extensions/jsx-component': extensionsJsxComponentSubpath,
+ './extensions/jsx-inline': extensionsJsxInlineSubpath,
+ './extensions/link-fidelity': extensionsLinkFidelitySubpath,
+ './extensions/math-inline': extensionsMathInlineSubpath,
+ './extensions/raw-mdx-fallback': extensionsRawMdxFallbackSubpath,
+ './extensions/shared': extensionsSharedSubpath,
+ './extensions/tag': extensionsTagSubpath,
+ './extensions/wiki-link': extensionsWikiLinkSubpath,
+ './extensions/wiki-link-embed': extensionsWikiLinkEmbedSubpath,
+ './frontmatter-diff': frontmatterDiffSubpath,
+ './frontmatter/errors': frontmatterErrorsSubpath,
+ './frontmatter/schema': frontmatterSchemaSubpath,
+ './frontmatter/tags': frontmatterTagsSubpath,
+ './git/worktree-inventory-model': gitWorktreeInventoryModelSubpath,
+ './git/worktree-selector-model': gitWorktreeSelectorModelSubpath,
+ './handoff': handoffSubpath,
+ './i18n/browser-locale-provider': i18nBrowserLocaleProviderSubpath,
+ './i18n/direction': i18nDirectionSubpath,
+ './i18n/locales': i18nLocalesSubpath,
+ './i18n/resolve-locale': i18nResolveLocaleSubpath,
+ './logger-types': loggerTypesSubpath,
+ './logging/renderer-log': loggingRendererLogSubpath,
+ './logging/secret-scrub': loggingSecretScrubSubpath,
+ './markdown': markdownSubpath,
+ './markdown/code-fence': markdownCodeFenceSubpath,
+ './markdown/html-to-mdast': markdownHtmlToMdastSubpath,
+ './markdown/lint': markdownLintSubpath,
+ './markdown/mdast-to-html': markdownMdastToHtmlSubpath,
+ './markdown/plain-text': markdownPlainTextSubpath,
+ './markdown/reference-label': markdownReferenceLabelSubpath,
+ './markdown/resolve-image-url': markdownResolveImageUrlSubpath,
+ './markdown/safe-url': markdownSafeUrlSubpath,
+ './markdown/tag-promotion': markdownTagPromotionSubpath,
+ './metrics/parse-health': metricsParseHealthSubpath,
+ './registry': registrySubpath,
+ './registry/types': registryTypesSubpath,
+ './schemas/api': schemasApiSubpath,
+ './schemas/cc1': schemasCc1Subpath,
+ './search/workspace-search': searchWorkspaceSearchSubpath,
+ './seed-plan-work': seedPlanWorkSubpath,
+ './sharing': sharingSubpath,
+ './skill-targets/schema': skillTargetsSchemaSubpath,
+ './skills-catalog/schema': skillsCatalogSchemaSubpath,
+ './skills-catalog/scope': skillsCatalogScopeSubpath,
+ './skills-catalog/skill-cost': skillsCatalogSkillCostSubpath,
+ './skills-catalog/source-fields': skillsCatalogSourceFieldsSubpath,
+ './sync-paused-reason': syncPausedReasonSubpath,
+ './terminal-layout': terminalLayoutSubpath,
+ './theme/base16': themeBase16Subpath,
+ './theme/theme-plugins': themeThemePluginsSubpath,
+ './types/awareness': typesAwarenessSubpath,
+ './types/identity': typesIdentitySubpath,
+ './types/principal': typesPrincipalSubpath,
+ './types/timeline': typesTimelineSubpath,
+ './uninstall-bridge': uninstallBridgeSubpath,
+ './util/doc-name': utilDocNameSubpath,
+ './utils/asset-href': utilsAssetHrefSubpath,
+ './utils/chunked-insert': utilsChunkedInsertSubpath,
+ './utils/code-fence-tracker': utilsCodeFenceTrackerSubpath,
+ './utils/embed-url-rewrite': utilsEmbedUrlRewriteSubpath,
+ './utils/extension': utilsExtensionSubpath,
+ './utils/file-size': utilsFileSizeSubpath,
+ './utils/github-stars': utilsGithubStarsSubpath,
+ './utils/heading-scan': utilsHeadingScanSubpath,
+ './utils/identity': utilsIdentitySubpath,
+ './utils/link-targets': utilsLinkTargetsSubpath,
+ './utils/loom-embed': utilsLoomEmbedSubpath,
+ './utils/pdf-anchor': utilsPdfAnchorSubpath,
+ './utils/random-uuid': utilsRandomUuidSubpath,
+ './utils/relative-time': utilsRelativeTimeSubpath,
+ './utils/resolve-internal-href': utilsResolveInternalHrefSubpath,
+ './utils/sanitize-folder-name': utilsSanitizeFolderNameSubpath,
+ './utils/slug': utilsSlugSubpath,
+ './utils/vimeo-embed': utilsVimeoEmbedSubpath,
+ './utils/wiki-link-resolve': utilsWikiLinkResolveSubpath,
+ './utils/youtube-embed': utilsYoutubeEmbedSubpath,
+};
+
+const CONDITION_ORDER = ['@inkeep/source', 'development', 'types', 'default'];
+
+const packageJson: { exports: Record<string, Record<string, string>> } = JSON.parse(
+ readFileSync(new URL('../../package.json', import.meta.url), 'utf8'),
+);
+
+const rootBindings = new Map(Object.entries(root));
+
+describe('per-module core subpaths', () => {
+ test('every export key beside the pre-existing entries is imported by this contract', () => {
+ const declared = Object.keys(packageJson.exports).filter(
+ (key) => !PRE_EXISTING_KEYS.includes(key),
+ );
+ expect(Object.keys(MODULE_SUBPATHS).sort()).toEqual(declared.sort());
+ });
+
+ test.each(Object.keys(MODULE_SUBPATHS))(
+ '%s points its conditions at the module its name implies',
+ (key) => {
+ const conditions = packageJson.exports[key];
+ const modulePath = key.slice(2);
+ const flatName = modulePath.replaceAll('/', '-');
+ expect(Object.keys(conditions ?? {})).toEqual(CONDITION_ORDER);
+ expect([`./src/${modulePath}.ts`, `./src/${modulePath}/index.ts`]).toContain(
+ conditions?.['@inkeep/source'],
+ );
+ expect(conditions?.development).toBe(conditions?.['@inkeep/source']);
+ expect(conditions?.types).toBe(`./dist/${flatName}.d.mts`);
+ expect(conditions?.default).toBe(`./dist/${flatName}.mjs`);
+ },
+ );
+
+ test.each(Object.entries(MODULE_SUBPATHS))(
+ '%s serves the same runtime bindings as the root barrel',
+ (_key, namespace) => {
+ const bindings = Object.entries(namespace);
+ const shared = bindings.filter(([name]) => rootBindings.has(name));
+ const divergent = shared
+ .filter(([name, value]) => value !== rootBindings.get(name))
+ .map(([name]) => name);
+ expect(divergent).toEqual([]);
+ if (bindings.length > 0) expect(shared.length).toBeGreaterThan(0);
+ },
+ );
+});
diff --git a/packages/core/tests/contract/subpath-types/consumer.ts b/packages/core/tests/contract/subpath-types/consumer.ts
new file mode 100644
index 000000000..d1032dd49
--- /dev/null
+++ b/packages/core/tests/contract/subpath-types/consumer.ts
@@ -0,0 +1,819 @@
+export type {
+ ACP_AGENT_HARNESS_CLI_MAP,
+ AGENT_REGISTRY,
+ AgentId,
+ AgentMode,
+ ApplyIntent,
+ ApplyReport,
+ agentIdForHandoffTarget,
+ agentIdForTerminalCli,
+ assessReadiness,
+ BlockedReason,
+ buildConnectionsView,
+ CONNECTION_ROW_AGENT_IDS,
+ ConnectionCell,
+ ConnectionRow,
+ ConsentClass,
+ GuidanceId,
+ GuidanceRef,
+ getAgentRecord,
+ HostSnapshot,
+ isAgentDetected,
+ KNOWN_HANDOFF_TARGETS,
+ PlanConflict,
+ parsePathId,
+ RequirementAssessment,
+ requiresExplicitConsent,
+ SatisfierId,
+ SurfaceState,
+ VISIBLE_HANDOFF_TARGETS,
+} from '@inkeep/open-knowledge-core/agent-registry';
+export type {
+ addsBlankLines,
+ bindFrontmatterDoc,
+ composeWithDerivedBody,
+ FrontmatterBinding,
+ FrontmatterSnapshot,
+ fnv1aDigest,
+ normalizeBridge,
+ readFmKeys,
+ readFmRegionWithError,
+ SynthesisedConflictRegion,
+ synthesiseConflictMarkersWithRegions,
+} from '@inkeep/open-knowledge-core/bridge';
+export type {
+ clampToCodeUnits,
+ mapControlCharactersToSpace,
+ stripInvisibleCharacters,
+} from '@inkeep/open-knowledge-core/bug-report-sidecar/note-content';
+export type { isSurfacedCheckpointKind } from '@inkeep/open-knowledge-core/checkpoint-kinds';
+export type {
+ CLIENT_RUNTIME_VERSION_FALLBACK,
+ ClientVersionTokenFields,
+ clientVersionHeaders,
+ clientVersionTokenFields,
+} from '@inkeep/open-knowledge-core/client-version';
+export type {
+ COMMAND_IDENTITIES,
+ CommandContext,
+ CommandIdentity,
+ evaluateCommandAvailability,
+} from '@inkeep/open-knowledge-core/commands/command-identity';
+export type {
+ commentLeafText,
+ commentQuoteText,
+} from '@inkeep/open-knowledge-core/comments/leaf-text';
+export type {
+ contextEvidenceFloor,
+ contextMatchScore,
+ findAllPassages,
+ PassageMatch,
+ rewriteCeiling,
+} from '@inkeep/open-knowledge-core/comments/passage-match';
+export type {
+ isSyncMode,
+ modeFromCommittedDefault,
+ resolveAutoSyncIntervals,
+ resolveLocalAutoSyncMode,
+ StoredSyncActiveMode,
+ StoredSyncMode,
+ SYNC_INTERVAL_PRESET_SECONDS,
+ SyncActiveMode,
+ SyncMode,
+} from '@inkeep/open-knowledge-core/config/auto-sync-mode';
+export type {
+ bindConfigDoc,
+ ConfigBinding,
+ ConfigBindingPatchResult,
+} from '@inkeep/open-knowledge-core/config/bind-config-doc';
+export type {
+ bindOkignoreDoc,
+ OkignoreBinding,
+} from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
+export type {
+ ConfigIssue,
+ ConfigValidationError,
+ humanFormat,
+ isKnownConfigError,
+ WriteScope,
+} from '@inkeep/open-knowledge-core/config/errors';
+export type { getFieldMeta } from '@inkeep/open-knowledge-core/config/field-registry';
+export type { mergeLayered } from '@inkeep/open-knowledge-core/config/merge-layered';
+export type {
+ Config,
+ ConfigPatch,
+ ConfigSchema,
+ checkEmbeddingsBaseUrl,
+ DEFAULT_EMBEDDINGS_BASE_URL,
+ DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
+ DEFAULT_EMBEDDINGS_MODEL,
+ DEFAULT_TUNNEL_PORT,
+ MAX_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MAX_EMBEDDINGS_MAX_BATCH_CHARS,
+ MAX_EMBEDDINGS_MAX_BATCH_SIZE,
+ MIN_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MIN_EMBEDDINGS_MAX_BATCH_CHARS,
+ MIN_EMBEDDINGS_MAX_BATCH_SIZE,
+ normalizeAttachmentFolderPath,
+} from '@inkeep/open-knowledge-core/config/schema';
+export type { resolveLeafSchema } from '@inkeep/open-knowledge-core/config/schema-leaf';
+export type {
+ evictStaleEntries,
+ FLASH_DEBOUNCE_MS,
+ FLASH_DURATION_MS,
+ hasNewEntries,
+} from '@inkeep/open-knowledge-core/constants/activity';
+export type {
+ CC1_CONTRACT_VERSION,
+ CONFIG_DOC_NAME_OKIGNORE,
+ CONFIG_DOC_NAME_PROJECT,
+ CONFIG_DOC_NAME_PROJECT_LOCAL,
+ CONFIG_DOC_NAME_USER,
+ CONFIG_DOC_NAMES,
+ externalSkillFileLiveDocName,
+ externalSkillLiveDocName,
+ isExternalSkillDocName,
+ isManagedArtifactDocName,
+ MANAGED_ARTIFACT_SCOPES,
+ ManagedArtifactScope,
+ parseExternalSkillDocName,
+ parseGlobalSkillBundleDoc,
+ parseLegacyTemplateDocName,
+ parseManagedArtifactName,
+ parseProjectSkillBundleDoc,
+ parseTemplateContentDocName,
+ projectSkillContentDocName,
+ SYSTEM_DOC_NAME,
+ skillFileLiveDocName,
+ skillLiveDocName,
+ stripMdExt,
+ templateContentDocName,
+} from '@inkeep/open-knowledge-core/constants/cc1';
+export type { CHROME_BG_DARK, CHROME_BG_LIGHT } from '@inkeep/open-knowledge-core/constants/chrome';
+export type {
+ codeLanguageForExtension,
+ EDITABLE_TEXT_EXTRA_LANGUAGE,
+ isEditableTextDocFile,
+} from '@inkeep/open-knowledge-core/constants/code-languages';
+export type { CreateNewBannerKind } from '@inkeep/open-knowledge-core/constants/create-new-banner';
+export type {
+ CREATE_NEW_PROJECT_FAILURE_REASONS,
+ CreateNewProjectFailureReason,
+} from '@inkeep/open-knowledge-core/constants/create-new-project-reason';
+export type { LINEAGE_EPOCH_KEY } from '@inkeep/open-knowledge-core/constants/doc-lifecycle';
+export type {
+ DOCUMENT_OPEN_BYTE_LIMIT,
+ isDocumentOverOpenByteLimit,
+ TEXT_DOC_OPEN_BYTE_LIMIT,
+} from '@inkeep/open-knowledge-core/constants/document-open';
+export type {
+ EDITOR_LABELS,
+ EDITOR_PROJECT_SKILL_ROOT,
+ EDITOR_USER_SKILL_ROOT,
+ EditorId,
+ RESERVED_PROJECT_SKILL_NAME,
+ receivesProjectIntegrationWrite,
+ STABLE_EDITOR_PROJECT_CONFIG_PATH,
+} from '@inkeep/open-knowledge-core/constants/editors';
+export type {
+ detectEmbeddedHostFromBrowser,
+ EmbeddedHost,
+} from '@inkeep/open-knowledge-core/constants/embedded-host';
+export type { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core/constants/feature-flags';
+export type { normalizeGitHostname } from '@inkeep/open-knowledge-core/constants/github';
+export type {
+ isOrphanMode,
+ ORPHAN_MODES,
+ OrphanMode,
+} from '@inkeep/open-knowledge-core/constants/graph';
+export type { MANUAL_CHECK_NOTICE_EXPIRY_MS } from '@inkeep/open-knowledge-core/constants/manual-update-check';
+export type {
+ OPEN_KNOWLEDGE_MCP_WRITE_TOOLS,
+ SERVER_TIMEOUT_ERROR_PREFIX,
+ SERVER_UNREACHABLE_ERROR_PREFIX,
+} from '@inkeep/open-knowledge-core/constants/mcp';
+export type { OPEN_KNOWLEDGE_GITHUB_URL } from '@inkeep/open-knowledge-core/constants/menu-labels';
+export type { NativeMenuLabelKey } from '@inkeep/open-knowledge-core/constants/native-menu-labels';
+export type {
+ PREVIEW_EMBED_STARTERS,
+ PreviewEmbedStarter,
+} from '@inkeep/open-knowledge-core/constants/preview-embed-starters';
+export type { PREVIEW_THEME_TOKENS } from '@inkeep/open-knowledge-core/constants/preview-theme-tokens';
+export type {
+ DESKTOP_PRODUCTS,
+ desktopChannelLabel,
+} from '@inkeep/open-knowledge-core/constants/product';
+export type {
+ AGENTS_SKILLS_ROOT,
+ isSkillRefCandidate,
+ OPENKNOWLEDGE_SKILLS_REPO,
+ PACK_SKILL_PREFIX,
+ SKILL_REF_RE,
+} from '@inkeep/open-knowledge-core/constants/skills';
+export type {
+ UNINSTALL_FEEDBACK_EMAIL_MAX_LEN,
+ UNINSTALL_FEEDBACK_NOTE_MAX_LEN,
+ UNINSTALL_FEEDBACK_REASONS,
+ UninstallFeedbackReason,
+} from '@inkeep/open-knowledge-core/constants/uninstall-feedback';
+export type {
+ ALLOWED_IMAGE_MIME_TYPES,
+ ASSET_EXTENSIONS,
+ AUDIO_EXTENSIONS,
+ DEFAULT_ATTACHMENT_FOLDER_PATH,
+ DEFAULT_DEDUP_UI,
+ DEFAULT_EMIT_FORMAT,
+ EXECUTABLE_BLOCKLIST_EXTENSIONS,
+ FILE_ATTACHMENT_EXTENSIONS,
+ IMAGE_EXTENSIONS,
+ INLINE_RENDERABLE_EXTENSIONS,
+ InlineAssetMediaKind,
+ isExcalidrawDocFile,
+ isMarkdownDocFile,
+ isMermaidDocFile,
+ mediaKindForSidebarAssetExtension,
+ VIDEO_EXTENSIONS,
+ WIKI_EMBED_EXTENSIONS,
+} from '@inkeep/open-knowledge-core/constants/upload';
+export type { CodeBlockFidelity } from '@inkeep/open-knowledge-core/extensions/code-block-fidelity';
+export type {
+ collectFootnoteIdentifiers,
+ findFootnoteDefinitionInsertPos,
+ nextFootnoteIdentifier,
+} from '@inkeep/open-knowledge-core/extensions/footnote-reference';
+export type {
+ FM_FENCE_LINE_RE,
+ stripFrontmatter,
+ unwrapFrontmatterFences,
+} from '@inkeep/open-knowledge-core/extensions/frontmatter';
+export type { ImageReferenceFidelity } from '@inkeep/open-knowledge-core/extensions/image-reference-fidelity';
+export type { ImageSrcFidelity } from '@inkeep/open-knowledge-core/extensions/image-src-fidelity';
+export type { JsxComponent } from '@inkeep/open-knowledge-core/extensions/jsx-component';
+export type { JsxInline } from '@inkeep/open-knowledge-core/extensions/jsx-inline';
+export type {
+ isAllowedLinkUri,
+ LinkFidelity,
+ LinkStyle,
+} from '@inkeep/open-knowledge-core/extensions/link-fidelity';
+export type { MathInline } from '@inkeep/open-knowledge-core/extensions/math-inline';
+export type { RawMdxFallback } from '@inkeep/open-knowledge-core/extensions/raw-mdx-fallback';
+export type { sharedExtensions } from '@inkeep/open-knowledge-core/extensions/shared';
+export type { Tag } from '@inkeep/open-knowledge-core/extensions/tag';
+export type {
+ getWikiLinkText,
+ normalizeNullableString,
+ parseWikiLink,
+ WikiLink,
+} from '@inkeep/open-knowledge-core/extensions/wiki-link';
+export type { WikiLinkEmbed } from '@inkeep/open-knowledge-core/extensions/wiki-link-embed';
+export type {
+ FrontmatterValidationError,
+ fieldErrorsFromError,
+} from '@inkeep/open-knowledge-core/frontmatter/errors';
+export type {
+ FrontmatterMap,
+ FrontmatterPatch,
+ FrontmatterType,
+ FrontmatterValue,
+ frontmatterValuesEqual,
+ inferType,
+ isFrontmatterValueEmpty,
+ RESERVED_FRONTMATTER_KEY,
+} from '@inkeep/open-knowledge-core/frontmatter/schema';
+export type {
+ extractFrontmatterTags,
+ FRONTMATTER_TAG_GRAMMAR_HINT,
+ FRONTMATTER_TAG_VALUE_RE,
+ isValidFrontmatterTagValue,
+} from '@inkeep/open-knowledge-core/frontmatter/tags';
+export type {
+ diffFrontmatter,
+ FrontmatterDelta,
+ PropertyChange,
+} from '@inkeep/open-knowledge-core/frontmatter-diff';
+export type {
+ WorktreeInventoryEntry,
+ WorktreeInventoryLocation,
+ WorktreeInventoryModel,
+ WorktreeInventoryOpenRequest,
+} from '@inkeep/open-knowledge-core/git/worktree-inventory-model';
+export type {
+ stripRemotePrefix,
+ WorktreeCreateResult,
+ WorktreeSelectorEntry,
+ WorktreeSelectorModel,
+} from '@inkeep/open-knowledge-core/git/worktree-selector-model';
+export type {
+ AssembleHandoffPromptInput,
+ assembleHandoffPrompt,
+ buildClaudeUrl,
+ buildCliLaunchArgString,
+ buildCodexUrl,
+ buildCursorUrl,
+ buildStartupInjectionBytes,
+ buildWindowsCliLaunch,
+ ComposeSelection,
+ CreateScenario,
+ composeAskPrompt,
+ composeCreatePrompt,
+ composeEmptySpacePrompt,
+ composeFilePrompt,
+ composeFixAllProblemsPrompt,
+ composeFolderPrompt,
+ composeLintFixPrompt,
+ composeSelectionPrompt,
+ composeSkillPrompt,
+ composeTerminalBareLaunchPrompt,
+ composeThreadBareLaunchPrompt,
+ DocContext,
+ HandoffFailureReason,
+ HandoffOutcome,
+ HandoffPayload,
+ HandoffScope,
+ HandoffTarget,
+ InstallState,
+ OK_TERMINAL_SURFACE_PREAMBLE,
+ OK_THREAD_SURFACE_PREAMBLE,
+ PromptTransport,
+ quoteWindowsShellPath,
+ shellSingleQuote,
+ startupInjectionFor,
+ TargetData,
+ TERMINAL_CLI_IDS,
+ TERMINAL_CLIS,
+ TerminalCli,
+ TerminalLaunchCommand,
+ WindowsShellFamily,
+ withSkillPointer,
+} from '@inkeep/open-knowledge-core/handoff';
+export type { readBrowserLanguages } from '@inkeep/open-knowledge-core/i18n/browser-locale-provider';
+export type { localeDirection } from '@inkeep/open-knowledge-core/i18n/direction';
+export type {
+ AUTO_DETECTABLE_LOCALES,
+ LanguagePreference,
+ PICKER_LOCALES,
+ SUPPORTED_LOCALES,
+ SupportedLocale,
+} from '@inkeep/open-knowledge-core/i18n/locales';
+export type {
+ FALLBACK_LOCALE,
+ resolveLocale,
+} from '@inkeep/open-knowledge-core/i18n/resolve-locale';
+export type {
+ BUG_REPORT_ATTACHMENT_CONTENT_TYPES,
+ BUG_REPORT_ATTACHMENT_EXTENSIONS,
+ BUG_REPORT_SCREENSHOT_ZIP_ENTRY,
+ isBugReportAgentChatEntry,
+ isBugReportAttachmentEntry,
+ isBugReportCrashDumpEntry,
+ MAX_BUG_REPORT_ATTACHMENTS,
+ MAX_BUG_REPORT_ATTACHMENTS_TOTAL_BYTES,
+ OkBugReportCrashDetectedEvent,
+ OkBugReportListRow,
+ OkBugReportScreenshot,
+ OkBugReportSendMetadata,
+ OkBugReportSendResult,
+ OkImageAttachmentContentType,
+ ReportBundleSummary,
+} from '@inkeep/open-knowledge-core/logger-types';
+export type {
+ LOGGER_OWNED_FIELDS,
+ parseStructuredConsoleMessage,
+ RENDERER_LOG_MAX_BATCH_BYTES,
+ RENDERER_LOG_MAX_ENTRIES,
+ RENDERER_LOG_MAX_MESSAGE_BYTES,
+ truncateLogMessage,
+} from '@inkeep/open-knowledge-core/logging/renderer-log';
+export type { scrubSecrets } from '@inkeep/open-knowledge-core/logging/secret-scrub';
+export type { MarkdownManager } from '@inkeep/open-knowledge-core/markdown';
+export type {
+ selectFenceChar,
+ widenFenceLength,
+} from '@inkeep/open-knowledge-core/markdown/code-fence';
+export type {
+ HtmlPayloadTooLargeError,
+ htmlToMdast,
+ mdastToMarkdown,
+} from '@inkeep/open-knowledge-core/markdown/html-to-mdast';
+export type {
+ AppliesToPatternSummary,
+ assertNeverOkfRuleGroupId,
+ assertNeverOkfRuleId,
+ compileAppliesTo,
+ countDiagnosticsBySource,
+ DEFAULT_LINKS_VALIDATION,
+ DEFAULT_LINTER_CONFIG,
+ DEFAULT_SUPPRESS_LOG_LINK_ADVISORIES,
+ displayCategoryForRule,
+ FrontmatterFieldConstraint,
+ FrontmatterSchemaMapping,
+ FrontmatterSchemasListSuccessSchema,
+ FrontmatterScope,
+ findRuleConfigEntry,
+ findZeroMatchAppliesToPatterns,
+ isAuditEmptyScopeWarning,
+ isFrontmatterSchemaAsset,
+ isFrontmatterScoped,
+ isMarkdownlintJsonConfig,
+ isOkfRuleEnabled,
+ LINT_PLUGINS,
+ LinksValidationSetting,
+ LintConfigResponse,
+ LintConfigResponseSchema,
+ LintDiagnostic,
+ LinterConfig,
+ LintFixResult,
+ LintFixResultSchema,
+ LintPluginId,
+ LintPosition,
+ LintTextEdit,
+ lintDocument,
+ MARKDOWNLINT_RULE_CATALOG,
+ MarkdownlintRuleSetting,
+ MarkdownlintRuleSeverity,
+ MarkdownlintRuleWriteValue,
+ OKF_RULE_GROUPS,
+ OKF_RULE_IDS,
+ OkfRuleGroupId,
+ OkfRuleId,
+ PersistedLinterConfig,
+ RULE_DISPLAY_CATEGORIES,
+ RuleCatalogEntry,
+ RuleDisplayCategory,
+ RuleOptionSpec,
+ SchemaParentPathSegment,
+ selectFrontmatterOnlyConfig,
+ selectGoverningFrontmatterSchemas,
+ summarizeAppliesTo,
+ toEffectiveBase,
+ ValidationAuditCountsResponse,
+ ValidationAuditCountsResponseSchema,
+ ValidationAuditResponse,
+ ValidationAuditResponseSchema,
+ ValidationDocCounts,
+ ValidationDocResult,
+ ValidationSourceCounts,
+ ValidationSourceKey,
+} from '@inkeep/open-knowledge-core/markdown/lint';
+export type {
+ markdownToHtml,
+ mdastToHtml,
+} from '@inkeep/open-knowledge-core/markdown/mdast-to-html';
+export type { markdownToPlainText } from '@inkeep/open-knowledge-core/markdown/plain-text';
+export type { normalizeReferenceLabel } from '@inkeep/open-knowledge-core/markdown/reference-label';
+export type { normalizeDocRelativeAssetUrl } from '@inkeep/open-knowledge-core/markdown/resolve-image-url';
+export type {
+ isRelativeUrl,
+ isSafeUrl,
+ SAFE_URL_SCHEME_RE,
+ SAFE_URL_SCHEMES,
+} from '@inkeep/open-knowledge-core/markdown/safe-url';
+export type { INLINE_TAG_VALUE_RE } from '@inkeep/open-knowledge-core/markdown/tag-promotion';
+export type {
+ incrementBlockGripClickSelectFailed,
+ incrementJsxActionAborted,
+ incrementJsxArrowNodeSelectFailed,
+ incrementJsxAutoConvertFailed,
+ incrementJsxAutoConvertSucceeded,
+ incrementJsxChromeDeleteFailed,
+ incrementJsxKeyboardDeleteFailed,
+ incrementJsxMoveFailed,
+ incrementJsxPopoverCloseRestoreFailed,
+ incrementJsxPropDropped,
+ incrementJsxRenderFailure,
+ incrementJsxStuckCopyFailed,
+ incrementJsxStuckDeleteFailed,
+ JsxNodeAction,
+} from '@inkeep/open-knowledge-core/metrics/parse-health';
+export type { createRegistry } from '@inkeep/open-knowledge-core/registry';
+export type {
+ JsxComponentMeta,
+ PropDef,
+ PropDefString,
+} from '@inkeep/open-knowledge-core/registry/types';
+export type {
+ ActivityAgentHeader,
+ ActivityBurst,
+ ActivityFile,
+ AgentActivitySuccessSchema,
+ AgentBurstDiffSuccessSchema,
+ AgentIntegrationsApplySuccessSchema,
+ assertNeverSemanticQueryOutcome,
+ BacklinkCountsSuccessSchema,
+ BacklinkEntry,
+ BacklinksSuccessSchema,
+ BranchInfoResponse,
+ BrokenLinkSuppression,
+ CheckoutResponse,
+ ClientLogEntry,
+ CommentThreadMeta,
+ CommentThreadMetaSchema,
+ CompleteBatchSuccessSchema,
+ ConflictEntryWire,
+ CreateFolderSuccessSchema,
+ CreatePageSuccessSchema,
+ classifySemanticProviderError,
+ DeletePathSuccessSchema,
+ DeleteSuccessSchema,
+ DispatchPayload,
+ DocumentListEntry,
+ DocumentListEntrySchema,
+ DocumentListSuccess,
+ DocumentListSuccessSchema,
+ DocumentReadSuccessSchema,
+ DuplicatePathSuccess,
+ DuplicatePathSuccessSchema,
+ FolderConfigWarningCode,
+ ForwardLinkEntry,
+ ForwardLinkLocalTarget,
+ ForwardLinksSuccess,
+ ForwardLinksSuccessSchema,
+ GitHubReferencePreview,
+ GitHubReferenceResponseSchema,
+ GitStatusCode,
+ GitWorktreeEntry,
+ GitWorktreeOpenTarget,
+ GitWorktreeStatusSuccess,
+ HubEntry,
+ HubsSuccessSchema,
+ interpretSkillMoveFailure,
+ isSemanticSearchOffered,
+ isSkillMoveRetainedDestinationCode,
+ LinkGraphSuccessSchema,
+ LinkPreviewMetadata,
+ LinkPreviewResponseSchema,
+ LocalOpEmbeddingsTestResponse,
+ LocalOpEmbeddingsTestResponseSchema,
+ normalizeApiWarnings,
+ OrphanEntry,
+ OrphansSuccessSchema,
+ PageHeadingsSuccessSchema,
+ PagesSuccessSchema,
+ PrepareBatchSuccessSchema,
+ PrincipalSuccessSchema,
+ ProblemDetails,
+ ProblemDetailsSchema,
+ ProblemType,
+ PullOutcome,
+ PushPermissionWire,
+ QueueSuccessSchema,
+ RenamedAssetMapping,
+ RenamedDocMapping,
+ RenamePathSuccessSchema,
+ ResolveStrategyWire,
+ SavedThemeDeleteSuccessSchema,
+ SavedThemeListEntry,
+ SavedThemeSaveRequest,
+ SavedThemeSaveRequestSchema,
+ SavedThemeSaveSuccessSchema,
+ SavedThemeScheme,
+ SavedThemeSchemeSchema,
+ SavedThemesListSuccessSchema,
+ SavedThemeUpdateRequestSchema,
+ SavedThemeUpdateSuccessSchema,
+ SearchSemanticStatus,
+ SearchSemanticStatusSchema,
+ SeedInstallPackSkillSuccess,
+ SemanticIndexStatus,
+ SemanticIndexStatusSchema,
+ ServerInfoSuccessSchema,
+ ShareConstructUrlErrorCode,
+ ShareConstructUrlRequest,
+ ShareConstructUrlResponse,
+ ShareConstructUrlResponseSchema,
+ ShareFreshness,
+ SharePublishErrorCode,
+ SharePublishNameCheckResponse,
+ SharePublishNameCheckResponseSchema,
+ SharePublishOwner,
+ SharePublishOwnersResponse,
+ SharePublishOwnersResponseSchema,
+ SharePublishRequest,
+ SharePublishResponse,
+ SharePublishResponseSchema,
+ SharePublishVisibility,
+ ShareTargetStatusResponse,
+ SKILL_NAME_REGEX,
+ SkillFolderLinkPreview,
+ SkillFolderLinkPreviewSchema,
+ SkillFrontmatter,
+ SkillInstallWarningCode,
+ SkillMoveFailureOutcome,
+ SkillOrigin,
+ SkillScope,
+ SkillsImportBulkSuccess,
+ SkillsListEntry,
+ SkillsListSuccessSchema,
+ SkillsReimportBulkSuccess,
+ SkillTargetsGetSuccess,
+ SkillTargetsGetSuccessSchema,
+ SyncConflictContentSuccess,
+ SyncConflictContentSuccessSchema,
+ SyncConflictsSuccessSchema,
+ SyncErrorCode,
+ SyncStatusSchema,
+ semanticProviderErrorBlocks,
+ TEMPLATE_NAME_REGEX,
+ TemplatesListEntry,
+ TemplatesListSuccessSchema,
+ TrashCleanupSuccessSchema,
+ UploadAssetSuccess,
+ UploadAssetSuccessSchema,
+ WorkspaceSuccessSchema,
+} from '@inkeep/open-knowledge-core/schemas/api';
+export type {
+ CC1_CHANNEL_BRANCH_SWITCHED,
+ CC1_CHANNEL_CONFIG_IGNORE_NESTED_ERROR,
+ CC1_CHANNEL_CONFIG_VALIDATION_REJECTED,
+ CC1_CHANNEL_DISK_ACK,
+ CC1BranchSwitchedPayload,
+ CC1BranchSwitchedPayloadSchema,
+ CC1ConfigIgnoreNestedErrorPayload,
+ CC1ConfigIgnoreNestedErrorPayloadSchema,
+ CC1ConfigValidationRejectedPayload,
+ CC1ConfigValidationRejectedPayloadSchema,
+ CC1DerivedViewPayload,
+ CC1DerivedViewPayloadSchema,
+ CC1DiskAckPayloadSchema,
+ CC1ServerInfoPayload,
+ CC1ServerInfoPayloadSchema,
+ DerivedViewChannel,
+ DerivedViewChannelSchema,
+} from '@inkeep/open-knowledge-core/schemas/cc1';
+export type {
+ createWorkspaceSearchCorpus,
+ createWorkspaceSearchDocument,
+ MAX_WORKSPACE_SEARCH_LIMIT,
+ searchWorkspaceCorpus,
+ WorkspaceSearchCorpus,
+ WorkspaceSearchDocument,
+ WorkspaceSearchKind,
+ workspaceSearchBasename,
+} from '@inkeep/open-knowledge-core/search/workspace-search';
+export type { planHasOutstandingWork } from '@inkeep/open-knowledge-core/seed-plan-work';
+export type {
+ BranchMatchOutcome,
+ canonicalGitHubRemoteUrl,
+ classifyBranchMatch,
+ ExpectedShareRepo,
+} from '@inkeep/open-knowledge-core/sharing';
+export type {
+ isSkillInstallTarget,
+ SkillInstallTarget,
+ SkillTargetEditor,
+ SkillTargetEditorSchema,
+ SkillUserTargetEditor,
+ SkillUserTargetEditorSchema,
+} from '@inkeep/open-knowledge-core/skill-targets/schema';
+export type {
+ CatalogSkill,
+ PluginBundleMetadata,
+ PluginSourceMetadata,
+ SkillDetail,
+ SkillDiscover,
+ SkillPreview,
+ SkillRefResolution,
+ SkillSearchResult,
+ SkillsInstalledSuccess,
+ SkillsSearchSuccess,
+} from '@inkeep/open-knowledge-core/skills-catalog/schema';
+export type { catalogRawScopeToOkScope } from '@inkeep/open-knowledge-core/skills-catalog/scope';
+export type {
+ ALWAYS_ON_TOKEN_BUDGET,
+ estimateSkillCost,
+ ON_TRIGGER_TOKEN_BUDGET,
+ SkillCostTiers,
+} from '@inkeep/open-knowledge-core/skills-catalog/skill-cost';
+export type {
+ isLocalSkillSource,
+ parseSkillsShCatalogSource,
+ skillsShSkillLinks,
+} from '@inkeep/open-knowledge-core/skills-catalog/source-fields';
+export type { SyncPausedReason } from '@inkeep/open-knowledge-core/sync-paused-reason';
+export type {
+ DEFAULT_TERMINAL_PLACEMENT,
+ MIN_TERMINAL_RIGHT_WIDTH,
+ normalizeTerminalPlacement,
+ normalizeTerminalRightWidth,
+ PREFERRED_TERMINAL_RIGHT_WIDTH,
+ TerminalPlacement,
+} from '@inkeep/open-knowledge-core/terminal-layout';
+export type {
+ AnsiSlotName,
+ BASE16_SLOT_ROLES,
+ BASE16_SLOTS,
+ Base16Palette,
+ Base16ParseError,
+ Base16Scheme,
+ Base16Slot,
+ base16ToTokens,
+ base16ToYaml,
+ isBase16Hex,
+ mixHex,
+ parseBase16Scheme,
+ relativeLuminance,
+} from '@inkeep/open-knowledge-core/theme/base16';
+export type {
+ ColorThemeSelection,
+ ColorThemeSelectionInput,
+ deriveSavedThemeName,
+ generateColorThemesCss,
+ isDarkTheme,
+ parseSavedThemeId,
+ renderThemeBlock,
+ resolveColorThemeSelection,
+ resolveModePreference,
+ resolveThemePlugin,
+ THEME_PLUGINS,
+ ThemePlugin,
+} from '@inkeep/open-knowledge-core/theme/theme-plugins';
+export type {
+ AgentFlashEntry,
+ AgentPresenceEntry,
+ AwarenessState,
+ AwarenessUser,
+ isPresenceSentinelDocName,
+} from '@inkeep/open-knowledge-core/types/awareness';
+export type { Identity } from '@inkeep/open-knowledge-core/types/identity';
+export type { Principal } from '@inkeep/open-knowledge-core/types/principal';
+export type { TimelineEntry } from '@inkeep/open-knowledge-core/types/timeline';
+export type {
+ OkUninstallBridge,
+ UNINSTALL_RESULT_WAIT_TIMEOUT_MS,
+ UninstallDispatchResult,
+ UninstallIntent,
+ UninstallNoticeChecklistItem,
+ UninstallNoticeScreen,
+ UninstallProjectRow,
+ UninstallScreenSpec,
+} from '@inkeep/open-knowledge-core/uninstall-bridge';
+export type {
+ isHiddenDocName,
+ isProjectSkillBundlePath,
+} from '@inkeep/open-knowledge-core/util/doc-name';
+export type { toDesktopAssetHref } from '@inkeep/open-knowledge-core/utils/asset-href';
+export type {
+ ChunkedInsertError,
+ chunkedYTextInsert,
+} from '@inkeep/open-knowledge-core/utils/chunked-insert';
+export type { createCodeFenceTracker } from '@inkeep/open-knowledge-core/utils/code-fence-tracker';
+export type { rewriteEmbedUrl } from '@inkeep/open-knowledge-core/utils/embed-url-rewrite';
+export type { extensionOf } from '@inkeep/open-knowledge-core/utils/extension';
+export type { formatFileSize } from '@inkeep/open-knowledge-core/utils/file-size';
+export type { getGitHubStars } from '@inkeep/open-knowledge-core/utils/github-stars';
+export type { scanHeadingLine } from '@inkeep/open-knowledge-core/utils/heading-scan';
+export type {
+ AGENT_ICON_COLORS,
+ AGENT_ICON_COLORS_DARK,
+ colorFromSeed,
+ computeInitials,
+ deriveIconColor,
+ formatPresenceLabel,
+ getIdentity,
+ HUMAN_COLORS,
+ iconFromClientName,
+ SYSTEM_WRITER_DISPLAY_NAMES,
+} from '@inkeep/open-knowledge-core/utils/identity';
+export type {
+ assertNeverLinkTarget,
+ buildRelativeMarkdownHref,
+ ClassifiedLinkTarget,
+ classifyMarkdownHref,
+ DocLinkTarget,
+ extractAssetExtension,
+ isExternalHref,
+ resolveAssetProjectPath,
+} from '@inkeep/open-knowledge-core/utils/link-targets';
+export type { isLoomUrl, parseLoomUrl } from '@inkeep/open-knowledge-core/utils/loom-embed';
+export type { parsePdfAnchor } from '@inkeep/open-knowledge-core/utils/pdf-anchor';
+export type { randomUUID } from '@inkeep/open-knowledge-core/utils/random-uuid';
+export type { formatRelativeAge } from '@inkeep/open-knowledge-core/utils/relative-time';
+export type {
+ decodeHrefPath,
+ resolveInternalHref,
+} from '@inkeep/open-knowledge-core/utils/resolve-internal-href';
+export type { sanitizeFolderName } from '@inkeep/open-knowledge-core/utils/sanitize-folder-name';
+export type {
+ getHeadingSlug,
+ HeadingEntry,
+ toWikiLinkSlug,
+ wikiLinkHref,
+} from '@inkeep/open-knowledge-core/utils/slug';
+export type { isVimeoUrl } from '@inkeep/open-knowledge-core/utils/vimeo-embed';
+export type {
+ buildPagesByBasenameIndex,
+ buildPagesBySlugIndex,
+ buildWikiLinkAssetTargetKeys,
+ getWikiLinkResolutionCandidates,
+ isResolvedWikiLinkTarget,
+ resolveWikiLinkAssetTarget,
+ resolveWikiLinkTarget,
+ resolveWikiLinkTargetDocName,
+ WikiLinkLookupIndex,
+} from '@inkeep/open-knowledge-core/utils/wiki-link-resolve';
+export type {
+ ParsedYouTubeUrl,
+ parseYouTubeUrl,
+} from '@inkeep/open-knowledge-core/utils/youtube-embed';
diff --git a/packages/core/tests/contract/subpath-types/tsconfig.json b/packages/core/tests/contract/subpath-types/tsconfig.json
new file mode 100644
index 000000000..b70535ac5
--- /dev/null
+++ b/packages/core/tests/contract/subpath-types/tsconfig.json
@@ -0,0 +1,8 @@
+{
+ "extends": "../../../tsconfig.json",
+ "compilerOptions": {
+ "types": ["node"]
+ },
+ "include": ["consumer.ts"],
+ "exclude": []
+}
diff --git a/packages/core/tsconfig.check.json b/packages/core/tsconfig.check.json
new file mode 100644
index 000000000..fb43f4e43
--- /dev/null
+++ b/packages/core/tsconfig.check.json
@@ -0,0 +1,8 @@
+{
+ "extends": "./tsconfig.json",
+ "compilerOptions": {
+ "customConditions": []
+ },
+ "include": ["tests/contract/subpath-types/consumer.ts"],
+ "exclude": []
+}
diff --git a/packages/core/tsdown.config.ts b/packages/core/tsdown.config.ts
index 47a108ae0..8add39f69 100644
--- a/packages/core/tsdown.config.ts
+++ b/packages/core/tsdown.config.ts
@@ -15,6 +15,126 @@ const entry = {
'acp-codex-legacy-notice': 'src/acp/codex-legacy-notice.ts',
'acp-tool-call-input': 'src/acp/tool-call-input.ts',
'desktop-bridge': 'src/desktop-bridge.ts',
+ 'agent-registry': 'src/agent-registry/index.ts',
+ bridge: 'src/bridge/index.ts',
+ 'bug-report-sidecar-note-content': 'src/bug-report-sidecar/note-content.ts',
+ 'checkpoint-kinds': 'src/checkpoint-kinds.ts',
+ 'client-version': 'src/client-version.ts',
+ 'commands-command-identity': 'src/commands/command-identity.ts',
+ 'comments-leaf-text': 'src/comments/leaf-text.ts',
+ 'comments-passage-match': 'src/comments/passage-match.ts',
+ 'config-auto-sync-mode': 'src/config/auto-sync-mode.ts',
+ 'config-bind-config-doc': 'src/config/bind-config-doc.ts',
+ 'config-bind-okignore-doc': 'src/config/bind-okignore-doc.ts',
+ 'config-errors': 'src/config/errors.ts',
+ 'config-field-registry': 'src/config/field-registry.ts',
+ 'config-merge-layered': 'src/config/merge-layered.ts',
+ 'config-schema': 'src/config/schema.ts',
+ 'config-schema-leaf': 'src/config/schema-leaf.ts',
+ 'constants-activity': 'src/constants/activity.ts',
+ 'constants-cc1': 'src/constants/cc1.ts',
+ 'constants-chrome': 'src/constants/chrome.ts',
+ 'constants-code-languages': 'src/constants/code-languages.ts',
+ 'constants-create-new-banner': 'src/constants/create-new-banner.ts',
+ 'constants-create-new-project-reason': 'src/constants/create-new-project-reason.ts',
+ 'constants-doc-lifecycle': 'src/constants/doc-lifecycle.ts',
+ 'constants-document-open': 'src/constants/document-open.ts',
+ 'constants-editors': 'src/constants/editors.ts',
+ 'constants-embedded-host': 'src/constants/embedded-host.ts',
+ 'constants-feature-flags': 'src/constants/feature-flags.ts',
+ 'constants-github': 'src/constants/github.ts',
+ 'constants-graph': 'src/constants/graph.ts',
+ 'constants-manual-update-check': 'src/constants/manual-update-check.ts',
+ 'constants-mcp': 'src/constants/mcp.ts',
+ 'constants-menu-labels': 'src/constants/menu-labels.ts',
+ 'constants-native-menu-labels': 'src/constants/native-menu-labels.ts',
+ 'constants-preview-embed-starters': 'src/constants/preview-embed-starters.ts',
+ 'constants-preview-theme-tokens': 'src/constants/preview-theme-tokens.ts',
+ 'constants-product': 'src/constants/product.ts',
+ 'constants-skills': 'src/constants/skills.ts',
+ 'constants-uninstall-feedback': 'src/constants/uninstall-feedback.ts',
+ 'constants-upload': 'src/constants/upload.ts',
+ 'extensions-code-block-fidelity': 'src/extensions/code-block-fidelity.ts',
+ 'extensions-footnote-reference': 'src/extensions/footnote-reference.ts',
+ 'extensions-frontmatter': 'src/extensions/frontmatter.ts',
+ 'extensions-image-reference-fidelity': 'src/extensions/image-reference-fidelity.ts',
+ 'extensions-image-src-fidelity': 'src/extensions/image-src-fidelity.ts',
+ 'extensions-jsx-component': 'src/extensions/jsx-component.ts',
+ 'extensions-jsx-inline': 'src/extensions/jsx-inline.ts',
+ 'extensions-link-fidelity': 'src/extensions/link-fidelity.ts',
+ 'extensions-math-inline': 'src/extensions/math-inline.ts',
+ 'extensions-raw-mdx-fallback': 'src/extensions/raw-mdx-fallback.ts',
+ 'extensions-shared': 'src/extensions/shared.ts',
+ 'extensions-tag': 'src/extensions/tag.ts',
+ 'extensions-wiki-link': 'src/extensions/wiki-link.ts',
+ 'extensions-wiki-link-embed': 'src/extensions/wiki-link-embed.ts',
+ 'frontmatter-diff': 'src/frontmatter-diff.ts',
+ 'frontmatter-errors': 'src/frontmatter/errors.ts',
+ 'frontmatter-schema': 'src/frontmatter/schema.ts',
+ 'frontmatter-tags': 'src/frontmatter/tags.ts',
+ 'git-worktree-inventory-model': 'src/git/worktree-inventory-model.ts',
+ 'git-worktree-selector-model': 'src/git/worktree-selector-model.ts',
+ handoff: 'src/handoff/index.ts',
+ 'i18n-browser-locale-provider': 'src/i18n/browser-locale-provider.ts',
+ 'i18n-direction': 'src/i18n/direction.ts',
+ 'i18n-locales': 'src/i18n/locales.ts',
+ 'i18n-resolve-locale': 'src/i18n/resolve-locale.ts',
+ 'logger-types': 'src/logger-types.ts',
+ 'logging-renderer-log': 'src/logging/renderer-log.ts',
+ 'logging-secret-scrub': 'src/logging/secret-scrub.ts',
+ markdown: 'src/markdown/index.ts',
+ 'markdown-code-fence': 'src/markdown/code-fence.ts',
+ 'markdown-html-to-mdast': 'src/markdown/html-to-mdast.ts',
+ 'markdown-lint': 'src/markdown/lint/index.ts',
+ 'markdown-mdast-to-html': 'src/markdown/mdast-to-html.ts',
+ 'markdown-plain-text': 'src/markdown/plain-text.ts',
+ 'markdown-reference-label': 'src/markdown/reference-label.ts',
+ 'markdown-resolve-image-url': 'src/markdown/resolve-image-url.ts',
+ 'markdown-safe-url': 'src/markdown/safe-url.ts',
+ 'markdown-tag-promotion': 'src/markdown/tag-promotion.ts',
+ 'metrics-parse-health': 'src/metrics/parse-health.ts',
+ registry: 'src/registry/index.ts',
+ 'registry-types': 'src/registry/types.ts',
+ 'schemas-api': 'src/schemas/api/index.ts',
+ 'schemas-cc1': 'src/schemas/cc1.ts',
+ 'search-workspace-search': 'src/search/workspace-search.ts',
+ 'seed-plan-work': 'src/seed-plan-work.ts',
+ sharing: 'src/sharing/index.ts',
+ 'skill-targets-schema': 'src/skill-targets/schema.ts',
+ 'skills-catalog-schema': 'src/skills-catalog/schema.ts',
+ 'skills-catalog-scope': 'src/skills-catalog/scope.ts',
+ 'skills-catalog-skill-cost': 'src/skills-catalog/skill-cost.ts',
+ 'skills-catalog-source-fields': 'src/skills-catalog/source-fields.ts',
+ 'sync-paused-reason': 'src/sync-paused-reason.ts',
+ 'terminal-layout': 'src/terminal-layout.ts',
+ 'theme-base16': 'src/theme/base16.ts',
+ 'theme-theme-plugins': 'src/theme/theme-plugins.ts',
+ 'types-awareness': 'src/types/awareness.ts',
+ 'types-identity': 'src/types/identity.ts',
+ 'types-principal': 'src/types/principal.ts',
+ 'types-timeline': 'src/types/timeline.ts',
+ 'uninstall-bridge': 'src/uninstall-bridge.ts',
+ 'util-doc-name': 'src/util/doc-name.ts',
+ 'utils-asset-href': 'src/utils/asset-href.ts',
+ 'utils-chunked-insert': 'src/utils/chunked-insert.ts',
+ 'utils-code-fence-tracker': 'src/utils/code-fence-tracker.ts',
+ 'utils-embed-url-rewrite': 'src/utils/embed-url-rewrite.ts',
+ 'utils-extension': 'src/utils/extension.ts',
+ 'utils-file-size': 'src/utils/file-size.ts',
+ 'utils-github-stars': 'src/utils/github-stars.ts',
+ 'utils-heading-scan': 'src/utils/heading-scan.ts',
+ 'utils-identity': 'src/utils/identity.ts',
+ 'utils-link-targets': 'src/utils/link-targets.ts',
+ 'utils-loom-embed': 'src/utils/loom-embed.ts',
+ 'utils-pdf-anchor': 'src/utils/pdf-anchor.ts',
+ 'utils-random-uuid': 'src/utils/random-uuid.ts',
+ 'utils-relative-time': 'src/utils/relative-time.ts',
+ 'utils-resolve-internal-href': 'src/utils/resolve-internal-href.ts',
+ 'utils-sanitize-folder-name': 'src/utils/sanitize-folder-name.ts',
+ 'utils-slug': 'src/utils/slug.ts',
+ 'utils-vimeo-embed': 'src/utils/vimeo-embed.ts',
+ 'utils-wiki-link-resolve': 'src/utils/wiki-link-resolve.ts',
+ 'utils-youtube-embed': 'src/utils/youtube-embed.ts',
};
export default defineConfig([
diff --git a/packages/desktop/tests/integration/m1-smoke.test.ts b/packages/desktop/tests/integration/m1-smoke.test.ts
index 6324b697d..bf5bbd153 100644
--- a/packages/desktop/tests/integration/m1-smoke.test.ts
+++ b/packages/desktop/tests/integration/m1-smoke.test.ts
@@ -196,7 +196,7 @@ describe('M1 smoke', () => {
offenders.push(` [${pin.typeName}] ${label} still carries an inline literal union`);
}
const importsFromCore =
- /from\s+['"]@inkeep\/open-knowledge-core(?:\/desktop-bridge)?['"]/.test(src) ||
+ /from\s+['"]@inkeep\/open-knowledge-core(?:\/[\w-]+)*['"]/.test(src) ||
/from\s+['"]\.\/constants\/[\w-]+\.ts['"]/.test(src);
if (!importsFromCore) {
offenders.push(
diff --git a/scripts/check-typescript-resolution.test.mjs b/scripts/check-typescript-resolution.test.mjs
index ec04ecc85..873528e79 100644
--- a/scripts/check-typescript-resolution.test.mjs
+++ b/scripts/check-typescript-resolution.test.mjs
@@ -1675,6 +1675,7 @@ describe('the tsconfigs on disk', () => {
['packages/cli/tsconfig.build.json', []],
['packages/cli/tsconfig.check.json', []],
['packages/core/tsconfig.build.json', []],
+ ['packages/core/tsconfig.check.json', []],
['packages/server/tsconfig.build.json', []],
['tsconfig.json', [SOURCE_CONDITION]],
]);
diff --git a/turbo.json b/turbo.json
index a0a9aea5a..24b7b756b 100644
--- a/turbo.json
+++ b/turbo.json
@@ -84,6 +84,10 @@
"$TURBO_ROOT$/scripts/read-jsonc.mjs"
]
},
+ "@inkeep/open-knowledge-core#check:dts": {
+ "dependsOn": ["build"],
+ "inputs": ["tsconfig.json", "tsconfig.check.json", "tests/contract/subpath-types/consumer.ts"]
+ },
"@inkeep/open-knowledge-docs#build": {
"dependsOn": ["^build", "typecheck"],
"outputs": ["dist/**", ".next/**", "!.next/cache/**", "!.next/dev/**"],