Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Trim Open Knowledge AGENTS.md and pin it at 31,700 bytes (#7074)

Nick Gomez131437ebc3a3
diff --git a/lint-plugins/ok-rules/README.md b/lint-plugins/ok-rules/README.md
index 1f8b0e2fc..1b15d606a 100644
--- a/lint-plugins/ok-rules/README.md
+++ b/lint-plugins/ok-rules/README.md
@@ -44,7 +44,7 @@ Rule: [`lint-plugins/ok-rules/rules/no-loosely-typed-webcontents-ipc.mjs`](rules
### `no-raw-html-interactive-element`
-UI primitives discipline. Forbids raw JSX `<button>`, `<input>`, `<textarea>`, `<select>` inside production `.tsx` under `packages/{app,desktop,plugin}/src/**`. Consumers must use the shadcn primitives (`Button`, `Input`, `Textarea`, `Select`) from `@/components/ui/*`; if the primitive isn't installed yet, add it via `pnpm dlx shadcn@latest add <name>` first. The rule catches the PR #937 failure mode: contributors (including Codex / Claude Code / human reviewers) introducing raw `<button>` JSX while a shadcn `<Button>` from `@/components/ui/button` was already imported in the same file.
+UI primitives discipline. Forbids raw JSX `<button>`, `<input>`, `<textarea>`, `<select>` inside production `.tsx` under `packages/{app,desktop,plugin}/src/**`. Consumers must use the shadcn primitives (`Button`, `Input`, `Textarea`, `Select`) from `@/components/ui/*`; if the primitive isn't installed yet, add it via `pnpm dlx shadcn@latest add <name>` from `packages/app` first. The rule catches the PR #937 failure mode: contributors (including Codex / Claude Code / human reviewers) introducing raw `<button>` JSX while a shadcn `<Button>` from `@/components/ui/button` was already imported in the same file.
**Scoped** (see the rule's `RULE_SCOPES` entry in [`scope.mjs`](scope.mjs)) to `packages/{app,desktop,plugin}/src/**/*.tsx`. Exemptions are the leading-`!` globs in that same entry:
diff --git a/lint-plugins/ok-rules/rules/no-raw-html-interactive-element.mjs b/lint-plugins/ok-rules/rules/no-raw-html-interactive-element.mjs
index 3194caf1e..908a2ff8b 100644
--- a/lint-plugins/ok-rules/rules/no-raw-html-interactive-element.mjs
+++ b/lint-plugins/ok-rules/rules/no-raw-html-interactive-element.mjs
@@ -3,7 +3,7 @@ import { elementName } from '../jsx.mjs';
const URL = docsUrl('no-raw-html-interactive-element');
-const MESSAGE = `Raw HTML interactive primitive — use shadcn Button/Input/Textarea/Select from @/components/ui/* (install missing via \`pnpm dlx shadcn@latest add <name>\`). See ${URL}`;
+const MESSAGE = `Raw HTML interactive primitive — use shadcn Button/Input/Textarea/Select from @/components/ui/* (install missing via \`pnpm dlx shadcn@latest add <name>\` from \`packages/app\`). See ${URL}`;
const FORBIDDEN = new Set(['button', 'input', 'textarea', 'select']);
diff --git a/packages/core/src/config/field-registry.test.ts b/packages/core/src/config/field-registry.test.ts
index a118928e8..8cc46ca5c 100644
--- a/packages/core/src/config/field-registry.test.ts
+++ b/packages/core/src/config/field-registry.test.ts
@@ -129,7 +129,7 @@ describe('ConfigSchema coverage (NR3 — every leaf has fieldRegistry metadata)'
if (missing.length > 0) {
const lines = missing.map((m) => ` - ${m.path.join('.')}`).join('\n');
throw new Error(
- `ConfigSchema leaves missing fieldRegistry entry (declaration order bug? .register() must come BEFORE .default()/.optional()/.nullable()):\n${lines}`,
+ `ConfigSchema leaves missing fieldRegistry entry (register each leaf on the \`fieldRegistry\` singleton from \`@inkeep/open-knowledge-core\`):\n${lines}`,
);
}
});
diff --git a/packages/desktop/playwright.config.ts b/packages/desktop/playwright.config.ts
index e73420734..1c7110208 100644
--- a/packages/desktop/playwright.config.ts
+++ b/packages/desktop/playwright.config.ts
@@ -25,23 +25,7 @@ export default defineConfig({
testDir: './tests/smoke',
testMatch: /.*\.e2e\.ts$/,
timeout: process.env.CI ? 150_000 : ONE_LAUNCH_AND_ITS_READINESS_VERDICT_MS,
- // Retries for CI macOS runner flake. Tests that hang or time out from
- // runner-load contention (Electron Helper XPC delays, slow loadFile
- // resolution, slow window show under vibrancy + transparent: true) get
- // retried up to twice. Local dev runs (CI=undefined) get 0 retries to
- // surface real regressions immediately. This mirrors the precedent set
- // by `OpenKnowledge Validation`'s playwright job — CLAUDE.md
- // documents `failOnFlakyTests: false` for it explicitly because Electron
- // smoke on macos-latest has inherent latency variance the Playwright
- // engine itself can't eliminate. Retries are a structural acknowledgment
- // of CI runner-class behavior, NOT a substitute for fixing real bugs.
retries: process.env.CI ? 2 : 0,
- // Per CLAUDE.md root policy ("PR-tier has failOnFlakyTests: false — retry-
- // success does NOT promote to red"), a smoke that flakes once and passes on
- // retry must not red the job. Persistent-flake detection is the nightly's
- // job. Without this, a single transient timeout (Electron Helper XPC delay,
- // slow vibrancy compositor under load, etc.) reds the gate even though the
- // retry surfaces no real regression.
failOnFlakyTests: false,
// Fail-fast diagnostic when src/ is newer than out/. The smoke harness
// launches `out/main/index.js` directly; if out/ is stale, tests run
diff --git a/packages/server/assets/skills/project/SKILL.md b/packages/server/assets/skills/project/SKILL.md
index 9f0a5380c..2dd528606 100644
--- a/packages/server/assets/skills/project/SKILL.md
+++ b/packages/server/assets/skills/project/SKILL.md
@@ -61,7 +61,7 @@ Tools NOT in OK MCP (your host's): `preview_start`, `preview_screenshot`, `WebFe
- **Native `Read` / `Grep` / `Glob` on in-scope `.md` / `.mdx`** — the original case.
- **`Bash ls` / `Bash find` / `Bash cat` on dirs containing in-scope markdown** — use `exec("ls -A …")` / `exec("find … -name '*.md'")` / `exec("cat …")`. Native returns bare names; `exec` adds frontmatter, backlinks, and recent activity. `-A` shows hidden entries without `.`/`..`.
- **Glob patterns that target markdown** — `exec` expands file operands (`cat specs/*.md`); quoted patterns and a command's own pattern (`find -name`) stay literal.
-- **Dispatching the Explore / general-purpose subagent for markdown-heavy exploration** — subagents use native tools internally and bypass OK. Do markdown exploration yourself via `exec` / `search`. Subagents remain appropriate for **source-code** exploration.
+- **Dispatching the Explore / general-purpose subagent for markdown-heavy exploration** — a subagent may start without this skill loaded and then read markdown with its native tools, bypassing OK. Do markdown exploration yourself via `exec` / `search`. Subagents remain appropriate for **source-code** exploration.
- **Native `Read` / `Grep` on in-scope markdown inside `.ok/`** — `.ok/` is in-scope; treat its `.md` / `.mdx` like any other KB file.
- **`ls` / `cat` / `find` on skill folders to discover or read a skill** — skills are addressed by `name`+`scope`, not by path (a skill can live in any editor dir, the `.agents/skills/` hub, or a custom root, with copies elsewhere). Use the `skills` tool.